@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/cjs/modules/word/reader/drawing-helpers.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * DOCX Reader - Drawing/Image Helpers
+ *
+ * Shared parsing helpers for DrawingML elements (used by both inline image,
+ * floating image, and drawing shape parsers).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseXfrm = parseXfrm;
+exports.parseOutline = parseOutline;
+exports.parseSrcRect = parseSrcRect;
+exports.parseSvgBlip = parseSvgBlip;
+const dom_1 = require("../../xml/dom.js");
+const parse_utils_1 = require("./parse-utils");
+/** Parse `a:xfrm` element for rotation and flip properties. */
+function parseXfrm(spPrEl, target) {
+    const xfrmEl = (0, dom_1.findChild)(spPrEl, "a:xfrm");
+    if (xfrmEl) {
+        const rot = xfrmEl.attributes["rot"];
+        if (rot !== undefined && rot !== "") {
+            target.rotation = parseInt(rot, 10);
+        }
+        if (xfrmEl.attributes["flipH"] === "1") {
+            target.flipHorizontal = true;
+        }
+        if (xfrmEl.attributes["flipV"] === "1") {
+            target.flipVertical = true;
+        }
+    }
+}
+/** Parse outline (`a:ln`) element. */
+function parseOutline(spPrEl) {
+    const lnEl = (0, dom_1.findChild)(spPrEl, "a:ln");
+    if (!lnEl) {
+        return undefined;
+    }
+    const outline = {};
+    const w = lnEl.attributes["w"];
+    if (w) {
+        outline.width = parseInt(w, 10);
+    }
+    const sfEl = (0, dom_1.findChild)(lnEl, "a:solidFill");
+    const srgbEl = sfEl ? (0, dom_1.findChild)(sfEl, "a:srgbClr") : undefined;
+    if (srgbEl) {
+        outline.color = srgbEl.attributes["val"];
+    }
+    return Object.keys(outline).length > 0 ? outline : undefined;
+}
+/** Parse source rectangle (crop) from `a:blipFill`. */
+function parseSrcRect(blipFillEl) {
+    const srcRectEl = (0, dom_1.findChild)(blipFillEl, "a:srcRect");
+    if (!srcRectEl) {
+        return undefined;
+    }
+    const sr = {};
+    const lAttr = srcRectEl.attributes["l"];
+    const tAttr = srcRectEl.attributes["t"];
+    const rAttr = srcRectEl.attributes["r"];
+    const bAttr = srcRectEl.attributes["b"];
+    if (lAttr !== undefined) {
+        sr.l = parseInt(lAttr, 10);
+    }
+    if (tAttr !== undefined) {
+        sr.t = parseInt(tAttr, 10);
+    }
+    if (rAttr !== undefined) {
+        sr.r = parseInt(rAttr, 10);
+    }
+    if (bAttr !== undefined) {
+        sr.b = parseInt(bAttr, 10);
+    }
+    return Object.keys(sr).length > 0 ? sr : undefined;
+}
+/** Parse SVG blip reference from `a:extLst` inside `a:blip`. */
+function parseSvgBlip(blipEl) {
+    const extLst = (0, dom_1.findChild)(blipEl, "a:extLst");
+    if (!extLst) {
+        return undefined;
+    }
+    for (const ext of (0, dom_1.findChildren)(extLst, "a:ext")) {
+        const svgBlip = (0, dom_1.findChild)(ext, "asvg:svgBlip") ?? (0, parse_utils_1.findChildNs)(ext, "svgBlip");
+        if (svgBlip) {
+            const svgEmbed = svgBlip.attributes["r:embed"];
+            if (svgEmbed) {
+                return svgEmbed;
+            }
+        }
+    }
+    return undefined;
+}

