@usejunior/docx-core 0.10.0 → 0.11.0

package/dist/cli/conformance-adapter.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * docx-platform-tests adapter protocol v1 entrypoint.
+ *
+ * Invoked by the suite runner as:
+ *   safe-docx-conformance-adapter --protocol-version 1 \
+ *     --operation operation.json --input input.docx --output output.docx
+ *
+ * Exit codes (per the suite's docs/adapter-protocol.md):
+ *   0 success, 1 error, 2 unsupported operation, 3 protocol mismatch.
+ * Declining with 2 is mandatory for operations outside the implemented
+ * set — the suite's design treats honest gaps as data, never approximate.
+ */
+import { readFileSync, realpathSync, writeFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { DocxDocument } from '../primitives/document.js';
+import { getParagraphText, replaceParagraphTextRange } from '../primitives/text.js';
+const SUPPORTED_PROTOCOL_VERSION = '1';
+const SUPPORTED_OPERATIONS = new Set([
+    'acceptAllTrackedChanges',
+    'rejectAllTrackedChanges',
+    'replaceFirstTextOccurrence',
+]);
+function argValue(argv, flag) {
+    const idx = argv.indexOf(flag);
+    return idx !== -1 ? argv[idx + 1] : undefined;
+}
+export async function runConformanceAdapter(argv) {
+    const protocolVersion = argValue(argv, '--protocol-version');
+    const operationPath = argValue(argv, '--operation');
+    const inputPath = argValue(argv, '--input');
+    const outputPath = argValue(argv, '--output');
+    if (protocolVersion !== SUPPORTED_PROTOCOL_VERSION) {
+        console.log(`safe-docx-conformance-adapter speaks protocol v${SUPPORTED_PROTOCOL_VERSION}, got ${protocolVersion ?? 'none'}`);
+        return 3;
+    }
+    if (!operationPath || !inputPath || !outputPath) {
+        console.error('usage: --protocol-version 1 --operation <json> --input <docx> --output <docx>');
+        return 1;
+    }
+    const operation = JSON.parse(readFileSync(operationPath, 'utf8'));
+    // Decline before touching the input: unsupported must not depend on the
+    // document being readable.
+    if (!SUPPORTED_OPERATIONS.has(operation.operationName)) {
+        console.log(`safe-docx adapter does not implement operation '${operation.operationName}'`);
+        return 2;
+    }
+    const doc = await DocxDocument.load(readFileSync(inputPath));
+    switch (operation.operationName) {
+        case 'acceptAllTrackedChanges':
+            await doc.acceptChanges();
+            break;
+        case 'rejectAllTrackedChanges':
+            await doc.rejectChanges();
+            break;
+        case 'replaceFirstTextOccurrence': {
+            const { findText, replaceText } = operation;
+            if (typeof findText !== 'string' || typeof replaceText !== 'string') {
+                console.error('replaceFirstTextOccurrence requires findText and replaceText');
+                return 1;
+            }
+            // DSL 1.0 match scope: first paragraph-local occurrence in document
+            // order; the replacement is a plain edit, not a tracked change.
+            const paragraph = doc
+                .getParagraphs()
+                .find((p) => getParagraphText(p).includes(findText));
+            if (!paragraph) {
+                console.error(`findText not present in any paragraph: ${JSON.stringify(findText)}`);
+                return 1;
+            }
+            const start = getParagraphText(paragraph).indexOf(findText);
+            replaceParagraphTextRange(paragraph, start, start + findText.length, replaceText);
+            break;
+        }
+        default:
+            // Unreachable: membership was checked above.
+            return 2;
+    }
+    const { buffer } = await doc.toBuffer();
+    writeFileSync(outputPath, buffer);
+    return 0;
+}
+// realpathSync: when invoked through the node_modules/.bin symlink,
+// process.argv[1] is the symlink while import.meta.url is the real file.
+if (process.argv[1] && pathToFileURL(realpathSync(process.argv[1])).href === import.meta.url) {
+    runConformanceAdapter(process.argv.slice(2))
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        console.error(err?.message ?? String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=conformance-adapter.js.map

package/dist/cli/conformance-adapter.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAIA,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/D"}

package/dist/cli/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
 import { pathToFileURL } from 'node:url';
 import { runCompareCli } from './compare-two.js';
 export async function runCli(argv = process.argv) {
@@ -11,7 +12,10 @@ export async function runCli(argv = process.argv) {
     // eslint-disable-next-line no-console
     console.log(JSON.stringify(result));
 }
-if (process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url) {
+// npm installs bins as node_modules/.bin symlinks, so argv[1] must be
+// realpath-resolved before comparing against import.meta.url (which node
+// always resolves to the real dist file). See #398.
+if (process.argv[1] && pathToFileURL(realpathSync(process.argv[1])).href === import.meta.url) {
     runCli(process.argv).catch((err) => {
         // eslint-disable-next-line no-console
         console.error(err?.message ?? String(err));

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/E,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,sEAAsE;AACtE,yEAAyE;AACzE,oDAAoD;AACpD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7F,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/compare-types.d.ts

@@ -34,9 +34,35 @@ export interface CompareOptions {
     engine?: 'wmlcomparer' | 'atomizer' | 'auto';
 }
 export interface CompareStats {
+    /**
+     * Human-facing inserted change ranges. This counts contiguous inserted atom
+     * runs, matching the coalesced w:ins regions emitted in OOXML.
+     */
     insertions: number;
+    /**
+     * Human-facing deleted change ranges. This counts contiguous deleted atom
+     * runs, matching the coalesced w:del regions emitted in OOXML.
+     */
     deletions: number;
+    /**
+     * Paragraphs containing both inserted and deleted content. Format-only
+     * changes are reported separately in formatChanges.
+     */
     modifications: number;
+    /** Same value as insertions, exposed with explicit range-level semantics. */
+    insertedRanges: number;
+    /** Same value as deletions, exposed with explicit range-level semantics. */
+    deletedRanges: number;
+    /** Atom-level inserted units for granular/benchmark consumers. */
+    insertedAtoms: number;
+    /** Atom-level deleted units for granular/benchmark consumers. */
+    deletedAtoms: number;
+    /** Same value as modifications, exposed without overloading the term. */
+    modifiedParagraphs: number;
+    /** Contiguous format-only change ranges. */
+    formatChanges: number;
+    /** Atom-level format-only units for granular/benchmark consumers. */
+    formatChangeAtoms: number;
 }
 export type ReconstructionMode = 'rebuild' | 'inplace';
 export type ReconstructionFallbackReason = 'round_trip_safety_check_failed';
@@ -122,6 +148,20 @@ export interface ReconstructionAttemptDiagnostics {
 export interface ReconstructionFallbackDiagnostics {
     attempts: ReconstructionAttemptDiagnostics[];
 }
+/**
+ * Round-trip safety evaluation of rebuild output. Rebuild is the terminal
+ * reconstruction strategy — there is no further fallback — so a failed check
+ * cannot reroute the pipeline. The document is returned anyway and the
+ * failures are surfaced here as a caller-visible warning.
+ *
+ * @see https://github.com/UseJunior/safe-docx/issues/226
+ */
+export interface ReconstructionRebuildSafetyDiagnostics {
+    checks: ReconstructionSafetyChecks;
+    failedChecks: ReconstructionSafetyCheckName[];
+    failureDetails?: ReconstructionSafetyFailureDetails;
+    firstDiffSummary?: ReconstructionSafetyFailureSummary;
+}
 export interface CompareResult {
     /** The resulting DOCX with track changes */
     document: Buffer;
@@ -147,5 +187,11 @@ export interface CompareResult {
      * Present only when atomizer falls back.
      */
     fallbackDiagnostics?: ReconstructionFallbackDiagnostics;
+    /**
+     * Safety-check failures observed on rebuild output — whether rebuild was
+     * requested explicitly (the default mode) or reached via inplace fallback.
+     * Present only when at least one check failed.
+     */
+    rebuildSafetyDiagnostics?: ReconstructionRebuildSafetyDiagnostics;
 }
 //# sourceMappingURL=compare-types.d.ts.map

package/dist/compare-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare-types.d.ts","sourceRoot":"","sources":["../src/compare-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compare-types.d.ts","sourceRoot":"","sources":["../src/compare-types.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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAK3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,6EAA6E,CAAC;AACnH,MAAM,CAAC,MAAM,iBAAiB,GAAG,8EAA8E,CAAC;AAChH,MAAM,CAAC,MAAM,8BAA8B,GACzC,qFAAqF,CAAC;AACxF,MAAM,CAAC,MAAM,0BAA0B,GAAG,yEAAyE,CAAC;AACpH,MAAM,CAAC,MAAM,mBAAmB,GAAG,2EAA2E,CAAC;AAC/G,MAAM,CAAC,MAAM,eAAe,GAAG,+DAA+D,CAAC;AAE/F,MAAM,iBAAiB,GAAG,wBAAwB,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,MAAM,KAAK,CAAC;AAE9F,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC,4EAA4E;AAC5E,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,SAAS,CAAC,IAAkB,EAAE,IAAsB;IAC3D,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,cAAc,CAAC;AAC5D,CAAC;AAED,0EAA0E;AAC1E,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,OAAO,GAAG,MAAM;SACnB,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB,CACvC,IAAkB,EAClB,GAAmB,EACnB,SAAgC;IAEhC,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE7C,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;IAChF,GAAG,CAAC,YAAY,CAAC,2BAA2B,EAAE,8BAA8B,EAAE,0BAA0B,CAAC,CAAC;IAC1G,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAE1E,GAAG,CAAC,cAAc,CAAC,mBAAmB,EAAE,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,cAAc,CAAC,2BAA2B,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;IACpF,GAAG,CAAC,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,eAAe,CAAC,IAAkB,EAAE,SAAgC;IAC3E,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,eAAgB,CAAC;IAClC,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,KAAK,GAA2B;YACpC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAClB,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;YACjC,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACjD,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QACtD,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QACrD,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,GAAG,CAAC,WAAW,CAAC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,uBAAuB,CAAC,SAAgC;IAC/D,MAAM,GAAG,GAAG,QAAQ,CAAC,8BAA8B,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,GAAG,CAAC,eAAgB,CAAC;IAClC,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACrE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,IAAkB,EAAE,SAAgC;IACzE,MAAM,GAAG,GAAG,QAAQ,CAAC,0BAA0B,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,GAAG,CAAC,eAAgB,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACvE,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAChE,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

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