@stll/folio-core 0.58.5 → 0.59.0

package/dist/compat/eigenpal.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../types/document.js";
-import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentFormatRange, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineComparisonResult, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } 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, FolioAIParagraphSpacing, FolioAISignatureParty } from "../ai-edits/types.js";
+import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentFormatRange, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineComparisonResult, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentStatedNumbering, FolioContentTableLocation } from "../compare/content-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, FolioAIParagraphBlock, FolioAIParagraphSpacing, FolioAISignatureParty } from "../ai-edits/types.js";
 import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "../ai-edits/word-diff.js";
-import { FolioAIEditApplyOutcome, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "../ai-edits/apply.js";
+import { FolioAIEditApplyOutcome, FolioRevisionStamp, FolioUndefinedReferencePolicy, FolioWordDiffOptions, applyFolioAIEditOperations } from "../ai-edits/apply.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";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
@@ -42,4 +42,4 @@ import { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersion, FolioYjsAttrS
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DEFAULT_OUTLINE_DEPTH, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_YJS_ATTR_SCHEMA_VERSION, type FinalParagraphMarkRevision, 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 FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, 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 FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type OutlineDepth, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewHiddenRange, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, filterHeadingsByDepth, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DEFAULT_OUTLINE_DEPTH, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, 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_YJS_ATTR_SCHEMA_VERSION, type FinalParagraphMarkRevision, 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 FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStatedNumbering, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, 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 FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioUndefinedReferencePolicy, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type OutlineDepth, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewHiddenRange, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, filterHeadingsByDepth, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/controller/canonicalListRendering.js

@@ -2,8 +2,8 @@ import { foldListNumberFields, planParagraphListNumberFold, unfoldedListNumberCo
 import { computeListMarker } from "../docx/listMarkerComputation.js";
 import { listRenderingDefinitionsMatch } from "../docx/listRendering.js";
 import { computeListRendering, getCachedNumberingMap } from "../docx/numberingParser.js";
-import { mergeParagraphNumbering, paragraphNumberingReferenceId, sameStatedParagraphNumbering } from "../docx/numberingReference.js";
 import { assignParagraphIndentationProjection, cloneParagraphWithPropertySource, paragraphFormattingWithAuthoredIndentation, sameParagraphIndentationProjection } from "../docx/paragraphPropertySource.js";
+import { effectiveParagraphNumberingReference, paragraphNumberingSourcesFromBoundary } from "../prosemirror/numberingAttr.js";
 import { paragraphIndentationFromFormatting } from "../prosemirror/paragraphIndentation.js";
 import { listIndentationProvenancePatch } from "../prosemirror/styles/resolvedStyleAttrs.js";
 import { createStyleResolver } from "../prosemirror/styles/styleResolver.js";
@@ -35,16 +35,8 @@ const normalizeCanonicalListRendering = (document) => {
 				snapshot: paragraphFormattingWithAuthoredIndentation(paragraph)
 			});
 			const formatting = paragraph.formatting;
-			const numPr = mergeParagraphNumbering(formatting?.numPrFromStyle, formatting?.numPr);
-			if (paragraph.listRendering === void 0 && formatting?.numPrFromStyle === void 0 && (numPr?.kind !== "reference" || numbering === null)) {
-				computeListMarker(paragraph, counters);
-				return paragraph;
-			}
-			const definition = numPr?.kind === "reference" && numbering !== null ? computeListRendering(numPr, numbering) : null;
-			const cached = paragraph.listRendering;
-			const rendering = definition !== null && cached !== void 0 && listRenderingDefinitionsMatch(cached, definition) ? { ...cached } : definition;
 			const next = cloneParagraphWithPropertySource(paragraph, {});
-			if (formatting?.numPrFromStyle !== void 0 && formatting.numPr !== void 0 && paragraphNumberingReferenceId(numPr) !== paragraphNumberingReferenceId(formatting.numPrFromStyle)) {
+			if (formatting?.numPrFromStyle !== void 0 && (formatting.numPr?.kind === "reference" || formatting.numPr?.kind === "none")) {
 				next.formatting = { ...formatting };
 				delete next.formatting.numPrFromStyle;
 				inverse.push({
@@ -54,18 +46,17 @@ const normalizeCanonicalListRendering = (document) => {
 					patch: { numPrFromStyle: formatting.numPrFromStyle }
 				});
 			}
-			if (formatting?.numPrFromStyle !== void 0 && numPr?.kind === "reference" && !sameStatedParagraphNumbering(formatting.numPr, numPr)) {
-				next.formatting = {
-					...next.formatting,
-					numPr
-				};
-				inverse.push({
-					type: DOCUMENT_OP_TYPES.SET_PARAGRAPH_PROPS,
-					story,
-					blockId: paragraph.paraId ?? panic("Canonical numbering normalization requires paragraph identities."),
-					patch: { numPr: formatting.numPr ?? null }
-				});
+			const numPr = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
+				numPr: next.formatting?.numPr,
+				numPrFromStyle: next.formatting?.numPrFromStyle
+			}));
+			if (paragraph.listRendering === void 0 && formatting?.numPrFromStyle === void 0 && (numPr?.kind !== "reference" || numbering === null)) {
+				computeListMarker(paragraph, counters);
+				return paragraph;
 			}
+			const definition = numPr?.kind === "reference" && numbering !== null ? computeListRendering(numPr, numbering) : null;
+			const cached = paragraph.listRendering;
+			const rendering = definition !== null && cached !== void 0 && listRenderingDefinitionsMatch(cached, definition) ? { ...cached } : definition;
 			const authoredFormatting = paragraphFormattingWithAuthoredIndentation(next);
 			assignParagraphIndentationProjection({
 				paragraph: next,
@@ -73,7 +64,7 @@ const normalizeCanonicalListRendering = (document) => {
 				inherited: paragraphIndentationFromFormatting(listIndentationProvenancePatch({
 					direct: paragraphIndentationFromFormatting(authoredFormatting),
 					styleFormatting: styles.resolveParagraphStyle(next.formatting?.styleId).paragraphFormatting,
-					numberingSource: next.formatting?.numPrFromStyle === void 0 ? "paragraph" : "style",
+					numberingSource: next.formatting?.numPr?.kind === "reference" || next.formatting?.numPrFromStyle === void 0 ? "paragraph" : "style",
 					numPr: numPr?.kind === "reference" ? {
 						numId: numPr.numId,
 						ilvl: numPr.ilvl ?? 0

package/dist/controller/canonicalPublicOperations.js

@@ -193,7 +193,7 @@ var CanonicalPublicOperations = class {
 				skip(operation.id, "unsupportedMode", "Canonical pending suggestions are unavailable.");
 				continue;
 			}
-			if (options.tableTemplates !== void 0 || options.undefinedStyles === "keep") {
+			if (options.tableTemplates !== void 0 || options.undefinedReferences === "keep") {
 				refusals.set(operation.id, { gap: CANONICAL_GAP.publicUnsupportedInline });
 				skip(operation.id, "unsupportedBlock", "This canonical compiler does not support the supplied execution options.");
 				continue;

package/dist/controller/canonicalStructure.js

@@ -1,6 +1,7 @@
 import { BUILT_IN_STYLE_NAME, createBuiltInStyleIndex } from "../docx/builtInStyles.js";
 import { getCachedNumberingMap, numberingLevelUsesBulletMarker } from "../docx/numberingParser.js";
 import { listRequestsForMarker } from "../prosemirror/listAutoformatMarkers.js";
+import { effectiveParagraphNumbering, paragraphNumberingSourcesFromBoundary } from "../prosemirror/numberingAttr.js";
 import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { collectHeadings } from "../utils/headingCollector.js";
 import { CanonicalSessionError } from "./canonicalSession.js";
@@ -27,6 +28,10 @@ const selectedParagraphs = (session, state) => {
 	});
 	return session.document.package.document.content.filter((paragraph) => paragraph.type === "paragraph" && ids.has(paragraph.paraId ?? ""));
 };
+const effectiveNumbering = (paragraph) => effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+	numPr: paragraph?.formatting?.numPr,
+	numPrFromStyle: paragraph?.formatting?.numPrFromStyle
+}));
 const numberingIntent = (session, paragraphs, request) => {
 	const definitions = session.document.package.numbering;
 	const map = definitions === void 0 ? void 0 : getCachedNumberingMap(definitions);
@@ -184,8 +189,8 @@ const prepareCanonicalCommands = (session, state, commands) => {
 		case "toggleList": {
 			const definitions = session.document.package.numbering;
 			const map = definitions === void 0 ? void 0 : getCachedNumberingMap(definitions);
-			if (!(paragraphs.length > 0 && paragraphs.every(({ formatting }) => {
-				const numPr = formatting?.numPr;
+			if (!(paragraphs.length > 0 && paragraphs.every((paragraph) => {
+				const numPr = effectiveNumbering(paragraph);
 				return numPr?.kind === "reference" && numberingLevelUsesBulletMarker(map?.getLevel(numPr.numId, numPr.ilvl ?? 0)) === (command.kind === "bullet");
 			}))) {
 				intents.push(numberingIntent(session, paragraphs, { kind: command.kind === "bullet" ? "bullet" : "numbered" }));
@@ -215,7 +220,7 @@ const prepareCanonicalCommands = (session, state, commands) => {
 			break;
 		case "changeListLevel":
 			for (const paragraph of paragraphs) {
-				const numPr = paragraph.formatting?.numPr;
+				const numPr = effectiveNumbering(paragraph);
 				if (numPr?.kind !== "reference") continue;
 				const at = {
 					story: OP_STORIES.MAIN,
@@ -227,30 +232,46 @@ const prepareCanonicalCommands = (session, state, commands) => {
 				intents.push({
 					type: "formatParagraph",
 					at,
-					patch: { numPr: level < 0 ? { kind: "none" } : paragraphNumberingReference({
-						numId: numPr.numId,
-						ilvl: level
-					}) }
+					patch: { numPr: (() => {
+						if (level < 0) return { kind: "none" };
+						if (paragraph.formatting?.numPr?.kind !== "reference" && paragraph.formatting?.numPrFromStyle?.kind === "reference") return {
+							kind: "levelOnly",
+							ilvl: level
+						};
+						return paragraphNumberingReference({
+							numId: numPr.numId,
+							ilvl: level
+						});
+					})() }
 				});
 			}
 			break;
 		case "restartNumbering":
 		case "continueNumbering": {
 			const source = paragraphs.at(0);
-			const numPr = source?.formatting?.numPr;
+			const numPr = effectiveNumbering(source);
 			const definitions = session.document.package.numbering;
 			if (source === void 0 || numPr?.kind !== "reference" || definitions === void 0) return noChange("Numbering changes require a list paragraph.");
 			const body = session.document.package.document.content;
 			const index = body.findIndex((item) => item === source);
-			const affected = body.slice(index).filter((item) => item.type === "paragraph" && item.formatting?.numPr?.kind === "reference" && item.formatting.numPr.numId === numPr.numId);
+			const affected = body.slice(index).filter((item) => {
+				if (item.type !== "paragraph") return false;
+				const effective = effectiveNumbering(item);
+				return effective?.kind === "reference" && effective.numId === numPr.numId;
+			});
 			let targetId;
 			let target;
 			if (command.type === "continueNumbering") {
 				const map = getCachedNumberingMap(definitions);
 				const bullet = numberingLevelUsesBulletMarker(map.getLevel(numPr.numId, numPr.ilvl ?? 0));
-				const earlier = body.slice(0, index).findLast((item) => item.type === "paragraph" && item.formatting?.numPr?.kind === "reference" && item.formatting.numPr.numId !== numPr.numId && numberingLevelUsesBulletMarker(map.getLevel(item.formatting.numPr.numId, item.formatting.numPr.ilvl ?? 0)) === bullet);
-				if (earlier?.type !== "paragraph" || earlier.formatting?.numPr?.kind !== "reference") return noChange("There is no preceding compatible list.");
-				targetId = earlier.formatting.numPr.numId;
+				const earlier = body.slice(0, index).findLast((item) => {
+					if (item.type !== "paragraph") return false;
+					const effective = effectiveNumbering(item);
+					return effective?.kind === "reference" && effective.numId !== numPr.numId && numberingLevelUsesBulletMarker(map.getLevel(effective.numId, effective.ilvl ?? 0)) === bullet;
+				});
+				const earlierNumbering = earlier?.type === "paragraph" ? effectiveNumbering(earlier) : void 0;
+				if (earlierNumbering?.kind !== "reference") return noChange("There is no preceding compatible list.");
+				targetId = earlierNumbering.numId;
 				target = {
 					type: "existing",
 					numId: targetId
@@ -278,14 +299,17 @@ const prepareCanonicalCommands = (session, state, commands) => {
 			intents.push({
 				type: "setList",
 				target,
-				items: affected.map((paragraph) => ({
-					at: {
-						story: OP_STORIES.MAIN,
-						blockId: paragraph.paraId ?? "",
-						offset: 0
-					},
-					ilvl: paragraph.formatting?.numPr?.kind === "reference" ? paragraph.formatting.numPr.ilvl ?? 0 : 0
-				}))
+				items: affected.map((paragraph) => {
+					const effective = effectiveNumbering(paragraph);
+					return {
+						at: {
+							story: OP_STORIES.MAIN,
+							blockId: paragraph.paraId ?? "",
+							offset: 0
+						},
+						ilvl: effective?.kind === "reference" ? effective.ilvl ?? 0 : 0
+					};
+				})
 			});
 			break;
 		}
@@ -299,7 +323,7 @@ const prepareCanonicalAutoformat = (session, state, { from, to, text }) => {
 	const at = session.projection.addressAt(from);
 	if (at.isErr()) return void 0;
 	const address = session.projection.paragraph(at.value.blockId);
-	if (address === void 0 || address.source.formatting?.numPr?.kind === "reference") return void 0;
+	if (address === void 0 || effectiveNumbering(address.source)?.kind === "reference") return void 0;
 	const source = address.source;
 	const prefix = address.text.slice(0, at.value.offset) + text;
 	const requests = listRequestsForMarker(prefix);

package/dist/document-operations.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "./types/document.js";
 import { FolioTableTemplates } from "./ai-edits/table-template.js";
 import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditNormalization, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
-import { FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedStylePolicy, FolioWordDiffOptions } from "./ai-edits/apply.js";
+import { FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedReferencePolicy, FolioWordDiffOptions } from "./ai-edits/apply.js";
 //#region src/document-operations.d.ts
 declare const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION: 1;
 /** Direct paragraph-alignment values accepted by the operation contract. */
@@ -298,14 +298,9 @@ type ApplyFolioDocumentOperationsOptions = {
    * revised document — keeps them instead.
    */
   replacementBackground?: FolioReplacementBackground;
-  /**
-   * What an operation naming a paragraph style the document does not define
-   * does. Refusing it (`missingStyle`) is the default; a caller copying the
-   * style references of another document — a comparison reproducing the
-   * revised one — keeps them instead.
-   */
-  undefinedStyles?: FolioUndefinedStylePolicy;
+  /** Required policy for undefined style and numbering references. */
+  undefinedReferences: FolioUndefinedReferencePolicy;
 };
-declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
+declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
 //#endregion
 export { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, 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_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationBatchPrecondition, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationQueuedOperation, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOperationReceiptsForStory, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/document-operations.js

@@ -1,13 +1,13 @@
 import { applyFolioAIEditOperations, previewFolioAIEditOperationsWithResult } from "./ai-edits/apply.js";
 import { describeModelError, findIntroducedModelErrors } from "./ai-edits/result-validation.js";
 import { LIST_KINDS } from "./docx/listNumberingInstances.js";
-import { isNumberingReference } from "./docx/numberingReference.js";
 import { completeNumberingForDoc } from "./prosemirror/listInstanceReferences.js";
 import { outlineLevelFromAttrValue } from "./prosemirror/outlineLevelAttr.js";
 import { getStatedDocumentNumbering } from "./prosemirror/plugins/documentNumbering.js";
 import { LINE_SPACING_RULE_VALUES, PARAGRAPH_ALIGNMENT_VALUES } from "./types/documentEnumValues.js";
 import { TaggedError } from "better-result";
 import { sanitizeXmlCharacters } from "@stll/docx-core";
+import { isNumberingReference, paragraphNumberingReference } from "@stll/docx-core/model";
 //#region src/document-operations.ts
 const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION = 1;
 /** Direct paragraph-alignment values accepted by the operation contract. */
@@ -210,16 +210,6 @@ const readNonNegativeInteger = (value, key, path) => {
 	if (typeof candidate === "number" && Number.isSafeInteger(candidate) && candidate >= 0) return candidate;
 	return invalidBatch(`${path}.${key}`, "expected a non-negative safe integer");
 };
-/**
-* A non-negative integer that may also be cleared. `undefined` is "say
-* nothing"; `null` is "there is none", which is a different instruction and
-* the one absence alone cannot give.
-*/
-const readClearableNonNegativeInteger = (value, key, path) => {
-	const candidate = value[key];
-	if (candidate === void 0) return;
-	return candidate === null ? null : readNonNegativeInteger(value, key, path);
-};
 const readClearableParagraphAlignment = ({ value, key, path }) => {
 	const candidate = value[key];
 	if (candidate === void 0 || candidate === null) return candidate;
@@ -302,43 +292,64 @@ const readClearableParagraphIndentation = ({ value, key, path }) => {
 const MAX_NEW_LIST_LEVEL = 8;
 const LIST_KIND_SET = new Set(LIST_KINDS);
 const isListKind = (value) => LIST_KIND_SET.has(value);
-/** `{ start: "new", kind, level? }`: a list the operation starts. */
+/** `{ kind: "newList", format, level? }`: a list the operation starts. */
 const readNewListReference = (candidate, numberingPath) => {
 	assertAllowedKeys(candidate, numberingPath, [
-		"start",
 		"kind",
+		"format",
 		"level"
 	]);
-	const kind = candidate["kind"];
-	if (typeof kind !== "string" || !isListKind(kind)) return invalidBatch(`${numberingPath}.kind`, `expected one of ${LIST_KINDS.join(", ")}`);
+	const format = candidate["format"];
+	if (typeof format !== "string" || !isListKind(format)) return invalidBatch(`${numberingPath}.format`, `expected one of ${LIST_KINDS.join(", ")}`);
 	if (candidate["level"] === void 0) return {
-		start: "new",
-		kind
+		kind: "newList",
+		format
 	};
 	const level = readNonNegativeInteger(candidate, "level", numberingPath);
 	if (level > MAX_NEW_LIST_LEVEL) return invalidBatch(`${numberingPath}.level`, `expected at most ${MAX_NEW_LIST_LEVEL}`);
 	return {
-		start: "new",
-		kind,
+		kind: "newList",
+		format,
 		level
 	};
 };
 const readClearableNumbering = ({ value, key, path }) => {
 	const candidate = value[key];
-	if (candidate === void 0 || candidate === null) return candidate;
+	if (candidate === void 0) return void 0;
 	const numberingPath = `${path}.${key}`;
-	if (!isPlainObject(candidate)) return invalidBatch(numberingPath, "expected an object or null when provided");
-	if (candidate["start"] !== void 0) {
-		if (candidate["start"] !== "new") return invalidBatch(`${numberingPath}.start`, "expected \"new\"");
-		return readNewListReference(candidate, numberingPath);
+	if (!isPlainObject(candidate)) return invalidBatch(numberingPath, "expected a numbering object");
+	const kind = candidate["kind"];
+	if (kind === "none" || kind === "inherit") {
+		assertAllowedKeys(candidate, numberingPath, ["kind"]);
+		return { kind };
 	}
-	assertAllowedKeys(candidate, numberingPath, ["numId", "level"]);
-	const numId = readNonNegativeInteger(candidate, "numId", numberingPath);
-	if (!isNumberingReference(numId)) return invalidBatch(`${numberingPath}.numId`, "expected a positive integer");
-	return {
-		numId,
-		level: readNonNegativeInteger(candidate, "level", numberingPath)
-	};
+	if (kind === "levelOnly") {
+		assertAllowedKeys(candidate, numberingPath, ["kind", "ilvl"]);
+		const ilvl = readNonNegativeInteger(candidate, "ilvl", numberingPath);
+		if (ilvl > MAX_NEW_LIST_LEVEL) return invalidBatch(`${numberingPath}.ilvl`, `expected at most ${MAX_NEW_LIST_LEVEL}`);
+		return {
+			kind,
+			ilvl
+		};
+	}
+	if (kind === "reference") {
+		assertAllowedKeys(candidate, numberingPath, [
+			"kind",
+			"numId",
+			"ilvl"
+		]);
+		const numId = readNonNegativeInteger(candidate, "numId", numberingPath);
+		if (!isNumberingReference(numId)) return invalidBatch(`${numberingPath}.numId`, "expected a positive integer");
+		if (candidate["ilvl"] === void 0) return paragraphNumberingReference({ numId });
+		const ilvl = readNonNegativeInteger(candidate, "ilvl", numberingPath);
+		if (ilvl > MAX_NEW_LIST_LEVEL) return invalidBatch(`${numberingPath}.ilvl`, `expected at most ${MAX_NEW_LIST_LEVEL}`);
+		return paragraphNumberingReference({
+			numId,
+			ilvl
+		});
+	}
+	if (kind === "newList") return readNewListReference(candidate, numberingPath);
+	return invalidBatch(`${numberingPath}.kind`, "expected \"none\", \"inherit\", \"levelOnly\", \"reference\", or \"newList\"");
 };
 /**
 * A rectangular grid of cell texts. Rectangular because a table whose rows
@@ -376,7 +387,6 @@ const readParagraphProperties = ({ value, key, path }) => {
 	assertAllowedKeys(candidate, propertiesPath, [
 		"styleId",
 		"outlineLevel",
-		"listLevel",
 		"numbering",
 		"alignment",
 		"spacing",
@@ -384,7 +394,6 @@ const readParagraphProperties = ({ value, key, path }) => {
 	]);
 	const styleId = candidate["styleId"] === null ? null : readOptionalString(candidate, "styleId", propertiesPath);
 	const outlineLevel = readClearableOutlineLevel(candidate, propertiesPath);
-	const listLevel = readClearableNonNegativeInteger(candidate, "listLevel", propertiesPath);
 	const numbering = readClearableNumbering({
 		value: candidate,
 		key: "numbering",
@@ -405,11 +414,10 @@ const readParagraphProperties = ({ value, key, path }) => {
 		key: "indentation",
 		path: propertiesPath
 	});
-	if (styleId === void 0 && outlineLevel === void 0 && listLevel === void 0 && numbering === void 0 && alignment === void 0 && spacing === void 0 && indentation === void 0) return invalidBatch(propertiesPath, "expected at least one property to set");
+	if (styleId === void 0 && outlineLevel === void 0 && numbering === void 0 && alignment === void 0 && spacing === void 0 && indentation === void 0) return invalidBatch(propertiesPath, "expected at least one property to set");
 	return {
 		...styleId !== void 0 && { styleId },
 		...outlineLevel !== void 0 && { outlineLevel },
-		...listLevel !== void 0 && { listLevel },
 		...numbering !== void 0 && { numbering },
 		...alignment !== void 0 && { alignment },
 		...spacing !== void 0 && { spacing },
@@ -555,7 +563,6 @@ const OPERATION_KEY_DECISIONS = {
 		indentation: true,
 		lineBreakMode: true,
 		formattingScope: true,
-		listLevel: true,
 		numbering: true,
 		moveId: true,
 		pageBreakBefore: true,
@@ -573,7 +580,6 @@ const OPERATION_KEY_DECISIONS = {
 		indentation: true,
 		lineBreakMode: true,
 		formattingScope: true,
-		listLevel: true,
 		numbering: true,
 		moveId: true,
 		pageBreakBefore: true,
@@ -833,7 +839,6 @@ const parseDocumentOperation = (value, index) => {
 		const styleId = value["styleId"] === null ? null : readOptionalString(value, "styleId", path);
 		const outlineLevel = readClearableOutlineLevel(value, path);
 		const moveId = readOptionalString(value, "moveId", path);
-		const listLevel = readClearableNonNegativeInteger(value, "listLevel", path);
 		const numbering = readClearableNumbering({
 			value,
 			key: "numbering",
@@ -874,7 +879,6 @@ const parseDocumentOperation = (value, index) => {
 			...indentation !== void 0 && { indentation },
 			...lineBreakMode !== void 0 && { lineBreakMode },
 			...formattingScope !== void 0 && { formattingScope },
-			...listLevel !== void 0 && { listLevel },
 			...numbering !== void 0 && { numbering },
 			...moveId !== void 0 && { moveId },
 			...pageBreakBefore !== void 0 && { pageBreakBefore },
@@ -1250,7 +1254,7 @@ const inOperationOrder = (operations, skipped) => {
 	const indexById = new Map(operations.map(({ id }, index) => [id, index]));
 	return [...skipped].sort((left, right) => (indexById.get(left.id) ?? -1) - (indexById.get(right.id) ?? -1));
 };
-const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles }) => {
+const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences }) => {
 	const parsedBatch = parseFolioDocumentOperationBatch(batch);
 	const isAtomic = parsedBatch.atomic === true;
 	const beforeDoc = view.state.doc;
@@ -1265,7 +1269,7 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", a
 			...wordDiff !== void 0 && { wordDiff },
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
-			...undefinedStyles !== void 0 && { undefinedStyles }
+			undefinedReferences
 		};
 		if (preview) return {
 			...previewFolioAIEditOperationsWithResult({

package/dist/docx/attributeRemainder.d.ts

@@ -1,5 +1,5 @@
-import { XmlElement } from "./xmlParser.js";
 import { ModelledAttributes } from "./propertyElementAttributes.js";
+import { XmlElement } from "./xmlParser.js";
 import { PreservedAttribute } from "@stll/docx-core/model";
 //#region src/docx/attributeRemainder.d.ts
 declare const InvalidPreservedAttributeError_base: import("better-result").TaggedErrorClass<"InvalidPreservedAttributeError">;

package/dist/docx/index.d.ts

@@ -1,6 +1,6 @@
 import { getCachedNumberingMap } from "./numberingParser.js";
-import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, ParagraphNumberingOverride, ParagraphNumberingSlots, ResolvedParagraphNumbering, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "./numberingReference.js";
 import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, DocxEncryptionErrorCode, isDocxEncryptionError } from "./encryption/errors.js";
 import { DecryptDocxOptions, DecryptDocxResult, decryptDocxIfNeeded, openDocxBuffer } from "./encryption/openEncryptedDocx.js";
+import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, ParagraphNumberingOverride, ParagraphNumberingSlots, ResolvedParagraphNumbering, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "./numberingReference.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./metadataPrivacy.js";
 export { DOCX_ENCRYPTION_ERROR_CODES, type DecryptDocxOptions, type DecryptDocxResult, DocxEncryptionError, type DocxEncryptionErrorCode, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, type FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, type ParagraphNumberingOverride, type ParagraphNumberingSlots, type ResolvedParagraphNumbering, type RewriteDocxMetadataPrivacyResult, decryptDocxIfNeeded, getCachedNumberingMap, isDocxEncryptionError, isFolioDocumentPrivacyTransform, isNumberingReference, mergeParagraphNumbering, openDocxBuffer, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, rewriteDocxMetadataPrivacy, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering };

package/dist/docx/listMarkerComputation.js

@@ -1,6 +1,6 @@
 import { bulletMarkerFontName, convertBulletToUnicode } from "./bulletMarkers.js";
+import { resolveListTemplate } from "./listTemplate.js";
 import { isNumberingReference } from "./numberingReference.js";
-import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
 //#region src/docx/listMarkerComputation.ts
 const computeListMarker = (paragraph, { numbering, listCounters, abstractCounters, restartedNumIds, previousList }) => {
 	const listRendering = paragraph.listRendering;
@@ -22,7 +22,7 @@ const computeListMarker = (paragraph, { numbering, listCounters, abstractCounter
 	let counters = listCounters.get(numId);
 	if (!counters) return;
 	const abstractNumId = numbering.getAbstractNumId(numId);
-	const styleNumbering = paragraph.formatting?.numPrFromStyle;
+	const styleNumbering = paragraph.formatting?.numPr?.kind !== "reference" && paragraph.formatting?.numPrFromStyle?.kind === "reference";
 	const resumesRestartedInstance = firstEncounter && listRendering.startOverride === void 0 && abstractNumId !== null && previousList.abstractNumId === abstractNumId && previousList.numId !== null && previousList.numId !== numId && restartedNumIds.has(previousList.numId);
 	const resumesStyleInstance = firstEncounter && !styleNumbering && listRendering.startOverride === void 0 && abstractNumId !== null && previousList.abstractNumId === abstractNumId && previousList.fromStyle === true;
 	if (abstractNumId !== null && (styleNumbering || resumesRestartedInstance || resumesStyleInstance)) {
@@ -60,18 +60,13 @@ const computeListMarker = (paragraph, { numbering, listCounters, abstractCounter
 		previousList.numId = null;
 		return;
 	}
-	let computedMarker = pattern;
-	const useLegalNumbering = numbering.getLevel(numId, level)?.isLgl === true || listRendering.isLegal === true;
-	for (let lvl = 0; lvl <= level; lvl += 1) {
-		const placeholder = `%${lvl + 1}`;
-		if (computedMarker.includes(placeholder)) {
-			const value = counters[lvl] ?? 0;
-			const levelInfo = numbering.getLevel(numId, lvl);
-			const formatted = formatOoxmlCounter(value, useLegalNumbering ? "decimal" : levelInfo?.numFmt || "decimal");
-			computedMarker = computedMarker.replaceAll(placeholder, formatted);
-		}
-	}
-	listRendering.marker = computedMarker;
+	const currentLevelInfo = numbering.getLevel(numId, level);
+	listRendering.marker = resolveListTemplate({
+		template: pattern,
+		counters,
+		levelFormats: listRendering.levelNumFmts ?? counters.map((_counter, ilvl) => numbering.getLevel(numId, ilvl)?.numFmt),
+		forceDecimal: currentLevelInfo?.isLgl === true || listRendering.isLegal === true
+	});
 };
 //#endregion
 export { computeListMarker };

package/dist/docx/listTemplate.d.ts

@@ -0,0 +1,22 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/listTemplate.d.ts
+type ResolvedListComponent = {
+  level: number;
+  relativeStart: number;
+  start: number;
+  end: number;
+};
+type ResolvedListTemplate = {
+  value: string;
+  components: readonly ResolvedListComponent[];
+};
+type ResolveListTemplateOptions = {
+  template: string;
+  counters: readonly number[];
+  levelFormats?: readonly (document_d_exports.CounterFormat | undefined)[] | undefined;
+  forceDecimal?: boolean | undefined;
+};
+declare function resolveListTemplate(options: ResolveListTemplateOptions): string;
+declare function resolveListTemplateWithComponents({ template, counters, levelFormats, forceDecimal }: ResolveListTemplateOptions): ResolvedListTemplate;
+//#endregion
+export { ResolvedListComponent, ResolvedListTemplate, resolveListTemplate, resolveListTemplateWithComponents };

package/dist/docx/listTemplate.js

@@ -0,0 +1,40 @@
+import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
+//#region src/docx/listTemplate.ts
+function resolveListTemplate(options) {
+	return resolveListTemplateWithComponents(options).value;
+}
+function resolveListTemplateWithComponents({ template, counters, levelFormats, forceDecimal = false }) {
+	const components = [];
+	let value = "";
+	let sourceEnd = 0;
+	for (const match of template.matchAll(/%(?<digit>\d)(?<punct>[.):\]])?/gu)) {
+		const sourceStart = match.index;
+		const relativeStart = value.length;
+		value += template.slice(sourceEnd, sourceStart);
+		sourceEnd = sourceStart + match[0].length;
+		const index = Number.parseInt(match.groups?.["digit"] ?? "", 10) - 1;
+		const counter = counters[index];
+		if (index < 0 || counter === void 0 || !Number.isFinite(counter)) {
+			value += match.groups?.["punct"] ?? "";
+			continue;
+		}
+		const formatted = formatOoxmlCounter(counter, forceDecimal ? "decimal" : levelFormats?.[index]);
+		if (!formatted) continue;
+		const start = value.length;
+		value += formatted;
+		components.push({
+			level: index,
+			relativeStart,
+			start,
+			end: value.length
+		});
+		value += match.groups?.["punct"] ?? "";
+	}
+	value += template.slice(sourceEnd);
+	return {
+		value,
+		components
+	};
+}
+//#endregion
+export { resolveListTemplate, resolveListTemplateWithComponents };