@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/generation/emit/table.js

@@ -0,0 +1,196 @@
+/**
+ * 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 { createWmlElement } from '../../primitives/dom-helpers.js';
+import { W } from '../../primitives/namespaces.js';
+import { appendInOrder, TBLPR_ORDER, TCPR_ORDER, TRPR_ORDER } from '../ordering.js';
+import { buildParagraph } from './paragraph.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 function buildTable(doc, table, ctx) {
+    const tbl = createWmlElement(doc, W.tbl);
+    tbl.appendChild(buildTblPr(doc, table));
+    tbl.appendChild(buildTblGrid(doc, table));
+    for (const row of table.rows) {
+        tbl.appendChild(buildRow(doc, table, row, ctx));
+    }
+    return tbl;
+}
+/**
+ * Table-level properties. w:tblW always carries the dxa sum of the declared
+ * grid so the preferred width and the grid agree, and w:tblLayout is always
+ * emitted explicitly (fixed by default) because autofit is the reader-side
+ * default and silently reflows fixed designs.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.63
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.52
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.38
+ */
+function buildTblPr(doc, table) {
+    const tblPr = createWmlElement(doc, W.tblPr);
+    const props = new Map();
+    const widthSum = table.columnWidthsTwips.reduce((sum, w) => sum + w, 0);
+    props.set(W.tblW, createWmlElement(doc, W.tblW, { 'w:w': String(widthSum), 'w:type': 'dxa' }));
+    if (table.borders) {
+        props.set(W.tblBorders, buildBordersElement(doc, W.tblBorders, table.borders));
+    }
+    props.set(W.tblLayout, createWmlElement(doc, W.tblLayout, { 'w:type': table.layout ?? 'fixed' }));
+    appendInOrder(tblPr, props, TBLPR_ORDER);
+    return tblPr;
+}
+/**
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.16
+ */
+function buildTblGrid(doc, table) {
+    const tblGrid = createWmlElement(doc, W.tblGrid);
+    for (const width of table.columnWidthsTwips) {
+        tblGrid.appendChild(createWmlElement(doc, W.gridCol, { 'w:w': String(width) }));
+    }
+    return tblGrid;
+}
+/**
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.78
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.80
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.49
+ */
+function buildRow(doc, table, row, ctx) {
+    const tr = createWmlElement(doc, W.tr);
+    const props = new Map();
+    if (row.heightTwips !== undefined) {
+        props.set(W.trHeight, createWmlElement(doc, W.trHeight, {
+            'w:val': String(row.heightTwips),
+            'w:hRule': row.heightRule ?? 'atLeast',
+        }));
+    }
+    if (row.header) {
+        props.set(W.tblHeader, createWmlElement(doc, W.tblHeader));
+    }
+    if (props.size > 0) {
+        const trPr = createWmlElement(doc, W.trPr);
+        appendInOrder(trPr, props, TRPR_ORDER);
+        tr.appendChild(trPr);
+    }
+    let gridOffset = 0;
+    for (const cell of row.cells) {
+        const span = cell.gridSpan ?? 1;
+        tr.appendChild(buildCell(doc, table, cell, gridOffset, ctx));
+        gridOffset += span;
+    }
+    return tr;
+}
+/**
+ * Cell properties in TCPR_ORDER, then cell content. An unspecified width
+ * falls back to the sum of the spanned grid columns; a vertical-merge
+ * continuation is the bare element form Word itself writes.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.65
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.69
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.71
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.84
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.32
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.83
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.68
+ */
+function buildCell(doc, table, cell, gridOffset, ctx) {
+    const tc = createWmlElement(doc, W.tc);
+    const tcPr = createWmlElement(doc, W.tcPr);
+    const props = new Map();
+    const span = cell.gridSpan ?? 1;
+    const width = cell.widthTwips ?? table.columnWidthsTwips.slice(gridOffset, gridOffset + span).reduce((sum, w) => sum + w, 0);
+    props.set(W.tcW, createWmlElement(doc, W.tcW, { 'w:w': String(width), 'w:type': 'dxa' }));
+    if (cell.gridSpan !== undefined && cell.gridSpan > 1) {
+        props.set(W.gridSpan, createWmlElement(doc, W.gridSpan, { 'w:val': String(cell.gridSpan) }));
+    }
+    if (cell.vMerge !== undefined) {
+        props.set(W.vMerge, cell.vMerge === 'restart' ? createWmlElement(doc, W.vMerge, { 'w:val': 'restart' }) : createWmlElement(doc, W.vMerge));
+    }
+    if (cell.borders) {
+        props.set(W.tcBorders, buildBordersElement(doc, W.tcBorders, cell.borders));
+    }
+    if (cell.shadingHex !== undefined) {
+        props.set(W.shd, createWmlElement(doc, W.shd, { 'w:val': 'clear', 'w:color': 'auto', 'w:fill': cell.shadingHex }));
+    }
+    if (cell.marginsTwips) {
+        props.set(W.tcMar, buildCellMargins(doc, cell.marginsTwips));
+    }
+    if (cell.vAlign !== undefined) {
+        props.set(W.vAlign, createWmlElement(doc, W.vAlign, { 'w:val': cell.vAlign }));
+    }
+    appendInOrder(tcPr, props, TCPR_ORDER);
+    tc.appendChild(tcPr);
+    for (const block of cell.blocks) {
+        tc.appendChild(buildBlock(doc, block, ctx));
+    }
+    // A cell must end with a paragraph: readers reject a cell that is empty or
+    // whose last block is a table.
+    const last = cell.blocks[cell.blocks.length - 1];
+    if (!last || last.kind === 'table') {
+        tc.appendChild(createWmlElement(doc, W.p));
+    }
+    return tc;
+}
+/** Dispatch a block-level spec node to its emitter (cells hold both kinds). */
+export function buildBlock(doc, block, ctx) {
+    return block.kind === 'table' ? buildTable(doc, block, ctx) : buildParagraph(doc, block, ctx);
+}
+/**
+ * Border collection in CT_TblBorders / CT_TcBorders schema order. Every edge
+ * present in the spec is emitted with explicit size/space/color so readers
+ * don't fall back to divergent defaults.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.66
+ */
+function buildBordersElement(doc, localName, borders) {
+    const container = createWmlElement(doc, localName);
+    const edges = [
+        [W.top, borders.top],
+        [W.left, borders.left],
+        [W.bottom, borders.bottom],
+        [W.right, borders.right],
+        [W.insideH, borders.insideH],
+        [W.insideV, borders.insideV],
+    ];
+    for (const [edge, spec] of edges) {
+        if (!spec)
+            continue;
+        container.appendChild(createWmlElement(doc, edge, {
+            'w:val': spec.style,
+            'w:sz': String(spec.style === 'none' ? 0 : (spec.sizeEighthPt ?? 4)),
+            'w:space': '0',
+            'w:color': spec.colorHex ?? 'auto',
+        }));
+    }
+    return container;
+}
+function buildCellMargins(doc, margins) {
+    const tcMar = createWmlElement(doc, W.tcMar);
+    const edges = [
+        [W.top, margins.top],
+        [W.left, margins.left],
+        [W.bottom, margins.bottom],
+        [W.right, margins.right],
+    ];
+    for (const [edge, value] of edges) {
+        if (value === undefined)
+            continue;
+        tcMar.appendChild(createWmlElement(doc, edge, { 'w:w': String(value), 'w:type': 'dxa' }));
+    }
+    return tcMar;
+}
+//# sourceMappingURL=table.js.map

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

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

