@usejunior/odf-core 0.9.1

package/dist/odf_archive_safety.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ODF archive-safety guard.
+ *
+ * Reuses docx-core's format-agnostic `inspectZipEntries` for the zip-bomb / entry
+ * limits (entry count, single-entry size, total uncompressed size, compression
+ * ratio), and additionally asserts the package declares the OpenDocument text
+ * mimetype. Returns a plain result; the MCP layer maps failures to tool errors.
+ */
+export type OdfArchiveSafetyResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    hint: string;
+};
+export declare function validateOdfArchiveSafety(buffer: Buffer): Promise<OdfArchiveSafetyResult>;
+//# sourceMappingURL=odf_archive_safety.d.ts.map

package/dist/odf_archive_safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odf_archive_safety.d.ts","sourceRoot":"","sources":["../src/odf_archive_safety.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAmB/D,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAwE9F"}

package/dist/odf_archive_safety.js

@@ -0,0 +1,72 @@
+/**
+ * ODF archive-safety guard.
+ *
+ * Reuses docx-core's format-agnostic `inspectZipEntries` for the zip-bomb / entry
+ * limits (entry count, single-entry size, total uncompressed size, compression
+ * ratio), and additionally asserts the package declares the OpenDocument text
+ * mimetype. Returns a plain result; the MCP layer maps failures to tool errors.
+ */
+import { inspectZipEntries } from '@usejunior/docx-core';
+import JSZip from 'jszip';
+import { ODF_PATHS, ODT_MIMETYPE } from './shared/odf/namespaces.js';
+function readIntEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return fallback;
+    return parsed;
+}
+const MAX_ARCHIVE_ENTRIES = () => readIntEnv('ODF_MAX_ARCHIVE_ENTRIES', 2000);
+const MAX_TOTAL_UNCOMPRESSED_BYTES = () => readIntEnv('ODF_MAX_UNCOMPRESSED_BYTES', 200 * 1024 * 1024);
+const MAX_SINGLE_ENTRY_UNCOMPRESSED_BYTES = () => readIntEnv('ODF_MAX_ENTRY_UNCOMPRESSED_BYTES', 50 * 1024 * 1024);
+const MAX_COMPRESSION_RATIO = () => readIntEnv('ODF_MAX_COMPRESSION_RATIO', 200);
+function fail(code, message, hint) {
+    return { ok: false, code, message, hint };
+}
+export async function validateOdfArchiveSafety(buffer) {
+    let entries;
+    try {
+        entries = await inspectZipEntries(buffer);
+    }
+    catch (e) {
+        return fail('INVALID_ODF_ARCHIVE', `Unable to parse .odt archive: ${e instanceof Error ? e.message : String(e)}`, 'Ensure the input file is a valid .odt (OpenDocument text) package.');
+    }
+    const files = entries.filter((entry) => !entry.isDirectory);
+    if (files.length > MAX_ARCHIVE_ENTRIES()) {
+        return fail('ODF_ARCHIVE_TOO_MANY_ENTRIES', `Archive contains ${files.length} entries (max ${MAX_ARCHIVE_ENTRIES()}).`, 'Use a simpler .odt package or raise ODF_MAX_ARCHIVE_ENTRIES intentionally.');
+    }
+    let totalUncompressed = 0;
+    for (const file of files) {
+        const { compressedSize, uncompressedSize } = file;
+        totalUncompressed += uncompressedSize;
+        if (uncompressedSize > MAX_SINGLE_ENTRY_UNCOMPRESSED_BYTES()) {
+            return fail('ODF_ARCHIVE_ENTRY_TOO_LARGE', `Archive entry '${file.name}' is ${uncompressedSize} bytes uncompressed (max ${MAX_SINGLE_ENTRY_UNCOMPRESSED_BYTES()}).`, 'Reduce embedded object sizes or raise ODF_MAX_ENTRY_UNCOMPRESSED_BYTES intentionally.');
+        }
+        if (totalUncompressed > MAX_TOTAL_UNCOMPRESSED_BYTES()) {
+            return fail('ODF_ARCHIVE_UNCOMPRESSED_TOO_LARGE', `Archive expands to ${totalUncompressed} bytes (max ${MAX_TOTAL_UNCOMPRESSED_BYTES()}).`, 'Reduce archive complexity or raise ODF_MAX_UNCOMPRESSED_BYTES intentionally.');
+        }
+        if (uncompressedSize > 0) {
+            const ratio = compressedSize > 0 ? uncompressedSize / compressedSize : Number.POSITIVE_INFINITY;
+            if (ratio > MAX_COMPRESSION_RATIO()) {
+                return fail('ODF_ARCHIVE_COMPRESSION_RATIO_TOO_HIGH', `Archive entry '${file.name}' has compression ratio ${ratio.toFixed(2)} (max ${MAX_COMPRESSION_RATIO()}).`, 'This may indicate a highly compressed or hostile archive. Adjust ODF_MAX_COMPRESSION_RATIO only if trusted.');
+            }
+        }
+    }
+    // ODF identity: the package must declare the OpenDocument text mimetype.
+    let mimetype = null;
+    try {
+        const zip = await JSZip.loadAsync(buffer);
+        const mimeFile = zip.file(ODF_PATHS.MIMETYPE);
+        mimetype = mimeFile ? (await mimeFile.async('string')).trim() : null;
+    }
+    catch {
+        mimetype = null;
+    }
+    if (mimetype !== ODT_MIMETYPE) {
+        return fail('INVALID_ODF_ARCHIVE', `Not an OpenDocument text package (mimetype: ${mimetype ?? 'absent'}).`, `Provide a .odt whose 'mimetype' entry is '${ODT_MIMETYPE}'.`);
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=odf_archive_safety.js.map

package/dist/odf_archive_safety.js.map

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

package/dist/shared/odf/OdfArchive.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ODF package handler (parallel to docx-core's `DocxArchive`).
+ *
+ * ODF is a ZIP-of-XML like DOCX, but with one sharp packaging rule that DOCX does
+ * not have: the `mimetype` entry MUST be the FIRST entry in the archive and stored
+ * UNCOMPRESSED (STORE, not DEFLATE). Strict ODF readers reject a package that
+ * violates this.
+ *
+ * CRITICAL (verified against JSZip 3.10.1): a fresh JSZip honors mimetype-first +
+ * `{ compression: 'STORE' }`, but if you LOAD an existing `.odt` and re-`generateAsync`
+ * the loaded handle, JSZip re-emits the existing `mimetype` entry as DEFLATE
+ * (method 8) — producing an invalid `.odt`. The ONLY reliable fix is to REBUILD a
+ * fresh JSZip on save: write `mimetype` first with STORE, then copy every other
+ * entry's decompressed content. `save()` below does exactly that. Do not "optimize"
+ * it back into re-saving the loaded handle.
+ */
+export declare class OdfArchive {
+    private zip;
+    private modified;
+    private constructor();
+    /**
+     * Load an ODF package from a Buffer. Rejects a buffer that is missing the
+     * required `content.xml` or `META-INF/manifest.xml` parts.
+     */
+    static load(buffer: Buffer): Promise<OdfArchive>;
+    /** Get `content.xml` as a string. */
+    getContentXml(): Promise<string>;
+    /** Replace `content.xml`. */
+    setContentXml(xml: string): void;
+    /** Get an arbitrary part as a string, or null if absent. */
+    getFile(path: string): Promise<string | null>;
+    /** Set an arbitrary part. */
+    setFile(path: string, content: string): void;
+    /** Whether a part exists. */
+    hasFile(path: string): boolean;
+    /** List all non-directory entry names in the archive. */
+    listFiles(): string[];
+    /** Paths modified since load. */
+    getModifiedPaths(): string[];
+    /**
+     * Save the archive to a Buffer.
+     *
+     * Rebuilds a fresh JSZip so the `mimetype` entry is guaranteed first + STORE
+     * across a load→modify→save round trip (see the class-level note). Untouched
+     * entries keep byte-identical DECOMPRESSED content; the compressed container
+     * bytes may differ (re-deflation), which matches the DOCX side's guarantee.
+     */
+    save(): Promise<Buffer>;
+}
+//# sourceMappingURL=OdfArchive.d.ts.map

package/dist/shared/odf/OdfArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OdfArchive.d.ts","sourceRoot":"","sources":["../../../src/shared/odf/OdfArchive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAA0B;IAE1C,OAAO;IAIP;;;OAGG;WACU,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAWtD,qCAAqC;IAC/B,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQtC,6BAA6B;IAC7B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,4DAA4D;IACtD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMnD,6BAA6B;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5C,6BAA6B;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,yDAAyD;IACzD,SAAS,IAAI,MAAM,EAAE;IAQrB,iCAAiC;IACjC,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CA6B9B"}

package/dist/shared/odf/OdfArchive.js

@@ -0,0 +1,118 @@
+/**
+ * ODF package handler (parallel to docx-core's `DocxArchive`).
+ *
+ * ODF is a ZIP-of-XML like DOCX, but with one sharp packaging rule that DOCX does
+ * not have: the `mimetype` entry MUST be the FIRST entry in the archive and stored
+ * UNCOMPRESSED (STORE, not DEFLATE). Strict ODF readers reject a package that
+ * violates this.
+ *
+ * CRITICAL (verified against JSZip 3.10.1): a fresh JSZip honors mimetype-first +
+ * `{ compression: 'STORE' }`, but if you LOAD an existing `.odt` and re-`generateAsync`
+ * the loaded handle, JSZip re-emits the existing `mimetype` entry as DEFLATE
+ * (method 8) — producing an invalid `.odt`. The ONLY reliable fix is to REBUILD a
+ * fresh JSZip on save: write `mimetype` first with STORE, then copy every other
+ * entry's decompressed content. `save()` below does exactly that. Do not "optimize"
+ * it back into re-saving the loaded handle.
+ */
+import JSZip from 'jszip';
+import { ODF_PATHS, ODT_MIMETYPE } from './namespaces.js';
+export class OdfArchive {
+    zip;
+    modified = new Set();
+    constructor(zip) {
+        this.zip = zip;
+    }
+    /**
+     * Load an ODF package from a Buffer. Rejects a buffer that is missing the
+     * required `content.xml` or `META-INF/manifest.xml` parts.
+     */
+    static async load(buffer) {
+        const zip = await JSZip.loadAsync(buffer);
+        if (!zip.file(ODF_PATHS.CONTENT)) {
+            throw new Error('Invalid ODF: missing content.xml');
+        }
+        if (!zip.file(ODF_PATHS.MANIFEST)) {
+            throw new Error('Invalid ODF: missing META-INF/manifest.xml');
+        }
+        return new OdfArchive(zip);
+    }
+    /** Get `content.xml` as a string. */
+    async getContentXml() {
+        const file = this.zip.file(ODF_PATHS.CONTENT);
+        if (!file) {
+            throw new Error('content.xml not found');
+        }
+        return file.async('string');
+    }
+    /** Replace `content.xml`. */
+    setContentXml(xml) {
+        this.zip.file(ODF_PATHS.CONTENT, xml);
+        this.modified.add(ODF_PATHS.CONTENT);
+    }
+    /** Get an arbitrary part as a string, or null if absent. */
+    async getFile(path) {
+        const file = this.zip.file(path);
+        if (!file)
+            return null;
+        return file.async('string');
+    }
+    /** Set an arbitrary part. */
+    setFile(path, content) {
+        this.zip.file(path, content);
+        this.modified.add(path);
+    }
+    /** Whether a part exists. */
+    hasFile(path) {
+        return this.zip.file(path) !== null;
+    }
+    /** List all non-directory entry names in the archive. */
+    listFiles() {
+        const files = [];
+        this.zip.forEach((relativePath, file) => {
+            if (!file.dir)
+                files.push(relativePath);
+        });
+        return files;
+    }
+    /** Paths modified since load. */
+    getModifiedPaths() {
+        return Array.from(this.modified);
+    }
+    /**
+     * Save the archive to a Buffer.
+     *
+     * Rebuilds a fresh JSZip so the `mimetype` entry is guaranteed first + STORE
+     * across a load→modify→save round trip (see the class-level note). Untouched
+     * entries keep byte-identical DECOMPRESSED content; the compressed container
+     * bytes may differ (re-deflation), which matches the DOCX side's guarantee.
+     */
+    async save() {
+        const out = new JSZip();
+        // mimetype FIRST, uncompressed. Use the original value if present (it should be),
+        // otherwise fall back to the ODT mimetype.
+        const mimeFile = this.zip.file(ODF_PATHS.MIMETYPE);
+        const mimeValue = mimeFile ? await mimeFile.async('string') : ODT_MIMETYPE;
+        out.file(ODF_PATHS.MIMETYPE, mimeValue, { compression: 'STORE' });
+        // Copy every other entry's decompressed content, in the loaded order.
+        const names = [];
+        this.zip.forEach((relativePath, file) => {
+            if (relativePath === ODF_PATHS.MIMETYPE || file.dir)
+                return;
+            names.push(relativePath);
+        });
+        for (const name of names) {
+            const file = this.zip.file(name);
+            if (!file)
+                continue;
+            const content = await file.async('nodebuffer');
+            out.file(name, content);
+        }
+        const buffer = await out.generateAsync({
+            type: 'nodebuffer',
+            compression: 'DEFLATE',
+            compressionOptions: { level: 6 },
+        });
+        return buffer;
+    }
+}
+//# sourceMappingURL=OdfArchive.js.map

package/dist/shared/odf/OdfArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OdfArchive.js","sourceRoot":"","sources":["../../../src/shared/odf/OdfArchive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,OAAO,UAAU;IACb,GAAG,CAAQ;IACX,QAAQ,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE1C,YAAoB,GAAU;QAC5B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAc;QAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,6BAA6B;IAC7B,aAAa,CAAC,GAAW;QACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,6BAA6B;IAC7B,OAAO,CAAC,IAAY,EAAE,OAAe;QACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,6BAA6B;IAC7B,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACtC,CAAC;IAED,yDAAyD;IACzD,SAAS;QACP,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iCAAiC;IACjC,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QAExB,kFAAkF;QAClF,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAC3E,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAElE,sEAAsE;QACtE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE;YACtC,IAAI,YAAY,KAAK,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG;gBAAE,OAAO;YAC5D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;YACrC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,SAAS;YACtB,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;SACjC,CAAC,CAAC;QACH,OAAO,MAAgB,CAAC;IAC1B,CAAC;CACF"}

package/dist/shared/odf/blocks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared block-level paragraph enumeration for ODF `content.xml`.
+ *
+ * Extracted from `document.ts` so both the document view and the comparison engine
+ * (`compare/index.ts`) enumerate body paragraphs identically without an import cycle.
+ *
+ * A "block" is a `text:p` / `text:h` carrying visible content, in document order — including
+ * those nested in `table:table-cell`. Two subtrees are skipped because their `text:p`s are not
+ * body content: `office:annotation` / `office:annotation-end` (comment bodies) and
+ * `text:tracked-changes` (deleted content stored out-of-line). All matching is by
+ * `namespaceURI` + `localName` (ODF prefixes are not guaranteed).
+ */
+/** Depth-first, document-order collection of `text:p` / `text:h` blocks into `out`. */
+export declare function collectBlocks(node: Node | null, out: Element[]): void;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/shared/odf/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/shared/odf/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAgBrE"}

package/dist/shared/odf/blocks.js

@@ -0,0 +1,36 @@
+/**
+ * Shared block-level paragraph enumeration for ODF `content.xml`.
+ *
+ * Extracted from `document.ts` so both the document view and the comparison engine
+ * (`compare/index.ts`) enumerate body paragraphs identically without an import cycle.
+ *
+ * A "block" is a `text:p` / `text:h` carrying visible content, in document order — including
+ * those nested in `table:table-cell`. Two subtrees are skipped because their `text:p`s are not
+ * body content: `office:annotation` / `office:annotation-end` (comment bodies) and
+ * `text:tracked-changes` (deleted content stored out-of-line). All matching is by
+ * `namespaceURI` + `localName` (ODF prefixes are not guaranteed).
+ */
+import { ELEMENT_NODE, isAnnotationSubtree, isTextBlock, isTrackedChangesSubtree, } from './text_segments.js';
+/** Depth-first, document-order collection of `text:p` / `text:h` blocks into `out`. */
+export function collectBlocks(node, out) {
+    if (!node)
+        return;
+    for (let child = node.firstChild; child; child = child.nextSibling) {
+        if (child.nodeType !== ELEMENT_NODE)
+            continue;
+        const el = child;
+        // An annotation carries its own `text:p` comment body; never enumerate it as a block.
+        if (isAnnotationSubtree(el))
+            continue;
+        // `text:tracked-changes` stores deleted paragraphs out-of-line; they are not body blocks.
+        if (isTrackedChangesSubtree(el))
+            continue;
+        if (isTextBlock(el)) {
+            out.push(el);
+            // Block-level text elements are not nested inside one another in ODF, but
+            // continue traversal in case of unusual structures (cost is negligible).
+        }
+        collectBlocks(el, out);
+    }
+}
+//# sourceMappingURL=blocks.js.map

package/dist/shared/odf/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/shared/odf/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,GAAc;IAC7D,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACnE,IAAI,KAAK,CAAC,QAAQ,KAAK,YAAY;YAAE,SAAS;QAC9C,MAAM,EAAE,GAAG,KAAgB,CAAC;QAC5B,sFAAsF;QACtF,IAAI,mBAAmB,CAAC,EAAE,CAAC;YAAE,SAAS;QACtC,0FAA0F;QAC1F,IAAI,uBAAuB,CAAC,EAAE,CAAC;YAAE,SAAS;QAC1C,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACb,0EAA0E;YAC1E,yEAAyE;QAC3E,CAAC;QACD,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/shared/odf/namespaces.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OpenDocument Format (ODF) XML namespace URIs and the OpenDocument text mimetype.
+ *
+ * ODF content is heavily namespaced; the document view MUST resolve elements via
+ * `getElementsByTagNameNS` / `localName` rather than prefixed tag names, because
+ * prefixes are not guaranteed by the spec.
+ */
+export declare const ODF_NS: {
+    readonly OFFICE: "urn:oasis:names:tc:opendocument:xmlns:office:1.0";
+    readonly TEXT: "urn:oasis:names:tc:opendocument:xmlns:text:1.0";
+    readonly STYLE: "urn:oasis:names:tc:opendocument:xmlns:style:1.0";
+    readonly TABLE: "urn:oasis:names:tc:opendocument:xmlns:table:1.0";
+    readonly MANIFEST: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0";
+    readonly DC: "http://purl.org/dc/elements/1.1/";
+    readonly XML: "http://www.w3.org/XML/1998/namespace";
+};
+/** The mimetype value an OpenDocument text package declares. */
+export declare const ODT_MIMETYPE = "application/vnd.oasis.opendocument.text";
+/** Standard part paths within an ODF package. */
+export declare const ODF_PATHS: {
+    readonly MIMETYPE: "mimetype";
+    readonly CONTENT: "content.xml";
+    readonly STYLES: "styles.xml";
+    readonly META: "meta.xml";
+    readonly MANIFEST: "META-INF/manifest.xml";
+};
+//# sourceMappingURL=namespaces.d.ts.map

package/dist/shared/odf/namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../../src/shared/odf/namespaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;;;;;;;CAUT,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,YAAY,4CAA4C,CAAC;AAEtE,iDAAiD;AACjD,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC"}

package/dist/shared/odf/namespaces.js

@@ -0,0 +1,29 @@
+/**
+ * OpenDocument Format (ODF) XML namespace URIs and the OpenDocument text mimetype.
+ *
+ * ODF content is heavily namespaced; the document view MUST resolve elements via
+ * `getElementsByTagNameNS` / `localName` rather than prefixed tag names, because
+ * prefixes are not guaranteed by the spec.
+ */
+export const ODF_NS = {
+    OFFICE: 'urn:oasis:names:tc:opendocument:xmlns:office:1.0',
+    TEXT: 'urn:oasis:names:tc:opendocument:xmlns:text:1.0',
+    STYLE: 'urn:oasis:names:tc:opendocument:xmlns:style:1.0',
+    TABLE: 'urn:oasis:names:tc:opendocument:xmlns:table:1.0',
+    MANIFEST: 'urn:oasis:names:tc:opendocument:xmlns:manifest:1.0',
+    // Dublin Core — carries annotation/change author (`dc:creator`) and date (`dc:date`).
+    DC: 'http://purl.org/dc/elements/1.1/',
+    // W3C XML namespace — carries `xml:id` on `text:changed-region` for tracked changes.
+    XML: 'http://www.w3.org/XML/1998/namespace',
+};
+/** The mimetype value an OpenDocument text package declares. */
+export const ODT_MIMETYPE = 'application/vnd.oasis.opendocument.text';
+/** Standard part paths within an ODF package. */
+export const ODF_PATHS = {
+    MIMETYPE: 'mimetype',
+    CONTENT: 'content.xml',
+    STYLES: 'styles.xml',
+    META: 'meta.xml',
+    MANIFEST: 'META-INF/manifest.xml',
+};
+//# sourceMappingURL=namespaces.js.map

package/dist/shared/odf/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../../src/shared/odf/namespaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,kDAAkD;IAC1D,IAAI,EAAE,gDAAgD;IACtD,KAAK,EAAE,iDAAiD;IACxD,KAAK,EAAE,iDAAiD;IACxD,QAAQ,EAAE,oDAAoD;IAC9D,sFAAsF;IACtF,EAAE,EAAE,kCAAkC;IACtC,qFAAqF;IACrF,GAAG,EAAE,sCAAsC;CACnC,CAAC;AAEX,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,yCAAyC,CAAC;AAEtE,iDAAiD;AACjD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,uBAAuB;CACzB,CAAC"}

package/dist/shared/odf/text_segments.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared visible-text ↔ DOM-node mapping for ODF block-level text elements.
+ *
+ * Extracted from `document.ts` so both the document view and the comments module use one
+ * segmentation of a `text:p`/`text:h`'s visible text without an import cycle.
+ *
+ * All element matching is by `namespaceURI` + `localName` (ODF prefixes are not guaranteed).
+ */
+export declare const TEXT_NODE = 3;
+export declare const ELEMENT_NODE = 1;
+/** True for the block-level text elements that carry a paragraph's visible content. */
+export declare function isTextBlock(el: {
+    namespaceURI?: string | null;
+    localName?: string | null;
+}): boolean;
+/**
+ * True for an `office:annotation` / `office:annotation-end` element. Annotation subtrees carry
+ * their own `text:p` comment body, which must NOT be walked as part of the host paragraph's
+ * visible text nor enumerated as a paragraph block — callers skip these subtrees.
+ */
+export declare function isAnnotationSubtree(el: {
+    namespaceURI?: string | null;
+    localName?: string | null;
+}): boolean;
+/**
+ * True for a `text:tracked-changes` container. It holds change DEFINITIONS — including deleted
+ * paragraphs stored out-of-line inside `text:deletion` — which are NOT body content: they must
+ * not be walked as a host paragraph's visible text nor enumerated as paragraph blocks. Callers
+ * skip this subtree (the deletion-storage analogue of `isAnnotationSubtree`).
+ */
+export declare function isTrackedChangesSubtree(el: {
+    namespaceURI?: string | null;
+    localName?: string | null;
+}): boolean;
+/** A contiguous slice of a paragraph's visible text and where it came from. */
+export type Segment = {
+    kind: 'text';
+    node: {
+        data: string;
+    };
+    visStart: number;
+    length: number;
+} | {
+    kind: 'virtual';
+    node: Element;
+    virtual: 'space' | 'tab' | 'line-break';
+    visStart: number;
+    length: number;
+};
+/**
+ * Build the ordered segment list and concatenated visible string for a block.
+ * `text:s` (count via `text:c`) expands to spaces, `text:tab` to a tab, and
+ * `text:line-break` to a newline — each a "virtual" segment whose visible text has no host
+ * `#text` node (so a match landing on one cannot be edited in place via `replaceTextById`);
+ * the generating element itself is carried as `node` so offset-mapping consumers (the compare
+ * emitter) can split or copy it. `office:annotation` / `office:annotation-end` subtrees are
+ * skipped entirely.
+ */
+export declare function buildSegments(block: Element): {
+    segments: Segment[];
+    visible: string;
+};
+//# sourceMappingURL=text_segments.d.ts.map

package/dist/shared/odf/text_segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_segments.d.ts","sourceRoot":"","sources":["../../../src/shared/odf/text_segments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,EAAE,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAEpG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAE5G;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAEhH;AAED,+EAA+E;AAC/E,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6CtF"}

package/dist/shared/odf/text_segments.js

@@ -0,0 +1,90 @@
+/**
+ * Shared visible-text ↔ DOM-node mapping for ODF block-level text elements.
+ *
+ * Extracted from `document.ts` so both the document view and the comments module use one
+ * segmentation of a `text:p`/`text:h`'s visible text without an import cycle.
+ *
+ * All element matching is by `namespaceURI` + `localName` (ODF prefixes are not guaranteed).
+ */
+import { ODF_NS } from './namespaces.js';
+export const TEXT_NODE = 3;
+export const ELEMENT_NODE = 1;
+/** True for the block-level text elements that carry a paragraph's visible content. */
+export function isTextBlock(el) {
+    return el.namespaceURI === ODF_NS.TEXT && (el.localName === 'p' || el.localName === 'h');
+}
+/**
+ * True for an `office:annotation` / `office:annotation-end` element. Annotation subtrees carry
+ * their own `text:p` comment body, which must NOT be walked as part of the host paragraph's
+ * visible text nor enumerated as a paragraph block — callers skip these subtrees.
+ */
+export function isAnnotationSubtree(el) {
+    return el.namespaceURI === ODF_NS.OFFICE && (el.localName === 'annotation' || el.localName === 'annotation-end');
+}
+/**
+ * True for a `text:tracked-changes` container. It holds change DEFINITIONS — including deleted
+ * paragraphs stored out-of-line inside `text:deletion` — which are NOT body content: they must
+ * not be walked as a host paragraph's visible text nor enumerated as paragraph blocks. Callers
+ * skip this subtree (the deletion-storage analogue of `isAnnotationSubtree`).
+ */
+export function isTrackedChangesSubtree(el) {
+    return el.namespaceURI === ODF_NS.TEXT && el.localName === 'tracked-changes';
+}
+/**
+ * Build the ordered segment list and concatenated visible string for a block.
+ * `text:s` (count via `text:c`) expands to spaces, `text:tab` to a tab, and
+ * `text:line-break` to a newline — each a "virtual" segment whose visible text has no host
+ * `#text` node (so a match landing on one cannot be edited in place via `replaceTextById`);
+ * the generating element itself is carried as `node` so offset-mapping consumers (the compare
+ * emitter) can split or copy it. `office:annotation` / `office:annotation-end` subtrees are
+ * skipped entirely.
+ */
+export function buildSegments(block) {
+    const segments = [];
+    let visible = '';
+    const walk = (node) => {
+        for (let child = node.firstChild; child; child = child.nextSibling) {
+            if (child.nodeType === TEXT_NODE) {
+                const data = child.data ?? '';
+                if (data.length === 0)
+                    continue;
+                segments.push({ kind: 'text', node: child, visStart: visible.length, length: data.length });
+                visible += data;
+                continue;
+            }
+            if (child.nodeType !== ELEMENT_NODE)
+                continue;
+            const el = child;
+            // Skip annotation subtrees: their body text is a comment, not the host paragraph's content.
+            if (isAnnotationSubtree(el))
+                continue;
+            // Skip tracked-changes storage: deleted paragraphs live out-of-line here, not in the body.
+            if (isTrackedChangesSubtree(el))
+                continue;
+            if (el.namespaceURI === ODF_NS.TEXT && el.localName === 's') {
+                const countRaw = el.getAttributeNS(ODF_NS.TEXT, 'c') ?? el.getAttribute('text:c');
+                const count = Math.max(1, Number.parseInt(countRaw ?? '1', 10) || 1);
+                const spaces = ' '.repeat(count);
+                segments.push({ kind: 'virtual', node: el, virtual: 'space', visStart: visible.length, length: spaces.length });
+                visible += spaces;
+                continue;
+            }
+            if (el.namespaceURI === ODF_NS.TEXT && el.localName === 'tab') {
+                segments.push({ kind: 'virtual', node: el, virtual: 'tab', visStart: visible.length, length: 1 });
+                visible += '\t';
+                continue;
+            }
+            if (el.namespaceURI === ODF_NS.TEXT && el.localName === 'line-break') {
+                segments.push({ kind: 'virtual', node: el, virtual: 'line-break', visStart: visible.length, length: 1 });
+                visible += '\n';
+                continue;
+            }
+            // Other elements (text:span, hyperlink, etc.): recurse so their inner
+            // #text nodes are recorded as separate segments.
+            walk(el);
+        }
+    };
+    walk(block);
+    return { segments, visible };
+}
+//# sourceMappingURL=text_segments.js.map

package/dist/shared/odf/text_segments.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@usejunior/odf-core",
+  "version": "0.9.1",
+  "description": "OpenDocument Format (.odt) core library: archive packaging, document view, surgical text replacement, and tracked-changes comparison",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "clean:dist": "node -e \"const { rmSync } = require('node:fs'); rmSync('dist', { recursive: true, force: true });\"",
+    "build": "npm run clean:dist && tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "node ../../node_modules/vitest/vitest.mjs",
+    "test:run": "node ../../node_modules/vitest/vitest.mjs run",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@usejunior/docx-core": "^0.9.1",
+    "@xmldom/xmldom": "^0.9.10",
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UseJunior/safe-docx"
+  },
+  "homepage": "https://github.com/UseJunior/safe-docx/tree/main/packages/odf-core",
+  "bugs": {
+    "url": "https://github.com/UseJunior/safe-docx/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "odf",
+    "opendocument",
+    "odt",
+    "libreoffice",
+    "track-changes",
+    "comparison",
+    "document-editing",
+    "mcp"
+  ],
+  "license": "MIT"
+}