open-agreements 0.7.6 → 0.8.0

package/node_modules/@usejunior/docx-core/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/node_modules/@usejunior/docx-core/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/node_modules/@usejunior/docx-core/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/node_modules/@usejunior/docx-core/dist/generation/recipes.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 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 CoverTermRow = {
+    label: string;
+    value: string;
+};
+export type CoverTermGroupRow = {
+    group: string;
+};
+export type CoverTermSubrow = {
+    label: string;
+    value: string;
+    subrow: true;
+};
+export type CoverTermEntry = CoverTermRow | CoverTermGroupRow | CoverTermSubrow;
+export type CoverTermsOptions = {
+    /** Plain rows, group headers, and subrows rendered in declaration order. */
+    terms: CoverTermEntry[];
+    /** 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;
+    /** Table border style; defaults to the historical full grid. */
+    borderMode?: 'grid' | 'horizontal-rules';
+    /** Optional minimum row height applied to term/group/sub rows, not the title row. */
+    rowHeightTwips?: number;
+    /** Optional uniform cell padding applied to every cover-terms cell. */
+    cellPaddingTwips?: number;
+    /** Text color for subrow labels and values; defaults to mid-gray. */
+    subrowColorHex?: string;
+    /**
+     * Extra left indent on subrow label cells, added on top of `cellPaddingTwips`
+     * (so the label sits further right than a normal row). Defaults to 240 twips.
+     */
+    subrowLabelIndentTwips?: number;
+};
+/**
+ * A fixed-layout two-column label/value table for cover-terms blocks
+ * (scenario SDX-GEN-070), with optional house-style grouped/sub rows.
+ */
+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"). Single-column only. */
+    lineWidthTwips?: number;
+    /** Layout selector. Defaults to 'single-column' (the historical behavior). */
+    layout?: 'single-column' | 'two-column';
+    /** Total grid width in twips, split across the two signer columns. Defaults to 9360 (6.5" body). */
+    totalWidthTwips?: number;
+    /** Center gutter column width between the two signer cells. Defaults to 360 (0.25"). */
+    gutterTwips?: number;
+    /** Color for the muted party header and field captions. Defaults to '595959'. */
+    headerColorHex?: string;
+    /** Captions for the four ruled lines. Defaults to ['Signature', 'Print Name', 'Title', 'Date']. */
+    ruledLineLabels?: [string, string, string, string];
+};
+/**
+ * Signature blocks rendered as borderless tables whose content cells carry
+ * only bottom borders — the signature lines. No VML, no images.
+ *
+ * Default `layout: 'single-column'` keeps the historical stacked block: one
+ * table per party, a bottom-bordered line then name/title/date rows
+ * (scenario SDX-GEN-071). With `layout: 'two-column'` the parties render as a
+ * paired signing grid — two signers per row, each a centered uppercase muted
+ * header over ruled Signature / Print Name / Title / Date lines (Print Name and
+ * Title pre-filled from the party data), with an empty padding cell when the
+ * signer count is odd (scenario SDX-GEN-109).
+ */
+export declare function signatureBlock(options: SignatureBlockOptions): BlockSpec[];
+//# sourceMappingURL=recipes.d.ts.map

package/node_modules/@usejunior/docx-core/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;AAOlF,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4EAA4E;IAC5E,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACzC,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CA4ErE;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,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;IACxC,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAyB1E"}

package/node_modules/@usejunior/docx-core/dist/generation/recipes.js

