@stll/folio-core 0.41.0 → 0.43.0

package/dist/docx/rezip.js

@@ -1,15 +1,17 @@
 import { consumeTrackedSectionEndpointRemoval } from "../internal/sectionEndpointResolution.js";
 import { consumeSectionReferenceResolution } from "../internal/sectionReferenceResolution.js";
 import { isAllowedExternalWatermarkImageUrl } from "../watermark/index.js";
-import { normalizeAppVersionInExtendedProperties } from "./appVersionNormalization.js";
+import { appVersionInSchemaForm, normalizeAppVersionInExtendedProperties } from "./appVersionNormalization.js";
 import { withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
 import { applyReplyThreadMarkers } from "./commentReplyMarkers.js";
 import { normalizeDrawingIds } from "./drawingIdNormalization.js";
 import { rebindDrawingImageRelationship } from "./drawingRelationships.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
+import { parseHeaderFooterType } from "./headerFooterRefParser.js";
 import { assertValidFolioDocumentModel } from "./modelValidation.js";
 import { isNewDataUrlDrawing } from "./newImage.js";
 import { parseNumbering } from "./numberingParser.js";
+import { isNumberingReference } from "./numberingReference.js";
 import { isUnsafePackagePath, reconcilePackageReferences, removeUnsafeEntries } from "./packageParts.js";
 import { normalizeParaIdRangeInXmlParts } from "./paraIdRangeNormalization.js";
 import { RELATIONSHIP_TYPES, parseRelationships, resolveRelativePath } from "./relsParser.js";
@@ -113,7 +115,7 @@ const extractHeaderFooterReferences = (xml) => {
 			const rId = getAttributeByNamespaceUri(node, OFFICE_RELATIONSHIP_NAMESPACE_URIS, "id");
 			if (rId) references.push({
 				element,
-				type: getAttributeByNamespaceUri(node, WORDPROCESSINGML_NAMESPACE_URIS, "type") ?? "default",
+				type: parseHeaderFooterType(getAttributeByNamespaceUri(node, WORDPROCESSINGML_NAMESPACE_URIS, "type")),
 				rId
 			});
 		}
@@ -1524,14 +1526,24 @@ function isDocxBuffer(buffer) {
 	return view[0] === 80 && view[1] === 75;
 }
 /**
+* The application version a newly created package states.
+*
+* `AppVersion` describes the application, so it is written only alongside one,
+* and it says nothing about the host beyond the `XX.YYYY` form the schema
+* fixes. Deriving it from the mapping every save exit already uses keeps the
+* two from drifting apart.
+*/
+const CREATED_APP_VERSION = appVersionInSchemaForm("1");
+/**
 * Create a new empty DOCX file
 *
+* @param properties - Document properties the package states about itself
 * @returns Promise resolving to minimal DOCX as ArrayBuffer
 */
-function createEmptyDocx() {
-	return generateDocxZip(createEmptyDocxZip(), 6);
+function createEmptyDocx(properties = {}) {
+	return generateDocxZip(createEmptyDocxZip(properties), 6);
 }
-const createEmptyDocxZip = () => {
+const createEmptyDocxZip = ({ creator, application }) => {
 	const zip = new JSZip();
 	zip.file("[Content_Types].xml", `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
@@ -1586,16 +1598,15 @@ const createEmptyDocxZip = () => {
   </w:style>
 </w:styles>`);
 	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const creatorElement = creator === void 0 ? "" : `\n  <dc:creator>${escapeXml(creator)}</dc:creator>`;
 	zip.file("docProps/core.xml", `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <dc:creator>EigenPal DOCX Editor</dc:creator>
+<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">${creatorElement}
   <dcterms:created xsi:type="dcterms:W3CDTF">${now}</dcterms:created>
   <dcterms:modified xsi:type="dcterms:W3CDTF">${now}</dcterms:modified>
 </cp:coreProperties>`);
+	const applicationElements = application === void 0 ? "" : `\n  <Application>${escapeXml(application)}</Application>\n  <AppVersion>${CREATED_APP_VERSION}</AppVersion>`;
 	zip.file("docProps/app.xml", `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties">
-  <Application>EigenPal DOCX Editor</Application>
-  <AppVersion>1.0000</AppVersion>
+<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties">${applicationElements}
 </Properties>`);
 	return zip;
 };
@@ -1603,9 +1614,11 @@ const createEmptyDocxZip = () => {
 * Create a new DOCX from a Document (without requiring original buffer)
 *
 * @param doc - Document to serialize
+* @param properties - Document properties a package built from scratch states
+*   about itself; ignored when `doc` carries a source package
 * @returns Promise resolving to DOCX as ArrayBuffer
 */
-async function createDocx(doc) {
+async function createDocx(doc, properties = {}) {
 	if (doc.originalBuffer) {
 		const source = await loadParsedZipSource(doc, doc.originalBuffer);
 		return finishRepack({
@@ -1618,7 +1631,7 @@ async function createDocx(doc) {
 			updateModifiedDate: true
 		});
 	}
-	const zip = await createDocumentSeedZip(doc);
+	const zip = await createDocumentSeedZip(doc, properties);
 	return finishRepack({
 		document: withoutOrphanCommentRanges(doc),
 		originalZip: zip,
@@ -1629,8 +1642,8 @@ async function createDocx(doc) {
 		updateModifiedDate: true
 	});
 }
-const createDocumentSeedZip = async (doc) => {
-	const zip = createEmptyDocxZip();
+const createDocumentSeedZip = async (doc, properties) => {
+	const zip = createEmptyDocxZip(properties);
 	const relationships = ["<Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles\" Target=\"styles.xml\"/>"];
 	const overrides = [];
 	let nextRelationshipId = 2;
@@ -1673,17 +1686,32 @@ const createDocumentSeedZip = async (doc) => {
 };
 const relationshipXml = (id, type, target) => `<Relationship Id="rId${id}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/${type}" Target="${target}"/>`;
 const overrideXml = (partName, contentType) => `<Override PartName="${partName}" ContentType="${contentType}"/>`;
+/**
+* A package this build assembles from a Document must define the numbering its
+* styles name: Word reads a styles.xml reference nothing resolves as no
+* numbering at all, silently dropping the style's list.
+*
+* The panic is an invariant over Folio's own output, not input validation. A
+* source file can carry a dangling style reference, and it never arrives here:
+* `normalizeStyleNumberingReferences` rewrites one to the "no numbering"
+* sentinel at every boundary that mints a Document from user styles (`parseDocx`
+* and the style-set extraction entry points). What reaches this point is what
+* Folio itself put in the model, so a miss is a defect in Folio.
+*/
 const assertStyleNumberingReferences = (doc) => {
 	const referenced = /* @__PURE__ */ new Set();
 	for (const style of doc.package.styles?.styles ?? []) {
 		const numId = style.pPr?.numPr?.numId;
-		if (numId !== void 0) referenced.add(numId);
+		if (isNumberingReference(numId)) referenced.add(numId);
 	}
 	if (referenced.size === 0) return;
-	const available = new Set(doc.package.numbering?.nums.map((numbering) => numbering.numId) ?? []);
-	for (const numId of referenced) if (!available.has(numId)) panic(`Style references missing numbering definition ${numId}`);
+	const available = new Map(doc.package.numbering?.nums.map((numbering) => [numbering.numId, numbering]) ?? []);
 	const availableAbstract = new Set(doc.package.numbering?.abstractNums.map((numbering) => numbering.abstractNumId) ?? []);
-	for (const numbering of doc.package.numbering?.nums ?? []) if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
+	for (const numId of referenced) {
+		const numbering = available.get(numId);
+		if (!numbering) panic(`Style references missing numbering definition ${numId}`);
+		if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
+	}
 };
 //#endregion
 export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };

package/dist/docx/server/createBilingualDocument.js

@@ -1,4 +1,5 @@
 import { deterministicHexId } from "../../utils/hexId.js";
+import { isNumberingReference } from "../numberingReference.js";
 import { getParagraphText } from "../paragraphParser.js";
 import { cloneParagraphWithoutPropertySource } from "../paragraphPropertySource.js";
 import { getRunText } from "../runParser.js";
@@ -257,7 +258,7 @@ const resolveInheritedOutlineLevel = (style, styleById) => {
 /** The numbering a paragraph renders with: direct `numPr`, else the style chain's. */
 const effectiveNumPr = (paragraph, styleById) => {
 	const direct = paragraph.formatting?.numPr;
-	if (direct?.numId !== void 0) return direct.numId === 0 ? void 0 : direct;
+	if (direct?.numId !== void 0) return isNumberingReference(direct.numId) ? direct : void 0;
 	const styleId = paragraph.formatting?.styleId;
 	return styleId ? styleNumPr(styleById.get(styleId), styleById) : void 0;
 };
@@ -267,7 +268,7 @@ const styleNumPr = (style, styleById) => {
 	while (current && !seen.has(current.styleId)) {
 		seen.add(current.styleId);
 		const numPr = current.pPr?.numPr;
-		if (numPr?.numId !== void 0) return numPr.numId === 0 ? void 0 : numPr;
+		if (numPr?.numId !== void 0) return isNumberingReference(numPr.numId) ? numPr : void 0;
 		current = current.basedOn ? styleById.get(current.basedOn) : void 0;
 	}
 };
@@ -396,11 +397,11 @@ const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner, b
 	const nextFormatting = formatting && {
 		...formatting,
 		...formatting.styleId !== void 0 && { styleId: styleCloner.styleIdFor(formatting.styleId) },
-		...formatting.numPr?.numId !== void 0 && formatting.numPr.numId !== 0 && { numPr: {
+		...formatting.numPr !== void 0 && isNumberingReference(formatting.numPr.numId) && { numPr: {
 			...formatting.numPr,
 			numId: cloner.cloneNumId(formatting.numPr.numId)
 		} },
-		...formatting.numPrFromStyle?.numId !== void 0 && formatting.numPrFromStyle.numId !== 0 && { numPrFromStyle: {
+		...formatting.numPrFromStyle !== void 0 && isNumberingReference(formatting.numPrFromStyle.numId) && { numPrFromStyle: {
 			...formatting.numPrFromStyle,
 			numId: cloner.cloneNumId(formatting.numPrFromStyle.numId)
 		} }

package/dist/docx/styleParser.js

@@ -2,6 +2,7 @@ import { isValidHexColor } from "../utils/colorResolver.js";
 import { parseHorizontalScalePercent } from "../utils/horizontalScale.js";
 import { mergeParagraphFormatting } from "../utils/paragraphFormattingMerge.js";
 import { mergeStyleTextFormatting } from "../utils/textFormattingMerge.js";
+import { resolveDefaultParagraphStyle } from "./defaultParagraphStyle.js";
 import { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FontHintSchema, FontThemeSchema, HighlightColorSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
 import { resolveThemeFontRef } from "./themeParser.js";
 import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
@@ -916,8 +917,7 @@ function getResolvedStyle(styleId, styleMap) {
 * Get the default paragraph style
 */
 function getDefaultParagraphStyle(styleMap) {
-	for (const style of styleMap.values()) if (style.type === "paragraph" && style.default) return style;
-	return styleMap.get("Normal");
+	return resolveDefaultParagraphStyle(styleMap.values());
 }
 /**
 * Get the default character style

package/dist/index.d.ts

@@ -20,7 +20,7 @@ import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createD
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
-import { createDocx } from "./docx/rezip.js";
+import { DocumentPropertiesOptions, createDocx } from "./docx/rezip.js";
 import { DRAWING_SAFETY_CLASSES, DrawingSafetyClass } from "./docx/imageRawXml.js";
 import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, DocxDrawingClassification, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "./docx/compatibility.js";
 import { BlockRect } from "./paged-layout/blockGeometry.js";
@@ -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 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,