package/dist/cjs/modules/word/reader/form-field-parser.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * DOCX Reader - Form Field Parser
+ *
+ * Standalone parser for `w:ffData` elements (legacy form fields).
+ * Used by the run content parser when encountering form-field-bearing fields.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFfData = parseFfData;
+const parse_utils_1 = require("./parse-utils");
+/**
+ * Parse a `w:ffData` element into a `FormField`.
+ *
+ * Supports the three legacy form field types:
+ * - `w:textInput` → text field
+ * - `w:checkBox` → checkbox field
+ * - `w:ddList` → drop-down list field
+ *
+ * Common properties (name, enabled, helpText, statusText) are extracted.
+ *
+ * @returns A `FormField` object, or undefined if no recognized field type was found.
+ */
+function parseFfData(el) {
+    const nameEl = (0, parse_utils_1.findChildNs)(el, "name");
+    const name = nameEl ? (0, parse_utils_1.attrVal)(nameEl, "val") : undefined;
+    const enabledEl = (0, parse_utils_1.findChildNs)(el, "enabled");
+    const enabled = enabledEl ? (0, parse_utils_1.attrVal)(enabledEl, "val") !== "0" : undefined;
+    const helpTextEl = (0, parse_utils_1.findChildNs)(el, "helpText");
+    const helpText = helpTextEl ? (0, parse_utils_1.attrVal)(helpTextEl, "val") : undefined;
+    const statusTextEl = (0, parse_utils_1.findChildNs)(el, "statusText");
+    const statusText = statusTextEl ? (0, parse_utils_1.attrVal)(statusTextEl, "val") : undefined;
+    // Text input
+    const textInputEl = (0, parse_utils_1.findChildNs)(el, "textInput");
+    if (textInputEl) {
+        const defEl = (0, parse_utils_1.findChildNs)(textInputEl, "default");
+        const maxLenEl = (0, parse_utils_1.findChildNs)(textInputEl, "maxLength");
+        const fmtEl = (0, parse_utils_1.findChildNs)(textInputEl, "format");
+        return {
+            type: "text",
+            name,
+            default: defEl ? (0, parse_utils_1.attrVal)(defEl, "val") : undefined,
+            maxLength: maxLenEl ? (0, parse_utils_1.attrInt)(maxLenEl, "val") : undefined,
+            format: fmtEl ? (0, parse_utils_1.attrVal)(fmtEl, "val") : undefined,
+            helpText,
+            statusText,
+            enabled
+        };
+    }
+    // CheckBox
+    const cbEl = (0, parse_utils_1.findChildNs)(el, "checkBox");
+    if (cbEl) {
+        const checkedEl = (0, parse_utils_1.findChildNs)(cbEl, "checked");
+        const defEl = (0, parse_utils_1.findChildNs)(cbEl, "default");
+        const sizeEl = (0, parse_utils_1.findChildNs)(cbEl, "size");
+        return {
+            type: "checkBox",
+            name,
+            checked: checkedEl ? (0, parse_utils_1.attrVal)(checkedEl, "val") !== "0" : undefined,
+            default: defEl ? (0, parse_utils_1.attrVal)(defEl, "val") !== "0" : undefined,
+            size: sizeEl ? (0, parse_utils_1.attrInt)(sizeEl, "val") : undefined
+        };
+    }
+    // Drop-down list
+    const ddlEl = (0, parse_utils_1.findChildNs)(el, "ddList");
+    if (ddlEl) {
+        const defEl = (0, parse_utils_1.findChildNs)(ddlEl, "default");
+        const entries = [];
+        for (const le of (0, parse_utils_1.findChildrenNs)(ddlEl, "listEntry")) {
+            const v = (0, parse_utils_1.attrVal)(le, "val");
+            if (v !== undefined) {
+                entries.push(v);
+            }
+        }
+        return {
+            type: "dropDown",
+            name,
+            entries: entries.length > 0 ? entries : undefined,
+            default: defEl ? (0, parse_utils_1.attrInt)(defEl, "val") : undefined,
+            helpText,
+            statusText,
+            enabled
+        };
+    }
+    return undefined;
+}

