@cj-tech-master/excelts 9.5.4 → 9.5.5

package/dist/cjs/modules/word/writers/document-writer.js

@@ -1,465 +0,0 @@
-"use strict";
-/**
- * DOCX Writers - Document Body
- *
- * Renders the main word/document.xml part including all block-level
- * content types: paragraphs, tables, floating images, TOC, math,
- * text boxes, and structured document tags.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHART_RID_REGISTRY = void 0;
-exports.renderDocument = renderDocument;
-const constants_1 = require("../constants");
-const checkbox_writer_1 = require("./checkbox-writer");
-const image_writer_1 = require("./image-writer");
-const math_writer_1 = require("./math-writer");
-const paragraph_writer_1 = require("./paragraph-writer");
-const parts_writer_1 = require("./parts-writer");
-const section_writer_1 = require("./section-writer");
-const table_writer_1 = require("./table-writer");
-const textbox_writer_1 = require("./textbox-writer");
-const toc_writer_1 = require("./toc-writer");
-/** Render a structured document tag. */
-function renderSdt(xml, sdt) {
-    xml.openNode("w:sdt");
-    if (sdt.properties) {
-        xml.openNode("w:sdtPr");
-        const p = sdt.properties;
-        // Auto-assign ID if not provided (Word strongly expects unique IDs)
-        const sdtId = p.id ?? nextAutoSdtId();
-        xml.leafNode("w:id", { "w:val": String(sdtId) });
-        if (p.tag) {
-            xml.leafNode("w:tag", { "w:val": p.tag });
-        }
-        if (p.alias) {
-            xml.leafNode("w:alias", { "w:val": p.alias });
-        }
-        // Lock: combine lockContent + lockSdt
-        if (p.lockContent && p.lockSdt) {
-            xml.leafNode("w:lock", { "w:val": "sdtContentLocked" });
-        }
-        else if (p.lockContent) {
-            xml.leafNode("w:lock", { "w:val": "contentLocked" });
-        }
-        else if (p.lockSdt) {
-            xml.leafNode("w:lock", { "w:val": "sdtLocked" });
-        }
-        // Appearance (w15:appearance for modern SDTs)
-        if (p.appearance) {
-            xml.leafNode("w15:appearance", { "w15:val": p.appearance });
-        }
-        else if (p.showAs) {
-            // Back-compat mapping of legacy showAs
-            const mapped = p.showAs === "boundingBox" ? "boundingBox" : p.showAs === "startEnd" ? "tags" : "hidden";
-            xml.leafNode("w15:appearance", { "w15:val": mapped });
-        }
-        // Show placeholder toggle
-        if (p.showingPlaceholder) {
-            xml.leafNode("w:showingPlcHdr");
-        }
-        if (p.placeholder) {
-            xml.openNode("w:placeholder");
-            xml.leafNode("w:docPart", { "w:val": p.placeholder });
-            xml.closeNode();
-        }
-        if (p.temporary) {
-            xml.leafNode("w:temporary");
-        }
-        if (p.dataBinding) {
-            const bindAttrs = {
-                "w:xpath": p.dataBinding.xpath,
-                "w:storeItemID": p.dataBinding.storeItemId
-            };
-            if (p.dataBinding.prefixMappings) {
-                bindAttrs["w:prefixMappings"] = p.dataBinding.prefixMappings;
-            }
-            xml.leafNode("w:dataBinding", bindAttrs);
-        }
-        // Type discriminator markers
-        if (p.plainText) {
-            xml.leafNode("w:text");
-        }
-        if (p.richText) {
-            xml.leafNode("w:richText");
-        }
-        if (p.picture) {
-            xml.leafNode("w:picture");
-        }
-        if (p.group) {
-            xml.leafNode("w:group");
-        }
-        if (p.equation) {
-            xml.leafNode("w:equation");
-        }
-        if (p.citation) {
-            xml.leafNode("w:citation");
-        }
-        if (p.bibliography) {
-            xml.leafNode("w:bibliography");
-        }
-        if (p.repeatingSectionItem) {
-            xml.leafNode("w15:repeatingSectionItem");
-        }
-        if (p.repeatingSection) {
-            // w15:repeatingSection has child elements (not attributes) per the schema
-            const rs = p.repeatingSection;
-            const hasChildren = rs.sectionTitle !== undefined || rs.allowInsertDelete !== undefined;
-            if (hasChildren) {
-                xml.openNode("w15:repeatingSection");
-                if (rs.sectionTitle !== undefined) {
-                    xml.leafNode("w15:sectionTitle", { "w15:val": rs.sectionTitle });
-                }
-                if (rs.allowInsertDelete === false) {
-                    xml.leafNode("w15:doNotAllowInsertDeleteSection");
-                }
-                xml.closeNode();
-            }
-            else {
-                xml.leafNode("w15:repeatingSection");
-            }
-        }
-        // Checkbox (w14 extension)
-        if (p.checkbox) {
-            xml.openNode("w14:checkbox");
-            xml.leafNode("w14:checked", p.checkbox.checked ? { "w14:val": "1" } : { "w14:val": "0" });
-            if (p.checkbox.checkedChar || p.checkbox.checkedFont) {
-                const cAttrs = {};
-                if (p.checkbox.checkedChar) {
-                    cAttrs["w14:val"] = p.checkbox.checkedChar;
-                }
-                if (p.checkbox.checkedFont) {
-                    cAttrs["w14:font"] = p.checkbox.checkedFont;
-                }
-                xml.leafNode("w14:checkedState", cAttrs);
-            }
-            if (p.checkbox.uncheckedChar || p.checkbox.uncheckedFont) {
-                const uAttrs = {};
-                if (p.checkbox.uncheckedChar) {
-                    uAttrs["w14:val"] = p.checkbox.uncheckedChar;
-                }
-                if (p.checkbox.uncheckedFont) {
-                    uAttrs["w14:font"] = p.checkbox.uncheckedFont;
-                }
-                xml.leafNode("w14:uncheckedState", uAttrs);
-            }
-            xml.closeNode();
-        }
-        // Dropdown list
-        if (p.dropdownList) {
-            xml.openNode("w:dropDownList");
-            for (const item of p.dropdownList) {
-                const attrs = { "w:value": item.value };
-                if (item.displayText) {
-                    attrs["w:displayText"] = item.displayText;
-                }
-                xml.leafNode("w:listItem", attrs);
-            }
-            xml.closeNode();
-        }
-        // ComboBox
-        if (p.comboBox) {
-            xml.openNode("w:comboBox");
-            for (const item of p.comboBox) {
-                const attrs = { "w:value": item.value };
-                if (item.displayText) {
-                    attrs["w:displayText"] = item.displayText;
-                }
-                xml.leafNode("w:listItem", attrs);
-            }
-            xml.closeNode();
-        }
-        // Date picker
-        if (p.date) {
-            const dateAttrs = {};
-            if (p.date.fullDate) {
-                dateAttrs["w:fullDate"] = p.date.fullDate;
-            }
-            xml.openNode("w:date", Object.keys(dateAttrs).length > 0 ? dateAttrs : undefined);
-            if (p.date.dateFormat) {
-                xml.leafNode("w:dateFormat", { "w:val": p.date.dateFormat });
-            }
-            if (p.date.lid) {
-                xml.leafNode("w:lid", { "w:val": p.date.lid });
-            }
-            if (p.date.storeMappedDataAs) {
-                xml.leafNode("w:storeMappedDataAs", { "w:val": p.date.storeMappedDataAs });
-            }
-            xml.closeNode();
-        }
-        xml.closeNode();
-    }
-    xml.openNode("w:sdtContent");
-    for (const child of sdt.content) {
-        if ("type" in child) {
-            if (child.type === "paragraph") {
-                (0, paragraph_writer_1.renderParagraph)(xml, child);
-            }
-            else if (child.type === "table") {
-                (0, table_writer_1.renderTable)(xml, child);
-            }
-        }
-    }
-    xml.closeNode();
-    xml.closeNode();
-}
-/** Render a block-level content element. */
-function renderBodyContent(xml, content) {
-    switch (content.type) {
-        case "paragraph":
-            (0, paragraph_writer_1.renderParagraph)(xml, content);
-            break;
-        case "table":
-            (0, table_writer_1.renderTable)(xml, content);
-            break;
-        case "floatingImage":
-            (0, image_writer_1.renderFloatingImage)(xml, content);
-            break;
-        case "tableOfContents":
-            (0, toc_writer_1.renderTableOfContents)(xml, content);
-            break;
-        case "math":
-            (0, math_writer_1.renderMathBlock)(xml, content);
-            break;
-        case "textBox":
-            (0, textbox_writer_1.renderTextBox)(xml, content);
-            break;
-        case "sdt":
-            renderSdt(xml, content);
-            break;
-        case "checkBox":
-            (0, checkbox_writer_1.renderCheckBox)(xml, content);
-            break;
-        case "drawingShape":
-            renderDrawingShape(xml, content);
-            break;
-        case "opaqueDrawing":
-            renderOpaqueDrawing(xml, content);
-            break;
-        case "chart":
-            renderChartDrawing(xml, content);
-            break;
-        case "altChunk":
-            xml.leafNode("w:altChunk", { "r:id": content.rId });
-            break;
-    }
-}
-/** Render the complete word/document.xml. */
-function renderDocument(xml, doc) {
-    xml.openXml(constants_1.STD_DOC_ATTRIBUTES);
-    xml.openNode("w:document", constants_1.DOCUMENT_NAMESPACES);
-    // Document background (must come before w:body)
-    if (doc.background) {
-        (0, parts_writer_1.renderDocumentBackground)(xml, doc.background);
-    }
-    xml.openNode("w:body");
-    for (const content of doc.body) {
-        renderBodyContent(xml, content);
-    }
-    // Final section properties (goes directly in w:body)
-    if (doc.sectionProperties) {
-        (0, section_writer_1.renderSectionProperties)(xml, doc.sectionProperties);
-    }
-    xml.closeNode(); // w:body
-    xml.closeNode(); // w:document
-}
-// =============================================================================
-// DrawingML Shape Writer
-// =============================================================================
-function renderDrawingShape(xml, shape) {
-    // If rawXml is available, use it for round-trip fidelity
-    if (shape.rawXml) {
-        xml.writeRaw(shape.rawXml);
-        return;
-    }
-    // Wrap in w:p > w:r > w:drawing > wp:anchor > a:graphic > a:graphicData > wps:wsp
-    xml.openNode("w:p");
-    xml.openNode("w:r");
-    xml.openNode("w:drawing");
-    const anchorAttrs = {
-        distT: "0",
-        distB: "0",
-        distL: "114300",
-        distR: "114300",
-        simplePos: "0",
-        relativeHeight: "251658240",
-        behindDoc: shape.behindDoc ? "1" : "0",
-        locked: "0",
-        layoutInCell: "1",
-        allowOverlap: "1"
-    };
-    xml.openNode("wp:anchor", anchorAttrs);
-    xml.leafNode("wp:simplePos", { x: "0", y: "0" });
-    // Horizontal position
-    const hp = shape.horizontalPosition;
-    xml.openNode("wp:positionH", {
-        relativeFrom: hp?.relativeTo ?? "column"
-    });
-    if (hp?.align) {
-        xml.openNode("wp:align");
-        xml.writeText(hp.align);
-        xml.closeNode();
-    }
-    else {
-        xml.openNode("wp:posOffset");
-        xml.writeText(String(hp?.offset ?? 0));
-        xml.closeNode();
-    }
-    xml.closeNode(); // wp:positionH
-    // Vertical position
-    const vp = shape.verticalPosition;
-    xml.openNode("wp:positionV", {
-        relativeFrom: vp?.relativeTo ?? "paragraph"
-    });
-    if (vp?.align) {
-        xml.openNode("wp:align");
-        xml.writeText(vp.align);
-        xml.closeNode();
-    }
-    else {
-        xml.openNode("wp:posOffset");
-        xml.writeText(String(vp?.offset ?? 0));
-        xml.closeNode();
-    }
-    xml.closeNode(); // wp:positionV
-    xml.leafNode("wp:extent", {
-        cx: String(shape.width),
-        cy: String(shape.height)
-    });
-    xml.leafNode("wp:effectExtent", { l: "0", t: "0", r: "0", b: "0" });
-    // Wrap
-    const wrap = shape.wrap;
-    if (!wrap || wrap.style === "none") {
-        xml.leafNode("wp:wrapNone");
-    }
-    else if (wrap.style === "square") {
-        xml.leafNode("wp:wrapSquare", { wrapText: wrap.side ?? "bothSides" });
-    }
-    else if (wrap.style === "tight") {
-        xml.leafNode("wp:wrapTight", { wrapText: wrap.side ?? "bothSides" });
-    }
-    else if (wrap.style === "topAndBottom") {
-        xml.leafNode("wp:wrapTopAndBottom");
-    }
-    const docPrAttrs = { id: "1", name: shape.name ?? "Shape" };
-    if (shape.altText) {
-        docPrAttrs["descr"] = shape.altText;
-    }
-    xml.leafNode("wp:docPr", docPrAttrs);
-    xml.openNode("a:graphic", { "xmlns:a": constants_1.NS_A });
-    xml.openNode("a:graphicData", { uri: constants_1.NS_WPS });
-    xml.openNode("wps:wsp");
-    // Shape properties
-    xml.openNode("wps:spPr");
-    // Transform
-    xml.openNode("a:xfrm", shape.rotation ? { rot: String(shape.rotation) } : {});
-    xml.leafNode("a:off", { x: "0", y: "0" });
-    xml.leafNode("a:ext", { cx: String(shape.width), cy: String(shape.height) });
-    xml.closeNode(); // a:xfrm
-    // Preset geometry
-    xml.openNode("a:prstGeom", { prst: shape.shapeType });
-    xml.leafNode("a:avLst");
-    xml.closeNode(); // a:prstGeom
-    // Fill
-    if (shape.noFill) {
-        xml.leafNode("a:noFill");
-    }
-    else if (shape.fillColor) {
-        xml.openNode("a:solidFill");
-        xml.leafNode("a:srgbClr", { val: shape.fillColor });
-        xml.closeNode();
-    }
-    // Outline
-    const lnAttrs = {};
-    if (shape.outlineWidth) {
-        lnAttrs["w"] = String(shape.outlineWidth);
-    }
-    if (shape.outlineColor || shape.noOutline) {
-        xml.openNode("a:ln", lnAttrs);
-        if (shape.noOutline) {
-            xml.leafNode("a:noFill");
-        }
-        else if (shape.outlineColor) {
-            xml.openNode("a:solidFill");
-            xml.leafNode("a:srgbClr", { val: shape.outlineColor });
-            xml.closeNode();
-        }
-        xml.closeNode(); // a:ln
-    }
-    xml.closeNode(); // wps:spPr
-    // Text body
-    if (shape.textContent && shape.textContent.length > 0) {
-        xml.openNode("wps:txbx");
-        xml.openNode("w:txbxContent");
-        for (const para of shape.textContent) {
-            (0, paragraph_writer_1.renderParagraph)(xml, para);
-        }
-        xml.closeNode(); // w:txbxContent
-        xml.closeNode(); // wps:txbx
-    }
-    // Body properties (required)
-    xml.leafNode("wps:bodyPr");
-    xml.closeNode(); // wps:wsp
-    xml.closeNode(); // a:graphicData
-    xml.closeNode(); // a:graphic
-    xml.closeNode(); // wp:anchor
-    xml.closeNode(); // w:drawing
-    xml.closeNode(); // w:r
-    xml.closeNode(); // w:p
-}
-// =============================================================================
-// Opaque Drawing Writer
-// =============================================================================
-function renderOpaqueDrawing(xml, drawing) {
-    xml.openNode("w:p");
-    xml.openNode("w:r");
-    xml.writeRaw(drawing.rawXml);
-    xml.closeNode(); // w:r
-    xml.closeNode(); // w:p
-}
-// =============================================================================
-// Chart Drawing Writer (inline chart reference)
-// =============================================================================
-/**
- * Registry mapping ChartContent → rId. Populated by packager before rendering.
- * Uses a WeakMap so chart contents can be garbage collected.
- */
-exports.CHART_RID_REGISTRY = new WeakMap();
-/** Auto-incrementing SDT ID counter. */
-let _autoSdtIdCounter = 100000000;
-function nextAutoSdtId() {
-    return _autoSdtIdCounter++;
-}
-function renderChartDrawing(xml, content) {
-    const rId = exports.CHART_RID_REGISTRY.get(content) ?? "rId0";
-    const cx = content.chart.width ?? 5486400; // 6 inches default
-    const cy = content.chart.height ?? 3200400; // 3.5 inches default
-    xml.openNode("w:p");
-    xml.openNode("w:r");
-    xml.openNode("w:drawing");
-    xml.openNode("wp:inline", { distT: "0", distB: "0", distL: "0", distR: "0" });
-    xml.leafNode("wp:extent", { cx: String(cx), cy: String(cy) });
-    xml.leafNode("wp:effectExtent", { l: "0", t: "0", r: "0", b: "0" });
-    xml.leafNode("wp:docPr", {
-        id: "1",
-        name: content.name ?? "Chart",
-        ...(content.altText ? { descr: content.altText } : {})
-    });
-    xml.leafNode("wp:cNvGraphicFramePr");
-    xml.openNode("a:graphic", {
-        "xmlns:a": "http://schemas.openxmlformats.org/drawingml/2006/main"
-    });
-    xml.openNode("a:graphicData", {
-        uri: "http://schemas.openxmlformats.org/drawingml/2006/chart"
-    });
-    xml.leafNode("c:chart", {
-        "xmlns:c": "http://schemas.openxmlformats.org/drawingml/2006/chart",
-        "xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
-        "r:id": rId
-    });
-    xml.closeNode(); // a:graphicData
-    xml.closeNode(); // a:graphic
-    xml.closeNode(); // wp:inline
-    xml.closeNode(); // w:drawing
-    xml.closeNode(); // w:r
-    xml.closeNode(); // w:p
-}

