@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/generation/emit/header-footer-part.js

@@ -0,0 +1,57 @@
+/**
+ * Header and footer part emitters.
+ *
+ * Each declared header/footer slot (default / first / even) becomes its own
+ * part — word/headerN.xml or word/footerN.xml — registered with a
+ * content-type override and a relationship from the main document part. The
+ * block content reuses the same paragraph/run emitters as the body, so a
+ * footer's "Page X of Y" field compiles through exactly the same five-part
+ * field machinery.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.4
+ */
+import { OOXML } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+import { buildBlock } from './table.js';
+const HEADER_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml';
+const FOOTER_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml';
+const HEADER_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/header';
+const FOOTER_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer';
+const SLOT_ORDER = ['first', 'default', 'even'];
+/**
+ * Allocate and emit every header/footer part, returning per-section
+ * reference maps for the sectPr emitter. Runs before the document part so
+ * relationship ids exist when sections bind their references.
+ */
+export function emitHeaderFooterParts(spec, ctx, blockCtx) {
+    return spec.sections.map((section) => emitForSection(section, ctx, blockCtx));
+}
+function emitForSection(section, ctx, blockCtx) {
+    const refs = { headers: {}, footers: {} };
+    for (const slot of SLOT_ORDER) {
+        const header = section.headers?.[slot];
+        if (header) {
+            refs.headers[slot] = emitPart(header, ctx, 'header', blockCtx);
+        }
+        const footer = section.footers?.[slot];
+        if (footer) {
+            refs.footers[slot] = emitPart(footer, ctx, 'footer', blockCtx);
+        }
+    }
+    return refs;
+}
+/** @conformance ECMA-376 edition 5, Part 1 § 17.10.3 */
+function emitPart(content, ctx, kind, blockCtx) {
+    const isHeader = kind === 'header';
+    const partName = isHeader ? ctx.allocateHeaderPartName() : ctx.allocateFooterPartName();
+    const part = ctx.registerPart(partName, isHeader ? HEADER_CONTENT_TYPE : FOOTER_CONTENT_TYPE, isHeader ? HEADER_REL_TYPE : FOOTER_REL_TYPE);
+    const rootTag = isHeader ? 'w:hdr' : 'w:ftr';
+    const doc = parseXml(`<${rootTag} xmlns:w="${OOXML.W_NS}" xmlns:r="${OOXML.R_NS}"/>`);
+    const root = doc.documentElement;
+    for (const block of content.blocks) {
+        root.appendChild(buildBlock(doc, block, blockCtx));
+    }
+    ctx.setFileContent(partName, XML_DECL + serializeXml(doc));
+    return part.documentRel.rId;
+}
+//# sourceMappingURL=header-footer-part.js.map

package/dist/generation/emit/header-footer-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-footer-part.js","sourceRoot":"","sources":["../../../src/generation/emit/header-footer-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAI3E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,mBAAmB,GAAG,2EAA2E,CAAC;AACxG,MAAM,mBAAmB,GAAG,2EAA2E,CAAC;AACxG,MAAM,eAAe,GAAG,4EAA4E,CAAC;AACrG,MAAM,eAAe,GAAG,4EAA4E,CAAC;AAErG,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB,EAAE,GAAmB,EAAE,QAA2B;IACxG,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,cAAc,CAAC,OAAoB,EAAE,GAAmB,EAAE,QAA2B;IAC5F,MAAM,IAAI,GAA4B,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,SAAS,QAAQ,CAAC,OAAyB,EAAE,GAAmB,EAAE,IAAyB,EAAE,QAA2B;IACtH,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,CAAC;IACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;IACxF,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAC3B,QAAQ,EACR,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,EACpD,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAC7C,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,OAAO,aAAa,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,GAAG,CAAC,eAAgB,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,WAAY,CAAC,GAAG,CAAC;AAC/B,CAAC"}

package/dist/generation/emit/numbering-part.d.ts

