@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/generation/emit/properties.js

@@ -0,0 +1,138 @@
+/**
+ * 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) {
+    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) {
+        children.set(W.color, createWmlElement(doc, W.color, { 'w:val': props.colorHex }));
+    }
+    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.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,15 @@
+/**
+ * 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';
+/** Build the w:r element(s) for one inline spec node. */
+export declare function buildInlineRuns(doc: Document, inline: InlineSpec): 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;AAqCnE,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,CAsB5E"}

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, ...children) {
+    const run = createWmlElement(doc, W.r);
+    const rPr = buildRunPropsElement(doc, props);
+    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) {
+    const instr = createWmlElement(doc, W.instrText);
+    instr.setAttribute('xml:space', 'preserve');
+    instr.appendChild(doc.createTextNode(FIELD_INSTRUCTION_TEXT[field.field]));
+    return [
+        makeRun(doc, field, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'begin' })),
+        makeRun(doc, field, instr),
+        makeRun(doc, field, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'separate' })),
+        makeRun(doc, field, createWmlTextElement(doc, field.cachedResult)),
+        makeRun(doc, field, createWmlElement(doc, W.fldChar, { 'w:fldCharType': 'end' })),
+    ];
+}
+/** Build the w:r element(s) for one inline spec node. */
+export function buildInlineRuns(doc, inline) {
+    switch (inline.kind) {
+        case 'text': {
+            const run = createWmlElement(doc, W.r);
+            const rPr = buildRunPropsElement(doc, inline);
+            if (rPr)
+                run.appendChild(rPr);
+            run.appendChild(createWmlTextElement(doc, inline.text));
+            return [run];
+        }
+        case 'field':
+            return buildFieldRuns(doc, inline);
+        case 'tab':
+            return [makeRun(doc, {}, createWmlElement(doc, W.tab))];
+        case 'break': {
+            const attrs = inline.breakType === 'page' ? { 'w:type': 'page' } : undefined;
+            return [makeRun(doc, {}, 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 — today that is
+ * `w:evenAndOddHeaders`, required for any section declaring an even-page
+ * header or footer (without it readers ignore the even-page parts entirely).
+ *
+ * @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,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAQtF"}

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

@@ -0,0 +1,24 @@
+/**
+ * word/settings.xml emitter.
+ *
+ * Only emitted when the document actually needs a setting — today that is
+ * `w:evenAndOddHeaders`, required for any section declaring an even-page
+ * header or footer (without it readers ignore the even-page parts entirely).
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.1
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+const SETTINGS_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml';
+const SETTINGS_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings';
+export function emitSettingsPartIfNeeded(spec, ctx) {
+    const needsEvenOdd = spec.sections.some((s) => s.headers?.even || s.footers?.even);
+    if (!needsEvenOdd)
+        return;
+    ctx.registerPart('word/settings.xml', SETTINGS_CONTENT_TYPE, SETTINGS_REL_TYPE);
+    const doc = parseXml(`<w:settings xmlns:w="${OOXML.W_NS}"/>`);
+    doc.documentElement.appendChild(createWmlElement(doc, W.evenAndOddHeaders));
+    ctx.setFileContent('word/settings.xml', XML_DECL + serializeXml(doc));
+}
+//# sourceMappingURL=settings-part.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-part.js","sourceRoot":"","sources":["../../../src/generation/emit/settings-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAI3E,MAAM,qBAAqB,GAAG,6EAA6E,CAAC;AAC5G,MAAM,iBAAiB,GAAG,8EAA8E,CAAC;AAEzG,MAAM,UAAU,wBAAwB,CAAC,IAAkB,EAAE,GAAmB;IAC9E,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnF,IAAI,CAAC,YAAY;QAAE,OAAO;IAE1B,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;IAChF,MAAM,GAAG,GAAG,QAAQ,CAAC,wBAAwB,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;IAC9D,GAAG,CAAC,eAAgB,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC7E,GAAG,CAAC,cAAc,CAAC,mBAAmB,EAAE,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AACxE,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * word/styles.xml emitter.
+ *
+ * Always emitted: document defaults, the Normal paragraph style, and every
+ * declared StyleSpec. Style pPr/rPr go through the same shared property
+ * builders as direct formatting (emit/properties.ts), so a style definition
+ * and an inline run can never disagree on how a property serializes.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.7.4.18
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+export declare const STYLES_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml";
+export declare const STYLES_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+export declare function emitStylesPart(spec: DocumentSpec, ctx: CompileContext): void;
+//# sourceMappingURL=styles-part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/styles-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAG3D,eAAO,MAAM,mBAAmB,8EAA8E,CAAC;AAC/G,eAAO,MAAM,eAAe,+EAA+E,CAAC;AAQ5G,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAa5E"}

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

@@ -0,0 +1,80 @@
+/**
+ * word/styles.xml emitter.
+ *
+ * Always emitted: document defaults, the Normal paragraph style, and every
+ * declared StyleSpec. Style pPr/rPr go through the same shared property
+ * builders as direct formatting (emit/properties.ts), so a style definition
+ * and an inline run can never disagree on how a property serializes.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.7.4.18
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+import { buildParagraphPropsElement, buildRunPropsElement, styleParagraphProps } from './properties.js';
+export const STYLES_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml';
+export const STYLES_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles';
+const STYLES_SKELETON = `<w:styles xmlns:w="${OOXML.W_NS}"/>`;
+/** Default run properties for docDefaults: Calibri 11pt, matching Word's baseline. */
+const DEFAULT_FONT = 'Calibri';
+const DEFAULT_SIZE_HALF_POINTS = '22';
+export function emitStylesPart(spec, ctx) {
+    ctx.registerPart('word/styles.xml', STYLES_CONTENT_TYPE, STYLES_REL_TYPE);
+    const doc = parseXml(STYLES_SKELETON);
+    const root = doc.documentElement;
+    root.appendChild(buildDocDefaults(doc));
+    root.appendChild(buildNormalStyle(doc));
+    for (const style of spec.styles ?? []) {
+        root.appendChild(buildStyle(doc, style));
+    }
+    ctx.setFileContent('word/styles.xml', XML_DECL + serializeXml(doc));
+}
+/** @conformance ECMA-376 edition 5, Part 1 § 17.7.5.1 */
+function buildDocDefaults(doc) {
+    const docDefaults = createWmlElement(doc, W.docDefaults);
+    const rPrDefault = createWmlElement(doc, W.rPrDefault);
+    const rPr = createWmlElement(doc, W.rPr);
+    rPr.appendChild(createWmlElement(doc, W.rFonts, {
+        'w:ascii': DEFAULT_FONT,
+        'w:hAnsi': DEFAULT_FONT,
+        'w:cs': DEFAULT_FONT,
+    }));
+    rPr.appendChild(createWmlElement(doc, W.sz, { 'w:val': DEFAULT_SIZE_HALF_POINTS }));
+    rPr.appendChild(createWmlElement(doc, W.szCs, { 'w:val': DEFAULT_SIZE_HALF_POINTS }));
+    rPrDefault.appendChild(rPr);
+    docDefaults.appendChild(rPrDefault);
+    const pPrDefault = createWmlElement(doc, W.pPrDefault);
+    docDefaults.appendChild(pPrDefault);
+    return docDefaults;
+}
+function buildNormalStyle(doc) {
+    const style = createWmlElement(doc, W.style, { 'w:type': 'paragraph', 'w:styleId': 'Normal', 'w:default': '1' });
+    style.appendChild(createWmlElement(doc, W.name, { 'w:val': 'Normal' }));
+    style.appendChild(createWmlElement(doc, W.qFormat));
+    return style;
+}
+/** @conformance ECMA-376 edition 5, Part 1 § 17.7.4.17 */
+function buildStyle(doc, spec) {
+    const style = createWmlElement(doc, W.style, { 'w:type': spec.type, 'w:styleId': spec.styleId });
+    style.appendChild(createWmlElement(doc, W.name, { 'w:val': spec.name }));
+    if (spec.basedOn !== undefined) {
+        style.appendChild(createWmlElement(doc, W.basedOn, { 'w:val': spec.basedOn }));
+    }
+    if (spec.next !== undefined) {
+        style.appendChild(createWmlElement(doc, W.next, { 'w:val': spec.next }));
+    }
+    style.appendChild(createWmlElement(doc, W.qFormat));
+    // CT_Style declares pPr before rPr.
+    if (spec.paragraph) {
+        const pPr = buildParagraphPropsElement(doc, styleParagraphProps(spec));
+        if (pPr)
+            style.appendChild(pPr);
+    }
+    if (spec.run) {
+        const rPr = buildRunPropsElement(doc, spec.run);
+        if (rPr)
+            style.appendChild(rPr);
+    }
+    return style;
+}
+//# sourceMappingURL=styles-part.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Table emitter.
+ *
+ * Compiles TableSpec nodes into w:tbl structures: table-level properties and
+ * the column grid, then rows and cells. Cell content reuses the paragraph
+ * emitter, and nested tables recurse through buildTable. Two invariants are
+ * enforced by construction rather than checked after the fact:
+ *
+ *  - every cell ends with a w:p (readers treat a cell whose last block is a
+ *    table as corrupt), and
+ *  - cell widths always come from somewhere deterministic — an explicit
+ *    widthTwips, or the sum of the grid columns the cell spans.
+ */
+import type { BlockSpec, TableSpec } from '../types.js';
+import type { BlockEmitContext } from './emit-context.js';
+/**
+ * Build the w:tbl element for a table block.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.37
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.59
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ */
+export declare function buildTable(doc: Document, table: TableSpec, ctx?: BlockEmitContext): Element;
+/** Dispatch a block-level spec node to its emitter (cells hold both kinds). */
+export declare function buildBlock(doc: Document, block: BlockSpec, ctx?: BlockEmitContext): Element;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAyD,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAQ3F;AAmID,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAE3F"}