explicai 0.0.0-stage → 0.1.0

package/dist/core/tree.d.ts

@@ -0,0 +1,13 @@
+import type { PageNode } from "./types.js";
+export interface Located {
+    node: PageNode;
+    /** O array que contém o nó, para inserir ou remover sem buscar de novo. */
+    siblings: PageNode[];
+}
+export declare function findNode(nodes: PageNode[], id: string): Located;
+export declare function findIn(nodes: PageNode[], id: string): Located | undefined;
+/** Lista de filhos onde inserir: os da página `parentId`, ou a raiz quando é null. */
+export declare function childrenOf(nodes: PageNode[], parentId: string | null | undefined): PageNode[];
+/** Percorre a árvore em ordem de leitura (pai antes dos filhos). */
+export declare function flatten(nodes: PageNode[]): PageNode[];
+export declare function clampIndex(index: number | undefined, length: number): number;

package/dist/core/tree.js

@@ -0,0 +1,28 @@
+export function findNode(nodes, id) {
+    const found = findIn(nodes, id);
+    if (!found)
+        throw new Error(`Página não encontrada: ${id}`);
+    return found;
+}
+export function findIn(nodes, id) {
+    for (const node of nodes) {
+        if (node.id === id)
+            return { node, siblings: nodes };
+        const inner = findIn(node.children, id);
+        if (inner)
+            return inner;
+    }
+    return undefined;
+}
+/** Lista de filhos onde inserir: os da página `parentId`, ou a raiz quando é null. */
+export function childrenOf(nodes, parentId) {
+    return parentId ? findNode(nodes, parentId).node.children : nodes;
+}
+/** Percorre a árvore em ordem de leitura (pai antes dos filhos). */
+export function flatten(nodes) {
+    return nodes.flatMap((n) => [n, ...flatten(n.children)]);
+}
+export function clampIndex(index, length) {
+    return index === undefined ? length : Math.max(0, Math.min(index, length));
+}
+//# sourceMappingURL=tree.js.map

package/dist/core/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/core/tree.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,QAAQ,CAAC,KAAiB,EAAE,EAAU;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAiB,EAAE,EAAU;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,QAAmC;IAC/E,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AACpE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,MAAc;IAClE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,86 @@
+/** Formato em disco de um manual. Ver docs/manual-format.md. */
+export declare const FORMAT_VERSION = 1;
+/** Nó da árvore de páginas guardada em manual.json. O título fica só no frontmatter da página. */
+export interface PageNode {
+    id: string;
+    /** Caminho relativo à pasta do manual, sempre em `pages/`. */
+    file: string;
+    /** Versão escolhida para o manual final (arquivo em `.versoes/<id>/`). Sem ela, vale o texto atual. */
+    published?: string;
+    children: PageNode[];
+}
+export interface ManualMeta {
+    version: typeof FORMAT_VERSION;
+    title: string;
+    /** Tag BCP 47, como `pt-BR` ou `en-US`. */
+    language: string;
+    /** Aparência do manual exportado. Sem ela, vale a cor da marca. */
+    theme?: ManualTheme;
+    pages: PageNode[];
+}
+export interface ManualTheme {
+    /** Cor de destaque em hexadecimal (#2b4fe0): títulos, links e números dos passos no HTML e no PDF. */
+    accent?: string;
+}
+export interface Manual {
+    /** Caminho absoluto da pasta do manual. */
+    dir: string;
+    meta: ManualMeta;
+}
+/** Etapa da página no fluxo de aprovação. Sem status no arquivo, a página é rascunho. */
+export declare const PAGE_STATUSES: readonly ["rascunho", "revisao", "aprovado", "publicado"];
+export type PageStatus = (typeof PAGE_STATUSES)[number];
+export interface Page {
+    id: string;
+    title: string;
+    status: PageStatus;
+    /** Conteúdo em Markdown, sem o frontmatter. */
+    body: string;
+    file: string;
+}
+/** Coordenadas normalizadas de 0 a 1, relativas à largura e à altura da imagem. */
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Rect extends Point {
+    w: number;
+    h: number;
+}
+export interface Marker extends Point {
+    id: string;
+    /** Número exibido no marcador e na legenda. */
+    n: number;
+    label?: string;
+}
+export interface Highlight extends Rect {
+    id: string;
+}
+export interface Arrow {
+    id: string;
+    from: Point;
+    to: Point;
+}
+export type HotspotTarget = {
+    type: "page";
+    pageId: string;
+} | {
+    type: "anchor";
+    pageId: string;
+    anchor: string;
+} | {
+    type: "url";
+    href: string;
+};
+export interface Hotspot extends Rect {
+    id: string;
+    target: HotspotTarget;
+}
+/** Conteúdo do JSON que fica ao lado de cada imagem (`assets/foto.png.json`). */
+export interface Annotations {
+    version: typeof FORMAT_VERSION;
+    markers: Marker[];
+    highlights: Highlight[];
+    arrows: Arrow[];
+    hotspots: Hotspot[];
+}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+/** Formato em disco de um manual. Ver docs/manual-format.md. */
+export const FORMAT_VERSION = 1;
+/** Etapa da página no fluxo de aprovação. Sem status no arquivo, a página é rascunho. */
+export const PAGE_STATUSES = ["rascunho", "revisao", "aprovado", "publicado"];
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAiChC,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC"}

