@cj-tech-master/excelts 9.5.4 → 9.5.5

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

@@ -2,17 +2,55 @@
 /**
  * DOCX Module - Document IO
  *
- * IO operations that depend on docx-packager and docx-reader.
- * Separated from document.ts so that builder helpers can be imported
- * without pulling in archive/xml/writer code.
+ * IO operations: package/unpackage to bytes, base64, Flat OPC,
+ * plus the public Patch and Template APIs that combine read/patch/write.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toBuffer = toBuffer;
 exports.toBase64 = toBase64;
+exports.compileTemplate = compileTemplate;
+exports.patchTemplate = patchTemplate;
 exports.patchDocument = patchDocument;
-const docx_packager_1 = require("./docx-packager");
-const docx_reader_1 = require("./docx-reader");
-const internal_utils_1 = require("./internal-utils");
+exports.fillTemplateFromBuffer = fillTemplateFromBuffer;
+exports.toFlatOpcFromDoc = toFlatOpcFromDoc;
+const internal_utils_1 = require("./core/internal-utils");
+const patcher_1 = require("./patcher");
+const docx_reader_1 = require("./reader/docx-reader");
+const template_engine_1 = require("./template/template-engine");
+const docx_packager_1 = require("./writer/docx-packager");
 // =============================================================================
 // Document IO (toBuffer / toBase64)
 // =============================================================================
@@ -25,6 +63,36 @@ async function toBase64(doc, compressionLevel) {
     const bytes = await toBuffer(doc, compressionLevel);
     return (0, internal_utils_1.bytesToBase64)(bytes);
 }
+/**
+ * Compile a DOCX template for reuse with multiple data sets.
+ *
+ * Parsing the ZIP and XML is expensive. If you need to patch the same template
+ * multiple times with different data, compile it once and reuse.
+ *
+ * @param buffer - The source DOCX template file as a Uint8Array.
+ * @returns A compiled template handle.
+ */
+async function compileTemplate(buffer) {
+    const doc = await (0, docx_reader_1.readDocx)(buffer);
+    return { _doc: doc };
+}
+/**
+ * Apply patches to a pre-compiled template.
+ *
+ * Much faster than `patchDocument` when applying to the same template repeatedly,
+ * since ZIP/XML parsing is skipped.
+ *
+ * @param template - A compiled template from `compileTemplate`.
+ * @param patches - Array of patch operations to apply.
+ * @param options - Optional compression settings.
+ * @returns New DOCX file as a Uint8Array.
+ */
+async function patchTemplate(template, patches, options) {
+    // Deep clone the document to avoid mutating the cached template
+    const doc = structuredClone(template._doc);
+    const patched = (0, patcher_1.applyPatchesToDocument)(doc, patches);
+    return (0, docx_packager_1.packageDocx)(patched, options?.compressionLevel);
+}
 /**
  * Read an existing DOCX file, replace placeholders with content, and produce a new DOCX.
  *
@@ -44,201 +112,53 @@ async function toBase64(doc, compressionLevel) {
  */
 async function patchDocument(buffer, patches, options) {
     const doc = await (0, docx_reader_1.readDocx)(buffer);
-    // Build lookup map for quick placeholder matching
-    const patchMap = new Map();
-    for (const patch of patches) {
-        patchMap.set(patch.placeholder, patch);
-    }
-    // Process body content
-    const newBody = [];
-    for (const block of doc.body) {
-        if (block.type === "paragraph") {
-            const result = patchParagraph(block, patchMap);
-            if (result) {
-                if (Array.isArray(result)) {
-                    newBody.push(...result);
-                }
-                else {
-                    newBody.push(result);
-                }
-            }
-        }
-        else if (block.type === "table") {
-            patchTable(block, patchMap);
-            newBody.push(block);
-        }
-        else {
-            newBody.push(block);
-        }
-    }
-    // Patch headers
-    if (doc.headers) {
-        for (const [, headerDef] of doc.headers) {
-            patchHeaderFooterContent(headerDef.content, patchMap);
-        }
-    }
-    // Patch footers
-    if (doc.footers) {
-        for (const [, footerDef] of doc.footers) {
-            patchHeaderFooterContent(footerDef.content, patchMap);
-        }
-    }
-    // Add any new images from patches
-    const images = doc.images ? [...doc.images] : [];
-    for (const patch of patches) {
-        if (patch.content.type === "image") {
-            const imgContent = patch.content;
-            const existing = images.find(i => i.fileName === imgContent.image.fileName);
-            if (!existing) {
-                images.push(imgContent.image);
-            }
-        }
-    }
-    const patched = {
-        ...doc,
-        body: newBody,
-        images: images.length > 0 ? images : undefined
-    };
+    const patched = (0, patcher_1.applyPatchesToDocument)(doc, patches);
     return (0, docx_packager_1.packageDocx)(patched, options?.compressionLevel);
 }
 // =============================================================================
