@stll/folio-core 0.45.0 → 0.46.0

package/dist/ai-edits/apply.js

@@ -10,6 +10,7 @@ import { directParagraphIndentation, paragraphIndentationAttrPatch, paragraphInd
 import { directParagraphSpacing, paragraphSpacingAttrPatch, paragraphSpacingEqual, paragraphSpacingFromFormatting, withDirectParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
 import { getDocumentNumbering } from "../prosemirror/plugins/documentNumbering.js";
 import { getDocumentStyleResolver } from "../prosemirror/plugins/documentStyles.js";
+import { addCarriedMarks, annotatedReplacement, hasReplacedAnnotations, inheritedReplacementMarks, surveyReplacedAnnotations } from "../prosemirror/replacedAnnotations.js";
 import { applyMarksToRunFormattingRepresentation, runFormattingInlineControlNodeName, selectRunFormattingCarrierRepresentations } from "../prosemirror/runFormattingInlineCarriers.js";
 import { readAuthoredRunFormatting, reconcileRunFormattingMarks } from "../prosemirror/runFormattingReconciliation.js";
 import { paragraphRunStyleContext, paragraphRunStyleContextAt } from "../prosemirror/runStyleFormatting.js";
@@ -949,6 +950,14 @@ const buildEmphasisInlineContent = (schema, text, baseMarks) => {
 	}
 	return nodes.length > 0 ? nodes : [schema.text(text, [...baseMarks])];
 };
+/**
+* Inline content for a block the applier rebuilds whole, carrying over the
+* annotations the block's old content held (see `replacedAnnotations`).
+*/
+const rebuiltBlockContent = ({ doc, blockFrom, blockTo, content }) => annotatedReplacement({
+	annotations: surveyReplacedAnnotations(doc, blockFrom + 1, blockTo - 1),
+	content: Fragment.fromArray([...content])
+}).fragment;
 const isBatchableParagraphInsertion = (item, mode) => {
 	if (item.operation.type !== "insertAfterBlock" && item.operation.type !== "insertBeforeBlock") return false;
 	if (item.commentText !== void 0) return false;
@@ -1608,7 +1617,12 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					const replacement = item.operation.text;
 					const paragraphType = view.state.schema.nodes["paragraph"];
 					if (paragraphType) {
-						const node = paragraphType.create(null, replacement.length === 0 ? null : buildEmphasisInlineContent(view.state.schema, replacement, commentMark ? [commentMark] : []));
+						const node = paragraphType.create(null, rebuiltBlockContent({
+							doc: tr.doc,
+							blockFrom: item.blockFrom,
+							blockTo: item.blockTo,
+							content: replacement.length === 0 ? [] : buildEmphasisInlineContent(view.state.schema, replacement, commentMark ? [commentMark] : [])
+						}));
 						tr = tr.replaceWith(item.blockFrom, item.blockTo, node);
 						tr = applyReplaceBlockStyleId({
 							item,
@@ -1619,7 +1633,12 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					}
 				}
 				if (mode === "direct" && hasInlineEmphasis(item.operation.text)) {
-					const node = item.blockNode.type.create({ ...item.blockNode.attrs }, buildEmphasisInlineContent(view.state.schema, item.operation.text, commentMark ? [commentMark] : []));
+					const node = item.blockNode.type.create({ ...item.blockNode.attrs }, rebuiltBlockContent({
+						doc: tr.doc,
+						blockFrom: item.blockFrom,
+						blockTo: item.blockTo,
+						content: buildEmphasisInlineContent(view.state.schema, item.operation.text, commentMark ? [commentMark] : [])
+					}));
 					tr = tr.replaceWith(item.blockFrom, item.blockTo, node);
 					tr = applyReplaceBlockStyleId({
 						item,
@@ -2342,18 +2361,28 @@ const cleanTextInlineNodes = ({ schema, text, marks = [] }) => {
 	if (trailing.length > 0) nodes.push(schema.text(trailing, marks));
 	return nodes;
 };
-const insertCleanText = ({ tr, from, to, text }) => {
-	if (!hasCleanTextControls(text)) return {
+const insertCleanText = ({ tr, from, to, text, standsInFor }) => {
+	const annotations = surveyReplacedAnnotations(tr.doc, from, to);
+	const replaced = standsInFor ? surveyReplacedAnnotations(tr.doc, standsInFor.from, standsInFor.to).carried : [];
+	if (!hasReplacedAnnotations(annotations) && replaced.length === 0 && !hasCleanTextControls(text)) return {
 		transaction: tr.insertText(text, from, to),
+		start: from,
 		end: from + text.length
 	};
-	const content = Fragment.fromArray(cleanTextInlineNodes({
-		schema: tr.doc.type.schema,
-		text
-	}));
+	const schema = tr.doc.type.schema;
+	const { fragment, leadingSize, contentSize } = annotatedReplacement({
+		annotations,
+		content: Fragment.fromArray(cleanTextInlineNodes({
+			schema,
+			text,
+			marks: addCarriedMarks(inheritedReplacementMarks(tr.doc, from, to), replaced)
+		}))
+	});
+	const start = from + leadingSize;
 	return {
-		transaction: tr.replaceWith(from, to, content),
-		end: from + content.size
+		transaction: tr.replaceWith(from, to, fragment),
+		start,
+		end: start + contentSize
 	};
 };
 const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete, revisionIdInsert, commentMark, suggestionId = null, initials, diffText }) => {
@@ -2365,8 +2394,11 @@ const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete,
 	})());
 	if (mode === "direct") {
 		if ((item.operation.type === "replaceInBlock" || item.operation.type === "replaceRange") && hasInlineEmphasis(item.operation.replace)) {
-			const content = buildEmphasisInlineContent(nextTr.doc.type.schema, item.operation.replace, commentMark ? [commentMark] : []);
-			return nextTr.replaceWith(item.from, item.to, content);
+			const { fragment } = annotatedReplacement({
+				annotations: surveyReplacedAnnotations(nextTr.doc, item.from, item.to),
+				content: Fragment.fromArray(buildEmphasisInlineContent(nextTr.doc.type.schema, item.operation.replace, commentMark ? [commentMark] : []))
+			});
+			return nextTr.replaceWith(item.from, item.to, fragment);
 		}
 		const inserted = insertCleanText({
 			tr: nextTr,
@@ -2375,7 +2407,7 @@ const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete,
 			text: replacement
 		});
 		nextTr = inserted.transaction;
-		if (commentMark && replacement.length > 0) nextTr = nextTr.addMark(item.from, inserted.end, commentMark);
+		if (commentMark && replacement.length > 0) nextTr = nextTr.addMark(inserted.start, inserted.end, commentMark);
 		return nextTr;
 	}
 	const insertionType = nextTr.doc.type.schema.marks["insertion"];
@@ -2465,11 +2497,15 @@ const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete,
 						tr: nextTr,
 						from: step.at,
 						to: step.at,
-						text: step.text
+						text: step.text,
+						standsInFor: {
+							from: item.from,
+							to: item.to
+						}
 					});
 					nextTr = inserted.transaction;
-					nextTr = nextTr.addMark(step.at, inserted.end, insertionType.create(insAttrs));
-					if (commentMark) nextTr = nextTr.addMark(step.at, inserted.end, commentMark);
+					nextTr = nextTr.addMark(inserted.start, inserted.end, insertionType.create(insAttrs));
+					if (commentMark) nextTr = nextTr.addMark(inserted.start, inserted.end, commentMark);
 				}
 			}
 			return nextTr;