package/dist/core/versions.d.ts

@@ -0,0 +1,27 @@
+import type { Page } from "./types.js";
+/** Versões guardadas de cada página: `.versoes/<id da página>/<data>.md`, uma cópia completa por versão. */
+export declare const VERSIONS_DIR = ".versoes";
+export interface VersionInfo {
+    id: string;
+    title: string;
+    /** Nome que a pessoa deu ao guardar ("Revisado pelo suporte"). Pode ser vazio. */
+    note: string;
+    savedAt: string;
+    /** É a versão escolhida para o manual final. */
+    published: boolean;
+}
+export interface Version extends VersionInfo {
+    body: string;
+}
+/** Guarda o texto atual da página como uma versão nova. */
+export declare function saveVersion(dir: string, pageId: string, note?: string): Promise<VersionInfo>;
+/** Versões da página, da mais recente para a mais antiga. */
+export declare function listVersions(dir: string, pageId: string): Promise<VersionInfo[]>;
+export declare function readVersion(dir: string, pageId: string, versionId: string): Promise<Version>;
+/**
+ * Volta a página para o texto da versão. O texto que estava antes vira uma versão
+ * ("Antes de restaurar"), para restaurar nunca apagar nada.
+ */
+export declare function restoreVersion(dir: string, pageId: string, versionId: string): Promise<Page>;
+/** Escolhe a versão que vai para o manual final. `null` volta a valer o texto atual da página. */
+export declare function publishVersion(dir: string, pageId: string, versionId: string | null): Promise<void>;

package/dist/core/versions.js

