@cj-tech-master/excelts 9.6.1 → 10.0.0

package/dist/cjs/modules/word/convert/odt/odt.js

@@ -426,7 +426,7 @@ function parseParagraph(el, styles, listContext) {
     if (listContext) {
         paraProps = {
             ...paraProps,
-            numbering: { numId: 1, level: listContext.level }
+            numbering: { numId: listContext.numId, level: listContext.level }
         };
     }
     const children = [];
@@ -555,8 +555,12 @@ function parseDrawFrame(el) {
     };
 }
 /** Parse a text:list element. */
-function parseList(el, styles, parentLevel) {
+function parseList(el, styles, parentLevel, registry, parentNumId) {
     const listStyleName = nsAttr(el, "text", "style-name");
+    // The outermost list determines the numId; nested lists inherit it so a
+    // single multi-level list resolves to one numbering definition. Only the
+    // top-level list (no parent numId) consults its own style name.
+    const numId = parentNumId ?? registry.numIdFor(listStyleName);
     const paragraphs = [];
     const level = parentLevel;
     const items = findNsChildren(el, "text", "list-item");
@@ -567,18 +571,19 @@ function parseList(el, styles, parentLevel) {
             }
             const local = getLocalName(child.name);
             if (local === "p" || local === "h") {
-                paragraphs.push(parseParagraph(child, styles, { listStyleName, level }));
+                registry.noteLevel(numId, level);
+                paragraphs.push(parseParagraph(child, styles, { listStyleName, level, numId }));
             }
             else if (local === "list") {
-                // Nested list
-                paragraphs.push(...parseList(child, styles, level + 1));
+                // Nested list — inherit the enclosing list's numId.
+                paragraphs.push(...parseList(child, styles, level + 1, registry, numId));
             }
         }
     }
     return paragraphs;
 }
 /** Parse a table:table element into a Table. */
-function parseTable(el, styles) {
+function parseTable(el, styles, registry) {
     const tableStyleName = nsAttr(el, "table", "style-name");
     const tableStyle = tableStyleName ? styles.get(tableStyleName) : undefined;
     // Parse column definitions for widths
@@ -629,10 +634,10 @@ function parseTable(el, styles) {
                     cellContent.push(parseParagraph(cellChild, styles));
                 }
                 else if (cellChildLocal === "table") {
-                    cellContent.push(parseTable(cellChild, styles));
+                    cellContent.push(parseTable(cellChild, styles, registry));
                 }
                 else if (cellChildLocal === "list") {
-                    cellContent.push(...parseList(cellChild, styles, 0));
+                    cellContent.push(...parseList(cellChild, styles, 0, registry));
                 }
             }
             // Ensure at least one paragraph per cell
@@ -663,7 +668,7 @@ function parseTable(el, styles) {
     };
 }
 /** Parse document body content from the office:body/office:text element. */