@@ -0,0 +1,29 @@
+/**
+ * word/numbering.xml emitter.
+ *
+ * Each NumberingSpec compiles to one abstract definition plus one instance:
+ * the spec's string handle (`numId`) maps to sequential numeric ids assigned
+ * in declaration order, so identical specs always produce identical ids. The
+ * returned map is what lets paragraph `w:numPr` references bind to the
+ * numeric `w:numId` deterministically.
+ *
+ * Level children follow the CT_Lvl sequence (start, numFmt, suff, lvlText,
+ * lvlJc, pPr, rPr); level run properties reuse the shared rPr builder so a
+ * bullet glyph's font serializes exactly like body formatting would.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.1
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.15
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.2
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+import type { NumberingIdMap } from './emit-context.js';
+export declare const NUMBERING_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml";
+export declare const NUMBERING_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
+/**
+ * Emit word/numbering.xml when the spec declares numbering definitions.
+ * Returns the handle → numeric id map (empty when no part is emitted).
+ */
+export declare function emitNumberingPartIfNeeded(spec: DocumentSpec, ctx: CompileContext): NumberingIdMap;
+//# sourceMappingURL=numbering-part.d.ts.map

package/dist/generation/emit/numbering-part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/numbering-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,sBAAsB,iFAC6C,CAAC;AACjF,eAAO,MAAM,kBAAkB,kFACkD,CAAC;AAIlF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,cAAc,CAyBjG"}

package/dist/generation/emit/numbering-part.js

@@ -0,0 +1,100 @@
+/**
+ * word/numbering.xml emitter.
+ *
+ * Each NumberingSpec compiles to one abstract definition plus one instance:
+ * the spec's string handle (`numId`) maps to sequential numeric ids assigned
+ * in declaration order, so identical specs always produce identical ids. The
+ * returned map is what lets paragraph `w:numPr` references bind to the
+ * numeric `w:numId` deterministically.
+ *
+ * Level children follow the CT_Lvl sequence (start, numFmt, suff, lvlText,
+ * lvlJc, pPr, rPr); level run properties reuse the shared rPr builder so a
+ * bullet glyph's font serializes exactly like body formatting would.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.1
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.15
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.2
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+import { buildRunPropsElement } from './properties.js';
+export const NUMBERING_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml';
+export const NUMBERING_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering';
+const NUMBERING_SKELETON = `<w:numbering xmlns:w="${OOXML.W_NS}"/>`;
+/**
+ * Emit word/numbering.xml when the spec declares numbering definitions.
+ * Returns the handle → numeric id map (empty when no part is emitted).
+ */
+export function emitNumberingPartIfNeeded(spec, ctx) {
+    const ids = new Map();
+    const definitions = spec.numbering ?? [];
+    if (definitions.length === 0)
+        return ids;
+    ctx.registerPart('word/numbering.xml', NUMBERING_CONTENT_TYPE, NUMBERING_REL_TYPE);
+    const doc = parseXml(NUMBERING_SKELETON);
+    const root = doc.documentElement;
+    definitions.forEach((definition, index) => {
+        ids.set(definition.numId, index + 1);
+    });
+    // CT_Numbering sequence: every abstractNum precedes every num.
+    definitions.forEach((definition, index) => {
+        root.appendChild(buildAbstractNum(doc, definition, index));
+    });
+    definitions.forEach((_definition, index) => {
+        const num = createWmlElement(doc, W.num, { 'w:numId': String(index + 1) });
+        num.appendChild(createWmlElement(doc, W.abstractNumId, { 'w:val': String(index) }));
+        root.appendChild(num);
+    });
+    ctx.setFileContent('word/numbering.xml', XML_DECL + serializeXml(doc));
+    return ids;
+}
+/**
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.12
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.6
+ */
+function buildAbstractNum(doc, definition, abstractId) {
+    const abstractNum = createWmlElement(doc, W.abstractNum, { 'w:abstractNumId': String(abstractId) });
+    abstractNum.appendChild(createWmlElement(doc, W.multiLevelType, {
+        'w:val': definition.levels.length > 1 ? 'multilevel' : 'singleLevel',
+    }));
+    for (const level of definition.levels) {
+        abstractNum.appendChild(buildLevel(doc, level));
+    }
+    return abstractNum;
+}
+/**
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.25
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.28
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.11
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.7
+ */
+function buildLevel(doc, level) {
+    const lvl = createWmlElement(doc, W.lvl, { 'w:ilvl': String(level.ilvl) });
+    lvl.appendChild(createWmlElement(doc, W.start, { 'w:val': String(level.start ?? 1) }));
+    lvl.appendChild(createWmlElement(doc, W.numFmt, { 'w:val': level.numFmt }));
+    if (level.suff !== undefined) {
+        lvl.appendChild(createWmlElement(doc, W.suff, { 'w:val': level.suff }));
+    }
+    lvl.appendChild(createWmlElement(doc, W.lvlText, { 'w:val': level.lvlText }));
+    lvl.appendChild(createWmlElement(doc, W.lvlJc, { 'w:val': 'left' }));
+    if (level.indentTwips !== undefined) {
+        const pPr = createWmlElement(doc, W.pPr);
+        const attrs = {};
+        if (level.indentTwips.left !== undefined)
+            attrs['w:left'] = String(level.indentTwips.left);
+        if (level.indentTwips.hanging !== undefined)
+            attrs['w:hanging'] = String(level.indentTwips.hanging);
+        pPr.appendChild(createWmlElement(doc, W.ind, attrs));
+        lvl.appendChild(pPr);
+    }
+    if (level.runProps !== undefined) {
+        const rPr = buildRunPropsElement(doc, level.runProps);
+        if (rPr)
+            lvl.appendChild(rPr);
+    }
+    return lvl;
+}
+//# sourceMappingURL=numbering-part.js.map

