@cj-tech-master/excelts 9.5.4 → 9.5.5

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

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * DOCX Reader - SDT Helper Parsers
+ *
+ * Standalone parsers for SDT-related elements that don't depend on
+ * the main reader context (parseParagraph etc.):
+ * - `parseCheckBox` — w14:checkbox SDT specialization
+ * - `parseTocInstruction` — TOC field instruction string parser
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCheckBox = parseCheckBox;
+exports.parseTocInstruction = parseTocInstruction;
+const dom_1 = require("../../xml/dom.js");
+/**
+ * Parse a w14:checkbox SDT element.
+ *
+ * Handles `w14:checked`, `w14:checkedState`, `w14:uncheckedState`.
+ */
+function parseCheckBox(checkBoxEl) {
+    const cb = { type: "checkBox" };
+    const checkedEl = (0, dom_1.findChild)(checkBoxEl, "w14:checked");
+    if (checkedEl) {
+        const v = checkedEl.attributes["w14:val"] ?? checkedEl.attributes["val"];
+        cb.checked = v === "1" || v === "true";
+    }
+    const checkedStateEl = (0, dom_1.findChild)(checkBoxEl, "w14:checkedState");
+    if (checkedStateEl) {
+        cb.checkedState = {
+            value: checkedStateEl.attributes["w14:val"] ?? checkedStateEl.attributes["val"] ?? "",
+            font: checkedStateEl.attributes["w14:font"] ?? checkedStateEl.attributes["font"]
+        };
+    }
+    const uncheckedStateEl = (0, dom_1.findChild)(checkBoxEl, "w14:uncheckedState");
+    if (uncheckedStateEl) {
+        cb.uncheckedState = {
+            value: uncheckedStateEl.attributes["w14:val"] ?? uncheckedStateEl.attributes["val"] ?? "",
+            font: uncheckedStateEl.attributes["w14:font"] ?? uncheckedStateEl.attributes["font"]
+        };
+    }
+    return cb;
+}
+/**
+ * Parse a TOC field instruction string and populate the given TableOfContents object.
+ *
+ * Recognizes common TOC switches:
+ * - `\o "1-3"` — heading style range
+ * - `\h` — hyperlinks
+ * - `\c "label"` — caption label (table of figures)
+ * - `\s "id"` — sequence field identifier
+ * - `\p "."`/`"-"`/`"_"` — leader character
+ * - `\t "Style,Level;..."` — custom styles with levels
+ */
+function parseTocInstruction(instr, toc) {
+    const trimmed = instr.trim();
+    if (!/^TOC\b/i.test(trimmed)) {
+        return;
+    }
+    // Match switches: \<letter> followed by either "quoted" or non-quoted non-switch token.
+    // The next-switch boundary must be respected: an unquoted value cannot start with \.
+    const switchRe = /\\(\w)(?:\s+"([^"]*)"|\s+([^\\\s][^\s]*))?/g;
+    let match;
+    while ((match = switchRe.exec(trimmed)) !== null) {
+        const switchName = match[1].toLowerCase();
+        const value = match[2] ?? match[3];
+        switch (switchName) {
+            case "o": // Heading level range e.g. "1-3"
+                if (value) {
+                    toc.headingStyleRange = value;
+                }
+                break;
+            case "h": // Hyperlinks
+                toc.hyperlink = true;
+                break;
+            case "c": // Caption label (table of figures)
+                if (value) {
+                    toc.captionLabel = value;
+                }
+                break;
+            case "s": // Sequence field identifier
+                if (value) {
+                    toc.sequenceFieldIdentifier = value;
+                }
+                break;
+            case "p": // Page-number leader or style separator
+                if (value === "." || value === "-" || value === "_") {
+                    toc.leader = "dot";
+                    if (value === "-") {
+                        toc.leader = "hyphen";
+                    }
+                    else if (value === "_") {
+                        toc.leader = "underscore";
+                    }
+                }
+                break;
+            case "t": {
+                // Styles with levels: "StyleName1,Level1;StyleName2,Level2;..."
+                if (!value) {
+                    break;
+                }
+                const items = [];
+                for (const part of value.split(";")) {
+                    const [styleName, levelStr] = part.split(",");
+                    if (styleName && levelStr) {
+                        items.push({ styleName: styleName.trim(), level: parseInt(levelStr, 10) });
+                    }
+                }
+                if (items.length > 0) {
+                    toc.stylesWithLevels = items;
+                }
+                break;
+            }
+        }
+    }
+}

