@usejunior/docx-core 0.10.0 → 0.11.1

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, ctx)) {
+            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,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,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,36 @@
+/**
+ * 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, ThemeColorSlot } 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, opts?: {
+    themeColorValues?: ReadonlyMap<ThemeColorSlot, string>;
+}): 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,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtF,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,CAClC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,QAAQ,EACf,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;CAAE,GAChE,OAAO,GAAG,IAAI,CAoDhB;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"}

package/dist/generation/emit/properties.js

@@ -0,0 +1,154 @@
+/**
+ * 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 { createWmlElement } from '../../primitives/dom-helpers.js';
+import { W } from '../../primitives/namespaces.js';
+import { appendInOrder, PPR_ORDER, RPR_ORDER } from '../ordering.js';
+const ALIGNMENT_TO_JC = {
+    left: 'left',
+    center: 'center',
+    right: 'right',
+    justify: 'both',
+};
+/**
+ * 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 function buildRunPropsElement(doc, props, opts) {
+    const children = new Map();
+    if (props.font !== undefined) {
+        children.set(W.rFonts, createWmlElement(doc, W.rFonts, {
+            'w:ascii': props.font,
+            'w:hAnsi': props.font,
+            'w:cs': props.font,
+        }));
+    }
+    if (props.bold !== undefined) {
+        children.set(W.b, createWmlElement(doc, W.b, props.bold ? undefined : { 'w:val': '0' }));
+        children.set(W.bCs, createWmlElement(doc, W.bCs, props.bold ? undefined : { 'w:val': '0' }));
+    }
+    if (props.italic !== undefined) {
+        children.set(W.i, createWmlElement(doc, W.i, props.italic ? undefined : { 'w:val': '0' }));
+        children.set(W.iCs, createWmlElement(doc, W.iCs, props.italic ? undefined : { 'w:val': '0' }));
+    }
+    if (props.caps !== undefined) {
+        children.set(W.caps, createWmlElement(doc, W.caps, props.caps ? undefined : { 'w:val': '0' }));
+    }
+    if (props.smallCaps !== undefined) {
+        children.set(W.smallCaps, createWmlElement(doc, W.smallCaps, props.smallCaps ? undefined : { 'w:val': '0' }));
+    }
+    if (props.colorHex !== undefined || props.themeColor !== undefined) {
+        const attrs = {};
+        if (props.colorHex !== undefined)
+            attrs['w:val'] = props.colorHex;
+        if (props.themeColor !== undefined) {
+            attrs['w:themeColor'] = props.themeColor;
+            const fallback = opts?.themeColorValues?.get(props.themeColor);
+            if (fallback !== undefined && attrs['w:val'] === undefined)
+                attrs['w:val'] = fallback;
+        }
+        if (props.themeTint !== undefined)
+            attrs['w:themeTint'] = props.themeTint;
+        if (props.themeShade !== undefined)
+            attrs['w:themeShade'] = props.themeShade;
+        children.set(W.color, createWmlElement(doc, W.color, attrs));
+    }
+    if (props.sizePt !== undefined) {
+        const halfPoints = String(Math.round(props.sizePt * 2));
+        children.set(W.sz, createWmlElement(doc, W.sz, { 'w:val': halfPoints }));
+        children.set(W.szCs, createWmlElement(doc, W.szCs, { 'w:val': halfPoints }));
+    }
+    if (props.highlight !== undefined) {
+        children.set(W.highlight, createWmlElement(doc, W.highlight, { 'w:val': props.highlight }));
+    }
+    if (props.underline !== undefined) {
+        children.set(W.u, createWmlElement(doc, W.u, { 'w:val': props.underline }));
+    }
+    if (children.size === 0)
+        return null;
+    const rPr = createWmlElement(doc, W.rPr);
+    appendInOrder(rPr, children, RPR_ORDER);
+    return rPr;
+}
+/**
+ * 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 function buildParagraphPropsElement(doc, props, extras) {
+    const children = new Map();
+    if (props.styleId !== undefined) {
+        children.set(W.pStyle, createWmlElement(doc, W.pStyle, { 'w:val': props.styleId }));
+    }
+    if (props.keepNext) {
+        children.set(W.keepNext, createWmlElement(doc, W.keepNext));
+    }
+    if (props.pageBreakBefore) {
+        children.set(W.pageBreakBefore, createWmlElement(doc, W.pageBreakBefore));
+    }
+    if (props.tabs && props.tabs.length > 0) {
+        const tabs = createWmlElement(doc, W.tabs);
+        for (const stop of props.tabs) {
+            const attrs = { 'w:val': stop.align, 'w:pos': String(stop.posTwips) };
+            if (stop.leader && stop.leader !== 'none')
+                attrs['w:leader'] = stop.leader;
+            tabs.appendChild(createWmlElement(doc, W.tab, attrs));
+        }
+        children.set(W.tabs, tabs);
+    }
+    if (props.spacing) {
+        const attrs = {};
+        if (props.spacing.beforeTwips !== undefined)
+            attrs['w:before'] = String(props.spacing.beforeTwips);
+        if (props.spacing.afterTwips !== undefined)
+            attrs['w:after'] = String(props.spacing.afterTwips);
+        if (props.spacing.lineTwips !== undefined) {
+            attrs['w:line'] = String(props.spacing.lineTwips);
+            attrs['w:lineRule'] = props.spacing.lineRule ?? 'auto';
+        }
+        if (Object.keys(attrs).length > 0)
+            children.set(W.spacing, createWmlElement(doc, W.spacing, attrs));
+    }
+    if (props.indent) {
+        const attrs = {};
+        if (props.indent.leftTwips !== undefined)
+            attrs['w:left'] = String(props.indent.leftTwips);
+        if (props.indent.rightTwips !== undefined)
+            attrs['w:right'] = String(props.indent.rightTwips);
+        if (props.indent.firstLineTwips !== undefined)
+            attrs['w:firstLine'] = String(props.indent.firstLineTwips);
+        if (props.indent.hangingTwips !== undefined)
+            attrs['w:hanging'] = String(props.indent.hangingTwips);
+        if (Object.keys(attrs).length > 0)
+            children.set(W.ind, createWmlElement(doc, W.ind, attrs));
+    }
+    if (props.alignment !== undefined) {
+        children.set(W.jc, createWmlElement(doc, W.jc, { 'w:val': ALIGNMENT_TO_JC[props.alignment] }));
+    }
+    if (extras) {
+        for (const [name, value] of extras)
+            children.set(name, value);
+    }
+    if (children.size === 0)
+        return null;
+    const pPr = createWmlElement(doc, W.pPr);
+    appendInOrder(pPr, children, PPR_ORDER);
+    return pPr;
+}
+/** Paragraph-formatting subset of a StyleSpec, normalized for the builder. */
+export function styleParagraphProps(style) {
+    return { ...style.paragraph };
+}
+//# sourceMappingURL=properties.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Inline-run emitter.
+ *
+ * Shipped: text runs with full RunProps formatting, tab and break runs, and
+ * complete five-part complex fields. A FieldSpec compiles to
+ * begin → instruction text → separate → cached result → end so reading
+ * applications always display a value without recomputation prompts — the
+ * required `cachedResult` makes the no-recovery-dialog property
+ * unrepresentable-by-omission. `w:dirty` is never set (it triggers
+ * update-fields prompts in some readers).
+ */
+import type { InlineSpec } from '../types.js';
+import type { BlockEmitContext } from './emit-context.js';
+/** Build the w:r element(s) for one inline spec node. */
+export declare function buildInlineRuns(doc: Document, inline: InlineSpec, ctx?: BlockEmitContext): Element[];
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAa,UAAU,EAAY,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAqC1D,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAsBpG"}

package/dist/generation/emit/run.js

@@ -0,0 +1,71 @@
+/**
+ * Inline-run emitter.
+ *
+ * Shipped: text runs with full RunProps formatting, tab and break runs, and
+ * complete five-part complex fields. A FieldSpec compiles to
+ * begin → instruction text → separate → cached result → end so reading
+ * applications always display a value without recomputation prompts — the
+ * required `cachedResult` makes the no-recovery-dialog property
+ * unrepresentable-by-omission. `w:dirty` is never set (it triggers
+ * update-fields prompts in some readers).
+ */
+import { createWmlElement, createWmlTextElement } from '../../primitives/dom-helpers.js';
+import { W } from '../../primitives/namespaces.js';
+import { GenerationInternalError } from '../errors.js';
+import { buildRunPropsElement } from './properties.js';
+/** Instruction text per field, with the canonical surrounding spaces. */
+const FIELD_INSTRUCTION_TEXT = {
+    PAGE: ' PAGE ',
+    NUMPAGES: ' NUMPAGES ',
+};
+function makeRun(doc, props, ctx, ...children) {
+    const run = createWmlElement(doc, W.r);
+    const rPr = buildRunPropsElement(doc, props, { themeColorValues: ctx?.themeColorValues });
+    if (rPr)
+        run.appendChild(rPr);
+    for (const child of children)
+        run.appendChild(child);
+    return run;
+}
+/**
+ * Five sibling runs per field: fldChar begin, preserved-space instruction
+ * text, fldChar separate, the cached result, fldChar end.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.18
+ */
+function buildFieldRuns(doc, field, ctx) {
+    const instr = createWmlElement(doc, W.instrText);
+    instr.setAttribute('xml:space', 'preserve');
+    instr.appendChild(doc.createTextNode(FIELD_INSTRUCTION_TEXT[field.field]));
+    return [
+        makeRun(doc, field, ctx, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'begin' })),
+        makeRun(doc, field, ctx, instr),
+        makeRun(doc, field, ctx, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'separate' })),
+        makeRun(doc, field, ctx, createWmlTextElement(doc, field.cachedResult)),
+        makeRun(doc, field, ctx, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'end' })),
+    ];
+}
+/** Build the w:r element(s) for one inline spec node. */
+export function buildInlineRuns(doc, inline, ctx) {
+    switch (inline.kind) {
+        case 'text': {
+            const run = createWmlElement(doc, W.r);
+            const rPr = buildRunPropsElement(doc, inline, { themeColorValues: ctx?.themeColorValues });
+            if (rPr)
+                run.appendChild(rPr);
+            run.appendChild(createWmlTextElement(doc, inline.text));
+            return [run];
+        }
+        case 'field':
+            return buildFieldRuns(doc, inline, ctx);
+        case 'tab':
+            return [makeRun(doc, {}, ctx, createWmlElement(doc, W.tab))];
+        case 'break': {
+            const attrs = inline.breakType === 'page' ? { 'w:type': 'page' } : undefined;
+            return [makeRun(doc, {}, ctx, createWmlElement(doc, W.br, attrs))];
+        }
+        default:
+            throw new GenerationInternalError(`Inline kind '${inline.kind}' reached the run emitter without a shipped emitter`);
+    }
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Section-properties emitter.
+ *
+ * Shipped: page size/margins, page numbering, section break type, title-page
+ * switch, and header/footer references. The reference rIds come from the
+ * header/footer part allocation pass (emit/header-footer-part.ts), which runs
+ * before the document part so the sectPr can bind them.
+ */
+import type { SectionSpec } from '../types.js';
+/** Header/footer part references for one section, allocated by the parts pass. */
+export type SectionHeaderFooterRefs = {
+    headers: Partial<Record<'default' | 'first' | 'even', string>>;
+    footers: Partial<Record<'default' | 'first' | 'even', string>>;
+};
+/**
+ * Build the w:sectPr element for a section.
+ *
+ * Width/height are always emitted explicitly (never reader defaults); a
+ * landscape request swaps the dimensions and sets w:orient. Header/footer
+ * references lead the child sequence; w:titlePg is implied whenever a
+ * first-page header or footer is present.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.13
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.12
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.6
+ */
+export declare function buildSectPr(doc: Document, section: SectionSpec, refs?: SectionHeaderFooterRefs): Element;
+export declare function titlePgImplied(section: SectionSpec): boolean;
+//# sourceMappingURL=section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/section.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/C,kFAAkF;AAClF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CA4BxG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAE5D"}

package/dist/generation/emit/section.js

@@ -0,0 +1,117 @@
+/**
+ * Section-properties emitter.
+ *
+ * Shipped: page size/margins, page numbering, section break type, title-page
+ * switch, and header/footer references. The reference rIds come from the
+ * header/footer part allocation pass (emit/header-footer-part.ts), which runs
+ * before the document part so the sectPr can bind them.
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { appendInOrder, SECTPR_ORDER } from '../ordering.js';
+/** US Letter, in twentieths of a point. */
+const DEFAULT_PAGE = { w: 12240, h: 15840 };
+/** One-inch page margins, half-inch header/footer offsets, no gutter. */
+const DEFAULT_MARGINS = {
+    top: 1440,
+    right: 1440,
+    bottom: 1440,
+    left: 1440,
+    header: 720,
+    footer: 720,
+    gutter: 0,
+};
+/**
+ * Build the w:sectPr element for a section.
+ *
+ * Width/height are always emitted explicitly (never reader defaults); a
+ * landscape request swaps the dimensions and sets w:orient. Header/footer
+ * references lead the child sequence; w:titlePg is implied whenever a
+ * first-page header or footer is present.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.13
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.12
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.6
+ */
+export function buildSectPr(doc, section, refs) {
+    const sectPr = createWmlElement(doc, W.sectPr);
+    const props = new Map();
+    if (refs) {
+        const headerRefs = buildReferences(doc, W.headerReference, refs.headers);
+        const footerRefs = buildReferences(doc, W.footerReference, refs.footers);
+        if (headerRefs.length > 0)
+            props.set(W.headerReference, headerRefs);
+        if (footerRefs.length > 0)
+            props.set(W.footerReference, footerRefs);
+    }
+    if (section.breakType !== undefined) {
+        props.set(W.type, createWmlElement(doc, W.type, { 'w:val': section.breakType }));
+    }
+    props.set(W.pgSz, buildPgSz(doc, section));
+    props.set(W.pgMar, buildPgMar(doc, section));
+    if (section.pageNumbering) {
+        const attrs = {};
+        if (section.pageNumbering.start !== undefined)
+            attrs['w:start'] = String(section.pageNumbering.start);
+        if (section.pageNumbering.format !== undefined)
+            attrs['w:fmt'] = section.pageNumbering.format;
+        props.set(W.pgNumType, createWmlElement(doc, W.pgNumType, attrs));
+    }
+    if (titlePgImplied(section)) {
+        props.set(W.titlePg, createWmlElement(doc, W.titlePg));
+    }
+    appendInOrder(sectPr, props, SECTPR_ORDER);
+    return sectPr;
+}
+export function titlePgImplied(section) {
+    return Boolean(section.titlePg || section.headers?.first || section.footers?.first);
+}
+/**
+ * One reference element per declared header/footer slot, in a fixed
+ * first/default/even emission order so output is deterministic.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.5
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.2
+ */
+function buildReferences(doc, localName, slots) {
+    const out = [];
+    for (const type of ['first', 'default', 'even']) {
+        const rId = slots[type];
+        if (!rId)
+            continue;
+        const el = createWmlElement(doc, localName, { 'w:type': type });
+        el.setAttributeNS(OOXML.R_NS, 'r:id', rId);
+        out.push(el);
+    }
+    return out;
+}
+function buildPgSz(doc, section) {
+    const requested = section.page?.sizeTwips ?? DEFAULT_PAGE;
+    const landscape = section.page?.orientation === 'landscape';
+    const w = landscape ? Math.max(requested.w, requested.h) : requested.w;
+    const h = landscape ? Math.min(requested.w, requested.h) : requested.h;
+    const attrs = { 'w:w': String(w), 'w:h': String(h) };
+    if (landscape)
+        attrs['w:orient'] = 'landscape';
+    return createWmlElement(doc, W.pgSz, attrs);
+}
+/**
+ * The full attribute set (top/right/bottom/left/header/footer/gutter) is
+ * always emitted because readers diverge in their defaults when attributes
+ * are omitted.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.11
+ */
+function buildPgMar(doc, section) {
+    const margins = { ...DEFAULT_MARGINS, ...section.page?.marginsTwips };
+    return createWmlElement(doc, W.pgMar, {
+        'w:top': String(margins.top),
+        'w:right': String(margins.right),
+        'w:bottom': String(margins.bottom),
+        'w:left': String(margins.left),
+        'w:header': String(margins.header),
+        'w:footer': String(margins.footer),
+        'w:gutter': String(margins.gutter),
+    });
+}
+//# sourceMappingURL=section.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * word/settings.xml emitter.
+ *
+ * Only emitted when the document actually needs a setting: `w:evenAndOddHeaders`
+ * for any section declaring an even-page header or footer, or
+ * `w:clrSchemeMapping` when theme-relative authoring or a custom theme is used.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.1
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+export declare function emitSettingsPartIfNeeded(spec: DocumentSpec, ctx: CompileContext): void;
+//# sourceMappingURL=settings-part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/settings-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAa,YAAY,EAA6B,MAAM,aAAa,CAAC;AAKtF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA6BtF"}