package/dist/generation/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Typed errors for the generation compiler.
+ *
+ * GenerationSpecError reports problems in the caller's DocumentSpec (dangling
+ * references, unimplemented features, shape violations) with a JSON-pointer-ish
+ * path into the spec so callers can surface the exact offending node.
+ *
+ * GenerationInternalError flags compiler bugs (e.g. an emitter producing a
+ * property name missing from its ordering table); it should never be reachable
+ * from user input that passed spec validation.
+ */
+export type GenerationSpecErrorCode = 'empty_sections' | 'unsupported_feature' | 'dangling_style_reference' | 'dangling_numbering_reference' | 'invalid_value' | 'grid_mismatch';
+export declare class GenerationSpecError extends Error {
+    readonly code: GenerationSpecErrorCode;
+    /** Path into the spec, e.g. '/sections/0/blocks/2/runs/1'. */
+    readonly path: string;
+    constructor(code: GenerationSpecErrorCode, path: string, message: string);
+}
+export declare class GenerationInternalError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/generation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/generation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,uBAAuB,GAC/B,gBAAgB,GAChB,qBAAqB,GACrB,0BAA0B,GAC1B,8BAA8B,GAC9B,eAAe,GACf,eAAe,CAAC;AAEpB,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAMzE;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/generation/errors.js

