@usejunior/docx-core 0.18.0 → 0.20.1

package/dist/primitives/namespaces.d.ts

@@ -1,5 +1,6 @@
 export declare const OOXML: {
     readonly W_NS: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly A_NS: "http://schemas.openxmlformats.org/drawingml/2006/main";
     readonly REL_NS: "http://schemas.openxmlformats.org/package/2006/relationships";
     readonly R_NS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
     readonly HYPERLINK_REL_TYPE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
@@ -15,6 +16,7 @@ export declare const W: {
     readonly r: "r";
     readonly t: "t";
     readonly pPr: "pPr";
+    readonly pBdr: "pBdr";
     readonly rPr: "rPr";
     readonly bookmarkStart: "bookmarkStart";
     readonly bookmarkEnd: "bookmarkEnd";
@@ -30,6 +32,14 @@ export declare const W: {
     readonly rFonts: "rFonts";
     readonly b: "b";
     readonly i: "i";
+    readonly caps: "caps";
+    readonly smallCaps: "smallCaps";
+    readonly strike: "strike";
+    readonly emboss: "emboss";
+    readonly imprint: "imprint";
+    readonly outline: "outline";
+    readonly shadow: "shadow";
+    readonly vanish: "vanish";
     readonly u: "u";
     readonly highlight: "highlight";
     readonly sz: "sz";
@@ -82,6 +92,7 @@ export declare const W: {
     readonly bottom: "bottom";
     readonly left: "left";
     readonly right: "right";
+    readonly between: "between";
     readonly end: "end";
     readonly val: "val";
     readonly hRule: "hRule";
@@ -108,8 +119,6 @@ export declare const W: {
     readonly qFormat: "qFormat";
     readonly bCs: "bCs";
     readonly iCs: "iCs";
-    readonly caps: "caps";
-    readonly smallCaps: "smallCaps";
     readonly keepNext: "keepNext";
     readonly keepLines: "keepLines";
     readonly pageBreakBefore: "pageBreakBefore";
@@ -137,6 +146,7 @@ export declare const W: {
     readonly drawing: "drawing";
     readonly pict: "pict";
     readonly object: "object";
+    readonly contentPart: "contentPart";
     readonly del: "del";
     readonly moveFrom: "moveFrom";
     readonly font: "font";

package/dist/primitives/namespaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../src/primitives/namespaces.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;CAiBR,CAAC;AAEX,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqKJ,CAAC"}
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../src/primitives/namespaces.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;CAmBR,CAAC;AAEX,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8KJ,CAAC"}

package/dist/primitives/namespaces.js

@@ -1,6 +1,8 @@
 export const OOXML = {
     // Main WordprocessingML namespace.
     W_NS: 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
+    // DrawingML namespace used by theme parts.
+    A_NS: 'http://schemas.openxmlformats.org/drawingml/2006/main',
     // Relationships, package, etc. kept for future parts.
     REL_NS: 'http://schemas.openxmlformats.org/package/2006/relationships',
     // Relationship namespace used inside .rels parts (document relationships).
@@ -23,6 +25,7 @@ export const W = {
     r: 'r',
     t: 't',
     pPr: 'pPr',
+    pBdr: 'pBdr',
     rPr: 'rPr',
     bookmarkStart: 'bookmarkStart',
     bookmarkEnd: 'bookmarkEnd',
@@ -40,6 +43,14 @@ export const W = {
     rFonts: 'rFonts',
     b: 'b',
     i: 'i',
+    caps: 'caps',
+    smallCaps: 'smallCaps',
+    strike: 'strike',
+    emboss: 'emboss',
+    imprint: 'imprint',
+    outline: 'outline',
+    shadow: 'shadow',
+    vanish: 'vanish',
     u: 'u',
     highlight: 'highlight',
     sz: 'sz',
@@ -95,6 +106,7 @@ export const W = {
     bottom: 'bottom',
     left: 'left',
     right: 'right',
+    between: 'between',
     end: 'end',
     val: 'val',
     hRule: 'hRule',
@@ -123,8 +135,6 @@ export const W = {
     qFormat: 'qFormat',
     bCs: 'bCs',
     iCs: 'iCs',
-    caps: 'caps',
-    smallCaps: 'smallCaps',
     keepNext: 'keepNext',
     keepLines: 'keepLines',
     pageBreakBefore: 'pageBreakBefore',
@@ -158,6 +168,7 @@ export const W = {
     drawing: 'drawing',
     pict: 'pict',
     object: 'object',
+    contentPart: 'contentPart',
     // Revision wrappers
     del: 'del',
     moveFrom: 'moveFrom',

package/dist/primitives/namespaces.js.map

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

package/dist/primitives/note_conversion.d.ts

@@ -0,0 +1,11 @@
+import { type ConvertCommentsToFootnotesOptions, type ConvertCommentsToFootnotesReport } from './document.js';
+export type ConvertCommentsToFootnotesResult = {
+    buffer: Buffer;
+    report: ConvertCommentsToFootnotesReport;
+};
+/**
+ * Convert comments on an isolated in-memory document and return a new DOCX.
+ * The caller's source buffer and file remain unchanged when preflight fails.
+ */
+export declare function convertCommentsToFootnotes(source: Buffer, options?: ConvertCommentsToFootnotesOptions): Promise<ConvertCommentsToFootnotesResult>;
+//# sourceMappingURL=note_conversion.d.ts.map

package/dist/primitives/note_conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note_conversion.d.ts","sourceRoot":"","sources":["../../src/primitives/note_conversion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iCAAiC,EAAE,KAAK,gCAAgC,EAAE,MAAM,eAAe,CAAC;AAE5H,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gCAAgC,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,gCAAgC,CAAC,CAK3C"}

package/dist/primitives/note_conversion.js

@@ -0,0 +1,12 @@
+import { DocxDocument } from './document.js';
+/**
+ * Convert comments on an isolated in-memory document and return a new DOCX.
+ * The caller's source buffer and file remain unchanged when preflight fails.
+ */
+export async function convertCommentsToFootnotes(source, options = {}) {
+    const document = await DocxDocument.load(source);
+    const report = await document.convertCommentsToFootnotes(options);
+    const { buffer } = await document.toBuffer({ cleanBookmarks: true, preserveOriginalBookmarks: true });
+    return { buffer, report };
+}
+//# sourceMappingURL=note_conversion.js.map

package/dist/primitives/note_conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note_conversion.js","sourceRoot":"","sources":["../../src/primitives/note_conversion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiF,MAAM,eAAe,CAAC;AAO5H;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAc,EACd,UAA6C,EAAE;IAE/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,CAAC;IACtG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/primitives/opc-target.d.ts

@@ -0,0 +1,24 @@
+export type OpcRelationshipTargetMode = 'Internal' | 'External';
+export type OpcRelationshipTargetIssue = 'empty_target' | 'invalid_target_mode' | 'external_target_not_allowed' | 'invalid_encoding' | 'unsafe_target' | 'package_escape' | 'empty_resolved_target' | 'invalid_external_target';
+export declare class OpcRelationshipTargetError extends Error {
+    readonly issue: OpcRelationshipTargetIssue;
+    constructor(issue: OpcRelationshipTargetIssue, message: string);
+}
+export interface NormalizeOpcRelationshipTargetOptions {
+    ownerPart: string;
+    target: string;
+    targetMode?: string | null;
+    allowExternal?: boolean;
+}
+export interface NormalizedOpcRelationshipTarget {
+    mode: OpcRelationshipTargetMode;
+    target: string;
+}
+/**
+ * Normalize one OPC relationship target under SafeDocX package-containment
+ * policy. Internal targets are decoded once, checked for ambiguous or unsafe
+ * URI/path forms, and resolved relative to the owning part. External targets
+ * are accepted only when the caller opts in.
+ */
+export declare function normalizeOpcRelationshipTarget(options: NormalizeOpcRelationshipTargetOptions): NormalizedOpcRelationshipTarget;
+//# sourceMappingURL=opc-target.d.ts.map

package/dist/primitives/opc-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opc-target.d.ts","sourceRoot":"","sources":["../../src/primitives/opc-target.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE,MAAM,MAAM,0BAA0B,GAClC,cAAc,GACd,qBAAqB,GACrB,6BAA6B,GAC7B,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,KAAK,EAAE,0BAA0B;gBAAjC,KAAK,EAAE,0BAA0B,EAC1C,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,qCAAqC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,yBAAyB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6FD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,+BAA+B,CAsBjC"}

package/dist/primitives/opc-target.js

@@ -0,0 +1,99 @@
+import { posix } from 'node:path';
+export class OpcRelationshipTargetError extends Error {
+    issue;
+    constructor(issue, message) {
+        super(message);
+        this.issue = issue;
+        this.name = 'OpcRelationshipTargetError';
+    }
+}
+function targetMode(value) {
+    if (value === null || value === undefined || value === 'Internal') {
+        return 'Internal';
+    }
+    if (value === 'External')
+        return 'External';
+    throw new OpcRelationshipTargetError('invalid_target_mode', `invalid relationship TargetMode '${value}'`);
+}
+function normalizeInternalTarget(ownerPart, target) {
+    if (!target) {
+        throw new OpcRelationshipTargetError('empty_target', 'empty internal relationship target');
+    }
+    if (target.includes('\\') || /[\u0000-\u001f\u007f?#]/u.test(target)) {
+        throw new OpcRelationshipTargetError('unsafe_target', `unsafe internal relationship target '${target}'`);
+    }
+    let decoded = target;
+    for (let pass = 0; pass <= target.length; pass++) {
+        if (/%(?:2f|5c)/iu.test(decoded)) {
+            throw new OpcRelationshipTargetError('unsafe_target', `encoded path separator in internal relationship target '${target}'`);
+        }
+        let next;
+        try {
+            next = decodeURIComponent(decoded);
+        }
+        catch {
+            throw new OpcRelationshipTargetError('invalid_encoding', `invalid encoded relationship target '${target}'`);
+        }
+        const rawSegments = decoded.split('/');
+        const nextSegments = next.split('/');
+        if (next.includes('\\') ||
+            /[\u0000-\u001f\u007f?#]/u.test(next) ||
+            next.startsWith('//') ||
+            next.includes(':') ||
+            nextSegments.some((segment, index) => (segment === '.' || segment === '..') && rawSegments[index] !== segment)) {
+            throw new OpcRelationshipTargetError('unsafe_target', `unsafe internal relationship target '${target}'`);
+        }
+        decoded = next;
+        if (!/%[0-9a-f]{2}/iu.test(decoded))
+            break;
+        if (pass === target.length) {
+            throw new OpcRelationshipTargetError('invalid_encoding', `excessively nested encoded relationship target '${target}'`);
+        }
+    }
+    const decodedSegments = decoded.split('/');
+    const segments = decoded.startsWith('/')
+        ? []
+        : posix.dirname(ownerPart).split('/').filter(Boolean);
+    for (const segment of decodedSegments) {
+        if (!segment || segment === '.')
+            continue;
+        if (segment === '..') {
+            if (segments.length === 0) {
+                throw new OpcRelationshipTargetError('package_escape', `relationship target escapes the package root: '${target}'`);
+            }
+            segments.pop();
+        }
+        else {
+            segments.push(segment);
+        }
+    }
+    if (segments.length === 0) {
+        throw new OpcRelationshipTargetError('empty_resolved_target', `empty resolved relationship target '${target}'`);
+    }
+    return segments.join('/');
+}
+/**
+ * Normalize one OPC relationship target under SafeDocX package-containment
+ * policy. Internal targets are decoded once, checked for ambiguous or unsafe
+ * URI/path forms, and resolved relative to the owning part. External targets
+ * are accepted only when the caller opts in.
+ */
+export function normalizeOpcRelationshipTarget(options) {
+    const mode = targetMode(options.targetMode);
+    if (mode === 'External') {
+        if (!options.allowExternal) {
+            throw new OpcRelationshipTargetError('external_target_not_allowed', `external relationship target is not allowed: '${options.target}'`);
+        }
+        try {
+            return { mode, target: new URL(options.target).href };
+        }
+        catch {
+            throw new OpcRelationshipTargetError('invalid_external_target', `unsafe external relationship target '${options.target}'`);
+        }
+    }
+    return {
+        mode,
+        target: normalizeInternalTarget(options.ownerPart, options.target),
+    };
+}
+//# sourceMappingURL=opc-target.js.map

package/dist/primitives/opc-target.js.map

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

package/dist/primitives/paragraph_numbering.d.ts

@@ -0,0 +1,40 @@
+import { type RevisionContext } from './track-changes-emitter.js';
+export type DirectParagraphNumbering = {
+    numId: string;
+    ilvl: number;
+};
+export type ParagraphNumberingMutation = {
+    paragraphId: string;
+    numbering: DirectParagraphNumbering | null;
+};
+export type ParagraphNumberingMutationResult = {
+    paragraphId: string;
+    changed: boolean;
+    previous: DirectParagraphNumbering | null;
+    current: DirectParagraphNumbering | null;
+    warning?: string;
+};
+export type ParagraphNumberingMutationErrorCode = 'PARAGRAPH_NOT_FOUND' | 'INCOMPLETE_NUMBERING' | 'NUMBERING_PART_MISSING' | 'NUMBERING_INSTANCE_NOT_FOUND' | 'ABSTRACT_NUMBERING_NOT_FOUND' | 'NUMBERING_LEVEL_NOT_FOUND' | 'INVALID_NUMBERING_REFERENCE';
+export declare class ParagraphNumberingMutationError extends Error {
+    readonly code: ParagraphNumberingMutationErrorCode;
+    constructor(code: ParagraphNumberingMutationErrorCode, message: string);
+}
+/**
+ * Read only the paragraph's direct `w:numPr`; style-inherited numbering is not
+ * considered.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @see #653
+ */
+export declare function getDirectParagraphNumbering(doc: Document, paragraphId: string): DirectParagraphNumbering | null;
+/**
+ * Mutate one paragraph's direct list reference while preserving the numbering
+ * definitions and unrelated paragraph properties.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.3
+ * @see #653
+ */
+export declare function setDirectParagraphNumbering(documentDoc: Document, numberingDoc: Document | null, mutation: ParagraphNumberingMutation, ctx?: RevisionContext): ParagraphNumberingMutationResult;
+//# sourceMappingURL=paragraph_numbering.d.ts.map

package/dist/primitives/paragraph_numbering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph_numbering.d.ts","sourceRoot":"","sources":["../../src/primitives/paragraph_numbering.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAC3C,qBAAqB,GACrB,sBAAsB,GACtB,wBAAwB,GACxB,8BAA8B,GAC9B,8BAA8B,GAC9B,2BAA2B,GAC3B,6BAA6B,CAAC;AAElC,qBAAa,+BAAgC,SAAQ,KAAK;aAEtC,IAAI,EAAE,mCAAmC;gBAAzC,IAAI,EAAE,mCAAmC,EACzD,OAAO,EAAE,MAAM;CAKlB;AAkCD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EACb,WAAW,EAAE,MAAM,GAClB,wBAAwB,GAAG,IAAI,CAgBjC;AA4FD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,QAAQ,EACrB,YAAY,EAAE,QAAQ,GAAG,IAAI,EAC7B,QAAQ,EAAE,0BAA0B,EACpC,GAAG,CAAC,EAAE,eAAe,GACpB,gCAAgC,CA6ElC"}

package/dist/primitives/paragraph_numbering.js

@@ -0,0 +1,198 @@
+import { findParagraphByBookmarkId } from './bookmarks.js';
+import { getDirectChildrenByName } from './dom-helpers.js';
+import { OOXML, W } from './namespaces.js';
+import { parseNumberingXml } from './numbering.js';
+import { buildPPrChangeElement, } from './track-changes-emitter.js';
+export class ParagraphNumberingMutationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ParagraphNumberingMutationError';
+    }
+}
+function getWAttr(el, localName) {
+    return el.getAttributeNS(OOXML.W_NS, localName)
+        || el.getAttribute(`w:${localName}`)
+        || el.getAttribute(localName)
+        || null;
+}
+function parseDirectNumberingFromParagraph(paragraph) {
+    const pPr = getDirectChildrenByName(paragraph, W.pPr)[0] ?? null;
+    const numPr = pPr ? getDirectChildrenByName(pPr, W.numPr)[0] ?? null : null;
+    if (!numPr)
+        return { value: null, complete: true };
+    const numIdEl = getDirectChildrenByName(numPr, W.numId)[0] ?? null;
+    const ilvlEl = getDirectChildrenByName(numPr, W.ilvl)[0] ?? null;
+    const numId = numIdEl ? getWAttr(numIdEl, W.val) : null;
+    const ilvlText = ilvlEl ? getWAttr(ilvlEl, W.val) : null;
+    const ilvl = ilvlText !== null ? Number(ilvlText) : Number.NaN;
+    if (numId === null
+        || !/^[1-9]\d*$/.test(numId)
+        || !Number.isSafeInteger(ilvl)
+        || ilvl < 0) {
+        return { value: null, complete: false };
+    }
+    return { value: { numId, ilvl }, complete: true };
+}
+/**
+ * Read only the paragraph's direct `w:numPr`; style-inherited numbering is not
+ * considered.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @see #653
+ */
+export function getDirectParagraphNumbering(doc, paragraphId) {
+    const paragraph = findParagraphByBookmarkId(doc, paragraphId);
+    if (!paragraph) {
+        throw new ParagraphNumberingMutationError('PARAGRAPH_NOT_FOUND', `Paragraph '${paragraphId}' was not found.`);
+    }
+    const parsed = parseDirectNumberingFromParagraph(paragraph);
+    if (!parsed.complete) {
+        throw new ParagraphNumberingMutationError('INCOMPLETE_NUMBERING', `Paragraph '${paragraphId}' has an incomplete or invalid direct w:numPr.`);
+    }
+    return parsed.value;
+}
+function validateRequestedNumbering(numberingDoc, requested) {
+    if (!/^[1-9]\d*$/.test(requested.numId)
+        || !Number.isSafeInteger(requested.ilvl)
+        || requested.ilvl < 0) {
+        throw new ParagraphNumberingMutationError('INVALID_NUMBERING_REFERENCE', 'numId must be a positive decimal string and ilvl must be a non-negative safe integer.');
+    }
+    if (!numberingDoc) {
+        throw new ParagraphNumberingMutationError('NUMBERING_PART_MISSING', 'The document has no word/numbering.xml part.');
+    }
+    const model = parseNumberingXml(numberingDoc);
+    const instance = model.nums.get(requested.numId);
+    if (!instance) {
+        throw new ParagraphNumberingMutationError('NUMBERING_INSTANCE_NOT_FOUND', `Numbering instance '${requested.numId}' was not found in word/numbering.xml.`);
+    }
+    const abstract = model.abstractNums.get(instance.abstractNumId);
+    if (!abstract) {
+        throw new ParagraphNumberingMutationError('ABSTRACT_NUMBERING_NOT_FOUND', `Numbering instance '${requested.numId}' references missing abstract numbering '${instance.abstractNumId}'.`);
+    }
+    if (!abstract.levels.has(requested.ilvl)) {
+        throw new ParagraphNumberingMutationError('NUMBERING_LEVEL_NOT_FOUND', `Numbering instance '${requested.numId}' has no level ${requested.ilvl}.`);
+    }
+}
+function ensureParagraphProperties(paragraph) {
+    const existing = getDirectChildrenByName(paragraph, W.pPr)[0];
+    if (existing)
+        return existing;
+    const pPr = paragraph.ownerDocument.createElementNS(OOXML.W_NS, `w:${W.pPr}`);
+    paragraph.insertBefore(pPr, paragraph.firstChild);
+    return pPr;
+}
+function insertNumPrInSchemaOrder(pPr, numPr) {
+    const successors = new Set([
+        'suppressLineNumbers',
+        'pBdr',
+        'shd',
+        'tabs',
+        'suppressAutoHyphens',
+        'kinsoku',
+        'wordWrap',
+        'overflowPunct',
+        'topLinePunct',
+        'autoSpaceDE',
+        'autoSpaceDN',
+        'bidi',
+        'adjustRightInd',
+        'snapToGrid',
+        W.spacing,
+        W.ind,
+        'contextualSpacing',
+        'mirrorIndents',
+        'suppressOverlap',
+        W.jc,
+        'textDirection',
+        'textAlignment',
+        'textboxTightWrap',
+        'outlineLvl',
+        'divId',
+        'cnfStyle',
+        W.rPr,
+        W.sectPr,
+        'pPrChange',
+    ]);
+    const successor = Array.from(pPr.children)
+        .find((child) => successors.has(child.localName));
+    if (successor)
+        pPr.insertBefore(numPr, successor);
+    else
+        pPr.appendChild(numPr);
+}
+/**
+ * Mutate one paragraph's direct list reference while preserving the numbering
+ * definitions and unrelated paragraph properties.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.19
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.9.3
+ * @see #653
+ */
+export function setDirectParagraphNumbering(documentDoc, numberingDoc, mutation, ctx) {
+    const paragraph = findParagraphByBookmarkId(documentDoc, mutation.paragraphId);
+    if (!paragraph) {
+        throw new ParagraphNumberingMutationError('PARAGRAPH_NOT_FOUND', `Paragraph '${mutation.paragraphId}' was not found.`);
+    }
+    if (mutation.numbering) {
+        validateRequestedNumbering(numberingDoc, mutation.numbering);
+    }
+    const parsedPrevious = parseDirectNumberingFromParagraph(paragraph);
+    const existingPPr = getDirectChildrenByName(paragraph, W.pPr)[0] ?? null;
+    const existingNumPrs = existingPPr
+        ? getDirectChildrenByName(existingPPr, W.numPr)
+        : [];
+    if (!mutation.numbering && existingNumPrs.length === 0) {
+        return {
+            paragraphId: mutation.paragraphId,
+            changed: false,
+            previous: null,
+            current: null,
+            warning: 'The paragraph has no direct w:numPr; style-inherited numbering was not changed.',
+        };
+    }
+    if (mutation.numbering
+        && parsedPrevious.complete
+        && parsedPrevious.value?.numId === mutation.numbering.numId
+        && parsedPrevious.value.ilvl === mutation.numbering.ilvl
+        && existingNumPrs.length === 1) {
+        return {
+            paragraphId: mutation.paragraphId,
+            changed: false,
+            previous: parsedPrevious.value,
+            current: parsedPrevious.value,
+        };
+    }
+    const oldPPr = existingPPr ? existingPPr.cloneNode(true) : null;
+    const pPr = mutation.numbering
+        ? ensureParagraphProperties(paragraph)
+        : existingPPr;
+    for (const stale of getDirectChildrenByName(pPr, W.numPr)) {
+        pPr.removeChild(stale);
+    }
+    if (mutation.numbering) {
+        const numPr = documentDoc.createElementNS(OOXML.W_NS, `w:${W.numPr}`);
+        const ilvl = documentDoc.createElementNS(OOXML.W_NS, `w:${W.ilvl}`);
+        ilvl.setAttributeNS(OOXML.W_NS, `w:${W.val}`, String(mutation.numbering.ilvl));
+        const numId = documentDoc.createElementNS(OOXML.W_NS, `w:${W.numId}`);
+        numId.setAttributeNS(OOXML.W_NS, `w:${W.val}`, mutation.numbering.numId);
+        numPr.appendChild(ilvl);
+        numPr.appendChild(numId);
+        insertNumPrInSchemaOrder(pPr, numPr);
+    }
+    if (ctx) {
+        for (const stale of getDirectChildrenByName(pPr, 'pPrChange')) {
+            pPr.removeChild(stale);
+        }
+        pPr.appendChild(buildPPrChangeElement(oldPPr, ctx));
+    }
+    return {
+        paragraphId: mutation.paragraphId,
+        changed: true,
+        previous: parsedPrevious.complete ? parsedPrevious.value : null,
+        current: mutation.numbering,
+    };
+}
+//# sourceMappingURL=paragraph_numbering.js.map

package/dist/primitives/paragraph_numbering.js.map

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

package/dist/primitives/reject_changes.d.ts

@@ -23,6 +23,13 @@ export type RejectChangesResult = {
     deletionsRestored: number;
     movesReverted: number;
     propertyChangesReverted: number;
+    /**
+     * Row-level revision markers left in place because this engine cannot resolve
+     * them. A non-zero count means the output still holds tracked-change markup
+     * and does not match what a word processor would project. Reported separately
+     * from the resolved counters: a preserved marker is not a reverted change.
+     */
+    unresolvedRowRevisions: number;
 };
 /**
  * Reject all tracked changes in the document body or story root, restoring

package/dist/primitives/reject_changes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reject_changes.d.ts","sourceRoot":"","sources":["../../src/primitives/reject_changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsB1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAgUF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GACjC,mBAAmB,CAuKrB"}
+{"version":3,"file":"reject_changes.d.ts","sourceRoot":"","sources":["../../src/primitives/reject_changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsB1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AA4WF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GACjC,mBAAmB,CA6PrB"}