@@ -2480,11 +2516,15 @@ const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete,
 			tr: nextTr,
 			from: item.to,
 			to: item.to,
-			text: replacement
+			text: replacement,
+			standsInFor: {
+				from: item.from,
+				to: item.to
+			}
 		});
 		nextTr = inserted.transaction;
-		nextTr = nextTr.addMark(item.to, inserted.end, insertionType.create(insAttrs));
-		if (commentMark) nextTr = nextTr.addMark(item.to, inserted.end, commentMark);
+		nextTr = nextTr.addMark(inserted.start, inserted.end, insertionType.create(insAttrs));
+		if (commentMark) nextTr = nextTr.addMark(inserted.start, inserted.end, commentMark);
 	}
 	if (item.to > item.from && deletionType) {
 		nextTr = nextTr.addMark(item.from, item.to, deletionType.create(delAttrs));

package/dist/ai-edits/headless.js

@@ -1544,7 +1544,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* same states, so the text now describes exactly what a save would write.
 	*/
 	storyBlocks(state, source) {
-		return state ? proseDocToBlocks(state.doc, source.content, this.baseDocument.package.styles, { emptyFieldResult: "authored" }) : source.content;
+		return state ? proseDocToBlocks(state.doc, source.content, this.baseDocument.package.styles) : source.content;
 	}
 	getHeaderFooterStoryText(story, source) {
 		const state = this.secondaryStoryStates.get(headerFooterStoryKey(story))?.state;

package/dist/compare/compare.js

@@ -15,7 +15,7 @@ import { sameAuthoredInlineProvenance } from "./inline-provenance.js";
 import { planStoryCompare } from "./plan.js";
 import { withFixedPackageDates } from "./reproducible-package.js";
 import { compareSectionBoundaryProperties } from "./section-boundary-properties.js";
-import { CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError } from "./types.js";
+import { CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, InvalidCompareDocxOptionsError, compareDocxSerializeError } from "./types.js";
 import { classifyGeometryMismatch, classifyProjectionMismatch, revisedFinalParagraphMarks } from "./verification.js";
 import { Result, panic } from "better-result";
 //#region src/compare/compare.ts
@@ -903,10 +903,7 @@ const serializeComparison = async ({ baseBuffer, baseCarriedRevisions, reviewer,
 	}));
 	return await Result.tryPromise({
 		try: async () => await withFixedPackageDates(await reviewer.toBuffer(), packageDate),
-		catch: (cause) => new CompareDocxSerializeError({
-			message: "The compared document could not be serialized.",
-			cause
-		})
+		catch: (cause) => compareDocxSerializeError("The compared document could not be serialized", cause)
 	});
 };
 /**

package/dist/compare/scenario.js

@@ -1,6 +1,6 @@
 import { FolioDocxReviewer } from "../ai-edits/headless.js";
 import { createFolioAITextRangeHandle } from "../ai-edits/snapshot.js";
-import { CompareDocxParseError, CompareDocxSerializeError } from "./types.js";
+import { CompareDocxParseError, compareDocxSerializeError } from "./types.js";
 import { Result, panic } from "better-result";
 //#region src/compare/scenario.ts
 /**
@@ -252,10 +252,7 @@ const applyEditScript = async (base, script) => {
 	}
 	const serialized = await Result.tryPromise({
 		try: async () => await reviewer.toBuffer(),
-		catch: (cause) => new CompareDocxSerializeError({
-			message: "The edit script's target document could not be serialized.",
-			cause
-		})
+		catch: (cause) => compareDocxSerializeError("The edit script's target document could not be serialized", cause)
 	});
 	return serialized.isErr() ? Result.err(serialized.error) : Result.ok({
 		buffer: serialized.value,

package/dist/compare/types.d.ts

@@ -316,6 +316,14 @@ declare class CompareDocxSerializeError extends CompareDocxSerializeError_base<{
   message: string;
   cause: unknown;
 }> {}
+/**
+ * A serialize failure whose message names the reason.
+ *
+ * `cause` is structured context a caller can branch on, but a log line, a
+ * report and the corpus census read the message, and a constant one collapses
+ * every distinct save failure into a single undiagnosable row.
+ */
+declare const compareDocxSerializeError: (context: string, cause: unknown) => CompareDocxSerializeError;
 declare const CompareDocxFinalParagraphMarkError_base: import("better-result").TaggedErrorClass<"CompareDocxFinalParagraphMarkError">;
 /**
  * A container's final paragraph mark carries a revision, so the package would
@@ -335,4 +343,4 @@ declare class CompareDocxFinalParagraphMarkError extends CompareDocxFinalParagra
 }> {}
 type CompareDocxError = CompareDocxApplyError | CompareDocxFinalParagraphMarkError | CompareDocxOperationLimitError | CompareDocxParseError | CompareDocxRoundTripError | CompareDocxSerializeError | InvalidCompareDocxOptionsError;
 //#endregion
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareCompatibility, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFolioRequirement, CompareResult, CompareRevisionFormat, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError };
+export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareCompatibility, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFolioRequirement, CompareResult, CompareRevisionFormat, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError, compareDocxSerializeError };

package/dist/compare/types.js

@@ -31,6 +31,17 @@ var CompareDocxRoundTripError = class extends TaggedError("CompareDocxRoundTripE
 var CompareDocxOperationLimitError = class extends TaggedError("CompareDocxOperationLimitError") {};
 var CompareDocxSerializeError = class extends TaggedError("CompareDocxSerializeError") {};
 /**
+* A serialize failure whose message names the reason.
+*
+* `cause` is structured context a caller can branch on, but a log line, a
+* report and the corpus census read the message, and a constant one collapses
+* every distinct save failure into a single undiagnosable row.
+*/
+const compareDocxSerializeError = (context, cause) => new CompareDocxSerializeError({
+	message: `${context}: ${cause instanceof Error ? cause.message : String(cause)}`,
+	cause
+});
+/**
 * A container's final paragraph mark carries a revision, so the package would
 * not open, or would open carrying one no reader can resolve.
 *
@@ -43,4 +54,4 @@ var CompareDocxSerializeError = class extends TaggedError("CompareDocxSerializeE
 */
 var CompareDocxFinalParagraphMarkError = class extends TaggedError("CompareDocxFinalParagraphMarkError") {};
 //#endregion
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError };
+export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError, compareDocxSerializeError };

