ai-document-parser 0.1.101

package/dist/convert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/convert/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/edit/docx-ooxml.d.ts

@@ -0,0 +1,13 @@
+import type { DocxStructured } from '../types.js';
+export declare function escapeXml(text: string): string;
+export declare function editDocx(filePath: string, oldString: string, newString: string, replaceAll: boolean): Promise<{
+    message: string;
+    changes: number;
+}>;
+export declare function appendDocxParagraphs(filePath: string, paragraphs: string[]): Promise<{
+    message: string;
+    changes: number;
+}>;
+export declare function readDocxStructured(filePath: string): Promise<DocxStructured>;
+export declare function readDocxStructuredFromBuffer(buf: Buffer): Promise<DocxStructured>;
+//# sourceMappingURL=docx-ooxml.d.ts.map

package/dist/edit/docx-ooxml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-ooxml.d.ts","sourceRoot":"","sources":["../../src/edit/docx-ooxml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AA4HD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC/C;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B/C;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CASzB;AAED,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAQzB"}

package/dist/edit/docx-ooxml.js

@@ -0,0 +1,182 @@
+import { readFile } from 'node:fs/promises';
+import JSZip from 'jszip';
+import { DocumentError } from '../utils/errors.js';
+const DOC_PARTS = [
+    'word/document.xml',
+    /^word\/header\d*\.xml$/,
+    /^word\/footer\d*\.xml$/,
+];
+export function escapeXml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function decodeXmlEntities(s) {
+    return s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+function paragraphTextsFromXml(xml) {
+    const paragraphs = [];
+    const paraRegex = /<w:p[\s\S]*?<\/w:p>/g;
+    let pm;
+    while ((pm = paraRegex.exec(xml)) !== null) {
+        const wtRegex = /<w:t(?:\s[^>]*)?>([^<]*)<\/w:t>/g;
+        const parts = [];
+        let tm;
+        while ((tm = wtRegex.exec(pm[0])) !== null) {
+            parts.push(decodeXmlEntities(tm[1]));
+        }
+        const text = parts.join('').trim();
+        if (text)
+            paragraphs.push(text);
+    }
+    return paragraphs;
+}
+function isDocPart(name) {
+    return DOC_PARTS.some((p) => typeof p === 'string' ? name === p : p.test(name));
+}
+async function loadZip(filePath) {
+    const buf = await readFile(filePath);
+    return JSZip.loadAsync(buf);
+}
+function replaceInParagraphXml(paraXml, oldString, newString, replaceAll) {
+    const wtRegex = /<w:t(?:\s[^>]*)?>([^<]*)<\/w:t>/g;
+    const runs = [];
+    let m;
+    while ((m = wtRegex.exec(paraXml)) !== null) {
+        runs.push({ full: m[0], text: m[1] });
+    }
+    if (runs.length === 0) {
+        return { xml: paraXml, count: 0 };
+    }
+    const combined = runs.map((r) => r.text).join('');
+    if (!combined.includes(oldString)) {
+        return { xml: paraXml, count: 0 };
+    }
+    let count = 0;
+    let updatedCombined = combined;
+    if (replaceAll) {
+        const parts = combined.split(oldString);
+        count = parts.length - 1;
+        updatedCombined = parts.join(newString);
+    }
+    else {
+        const idx = combined.indexOf(oldString);
+        if (idx === -1)
+            return { xml: paraXml, count: 0 };
+        count = 1;
+        updatedCombined =
+            combined.slice(0, idx) +
+                newString +
+                combined.slice(idx + oldString.length);
+    }
+    const escaped = escapeXml(updatedCombined);
+    const newRun = `<w:r><w:t xml:space="preserve">${escaped}</w:t></w:r>`;
+    const pPrMatch = paraXml.match(/<w:pPr[\s\S]*?<\/w:pPr>/);
+    const pPr = pPrMatch ? pPrMatch[0] : '';
+    return { xml: `<w:p>${pPr}${newRun}</w:p>`, count };
+}
+function replaceInDocumentXml(xml, oldString, newString, replaceAll) {
+    const paraRegex = /<w:p[\s\S]*?<\/w:p>/g;
+    let total = 0;
+    const result = xml.replace(paraRegex, (para) => {
+        const { xml: next, count } = replaceInParagraphXml(para, oldString, newString, replaceAll);
+        total += count;
+        return next;
+    });
+    if (total === 0 && xml.includes(oldString)) {
+        if (replaceAll) {
+            const parts = xml.split(oldString);
+            if (parts.length > 1) {
+                return { xml: parts.join(escapeXml(newString)), count: parts.length - 1 };
+            }
+        }
+        const idx = xml.indexOf(oldString);
+        if (idx !== -1) {
+            return {
+                xml: xml.slice(0, idx) +
+                    escapeXml(newString) +
+                    xml.slice(idx + oldString.length),
+                count: 1,
+            };
+        }
+    }
+    return { xml: result, count: total };
+}
+export async function editDocx(filePath, oldString, newString, replaceAll) {
+    if (!oldString) {
+        throw new DocumentError('INVALID_ARGUMENT', 'oldString cannot be empty');
+    }
+    const zip = await loadZip(filePath);
+    let total = 0;
+    for (const name of Object.keys(zip.files)) {
+        if (!isDocPart(name) || zip.files[name].dir)
+            continue;
+        const xml = await zip.file(name).async('string');
+        const { xml: next, count } = replaceInDocumentXml(xml, oldString, newString, replaceAll);
+        total += count;
+        zip.file(name, next);
+    }
+    if (total === 0) {
+        throw new DocumentError('EDIT_TARGET_NOT_FOUND', 'Text not found in docx. Parse with output:"structured" and refine oldString.');
+    }
+    if (total > 1 && !replaceAll) {
+        throw new DocumentError('MULTIPLE_MATCHES', `Found ${total} matches. Narrow oldString or set replaceAll: true.`);
+    }
+    const { writeFile } = await import('node:fs/promises');
+    const out = await zip.generateAsync({ type: 'nodebuffer' });
+    await writeFile(filePath, out);
+    return {
+        message: `DOCX updated: ${filePath} (${total} replacement(s); formatting partially preserved)`,
+        changes: total,
+    };
+}
+export async function appendDocxParagraphs(filePath, paragraphs) {
+    const zip = await loadZip(filePath);
+    const docFile = zip.file('word/document.xml');
+    if (!docFile) {
+        throw new DocumentError('PARSE_FAILED', 'Invalid docx: missing word/document.xml');
+    }
+    let xml = await docFile.async('string');
+    const blocks = paragraphs
+        .map((p) => `<w:p><w:r><w:t xml:space="preserve">${escapeXml(p || ' ')}</w:t></w:r></w:p>`)
+        .join('');
+    if (!xml.includes('</w:body>')) {
+        throw new DocumentError('PARSE_FAILED', 'Could not find w:body in document.xml');
+    }
+    xml = xml.replace('</w:body>', `${blocks}</w:body>`);
+    zip.file('word/document.xml', xml);
+    const { writeFile } = await import('node:fs/promises');
+    const out = await zip.generateAsync({ type: 'nodebuffer' });
+    await writeFile(filePath, out);
+    return {
+        message: `DOCX: appended ${paragraphs.length} paragraph(s) to ${filePath}`,
+        changes: paragraphs.length,
+    };
+}
+export async function readDocxStructured(filePath) {
+    const zip = await loadZip(filePath);
+    const docFile = zip.file('word/document.xml');
+    if (!docFile) {
+        throw new DocumentError('PARSE_FAILED', 'Invalid docx: missing word/document.xml');
+    }
+    const xml = await docFile.async('string');
+    return { format: 'docx', paragraphs: paragraphTextsFromXml(xml) };
+}
+export async function readDocxStructuredFromBuffer(buf) {
+    const zip = await JSZip.loadAsync(buf);
+    const docFile = zip.file('word/document.xml');
+    if (!docFile) {
+        throw new DocumentError('PARSE_FAILED', 'Invalid docx: missing word/document.xml');
+    }
+    const xml = await docFile.async('string');
+    return { format: 'docx', paragraphs: paragraphTextsFromXml(xml) };
+}
+//# sourceMappingURL=docx-ooxml.js.map

package/dist/edit/docx-ooxml.js.map

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

package/dist/edit/index.d.ts

@@ -0,0 +1,8 @@
+import type { EditDocumentOp, EditResult } from '../types.js';
+/**
+ * Surgically edit an existing docx or spreadsheet without full regeneration.
+ */
+export declare function editDocument(filePath: string, op: EditDocumentOp): Promise<EditResult>;
+export { editDocx, appendDocxParagraphs, readDocxStructured, escapeXml, } from './docx-ooxml.js';
+export { updateSpreadsheetCells, readSpreadsheetStructured, readSpreadsheetStructuredAsync, type CellUpdate, type SheetGrid, } from './spreadsheet.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/edit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edit/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9D;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,EAC9B,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,kBAAkB,CAAC"}

package/dist/edit/index.js

@@ -0,0 +1,26 @@
+import { DocumentError } from '../utils/errors.js';
+import { appendDocxParagraphs, editDocx, } from './docx-ooxml.js';
+import { updateSpreadsheetCells } from './spreadsheet.js';
+/**
+ * Surgically edit an existing docx or spreadsheet without full regeneration.
+ */
+export async function editDocument(filePath, op) {
+    if (op.type === 'docx') {
+        if (op.op === 'replace') {
+            const result = await editDocx(filePath, op.oldString, op.newString, op.replaceAll ?? false);
+            return { path: filePath, message: result.message, changes: result.changes };
+        }
+        if (op.op === 'append') {
+            const result = await appendDocxParagraphs(filePath, op.paragraphs);
+            return { path: filePath, message: result.message, changes: result.changes };
+        }
+    }
+    if (op.type === 'spreadsheet' && op.op === 'patchCells') {
+        const result = await updateSpreadsheetCells(filePath, op.updates);
+        return { path: filePath, message: result.message, changes: result.changes };
+    }
+    throw new DocumentError('INVALID_ARGUMENT', `Unsupported edit operation: ${JSON.stringify(op)}`);
+}
+export { editDocx, appendDocxParagraphs, readDocxStructured, escapeXml, } from './docx-ooxml.js';
+export { updateSpreadsheetCells, readSpreadsheetStructured, readSpreadsheetStructuredAsync, } from './spreadsheet.js';
+//# sourceMappingURL=index.js.map

package/dist/edit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACL,oBAAoB,EACpB,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,EAAkB;IAElB,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,QAAQ,EACR,EAAE,CAAC,SAAS,EACZ,EAAE,CAAC,SAAS,EACZ,EAAE,CAAC,UAAU,IAAI,KAAK,CACvB,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9E,CAAC;QACD,IAAI,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,EAAE,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,IAAI,aAAa,CACrB,kBAAkB,EAClB,+BAA+B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CACpD,CAAC;AACJ,CAAC;AAED,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAG/B,MAAM,kBAAkB,CAAC"}

package/dist/edit/spreadsheet.d.ts

@@ -0,0 +1,19 @@
+import type { SpreadsheetStructured } from '../types.js';
+export type SheetGrid = Record<string, (string | number | boolean | null)[][]>;
+export type CellUpdate = {
+    sheet?: string;
+    cell: string;
+    value: string | number | boolean | null;
+};
+export declare function writeSpreadsheet(filePath: string, sheets: SheetGrid): Promise<{
+    message: string;
+}>;
+export declare function updateSpreadsheetCells(filePath: string, updates: CellUpdate[]): Promise<{
+    message: string;
+    changes: number;
+}>;
+export declare function readSpreadsheetStructured(filePath: string): SpreadsheetStructured;
+export declare function readSpreadsheetStructuredAsync(filePath: string): Promise<SpreadsheetStructured>;
+export declare function readSpreadsheetStructuredFromBuffer(buf: Buffer, format?: 'xlsx' | 'xls'): SpreadsheetStructured;
+export declare function spreadsheetToText(structured: SpreadsheetStructured): string;
+//# sourceMappingURL=spreadsheet.d.ts.map

package/dist/edit/spreadsheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheet.d.ts","sourceRoot":"","sources":["../../src/edit/spreadsheet.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AAE/E,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC,CAAC;AAsDF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAY9B;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/C;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAGjF;AAED,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,GAAG,KAAc,GAC9B,qBAAqB,CAOvB;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAS3E"}

package/dist/edit/spreadsheet.js

@@ -0,0 +1,123 @@
+import { readFileSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import * as XLSX from '@e965/xlsx';
+import { DocumentError } from '../utils/errors.js';
+import { ensureParentDir } from '../utils/paths.js';
+import { csvEscapeCell } from '../utils/text.js';
+function bookTypeFor(filePath) {
+    return path.extname(filePath).toLowerCase() === '.xls' ? 'biff8' : 'xlsx';
+}
+function formatFor(filePath) {
+    return path.extname(filePath).toLowerCase() === '.xls' ? 'xls' : 'xlsx';
+}
+function coerceValue(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === 'boolean' || typeof v === 'number')
+        return v;
+    const s = String(v);
+    if (s === 'true')
+        return true;
+    if (s === 'false')
+        return false;
+    const n = Number(s);
+    if (s !== '' && !Number.isNaN(n) && String(n) === s)
+        return n;
+    return s;
+}
+function cellObject(value) {
+    if (value === null)
+        return { t: 'z' };
+    if (typeof value === 'boolean')
+        return { t: 'b', v: value };
+    if (typeof value === 'number')
+        return { t: 'n', v: value };
+    return { t: 's', v: value };
+}
+async function writeWorkbook(filePath, wb) {
+    const bookType = bookTypeFor(filePath);
+    const data = XLSX.write(wb, { type: 'buffer', bookType });
+    await writeFile(filePath, data);
+}
+/** Expand worksheet !ref so a patched A1 address is included. */
+function ensureCellInRange(ws, address) {
+    const cell = XLSX.utils.decode_cell(address);
+    const range = ws['!ref']
+        ? XLSX.utils.decode_range(ws['!ref'])
+        : { s: { c: cell.c, r: cell.r }, e: { c: cell.c, r: cell.r } };
+    if (cell.c < range.s.c)
+        range.s.c = cell.c;
+    if (cell.r < range.s.r)
+        range.s.r = cell.r;
+    if (cell.c > range.e.c)
+        range.e.c = cell.c;
+    if (cell.r > range.e.r)
+        range.e.r = cell.r;
+    ws['!ref'] = XLSX.utils.encode_range(range);
+}
+function sheetToGrid(ws) {
+    return XLSX.utils.sheet_to_json(ws, {
+        header: 1,
+        defval: null,
+    });
+}
+export async function writeSpreadsheet(filePath, sheets) {
+    await ensureParentDir(filePath);
+    const wb = XLSX.utils.book_new();
+    for (const [name, rows] of Object.entries(sheets)) {
+        const ws = XLSX.utils.aoa_to_sheet(rows.map((row) => row.map((c) => (c === null ? '' : coerceValue(c)))));
+        XLSX.utils.book_append_sheet(wb, ws, name.slice(0, 31));
+    }
+    await writeWorkbook(filePath, wb);
+    const label = bookTypeFor(filePath) === 'biff8' ? 'XLS' : 'XLSX';
+    return { message: `Created ${label}: ${filePath}` };
+}
+export async function updateSpreadsheetCells(filePath, updates) {
+    const buf = await readFile(filePath);
+    const wb = XLSX.read(buf, { type: 'buffer' });
+    let count = 0;
+    for (const u of updates) {
+        const sheetName = u.sheet ?? wb.SheetNames[0];
+        const ws = wb.Sheets[sheetName];
+        if (!ws) {
+            throw new DocumentError('INVALID_ARGUMENT', `Sheet not found: ${sheetName}`);
+        }
+        const addr = u.cell.trim().toUpperCase();
+        if (!/^[A-Z]+\d+$/.test(addr)) {
+            throw new DocumentError('INVALID_ARGUMENT', `Invalid cell address: ${u.cell}`);
+        }
+        ensureCellInRange(ws, addr);
+        ws[addr] = cellObject(coerceValue(u.value));
+        count++;
+    }
+    await writeWorkbook(filePath, wb);
+    return { message: `Updated ${count} cell(s) in ${filePath}`, changes: count };
+}
+export function readSpreadsheetStructured(filePath) {
+    const buf = readFileSync(filePath);
+    return readSpreadsheetStructuredFromBuffer(buf, formatFor(filePath));
+}
+export async function readSpreadsheetStructuredAsync(filePath) {
+    const buf = await readFile(filePath);
+    return readSpreadsheetStructuredFromBuffer(buf, formatFor(filePath));
+}
+export function readSpreadsheetStructuredFromBuffer(buf, format = 'xlsx') {
+    const wb = XLSX.read(buf, { type: 'buffer' });
+    const sheets = {};
+    for (const name of wb.SheetNames) {
+        sheets[name] = sheetToGrid(wb.Sheets[name]);
+    }
+    return { format, sheets };
+}
+export function spreadsheetToText(structured) {
+    const parts = [];
+    for (const [name, rows] of Object.entries(structured.sheets)) {
+        const csv = rows
+            .map((row) => row.map((c) => csvEscapeCell(c)).join(','))
+            .join('\n');
+        parts.push(`## ${name}\n${csv}`);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=spreadsheet.js.map

package/dist/edit/spreadsheet.js.map

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

package/dist/fonts/LICENSE-DejaVu.txt

@@ -0,0 +1,2 @@
+DejaVu Sans (DejaVuSans.ttf) — fonts from the DejaVu project.
+See https://dejavu-fonts.github.io/ for license terms (Bitstream Vera / Arev Fonts / Public Domain).

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ai-document-parser — parse, convert, edit, and write office documents.
+ *
+ * Import from this package root (or subpaths).
+ */
+export { parseDocument, convertDocToDocx } from './parse/index.js';
+export { convertDocument } from './convert/index.js';
+export { editDocument, editDocx, appendDocxParagraphs, readDocxStructured, updateSpreadsheetCells, readSpreadsheetStructured, } from './edit/index.js';
+export { writeDocument, writeDocx, writePdf, writeSpreadsheet } from './write/index.js';
+export { DocumentError } from './utils/errors.js';
+export type { ParseOptions, ParseOutputMode, ConvertFormat, ConvertOptions, ConvertResult, DocumentInput, DocumentResult, DocumentWarning, DocxStructured, SpreadsheetStructured, LegacyDocStructured, PptxStructured, EditDocumentOp, EditResult, WriteDocumentInput, WriteResult, DocumentErrorCode, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,YAAY,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * ai-document-parser — parse, convert, edit, and write office documents.
+ *
+ * Import from this package root (or subpaths).
+ */
+export { parseDocument, convertDocToDocx } from './parse/index.js';
+export { convertDocument } from './convert/index.js';
+export { editDocument, editDocx, appendDocxParagraphs, readDocxStructured, updateSpreadsheetCells, readSpreadsheetStructured, } from './edit/index.js';
+export { writeDocument, writeDocx, writePdf, writeSpreadsheet } from './write/index.js';
+export { DocumentError } from './utils/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/parse/detect.d.ts

@@ -0,0 +1,19 @@
+export type DetectedFormat = 'docx' | 'xlsx' | 'xls' | 'pdf' | 'md' | 'html' | 'csv' | 'doc' | 'pptx' | 'unknown';
+export declare function formatFromExt(filePath: string | undefined): DetectedFormat | null;
+export declare function isZipBuffer(buf: Buffer): boolean;
+/**
+ * Detect format from magic bytes, then UTF-8 text heuristics for buffers
+ * without a binary signature.
+ * ZIP containers return a provisional `'docx'`; callers with a buffer should
+ * follow up with `refineZipFormat` when the extension is unknown.
+ */
+export declare function detectFormatFromBuffer(buf: Buffer): DetectedFormat | null;
+/**
+ * Distinguish OOXML ZIP packages (docx / xlsx / pptx) via package parts
+ * and `[Content_Types].xml`.
+ */
+export declare function refineZipFormat(buf: Buffer): Promise<DetectedFormat>;
+/** Detect format for a raw string that is not a filesystem path. */
+export declare function detectFormatFromText(text: string): DetectedFormat;
+export declare function assertSupportedParse(format: string): void;
+//# sourceMappingURL=detect.d.ts.map

package/dist/parse/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/parse/detect.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,KAAK,GACL,KAAK,GACL,MAAM,GACN,SAAS,CAAC;AAyBd,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAUjF;AAQD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgBzE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB1E;AAQD,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOzD"}

package/dist/parse/detect.js

@@ -0,0 +1,109 @@
+import JSZip from 'jszip';
+import { DocumentError } from '../utils/errors.js';
+import { extOf } from '../utils/paths.js';
+import { CORE_FORMATS_HELP, CORE_PARSE_FORMAT_SET } from './formats.js';
+const EXT_MAP = {
+    '.docx': 'docx',
+    '.xlsx': 'xlsx',
+    '.xls': 'xls',
+    '.pptx': 'pptx',
+    '.pdf': 'pdf',
+    '.md': 'md',
+    '.markdown': 'md',
+    '.html': 'html',
+    '.htm': 'html',
+    '.csv': 'csv',
+    '.doc': 'doc',
+};
+const UNSUPPORTED_EXT = new Set([
+    '.ppt',
+    '.odt',
+    '.ods',
+    '.odp',
+    '.rtf',
+    '.epub',
+]);
+export function formatFromExt(filePath) {
+    if (!filePath)
+        return null;
+    const ext = extOf(filePath);
+    if (UNSUPPORTED_EXT.has(ext)) {
+        throw new DocumentError('UNSUPPORTED_FORMAT', `Unsupported format "${ext}". Core formats: ${CORE_FORMATS_HELP}.`);
+    }
+    return EXT_MAP[ext] ?? null;
+}
+function detectTextFormat(sample) {
+    if (/^\s*</.test(sample))
+        return 'html';
+    if (sample.includes(',') && !sample.includes('<'))
+        return 'csv';
+    return 'md';
+}
+export function isZipBuffer(buf) {
+    return buf.length >= 2 && buf[0] === 0x50 && buf[1] === 0x4b;
+}
+/**
+ * Detect format from magic bytes, then UTF-8 text heuristics for buffers
+ * without a binary signature.
+ * ZIP containers return a provisional `'docx'`; callers with a buffer should
+ * follow up with `refineZipFormat` when the extension is unknown.
+ */
+export function detectFormatFromBuffer(buf) {
+    if (buf.length >= 4 && buf.slice(0, 4).toString('ascii') === '%PDF')
+        return 'pdf';
+    if (isZipBuffer(buf)) {
+        return 'docx';
+    }
+    if (buf.length >= 8 &&
+        buf[0] === 0xd0 &&
+        buf[1] === 0xcf &&
+        buf[2] === 0x11 &&
+        buf[3] === 0xe0) {
+        return 'doc';
+    }
+    if (buf.length === 0)
+        return null;
+    return detectTextFormat(buf.slice(0, 200).toString('utf8'));
+}
+/**
+ * Distinguish OOXML ZIP packages (docx / xlsx / pptx) via package parts
+ * and `[Content_Types].xml`.
+ */
+export async function refineZipFormat(buf) {
+    try {
+        const zip = await JSZip.loadAsync(buf);
+        if (zip.file('ppt/presentation.xml') || hasSlidePart(zip))
+            return 'pptx';
+        if (zip.file('xl/workbook.xml'))
+            return 'xlsx';
+        if (zip.file('word/document.xml'))
+            return 'docx';
+        const ct = zip.file('[Content_Types].xml');
+        if (ct) {
+            const xml = await ct.async('string');
+            if (/presentationml/i.test(xml) || /\/ppt\//i.test(xml))
+                return 'pptx';
+            if (/spreadsheetml/i.test(xml) || /\/xl\//i.test(xml))
+                return 'xlsx';
+            if (/wordprocessingml/i.test(xml) || /\/word\//i.test(xml))
+                return 'docx';
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return 'docx';
+}
+function hasSlidePart(zip) {
+    return Object.keys(zip.files).some((n) => /^ppt\/slides\/slide\d+\.xml$/i.test(n));
+}
+/** Detect format for a raw string that is not a filesystem path. */
+export function detectFormatFromText(text) {
+    return detectTextFormat(text.slice(0, 200));
+}
+export function assertSupportedParse(format) {
+    if (!CORE_PARSE_FORMAT_SET.has(format)) {
+        throw new DocumentError('UNSUPPORTED_FORMAT', `Unsupported format "${format}". Core formats: ${CORE_FORMATS_HELP}.`);
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/parse/detect.js.map

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

package/dist/parse/formats.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Clean-room rules for contributors (also summarized in AGENTS.md):
+ *
+ * 1. Implement parsers/converters from public format specs and public API behavior
+ *    (tests + docs/API.md) — do not copy code from historical derived engines.
+ * 2. Prefer extending src/edit, src/write, src/parse over large opaque backends.
+ * 3. New format support lands behind parseDocument / convertDocument only.
+ */
+/** Normalized format ids returned by detect / parseDocument. */
+export declare const CORE_PARSE_FORMATS: readonly ["docx", "xlsx", "xls", "pdf", "md", "html", "csv", "doc", "pptx"];
+export type CoreParseFormat = (typeof CORE_PARSE_FORMATS)[number];
+export declare const CORE_PARSE_FORMAT_SET: Set<string>;
+export declare const CORE_FORMATS_HELP = "docx, xlsx, xls, pptx, pdf, md, html, csv, legacy doc";
+//# sourceMappingURL=formats.d.ts.map

package/dist/parse/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/parse/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,6EAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB,aAAsC,CAAC;AAEzE,eAAO,MAAM,iBAAiB,0DAC2B,CAAC"}