@@ -0,0 +1,29 @@
+/**
+ * Typed errors for the generation compiler.
+ *
+ * GenerationSpecError reports problems in the caller's DocumentSpec (dangling
+ * references, unimplemented features, shape violations) with a JSON-pointer-ish
+ * path into the spec so callers can surface the exact offending node.
+ *
+ * GenerationInternalError flags compiler bugs (e.g. an emitter producing a
+ * property name missing from its ordering table); it should never be reachable
+ * from user input that passed spec validation.
+ */
+export class GenerationSpecError extends Error {
+    code;
+    /** Path into the spec, e.g. '/sections/0/blocks/2/runs/1'. */
+    path;
+    constructor(code, path, message) {
+        super(`${message} (at ${path})`);
+        this.name = 'GenerationSpecError';
+        this.code = code;
+        this.path = path;
+    }
+}
+export class GenerationInternalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GenerationInternalError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/generation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/generation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAA0B;IACvC,8DAA8D;IACrD,IAAI,CAAS;IAEtB,YAAY,IAA6B,EAAE,IAAY,EAAE,OAAe;QACtE,KAAK,CAAC,GAAG,OAAO,QAAQ,IAAI,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/generation/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * From-scratch DOCX generation (OpenSpec capability: docx-generation).
+ *
+ * Re-exported from the package root since the final phase of the
+ * add-docx-generation change, with the cross-reader compatibility matrix
+ * recorded in docs/generation-manual-compat-checklist.md.
+ */
+export { generateDocx, type GenerateDocxOptions } from './compile.js';
+export { GenerationSpecError, GenerationInternalError, type GenerationSpecErrorCode } from './errors.js';
+export { checkGeneratedPackage, type StructuralCheckResult, type StructuralIssue } from './structural-checks.js';
+export { coverTermsTable, signatureBlock, type CoverTermsOptions, type SignatureBlockOptions } from './recipes.js';
+export type { BlockSpec, BorderSpec, BreakSpec, DocumentMetaSpec, DocumentSpec, DraftingNoteSpec, FieldSpec, HeaderFooterSet, HeaderFooterSpec, InlineSpec, NumberingSpec, ParagraphSpec, RunProps, RunSpec, SectionSpec, StyleSpec, TableBorders, TableCellSpec, TableRowSpec, TableSpec, TabSpec, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnH,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,aAAa,EACb,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/generation/index.js

@@ -0,0 +1,12 @@
+/**
+ * From-scratch DOCX generation (OpenSpec capability: docx-generation).
+ *
+ * Re-exported from the package root since the final phase of the
+ * add-docx-generation change, with the cross-reader compatibility matrix
+ * recorded in docs/generation-manual-compat-checklist.md.
+ */
+export { generateDocx } from './compile.js';
+export { GenerationSpecError, GenerationInternalError } from './errors.js';
+export { checkGeneratedPackage } from './structural-checks.js';
+export { coverTermsTable, signatureBlock } from './recipes.js';
+//# sourceMappingURL=index.js.map

package/dist/generation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAA4B,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAgC,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAoD,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAsD,MAAM,cAAc,CAAC"}

package/dist/generation/ordering.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Property-order discipline for emitted OOXML property containers.
+ *
+ * Each table lists the subset of child local names the generation emitters
+ * produce, in the relative order the WML schema sequence declares. Emitters
+ * never appendChild properties directly — they collect them into a map and
+ * call appendInOrder, which throws on any name missing from its table so
+ * adding a new property forces a conscious ordering decision.
+ */
+/**
+ * Child order for w:pPr (CT_PPr). Subset actually emitted, in schema-relative
+ * order; w:rPr (paragraph-mark run properties) precedes w:sectPr at the end.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.26
+ */
+export declare const PPR_ORDER: readonly ["pStyle", "keepNext", "keepLines", "pageBreakBefore", "widowControl", "numPr", "pBdr", "shd", "tabs", "spacing", "ind", "contextualSpacing", "jc", "rPr", "sectPr"];
+/**
+ * Child order for w:rPr (CT_RPr / EG_RPrBase). Subset actually emitted.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.2.28
+ */
+export declare const RPR_ORDER: readonly ["rStyle", "rFonts", "b", "bCs", "i", "iCs", "caps", "smallCaps", "strike", "vanish", "color", "sz", "szCs", "highlight", "u", "vertAlign"];
+/** Child order for w:sectPr (CT_SectPr). Header/footer references lead. */
+export declare const SECTPR_ORDER: readonly ["headerReference", "footerReference", "type", "pgSz", "pgMar", "pgNumType", "titlePg", "docGrid"];
+/** Child order for w:tblPr (CT_TblPr). */
+export declare const TBLPR_ORDER: readonly ["tblStyle", "tblW", "jc", "tblBorders", "tblLayout", "tblCellMar", "tblLook"];
+/**
+ * Child order for w:trPr (CT_TrPrBase). Subset actually emitted.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.81
+ */
+export declare const TRPR_ORDER: readonly ["trHeight", "tblHeader"];
+/** Child order for w:tcPr (CT_TcPr). */
+export declare const TCPR_ORDER: readonly ["tcW", "gridSpan", "vMerge", "tcBorders", "shd", "tcMar", "vAlign"];
+export type PropMap = ReadonlyMap<string, Element | Element[]>;
+/**
+ * Append collected property elements to a container in the order declared by
+ * the table. Repeatable properties (e.g. w:headerReference) are passed as
+ * arrays and appended in collection order at their slot.
+ *
+ * Throws GenerationInternalError when the map contains a local name absent
+ * from the order table — ordering bugs fail loudly at build time instead of
+ * producing schema-invalid output.
+ */
+export declare function appendInOrder(container: Element, props: PropMap, order: readonly string[]): void;
+//# sourceMappingURL=ordering.d.ts.map

package/dist/generation/ordering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.d.ts","sourceRoot":"","sources":["../../src/generation/ordering.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,+KAgBZ,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,SAAS,sJAiBZ,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,YAAY,6GASf,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,WAAW,yFAQd,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,UAAU,oCAAqC,CAAC;AAE7D,wCAAwC;AACxC,eAAO,MAAM,UAAU,+EAQb,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAehG"}

package/dist/generation/ordering.js

@@ -0,0 +1,119 @@
+/**
+ * Property-order discipline for emitted OOXML property containers.
+ *
+ * Each table lists the subset of child local names the generation emitters
+ * produce, in the relative order the WML schema sequence declares. Emitters
+ * never appendChild properties directly — they collect them into a map and
+ * call appendInOrder, which throws on any name missing from its table so
+ * adding a new property forces a conscious ordering decision.
+ */
+import { GenerationInternalError } from './errors.js';
+/**
+ * Child order for w:pPr (CT_PPr). Subset actually emitted, in schema-relative
+ * order; w:rPr (paragraph-mark run properties) precedes w:sectPr at the end.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.26
+ */
+export const PPR_ORDER = [
+    'pStyle',
+    'keepNext',
+    'keepLines',
+    'pageBreakBefore',
+    'widowControl',
+    'numPr',
+    'pBdr',
+    'shd',
+    'tabs',
+    'spacing',
+    'ind',
+    'contextualSpacing',
+    'jc',
+    'rPr',
+    'sectPr',
+];
+/**
+ * Child order for w:rPr (CT_RPr / EG_RPrBase). Subset actually emitted.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.2.28
+ */
+export const RPR_ORDER = [
+    'rStyle',
+    'rFonts',
+    'b',
+    'bCs',
+    'i',
+    'iCs',
+    'caps',
+    'smallCaps',
+    'strike',
+    'vanish',
+    'color',
+    'sz',
+    'szCs',
+    'highlight',
+    'u',
+    'vertAlign',
+];
+/** Child order for w:sectPr (CT_SectPr). Header/footer references lead. */
+export const SECTPR_ORDER = [
+    'headerReference',
+    'footerReference',
+    'type',
+    'pgSz',
+    'pgMar',
+    'pgNumType',
+    'titlePg',
+    'docGrid',
+];
+/** Child order for w:tblPr (CT_TblPr). */
+export const TBLPR_ORDER = [
+    'tblStyle',
+    'tblW',
+    'jc',
+    'tblBorders',
+    'tblLayout',
+    'tblCellMar',
+    'tblLook',
+];
+/**
+ * Child order for w:trPr (CT_TrPrBase). Subset actually emitted.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.81
+ */
+export const TRPR_ORDER = ['trHeight', 'tblHeader'];
+/** Child order for w:tcPr (CT_TcPr). */
+export const TCPR_ORDER = [
+    'tcW',
+    'gridSpan',
+    'vMerge',
+    'tcBorders',
+    'shd',
+    'tcMar',
+    'vAlign',
+];
+/**
+ * Append collected property elements to a container in the order declared by
+ * the table. Repeatable properties (e.g. w:headerReference) are passed as
+ * arrays and appended in collection order at their slot.
+ *
+ * Throws GenerationInternalError when the map contains a local name absent
+ * from the order table — ordering bugs fail loudly at build time instead of
+ * producing schema-invalid output.
+ */
+export function appendInOrder(container, props, order) {
+    for (const name of props.keys()) {
+        if (!order.includes(name)) {
+            throw new GenerationInternalError(`Property '${name}' is not declared in the ordering table for <${container.tagName}>; ` +
+                'add it to the table in schema order before emitting it');
+        }
+    }
+    for (const name of order) {
+        const value = props.get(name);
+        if (!value)
+            continue;
+        const elements = Array.isArray(value) ? value : [value];
+        for (const el of elements)
+            container.appendChild(el);
+    }
+}
+//# sourceMappingURL=ordering.js.map

package/dist/generation/ordering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.js","sourceRoot":"","sources":["../../src/generation/ordering.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ;IACR,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,cAAc;IACd,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;IACN,SAAS;IACT,KAAK;IACL,mBAAmB;IACnB,IAAI;IACJ,KAAK;IACL,QAAQ;CACA,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ;IACR,QAAQ;IACR,GAAG;IACH,KAAK;IACL,GAAG;IACH,KAAK;IACL,MAAM;IACN,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,IAAI;IACJ,MAAM;IACN,WAAW;IACX,GAAG;IACH,WAAW;CACH,CAAC;AAEX,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,iBAAiB;IACjB,iBAAiB;IACjB,MAAM;IACN,MAAM;IACN,OAAO;IACP,WAAW;IACX,SAAS;IACT,SAAS;CACD,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU;IACV,MAAM;IACN,IAAI;IACJ,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,SAAS;CACD,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,WAAW,CAAU,CAAC;AAE7D,wCAAwC;AACxC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK;IACL,UAAU;IACV,QAAQ;IACR,WAAW;IACX,KAAK;IACL,OAAO;IACP,QAAQ;CACA,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,SAAkB,EAAE,KAAc,EAAE,KAAwB;IACxF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,uBAAuB,CAC/B,aAAa,IAAI,gDAAgD,SAAS,CAAC,OAAO,KAAK;gBACrF,wDAAwD,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxD,KAAK,MAAM,EAAE,IAAI,QAAQ;YAAE,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/generation/recipes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Legal-document recipes.
+ *
+ * Pure functions producing spec nodes from options — no own OOXML
+ * representation, no compiler hooks. Everything a recipe returns is built
+ * from the paragraph/table grammar, so its output is inlineable anywhere a
+ * BlockSpec is accepted and serializes through exactly the emitters the
+ * rest of the document uses. Signature lines are bottom-bordered cells, not
+ * VML shapes: Pages and Google Docs mangle VML, borders survive everywhere.
+ */
+import type { BlockSpec, TableSpec } from './types.js';
+export type CoverTermsOptions = {
+    /** Label/value pairs, rendered one row each in declaration order. */
+    terms: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Two-column widths in twips; defaults to a 2880/6480 split of a 6.5" body. */
+    columnWidthsTwips?: [number, number];
+    /** Heading text for a shaded full-width header row; omitted when absent. */
+    title?: string;
+};
+/**
+ * A fixed-layout two-column label/value table for cover-terms blocks
+ * (scenario SDX-GEN-070).
+ */
+export declare function coverTermsTable(options: CoverTermsOptions): TableSpec;
+export type SignatureBlockOptions = {
+    parties: Array<{
+        /** Party heading above the signature line, e.g. the company name. */
+        party: string;
+        /** Signatory name printed under the line. */
+        name: string;
+        title?: string;
+        /** Label for the date row; defaults to 'Date:'. */
+        dateLabel?: string;
+    }>;
+    /** Signature-line column width in twips; defaults to 4320 (3"). */
+    lineWidthTwips?: number;
+};
+/**
+ * Signature blocks rendered as borderless single-column tables whose first
+ * content cell carries only a bottom border — the signature line — followed
+ * by name, title, and date rows (scenario SDX-GEN-071). No VML, no images.
+ */
+export declare function signatureBlock(options: SignatureBlockOptions): BlockSpec[];
+//# sourceMappingURL=recipes.d.ts.map

package/dist/generation/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/generation/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA6B,SAAS,EAAE,MAAM,YAAY,CAAC;AAIlF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qEAAqE;IACrE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CA+BrE;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,qEAAqE;QACrE,KAAK,EAAE,MAAM,CAAC;QACd,6CAA6C;QAC7C,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAsB1E"}

package/dist/generation/recipes.js

@@ -0,0 +1,84 @@
+/**
+ * Legal-document recipes.
+ *
+ * Pure functions producing spec nodes from options — no own OOXML
+ * representation, no compiler hooks. Everything a recipe returns is built
+ * from the paragraph/table grammar, so its output is inlineable anywhere a
+ * BlockSpec is accepted and serializes through exactly the emitters the
+ * rest of the document uses. Signature lines are bottom-bordered cells, not
+ * VML shapes: Pages and Google Docs mangle VML, borders survive everywhere.
+ */
+const SINGLE = { style: 'single' };
+/**
+ * A fixed-layout two-column label/value table for cover-terms blocks
+ * (scenario SDX-GEN-070).
+ */
+export function coverTermsTable(options) {
+    const [labelWidth, valueWidth] = options.columnWidthsTwips ?? [2880, 6480];
+    const rows = [];
+    if (options.title !== undefined) {
+        rows.push({
+            header: true,
+            cells: [
+                {
+                    gridSpan: 2,
+                    shadingHex: 'D9D9D9',
+                    vAlign: 'center',
+                    blocks: [paragraph(options.title, { bold: true, alignment: 'center' })],
+                },
+            ],
+        });
+    }
+    for (const term of options.terms) {
+        rows.push({
+            cells: [
+                { blocks: [paragraph(term.label, { bold: true })] },
+                { blocks: [paragraph(term.value)] },
+            ],
+        });
+    }
+    return {
+        kind: 'table',
+        layout: 'fixed',
+        columnWidthsTwips: [labelWidth, valueWidth],
+        borders: { top: SINGLE, bottom: SINGLE, left: SINGLE, right: SINGLE, insideH: SINGLE, insideV: SINGLE },
+        rows,
+    };
+}
+/**
+ * Signature blocks rendered as borderless single-column tables whose first
+ * content cell carries only a bottom border — the signature line — followed
+ * by name, title, and date rows (scenario SDX-GEN-071). No VML, no images.
+ */
+export function signatureBlock(options) {
+    const width = options.lineWidthTwips ?? 4320;
+    const blocks = [];
+    options.parties.forEach((party, index) => {
+        if (index > 0)
+            blocks.push(paragraph(''));
+        blocks.push(paragraph(party.party, { bold: true }));
+        const rows = [
+            { cells: [{ borders: { bottom: SINGLE }, blocks: [paragraph('')] }] },
+            { cells: [{ blocks: [paragraph(`Name: ${party.name}`)] }] },
+        ];
+        if (party.title !== undefined) {
+            rows.push({ cells: [{ blocks: [paragraph(`Title: ${party.title}`)] }] });
+        }
+        rows.push({ cells: [{ blocks: [paragraph(party.dateLabel ?? 'Date:')] }] });
+        blocks.push({
+            kind: 'table',
+            layout: 'fixed',
+            columnWidthsTwips: [width],
+            rows,
+        });
+    });
+    return blocks;
+}
+function paragraph(text, opts) {
+    return {
+        kind: 'paragraph',
+        ...(opts?.alignment !== undefined ? { alignment: opts.alignment } : {}),
+        runs: [{ kind: 'text', text, ...(opts?.bold ? { bold: true } : {}) }],
+    };
+}
+//# sourceMappingURL=recipes.js.map

package/dist/generation/recipes.js.map

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

package/dist/generation/structural-checks.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Post-build structural validation of a generated package — the
+ * "no recovery dialog" gate. Each check targets a concrete repair trigger in
+ * reading applications: missing content types, dangling relationship targets,
+ * unresolvable r:id references, malformed section properties, and unbalanced
+ * field characters.
+ *
+ * `auditSectPr` is reused as one component: it flags duplicated or misplaced
+ * body-level sectPr and dangling header/footer references, but tolerates the
+ * zero-sectPr case (legal for parsed third-party documents), so the
+ * required-final-sectPr check lives here.
+ */
+export type StructuralIssue = {
+    check: 'xml_declaration' | 'content_type_coverage' | 'relationship_target' | 'rid_resolution' | 'sectpr' | 'field_pairing' | 'table';
+    part: string;
+    message: string;
+};
+export type StructuralCheckResult = {
+    ok: boolean;
+    issues: StructuralIssue[];
+};
+/** Run every structural check against a generated package buffer. */
+export declare function checkGeneratedPackage(buffer: Buffer): Promise<StructuralCheckResult>;
+//# sourceMappingURL=structural-checks.d.ts.map