@stll/folio-core 0.42.0 → 0.43.0

package/dist/index.d.ts

@@ -30,7 +30,7 @@ import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "./page
 import { AICitationRange, createAICitationDecorationsPlugin, setAICitationsMeta, setActiveCitationMeta } from "./prosemirror/plugins/aiCitationDecorations.js";
 import { AnonymizationMatch, AnonymizationTerm, anonymizationDecorationsKey, getAnonymizationMatches, setAnonymizationTermsMeta } from "./prosemirror/plugins/anonymizationDecorations.js";
 import { DirectiveKind, DirectiveRange, getTemplateDirectives, scanDirectives } from "./prosemirror/plugins/templateDirectives.js";
-import { TemplatePreviewSpan, TemplatePreviewValue, TemplatePreviewValues, setTemplatePreviewValues } from "./prosemirror/plugins/templatePreviewValues.js";
+import { TemplatePreviewHiddenRange, TemplatePreviewSpan, TemplatePreviewValue, TemplatePreviewValues, setTemplatePreviewValues } from "./prosemirror/plugins/templatePreviewValues.js";
 import { TemplateSlashMenuKeyAction, TemplateSlashMenuState, clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu, resetTemplateSlashQuery, templateSlashMenuKey } from "./prosemirror/plugins/templateSlashMenu.js";
 import { AcceptAutocompleteResult, AutocompleteSuggestionPluginOptions, AutocompleteSuggestionState, AutocompleteSuggestionStatus, AutocompleteTriggerCheck, AutocompleteTriggerOptions, AutocompleteTriggerSkipReason, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "./prosemirror/plugins/autocompleteSuggestion.js";
 import { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult } from "./markdown/types.js";
@@ -41,4 +41,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 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, 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, 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 ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, 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, 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, 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, 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 ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, 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, 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/internal/pageBreakRunSourceDescendantIndex.d.ts

@@ -2,6 +2,8 @@ import { document_d_exports } from "../types/document.js";
 //#region src/internal/pageBreakRunSourceDescendantIndex.d.ts
 type PageBreakRunSourceDescendantIndex = {
   containsPageBreakRun: (content: readonly document_d_exports.BlockContent[]) => boolean;
+  /** The same question about one block, so a caller can ask it per sibling. */
+  blockContainsPageBreakRun: (block: document_d_exports.BlockContent) => boolean;
   paragraphFeatures: (paragraph: document_d_exports.Paragraph) => PageBreakRunSourceParagraphFeatures;
 };
 type PageBreakRunSourceParagraphFeatures = {

package/dist/internal/pageBreakRunSourceDescendantIndex.js

@@ -105,12 +105,14 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 		return flags;
 	}
 	inspectBlocks(rootContent);
+	const indexedFlags = (node) => {
+		const flags = flagsByObject.get(node);
+		if (flags === void 0) panic("Page-break source ownership was queried outside its conversion index");
+		return flags;
+	};
 	return {
-		containsPageBreakRun: (content) => {
-			const flags = flagsByObject.get(content);
-			if (flags === void 0) panic("Page-break source ownership was queried outside its conversion index");
-			return hasFlag(flags, SOURCE_FLAGS.containsPageBreak);
-		},
+		containsPageBreakRun: (content) => hasFlag(indexedFlags(content), SOURCE_FLAGS.containsPageBreak),
+		blockContainsPageBreakRun: (block) => hasFlag(indexedFlags(block), SOURCE_FLAGS.containsPageBreak),
 		paragraphFeatures: (paragraph) => {
 			const flags = flagsByObject.get(paragraph);
 			if (flags === void 0) panic("Page-break paragraph ownership was queried outside its conversion index");

package/dist/layout-bridge/convert/templatePreviewFlow.d.ts

@@ -1,4 +1,4 @@
-import { TemplatePreviewValue } from "../../prosemirror/plugins/templatePreviewValues.js";
+import { TemplatePreviewHiddenRange, TemplatePreviewValue } from "../../prosemirror/plugins/templatePreviewValues.js";
 import { FlowBlock } from "../../layout-engine/types.js";
 //#region src/layout-bridge/convert/templatePreviewFlow.d.ts
 /** One marker→value substitution, in PM doc positions. */
@@ -10,27 +10,35 @@ type TemplatePreviewFlowEntry = {
   /** The typed value displayed in place of the marker. */
   value: TemplatePreviewValue;
 };
-type TemplatePreviewFlowOptions = {
+/** What the preview substitutes and what it hides, as the flow stage sees it. */
+type TemplatePreviewFlowState = {
   entries: readonly TemplatePreviewFlowEntry[];
+  /** Conditional spans a `false` condition hides, in PM doc positions. */
+  hidden: readonly TemplatePreviewHiddenRange[];
+};
+type TemplatePreviewFlowOptions = TemplatePreviewFlowState & {
   /** `highlighted` marks substituted runs for the accent-chip CSS. */
   mode: "highlighted" | "plain";
 };
 /**
  * Replace each entry's marker range with its preview value across the given
- * flow blocks (recursing into table cells and text boxes). Returns the input
- * array unchanged when there is nothing to substitute.
+ * flow blocks (recursing into table cells and text boxes), and drop the blocks
+ * a hidden conditional span swallows whole. Returns the input array unchanged
+ * when there is nothing to substitute and nothing to hide.
  */
-declare function applyTemplatePreviewToBlocks(blocks: FlowBlock[], { entries, mode }: TemplatePreviewFlowOptions): FlowBlock[];
+declare function applyTemplatePreviewToBlocks(blocks: FlowBlock[], { entries, hidden, mode }: TemplatePreviewFlowOptions): FlowBlock[];
 /**
- * PM range covering every substitution that differs between two preview
- * states (changed, added, or removed entries), or `null` when the
- * substituted flow content is identical. Feeds the layout pipeline's
+ * PM range covering every substitution and every hidden span that differs
+ * between two preview states (changed, added, or removed), or `null` when the
+ * flow content both produce is identical. Feeds the layout pipeline's
  * dirty-range invalidation so typing a value re-measures only the blocks
- * hosting the affected markers.
+ * hosting the affected markers. A hidden span that appears or disappears also
+ * changes the block count, which sends the measure path down its full-remeasure
+ * branch regardless of how wide this range is.
  */
-declare function templatePreviewDirtyRange(previous: readonly TemplatePreviewFlowEntry[], next: readonly TemplatePreviewFlowEntry[]): {
+declare function templatePreviewDirtyRange(previous: TemplatePreviewFlowState, next: TemplatePreviewFlowState): {
   from: number;
   to: number;
 } | null;
 //#endregion
-export { TemplatePreviewFlowEntry, TemplatePreviewFlowOptions, applyTemplatePreviewToBlocks, templatePreviewDirtyRange };
+export { TemplatePreviewFlowEntry, TemplatePreviewFlowOptions, TemplatePreviewFlowState, applyTemplatePreviewToBlocks, templatePreviewDirtyRange };

package/dist/layout-bridge/convert/templatePreviewFlow.js

@@ -1,16 +1,41 @@
-import { templatePreviewValueFingerprint } from "../../prosemirror/plugins/templatePreviewValues.js";
+import { templatePreviewHidesWholeBlock, templatePreviewValueFingerprint } from "../../prosemirror/plugins/templatePreviewValues.js";
 //#region src/layout-bridge/convert/templatePreviewFlow.ts
 /**
+* A top-level block a hidden span swallows whole, which therefore leaves the
+* flow. A block the span only partly covers stays: its text is authored content
+* outside the conditional, and dropping the block would take that text with it.
+*
+* A block carrying no PM positions stays too. That is every section break,
+* which is the safe answer rather than an accident: a section break sets the
+* page geometry that follows it, so hiding text must not take it out of the
+* flow. `SectionBreakBlock` is the one `FlowBlock` variant without the fields,
+* hence the `in` test, matching `findDirtyBlockIndexes`.
+*/
+const isHiddenWholeBlock = (block, hidden) => {
+	const pmStart = "pmStart" in block ? block.pmStart : void 0;
+	const pmEnd = "pmEnd" in block ? block.pmEnd : void 0;
+	if (pmStart === void 0 || pmEnd === void 0) return false;
+	return hidden.some((range) => templatePreviewHidesWholeBlock(range, {
+		pmStart,
+		pmEnd
+	}));
+};
+/**
 * Replace each entry's marker range with its preview value across the given
-* flow blocks (recursing into table cells and text boxes). Returns the input
-* array unchanged when there is nothing to substitute.
+* flow blocks (recursing into table cells and text boxes), and drop the blocks
+* a hidden conditional span swallows whole. Returns the input array unchanged
+* when there is nothing to substitute and nothing to hide.
 */
-function applyTemplatePreviewToBlocks(blocks, { entries, mode }) {
-	if (entries.length === 0) return blocks;
+function applyTemplatePreviewToBlocks(blocks, { entries, hidden, mode }) {
+	if (entries.length === 0 && hidden.length === 0) return blocks;
 	const sorted = [...entries].sort((a, b) => a.from - b.from);
 	let changed = false;
 	const next = [];
 	for (const block of blocks) {
+		if (isHiddenWholeBlock(block, hidden)) {
+			changed = true;
+			continue;
+		}
 		const transformed = transformBlock(block, sorted, mode);
 		changed ||= transformed !== block;
 		next.push(transformed);
@@ -117,60 +142,100 @@ function sliceTextRun(run, base, from, to) {
 		pmEnd: to
 	};
 }
+/** Every newline form a host value may carry; `\r\n` counts once. */
+const VALUE_LINE_BREAK_RE = /\r\n|[\n\r]/u;
+/**
+* Push one span of value text, breaking its lines the way the editor does: each
+* newline becomes a `lineBreak` run, which is the `w:br` the measurer starts a
+* new line on. Consecutive newlines emit consecutive breaks, so a blank line
+* stays a blank line; an empty segment contributes no text run of its own.
+*
+* A rich value's spans are one text stream, so a `\r\n` the host split across a
+* formatting boundary is still one break: `pendingCr` carries a `\r` that ended
+* the previous span, and the returned flag carries this span's. Without it the
+* halves would count as two breaks and the value would gain a blank line.
+*/
+function pushValueSpan(out, valueRun, pendingCr) {
+	const text = pendingCr && valueRun.text.startsWith("\n") ? valueRun.text.slice(1) : valueRun.text;
+	const segments = text.split(VALUE_LINE_BREAK_RE);
+	for (const [index, segment] of segments.entries()) {
+		if (index > 0) out.push({
+			kind: "lineBreak",
+			pmStart: valueRun.pmStart,
+			pmEnd: valueRun.pmEnd
+		});
+		if (segment !== "") out.push({
+			...valueRun,
+			text: segment
+		});
+	}
+	return text.endsWith("\r");
+}
 /**
 * The value run(s) replacing a marker. A plain value is one run carrying the
 * host run's formatting; a rich value emits one run per span, each layering
 * its own bold/italic over the host formatting (host bold stays bold, a
-* span's flags OR in). Every run keeps the marker's full PM range so
-* click-to-position keeps resolving into the marker.
+* span's flags OR in). A newline in either splits its span around a line
+* break run. Every run keeps the marker's full PM range so click-to-position
+* keeps resolving into the marker.
 */
 function buildValueRuns(host, entry, mode) {
-	if (typeof entry.value === "string") return [{
+	const runs = [];
+	const base = {
 		...host,
-		text: entry.value,
 		pmStart: entry.from,
 		pmEnd: entry.to,
 		templatePreview: mode
-	}];
-	return entry.value.runs.map((span) => {
+	};
+	if (typeof entry.value === "string") {
+		pushValueSpan(runs, {
+			...base,
+			text: entry.value
+		}, false);
+		return runs;
+	}
+	let pendingCr = false;
+	for (const span of entry.value.runs) {
 		const valueRun = {
-			...host,
-			text: span.text,
-			pmStart: entry.from,
-			pmEnd: entry.to,
-			templatePreview: mode
+			...base,
+			text: span.text
 		};
 		if (span.bold === true) valueRun.bold = true;
 		if (span.italic === true) valueRun.italic = true;
-		return valueRun;
-	});
+		pendingCr = pushValueSpan(runs, valueRun, pendingCr);
+	}
+	return runs;
 }
 const entryKey = (entry) => `${entry.from}:${entry.to}:${templatePreviewValueFingerprint(entry.value)}`;
+const hiddenKey = (range) => `${range.from}:${range.to}:${range.expr}`;
+/** Widen `bounds` over every range whose key is absent from `known`. */
+const growOverUnknown = (ranges, key, known, bounds) => {
+	for (const range of ranges) {
+		if (known.has(key(range))) continue;
+		bounds.from = Math.min(bounds.from, range.from);
+		bounds.to = Math.max(bounds.to, range.to);
+	}
+};
 /**
-* PM range covering every substitution that differs between two preview
-* states (changed, added, or removed entries), or `null` when the
-* substituted flow content is identical. Feeds the layout pipeline's
+* PM range covering every substitution and every hidden span that differs
+* between two preview states (changed, added, or removed), or `null` when the
+* flow content both produce is identical. Feeds the layout pipeline's
 * dirty-range invalidation so typing a value re-measures only the blocks
-* hosting the affected markers.
+* hosting the affected markers. A hidden span that appears or disappears also
+* changes the block count, which sends the measure path down its full-remeasure
+* branch regardless of how wide this range is.
 */
 function templatePreviewDirtyRange(previous, next) {
-	const previousKeys = new Set(previous.map(entryKey));
-	const nextKeys = new Set(next.map(entryKey));
-	let from = Number.POSITIVE_INFINITY;
-	let to = Number.NEGATIVE_INFINITY;
-	for (const entry of previous) if (!nextKeys.has(entryKey(entry))) {
-		from = Math.min(from, entry.from);
-		to = Math.max(to, entry.to);
-	}
-	for (const entry of next) if (!previousKeys.has(entryKey(entry))) {
-		from = Math.min(from, entry.from);
-		to = Math.max(to, entry.to);
-	}
-	if (from === Number.POSITIVE_INFINITY) return null;
-	return {
-		from,
-		to
+	const bounds = {
+		from: Number.POSITIVE_INFINITY,
+		to: Number.NEGATIVE_INFINITY
 	};
+	growOverUnknown(previous.entries, entryKey, new Set(next.entries.map(entryKey)), bounds);
+	growOverUnknown(next.entries, entryKey, new Set(previous.entries.map(entryKey)), bounds);
+	growOverUnknown(previous.hidden, hiddenKey, new Set(next.hidden.map(hiddenKey)), bounds);
+	growOverUnknown(next.hidden, hiddenKey, new Set(previous.hidden.map(hiddenKey)), bounds);
+	if (bounds.from === Number.POSITIVE_INFINITY) return null;
+	return bounds;
 }
 //#endregion
 export { applyTemplatePreviewToBlocks, templatePreviewDirtyRange };

package/dist/layout-bridge/convert/toFlowBlocks.js

@@ -1175,6 +1175,15 @@ const runIsZeroWidthBoundaryMarker = (run) => {
 		default: return run;
 	}
 };
+/** Every page-break run under a node, nested tables and text boxes included. */
+const countPageBreakRuns = (node) => {
+	let count = node.type.name === "pageBreakRun" ? 1 : 0;
+	node.descendants((descendant) => {
+		if (descendant.type.name === "pageBreakRun") count += 1;
+		return true;
+	});
+	return count;
+};
 /** Decide leading-break eligibility from the exact projected runs consumed by layout. */
 const hasSingleLeadingProjectedPageBreak = (runs, pageBreaks) => {
 	if (pageBreaks.length !== 1) return false;
@@ -1348,12 +1357,12 @@ function convertTableCell(node, startPos, options, tableCellMargins) {
 	const blocks = [];
 	let offset = startPos + 1;
 	const authoredPageBreakPosition = options.firstPageBreakRunPosition(node);
-	const singleParagraph = node.childCount === 1 && node.firstChild?.type.name === "paragraph" ? node.firstChild : void 0;
-	if (authoredPageBreakPosition !== void 0 && singleParagraph === void 0) panic(`An explicit page-break run at ${String(authoredPageBreakPosition)} cannot be projected inside a table cell`);
+	const leadingParagraph = node.firstChild?.type.name === "paragraph" ? node.firstChild : void 0;
+	if (authoredPageBreakPosition !== void 0 && (leadingParagraph === void 0 || countPageBreakRuns(node) !== 1 || options.firstPageBreakRunPosition(leadingParagraph) !== authoredPageBreakPosition)) panic(`An explicit page-break run at ${String(authoredPageBreakPosition)} cannot be projected inside a table cell`);
 	const pageBreaks = [];
 	node.forEach((child) => {
 		if (child.type.name === "paragraph") {
-			const block = convertParagraph(child, offset, options, child === singleParagraph ? pageBreaks : void 0);
+			const block = convertParagraph(child, offset, options, child === leadingParagraph ? pageBreaks : void 0);
 			blocks.push(block);
 		} else if (child.type.name === "table") blocks.push(convertTable(child, offset, options));
 		else if (child.type.name === "textBox") blocks.push(convertTextBoxNode(child, offset, options));

package/dist/prosemirror/commands/pageBreak.js

@@ -5,6 +5,17 @@ const UNSUPPORTED_PAGE_BREAK_RUN_ANCESTORS = /* @__PURE__ */ new Set([
 	"tableHeader",
 	"textBox"
 ]);
+const hasTextBoxAnchorAtOrAfter = (paragraph, contentStart, position) => {
+	let found = false;
+	paragraph.descendants((descendant, offset) => {
+		if (descendant.type.name === "textBoxAnchor" && contentStart + offset >= position) {
+			found = true;
+			return false;
+		}
+		return !found;
+	});
+	return found;
+};
 /**
 * Insert a page-break run at the current text cursor.
 *
@@ -18,7 +29,7 @@ const insertPageBreak = (state, dispatch) => {
 	const { $from } = state.selection;
 	if (!pageBreakRunType || !state.selection.empty || !$from.parent.isTextblock) return false;
 	for (let depth = $from.depth; depth >= 0; depth--) if (UNSUPPORTED_PAGE_BREAK_RUN_ANCESTORS.has($from.node(depth).type.name)) return false;
-	if ($from.parent.type.name !== "paragraph" || pageBreakRunParagraphProjectionDisposition($from.parent).status === "unsupported") return false;
+	if ($from.parent.type.name !== "paragraph" || pageBreakRunParagraphProjectionDisposition($from.parent).status === "unsupported" || hasTextBoxAnchorAtOrAfter($from.parent, $from.start(), $from.pos)) return false;
 	if (dispatch) {
 		const pageBreak = pageBreakRunType.create();
 		dispatch(state.tr.replaceSelectionWith(pageBreak).scrollIntoView());

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -1,4 +1,5 @@
 import { EDITED_PREVIEW_FINGERPRINT, imageRawXmlFingerprint } from "../../docx/imageRawXml.js";
+import { isNumberingReference } from "../../docx/numberingReference.js";
 import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, ParagraphPropertySourceValidationError, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, linkParagraphPropertySourceCandidate, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings } from "../../docx/paragraphPropertySource.js";
 import { visitDocxParagraphs } from "../../docx/paragraphTraversal.js";
 import { ShapeOutlineStyleSchema, narrowEnum } from "../../docx/parserEnums.js";
@@ -689,7 +690,7 @@ function removeTextBoxAnchorFromBlocks(blocks, marker) {
 */
 function listRenderingFromAttrs(attrs) {
 	const numId = attrs.numPr?.numId;
-	if (numId === void 0 || numId === 0) return;
+	if (!isNumberingReference(numId)) return;
 	if (!(attrs.listMarker != null || attrs.listIsBullet || attrs.listNumFmt != null)) return;
 	return listRenderingFromAttrs$1({
 		attrs,

package/dist/prosemirror/conversion/toProseDoc.js

@@ -1,4 +1,5 @@
 import { resolveColorValueToHex } from "../../docx/drawingUtils.js";
+import { isNumberingReference } from "../../docx/numberingReference.js";
 import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, createProseParagraphWithPropertySource, getDocumentParagraphPropertySourceContract, recreateProseNodeWithParagraphPropertySource, transportTableCellsWithParagraphPropertySources } from "../../docx/paragraphPropertySource.js";
 import { buildPageBreakRunSourceDescendantIndex } from "../../internal/pageBreakRunSourceDescendantIndex.js";
 import { createStyleEngine } from "../../style-engine/styleEngine.js";
@@ -453,7 +454,7 @@ function paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOver
 		if (formatting?.spaceBefore === void 0 && tableParagraphOverlay?.spaceBefore === void 0 && paragraphStyle?.pPr?.spaceBefore === void 0 && docDefaultSpacing?.spaceBefore !== void 0) spacingFromDocDefaults.before = true;
 		if (formatting?.spaceAfter === void 0 && tableParagraphOverlay?.spaceAfter === void 0 && paragraphStyle?.pPr?.spaceAfter === void 0 && docDefaultSpacing?.spaceAfter !== void 0) spacingFromDocDefaults.after = true;
 		if (spacingFromDocDefaults.before || spacingFromDocDefaults.after) attrs.spacingFromDocDefaults = spacingFromDocDefaults;
-		const effectiveIndent = mergeParagraphFormatting(formatting?.numPr?.numId === 0 && stylePpr?.numPr !== void 0 && stylePpr.numPr.numId !== 0 ? void 0 : stylePpr, formatting);
+		const effectiveIndent = mergeParagraphFormatting(formatting?.numPr?.numId === 0 && isNumberingReference(stylePpr?.numPr?.numId) ? void 0 : stylePpr, formatting);
 		set("indentLeft", effectiveIndent?.indentLeft);
 		set("indentRight", formatting?.indentRight ?? stylePpr?.indentRight);
 		set("indentFirstLine", effectiveIndent?.indentFirstLine);
@@ -473,7 +474,7 @@ function paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOver
 		set("outlineLevel", formatting?.outlineLevel ?? stylePpr?.outlineLevel);
 		set("direction", directionFromBidi(formatting?.bidi ?? stylePpr?.bidi));
 		set("defaultTextFormatting", resolveParagraphDefaultTextFormatting(styleId, formatting, styleResolver, { includeParagraphMarkRunProperties: tableOfContentsLevel === void 0 && (styleId === void 0 || paragraph.content.length === 0) }));
-		if (stylePpr?.numPr && formatting?.numPr?.numId === void 0 && stylePpr.numPr.numId !== 0) {
+		if (stylePpr?.numPr && formatting?.numPr?.numId === void 0 && isNumberingReference(stylePpr.numPr.numId)) {
 			attrs.numPr = {
 				...stylePpr.numPr,
 				...formatting?.numPr
@@ -1216,19 +1217,27 @@ const PAGE_BREAK_PARAGRAPH_OWNERS = {
 };
 function assertSourceContainerHasNoPageBreakRun(content, owner, sourceDescendants) {
 	if (!sourceDescendants.containsPageBreakRun(content)) return;
-	if (owner === "table-cell" && hasSingleLeadingTableCellPageBreak(content)) return;
+	if (owner === "table-cell" && hasSingleLeadingTableCellPageBreak(content, sourceDescendants)) return;
 	throw new UnsupportedDocxToProseMirrorConversionError({
 		message: `${PAGE_BREAK_CONTAINER_DESCRIPTIONS[owner]} cannot be represented in the editor model`,
 		owner,
 		contentType: "break"
 	});
 }
-/** A leading page-break run in a cell advances the whole row during pagination. This
-* narrow shape has a lossless PM representation and a row-wide layout
-* projection; interior breaks still require table-fragment ownership. */
-function hasSingleLeadingTableCellPageBreak(content) {
-	const paragraph = content.length === 1 && content[0]?.type === "paragraph" ? content[0] : void 0;
-	return paragraph !== void 0 && hasSingleLeadingParagraphPageBreak(paragraph);
+/**
+* A page break opening a cell advances the whole row during pagination.
+*
+* Word writes this shape routinely and the row's own `breakBefore` projects it
+* losslessly, so what follows the break inside the cell rides along: the row
+* moves as a unit. The break has to be the cell's only one and has to open its
+* first paragraph; an interior break still requires table-fragment ownership,
+* which cell-local flow cannot model. `convertTableCell` in the layout bridge
+* decides the same question over the projected runs.
+*/
+function hasSingleLeadingTableCellPageBreak(content, sourceDescendants) {
+	const first = content.at(0);
+	if (first?.type !== "paragraph" || !hasSingleLeadingParagraphPageBreak(first)) return false;
+	return !content.slice(1).some((block) => sourceDescendants.blockContainsPageBreakRun(block));
 }
 const scanLeadingPageBreakRun = (run, scan) => {
 	for (const content of run.content) {
@@ -1237,6 +1246,7 @@ const scanLeadingPageBreakRun = (run, scan) => {
 			scan.pageBreaks += 1;
 			continue;
 		}
+		if (content.type === "shape" && content.shape.textBody && scan.pageBreaks > 0) scan.textBoxShapeAfterBreak = true;
 		if (scan.pageBreaks === 0) scan.contentBeforeBreak = true;
 	}
 };
@@ -1276,12 +1286,17 @@ const scanLeadingPageBreakContent = (content, scan) => {
 		default: return content;
 	}
 };
-const hasSingleLeadingParagraphPageBreak = (paragraph) => {
+const scanParagraphPageBreaks = (paragraph) => {
 	const scan = {
 		contentBeforeBreak: false,
-		pageBreaks: 0
+		pageBreaks: 0,
+		textBoxShapeAfterBreak: false
 	};
 	for (const content of paragraph.content) scanLeadingPageBreakContent(content, scan);
+	return scan;
+};
+const hasSingleLeadingParagraphPageBreak = (paragraph) => {
+	const scan = scanParagraphPageBreaks(paragraph);
 	return !scan.contentBeforeBreak && scan.pageBreaks === 1;
 };
 function assertParagraphPageBreakCanBeProjected({ paragraph, attrs, effectiveFrame, sourceDescendants }) {
@@ -1290,7 +1305,7 @@ function assertParagraphPageBreakCanBeProjected({ paragraph, attrs, effectiveFra
 	const disposition = pageBreakRunParagraphProjectionDispositionForFeatures({
 		attrs,
 		effectiveFrame,
-		hasTextBoxAnchor: sourceFeatures.hasTextBoxShape && !sourceFeatures.pageBreakSharesTextBoxShape
+		textBoxAnchorAfterPageBreak: sourceFeatures.hasTextBoxShape && !sourceFeatures.pageBreakSharesTextBoxShape && scanParagraphPageBreaks(paragraph).textBoxShapeAfterBreak
 	});
 	if (disposition.status === "supported") return;
 	if (disposition.reason !== "textBoxAnchor" && hasSingleLeadingParagraphPageBreak(paragraph)) return;

package/dist/prosemirror/extensions/features/ListExtension.js

@@ -1,3 +1,4 @@
+import { isNumberingReference } from "../../../docx/numberingReference.js";
 import { expectParagraphAttrs } from "../../attrs/index.js";
 import { PPR_CHANGE_SCOPED_ATTR_KEYS, hasSerializableParagraphPropertyChange } from "../../commands/propertyChangeScope.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../../listMarker.js";
@@ -9,6 +10,7 @@ import { createExtension } from "../create.js";
 import { goToNextCell, goToPrevCell } from "../nodes/TableExtension.js";
 import { Priority } from "../types.js";
 import { panic } from "better-result";
+import { InputRule, inputRules, undoInputRule } from "prosemirror-inputrules";
 //#region src/prosemirror/extensions/features/ListExtension.ts
 /**
 * List Extension — list commands + keymaps
@@ -48,9 +50,9 @@ function getPreviousListFormatting(attrs) {
 }
 function clearListAttrs(attrs) {
 	const styleNumPr = attrs.numPrFromStyle;
-	const numPr = styleNumPr?.numId !== void 0 && styleNumPr.numId !== 0 ? {
+	const numPr = isNumberingReference(styleNumPr?.numId) ? {
 		numId: 0,
-		ilvl: attrs.numPr?.ilvl ?? styleNumPr.ilvl ?? 0
+		ilvl: attrs.numPr?.ilvl ?? styleNumPr?.ilvl ?? 0
 	} : null;
 	return {
 		...attrs,
@@ -59,7 +61,7 @@ function clearListAttrs(attrs) {
 	};
 }
 function hasActiveListNumbering(attrs) {
-	return attrs.numPr?.numId !== void 0 && attrs.numPr.numId !== 0;
+	return isNumberingReference(attrs.numPr?.numId);
 }
 function toggleList(numId) {
 	return (state, dispatch) => {
@@ -293,11 +295,47 @@ function insertTab() {
 		return true;
 	};
 }
+/**
+* Word's as-you-type markers. Each ends in the space that triggers the rule.
+* `1.` starts a numbered list at one, like the toolbar button; another typed
+* number stays text rather than being silently renumbered.
+*/
+const BULLET_AUTOFORMAT = /^[-*] $/u;
+const NUMBERED_AUTOFORMAT = /^1\. $/u;
+const captureTransaction = (command, state) => {
+	const captured = { transaction: null };
+	command(state, (transaction) => {
+		captured.transaction = transaction;
+	});
+	return captured.transaction;
+};
+/**
+* Replace a typed marker with the list the toolbar button produces. Running the
+* command itself (rather than writing `numPr` here) keeps an autoformatted list
+* identical to a clicked one, down to what the document saves.
+*/
+const listAutoformat = (marker, toggleCommand) => new InputRule(marker, (state, _match, start, end) => {
+	const { $from } = state.selection;
+	if ($from.parent.type.name !== "paragraph") return null;
+	if (start !== $from.start()) return null;
+	if (expectParagraphAttrs($from.parent).numPr?.numId) return null;
+	if (makeRevisionInfo(state)) return null;
+	const toggled = captureTransaction(toggleCommand, state);
+	if (!toggled) return null;
+	const tr = state.tr.delete(start, end);
+	for (const step of toggled.steps) {
+		const mapped = step.map(tr.mapping);
+		if (mapped) tr.step(mapped);
+	}
+	return tr;
+});
+const listAutoformatRules = () => inputRules({ rules: [listAutoformat(BULLET_AUTOFORMAT, toggleBulletList), listAutoformat(NUMBERED_AUTOFORMAT, toggleNumberedList)] });
 const ListExtension = createExtension({
 	name: "list",
 	priority: Priority.High,
 	onSchemaReady() {
 		return {
+			plugins: [listAutoformatRules()],
 			commands: {
 				toggleBulletList: () => toggleBulletList,
 				toggleNumberedList: () => toggleNumberedList,
@@ -310,7 +348,7 @@ const ListExtension = createExtension({
 				"Shift-Tab": chainCommands(goToPrevCell(), decreaseListIndent()),
 				"Shift-Enter": () => false,
 				Enter: chainCommands(exitListOnEmptyEnter(), splitListItem()),
-				Backspace: backspaceExitList()
+				Backspace: chainCommands(undoInputRule, backspaceExitList())
 			}
 		};
 	}

package/dist/prosemirror/listMarker.js

@@ -1,4 +1,5 @@
 import { convertBulletToUnicode } from "../docx/bulletMarkers.js";
+import { isNumberingReference } from "../docx/numberingReference.js";
 import { formatOoxmlCounter } from "../docx/ooxmlCounterFormatter.js";
 import { LIST_RENDERING_ATTR_KEYS } from "./listRenderingAttrs.js";
 //#region src/prosemirror/listMarker.ts
@@ -179,7 +180,7 @@ function advanceListMarker(attrs, state) {
 	const level = attrs.numPr?.ilvl ?? 0;
 	if (!Number.isInteger(level) || level < 0 || level > 8) return null;
 	const numId = attrs.numPr?.numId;
-	if (numId === void 0 || numId === 0) {
+	if (!isNumberingReference(numId)) {
 		let marker = null;
 		if (markerTemplate?.includes("%") && !attrs.listIsBullet) {
 			const counters = getLastListCounters(state);

package/dist/prosemirror/numberedRefFields.js

@@ -1,3 +1,4 @@
+import { isNumberingReference } from "../docx/numberingReference.js";
 import { expectFieldAttrs, expectParagraphAttrs } from "./attrs/index.js";
 import { expectBookmarkBoundaryAttrs } from "./bookmarkBoundaryAttrs.js";
 import { advanceVisibleListMarker, createListCounterState, resolveListTemplateWithComponents } from "./listMarker.js";
@@ -79,7 +80,7 @@ function numberTargetForParagraph(node, contextStreams, streams) {
 }
 function numberTargetForAdvancedMarker(attrs, resolvedMarker, state, contexts) {
 	const numId = attrs.numPr?.numId;
-	if (numId === void 0 || numId === 0 || attrs.listIsBullet || attrs.listMarkerHidden || attrs.listNumFmt === "none" || !resolvedMarker) return null;
+	if (!isNumberingReference(numId) || attrs.listIsBullet || attrs.listMarkerHidden || attrs.listNumFmt === "none" || !resolvedMarker) return null;
 	const marker = attrs.listMarkerAllCaps ? resolvedMarker.toLocaleUpperCase() : resolvedMarker;
 	const level = attrs.numPr?.ilvl ?? 0;
 	if (!Number.isInteger(level) || level < 0 || level > 8) return null;

package/dist/prosemirror/pageBreakRunProjection.d.ts

@@ -6,7 +6,7 @@ declare const PAGE_BREAK_RUN_PARAGRAPH_PROJECTION_MESSAGES: {
   readonly borders: "A bordered paragraph containing an explicit page-break run cannot be projected";
   readonly frame: "A framed paragraph containing an explicit page-break run cannot be projected";
   readonly outline: "An outline paragraph containing an explicit page-break run cannot be projected";
-  readonly textBoxAnchor: "A paragraph containing both an explicit page-break run and a text-box anchor cannot be projected";
+  readonly textBoxAnchor: "A paragraph whose text-box anchor follows an explicit page-break run cannot be projected";
 };
 type PageBreakRunParagraphProjectionReason = keyof typeof PAGE_BREAK_RUN_PARAGRAPH_PROJECTION_MESSAGES;
 type PageBreakRunParagraphProjectionDisposition = {
@@ -19,10 +19,18 @@ type PageBreakRunParagraphProjectionDisposition = {
 type PageBreakRunParagraphFeatures = {
   attrs: ParagraphAttrs;
   effectiveFrame: document_d_exports.ParagraphFormatting["frame"];
-  hasTextBoxAnchor: boolean;
+  /**
+   * A text-box anchor that the paragraph's first page break precedes.
+   *
+   * Layout splits such a paragraph into fragments at its breaks, and only the
+   * first fragment keeps the paragraph's block id, which is what an anchor
+   * resolves its host through. An anchor before the first break is therefore
+   * projected faithfully; one after it would lose its host.
+   */
+  textBoxAnchorAfterPageBreak: boolean;
 };
 /** Keep source-import and ProseMirror-layout ownership decisions on one predicate. */
-declare const pageBreakRunParagraphProjectionDispositionForFeatures: ({ attrs, effectiveFrame, hasTextBoxAnchor }: PageBreakRunParagraphFeatures) => PageBreakRunParagraphProjectionDisposition;
+declare const pageBreakRunParagraphProjectionDispositionForFeatures: ({ attrs, effectiveFrame, textBoxAnchorAfterPageBreak }: PageBreakRunParagraphFeatures) => PageBreakRunParagraphProjectionDisposition;
 declare const pageBreakRunParagraphProjectionDisposition: (paragraph: Node) => PageBreakRunParagraphProjectionDisposition;
 //#endregion
 export { PageBreakRunParagraphProjectionDisposition, PageBreakRunParagraphProjectionReason, pageBreakRunParagraphProjectionDisposition, pageBreakRunParagraphProjectionDispositionForFeatures };