@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/esm/modules/word/incremental-edit.js

@@ -0,0 +1,361 @@
+/**
+ * DOCX Incremental Edit API
+ *
+ * Supports efficient "open → modify → save" workflows by editing a DOCX
+ * file at the ZIP entry level.
+ *
+ * Use cases:
+ * - Replace just the document.xml in an existing template
+ * - Update headers/footers without touching styles or images
+ * - Patch specific parts (e.g. core properties metadata)
+ *
+ * **Limitations and caveats — read before using `replacePart`/`deletePart`:**
+ *
+ * This API is a thin wrapper around ZIP entry mutation. It deliberately
+ * does not understand DOCX semantics:
+ *
+ * - `[Content_Types].xml` is **not** updated when you add a new part with
+ *   a previously-unseen content type. If your replacement part introduces
+ *   a new MIME type, callers must also patch `[Content_Types].xml` (or
+ *   round-trip through `readDocx` + `packageDocx` instead).
+ * - Relationship files (`*.rels`) are **not** rebuilt. Adding or deleting
+ *   a part with relationships will leave the corresponding `_rels/*.rels`
+ *   stale.
+ * - `replaceBody`, `replaceHeader`, `replaceFooter` only rewrite their
+ *   target XML part; they do **not** modify the corresponding `.rels` file
+ *   or copy in new media binaries. As a result they reject content that
+ *   would introduce new relationship IDs (images, hyperlinks, charts,
+ *   altChunks, opaque drawings carrying rIds) — use `patchDocument` /
+ *   `packageDocx` for those cases. Existing references that survive
+ *   unchanged are fine because their `.rels` entries already exist.
+ *
+ * For DOCX-aware edits (changes that may add/remove relationships or
+ * content types) use `patchDocument` or `compileTemplate`, or round-trip
+ * through `readDocx` + `packageDocx`.
+ *
+ * Note: This API operates on raw ZIP entries; it does not parse the DOCX
+ * model. For higher-level edits use `patchDocument` or `compileTemplate`.
+ */
+import { zip } from "../archive/create-archive.js";
+import { unzip } from "../archive/read-archive.js";
+import { XmlWriter } from "../xml/writer.js";
+import { PartPath } from "./constants.js";
+import { utf8Decoder, utf8Encoder } from "./core/internal-utils.js";
+import { walkBlocks } from "./core/walker.js";
+import { DocxUnsupportedFeatureError } from "./errors.js";
+import { renderBodyContent, renderDocument } from "./writer/document-writer.js";
+import { renderHeader, renderFooter } from "./writer/header-footer-writer.js";
+import { createRenderContext } from "./writer/render-context.js";
+/**
+ * Apply incremental edits to an existing DOCX file.
+ *
+ * Reads all parts from the original ZIP, applies the edits, and writes a
+ * new ZIP. Unchanged parts are passed through (decompressed and recompressed,
+ * but their content is not parsed).
+ *
+ * @param buffer - The original DOCX file as a Uint8Array.
+ * @param edits - Array of incremental edits to apply.
+ * @param options - Optional settings.
+ * @returns A new DOCX file as a Uint8Array.
+ *
+ * @example
+ * ```ts
+ * const original = await fs.readFile("template.docx");
+ * const edited = await editDocxIncremental(original, [
+ *   { type: "replaceBody", body: [...newParagraphs] }
+ * ]);
+ * ```
+ */
+export async function editDocxIncremental(buffer, edits, options) {
+    // Read all entries from the original ZIP. Some third-party ZIP writers emit
+    // entry paths with a leading "/" — strip it so lookups by canonical path
+    // (e.g. "word/document.xml") match consistently with the rest of the
+    // codebase (see readDocxPart below).
+    const reader = unzip(buffer);
+    const parts = new Map();
+    for await (const entry of reader.entries()) {
+        const normalizedPath = entry.path.replace(/^\/+/, "");
+        parts.set(normalizedPath, await entry.bytes());
+    }
+    // Apply edits
+    for (const edit of edits) {
+        switch (edit.type) {
+            case "replacePart":
+                parts.set(edit.path.replace(/^\/+/, ""), edit.data);
+                break;
+            case "replacePartText":
+                parts.set(edit.path.replace(/^\/+/, ""), utf8Encoder.encode(edit.text));
+                break;
+            case "deletePart":
+                parts.delete(edit.path.replace(/^\/+/, ""));
+                break;
+            case "replaceBody": {
+                // Preserve the original document's section properties, background,
+                // and document-level wrappers — only swap the children inside w:body.
+                // Reject new external references for the same reason as
+                // replaceHeader/Footer: this editor doesn't rewrite document.xml.rels.
+                assertNoExternalReferences(edit.body, "body");
+                const original = parts.get(PartPath.Document);
+                parts.set(PartPath.Document, original
+                    ? replaceBodyChildrenInDocumentXml(original, edit.body)
+                    : renderBodyOnly(edit.body));
+                break;
+            }
+            case "replaceHeader":
+                parts.set(edit.path.replace(/^\/+/, ""), renderHeaderFooter("header", edit.children));
+                break;
+            case "replaceFooter":
+                parts.set(edit.path.replace(/^\/+/, ""), renderHeaderFooter("footer", edit.children));
+                break;
+        }
+    }
+    // Write back to a new ZIP
+    const archive = zip({ level: options?.compressionLevel ?? 6 });
+    for (const [path, data] of parts) {
+        archive.add(path, data);
+    }
+    return archive.bytes();
+}
+/**
+ * List all part paths in a DOCX file without parsing the model.
+ *
+ * @param buffer - The DOCX file as a Uint8Array.
+ * @returns Array of part paths.
+ */
+export async function listDocxParts(buffer) {
+    const reader = unzip(buffer);
+    const paths = [];
+    for await (const entry of reader.entries()) {
+        paths.push(entry.path);
+    }
+    return paths;
+}
+/**
+ * Read a single part's raw bytes from a DOCX file.
+ *
+ * @param buffer - The DOCX file as a Uint8Array.
+ * @param path - The part path (e.g. `"word/document.xml"`).
+ * @returns The part's raw bytes, or undefined if the part doesn't exist.
+ */
+export async function readDocxPart(buffer, path) {
+    const reader = unzip(buffer);
+    for await (const entry of reader.entries()) {
+        const normalizedPath = entry.path.replace(/^\//, "");
+        if (normalizedPath === path) {
+            return entry.bytes();
+        }
+    }
+    return undefined;
+}
+// =============================================================================
+// Internal helpers
+// =============================================================================
+function renderBodyOnly(body) {
+    const minimalDoc = { body };
+    const ctx = createRenderContext();
+    const xml = new XmlWriter();
+    renderDocument(xml, minimalDoc, ctx);
+    return utf8Encoder.encode(xml.toString());
+}
+/**
+ * Replace the children inside `<w:body>...</w:body>` of an existing
+ * document.xml, preserving the original section properties (the trailing
+ * `w:sectPr` directly under w:body), the document background, and any other
+ * document-level structure (namespace declarations, custom attributes, etc.).
+ *
+ * If the document doesn't contain a parseable `<w:body>` block we fall back
+ * to a minimal render so callers still get a valid DOCX (this matches the
+ * legacy behavior of `replaceBody`).
+ */
+function replaceBodyChildrenInDocumentXml(original, body) {
+    const text = utf8Decoder.decode(original);
+    // Locate <w:body...> opening tag and the matching </w:body>. We must
+    // ignore any literal "<w:body" or "</w:body>" sitting inside an XML
+    // comment, CDATA section, or processing instruction — those are common
+    // in author-edited documents and confused the previous purely-regex
+    // scan.
+    const range = findBodyTagRange(text);
+    if (!range) {
+        return renderBodyOnly(body);
+    }
+    const { bodyStart, bodyCloseIdx } = range;
+    const innerBody = text.slice(bodyStart, bodyCloseIdx);
+    // Preserve the trailing <w:sectPr ...>...</w:sectPr> if present. Section
+    // properties at this level apply to the whole document and would otherwise
+    // be lost.
+    let trailingSectPr = "";
+    const sectPrMatch = /<w:sectPr(?:\s[^>]*)?>[\s\S]*?<\/w:sectPr>\s*$|<w:sectPr(?:\s[^>]*)?\/>\s*$/.exec(innerBody);
+    if (sectPrMatch) {
+        trailingSectPr = sectPrMatch[0].trimEnd();
+    }
+    // Render new body children (no document/body wrappers, no sectPr — we add
+    // back the preserved one ourselves).
+    const ctx = createRenderContext();
+    const xml = new XmlWriter();
+    for (const block of body) {
+        renderBodyContent(xml, block, ctx);
+    }
+    const newInner = xml.toString() + trailingSectPr;
+    const updated = text.slice(0, bodyStart) + newInner + text.slice(bodyCloseIdx);
+    return utf8Encoder.encode(updated);
+}
+/**
+ * Locate the inner-text range of `<w:body>...</w:body>`, ignoring any
+ * occurrence of the literal tag inside XML comments (`<!-- ... -->`),
+ * CDATA sections (`<![CDATA[ ... ]]>`), or processing instructions
+ * (`<?...?>`). Returns the offsets of the first byte after the body open
+ * tag and the first byte of the body close tag, or `undefined` if either
+ * tag was not found.
+ *
+ * The scanner is a tiny linear pass — no lexer, no DOM. It only knows
+ * about the three "skip these contents" sections that can legitimately
+ * contain `<` and `>` characters.
+ */
+function findBodyTagRange(text) {
+    let bodyStart = -1;
+    let bodyCloseIdx = -1;
+    let i = 0;
+    while (i < text.length) {
+        const lt = text.indexOf("<", i);
+        if (lt < 0) {
+            break;
+        }
+        // Comment <!-- ... -->
+        if (text.startsWith("<!--", lt)) {
+            const end = text.indexOf("-->", lt + 4);
+            i = end < 0 ? text.length : end + 3;
+            continue;
+        }
+        // CDATA <![CDATA[ ... ]]>
+        if (text.startsWith("<![CDATA[", lt)) {
+            const end = text.indexOf("]]>", lt + 9);
+            i = end < 0 ? text.length : end + 3;
+            continue;
+        }
+        // Processing instruction <? ... ?>
+        if (text.startsWith("<?", lt)) {
+            const end = text.indexOf("?>", lt + 2);
+            i = end < 0 ? text.length : end + 2;
+            continue;
+        }
+        // Closing tag </w:body>
+        if (text.startsWith("</w:body>", lt)) {
+            // Track the LAST close tag (matches the previous behaviour of
+            // picking up the outermost body) — there should only be one in a
+            // well-formed document anyway, but a stale match would just be
+            // overwritten by the real one.
+            bodyCloseIdx = lt;
+            i = lt + "</w:body>".length;
+            continue;
+        }
+        // Opening tag <w:body...>
+        if (text.startsWith("<w:body", lt)) {
+            const next = text.charCodeAt(lt + 7);
+            // Must be either whitespace before attributes or '>' for the bare tag,
+            // or '/' for the (rare) self-closing form. Anything else (e.g.
+            // "<w:bodyExtra") is a different element name.
+            if (next === 0x20 ||
+                next === 0x09 ||
+                next === 0x0a ||
+                next === 0x0d ||
+                next === 0x3e ||
+                next === 0x2f) {
+                const gt = text.indexOf(">", lt);
+                if (gt < 0) {
+                    break;
+                }
+                // Self-closing `<w:body/>` carries no children — fall back to a
+                // full render rather than trying to splice into nothing.
+                if (text.charCodeAt(gt - 1) === 0x2f) {
+                    return undefined;
+                }
+                if (bodyStart < 0) {
+                    bodyStart = gt + 1;
+                }
+                i = gt + 1;
+                continue;
+            }
+        }
+        // Any other tag — skip past its '>'.
+        const gt = text.indexOf(">", lt + 1);
+        i = gt < 0 ? text.length : gt + 1;
+    }
+    if (bodyStart < 0 || bodyCloseIdx < 0 || bodyStart >= bodyCloseIdx) {
+        return undefined;
+    }
+    return { bodyStart, bodyCloseIdx };
+}
+function renderHeaderFooter(kind, children) {
+    // Reject content that requires fresh part-level relationships (images,
+    // external hyperlinks, charts, alt-chunks, embedded fonts, etc.). The
+    // incremental editor only rewrites individual XML parts; it does not
+    // rebuild the per-part `*.rels` file or copy in new media binaries, so
+    // any new `r:embed` / `r:id` reference would dangle. Callers wanting to
+    // add such content should use the full `patchDocument` / `packageDocx`
+    // flow instead.
+    assertNoExternalReferences(children, kind);
+    const xml = new XmlWriter();
+    if (kind === "header") {
+        renderHeader(xml, { children });
+    }
+    else {
+        renderFooter(xml, { children });
+    }
+    return utf8Encoder.encode(xml.toString());
+}
+/**
+ * Walk a header/footer / body fragment and throw if it contains any element
+ * that needs a per-part relationship registration the incremental editor
+ * cannot perform.
+ *
+ * The list mirrors what {@link renderBodyContent} writes as `r:embed` /
+ * `r:id` / `r:link` attributes:
+ *   - inline & floating images (`r:embed` / `r:link`)
+ *   - external hyperlinks (`r:id` on `w:hyperlink`)
+ *   - charts and chart extensions (`r:id` on `w:chart` / `cx:chart`)
+ *   - alt-chunks (`r:id` on `w:altChunk`)
+ *   - opaque drawings carrying preserved relationships
+ */
+function assertNoExternalReferences(blocks, context) {
+    let offending;
+    walkBlocks(blocks, {
+        enterRun(run) {
+            for (const c of run.content) {
+                if (c.type === "image") {
+                    offending ?? (offending = "inline image");
+                    return "stop";
+                }
+            }
+            return "continue";
+        },
+        enterHyperlink(h) {
+            if (h.url || h.rId) {
+                offending ?? (offending = "hyperlink");
+                return "stop";
+            }
+            return "continue";
+        },
+        visitFloatingImage() {
+            offending ?? (offending = "floating image");
+        },
+        visitChart() {
+            offending ?? (offending = "chart");
+        },
+        visitChartEx() {
+            offending ?? (offending = "chart (extended)");
+        },
+        visitAltChunk() {
+            offending ?? (offending = "altChunk");
+        },
+        visitOpaqueDrawing(drawing) {
+            if (drawing.referencedRIds.length > 0) {
+                offending ?? (offending = "opaque drawing with relationships");
+            }
+        }
+    });
+    if (offending) {
+        throw new DocxUnsupportedFeatureError(`incremental ${context} replacement does not support ${offending}: ` +
+            "relationship parts (.rels) are not rewritten. Use patchDocument() or " +
+            "rebuild the document with packageDocx() instead.");
+    }
+}

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

@@ -2,27 +2,40 @@
  * DOCX Module - Base Exports (Platform Independent)
  *
  * Shared exports for both Node.js and browser environments.
+ *
+ * Each export is annotated with a `@stability` tag:
+ *
+ * - `@stability stable` — Public API. Backwards-compatible changes only;
+ *   semver-major bumps for any breaking changes.
+ * - `@stability experimental` — Public but evolving. The shape may change
+ *   without a major version bump while we collect feedback. Consumers
+ *   should pin to exact minor versions if they rely on these.
+ * - `@stability preserve-only` — Round-trip preservation types. They exist
+ *   so reading and writing a DOCX is loss-less; the underlying schema is
+ *   not yet promised to be ergonomic. Avoid building features on top of
+ *   them unless you also handle the underlying OOXML directly.
+ *
+ * Tree-shakeable subpaths: HTML/Markdown/Excel/PDF integrations live under
+ * `excelts/word/{html,markdown,excel}` and `excelts/pdf` — they are not
+ * re-exported here so bundlers can drop them when unused.
  */
-// Errors
-export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, isDocxError } from "./errors.js";
-// Units
+// --- Stable API ---
+/** @stability stable */
+export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, DocxEncryptedError, DocxDecryptionError, DocxLimitExceededError, isDocxError } from "./errors.js";
+// --- Stable API ---
+/** @stability stable */
 export { inchesToTwips, twipsToInches, cmToTwips, twipsToCm, ptToTwips, twipsToPt, mmToTwips, inchesToEmu, emuToInches, cmToEmu, emuToCm, ptToEmu, pxToEmu, emuToPx, ptToHalfPoint, halfPointToPt, ptToEighthPoint, eighthPointToPt, lineMultiplierToSpacing, spacingToLineMultiplier, percentToTablePct, tablePctToPercent } from "./units.js";