package/dist/compat/eigenpal.d.ts

@@ -37,7 +37,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 "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, 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/compat/eigenpal.js

@@ -26,6 +26,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 { currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioB
 import { createEmptyDocument } from "../utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
-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/content-controls/checkboxDisplay.d.ts

@@ -0,0 +1,11 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/content-controls/checkboxDisplay.d.ts
+type CheckboxDisplayContent = Extract<document_d_exports.RunContent, {
+  type: "symbol";
+} | {
+  type: "text";
+}>;
+/** Resolve the authored checkbox state into the run payload Word expects. */
+declare const checkboxDisplayContent: (rawPropertiesXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
+//#endregion
+export { checkboxDisplayContent };

package/dist/content-controls/checkboxDisplay.js

@@ -0,0 +1,40 @@
+import { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, findChildByNamespaceUri, getAttributeByNamespaceUri, parseXml } from "../docx/xmlParser.js";
+//#region src/content-controls/checkboxDisplay.ts
+const CHECKBOX_NAMESPACE_URIS = /* @__PURE__ */ new Set([NAMESPACES.w14, ...WORDPROCESSINGML_NAMESPACE_URIS]);
+const DEFAULT_CHECKED_CHARACTER = "2612";
+const DEFAULT_UNCHECKED_CHARACTER = "2610";
+const DEFAULT_CHECKBOX_FONT = "MS Gothic";
+const HEX_CODE_POINT = /^[\dA-Fa-f]{1,6}$/u;
+const MAX_CHECKBOX_PROPERTIES_CHARACTERS = 65536;
+const defaultDisplay = (checked) => ({
+	type: "symbol",
+	char: checked ? DEFAULT_CHECKED_CHARACTER : DEFAULT_UNCHECKED_CHARACTER,
+	font: DEFAULT_CHECKBOX_FONT
+});
+/** Resolve the authored checkbox state into the run payload Word expects. */
+const checkboxDisplayContent = (rawPropertiesXml, checked) => {
+	if (!rawPropertiesXml || rawPropertiesXml.length > MAX_CHECKBOX_PROPERTIES_CHARACTERS) return defaultDisplay(checked);
+	let root;
+	try {
+		root = parseXml(rawPropertiesXml, OOXML_NAMESPACE_SCOPE);
+	} catch {
+		return defaultDisplay(checked);
+	}
+	const state = findChildByNamespaceUri(findChildByNamespaceUri(findChildByNamespaceUri(root, WORDPROCESSINGML_NAMESPACE_URIS, "sdtPr"), CHECKBOX_NAMESPACE_URIS, "checkbox"), CHECKBOX_NAMESPACE_URIS, checked ? "checkedState" : "uncheckedState");
+	const rawCharacter = getAttributeByNamespaceUri(state, CHECKBOX_NAMESPACE_URIS, "val");
+	if (!rawCharacter || !HEX_CODE_POINT.test(rawCharacter)) return defaultDisplay(checked);
+	const codePoint = Number.parseInt(rawCharacter, 16);
+	if (!Number.isInteger(codePoint) || codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) return defaultDisplay(checked);
+	const font = getAttributeByNamespaceUri(state, CHECKBOX_NAMESPACE_URIS, "font") ?? DEFAULT_CHECKBOX_FONT;
+	if (codePoint <= 65535) return {
+		type: "symbol",
+		char: codePoint.toString(16).toUpperCase().padStart(4, "0"),
+		font
+	};
+	return {
+		type: "text",
+		text: String.fromCodePoint(codePoint)
+	};
+};
+//#endregion
+export { checkboxDisplayContent };

package/dist/content-controls/findContentControls.js

@@ -1,3 +1,4 @@
+import { decodeOoxmlSymbolCharacter } from "../utils/ooxmlSymbol.js";
 //#region src/content-controls/findContentControls.ts
 function matches(control, filter) {
 	if (filter.pmPos !== void 0) return false;
@@ -63,10 +64,11 @@ function getContentControlText(control) {
 			const paraText = [];
 			for (const item of block.content) if (item.type === "run") {
 				for (const child of item.content) if (child.type === "text") paraText.push(child.text);
+				else if (child.type === "symbol") paraText.push(decodeOoxmlSymbolCharacter(child.char) ?? "");
 			}
 			parts.push(paraText.join(""));
 		} else if (block.type === "table") for (const row of block.rows) for (const cell of row.cells) visit(cell.content);
-		else visit(block.content);
+		else if (block.type === "blockSdt") visit(block.content);
 	};
 	visit(control.content);
 	return parts.join("\n");

package/dist/content-controls/mutateContentControls.js

@@ -1,4 +1,6 @@
 import { formatDate } from "../docx/fieldParser.js";
+import { cloneParagraphWithPropertySource } from "../docx/paragraphPropertySource.js";
+import { checkboxDisplayContent } from "./checkboxDisplay.js";
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "./errors.js";
 import { sanitizeXmlCharacters } from "@stll/docx-core";
 //#region src/content-controls/mutateContentControls.ts
@@ -234,6 +236,20 @@ function makeParagraphFromText(rawText) {
 		}]
 	};
 }
