@stll/folio-core 0.44.0 → 0.46.0

package/dist/docx/xmlResourceLimits.d.ts

@@ -1,27 +1,107 @@
 //#region src/docx/xmlResourceLimits.d.ts
-/** Shared bounds for XML parts parsed by Folio. */
+/**
+ * Shared bounds for XML parts parsed by Folio.
+ *
+ * `maxBytes` and the package expansion ceiling bound the *markup*; they do not
+ * bound what parsing that markup allocates. A parsed element retains far more
+ * than the bytes it was written as, so a part that satisfies a byte bound can
+ * still cost multiples of it in tree. Measured on this repository's corpus
+ * generators (Bun 1.4, arm64, heap retained after a forced GC):
+ *
+ *   shape                       bytes/element   tree heap / part bytes
+ *   `<w:r/>`                          49.5 B            8.3x
+ *   `<w:r a=".." x4/>`               105-124 B          2.8-3.3x
+ *   `<w:r><w:t>x</w:t></w:r>`        162-171 B         14.1-14.8x
+ *
+ * An element is therefore the unit a memory bound has to count, because the
+ * adversarial shape is the cheap one: `<w:r/>` is 7 bytes of markup and 49.5
+ * bytes of tree, so 128 MiB of markup buys ~19M elements and ~950 MB of tree
+ * inside a byte budget that never trips.
+ *
+ * Corpus distribution (5,314 readable packages, every XML and .rels part):
+ *
+ *   metric                     p50      p90      p99    p99.9        max
+ *   elements / part             16      227    1,590   24,719    596,668
+ *   elements / package         917    3,230   29,106   71,975    602,212
+ *   attributes / part           27      577    1,993   21,037    630,374
+ *   attributes / package     1,783    4,711   25,896   91,946    639,110
+ *   depth / part                 3        9       15       22     15,005
+ *   elements per byte        0.012    0.027    0.036    0.043      0.111
+ *
+ * The defaults below reject no corpus package that today's bounds accept. The
+ * package budget is the one that matters: it caps a whole package at ~2.5M
+ * elements and ~3M attributes, which is at most ~425 MB of tree at the densest
+ * measured shape and ~124 MB at the cheapest. Before it existed, only
+ * `word/document.xml`, `word/styles.xml` and `word/numbering.xml` were counted
+ * at all, so a package of many merely-large parts could reach the expansion
+ * ceiling of 250 MiB, ~37M elements and well past 1.8 GB of tree while passing
+ * every bound. Lower these to trade format reach for a smaller ceiling.
+ */
 declare const FOLIO_XML_RESOURCE_LIMITS: {
   readonly maxBytes: number;
   readonly maxDepth: 100;
-  readonly maxNodes: 1000000;
+  /** 1.68x the corpus maximum (596,668). Unchanged; a shipped bound is not loosened. */
+  readonly maxElementsPerPart: 1000000;
+  /** 3.97x the corpus maximum (630,374). */
+  readonly maxAttributesPerPart: 2500000;
+  /** 4.15x the corpus maximum (602,212). */
+  readonly maxElementsPerPackage: 2500000;
+  /** 4.69x the corpus maximum (639,110). */
+  readonly maxAttributesPerPackage: 3000000;
 };
 type XmlResourceLimits = {
   maxBytes: number;
   maxDepth: number;
-  maxNodes: number;
+  maxElementsPerPart: number;
+  maxAttributesPerPart: number;
+  maxElementsPerPackage: number;
+  maxAttributesPerPackage: number;
 };
