@cj-tech-master/excelts 9.5.0 → 9.5.1

package/dist/browser/modules/word/document.js

@@ -4,10 +4,10 @@
  * High-level fluent API for constructing DOCX documents programmatically.
  * Provides convenience methods for common operations including comments,
  * track changes, TOC, math, text boxes, checkboxes, and custom properties.
+ *
+ * This file has NO static imports from docx-packager or docx-reader,
+ * ensuring that importing builder helpers does not pull in archive/xml code.
  */
-import { packageDocx } from "./docx-packager.js";
-import { readDocx } from "./docx-reader.js";
-import { bytesToBase64 } from "./internal-utils.js";
 // =============================================================================
 // Helper Builders
 // =============================================================================
@@ -646,88 +646,91 @@ export function simpleTable(data, options) {
         borders: opts.borders ? gridBorders() : undefined
     }, opts.columnWidths);
 }
-// =============================================================================
-// Document Builder Class
-// =============================================================================
+/** Cast internal state to opaque handle. */
+function _toHandle(state) {
+    return state;
+}
+/** Cast opaque handle back to internal state. */
+function _toState(handle) {
+    return handle;
+}
 /**
- * Fluent builder for constructing DOCX documents.
+ * Namespace of free functions for building DOCX documents.
+ *
+ * Replaces the former `DocumentBuilder` class with tree-shakeable free functions.
+ * Each function operates on an opaque `DocumentHandle`.
  *
  * @example
  * ```ts
- * const doc = new DocumentBuilder()
- *   .addHeading("Hello World", 1)
- *   .addParagraph("This is a paragraph.")
- *   .addTable([["Name", "Age"], ["Alice", "30"]])
- *   .build();
- *
- * const bytes = await doc.toBuffer();
+ * const doc = Document.create();
+ * Document.addHeading(doc, "Hello World", 1);
+ * Document.addParagraph(doc, "This is a paragraph.");
+ * Document.addTable(doc, [["Name", "Age"], ["Alice", "30"]]);
+ * const bytes = await Document.toBuffer(doc);
  * ```
  */