package/dist/esm/modules/word/color-utils.js

@@ -1,94 +0,0 @@
-/**
- * DOCX Module - Theme Color Utilities
- *
- * Resolves OOXML theme colors with tint/shade transformations.
- * Extracted to a standalone file so that html-renderer and document.ts
- * can both import it without creating circular heavy dependencies.
- */
-/**
- * Map OOXML theme color attribute names to theme color scheme keys.
- * Word uses different names in run/paragraph properties vs the theme XML.
- */
-const THEME_COLOR_MAP = {
-    dark1: "dk1",
-    light1: "lt1",
-    dark2: "dk2",
-    light2: "lt2",
-    accent1: "accent1",
-    accent2: "accent2",
-    accent3: "accent3",
-    accent4: "accent4",
-    accent5: "accent5",
-    accent6: "accent6",
-    hyperlink: "hlink",
-    followedHyperlink: "folHlink",
-    // Direct names also work
-    dk1: "dk1",
-    lt1: "lt1",
-    dk2: "dk2",
-    lt2: "lt2",
-    hlink: "hlink",
-    folHlink: "folHlink"
-};
-/**
- * Resolve a ColorSpec to an actual hex RGB color using the document theme.
- *
- * Applies theme color lookup + tint/shade transformations per OOXML spec.
- *
- * @param color - The color value (HexColor string or ColorSpec).
- * @param theme - The document theme (from `doc.theme`).
- * @returns Resolved hex color string (6 chars, no #), or undefined if unresolvable.
- */
-export function resolveThemeColor(color, theme) {
-    if (color === undefined) {
-        return undefined;
-    }
-    if (typeof color === "string") {
-        return color;
-    }
-    // ColorSpec with val — use directly
-    if (color.val && color.val !== "auto") {
-        return color.val;
-    }
-    // Resolve via theme
-    if (!color.themeColor || !theme) {
-        return color.val;
-    }
-    const key = THEME_COLOR_MAP[color.themeColor] ?? color.themeColor;
-    const base = theme.colorScheme.colors[key];
-    if (!base) {
-        return color.val;
-    }
-    // Apply tint or shade
-    if (color.themeTint) {
-        return applyTint(base, parseInt(color.themeTint, 16) / 255);
-    }
-    if (color.themeShade) {
-        return applyShade(base, parseInt(color.themeShade, 16) / 255);
-    }
-    return base;
-}
-/** Apply tint to a hex color. tint=1 → white, tint=0 → original. */
-function applyTint(hex, tint) {
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
-    const nr = Math.round(r + (255 - r) * tint);
-    const ng = Math.round(g + (255 - g) * tint);
-    const nb = Math.round(b + (255 - b) * tint);
-    return toHex2(nr) + toHex2(ng) + toHex2(nb);
-}
-/** Apply shade to a hex color. shade=1 → original, shade=0 → black. */
-function applyShade(hex, shade) {
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
-    const nr = Math.round(r * shade);
-    const ng = Math.round(g * shade);
-    const nb = Math.round(b * shade);
-    return toHex2(nr) + toHex2(ng) + toHex2(nb);
-}
-function toHex2(n) {
-    const h = Math.max(0, Math.min(255, n)).toString(16);
-    return h.length < 2 ? "0" + h : h;
-}