@stll/folio-core 0.42.0 → 0.44.0

package/dist/docx/xmlParser.js

@@ -1,7 +1,8 @@
-import { transitionalSlotEncoding } from "./transitionalSpelling.js";
+import { NUMBERS_PER_PERCENT, percentageSpelling, transitionalSlotEncoding } from "./transitionalSpelling.js";
 import { universalMeasureAs } from "./universalMeasure.js";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 import { OOXML_NS } from "@stll/docx-utils";
+import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/xmlParser.ts
 /**
 * XML Parser Utilities for OOXML
@@ -481,17 +482,19 @@ function getTextContent(element) {
 	return text;
 }
 /**
-* Check if an element has a specific attribute with value "true" or "1"
+* Read an `ST_OnOff` attribute.
 *
-* @param element - Element to check
-* @param namespace - Attribute namespace
-* @param name - Attribute name
-* @returns true if attribute exists and is truthy
+* The type has three spellings per polarity — `1`/`true`/`on` and
+* `0`/`false`/`off` — and producers use all of them. `undefined` means the
+* author said nothing (absent, or a value outside the type), so the caller
+* still owns what absence means for its own slot.
+*
+* Every on/off attribute goes through here: a hand-rolled `=== "1"` reads
+* `w:beforeAutospacing="on"` as false, and the save path then writes `"0"`,
+* inverting what the document said.
 */