@@ -0,0 +1,82 @@
+import { mkdir, readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { joinFrontmatter, splitFrontmatter } from "./frontmatter.js";
+import { atomicWrite, exists, resolveInside, uniquePath } from "./fs.js";
+import { readManual, updateManual } from "./manuals.js";
+import { readPage, updatePage } from "./pages.js";
+import { findNode } from "./tree.js";
+/** Versões guardadas de cada página: `.versoes/<id da página>/<data>.md`, uma cópia completa por versão. */
+export const VERSIONS_DIR = ".versoes";
+const pageVersionsDir = (dir, pageId) => resolveInside(dir, path.posix.join(VERSIONS_DIR, pageId));
+const versionFile = (dir, pageId, versionId) => resolveInside(pageVersionsDir(dir, pageId), `${versionId}.md`);
+/** Guarda o texto atual da página como uma versão nova. */
+export async function saveVersion(dir, pageId, note = "") {
+    const page = await readPage(dir, pageId);
+    const savedAt = new Date().toISOString();
+    const folder = pageVersionsDir(dir, pageId);
+    await mkdir(folder, { recursive: true });
+    // A data vira o nome do arquivo: a pasta fica em ordem e legível sem o Studio.
+    const file = await uniquePath(folder, savedAt.replace(/[:.]/g, "-"), ".md");
+    const clean = note.trim().slice(0, 200);
+    await atomicWrite(file, joinFrontmatter({ id: page.id, title: page.title, savedAt, note: clean }, page.body));
+    return { id: path.basename(file, ".md"), title: page.title, note: clean, savedAt, published: false };
+}
+/** Versões da página, da mais recente para a mais antiga. */
+export async function listVersions(dir, pageId) {
+    const { node } = findNode((await readManual(dir)).pages, pageId);
+    const folder = pageVersionsDir(dir, pageId);
+    if (!(await exists(folder)))
+        return [];
+    const list = [];
+    for (const name of await readdir(folder)) {
+        if (!name.endsWith(".md"))
+            continue;
+        const { body: _, ...info } = await readVersionFile(path.join(folder, name), node.published);
+        list.push(info);
+    }
+    return list.sort((a, b) => b.savedAt.localeCompare(a.savedAt));
+}
+export async function readVersion(dir, pageId, versionId) {
+    const { node } = findNode((await readManual(dir)).pages, pageId);
+    return readVersionFile(versionFile(dir, pageId, versionId), node.published);
+}
+/**
+ * Volta a página para o texto da versão. O texto que estava antes vira uma versão
+ * ("Antes de restaurar"), para restaurar nunca apagar nada.
+ */
+export async function restoreVersion(dir, pageId, versionId) {
+    const version = await readVersion(dir, pageId, versionId);
+    const current = await readPage(dir, pageId);
+    if (current.title !== version.title || current.body !== version.body) {
+        await saveVersion(dir, pageId, "Antes de restaurar");
+    }
+    return updatePage(dir, pageId, { title: version.title, body: version.body });
+}
+/** Escolhe a versão que vai para o manual final. `null` volta a valer o texto atual da página. */
+export async function publishVersion(dir, pageId, versionId) {
+    if (versionId !== null)
+        await readVersion(dir, pageId, versionId);
+    await updateManual(dir, (meta) => {
+        const { node } = findNode(meta.pages, pageId);
+        if (versionId === null)
+            delete node.published;
+        else
+            node.published = versionId;
+    });
+}
+async function readVersionFile(file, published) {
+    let text;
+    try {
+        text = await readFile(file, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            throw new Error(`Versão não encontrada: ${path.basename(file, ".md")}`);
+        throw err;
+    }
+    const { data, body } = splitFrontmatter(text);
+    const id = path.basename(file, ".md");
+    const str = (v) => (typeof v === "string" ? v : "");
+    return { id, title: str(data.title), note: str(data.note), savedAt: str(data.savedAt), published: id === published, body };
+}
+//# sourceMappingURL=versions.js.map

package/dist/core/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/core/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,4GAA4G;AAC5G,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAgBvC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;AACnH,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrE,aAAa,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;AAEjE,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,MAAc,EAAE,IAAI,GAAG,EAAE;IACtE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,+EAA+E;IAC/E,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9G,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACvG,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc;IAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,MAAc,EAAE,SAAiB;IAC9E,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,eAAe,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,MAAc,EAAE,SAAiB;IACjF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QACrE,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,MAAc,EAAE,SAAwB;IACxF,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;;YACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,SAA6B;IACxE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAAyB,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1H,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7H,CAAC"}

package/dist/server/http.d.ts

@@ -0,0 +1,23 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** O que um handler devolve. O servidor transforma em resposta HTTP. */
+export type Reply = {
+    kind: "json";
+    status: number;
+    body: unknown;
+} | {
+    kind: "file";
+    path: string;
+    cache: string;
+};
+export declare const json: (body: unknown, status?: number) => Reply;
+export declare const file: (filePath: string, cache?: string) => Reply;
+export declare function send(res: ServerResponse, reply: Reply): Promise<void>;
+export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
+export declare function readBody(req: IncomingMessage, limit: number): Promise<Uint8Array>;
+export declare function readJson(req: IncomingMessage): Promise<Record<string, unknown>>;
+/** Status HTTP para um erro vindo do core: "não encontrado" e arquivo inexistente viram 404, o resto 400. */
+export declare function statusOf(err: unknown): number;

package/dist/server/http.js

@@ -0,0 +1,78 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+export const json = (body, status = 200) => ({ kind: "json", status, body });
+export const file = (filePath, cache = "no-cache") => ({ kind: "file", path: filePath, cache });
+const MIME = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".woff2": "font/woff2",
+    ".pdf": "application/pdf",
+    ".md": "text/markdown; charset=utf-8",
+};
+export async function send(res, reply) {
+    if (reply.kind === "json")
+        return sendJson(res, reply.status, reply.body);
+    const data = await readFile(reply.path);
+    res.writeHead(200, {
+        "content-type": MIME[path.extname(reply.path).toLowerCase()] ?? "application/octet-stream",
+        "cache-control": reply.cache,
+        "x-content-type-options": "nosniff",
+    });
+    res.end(data);
+}
+export function sendJson(res, status, body) {
+    res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+    res.end(JSON.stringify(body));
+}
+export async function readBody(req, limit) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        size += chunk.length;
+        // Passou do limite: continua lendo sem guardar. Parar no meio derruba a conexão e o navegador
+        // nunca recebe o 413. shortcut: lê o envio inteiro; tudo bem só porque o servidor é local.
+        if (size <= limit)
+            chunks.push(chunk);
+    }
+    if (size > limit)
+        throw new HttpError(413, `Arquivo maior que ${limit / 1024 / 1024} MB.`);
+    return Buffer.concat(chunks);
+}
+export async function readJson(req) {
+    const text = Buffer.from(await readBody(req, 5 * 1024 * 1024)).toString("utf8");
+    let data;
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        throw new HttpError(400, "O corpo da requisição não é um JSON válido.");
+    }
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new HttpError(400, "O corpo da requisição deve ser um objeto JSON.");
+    }
+    return data;
+}
+/** Status HTTP para um erro vindo do core: "não encontrado" e arquivo inexistente viram 404, o resto 400. */
+export function statusOf(err) {
+    if (err instanceof HttpError)
+        return err.status;
+    const missing = (err instanceof Error && /não encontrad/i.test(err.message)) ||
+        (typeof err === "object" && err !== null && err.code === "ENOENT");
+    return missing ? 404 : 400;
+}
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+import { type Server } from "node:http";
+import { type StudioOptions } from "./router.js";
+export type { StudioOptions } from "./router.js";
+export declare function createStudioServer(opts: StudioOptions): Server;