package/dist/cjs/modules/word/reader/image-parsers.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * DOCX Reader - Image Parsers
+ *
+ * Parsers for inline and floating images (wp:inline / wp:anchor).
+ * These are pure parsers that don't depend on ReaderContext.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDrawingContent = parseDrawingContent;
+exports.parseFloatingImage = parseFloatingImage;
+const dom_1 = require("../../xml/dom.js");
+const drawing_helpers_1 = require("./drawing-helpers");
+const parse_utils_1 = require("./parse-utils");
+function parseDrawingContent(drawingEl, content) {
+    // Look for wp:inline
+    const inlineEl = (0, dom_1.findChild)(drawingEl, "wp:inline");
+    if (inlineEl) {
+        const extentEl = (0, dom_1.findChild)(inlineEl, "wp:extent");
+        const docPrEl = (0, dom_1.findChild)(inlineEl, "wp:docPr");
+        const graphicEl = (0, dom_1.findChild)(inlineEl, "a:graphic");
+        const graphicDataEl = graphicEl ? (0, dom_1.findChild)(graphicEl, "a:graphicData") : undefined;
+        const picEl = graphicDataEl ? (0, dom_1.findChild)(graphicDataEl, "pic:pic") : undefined;
+        const blipFillEl = picEl ? (0, dom_1.findChild)(picEl, "pic:blipFill") : undefined;
+        const blipEl = blipFillEl ? (0, dom_1.findChild)(blipFillEl, "a:blip") : undefined;
+        const rId = blipEl?.attributes["r:embed"];
+        if (!rId) {
+            // Non-picture inline drawing (chart, SmartArt, OLE, generic shape).
+            // Preserve the entire <w:drawing>…</w:drawing> as an opaque run content
+            // so the element survives a parse → write round-trip even when the
+            // surrounding paragraph lives inside a table cell, header, footer or
+            // SDT — locations where the body-level floating-content extractor
+            // never runs.
+            content.push({
+                type: "opaqueRun",
+                rawXml: (0, parse_utils_1.serializeElement)(drawingEl)
+            });
+            return;
+        }
+        const cx = (0, parse_utils_1.safeParseInt)(extentEl?.attributes["cx"], 0);
+        const cy = (0, parse_utils_1.safeParseInt)(extentEl?.attributes["cy"], 0);
+        const img = {
+            type: "image",
+            rId,
+            width: cx,
+            height: cy,
+            altText: docPrEl?.attributes["descr"],
+            name: docPrEl?.attributes["name"],
+            drawingId: docPrEl ? (0, parse_utils_1.safeParseInt)(docPrEl.attributes["id"], 1) : undefined
+        };
+        // Parse xfrm for rotation/flip + outline
+        const spPrEl = picEl ? (0, dom_1.findChild)(picEl, "pic:spPr") : undefined;
+        if (spPrEl) {
+            (0, drawing_helpers_1.parseXfrm)(spPrEl, img);
+            const outline = (0, drawing_helpers_1.parseOutline)(spPrEl);
+            if (outline) {
+                img.outline = outline;
+            }
+        }
+        // Source rectangle (crop)
+        if (blipFillEl) {
+            const srcRect = (0, drawing_helpers_1.parseSrcRect)(blipFillEl);
+            if (srcRect) {
+                img.srcRect = srcRect;
+            }
+        }
+        // SVG blip in a:extLst
+        if (blipEl) {
+            const svgRId = (0, drawing_helpers_1.parseSvgBlip)(blipEl);
+            if (svgRId) {
+                img.svgRId = svgRId;
+            }
+        }
+        content.push(img);
+    }
+}
+// =============================================================================
+// Floating Image Parser
+// =============================================================================
+function parseFloatingImage(anchorEl) {
+    const docPrEl = (0, dom_1.findChild)(anchorEl, "wp:docPr");
+    const extentEl = (0, dom_1.findChild)(anchorEl, "wp:extent");
+    const graphicEl = (0, dom_1.findChild)(anchorEl, "a:graphic");
+    const graphicDataEl = graphicEl ? (0, dom_1.findChild)(graphicEl, "a:graphicData") : undefined;
+    const picEl = graphicDataEl ? (0, dom_1.findChild)(graphicDataEl, "pic:pic") : undefined;
+    const blipFillEl = picEl ? (0, dom_1.findChild)(picEl, "pic:blipFill") : undefined;
+    const blipEl = blipFillEl ? (0, dom_1.findChild)(blipFillEl, "a:blip") : undefined;
+    const rId = blipEl?.attributes["r:embed"];
+    if (!rId) {
+        return undefined;
+    }
+    const cx = (0, parse_utils_1.safeParseInt)(extentEl?.attributes["cx"], 0);
+    const cy = (0, parse_utils_1.safeParseInt)(extentEl?.attributes["cy"], 0);
+    const img = {
+        type: "floatingImage",
+        rId,
+        width: cx,
+        height: cy,
+        altText: docPrEl?.attributes["descr"],
+        name: docPrEl?.attributes["name"],
+        drawingId: docPrEl ? (0, parse_utils_1.safeParseInt)(docPrEl.attributes["id"], 1) : undefined
+    };
+    // Attributes
+    if (anchorEl.attributes["behindDoc"] === "1") {
+        img.behindDoc = true;
+    }
+    if (anchorEl.attributes["locked"] === "1") {
+        img.lockAnchor = true;
+    }
+    if (anchorEl.attributes["layoutInCell"] === "0") {
+        img.layoutInCell = false;
+    }
+    if (anchorEl.attributes["allowOverlap"] === "0") {
+        img.allowOverlap = false;
+    }
+    const rh = anchorEl.attributes["relativeHeight"];
+    if (rh) {
+        const n = parseInt(rh, 10);
+        if (Number.isFinite(n)) {
+            img.relativeHeight = n;
+        }
+    }
+    // Dist* — guard each parseInt against NaN so a hostile attribute
+    // never round-trips back into the output XML as the literal "NaN"
+    // (Word rejects such files).
+    const distT = anchorEl.attributes["distT"];
+    if (distT) {
+        const n = parseInt(distT, 10);
+        if (Number.isFinite(n)) {
+            img.distT = n;
+        }
+    }
+    const distB = anchorEl.attributes["distB"];
+    if (distB) {
+        const n = parseInt(distB, 10);
+        if (Number.isFinite(n)) {
+            img.distB = n;
+        }
+    }
+    const distL = anchorEl.attributes["distL"];
+    if (distL) {
+        const n = parseInt(distL, 10);
+        if (Number.isFinite(n)) {
+            img.distL = n;
+        }
+    }
+    const distR = anchorEl.attributes["distR"];
+    if (distR) {
+        const n = parseInt(distR, 10);
+        if (Number.isFinite(n)) {
+            img.distR = n;
+        }
+    }
+    // Simple positioning
+    if (anchorEl.attributes["simplePos"] === "1") {
+        const sposEl = (0, dom_1.findChild)(anchorEl, "wp:simplePos");
+        if (sposEl) {
+            const x = (0, parse_utils_1.safeParseInt)(sposEl.attributes["x"], 0);
+            const y = (0, parse_utils_1.safeParseInt)(sposEl.attributes["y"], 0);
+            img.simplePos = { x, y };
+        }
+    }
+    // Horizontal position
+    const hPosEl = (0, dom_1.findChild)(anchorEl, "wp:positionH");
+    if (hPosEl) {
+        const h = {
+            relativeTo: hPosEl.attributes["relativeFrom"]
+        };
+        const offsetEl = (0, dom_1.findChild)(hPosEl, "wp:posOffset");
+        if (offsetEl) {
+            const n = parseInt((0, dom_1.textContent)(offsetEl), 10);
+            if (Number.isFinite(n)) {
+                h.offset = n;
+            }
+        }
+        const alignEl = (0, dom_1.findChild)(hPosEl, "wp:align");
+        if (alignEl) {
+            h.align = (0, dom_1.textContent)(alignEl);
+        }
+        img.horizontalPosition = h;
+    }
+    // Vertical position
+    const vPosEl = (0, dom_1.findChild)(anchorEl, "wp:positionV");
+    if (vPosEl) {
+        const v = {
+            relativeTo: vPosEl.attributes["relativeFrom"]
+        };
+        const offsetEl = (0, dom_1.findChild)(vPosEl, "wp:posOffset");
+        if (offsetEl) {
+            const n = parseInt((0, dom_1.textContent)(offsetEl), 10);
+            if (Number.isFinite(n)) {
+                v.offset = n;
+            }
+        }
+        const alignEl = (0, dom_1.findChild)(vPosEl, "wp:align");
+        if (alignEl) {
+            v.align = (0, dom_1.textContent)(alignEl);
+        }
+        img.verticalPosition = v;
+    }
+    // Wrap
+    for (const wrapChild of anchorEl.children) {
+        if (wrapChild.type !== "element") {
+            continue;
+        }
+        const wn = wrapChild.name;
+        let wrap;
+        if (wn === "wp:wrapSquare") {
+            wrap = {
+                style: "square",
+                side: wrapChild.attributes["wrapText"]
+            };
+        }
+        else if (wn === "wp:wrapTight") {
+            wrap = {
+                style: "tight",
+                side: wrapChild.attributes["wrapText"]
+            };
+        }
+        else if (wn === "wp:wrapThrough") {
+            wrap = {
+                style: "through",
+                side: wrapChild.attributes["wrapText"]
+            };
+        }
+        else if (wn === "wp:wrapTopAndBottom") {
+            wrap = { style: "topAndBottom" };
+        }
+        else if (wn === "wp:wrapNone") {
+            wrap = { style: "none" };
+        }
+        if (wrap) {
+            // Parse wrap margins
+            const distT = anchorEl.attributes["distT"];
+            const distB = anchorEl.attributes["distB"];
+            const distL = anchorEl.attributes["distL"];
+            const distR = anchorEl.attributes["distR"];
+            if (distT || distB || distL || distR) {
+                const margins = {};
+                if (distT) {
+                    const n = parseInt(distT, 10);
+                    if (Number.isFinite(n)) {
+                        margins.top = n;
+                    }
+                }
+                if (distB) {
+                    const n = parseInt(distB, 10);
+                    if (Number.isFinite(n)) {
+                        margins.bottom = n;
+                    }
+                }
+                if (distL) {
+                    const n = parseInt(distL, 10);
+                    if (Number.isFinite(n)) {
+                        margins.left = n;
+                    }
+                }
+                if (distR) {
+                    const n = parseInt(distR, 10);
+                    if (Number.isFinite(n)) {
+                        margins.right = n;
+                    }
+                }
+                wrap.margins = margins;
+            }
+            img.wrap = wrap;
+            break;
+        }
+    }
+    // Rotation/flip from spPr
+    const spPrEl = picEl ? (0, dom_1.findChild)(picEl, "pic:spPr") : undefined;
+    if (spPrEl) {
+        (0, drawing_helpers_1.parseXfrm)(spPrEl, img);
+        const outline = (0, drawing_helpers_1.parseOutline)(spPrEl);
+        if (outline) {
+            img.outline = outline;
+        }
+    }
+    // SVG blip in a:extLst
+    if (blipEl) {
+        const svgRId = (0, drawing_helpers_1.parseSvgBlip)(blipEl);
+        if (svgRId) {
+            img.svgRId = svgRId;
+        }
+    }
+    // Source rectangle (crop)
+    if (blipFillEl) {
+        const srcRect = (0, drawing_helpers_1.parseSrcRect)(blipFillEl);
+        if (srcRect) {
+            img.srcRect = srcRect;
+        }
+    }
+    return img;
+}