-// Internal helpers
+// Template Engine - Convenience IO
 // =============================================================================
-/** Extract concatenated plain text from a paragraph's runs. */
-function paragraphText(para) {
-    let t = "";
-    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) {
-                    t += c.text;
-                }
-            }
-        }
-    }
-    return t;
-}
-/** Replace text within a single paragraph. */
-function replaceInParagraph(para, search, replacement) {
-    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;
-            if (before.includes(search)) {
-                c.text = before.replaceAll(search, replacement);
-            }
-        }
-    }
-    // Cross-run replacement fallback
-    const fullText = paragraphText(para);
-    if (fullText.includes(search)) {
-        const newText = fullText.replaceAll(search, replacement);
-        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 = "";
-                }
-            }
-        }
-    }
-}
-/** Patch a paragraph — returns replacement content or null to remove. */
-function patchParagraph(para, patchMap) {
-    const text = paragraphText(para);
-    for (const [placeholder, patch] of patchMap) {
-        if (!text.includes(placeholder)) {
-            continue;
-        }
-        switch (patch.content.type) {
-            case "text": {
-                replaceInParagraph(para, placeholder, patch.content.text);
-                return para;
-            }
-            case "paragraph": {
-                return patch.content.children;
-            }
-            case "table": {
-                return patch.content.table;
-            }
-            case "image": {
-                const img = patch.content.image;
-                const rId = img.rId ?? `rId_img_${img.fileName}`;
-                const imgContent = {
-                    type: "image",
-                    rId,
-                    width: patch.content.width,
-                    height: patch.content.height,
-                    altText: img.fileName,
-                    name: img.fileName
-                };
-                const newPara = {
-                    type: "paragraph",
-                    properties: para.properties,
-                    children: [{ content: [imgContent] }]
-                };
-                return newPara;
-            }
-        }
-    }
-    return para;
-}
-/** Patch text inside table cells recursively. */
-function patchTable(table, patchMap) {
-    for (const row of table.rows) {
-        for (const cell of row.cells) {
-            const newContent = [];
-            for (const block of cell.content) {
-                if (block.type === "paragraph") {
-                    const result = patchParagraph(block, patchMap);
-                    if (result) {
-                        if (Array.isArray(result)) {
-                            newContent.push(...result);
-                        }
-                        else {
-                            newContent.push(result);
-                        }
-                    }
-                }
-                else if (block.type === "table") {
-                    patchTable(block, patchMap);
-                    newContent.push(block);
-                }
-                else {
-                    newContent.push(block);
-                }
-            }
-            cell.content = newContent;
-        }
-    }
+/**
+ * Read a DOCX buffer, fill template placeholders with data, and produce a new DOCX.
+ *
+ * This is a convenience wrapper combining readDocx + fillTemplate + packageDocx.
+ *
+ * @param buffer - The source DOCX template file as a Uint8Array.
+ * @param data - Data object to fill into the template placeholders.
+ * @param options - Template and compression options.
+ * @returns New DOCX file as a Uint8Array.
+ */
+async function fillTemplateFromBuffer(buffer, data, options) {
+    const doc = await (0, docx_reader_1.readDocx)(buffer);
+    const filled = (0, template_engine_1.fillTemplate)(doc, data, options);
+    return (0, docx_packager_1.packageDocx)(filled, options?.compressionLevel);
 }
-/** Patch text in header/footer content. */
-function patchHeaderFooterContent(content, patchMap) {
-    for (const child of content.children) {
-        if (child.type === "paragraph") {
-            for (const [placeholder, patch] of patchMap) {
-                if (patch.content.type === "text") {
-                    const text = paragraphText(child);
-                    if (text.includes(placeholder)) {
-                        replaceInParagraph(child, placeholder, patch.content.text);
-                    }
-                }
-            }
-        }
+// =============================================================================
+// Flat OPC Convenience
+// =============================================================================
+/**
+ * Package a DocxDocument model into Flat OPC XML format.
+ *
+ * This packages the document to a ZIP, then re-reads the entries to wrap
+ * them as Flat OPC XML. While this involves a ZIP round-trip, it ensures
+ * the Flat OPC output is byte-identical to what `packageDocx` would produce
+ * (same XML serialization, same relationships, same content types).
+ *
+ * @param doc - The document model.
+ * @param compressionLevel - Optional compression level (0 = no compression, faster for Flat OPC).
+ * @returns The Flat OPC XML string.
+ */
+async function toFlatOpcFromDoc(doc, compressionLevel) {
+    // Use level 0 (store-only) since we're immediately decompressing
+    const zipBytes = await (0, docx_packager_1.packageDocx)(doc, compressionLevel ?? 0);
+    const { unzip } = await Promise.resolve().then(() => __importStar(require("../archive/read-archive.js")));
+    const reader = unzip(zipBytes);
+    const entries = new Map();
+    for await (const entry of reader.entries()) {
+        const data = await entry.bytes();
+        const path = entry.path.replace(/^\//, "").replace(/\\/g, "/");
+        entries.set(path, data);
     }
+    const { toFlatOpc } = await Promise.resolve().then(() => __importStar(require("./convert/flat-opc")));
+    return toFlatOpc(entries);
 }

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

@@ -5,21 +5,9 @@
  * All DOCX-related errors extend DocxError.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocxUnsupportedFeatureError = exports.DocxInvalidStructureError = exports.DocxMissingPartError = exports.DocxWriteError = exports.DocxParseError = exports.DocxError = exports.getRootCause = exports.getErrorChain = exports.errorToJSON = exports.suppressUnhandledRejection = exports.toError = exports.createLinkedAbortController = exports.throwIfAborted = exports.isAbortError = exports.createAbortError = exports.AbortError = void 0;
+exports.DocxRawXmlPolicyError = exports.DocxLimitExceededError = exports.DocxDecryptionError = exports.DocxEncryptedError = exports.DocxUnsupportedFeatureError = exports.DocxInvalidStructureError = exports.DocxMissingPartError = exports.DocxWriteError = exports.DocxParseError = exports.DocxError = void 0;
 exports.isDocxError = isDocxError;
 const errors_1 = require("../../utils/errors.js");
-// Re-export common utilities from base
-var errors_2 = require("../../utils/errors.js");
-Object.defineProperty(exports, "AbortError", { enumerable: true, get: function () { return errors_2.AbortError; } });
-Object.defineProperty(exports, "createAbortError", { enumerable: true, get: function () { return errors_2.createAbortError; } });
-Object.defineProperty(exports, "isAbortError", { enumerable: true, get: function () { return errors_2.isAbortError; } });
-Object.defineProperty(exports, "throwIfAborted", { enumerable: true, get: function () { return errors_2.throwIfAborted; } });
-Object.defineProperty(exports, "createLinkedAbortController", { enumerable: true, get: function () { return errors_2.createLinkedAbortController; } });
-Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return errors_2.toError; } });
-Object.defineProperty(exports, "suppressUnhandledRejection", { enumerable: true, get: function () { return errors_2.suppressUnhandledRejection; } });
-Object.defineProperty(exports, "errorToJSON", { enumerable: true, get: function () { return errors_2.errorToJSON; } });
-Object.defineProperty(exports, "getErrorChain", { enumerable: true, get: function () { return errors_2.getErrorChain; } });
-Object.defineProperty(exports, "getRootCause", { enumerable: true, get: function () { return errors_2.getRootCause; } });
 /**
  * Base class for all DOCX-related errors.
  */
@@ -86,3 +74,61 @@ class DocxUnsupportedFeatureError extends DocxError {
     }
 }
 exports.DocxUnsupportedFeatureError = DocxUnsupportedFeatureError;
