@cj-tech-master/excelts 9.4.2 → 9.5.0

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

@@ -0,0 +1,660 @@
+/**
+ * DOCX Writers - Settings, Font Table, Core Properties, App Properties,
+ * Theme, Document Background, Custom Properties
+ *
+ * Renders various auxiliary parts of the DOCX package.
+ */
+import { NS_W, NS_R, NS_M, NS_V, NS_O, NS_W14, NS_DC, NS_DCTERMS, NS_DCMITYPE, NS_CP, NS_EP, NS_VT, NS_XSI, NS_CUSTOM, STD_DOC_ATTRIBUTES } from "../constants.js";
+/** Render footnote/endnote properties in settings. */
+function renderSettingsNoteProperties(xml, tagName, props) {
+    xml.openNode(tagName);
+    if (props.position) {
+        xml.leafNode("w:pos", { "w:val": props.position });
+    }
+    if (props.numFmt) {
+        xml.leafNode("w:numFmt", { "w:val": props.numFmt });
+    }
+    if (props.numStart !== undefined) {
+        xml.leafNode("w:numStart", { "w:val": String(props.numStart) });
+    }
+    if (props.numRestart) {
+        xml.leafNode("w:numRestart", { "w:val": props.numRestart });
+    }
+    xml.closeNode();
+}
+// =============================================================================
+// Settings
+// =============================================================================
+/** Render word/settings.xml. */
+export function renderSettings(xml, settings) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:settings", {
+        "xmlns:w": NS_W,
+        "xmlns:m": NS_M,
+        "xmlns:r": NS_R,
+        "xmlns:w14": NS_W14,
+        "xmlns:o": NS_O,
+        "xmlns:v": NS_V
+    });
+    if (settings?.zoom) {
+        xml.leafNode("w:zoom", { "w:percent": String(settings.zoom) });
+    }
+    if (settings?.mirrorMargins) {
+        xml.leafNode("w:mirrorMargins");
+    }
+    if (settings?.gutterAtTop) {
+        xml.leafNode("w:gutterAtTop");
+    }
+    if (settings?.trackRevisions) {
+        xml.leafNode("w:trackRevisions");
+    }
+    if (settings?.evenAndOddHeaders) {
+        xml.leafNode("w:evenAndOddHeaders");
+    }
+    xml.leafNode("w:defaultTabStop", { "w:val": String(settings?.defaultTabStop ?? 720) });
+    xml.leafNode("w:characterSpacingControl", {
+        "w:val": settings?.characterSpacingControl ?? "doNotCompress"
+    });
+    // Extended settings flags
+    if (settings?.doNotTrackMoves) {
+        xml.leafNode("w:doNotTrackMoves");
+    }
+    if (settings?.doNotTrackFormatting) {
+        xml.leafNode("w:doNotTrackFormatting");
+    }
+    if (settings?.doNotDemoteAsianTextFirstLine) {
+        xml.leafNode("w:doNotDemoteNonCombiningChars");
+    }
+    if (settings?.saveSubsetFonts) {
+        xml.leafNode("w:saveSubsetFonts", { "w:val": "1" });
+    }
+    if (settings?.noPunctuationKerning) {
+        xml.leafNode("w:noPunctuationKerning");
+    }
+    if (settings?.bordersDoNotSurroundHeader) {
+        xml.leafNode("w:bordersDoNotSurroundHeader");
+    }
+    if (settings?.bordersDoNotSurroundFooter) {
+        xml.leafNode("w:bordersDoNotSurroundFooter");
+    }
+    if (settings?.clickAndTypeStyle) {
+        xml.leafNode("w:clickAndTypeStyle", { "w:val": settings.clickAndTypeStyle });
+    }
+    if (settings?.stylePaneFormatFilter) {
+        xml.leafNode("w:stylePaneFormatFilter", {
+            "w:val": settings.stylePaneFormatFilter
+        });
+    }
+    if (settings?.stylePaneSortMethod) {
+        xml.leafNode("w:stylePaneSortMethod", { "w:val": settings.stylePaneSortMethod });
+    }
+    if (settings?.themeFontLang) {
+        const attrs = {};
+        if (settings.themeFontLang.val) {
+            attrs["w:val"] = settings.themeFontLang.val;
+        }
+        if (settings.themeFontLang.eastAsia) {
+            attrs["w:eastAsia"] = settings.themeFontLang.eastAsia;
+        }
+        if (settings.themeFontLang.bidi) {
+            attrs["w:bidi"] = settings.themeFontLang.bidi;
+        }
+        if (Object.keys(attrs).length > 0) {
+            xml.leafNode("w:themeFontLang", attrs);
+        }
+    }
+    if (settings?.decimalSymbol !== undefined) {
+        xml.leafNode("w:decimalSymbol", { "w:val": settings.decimalSymbol });
+    }
+    if (settings?.listSeparator !== undefined) {
+        xml.leafNode("w:listSeparator", { "w:val": settings.listSeparator });
+    }
+    // RSID list (revision save IDs)
+    if (settings?.rsids) {
+        xml.openNode("w:rsids");
+        if (settings.rsids.rsidRoot) {
+            xml.leafNode("w:rsidRoot", { "w:val": settings.rsids.rsidRoot });
+        }
+        if (settings.rsids.rsid) {
+            for (const id of settings.rsids.rsid) {
+                xml.leafNode("w:rsid", { "w:val": id });
+            }
+        }
+        xml.closeNode();
+    }
+    // Hyphenation
+    if (settings?.autoHyphenation || settings?.hyphenation?.autoHyphenation) {
+        xml.leafNode("w:autoHyphenation");
+    }
+    if (settings?.hyphenation) {
+        const h = settings.hyphenation;
+        if (h.consecutiveHyphenLimit !== undefined) {
+            xml.leafNode("w:consecutiveHyphenLimit", { "w:val": String(h.consecutiveHyphenLimit) });
+        }
+        if (h.hyphenationZone !== undefined) {
+            xml.leafNode("w:hyphenationZone", { "w:val": String(h.hyphenationZone) });
+        }
+        if (h.doNotHyphenateCaps) {
+            xml.leafNode("w:doNotHyphenateCaps");
+        }
+    }
+    // Document protection
+    if (settings?.documentProtection) {
+        const dp = settings.documentProtection;
+        const attrs = { "w:edit": dp.type };
+        if (dp.enforcement !== undefined) {
+            attrs["w:enforcement"] = dp.enforcement ? "1" : "0";
+        }
+        xml.leafNode("w:documentProtection", attrs);
+    }
+    // Display background shape
+    if (settings?.displayBackgroundShape) {
+        xml.leafNode("w:displayBackgroundShape");
+    }
+    // Update fields on open
+    if (settings?.updateFieldsOnOpen) {
+        xml.leafNode("w:updateFields", { "w:val": "true" });
+    }
+    // Document variables
+    if (settings?.docVars && settings.docVars.size > 0) {
+        xml.openNode("w:docVars");
+        for (const [name, val] of settings.docVars) {
+            xml.leafNode("w:docVar", { "w:name": name, "w:val": val });
+        }
+        xml.closeNode();
+    }
+    // Footnote/endnote properties
+    if (settings?.footnoteProperties) {
+        renderSettingsNoteProperties(xml, "w:footnotePr", settings.footnoteProperties);
+    }
+    if (settings?.endnoteProperties) {
+        renderSettingsNoteProperties(xml, "w:endnotePr", settings.endnoteProperties);
+    }
+    // Mail merge (round-trip preservation)
+    if (settings?.mailMergeRawXml) {
+        xml.writeRaw(settings.mailMergeRawXml);
+    }
+    // Write protection
+    if (settings?.writeProtection) {
+        const wp = settings.writeProtection;
+        const wpAttrs = {};
+        if (wp.recommended) {
+            wpAttrs["w:recommended"] = "1";
+        }
+        if (wp.algorithmName) {
+            wpAttrs["w:algorithmName"] = wp.algorithmName;
+        }
+        if (wp.hashValue) {
+            wpAttrs["w:hashValue"] = wp.hashValue;
+        }
+        if (wp.saltValue) {
+            wpAttrs["w:saltValue"] = wp.saltValue;
+        }
+        if (wp.spinCount !== undefined) {
+            wpAttrs["w:spinCount"] = String(wp.spinCount);
+        }
+        xml.leafNode("w:writeProtection", wpAttrs);
+    }
+    // Compatibility
+    xml.openNode("w:compat");
+    // Legacy compat flags (w:useFELayout, etc.) come before compatSettings
+    if (settings?.compatFlags) {
+        for (const flag of settings.compatFlags) {
+            const attrs = {};
+            if (flag.val !== undefined) {
+                attrs["w:val"] = flag.val;
+            }
+            xml.leafNode(`w:${flag.name}`, attrs);
+        }
+    }
+    xml.leafNode("w:compatSetting", {
+        "w:name": "compatibilityMode",
+        "w:uri": "http://schemas.microsoft.com/office/word",
+        "w:val": String(settings?.compatibilityMode ?? 15)
+    });
+    // Additional compatSettings
+    if (settings?.compatSettings) {
+        for (const cs of settings.compatSettings) {
+            xml.leafNode("w:compatSetting", {
+                "w:name": cs.name,
+                "w:uri": cs.uri,
+                "w:val": cs.val
+            });
+        }
+    }
+    xml.closeNode(); // w:compat
+    xml.closeNode();
+}
+// =============================================================================
+// Font Table
+// =============================================================================
+/** Render word/fontTable.xml. */
+export function renderFontTable(xml, fonts) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:fonts", { "xmlns:w": NS_W, "xmlns:r": NS_R });
+    const allFonts = fonts ?? DEFAULT_FONTS;
+    for (const font of allFonts) {
+        xml.openNode("w:font", { "w:name": font.name });
+        if (font.panose1) {
+            xml.leafNode("w:panose1", { "w:val": font.panose1 });
+        }
+        if (font.charset) {
+            xml.leafNode("w:charset", { "w:val": font.charset });
+        }
+        if (font.family) {
+            xml.leafNode("w:family", { "w:val": font.family });
+        }
+        if (font.pitch) {
+            xml.leafNode("w:pitch", { "w:val": font.pitch });
+        }
+        // Signature bytes
+        if (font.sig) {
+            const sigAttrs = {};
+            if (font.sig.usb0 !== undefined) {
+                sigAttrs["w:usb0"] = font.sig.usb0;
+            }
+            if (font.sig.usb1 !== undefined) {
+                sigAttrs["w:usb1"] = font.sig.usb1;
+            }
+            if (font.sig.usb2 !== undefined) {
+                sigAttrs["w:usb2"] = font.sig.usb2;
+            }
+            if (font.sig.usb3 !== undefined) {
+                sigAttrs["w:usb3"] = font.sig.usb3;
+            }
+            if (font.sig.csb0 !== undefined) {
+                sigAttrs["w:csb0"] = font.sig.csb0;
+            }
+            if (font.sig.csb1 !== undefined) {
+                sigAttrs["w:csb1"] = font.sig.csb1;
+            }
+            if (Object.keys(sigAttrs).length > 0) {
+                xml.leafNode("w:sig", sigAttrs);
+            }
+        }
+        // Embedded font references
+        if (font.embedRegular) {
+            const attrs = { "r:id": font.embedRegular };
+            if (font.embedRegularKey) {
+                attrs["w:fontKey"] = font.embedRegularKey;
+            }
+            xml.leafNode("w:embedRegular", attrs);
+        }
+        if (font.embedBold) {
+            const attrs = { "r:id": font.embedBold };
+            if (font.embedBoldKey) {
+                attrs["w:fontKey"] = font.embedBoldKey;
+            }
+            xml.leafNode("w:embedBold", attrs);
+        }
+        if (font.embedItalic) {
+            const attrs = { "r:id": font.embedItalic };
+            if (font.embedItalicKey) {
+                attrs["w:fontKey"] = font.embedItalicKey;
+            }
+            xml.leafNode("w:embedItalic", attrs);
+        }
+        if (font.embedBoldItalic) {
+            const attrs = { "r:id": font.embedBoldItalic };
+            if (font.embedBoldItalicKey) {
+                attrs["w:fontKey"] = font.embedBoldItalicKey;
+            }
+            xml.leafNode("w:embedBoldItalic", attrs);
+        }
+        xml.closeNode();
+    }
+    xml.closeNode();
+}
+const DEFAULT_FONTS = [
+    {
+        name: "Calibri",
+        panose1: "020F0502020204030204",
+        charset: "00",
+        family: "swiss",
+        pitch: "variable"
+    },
+    {
+        name: "Times New Roman",
+        panose1: "02020603050405020304",
+        charset: "00",
+        family: "roman",
+        pitch: "variable"
+    },
+    { name: "Symbol", charset: "02", family: "roman", pitch: "variable" },
+    {
+        name: "Courier New",
+        panose1: "02070309020205020404",
+        charset: "00",
+        family: "modern",
+        pitch: "fixed"
+    },
+    { name: "Wingdings", charset: "02", family: "auto", pitch: "variable" },
+    { name: "MS Gothic", charset: "80", family: "modern", pitch: "fixed" }
+];
+// =============================================================================
+// Core Properties (docProps/core.xml)
+// =============================================================================
+/** Render docProps/core.xml. */
+export function renderCoreProperties(xml, props) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("cp:coreProperties", {
+        "xmlns:cp": NS_CP,
+        "xmlns:dc": NS_DC,
+        "xmlns:dcterms": NS_DCTERMS,
+        "xmlns:dcmitype": NS_DCMITYPE,
+        "xmlns:xsi": NS_XSI
+    });
+    const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
+    if (props?.title) {
+        xml.leafNode("dc:title", undefined, props.title);
+    }
+    if (props?.subject) {
+        xml.leafNode("dc:subject", undefined, props.subject);
+    }
+    if (props?.creator) {
+        xml.leafNode("dc:creator", undefined, props.creator);
+    }
+    if (props?.description) {
+        xml.leafNode("dc:description", undefined, props.description);
+    }
+    if (props?.keywords) {
+        xml.leafNode("cp:keywords", undefined, props.keywords);
+    }
+    if (props?.lastModifiedBy) {
+        xml.leafNode("cp:lastModifiedBy", undefined, props.lastModifiedBy);
+    }
+    if (props?.revision) {
+        xml.leafNode("cp:revision", undefined, props.revision);
+    }
+    if (props?.category) {
+        xml.leafNode("cp:category", undefined, props.category);
+    }
+    xml.leafNode("dcterms:created", { "xsi:type": "dcterms:W3CDTF" }, props?.created ? props.created.toISOString().replace(/\.\d+Z$/, "Z") : now);
+    xml.leafNode("dcterms:modified", { "xsi:type": "dcterms:W3CDTF" }, props?.modified ? props.modified.toISOString().replace(/\.\d+Z$/, "Z") : now);
+    xml.closeNode();
+}
+// =============================================================================
+// App Properties (docProps/app.xml)
+// =============================================================================
+/** Render docProps/app.xml. */
+export function renderAppProperties(xml, props) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("Properties", {
+        xmlns: NS_EP,
+        "xmlns:vt": NS_VT
+    });
+    xml.leafNode("Application", undefined, props?.application ?? "excelts");
+    xml.leafNode("AppVersion", undefined, props?.appVersion ?? "1.0.0");
+    if (props?.pages !== undefined) {
+        xml.leafNode("Pages", undefined, String(props.pages));
+    }
+    if (props?.words !== undefined) {
+        xml.leafNode("Words", undefined, String(props.words));
+    }
+    if (props?.characters !== undefined) {
+        xml.leafNode("Characters", undefined, String(props.characters));
+    }
+    if (props?.lines !== undefined) {
+        xml.leafNode("Lines", undefined, String(props.lines));
+    }
+    if (props?.paragraphs !== undefined) {
+        xml.leafNode("Paragraphs", undefined, String(props.paragraphs));
+    }
+    if (props?.company) {
+        xml.leafNode("Company", undefined, props.company);
+    }
+    if (props?.manager) {
+        xml.leafNode("Manager", undefined, props.manager);
+    }
+    xml.closeNode();
+}
+// =============================================================================
+// Document Background
+// =============================================================================
+/** Render document background element (w:background in document.xml). */
+export function renderDocumentBackground(xml, bg) {
+    const attrs = {};
+    if (bg.color) {
+        attrs["w:color"] = bg.color;
+    }
+    if (bg.themeColor) {
+        attrs["w:themeColor"] = bg.themeColor;
+    }
+    if (bg.themeShade) {
+        attrs["w:themeShade"] = bg.themeShade;
+    }
+    if (bg.themeTint) {
+        attrs["w:themeTint"] = bg.themeTint;
+    }
+    xml.leafNode("w:background", attrs);
+}
+// =============================================================================
+// Custom Properties (docProps/custom.xml)
+// =============================================================================
+/** Render docProps/custom.xml. */
+export function renderCustomProperties(xml, properties) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("Properties", {
+        xmlns: NS_CUSTOM,
+        "xmlns:vt": NS_VT
+    });
+    let fmtid = 2; // Start at 2 (1 is reserved)
+    for (const prop of properties) {
+        xml.openNode("property", {
+            fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
+            pid: String(fmtid++),
+            name: prop.name
+        });
+        switch (prop.value.type) {
+            case "string":
+                xml.leafNode("vt:lpwstr", undefined, prop.value.value);
+                break;
+            case "number":
+                if (Number.isInteger(prop.value.value)) {
+                    xml.leafNode("vt:i4", undefined, String(prop.value.value));
+                }
+                else {
+                    xml.leafNode("vt:r8", undefined, String(prop.value.value));
+                }
+                break;
+            case "boolean":
+                xml.leafNode("vt:bool", undefined, prop.value.value ? "true" : "false");
+                break;
+            case "date":
+                xml.leafNode("vt:filetime", undefined, prop.value.value.toISOString().replace(/\.\d+Z$/, "Z"));
+                break;
+        }
+        xml.closeNode();
+    }
+    xml.closeNode();
+}
+// =============================================================================
+// Theme (minimal default theme)
+// =============================================================================
+/** Render word/theme/theme1.xml (minimal theme). */
+export function renderTheme(xml, theme) {
+    const NS_A_LOCAL = "http://schemas.openxmlformats.org/drawingml/2006/main";
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("a:theme", { "xmlns:a": NS_A_LOCAL, name: theme?.name ?? "Office Theme" });
+    xml.openNode("a:themeElements");
+    // Color scheme
+    const colorScheme = theme?.colorScheme;
+    xml.openNode("a:clrScheme", { name: colorScheme?.name ?? "Office" });
+    const defaultColors = {
+        dk1: "000000",
+        lt1: "FFFFFF",
+        dk2: "44546A",
+        lt2: "E7E6E6",
+        accent1: "4472C4",
+        accent2: "ED7D31",
+        accent3: "A5A5A5",
+        accent4: "FFC000",
+        accent5: "5B9BD5",
+        accent6: "70AD47",
+        hlink: "0563C1",
+        folHlink: "954F72"
+    };
+    const colorOrder = [
+        "dk1",
+        "lt1",
+        "dk2",
+        "lt2",
+        "accent1",
+        "accent2",
+        "accent3",
+        "accent4",
+        "accent5",
+        "accent6",
+        "hlink",
+        "folHlink"
+    ];
+    for (const name of colorOrder) {
+        const val = colorScheme?.colors[name] ?? defaultColors[name];
+        xml.openNode(`a:${name}`);
+        // dk1/lt1 use sysClr in standard theme, but srgbClr also valid
+        xml.leafNode("a:srgbClr", { val });
+        xml.closeNode();
+    }
+    xml.closeNode(); // a:clrScheme
+    // Font scheme
+    const fontScheme = theme?.fontScheme;
+    xml.openNode("a:fontScheme", { name: fontScheme?.name ?? "Office" });
+    // Major font
+    xml.openNode("a:majorFont");
+    renderThemeFont(xml, fontScheme?.major, fontScheme?.majorFont ?? "Calibri Light");
+    xml.closeNode();
+    // Minor font
+    xml.openNode("a:minorFont");
+    renderThemeFont(xml, fontScheme?.minor, fontScheme?.minorFont ?? "Calibri");
+    xml.closeNode();
+    xml.closeNode(); // a:fontScheme
+    // Format scheme - preserve raw XML if provided, otherwise minimal default
+    if (theme?.formatScheme?.rawXml) {
+        xml.openNode("a:fmtScheme", { name: theme.formatScheme.name });
+        xml.writeRaw(theme.formatScheme.rawXml);
+        xml.closeNode();
+    }
+    else {
+        renderDefaultFormatScheme(xml);
+    }
+    xml.closeNode(); // a:themeElements
+    // Extension list (round-trip preservation)
+    if (theme?.extLstXml) {
+        xml.writeRaw(theme.extLstXml);
+    }
+    xml.closeNode(); // a:theme
+}
+/** Render a single theme font (major or minor). */
+function renderThemeFont(xml, font, fallbackLatin) {
+    xml.leafNode("a:latin", { typeface: font?.latin ?? fallbackLatin });
+    xml.leafNode("a:ea", { typeface: font?.eastAsia ?? "" });
+    xml.leafNode("a:cs", { typeface: font?.complexScript ?? "" });
+    if (font?.supplementalFonts) {
+        for (const [script, typeface] of Object.entries(font.supplementalFonts)) {
+            xml.leafNode("a:font", { script, typeface });
+        }
+    }
+}
+/** Render the minimal default format scheme. */
+function renderDefaultFormatScheme(xml) {
+    xml.openNode("a:fmtScheme", { name: "Office" });
+    // Fill styles
+    xml.openNode("a:fillStyleLst");
+    for (let i = 0; i < 3; i++) {
+        xml.openNode("a:solidFill");
+        xml.leafNode("a:schemeClr", { val: "phClr" });
+        xml.closeNode();
+    }
+    xml.closeNode();
+    // Line styles
+    xml.openNode("a:lnStyleLst");
+    for (let i = 0; i < 3; i++) {
+        xml.openNode("a:ln", { w: String(6350 + i * 6350) });
+        xml.openNode("a:solidFill");
+        xml.leafNode("a:schemeClr", { val: "phClr" });
+        xml.closeNode();
+        xml.leafNode("a:prstDash", { val: "solid" });
+        xml.closeNode();
+    }
+    xml.closeNode();
+    // Effect styles
+    xml.openNode("a:effectStyleLst");
+    for (let i = 0; i < 3; i++) {
+        xml.openNode("a:effectStyle");
+        xml.leafNode("a:effectLst");
+        xml.closeNode();
+    }
+    xml.closeNode();
+    // Bg fill styles
+    xml.openNode("a:bgFillStyleLst");
+    for (let i = 0; i < 3; i++) {
+        xml.openNode("a:solidFill");
+        xml.leafNode("a:schemeClr", { val: "phClr" });
+        xml.closeNode();
+    }
+    xml.closeNode();
+    xml.closeNode(); // a:fmtScheme
+}
+// =============================================================================
+// Web Settings
+// =============================================================================
+/** Render word/webSettings.xml. */
+export function renderWebSettings(xml, ws) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w:webSettings", { "xmlns:w": NS_W });
+    if (ws?.optimizeForBrowser) {
+        const attrs = {};
+        if (ws.optimizeForBrowser.target) {
+            attrs["w:target"] = ws.optimizeForBrowser.target;
+        }
+        if (ws.optimizeForBrowser.majorVersion !== undefined) {
+            attrs["w:majorVersion"] = String(ws.optimizeForBrowser.majorVersion);
+        }
+        xml.leafNode("w:optimizeForBrowser", attrs);
+    }
+    if (ws?.allowPng) {
+        xml.leafNode("w:allowPNG");
+    }
+    if (ws?.relyOnVml) {
+        xml.leafNode("w:relyOnVML");
+    }
+    if (ws?.doNotSaveAsSingleFile) {
+        xml.leafNode("w:doNotSaveAsSingleFile");
+    }
+    if (ws?.doNotOrganizeInFolder) {
+        xml.leafNode("w:doNotOrganizeInFolder");
+    }
+    if (ws?.useTargetMachineType) {
+        xml.leafNode("w:useTargetMachineType");
+    }
+    if (ws?.rawXml) {
+        xml.writeRaw(ws.rawXml);
+    }
+    xml.closeNode();
+}
+// =============================================================================
+// People (collaboration metadata)
+// =============================================================================
+/** Render word/people.xml. */
+export function renderPeople(xml, people) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("w15:people", {
+        "xmlns:w": NS_W,
+        "xmlns:w15": "http://schemas.microsoft.com/office/word/2012/wordml"
+    });
+    for (const person of people) {
+        xml.openNode("w15:person", { "w15:author": person.author });
+        if (person.presenceInfo) {
+            const attrs = {};
+            if (person.presenceInfo.providerId) {
+                attrs["w15:providerId"] = person.presenceInfo.providerId;
+            }
+            if (person.presenceInfo.userId) {
+                attrs["w15:userId"] = person.presenceInfo.userId;
+            }
+            xml.leafNode("w15:presenceInfo", attrs);
+        }
+        xml.closeNode();
+    }
+    xml.closeNode();
+}