@stll/folio-core 0.44.0 → 0.46.0

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,5 +1,8 @@
 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
 /**
 * Pure (immutable) write helpers for block-level content controls.
@@ -220,7 +223,8 @@ function controlMatchesFilter(control, filter) {
 	if (filter.sdtType !== void 0 && control.properties.sdtType !== filter.sdtType) return false;
 	return true;
 }
-function makeParagraphFromText(text) {
+function makeParagraphFromText(rawText) {
+	const text = sanitizeXmlCharacters(rawText);
 	return {
 		type: "paragraph",
 		content: text.length === 0 ? [] : [{
@@ -232,6 +236,20 @@ function makeParagraphFromText(text) {
 		}]
 	};
 }
+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);
 }
@@ -300,7 +318,7 @@ function setContentControlValue(doc, filter, input, options = {}) {
 				...control,
 				properties: {
 					...control.properties,
-					dropdownLastValue: input.value,
+					dropdownLastValue: sanitizeXmlCharacters(input.value),
 					showingPlaceholder: false,
 					...strippedRawPropertiesXml !== void 0 ? { rawPropertiesXml: strippedRawPropertiesXml } : {}
 				},
@@ -315,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: {
@@ -324,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);

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

@@ -6,7 +6,7 @@ import { countCompressibleSpaces, toPaintedText } from "../../layout-engine/meas
 import { isFloatingImageRun } from "../../layout-engine/types.js";
 import { resolveParagraphBorderHorizontalOutsets } from "../../layout-painter/borderStroke.js";
 import { getAutomaticTextColorForBackground } from "../../layout-painter/documentColors.js";
-import { getLeaderChar, getRenderableTextColor, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap } from "../../layout-painter/renderParagraph.js";
+import { UNICODE_BIDI_BY_WRAPPER_CONTROL, getLeaderChar, getRenderableTextColor, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap } from "../../layout-painter/renderParagraph.js";
 import { getHorizontalScaleFactor } from "../../utils/horizontalScale.js";
 import { resolvePhysicalParagraphInlineLayout } from "../../utils/paragraphInlineLayout.js";
 import { inlineImageBoundingBox } from "../../utils/rotationBoundingBox.js";
@@ -278,6 +278,23 @@ const modelRangeOf = (run, context) => run.pmStart === void 0 || run.pmEnd === v
 	story: context.story
 };
 /**
+* The base direction one run's glyphs are laid out in.
+*
+* A bidirectional wrapper the author wrote around the run states it, and is
+* nearer than the paragraph's own base direction: an override (`w:bdo`) lays
+* every character out that way, and an embedding (`w:dir`) opens a level in
+* that direction. A wrapper with no `w:val` states nothing, and the paragraph
+* decides as before.
+*/
+const runGlyphDirection = (run, paragraphIsRtl) => run.bidiWrapper?.direction ?? (paragraphIsRtl ? "rtl" : "ltr");
+/**
+* The wrapper's control, for the backend that resolves the order itself.
+*
+* The direction alone does not separate the two: an override forces the
+* order, an embedding leaves the algorithm to resolve within it.
+*/
+const runUnicodeBidi = (run) => run.bidiWrapper === void 0 ? void 0 : UNICODE_BIDI_BY_WRAPPER_CONTROL[run.bidiWrapper.control];
+/**
 * One `glyphRun` plus everything painted around it: the run's background rect
 * first, then the glyphs, then the decorations whose geometry CSS would have
 * derived from the font.
@@ -342,6 +359,7 @@ const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx
 		thicknessPx: 1,
 		pattern: "solid"
 	} : void 0;
+	const unicodeBidi = runUnicodeBidi(run);
 	sink.glyphs.push({
 		kind: "glyphRun",
 		font,
@@ -350,7 +368,8 @@ const emitGlyphRun = ({ sink, context, run, glyphs, style, paintXPx, baselineYPx
 		xPx: paintXPx,
 		baselineYPx: runBaselineYPx,
 		...glyphRunText(glyphs),
-		direction: isRtl ? "rtl" : "ltr",
+		direction: runGlyphDirection(run, isRtl),
+		...unicodeBidi === void 0 ? {} : { unicodeBidi },
 		...stroke === void 0 ? {} : { stroke },
 		...pmRange === void 0 ? {} : { pmRange },
 		...collapsedEdge === void 0 ? {} : { collapsedEdge }

package/dist/display-list/dom/renderDisplayListToDom.js

@@ -1,3 +1,7 @@
+import { writeCommentAnchorIds } from "../../render-dom/commentAnchorAttributes.js";
+import { bytesToDataUrl } from "../../utils/base64.js";
+import { imageLuminanceFilter } from "../../utils/imageLuminance.js";
+import { anchorTargetAttrs } from "../../utils/urlSecurity.js";
 import { STROKE_DASH_FACTORS, walkRegions } from "../primitives.js";
 import { panic } from "better-result";
 //#region src/display-list/dom/renderDisplayListToDom.ts
@@ -42,7 +46,6 @@ const PAGE_CLASS_NAME = "layout-page";
 */
 const PAGE_ELEMENT_ID_PREFIX = "page-";
 const DEGREES_PER_RADIAN = 180 / Math.PI;