-type XmlResourceLimitKind = "bytes" | "depth" | "nodes" | "syntax";
+type XmlResourceLimitKind = "bytes" | "depth" | "elements" | "attributes" | "package-elements" | "package-attributes" | "syntax";
 declare const XmlResourceLimitError_base: import("better-result").TaggedErrorClass<"XmlResourceLimitError">;
 /** XML input exceeded a parser resource bound or could not be scanned safely. */
 declare class XmlResourceLimitError extends XmlResourceLimitError_base<{
   message: string;
   limit: XmlResourceLimitKind;
+  /** The package part being scanned, when the caller named one. */
+  partPath?: string;
+  /** The count reached at the point of refusal, not the count of the whole input. */
+  observed: number;
+  allowed: number;
 }> {}
 /**
- * Bound XML bytes, element count, and nesting before building an object tree.
- * The lexical scan is iterative, so deeply nested input cannot consume the JS
- * call stack before the depth limit is enforced.
+ * What a package has spent so far, shared by every part in one package.
+ *
+ * Per-part bounds alone do not bound a package: a package may hold hundreds of
+ * parts, each individually modest. The budget is the accumulator the readers
+ * carry across parts so the ceiling is the package's, not each part's.
+ */
+type XmlPackageBudget = {
+  elements: number;
+  attributes: number;
+};
+declare const createXmlPackageBudget: () => XmlPackageBudget;
+type XmlResourceScanOptions = {
+  xml: string;
+  limits?: XmlResourceLimits;
+  /** The package path scanned, carried on any refusal so a host can name it. */
+  partPath?: string;
+  /** Charged as the scan proceeds; omit for a part with no package context. */
+  budget?: XmlPackageBudget;
+};
+/** What the preflight counted, for callers that reconcile it against the tree. */
+type XmlResourceScanResult = {
+  elements: number;
+  attributes: number;
+  maxDepth: number;
+};
+/**
+ * Bound XML bytes, element count, attribute count and nesting before building
+ * an object tree. The lexical scan is iterative, so deeply nested input cannot
+ * consume the JS call stack before the depth limit is enforced, and every
+ * bound is checked at the point it is crossed, so the work done before a
+ * refusal is proportional to the limit rather than to the input.
  */
-declare const assertXmlResourceLimits: (xml: string, limits?: XmlResourceLimits) => void;
+declare const assertXmlResourceLimits: ({ xml, limits, partPath, budget }: XmlResourceScanOptions) => XmlResourceScanResult;
 //#endregion
-export { FOLIO_XML_RESOURCE_LIMITS, XmlResourceLimitError, assertXmlResourceLimits };
+export { FOLIO_XML_RESOURCE_LIMITS, XmlPackageBudget, XmlResourceLimitError, XmlResourceLimits, XmlResourceScanOptions, XmlResourceScanResult, assertXmlResourceLimits, createXmlPackageBudget };

package/dist/docx/xmlResourceLimits.js

@@ -1,12 +1,60 @@
 import { TaggedError } from "better-result";
-/** Shared bounds for XML parts parsed by Folio. */
+/**
+* Shared bounds for XML parts parsed by Folio.
+*
+* `maxBytes` and the package expansion ceiling bound the *markup*; they do not
+* bound what parsing that markup allocates. A parsed element retains far more
+* than the bytes it was written as, so a part that satisfies a byte bound can
+* still cost multiples of it in tree. Measured on this repository's corpus
+* generators (Bun 1.4, arm64, heap retained after a forced GC):
+*
+*   shape                       bytes/element   tree heap / part bytes
+*   `<w:r/>`                          49.5 B            8.3x
+*   `<w:r a=".." x4/>`               105-124 B          2.8-3.3x
+*   `<w:r><w:t>x</w:t></w:r>`        162-171 B         14.1-14.8x
+*
+* An element is therefore the unit a memory bound has to count, because the
+* adversarial shape is the cheap one: `<w:r/>` is 7 bytes of markup and 49.5
+* bytes of tree, so 128 MiB of markup buys ~19M elements and ~950 MB of tree
+* inside a byte budget that never trips.
+*
+* Corpus distribution (5,314 readable packages, every XML and .rels part):
+*
+*   metric                     p50      p90      p99    p99.9        max
+*   elements / part             16      227    1,590   24,719    596,668
+*   elements / package         917    3,230   29,106   71,975    602,212
+*   attributes / part           27      577    1,993   21,037    630,374
+*   attributes / package     1,783    4,711   25,896   91,946    639,110
+*   depth / part                 3        9       15       22     15,005
+*   elements per byte        0.012    0.027    0.036    0.043      0.111
+*
+* The defaults below reject no corpus package that today's bounds accept. The
+* package budget is the one that matters: it caps a whole package at ~2.5M
+* elements and ~3M attributes, which is at most ~425 MB of tree at the densest
+* measured shape and ~124 MB at the cheapest. Before it existed, only
+* `word/document.xml`, `word/styles.xml` and `word/numbering.xml` were counted
+* at all, so a package of many merely-large parts could reach the expansion
+* ceiling of 250 MiB, ~37M elements and well past 1.8 GB of tree while passing
+* every bound. Lower these to trade format reach for a smaller ceiling.
+*/
 const FOLIO_XML_RESOURCE_LIMITS = {
 	maxBytes: 128 * (1024 * 1024),
 	maxDepth: 100,
-	maxNodes: 1e6
+	/** 1.68x the corpus maximum (596,668). Unchanged; a shipped bound is not loosened. */
+	maxElementsPerPart: 1e6,
+	/** 3.97x the corpus maximum (630,374). */
+	maxAttributesPerPart: 25e5,
+	/** 4.15x the corpus maximum (602,212). */
+	maxElementsPerPackage: 25e5,
+	/** 4.69x the corpus maximum (639,110). */
+	maxAttributesPerPackage: 3e6
 };
 /** XML input exceeded a parser resource bound or could not be scanned safely. */
 var XmlResourceLimitError = class extends TaggedError("XmlResourceLimitError") {};
