@cj-tech-master/excelts 9.5.4 → 9.5.5

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

@@ -1,1645 +0,0 @@
-"use strict";
-/**
- * DOCX Module - Document Builder
- *
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveThemeColor = exports.Document = void 0;
-exports.text = text;
-exports.bold = bold;
-exports.italic = italic;
-exports.pageBreak = pageBreak;
-exports.lineBreak = lineBreak;
-exports.columnBreak = columnBreak;
-exports.tab = tab;
-exports.positionalTab = positionalTab;
-exports.ruby = ruby;
-exports.carriageReturn = carriageReturn;
-exports.noBreakHyphen = noBreakHyphen;
-exports.softHyphen = softHyphen;
-exports.field = field;
-exports.pageNumberField = pageNumberField;
-exports.totalPagesField = totalPagesField;
-exports.sectionPagesField = sectionPagesField;
-exports.sectionField = sectionField;
-exports.dateField = dateField;
-exports.sequenceField = sequenceField;
-exports.timeField = timeField;
-exports.authorField = authorField;
-exports.titleField = titleField;
-exports.subjectField = subjectField;
-exports.keywordsField = keywordsField;
-exports.fileNameField = fileNameField;
-exports.fileSizeField = fileSizeField;
-exports.styleRefField = styleRefField;
-exports.refField = refField;
-exports.pageRefField = pageRefField;
-exports.noteRefField = noteRefField;
-exports.hyperlinkField = hyperlinkField;
-exports.quoteField = quoteField;
-exports.tocField = tocField;
-exports.tcField = tcField;
-exports.indexEntryField = indexEntryField;
-exports.indexField = indexField;
-exports.ifField = ifField;
-exports.includeTextField = includeTextField;
-exports.includePictureField = includePictureField;
-exports.formTextField = formTextField;
-exports.formCheckboxField = formCheckboxField;
-exports.formDropdownField = formDropdownField;
-exports.paragraph = paragraph;
-exports.textParagraph = textParagraph;
-exports.heading = heading;
-exports.hyperlink = hyperlink;
-exports.bookmarkStart = bookmarkStart;
-exports.bookmarkEnd = bookmarkEnd;
-exports.commentRangeStart = commentRangeStart;
-exports.commentRangeEnd = commentRangeEnd;
-exports.commentReference = commentReference;
-exports.insertedRun = insertedRun;
-exports.deletedRun = deletedRun;
-exports.movedFromRun = movedFromRun;
-exports.movedToRun = movedToRun;
-exports.moveFromRangeStart = moveFromRangeStart;
-exports.moveFromRangeEnd = moveFromRangeEnd;
-exports.moveToRangeStart = moveToRangeStart;
-exports.moveToRangeEnd = moveToRangeEnd;
-exports.checkBox = checkBox;
-exports.mathBlock = mathBlock;
-exports.mathRun = mathRun;
-exports.mathFraction = mathFraction;
-exports.mathSqrt = mathSqrt;
-exports.mathRoot = mathRoot;
-exports.mathSum = mathSum;
-exports.mathIntegral = mathIntegral;
-exports.mathProduct = mathProduct;
-exports.mathSuperScript = mathSuperScript;
-exports.mathSubScript = mathSubScript;
-exports.mathSubSuperScript = mathSubSuperScript;
-exports.mathPreSubSuperScript = mathPreSubSuperScript;
-exports.mathPhantom = mathPhantom;
-exports.mathGroupChar = mathGroupChar;
-exports.mathBorderBox = mathBorderBox;
-exports.mathDelimiter = mathDelimiter;
-exports.mathNary = mathNary;
-exports.mathFunction = mathFunction;
-exports.mathLimit = mathLimit;
-exports.mathMatrix = mathMatrix;
-exports.mathAccent = mathAccent;
-exports.mathBar = mathBar;
-exports.mathBox = mathBox;
-exports.mathEquationArray = mathEquationArray;
-exports.symbol = symbol;
-exports.floatingImage = floatingImage;
-exports.drawingShape = drawingShape;
-exports.chart = chart;
-exports.structuredDocumentTag = structuredDocumentTag;
-exports.border = border;
-exports.gridBorders = gridBorders;
-exports.cell = cell;
-exports.row = row;
-exports.table = table;
-exports.simpleTable = simpleTable;
-exports.paragraphCount = paragraphCount;
-exports.countWords = countWords;
-exports.getHeadings = getHeadings;
-exports.findBookmark = findBookmark;
-exports.findComment = findComment;
-exports.listImages = listImages;
-exports.listTables = listTables;
-exports.listHyperlinks = listHyperlinks;
-exports.tableCount = tableCount;
-exports.extractText = extractText;
-exports.searchText = searchText;
-exports.replaceText = replaceText;
-exports.mailMerge = mailMerge;
-// =============================================================================
-// Helper Builders
-// =============================================================================
-/** Create a text run. */
-function text(content, properties) {
-    return { properties, content: [{ type: "text", text: content }] };
-}
-/** Create a bold text run. */
-function bold(content, properties) {
-    return text(content, { ...properties, bold: true });
-}
-/** Create an italic text run. */
-function italic(content, properties) {
-    return text(content, { ...properties, italic: true });
-}
-/** Create a run with a page break. */
-function pageBreak() {
-    return { content: [{ type: "break", breakType: "page" }] };
-}
-/** Create a run with a line break. */
-function lineBreak() {
-    return { content: [{ type: "break" }] };
-}
-/** Create a run with a column break. */
-function columnBreak() {
-    return { content: [{ type: "break", breakType: "column" }] };
-}
-/** Create a tab run. */
-function tab() {
-    return { content: [{ type: "tab" }] };
-}
-/** Create a positional tab (w:ptab). */
-function positionalTab(options) {
-    return {
-        content: [
-            {
-                type: "ptab",
-                alignment: options.alignment,
-                relativeTo: options.relativeTo,
-                leader: options.leader
-            }
-        ]
-    };
-}
-/**
- * Create a ruby (phonetic guide) run — e.g. Japanese furigana or Chinese pinyin.
- *
- * @param baseText - The main text being annotated.
- * @param rubyText - The phonetic text shown above the base.
- * @param properties - Optional ruby properties (alignment, font size, language).
- */
-function ruby(baseText, rubyText, properties) {
-    const normalize = (v) => {
-        if (typeof v === "string") {
-            return [text(v)];
-        }
-        if (Array.isArray(v)) {
-            return v;
-        }
-        return [v];
-    };
-    return {
-        content: [
-            {
-                type: "ruby",
-                properties,
-                baseText: normalize(baseText),
-                rubyText: normalize(rubyText)
-            }
-        ]
-    };
-}
-/** Create a carriage return run. */
-function carriageReturn() {
-    return { content: [{ type: "carriageReturn" }] };
-}
-/** Create a no-break hyphen run. */
-function noBreakHyphen() {
-    return { content: [{ type: "noBreakHyphen" }] };
-}
-/** Create a soft hyphen run. */
-function softHyphen() {
-    return { content: [{ type: "softHyphen" }] };
-}
-/** Create a run with a field code. */
-function field(instruction, cachedValue) {
-    return { content: [{ type: "field", instruction, cachedValue }] };
-}
-/** Create a PAGE field (current page number). */
-function pageNumberField(cachedValue) {
-    return field(" PAGE ", cachedValue ?? "1");
-}
-/** Create a NUMPAGES field (total page count). */
-function totalPagesField(cachedValue) {
-    return field(" NUMPAGES ", cachedValue ?? "1");
-}
-/** Create a SECTIONPAGES field (pages in section). */
-function sectionPagesField(cachedValue) {
-    return field(" SECTIONPAGES ", cachedValue ?? "1");
-}
-/** Create a SECTION field (current section number). */
-function sectionField(cachedValue) {
-    return field(" SECTION ", cachedValue ?? "1");
-}
-/** Create a DATE field. */
-function dateField(format, cachedValue) {
-    const fmt = format ?? "yyyy-MM-dd";
-    return field(` DATE \\@ "${fmt}" `, cachedValue);
-}
-/** Create a SEQ (sequence) field for numbering figures, tables, etc. */
-function sequenceField(identifier, options) {
-    let instruction = ` SEQ ${identifier} `;
-    if (options?.hide) {
-        instruction += "\\h ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create a TIME field (current time). */
-function timeField(format, cachedValue) {
-    const fmt = format ?? "HH:mm:ss";
-    return field(` TIME \\@ "${fmt}" `, cachedValue);
-}
-/** Create an AUTHOR field. */
-function authorField(cachedValue) {
-    return field(" AUTHOR ", cachedValue);
-}
-/** Create a TITLE field. */
-function titleField(cachedValue) {
-    return field(" TITLE ", cachedValue);
-}
-/** Create a SUBJECT field. */
-function subjectField(cachedValue) {
-    return field(" SUBJECT ", cachedValue);
-}
-/** Create a KEYWORDS field. */
-function keywordsField(cachedValue) {
-    return field(" KEYWORDS ", cachedValue);
-}
-/** Create a FILENAME field. */
-function fileNameField(options) {
-    const instruction = options?.includePath ? " FILENAME \\p " : " FILENAME ";
-    return field(instruction, options?.cachedValue);
-}
-/** Create a FILESIZE field. */
-function fileSizeField(cachedValue) {
-    return field(" FILESIZE ", cachedValue);
-}
-/**
- * Create a STYLEREF field (references text from nearest paragraph with given style).
- *
- * Commonly used in headers to show current chapter/section heading.
- */
-function styleRefField(styleName, options) {
-    let instruction = ` STYLEREF "${styleName}" `;
-    if (options?.fromBottom) {
-        instruction += "\\l ";
-    }
-    if (options?.insertParagraphNumber) {
-        instruction += "\\n ";
-    }
-    if (options?.insertPosition) {
-        instruction += "\\p ";
-    }
-    if (options?.suppressNonNumeric) {
-        instruction += "\\t ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/**
- * Create a REF field (references a bookmark).
- */
-function refField(bookmarkName, options) {
-    let instruction = ` REF ${bookmarkName} `;
-    if (options?.insertNumber) {
-        instruction += "\\n ";
-    }
-    if (options?.hyperlink) {
-        instruction += "\\h ";
-    }
-    if (options?.paragraphNumber) {
-        instruction += "\\w ";
-    }
-    if (options?.relativeParagraphNumber) {
-        instruction += "\\r ";
-    }
-    if (options?.fullContext) {
-        instruction += "\\w ";
-    }
-    if (options?.suppressNonDelimiter) {
-        instruction += "\\t ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create a PAGEREF field (references page of bookmark). */
-function pageRefField(bookmarkName, options) {
-    let instruction = ` PAGEREF ${bookmarkName} `;
-    if (options?.hyperlink) {
-        instruction += "\\h ";
-    }
-    if (options?.relativePosition) {
-        instruction += "\\p ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create a NOTEREF field (references a footnote/endnote). */
-function noteRefField(bookmarkName, options) {
-    let instruction = ` NOTEREF ${bookmarkName} `;
-    if (options?.hyperlink) {
-        instruction += "\\h ";
-    }
-    if (options?.insertNumberFormat) {
-        instruction += "\\f ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create a HYPERLINK field (alternative to w:hyperlink element). */
-function hyperlinkField(target, options) {
-    let instruction = ` HYPERLINK "${target}" `;
-    if (options?.anchor) {
-        instruction += `\\l "${options.anchor}" `;
-    }
-    if (options?.newWindow) {
-        instruction += "\\n ";
-    }
-    if (options?.tooltip) {
-        instruction += `\\o "${options.tooltip}" `;
-    }
-    return field(instruction, options?.cachedValue ?? options?.displayText);
-}
-/** Create a QUOTE field (literal text). */
-function quoteField(text, cachedValue) {
-    return field(` QUOTE "${text}" `, cachedValue ?? text);
-}
-/**
- * Create a TOC field for table of contents.
- *
- * @param options - TOC options.
- */
-function tocField(options) {
-    let instruction = " TOC ";
-    if (options?.headingLevels) {
-        instruction += `\\o "${options.headingLevels}" `;
-    }
-    if (options?.styles && options.styles.length > 0) {
-        instruction += `\\t "${options.styles.join(";")}" `;
-    }
-    if (options?.tcLevels) {
-        instruction += `\\f ${options.tcLevels} `;
-    }
-    if (options?.hyperlink) {
-        instruction += "\\h ";
-    }
-    if (options?.rightAlignedPageNumbers) {
-        instruction += "\\z ";
-    }
-    if (options?.tabLeader) {
-        instruction += `\\p "${options.tabLeader}" `;
-    }
-    if (options?.noPageNumbers) {
-        instruction += "\\n ";
-    }
-    if (options?.captionIdentifier) {
-        instruction += `\\c "${options.captionIdentifier}" `;
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create a TC (table of contents entry) field. */
-function tcField(text, options) {
-    let instruction = ` TC "${text}" `;
-    if (options?.level !== undefined) {
-        instruction += `\\l ${options.level} `;
-    }
-    if (options?.suppressPageNumber) {
-        instruction += "\\n ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create an XE (index entry) field. */
-function indexEntryField(text, options) {
-    let instruction = ` XE "${text}" `;
-    if (options?.bold) {
-        instruction += "\\b ";
-    }
-    if (options?.italic) {
-        instruction += "\\i ";
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create an INDEX field (renders index from XE entries). */
-function indexField(options) {
-    let instruction = " INDEX ";
-    if (options?.bookmark) {
-        instruction += `\\b ${options.bookmark} `;
-    }
-    if (options?.columns) {
-        instruction += `\\c ${options.columns} `;
-    }
-    if (options?.entryType) {
-        instruction += `\\f "${options.entryType}" `;
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create an IF field (conditional content). */
-function ifField(condition, trueText, falseText, cachedValue) {
-    return field(` IF ${condition} "${trueText}" "${falseText}" `, cachedValue);
-}
-/** Create an INCLUDETEXT field (includes external file content). */
-function includeTextField(filePath, options) {
-    let instruction = ` INCLUDETEXT "${filePath}" `;
-    if (options?.bookmark) {
-        instruction += `${options.bookmark} `;
-    }
-    return field(instruction, options?.cachedValue);
-}
-/** Create an INCLUDEPICTURE field. */
-function includePictureField(filePath, cachedValue) {
-    return field(` INCLUDEPICTURE "${filePath}" `, cachedValue);
-}
-/** Create a FORMTEXT field (legacy text form field). */
-function formTextField(cachedValue) {
-    return field(" FORMTEXT ", cachedValue);
-}
-/** Create a FORMCHECKBOX field (legacy checkbox form field). */
-function formCheckboxField(cachedValue) {
-    return field(" FORMCHECKBOX ", cachedValue);
-}
-/** Create a FORMDROPDOWN field (legacy dropdown form field). */
-function formDropdownField(cachedValue) {
-    return field(" FORMDROPDOWN ", cachedValue);
-}
-/** Create a paragraph. */
-function paragraph(children, properties) {
-    return { type: "paragraph", properties, children };
-}
-/** Create a simple text paragraph. */
-function textParagraph(content, properties) {
-    const { run: runProps, ...pProps } = properties ?? {};
-    return paragraph([text(content, runProps)], Object.keys(pProps).length > 0 ? pProps : undefined);
-}
-/** Create a heading paragraph. */
-function heading(content, level) {
-    return paragraph([text(content)], { style: `Heading${level}` });
-}
-/** Create a hyperlink. */
-function hyperlink(linkText, options) {
-    return {
-        type: "hyperlink",
-        rId: options.rId,
-        url: options.url,
-        anchor: options.anchor,
-        tooltip: options.tooltip,
-        children: [text(linkText, options.properties ?? { color: "0563C1", underline: "single" })]
-    };
-}
-/** Create a bookmark start. */
-function bookmarkStart(id, name) {
-    return { type: "bookmarkStart", id, name };
-}
-/** Create a bookmark end. */
-function bookmarkEnd(id) {
-    return { type: "bookmarkEnd", id };
-}
-/** Create a comment range start marker. */
-function commentRangeStart(id) {
-    return { type: "commentRangeStart", id };
-}
-/** Create a comment range end marker. */
-function commentRangeEnd(id) {
-    return { type: "commentRangeEnd", id };
-}
-/** Create a comment reference (inside paragraph children). */
-function commentReference(id) {
-    return { type: "commentReference", id };
-}
-/** Create an inserted run (track changes). */
-function insertedRun(run, revision) {
-    return { type: "insertedRun", revision, run };
-}
-/** Create a deleted run (track changes). */
-function deletedRun(run, revision) {
-    return { type: "deletedRun", revision, run };
-}
-/** Create a moved-from run (track changes — source of a move). */
-function movedFromRun(run, revision) {
-    return { type: "movedFromRun", revision, run };
-}
-/** Create a moved-to run (track changes — destination of a move). */
-function movedToRun(run, revision) {
-    return { type: "movedToRun", revision, run };
-}
-/** Create a move range start marker. */
-function moveFromRangeStart(id, author, options) {
-    return { type: "moveFromRangeStart", id, author, date: options?.date, name: options?.name };
-}
-/** Create a move range end marker. */
-function moveFromRangeEnd(id) {
-    return { type: "moveFromRangeEnd", id };
-}
-/** Create a move-to range start marker. */
-function moveToRangeStart(id, author, options) {
-    return { type: "moveToRangeStart", id, author, date: options?.date, name: options?.name };
-}
-/** Create a move-to range end marker. */
-function moveToRangeEnd(id) {
-    return { type: "moveToRangeEnd", id };
-}
-/** Create a checkbox. */
-function checkBox(options) {
-    return {
-        type: "checkBox",
-        checked: options?.checked,
-        checkedState: options?.checkedState,
-        uncheckedState: options?.uncheckedState
-    };
-}
-// =============================================================================
-// Math Builders
-// =============================================================================
-/** Create a math block. */
-function mathBlock(content) {
-    return { type: "math", content };
-}
-/** Create a math text run. */
-function mathRun(mathText, properties) {
-    return { type: "mathRun", text: mathText, properties };
-}
-/** Create a math fraction. */
-function mathFraction(numerator, denominator, fractionType) {
-    return { type: "mathFraction", fractionType, numerator, denominator };
-}
-/** Create a math square root. */
-function mathSqrt(content) {
-    return { type: "mathRadical", content, hideDegree: true };
-}
-/** Create a math nth root. */
-function mathRoot(degree, content) {
-    return { type: "mathRadical", degree, content };
-}
-/** Create a math summation. */
-function mathSum(content, sub, sup) {
-    return { type: "mathNary", char: "\u2211", sub, sup, content };
-}
-/** Create a math integral. */
-function mathIntegral(content, sub, sup) {
-    return { type: "mathNary", char: "\u222B", sub, sup, content };
-}
-/** Create a math product. */
-function mathProduct(content, sub, sup) {
-    return { type: "mathNary", char: "\u220F", sub, sup, content };
-}
-/** Create a math superscript. */
-function mathSuperScript(base, superScript) {
-    return { type: "mathSuperScript", base, superScript };
-}
-/** Create a math subscript. */
-function mathSubScript(base, subScript) {
-    return { type: "mathSubScript", base, subScript };
-}
-/** Create a math sub-superscript. */
-function mathSubSuperScript(base, subScript, superScript) {
-    return { type: "mathSubSuperScript", base, subScript, superScript };
-}
-/** Create a math pre-sub-superscript (subscript/superscript before the base). */
-function mathPreSubSuperScript(base, preSubScript, preSuperScript) {
-    return { type: "mathPreSubSuperScript", base, preSubScript, preSuperScript };
-}
-/** Create a math phantom (invisible expression that takes up space). */
-function mathPhantom(content, options) {
-    return { type: "mathPhantom", content, ...options };
-}
-/** Create a math group character (e.g. a horizontal brace over an expression). */
-function mathGroupChar(base, options) {
-    return { type: "mathGroupChar", base, ...options };
-}
-/** Create a math border box (draw borders around / strike through an expression). */
-function mathBorderBox(content, options) {
-    return { type: "mathBorderBox", content, ...options };
-}
-/** Create a math delimiter (parentheses, brackets, etc.). */
-function mathDelimiter(content, options) {
-    return {
-        type: "mathDelimiter",
-        beginChar: options?.beginChar,
-        endChar: options?.endChar,
-        separatorChar: options?.separatorChar,
-        content
-    };
-}
-/** Create a math n-ary operator (sum, integral, product, etc.). */
-function mathNary(char, content, sub, sup) {
-    return { type: "mathNary", char, sub, sup, content };
-}
-/** Create a math function (sin, cos, lim, etc.). */
-function mathFunction(name, content) {
-    return { type: "mathFunction", name, content };
-}
-/** Create a math limit (upper or lower). */
-function mathLimit(base, limit, limitType = "lower") {
-    return { type: "mathLimit", base, limit, limitType };
-}
-/** Create a math matrix. */
-function mathMatrix(rows) {
-    return { type: "mathMatrix", rows };
-}
-/** Create a math accent (hat, tilde, etc.). */
-function mathAccent(content, char) {
-    return { type: "mathAccent", content, char };
-}
-/** Create a math bar (overbar/underbar). */
-function mathBar(content, position) {
-    return { type: "mathBar", content, position: position ?? "top" };
-}
-/** Create a math box. */
-function mathBox(content) {
-    return { type: "mathBox", content };
-}
-/** Create a math equation array. */
-function mathEquationArray(rows) {
-    return { type: "mathEquationArray", rows };
-}
-/** Create a symbol run. */
-function symbol(font, char, properties) {
-    return { properties, content: [{ type: "symbol", font, char }] };
-}
-/** Create a floating image (body-level). */
-function floatingImage(options) {
-    return {
-        type: "floatingImage",
-        rId: options.rId,
-        width: options.width,
-        height: options.height,
-        horizontalPosition: options.horizontalPosition ?? { relativeTo: "column", offset: 0 },
-        verticalPosition: options.verticalPosition ?? { relativeTo: "paragraph", offset: 0 },
-        wrap: options.wrap ?? { style: "square" },
-        altText: options.altText,
-        name: options.name,
-        behindDoc: options.behindDoc,
-        lockAnchor: options.lockAnchor,
-        layoutInCell: options.layoutInCell,
-        allowOverlap: options.allowOverlap,
-        simplePos: options.simplePos,
-        distT: options.distT,
-        distB: options.distB,
-        distL: options.distL,
-        distR: options.distR,
-        rotation: options.rotation,
-        flipHorizontal: options.flipHorizontal,
-        flipVertical: options.flipVertical,
-        srcRect: options.srcRect
-    };
-}
-/** Create a DrawingML shape. */
-function drawingShape(options) {
-    return {
-        type: "drawingShape",
-        shapeType: options.shapeType,
-        width: options.width,
-        height: options.height,
-        fillColor: options.fillColor,
-        noFill: options.noFill,
-        outlineColor: options.outlineColor,
-        outlineWidth: options.outlineWidth,
-        noOutline: options.noOutline,
-        textContent: options.textContent,
-        altText: options.altText,
-        name: options.name,
-        horizontalPosition: options.horizontalPosition ?? { relativeTo: "column", offset: 0 },
-        verticalPosition: options.verticalPosition ?? { relativeTo: "paragraph", offset: 0 },
-        wrap: options.wrap ?? { style: "square" },
-        behindDoc: options.behindDoc,
-        rotation: options.rotation
-    };
-}
-/** Create a chart content block. */
-function chart(options) {
-    return {
-        type: "chart",
-        chart: {
-            type: options.type,
-            series: options.series,
-            title: options.title,
-            legend: options.legend,
-            categoryAxis: options.categoryAxis,
-            valueAxis: options.valueAxis,
-            plotAreaColor: options.plotAreaColor,
-            chartAreaColor: options.chartAreaColor,
-            view3d: options.view3d,
-            style: options.style,
-            width: options.width,
-            height: options.height
-        },
-        altText: options.altText,
-        name: options.name
-    };
-}
-/** Create a structured document tag (content control). */
-function structuredDocumentTag(content, properties) {
-    return { type: "sdt", properties: properties ?? {}, content };
-}
-// =============================================================================
-// Table Builders
-// =============================================================================
-/** Shorthand border. */
-function border(style = "single", size = 4, color = "auto") {
-    return { style, size, space: 0, color };
-}
-/** Create standard grid borders for a table. */
-function gridBorders(size = 4, color = "auto") {
-    const b = border("single", size, color);
-    return { top: b, left: b, bottom: b, right: b, insideH: b, insideV: b };
-}
-/** Create a table cell. */
-function cell(content, properties) {
-    if (typeof content === "string") {
-        return { properties, content: [textParagraph(content)] };
-    }
-    return { properties, content };
-}
-/** Create a table row. */
-function row(cells, properties) {
-    return { properties, cells };
-}
-/** Create a table. */
-function table(rows, properties, columnWidths) {
-    return { type: "table", properties, columnWidths, rows };
-}
-/** Create a simple table from a 2D string array. */
-function simpleTable(data, options) {
-    const opts = { headerRow: true, borders: true, ...options };
-    const tableRows = data.map((rowData, rowIndex) => {
-        const cells = rowData.map(cellText => cell(cellText));
-        return row(cells, rowIndex === 0 && opts.headerRow ? { tableHeader: true } : undefined);
-    });
-    return table(tableRows, {
-        width: opts.width ?? { value: 5000, type: "pct" },
-        borders: opts.borders ? gridBorders() : undefined
-    }, opts.columnWidths);
-}
-/** Cast internal state to opaque handle. */
-function _toHandle(state) {
-    return state;
-}
-/** Cast opaque handle back to internal state. */
-function _toState(handle) {
-    return handle;
-}
-/**
- * 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 = 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);
- * ```
- */
-exports.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(doc, content) {
-        _toState(doc).body.push(content);
-    },
-    /** Add a paragraph with runs. */
-    addParagraphElement(doc, para) {
-        _toState(doc).body.push(para);
-    },
-    /** Add a simple text paragraph. */
-    addParagraph(doc, content, properties) {
-        _toState(doc).body.push(textParagraph(content, properties));
-    },
-    /** Add a heading. */
-    addHeading(doc, content, level = 1) {
-        _toState(doc).body.push(heading(content, level));
-    },
-    /** Add a page break. */
-    addPageBreak(doc) {
-        _toState(doc).body.push(paragraph([pageBreak()]));
-    },
-    /** Add a table from a 2D array. */
-    addTable(doc, data, options) {
-        _toState(doc).body.push(simpleTable(data, options));
-    },
-    /** Add a table element. */
-    addTableElement(doc, tbl) {
-        _toState(doc).body.push(tbl);
-    },
-    /** Add an inline image. Returns the image relationship ID and drawing ID. */
-    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: [
-                    {
-                        type: "image",
-                        rId,
-                        width,
-                        height,
-                        altText: options?.altText,
-                        name: options?.name ?? `Picture ${s.nextImageId}`,
-                        drawingId
-                    }
-                ]
-            }
-        ]));
-        s.nextImageId++;
-        return { rId, drawingId };
-    },
-    /** Add a floating image. Returns the image relationship ID. */
-    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 ${s.nextImageId}`,
-            horizontalPosition: options?.horizontalPosition,
-            verticalPosition: options?.verticalPosition,
-            wrap: options?.wrap,
-            behindDoc: options?.behindDoc,
-            lockAnchor: options?.lockAnchor,
-            layoutInCell: options?.layoutInCell,
-            allowOverlap: options?.allowOverlap,
-            distT: options?.distT,
-            distB: options?.distB,
-            distL: options?.distL,
-            distR: options?.distR,
-            rotation: options?.rotation,
-            flipHorizontal: options?.flipHorizontal,
-            flipVertical: options?.flipVertical
-        }));
-        s.nextImageId++;
-        return rId;
-    },
-    /** Add a custom font definition. */
-    addFont(doc, font) {
-        _toState(doc).fonts.push(font);
-    },
-    /** Set a text watermark on the document. */
-    setWatermark(doc, watermark) {
-        _toState(doc).watermark = watermark;
-    },
-    /** Add a footnote. Returns the footnote ID. */
-    addFootnote(doc, content) {
-        const s = _toState(doc);
-        const id = s.nextFootnoteId++;
-        const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        s.footnotes.push({ id, content: paras });
-        return id;
-    },
-    /** Add an endnote. Returns the endnote ID. */
-    addEndnote(doc, content) {
-        const s = _toState(doc);
-        const id = s.nextEndnoteId++;
-        const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        s.endnotes.push({ id, content: paras });
-        return id;
-    },
-    /** Add a comment. Returns the comment ID. */
-    addComment(doc, author, content, options) {
-        const s = _toState(doc);
-        const id = s.nextCommentId++;
-        const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        s.comments.push({
-            id,
-            author,
-            date: options?.date,
-            initials: options?.initials,
-            content: paras
-        });
-        return id;
-    },
-    /** Add a Table of Contents. */
-    addTableOfContents(doc, options) {
-        _toState(doc).body.push({
-            type: "tableOfContents",
-            headingStyleRange: options?.headingStyleRange ?? "1-3",
-            hyperlink: options?.hyperlink ?? true,
-            ...options
-        });
-    },
-    /** Add a math equation block. */
-    addMath(doc, content) {
-        _toState(doc).body.push(mathBlock(content));
-    },
-    /** Add a text box. */
-    addTextBox(doc, content, options) {
-        const paras = typeof content === "string" ? [textParagraph(content)] : content;
-        _toState(doc).body.push({
-            type: "textBox",
-            content: paras,
-            width: options?.width,
-            height: options?.height,
-            stroke: options?.stroke,
-            fill: options?.fill
-        });
-    },
-    /** Add a bullet list. */
-    addBulletList(doc, items, level = 0) {
-        const s = _toState(doc);
-        // Create abstract numbering for bullets if not exists
-        let bulletAbsId = s.abstractNumberings.find(a => a.levels[0]?.format === "bullet")?.abstractNumId;
-        if (bulletAbsId === undefined) {
-            bulletAbsId = s.nextAbstractNumId++;
-            s.abstractNumberings.push({
-                abstractNumId: bulletAbsId,
-                multiLevelType: "hybridMultilevel",
-                levels: [
-                    {
-                        level: 0,
-                        start: 1,
-                        format: "bullet",
-                        text: "\uF0B7",
-                        justification: "left",
-                        paragraphProperties: { indent: { left: 720, hanging: 360 } },
-                        runProperties: { font: { ascii: "Symbol", hAnsi: "Symbol" } }
-                    },
-                    {
-                        level: 1,
-                        start: 1,
-                        format: "bullet",
-                        text: "o",
-                        justification: "left",
-                        paragraphProperties: { indent: { left: 1440, hanging: 360 } },
-                        runProperties: { font: { ascii: "Courier New", hAnsi: "Courier New" } }
-                    },
-                    {
-                        level: 2,
-                        start: 1,
-                        format: "bullet",
-                        text: "\uF0A7",
-                        justification: "left",
-                        paragraphProperties: { indent: { left: 2160, hanging: 360 } },
-                        runProperties: { font: { ascii: "Wingdings", hAnsi: "Wingdings" } }
-                    }
-                ]
-            });
-            s.numberingInstances.push({
-                numId: s.nextNumId++,
-                abstractNumId: bulletAbsId
-            });
-        }
-        const numId = s.numberingInstances.find(n => n.abstractNumId === bulletAbsId).numId;
-        for (const item of items) {
-            s.body.push(textParagraph(item, { numbering: { numId, level } }));
-        }
-    },
-    /** Add a numbered list. */
-    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 = s.nextAbstractNumId++;
-            s.abstractNumberings.push({
-                abstractNumId: numAbsId,
-                multiLevelType: "hybridMultilevel",
-                levels: [
-                    {
-                        level: 0,
-                        start: 1,
-                        format: "decimal",
-                        text: "%1.",
-                        justification: "left",
-                        paragraphProperties: { indent: { left: 720, hanging: 360 } }
-                    },
-                    {
-                        level: 1,
-                        start: 1,
-                        format: "lowerLetter",
-                        text: "%2.",
-                        justification: "left",
-                        paragraphProperties: { indent: { left: 1440, hanging: 360 } }
-                    },
-                    {
-                        level: 2,
-                        start: 1,
-                        format: "lowerRoman",
-                        text: "%3.",
-                        justification: "right",
-                        paragraphProperties: { indent: { left: 2160, hanging: 180 } }
-                    }
-                ]
-            });
-            s.numberingInstances.push({
-                numId: s.nextNumId++,
-                abstractNumId: numAbsId
-            });
-        }
-        const numId = s.numberingInstances.find(n => n.abstractNumId === numAbsId).numId;
-        for (const item of items) {
-            s.body.push(textParagraph(item, { numbering: { numId, level } }));
-        }
-    },
-    /** Set section properties (page size, margins, etc.). */
-    setSectionProperties(doc, props) {
-        _toState(doc).sectionProperties = props;
-    },
-    /** Set document defaults. */
-    setDocDefaults(doc, defaults) {
-        _toState(doc).docDefaults = defaults;
-    },
-    /** Add a style definition. */
-    addStyle(doc, style) {
-        _toState(doc).styles.push(style);
-    },
-    /** Set default styles (Normal, Heading1-6, Hyperlink, etc.). */
-    useDefaultStyles(doc) {
-        const s = _toState(doc);
-        s.docDefaults = {
-            runProperties: {
-                font: { ascii: "Calibri", hAnsi: "Calibri", eastAsia: "SimSun", cs: "Times New Roman" },
-                size: 22,
-                sizeCs: 22,
-                language: { val: "en-US" }
-            },
-            paragraphProperties: {
-                spacing: { after: 160, line: 259, lineRule: "auto" }
-            }
-        };
-        s.styles.push({ type: "paragraph", styleId: "Normal", name: "Normal", isDefault: true, qFormat: true }, {
-            type: "paragraph",
-            styleId: "Heading1",
-            name: "heading 1",
-            basedOn: "Normal",
-            next: "Normal",
-            qFormat: true,
-            uiPriority: 9,
-            paragraphProperties: {
-                keepNext: true,
-                keepLines: true,
-                spacing: { before: 240, after: 0 }
-            },
-            runProperties: { font: "Calibri Light", color: "2F5496", size: 32 }
-        }, {
-            type: "paragraph",
-            styleId: "Heading2",
-            name: "heading 2",
-            basedOn: "Normal",
-            next: "Normal",
-            qFormat: true,
-            uiPriority: 9,
-            paragraphProperties: { keepNext: true, keepLines: true, spacing: { before: 40, after: 0 } },
-            runProperties: { font: "Calibri Light", color: "2F5496", size: 26 }
-        }, {
-            type: "paragraph",
-            styleId: "Heading3",
-            name: "heading 3",
-            basedOn: "Normal",
-            next: "Normal",
-            qFormat: true,
-            uiPriority: 9,
-            paragraphProperties: { keepNext: true, keepLines: true, spacing: { before: 40, after: 0 } },
-            runProperties: { font: "Calibri Light", color: "1F3763", size: 24 }
-        }, {
-            type: "character",
-            styleId: "Hyperlink",
-            name: "Hyperlink",
-            uiPriority: 99,
-            runProperties: { color: "0563C1", underline: "single" }
-        }, {
-            type: "table",
-            styleId: "TableGrid",
-            name: "Table Grid",
-            basedOn: "TableNormal",
-            uiPriority: 39,
-            tableProperties: { borders: gridBorders(4, "auto") }
-        });
-    },
-    /** Set a header for the given type. */
-    setHeader(doc, type, content) {
-        _toState(doc).headers.set(type, { content });
-    },
-    /** Set a footer for the given type. */
-    setFooter(doc, type, content) {
-        _toState(doc).footers.set(type, { content });
-    },
-    /** Set document settings. */
-    setSettings(doc, settings) {
-        _toState(doc).settings = settings;
-    },
-    /** Set core properties (metadata). */
-    setCoreProperties(doc, props) {
-        _toState(doc).coreProperties = props;
-    },
-    /** Set application properties. */
-    setAppProperties(doc, props) {
-        _toState(doc).appProperties = props;
-    },
-    /** Set document background. */
-    setBackground(doc, background) {
-        _toState(doc).background = background;
-    },
-    /** Add a custom document property. */
-    addCustomProperty(doc, name, value) {
-        _toState(doc).customProperties.push({ name, value });
-    },
-    /** Add a section break with properties. */
-    addSectionBreak(doc, props) {
-        const s = _toState(doc);
-        // Insert as the last paragraph's section properties
-        if (s.body.length > 0) {
-            const last = s.body[s.body.length - 1];
-            if (last.type === "paragraph") {
-                const existingProps = last.properties ?? {};
-                s.body[s.body.length - 1] = {
-                    ...last,
-                    properties: { ...existingProps, sectionProperties: props }
-                };
-                return;
-            }
-        }
-        // If no previous paragraph, add an empty one with section properties
-        s.body.push(paragraph([], { sectionProperties: props }));
-    },
-    /** Get next available bookmark ID. */
-    nextBookmarkId(doc) {
-        return _toState(doc).nextBookmarkId++;
-    },
-    /** Build the DocxDocument model from the handle. */
-    build(doc) {
-        const s = _toState(doc);
-        return {
-            body: s.body,
-            sectionProperties: s.sectionProperties ?? {
-                pageSize: { width: 12240, height: 15840 },
-                margins: { top: 1440, right: 1440, bottom: 1440, left: 1440 }
-            },
-            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
-        };
-    }
-};
-// =============================================================================
-// Theme Color Resolution (re-export from color-utils for backward compat)
-// =============================================================================
-var color_utils_1 = require("./color-utils");
-Object.defineProperty(exports, "resolveThemeColor", { enumerable: true, get: function () { return color_utils_1.resolveThemeColor; } });
-/** Extract concatenated plain text from a paragraph's runs. */
-function paragraphText(para) {
-    let text = "";
-    for (const child of para.children) {
-        if ("content" in child && Array.isArray(child.content)) {
-            for (const c of child.content) {
-                if ("type" in c && c.type === "text" && "text" in c) {
-                    text += c.text;
-                }
-            }
-        }
-    }
-    return text;
-}
-// =============================================================================
-// Document Query API (read-only helpers)
-// =============================================================================
-/**
- * Count all top-level paragraphs in the document body.
- */
-function paragraphCount(doc) {
-    let count = 0;
-    for (const block of doc.body) {
-        if (block.type === "paragraph") {
-            count++;
-        }
-    }
-    return count;
-}
-/**
- * Count words across all paragraphs in the document body.
- * Uses simple whitespace splitting; for East Asian text, each CJK character
- * is counted as one "word" to approximate meaningful unit count.
- */
-function countWords(doc) {
-    let count = 0;
-    const cjkRe = /[\u4e00-\u9fff\u3040-\u30ff\uac00-\ud7af]/g;
-    const walkParagraphs = (blocks) => {
-        for (const block of blocks) {
-            if (block.type === "paragraph") {
-                const text = paragraphText(block);
-                // Count CJK chars + latin word-like tokens
-                const cjkCount = (text.match(cjkRe) ?? []).length;
-                const latin = text.replace(cjkRe, " ").trim();
-                const latinCount = latin ? latin.split(/\s+/).length : 0;
-                count += cjkCount + latinCount;
-            }
-            else if (block.type === "table") {
-                for (const row of block.rows) {
-                    for (const cell of row.cells) {
-                        walkParagraphs(cell.content);
-                    }
-                }
-            }
-            else if (block.type === "sdt") {
-                const filtered = block.content.filter(c => "type" in c && (c.type === "paragraph" || c.type === "table"));
-                walkParagraphs(filtered);
-            }
-        }
-    };
-    walkParagraphs(doc.body);
-    return count;
-}
-/**
- * Extract the heading outline from a document.
- *
- * Matches paragraphs whose style is `Heading1` through `Heading9` (case-insensitive),
- * or whose `outlineLevel` property is set (0-8).
- */
-function getHeadings(doc) {
-    const out = [];
-    doc.body.forEach((block, i) => {
-        if (block.type !== "paragraph") {
-            return;
-        }
-        const style = block.properties?.style;
-        const styleMatch = style ? /^Heading\s*(\d)$/i.exec(style) : null;
-        let level;
-        if (styleMatch) {
-            level = parseInt(styleMatch[1], 10);
-        }
-        else if (block.properties?.outlineLevel !== undefined && block.properties.outlineLevel < 9) {
-            level = block.properties.outlineLevel + 1;
-        }
-        if (level !== undefined && level >= 1 && level <= 9) {
-            out.push({
-                level,
-                text: paragraphText(block),
-                paragraphIndex: i,
-                style
-            });
-        }
-    });
-    return out;
-}
-/**
- * Find a bookmark by name.
- *
- * @returns The bookmark start marker + its location, or `undefined` if not found.
- */
-function findBookmark(doc, name) {
-    for (let i = 0; i < doc.body.length; i++) {
-        const block = doc.body[i];
-        if (block.type !== "paragraph") {
-            continue;
-        }
-        for (let j = 0; j < block.children.length; j++) {
-            const ch = block.children[j];
-            if ("type" in ch && ch.type === "bookmarkStart" && ch.name === name) {
-                return { bookmark: ch, paragraphIndex: i, childIndex: j };
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Find a comment by its ID.
- */
-function findComment(doc, id) {
-    return doc.comments?.find(c => c.id === id);
-}
-/**
- * List all images registered in the document.
- */
-function listImages(doc) {
-    return doc.images ?? [];
-}
-/**
- * List all tables in the document body (top-level only).
- */
-function listTables(doc) {
-    return doc.body.filter((b) => b.type === "table");
-}
-/**
- * Collect all hyperlinks in the document body.
- */
-function listHyperlinks(doc) {
-    const out = [];
-    const walk = (children) => {
-        for (const ch of children) {
-            if ("type" in ch && ch.type === "hyperlink") {
-                out.push(ch);
-                walk(ch.children);
-            }
-        }
-    };
-    for (const block of doc.body) {
-        if (block.type === "paragraph") {
-            walk(block.children);
-        }
-    }
-    return out;
-}
-/**
- * Get the total number of tables (top-level) and nested tables.
- */
-function tableCount(doc) {
-    let count = 0;
-    const walk = (blocks) => {
-        for (const block of blocks) {
-            if (block.type === "table") {
-                count++;
-                for (const row of block.rows) {
-                    for (const cell of row.cells) {
-                        walk(cell.content);
-                    }
-                }
-            }
-        }
-    };
-    walk(doc.body);
-    return count;
-}
-/**
- * Extract plain text from the entire document body.
- *
- * Paragraphs are separated by `\n`. Tables render as tab-separated cell text.
- */
-function extractText(doc) {
-    const lines = [];
-    const walk = (blocks) => {
-        for (const block of blocks) {
-            if (block.type === "paragraph") {
-                lines.push(paragraphText(block));
-            }
-            else if (block.type === "table") {
-                for (const row of block.rows) {
-                    const cellTexts = [];
-                    for (const cell of row.cells) {
-                        const cellLines = [];
-                        walk(cell.content);
-                        // collect last paragraphs text
-                        cellTexts.push(cellLines.join(" "));
-                    }
-                    lines.push(cellTexts.join("\t"));
-                }
-            }
-        }
-    };
-    walk(doc.body);
-    return lines.join("\n");
-}
-/**
- * Search for text occurrences in a document's body paragraphs.
- *
- * @param doc - The document model to search.
- * @param query - String or RegExp to search for.
- * @returns Array of search results.
- */
-function searchText(doc, query) {
-    const results = [];
-    for (let i = 0; i < doc.body.length; i++) {
-        const block = doc.body[i];
-        if (block.type !== "paragraph") {
-            continue;
-        }
-        const text = paragraphText(block);
-        if (typeof query === "string") {
-            let idx = text.indexOf(query);
-            while (idx !== -1) {
-                results.push({ paragraphIndex: i, match: query, offset: idx });
-                idx = text.indexOf(query, idx + 1);
-            }
-        }
-        else {
-            const re = new RegExp(query.source, query.flags.includes("g") ? query.flags : query.flags + "g");
-            let m;
-            while ((m = re.exec(text)) !== null) {
-                results.push({ paragraphIndex: i, match: m[0], offset: m.index });
-                if (!re.global) {
-                    break;
-                }
-            }
-        }
-    }
-    return results;
-}
-/**
- * Replace text in a document's body paragraphs (mutates the document).
- *
- * Performs simple text replacement within run content. Each run's text content
- * is individually searched and replaced. For cross-run matches, the paragraph
- * text is reconstructed and split back into runs.
- *
- * @param doc - The document model to modify (mutated in place).
- * @param search - String or RegExp to find.
- * @param replacement - Replacement string (supports $1, $2 etc. for RegExp).
- * @returns Number of replacements made.
- */
-function replaceText(doc, search, replacement) {
-    let count = 0;
-    for (const block of doc.body) {
-        if (block.type !== "paragraph") {
-            continue;
-        }
-        count += replaceInParagraph(block, search, replacement);
-    }
-    return count;
-}
-// =============================================================================
-// Mail Merge
-// =============================================================================
-/** Regex to parse MERGEFIELD instruction: MERGEFIELD "FieldName" or MERGEFIELD FieldName */
-const MERGEFIELD_RE = /^\s*MERGEFIELD\s+(?:"([^"]+)"|(\S+))/i;
-/**
- * Execute a mail merge: replace all MERGEFIELD fields in the document with values from the data map.
- *
- * Fields not found in the data map are left unchanged (or optionally cleared).
- *
- * @param doc - The document to modify (mutated in place).
- * @param data - Map of field names to replacement values.
- * @param options - Optional settings.
- * @returns The number of fields replaced.
- */
-function mailMerge(doc, data, options) {
-    let count = 0;
-    const removeUnmatched = options?.removeUnmatched ?? false;
-    // Process body
-    for (const block of doc.body) {
-        if (block.type === "paragraph") {
-            count += mergeFieldsInParagraph(block, data, removeUnmatched);
-        }
-        else if (block.type === "table") {
-            count += mergeFieldsInTable(block, data, removeUnmatched);
-        }
-        else if (block.type === "sdt") {
-            for (const sdtChild of block.content) {
-                if ("type" in sdtChild && sdtChild.type === "paragraph") {
-                    count += mergeFieldsInParagraph(sdtChild, data, removeUnmatched);
-                }
-                else if ("type" in sdtChild && sdtChild.type === "table") {
-                    count += mergeFieldsInTable(sdtChild, data, removeUnmatched);
-                }
-            }
-        }
-    }
-    // Process headers and footers
-    if (doc.headers) {
-        for (const [, header] of doc.headers) {
-            count += mergeFieldsInHeaderFooter(header.content, data, removeUnmatched);
-        }
-    }
-    if (doc.footers) {
-        for (const [, footer] of doc.footers) {
-            count += mergeFieldsInHeaderFooter(footer.content, data, removeUnmatched);
-        }
-    }
-    return count;
-}
-function mergeFieldsInTable(table, data, removeUnmatched) {
-    let count = 0;
-    for (const row of table.rows) {
-        for (const cell of row.cells) {
-            for (const block of cell.content) {
-                if (block.type === "paragraph") {
-                    count += mergeFieldsInParagraph(block, data, removeUnmatched);
-                }
-                else if (block.type === "table") {
-                    count += mergeFieldsInTable(block, data, removeUnmatched);
-                }
-            }
-        }
-    }
-    return count;
-}
-function mergeFieldsInHeaderFooter(content, data, removeUnmatched) {
-    let count = 0;
-    for (const child of content.children) {
-        if (child.type === "paragraph") {
-            count += mergeFieldsInParagraph(child, data, removeUnmatched);
-        }
-        else if (child.type === "table") {
-            count += mergeFieldsInTable(child, data, removeUnmatched);
-        }
-    }
-    return count;
-}
-function mergeFieldsInParagraph(para, data, removeUnmatched) {
-    let count = 0;
-    const children = para.children;
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        if (!("content" in child) || !Array.isArray(child.content)) {
-            continue;
-        }
-        const run = child;
-        const content = run.content;
-        for (let j = 0; j < content.length; j++) {
-            const c = content[j];
-            if (c.type !== "field") {
-                continue;
-            }
-            const match = MERGEFIELD_RE.exec(c.instruction);
-            if (!match) {
-                continue;
-            }
-            const fieldName = match[1] ?? match[2];
-            if (fieldName in data) {
-                // Replace field with text
-                content[j] = { type: "text", text: data[fieldName] };
-                count++;
-            }
-            else if (removeUnmatched) {
-                // Remove unmatched field
-                content[j] = { type: "text", text: "" };
-                count++;
-            }
-        }
-    }
-    return count;
-}
-/** Replace text within a single paragraph. */
-function replaceInParagraph(para, search, replacement) {
-    // First try simple per-run replacement
-    let count = 0;
-    for (const child of para.children) {
-        if (!("content" in child) || !Array.isArray(child.content)) {
-            continue;
-        }
-        for (const c of child.content) {
-            if (!("type" in c) || c.type !== "text" || !("text" in c)) {
-                continue;
-            }
-            const before = c.text;
-            const after = typeof search === "string"
-                ? replaceAll(before, search, replacement)
-                : before.replace(search, replacement);
-            if (after !== before) {
-                c.text = after;
-                count += typeof search === "string" ? countOccurrences(before, search) : 1;
-            }
-        }
-    }
-    // If no per-run matches, try cross-run replacement
-    if (count === 0) {
-        const fullText = paragraphText(para);
-        const newText = typeof search === "string"
-            ? replaceAll(fullText, search, replacement)
-            : fullText.replace(search, replacement);
-        if (newText !== fullText) {
-            // Rebuild: put all text into first text run, clear others
-            let placed = false;
-            for (const child of para.children) {
-                if (!("content" in child) || !Array.isArray(child.content)) {
-                    continue;
-                }
-                for (const c of child.content) {
-                    if (!("type" in c) || c.type !== "text" || !("text" in c)) {
-                        continue;
-                    }
-                    if (!placed) {
-                        c.text = newText;
-                        placed = true;
-                    }
-                    else {
-                        c.text = "";
-                    }
-                }
-            }
-            count = typeof search === "string" ? countOccurrences(fullText, search) : 1;
-        }
-    }
-    return count;
-}
-function replaceAll(str, search, replacement) {
-    if (search === "") {
-        return str;
-    }
-    return str.replaceAll(search, replacement);
-}
-function countOccurrences(str, search) {
-    if (search === "") {
-        return 0;
-    }
-    return str.split(search).length - 1;
-}