package/dist/generation/emit/numbering-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-part.js","sourceRoot":"","sources":["../../../src/generation/emit/numbering-part.ts"],"names":[],"mappings":"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"}

package/dist/generation/emit/package-parts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OPC package plumbing: [Content_Types].xml, package/part relationships, and
+ * document properties. Built with the same skeleton-parse + namespace-aware
+ * DOM approach as the WML parts — no string concatenation of dynamic values.
+ *
+ * docProps/core.xml dates come exclusively from the spec (meta.createdIso);
+ * generation never reads the clock, keeping output byte-deterministic.
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+export declare const CONTENT_TYPES: {
+    readonly document: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml";
+    readonly coreProps: "application/vnd.openxmlformats-package.core-properties+xml";
+    readonly extendedProps: "application/vnd.openxmlformats-officedocument.extended-properties+xml";
+    readonly relationships: "application/vnd.openxmlformats-package.relationships+xml";
+};
+export declare const REL_TYPES: {
+    readonly officeDocument: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly coreProps: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
+    readonly extendedProps: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties";
+};
+/** Emit every package-plumbing part into the context's file map. */
+export declare function emitPackageParts(spec: DocumentSpec, ctx: CompileContext): void;
+//# sourceMappingURL=package-parts.d.ts.map

package/dist/generation/emit/package-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-parts.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/package-parts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAWX,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAM9E"}

package/dist/generation/emit/package-parts.js