+const createXmlPackageBudget = () => ({
+	elements: 0,
+	attributes: 0
+});
 const exceedsUtf8ByteLimit = (value, maxBytes) => {
 	let bytes = 0;
 	for (let index = 0; index < value.length; index += 1) {
@@ -22,8 +70,9 @@ const exceedsUtf8ByteLimit = (value, maxBytes) => {
 	return false;
 };
 const isXmlWhitespace = (code) => code === 9 || code === 10 || code === 13 || code === 32;
-const findTagClose = (xml, start) => {
+const scanTag = (xml, start) => {
 	let quote = 0;
+	let attributes = 0;
 	for (let cursor = start; cursor < xml.length; cursor += 1) {
 		const code = xml.charCodeAt(cursor);
 		if (quote !== 0) {
@@ -34,29 +83,53 @@ const findTagClose = (xml, start) => {
 			quote = code;
 			continue;
 		}
-		if (code === 62) return cursor;
+		if (code === 61) {
+			attributes += 1;
+			continue;
+		}
+		if (code === 62) return {
+			close: cursor,
+			attributes
+		};
 	}
-	return -1;
+	return {
+		close: -1,
+		attributes
+	};
 };
 const throwSyntaxLimit = () => {
 	throw new XmlResourceLimitError({
 		message: "XML resource preflight could not safely scan malformed markup",
-		limit: "syntax"
+		limit: "syntax",
+		observed: 0,
+		allowed: 0
 	});
 };
 /**
-* Bound XML bytes, element count, and nesting before building an object tree.
-* The lexical scan is iterative, so deeply nested input cannot consume the JS
-* call stack before the depth limit is enforced.
+* Bound XML bytes, element count, attribute count and nesting before building
+* an object tree. The lexical scan is iterative, so deeply nested input cannot
+* consume the JS call stack before the depth limit is enforced, and every
+* bound is checked at the point it is crossed, so the work done before a
+* refusal is proportional to the limit rather than to the input.
 */
-const assertXmlResourceLimits = (xml, limits = FOLIO_XML_RESOURCE_LIMITS) => {
-	if (exceedsUtf8ByteLimit(xml, limits.maxBytes)) throw new XmlResourceLimitError({
-		message: `XML part exceeds ${String(limits.maxBytes)} bytes`,
-		limit: "bytes"
-	});
+const assertXmlResourceLimits = ({ xml, limits = FOLIO_XML_RESOURCE_LIMITS, partPath, budget }) => {
+	const refuse = (limit, message, observed, allowed) => {
+		throw new XmlResourceLimitError({
+			message: partPath === void 0 ? message : `${message} (part ${partPath})`,
+			limit,
+			...partPath === void 0 ? {} : { partPath },
+			observed,
+			allowed
+		});
+	};
+	if (exceedsUtf8ByteLimit(xml, limits.maxBytes)) refuse("bytes", `XML part exceeds ${String(limits.maxBytes)} bytes`, limits.maxBytes + 1, limits.maxBytes);
+	const budgetElements = budget?.elements ?? 0;
+	const budgetAttributes = budget?.attributes ?? 0;
 	let cursor = 0;
 	let depth = 0;
+	let maxDepth = 0;
 	let nodes = 0;
+	let attributes = 0;
 	while (cursor < xml.length) {
 		const open = xml.indexOf("<", cursor);
 		if (open === -1) break;
@@ -79,7 +152,7 @@ const assertXmlResourceLimits = (xml, limits = FOLIO_XML_RESOURCE_LIMITS) => {
 			continue;
 		}
 		if (xml.startsWith("<!", open)) throwSyntaxLimit();
-		const close = findTagClose(xml, open + 1);
+		const { close, attributes: tagAttributes } = scanTag(xml, open + 1);
 		if (close === -1) throwSyntaxLimit();
 		if (xml.charCodeAt(open + 1) === 47) {
 			if (depth === 0) throwSyntaxLimit();
@@ -88,21 +161,29 @@ const assertXmlResourceLimits = (xml, limits = FOLIO_XML_RESOURCE_LIMITS) => {
 			continue;
 		}
 		nodes += 1;
-		if (nodes > limits.maxNodes) throw new XmlResourceLimitError({
-			message: `XML part contains more than ${String(limits.maxNodes)} elements`,
-			limit: "nodes"
-		});
+		if (nodes > limits.maxElementsPerPart) refuse("elements", `XML part contains more than ${String(limits.maxElementsPerPart)} elements`, nodes, limits.maxElementsPerPart);
+		if (budgetElements + nodes > limits.maxElementsPerPackage) refuse("package-elements", `DOCX package contains more than ${String(limits.maxElementsPerPackage)} XML elements`, budgetElements + nodes, limits.maxElementsPerPackage);
+		attributes += tagAttributes;
+		if (attributes > limits.maxAttributesPerPart) refuse("attributes", `XML part contains more than ${String(limits.maxAttributesPerPart)} attributes`, attributes, limits.maxAttributesPerPart);
+		if (budgetAttributes + attributes > limits.maxAttributesPerPackage) refuse("package-attributes", `DOCX package contains more than ${String(limits.maxAttributesPerPackage)} XML attributes`, budgetAttributes + attributes, limits.maxAttributesPerPackage);
 		let lastContent = close - 1;
 		while (lastContent > open && isXmlWhitespace(xml.charCodeAt(lastContent))) lastContent -= 1;
 		const elementDepth = depth + 1;
-		if (elementDepth > limits.maxDepth) throw new XmlResourceLimitError({
-			message: `XML part is nested deeper than ${String(limits.maxDepth)} elements`,
-			limit: "depth"
-		});
+		if (elementDepth > limits.maxDepth) refuse("depth", `XML part is nested deeper than ${String(limits.maxDepth)} elements`, elementDepth, limits.maxDepth);
+		if (elementDepth > maxDepth) maxDepth = elementDepth;
 		if (xml.charCodeAt(lastContent) !== 47) depth = elementDepth;
 		cursor = close + 1;
 	}
 	if (depth !== 0) throwSyntaxLimit();
+	if (budget) {
+		budget.elements += nodes;
+		budget.attributes += attributes;
+	}
+	return {
+		elements: nodes,
+		attributes,
+		maxDepth
+	};
 };
 //#endregion
-export { FOLIO_XML_RESOURCE_LIMITS, XmlResourceLimitError, assertXmlResourceLimits };
+export { FOLIO_XML_RESOURCE_LIMITS, XmlResourceLimitError, assertXmlResourceLimits, createXmlPackageBudget };

package/dist/headless-layout.js

@@ -1,5 +1,7 @@
 import { resolveDocumentGridLinePitch } from "./docx/documentGrid.js";
 import { formatOoxmlCounter } from "./docx/ooxmlCounterFormatter.js";
+import { createParseWarningCollector } from "./docx/parseContext.js";
+import { formatParseWarnings } from "./docx/parseWarningMessage.js";
 import { parseDocx } from "./docx/parser.js";
 import { buildHeaderFooterFieldValues } from "./fields/resolveFieldValues.js";
 import { extractEmbeddedFonts } from "./fonts/embeddedFonts.js";
@@ -209,14 +211,21 @@ const layoutDocxHeadless = async (input, options = {}) => {
 	});
 	if (parsed.isErr()) return Result.err(parsed.error);
 	const document = parsed.value;
+	const { context: projectionContext, warnings: projectionWarnings } = createParseWarningCollector("word/document.xml");
 	const projected = Result.try(() => toProseDoc(document, {
 		...document.package.styles ? { styles: document.package.styles } : {},
-		...document.package.theme ? { theme: document.package.theme } : {}
+		...document.package.theme ? { theme: document.package.theme } : {},
+		warn: projectionContext.warn
 	}));
 	if (projected.isErr()) return Result.err(new HeadlessLayoutError({
 		message: "The document could not be projected to the editable model.",
 		cause: projected.error
 	}));
+	const recorded = projectionWarnings();
+	if (recorded.length > 0) {
+		document.parseWarnings = [...document.parseWarnings ?? [], ...recorded];
+		document.warnings = [...document.warnings ?? [], ...formatParseWarnings(recorded)];
+	}
 	if (packageNeedsShaping(document.package)) {
 		const loaded = await Result.tryPromise({
 			try: () => getShaper(),

package/dist/index.d.ts

@@ -38,7 +38,8 @@ import { fromMarkdown } from "./markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "./markdown/index.js";
 import { EmbeddedFont, EmbeddedFontParts, buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "./fonts/embeddedFonts.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
+import { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError } from "./prosemirror/yjsDocumentMetadata.js";
 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 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 };
+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, FOLIO_YJS_ATTR_SCHEMA_VERSION, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type 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/index.js

@@ -25,6 +25,7 @@ import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acc
 import { getTemplateDirectives, scanDirectives } from "./prosemirror/plugins/templateDirectives.js";
 import { setTemplatePreviewValues } from "./prosemirror/plugins/templatePreviewValues.js";
 import { clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu, resetTemplateSlashQuery, templateSlashMenuKey } from "./prosemirror/plugins/templateSlashMenu.js";
+import { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersionError } from "./prosemirror/yjsDocumentMetadata.js";
 import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
@@ -33,4 +34,4 @@ import { createEmptyDocument } from "./utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, 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, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, 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 { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, FolioYjsAttrSchemaVersionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, 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.js

@@ -37,6 +37,7 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 			case "footnoteRef":
 			case "instrText":
 			case "noBreakHyphen":
+			case "preservedXml":
 			case "renderedPageBreak":
 			case "softHyphen":
 			case "symbol":
@@ -60,7 +61,7 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 				case "moveFrom":
 				case "moveTo":
 				case "inlineSdt":
-				case "bidiWrapper": return inspectMany(content.content, inspectParagraphContent);
+				case "inlineWrapper": 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;
@@ -82,7 +83,8 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 				case "moveFromRangeEnd":
 				case "moveToRangeStart":
 				case "moveToRangeEnd":
-				case "mathEquation": return 0;
+				case "mathEquation":
+				case "preservedInline": return 0;
 				default: return content;
 			}
 		});
@@ -94,6 +96,7 @@ const buildPageBreakRunSourceDescendantIndex = (rootContent) => {
 			case "paragraph": return inspectMany(block.content, inspectParagraphContent);
 			case "table": return inspectMany(block.rows, inspectTableRow);
 			case "blockSdt": return inspectBlocks(block.content);
+			case "preservedBlock": return 0;
 			default: return block;
 		}
 	});

package/dist/internal/paragraphFormattingSerialization.js

@@ -1,8 +1,9 @@
 import { serializeBorder } from "../docx/serializer/borderSerializer.js";
 import { serializeShading, serializeTextFormatting } from "../docx/serializer/textFormattingSerializer.js";
-import { escapeXml, intAttr } from "../docx/serializer/xmlUtils.js";
+import { intAttr } from "../docx/serializer/xmlUtils.js";
 import { sanitizeCapturedXmlElement } from "../docx/verbatimCapture.js";
 import { NAMESPACES, OOXML_NAMESPACE_SCOPE } from "../docx/xmlParser.js";
+import { escapeXmlAttribute } from "@stll/docx-core";
 //#region src/internal/paragraphFormattingSerialization.ts
 const modelParagraphNumberingReference = (reference) => {
 	if (!reference) return null;
@@ -140,7 +141,7 @@ const modelParagraphFormattingEmission = (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)}"/>` : "",
+		styleId ? `<w:pStyle w:val="${escapeXmlAttribute(styleId)}"/>` : "",
 		serializeToggle("keepNext", keepNext),
 		serializeToggle("keepLines", keepLines),
 		serializeToggle("pageBreakBefore", pageBreakBefore),

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

@@ -8,12 +8,11 @@ import { setParagraphFrame } from "../../layout-engine/paragraphFrame.js";
 import { setTextBoxGroupId } from "../../layout-engine/textBoxGroup.js";
 import { DEFAULT_TEXTBOX_MARGINS } from "../../layout-engine/types.js";
 import { getPageNumbering } from "../../paged-layout/sectionGeometry.js";
-import { expectBlockSdtAttrs, expectCharacterSpacingMarkAttrs, expectCharacterStyleMarkAttrs, expectCommentMarkAttrs, expectEmphasisMarkAttrs, expectFieldAttrs, expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectFootnoteRefMarkAttrs, expectHardBreakAttrs, expectHighlightMarkAttrs, expectHyperlinkMarkAttrs, expectImageAttrs, expectLanguageMarkAttrs, expectMathAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs, expectRunShadingMarkAttrs, expectSymbolAttrs, expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, expectTextBoxAttrs, expectTextColorMarkAttrs, expectTextEffectMarkAttrs, expectTrackedChangeMarkAttrs, expectUnderlineMarkAttrs } from "../../prosemirror/attrs/index.js";
+import { expectBlockSdtAttrs, expectCharacterSpacingMarkAttrs, expectCharacterStyleMarkAttrs, expectCommentMarkAttrs, expectEmphasisMarkAttrs, expectFieldAttrs, expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectFootnoteRefMarkAttrs, expectHardBreakAttrs, expectHighlightMarkAttrs, expectHyperlinkMarkAttrs, expectImageAttrs, expectInlineWrapperMarkAttrs, expectLanguageMarkAttrs, expectMathAttrs, expectParagraphAttrs, expectPreservedXmlAttrs, expectRunFormattingOverrideMarkAttrs, expectRunShadingMarkAttrs, expectSymbolAttrs, expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, expectTextBoxAttrs, expectTextColorMarkAttrs, expectTextEffectMarkAttrs, expectTrackedChangeMarkAttrs, expectUnderlineMarkAttrs } from "../../prosemirror/attrs/index.js";
 import { autospacingMatchesBase } from "../../prosemirror/autospacingBase.js";
 import { runShadingAttrsToShading } from "../../prosemirror/conversion/runShadingMark.js";
 import { advanceListMarker, advanceVisibleListMarker, cloneListCounterState, formatCounter, resolveListTemplate } from "../../prosemirror/listMarker.js";
 import { resolveNumberedRefFields } from "../../prosemirror/numberedRefFields.js";
-import { pageBreakRunParagraphProjectionDisposition } from "../../prosemirror/pageBreakRunProjection.js";
 import { directionToBidi } from "../../prosemirror/paragraphDirection.js";
 import { resolveEffectiveRunStyleFormatting } from "../../prosemirror/runStyleFormatting.js";
 import { expectTextBoxAnchorAttrs } from "../../prosemirror/textBoxAnchorAttrs.js";
@@ -102,6 +101,74 @@ function resetBlockIdCounter() {
 	blockIdCounter = 0;
 }
 /**
+* What the painter does with each mark the schema declares.
+*
+* The switch below used to end in `default: break`, so a mark that reached it
+* was silently not painted whether that was the decision or an omission. The
+* table is total over {@link SchemaMarkName}: a mark added to the schema
+* without a paint decision does not compile, and a mark this table says is
+* painted but the switch does not handle panics rather than disappearing.
+*/
+const MARK_PAINT_DISPOSITIONS = {
+	bold: "runFormatting",
+	italic: "runFormatting",
+	underline: "runFormatting",
+	strike: "runFormatting",
+	textColor: "runFormatting",
+	runShading: "runFormatting",
+	highlight: "runFormatting",
+	fontSize: "runFormatting",
+	fontFamily: "runFormatting",
+	language: "runFormatting",
+	superscript: "runFormatting",
+	subscript: "runFormatting",
+	hyperlink: "runFormatting",
+	allCaps: "runFormatting",
+	smallCaps: "runFormatting",
+	footnoteRef: "runFormatting",
+	characterSpacing: "runFormatting",
+	emboss: "runFormatting",
+	imprint: "runFormatting",
+	hidden: "runFormatting",
+	textShadow: "runFormatting",
+	emphasisMark: "runFormatting",
+	textOutline: "runFormatting",
+	rtl: "runFormatting",
+	textEffect: "runFormatting",
+	runFormattingOverride: "runFormatting",
+	comment: "runFormatting",
+	insertion: "runFormatting",
+	deletion: "runFormatting",
+	inlineWrapper: "runFormatting",
+	characterStyle: "resolvedElsewhere",
+	pageBreakRunOwner: "notPainted",
+	runPropertyChange: "notPainted"
+};
+const markPaintDisposition = (name) => {
+	return MARK_PAINT_DISPOSITIONS[name];
+};
+/**
+* The direction one bidirectional wrapper lays its content out in, as the
+* innermost layer of a stack states it.
+*
+* Only the innermost is read: a wrapper inside another is the one whose
+* direction the text is laid out in, and the outer layers are what the save
+* leg rebuilds the nesting from.
+*/
+const innermostBidiWrapper = (stack) => {
+	const layer = stack.at(-1);
+	if (layer === void 0) return;
+	switch (layer.kind) {
+		case "bidi": return layer.direction === void 0 ? { control: layer.control } : {
+			control: layer.control,
+			direction: layer.direction
+		};
+		default:
+			layer.kind;
+			return;
+	}
+};
+/**
 * Extract run formatting from ProseMirror marks.
 */
 function extractRunFormatting(marks, theme, fontAlternates) {
@@ -282,7 +349,14 @@ function extractRunFormatting(marks, theme, fontAlternates) {
 			}
 			break;
 		}
-		default: break;
+		case "inlineWrapper": {
+			const bidiWrapper = innermostBidiWrapper(expectInlineWrapperMarkAttrs(mark).stack);
+			if (bidiWrapper) formatting.bidiWrapper = bidiWrapper;
+			break;
+		}
+		default:
+			if (markPaintDisposition(mark.type.name) === "runFormatting") panic(`Mark ${mark.type.name} is painted as run formatting but has no branch here`);
+			break;
 	}
 	if (runFormattingOverride) applyRunFormattingOverrides(formatting, runFormattingOverride);
 	if (hasNoteRef && formatting.subscript) delete formatting.superscript;
@@ -530,6 +604,8 @@ function buildImageRun(attrs, constrained, pmStart, pmEnd, trackedChange) {
 	if (attrs.alt !== void 0) run.alt = attrs.alt;
 	if (attrs.transform !== void 0) run.transform = attrs.transform;
 	if (attrs.opacity != null) run.opacity = attrs.opacity;
+	if (attrs.brightness != null) run.brightness = attrs.brightness;
+	if (attrs.contrast != null) run.contrast = attrs.contrast;
 	if (attrs.wrapType !== void 0) run.wrapType = attrs.wrapType;
 	if (attrs.displayMode !== void 0) run.displayMode = attrs.displayMode;
 	if (attrs.cssFloat !== void 0) run.cssFloat = attrs.cssFloat;
@@ -684,6 +760,25 @@ function paragraphToRuns(node, startPos, _options, pageBreaks) {
 			});
 			return;
 		}
+		if (child.type.name === "preservedXml") {
+			const { text } = expectPreservedXmlAttrs(child);
+			if (text === "") return;
+			const formatting = extractRunFormatting(effectiveMarks, theme, fontAlternates);
+			applyCharacterStyleToggleFormatting({
+				formatting,
+				marks: effectiveMarks,
+				paragraphFormatting: pmAttrs.defaultTextFormatting,
+				styleResolver: _options.styleResolver
+			});
+			runs.push({
+				kind: "text",
+				text,
+				...mergeRunFormatting(paraDefaults, formatting),
+				pmStart: childPos,
+				pmEnd: childPos + child.nodeSize
+			});
+			return;
+		}
 		if (child.type.name === "hardBreak") {
 			runs.push({
 				kind: "lineBreak",
@@ -1357,8 +1452,7 @@ function convertTableCell(node, startPos, options, tableCellMargins) {
 	const blocks = [];
 	let offset = startPos + 1;
 	const authoredPageBreakPosition = options.firstPageBreakRunPosition(node);
-	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 leadingParagraph = node.firstChild?.type.name === "paragraph" && countPageBreakRuns(node) === 1 && options.firstPageBreakRunPosition(node.firstChild) === authoredPageBreakPosition ? node.firstChild : void 0;
 	const pageBreaks = [];
 	node.forEach((child) => {
 		if (child.type.name === "paragraph") {
@@ -1406,7 +1500,7 @@ function convertTableCell(node, startPos, options, tableCellMargins) {
 	if (attrs.noWrap) cell.noWrap = true;
 	if (authoredPageBreakPosition === void 0 || pageBreaks.length === 0) return { cell };
 	const paragraph = blocks.at(0);
-	if (paragraph?.kind !== "paragraph" || !hasSingleLeadingProjectedPageBreak(paragraph.runs, pageBreaks)) panic(`An explicit page-break run at ${String(authoredPageBreakPosition)} cannot be projected inside a table cell`);
+	if (paragraph?.kind !== "paragraph" || !hasSingleLeadingProjectedPageBreak(paragraph.runs, pageBreaks)) return { cell };
 	return {
 		cell,
 		breakBefore: "page"
@@ -1523,6 +1617,8 @@ function convertImage(node, startPos, pageContentHeight) {
 	if (attrs.alt) imgBlock.alt = attrs.alt;
 	if (attrs.transform) imgBlock.transform = attrs.transform;
 	if (attrs.opacity != null) imgBlock.opacity = attrs.opacity;
+	if (attrs.brightness != null) imgBlock.brightness = attrs.brightness;
+	if (attrs.contrast != null) imgBlock.contrast = attrs.contrast;
 	if (shouldAnchor) {
 		const anchor = {
 			isAnchored: true,
@@ -1544,8 +1640,6 @@ function convertImage(node, startPos, pageContentHeight) {
 }
 /** Convert a textBox PM node to a TextBoxBlock. */
 function convertTextBoxNode(node, startPos, opts) {
-	const pageBreakPosition = opts.firstPageBreakRunPosition(node);
-	if (pageBreakPosition !== void 0) panic(`An explicit page-break run at ${String(pageBreakPosition)} cannot be projected inside a text box`);
 	const attrs = expectTextBoxAttrs(node);
 	const contentBlocks = [];
 	node.forEach((child, offset) => {
@@ -1746,10 +1840,6 @@ function toFlowBlocks(doc, options = {}) {
 	const pushParagraphProjection = (node, pos, stripLeadingLineBreak = false) => {
 		const pageBreaks = [];
 		const paragraph = convertParagraph(node, pos, opts, pageBreaks);
-		if (pageBreaks.length > 0) {
-			const disposition = pageBreakRunParagraphProjectionDisposition(node);
-			if (disposition.status === "unsupported" && (disposition.reason === "textBoxAnchor" || !hasSingleLeadingProjectedPageBreak(paragraph.runs, pageBreaks))) panic(disposition.message);
-		}
 		if (stripLeadingLineBreak && paragraph.runs.at(0)?.kind === "lineBreak") paragraph.runs.shift();
 		for (const block of splitParagraphAtPageBreaks({
 			pageBreaks,