@stll/folio-core 0.58.5 → 0.59.0

package/dist/ai-edits/headless.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { FolioTableTemplates } from "./table-template.js";
 import { FolioAIBlock, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot } from "./types.js";
-import { FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedStylePolicy, FolioWordDiffOptions } from "./apply.js";
+import { FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedReferencePolicy, FolioWordDiffOptions } from "./apply.js";
 import { ImportReferencedStyleDefinitionsResult } from "../compare/style-resources.js";
 import { InlineProvenanceTargetOptions } from "../compare/inline-provenance.js";
 import { MatchInlineAtomsOptions } from "../compare/inline-atoms.js";
@@ -21,6 +21,8 @@ type FolioDocxReviewerOptions = {
 };
 /** Options for {@link FolioDocxReviewer.applyOperations}. */
 type FolioApplyOperationsOptions = {
+  /** Required policy for undefined style and numbering references. */
+  undefinedReferences: FolioUndefinedReferencePolicy;
   /** `"tracked-changes"` (default) produces ins/del redlines; `"direct"` edits in place. */
   mode?: FolioAIEditApplyMode;
   /**
@@ -160,13 +162,6 @@ type FolioApplyDocumentOperationsToStoryOptions = FolioApplyDocumentOperationsOp
    * the target document — keeps them instead.
    */
   replacementBackground?: FolioReplacementBackground;
-  /**
-   * What an operation naming a paragraph style the document does not define
-   * does. Refusing it is the default; a caller copying another document's
-   * style references — `compareDocx` and `generateRedlineDocx` reproducing the
-   * revised document — keeps them instead.
-   */
-  undefinedStyles?: FolioUndefinedStylePolicy;
 };
 type FolioHeaderFooterStoryHandle = Extract<FolioEditableDocumentStoryHandle, {
   type: "header" | "footer";
@@ -213,15 +208,22 @@ type StoryInlineAtomsResult = {
   status: "budget-exceeded";
 };
 type StageTargetNumberingResult = "unchanged" | "staged" | "conflict";
+type StageTargetStylesOptions = {
+  source: FolioDocxReviewer;
+  snapshots: readonly FolioAIEditSnapshot[];
+  importedHeaderFooterSnapshots: readonly FolioAIEditSnapshot[];
+  numberingReferenceMap?: ReadonlyMap<number, number>;
+};
 type FolioDocxComparisonAccess = {
   stageTerminalTableReviewCarrier: (target: Node) => boolean;
-  stageTargetStyles: (source: FolioDocxReviewer, snapshots: readonly FolioAIEditSnapshot[], importedHeaderFooterSnapshots: readonly FolioAIEditSnapshot[]) => ImportReferencedStyleDefinitionsResult;
+  stageTargetStyles: (options: StageTargetStylesOptions) => ImportReferencedStyleDefinitionsResult;
   createComparisonHeaderFooter: (source: FolioDocxReviewer, story: FolioHeaderFooterStoryHandle) => Promise<FolioHeaderFooterStoryHandle | null>;
   matchInlineAtoms: (options: MatchStoryInlineAtomsOptions) => StoryInlineAtomsResult;
   matchInlineProvenance: (options: MatchStoryInlineProvenanceOptions) => StoryInlineProvenanceResult;
   projectStories: (mode: FolioDocxComparisonProjectionMode) => FolioDocxComparisonProjection;
   snapshotReviewedStory: (options?: FolioReadReviewedStoryOptions) => FolioAIEditSnapshot | null;
   numberingDefinitions: () => document_d_exports.NumberingDefinitions | null | undefined;
+  styleDefinitions: () => document_d_exports.Document["package"]["styles"];
   planTargetNumberingReferences: (target: document_d_exports.NumberingDefinitions | null | undefined, references: readonly {
     numId: number;
     level: number;
@@ -328,7 +330,7 @@ type FolioReviewCommentFilter = {
  * const { blocks } = reviewer.snapshot();
  * reviewer.applyOperations([
  *   { id: "1", type: "replaceInBlock", blockId: blocks[0].id, find: "$50k", replace: "$500k" },
- * ]);
+ * ], { undefinedReferences: "refuse" });
  * const reviewed = await reviewer.toBuffer();
  * ```
  */
@@ -436,16 +438,16 @@ declare class FolioDocxReviewer {
    * verbatim via a headless `{ state, dispatch }` seam; the resulting state
    * (including any comments) is retained for {@link toBuffer}.
    */
-  applyOperations(operations: FolioAIEditOperation[], options?: FolioApplyOperationsOptions): FolioAIEditApplyResult;
+  applyOperations(operations: FolioAIEditOperation[], options: FolioApplyOperationsOptions): FolioAIEditApplyResult;
   /**
    * Apply a versioned document-operation batch against the current state.
    * This is the contract entry point for serialized callers; the legacy
    * {@link applyOperations} method delegates here so both APIs keep identical
    * edit semantics.
    */
-  applyDocumentOperations(batch: FolioDocumentOperationBatch, options?: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
+  applyDocumentOperations(batch: FolioDocumentOperationBatch, options: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
   /** Apply a versioned operation batch to one editable document story. */
-  applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
+  applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
   /** Apply a batch; the notes whose references it deletes or removes follow them. */
   private applyDocumentOperationsInternal;
   private applyDocumentOperationsToStoryState;

package/dist/ai-edits/headless.js

@@ -1,7 +1,7 @@
 import { matchInlineAtoms } from "../compare/inline-atoms.js";
 import { matchInlineProvenance } from "../compare/inline-provenance.js";
 import { stageSectionBoundaryProperties } from "../compare/section-boundary-properties.js";
-import { importReferencedStyleDefinitions } from "../compare/style-resources.js";
+import { importReferencedStyleDefinitions, styleClosureNumberingReferences } from "../compare/style-resources.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { applyReplyThreadMarkers } from "../docx/commentReplyMarkers.js";
 import { rebindDrawingImageRelationship } from "../docx/drawingRelationships.js";
@@ -42,6 +42,7 @@ import { anchoredCommentIdsInBlocks, anchoredCommentIdsInProseDoc, withoutLostCo
 import { noteReferenceEditsAllowed } from "./note-references.js";
 import { FolioPendingSuggestionRegistry, createPendingSuggestionSourceSnapshot, withoutPendingSuggestionCommentMarks } from "./pending-suggestions.js";
 import { getCommentAnchorsFromDoc, getTrackedChangeGroupIdsFromDoc, getTrackedChangeStatsFromDoc, getTrackedChangesFromDoc, getTrackedChangesFromSnapshot } from "./read.js";
+import { classifyResourceReference } from "./referenceClassification.js";
 import { collectNoteReferenceLabels, createFolioAIEditSnapshotWithStyleResolver, detachFolioAIEditSnapshotExternalHyperlinks, folioStoryTables, isFolioAIContentBlock, normalizeFolioAIBlockText, sourceDocumentOf } from "./snapshot.js";
 import { matchTableGeometry } from "./table-geometry.js";
 import { tableTemplateCanCrossPackageLosslessly } from "./table-template.js";
@@ -371,7 +372,7 @@ const paragraphPlainText = (paragraph) => {
 * const { blocks } = reviewer.snapshot();
 * reviewer.applyOperations([
 *   { id: "1", type: "replaceInBlock", blockId: blocks[0].id, find: "$50k", replace: "$500k" },
-* ]);
+* ], { undefinedReferences: "refuse" });
 * const reviewed = await reviewer.toBuffer();
 * ```
 */
@@ -415,7 +416,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		this.loadedMainCommentIds = anchoredCommentIdsInProseDoc(args.state.doc);
 		comparisonAccessByReviewer.set(this, Object.freeze({
 			stageTerminalTableReviewCarrier: (target) => this.stageTerminalTableReviewCarrier(target),
-			stageTargetStyles: (source, snapshots, importedHeaderFooterSnapshots) => this.stageTargetStyles(source, snapshots, importedHeaderFooterSnapshots),
+			stageTargetStyles: (options) => this.stageTargetStyles(options),
 			createComparisonHeaderFooter: (source, story) => this.createComparisonHeaderFooter(source, story),
 			finalSectionProperties: () => this.currentFinalSectionProperties(),
 			stageFinalSectionProperties: ({ target, previous, revision }) => this.stageFinalSectionProperties({
@@ -473,16 +474,17 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			projectStories: (mode) => this.projectComparisonStoriesInternal(mode),
 			snapshotReviewedStory: (options) => this.snapshotReviewedStoryInternal(options),
 			numberingDefinitions: () => this.baseDocument.package.numbering,
+			styleDefinitions: () => this.importedStyles ?? this.baseDocument.package.styles,
 			planTargetNumberingReferences: (target, references) => this.planTargetNumberingReferences(target, references),
 			stageTargetNumbering: (target, references, remappedNumIds) => this.stageTargetNumbering(target, references, remappedNumIds)
 		}));
 	}
-	stageTargetStyles(source, snapshots, importedHeaderFooterSnapshots) {
+	stageTargetStyles({ source, snapshots, importedHeaderFooterSnapshots, numberingReferenceMap }) {
 		const destination = this.baseDocument.package;
 		const sourcePackage = source.baseDocument.package;
 		const destinationStyles = this.importedStyles ?? destination.styles;
-		const existing = new Set(destinationStyles?.styles.map(({ styleId }) => styleId));
-		const sourceStyleIds = new Set(sourcePackage.styles?.styles.map(({ styleId }) => styleId));
+		const sourceStylesById = new Map(sourcePackage.styles?.styles.map((style) => [style.styleId, style]));
+		const destinationStyleIds = new Set(destinationStyles?.styles.map(({ styleId }) => styleId));
 		const collect = (document) => {
 			const references = /* @__PURE__ */ new Set();
 			document.descendants((node) => {
@@ -508,7 +510,12 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		let materializeDefaultParagraphStyle = false;
 		for (const snapshot of resourceSnapshots) {
 			if (hasUnstyledParagraph(sourceDocumentOf(snapshot))) materializeDefaultParagraphStyle = true;
-			for (const styleId of collect(sourceDocumentOf(snapshot))) if (sourceStyleIds.has(styleId) && !existing.has(styleId)) referencedStyleIds.add(styleId);
+			for (const styleId of collect(sourceDocumentOf(snapshot))) if (classifyResourceReference({
+				kind: "style",
+				id: styleId,
+				sourceDefines: (id) => sourceStylesById.has(id),
+				destinationDefines: (id) => destinationStyleIds.has(id)
+			}) === "sourceDefined") referencedStyleIds.add(styleId);
 		}
 		const reservedStyleIds = /* @__PURE__ */ new Set();
 		if (referencedStyleIds.size > 0) for (const handle of this.listStoryHandlesInternal()) {
@@ -516,7 +523,22 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			if (!state) continue;
 			for (const styleId of collect(state.doc)) if (referencedStyleIds.has(styleId)) reservedStyleIds.add(styleId);
 		}
+		let styleNumberingReferenceMap = numberingReferenceMap ?? /* @__PURE__ */ new Map();
+		if (numberingReferenceMap !== void 0) {
+			const remaining = styleClosureNumberingReferences(sourcePackage.styles, [...referencedStyleIds]).filter(({ numId }) => !numberingReferenceMap.has(numId));
+			const planned = this.planTargetNumberingReferences(sourcePackage.numbering, remaining);
+			if (planned === null) return {
+				status: "unalignable",
+				detail: "a referenced style has undefined numbering"
+			};
+			styleNumberingReferenceMap = new Map([...planned, ...numberingReferenceMap]);
+			if (this.stageTargetNumbering(sourcePackage.numbering, remaining, planned) === "conflict") return {
+				status: "unalignable",
+				detail: "a referenced style's numbering could not be imported"
+			};
+		}
 		const result = importReferencedStyleDefinitions({
+			numberingReferenceMap: styleNumberingReferenceMap,
 			sourceStyles: sourcePackage.styles,
 			destinationStyles,
 			sourceTheme: sourcePackage.theme,
@@ -685,6 +707,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			},
 			apply: (record, snapshot) => {
 				const result = this.applyDocumentOperationsInternal({
+					undefinedReferences: "refuse",
 					story: record.story,
 					batch: {
 						version: 1,
@@ -873,7 +896,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* verbatim via a headless `{ state, dispatch }` seam; the resulting state
 	* (including any comments) is retained for {@link toBuffer}.
 	*/
-	applyOperations(operations, options = {}) {
+	applyOperations(operations, options) {
 		const { applied, skipped } = this.applyDocumentOperationsInternal({
 			story: MAIN_STORY,
 			batch: {
@@ -884,6 +907,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
 			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
 			...options.wordDiff !== void 0 && { wordDiff: options.wordDiff },
+			undefinedReferences: options.undefinedReferences,
 			createUndoEntry: false
 		});
 		return {
@@ -897,18 +921,19 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* {@link applyOperations} method delegates here so both APIs keep identical
 	* edit semantics.
 	*/
-	applyDocumentOperations(batch, options = {}) {
+	applyDocumentOperations(batch, options) {
 		return this.applyDocumentOperationsInternal({
 			story: MAIN_STORY,
 			batch,
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
 			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
 			...options.wordDiff !== void 0 && { wordDiff: options.wordDiff },
+			undefinedReferences: options.undefinedReferences,
 			createUndoEntry: true
 		});
 	}
 	/** Apply a versioned operation batch to one editable document story. */
-	applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles }) {
+	applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences }) {
 		return this.applyDocumentOperationsInternal({
 			story,
 			batch,
@@ -917,7 +942,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...wordDiff !== void 0 && { wordDiff },
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
-			...undefinedStyles !== void 0 && { undefinedStyles },
+			undefinedReferences,
 			createUndoEntry: true
 		});
 	}
@@ -926,7 +951,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		if (noteReferenceEditsAllowed()) return this.applyDocumentOperationsToStoryState(options);
 		return this.withNotesFollowingReferences(() => this.applyDocumentOperationsToStoryState(options));
 	}
-	applyDocumentOperationsToStoryState({ story, batch, author, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles, createUndoEntry }) {
+	applyDocumentOperationsToStoryState({ story, batch, author, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, createUndoEntry }) {
 		const beforeState = this.requireEditableStoryState(story);
 		const operationAuthor = author ?? this.author;
 		const sourceSnapshot = snapshot ?? createStateSnapshot(beforeState);
@@ -947,7 +972,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...wordDiff !== void 0 && { wordDiff },
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
-			...undefinedStyles !== void 0 && { undefinedStyles },
+			undefinedReferences,
 			createCommentId: (text) => {
 				const comment = createReviewerComment({
 					id: this.nextCommentId(),
@@ -1616,6 +1641,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				}
 			};
 			const applied = applyFolioDocumentOperations({
+				undefinedReferences: "refuse",
 				view,
 				snapshot,
 				batch: {
@@ -2214,6 +2240,7 @@ const getFolioDocxComparisonAccess = (reviewer) => comparisonAccessByReviewer.ge
 const applyFolioAIEditsToBuffer = async (buffer, operations, options = {}) => {
 	const reviewer = await FolioDocxReviewer.fromBuffer(buffer, { ...options.author !== void 0 && { author: options.author } });
 	const { applied, skipped } = reviewer.applyOperations(operations, {
+		undefinedReferences: "refuse",
 		...options.mode !== void 0 && { mode: options.mode },
 		...options.snapshot !== void 0 && { snapshot: options.snapshot }
 	});

package/dist/ai-edits/index.d.ts

@@ -1,7 +1,7 @@
 import { FolioContentParagraphKind } from "../compare/content-types.js";
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIInsertFormattingScope, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIDiagnosticBlock, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIInsertFormattingScope, FolioAIParagraphBlock, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
 import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./word-diff.js";
-import { FolioAIEditApplyOutcome, FolioAIEditView, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./apply.js";
+import { FolioAIEditApplyOutcome, FolioAIEditView, FolioRevisionStamp, FolioUndefinedReferencePolicy, FolioWordDiffOptions, applyFolioAIEditOperations } from "./apply.js";
 import { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
 import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
@@ -11,4 +11,4 @@ import { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver,
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsToStoryOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioEditableDocumentStoryHandle, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIInsertFormattingScope, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioContentParagraphKind, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioPendingSuggestionLoadResult, type FolioPendingSuggestionRecord, FolioPendingSuggestionRegistry, type FolioPendingSuggestionStaleReason, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIDiagnosticBlock, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIInsertFormattingScope, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioContentParagraphKind, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioPendingSuggestionLoadResult, type FolioPendingSuggestionRecord, FolioPendingSuggestionRegistry, type FolioPendingSuggestionStaleReason, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioUndefinedReferencePolicy, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/newListNumbering.d.ts

@@ -1,16 +1,10 @@
-import { FolioAIEditOperation, FolioAIListNumbering, FolioAIListReference, FolioAINewListReference } from "./types.js";
+import { FolioAIEditOperation, FolioAIListNumbering, FolioAINewListReference, FolioAIResolvedEditOperation } from "./types.js";
 import { NumberingMap } from "../docx/numberingParser.js";
 //#region src/ai-edits/newListNumbering.d.ts
 /** Whether `numbering` asks for a new list rather than naming an instance. */
 declare const isFolioAINewListReference: (numbering: FolioAIListNumbering) => numbering is FolioAINewListReference;
-/**
- * The concrete instance an operation's numbering names once new lists are
- * resolved. A new-list request reaching this point skipped resolution, which
- * is a bug in the apply path rather than a malformed operation.
- */
-declare const concreteListReference: (numbering: FolioAIListNumbering) => FolioAIListReference;
 type ResolvedNewLists = {
-  operations: FolioAIEditOperation[];
+  operations: FolioAIResolvedEditOperation[];
   numbering: NumberingMap | null;
 };
 /**
@@ -20,4 +14,4 @@ type ResolvedNewLists = {
  */
 declare const resolveNewListOperations: (operations: readonly FolioAIEditOperation[], numbering: NumberingMap | null) => ResolvedNewLists;
 //#endregion
-export { concreteListReference, isFolioAINewListReference, resolveNewListOperations };
+export { isFolioAINewListReference, resolveNewListOperations };

package/dist/ai-edits/newListNumbering.js

@@ -1,9 +1,9 @@
 import { mintListInstance } from "../docx/listNumberingInstances.js";
 import { createNumberingMap } from "../docx/numberingParser.js";
-import { panic } from "better-result";
+import { paragraphNumberingReference } from "../docx/numberingReference.js";
 //#region src/ai-edits/newListNumbering.ts
 /**
-* Operations that start a new list (`numbering: { start: "new", kind }`)
+* Operations that start a new list (`numbering: { kind: "newList", format }`)
 * resolved to the numbering instance each one defines.
 *
 * The instance is minted against the document's numbering (the package's
@@ -14,16 +14,7 @@ import { panic } from "better-result";
 * defines it in the saved package (see `docx/listNumberingInstances.ts`).
 */
 /** Whether `numbering` asks for a new list rather than naming an instance. */
-const isFolioAINewListReference = (numbering) => "start" in numbering;
-/**
-* The concrete instance an operation's numbering names once new lists are
-* resolved. A new-list request reaching this point skipped resolution, which
-* is a bug in the apply path rather than a malformed operation.
-*/
-const concreteListReference = (numbering) => {
-	if (isFolioAINewListReference(numbering)) return panic("A new-list numbering request reached apply unresolved");
-	return numbering;
-};
+const isFolioAINewListReference = (numbering) => numbering.kind === "newList";
 /**
 * Replace every new-list request with a reference to an instance minted for
 * its operation: one instance per operation and kind. `numbering` is the map
@@ -35,51 +26,55 @@ const resolveNewListOperations = (operations, numbering) => {
 	const resolveOperation = (operation) => {
 		const instances = /* @__PURE__ */ new Map();
 		const resolve = (value) => {
-			if (value === null || value === void 0 || !isFolioAINewListReference(value)) return value;
-			let numId = instances.get(value.kind);
+			if (value === void 0 || !isFolioAINewListReference(value)) return value;
+			let numId = instances.get(value.format);
 			if (numId === void 0) {
-				const instance = mintListInstance(definitions, { kind: value.kind });
+				const instance = mintListInstance(definitions, { kind: value.format });
 				definitions = instance.definitions;
 				numId = instance.numId;
-				instances.set(value.kind, numId);
+				instances.set(value.format, numId);
 				minted = true;
 			}
-			return {
+			return paragraphNumberingReference({
 				numId,
-				level: value.level ?? 0
+				ilvl: value.level ?? 0
+			});
+		};
+		const resolveProperties = (properties) => {
+			const { numbering: request, ...rest } = properties;
+			const resolved = resolve(request);
+			return {
+				...rest,
+				...resolved !== void 0 && { numbering: resolved }
 			};
 		};
-		const resolveProperties = (properties) => properties?.numbering ? {
-			...properties,
-			numbering: resolve(properties.numbering)
-		} : properties;
 		switch (operation.type) {
 			case "insertAfterBlock":
-			case "insertBeforeBlock": return operation.numbering ? {
-				...operation,
-				numbering: resolve(operation.numbering)
-			} : operation;
-			case "setBlockParagraphProperties": return operation.properties.numbering ? {
+			case "insertBeforeBlock": {
+				const { numbering: request, ...rest } = operation;
+				const resolved = resolve(request);
+				return {
+					...rest,
+					...resolved !== void 0 && { numbering: resolved }
+				};
+			}
+			case "setBlockParagraphProperties": return {
 				...operation,
-				properties: {
-					...operation.properties,
-					numbering: resolve(operation.properties.numbering)
-				}
-			} : operation;
+				properties: resolveProperties(operation.properties)
+			};
 			case "splitBlock": {
-				const firstParagraphProperties = resolveProperties(operation.firstParagraphProperties);
-				const secondParagraphProperties = resolveProperties(operation.secondParagraphProperties);
+				const { firstParagraphProperties: firstRequest, secondParagraphProperties: secondRequest, ...rest } = operation;
 				return {
-					...operation,
-					...firstParagraphProperties && { firstParagraphProperties },
-					...secondParagraphProperties && { secondParagraphProperties }
+					...rest,
+					...firstRequest !== void 0 && { firstParagraphProperties: resolveProperties(firstRequest) },
+					...secondRequest !== void 0 && { secondParagraphProperties: resolveProperties(secondRequest) }
 				};
 			}
 			case "mergeBlockWithNext": {
-				const mergedParagraphProperties = resolveProperties(operation.mergedParagraphProperties);
+				const { mergedParagraphProperties: request, ...rest } = operation;
 				return {
-					...operation,
-					...mergedParagraphProperties && { mergedParagraphProperties }
+					...rest,
+					...request !== void 0 && { mergedParagraphProperties: resolveProperties(request) }
 				};
 			}
 			default: return operation;
@@ -91,4 +86,4 @@ const resolveNewListOperations = (operations, numbering) => {
 	};
 };
 //#endregion
-export { concreteListReference, isFolioAINewListReference, resolveNewListOperations };
+export { isFolioAINewListReference, resolveNewListOperations };

package/dist/ai-edits/referenceClassification.d.ts

@@ -0,0 +1,22 @@
+//#region src/ai-edits/referenceClassification.d.ts
+type ResourceReferenceClassificationOptions = {
+  kind: "style";
+  id: string;
+  sourceDefines: (id: string) => boolean;
+  destinationDefines: (id: string) => boolean;
+} | {
+  kind: "numbering";
+  id: number;
+  sourceDefines: (id: number) => boolean;
+  destinationDefines: (id: number) => boolean;
+};
+declare const REFERENCE_DISPOSITIONS: {
+  readonly sourceDefined: "sourceDefined";
+  readonly destinationCollision: "destinationCollision";
+  readonly unknown: "unknown";
+};
+type ReferenceDisposition = (typeof REFERENCE_DISPOSITIONS)[keyof typeof REFERENCE_DISPOSITIONS];
+/** A missing source reference may stay dangling, but cannot acquire destination meaning. */
+declare const classifyResourceReference: (reference: ResourceReferenceClassificationOptions) => ReferenceDisposition;
+//#endregion
+export { classifyResourceReference };

package/dist/ai-edits/referenceClassification.js

@@ -0,0 +1,21 @@
+import { panic } from "better-result";
+//#region src/ai-edits/referenceClassification.ts
+const REFERENCE_DISPOSITIONS = {
+	sourceDefined: "sourceDefined",
+	destinationCollision: "destinationCollision",
+	unknown: "unknown"
+};
+const classifyReferenceSpace = ({ id, sourceDefines, destinationDefines }) => {
+	if (sourceDefines(id)) return REFERENCE_DISPOSITIONS.sourceDefined;
+	return destinationDefines(id) ? REFERENCE_DISPOSITIONS.destinationCollision : REFERENCE_DISPOSITIONS.unknown;
+};
+/** A missing source reference may stay dangling, but cannot acquire destination meaning. */
+const classifyResourceReference = (reference) => {
+	switch (reference.kind) {
+		case "style": return classifyReferenceSpace(reference);
+		case "numbering": return classifyReferenceSpace(reference);
+		default: return panic("Unhandled resource reference kind", { reference });
+	}
+};
+//#endregion
+export { classifyResourceReference };

package/dist/ai-edits/snapshot.js

@@ -1,11 +1,11 @@
+import { INHERITED_PARAGRAPH_NUMBERING } from "../compare/content-types.js";
 import { isAltChunkMarkup } from "../docx/altChunk.js";
 import { EMPTY_BUILT_IN_STYLE_INDEX, resolveHeadingLevel } from "../docx/builtInStyles.js";
-import { resolveParagraphNumbering } from "../docx/numberingReference.js";
 import { OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC, isOpaqueNestedRowMarkup, opaqueRevisionCarrierName } from "../docx/opaqueCarrier.js";
 import { recreateProseNodeWithParagraphPropertySource } from "../docx/paragraphPropertySource.js";
 import { expectCharacterStyleMarkAttrs, expectHyperlinkMarkAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.js";
 import { createListLabelCounter } from "../prosemirror/listLabels.js";
-import { paragraphNumberingAttr, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
+import { effectiveParagraphNumberingReference, paragraphNumberingAttr, paragraphNumberingSourcesFromBoundary, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
 import { readOutlineLevelAttr } from "../prosemirror/outlineLevelAttr.js";
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { directParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
@@ -42,16 +42,21 @@ const remapFolioAIEditSnapshotNumberingReferences = (snapshot, numIdMap) => {
 	if (numIdMap.size === 0) return snapshot;
 	const metadata = metadataOf(snapshot);
 	const remapNode = (node) => {
-		const numPr = readParagraphNumberingAttr(node.attrs["numPr"]);
-		if (numPr?.kind !== "reference") return node;
-		const remappedNumId = numIdMap.get(numPr.numId);
-		if (remappedNumId === void 0) return node;
+		const remapReference = (numPr) => {
+			if (numPr?.kind !== "reference") return void 0;
+			const numId = numIdMap.get(numPr.numId);
+			return numId === void 0 ? void 0 : paragraphNumberingAttr({
+				...numPr,
+				numId
+			});
+		};
+		const numPr = remapReference(readParagraphNumberingAttr(node.attrs["numPr"]));
+		const numPrFromStyle = remapReference(readParagraphNumberingAttr(node.attrs["numPrFromStyle"]));
+		if (numPr === void 0 && numPrFromStyle === void 0) return node;
 		return recreateProseNodeWithParagraphPropertySource(node, { attrs: {
 			...node.attrs,
-			numPr: paragraphNumberingAttr({
-				...numPr,
-				numId: remappedNumId
-			})
+			...numPr && { numPr },
+			...numPrFromStyle && { numPrFromStyle }
 		} });
 	};
 	const remapped = remapDocument(metadata.sourceDocument, remapNode);
@@ -347,7 +352,15 @@ const alignedNoteReferenceLabels = (base, revised) => numberNoteReferencesLazily
 */
 const relabelFolioAIEditSnapshotNoteReferences = (snapshot, labels) => {
 	const metadata = metadataOf(snapshot);
-	if (!snapshot.blocks.some((block) => block.structuralBoundaries?.some(({ type }) => type === "noteReference"))) return snapshot;
+	if (!snapshot.blocks.some((block) => {
+		switch (block.kind) {
+			case "diagnostic": return false;
+			case "paragraph":
+			case "heading":
+			case "listItem": return block.structuralBoundaries?.some(({ type }) => type === "noteReference") ?? false;
+			default: return panic("Unhandled snapshot block kind", { block });
+		}
+	})) return snapshot;
 	return createFolioAIEditSnapshotInternal(metadata.sourceDocument, metadata.styleResolver, labels);
 };
 const STORY_TABLE_CONTAINER = "container";
@@ -524,7 +537,6 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabe
 		const displayLabel = getDisplayLabel(node, listLabel, kind === "heading");
 		const styleId = getStyleId(node);
 		const directOutlineLevel = node.type.name === "paragraph" ? expectParagraphAttrs(node)._originalFormatting?.outlineLevel : void 0;
-		const listLevel = getListLevel(node);
 		const listReference = getListReference(node);
 		const numberingReferenceKey = getNumberingReferenceKey(node);
 		if (numberingReferenceKey) numberingReferenceKeys.add(numberingReferenceKey);
@@ -552,7 +564,7 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabe
 				...displayLabel !== void 0 && { displayLabel },
 				...styleId !== void 0 && { styleId },
 				...directOutlineLevel !== void 0 && { directOutlineLevel },
-				...listLevel !== void 0 && { listLevel },
+				statedNumbering: readParagraphNumberingAttr(node.attrs["numPr"]) ?? INHERITED_PARAGRAPH_NUMBERING,
 				...listReference !== void 0 && { listReference },
 				...directAlignment !== void 0 && { directAlignment },
 				...directSpacing !== void 0 && { directSpacing },
@@ -616,12 +628,12 @@ const createFolioAIEditSnapshotWithStyleResolver = (doc, styleResolver) => creat
 /**
 * What a reader sees the block as, heading first: a numbered heading (`1.
 * Scope`, numbered through its style or its own `w:numPr`) is a heading that
-* shows a number, with the number in `displayLabel` and its level in
-* `listLevel`. A paragraph is a list item when it shows a marker, which is
+* shows a number, with the number in `displayLabel` and its effective level in
+* `listReference`. A paragraph is a list item when it shows a marker, which is
 * when it has a label. One whose numbering shows none (a `w:vanish` level, a
 * level its list does not define, or `w:numId="0"` cancelling its style's
-* numbering) reads as prose and is a paragraph, keeping its `listLevel` and
-* `listReference`.
+* numbering) reads as prose and is a paragraph, keeping its `statedNumbering` and
+* effective `listReference`.
 */
 const getBlockKind = (headingLevel, listLabel) => {
 	if (headingLevel !== void 0) return "heading";
@@ -641,35 +653,22 @@ const getDisplayLabel = (node, listLabel, isHeading) => {
 	const styleId = node.attrs["styleId"];
 	if (isHeading && typeof styleId === "string") return styleId;
 };
-/**
-* The level the paragraph's `<w:numPr>` states, and only that. An absent
-* `w:ilvl` renders as level zero but is not a stated zero, and a caller that
-* writes it back would turn an untouched paragraph into one stating a level
-* its source never did.
-*/
-const getListLevel = (node) => {
-	const numPr = readParagraphNumberingAttr(node.attrs["numPr"]);
-	return numPr === null || numPr.kind === "none" ? void 0 : numPr.ilvl;
-};
-/**
-* The numbering a paragraph attr states, read through the model's own reader.
-*
-* The two functions below used to test the reserved id relationally
-* (`numId > 0`, `numId <= 0`), which is the one spelling that disagreed with
-* the other four: a malformed package's negative id is a dangling reference
-* everywhere else and "not numbered" here.
-*/
-const statedNumbering = (node) => resolveParagraphNumbering(readParagraphNumberingAttr(node.attrs["numPr"]) ?? void 0);
 const getListReference = (node) => {
-	const numbering = statedNumbering(node);
-	return numbering.kind === "reference" ? {
+	const numbering = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
+		numPr: readParagraphNumberingAttr(node.attrs["numPr"]),
+		numPrFromStyle: readParagraphNumberingAttr(node.attrs["numPrFromStyle"])
+	}));
+	return numbering ? {
 		numId: numbering.numId,
 		level: numbering.ilvl
 	} : void 0;
 };
 const getNumberingReferenceKey = (node) => {
-	const numbering = statedNumbering(node);
-	return numbering.kind === "reference" ? `${String(numbering.numId)}:${String(numbering.ilvl)}` : null;
+	const numbering = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
+		numPr: readParagraphNumberingAttr(node.attrs["numPr"]),
+		numPrFromStyle: readParagraphNumberingAttr(node.attrs["numPrFromStyle"])
+	}));
+	return numbering ? `${String(numbering.numId)}:${String(numbering.ilvl)}` : null;
 };
 const getStyleId = (node) => {
 	const styleId = node.attrs["styleId"];