@usejunior/docx-core 0.10.0 → 0.11.0

package/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"}

package/dist/generation/structural-checks.js

@@ -0,0 +1,318 @@
+/**
+ * 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.
+ */
+import { auditSectPr } from '../primitives/sectPrAudit.js';
+import { NODE_TYPE } from '../primitives/dom-helpers.js';
+import { OOXML } from '../primitives/namespaces.js';
+import { parseXml } from '../primitives/xml.js';
+import { DocxZip } from '../primitives/zip.js';
+/** Run every structural check against a generated package buffer. */
+export async function checkGeneratedPackage(buffer) {
+    const zip = await DocxZip.load(buffer);
+    const files = zip.listFiles().filter((name) => !name.endsWith('/'));
+    const contents = new Map();
+    for (const name of files) {
+        contents.set(name, await zip.readText(name));
+    }
+    const issues = [
+        ...checkXmlDeclarations(contents),
+        ...checkContentTypeCoverage(contents),
+        ...checkRelationshipTargets(contents),
+        ...checkRidResolution(contents),
+        ...checkSectPr(contents),
+        ...checkFieldPairing(contents),
+        ...checkTables(contents),
+    ];
+    return { ok: issues.length === 0, issues };
+}
+function isXmlPart(name) {
+    return name.endsWith('.xml') || name.endsWith('.rels');
+}
+function checkXmlDeclarations(contents) {
+    const issues = [];
+    for (const [name, text] of contents) {
+        if (!isXmlPart(name))
+            continue;
+        if (!text.startsWith('<?xml')) {
+            issues.push({
+                check: 'xml_declaration',
+                part: name,
+                message: 'XML part does not begin with an <?xml declaration',
+            });
+        }
+    }
+    return issues;
+}
+function checkContentTypeCoverage(contents) {
+    const issues = [];
+    const contentTypes = contents.get('[Content_Types].xml');
+    if (!contentTypes) {
+        return [{ check: 'content_type_coverage', part: '[Content_Types].xml', message: 'Part is missing' }];
+    }
+    const doc = parseXml(contentTypes);
+    const defaults = new Set();
+    const overrides = new Set();
+    for (const el of Array.from(doc.getElementsByTagName('Default'))) {
+        const ext = el.getAttribute('Extension');
+        if (ext)
+            defaults.add(ext.toLowerCase());
+    }
+    for (const el of Array.from(doc.getElementsByTagName('Override'))) {
+        const part = el.getAttribute('PartName');
+        if (part)
+            overrides.add(part);
+    }
+    for (const name of contents.keys()) {
+        if (name === '[Content_Types].xml')
+            continue;
+        const extension = name.split('.').pop()?.toLowerCase() ?? '';
+        if (!overrides.has(`/${name}`) && !defaults.has(extension)) {
+            issues.push({
+                check: 'content_type_coverage',
+                part: name,
+                message: 'Part is covered by neither a content-type Default nor an Override',
+            });
+        }
+    }
+    return issues;
+}
+/** Directory ('word/' or '') whose relationships a .rels part declares. */
+function relsOwnerDir(relsName) {
+    const marker = '_rels/';
+    const idx = relsName.lastIndexOf(marker);
+    return idx <= 0 ? '' : relsName.slice(0, idx);
+}
+function resolveTarget(ownerDir, target) {
+    const joined = target.startsWith('/') ? target.slice(1) : ownerDir + target;
+    const segments = [];
+    for (const segment of joined.split('/')) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..')
+            segments.pop();
+        else
+            segments.push(segment);
+    }
+    return segments.join('/');
+}
+function checkRelationshipTargets(contents) {
+    const issues = [];
+    for (const [name, text] of contents) {
+        if (!name.endsWith('.rels'))
+            continue;
+        const ownerDir = relsOwnerDir(name);
+        const doc = parseXml(text);
+        for (const rel of Array.from(doc.getElementsByTagName('Relationship'))) {
+            if (rel.getAttribute('TargetMode') === 'External')
+                continue;
+            const target = rel.getAttribute('Target');
+            if (!target) {
+                issues.push({ check: 'relationship_target', part: name, message: 'Relationship without Target' });
+                continue;
+            }
+            const resolved = resolveTarget(ownerDir, target);
+            if (!contents.has(resolved)) {
+                issues.push({
+                    check: 'relationship_target',
+                    part: name,
+                    message: `Relationship target '${target}' resolves to missing part '${resolved}'`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+function relsIdsFor(contents, partName) {
+    const dir = partName.includes('/') ? partName.slice(0, partName.lastIndexOf('/') + 1) : '';
+    const base = partName.slice(dir.length);
+    const relsName = `${dir}_rels/${base}.rels`;
+    const ids = new Set();
+    const text = contents.get(relsName);
+    if (!text)
+        return ids;
+    const doc = parseXml(text);
+    for (const rel of Array.from(doc.getElementsByTagName('Relationship'))) {
+        const id = rel.getAttribute('Id');
+        if (id)
+            ids.add(id);
+    }
+    return ids;
+}
+function checkRidResolution(contents) {
+    const issues = [];
+    for (const [name, text] of contents) {
+        if (!name.startsWith('word/') || !name.endsWith('.xml'))
+            continue;
+        const ids = relsIdsFor(contents, name);
+        const doc = parseXml(text);
+        const visit = (el) => {
+            for (let i = 0; i < el.attributes.length; i++) {
+                const attr = el.attributes[i];
+                const isRid = attr.namespaceURI === OOXML.R_NS || attr.name === 'r:id' || attr.name === 'r:embed';
+                if (!isRid)
+                    continue;
+                if (!ids.has(attr.value)) {
+                    issues.push({
+                        check: 'rid_resolution',
+                        part: name,
+                        message: `<${el.tagName}> references relationship '${attr.value}' missing from this part's rels`,
+                    });
+                }
+            }
+            for (let i = 0; i < el.childNodes.length; i++) {
+                const child = el.childNodes[i];
+                if (child.nodeType === NODE_TYPE.ELEMENT)
+                    visit(child);
+            }
+        };
+        if (doc.documentElement)
+            visit(doc.documentElement);
+    }
+    return issues;
+}
+/**
+ * Generated documents must bind their final section explicitly: exactly one
+ * body-level w:sectPr, positioned last. auditSectPr supplies the placement
+ * and reference checks but allows the zero-sectPr case, hence the count
+ * assertion here.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.17
+ */
+function checkSectPr(contents) {
+    const issues = [];
+    const documentXml = contents.get('word/document.xml');
+    if (!documentXml) {
+        return [{ check: 'sectpr', part: 'word/document.xml', message: 'Part is missing' }];
+    }
+    const audit = auditSectPr(documentXml, contents.get('word/_rels/document.xml.rels') ?? null);
+    for (const issue of audit.issues) {
+        issues.push({ check: 'sectpr', part: 'word/document.xml', message: `${issue.type}: ${issue.message}` });
+    }
+    if (audit.stats.bodyLevelSectPrCount !== 1) {
+        issues.push({
+            check: 'sectpr',
+            part: 'word/document.xml',
+            message: `Expected exactly one body-level w:sectPr, found ${audit.stats.bodyLevelSectPrCount}`,
+        });
+    }
+    return issues;
+}
+function isStoryPart(name) {
+    return (name === 'word/document.xml' ||
+        /^word\/header\d+\.xml$/.test(name) ||
+        /^word\/footer\d+\.xml$/.test(name) ||
+        name === 'word/footnotes.xml' ||
+        name === 'word/endnotes.xml' ||
+        name === 'word/comments.xml');
+}
+function checkFieldPairing(contents) {
+    const issues = [];
+    for (const [name, text] of contents) {
+        if (!isStoryPart(name))
+            continue;
+        const doc = parseXml(text);
+        // Document-order walk over field-relevant leaves; fldChar transitions
+        // drive a begin → separate → end state machine per story part.
+        let state = 'idle';
+        const visit = (el) => {
+            if (el.tagName === 'w:fldChar') {
+                const type = el.getAttribute('w:fldCharType');
+                if (type === 'begin') {
+                    if (state !== 'idle') {
+                        issues.push({ check: 'field_pairing', part: name, message: 'fldChar begin while a field is already open' });
+                    }
+                    state = 'instr';
+                }
+                else if (type === 'separate') {
+                    if (state !== 'instr') {
+                        issues.push({ check: 'field_pairing', part: name, message: 'fldChar separate without a matching begin' });
+                    }
+                    state = 'result';
+                }
+                else if (type === 'end') {
+                    if (state === 'idle') {
+                        issues.push({ check: 'field_pairing', part: name, message: 'fldChar end without a matching begin' });
+                    }
+                    state = 'idle';
+                }
+            }
+            else if (el.tagName === 'w:instrText') {
+                if (state !== 'instr') {
+                    issues.push({
+                        check: 'field_pairing',
+                        part: name,
+                        message: 'w:instrText outside a begin→separate range',
+                    });
+                }
+            }
+            for (let i = 0; i < el.childNodes.length; i++) {
+                const child = el.childNodes[i];
+                if (child.nodeType === NODE_TYPE.ELEMENT)
+                    visit(child);
+            }
+        };
+        if (doc.documentElement)
+            visit(doc.documentElement);
+        if (state !== 'idle') {
+            issues.push({ check: 'field_pairing', part: name, message: 'Unclosed field at end of story part' });
+        }
+    }
+    return issues;
+}
+/**
+ * Table invariants readers actually enforce: every cell ends with a w:p,
+ * and the document body never ends with a table (the element preceding the
+ * body-level sectPr, or the last body child, must not be w:tbl).
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.65
+ */
+function checkTables(contents) {
+    const issues = [];
+    for (const [name, text] of contents) {
+        if (!isStoryPart(name))
+            continue;
+        const doc = parseXml(text);
+        for (const tc of Array.from(doc.getElementsByTagName('w:tc'))) {
+            let last = null;
+            for (let child = tc.firstChild; child; child = child.nextSibling) {
+                if (child.nodeType === NODE_TYPE.ELEMENT)
+                    last = child;
+            }
+            if (!last || last.tagName !== 'w:p') {
+                issues.push({
+                    check: 'table',
+                    part: name,
+                    message: `Table cell ends with <${last?.tagName ?? 'nothing'}> instead of a w:p`,
+                });
+            }
+        }
+        if (name !== 'word/document.xml')
+            continue;
+        const body = doc.getElementsByTagName('w:body').item(0);
+        if (!body)
+            continue;
+        let lastContent = null;
+        for (let child = body.firstChild; child; child = child.nextSibling) {
+            if (child.nodeType !== NODE_TYPE.ELEMENT)
+                continue;
+            const el = child;
+            if (el.tagName === 'w:sectPr')
+                continue;
+            lastContent = el;
+        }
+        if (lastContent && lastContent.tagName === 'w:tbl') {
+            issues.push({ check: 'table', part: name, message: 'Document body ends with a w:tbl' });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=structural-checks.js.map

package/dist/generation/structural-checks.js.map

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

package/dist/generation/types.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Declarative document specification for from-scratch DOCX generation.
+ *
+ * The entire surface is plain data: discriminated unions on `kind`, no Map /
+ * Date / class instances, explicit unit suffixes (`...Twips`, `...Pt`) instead
+ * of bare numbers. `JSON.parse(JSON.stringify(spec))` is identity over any
+ * valid spec, which is what lets a stored recipe (or, later, an MCP payload)
+ * compile without translation.
+ *
+ * The type surface intentionally covers the full feature set of the
+ * add-docx-generation change even though emitters land in phases; the
+ * compiler rejects any spec feature whose emitter has not shipped yet
+ * (see validate-spec.ts) rather than silently ignoring it.
+ */
+export type DocumentSpec = {
+    meta?: DocumentMetaSpec;
+    /** Emitted to word/styles.xml. Document defaults + Normal are always emitted. */
+    styles?: StyleSpec[];
+    /** Emitted to word/numbering.xml when non-empty. */
+    numbering?: NumberingSpec[];
+    /** At least one section. The final section's properties bind at body level. */
+    sections: SectionSpec[];
+    options?: {
+        /** Default true. When false, drafting notes compile to nothing. */
+        includeDraftingNotes?: boolean;
+    };
+};
+export type DocumentMetaSpec = {
+    title?: string;
+    author?: string;
+    /** ISO-8601 timestamp used for docProps dates. Generation never reads the clock. */
+    createdIso?: string;
+};
+export type SectionSpec = {
+    page?: {
+        /** Defaults to US Letter (12240 × 15840). */
+        sizeTwips?: {
+            w: number;
+            h: number;
+        };
+        orientation?: 'portrait' | 'landscape';
+        marginsTwips?: {
+            top?: number;
+            right?: number;
+            bottom?: number;
+            left?: number;
+            header?: number;
+            footer?: number;
+            gutter?: number;
+        };
+    };
+    /** Section-break type for non-final sections (w:type). */
+    breakType?: 'nextPage' | 'continuous' | 'oddPage' | 'evenPage';
+    pageNumbering?: {
+        start?: number;
+        format?: 'decimal' | 'lowerRoman' | 'upperRoman' | 'lowerLetter' | 'upperLetter';
+    };
+    /** Auto-implied when headers.first or footers.first is present. */
+    titlePg?: boolean;
+    headers?: HeaderFooterSet;
+    footers?: HeaderFooterSet;
+    blocks: BlockSpec[];
+};
+export type HeaderFooterSet = {
+    default?: HeaderFooterSpec;
+    first?: HeaderFooterSpec;
+    even?: HeaderFooterSpec;
+};
+export type HeaderFooterSpec = {
+    blocks: BlockSpec[];
+};
+export type BlockSpec = ParagraphSpec | TableSpec;
+export type ParagraphSpec = {
+    kind: 'paragraph';
+    /** Must resolve to a declared style (or the implicit Normal). */
+    styleId?: string;
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    spacing?: {
+        beforeTwips?: number;
+        afterTwips?: number;
+        lineTwips?: number;
+        lineRule?: 'auto' | 'exact' | 'atLeast';
+    };
+    indent?: {
+        leftTwips?: number;
+        rightTwips?: number;
+        firstLineTwips?: number;
+        hangingTwips?: number;
+    };
+    /** Must resolve to a declared numbering definition. */
+    list?: {
+        numId: string;
+        ilvl: number;
+    };
+    pageBreakBefore?: boolean;
+    keepNext?: boolean;
+    tabs?: Array<{
+        posTwips: number;
+        align: 'left' | 'center' | 'right';
+        leader?: 'none' | 'dot' | 'underscore';
+    }>;
+    runs: InlineSpec[];
+    /** Drafting-note annotation anchored to this paragraph (separable layer). */
+    note?: DraftingNoteSpec;
+};
+export type InlineSpec = RunSpec | FieldSpec | TabSpec | BreakSpec;
+/** Run-level formatting shared by text runs, fields, and style definitions. */
+export type RunProps = {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: 'single' | 'double' | 'none';
+    /** Six-digit hex without '#', e.g. 'FF0000'. */
+    colorHex?: string;
+    /** Applied to ascii + hAnsi + cs so all script ranges agree. */
+    font?: string;
+    sizePt?: number;
+    caps?: boolean;
+    smallCaps?: boolean;
+};
+export type RunSpec = {
+    kind: 'text';
+    text: string;
+} & RunProps;
+export type FieldSpec = {
+    kind: 'field';
+    field: 'PAGE' | 'NUMPAGES';
+    /**
+     * Cached field result text, required so readers display a value without
+     * recomputation prompts. The no-recovery-dialog guarantee is
+     * unrepresentable-by-omission.
+     */
+    cachedResult: string;
+} & RunProps;
+export type TabSpec = {
+    kind: 'tab';
+};
+export type BreakSpec = {
+    kind: 'break';
+    breakType?: 'line' | 'page';
+};
+export type TableSpec = {
+    kind: 'table';
+    /** Defaults to 'fixed'. */
+    layout?: 'fixed' | 'autofit';
+    /** Defines w:tblGrid; the sum drives w:tblW. */
+    columnWidthsTwips: number[];
+    borders?: TableBorders;
+    rows: TableRowSpec[];
+};
+export type BorderSpec = {
+    style: 'single' | 'double' | 'none';
+    sizeEighthPt?: number;
+    colorHex?: string;
+};
+export type TableBorders = {
+    top?: BorderSpec;
+    bottom?: BorderSpec;
+    left?: BorderSpec;
+    right?: BorderSpec;
+    insideH?: BorderSpec;
+    insideV?: BorderSpec;
+};
+export type TableRowSpec = {
+    heightTwips?: number;
+    heightRule?: 'atLeast' | 'exact';
+    /** Marks the row as a repeating header row (w:tblHeader). */
+    header?: boolean;
+    cells: TableCellSpec[];
+};
+export type TableCellSpec = {
+    widthTwips?: number;
+    gridSpan?: number;
+    vMerge?: 'restart' | 'continue';
+    borders?: TableBorders;
+    shadingHex?: string;
+    vAlign?: 'top' | 'center' | 'bottom';
+    marginsTwips?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    blocks: BlockSpec[];
+};
+export type StyleSpec = {
+    styleId: string;
+    name: string;
+    type: 'paragraph' | 'character';
+    basedOn?: string;
+    next?: string;
+    paragraph?: Omit<ParagraphSpec, 'kind' | 'runs' | 'list' | 'note' | 'styleId'>;
+    run?: RunProps;
+};
+export type NumberingSpec = {
+    /** Spec-level handle; the compiler assigns numeric w:numId / abstractNumId. */
+    numId: string;
+    levels: Array<{
+        ilvl: number;
+        start?: number;
+        numFmt: 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'bullet' | 'none';
+        /** Level text pattern, e.g. '%1.' or '%1.%2' or a bullet glyph. */
+        lvlText: string;
+        suff?: 'tab' | 'space' | 'nothing';
+        indentTwips?: {
+            left?: number;
+            hanging?: number;
+        };
+        runProps?: RunProps;
+    }>;
+};
+export type DraftingNoteSpec = {
+    text: string;
+    author?: string;
+    /** ISO-8601; comment metadata is deterministic, never wall-clock. */
+    dateIso?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/generation/types.js

@@ -0,0 +1,16 @@
+/**
+ * Declarative document specification for from-scratch DOCX generation.
+ *
+ * The entire surface is plain data: discriminated unions on `kind`, no Map /
+ * Date / class instances, explicit unit suffixes (`...Twips`, `...Pt`) instead
+ * of bare numbers. `JSON.parse(JSON.stringify(spec))` is identity over any
+ * valid spec, which is what lets a stored recipe (or, later, an MCP payload)
+ * compile without translation.
+ *
+ * The type surface intentionally covers the full feature set of the
+ * add-docx-generation change even though emitters land in phases; the
+ * compiler rejects any spec feature whose emitter has not shipped yet
+ * (see validate-spec.ts) rather than silently ignoring it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/generation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/generation/validate-spec.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pre-compile validation of a DocumentSpec.
+ *
+ * Two jobs:
+ *  1. Shape/referential checks for the spec subset whose emitters have shipped.
+ *  2. Loud rejection of declared-but-not-yet-implemented spec features. The
+ *     type surface covers the full add-docx-generation change; emitters land
+ *     in phases, and a spec feature without an emitter must fail compilation
+ *     with a typed error naming the feature and its path — never be silently
+ *     dropped (scenario SDX-GEN-003).
+ *
+ * Shipped so far: formatted text/tab/break runs, five-part PAGE/NUMPAGES
+ * fields, paragraph formatting, named styles + styles.xml, multi-section
+ * documents with per-section page setup, page numbering, break types,
+ * default/first/even headers and footers, tables (grid, spans, vertical
+ * merges, cell decoration, nesting), multi-level numbering with w:numPr
+ * list references, and drafting notes compiled to anchored comments (body
+ * story only — header/footer paragraphs cannot carry notes).
+ *
+ * Every declared feature now has an emitter; the loud-rejection contract
+ * (SDX-GEN-003) lives on as runtime guards against unrecognized block and
+ * inline kinds, which protect callers handing in JSON that the TypeScript
+ * surface never saw.
+ */
+import type { DocumentSpec } from './types.js';
+export declare function validateSpec(spec: DocumentSpec): void;
+//# sourceMappingURL=validate-spec.d.ts.map

package/dist/generation/validate-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-spec.d.ts","sourceRoot":"","sources":["../../src/generation/validate-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAGV,YAAY,EASb,MAAM,YAAY,CAAC;AAapB,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAWrD"}