-export class DocumentBuilder {
-    constructor() {
-        this._body = [];
-        this._styles = [];
-        this._abstractNumberings = [];
-        this._numberingInstances = [];
-        this._headers = new Map();
-        this._footers = new Map();
-        this._footnotes = [];
-        this._endnotes = [];
-        this._images = [];
-        this._fonts = [];
-        this._comments = [];
-        this._customProperties = [];
-        this._nextImageId = 1;
-        this._nextFootnoteId = 1;
-        this._nextEndnoteId = 1;
-        this._nextBookmarkId = 0;
-        this._nextAbstractNumId = 0;
-        this._nextNumId = 1;
-        this._nextDrawingId = 1;
-        this._nextCommentId = 0;
-    }
+export const Document = {
+    /** Create a new document handle. */
+    create() {
+        return _toHandle({
+            body: [],
+            styles: [],
+            abstractNumberings: [],
+            numberingInstances: [],
+            headers: new Map(),
+            footers: new Map(),
+            footnotes: [],
+            endnotes: [],
+            images: [],
+            fonts: [],
+            comments: [],
+            customProperties: [],
+            nextImageId: 1,
+            nextFootnoteId: 1,
+            nextEndnoteId: 1,
+            nextBookmarkId: 0,
+            nextAbstractNumId: 0,
+            nextNumId: 1,
+            nextDrawingId: 1,
+            nextCommentId: 0
+        });
+    },
     /** Add raw body content. */
-    addContent(content) {
-        this._body.push(content);
-        return this;
-    }
+    addContent(doc, content) {
+        _toState(doc).body.push(content);
+    },
     /** Add a paragraph with runs. */
-    addParagraphElement(para) {
-        this._body.push(para);
-        return this;
-    }
+    addParagraphElement(doc, para) {
+        _toState(doc).body.push(para);
+    },
     /** Add a simple text paragraph. */
-    addParagraph(content, properties) {
-        this._body.push(textParagraph(content, properties));
-        return this;
-    }
+    addParagraph(doc, content, properties) {
+        _toState(doc).body.push(textParagraph(content, properties));
+    },
     /** Add a heading. */
-    addHeading(content, level = 1) {
-        this._body.push(heading(content, level));
-        return this;
-    }
+    addHeading(doc, content, level = 1) {
+        _toState(doc).body.push(heading(content, level));
+    },
     /** Add a page break. */
-    addPageBreak() {
-        this._body.push(paragraph([pageBreak()]));
-        return this;
-    }
+    addPageBreak(doc) {
+        _toState(doc).body.push(paragraph([pageBreak()]));
+    },
     /** Add a table from a 2D array. */
-    addTable(data, options) {
-        this._body.push(simpleTable(data, options));
-        return this;
-    }
+    addTable(doc, data, options) {
+        _toState(doc).body.push(simpleTable(data, options));
+    },
     /** Add a table element. */
-    addTableElement(tbl) {
-        this._body.push(tbl);
-        return this;
-    }
+    addTableElement(doc, tbl) {
+        _toState(doc).body.push(tbl);
+    },
     /** Add an inline image. Returns the image relationship ID and drawing ID. */
-    addImage(data, mediaType, width, height, options) {
-        const fileName = `image${this._nextImageId}.${mediaType}`;
-        const rId = `__img_${this._nextImageId}`;
-        const drawingId = this._nextDrawingId++;
-        this._images.push({ data, mediaType, fileName, rId });
-        this._body.push(paragraph([
+    addImage(doc, data, mediaType, width, height, options) {
+        const s = _toState(doc);
+        const fileName = `image${s.nextImageId}.${mediaType}`;
+        const rId = `__img_${s.nextImageId}`;
+        const drawingId = s.nextDrawingId++;
+        s.images.push({ data, mediaType, fileName, rId });
+        s.body.push(paragraph([
             {
                 content: [
                     {
@@ -736,26 +739,27 @@ export class DocumentBuilder {
                         width,
                         height,
                         altText: options?.altText,
-                        name: options?.name ?? `Picture ${this._nextImageId}`,
+                        name: options?.name ?? `Picture ${s.nextImageId}`,
                         drawingId
                     }
                 ]
             }
         ]));
-        this._nextImageId++;
+        s.nextImageId++;
         return { rId, drawingId };
-    }
+    },
     /** Add a floating image. Returns the image relationship ID. */
-    addFloatingImage(data, mediaType, width, height, options) {
-        const fileName = `image${this._nextImageId}.${mediaType}`;
-        const rId = `__img_${this._nextImageId}`;
-        this._images.push({ data, mediaType, fileName, rId });
-        this._body.push(floatingImage({
+    addFloatingImage(doc, data, mediaType, width, height, options) {
+        const s = _toState(doc);
+        const fileName = `image${s.nextImageId}.${mediaType}`;
+        const rId = `__img_${s.nextImageId}`;
+        s.images.push({ data, mediaType, fileName, rId });
+        s.body.push(floatingImage({
             rId,
             width,
             height,
             altText: options?.altText,
-            name: options?.name ?? `Picture ${this._nextImageId}`,
+            name: options?.name ?? `Picture ${s.nextImageId}`,
             horizontalPosition: options?.horizontalPosition,
             verticalPosition: options?.verticalPosition,
             wrap: options?.wrap,
@@ -771,38 +775,39 @@ export class DocumentBuilder {
             flipHorizontal: options?.flipHorizontal,
             flipVertical: options?.flipVertical
         }));
-        this._nextImageId++;
+        s.nextImageId++;
         return rId;
-    }
+    },
     /** Add a custom font definition. */
-    addFont(font) {
-        this._fonts.push(font);
-        return this;
-    }
+    addFont(doc, font) {
+        _toState(doc).fonts.push(font);
+    },
     /** Set a text watermark on the document. */
-    setWatermark(watermark) {
-        this._watermark = watermark;
-        return this;
-    }
+    setWatermark(doc, watermark) {
+        _toState(doc).watermark = watermark;
+    },
     /** Add a footnote. Returns the footnote ID. */
-    addFootnote(content) {
-        const id = this._nextFootnoteId++;
+    addFootnote(doc, content) {
+        const s = _toState(doc);
+        const id = s.nextFootnoteId++;
         const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        this._footnotes.push({ id, content: paras });
+        s.footnotes.push({ id, content: paras });
         return id;
-    }
+    },
     /** Add an endnote. Returns the endnote ID. */
-    addEndnote(content) {
-        const id = this._nextEndnoteId++;
+    addEndnote(doc, content) {
+        const s = _toState(doc);
+        const id = s.nextEndnoteId++;
         const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        this._endnotes.push({ id, content: paras });
+        s.endnotes.push({ id, content: paras });
         return id;
-    }
+    },
     /** Add a comment. Returns the comment ID. */
-    addComment(author, content, options) {
-        const id = this._nextCommentId++;
+    addComment(doc, author, content, options) {
+        const s = _toState(doc);
+        const id = s.nextCommentId++;
         const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        this._comments.push({
+        s.comments.push({
             id,
             author,
             date: options?.date,
@@ -810,26 +815,24 @@ export class DocumentBuilder {
             content: paras
         });
         return id;
-    }
+    },
     /** Add a Table of Contents. */
-    addTableOfContents(options) {
-        this._body.push({
+    addTableOfContents(doc, options) {
+        _toState(doc).body.push({
             type: "tableOfContents",
             headingStyleRange: options?.headingStyleRange ?? "1-3",
             hyperlink: options?.hyperlink ?? true,
             ...options
         });
-        return this;
-    }
+    },
     /** Add a math equation block. */
-    addMath(content) {
-        this._body.push(mathBlock(content));
-        return this;
-    }
+    addMath(doc, content) {
+        _toState(doc).body.push(mathBlock(content));
+    },
     /** Add a text box. */
-    addTextBox(content, options) {
+    addTextBox(doc, content, options) {
         const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        this._body.push({
+        _toState(doc).body.push({
             type: "textBox",
             content: paras,
             width: options?.width,
@@ -837,15 +840,15 @@ export class DocumentBuilder {
             stroke: options?.stroke,
             fill: options?.fill
         });
-        return this;
-    }
+    },
     /** Add a bullet list. */
-    addBulletList(items, level = 0) {
+    addBulletList(doc, items, level = 0) {
+        const s = _toState(doc);
         // Create abstract numbering for bullets if not exists
-        let bulletAbsId = this._abstractNumberings.find(a => a.levels[0]?.format === "bullet")?.abstractNumId;
+        let bulletAbsId = s.abstractNumberings.find(a => a.levels[0]?.format === "bullet")?.abstractNumId;
         if (bulletAbsId === undefined) {
-            bulletAbsId = this._nextAbstractNumId++;
-            this._abstractNumberings.push({
+            bulletAbsId = s.nextAbstractNumId++;
+            s.abstractNumberings.push({
                 abstractNumId: bulletAbsId,
                 multiLevelType: "hybridMultilevel",
                 levels: [
@@ -878,23 +881,23 @@ export class DocumentBuilder {
                     }
                 ]
             });
-            this._numberingInstances.push({
-                numId: this._nextNumId++,
+            s.numberingInstances.push({
+                numId: s.nextNumId++,
                 abstractNumId: bulletAbsId
             });
         }
-        const numId = this._numberingInstances.find(n => n.abstractNumId === bulletAbsId).numId;
+        const numId = s.numberingInstances.find(n => n.abstractNumId === bulletAbsId).numId;
         for (const item of items) {
-            this._body.push(textParagraph(item, { numbering: { numId, level } }));
+            s.body.push(textParagraph(item, { numbering: { numId, level } }));
         }
-        return this;
-    }
+    },
     /** Add a numbered list. */
-    addNumberedList(items, level = 0) {
-        let numAbsId = this._abstractNumberings.find(a => a.levels[0]?.format === "decimal")?.abstractNumId;
+    addNumberedList(doc, items, level = 0) {
+        const s = _toState(doc);
+        let numAbsId = s.abstractNumberings.find(a => a.levels[0]?.format === "decimal")?.abstractNumId;
         if (numAbsId === undefined) {
-            numAbsId = this._nextAbstractNumId++;
-            this._abstractNumberings.push({
+            numAbsId = s.nextAbstractNumId++;
+            s.abstractNumberings.push({
                 abstractNumId: numAbsId,
                 multiLevelType: "hybridMultilevel",
                 levels: [
@@ -924,35 +927,32 @@ export class DocumentBuilder {
                     }
                 ]
             });
-            this._numberingInstances.push({
-                numId: this._nextNumId++,
+            s.numberingInstances.push({
+                numId: s.nextNumId++,
                 abstractNumId: numAbsId
             });
         }
-        const numId = this._numberingInstances.find(n => n.abstractNumId === numAbsId).numId;
+        const numId = s.numberingInstances.find(n => n.abstractNumId === numAbsId).numId;
         for (const item of items) {
-            this._body.push(textParagraph(item, { numbering: { numId, level } }));
+            s.body.push(textParagraph(item, { numbering: { numId, level } }));
         }
-        return this;
-    }
+    },
     /** Set section properties (page size, margins, etc.). */
-    setSectionProperties(props) {
-        this._sectionProperties = props;
-        return this;
-    }
+    setSectionProperties(doc, props) {
+        _toState(doc).sectionProperties = props;
+    },
     /** Set document defaults. */
-    setDocDefaults(defaults) {
-        this._docDefaults = defaults;
-        return this;
-    }
+    setDocDefaults(doc, defaults) {
+        _toState(doc).docDefaults = defaults;
+    },
     /** Add a style definition. */
-    addStyle(style) {
-        this._styles.push(style);
-        return this;
-    }
+    addStyle(doc, style) {
+        _toState(doc).styles.push(style);
+    },
     /** Set default styles (Normal, Heading1-6, Hyperlink, etc.). */
-    useDefaultStyles() {
-        this._docDefaults = {
+    useDefaultStyles(doc) {
+        const s = _toState(doc);
+        s.docDefaults = {
             runProperties: {
                 font: { ascii: "Calibri", hAnsi: "Calibri", eastAsia: "SimSun", cs: "Times New Roman" },
                 size: 22,
@@ -963,7 +963,7 @@ export class DocumentBuilder {
                 spacing: { after: 160, line: 259, lineRule: "auto" }
             }
         };
-        this._styles.push({ type: "paragraph", styleId: "Normal", name: "Normal", isDefault: true, qFormat: true }, {
+        s.styles.push({ type: "paragraph", styleId: "Normal", name: "Normal", isDefault: true, qFormat: true }, {
             type: "paragraph",
             styleId: "Heading1",
             name: "heading 1",
@@ -1011,192 +1011,90 @@ export class DocumentBuilder {
             uiPriority: 39,
             tableProperties: { borders: gridBorders(4, "auto") }
         });
-        return this;
-    }
+    },
     /** Set a header for the given type. */
-    setHeader(type, content) {
-        this._headers.set(type, { content });
-        return this;
-    }
+    setHeader(doc, type, content) {
+        _toState(doc).headers.set(type, { content });
+    },
     /** Set a footer for the given type. */
-    setFooter(type, content) {
-        this._footers.set(type, { content });
-        return this;
-    }
+    setFooter(doc, type, content) {
+        _toState(doc).footers.set(type, { content });
+    },
     /** Set document settings. */
-    setSettings(settings) {
-        this._settings = settings;
-        return this;
-    }
+    setSettings(doc, settings) {
+        _toState(doc).settings = settings;
+    },
     /** Set core properties (metadata). */
-    setCoreProperties(props) {
-        this._coreProperties = props;
-        return this;
-    }
+    setCoreProperties(doc, props) {
+        _toState(doc).coreProperties = props;
+    },
     /** Set application properties. */
-    setAppProperties(props) {
-        this._appProperties = props;
-        return this;
-    }
+    setAppProperties(doc, props) {
+        _toState(doc).appProperties = props;
+    },
     /** Set document background. */
-    setBackground(background) {
-        this._background = background;
-        return this;
-    }
+    setBackground(doc, background) {
+        _toState(doc).background = background;
+    },
     /** Add a custom document property. */
-    addCustomProperty(name, value) {
-        this._customProperties.push({ name, value });
-        return this;
-    }
+    addCustomProperty(doc, name, value) {
+        _toState(doc).customProperties.push({ name, value });
+    },
     /** Add a section break with properties. */
-    addSectionBreak(props) {
+    addSectionBreak(doc, props) {
+        const s = _toState(doc);
         // Insert as the last paragraph's section properties
-        if (this._body.length > 0) {
-            const last = this._body[this._body.length - 1];
+        if (s.body.length > 0) {
+            const last = s.body[s.body.length - 1];
             if (last.type === "paragraph") {
                 const existingProps = last.properties ?? {};
-                this._body[this._body.length - 1] = {
+                s.body[s.body.length - 1] = {
                     ...last,
                     properties: { ...existingProps, sectionProperties: props }
                 };
-                return this;
+                return;
             }
         }
         // If no previous paragraph, add an empty one with section properties
-        this._body.push(paragraph([], { sectionProperties: props }));
-        return this;
-    }
+        s.body.push(paragraph([], { sectionProperties: props }));
+    },
     /** Get next available bookmark ID. */
-    nextBookmarkId() {
-        return this._nextBookmarkId++;
-    }
-    /** Build the DocxDocument model. */
-    build() {
+    nextBookmarkId(doc) {
+        return _toState(doc).nextBookmarkId++;
+    },
+    /** Build the DocxDocument model from the handle. */
+    build(doc) {
+        const s = _toState(doc);
         return {
-            body: this._body,
-            sectionProperties: this._sectionProperties ?? {
+            body: s.body,
+            sectionProperties: s.sectionProperties ?? {
                 pageSize: { width: 12240, height: 15840 },
                 margins: { top: 1440, right: 1440, bottom: 1440, left: 1440 }
             },
-            styles: this._styles.length > 0 ? this._styles : undefined,
-            docDefaults: this._docDefaults,
-            abstractNumberings: this._abstractNumberings.length > 0 ? this._abstractNumberings : undefined,
-            numberingInstances: this._numberingInstances.length > 0 ? this._numberingInstances : undefined,
-            headers: this._headers.size > 0 ? this._headers : undefined,
-            footers: this._footers.size > 0 ? this._footers : undefined,
-            footnotes: this._footnotes.length > 0 ? this._footnotes : undefined,
-            endnotes: this._endnotes.length > 0 ? this._endnotes : undefined,
-            images: this._images.length > 0 ? this._images : undefined,
-            fonts: this._fonts.length > 0 ? this._fonts : undefined,
-            settings: this._settings,
-            coreProperties: this._coreProperties,
-            appProperties: this._appProperties,
-            comments: this._comments.length > 0 ? this._comments : undefined,
-            background: this._background,
-            customProperties: this._customProperties.length > 0 ? this._customProperties : undefined,
-            watermark: this._watermark
+            styles: s.styles.length > 0 ? s.styles : undefined,
+            docDefaults: s.docDefaults,
+            abstractNumberings: s.abstractNumberings.length > 0 ? s.abstractNumberings : undefined,
+            numberingInstances: s.numberingInstances.length > 0 ? s.numberingInstances : undefined,
+            headers: s.headers.size > 0 ? s.headers : undefined,
+            footers: s.footers.size > 0 ? s.footers : undefined,
+            footnotes: s.footnotes.length > 0 ? s.footnotes : undefined,
+            endnotes: s.endnotes.length > 0 ? s.endnotes : undefined,
+            images: s.images.length > 0 ? s.images : undefined,
+            fonts: s.fonts.length > 0 ? s.fonts : undefined,
+            settings: s.settings,
+            coreProperties: s.coreProperties,
+            appProperties: s.appProperties,
+            comments: s.comments.length > 0 ? s.comments : undefined,
+            background: s.background,
+            customProperties: s.customProperties.length > 0 ? s.customProperties : undefined,
+            watermark: s.watermark
         };
     }
-    /** Build and package to DOCX bytes. */
-    async toBuffer(compressionLevel) {
-        return packageDocx(this.build(), compressionLevel);
-    }
-    /** Build and package to base64 string. */
-    async toBase64(compressionLevel) {
-        const bytes = await this.toBuffer(compressionLevel);
-        return bytesToBase64(bytes);
-    }
-}
+};
 // =============================================================================
-// Theme Color Resolution
+// Theme Color Resolution (re-export from color-utils for backward compat)
 // =============================================================================
-/**
- * Map OOXML theme color attribute names to theme color scheme keys.
- * Word uses different names in run/paragraph properties vs the theme XML.
- */
-const THEME_COLOR_MAP = {
-    dark1: "dk1",
-    light1: "lt1",
-    dark2: "dk2",
-    light2: "lt2",
-    accent1: "accent1",
-    accent2: "accent2",
-    accent3: "accent3",
-    accent4: "accent4",
-    accent5: "accent5",
-    accent6: "accent6",
-    hyperlink: "hlink",
-    followedHyperlink: "folHlink",
-    // Direct names also work
-    dk1: "dk1",
-    lt1: "lt1",
-    dk2: "dk2",
-    lt2: "lt2",
-    hlink: "hlink",
-    folHlink: "folHlink"
-};
-/**
- * Resolve a ColorSpec to an actual hex RGB color using the document theme.
- *
- * Applies theme color lookup + tint/shade transformations per OOXML spec.
- *
- * @param color - The color value (HexColor string or ColorSpec).
- * @param theme - The document theme (from `doc.theme`).
- * @returns Resolved hex color string (6 chars, no #), or undefined if unresolvable.
- */
-export function resolveThemeColor(color, theme) {
-    if (color === undefined) {
-        return undefined;
-    }
-    if (typeof color === "string") {
-        return color;
-    }
-    // ColorSpec with val — use directly
-    if (color.val && color.val !== "auto") {
-        return color.val;
-    }
-    // Resolve via theme
-    if (!color.themeColor || !theme) {
-        return color.val;
-    }
-    const key = THEME_COLOR_MAP[color.themeColor] ?? color.themeColor;
-    const base = theme.colorScheme.colors[key];
-    if (!base) {
-        return color.val;
-    }
-    // Apply tint or shade
-    if (color.themeTint) {
-        return applyTint(base, parseInt(color.themeTint, 16) / 255);
-    }
-    if (color.themeShade) {
-        return applyShade(base, parseInt(color.themeShade, 16) / 255);
-    }
-    return base;
-}
-/** Apply tint to a hex color. tint=1 → white, tint=0 → original. */
-function applyTint(hex, tint) {
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
-    const nr = Math.round(r + (255 - r) * tint);
-    const ng = Math.round(g + (255 - g) * tint);
-    const nb = Math.round(b + (255 - b) * tint);
-    return toHex2(nr) + toHex2(ng) + toHex2(nb);
-}
-/** Apply shade to a hex color. shade=1 → original, shade=0 → black. */
-function applyShade(hex, shade) {
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
-    const nr = Math.round(r * shade);
-    const ng = Math.round(g * shade);
-    const nb = Math.round(b * shade);
-    return toHex2(nr) + toHex2(ng) + toHex2(nb);
-}
-function toHex2(n) {
-    const h = Math.max(0, Math.min(255, n)).toString(16);
-    return h.length < 2 ? "0" + h : h;
-}
+export { resolveThemeColor } from "./color-utils.js";
 /** Extract concatenated plain text from a paragraph's runs. */
 function paragraphText(para) {
     let text = "";
@@ -1633,163 +1531,3 @@ function countOccurrences(str, search) {
     }
     return str.split(search).length - 1;
 }
-/**
- * Read an existing DOCX file, replace placeholders with content, and produce a new DOCX.
- *
- * Placeholders are strings like `{{name}}` embedded in the document text.
- * They may span across multiple runs — the patcher handles cross-run matching.
- *
- * Supported patch content types:
- * - `text` — simple text replacement (preserves formatting of the first run)
- * - `paragraph` — replaces the entire paragraph containing the placeholder
- * - `table` — replaces the entire paragraph with a table
- * - `image` — replaces the placeholder with an inline image
- *
- * @param buffer - The source DOCX file as a Uint8Array.
- * @param patches - Array of patch operations to apply.
- * @param options - Optional compression settings.
- * @returns New DOCX file as a Uint8Array.
- */
-export async function patchDocument(buffer, patches, options) {
-    const doc = await readDocx(buffer);
-    // Build lookup map for quick placeholder matching
-    const patchMap = new Map();
-    for (const patch of patches) {
-        patchMap.set(patch.placeholder, patch);
-    }
-    // Process body content
-    const newBody = [];
-    for (const block of doc.body) {
-        if (block.type === "paragraph") {
-            const result = patchParagraph(block, patchMap);
-            if (result) {
-                if (Array.isArray(result)) {
-                    newBody.push(...result);
-                }
-                else {
-                    newBody.push(result);
-                }
-            }
-        }
-        else if (block.type === "table") {
-            patchTable(block, patchMap);
-            newBody.push(block);
-        }
-        else {
-            newBody.push(block);
-        }
-    }
-    // Patch headers
-    if (doc.headers) {
-        for (const [, headerDef] of doc.headers) {
-            patchHeaderFooterContent(headerDef.content, patchMap);
-        }
-    }
-    // Patch footers
-    if (doc.footers) {
-        for (const [, footerDef] of doc.footers) {
-            patchHeaderFooterContent(footerDef.content, patchMap);
-        }
-    }
-    // Add any new images from patches
-    const images = doc.images ? [...doc.images] : [];
-    for (const patch of patches) {
-        if (patch.content.type === "image") {
-            const imgContent = patch.content;
-            const existing = images.find(i => i.fileName === imgContent.image.fileName);
-            if (!existing) {
-                images.push(imgContent.image);
-            }
-        }
-    }
-    const patched = {
-        ...doc,
-        body: newBody,
-        images: images.length > 0 ? images : undefined
-    };
-    return packageDocx(patched, options?.compressionLevel);
-}
-/** Patch a paragraph — returns replacement content or null to remove. */
-function patchParagraph(para, patchMap) {
-    const text = paragraphText(para);
-    for (const [placeholder, patch] of patchMap) {
-        if (!text.includes(placeholder)) {
-            continue;
-        }
-        switch (patch.content.type) {
-            case "text": {
-                replaceInParagraph(para, placeholder, patch.content.text);
-                return para;
-            }
-            case "paragraph": {
-                return patch.content.children;
-            }
-            case "table": {
-                return patch.content.table;
-            }
-            case "image": {
-                const img = patch.content.image;
-                const rId = img.rId ?? `rId_img_${img.fileName}`;
-                const imgContent = {
-                    type: "image",
-                    rId,
-                    width: patch.content.width,
-                    height: patch.content.height,
-                    altText: img.fileName,
-                    name: img.fileName
-                };
-                const newPara = {
-                    type: "paragraph",
-                    properties: para.properties,
-                    children: [{ content: [imgContent] }]
-                };
-                return newPara;
-            }
-        }
-    }
-    return para;
-}
-/** Patch text inside table cells recursively. */
-function patchTable(table, patchMap) {
-    for (const row of table.rows) {
-        for (const cell of row.cells) {
-            const newContent = [];
-            for (const block of cell.content) {
-                if (block.type === "paragraph") {
-                    const result = patchParagraph(block, patchMap);
-                    if (result) {
-                        if (Array.isArray(result)) {
-                            newContent.push(...result);
-                        }
-                        else {
-                            newContent.push(result);
-                        }
-                    }
-                }
-                else if (block.type === "table") {
-                    patchTable(block, patchMap);
-                    newContent.push(block);
-                }
-                else {
-                    newContent.push(block);
-                }
-            }
-            cell.content = newContent;
-        }
-    }
-}
-/** Patch text in header/footer content. */
-function patchHeaderFooterContent(content, patchMap) {
-    for (const child of content.children) {
-        if (child.type === "paragraph") {
-            for (const [placeholder, patch] of patchMap) {
-                if (patch.content.type === "text") {
-                    const text = paragraphText(child);
-                    if (text.includes(placeholder)) {
-                        replaceInParagraph(child, placeholder, patch.content.text);
-                    }
-                }
-            }
-        }
-    }
-}