@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/footnotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../src/footnotes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,iBAAiB,EAEjB,UAAU,EACX,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,GACpD,UAAU,EAAE,CAcd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAMD;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,yBAAyB,CAAkC;IACnE,OAAO,CAAC,wBAAwB,CAAkC;IAClE,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,kBAAkB,CAA0B;IAEpD;;;;OAIG;gBACS,YAAY,EAAE,UAAU;IAIpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;;;OAKG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;;;;OAOG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOnD;;;;;OAKG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAwB5C;;;;OAIG;IACH,oBAAoB,IAAI,iBAAiB,EAAE;CAuB5C;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,UAAU,EACzB,KAAK,EAAE,MAAM,GACZ,UAAU,GAAG,SAAS,CAYxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,UAAU,EACxB,KAAK,EAAE,MAAM,GACZ,UAAU,GAAG,SAAS,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAiB/D"}
+{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../src/footnotes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EAEjB,UAAU,EACX,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,GACpD,UAAU,EAAE,CAcd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAMD;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,yBAAyB,CAAkC;IACnE,OAAO,CAAC,wBAAwB,CAAkC;IAClE,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,kBAAkB,CAA0B;IAEpD;;;;OAIG;gBACS,YAAY,EAAE,UAAU;IAIpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;;;OAKG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;;;;;;OAOG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOnD;;;;;OAKG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAwB5C;;;;OAIG;IACH,oBAAoB,IAAI,iBAAiB,EAAE;CAuB5C;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,UAAU,EACzB,KAAK,EAAE,MAAM,GACZ,UAAU,GAAG,SAAS,CAYxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,UAAU,EACxB,KAAK,EAAE,MAAM,GACZ,UAAU,GAAG,SAAS,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAiB/D"}

package/dist/footnotes.js

@@ -3,13 +3,15 @@
  *
  * Handles sequential footnote/endnote numbering by document order.
  *
- * Per ECMA-376, w:id on footnoteReference is a reference identifier, NOT the
- * display number. Display numbers are sequential based on document order.
+ * `w:id` on `w:footnoteReference` is a reference identifier, NOT the display
+ * number. Display numbers are sequential based on document order.
  *
  * @example
  * Document has 91 footnotes with XML IDs 2-92 (IDs 0, 1 are reserved):
  * - Incorrect: Display as 2, 3, 4, ..., 92
  * - Correct: Display as 1, 2, 3, ..., 91
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.11.14
  */
 import { RESERVED_FOOTNOTE_IDS, } from './core-types.js';
 import { childElements, getLeafText } from './primitives/index.js';
@@ -41,10 +43,13 @@ export function findReferencesInOrder(element, tagName) {
 /**
  * Check if a footnote/endnote ID is reserved.
  *
- * IDs 0 and 1 are reserved for separator types per ECMA-376.
+ * IDs 0 and 1 are treated as reserved, matching the special separator and
+ * continuation-separator footnote examples in ECMA-376 5th edition Part 1
+ * §17.11.9 / §17.11.10.
  *
  * @param xmlId - The XML ID to check
  * @returns True if this is a reserved ID
+ * @conformance ECMA-376 edition 5, Part 1 § 17.11.14
  */
 export function isReservedId(xmlId) {
     return (xmlId === RESERVED_FOOTNOTE_IDS.SEPARATOR ||

package/dist/footnotes.js.map

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

package/dist/generation/compile.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The generation compiler: DocumentSpec → validated spec → per-part emitters
+ * → ordered file record → zip buffer.
+ *
+ * Determinism contract: identical specs compile to byte-identical buffers.
+ * No emitter reads the clock or randomness; zip entry dates are pinned to a
+ * fixed epoch (document-facing dates come from spec.meta.createdIso).
+ *
+ * Ordering: header/footer parts are allocated first so their relationship
+ * ids exist when the document part binds section references; the package
+ * plumbing runs last because [Content_Types].xml is assembled from the part
+ * registry.
+ */
+import type { DocumentSpec } from './types.js';
+export type GenerateDocxOptions = {
+    /** Overrides spec.options.includeDraftingNotes when provided. */
+    includeDraftingNotes?: boolean;
+};
+/** Compile a DocumentSpec into a complete DOCX package. */
+export declare function generateDocx(spec: DocumentSpec, opts?: GenerateDocxOptions): Promise<Buffer>;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/generation/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,2DAA2D;AAC3D,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlG"}

package/dist/generation/compile.js

@@ -0,0 +1,46 @@
+/**
+ * The generation compiler: DocumentSpec → validated spec → per-part emitters
+ * → ordered file record → zip buffer.
+ *
+ * Determinism contract: identical specs compile to byte-identical buffers.
+ * No emitter reads the clock or randomness; zip entry dates are pinned to a
+ * fixed epoch (document-facing dates come from spec.meta.createdIso).
+ *
+ * Ordering: header/footer parts are allocated first so their relationship
+ * ids exist when the document part binds section references; the package
+ * plumbing runs last because [Content_Types].xml is assembled from the part
+ * registry.
+ */
+import { createZipBuffer } from '../primitives/zip.js';
+import { maybeCaptureEmittedDocumentXml } from '../primitives/schema-corpus-capture.js';
+import { CompileContext } from './context.js';
+import { emitCommentsPartsIfNeeded } from './emit/comments-part.js';
+import { DraftingNoteCollector } from './emit/emit-context.js';
+import { emitDocumentPart } from './emit/document-part.js';
+import { emitHeaderFooterParts } from './emit/header-footer-part.js';
+import { emitNumberingPartIfNeeded } from './emit/numbering-part.js';
+import { emitPackageParts } from './emit/package-parts.js';
+import { emitSettingsPartIfNeeded } from './emit/settings-part.js';
+import { emitStylesPart } from './emit/styles-part.js';
+import { validateSpec } from './validate-spec.js';
+/** Fixed zip-entry timestamp (2006-01-01T00:00:00Z, the OOXML vintage). */
+const ZIP_EPOCH = new Date(Date.UTC(2006, 0, 1));
+/** Compile a DocumentSpec into a complete DOCX package. */
+export async function generateDocx(spec, opts) {
+    validateSpec(spec);
+    const notesEnabled = opts?.includeDraftingNotes ?? spec.options?.includeDraftingNotes ?? true;
+    const ctx = new CompileContext();
+    const numberingIds = emitNumberingPartIfNeeded(spec, ctx);
+    const headerFooterRefs = emitHeaderFooterParts(spec, ctx, { numberingIds });
+    const notes = notesEnabled ? new DraftingNoteCollector() : undefined;
+    const documentPartXml = emitDocumentPart(spec, headerFooterRefs, { numberingIds, notes });
+    maybeCaptureEmittedDocumentXml(documentPartXml);
+    ctx.setFileContent('word/document.xml', documentPartXml);
+    if (notes)
+        emitCommentsPartsIfNeeded(spec, ctx, notes);
+    emitStylesPart(spec, ctx);
+    emitSettingsPartIfNeeded(spec, ctx);
+    emitPackageParts(spec, ctx);
+    return createZipBuffer(ctx.toFileRecord(), { fileDate: ZIP_EPOCH });
+}
+//# sourceMappingURL=compile.js.map

package/dist/generation/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/generation/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,2EAA2E;AAC3E,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAOjD,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAkB,EAAE,IAA0B;IAC/E,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,IAAI,EAAE,oBAAoB,IAAI,IAAI,CAAC,OAAO,EAAE,oBAAoB,IAAI,IAAI,CAAC;IAC9F,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;IACjC,MAAM,YAAY,GAAG,yBAAyB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAChD,GAAG,CAAC,cAAc,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IACzD,IAAI,KAAK;QAAE,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACvD,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE5B,OAAO,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/generation/context.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Compile-time state shared by the part emitters.
+ *
+ * The context owns the part registry (part name → content type + optional
+ * document-level relationship), the relationship-id allocator, and the
+ * ordered file map handed to the zip assembler. All allocation is
+ * deterministic: ids are sequential counters, never random, and no part of
+ * the compiler reads the clock.
+ */
+export type RegisteredPart = {
+    /** Zip path, e.g. 'word/header1.xml'. */
+    name: string;
+    /** Content type registered as an Override in [Content_Types].xml. */
+    contentType: string;
+    /** Relationship from word/document.xml, when the part is document-attached. */
+    documentRel?: {
+        type: string;
+        rId: string;
+    };
+};
+export declare class CompileContext {
+    private readonly partsByName;
+    private readonly fileContents;
+    private nextRid;
+    private nextHeaderIndex;
+    private nextFooterIndex;
+    /** Register a part that needs a content-type Override (content set separately). */
+    registerPart(name: string, contentType: string, documentRelType?: string): RegisteredPart;
+    allocateRid(): string;
+    allocateHeaderPartName(): string;
+    allocateFooterPartName(): string;
+    setFileContent(name: string, content: string): void;
+    registeredParts(): RegisteredPart[];
+    documentRelParts(): RegisteredPart[];
+    /**
+     * Assemble the final zip-file record. [Content_Types].xml is placed first —
+     * createZipBuffer preserves insertion order but does not enforce ordering
+     * itself, so the contract lives here.
+     */
+    toFileRecord(): Record<string, string>;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/generation/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAK;IAE5B,mFAAmF;IACnF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,cAAc;IAYzF,WAAW,IAAI,MAAM;IAIrB,sBAAsB,IAAI,MAAM;IAIhC,sBAAsB,IAAI,MAAM;IAIhC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInD,eAAe,IAAI,cAAc,EAAE;IAInC,gBAAgB,IAAI,cAAc,EAAE;IAIpC;;;;OAIG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAYvC"}

package/dist/generation/context.js

@@ -0,0 +1,65 @@
+/**
+ * Compile-time state shared by the part emitters.
+ *
+ * The context owns the part registry (part name → content type + optional
+ * document-level relationship), the relationship-id allocator, and the
+ * ordered file map handed to the zip assembler. All allocation is
+ * deterministic: ids are sequential counters, never random, and no part of
+ * the compiler reads the clock.
+ */
+export class CompileContext {
+    partsByName = new Map();
+    fileContents = new Map();
+    nextRid = 1;
+    nextHeaderIndex = 1;
+    nextFooterIndex = 1;
+    /** Register a part that needs a content-type Override (content set separately). */
+    registerPart(name, contentType, documentRelType) {
+        if (this.partsByName.has(name)) {
+            return this.partsByName.get(name);
+        }
+        const part = { name, contentType };
+        if (documentRelType) {
+            part.documentRel = { type: documentRelType, rId: this.allocateRid() };
+        }
+        this.partsByName.set(name, part);
+        return part;
+    }
+    allocateRid() {
+        return `rId${this.nextRid++}`;
+    }
+    allocateHeaderPartName() {
+        return `word/header${this.nextHeaderIndex++}.xml`;
+    }
+    allocateFooterPartName() {
+        return `word/footer${this.nextFooterIndex++}.xml`;
+    }
+    setFileContent(name, content) {
+        this.fileContents.set(name, content);
+    }
+    registeredParts() {
+        return Array.from(this.partsByName.values());
+    }
+    documentRelParts() {
+        return this.registeredParts().filter((p) => p.documentRel);
+    }
+    /**
+     * Assemble the final zip-file record. [Content_Types].xml is placed first —
+     * createZipBuffer preserves insertion order but does not enforce ordering
+     * itself, so the contract lives here.
+     */
+    toFileRecord() {
+        const contentTypes = this.fileContents.get('[Content_Types].xml');
+        if (contentTypes === undefined) {
+            throw new Error('compile bug: [Content_Types].xml was never emitted');
+        }
+        const record = { '[Content_Types].xml': contentTypes };
+        for (const [name, content] of this.fileContents) {
+            if (name === '[Content_Types].xml')
+                continue;
+            record[name] = content;
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/generation/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/generation/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,OAAO,cAAc;IACR,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,OAAO,GAAG,CAAC,CAAC;IACZ,eAAe,GAAG,CAAC,CAAC;IACpB,eAAe,GAAG,CAAC,CAAC;IAE5B,mFAAmF;IACnF,YAAY,CAAC,IAAY,EAAE,WAAmB,EAAE,eAAwB;QACtE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACrC,CAAC;QACD,MAAM,IAAI,GAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACnD,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;QACT,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IAChC,CAAC;IAED,sBAAsB;QACpB,OAAO,cAAc,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IACpD,CAAC;IAED,sBAAsB;QACpB,OAAO,cAAc,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IACpD,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,OAAe;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAClE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,MAAM,GAA2B,EAAE,qBAAqB,EAAE,YAAY,EAAE,CAAC;QAC/E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAChD,IAAI,IAAI,KAAK,qBAAqB;gBAAE,SAAS;YAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,36 @@
+/**
+ * Drafting-note comment parts: word/comments.xml plus the Word-extension
+ * ancillary parts word/commentsExtended.xml and word/people.xml.
+ *
+ * All three are always emitted together when notes are enabled. The
+ * ancillary pair is deliberately on by default: plain comments.xml loads in
+ * every reader we test, but Word 2013+ writes the trio and its own comment
+ * UI degrades (no resolve state, no people presence) without them. Content
+ * and relationship types match what Word itself writes — verified against
+ * the Open XML SDK's WordprocessingCommentsExPart/WordprocessingPeoplePart
+ * constants (the `application/vnd.ms-word.commentsExtended+xml` variant
+ * found in some third-party packages is NOT what Word emits). They also
+ * match the editing path in primitives/comments.ts, so a generated document
+ * is indistinguishable from an edited one to the comment APIs.
+ *
+ * Determinism: comment ids are allocated in document order by the
+ * DraftingNoteCollector; w14:paraId values derive from those ids; dates come
+ * only from DraftingNoteSpec.dateIso (falling back to meta.createdIso);
+ * authors fall back note.author → meta.author → 'safe-docx'. No clock, no
+ * randomness — identical specs produce byte-identical comment parts.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.6
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.2
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+import type { DraftingNoteCollector } from './emit-context.js';
+export declare const COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
+export declare const COMMENTS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+export declare const COMMENTS_EXTENDED_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml";
+export declare const COMMENTS_EXTENDED_REL_TYPE = "http://schemas.microsoft.com/office/2011/relationships/commentsExtended";
+export declare const PEOPLE_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.people+xml";
+export declare const PEOPLE_REL_TYPE = "http://schemas.microsoft.com/office/2011/relationships/people";
+/** Emit the comment trio from the notes collected during body emission. */
+export declare function emitCommentsPartsIfNeeded(spec: DocumentSpec, ctx: CompileContext, collector: DraftingNoteCollector): void;
+//# sourceMappingURL=comments-part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/comments-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,eAAO,MAAM,qBAAqB,gFAAgF,CAAC;AACnH,eAAO,MAAM,iBAAiB,iFAAiF,CAAC;AAChH,eAAO,MAAM,8BAA8B,wFAC4C,CAAC;AACxF,eAAO,MAAM,0BAA0B,4EAA4E,CAAC;AACpH,eAAO,MAAM,mBAAmB,8EAA8E,CAAC;AAC/G,eAAO,MAAM,eAAe,kEAAkE,CAAC;AAyB/F,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,qBAAqB,GAC/B,IAAI,CAUN"}

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

@@ -0,0 +1,116 @@
+/**
+ * Drafting-note comment parts: word/comments.xml plus the Word-extension
+ * ancillary parts word/commentsExtended.xml and word/people.xml.
+ *
+ * All three are always emitted together when notes are enabled. The
+ * ancillary pair is deliberately on by default: plain comments.xml loads in
+ * every reader we test, but Word 2013+ writes the trio and its own comment
+ * UI degrades (no resolve state, no people presence) without them. Content
+ * and relationship types match what Word itself writes — verified against
+ * the Open XML SDK's WordprocessingCommentsExPart/WordprocessingPeoplePart
+ * constants (the `application/vnd.ms-word.commentsExtended+xml` variant
+ * found in some third-party packages is NOT what Word emits). They also
+ * match the editing path in primitives/comments.ts, so a generated document
+ * is indistinguishable from an edited one to the comment APIs.
+ *
+ * Determinism: comment ids are allocated in document order by the
+ * DraftingNoteCollector; w14:paraId values derive from those ids; dates come
+ * only from DraftingNoteSpec.dateIso (falling back to meta.createdIso);
+ * authors fall back note.author → meta.author → 'safe-docx'. No clock, no
+ * randomness — identical specs produce byte-identical comment parts.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.6
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.4.2
+ */
+import { createWmlElement, createWmlTextElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+export const COMMENTS_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml';
+export const COMMENTS_REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments';
+export const COMMENTS_EXTENDED_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml';
+export const COMMENTS_EXTENDED_REL_TYPE = 'http://schemas.microsoft.com/office/2011/relationships/commentsExtended';
+export const PEOPLE_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.people+xml';
+export const PEOPLE_REL_TYPE = 'http://schemas.microsoft.com/office/2011/relationships/people';
+const COMMENTS_SKELETON = `<w:comments xmlns:w="${OOXML.W_NS}" xmlns:w14="${OOXML.W14_NS}"/>`;
+const DEFAULT_AUTHOR = 'safe-docx';
+/** Deterministic w14:paraId for a comment id: zero-padded uppercase hex. */
+function paraIdFor(id) {
+    return id.toString(16).toUpperCase().padStart(8, '0');
+}
+function authorFor(spec, note) {
+    return note.author ?? spec.meta?.author ?? DEFAULT_AUTHOR;
+}
+/** Up-to-three-letter initials from the author's words, deterministic. */
+function initialsFor(author) {
+    const letters = author
+        .split(/\s+/)
+        .map((word) => word.replace(/[^\p{L}\p{N}]/gu, '').charAt(0))
+        .filter((c) => c.length > 0);
+    const initials = letters.slice(0, 3).join('').toUpperCase();
+    return initials.length > 0 ? initials : 'SD';
+}
+/** Emit the comment trio from the notes collected during body emission. */
+export function emitCommentsPartsIfNeeded(spec, ctx, collector) {
+    if (collector.collected.length === 0)
+        return;
+    ctx.registerPart('word/comments.xml', COMMENTS_CONTENT_TYPE, COMMENTS_REL_TYPE);
+    ctx.registerPart('word/commentsExtended.xml', COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_REL_TYPE);
+    ctx.registerPart('word/people.xml', PEOPLE_CONTENT_TYPE, PEOPLE_REL_TYPE);
+    ctx.setFileContent('word/comments.xml', emitCommentsXml(spec, collector));
+    ctx.setFileContent('word/commentsExtended.xml', emitCommentsExtendedXml(collector));
+    ctx.setFileContent('word/people.xml', emitPeopleXml(spec, collector));
+}
+function emitCommentsXml(spec, collector) {
+    const doc = parseXml(COMMENTS_SKELETON);
+    const root = doc.documentElement;
+    for (const { id, note } of collector.collected) {
+        const attrs = {
+            'w:id': String(id),
+            'w:author': authorFor(spec, note),
+            'w:initials': initialsFor(authorFor(spec, note)),
+        };
+        const dateIso = note.dateIso ?? spec.meta?.createdIso;
+        if (dateIso !== undefined)
+            attrs['w:date'] = dateIso;
+        const comment = createWmlElement(doc, W.comment, attrs);
+        const p = createWmlElement(doc, W.p);
+        p.setAttributeNS(OOXML.W14_NS, 'w14:paraId', paraIdFor(id));
+        const run = createWmlElement(doc, W.r);
+        run.appendChild(createWmlTextElement(doc, note.text));
+        p.appendChild(run);
+        comment.appendChild(p);
+        root.appendChild(comment);
+    }
+    return XML_DECL + serializeXml(doc);
+}
+function emitCommentsExtendedXml(collector) {
+    const doc = parseXml(`<w15:commentsEx xmlns:w15="${OOXML.W15_NS}"/>`);
+    const root = doc.documentElement;
+    for (const { id } of collector.collected) {
+        const commentEx = doc.createElementNS(OOXML.W15_NS, 'w15:commentEx');
+        commentEx.setAttributeNS(OOXML.W15_NS, 'w15:paraId', paraIdFor(id));
+        commentEx.setAttributeNS(OOXML.W15_NS, 'w15:done', '0');
+        root.appendChild(commentEx);
+    }
+    return XML_DECL + serializeXml(doc);
+}
+function emitPeopleXml(spec, collector) {
+    const doc = parseXml(`<w15:people xmlns:w15="${OOXML.W15_NS}"/>`);
+    const root = doc.documentElement;
+    const seen = new Set();
+    for (const { note } of collector.collected) {
+        const author = authorFor(spec, note);
+        if (seen.has(author))
+            continue;
+        seen.add(author);
+        const person = doc.createElementNS(OOXML.W15_NS, 'w15:person');
+        person.setAttributeNS(OOXML.W15_NS, 'w15:author', author);
+        const presence = doc.createElementNS(OOXML.W15_NS, 'w15:presenceInfo');
+        presence.setAttributeNS(OOXML.W15_NS, 'w15:providerId', 'None');
+        presence.setAttributeNS(OOXML.W15_NS, 'w15:userId', author);
+        person.appendChild(presence);
+        root.appendChild(person);
+    }
+    return XML_DECL + serializeXml(doc);
+}
+//# sourceMappingURL=comments-part.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * word/document.xml emitter.
+ *
+ * Builds the main document part from a namespace-declaring skeleton: the
+ * skeleton string carries every namespace the part uses on the root element,
+ * and all children are created through the namespace-safe DOM helpers.
+ * xmldom's serializer omits the XML declaration, so it is prepended here;
+ * the structural validator asserts every part starts with one.
+ */
+import type { DocumentSpec } from '../types.js';
+import type { BlockEmitContext } from './emit-context.js';
+import { type SectionHeaderFooterRefs } from './section.js';
+/**
+ * Compile the body: each section's blocks in order. Every non-final section
+ * ends with a dedicated break paragraph whose pPr contains only that
+ * section's sectPr (what Word itself emits on Insert → Section Break; it
+ * also sidesteps the trailing-table case), and the final section's
+ * properties bind as the body's last child.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.17
+ */
+export declare function emitDocumentPart(spec: DocumentSpec, refs?: SectionHeaderFooterRefs[], ctx?: BlockEmitContext): string;
+//# sourceMappingURL=document-part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/document-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAe,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAOzE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,uBAAuB,EAAE,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAgCrH"}

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

@@ -0,0 +1,60 @@
+/**
+ * word/document.xml emitter.
+ *
+ * Builds the main document part from a namespace-declaring skeleton: the
+ * skeleton string carries every namespace the part uses on the root element,
+ * and all children are created through the namespace-safe DOM helpers.
+ * xmldom's serializer omits the XML declaration, so it is prepended here;
+ * the structural validator asserts every part starts with one.
+ */
+import { createWmlElement } from '../../primitives/dom-helpers.js';
+import { OOXML, W } from '../../primitives/namespaces.js';
+import { parseXml, serializeXml, XML_DECL } from '../../primitives/xml.js';
+import { GenerationInternalError } from '../errors.js';
+import { buildSectPr } from './section.js';
+import { buildBlock } from './table.js';
+const DOCUMENT_SKELETON = `<w:document xmlns:w="${OOXML.W_NS}" xmlns:r="${OOXML.R_NS}" xmlns:w14="${OOXML.W14_NS}">` +
+    `<w:body/></w:document>`;
+/**
+ * Compile the body: each section's blocks in order. Every non-final section
+ * ends with a dedicated break paragraph whose pPr contains only that
+ * section's sectPr (what Word itself emits on Insert → Section Break; it
+ * also sidesteps the trailing-table case), and the final section's
+ * properties bind as the body's last child.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.6.17
+ */
+export function emitDocumentPart(spec, refs, ctx) {
+    const doc = parseXml(DOCUMENT_SKELETON);
+    const body = doc.getElementsByTagName('w:body').item(0);
+    if (!body)
+        throw new GenerationInternalError('document skeleton lost its w:body');
+    spec.sections.forEach((section, index) => {
+        for (const block of section.blocks) {
+            body.appendChild(buildBlock(doc, block, ctx));
+        }
+        const sectPr = buildSectPr(doc, section, refs?.[index]);
+        const isFinal = index === spec.sections.length - 1;
+        if (isFinal) {
+            // The body must not end with a table (readers treat it as truncated);
+            // a final trailing table gets a closing empty paragraph before the
+            // body-level sectPr binds. Non-final sections already end with their
+            // dedicated break paragraph.
+            const lastBlock = section.blocks[section.blocks.length - 1];
+            if (lastBlock && lastBlock.kind === 'table') {
+                body.appendChild(createWmlElement(doc, W.p));
+            }
+            body.appendChild(sectPr);
+        }
+        else {
+            const breakParagraph = createWmlElement(doc, W.p);
+            const pPr = createWmlElement(doc, W.pPr);
+            pPr.appendChild(sectPr);
+            breakParagraph.appendChild(pPr);
+            body.appendChild(breakParagraph);
+        }
+    });
+    return XML_DECL + serializeXml(doc);
+}
+//# sourceMappingURL=document-part.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-part.js","sourceRoot":"","sources":["../../../src/generation/emit/document-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;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAgC,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,iBAAiB,GACrB,wBAAwB,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,MAAM,IAAI;IAC1F,wBAAwB,CAAC;AAE3B;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,IAAgC,EAAE,GAAsB;IAC3G,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,uBAAuB,CAAC,mCAAmC,CAAC,CAAC;IAElF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACnD,IAAI,OAAO,EAAE,CAAC;YACZ,sEAAsE;YACtE,mEAAmE;YACnE,qEAAqE;YACrE,6BAA6B;YAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC5D,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC5C,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACxB,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/generation/emit/emit-context.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared state the block emitters thread through paragraph/table recursion.
+ *
+ * Bundling it in one object keeps emitter signatures stable as features
+ * land: numbering binds spec handles to numeric ids, and the drafting-note
+ * collector allocates comment ids in document order (absent in stories that
+ * cannot carry notes, e.g. headers/footers, and when notes are disabled).
+ */
+import type { DraftingNoteSpec } from '../types.js';
+/** Spec-level numbering handle → numeric w:numId value. */
+export type NumberingIdMap = ReadonlyMap<string, number>;
+/** Allocates deterministic comment ids and records notes in document order. */
+export declare class DraftingNoteCollector {
+    readonly collected: Array<{
+        id: number;
+        note: DraftingNoteSpec;
+    }>;
+    private nextId;
+    allocate(note: DraftingNoteSpec): number;
+}
+export type BlockEmitContext = {
+    numberingIds?: NumberingIdMap;
+    /** Present only where drafting notes may anchor (body story, notes enabled). */
+    notes?: DraftingNoteCollector;
+};
+//# sourceMappingURL=emit-context.d.ts.map

package/dist/generation/emit/emit-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-context.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/emit-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzD,+EAA+E;AAC/E,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAM;IACvE,OAAO,CAAC,MAAM,CAAK;IAEnB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;CAKzC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,gFAAgF;IAChF,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,CAAC"}

package/dist/generation/emit/emit-context.js

@@ -0,0 +1,19 @@
+/**
+ * Shared state the block emitters thread through paragraph/table recursion.
+ *
+ * Bundling it in one object keeps emitter signatures stable as features
+ * land: numbering binds spec handles to numeric ids, and the drafting-note
+ * collector allocates comment ids in document order (absent in stories that
+ * cannot carry notes, e.g. headers/footers, and when notes are disabled).
+ */
+/** Allocates deterministic comment ids and records notes in document order. */
+export class DraftingNoteCollector {
+    collected = [];
+    nextId = 1;
+    allocate(note) {
+        const id = this.nextId++;
+        this.collected.push({ id, note });
+        return id;
+    }
+}
+//# sourceMappingURL=emit-context.js.map

package/dist/generation/emit/emit-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-context.js","sourceRoot":"","sources":["../../../src/generation/emit/emit-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,+EAA+E;AAC/E,MAAM,OAAO,qBAAqB;IACvB,SAAS,GAAkD,EAAE,CAAC;IAC/D,MAAM,GAAG,CAAC,CAAC;IAEnB,QAAQ,CAAC,IAAsB;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/generation/emit/header-footer-part.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Header and footer part emitters.
+ *
+ * Each declared header/footer slot (default / first / even) becomes its own
+ * part — word/headerN.xml or word/footerN.xml — registered with a
+ * content-type override and a relationship from the main document part. The
+ * block content reuses the same paragraph/run emitters as the body, so a
+ * footer's "Page X of Y" field compiles through exactly the same five-part
+ * field machinery.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.10.4
+ */
+import type { CompileContext } from '../context.js';
+import type { DocumentSpec } from '../types.js';
+import type { BlockEmitContext } from './emit-context.js';
+import type { SectionHeaderFooterRefs } from './section.js';
+/**
+ * Allocate and emit every header/footer part, returning per-section
+ * reference maps for the sectPr emitter. Runs before the document part so
+ * relationship ids exist when sections bind their references.
+ */
+export declare function emitHeaderFooterParts(spec: DocumentSpec, ctx: CompileContext, blockCtx?: BlockEmitContext): SectionHeaderFooterRefs[];
+//# sourceMappingURL=header-footer-part.d.ts.map

package/dist/generation/emit/header-footer-part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-footer-part.d.ts","sourceRoot":"","sources":["../../../src/generation/emit/header-footer-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAS5D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,EAAE,CAErI"}