laiss-docs 1.1.0__tar.gz

laiss_docs-1.1.0/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Registo de alterações
+
+Formato baseado em [Keep a Changelog](https://keepachangelog.com/pt-PT/1.1.0/),
+versionamento [semântico](https://semver.org/lang/pt/).
+
+## [1.1.0] — 2026-11-06
+
+### Acrescentado
+
+- **`laiss-docs deps`**: descobre o que falta no sistema (LuaLaTeX, poppler,
+  Graphviz, mermaid-cli) e instala com o gestor da distribuição. Reconhece
+  Debian, Arch, Fedora, openSUSE, Alpine, macOS e NixOS. Tem `--dry-run`,
+  `--yes`, `--no-optional` e `--keep-going`.
+- **Instalação automática na primeira utilização.** Quando falta alguma coisa
+  e há terminal, o `build` pergunta e instala. O resultado fica em
+  `~/.local/share/laiss-docs/.deps-ok`, com a versão, para não repetir a
+  verificação em cada compilação (poupa ~3 s por build). Apagar o ficheiro
+  força nova verificação.
+- **`laissdocs/install.py`**, com a lógica separada do CLI: o plano é uma
+  função que descreve, e a execução é outra que corre. É o que torna o
+  `--dry-run` verdadeiro em vez de aproximado.
+- **`python -m laissdocs`** funciona.
+- **`install.py` reconhece o gestor de TeX da instalação activa**, não o
+  primeiro no `PATH`. Numa máquina com MiKTeX activo e um TinyTeX antigo,
+  instalar pelo `tlmgr` errado escrevia numa árvore que o `lualatex` não lê.
+- **`build.missing_tex_files()`**: pergunta ao `kpsewhich` que ficheiros de
+  estilo faltam. 0,1 s contra os segundos de compilar uma sonda.
+
+### Alterado
+
+- **Empacotamento para PyPI.** Metadados completos (readme, classificadores,
+  `requires-python`), `py.typed`, e a versão numa fonte só: o
+  `pyproject.toml` lê-a de `laissdocs/__init__.py`.
+- **O `doctor` deixa de compilar uma sonda** quando há `kpsewhich`. A sonda
+  continua como recurso para máquinas sem ele.
+- **A estrutura do repositório está documentada por camadas** no README:
+  design, conteúdo, estrutura, motor e interface.
+
+### Corrigido
+
+- **`\caption` fora do `xltabular`.** Uma tabela com legenda abortava a
+  compilação com «\caption outside float», e o documento ficava sem PDF.
+  Nunca tinha aparecido porque nenhum exemplo usava legendas em tabelas.
+- **Legenda de tabela duplicada.** O `\endhead` repete-se em cada página e
+  levava o `\caption` consigo: uma tabela que atravessava uma página mostrava
+  «Tabela 1» duas vezes. Passou para o `\endfirsthead`.
+- **Títulos de secção órfãos.** `\needspace` no `titleformat`: um título
+  deixa de ficar sozinho no fundo da página.
+- **`\lstinline` com barras invertidas.** Uma regex inline partia a
+  compilação com «Improper alphabetic constant», sem indicar o parágrafo.
+  Passa a usar `\codeb`.
+- **`ensure_install` comparava só o tamanho dos ficheiros.** Uma edição ao
+  `.sty` que mantivesse os bytes nunca era copiada e o build revertia em
+  silêncio. Passa a comparar SHA-256.
+- **`__pycache__` no wheel**: 4 KB por módulo de outra versão de Python,
+  excluídos.
+- **Quatro nomes do `TEX_REQUIRED_PACKAGES` não são pacotes instaláveis.**
+  `tabularx`, `longtable` e `multicol` vivem dentro de `tools`, e `graphicx`
+  dentro de `graphics`. Pedi-los ao `tlmgr` responde «pacote desconhecido».
+  Agora instala-se só o que o `kpsewhich` diz que falta.
+
+### Notas
+
+- **Sem dependências Python.** A biblioteca padrão chega: o cliente HTTP da
+  IA e o protocolo MCP são escritos à mão. A alternativa era arrastar
+  `requests` e o SDK do MCP para uma ferramenta que os usa uma vez.
+- **As dependências de sistema não se declaram no `pyproject.toml`** porque o
+  pip só instala Python. Um pacote Python que corresse `sudo` na instalação
+  seria pior do que um comando explícito.
+
+## [1.0.0] — 2026-11-05
+
+Primeira versão empacotada.
+
+- Motor de blocos JSON: parágrafos, listas, definições, tabelas, caixas,
+  código, citações, figuras, gráficos e referências.
+- Design em `laissdoc.sty`: Inter + JetBrains Mono, paleta, capa, colofão.
+- Cinco idiomas com hifenização e datas próprias.
+- Compilação com três passagens do LuaLaTeX e cinco verificações no PDF.
+- CLI com quinze comandos, todos com `--json`.
+- Servidor MCP com vinte e duas ferramentas, e um guia para agentes.
+- Cliente de IA remota por endpoint compatível com OpenAI.

laiss_docs-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Laiss Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

laiss_docs-1.1.0/MANIFEST.in

@@ -0,0 +1,22 @@
+# O que entra no sdist, para além do pacote e do que o pyproject declara.
+#
+# O wheel já leva as fontes e os estilos (package-data). Isto é só o arquivo
+# fonte: o que alguém precisa para reconstruir o pacote, correr os testes, e
+# ler o que mudou. Sem o CHANGELOG e os testes, o sdist é um arquivo que não
+# se consegue auditar.
+
+include README.md
+include CHANGELOG.md
+include LICENSE
+
+# Os testes vão no sdist e não no wheel: quem instala não precisa deles, quem
+# reconstrói precisa de os poder correr.
+recursive-include tests *.py
+
+# Os exemplos ensinam o formato do doc.json melhor do que qualquer prosa.
+recursive-include examples *.json
+
+# Sem isto, o sdist arrasta o que estiver na pasta no momento do build.
+global-exclude __pycache__/*
+global-exclude *.py[co]
+global-exclude .DS_Store