package/dist/server/index.js

@@ -0,0 +1,30 @@
+import { createServer } from "node:http";
+import { HttpError, send, sendJson, statusOf } from "./http.js";
+import { matchRoute } from "./router.js";
+import { assetRoutes } from "./routes/assets.js";
+import { exportRoutes } from "./routes/export.js";
+import { manualRoutes } from "./routes/manuals.js";
+import { pageRoutes } from "./routes/pages.js";
+import { versionRoutes } from "./routes/versions.js";
+import { webRoutes } from "./routes/web.js";
+import { assertLocalRequest } from "./security.js";
+/** A ordem importa: a rota genérica do editor (`/*`) fica por último. */
+const routes = [...manualRoutes, ...pageRoutes, ...versionRoutes, ...exportRoutes, ...assetRoutes, ...webRoutes];
+export function createStudioServer(opts) {
+    return createServer(async (req, res) => {
+        try {
+            assertLocalRequest(req);
+            const url = new URL(req.url ?? "/", "http://localhost");
+            const segments = url.pathname.split("/").filter(Boolean).map(decodeURIComponent);
+            const method = req.method ?? "GET";
+            const match = matchRoute(routes, method, segments);
+            if (!match)
+                throw new HttpError(segments[0] === "api" ? 405 : 404, "Rota não encontrada.");
+            await send(res, await match.route.handle({ req, url, params: match.params, rest: match.rest, opts }));
+        }
+        catch (err) {
+            sendJson(res, statusOf(err), { error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,UAAU,EAAkC,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAInD,yEAAyE;AACzE,MAAM,MAAM,GAAY,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC;AAE1H,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,OAAO,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;YACnC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;YAC3F,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/router.d.ts

@@ -0,0 +1,30 @@
+import type { IncomingMessage } from "node:http";
+import type { Reply } from "./http.js";
+export interface StudioOptions {
+    /** Pasta onde ficam os manuais. */
+    workspace: string;
+    /** Pasta com o build do editor (index.html e assets). Sem ela, só a API responde. */
+    webDir?: string;
+}
+export interface RouteContext {
+    req: IncomingMessage;
+    url: URL;
+    /** Segmentos `:nome` do padrão da rota, já decodificados. */
+    params: Record<string, string>;
+    /** O que veio depois de um `*` no fim do padrão. */
+    rest: string;
+    opts: StudioOptions;
+}
+export interface Route {
+    method: string;
+    /** Ex.: `/api/manuals/:slug/pages/:id`. Um `*` no fim aceita o resto do caminho. */
+    path: string;
+    handle: (ctx: RouteContext) => Promise<Reply> | Reply;
+}
+export type Match = {
+    route: Route;
+    params: Record<string, string>;
+    rest: string;
+};
+/** Primeira rota cujo método e padrão batem. A ordem da tabela define a prioridade. */
+export declare function matchRoute(routes: Route[], method: string, segments: string[]): Match | null;

package/dist/server/router.js

@@ -0,0 +1,28 @@
+/** Primeira rota cujo método e padrão batem. A ordem da tabela define a prioridade. */
+export function matchRoute(routes, method, segments) {
+    for (const route of routes) {
+        if (route.method !== method)
+            continue;
+        const match = matchPath(route.path, segments);
+        if (match)
+            return { route, ...match };
+    }
+    return null;
+}
+function matchPath(pattern, segments) {
+    const parts = pattern.split("/").filter(Boolean);
+    const params = {};
+    for (const [i, part] of parts.entries()) {
+        if (part === "*")
+            return { params, rest: segments.slice(i).join("/") };
+        const seg = segments[i];
+        if (seg === undefined)
+            return null;
+        if (part.startsWith(":"))
+            params[part.slice(1)] = seg;
+        else if (part !== seg)
+            return null;
+    }
+    return parts.length === segments.length ? { params, rest: "" } : null;
+}
+//# sourceMappingURL=router.js.map

package/dist/server/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/server/router.ts"],"names":[],"mappings":"AA6BA,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,MAAc,EAAE,QAAkB;IAC5E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,QAAkB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;aACjD,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC"}

package/dist/server/routes/assets.d.ts

@@ -0,0 +1,2 @@
+import type { Route } from "../router.js";
+export declare const assetRoutes: Route[];

package/dist/server/routes/assets.js

@@ -0,0 +1,44 @@
+import { cleanUnusedAssets, findUnusedAssets, readAnnotations, resolveInside, saveAsset, writeAnnotations, } from "../../core/index.js";
+import { file, json, readBody, readJson } from "../http.js";
+import { manualDir } from "../workspace.js";
+const MAX_UPLOAD = 20 * 1024 * 1024;
+export const assetRoutes = [
+    {
+        method: "POST",
+        path: "/api/manuals/:slug/assets",
+        handle: async (ctx) => {
+            const name = ctx.url.searchParams.get("name") ?? "imagem.png";
+            const data = await readBody(ctx.req, MAX_UPLOAD);
+            return json({ path: await saveAsset(manualDir(ctx), name, data) }, 201);
+        },
+    },
+    {
+        method: "GET",
+        path: "/api/manuals/:slug/annotations",
+        handle: async (ctx) => json(await readAnnotations(manualDir(ctx), ctx.url.searchParams.get("asset") ?? "")),
+    },
+    {
+        method: "PUT",
+        path: "/api/manuals/:slug/annotations",
+        handle: async (ctx) => json(await writeAnnotations(manualDir(ctx), ctx.url.searchParams.get("asset") ?? "", await readJson(ctx.req))),
+    },
+    {
+        // Imagens e marcações que nenhuma página, versão ou item da lixeira usa.
+        method: "GET",
+        path: "/api/manuals/:slug/assets/unused",
+        handle: async (ctx) => json({ count: (await findUnusedAssets(manualDir(ctx))).length }),
+    },
+    {
+        // Move as sem uso para .lixeira/imagens-<data>/. Nada é apagado.
+        method: "POST",
+        path: "/api/manuals/:slug/assets/clean",
+        handle: async (ctx) => json(await cleanUnusedAssets(manualDir(ctx))),
+    },
+    {
+        // Imagens do manual, usadas pelo editor: /files/<manual>/assets/<arquivo>
+        method: "GET",
+        path: "/files/:slug/*",
+        handle: (ctx) => file(resolveInside(manualDir(ctx), ctx.rest)),
+    },
+];
+//# sourceMappingURL=assets.js.map

package/dist/server/routes/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/server/routes/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1E,CAAC;KACF;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gCAAgC;QACtC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;KAC5G;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gCAAgC;QACtC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CACpB,IAAI,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;KACjH;IACD;QACE,yEAAyE;QACzE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,kCAAkC;QACxC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACxF;IACD;QACE,iEAAiE;QACjE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iCAAiC;QACvC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;KACrE;IACD;QACE,0EAA0E;QAC1E,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;KAC/D;CACF,CAAC"}

package/dist/server/routes/export.d.ts

@@ -0,0 +1,2 @@
+import type { Route } from "../router.js";
+export declare const exportRoutes: Route[];

package/dist/server/routes/export.js

@@ -0,0 +1,33 @@
+import { EXPORT_FORMATS, exportManual, setManualTheme } from "../../core/index.js";
+import { HttpError, json, readJson } from "../http.js";
+import { manualDir, optionalString } from "../workspace.js";
+export const exportRoutes = [
+    {
+        // { format: "html" | "pdf" | "markdown", onlyApproved?: true }. Devolve o arquivo gerado e o endereço para abrir no navegador.
+        method: "POST",
+        path: "/api/manuals/:slug/export",
+        handle: async (ctx) => {
+            const body = await readJson(ctx.req);
+            const format = optionalString(body.format);
+            if (!format || !EXPORT_FORMATS.includes(format)) {
+                throw new HttpError(400, `Formato de exportação inválido. Use ${EXPORT_FORMATS.join(", ")}.`);
+            }
+            const result = await exportManual(manualDir(ctx), format, { onlyApproved: body.onlyApproved === true });
+            return json({ ...result, url: `/files/${encodeURIComponent(ctx.params.slug ?? "")}/${result.file}` });
+        },
+    },
+    {
+        // { accent: "#2b4fe0" } escolhe a cor do manual exportado; { accent: null } volta à da marca.
+        method: "PUT",
+        path: "/api/manuals/:slug/theme",
+        handle: async (ctx) => {
+            const body = await readJson(ctx.req);
+            const accent = body.accent === null ? undefined : optionalString(body.accent);
+            if (accent === undefined && body.accent !== null)
+                throw new HttpError(400, "Informe accent (texto ou null).");
+            await setManualTheme(manualDir(ctx), accent ? { accent } : {});
+            return json({ ok: true });
+        },
+    },
+];
+//# sourceMappingURL=export.js.map

package/dist/server/routes/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/server/routes/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC;QACE,+HAA+H;QAC/H,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAA6B,CAAC;YACvE,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,uCAAuC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC,CAAC;YACxG,OAAO,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,UAAU,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxG,CAAC;KACF;IACD;QACE,8FAA8F;QAC9F,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9E,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAC9G,MAAM,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC;KACF;CACF,CAAC"}

package/dist/server/routes/manuals.d.ts

@@ -0,0 +1,2 @@
+import type { Route } from "../router.js";
+export declare const manualRoutes: Route[];

package/dist/server/routes/manuals.js

@@ -0,0 +1,40 @@
+import path from "node:path";
+import { createManual, listManuals, readManual, readPageTree } from "../../core/index.js";
+import { json, readJson } from "../http.js";
+import { manualDir, optionalString } from "../workspace.js";
+const summary = (m) => ({ slug: path.basename(m.dir), title: m.meta.title, language: m.meta.language });
+export const manualRoutes = [
+    {
+        method: "GET",
+        path: "/api/manuals",
+        handle: async ({ opts }) => json((await listManuals(opts.workspace)).map(summary)),
+    },
+    {
+        method: "POST",
+        path: "/api/manuals",
+        handle: async ({ opts, req }) => {
+            const body = await readJson(req);
+            const manual = await createManual(opts.workspace, {
+                title: optionalString(body.title) ?? "",
+                language: optionalString(body.language) ?? "pt-BR",
+            });
+            return json(summary(manual), 201);
+        },
+    },
+    {
+        method: "GET",
+        path: "/api/manuals/:slug",
+        handle: async (ctx) => {
+            const dir = manualDir(ctx);
+            const meta = await readManual(dir);
+            return json({
+                slug: ctx.params.slug,
+                title: meta.title,
+                language: meta.language,
+                theme: meta.theme ?? {},
+                pages: await readPageTree(dir),
+            });
+        },
+    },
+];
+//# sourceMappingURL=manuals.js.map

package/dist/server/routes/manuals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manuals.js","sourceRoot":"","sources":["../../../src/server/routes/manuals.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAe,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEhH,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;KACnF;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE;gBAChD,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;gBACvC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO;aACnD,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;KACF;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;gBACV,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,KAAK,EAAE,MAAM,YAAY,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC"}

package/dist/server/routes/pages.d.ts

@@ -0,0 +1,2 @@
+import type { Route } from "../router.js";
+export declare const pageRoutes: Route[];