@nac3/forge-cli 0.2.0-alpha.1

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Source-code parser for the document reader.
+ *
+ * Treats a source file as a sequence of paragraph-like blocks
+ * with language metadata. Splits by blank lines (function /
+ * block separators in most languages). Each chunk becomes a
+ * TextBlock of kind 'paragraph' -- the reader can announce
+ * "block 1: function foo", "block 2: function bar", etc.
+ *
+ * Optional fine-grained walk: each chunk longer than 8 lines
+ * gets split into 4-line sub-blocks so playback does not
+ * drone for two minutes on a single function. Tunable via
+ * MAX_BLOCK_LINES.
+ *
+ * Language is mapped from the file extension.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+declare const MAX_BLOCK_LINES = 8;
+declare const SUB_BLOCK_LINES = 4;
+declare const EXT_TO_LANG: Record<string, string>;
+export interface ParseSourceOptions {
+    buffer: Buffer;
+    filename: string;
+    /** Optional language override. Defaults to extension-based map. */
+    language?: string;
+}
+export declare function parseSource(opts: ParseSourceOptions): NormalisedDocument;
+export declare function langFromExt(filename: string): string | undefined;
+export { EXT_TO_LANG, MAX_BLOCK_LINES, SUB_BLOCK_LINES };
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,aAAa,CAAC;AAE1E,QAAA,MAAM,eAAe,IAAI,CAAC;AAC1B,QAAA,MAAM,eAAe,IAAI,CAAC;AAE1B,QAAA,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0BvC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CA2BxE;AAkCD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIhE;AASD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/reader/parsers/source.js