-function parseDocumentBody(bodyEl, styles) {
+function parseDocumentBody(bodyEl, styles, registry) {
     const content = [];
     for (const child of bodyEl.children) {
         if (child.type !== "element") {
@@ -674,14 +679,14 @@ function parseDocumentBody(bodyEl, styles) {
             content.push(parseParagraph(child, styles));
         }
         else if (local === "table") {
-            content.push(parseTable(child, styles));
+            content.push(parseTable(child, styles, registry));
         }
         else if (local === "list") {
-            content.push(...parseList(child, styles, 0));
+            content.push(...parseList(child, styles, 0, registry));
         }
         else if (local === "section") {
             // Sections in ODF are logical containers; flatten their content
-            content.push(...parseDocumentBody(child, styles));
+            content.push(...parseDocumentBody(child, styles, registry));
         }
     }
     return content;
@@ -819,59 +824,248 @@ function convertStylesToStyleDefs(styles) {
     return defs;
 }
 // =============================================================================
-// ODT list numbering definition (numId=1)
+// ODT list numbering definitions (bullet & numbered, multi-level)
 // =============================================================================
+/** Bullet glyphs per nesting level, cycling every three levels. */
+const ODT_BULLET_CHARS = ["•", "◦", "▪", "•", "◦", "▪", "•", "◦", "▪"];
+/** Default ODF `style:num-format` value emitted for each docx NumberFormat. */
+function numberFormatToOdf(format) {
+    switch (format) {
+        case "decimal":
+        case "decimalZero":
+            return "1";
+        case "lowerLetter":
+            return "a";
+        case "upperLetter":
+            return "A";
+        case "lowerRoman":
+            return "i";
+        case "upperRoman":
+            return "I";
+        default:
+            // ODF has no equivalent for many Word-specific formats; fall back to
+            // decimal so the list still renders as an ordered list (its ordered
+            // nature is preserved even when the exact glyph set is not).
+            return "1";
+    }
+}
+/** Map an ODF `style:num-format` value to the closest docx NumberFormat. */
+function odfNumFormatToDocx(numFormat) {
+    switch (numFormat) {
+        case "1":
+            return "decimal";
+        case "a":
+            return "lowerLetter";
+        case "A":
+            return "upperLetter";
+        case "i":
+            return "lowerRoman";
+        case "I":
+            return "upperRoman";
+        default:
+            return "decimal";
+    }
+}
 /**
- * Walk the converted body and, if any paragraph references `numbering.numId`,
- * synthesize the corresponding `abstractNumberings` and `numberingInstances`
- * so Word renders bullet/number markers. Without this the list paragraphs
- * carry a `numId` that resolves to nothing in the produced document and the
- * markers are invisible.
+ * Parse a single `text:list-style` element into its per-level formats.
  *
- * The reader currently only emits a single bulleted abstract definition for
- * `numId === 1` (matching parseParagraph above). Numbered/multi-level ODT
- * lists fall back to bullets for now — preserving the visible structure is
- * the primary goal.
+ * Each `text:list-level-style-bullet` becomes a bullet level; each
+ * `text:list-level-style-number` becomes a numbered level whose docx format
+ * is derived from `style:num-format`. Levels are indexed by `text:level`
+ * (1-based in ODF) and stored 0-based.
  */
-function buildOdtNumberingDefs(body) {
-    if (!hasListParagraph(body)) {
-        return {};
+function parseOdfListStyle(el) {
+    const levels = new Map();
+    for (const child of el.children) {
+        if (child.type !== "element") {
+            continue;
+        }
+        const local = getLocalName(child.name);
+        const levelAttr = parseInt(nsAttr(child, "text", "level") ?? "1", 10);
+        const level = Math.max(0, levelAttr - 1);
+        if (local === "list-level-style-bullet") {
+            levels.set(level, {
+                format: "bullet",
+                bulletChar: nsAttr(child, "text", "bullet-char") ?? ODT_BULLET_CHARS[level] ?? "•"
+            });
+        }
+        else if (local === "list-level-style-number") {
+            levels.set(level, {
+                format: odfNumFormatToDocx(nsAttr(child, "style", "num-format"))
+            });
+        }
     }
+    return levels;
+}
+/**
+ * Index every `text:list-style` found in the ODF automatic/named styles by
+ * name. Used by the reader to recover the original bullet-vs-number format of
+ * each list so the produced DOCX renders the correct markers.
+ */
+function collectOdfListStyles(roots) {
+    const out = new Map();
+    const visit = (el) => {
+        for (const child of el.children) {
+            if (child.type !== "element") {
+                continue;
+            }
+            if (getLocalName(child.name) === "list-style") {
+                const name = nsAttr(child, "style", "name");
+                if (name) {
+                    out.set(name, parseOdfListStyle(child));
+                }
+            }
+            else {
+                visit(child);
+            }
+        }
+    };
+    for (const root of roots) {
+        visit(root);
+    }
+    return out;
+}
+/**
+ * Registry that assigns a stable `numId` to each distinct ODF list-style name
+ * encountered while parsing the body, and produces the matching docx
+ * `abstractNumberings` / `numberingInstances` on demand.
+ *
+ * A registry instance is threaded through `parseList` → `parseParagraph` so
+ * list paragraphs reference the same `numId` that ultimately resolves to the
+ * synthesized numbering definition. Lists without an explicit style name (or
+ * referencing an unknown style) fall back to a default bulleted definition.
+ */
+class OdtNumberingRegistry {
+    constructor(listStyles) {
+        this.numIdByStyle = new Map();
+        // The format chosen at each level for a given numId (level 0..8).
+        this.levelsByNumId = new Map();
+        this.nextNumId = 1;
+        this.listStyles = listStyles;
+    }
+    /** Resolve (and lazily register) the numId for a given list-style name. */
+    numIdFor(styleName) {
+        const key = styleName ?? "";
+        const existing = this.numIdByStyle.get(key);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const numId = this.nextNumId++;
+        this.numIdByStyle.set(key, numId);
+        this.levelsByNumId.set(numId, this.listStyles.get(key) ?? new Map());
+        return numId;
+    }
+    /**
+     * Record the level a paragraph used for this numId so the synthesized
+     * abstract numbering covers at least the deepest level actually referenced
+     * even when the ODF list-style omitted some levels.
+     */
+    noteLevel(numId, level) {
+        let levels = this.levelsByNumId.get(numId);
+        if (!levels) {
+            levels = new Map();
+            this.levelsByNumId.set(numId, levels);
+        }
+        if (!levels.has(level)) {
+            // Unknown level: default to bullet so the marker is still visible.
+            levels.set(level, { format: "bullet", bulletChar: ODT_BULLET_CHARS[level] ?? "•" });
+        }
+    }
+    /** Whether any list paragraph was registered. */
+    get isEmpty() {
+        return this.numIdByStyle.size === 0;
+    }
+    /** Build the docx numbering definitions for every registered list. */
+    build() {
+        if (this.isEmpty) {
+            return {};
+        }
+        const abstractNumberings = [];
+        const numberingInstances = [];
+        for (const numId of this.levelsByNumId.keys()) {
+            const odfLevels = this.levelsByNumId.get(numId) ?? new Map();
+            const levels = [];
+            for (let level = 0; level < 9; level++) {
+                const info = odfLevels.get(level) ??
+                    { format: "bullet", bulletChar: ODT_BULLET_CHARS[level] ?? "•" };
+                levels.push(makeNumberingLevel(level, info));
+            }
+            // abstractNumId mirrors numId for a clean 1:1 mapping.
+            abstractNumberings.push({ abstractNumId: numId, levels });
+            numberingInstances.push({ numId, abstractNumId: numId });
+        }
+        return { abstractNumberings, numberingInstances };
+    }
+}
+/** Build a single docx NumberingLevel from a parsed ODF level. */
+function makeNumberingLevel(level, info) {
     const tabSuffix = "tab";
-    const bulletChars = ["•", "◦", "▪", "•", "◦", "▪", "•", "◦", "▪"];
-    const levels = bulletChars.map((ch, level) => ({
+    const indent = { left: 720 * (level + 1), hanging: 360 };
+    if (info.format === "bullet") {
+        return {
+            level,
+            format: "bullet",
+            text: info.bulletChar ?? ODT_BULLET_CHARS[level] ?? "•",
+            start: 1,
+            paragraphProperties: { indent },
+            suffix: tabSuffix
+        };
+    }
+    return {
         level,
-        format: "bullet",
-        text: ch,
+        format: info.format,
+        // Word level text uses %N placeholders; "%<level+1>." renders "1." etc.
+        text: `%${level + 1}.`,
         start: 1,
-        paragraphProperties: {
-            indent: { left: 720 * (level + 1), hanging: 360 }
-        },
+        paragraphProperties: { indent },
         suffix: tabSuffix
-    }));
-    return {
-        abstractNumberings: [{ abstractNumId: 1, levels }],
-        numberingInstances: [{ numId: 1, abstractNumId: 1 }]
     };
 }
-function hasListParagraph(blocks) {
+// =============================================================================
+// Writer-side list numbering helpers
+// =============================================================================
+/** Deterministic ODF `text:list-style` name for a given docx numId. */
+function listStyleNameForNumId(numId) {
+    return `L${numId}`;
+}
+/** Collect every distinct numId referenced by list paragraphs in the body. */
+function collectListNumIds(blocks, out) {
     for (const block of blocks) {
         if (block.type === "paragraph") {
-            if (block.properties?.numbering) {
-                return true;
+            const numId = block.properties?.numbering?.numId;
+            if (typeof numId === "number") {
+                out.add(numId);
             }
         }
         else if (block.type === "table") {
             for (const row of block.rows) {
                 for (const cell of row.cells) {
-                    if (hasListParagraph(cell.content)) {
-                        return true;
-                    }
+                    collectListNumIds(cell.content, out);
                 }
             }
         }
     }
-    return false;
+}
+/**
+ * Resolve the per-level NumberFormat for a numId from the document's numbering
+ * definitions. Follows numId → numberingInstance → abstractNumbering → levels.
+ * Levels missing a definition default to bullet so a marker is still emitted.
+ */
+function resolveNumIdLevelFormats(doc, numId) {
+    const formats = new Array(9).fill("bullet");
+    const inst = doc.numberingInstances?.find(n => n.numId === numId);
+    const abstractId = inst?.abstractNumId;
+    const abstract = abstractId !== undefined
+        ? doc.abstractNumberings?.find(a => a.abstractNumId === abstractId)
+        : undefined;
+    if (abstract) {
+        for (const lvl of abstract.levels) {
+            if (lvl.level >= 0 && lvl.level < 9) {
+                formats[lvl.level] = lvl.format;
+            }
+        }
+    }
+    return formats;
 }
 // =============================================================================
 // readOdt — Main Entry Point
@@ -920,10 +1114,12 @@ async function readOdt(buffer) {
     // Collect all styles (from both content.xml and styles.xml)
     const allStyles = new Map();
     let pageLayoutProps;
+    let stylesRootEl;
     // Parse styles from styles.xml
     if (stylesXml) {
         const stylesDoc = (0, dom_1.parseXml)(stylesXml);
         const stylesRoot = stylesDoc.root;
+        stylesRootEl = stylesRoot;
         // Named styles (office:styles)
         const officeStylesEl = findNsChild(stylesRoot, "office", "styles");
         if (officeStylesEl) {
@@ -1003,7 +1199,16 @@ async function readOdt(buffer) {
     if (!textEl) {
         throw new errors_1.DocxParseError("Invalid ODT: missing office:text element");
     }
-    const body = parseDocumentBody(textEl, allStyles);
+    // Index every `text:list-style` (from styles.xml and content.xml) so the
+    // body parser can recover each list's bullet-vs-number format. The registry
+    // assigns a stable numId per distinct list style and produces the matching
+    // numbering definitions below.
+    const listStyleRoots = [contentDoc.root];
+    if (stylesRootEl) {
+        listStyleRoots.push(stylesRootEl);
+    }
+    const registry = new OdtNumberingRegistry(collectOdfListStyles(listStyleRoots));
+    const body = parseDocumentBody(textEl, allStyles, registry);
     // Convert styles to StyleDef[]
     const styleDefs = convertStylesToStyleDefs(allStyles);
     // Parse section properties from page layout
@@ -1059,7 +1264,7 @@ async function readOdt(buffer) {
         ...(styleDefs.length > 0 ? { styles: styleDefs } : {}),
         ...(coreProperties ? { coreProperties } : {}),
         ...(images.length > 0 ? { images } : {}),
-        ...buildOdtNumberingDefs(body)
+        ...registry.build()
     };
     return doc;
 }
@@ -1288,9 +1493,7 @@ function generateContentXml(doc, imagePaths, imageMap) {
     const bodyWriter = new writer_1.XmlWriter();
     bodyWriter.openNode("office:body");
     bodyWriter.openNode("office:text");
-    for (const block of doc.body) {
-        writeBodyContent(bodyWriter, block, doc, imagePaths, ctx);
-    }
+    writeBlocks(bodyWriter, doc.body, doc, imagePaths, ctx);
     bodyWriter.closeNode(); // office:text
     bodyWriter.closeNode(); // office:body
     const bodyXml = bodyWriter.xml;
@@ -1337,6 +1540,54 @@ function writeAutoStyles(w, doc) {
             writeStyleDef(w, styleDef);
         }
     }
+    // Emit one `text:list-style` per distinct numId referenced by the body so
+    // bullet vs numbered (and multi-level mixes) round-trip with the correct
+    // markers. Numbers are sorted for deterministic output.
+    const numIds = new Set();
+    collectListNumIds(doc.body, numIds);
+    for (const numId of [...numIds].sort((a, b) => a - b)) {
+        writeListStyleDef(w, numId, resolveNumIdLevelFormats(doc, numId));
+    }
+}
+/**
+ * Write the automatic `text:list-style` for a numId.
+ *
+ * Each of the nine ODF list levels is emitted as either a
+ * `text:list-level-style-bullet` or `text:list-level-style-number` based on
+ * the document's per-level NumberFormat, giving compliant readers (Word,
+ * LibreOffice) the right markers and letting the reader recover the format on
+ * the way back in.
+ */
+function writeListStyleDef(w, numId, formats) {
+    w.openNode("text:list-style", { "style:name": listStyleNameForNumId(numId) });
+    for (let idx = 0; idx < 9; idx++) {
+        const level = idx + 1; // ODF list levels are 1-based.
+        const format = formats[idx] ?? "bullet";
+        if (format === "bullet") {
+            w.openNode("text:list-level-style-bullet", {
+                "text:level": String(level),
+                "text:bullet-char": ODT_BULLET_CHARS[idx] ?? "•"
+            });
+        }
+        else {
+            w.openNode("text:list-level-style-number", {
+                "text:level": String(level),
+                "style:num-format": numberFormatToOdf(format),
+                "style:num-suffix": "."
+            });
+        }
+        w.openNode("style:list-level-properties", {
+            "text:list-level-position-and-space-mode": "label-alignment"
+        });
+        w.leafNode("style:list-level-label-alignment", {
+            "text:label-followed-by": "listtab",
+            "fo:text-indent": "-0.25in",
+            "fo:margin-left": `${0.25 * level}in`
+        });
+        w.closeNode(); // style:list-level-properties
+        w.closeNode(); // text:list-level-style-{bullet,number}
+    }
+    w.closeNode(); // text:list-style
 }
 /** Write a single StyleDef as an ODF style. */
 function writeStyleDef(w, def) {
@@ -1476,6 +1727,113 @@ function alignmentToOdf(alignment) {
             return "start";
     }
 }
+/**
+ * Determine whether a body block is a list paragraph (carries numbering).
+ *
+ * The ODT reader maps list-item paragraphs back to `numbering.numId`, so the
+ * writer must round-trip them as `text:list` structures rather than bare
+ * `text:p` (which would silently drop the list semantics).
+ */
+function isListParagraph(block) {
+    return block.type === "paragraph" && block.properties?.numbering !== undefined;
+}
+/** numId of a list paragraph (falls back to 1 if somehow absent). */
+function paragraphNumId(block) {
+    return block.type === "paragraph" ? (block.properties?.numbering?.numId ?? 1) : 1;
+}
+/**
+ * Write a sequence of block-level content elements, grouping runs of
+ * consecutive list paragraphs that share a numId into nested `text:list`
+ * structures.
+ *
+ * The ODF list model nests one `text:list` per indentation level, so a
+ * paragraph at `numbering.level === N` is wrapped in `N + 1` nested lists.
+ * Tracking an explicit level stack lets a single run contain mixed levels
+ * (e.g. a sub-bullet between two top-level bullets) and still produce valid,
+ * round-trippable markup that matches what `parseList` expects. Breaking on
+ * numId changes keeps each `text:list` pointed at a single list-style.
+ */
+function writeBlocks(w, blocks, doc, imagePaths, ctx) {
+    let i = 0;
+    while (i < blocks.length) {
+        const block = blocks[i];
+        if (isListParagraph(block)) {
+            // Consume the maximal run of consecutive list paragraphs sharing numId.
+            const numId = paragraphNumId(block);
+            let j = i;
+            while (j < blocks.length &&
+                isListParagraph(blocks[j]) &&
+                paragraphNumId(blocks[j]) === numId) {
+                j++;
+            }
+            writeListGroup(w, blocks.slice(i, j), numId, doc, imagePaths, ctx);
+            i = j;
+        }
+        else {
+            writeBodyContent(w, block, doc, imagePaths, ctx);
+            i++;
+        }
+    }
+}
+/**
+ * Emit a run of list paragraphs (all sharing `numId`) as nested `text:list`
+ * elements.
+ *
+ * ODF nests one `text:list` per indentation level, and every nested list lives
+ * inside a `text:list-item` of its parent. We therefore track, for each open
+ * list level, whether a `text:list-item` is currently open at that level
+ * (`itemOpen[d]`). Raising the level opens wrapper items plus nested lists;
+ * lowering it closes them in the correct order so the markup stays balanced
+ * and matches what `parseList` expects on the way back in.
+ */
+function writeListGroup(w, paras, numId, doc, imagePaths, ctx) {
+    const styleName = listStyleNameForNumId(numId);
+    // `itemOpen[d]` is true when a `text:list-item` is open inside the list at
+    // depth `d` (0-based). Its length equals the number of open `text:list`s.
+    const itemOpen = [];
+    const openList = () => {
+        w.openNode("text:list", { "text:style-name": styleName });
+        itemOpen.push(false);
+    };
+    const closeList = () => {
+        const depth = itemOpen.length - 1;
+        if (itemOpen[depth]) {
+            w.closeNode(); // text:list-item
+        }
+        itemOpen.pop();
+        w.closeNode(); // text:list
+    };
+    for (const para of paras) {
+        const level = Math.max(0, para.properties?.numbering?.level ?? 0);
+        const wantLists = level + 1;
+        // Close lists until we are at or below the desired depth.
+        while (itemOpen.length > wantLists) {
+            closeList();
+        }
+        // Open nested lists until we reach the desired depth. Each nested list
+        // must sit inside an open `text:list-item` of its parent list.
+        while (itemOpen.length < wantLists) {
+            const depth = itemOpen.length - 1;
+            if (depth >= 0 && !itemOpen[depth]) {
+                w.openNode("text:list-item");
+                itemOpen[depth] = true;
+            }
+            openList();
+        }
+        // At the target depth start a fresh list-item for this paragraph.
+        const depth = itemOpen.length - 1;
+        if (itemOpen[depth]) {
+            w.closeNode(); // previous text:list-item at this depth
+        }
+        w.openNode("text:list-item");
+        itemOpen[depth] = true;
+        writeParagraph(w, para, doc, imagePaths, ctx);
+    }
+    // Unwind any lists still open.
+    while (itemOpen.length > 0) {
+        closeList();
+    }
+}
 /** Write a block-level content element to the XML writer. */
 function writeBodyContent(w, block, doc, imagePaths, ctx) {
     switch (block.type) {
@@ -1742,14 +2100,7 @@ function writeTableCell(w, cell, doc, imagePaths, ctx) {
         return;
     }
     w.openNode("table:table-cell", attrs);
-    for (const content of cell.content) {
-        if (content.type === "paragraph") {
-            writeParagraph(w, content, doc, imagePaths, ctx);
-        }
-        else if (content.type === "table") {
-            writeTable(w, content, doc, imagePaths, ctx);
-        }
-    }
+    writeBlocks(w, cell.content, doc, imagePaths, ctx);
     w.closeNode();
 }
 // =============================================================================

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

@@ -12,7 +12,8 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.htmlToDocxBody = exports.renderToHtml = void 0;
+exports.htmlToDocx = exports.htmlToDocxBody = exports.renderToHtml = void 0;
 var html_1 = require("./convert/html/html");
 Object.defineProperty(exports, "renderToHtml", { enumerable: true, get: function () { return html_1.renderToHtml; } });
 Object.defineProperty(exports, "htmlToDocxBody", { enumerable: true, get: function () { return html_1.htmlToDocxBody; } });
+Object.defineProperty(exports, "htmlToDocx", { enumerable: true, get: function () { return html_1.htmlToDocx; } });

package/dist/cjs/modules/word/index.base.js

@@ -24,9 +24,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.totalPagesField = exports.pageNumberField = exports.field = exports.softHyphen = exports.noBreakHyphen = exports.carriageReturn = exports.ruby = exports.positionalTab = exports.tab = exports.columnBreak = exports.lineBreak = exports.pageBreak = exports.strikethrough = exports.underline = exports.italic = exports.bold = exports.text = exports.Document = exports.tablePctToPercent = exports.percentToTablePct = exports.spacingToLineMultiplier = exports.lineMultiplierToSpacing = exports.eighthPointToPt = exports.ptToEighthPoint = exports.halfPointToPt = exports.ptToHalfPoint = exports.emuToPx = exports.pxToEmu = exports.ptToEmu = exports.emuToCm = exports.cmToEmu = exports.emuToInches = exports.inchesToEmu = exports.mmToTwips = exports.twipsToPt = exports.ptToTwips = exports.twipsToCm = exports.cmToTwips = exports.twipsToInches = exports.inchesToTwips = exports.isDocxError = exports.DocxLimitExceededError = exports.DocxDecryptionError = exports.DocxEncryptedError = exports.DocxUnsupportedFeatureError = exports.DocxInvalidStructureError = exports.DocxMissingPartError = exports.DocxWriteError = exports.DocxParseError = exports.DocxError = void 0;
 exports.mathBar = exports.mathAccent = exports.mathMatrix = exports.mathLimit = exports.mathFunction = exports.mathNary = exports.mathDelimiter = exports.mathBorderBox = exports.mathGroupChar = exports.mathPhantom = exports.mathPreSubSuperScript = exports.mathSubSuperScript = exports.mathSubScript = exports.mathSuperScript = exports.mathProduct = exports.mathIntegral = exports.mathSum = exports.mathRoot = exports.mathSqrt = exports.mathFraction = exports.mathRun = exports.mathBlock = exports.checkBox = exports.formDropdownField = exports.formCheckboxField = exports.formTextField = exports.includePictureField = exports.includeTextField = exports.ifField = exports.indexField = exports.indexEntryField = exports.tcField = exports.tocField = exports.quoteField = exports.hyperlinkField = exports.noteRefField = exports.pageRefField = exports.refField = exports.styleRefField = exports.fileSizeField = exports.fileNameField = exports.keywordsField = exports.subjectField = exports.titleField = exports.authorField = exports.timeField = exports.sequenceField = exports.dateField = exports.sectionField = exports.sectionPagesField = void 0;
 exports.listRevisions = exports.rejectAllRevisions = exports.acceptAllRevisions = exports.splitDocument = exports.mergeDocuments = exports.mailMerge = exports.replaceText = exports.searchText = exports.extractText = exports.tableCount = exports.listSections = exports.listHyperlinks = exports.listTables = exports.listImages = exports.findComment = exports.findBookmark = exports.getHeadings = exports.countWords = exports.paragraphCount = exports.resolveThemeColor = exports.simpleTable = exports.table = exports.row = exports.cell = exports.gridBorders = exports.border = exports.moveToRangeEnd = exports.moveToRangeStart = exports.moveFromRangeEnd = exports.moveFromRangeStart = exports.movedToRun = exports.movedFromRun = exports.deletedRun = exports.insertedRun = exports.commentReference = exports.commentRangeEnd = exports.commentRangeStart = exports.bookmarkEnd = exports.bookmarkStart = exports.hyperlink = exports.heading = exports.textParagraph = exports.paragraph = exports.structuredDocumentTag = exports.chart = exports.drawingShape = exports.floatingImage = exports.symbol = exports.mathEquationArray = exports.mathBox = void 0;
-exports.protectDocument = exports.getQuickParts = exports.getAutoTextEntries = exports.listBuildingBlocks = exports.findBuildingBlock = exports.createGlossaryDocument = exports.createBuildingBlock = exports.createOleEmbedding = exports.getOleObjectData = exports.hasOleObjects = exports.extractOleObjects = exports.subsetFont = exports.addEmbeddedFonts = exports.embedFontFamily = exports.embedFont = exports.validateDocument = exports.createDocxStream = exports.StreamingDocxWriter = exports.toFlatOpc = exports.isFlatOpc = exports.parseFlatOpc = exports.TemplateError = exports.isTemplateChart = exports.listTemplateTags = exports.fillTemplateEnhanced = exports.fillTemplate = exports.diffDocuments = exports.toFlatOpcFromDoc = exports.fillTemplateFromBuffer = exports.patchTemplate = exports.compileTemplate = exports.patchDocument = exports.toBase64 = exports.toBuffer = exports.readDocx = exports.packageDocx = exports.readDocxPart = exports.listDocxParts = exports.editDocxIncremental = exports.fillFormFields = exports.extractFormFields = exports.resolveDataBindings = exports.setCompatibilityMode = exports.getCompatibilityMode = exports.resolveTableStyle = exports.resolveNumberingLevel = exports.resolveRunStyle = exports.resolveStyle = exports.rejectRevision = exports.acceptRevision = void 0;
-exports.fillTemplateFromSource = exports.CompositeDataSource = exports.CsvDataSource = exports.XmlDataSource = exports.JsonDataSource = exports.renderPageFromLayout = exports.renderDocumentToSvg = exports.renderPageToSvg = exports.writeOdt = exports.readOdt = exports.getUsedFormats = exports.countByFormat = exports.searchByFormat = exports.ENGLISH_US_PATTERNS = exports.hyphenateText = exports.hyphenateWord = exports.createHyphenator = exports.detectDirection = exports.detectScript = exports.shapeText = exports.createStar = exports.createCallout = exports.createFlowchartShape = exports.createArrow = exports.createLine = exports.createEllipse = exports.createRoundRect = exports.createRect = exports.createShape = exports.mathMLToOmml = exports.ommlToMathML = exports.updateTableOfContents = exports.updateFields = exports.layoutDocumentFull = exports.layoutDocument = exports.listVbaParts = exports.removeVbaProject = exports.addVbaProject = exports.getVbaProjectData = exports.getVbaProjectInfo = exports.hasVbaProject = exports.DEFAULT_STYLE_MAP = exports.matchStyleMap = exports.mergeStyleMaps = exports.createStyleMap = exports.parseStyleMap = exports.verifyProtectionPassword = exports.getProtectionState = exports.isDocumentProtected = exports.unprotectDocument = void 0;
-exports.docxToSemantic = exports.createConversionContext = exports.collectTables = exports.collectRuns = exports.collectParagraphs = exports.walkBlocks = exports.walkDocument = exports.mapDocument = exports.createIdGenerators = exports.createRenderContext = exports.resolveSecurityPolicy = exports.STRICT_SECURITY_POLICY = exports.DEFAULT_SECURITY_POLICY = exports.encryptDocx = exports.bindChartData = void 0;
+exports.getQuickParts = exports.getAutoTextEntries = exports.listBuildingBlocks = exports.findBuildingBlock = exports.createGlossaryDocument = exports.createBuildingBlock = exports.addOleObject = exports.createOleEmbedding = exports.getOleObjectData = exports.hasOleObjects = exports.extractOleObjects = exports.subsetFont = exports.addEmbeddedFonts = exports.embedFontFamily = exports.embedFont = exports.validateDocument = exports.createDocxStream = exports.StreamingDocxWriter = exports.toFlatOpc = exports.isFlatOpc = exports.parseFlatOpc = exports.TemplateError = exports.isTemplateChart = exports.listTemplateTags = exports.fillTemplateEnhanced = exports.fillTemplate = exports.diffDocuments = exports.toFlatOpcFromDoc = exports.fillTemplateFromBuffer = exports.patchTemplate = exports.compileTemplate = exports.patchDocument = exports.toBase64 = exports.toBuffer = exports.readDocx = exports.packageDocx = exports.readDocxPart = exports.listDocxParts = exports.editDocxIncremental = exports.fillFormFields = exports.extractFormFields = exports.resolveDataBindings = exports.setCompatibilityMode = exports.getCompatibilityMode = exports.resolveTableStyle = exports.resolveNumberingLevel = exports.resolveRunStyle = exports.resolveStyle = exports.rejectRevision = exports.acceptRevision = void 0;
+exports.CompositeDataSource = exports.CsvDataSource = exports.XmlDataSource = exports.JsonDataSource = exports.renderPageFromLayout = exports.renderDocumentToSvg = exports.renderPageToSvg = exports.writeOdt = exports.readOdt = exports.getUsedFormats = exports.countByFormat = exports.searchByFormat = exports.ENGLISH_US_PATTERNS = exports.hyphenateText = exports.hyphenateWord = exports.createHyphenator = exports.detectDirection = exports.detectScript = exports.shapeText = exports.createStar = exports.createCallout = exports.createFlowchartShape = exports.createArrow = exports.createLine = exports.createEllipse = exports.createRoundRect = exports.createRect = exports.createShape = exports.mathMLToOmml = exports.ommlToMathML = exports.updateTableOfContents = exports.updateFields = exports.layoutDocumentFull = exports.layoutDocument = exports.listVbaParts = exports.removeVbaProject = exports.addVbaProject = exports.getVbaProjectData = exports.getVbaProjectInfo = exports.hasVbaProject = exports.DEFAULT_STYLE_MAP = exports.matchStyleMap = exports.mergeStyleMaps = exports.createStyleMap = exports.parseStyleMap = exports.verifyProtectionPassword = exports.getProtectionState = exports.isDocumentProtected = exports.unprotectDocument = exports.protectDocument = void 0;
+exports.docxToSemantic = exports.createConversionContext = exports.collectTables = exports.collectRuns = exports.collectParagraphs = exports.walkBlocks = exports.walkDocument = exports.mapDocument = exports.createIdGenerators = exports.createRenderContext = exports.resolveSecurityPolicy = exports.STRICT_SECURITY_POLICY = exports.DEFAULT_SECURITY_POLICY = exports.encryptDocx = exports.bindChartData = exports.fillTemplateFromSource = void 0;
 // --- Stable API ---
 /** @stability stable */
 var errors_1 = require("./errors");
@@ -292,6 +292,7 @@ Object.defineProperty(exports, "extractOleObjects", { enumerable: true, get: fun
 Object.defineProperty(exports, "hasOleObjects", { enumerable: true, get: function () { return ole_objects_1.hasOleObjects; } });
 Object.defineProperty(exports, "getOleObjectData", { enumerable: true, get: function () { return ole_objects_1.getOleObjectData; } });
 Object.defineProperty(exports, "createOleEmbedding", { enumerable: true, get: function () { return ole_objects_1.createOleEmbedding; } });
+Object.defineProperty(exports, "addOleObject", { enumerable: true, get: function () { return ole_objects_1.addOleObject; } });
 /** @stability experimental */
 var glossary_1 = require("./advanced/glossary");
 Object.defineProperty(exports, "createBuildingBlock", { enumerable: true, get: function () { return glossary_1.createBuildingBlock; } });