@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/esm/modules/word/writers/header-footer-writer.js

@@ -0,0 +1,129 @@
+/**
+ * DOCX Writers - Headers & Footers
+ *
+ * Renders word/header{N}.xml and word/footer{N}.xml parts.
+ */
+import { NS_W, NS_R, NS_V, NS_O, NS_W10, STD_DOC_ATTRIBUTES } from "../constants.js";
+import { renderParagraph } from "./paragraph-writer.js";
+import { renderTable } from "./table-writer.js";
+/** Render content blocks (shared between header and footer). */
+function renderContent(xml, content) {
+    for (const child of content.children) {
+        if (child.type === "paragraph") {
+            renderParagraph(xml, child);
+        }
+        else if (child.type === "table") {
+            renderTable(xml, child);
+        }
+    }
+}
+/** Render a header part (word/header{N}.xml). */
+export function renderHeader(xml, content) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:hdr", {
+        "xmlns:w": NS_W,
+        "xmlns:r": NS_R
+    });
+    renderContent(xml, content);
+    xml.closeNode();
+}
+/** Render a footer part (word/footer{N}.xml). */
+export function renderFooter(xml, content) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:ftr", {
+        "xmlns:w": NS_W,
+        "xmlns:r": NS_R
+    });
+    renderContent(xml, content);
+    xml.closeNode();
+}
+/** Render a header part containing a watermark. */
+export function renderWatermarkHeader(xml, watermark, imageRId) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:hdr", {
+        "xmlns:w": NS_W,
+        "xmlns:r": NS_R,
+        "xmlns:v": NS_V,
+        "xmlns:o": NS_O,
+        "xmlns:w10": NS_W10
+    });
+    // Watermark goes in a paragraph with a single pict run
+    xml.openNode("w:p");
+    xml.openNode("w:pPr");
+    xml.openNode("w:pStyle");
+    xml.closeNode();
+    xml.closeNode(); // pPr
+    xml.openNode("w:r");
+    xml.openNode("w:pict");
+    if (watermark.type === "text") {
+        renderTextWatermarkVml(xml, watermark);
+    }
+    else {
+        renderImageWatermarkVml(xml, watermark, imageRId);
+    }
+    xml.closeNode(); // pict
+    xml.closeNode(); // r
+    xml.closeNode(); // p
+    xml.closeNode(); // hdr
+}
+function renderTextWatermarkVml(xml, wm) {
+    const color = wm.color ?? "C0C0C0";
+    const font = wm.font ?? "Calibri";
+    const fontSize = wm.fontSize ?? 1; // half-points; Word uses pt string in style
+    const fontPt = fontSize / 2;
+    const rotation = wm.rotation ?? -45;
+    const opacity = wm.semiTransparent !== false ? ".5" : "1";
+    // VML shape for text watermark (PowerWash / WASHOUT style)
+    xml.leafNode("v:shapetype", {
+        id: "_x0000_t136",
+        coordsize: "21600,21600",
+        "o:spt": "136",
+        path: "m@7,l@8,m@5,21600l@6,21600e"
+    });
+    const style = `position:absolute;margin-left:0;margin-top:0;width:468pt;height:234pt;` +
+        `rotation:${rotation};z-index:-251658752;mso-position-horizontal:center;` +
+        `mso-position-horizontal-relative:margin;mso-position-vertical:center;` +
+        `mso-position-vertical-relative:margin`;
+    xml.openNode("v:shape", {
+        id: "PowerPlusWaterMarkObject",
+        "o:spid": "_x0000_s2049",
+        type: "#_x0000_t136",
+        style,
+        "o:allowincell": "f",
+        fillcolor: `#${color}`,
+        stroked: "f"
+    });
+    xml.leafNode("v:fill", { opacity });
+    xml.leafNode("v:textpath", {
+        style: `font-family:"${font}";font-size:${fontPt}pt`,
+        string: wm.text
+    });
+    xml.leafNode("w10:wrap", { anchorx: "margin", anchory: "margin" });
+    xml.closeNode(); // v:shape
+}
+function renderImageWatermarkVml(xml, wm, rId) {
+    const scale = wm.scale ?? 100;
+    const rid = rId ?? wm.rId;
+    const style = `position:absolute;margin-left:0;margin-top:0;width:0;height:0;` +
+        `z-index:-251658752;mso-position-horizontal:center;` +
+        `mso-position-horizontal-relative:margin;mso-position-vertical:center;` +
+        `mso-position-vertical-relative:margin`;
+    xml.openNode("v:shape", {
+        id: "PowerPlusWaterMarkObject",
+        "o:spid": "_x0000_s2050",
+        type: "",
+        style,
+        "o:allowincell": "f"
+    });
+    const gain = wm.washout !== false ? "19661f" : "65536f";
+    const blacklevel = wm.washout !== false ? "22938f" : "0";
+    xml.leafNode("v:imagedata", {
+        "r:id": rid,
+        "o:title": "",
+        gain,
+        blacklevel,
+        ...(scale !== 100 ? { "o:detectmouseclick": "t" } : {})
+    });
+    xml.leafNode("w10:wrap", { anchorx: "margin", anchory: "margin" });
+    xml.closeNode(); // v:shape
+}

