@nac3/forge-cli 0.2.0-alpha.1

package/dist/nac3/tokens.js

@@ -0,0 +1,138 @@
+/**
+ * NAC-3 design tokens (PLAN sec D1, NAC3.1).
+ *
+ * Single source of truth for colors, fonts, spacing, radii,
+ * and shadows used by the Forge panel (web) and -- after the
+ * NAC3.3 slice -- the RN mirror.
+ *
+ * The TS export is the canonical shape. A side-effect helper
+ * (`tokensToCssVars`) emits the same values as CSS variable
+ * declarations so the existing `panel.ts` CSS can consume
+ * them without further changes.
+ *
+ * Pablo's decision (D7): two packages emparejados. This file
+ * is the embryo of `@yujin/nac3-tokens` -- when the monorepo
+ * lands, it moves under `packages/nac3-tokens/`. The shape
+ * stays identical to avoid a churn refactor in callers.
+ *
+ * ASCII-only on the source. Values are CSS hex / numeric.
+ */
+/** The canonical NAC-3 token set. */
+export const TOKENS = {
+    color: {
+        bg1: '#f5f0e6',
+        bg2: '#e0d8c4',
+        ink: '#1a1a1a',
+        inkMuted: '#555555',
+        inkSubtle: 'rgba(0,0,0,0.55)',
+        indigo: '#4f5b87',
+        amber: '#c8a04d',
+        border: '#d4cbb8',
+        borderSubtle: 'rgba(0,0,0,0.08)',
+        ok: '#3fa85e',
+        err: '#8b3530',
+        warn: '#d4950a',
+        bubbleUser: '#4f5b87',
+        bubbleAsst: '#ffffff',
+    },
+    font: {
+        sans: 'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+        kanji: '"Noto Serif JP", serif',
+        display: '"Inter Display", "Inter", system-ui, sans-serif',
+        mono: 'ui-monospace, "SF Mono", Menlo, monospace',
+    },
+    space: [0, 4, 8, 12, 16, 24, 32, 48, 64],
+    radius: { sm: 4, md: 8, lg: 12, pill: 999 },
+    shadow: {
+        card: { offsetX: 0, offsetY: 12, blur: 36, spread: 0, color: 'rgba(0,0,0,0.18)' },
+        modal: { offsetX: 0, offsetY: 16, blur: 48, spread: 0, color: 'rgba(0,0,0,0.22)' },
+    },
+};
+/**
+ * Emit the color + font + radius tokens as a CSS variable
+ * declaration block, scoped under `:root` by default. The
+ * existing panel CSS consumes these same names; rendering
+ * the block at HTML render time replaces the previous
+ * hardcoded `:root { --bg-1: ... }` block.
+ *
+ * Caller pattern (in `renderPanelHtml`):
+ *
+ *     <style>
+ *       :root { ${tokensToCssVars()} }
+ *       ...rest of the panel CSS...
+ *     </style>
+ */
+export function tokensToCssVars(scope = ':root') {
+    const lines = [];
+    lines.push(scope + ' {');
+    lines.push('  --bg-1: ' + TOKENS.color.bg1 + ';');
+    lines.push('  --bg-2: ' + TOKENS.color.bg2 + ';');
+    lines.push('  --ink: ' + TOKENS.color.ink + ';');
+    lines.push('  --ink-muted: ' + TOKENS.color.inkMuted + ';');
+    lines.push('  --ink-subtle: ' + TOKENS.color.inkSubtle + ';');
+    lines.push('  --indigo: ' + TOKENS.color.indigo + ';');
+    lines.push('  --amber: ' + TOKENS.color.amber + ';');
+    lines.push('  --border: ' + TOKENS.color.border + ';');
+    lines.push('  --border-subtle: ' + TOKENS.color.borderSubtle + ';');
+    lines.push('  --ok: ' + TOKENS.color.ok + ';');
+    lines.push('  --err: ' + TOKENS.color.err + ';');
+    lines.push('  --warn: ' + TOKENS.color.warn + ';');
+    lines.push('  --bubble-user: ' + TOKENS.color.bubbleUser + ';');
+    lines.push('  --bubble-asst: ' + TOKENS.color.bubbleAsst + ';');
+    lines.push('  --font-sans: ' + TOKENS.font.sans + ';');
+    lines.push('  --font-kanji: ' + TOKENS.font.kanji + ';');
+    lines.push('  --font-display: ' + TOKENS.font.display + ';');
+    lines.push('  --font-mono: ' + TOKENS.font.mono + ';');
+    lines.push('  --radius-sm: ' + TOKENS.radius.sm + 'px;');
+    lines.push('  --radius-md: ' + TOKENS.radius.md + 'px;');
+    lines.push('  --radius-lg: ' + TOKENS.radius.lg + 'px;');
+    lines.push('  --shadow-card: '
+        + TOKENS.shadow.card.offsetX + 'px '
+        + TOKENS.shadow.card.offsetY + 'px '
+        + TOKENS.shadow.card.blur + 'px '
+        + TOKENS.shadow.card.spread + 'px '
+        + TOKENS.shadow.card.color + ';');
+    lines.push('  --shadow-modal: '
+        + TOKENS.shadow.modal.offsetX + 'px '
+        + TOKENS.shadow.modal.offsetY + 'px '
+        + TOKENS.shadow.modal.blur + 'px '
+        + TOKENS.shadow.modal.spread + 'px '
+        + TOKENS.shadow.modal.color + ';');
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * RN style object equivalent. NB: shadows are RN-specific
+ * (elevation + shadowOffset for iOS, elevation only on
+ * Android). React Native callers should use this object,
+ * not the CSS string.
+ *
+ * Exported here so a future `@nac3/forge-rn` consumer
+ * doesn't need to re-translate the tokens; same numbers,
+ * same names.
+ */
+export function tokensToRnTheme() {
+    return {
+        color: TOKENS.color,
+        font: TOKENS.font,
+        space: TOKENS.space,
+        radius: TOKENS.radius,
+        shadow: {
+            card: {
+                elevation: 4,
+                shadowOffset: { width: TOKENS.shadow.card.offsetX, height: TOKENS.shadow.card.offsetY },
+                shadowOpacity: 0.18,
+                shadowRadius: TOKENS.shadow.card.blur,
+                shadowColor: '#000000',
+            },
+            modal: {
+                elevation: 8,
+                shadowOffset: { width: TOKENS.shadow.modal.offsetX, height: TOKENS.shadow.modal.offsetY },
+                shadowOpacity: 0.22,
+                shadowRadius: TOKENS.shadow.modal.blur,
+                shadowColor: '#000000',
+            },
+        },
+    };
+}
+//# sourceMappingURL=tokens.js.map

package/dist/nac3/tokens.js.map

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

package/dist/reader/parsers/csv.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CSV / TSV parser for the document reader (V1.22 of HITO 1
+ * -- CSV half; XLSX still pending pending the dep decision).
+ *
+ * Tiny hand-rolled parser. No npm dep. RFC 4180 with the
+ * common-sense relaxations needed for real-world files:
+ *
+ *   - Auto-detects the delimiter: ',' (.csv), '\t' (.tsv),
+ *     or ';' (European CSV) by counting candidates on the
+ *     first non-comment line.
+ *   - Quoted fields ("...") may contain delimiters and
+ *     newlines; double-quote ("") inside a quoted field
+ *     escapes a literal quote.
+ *   - Lines starting with '#' before any data row are
+ *     treated as comments.
+ *   - First non-comment row is the header. Subsequent rows
+ *     are data rows.
+ *
+ * Output shape (for voice readback):
+ *   - One section per data row, heading = "Fila N" where N
+ *     is the 1-based row index.
+ *   - Inside the section, one paragraph per cell, formatted
+ *     "header: value" so the TTS reads naturally without
+ *     needing column-position context.
+ *   - A "table" non-text block appears at the top of the
+ *     document with the row/column counts in its summary.
+ *
+ * Pathological inputs (mismatched quotes, ragged rows)
+ * degrade to "use what we have so far" without crashing.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+export interface ParseCsvOptions {
+    buffer: Buffer;
+    filename: string;
+    language?: string;
+    /** Force a delimiter. Auto-detected when omitted. */
+    delimiter?: ',' | ';' | '\t';
+}
+export declare function parseCsv(opts: ParseCsvOptions): NormalisedDocument;
+//# sourceMappingURL=csv.d.ts.map

package/dist/reader/parsers/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;CAC9B;AA0GD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CA6FlE"}

package/dist/reader/parsers/csv.js

@@ -0,0 +1,221 @@
+/**
+ * CSV / TSV parser for the document reader (V1.22 of HITO 1
+ * -- CSV half; XLSX still pending pending the dep decision).
+ *
+ * Tiny hand-rolled parser. No npm dep. RFC 4180 with the
+ * common-sense relaxations needed for real-world files:
+ *
+ *   - Auto-detects the delimiter: ',' (.csv), '\t' (.tsv),
+ *     or ';' (European CSV) by counting candidates on the
+ *     first non-comment line.
+ *   - Quoted fields ("...") may contain delimiters and
+ *     newlines; double-quote ("") inside a quoted field
+ *     escapes a literal quote.
+ *   - Lines starting with '#' before any data row are
+ *     treated as comments.
+ *   - First non-comment row is the header. Subsequent rows
+ *     are data rows.
+ *
+ * Output shape (for voice readback):
+ *   - One section per data row, heading = "Fila N" where N
+ *     is the 1-based row index.
+ *   - Inside the section, one paragraph per cell, formatted
+ *     "header: value" so the TTS reads naturally without
+ *     needing column-position context.
+ *   - A "table" non-text block appears at the top of the
+ *     document with the row/column counts in its summary.
+ *
+ * Pathological inputs (mismatched quotes, ragged rows)
+ * degrade to "use what we have so far" without crashing.
+ *
+ * ASCII-only.
+ */
+/** Detect the delimiter by counting candidates on the first
+ *  non-comment line. Tab beats semicolon beats comma when
+ *  counts are equal. */
+function detectDelimiter(firstLine, extension) {
+    if (extension === 'tsv' || firstLine.includes('\t'))
+        return '\t';
+    const semis = (firstLine.match(/;/g) || []).length;
+    const commas = (firstLine.match(/,/g) || []).length;
+    if (semis > commas)
+        return ';';
+    return ',';
+}
+/** Parse a CSV/TSV buffer into rows. Honours RFC 4180 quoting. */
+function parseTable(text, forceDelim, extension) {
+    const lines = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    /* Pull comment lines off the top until we hit a non-empty
+       non-# row. */
+    const comments = [];
+    let cursor = 0;
+    while (cursor < lines.length) {
+        const eol = lines.indexOf('\n', cursor);
+        const line = eol < 0 ? lines.slice(cursor) : lines.slice(cursor, eol);
+        if (line.startsWith('#')) {
+            comments.push(line.slice(1).trim());
+            cursor = eol < 0 ? lines.length : eol + 1;
+            continue;
+        }
+        if (line.trim() === '') {
+            cursor = eol < 0 ? lines.length : eol + 1;
+            continue;
+        }
+        break;
+    }
+    const body = lines.slice(cursor);
+    const firstNl = body.indexOf('\n');
+    const firstLine = firstNl < 0 ? body : body.slice(0, firstNl);
+    const delim = forceDelim
+        ?? detectDelimiter(firstLine, extension);
+    /* Tokenise the body honouring quoted fields. */
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    let i = 0;
+    while (i < body.length) {
+        const ch = body.charAt(i);
+        if (inQuotes) {
+            if (ch === '"') {
+                if (body.charAt(i + 1) === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            field += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"' && field === '') {
+            inQuotes = true;
+            i += 1;
+            continue;
+        }
+        if (ch === delim) {
+            row.push(field);
+            field = '';
+            i += 1;
+            continue;
+        }
+        if (ch === '\n') {
+            row.push(field);
+            if (row.length > 1 || row[0] !== '')
+                rows.push(row);
+            row = [];
+            field = '';
+            i += 1;
+            continue;
+        }
+        field += ch;
+        i += 1;
+    }
+    /* Flush trailing line without a final newline. */
+    if (field !== '' || row.length > 0) {
+        row.push(field);
+        if (row.length > 1 || row[0] !== '')
+            rows.push(row);
+    }
+    /* If we ran off the end inside quotes, recover with what we
+       have rather than throwing -- voice readback degrades
+       gracefully. */
+    const header = rows.shift() || [];
+    return { delimiter: delim, header, rows, comments };
+}
+/* ----- document assembly ----- */
+export function parseCsv(opts) {
+    const text = opts.buffer.toString('utf-8');
+    const ext = (opts.filename.toLowerCase().match(/\.([a-z0-9]+)$/) || ['', ''])[1] || '';
+    const parsed = parseTable(text, opts.delimiter, ext);
+    const sections = [];
+    let blockCounter = 0;
+    function nextId(prefix) {
+        blockCounter += 1;
+        return 's-' + prefix + '-' + blockCounter;
+    }
+    /* Top-of-document section with a table summary + comments. */
+    const topBlocks = [];
+    const tableSummary = 'tabla con ' + parsed.rows.length
+        + (parsed.rows.length === 1 ? ' fila' : ' filas')
+        + ' y ' + parsed.header.length
+        + (parsed.header.length === 1 ? ' columna' : ' columnas');
+    const tableBlock = {
+        kind: 'table',
+        id: nextId('table'),
+        summary: tableSummary,
+    };
+    topBlocks.push(tableBlock);
+    for (const c of parsed.comments) {
+        if (c) {
+            topBlocks.push({
+                kind: 'paragraph',
+                level: 0,
+                text: c,
+                id: nextId('cmt'),
+            });
+        }
+    }
+    if (parsed.header.length > 0) {
+        topBlocks.push({
+            kind: 'paragraph',
+            level: 0,
+            text: 'columnas: ' + parsed.header.join(', ') + '.',
+            id: nextId('cols'),
+        });
+    }
+    sections.push({
+        id: 's-0',
+        heading: 'Resumen',
+        level: 1,
+        blocks: [
+            { kind: 'heading', level: 1, text: 'Resumen', id: nextId('h') },
+            ...topBlocks,
+        ],
+    });
+    /* One section per data row. */
+    parsed.rows.forEach((cells, idx) => {
+        const heading = 'Fila ' + (idx + 1);
+        const blocks = [{
+                kind: 'heading', level: 2, text: heading, id: nextId('h'),
+            }];
+        cells.forEach((cell, ci) => {
+            const col = parsed.header[ci] || ('columna ' + (ci + 1));
+            const value = cell.trim();
+            if (value === '')
+                return;
+            blocks.push({
+                kind: 'paragraph',
+                level: 0,
+                text: col + ': ' + value,
+                id: nextId('p'),
+            });
+        });
+        sections.push({
+            id: 's-' + (idx + 1),
+            heading,
+            level: 2,
+            blocks,
+        });
+    });
+    const docId = (opts.filename.split(/[\\/]/).pop() || 'doc')
+        .replace(/\.[^.]+$/, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'doc';
+    const doc = {
+        id: docId,
+        filename: opts.filename,
+        format: 'csv',
+        bytes: opts.buffer.length,
+        title: 'Resumen',
+        sections,
+    };
+    if (opts.language !== undefined)
+        doc.language = opts.language;
+    return doc;
+}
+//# sourceMappingURL=csv.js.map

package/dist/reader/parsers/csv.js.map

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

package/dist/reader/parsers/docx.d.ts

@@ -0,0 +1,31 @@
+/**
+ * DOCX parser for the document reader (V1.17 of HITO 1).
+ *
+ * Uses mammoth (Pablo-approved). DOCX is a ZIP containing
+ * Office Open XML; hand-rolling the schema would burn weeks
+ * and not match real-world Word output anyway. Mammoth
+ * converts DOCX -> HTML which we then pass through the V1.19
+ * HTML parser -- same shape as EPUB, same downstream code
+ * path for sections / paragraphs / lists / tables / images.
+ *
+ * Pipeline:
+ *   1. mammoth.convertToHtml({ buffer }) -> { value: HTML }.
+ *   2. Wrap value in <html><body>...</body></html>.
+ *   3. parseHtml on the result.
+ *   4. Override format='docx' + bytes from the original buffer.
+ *   5. Title = first heading (parseHtml does this already).
+ *
+ * Pathological inputs (corrupt DOCX, encrypted Word docs)
+ * surface mammoth's error in a wrapper -- voice reader stays
+ * alive.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+export interface ParseDocxOptions {
+    buffer: Buffer;
+    filename: string;
+    language?: string;
+}
+export declare function parseDocx(opts: ParseDocxOptions): Promise<NormalisedDocument>;
+//# sourceMappingURL=docx.d.ts.map

package/dist/reader/parsers/docx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/docx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoBnF"}

package/dist/reader/parsers/docx.js

@@ -0,0 +1,51 @@
+/**
+ * DOCX parser for the document reader (V1.17 of HITO 1).
+ *
+ * Uses mammoth (Pablo-approved). DOCX is a ZIP containing
+ * Office Open XML; hand-rolling the schema would burn weeks
+ * and not match real-world Word output anyway. Mammoth
+ * converts DOCX -> HTML which we then pass through the V1.19
+ * HTML parser -- same shape as EPUB, same downstream code
+ * path for sections / paragraphs / lists / tables / images.
+ *
+ * Pipeline:
+ *   1. mammoth.convertToHtml({ buffer }) -> { value: HTML }.
+ *   2. Wrap value in <html><body>...</body></html>.
+ *   3. parseHtml on the result.
+ *   4. Override format='docx' + bytes from the original buffer.
+ *   5. Title = first heading (parseHtml does this already).
+ *
+ * Pathological inputs (corrupt DOCX, encrypted Word docs)
+ * surface mammoth's error in a wrapper -- voice reader stays
+ * alive.
+ *
+ * ASCII-only.
+ */
+import { parseHtml } from './html.js';
+/* Dynamic import wrapper -- mammoth is ESM-ish and lazy
+   loading keeps the cold-start cost off the txt/md path. */
+async function loadMammoth() {
+    /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+    return await import('mammoth');
+}
+export async function parseDocx(opts) {
+    const mammoth = await loadMammoth();
+    let result;
+    try {
+        result = await mammoth.convertToHtml({ buffer: opts.buffer });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error('docx: mammoth could not open the document: ' + msg);
+    }
+    const html = '<html><body>' + (result.value || '') + '</body></html>';
+    const inner = parseHtml({
+        filename: opts.filename,
+        buffer: Buffer.from(html, 'utf-8'),
+        ...(opts.language ? { language: opts.language } : {}),
+    });
+    inner.format = 'docx';
+    inner.bytes = opts.buffer.length;
+    return inner;
+}
+//# sourceMappingURL=docx.js.map

package/dist/reader/parsers/docx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.js","sourceRoot":"","sources":["../../../src/reader/parsers/docx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAStC;4DAC4D;AAC5D,KAAK,UAAU,WAAW;IACxB,iEAAiE;IACjE,OAAO,MAAM,MAAM,CAAC,SAAgB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAsB;IACpD,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,IAAI,MAA+C,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC;IACtE,MAAM,KAAK,GAAG,SAAS,CAAC;QACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/reader/parsers/epub.d.ts

@@ -0,0 +1,39 @@
+/**
+ * EPUB parser for the document reader (V1.21 of HITO 1).
+ *
+ * Hand-rolled. No npm dep -- uses node:zlib for deflate.
+ * EPUB is a ZIP containing:
+ *
+ *   - mimetype file ("application/epub+zip").
+ *   - META-INF/container.xml -> points to the OPF.
+ *   - The OPF (XML) -> declares <manifest> (file list) +
+ *     <spine> (reading order) + <metadata>.
+ *   - XHTML files in the spine carry the actual content.
+ *
+ * Pipeline:
+ *   1. extractZipFiles(buffer) -> Map<path, Buffer>.
+ *   2. read container.xml -> resolve OPF path.
+ *   3. parse OPF -> manifest map (id -> href) + spine order +
+ *      title from <dc:title>.
+ *   4. concatenate the XHTML files in spine order.
+ *   5. parseHtml on the concatenated stream.
+ *   6. override title from OPF metadata.
+ *
+ * The XHTML reuse means images / tables / code blocks render
+ * with the same shape as native HTML docs. CSS is ignored
+ * (no styling matters for voice readback).
+ *
+ * Pathological inputs (corrupt ZIP, missing container.xml,
+ * malformed OPF) throw a loud Error so the caller surfaces
+ * the failure -- never silently returns an empty document.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+export interface ParseEpubOptions {
+    buffer: Buffer;
+    filename: string;
+    language?: string;
+}
+export declare function parseEpub(opts: ParseEpubOptions): NormalisedDocument;
+//# sourceMappingURL=epub.d.ts.map

package/dist/reader/parsers/epub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epub.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/epub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CA+CpE"}