+/**
+ * Error thrown when a DOCX file is encrypted (CFB format) and no password
+ * was provided. Pass `{ password }` in the second argument of `readDocx()`
+ * to decrypt automatically, or call `decryptDocx()` from "excelts/word/crypto"
+ * directly if you need lower-level access to the decrypted ZIP bytes.
+ */
+class DocxEncryptedError extends DocxError {
+    constructor() {
+        super("The document is encrypted (password-protected). " +
+            'Pass { password } to readDocx(), or use decryptDocx() from "excelts/word/crypto" ' +
+            "for lower-level decryption.");
+        this.name = "DocxEncryptedError";
+    }
+}
+exports.DocxEncryptedError = DocxEncryptedError;
+/**
+ * Error thrown when an encrypted DOCX cannot be decrypted with the provided
+ * password (wrong password) or when the encryption metadata is malformed.
+ */
+class DocxDecryptionError extends DocxError {
+    constructor() {
+        super(...arguments);
+        this.name = "DocxDecryptionError";
+    }
+}
+exports.DocxDecryptionError = DocxDecryptionError;
+/**
+ * Error thrown when an input package exceeds a declared resource limit (e.g.
+ * total package size, single part size, number of parts). Used to defend
+ * against ZIP bombs and runaway memory usage.
+ */
+class DocxLimitExceededError extends DocxParseError {
+    constructor(limit, maximum, actual, detail) {
+        super(`DOCX ${limit} limit exceeded: actual ${actual} > maximum ${maximum}` +
+            (detail ? ` (${detail})` : ""));
+        this.name = "DocxLimitExceededError";
+        this.limit = limit;
+        this.maximum = maximum;
+        this.actual = actual;
+    }
+}
+exports.DocxLimitExceededError = DocxLimitExceededError;
+/**
+ * Error thrown when the active `WordSecurityPolicy.rawXmlPolicy` is `"reject"`
+ * and the writer encounters opaque/preserved rawXml that would otherwise have
+ * been emitted verbatim. Callers can either drop the offending model field
+ * before serialisation or relax the policy to `"strip"` / `"preserve"`.
+ */
+class DocxRawXmlPolicyError extends DocxWriteError {
+    constructor(site) {
+        super(`Raw XML rejected by security policy at "${site}". ` +
+            "Either remove the rawXml/opaque field from the model or set " +
+            "WordSecurityPolicy.rawXmlPolicy to 'preserve' or 'strip'.");
+        this.name = "DocxRawXmlPolicyError";
+        this.site = site;
+    }
+}
+exports.DocxRawXmlPolicyError = DocxRawXmlPolicyError;

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

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * DOCX Module - Excel Bridge (Subpath Entry)
+ *
+ * Re-exports the Excel bridge API at `excelts/word/excel`. This file is
+ * referenced by `package.json#exports["./word/excel"]`; it forwards to the
+ * implementation under `./bridge/excel-bridge`.
+ *
+ * @example
+ * ```ts
+ * import { excelToDocx } from "excelts/word/excel";
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateChartEmbeddedXlsx = exports.wordChartToChartModel = exports.buildWordChartExXml = exports.renderWordChartSvg = exports.extractTablesToExcel = exports.excelToDocx = void 0;
+var excel_bridge_1 = require("./bridge/excel-bridge");
+Object.defineProperty(exports, "excelToDocx", { enumerable: true, get: function () { return excel_bridge_1.excelToDocx; } });
+Object.defineProperty(exports, "extractTablesToExcel", { enumerable: true, get: function () { return excel_bridge_1.extractTablesToExcel; } });
+Object.defineProperty(exports, "renderWordChartSvg", { enumerable: true, get: function () { return excel_bridge_1.renderWordChartSvg; } });
+Object.defineProperty(exports, "buildWordChartExXml", { enumerable: true, get: function () { return excel_bridge_1.buildWordChartExXml; } });
+Object.defineProperty(exports, "wordChartToChartModel", { enumerable: true, get: function () { return excel_bridge_1.wordChartToChartModel; } });
+Object.defineProperty(exports, "generateChartEmbeddedXlsx", { enumerable: true, get: function () { return excel_bridge_1.generateChartEmbeddedXlsx; } });