package/dist/cjs/modules/word/reader/settings-parser.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * DOCX Reader - Settings Parser
+ *
+ * Parses `word/settings.xml` (DocumentSettings).
+ * Extracted from the original `metadata-parsers.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSettingsXml = parseSettingsXml;
+const dom_1 = require("../../xml/dom.js");
+const parse_utils_1 = require("./parse-utils");
+function parseSettingsXml(xmlStr) {
+    const doc = (0, dom_1.parseXml)(xmlStr);
+    const root = doc.root;
+    const settings = {};
+    const zoomEl = (0, parse_utils_1.findChildNs)(root, "zoom");
+    if (zoomEl) {
+        settings.zoom = (0, parse_utils_1.attrInt)(zoomEl, "percent");
+    }
+    const tabEl = (0, parse_utils_1.findChildNs)(root, "defaultTabStop");
+    if (tabEl) {
+        settings.defaultTabStop = (0, parse_utils_1.attrInt)(tabEl, "val");
+    }
+    const csControlEl = (0, parse_utils_1.findChildNs)(root, "characterSpacingControl");
+    if (csControlEl) {
+        const v = (0, parse_utils_1.attrVal)(csControlEl, "val");
+        if (v === "doNotCompress" ||
+            v === "compressPunctuation" ||
+            v === "compressPunctuationAndJapaneseKana") {
+            settings.characterSpacingControl = v;
+        }
+    }
+    // Extended settings
+    if ((0, parse_utils_1.findChildNs)(root, "doNotTrackMoves")) {
+        settings.doNotTrackMoves = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "doNotTrackFormatting")) {
+        settings.doNotTrackFormatting = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "doNotDemoteNonCombiningChars")) {
+        settings.doNotDemoteAsianTextFirstLine = true;
+    }
+    const ssFontsEl = (0, parse_utils_1.findChildNs)(root, "saveSubsetFonts");
+    if (ssFontsEl) {
+        const v = (0, parse_utils_1.attrVal)(ssFontsEl, "val");
+        settings.saveSubsetFonts = v !== "0" && v !== "false";
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "noPunctuationKerning")) {
+        settings.noPunctuationKerning = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "bordersDoNotSurroundHeader")) {
+        settings.bordersDoNotSurroundHeader = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "bordersDoNotSurroundFooter")) {
+        settings.bordersDoNotSurroundFooter = true;
+    }
+    const clickStyleEl = (0, parse_utils_1.findChildNs)(root, "clickAndTypeStyle");
+    if (clickStyleEl) {
+        settings.clickAndTypeStyle = (0, parse_utils_1.attrVal)(clickStyleEl, "val");
+    }
+    const spfEl = (0, parse_utils_1.findChildNs)(root, "stylePaneFormatFilter");
+    if (spfEl) {
+        settings.stylePaneFormatFilter = (0, parse_utils_1.attrVal)(spfEl, "val");
+    }
+    const spsEl = (0, parse_utils_1.findChildNs)(root, "stylePaneSortMethod");
+    if (spsEl) {
+        settings.stylePaneSortMethod = (0, parse_utils_1.attrVal)(spsEl, "val");
+    }
+    const tflEl = (0, parse_utils_1.findChildNs)(root, "themeFontLang");
+    if (tflEl) {
+        const tfl = {};
+        const v = (0, parse_utils_1.attrVal)(tflEl, "val");
+        if (v) {
+            tfl.val = v;
+        }
+        const ea = (0, parse_utils_1.attrVal)(tflEl, "eastAsia");
+        if (ea) {
+            tfl.eastAsia = ea;
+        }
+        const bd = (0, parse_utils_1.attrVal)(tflEl, "bidi");
+        if (bd) {
+            tfl.bidi = bd;
+        }
+        if (Object.keys(tfl).length > 0) {
+            settings.themeFontLang = tfl;
+        }
+    }
+    const dsEl = (0, parse_utils_1.findChildNs)(root, "decimalSymbol");
+    if (dsEl) {
+        settings.decimalSymbol = (0, parse_utils_1.attrVal)(dsEl, "val");
+    }
+    const lsEl = (0, parse_utils_1.findChildNs)(root, "listSeparator");
+    if (lsEl) {
+        settings.listSeparator = (0, parse_utils_1.attrVal)(lsEl, "val");
+    }
+    // RSID list
+    const rsidsEl = (0, parse_utils_1.findChildNs)(root, "rsids");
+    if (rsidsEl) {
+        const rsids = {};
+        const rootEl = (0, parse_utils_1.findChildNs)(rsidsEl, "rsidRoot");
+        if (rootEl) {
+            rsids.rsidRoot = (0, parse_utils_1.attrVal)(rootEl, "val");
+        }
+        const rsidList = [];
+        for (const rsidEl of (0, parse_utils_1.findChildrenNs)(rsidsEl, "rsid")) {
+            const v = (0, parse_utils_1.attrVal)(rsidEl, "val");
+            if (v) {
+                rsidList.push(v);
+            }
+        }
+        if (rsidList.length > 0) {
+            rsids.rsid = rsidList;
+        }
+        if (Object.keys(rsids).length > 0) {
+            settings.rsids = rsids;
+        }
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "evenAndOddHeaders")) {
+        settings.evenAndOddHeaders = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "trackRevisions")) {
+        settings.trackRevisions = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "mirrorMargins")) {
+        settings.mirrorMargins = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "gutterAtTop")) {
+        settings.gutterAtTop = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "displayBackgroundShape")) {
+        settings.displayBackgroundShape = true;
+    }
+    if ((0, parse_utils_1.findChildNs)(root, "updateFields")) {
+        settings.updateFieldsOnOpen = true;
+    }
+    // Hyphenation
+    const autoHyphEl = (0, parse_utils_1.findChildNs)(root, "autoHyphenation");
+    if (autoHyphEl) {
+        settings.autoHyphenation = true;
+        const hyph = { autoHyphenation: true };
+        const hzEl = (0, parse_utils_1.findChildNs)(root, "hyphenationZone");
+        if (hzEl) {
+            hyph.hyphenationZone = (0, parse_utils_1.attrInt)(hzEl, "val");
+        }
+        const chlEl = (0, parse_utils_1.findChildNs)(root, "consecutiveHyphenLimit");
+        if (chlEl) {
+            hyph.consecutiveHyphenLimit = (0, parse_utils_1.attrInt)(chlEl, "val");
+        }
+        if ((0, parse_utils_1.findChildNs)(root, "doNotHyphenateCaps")) {
+            hyph.doNotHyphenateCaps = true;
+        }
+        settings.hyphenation = hyph;
+    }
+    // Document protection
+    const protEl = (0, parse_utils_1.findChildNs)(root, "documentProtection");
+    if (protEl) {
+        settings.documentProtection = {
+            type: ((0, parse_utils_1.attrVal)(protEl, "edit") ?? "none"),
+            edit: (0, parse_utils_1.attrVal)(protEl, "edit") ?? undefined,
+            enforcement: (0, parse_utils_1.attrVal)(protEl, "enforcement") === "1",
+            formatting: (0, parse_utils_1.attrVal)(protEl, "formatting") === "1" ? true : undefined,
+            hashAlgorithm: (0, parse_utils_1.sidToHashAlgorithm)((0, parse_utils_1.attrVal)(protEl, "cryptAlgorithmSid")),
+            hashValue: (0, parse_utils_1.attrVal)(protEl, "hash") ?? undefined,
+            saltValue: (0, parse_utils_1.attrVal)(protEl, "salt") ?? undefined,
+            spinCount: (0, parse_utils_1.attrVal)(protEl, "cryptSpinCount")
+                ? parseInt((0, parse_utils_1.attrVal)(protEl, "cryptSpinCount"), 10)
+                : undefined
+        };
+    }
+    const compatEl = (0, parse_utils_1.findChildNs)(root, "compat");
+    if (compatEl) {
+        const compatSettings = [];
+        const compatFlags = [];
+        for (const csEl of compatEl.children) {
+            if (csEl.type !== "element") {
+                continue;
+            }
+            const localName = csEl.name.replace(/^w:/, "");
+            if (localName === "compatSetting") {
+                const name = (0, parse_utils_1.attrVal)(csEl, "name");
+                const uri = (0, parse_utils_1.attrVal)(csEl, "uri");
+                const val = (0, parse_utils_1.attrVal)(csEl, "val");
+                if (name === "compatibilityMode" && val !== undefined) {
+                    settings.compatibilityMode = parseInt(val, 10);
+                }
+                else if (name !== undefined && uri !== undefined && val !== undefined) {
+                    compatSettings.push({ name, uri, val });
+                }
+            }
+            else {
+                // Legacy compat flags (w:useFELayout, w:balanceSingleByteDoubleByteWidth, etc.)
+                compatFlags.push({ name: localName, val: (0, parse_utils_1.attrVal)(csEl, "val") });
+            }
+        }
+        if (compatSettings.length > 0) {
+            settings.compatSettings = compatSettings;
+        }
+        if (compatFlags.length > 0) {
+            settings.compatFlags = compatFlags;
+        }
+    }
+    // Mail merge settings (preserve as raw XML)
+    const mailMergeEl = (0, parse_utils_1.findChildNs)(root, "mailMerge");
+    if (mailMergeEl) {
+        settings.mailMergeRawXml = (0, parse_utils_1.serializeElement)(mailMergeEl);
+    }
+    // Write protection
+    const writeProtectionEl = (0, parse_utils_1.findChildNs)(root, "writeProtection");
+    if (writeProtectionEl) {
+        const wp = {};
+        const wpMut = wp;
+        const recommended = (0, parse_utils_1.attrVal)(writeProtectionEl, "recommended");
+        if (recommended === "1" || recommended === "true") {
+            wpMut.recommended = true;
+        }
+        const algName = (0, parse_utils_1.attrVal)(writeProtectionEl, "algorithmName");
+        if (algName) {
+            wpMut.algorithmName = algName;
+        }
+        const hashValue = (0, parse_utils_1.attrVal)(writeProtectionEl, "hashValue");
+        if (hashValue) {
+            wpMut.hashValue = hashValue;
+        }
+        const saltValue = (0, parse_utils_1.attrVal)(writeProtectionEl, "saltValue");
+        if (saltValue) {
+            wpMut.saltValue = saltValue;
+        }
+        const spinCount = (0, parse_utils_1.attrInt)(writeProtectionEl, "spinCount");
+        if (spinCount !== undefined) {
+            wpMut.spinCount = spinCount;
+        }
+        settings.writeProtection = wp;
+    }
+    // Document variables
+    const docVarsEl = (0, parse_utils_1.findChildNs)(root, "docVars");
+    if (docVarsEl) {
+        const vars = new Map();
+        for (const dvEl of (0, parse_utils_1.findChildrenNs)(docVarsEl, "docVar")) {
+            const name = (0, parse_utils_1.attrVal)(dvEl, "name");
+            const val = (0, parse_utils_1.attrVal)(dvEl, "val");
+            if (name !== undefined && val !== undefined) {
+                vars.set(name, val);
+            }
+        }
+        if (vars.size > 0) {
+            settings.docVars = vars;
+        }
+    }
+    // Footnote/endnote properties at document level
+    const fnPrEl = (0, parse_utils_1.findChildNs)(root, "footnotePr");
+    if (fnPrEl) {
+        const fnProps = (0, parse_utils_1.parseNoteProperties)(fnPrEl);
+        if (fnProps) {
+            settings.footnoteProperties = fnProps;
+        }
+    }
+    const enPrEl = (0, parse_utils_1.findChildNs)(root, "endnotePr");
+    if (enPrEl) {
+        const enProps = (0, parse_utils_1.parseNoteProperties)(enPrEl);
+        if (enProps) {
+            settings.endnoteProperties = enProps;
+        }
+    }
+    return settings;
+}

package/dist/cjs/modules/word/reader/styles-parser.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * DOCX Reader - Styles Parser
+ *
+ * Parses `word/styles.xml` (`DocDefaults` + `StyleDef[]`). Splits out from
+ * the legacy `styles-numbering-parsers.ts` to mirror the writer side
+ * (`styles-writer.ts` and `numbering-writer.ts` are already separate).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStyles = parseStyles;
+const dom_1 = require("../../xml/dom.js");
+const paragraph_section_parsers_1 = require("./paragraph-section-parsers");
+const parse_utils_1 = require("./parse-utils");
+const properties_parsers_1 = require("./properties-parsers");
+const table_properties_parsers_1 = require("./table-properties-parsers");
+function parseStyles(xmlStr) {
+    const doc = (0, dom_1.parseXml)(xmlStr);
+    const root = doc.root;
+    let docDefaults;
+    const styles = [];
+    const ddEl = (0, parse_utils_1.findChildNs)(root, "docDefaults");
+    if (ddEl) {
+        const dd = {};
+        const rPrDefaultEl = (0, parse_utils_1.findChildNs)(ddEl, "rPrDefault");
+        if (rPrDefaultEl) {
+            const rPrEl = (0, parse_utils_1.findChildNs)(rPrDefaultEl, "rPr");
+            if (rPrEl) {
+                dd.runProperties = (0, properties_parsers_1.parseRunProperties)(rPrEl);
+            }
+        }
+        const pPrDefaultEl = (0, parse_utils_1.findChildNs)(ddEl, "pPrDefault");
+        if (pPrDefaultEl) {
+            const pPrEl = (0, parse_utils_1.findChildNs)(pPrDefaultEl, "pPr");
+            if (pPrEl) {
+                dd.paragraphProperties = (0, paragraph_section_parsers_1.parseParagraphProperties)(pPrEl);
+            }
+        }
+        docDefaults = dd;
+    }
+    for (const styleEl of (0, parse_utils_1.findChildrenNs)(root, "style")) {
+        const s = {};
+        s.type = (0, parse_utils_1.attrVal)(styleEl, "type");
+        s.styleId = (0, parse_utils_1.attrVal)(styleEl, "styleId") ?? "";
+        s.isDefault = (0, parse_utils_1.attrVal)(styleEl, "default") === "1";
+        if ((0, parse_utils_1.attrVal)(styleEl, "customStyle") === "1") {
+            s.customStyle = true;
+        }
+        const nameEl = (0, parse_utils_1.findChildNs)(styleEl, "name");
+        s.name = nameEl ? ((0, parse_utils_1.attrVal)(nameEl, "val") ?? "") : "";
+        const basedOnEl = (0, parse_utils_1.findChildNs)(styleEl, "basedOn");
+        if (basedOnEl) {
+            s.basedOn = (0, parse_utils_1.attrVal)(basedOnEl, "val");
+        }
+        const nextEl = (0, parse_utils_1.findChildNs)(styleEl, "next");
+        if (nextEl) {
+            s.next = (0, parse_utils_1.attrVal)(nextEl, "val");
+        }
+        const linkEl = (0, parse_utils_1.findChildNs)(styleEl, "link");
+        if (linkEl) {
+            s.link = (0, parse_utils_1.attrVal)(linkEl, "val");
+        }
+        const uiPrEl = (0, parse_utils_1.findChildNs)(styleEl, "uiPriority");
+        if (uiPrEl) {
+            s.uiPriority = (0, parse_utils_1.attrInt)(uiPrEl, "val");
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "qFormat")) {
+            s.qFormat = true;
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "semiHidden")) {
+            s.semiHidden = true;
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "unhideWhenUsed")) {
+            s.unhideWhenUsed = true;
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "hidden")) {
+            s.hidden = true;
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "locked")) {
+            s.locked = true;
+        }
+        if ((0, parse_utils_1.findChildNs)(styleEl, "autoRedefine")) {
+            s.autoRedefine = true;
+        }
+        const pPrEl = (0, parse_utils_1.findChildNs)(styleEl, "pPr");
+        if (pPrEl) {
+            s.paragraphProperties = (0, paragraph_section_parsers_1.parseParagraphProperties)(pPrEl);
+        }
+        const rPrEl = (0, parse_utils_1.findChildNs)(styleEl, "rPr");
+        if (rPrEl) {
+            s.runProperties = (0, properties_parsers_1.parseRunProperties)(rPrEl);
+        }
+        // Table properties for table styles
+        const tblPrEl = (0, parse_utils_1.findChildNs)(styleEl, "tblPr");
+        if (tblPrEl) {
+            s.tableProperties = (0, table_properties_parsers_1.parseTableProperties)(tblPrEl);
+        }
+        // Table style conditional formats
+        const tblStylePrs = (0, parse_utils_1.findChildrenNs)(styleEl, "tblStylePr");
+        if (tblStylePrs.length > 0) {
+            const conditions = [];
+            for (const tsp of tblStylePrs) {
+                const cond = {
+                    type: (0, parse_utils_1.attrVal)(tsp, "type")
+                };
+                const cpPr = (0, parse_utils_1.findChildNs)(tsp, "pPr");
+                if (cpPr) {
+                    cond.paragraphProperties = (0, paragraph_section_parsers_1.parseParagraphProperties)(cpPr);
+                }
+                const crPr = (0, parse_utils_1.findChildNs)(tsp, "rPr");
+                if (crPr) {
+                    cond.runProperties = (0, properties_parsers_1.parseRunProperties)(crPr);
+                }
+                const ctblPr = (0, parse_utils_1.findChildNs)(tsp, "tblPr");
+                if (ctblPr) {
+                    cond.tableProperties = (0, table_properties_parsers_1.parseTableProperties)(ctblPr);
+                }
+                const ctrPr = (0, parse_utils_1.findChildNs)(tsp, "trPr");
+                if (ctrPr) {
+                    const rp = {};
+                    const hEl = (0, parse_utils_1.findChildNs)(ctrPr, "trHeight");
+                    if (hEl) {
+                        rp.height = {
+                            value: (0, parse_utils_1.attrInt)(hEl, "val") ?? 0,
+                            rule: (0, parse_utils_1.attrVal)(hEl, "hRule")
+                        };
+                    }
+                    cond.rowProperties = rp;
+                }
+                const ctcPr = (0, parse_utils_1.findChildNs)(tsp, "tcPr");
+                if (ctcPr) {
+                    const cp = {};
+                    const bEl = (0, parse_utils_1.findChildNs)(ctcPr, "tcBorders");
+                    if (bEl) {
+                        cp.borders = (0, table_properties_parsers_1.parseTableBorders)(bEl);
+                    }
+                    const shd = (0, parse_utils_1.findChildNs)(ctcPr, "shd");
+                    if (shd) {
+                        cp.shading = (0, properties_parsers_1.parseShading)(shd);
+                    }
+                    cond.cellProperties = cp;
+                }
+                conditions.push(cond);
+            }
+            s.tableStyleConditions = conditions;
+        }
+        styles.push(s);
+    }
+    return { docDefaults, styles };
+}