-// Builder helpers
-export { Document, 
+// --- Stable API ---
+/** @stability stable */
+export { Document } from "./builder/document-handle.js";
+/** @stability stable — Run / Field / Math / shape / chart / SDT builders */
+export { 
 // Run helpers
-text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, 
-// Paragraph helpers
-paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, 
-// Comment helpers
-commentRangeStart, commentRangeEnd, commentReference, 
-// Track changes helpers
-insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd, 
+text, bold, italic, underline, strikethrough, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, 
 // CheckBox helper
 checkBox, 
 // Math helpers
-mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, 
-// Additional math helpers
-mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, 
+mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, 
 // Symbol helper
 symbol, 
 // Floating image helper
@@ -32,17 +45,113 @@ drawingShape,
 // Chart helper
 chart, 
 // SDT helper
-structuredDocumentTag, 
-// Table helpers
-border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, resolveThemeColor, mailMerge, 
-// Query API
-paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
-// Packager
-export { packageDocx } from "./docx-packager.js";
-// Reader
-export { readDocx } from "./docx-reader.js";
-// Document IO (toBuffer, toBase64, patchDocument)
-export { toBuffer, toBase64, patchDocument } from "./document-io.js";
-// Sub-namespaces for grouped API ergonomics (no name conflicts with types)
-export { Field, Drawing, TrackChanges, Sdt, Query } from "./namespaces.js";
-export { Math as MathML } from "./namespaces.js";
+structuredDocumentTag } from "./builder/run-builders.js";
+/** @stability stable — paragraph / hyperlink / comment / track-changes builders */
+export { paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, commentRangeStart, commentRangeEnd, commentReference, insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd } from "./builder/paragraph-builders.js";
+/** @stability stable — table builders */
+export { border, gridBorders, cell, row, table, simpleTable } from "./builder/table-builders.js";
+/** @stability stable — theme color resolution */
+export { resolveThemeColor } from "./core/color-utils.js";
+/** @stability stable — search / queries */
+export { paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, listSections, tableCount, extractText, searchText } from "./query/search.js";
+/** @stability stable */
+export { replaceText } from "./query/replace.js";
+/** @stability stable */
+export { mailMerge } from "./query/mail-merge.js";
+/** @stability stable */
+export { mergeDocuments } from "./query/merge.js";
+/** @stability stable */
+export { splitDocument } from "./query/split.js";
+/** @stability stable */
+export { acceptAllRevisions, rejectAllRevisions, listRevisions, acceptRevision, rejectRevision } from "./query/revisions.js";
+/** @stability stable */
+export { resolveStyle, resolveRunStyle, resolveNumberingLevel, resolveTableStyle } from "./query/style-resolve.js";
+/** @stability stable */
+export { getCompatibilityMode, setCompatibilityMode } from "./query/compat.js";
+/** @stability stable */
+export { resolveDataBindings } from "./query/data-binding.js";
+/** @stability stable */
+export { extractFormFields, fillFormFields } from "./query/form-fields.js";
+export { editDocxIncremental, listDocxParts, readDocxPart } from "./incremental-edit.js";
+// --- Stable API ---
+/** @stability stable */
+export { packageDocx } from "./writer/docx-packager.js";
+/** @stability stable */
+export { readDocx } from "./reader/docx-reader.js";
+/** @stability stable */
+export { toBuffer, toBase64, patchDocument, compileTemplate, patchTemplate, fillTemplateFromBuffer, toFlatOpcFromDoc } from "./document-io.js";
+// --- Experimental API ---
+/** @stability experimental */
+export { diffDocuments } from "./advanced/diff.js";
+/** @stability experimental */
+export { fillTemplate, fillTemplateEnhanced, listTemplateTags, isTemplateChart, TemplateError } from "./template/template-engine.js";
+// --- Stable API ---
+/** @stability stable */
+export { parseFlatOpc, isFlatOpc, toFlatOpc } from "./convert/flat-opc.js";
+// --- Experimental API ---
+/** @stability experimental */
+export { StreamingDocxWriter, createDocxStream } from "./writer/streaming-writer.js";
+/** @stability experimental */
+export { validateDocument } from "./advanced/validation.js";
+// Font embedding
+/** @stability stable */
+export { embedFont, embedFontFamily, addEmbeddedFonts, subsetFont } from "./font/font-embed.js";
+// --- Experimental API ---
+/** @stability experimental */
+export { extractOleObjects, hasOleObjects, getOleObjectData, createOleEmbedding } from "./advanced/ole-objects.js";
+/** @stability experimental */
+export { createBuildingBlock, createGlossaryDocument, findBuildingBlock, listBuildingBlocks, getAutoTextEntries, getQuickParts } from "./advanced/glossary.js";
+// Document protection
+/** @stability stable */
+export { protectDocument, unprotectDocument, isDocumentProtected, getProtectionState, verifyProtectionPassword } from "./security/document-protection.js";
+// Style mapping DSL
+/** @stability stable */
+export { parseStyleMap, createStyleMap, mergeStyleMaps, matchStyleMap, DEFAULT_STYLE_MAP } from "./advanced/style-map.js";
+// --- Experimental API ---
+/** @stability experimental */
+export { hasVbaProject, getVbaProjectInfo, getVbaProjectData, addVbaProject, removeVbaProject, listVbaParts } from "./advanced/vba-project.js";
+/** @stability experimental */
+export { layoutDocument } from "./layout/layout.js";
+/** @stability experimental */
+export { layoutDocumentFull } from "./layout/layout-full.js";
+/** @stability experimental */
+export { updateFields, updateTableOfContents } from "./advanced/field-engine.js";
+/** @stability experimental */
+export { ommlToMathML, mathMLToOmml } from "./advanced/math-convert.js";
+/** @stability experimental */
+export { createShape, createRect, createRoundRect, createEllipse, createLine, createArrow, createFlowchartShape, createCallout, createStar } from "./advanced/drawing-shapes.js";
+/** @stability experimental — Text shaping for complex scripts */
+export { shapeText, detectScript, detectDirection } from "./font/text-shaping.js";
+/** @stability experimental — Hyphenation engine */
+export { createHyphenator, hyphenateWord, hyphenateText, ENGLISH_US_PATTERNS } from "./font/hyphenation.js";
+/** @stability experimental — Format-based search */
+export { searchByFormat, countByFormat, getUsedFormats } from "./query/format-search.js";
+/** @stability experimental — ODT (OpenDocument Text) read/write */
+export { readOdt, writeOdt } from "./convert/odt/odt.js";
+/** @stability experimental — Page rendering to SVG */
+export { renderPageToSvg, renderDocumentToSvg, renderPageFromLayout } from "./layout/render-page.js";
+/** @stability experimental — Template data source abstraction */
+export { JsonDataSource, XmlDataSource, CsvDataSource, CompositeDataSource, fillTemplateFromSource } from "./template/template-datasource.js";
+/** @stability experimental — Chart data binding for templates */
+export { bindChartData } from "./template/template-chart.js";
+// NOTE: renderToMarkdown, renderToHtml, htmlToDocx, excelToDocx, markdownToDocx are NOT exported
+// from the main entry — they live in dedicated subpaths to ensure tree-shaking:
+//   import { renderToMarkdown, markdownToDocx } from "excelts/word/markdown"
+//   import { renderToHtml }     from "excelts/word/html"
+//   import { excelToDocx }      from "excelts/word/excel"
+//   import { docxToPdf }        from "excelts/pdf"
+// --- Stable API ---
+/** @stability stable — DOCX encryption */
+export { encryptDocx } from "./security/encryption.js";
+/** @stability experimental */
+export { DEFAULT_SECURITY_POLICY, STRICT_SECURITY_POLICY, resolveSecurityPolicy } from "./security/policy.js";
+/** @stability experimental */
+export { createRenderContext, createIdGenerators } from "./writer/render-context.js";
+/** @stability experimental */
+export { mapDocument } from "./core/mapper.js";
+/** @stability experimental */
+export { walkDocument, walkBlocks, collectParagraphs, collectRuns, collectTables } from "./core/walker.js";
+/** @stability experimental */
+export { createConversionContext } from "./convert/conversion-ir.js";
+/** @stability experimental */
+export { docxToSemantic } from "./convert/docx-to-semantic.js";

package/dist/esm/modules/word/layout/layout-constants.js

@@ -0,0 +1,17 @@
+/**
+ * Shared layout constants for the layout / pagination / SVG render modules.
+ *
+ * These defaults are used when a `SectionProperties` does not specify a
+ * page size or margin. Keeping them in a single file avoids drift between
+ * `layout.ts`, `layout-full.ts`, and `render-page.ts`.
+ *
+ * The values match Microsoft Word's defaults for US Letter paper:
+ *   - Page size: 8.5 in × 11 in (12240 × 15840 twips)
+ *   - Margins:   1 in on all sides (1440 twips)
+ */
+/** Default page width in twips (US Letter, 8.5 in). */
+export const DEFAULT_PAGE_WIDTH_TWIPS = 12240;
+/** Default page height in twips (US Letter, 11 in). */
+export const DEFAULT_PAGE_HEIGHT_TWIPS = 15840;
+/** Default page margin in twips (1 in on each side). */
+export const DEFAULT_PAGE_MARGIN_TWIPS = 1440;