package/dist/esm/modules/word/writers/image-writer.js

@@ -0,0 +1,185 @@
+/**
+ * DOCX Writers - Floating Image
+ *
+ * Renders wp:anchor elements for floating (non-inline) images
+ * with full support for rotation, flip, lock anchor, outline, and wrap margins.
+ */
+import { NS_A, NS_PIC, URI_PIC, NS_ASVG, GUID_SVG } from "../constants.js";
+/** Render a floating image as a standalone paragraph with wp:anchor. */
+export function renderFloatingImage(xml, img) {
+    const drawingId = img.drawingId ?? 1;
+    const name = img.name ?? "Picture";
+    xml.openNode("w:p");
+    xml.openNode("w:r");
+    xml.openNode("w:drawing");
+    // Wrap margins
+    const wrapMargins = img.wrap?.margins;
+    xml.openNode("wp:anchor", {
+        distT: String(img.distT ?? wrapMargins?.top ?? 0),
+        distB: String(img.distB ?? wrapMargins?.bottom ?? 0),
+        distL: String(img.distL ?? wrapMargins?.left ?? 114300),
+        distR: String(img.distR ?? wrapMargins?.right ?? 114300),
+        simplePos: img.simplePos ? "1" : "0",
+        relativeHeight: String(img.relativeHeight ?? 251658240),
+        behindDoc: img.behindDoc ? "1" : "0",
+        locked: img.lockAnchor ? "1" : "0",
+        layoutInCell: img.layoutInCell === false ? "0" : "1",
+        allowOverlap: img.allowOverlap === false ? "0" : "1"
+    });
+    xml.leafNode("wp:simplePos", {
+        x: String(img.simplePos?.x ?? 0),
+        y: String(img.simplePos?.y ?? 0)
+    });
+    // Horizontal position
+    {
+        const hp = img.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();
+    }
+    // Vertical position
+    {
+        const vp = img.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();
+    }
+    xml.leafNode("wp:extent", { cx: String(img.width), cy: String(img.height) });
+    xml.leafNode("wp:effectExtent", { l: "0", t: "0", r: "0", b: "0" });
+    // Wrapping
+    if (img.wrap) {
+        switch (img.wrap.style) {
+            case "square":
+                xml.leafNode("wp:wrapSquare", { wrapText: img.wrap.side ?? "bothSides" });
+                break;
+            case "tight":
+                xml.leafNode("wp:wrapTight", { wrapText: img.wrap.side ?? "bothSides" });
+                break;
+            case "through":
+                xml.leafNode("wp:wrapThrough", { wrapText: img.wrap.side ?? "bothSides" });
+                break;
+            case "topAndBottom":
+                xml.leafNode("wp:wrapTopAndBottom");
+                break;
+            case "none":
+                xml.leafNode("wp:wrapNone");
+                break;
+        }
+    }
+    else {
+        xml.leafNode("wp:wrapNone");
+    }
+    xml.leafNode("wp:docPr", {
+        id: String(drawingId),
+        name,
+        ...(img.altText ? { descr: img.altText } : {})
+    });
+    xml.openNode("wp:cNvGraphicFramePr");
+    xml.leafNode("a:graphicFrameLocks", { "xmlns:a": NS_A, noChangeAspect: "1" });
+    xml.closeNode();
+    xml.openNode("a:graphic", { "xmlns:a": NS_A });
+    xml.openNode("a:graphicData", { uri: URI_PIC });
+    xml.openNode("pic:pic", { "xmlns:pic": NS_PIC });
+    xml.openNode("pic:nvPicPr");
+    xml.leafNode("pic:cNvPr", { id: String(drawingId), name });
+    xml.leafNode("pic:cNvPicPr");
+    xml.closeNode();
+    xml.openNode("pic:blipFill");
+    if (img.svgRId) {
+        // SVG with raster fallback: a:blip has extLst with asvg:svgBlip
+        xml.openNode("a:blip", { "r:embed": img.rId });
+        xml.openNode("a:extLst");
+        xml.openNode("a:ext", { uri: GUID_SVG });
+        xml.leafNode("asvg:svgBlip", {
+            "xmlns:asvg": NS_ASVG,
+            "r:embed": img.svgRId
+        });
+        xml.closeNode(); // a:ext
+        xml.closeNode(); // a:extLst
+        xml.closeNode(); // a:blip
+    }
+    else {
+        xml.leafNode("a:blip", { "r:embed": img.rId });
+    }
+    // Source rectangle (crop)
+    if (img.srcRect) {
+        const sr = img.srcRect;
+        const srAttrs = {};
+        if (sr.l !== undefined) {
+            srAttrs["l"] = String(sr.l);
+        }
+        if (sr.t !== undefined) {
+            srAttrs["t"] = String(sr.t);
+        }
+        if (sr.r !== undefined) {
+            srAttrs["r"] = String(sr.r);
+        }
+        if (sr.b !== undefined) {
+            srAttrs["b"] = String(sr.b);
+        }
+        xml.leafNode("a:srcRect", srAttrs);
+    }
+    xml.openNode("a:stretch");
+    xml.leafNode("a:fillRect");
+    xml.closeNode();
+    xml.closeNode();
+    xml.openNode("pic:spPr");
+    // Transform with rotation/flip
+    const xfrmAttrs = {};
+    if (img.rotation) {
+        xfrmAttrs["rot"] = String(img.rotation);
+    }
+    if (img.flipHorizontal) {
+        xfrmAttrs["flipH"] = "1";
+    }
+    if (img.flipVertical) {
+        xfrmAttrs["flipV"] = "1";
+    }
+    xml.openNode("a:xfrm", Object.keys(xfrmAttrs).length > 0 ? xfrmAttrs : undefined);
+    xml.leafNode("a:off", { x: "0", y: "0" });
+    xml.leafNode("a:ext", { cx: String(img.width), cy: String(img.height) });
+    xml.closeNode();
+    xml.openNode("a:prstGeom", { prst: "rect" });
+    xml.leafNode("a:avLst");
+    xml.closeNode();
+    // Outline
+    if (img.outline) {
+        const lnAttrs = {};
+        if (img.outline.width !== undefined) {
+            lnAttrs["w"] = String(img.outline.width);
+        }
+        xml.openNode("a:ln", Object.keys(lnAttrs).length > 0 ? lnAttrs : undefined);
+        if (img.outline.color) {
+            xml.openNode("a:solidFill");
+            xml.leafNode("a:srgbClr", { val: img.outline.color });
+            xml.closeNode();
+        }
+        xml.closeNode();
+    }
+    xml.closeNode(); // pic:spPr
+    xml.closeNode(); // pic:pic
+    xml.closeNode(); // a:graphicData
+    xml.closeNode(); // a:graphic
+    xml.closeNode(); // wp:anchor
+    xml.closeNode(); // w:drawing
+    xml.closeNode(); // w:r
+    xml.closeNode(); // w:p
+}