explicai 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabriel Sampaio
+
+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.

package/README.md

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+<p>
+  <img src="https://gabriel-codesampaio.github.io/explicai-brandbook/logo/explicai-logo-horizontal.svg" alt="Explicaí" height="56">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Construtor de manuais open source e gratuito. Do print ao manual pronto em PDF, HTML e Markdown.
+
+> Tira o print, que o Explicaí explica.
+
+## Como usar
+
+Precisa do Node 20.12 ou mais novo.
+
+```bash
+npx explicai manuais
+```
+
+O Explicaí Studio abre no navegador, e os manuais ficam na pasta `manuais` (sem pasta, vale a pasta atual). Opções: `--port 4321` para trocar a porta e `--no-open` para não abrir o navegador.
+
+No Studio você:
+
+- escreve cada tela ou tarefa do sistema numa página, organizada em árvore;
+- cola prints e marca com números, destaques, setas e áreas clicáveis;
+- escreve passos numerados com o print e o resultado esperado de cada um;
+- guarda versões de cada página e escolhe qual vai para o manual final;
+- marca cada página como rascunho, em revisão, aprovada ou publicada;
+- exporta em HTML, PDF ou Markdown. O PDF usa o Chrome, o Edge ou o Chromium que já estiver na máquina.
+
+Cada manual é uma pasta de arquivos Markdown que você pode versionar no git junto com o código. O formato está em [docs/manual-format.md](docs/manual-format.md).
+
+A interface está em português e em inglês, e segue o idioma do navegador. O [Explicaí Agent](https://github.com/gabriel-codesampaio/explicai-mcp) vai deixar uma IA montar manuais no mesmo formato, pelo MCP.
+
+## Desenvolvimento
+
+```bash
+npm install
+npm run check      # lint, tipos e testes
+npm run test:e2e   # testes de ponta a ponta no Chrome instalado
+npm run build
+```
+
+Para trabalhar no editor: `npm run dev:server` em um terminal e `npm run dev:web` em outro.
+
+Contribuições são bem-vindas. Abra uma issue para conversar sobre a ideia, ou mande um pull request com `npm run check` passando.
+
+- Formato do manual em disco: [docs/manual-format.md](docs/manual-format.md)
+- Brand book: [gabriel-codesampaio.github.io/explicai-brandbook](https://gabriel-codesampaio.github.io/explicai-brandbook/)
+
+## English
+
+Explicaí is a free, open source manual builder. Run `npx explicai manuals` (Node 20.12+), write one page per screen or task, paste screenshots and mark them up with numbered markers, highlights, arrows and clickable areas, then export to HTML, PDF or Markdown. Each manual is a folder of Markdown files you can keep in git next to your code. The interface is available in Portuguese and English. Pronounced *ex-plee-kah-EE*.
+
+## Licença
+
+MIT. Um projeto [codesampa.io](https://codesampa.io).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { createStudioServer } from "./server/index.js";
+const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: {
+        port: { type: "string", short: "p", default: "4321" },
+        "no-open": { type: "boolean", default: false },
+        help: { type: "boolean", short: "h", default: false },
+    },
+});
+if (values.help) {
+    console.log(`Uso: explicai [pasta] [--port 4321] [--no-open]
+
+Abre o Explicaí Studio no navegador. Os manuais ficam em [pasta] (padrão: pasta atual).`);
+    process.exit(0);
+}
+const workspace = path.resolve(positionals[0] ?? ".");
+const port = Number(values.port);
+if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    console.error(`Porta inválida: ${values.port}`);
+    process.exit(1);
+}
+await mkdir(workspace, { recursive: true });
+const webDir = path.join(path.dirname(fileURLToPath(import.meta.url)), "web");
+const server = createStudioServer({ workspace, webDir });
+server.on("error", (err) => {
+    console.error(err.code === "EADDRINUSE" ? `A porta ${port} já está em uso. Tente --port ${port + 1}.` : err.message);
+    process.exit(1);
+});
+server.listen(port, "127.0.0.1", () => {
+    const url = `http://localhost:${port}`;
+    console.log(`Explicaí Studio em ${url}\nManuais em ${workspace}\nCtrl+C para sair.`);
+    if (!values["no-open"])
+        openBrowser(url);
+});
+function openBrowser(url) {
+    const [cmd, args] = process.platform === "win32"
+        ? ["cmd", ["/c", "start", "", url]]
+        : process.platform === "darwin"
+            ? ["open", [url]]
+            : ["xdg-open", [url]];
+    spawn(cmd, args, { stdio: "ignore", detached: true })
+        .on("error", () => { })
+        .unref();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core/annotations.d.ts

@@ -0,0 +1,7 @@
+import { type Annotations } from "./types.js";
+export declare function emptyAnnotations(): Annotations;
+/**
+ * Valida anotações vindas do disco ou do Agent. Lança Error com o caminho do campo inválido.
+ * Coordenadas fora de 0..1 são rejeitadas para que nada aponte para fora da imagem.
+ */
+export declare function parseAnnotations(input: unknown): Annotations;

package/dist/core/annotations.js

@@ -0,0 +1,108 @@
+import { FORMAT_VERSION } from "./types.js";
+export function emptyAnnotations() {
+    return { version: FORMAT_VERSION, markers: [], highlights: [], arrows: [], hotspots: [] };
+}
+/**
+ * Valida anotações vindas do disco ou do Agent. Lança Error com o caminho do campo inválido.
+ * Coordenadas fora de 0..1 são rejeitadas para que nada aponte para fora da imagem.
+ */
+export function parseAnnotations(input) {
+    const obj = record(input, "anotações");
+    if (obj.version !== FORMAT_VERSION)
+        throw new Error(`anotações.version: esperado ${FORMAT_VERSION}`);
+    const ids = new Set();
+    const id = (v, path) => {
+        const s = text(v, path);
+        if (ids.has(s))
+            throw new Error(`${path}: id repetido "${s}"`);
+        ids.add(s);
+        return s;
+    };
+    return {
+        version: FORMAT_VERSION,
+        markers: list(obj.markers, "markers").map((m, i) => {
+            const r = record(m, `markers[${i}]`);
+            const n = r.n;
+            if (!Number.isInteger(n) || n < 1)
+                throw new Error(`markers[${i}].n: inteiro a partir de 1`);
+            return {
+                id: id(r.id, `markers[${i}].id`),
+                n: n,
+                ...point(r, `markers[${i}]`),
+                ...(r.label === undefined ? {} : { label: text(r.label, `markers[${i}].label`, true) }),
+            };
+        }),
+        highlights: list(obj.highlights, "highlights").map((h, i) => {
+            const r = record(h, `highlights[${i}]`);
+            return { id: id(r.id, `highlights[${i}].id`), ...rect(r, `highlights[${i}]`) };
+        }),
+        arrows: list(obj.arrows, "arrows").map((a, i) => {
+            const r = record(a, `arrows[${i}]`);
+            return {
+                id: id(r.id, `arrows[${i}].id`),
+                from: point(record(r.from, `arrows[${i}].from`), `arrows[${i}].from`),
+                to: point(record(r.to, `arrows[${i}].to`), `arrows[${i}].to`),
+            };
+        }),
+        hotspots: list(obj.hotspots, "hotspots").map((h, i) => {
+            const r = record(h, `hotspots[${i}]`);
+            return {
+                id: id(r.id, `hotspots[${i}].id`),
+                ...rect(r, `hotspots[${i}]`),
+                target: target(r.target, `hotspots[${i}].target`),
+            };
+        }),
+    };
+}
+function target(v, path) {
+    const r = record(v, path);
+    switch (r.type) {
+        case "page":
+            return { type: "page", pageId: text(r.pageId, `${path}.pageId`) };
+        case "anchor":
+            return { type: "anchor", pageId: text(r.pageId, `${path}.pageId`), anchor: text(r.anchor, `${path}.anchor`) };
+        case "url": {
+            const href = text(r.href, `${path}.href`);
+            // Só http(s) e mailto: um href "javascript:" viraria XSS no HTML exportado.
+            if (!/^(https?:|mailto:)/i.test(href))
+                throw new Error(`${path}.href: use http, https ou mailto`);
+            return { type: "url", href };
+        }
+        default:
+            throw new Error(`${path}.type: esperado "page", "anchor" ou "url"`);
+    }
+}
+function point(r, path) {
+    return { x: unit(r.x, `${path}.x`), y: unit(r.y, `${path}.y`) };
+}
+function rect(r, path) {
+    const box = { ...point(r, path), w: unit(r.w, `${path}.w`), h: unit(r.h, `${path}.h`) };
+    if (box.w === 0 || box.h === 0)
+        throw new Error(`${path}: largura e altura maiores que zero`);
+    if (box.x + box.w > 1 + 1e-9 || box.y + box.h > 1 + 1e-9)
+        throw new Error(`${path}: a área passa da borda da imagem`);
+    return box;
+}
+function unit(v, path) {
+    if (typeof v !== "number" || !Number.isFinite(v) || v < 0 || v > 1)
+        throw new Error(`${path}: número entre 0 e 1`);
+    return v;
+}
+function text(v, path, allowEmpty = false) {
+    if (typeof v !== "string" || (!allowEmpty && v.trim() === ""))
+        throw new Error(`${path}: texto obrigatório`);
+    return v;
+}
+function list(v, path) {
+    if (v === undefined)
+        return [];
+    if (!Array.isArray(v))
+        throw new Error(`${path}: esperado uma lista`);
+    return v;
+}
+function record(v, path) {
+    if (typeof v !== "object" || v === null || Array.isArray(v))
+        throw new Error(`${path}: esperado um objeto`);
+    return v;
+}
+//# sourceMappingURL=annotations.js.map

package/dist/core/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/core/annotations.ts"],"names":[],"mappings":"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"}

package/dist/core/assets.d.ts

@@ -0,0 +1,15 @@
+import type { Annotations } from "./types.js";
+/** Grava a imagem em `assets/` com nome único e devolve o caminho relativo ao manual. */
+export declare function saveAsset(dir: string, fileName: string, data: Uint8Array): Promise<string>;
+export declare function readAnnotations(dir: string, assetPath: string): Promise<Annotations>;
+export declare function writeAnnotations(dir: string, assetPath: string, input: unknown): Promise<Annotations>;
+/**
+ * Arquivos de assets/ que ninguém usa: imagens que nenhuma página, versão ou item da lixeira cita,
+ * e marcações (.json) cuja imagem não existe mais. Devolve caminhos como `assets/tela.png`.
+ */
+export declare function findUnusedAssets(dir: string): Promise<string[]>;
+/** Move o que `findUnusedAssets` achou para `.lixeira/imagens-<data>/`. Nada é apagado. */
+export declare function cleanUnusedAssets(dir: string): Promise<{
+    moved: number;
+    folder: string | null;
+}>;

package/dist/core/assets.js

@@ -0,0 +1,81 @@
+import { mkdir, readdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { emptyAnnotations, parseAnnotations } from "./annotations.js";
+import { atomicWrite, exists, relativePosix, resolveInside, uniquePath } from "./fs.js";
+import { ASSETS_DIR } from "./manuals.js";
+import { slugify } from "./text.js";
+const IMAGE_EXT = /^\.(png|jpe?g|gif|webp|svg)$/;
+/** Grava a imagem em `assets/` com nome único e devolve o caminho relativo ao manual. */
+export async function saveAsset(dir, fileName, data) {
+    const ext = path.extname(fileName).toLowerCase();
+    if (!IMAGE_EXT.test(ext))
+        throw new Error(`Formato de imagem não suportado: ${ext || "sem extensão"}`);
+    const name = path.basename(fileName);
+    const abs = await uniquePath(path.join(dir, ASSETS_DIR), slugify(name.slice(0, name.length - ext.length)), ext);
+    await writeFile(abs, data, { flag: "wx" });
+    return relativePosix(dir, abs);
+}
+export async function readAnnotations(dir, assetPath) {
+    const file = annotationsFile(dir, assetPath);
+    if (!(await exists(file)))
+        return emptyAnnotations();
+    return parseAnnotations(JSON.parse(await readFile(file, "utf8")));
+}
+export async function writeAnnotations(dir, assetPath, input) {
+    const annotations = parseAnnotations(input);
+    await atomicWrite(annotationsFile(dir, assetPath), `${JSON.stringify(annotations, null, 2)}\n`);
+    return annotations;
+}
+/** `assets/foto.png` → `assets/foto.png.json`. Só imagens dentro de assets/ têm anotações. */
+function annotationsFile(dir, assetPath) {
+    const abs = resolveInside(dir, assetPath);
+    if (path.dirname(abs) !== path.join(path.resolve(dir), ASSETS_DIR)) {
+        throw new Error("Anotações só existem para imagens em assets/.");
+    }
+    return `${abs}.json`;
+}
+/** Pastas cujos Markdown podem citar imagens: páginas, versões guardadas e lixeira. */
+const MENTION_DIRS = ["pages", ".versoes", ".lixeira"];
+const MENTION = /assets\/([^)\s"'#?]+)/g;
+/**
+ * Arquivos de assets/ que ninguém usa: imagens que nenhuma página, versão ou item da lixeira cita,
+ * e marcações (.json) cuja imagem não existe mais. Devolve caminhos como `assets/tela.png`.
+ */
+export async function findUnusedAssets(dir) {
+    const assetsDir = path.join(dir, ASSETS_DIR);
+    if (!(await exists(assetsDir)))
+        return [];
+    const used = new Set();
+    for (const sub of MENTION_DIRS) {
+        const root = path.join(dir, sub);
+        if (!(await exists(root)))
+            continue;
+        for (const file of await readdir(root, { recursive: true })) {
+            if (!file.endsWith(".md"))
+                continue;
+            for (const [, name] of (await readFile(path.join(root, file), "utf8")).matchAll(MENTION)) {
+                if (name)
+                    used.add(decodeURI(name));
+            }
+        }
+    }
+    const files = await readdir(assetsDir);
+    const names = new Set(files);
+    return files
+        .filter((f) => (f.endsWith(".json") ? !names.has(f.slice(0, -".json".length)) : !used.has(f)))
+        .flatMap((f) => (!f.endsWith(".json") && names.has(`${f}.json`) ? [f, `${f}.json`] : [f]))
+        .filter((f, i, all) => all.indexOf(f) === i)
+        .map((f) => `${ASSETS_DIR}/${f}`);
+}
+/** Move o que `findUnusedAssets` achou para `.lixeira/imagens-<data>/`. Nada é apagado. */
+export async function cleanUnusedAssets(dir) {
+    const unused = await findUnusedAssets(dir);
+    if (unused.length === 0)
+        return { moved: 0, folder: null };
+    const folder = path.join(".lixeira", `imagens-${new Date().toISOString().replace(/[:.]/g, "-")}`);
+    await mkdir(path.join(dir, folder, ASSETS_DIR), { recursive: true });
+    for (const asset of unused)
+        await rename(resolveInside(dir, asset), path.join(dir, folder, asset));
+    return { moved: unused.length, folder: folder.split(path.sep).join("/") };
+}
+//# sourceMappingURL=assets.js.map

package/dist/core/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/core/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,SAAS,GAAG,8BAA8B,CAAC;AAEjD,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,QAAgB,EAAE,IAAgB;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,IAAI,cAAc,EAAE,CAAC,CAAC;IACvG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChH,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,OAAO,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,SAAiB;IAClE,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,gBAAgB,EAAE,CAAC;IACrD,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAiB,EAAE,KAAc;IACnF,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,WAAW,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,8FAA8F;AAC9F,SAAS,eAAe,CAAC,GAAW,EAAE,SAAiB;IACrD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,GAAG,OAAO,CAAC;AACvB,CAAC;AAED,uFAAuF;AACvF,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AACvD,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,SAAS;QACpC,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzF,IAAI,IAAI;oBAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC7F,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACzF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,IAAI,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnG,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/core/export/collect.d.ts

@@ -0,0 +1,27 @@
+import type { ManualMeta } from "../types.js";
+export interface ExportPage {
+    id: string;
+    title: string;
+    /** Posição na árvore, como no sumário: "2", "2.1". */
+    number: string;
+    depth: number;
+    /** Nome do arquivo (`cadastrar-cliente.md`), para achar a página pelos links `./arquivo.md`. */
+    fileName: string;
+    body: string;
+}
+export interface Collected {
+    meta: ManualMeta;
+    pages: ExportPage[];
+    /** Páginas que ficaram de fora, com o motivo (arquivo apagado, versão sumida). */
+    warnings: string[];
+}
+export interface CollectOptions {
+    /** Só páginas aprovadas ou publicadas. Subpágina aprovada entra mesmo com a mãe em rascunho. */
+    onlyApproved?: boolean;
+}
+/**
+ * As páginas na ordem da árvore, com o texto que vai para o manual final: a versão marcada
+ * "No manual" quando existe, senão o texto atual. Página com problema fica de fora e vira aviso.
+ * A numeração conta só as páginas que entram, então o sumário não fica com buracos.
+ */
+export declare function collectPages(dir: string, opts?: CollectOptions): Promise<Collected>;

package/dist/core/export/collect.js

@@ -0,0 +1,49 @@
+import { readManual } from "../manuals.js";
+import { readPage } from "../pages.js";
+import { readVersion } from "../versions.js";
+import { labelsFor } from "./labels.js";
+const APPROVED = ["aprovado", "publicado"];
+/**
+ * As páginas na ordem da árvore, com o texto que vai para o manual final: a versão marcada
+ * "No manual" quando existe, senão o texto atual. Página com problema fica de fora e vira aviso.
+ * A numeração conta só as páginas que entram, então o sumário não fica com buracos.
+ */
+export async function collectPages(dir, opts = {}) {
+    const meta = await readManual(dir);
+    const pages = [];
+    const warnings = [];
+    // `count` é compartilhado com os filhos de uma página que ficou de fora: eles sobem para o lugar dela.
+    const walk = async (nodes, prefix, depth, count) => {
+        for (const node of nodes) {
+            let included = false;
+            let number = prefix;
+            try {
+                const current = await readPage(dir, node.id);
+                if (!opts.onlyApproved || APPROVED.includes(current.status)) {
+                    const source = node.published ? await readVersion(dir, node.id, node.published) : current;
+                    count.n += 1;
+                    number = prefix ? `${prefix}.${count.n}` : String(count.n);
+                    pages.push({
+                        id: node.id,
+                        title: source.title || labelsFor(meta.language).untitled,
+                        number,
+                        depth,
+                        fileName: node.file.split("/").pop() ?? node.file,
+                        body: source.body,
+                    });
+                    included = true;
+                }
+            }
+            catch (err) {
+                warnings.push(`${node.file}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            if (included)
+                await walk(node.children, number, depth + 1, { n: 0 });
+            else
+                await walk(node.children, prefix, depth, count);
+        }
+    };
+    await walk(meta.pages, "", 0, { n: 0 });
+    return { meta, pages, warnings };
+}
+//# sourceMappingURL=collect.js.map

package/dist/core/export/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../src/core/export/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAyBxC,MAAM,QAAQ,GAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAI,GAAmB,EAAE;IACvE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uGAAuG;IACvG,MAAM,IAAI,GAAG,KAAK,EAAE,KAAiB,EAAE,MAAc,EAAE,KAAa,EAAE,KAAoB,EAAE,EAAE;QAC5F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC1F,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;oBACb,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC3D,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,IAAI,CAAC,EAAE;wBACX,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ;wBACxD,MAAM;wBACN,KAAK;wBACL,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI;wBACjD,IAAI,EAAE,MAAM,CAAC,IAAI;qBAClB,CAAC,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,QAAQ;gBAAE,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;;gBAChE,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC"}

package/dist/core/export/html.d.ts

@@ -0,0 +1,6 @@
+import type { Collected } from "./collect.js";
+import { type ImageInfo } from "./refs.js";
+/** Cor da marca, quando o manual não escolheu outra. */
+export declare const DEFAULT_ACCENT = "#2b4fe0";
+/** Um arquivo HTML com o manual inteiro: sumário ao lado, uma seção por página, marcações sobre os prints. */
+export declare function renderHtml(collected: Collected, images: Map<string, ImageInfo>): string;