release: v1.6-2 com correcoes de bug, novas definicoes e documentacao modular

Author: pessoa736

.github/copilot-instructions.md

@@ -15,14 +15,43 @@ LogLua é um sistema de logging modular e minimalista para Lua com:
 
 ```
 loglua/
-├── init.lua         # API pública principal
-├── config.lua       # Estado interno (mensagens, seções, contadores, modo live)
-├── formatter.lua    # Formatação de mensagens, cores ANSI, agrupamento
-├── file_handler.lua # Operações de arquivo (I/O)
-├── help.lua         # Sistema de ajuda integrado (log.help())
-└── test.lua         # Testes automatizados
+├── init.lua           # API pública principal
+├── config.lua         # Estado interno (mensagens, seções, contadores, modo live)
+├── formatter.lua      # Formatação de mensagens, cores ANSI, agrupamento
+├── file_handler.lua   # Operações de arquivo (I/O)
+├── help.lua           # Sistema de ajuda integrado (log.help())
+├── constants/
+│   └── ANSIColors.lua # Constantes de cores ANSI
+└── utils/
+    └── formatIndex.lua # Utilitário de formatação de índice
+
+library/               # Arquivos de definição de tipos (LuaLS / lua-language-server)
+├── loglua.lua         # Definições da API pública (logluaLib)
+├── config.lua         # Definições do módulo config (loglua.configLib)
+├── formatter.lua      # Definições do módulo formatter
+└── help.lua           # Definições do módulo help
+
+spec/
+└── loglua_spec.lua    # Testes automatizados (busted)
+
+rockspecs/             # Rockspecs para publicação no LuaRocks
 ```
 
+## Importações
+
+Os módulos usam importações diretas com caminho completo:
+```lua
+local config = require("loglua.config")
+```
+**NÃO** usar resolução dinâmica de path com `(...)`.
+
+## Arquivos de Definição (library/)
+
+- Usados pelo lua-language-server para autocomplete e type-checking
+- Seguem o padrão `---@meta` e `---@class`
+- Cada função deve ter: `---@type function`, `---@param`, `---@return` e um bloco `example:` com código Lua
+- Não colocar anotações `---@type` no código fonte (init.lua, config.lua, etc) — as definições ficam apenas em `library/`
+
 ## Ao Implementar uma Nova Feature
 
 ### Antes
@@ -31,17 +60,19 @@ loglua/
 - Verificar se a feature não conflita com funcionalidades existentes
 
 ### Durante
-- Seguir o padrão de documentação LDoc nos comentários
 - Manter a arquitetura modular (config para estado, formatter para formatação, etc)
 - Adicionar funções públicas no init.lua, lógica interna nos outros módulos
+- Atualizar os arquivos de definição em `library/` com tipos e exemplos
 
 ### Depois
-- Rodar os testes: `cd loglua/loglua && lua test.lua`
-- Adicionar novos testes para a feature em test.lua
+- Rodar os testes: `busted spec/loglua_spec.lua`
+- Adicionar novos testes para a feature em spec/loglua_spec.lua
 - Atualizar documentação:
   - help.lua (adicionar tópico se necessário)
+  - library/ (definições de tipos e exemplos)
   - README.md (inglês)
   - README.pt-BR.md (português)
+  - README.es.md (espanhol)
 - Se tudo passar, fazer upload
 
 ## Upload / Release
@@ -76,7 +107,7 @@ Padrão: `X.Y-Z` (ex: 1.4-1)
 
 ### Logging
 - `log(...)` / `log.add(...)` - adiciona mensagem
-- `log.debug(...)` - mensagem de debug (requer debugMode)
+- `log.debug(...)` - mensagem de debug (requer debugMode, retorna imediatamente se inativo)
 - `log.error(...)` - mensagem de erro
 
 ### Seções
@@ -102,6 +133,7 @@ Padrão: `X.Y-Z` (ex: 1.4-1)
 ### Configuração
 - `log.activateDebugMode()` / `log.deactivateDebugMode()`
 - `log.checkDebugMode()`
+- `log.setHandlerHeader(func)` - customiza header do log
 - `log.clear()` - limpa tudo
 
 ### Ajuda
@@ -119,17 +151,17 @@ Padrão: `X.Y-Z` (ex: 1.4-1)
 
 Rodar testes:
 ```bash
-cd loglua/loglua && lua test.lua
+busted spec/loglua_spec.lua
 ```
 
-Os testes usam cores ANSI e verificam:
+Os testes (busted) verificam:
 - Logging básico
 - Sistema de seções
 - log.inSection()
 - Seção padrão
-- Modo debug
+- Modo debug (começa desativado, não adiciona mensagem quando inativo)
 - Contador de erros
 - Função clear()
 - Chamada direta log()
-- Modo live
+- Modo live (merge de grupos)
 - Salvamento em arquivo

.luarc.json

@@ -12,7 +12,7 @@
     "version": "Lua 5.4",
     "path": [
       "?.lua",
-      "loglua/init.lua",
+      "?/init.lua",
       "loglua/?.lua"
     ]
   },