-const BASE64_CHUNK_SIZE = 32768;
 const IMAGE_MIME_TYPES = {
 	png: "image/png",
 	jpeg: "image/jpeg"
@@ -98,17 +101,11 @@ const resolveImage = (ref, images) => {
 	if (source === void 0) panic(`renderDisplayListToDom: image ref ${ref} is out of range (${images.length} images)`);
 	return source;
 };
-const toBase64 = (bytes) => {
-	let binary = "";
-	for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK_SIZE) binary += String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK_SIZE));
-	return btoa(binary);
-};
 /** A `Blob` part cannot be backed by shared memory, so prove it is not. */
 const isBlobPart = (bytes) => bytes.buffer instanceof ArrayBuffer;
 const binarySrc = (bytes, mimeType) => {
 	if (isBlobPart(bytes) && typeof Blob === "function" && typeof URL !== "undefined" && typeof URL.createObjectURL === "function") return URL.createObjectURL(new Blob([bytes], { type: mimeType }));
-	if (typeof btoa === "function") return `data:${mimeType};base64,${toBase64(bytes)}`;
-	panic("renderDisplayListToDom: no Blob or btoa to build a binary source from");
+	return bytesToDataUrl(bytes, mimeType);
 };
 const fontFaceRule = (face, embedded, src) => `@font-face { font-family: ${quoteFontFamily(embedded.id)}; src: url("${src}"); font-weight: ${face.weight}; font-style: ${face.italic ? "italic" : "normal"}; }`;
 /**
@@ -315,6 +312,7 @@ const paintGlyphRun = (run, context) => {
 	span.style.fontStyle = face.italic ? "italic" : "normal";
 	span.style.color = cssColor(run.color);
 	span.style.direction = run.direction;
+	if (run.unicodeBidi !== void 0) span.style.unicodeBidi = run.unicodeBidi;
 	if (run.stroke !== void 0) span.style.webkitTextStroke = `${px(run.stroke.thicknessPx)} ${cssColor(run.stroke.color)}`;
 	span.style.fontKerning = run.kerning ? "normal" : "none";
 	if (run.smallCaps) span.style.fontVariant = "small-caps";
@@ -392,13 +390,18 @@ const paintRect = ({ rect, fill, stroke }, context) => {
 		default: panic(`renderDisplayListToDom: unhandled rect stroke painter ${JSON.stringify(painter)}`);
 	}
 };
-const paintImage = ({ image, rect, crop, opacity }, context) => {
+const paintImage = ({ image, rect, crop, opacity, brightness, contrast }, context) => {
 	const source = resolveImage(image, context.images);
 	const clip = createAbsoluteDiv(context, rect);
 	clip.style.overflow = "hidden";
 	const element = context.doc.createElement("img");
 	element.style.position = "absolute";
 	element.style.opacity = String(opacity);
+	const filter = imageLuminanceFilter({
+		...brightness === void 0 ? {} : { brightness },
+		...contrast === void 0 ? {} : { contrast }
+	});
+	if (filter !== void 0) element.style.filter = filter;
 	element.style.left = "0px";
 	element.style.top = "0px";
 	element.style.width = px(rect.widthPx);
@@ -489,6 +492,11 @@ const paintLink = ({ rect, target, tooltip }, context) => {
 	element.style.width = px(rect.widthPx);
 	element.style.height = px(rect.heightPx);
 	element.href = linkHref(target);
+	if (target.kind !== "page") {
+		const anchor = anchorTargetAttrs(void 0);
+		element.target = anchor.target;
+		element.rel = anchor.rel;
+	}
 	if (tooltip !== void 0) element.title = tooltip;
 	context.parent.append(element);
 };
@@ -549,7 +557,7 @@ const applyRegionModel = (element, region) => {
 		element.dataset["pmEnd"] = String(model.pmRange.end);
 	}
 	if (model.blockId !== void 0) element.dataset["blockId"] = model.blockId;
-	if (model.commentIds !== void 0 && model.commentIds.length > 0) element.dataset["commentId"] = String(model.commentIds[0]);
+	if (model.commentIds !== void 0) writeCommentAnchorIds(element, model.commentIds);
 	if (model.rowIndex !== void 0) element.dataset["rowIndex"] = String(model.rowIndex);
 	if (model.columnIndex !== void 0) element.dataset["columnIndex"] = String(model.columnIndex);
 	const story = model.story ?? model.pmRange?.story;

package/dist/display-list/types.d.ts

@@ -215,6 +215,19 @@ type DisplayGlyphRun = {
   readonly text: string;
   readonly advancesPx: readonly number[];
   readonly direction: "ltr" | "rtl";
+  /**
+   * How a backend that resolves bidirectional text itself must treat the run.
+   *
+   * `direction` alone is the base direction, and a backend that hands the text
+   * to such a resolver gets the ordinary algorithm: a Latin word inside an
+   * `rtl` run reads forwards. That is an embedding, and it is wrong for the
+   * run the author wrapped in an override (`w:bdo`), where every character is
+   * laid out in `direction` whatever its own script. Absent is the ordinary
+   * run, whose base direction the paragraph or the run itself decided; a
+   * backend that positions every glyph from `advancesPx` reorders nothing and
+   * ignores this.
+   */
+  readonly unicodeBidi?: "embed" | "bidi-override";
   /**
    * Whether the glyphs kern.
    *
@@ -299,6 +312,10 @@ type DisplayImagePrimitive = {
     readonly b: number;
   };
   readonly opacity: number;
+  /** DrawingML picture brightness as a signed percentage. */
+  readonly brightness?: number;
+  /** DrawingML picture contrast as a signed percentage. */
+  readonly contrast?: number;
 };
 /** Clips its children to `rect`. Used for cropped images and cell overflow. */
 type DisplayClipGroup = {

package/dist/document-operations.js

@@ -1,6 +1,7 @@
 import { applyFolioAIEditOperations, previewFolioAIEditOperations } from "./ai-edits/apply.js";
 import { LINE_SPACING_RULE_VALUES, PARAGRAPH_ALIGNMENT_VALUES } from "./types/documentEnumValues.js";
 import { TaggedError } from "better-result";
+import { sanitizeXmlCharacters } from "@stll/docx-core";
 //#region src/document-operations.ts
 const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION = 1;
 /** Direct paragraph-alignment values accepted by the operation contract. */
@@ -138,15 +139,25 @@ const assertAllowedKeys = (value, path, allowedKeys) => {
 	const unexpected = Object.keys(value).find((key) => !allowedKeys.includes(key));
 	if (unexpected !== void 0) invalidBatch(`${path}.${unexpected}`, "unexpected property");
 };
+/**
+* Every string in a batch passes through here, so this is where a value an
+* agent sent stops being able to corrupt the package it lands in: XML 1.0
+* admits none of the C0 controls but tab, LF and CR, and no escape can carry
+* one into a document. The batch is otherwise held to exactly what it says, so
+* the rule is the narrowest one that keeps the request usable — drop what
+* cannot be written, map an unpaired surrogate to U+FFFD — rather than
+* rejecting a whole edit over a stray control character. The parsed batch is
+* both what folio applies and what the receipt reports, so the two agree.
+*/
 const readString = (value, key, path) => {
 	const candidate = value[key];
-	if (typeof candidate === "string") return candidate;
+	if (typeof candidate === "string") return sanitizeXmlCharacters(candidate);
 	return invalidBatch(`${path}.${key}`, "expected a string");
 };
 const readOptionalString = (value, key, path) => {
 	const candidate = value[key];
 	if (candidate === void 0) return;
-	if (typeof candidate === "string") return candidate;
+	if (typeof candidate === "string") return sanitizeXmlCharacters(candidate);
 	return invalidBatch(`${path}.${key}`, "expected a string when provided");
 };
 const readOptionalBoolean = (value, key, path) => {
@@ -184,7 +195,7 @@ const readOptionalStringArray = (value, key, path) => {
 	if (candidate === void 0) return;
 	if (!Array.isArray(candidate)) return invalidBatch(`${path}.${key}`, "expected an array when provided");
 	return candidate.map((item, index) => {
-		if (typeof item === "string") return item;
+		if (typeof item === "string") return sanitizeXmlCharacters(item);
 		return invalidBatch(`${path}.${key}[${index}]`, "expected a string");
 	});
 };

package/dist/docx/attributeRemainder.d.ts

@@ -0,0 +1,43 @@
+import { XmlElement } from "./xmlParser.js";
+import { PreservedAttribute } from "@stll/docx-core/model";
+//#region src/docx/attributeRemainder.d.ts
+/**
+ * The modelled set of an element whose serializer writes no attribute at all.
+ *
+ * `w:r`, `w:tr` and `w:sectPr` are rebuilt as bare start tags, so everything
+ * their source wrote is the remainder. Named rather than spelled `new Set()`
+ * at each call site, so the claim is visible and one place has to change when
+ * one of them gains a modelled attribute.
+ */
+declare const NO_MODELLED_ATTRIBUTES: ReadonlySet<string>;
+type AttributeRemainderOptions = {
+  /** The element, as the source wrote it. */
+  element: XmlElement;
+  /**
+   * Local names this element's own parser reads.
+   *
+   * Local names rather than qualified ones, because folio's attribute readers
+   * fall back to a local-name match across prefixes: an attribute the parser
+   * would read under any binding has to be out of the remainder, or the save
+   * writes the value twice under two spellings.
+   */
+  modelled: ReadonlySet<string>;
+};
+/**
+ * Every attribute on the element the model has no field for.
+ *
+ * @returns the remainder, or `undefined` when the parser read them all — an
+ *   empty list is never written, so a fully modelled element stays identical
+ *   in the model.
+ */
+declare const attributeRemainder: ({ element, modelled }: AttributeRemainderOptions) => PreservedAttribute[] | undefined;
+/**
+ * The element's attributes, modelled first and the remainder after them.
+ *
+ * @param modelled the fragments the serializer is about to emit, already
+ *   spelled — they win a collision, because the model is the editable copy
+ * @returns the fragments to write, so an element with neither writes nothing
+ */
+declare const serializePreservedAttributes: (modelled: readonly string[], preserved: readonly PreservedAttribute[] | undefined) => string[];
+//#endregion
+export { NO_MODELLED_ATTRIBUTES, attributeRemainder, serializePreservedAttributes };