+function makeCheckboxParagraph(control, checked) {
+	const paragraph = control.content.find((block) => block.type === "paragraph");
+	const run = paragraph?.content.find((item) => item.type === "run");
+	const content = [{
+		type: "run",
+		...run?.formatting !== void 0 ? { formatting: run.formatting } : {},
+		content: [checkboxDisplayContent(control.properties.rawPropertiesXml, checked)]
+	}];
+	if (!paragraph) return {
+		type: "paragraph",
+		content
+	};
+	return cloneParagraphWithPropertySource(paragraph, { content });
+}
 function cloneBlock(block) {
 	return structuredClone(block);
 }
@@ -317,7 +333,6 @@ function setContentControlValue(doc, filter, input, options = {}) {
 				...control.properties.tag !== void 0 ? { tag: control.properties.tag } : {},
 				...control.properties.alias !== void 0 ? { alias: control.properties.alias } : {}
 			});
-			const glyph = input.checked ? "☒" : "☐";
 			return {
 				...control,
 				properties: {
@@ -326,7 +341,7 @@ function setContentControlValue(doc, filter, input, options = {}) {
 					showingPlaceholder: false,
 					...strippedRawPropertiesXml !== void 0 ? { rawPropertiesXml: strippedRawPropertiesXml } : {}
 				},
-				content: [makeParagraphFromText(glyph)]
+				content: [makeCheckboxParagraph(control, input.checked)]
 			};
 		}
 		if (sdtType !== "date") throw new ContentControlTypeError({

package/dist/controller/contentControlWidgetController.d.ts

@@ -46,6 +46,7 @@ declare class ContentControlWidgetController extends Subscribable<ContentControl
   private readonly onPaintedClick;
   private readonly onKeyDown;
   private readonly onScroll;
+  private readonly onPointerDown;
   private open;
   private removeDismissListeners;
   private unbindView;

package/dist/controller/contentControlWidgetController.js

@@ -113,15 +113,18 @@ var ContentControlWidgetController = class extends Subscribable {
 		if (event.key === "Escape") this.close();
 	};
 	onScroll = () => this.close();
+	onPointerDown = () => this.close();
 	open(snapshot) {
 		this.removeDismissListeners();
 		this.ownerWindow = this.viewDom?.ownerDocument.defaultView ?? null;
 		this.ownerWindow?.addEventListener("keydown", this.onKeyDown);
+		this.ownerWindow?.addEventListener("pointerdown", this.onPointerDown);
 		this.ownerWindow?.addEventListener("scroll", this.onScroll, true);
 		this.setSnapshot(snapshot);
 	}
 	removeDismissListeners() {
 		this.ownerWindow?.removeEventListener("keydown", this.onKeyDown);
+		this.ownerWindow?.removeEventListener("pointerdown", this.onPointerDown);
 		this.ownerWindow?.removeEventListener("scroll", this.onScroll, true);
 		this.ownerWindow = null;
 	}

package/dist/controller/hiddenEditorApi.js

@@ -45,7 +45,9 @@ const createHiddenEditorApi = (deps) => {
 			return stateToDocument(view.state, deps.getDocumentContext());
 		},
 		focus: () => {
-			deps.getView()?.focus();
+			const view = deps.getView();
+			if (!view || view.hasFocus()) return;
+			view.focus();
 		},
 		blur: () => {
 			const view = deps.getView();

package/dist/controller/hiddenEditorManager.d.ts

@@ -5,9 +5,9 @@ import { RemoteSelection } from "../types/remote-selection.js";
 import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-import * as YProseMirror from "y-prosemirror";
 import * as Yjs from "yjs";
 import { XmlFragment } from "yjs";
+import * as YProseMirror from "y-prosemirror";
 //#region src/controller/hiddenEditorManager.d.ts
 type YProseMirrorModule = typeof YProseMirror;
 type YjsModule = typeof Yjs;

package/dist/controller/hiddenEditorManager.js

@@ -8,7 +8,7 @@ import { createDocumentNumberingPlugin } from "../prosemirror/plugins/documentNu
 import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
 import { createTextInputPlugin } from "../prosemirror/textInput.js";
-import { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract } from "../prosemirror/yjsParagraphSourceContract.js";
+import { applyAttrSchemaMigrations, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsDocumentMetadata } from "../prosemirror/yjsDocumentMetadata.js";
 import { createHiddenEditorApi } from "./hiddenEditorApi.js";
 import { panic } from "better-result";
 import { EditorState } from "prosemirror-state";
@@ -129,12 +129,15 @@ function createHiddenEditorState(options) {
 			collaborationModules.yProseMirror.prosemirrorToYXmlFragment(seedState.doc, collaboration.yXmlFragment);
 			const collaborationDocument = collaboration.yXmlFragment.doc;
 			if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before seeding.");
-			if (proseDocumentParagraphSourceContract(seedState.doc)) writeYjsParagraphSourceContract(collaborationDocument, seedState.doc);
+			writeYjsDocumentMetadata(collaborationDocument, seedState.doc);
 			collaboration.onSeeded?.();
 		}
-		let { doc } = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema);
 		const collaborationDocument = collaboration.yXmlFragment.doc;
 		if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before loading.");
+		const attrSchemaVersion = readYjsAttrSchemaVersion(collaborationDocument);
+		if (attrSchemaVersion.isErr()) throw attrSchemaVersion.error;
+		applyAttrSchemaMigrations(collaborationDocument, collaboration.yXmlFragment, attrSchemaVersion.value);
+		let { doc } = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema);
 		const collaborationContract = readYjsParagraphSourceContract(collaborationDocument);
 		const localContract = proseDocumentParagraphSourceContract(localDoc);
 		if (localContract && collaborationContract !== localContract) panic("The collaboration state belongs to a different paragraph-property source.");

package/dist/display-list/build/buildDisplayList.js

@@ -1,3 +1,4 @@
+import { isHeadingOutlineLevel } from "../../docx/builtInStyles.js";
 import { HIT_REGION_KINDS } from "../primitives.js";
 import { AuthorColorTable } from "./buildContext.js";
 import { DOC_CANVAS } from "./colors.js";
@@ -12,6 +13,19 @@ import { paintTableFragment } from "./tablePrimitives.js";
 import { paintTextBoxFragment } from "./textBoxPrimitives.js";
 import { UNSUPPORTED_CONSTRUCT, UnsupportedCollector } from "./unsupported.js";
 //#region src/display-list/build/buildDisplayList.ts
+/**
+* `Layout` + `BlockLookup` → `DisplayList`.
+*
+* The single source of truth for painting. Two backends consume the result and
+* neither may look behind it, so anything missing here is painted nowhere.
+*
+* Purity is a hard requirement, not a preference: no clock, no randomness, no
+* `globalThis.document`. The font and image tables intern in first-use page
+* order, and author colours are assigned per build, so two builds of one layout
+* are deeply equal. The one impure edge is the measure provider, which the
+* composition root installs and which is deterministic for a given font set;
+* that is the same seam line breaking already ran through, which is the point.
+*/
 /** Document-wide gaps are attributed to the first page, the only one certain to exist. */
 const FIRST_PAGE_INDEX = 0;
 /**
@@ -60,6 +74,11 @@ const paragraphTextOf = (block) => block.runs.map((run) => run.kind === "text" ?
 * Resolve everything that needs the whole document before any page is painted:
 * where each bookmark lands (a `#name` hyperlink cannot become a page target
 * until then) and the heading outline.
+*
+* The outline takes the levels {@link isHeadingOutlineLevel} accepts and no
+* others: `w:outlineLvl` 9 is the reserved body-text value, not a tenth level,
+* and a `TOC Heading` paragraph carrying it would otherwise become a PDF
+* bookmark nested nine deep.
 */
 const collectDocumentTargets = (layout, blockLookup) => {
 	const bookmarkTargets = /* @__PURE__ */ new Map();
@@ -74,7 +93,7 @@ const collectDocumentTargets = (layout, blockLookup) => {
 			yPx: fragment.y
 		});
 		const level = block.attrs?.outlineLevel;
-		if (level !== void 0 && fragment.continuesFromPrev !== true) {
+		if (isHeadingOutlineLevel(level) && fragment.continuesFromPrev !== true) {
 			const title = paragraphTextOf(block);
 			if (title.length > 0) outline.push({
 				title,

package/dist/display-list/build/imagePrimitives.d.ts

@@ -15,7 +15,7 @@ declare class ImageTable {
   failureFor(src: string): string | undefined;
   snapshot(): readonly DisplayImageSource[];
 }
-type ImageVisualSource = Pick<ImageBlock, "src" | "opacity" | "cropTop" | "cropRight" | "cropBottom" | "cropLeft" | "borderWidth" | "borderColor" | "borderStyle" | "transform">;
+type ImageVisualSource = Pick<ImageBlock, "src" | "opacity" | "brightness" | "contrast" | "cropTop" | "cropRight" | "cropBottom" | "cropLeft" | "borderWidth" | "borderColor" | "borderStyle" | "transform">;
 type PaintImageOptions = {
   readonly source: ImageVisualSource;
   readonly rect: DisplayRect;

package/dist/display-list/build/imagePrimitives.js

@@ -213,7 +213,9 @@ const paintImage = ({ source, rect, context, label }) => {
 			image: ref,
 			rect,
 			...crop === void 0 ? {} : { crop },
-			opacity: source.opacity == null ? 1 : Math.min(1, Math.max(0, source.opacity))
+			opacity: source.opacity == null ? 1 : Math.min(1, Math.max(0, source.opacity)),
+			...source.brightness == null ? {} : { brightness: source.brightness },
+			...source.contrast == null ? {} : { contrast: source.contrast }
 		};
 		const degrees = parseRotationDegrees(source.transform);
 		if (degrees === 0) primitives.push(image);