@@ -0,0 +1,122 @@
+/**
+ * Source-code parser for the document reader.
+ *
+ * Treats a source file as a sequence of paragraph-like blocks
+ * with language metadata. Splits by blank lines (function /
+ * block separators in most languages). Each chunk becomes a
+ * TextBlock of kind 'paragraph' -- the reader can announce
+ * "block 1: function foo", "block 2: function bar", etc.
+ *
+ * Optional fine-grained walk: each chunk longer than 8 lines
+ * gets split into 4-line sub-blocks so playback does not
+ * drone for two minutes on a single function. Tunable via
+ * MAX_BLOCK_LINES.
+ *
+ * Language is mapped from the file extension.
+ *
+ * ASCII-only.
+ */
+const MAX_BLOCK_LINES = 8;
+const SUB_BLOCK_LINES = 4;
+const EXT_TO_LANG = {
+    ts: 'TypeScript', tsx: 'TSX',
+    js: 'JavaScript', jsx: 'JSX', mjs: 'JavaScript', cjs: 'JavaScript',
+    py: 'Python', pyi: 'Python',
+    rb: 'Ruby',
+    java: 'Java', kt: 'Kotlin', kts: 'Kotlin',
+    scala: 'Scala',
+    c: 'C', h: 'C',
+    cpp: 'Cpp', hpp: 'Cpp', cc: 'Cpp', cxx: 'Cpp', hxx: 'Cpp',
+    cs: 'CSharp',
+    rs: 'Rust',
+    go: 'Go',
+    swift: 'Swift',
+    php: 'PHP',
+    sh: 'Shell', bash: 'Shell', zsh: 'Shell', fish: 'Shell',
+    sql: 'SQL',
+    html: 'HTML', htm: 'HTML',
+    css: 'CSS', scss: 'SCSS', sass: 'Sass', less: 'Less',
+    json: 'JSON', jsonc: 'JSONC',
+    yaml: 'YAML', yml: 'YAML',
+    toml: 'TOML',
+    xml: 'XML',
+    vue: 'Vue', svelte: 'Svelte',
+    lua: 'Lua',
+    r: 'R',
+    pl: 'Perl', pm: 'Perl',
+};
+export function parseSource(opts) {
+    const text = opts.buffer.toString('utf-8')
+        .replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const language = opts.language ?? langFromExt(opts.filename);
+    const blocks = splitIntoBlocks(text);
+    const textBlocks = blocks.map((lines, i) => ({
+        kind: 'paragraph',
+        level: 0,
+        text: lines.join('\n'),
+        id: 'src-' + (i + 1),
+    }));
+    const section = {
+        id: 's-0',
+        heading: '',
+        level: 0,
+        blocks: textBlocks,
+    };
+    const title = opts.filename.replace(/\.[^.]+$/, '');
+    return {
+        id: slugifyFilename(opts.filename),
+        filename: opts.filename,
+        format: 'source',
+        bytes: opts.buffer.length,
+        title,
+        ...(language ? { language } : {}),
+        sections: [section],
+    };
+}
+/** Split source into block-sized chunks. */
+function splitIntoBlocks(text) {
+    const allLines = text.split('\n');
+    /* First pass: paragraph-like splits on blank lines. */
+    const paragraphs = [];
+    let current = [];
+    for (const line of allLines) {
+        if (line.trim() === '') {
+            if (current.length > 0) {
+                paragraphs.push(current);
+                current = [];
+            }
+        }
+        else {
+            current.push(line);
+        }
+    }
+    if (current.length > 0)
+        paragraphs.push(current);
+    /* Second pass: chunks larger than MAX_BLOCK_LINES get split. */
+    const out = [];
+    for (const p of paragraphs) {
+        if (p.length <= MAX_BLOCK_LINES) {
+            out.push(p);
+        }
+        else {
+            for (let i = 0; i < p.length; i += SUB_BLOCK_LINES) {
+                out.push(p.slice(i, i + SUB_BLOCK_LINES));
+            }
+        }
+    }
+    return out;
+}
+export function langFromExt(filename) {
+    const m = filename.toLowerCase().match(/\.([a-z0-9]+)$/);
+    if (!m)
+        return undefined;
+    return EXT_TO_LANG[m[1]];
+}
+function slugifyFilename(name) {
+    return name.toLowerCase()
+        .replace(/\.[^.]+$/, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'source';
+}
+export { EXT_TO_LANG, MAX_BLOCK_LINES, SUB_BLOCK_LINES };
+//# sourceMappingURL=source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/reader/parsers/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,WAAW,GAA2B;IAC1C,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK;IAC5B,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY;IAClE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ;IAC3B,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ;IACzC,KAAK,EAAE,OAAO;IACd,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IACd,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK;IACzD,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;IACvD,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACzB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IACpD,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAC5B,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACzB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ;IAC5B,GAAG,EAAE,KAAK;IACV,CAAC,EAAE,GAAG;IACN,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CACvB,CAAC;AASF,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;SACvC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAgB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;KACrB,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,UAAU;KACnB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO;QACL,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QACzB,KAAK;QACL,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,uDAAuD;IACvD,MAAM,UAAU,GAAe,EAAE,CAAC;IAClC,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjD,gEAAgE;IAChE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;gBACnD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC;AACzC,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Plain-text parser for the document reader.
+ *
+ * A .txt file is broken into paragraphs by blank lines. Each
+ * paragraph becomes a TextBlock of kind 'paragraph'. The whole
+ * document lives under a single anonymous section (level 0,
+ * empty heading).
+ *
+ * Tabular or pre-formatted text inside a .txt is NOT special-
+ * cased -- it stays as paragraph blocks. Adopters who need
+ * table awareness can mark up the file as Markdown instead.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+export interface ParseTxtOptions {
+    /** Source bytes. */
+    buffer: Buffer;
+    /** Original filename. */
+    filename: string;
+    /** Optional language hint. */
+    language?: string;
+}
+export declare function parseTxt(opts: ParseTxtOptions): NormalisedDocument;
+//# sourceMappingURL=txt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"txt.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/txt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,aAAa,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CA0BlE"}

package/dist/reader/parsers/txt.js

@@ -0,0 +1,56 @@
+/**
+ * Plain-text parser for the document reader.
+ *
+ * A .txt file is broken into paragraphs by blank lines. Each
+ * paragraph becomes a TextBlock of kind 'paragraph'. The whole
+ * document lives under a single anonymous section (level 0,
+ * empty heading).
+ *
+ * Tabular or pre-formatted text inside a .txt is NOT special-
+ * cased -- it stays as paragraph blocks. Adopters who need
+ * table awareness can mark up the file as Markdown instead.
+ *
+ * ASCII-only.
+ */
+export function parseTxt(opts) {
+    const text = opts.buffer.toString('utf-8');
+    const paragraphs = splitParagraphs(text);
+    const blocks = paragraphs.map((p, i) => ({
+        kind: 'paragraph',
+        level: 0,
+        text: p,
+        id: 'p-' + (i + 1),
+    }));
+    const section = {
+        id: 's-0',
+        heading: '',
+        level: 0,
+        blocks,
+    };
+    /* Pick a title: filename without extension. */
+    const title = opts.filename.replace(/\.[^.]+$/, '');
+    return {
+        id: slugifyFilename(opts.filename),
+        filename: opts.filename,
+        format: 'txt',
+        bytes: opts.buffer.length,
+        title,
+        ...(opts.language ? { language: opts.language } : {}),
+        sections: [section],
+    };
+}
+function splitParagraphs(text) {
+    /* Normalise line endings, split on blank lines, trim each. */
+    const normalised = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    return normalised
+        .split(/\n\s*\n+/)
+        .map((p) => p.replace(/\s+/g, ' ').trim())
+        .filter((p) => p.length > 0);
+}
+function slugifyFilename(name) {
+    return name.toLowerCase()
+        .replace(/\.[^.]+$/, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'doc';
+}
+//# sourceMappingURL=txt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"txt.js","sourceRoot":"","sources":["../../../src/reader/parsers/txt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAgB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;KACnB,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,CAAC;QACR,MAAM;KACP,CAAC;IACF,+CAA+C;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO;QACL,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QACzB,KAAK;QACL,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,8DAA8D;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpE,OAAO,UAAU;SACd,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * XLSX parser for the document reader (V1.22 of HITO 1,
+ * XLSX half -- CSV half shipped in V1.22 earlier).
+ *
+ * Uses xlsx (Pablo-approved). XLSX is Office Open XML in a
+ * ZIP with shared-strings + styles + per-sheet XML; hand-
+ * rolling it is a multi-week project that would not match
+ * Excel output anyway. sheetjs reads + emits row arrays we
+ * convert to the same voice-readback shape as the CSV parser:
+ *
+ *   - One section per sheet ("Hoja: <name>").
+ *   - First non-empty row treated as the header.
+ *   - One paragraph per data row, formatted "header: value"
+ *     for each non-empty cell.
+ *   - Table summary block at the top of each sheet section
+ *     ("tabla con N filas y M columnas").
+ *
+ * Multi-sheet workbooks read sheet-by-sheet in the order
+ * SheetNames defines.
+ *
+ * Pathological inputs (encrypted xlsx, corrupt OOXML) wrap
+ * sheetjs's error so the voice reader stays alive.
+ *
+ * ASCII-only.
+ */
+import type { NormalisedDocument } from '../types.js';
+export interface ParseXlsxOptions {
+    buffer: Buffer;
+    filename: string;
+    language?: string;
+}
+export declare function parseXlsx(opts: ParseXlsxOptions): Promise<NormalisedDocument>;
+//# sourceMappingURL=xlsx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.d.ts","sourceRoot":"","sources":["../../../src/reader/parsers/xlsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,aAAa,CAAC;AAEpF,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,CAoHnF"}

package/dist/reader/parsers/xlsx.js

@@ -0,0 +1,143 @@
+/**
+ * XLSX parser for the document reader (V1.22 of HITO 1,
+ * XLSX half -- CSV half shipped in V1.22 earlier).
+ *
+ * Uses xlsx (Pablo-approved). XLSX is Office Open XML in a
+ * ZIP with shared-strings + styles + per-sheet XML; hand-
+ * rolling it is a multi-week project that would not match
+ * Excel output anyway. sheetjs reads + emits row arrays we
+ * convert to the same voice-readback shape as the CSV parser:
+ *
+ *   - One section per sheet ("Hoja: <name>").
+ *   - First non-empty row treated as the header.
+ *   - One paragraph per data row, formatted "header: value"
+ *     for each non-empty cell.
+ *   - Table summary block at the top of each sheet section
+ *     ("tabla con N filas y M columnas").
+ *
+ * Multi-sheet workbooks read sheet-by-sheet in the order
+ * SheetNames defines.
+ *
+ * Pathological inputs (encrypted xlsx, corrupt OOXML) wrap
+ * sheetjs's error so the voice reader stays alive.
+ *
+ * ASCII-only.
+ */
+/* sheetjs is CJS interop; lazy dynamic import keeps cold
+   start off the txt/md path. */
+async function loadXlsx() {
+    /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+    return await import('xlsx');
+}
+export async function parseXlsx(opts) {
+    const xlsxMod = await loadXlsx();
+    /* sheetjs exposes either the default export or named
+       functions depending on bundler; tolerate both. */
+    const XLSX = xlsxMod.default ?? xlsxMod;
+    let wb;
+    try {
+        wb = XLSX.read(new Uint8Array(opts.buffer), { type: 'array' });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error('xlsx: sheetjs could not open the document: ' + msg);
+    }
+    const sections = [];
+    let blockCounter = 0;
+    function nextId(prefix) {
+        blockCounter += 1;
+        return 's-' + prefix + '-' + blockCounter;
+    }
+    const sheetNames = wb.SheetNames || [];
+    let firstSheetTitle = '';
+    sheetNames.forEach((name, idx) => {
+        const sheet = wb.Sheets[name];
+        if (!sheet)
+            return;
+        /* json with header=1 returns array-of-arrays; defval ''
+           so empty cells stay positional. */
+        const rows = XLSX.utils.sheet_to_json(sheet, { header: 1, defval: '', raw: false });
+        /* Skip leading fully-empty rows so the header row is the
+           first row with content. */
+        while (rows.length > 0 && rows[0].every((c) => String(c).trim() === '')) {
+            rows.shift();
+        }
+        if (rows.length === 0)
+            return;
+        const header = rows.shift().map((c) => String(c).trim());
+        const dataRows = rows.filter((r) => r.some((c) => String(c).trim() !== ''));
+        const heading = 'Hoja: ' + name;
+        if (idx === 0)
+            firstSheetTitle = name;
+        const tableSummary = 'tabla con ' + dataRows.length
+            + (dataRows.length === 1 ? ' fila' : ' filas')
+            + ' y ' + header.length
+            + (header.length === 1 ? ' columna' : ' columnas');
+        const tableBlock = {
+            kind: 'table',
+            id: nextId('table'),
+            summary: tableSummary,
+        };
+        const sectionBlocks = [
+            { kind: 'heading', level: 1, text: heading, id: nextId('h') },
+            tableBlock,
+        ];
+        if (header.length > 0) {
+            sectionBlocks.push({
+                kind: 'paragraph',
+                level: 0,
+                text: 'columnas: ' + header.filter((h) => h).join(', ') + '.',
+                id: nextId('cols'),
+            });
+        }
+        /* Per data row -> "Fila N" subsection collapsed into the
+           same section. The reader can still navigate by next_block
+           (one paragraph per cell). */
+        dataRows.forEach((row, ri) => {
+            sectionBlocks.push({
+                kind: 'heading',
+                level: 2,
+                text: 'Fila ' + (ri + 1),
+                id: nextId('h'),
+            });
+            row.forEach((cell, ci) => {
+                const value = String(cell).trim();
+                if (value === '')
+                    return;
+                const col = header[ci] || ('columna ' + (ci + 1));
+                sectionBlocks.push({
+                    kind: 'paragraph',
+                    level: 0,
+                    text: col + ': ' + value,
+                    id: nextId('p'),
+                });
+            });
+        });
+        sections.push({
+            id: 's-' + (idx + 1),
+            heading,
+            level: 1,
+            blocks: sectionBlocks,
+        });
+    });
+    if (sections.length === 0) {
+        sections.push({ id: 's-0', heading: '', level: 0, blocks: [] });
+    }
+    const docId = (opts.filename.split(/[\\/]/).pop() || 'doc')
+        .replace(/\.[^.]+$/, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'doc';
+    const out = {
+        id: docId,
+        filename: opts.filename,
+        format: 'xlsx',
+        bytes: opts.buffer.length,
+        title: firstSheetTitle || 'Hoja',
+        sections,
+    };
+    if (opts.language !== undefined)
+        out.language = opts.language;
+    return out;
+}
+//# sourceMappingURL=xlsx.js.map

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

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

package/dist/reader/registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Format detection + parser dispatch (V1.23 of HITO 1).
+ *
+ * Two surfaces:
+ *
+ *   detectFormat(filename, buffer?) -> DocFormat
+ *     File-extension first; magic bytes second when buffer is
+ *     provided. Returns 'source' for any extension matching the
+ *     source-code map (anything not in the explicit list).
+ *
+ *   parseDocument({ filename, buffer, format? }) -> NormalisedDocument
+ *     Picks the parser for the detected (or explicit) format and
+ *     calls it. Throws loudly when the format has no shipped
+ *     parser yet (pdf / docx / html / rtf / epub / csv / xlsx
+ *     are placeholders -- documented as alpha gaps).
+ *
+ * ASCII-only.
+ */
+import type { DocFormat, NormalisedDocument } from './types.js';
+/** Detect format. Filename extension is canonical; the optional
+ *  buffer triggers a magic-byte fallback when the extension is
+ *  unknown. */
+export declare function detectFormat(filename: string, buffer?: Buffer): DocFormat;
+export interface ParseDocumentRequest {
+    filename: string;
+    buffer: Buffer;
+    /** Optional override -- skip detectFormat when set. */
+    format?: DocFormat;
+    /** Optional language hint propagated to the parser. */
+    language?: string;
+}
+/** Dispatch a buffer to the right parser. Async because some
+ *  parsers (PDF via pdfjs-dist, future DOCX via mammoth) need
+ *  a Promise. Sync parsers are wrapped in Promise.resolve so
+ *  the caller contract stays uniform. */
+export declare function parseDocument(req: ParseDocumentRequest): Promise<NormalisedDocument>;
+/** Names of formats this build supports today. */
+export declare function supportedFormats(): DocFormat[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/reader/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/reader/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAyBhE;;eAEe;AACf,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CA4CzE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;yCAGyC;AACzC,wBAAsB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyE1F;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}