-function hasFlag(element, namespace, name) {
-	const value = getAttribute(element, namespace, name);
-	if (value === null) return false;
-	return parseOnOffValue(value) ?? true;
+function parseOnOffAttribute(element, namespace, name, context) {
+	return parseOnOffValue(getAttribute(element, namespace, name), context, element?.name ?? name);
 }
 /**
 * Check if a child element exists (used for boolean flags in OOXML)
@@ -554,17 +557,19 @@ function parseNumberingLevelAttribute(element) {
 	return level !== void 0 && level >= 0 ? level : void 0;
 }
 /**
-* Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
-* sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
-* (`5000`); normalize those to the ECMA-376 unit the layout engine expects.
+* Parse `w:w` on a table width/height element. A percentage may be spelled the
+* way it reads (`100%`) or as the number its slot counts in
+* (50ths-of-percent, `5000`); the generated slot table says which unit that
+* is, so the two spellings are not decided here.
 */
 function parseTableMeasurementValue(element, widthType) {
 	const raw = getAttribute(element, "w", "w");
 	if (raw === null) return;
 	const trimmed = raw.trim();
-	if (widthType === "pct" && trimmed.endsWith("%")) {
-		const pct = Number.parseFloat(trimmed.slice(0, -1));
-		if (!Number.isNaN(pct)) return Math.round(pct * 50);
+	if (widthType === "pct") {
+		const percent = percentageSpelling(trimmed);
+		const unit = element === null || element === void 0 ? void 0 : transitionalSlotEncoding(element.namespaceUri, getLocalName(element.name), "w")?.percent;
+		if (percent !== void 0 && unit !== void 0) return Math.round(percent * NUMBERS_PER_PERCENT[unit]);
 	}
 	const measure = universalMeasureAs(trimmed, "twips");
 	if (measure !== void 0) return measure;
@@ -573,8 +578,12 @@ function parseTableMeasurementValue(element, widthType) {
 }
 /**
 * Parse an OOXML `ST_OnOff` lexical value.
+*
+* `context` is optional and trailing on purpose: every call site that has one
+* reports the value folio declined to read, and the hundred that do not yet
+* thread one keep compiling and keep their behaviour.
 */
-function parseOnOffValue(value) {
+function parseOnOffValue(value, context, element) {
 	if (value === null || value === void 0) return;
 	switch (value) {
 		case "1":
@@ -583,7 +592,13 @@ function parseOnOffValue(value) {
 		case "0":
 		case "false":
 		case "off": return false;
-		default: return;
+		default:
+			context?.warn({
+				code: PARSE_WARNING_CODES.unrecognisedOnOffValue,
+				value,
+				...element === void 0 ? {} : { element }
+			});
+			return;
 	}
 }
 /**
@@ -598,7 +613,7 @@ function parseOnOffValue(value) {
 * @param namespace - Namespace for val attribute
 * @returns boolean value
 */
-function parseBooleanElement(element, namespace = "w") {
+function parseBooleanElement(element, namespace = "w", context) {
 	if (!element) return false;
 	let val = null;
 	const elementName = element.name ?? "";
@@ -613,7 +628,7 @@ function parseBooleanElement(element, namespace = "w") {
 		}
 	}
 	if (val === null) return true;
-	return parseOnOffValue(val) ?? true;
+	return parseOnOffValue(val, context, elementName) ?? false;
 }
 /**
 * Deep find - search recursively for an element
@@ -810,4 +825,4 @@ function cloneElement(element, overrides) {
 	return clone;
 }
 //#endregion
-export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, selectAlternateContentBranch };

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

@@ -59,7 +59,8 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 				case "deletion":
 				case "moveFrom":
 				case "moveTo":
-				case "inlineSdt": return inspectMany(content.content, inspectParagraphContent);
+				case "inlineSdt":
+				case "bidiWrapper": return inspectMany(content.content, inspectParagraphContent);
 				case "simpleField": {
 					const fieldResultFlags = inspectMany(content.content, inspectParagraphContent);
 					if (hasFlag(fieldResultFlags, SOURCE_FLAGS.paragraphPageBreak) && hasFlag(fieldResultFlags, SOURCE_FLAGS.paragraphTextBoxShape)) return fieldResultFlags | SOURCE_FLAGS.pageBreakSharesTextBoxShape;
@@ -105,12 +106,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/internal/paragraphFormattingSerialization.d.ts

@@ -1,9 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/internal/paragraphFormattingSerialization.d.ts
-type ExhaustiveFields<Source, Classified extends keyof Source> = Exclude<keyof Source, Classified> extends never ? Source : never;
 type ParagraphNumberingReference = document_d_exports.ParagraphFormatting["numPr"] | null;
-type ClassifiedParagraphFormattingField = "alignment" | "bidi" | "kinsoku" | "overflowPunctuation" | "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "snapToGrid" | "beforeAutospacing" | "afterAutospacing" | "spacingExplicit" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent" | "borders" | "shading" | "tabs" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "contextualSpacing" | "numPr" | "numPrFromStyle" | "outlineLevel" | "styleId" | "frame" | "suppressLineNumbers" | "suppressAutoHyphens" | "runProperties" | "runInWithNext";
-type ExhaustiveParagraphFormatting = ExhaustiveFields<document_d_exports.ParagraphFormatting, ClassifiedParagraphFormattingField>;
+type ClassifiedParagraphFormattingField = "alignment" | "bidi" | "kinsoku" | "overflowPunctuation" | "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "snapToGrid" | "beforeAutospacing" | "afterAutospacing" | "spacingExplicit" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent" | "borders" | "shading" | "tabs" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "contextualSpacing" | "numPr" | "numPrFromStyle" | "numberingChangeXml" | "outlineLevel" | "styleId" | "frame" | "suppressLineNumbers" | "suppressAutoHyphens" | "runProperties" | "runInWithNext";
+type ExhaustiveParagraphFormatting = document_d_exports.ExhaustiveFields<document_d_exports.ParagraphFormatting, ClassifiedParagraphFormattingField>;
 /** Compare numbering references by their emitted id and effective level. */
 declare const paragraphNumberingReferencesEqual: (left: ParagraphNumberingReference, right: ParagraphNumberingReference) => boolean;
 /** Compare the authored `w:numPr` attributes, including an absent `w:ilvl`. */

package/dist/internal/paragraphFormattingSerialization.js

@@ -1,6 +1,8 @@
 import { serializeBorder } from "../docx/serializer/borderSerializer.js";
 import { serializeShading, serializeTextFormatting } from "../docx/serializer/textFormattingSerializer.js";
 import { escapeXml, intAttr } from "../docx/serializer/xmlUtils.js";
+import { sanitizeCapturedXmlElement } from "../docx/verbatimCapture.js";
+import { NAMESPACES, OOXML_NAMESPACE_SCOPE } from "../docx/xmlParser.js";
 //#region src/internal/paragraphFormattingSerialization.ts
 const modelParagraphNumberingReference = (reference) => {
 	if (!reference) return null;
@@ -74,14 +76,32 @@ const serializeIndentation = (formatting) => {
 	}
 	return attrs.length === 0 ? "" : `<w:ind ${attrs.join(" ")}/>`;
 };
-const serializeNumbering = (numPr) => {
+/**
+* `w:numPr`, with the tracked record of the numbering it replaced.
+*
+* `w:numberingChange` is the revision a reviewer's numbering change left
+* behind. It is history: nothing in the model derives it, and a rebuilt
+* `w:numPr` that drops it discards the revision silently. It is written even
+* when the paragraph's own numbering reference is gone, because a change
+* record with nothing left to describe is still a record — the schema declares
+* it last in `CT_NumPr`, after `w:ilvl` and `w:numId`.
+*/
+const serializeNumbering = (numPr, numberingChangeXml) => {
 	const modeled = modelParagraphNumberingReference(numPr ?? null);
-	if (!modeled) return "";
 	const parts = [];
-	if (modeled.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(modeled.ilvl)}"/>`);
-	if (modeled.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(modeled.numId)}"/>`);
+	if (modeled?.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(modeled.ilvl)}"/>`);
+	if (modeled?.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(modeled.numId)}"/>`);
+	const change = replayableNumberingChangeXml(numberingChangeXml);
+	if (change !== null) parts.push(change);
 	return parts.length === 0 ? "" : `<w:numPr>${parts.join("")}</w:numPr>`;
 };
+const NUMBERING_CHANGE_ROOT_NAME = /* @__PURE__ */ new Set(["numberingChange"]);
+const WORDPROCESSINGML_NAMESPACE = /* @__PURE__ */ new Set([NAMESPACES.w]);
+const replayableNumberingChangeXml = (numberingChangeXml) => sanitizeCapturedXmlElement(numberingChangeXml, {
+	allowedLocalNames: NUMBERING_CHANGE_ROOT_NAME,
+	allowedNamespaceUris: WORDPROCESSINGML_NAMESPACE,
+	inheritedNamespaceScope: OOXML_NAMESPACE_SCOPE
+});
 const serializeFrameProperties = (frame) => {
 	if (!frame) return "";
 	const { dropCap, lines, width, height, hSpace, vSpace, hAnchor, vAnchor, x, y, xAlign, yAlign, wrap } = frame;
@@ -117,7 +137,7 @@ const extractRunPropertiesInnerXml = (runPropertiesXml) => {
 */
 const modelParagraphFormattingEmission = (input) => {
 	if (!input) return {};
-	const { alignment, bidi, kinsoku, overflowPunctuation, spaceBefore, spaceAfter, lineSpacing, lineSpacingRule, snapToGrid, beforeAutospacing, afterAutospacing, spacingExplicit, indentLeft, indentRight, indentFirstLine, hangingIndent, borders, shading, tabs, keepNext, keepLines, widowControl, pageBreakBefore, contextualSpacing, numPr, numPrFromStyle, outlineLevel, styleId, frame, suppressLineNumbers, suppressAutoHyphens, runProperties, runInWithNext } = input;
+	const { alignment, bidi, kinsoku, overflowPunctuation, spaceBefore, spaceAfter, lineSpacing, lineSpacingRule, snapToGrid, beforeAutospacing, afterAutospacing, spacingExplicit, indentLeft, indentRight, indentFirstLine, hangingIndent, borders, shading, tabs, keepNext, keepLines, widowControl, pageBreakBefore, contextualSpacing, numPr, numPrFromStyle, numberingChangeXml, outlineLevel, styleId, frame, suppressLineNumbers, suppressAutoHyphens, runProperties, runInWithNext } = input;
 	modelSpacingProvenance(spacingExplicit);
 	const propertiesXml = [
 		styleId ? `<w:pStyle w:val="${escapeXml(styleId)}"/>` : "",
@@ -126,7 +146,7 @@ const modelParagraphFormattingEmission = (input) => {
 		serializeToggle("pageBreakBefore", pageBreakBefore),
 		serializeFrameProperties(frame),
 		serializeToggle("widowControl", widowControl),
-		isStyleSourcedParagraphNumbering(numPr, numPrFromStyle) ? "" : serializeNumbering(numPr),
+		isStyleSourcedParagraphNumbering(numPr, numPrFromStyle) ? serializeNumbering(void 0, numberingChangeXml) : serializeNumbering(numPr, numberingChangeXml),
 		serializeToggle("suppressLineNumbers", suppressLineNumbers),
 		serializeParagraphBorders(borders),
 		serializeShading(shading),

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

@@ -1,6 +1,6 @@
 import { measureParagraph } from "../../layout-engine/measure/measureParagraph.js";
 import { layoutTextBoxContent } from "../../layout-engine/measure/textBoxParagraphLayout.js";
-import { DEFAULT_TEXTBOX_MARGINS, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, isFloatingImageRun } from "../../layout-engine/types.js";
+import { DEFAULT_TEXTBOX_MARGINS, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, isFloatingImageRun, resolveTableWidthPx } from "../../layout-engine/types.js";
 import { footnoteToProseDoc } from "../../prosemirror/conversion/toProseDoc.js";
 import { toFlowBlocks } from "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/footnoteLayout.ts
@@ -264,14 +264,9 @@ function measureFootnoteBlock(block, contentWidth) {
 		default: return block;
 	}
 }
-function resolveFootnoteTableWidth(width, widthType, contentWidth) {
-	if (!width) return;
-	if (widthType === "pct") return contentWidth * width / 5e3;
-	if (widthType === "dxa" || !widthType || widthType === "auto") return width / 1440 * 96;
-}
 function measureFootnoteTable(tableBlock, contentWidth) {
 	let columnWidths = tableBlock.columnWidths ?? [];
-	const explicitWidth = resolveFootnoteTableWidth(tableBlock.width, tableBlock.widthType, contentWidth);
+	const explicitWidth = resolveTableWidthPx(tableBlock.width, tableBlock.widthType, contentWidth);
 	if (columnWidths.length === 0) {
 		const firstRow = tableBlock.rows.at(0);
 		let colCount = 0;

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/layout-engine/index.d.ts

@@ -1,4 +1,4 @@
-import { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned } from "./types.js";
+import { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned } from "./types.js";
 import { PageState, Paginator, PaginatorOptions, createPaginator } from "./paginator.js";
 import { KeepNextChain, calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore } from "./keep-together.js";
 import { resolveSectionHeaderFooterRefs } from "./headerFooterRefs.js";
@@ -42,4 +42,4 @@ declare function layoutDocument(blocks: FlowBlock[], measures: Measure[], option
  */
 declare function getHeaderRowsHeight(measure: TableMeasure, headerRowCount: number): number;
 //#endregion
-export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };
+export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, tableColumnsArePinned };

package/dist/layout-engine/index.js

@@ -14,7 +14,7 @@ import { applyPendingToActive, createInitialSectionState, getEffectiveColumns, g
 import { applySectionVerticalAlignment } from "./sectionVerticalAlignment.js";
 import { buildTableRowBreakInfo, getRowContinuationSkip, snapRowBreak } from "./tableRowBreak.js";
 import { bandFragmentX, bandTopContentY, isPageFrameRelativeAnchor } from "./textBoxFlow.js";
-import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned } from "./types.js";
+import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned } from "./types.js";
 import { panic } from "better-result";
 //#region src/layout-engine/index.ts
 /**
@@ -1036,4 +1036,4 @@ function handleSectionBreak(_block, paginator, nextSectionConfig, nextSectionTyp
 	paginator.updateColumns(nextSectionConfig.columns ?? DEFAULT_COLUMNS);
 }
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, tableColumnsArePinned };