@@ -0,0 +1,232 @@
+/**
+ * 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' };
+const NONE = { style: 'none' };
+const DEFAULT_SUBROW_COLOR_HEX = '595959';
+const DEFAULT_SUBROW_LABEL_INDENT_TWIPS = 240;
+/**
+ * A fixed-layout two-column label/value table for cover-terms blocks
+ * (scenario SDX-GEN-070), with optional house-style grouped/sub rows.
+ */
+export function coverTermsTable(options) {
+    const [labelWidth, valueWidth] = options.columnWidthsTwips ?? [2880, 6480];
+    const borders = options.borderMode === 'horizontal-rules'
+        ? { top: SINGLE, bottom: SINGLE, left: NONE, right: NONE, insideH: SINGLE, insideV: NONE }
+        : { top: SINGLE, bottom: SINGLE, left: SINGLE, right: SINGLE, insideH: SINGLE, insideV: SINGLE };
+    const rowRhythm = rowRhythmProps(options);
+    const rows = [];
+    if (options.title !== undefined) {
+        rows.push({
+            header: true,
+            cells: [
+                {
+                    gridSpan: 2,
+                    shadingHex: 'D9D9D9',
+                    vAlign: 'center',
+                    ...cellPaddingProps(options),
+                    blocks: [paragraph(options.title, { bold: true, alignment: 'center' })],
+                },
+            ],
+        });
+    }
+    for (const term of options.terms) {
+        if ('group' in term) {
+            rows.push({
+                ...rowRhythm,
+                cells: [
+                    {
+                        gridSpan: 2,
+                        vAlign: 'center',
+                        ...cellPaddingProps(options),
+                        blocks: [paragraph(term.group, { bold: true })],
+                    },
+                ],
+            });
+            continue;
+        }
+        const subrow = 'subrow' in term && term.subrow === true;
+        rows.push({
+            ...rowRhythm,
+            cells: [
+                {
+                    ...cellPaddingProps(options, subrow
+                        ? { left: (options.cellPaddingTwips ?? 0) + (options.subrowLabelIndentTwips ?? DEFAULT_SUBROW_LABEL_INDENT_TWIPS) }
+                        : undefined),
+                    blocks: [
+                        paragraph(term.label, {
+                            bold: !subrow,
+                            italic: subrow,
+                            colorHex: subrow ? (options.subrowColorHex ?? DEFAULT_SUBROW_COLOR_HEX) : undefined,
+                        }),
+                    ],
+                },
+                {
+                    ...cellPaddingProps(options),
+                    blocks: [
+                        paragraph(term.value, {
+                            italic: subrow,
+                            colorHex: subrow ? (options.subrowColorHex ?? DEFAULT_SUBROW_COLOR_HEX) : undefined,
+                        }),
+                    ],
+                },
+            ],
+        });
+    }
+    return {
+        kind: 'table',
+        layout: 'fixed',
+        columnWidthsTwips: [labelWidth, valueWidth],
+        borders,
+        rows,
+    };
+}
+/**
+ * Signature blocks rendered as borderless tables whose content cells carry
+ * only bottom borders — the signature lines. No VML, no images.
+ *
+ * Default `layout: 'single-column'` keeps the historical stacked block: one
+ * table per party, a bottom-bordered line then name/title/date rows
+ * (scenario SDX-GEN-071). With `layout: 'two-column'` the parties render as a
+ * paired signing grid — two signers per row, each a centered uppercase muted
+ * header over ruled Signature / Print Name / Title / Date lines (Print Name and
+ * Title pre-filled from the party data), with an empty padding cell when the
+ * signer count is odd (scenario SDX-GEN-109).
+ */
+export function signatureBlock(options) {
+    if ((options.layout ?? 'single-column') === 'two-column') {
+        return [twoColumnSignatureGrid(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 } : {}),
+                ...(opts?.italic ? { italic: true } : {}),
+                ...(opts?.caps ? { caps: true } : {}),
+                ...(opts?.colorHex !== undefined ? { colorHex: opts.colorHex } : {}),
+            },
+        ],
+    };
+}
+/**
+ * Two-column signing grid: parties chunked into pairs across a 3-column table
+ * `[signer, gutter, signer]`, with an empty padding cell for an odd final
+ * signer. Each signer cell stacks a centered uppercase muted header over a
+ * nested one-column table of four ruled fields (Signature / Print Name / Title
+ * / Date), reusing the bottom-bordered-cell rule from the single-column path.
+ */
+function twoColumnSignatureGrid(options) {
+    const total = options.totalWidthTwips ?? 9360;
+    const gutter = options.gutterTwips ?? 360;
+    const signer = Math.max(1, Math.floor((total - gutter) / 2));
+    const mutedColor = options.headerColorHex ?? DEFAULT_SUBROW_COLOR_HEX;
+    const labels = options.ruledLineLabels ?? ['Signature', 'Print Name', 'Title', 'Date'];
+    const gutterCell = {
+        borders: { top: NONE, bottom: NONE, left: NONE, right: NONE },
+        blocks: [paragraph('')],
+    };
+    const paddingCell = {
+        borders: { top: NONE, bottom: NONE, left: NONE, right: NONE },
+        blocks: [paragraph('')],
+    };
+    const rows = [];
+    for (let i = 0; i < options.parties.length; i += 2) {
+        const left = options.parties[i];
+        if (left === undefined)
+            continue;
+        const right = options.parties[i + 1];
+        rows.push({
+            cells: [
+                signerCell(left, labels, mutedColor),
+                gutterCell,
+                right === undefined ? paddingCell : signerCell(right, labels, mutedColor),
+            ],
+        });
+    }
+    return {
+        kind: 'table',
+        layout: 'fixed',
+        columnWidthsTwips: [signer, gutter, signer],
+        borders: { top: NONE, bottom: NONE, left: NONE, right: NONE, insideH: NONE, insideV: NONE },
+        rows,
+    };
+}
+function signerCell(party, labels, mutedColor) {
+    // Pre-fill Print Name / Title from the party data; Signature / Date stay blank.
+    const fields = [
+        ['', labels[0]],
+        [party.name, labels[1]],
+        [party.title ?? '', labels[2]],
+        ['', party.dateLabel ?? labels[3]],
+    ];
+    return {
+        vAlign: 'top',
+        blocks: [
+            paragraph(party.party, { alignment: 'center', caps: true, colorHex: mutedColor }),
+            {
+                kind: 'table',
+                layout: 'fixed',
+                columnWidthsTwips: [4320],
+                borders: { top: NONE, bottom: NONE, left: NONE, right: NONE, insideH: NONE, insideV: NONE },
+                rows: fields.flatMap(([value, caption]) => ruledFieldRows(value, caption, mutedColor)),
+            },
+        ],
+    };
+}
+/** A ruled field = the bottom-bordered value line, then its muted caption beneath. */
+function ruledFieldRows(value, caption, mutedColor) {
+    return [
+        { cells: [{ borders: { bottom: SINGLE }, blocks: [paragraph(value)] }] },
+        { cells: [{ blocks: [paragraph(caption, { colorHex: mutedColor })] }] },
+    ];
+}
+function rowRhythmProps(options) {
+    return options.rowHeightTwips === undefined ? {} : { heightTwips: options.rowHeightTwips, heightRule: 'atLeast' };
+}
+function cellPaddingProps(options, overrides) {
+    if (options.cellPaddingTwips === undefined && overrides === undefined)
+        return {};
+    const uniform = options.cellPaddingTwips;
+    return {
+        marginsTwips: {
+            ...(uniform === undefined ? {} : { top: uniform, right: uniform, bottom: uniform, left: uniform }),
+            ...overrides,
+        },
+    };
+}
+//# sourceMappingURL=recipes.js.map

package/node_modules/@usejunior/docx-core/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/node_modules/@usejunior/docx-core/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

package/node_modules/@usejunior/docx-core/dist/generation/structural-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-checks.d.ts","sourceRoot":"","sources":["../../src/generation/structural-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EACD,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,gBAAgB,GAChB,QAAQ,GACR,eAAe,GACf,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,qEAAqE;AACrE,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAkB1F"}