@@ -0,0 +1,121 @@
+/**
+ * OPC package plumbing: [Content_Types].xml, package/part relationships, and
+ * document properties. Built with the same skeleton-parse + namespace-aware
+ * DOM approach as the WML parts — no string concatenation of dynamic values.
+ *
+ * docProps/core.xml dates come exclusively from the spec (meta.createdIso);
+ * generation never reads the clock, keeping output byte-deterministic.
+ */
+import { OOXML } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+export const CONTENT_TYPES = {
+    document: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml',
+    coreProps: 'application/vnd.openxmlformats-package.core-properties+xml',
+    extendedProps: 'application/vnd.openxmlformats-officedocument.extended-properties+xml',
+    relationships: 'application/vnd.openxmlformats-package.relationships+xml',
+};
+export const REL_TYPES = {
+    officeDocument: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument',
+    coreProps: 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties',
+    extendedProps: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties',
+};
+const CORE_PROPS_NS = {
+    cp: 'http://schemas.openxmlformats.org/package/2006/metadata/core-properties',
+    dc: 'http://purl.org/dc/elements/1.1/',
+    dcterms: 'http://purl.org/dc/terms/',
+    xsi: 'http://www.w3.org/2001/XMLSchema-instance',
+};
+const EXTENDED_PROPS_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/extended-properties';
+/** Emit every package-plumbing part into the context's file map. */
+export function emitPackageParts(spec, ctx) {
+    ctx.setFileContent('docProps/core.xml', emitCoreProps(spec));
+    ctx.setFileContent('docProps/app.xml', emitAppProps());
+    ctx.setFileContent('_rels/.rels', emitPackageRels());
+    ctx.setFileContent('word/_rels/document.xml.rels', emitDocumentRels(ctx));
+    ctx.setFileContent('[Content_Types].xml', emitContentTypes(ctx));
+}
+function emitContentTypes(ctx) {
+    const doc = parseXml(`<Types xmlns="${OOXML.CT_NS}"/>`);
+    const root = doc.documentElement;
+    const addDefault = (extension, contentType) => {
+        const el = doc.createElementNS(OOXML.CT_NS, 'Default');
+        el.setAttribute('Extension', extension);
+        el.setAttribute('ContentType', contentType);
+        root.appendChild(el);
+    };
+    const addOverride = (partName, contentType) => {
+        const el = doc.createElementNS(OOXML.CT_NS, 'Override');
+        el.setAttribute('PartName', partName);
+        el.setAttribute('ContentType', contentType);
+        root.appendChild(el);
+    };
+    addDefault('rels', CONTENT_TYPES.relationships);
+    addDefault('xml', 'application/xml');
+    addOverride('/word/document.xml', CONTENT_TYPES.document);
+    addOverride('/docProps/core.xml', CONTENT_TYPES.coreProps);
+    addOverride('/docProps/app.xml', CONTENT_TYPES.extendedProps);
+    for (const part of ctx.registeredParts()) {
+        addOverride(`/${part.name}`, part.contentType);
+    }
+    return XML_DECL + serializeXml(doc);
+}
+function emitPackageRels() {
+    const doc = parseXml(`<Relationships xmlns="${OOXML.REL_NS}"/>`);
+    const root = doc.documentElement;
+    const add = (id, type, target) => {
+        const el = doc.createElementNS(OOXML.REL_NS, 'Relationship');
+        el.setAttribute('Id', id);
+        el.setAttribute('Type', type);
+        el.setAttribute('Target', target);
+        root.appendChild(el);
+    };
+    add('rId1', REL_TYPES.officeDocument, 'word/document.xml');
+    add('rId2', REL_TYPES.coreProps, 'docProps/core.xml');
+    add('rId3', REL_TYPES.extendedProps, 'docProps/app.xml');
+    return XML_DECL + serializeXml(doc);
+}
+function emitDocumentRels(ctx) {
+    const doc = parseXml(`<Relationships xmlns="${OOXML.REL_NS}"/>`);
+    const root = doc.documentElement;
+    for (const part of ctx.documentRelParts()) {
+        const el = doc.createElementNS(OOXML.REL_NS, 'Relationship');
+        el.setAttribute('Id', part.documentRel.rId);
+        el.setAttribute('Type', part.documentRel.type);
+        // Targets are resolved relative to word/, the directory owning document.xml.
+        el.setAttribute('Target', part.name.replace(/^word\//, ''));
+        root.appendChild(el);
+    }
+    return XML_DECL + serializeXml(doc);
+}
+function emitCoreProps(spec) {
+    const doc = parseXml(`<cp:coreProperties xmlns:cp="${CORE_PROPS_NS.cp}" xmlns:dc="${CORE_PROPS_NS.dc}"` +
+        ` xmlns:dcterms="${CORE_PROPS_NS.dcterms}" xmlns:xsi="${CORE_PROPS_NS.xsi}"/>`);
+    const root = doc.documentElement;
+    const meta = spec.meta;
+    const addText = (ns, qname, text, attrs) => {
+        const el = doc.createElementNS(ns, qname);
+        if (attrs)
+            for (const [k, v] of Object.entries(attrs))
+                el.setAttribute(k, v);
+        el.appendChild(doc.createTextNode(text));
+        root.appendChild(el);
+    };
+    if (meta?.title)
+        addText(CORE_PROPS_NS.dc, 'dc:title', meta.title);
+    if (meta?.author)
+        addText(CORE_PROPS_NS.dc, 'dc:creator', meta.author);
+    if (meta?.createdIso) {
+        addText(CORE_PROPS_NS.dcterms, 'dcterms:created', meta.createdIso, { 'xsi:type': 'dcterms:W3CDTF' });
+        addText(CORE_PROPS_NS.dcterms, 'dcterms:modified', meta.createdIso, { 'xsi:type': 'dcterms:W3CDTF' });
+    }
+    return XML_DECL + serializeXml(doc);
+}
+function emitAppProps() {
+    const doc = parseXml(`<Properties xmlns="${EXTENDED_PROPS_NS}"/>`);
+    const root = doc.documentElement;
+    const app = doc.createElementNS(EXTENDED_PROPS_NS, 'Application');
+    app.appendChild(doc.createTextNode('safe-docx'));
+    root.appendChild(app);
+    return XML_DECL + serializeXml(doc);
+}
+//# sourceMappingURL=package-parts.js.map

package/dist/generation/emit/package-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-parts.js","sourceRoot":"","sources":["../../../src/generation/emit/package-parts.ts"],"names":[],"mappings":"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"}

package/dist/generation/emit/paragraph.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Paragraph emitter.
+ *
+ * Shipped: paragraphs with style references and direct formatting
+ * (alignment, spacing, indentation, tabs, keepNext, pageBreakBefore), all
+ * routed through the shared pPr builder and PPR_ORDER. The section-break
+ * injection hook (a pPr-only sectPr) arrives with the multi-section phase.
+ */
+import type { ParagraphSpec } from '../types.js';
+import type { BlockEmitContext } from './emit-context.js';
+/**
+ * List paragraphs reference their numbering definition through w:numPr
+ * (w:ilvl then w:numId, per CT_NumPr); the numeric id comes from the
+ * numbering part's deterministic handle map.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.3
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.4
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.3
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.5
+ */
+export declare function buildParagraph(doc: Document, paragraph: ParagraphSpec, ctx?: BlockEmitContext): Element;
+//# sourceMappingURL=paragraph.d.ts.map

package/dist/generation/emit/paragraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/paragraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAsCvG"}

package/dist/generation/emit/paragraph.js

@@ -0,0 +1,63 @@
+/**
+ * Paragraph emitter.
+ *
+ * Shipped: paragraphs with style references and direct formatting
+ * (alignment, spacing, indentation, tabs, keepNext, pageBreakBefore), all
+ * routed through the shared pPr builder and PPR_ORDER. The section-break
+ * injection hook (a pPr-only sectPr) arrives with the multi-section phase.
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { W } from '../../primitives/namespaces.js';
+import { GenerationInternalError } from '../errors.js';
+import { buildParagraphPropsElement } from './properties.js';
+import { buildInlineRuns } from './run.js';
+/**
+ * List paragraphs reference their numbering definition through w:numPr
+ * (w:ilvl then w:numId, per CT_NumPr); the numeric id comes from the
+ * numbering part's deterministic handle map.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.3
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.4
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.3
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.5
+ */
+export function buildParagraph(doc, paragraph, ctx) {
+    const p = createWmlElement(doc, W.p);
+    let extras;
+    if (paragraph.list !== undefined) {
+        const numericId = ctx?.numberingIds?.get(paragraph.list.numId);
+        if (numericId === undefined) {
+            throw new GenerationInternalError(`List paragraph references numbering handle '${paragraph.list.numId}' with no allocated numeric id`);
+        }
+        const numPr = createWmlElement(doc, W.numPr);
+        numPr.appendChild(createWmlElement(doc, W.ilvl, { 'w:val': String(paragraph.list.ilvl) }));
+        numPr.appendChild(createWmlElement(doc, W.numId, { 'w:val': String(numericId) }));
+        extras = new Map([[W.numPr, numPr]]);
+    }
+    const pPr = buildParagraphPropsElement(doc, paragraph, extras);
+    if (pPr)
+        p.appendChild(pPr);
+    // Drafting-note anchors: range markers bracket the paragraph's content and
+    // the reference run trails it (§ 17.13.4.4 / .3 / .5). Absent a collector
+    // (notes disabled, or a story that cannot carry them) the paragraph
+    // serializes without any trace of the note.
+    const noteId = paragraph.note !== undefined && ctx?.notes ? ctx.notes.allocate(paragraph.note) : undefined;
+    if (noteId !== undefined) {
+        p.appendChild(createWmlElement(doc, W.commentRangeStart, { 'w:id': String(noteId) }));
+    }
+    for (const inline of paragraph.runs) {
+        for (const run of buildInlineRuns(doc, inline)) {
+            p.appendChild(run);
+        }
+    }
+    if (noteId !== undefined) {
+        p.appendChild(createWmlElement(doc, W.commentRangeEnd, { 'w:id': String(noteId) }));
+        const referenceRun = createWmlElement(doc, W.r);
+        referenceRun.appendChild(createWmlElement(doc, W.commentReference, { 'w:id': String(noteId) }));
+        p.appendChild(referenceRun);
+    }
+    return p;
+}
+//# sourceMappingURL=paragraph.js.map

package/dist/generation/emit/paragraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph.js","sourceRoot":"","sources":["../../../src/generation/emit/paragraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,gCAAgC,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,GAAa,EAAE,SAAwB,EAAE,GAAsB;IAC5F,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,MAAwC,CAAC;IAC7C,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,uBAAuB,CAC/B,+CAA+C,SAAS,CAAC,IAAI,CAAC,KAAK,gCAAgC,CACpG,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7C,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3F,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,0BAA0B,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,GAAG;QAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE5B,2EAA2E;IAC3E,0EAA0E;IAC1E,oEAAoE;IACpE,4CAA4C;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,YAAY,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAChG,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/generation/emit/properties.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared property builders: RunProps → w:rPr and paragraph formatting → w:pPr
+ * child maps, used by both the body emitters (run.ts / paragraph.ts) and the
+ * styles-part emitter so direct formatting and style definitions can never
+ * drift apart. All children are routed through the ordering tables.
+ */
+import type { ParagraphSpec, RunProps, StyleSpec } from '../types.js';
+/** Paragraph-formatting subset shared by ParagraphSpec and StyleSpec.paragraph. */
+export type ParagraphProps = Pick<ParagraphSpec, 'alignment' | 'spacing' | 'indent' | 'tabs' | 'pageBreakBefore' | 'keepNext'> & {
+    styleId?: string;
+};
+/**
+ * Build the ordered rPr children for a RunProps value. Returns null when no
+ * property is set so callers can omit the rPr container entirely.
+ *
+ * Complex-script twins (bCs/iCs/szCs) and the full rFonts script coverage
+ * (ascii + hAnsi + cs) are always emitted alongside their base properties so
+ * all script ranges agree.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.2.28
+ */
+export declare function buildRunPropsElement(doc: Document, props: RunProps): Element | null;
+/**
+ * Build the ordered pPr children for a paragraph-formatting subset. Returns
+ * null when nothing is set. The optional extras hook lets phase-specific
+ * callers add already-built children (e.g. a section break sectPr) that
+ * still go through the same ordering discipline.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.26
+ */
+export declare function buildParagraphPropsElement(doc: Document, props: ParagraphProps, extras?: ReadonlyMap<string, Element | Element[]>): Element | null;
+/** Paragraph-formatting subset of a StyleSpec, normalized for the builder. */
+export declare function styleParagraphProps(style: StyleSpec): ParagraphProps;
+//# sourceMappingURL=properties.d.ts.map

package/dist/generation/emit/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtE,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,aAAa,EACb,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,GAAG,UAAU,CAC7E,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AASzB;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAwCnF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC,GAChD,OAAO,GAAG,IAAI,CAkDhB;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAEpE"}