@stll/folio-core 0.45.0 → 0.46.0

package/dist/index.d.ts

@@ -38,7 +38,8 @@ import { fromMarkdown } from "./markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "./markdown/index.js";
 import { EmbeddedFont, EmbeddedFontParts, buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "./fonts/embeddedFonts.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
+import { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError } from "./prosemirror/yjsDocumentMetadata.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewHiddenRange, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareCompatibility, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFolioRequirement, type CompareResult, type CompareRevisionFormat, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentPropertiesOptions, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type DocxDrawingClassification, type DrawingSafetyClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_YJS_ATTR_SCHEMA_VERSION, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineComparisonResult, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, FolioContentInlinePresentationProjectionError, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewHiddenRange, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/index.js

@@ -25,6 +25,7 @@ import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acc
 import { getTemplateDirectives, scanDirectives } from "./prosemirror/plugins/templateDirectives.js";
 import { setTemplatePreviewValues } from "./prosemirror/plugins/templatePreviewValues.js";
 import { clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu, resetTemplateSlashQuery, templateSlashMenuKey } from "./prosemirror/plugins/templateSlashMenu.js";
+import { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersionError } from "./prosemirror/yjsDocumentMetadata.js";
 import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
@@ -33,4 +34,4 @@ import { createEmptyDocument } from "./utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, DRAWING_SAFETY_CLASSES, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioContentComparisonLimitError, FolioContentInlinePresentationProjectionError, FolioYjsAttrSchemaVersionError, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/internal/pageBreakRunSourceDescendantIndex.js

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

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

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

package/dist/layout-engine/measure/tableCellFloating.d.ts

@@ -8,6 +8,8 @@ type TableCellFloatingImage = {
   alt?: string;
   transform?: string;
   opacity?: number;
+  brightness?: number;
+  contrast?: number;
   cropTop?: number;
   cropRight?: number;
   cropBottom?: number;

package/dist/layout-engine/measure/tableCellFloating.js

@@ -68,6 +68,8 @@ function getTableCellFloatingImages(cell, cellMeasure, contentWidth, resolvePosi
 				...run.alt !== void 0 ? { alt: run.alt } : {},
 				...run.transform !== void 0 ? { transform: run.transform } : {},
 				...run.opacity != null ? { opacity: run.opacity } : {},
+				...run.brightness != null ? { brightness: run.brightness } : {},
+				...run.contrast != null ? { contrast: run.contrast } : {},
 				...run.cropTop != null ? { cropTop: run.cropTop } : {},
 				...run.cropRight != null ? { cropRight: run.cropRight } : {},
 				...run.cropBottom != null ? { cropBottom: run.cropBottom } : {},

package/dist/layout-engine/types.d.ts

@@ -1,5 +1,5 @@
 import { OutlineStyleAttr } from "../types/documentEnumValues.js";
-import { ImagePosition, ImageWrap, NumberFormat, SdtProperties, SdtType, ShapeTextBody, TableCellFormatting, TableWidthType, VerticalAlign } from "@stll/docx-core/model";
+import { ImagePosition, ImageWrap, InlineWrapper, NumberFormat, SdtProperties, SdtType, ShapeTextBody, TableCellFormatting, TableWidthType, VerticalAlign } from "@stll/docx-core/model";
 declare namespace types_d_exports {
   export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned };
 }
@@ -99,6 +99,20 @@ type RunFormatting = {
    * RTL; the painter sets `dir="ltr"` so style/paragraph RTL does not leak in.
    */
   rtl?: boolean;
+  /**
+   * The bidirectional wrapper (`w:bdo` / `w:dir`) the run was authored inside,
+   * when it was inside one. An override switches the bidirectional algorithm
+   * off for its content, which is what makes a Latin word inside an `rtl`
+   * override read backwards; an embedding opens a level and leaves the
+   * algorithm on. `direction` is the wrapper's own `w:val`, absent when the
+   * wrapper states none.
+   *
+   * Distinct from `rtl`, which is the run's own `w:rtl` property: the wrapper
+   * is a container the author wrote around the run, not a property of it.
+   */
+  bidiWrapper?: Omit<Extract<InlineWrapper, {
+    kind: "bidi";
+  }>, "type" | "kind" | "content">;
   /**
    * Text effect animation hint (w:effect). Word 2013+ no longer animates,
    * but the painter emits `docx-text-effect-<name>` plus `data-effect` so
@@ -212,6 +226,10 @@ type ImageRun = {
    * eigenpal #424 (opacity render pipeline).
    */
   opacity?: number;
+  /** DrawingML picture brightness as a signed percentage. */
+  brightness?: number;
+  /** DrawingML picture contrast as a signed percentage. */
+  contrast?: number;
   /** Position for floating/anchored images */
   position?: ImageRunPosition;
   /** Whether a table-cell anchor uses the cell as its positioning scope. Undefined defaults true. */
@@ -681,6 +699,10 @@ type ImageBlock = {
    * eigenpal #424 (opacity render pipeline).
    */
   opacity?: number;
+  /** DrawingML picture brightness as a signed percentage. */
+  brightness?: number;
+  /** DrawingML picture contrast as a signed percentage. */
+  contrast?: number;
   anchor?: {
     isAnchored?: boolean;
     offsetH?: number;

package/dist/layout-painter/renderImage.d.ts

@@ -15,6 +15,8 @@ declare const IMAGE_CLASS_NAMES: {
  */
 type ImageVisualAttrs = {
   opacity?: number;
+  brightness?: number;
+  contrast?: number;
   cropTop?: number;
   cropRight?: number;
   cropBottom?: number;
@@ -43,6 +45,8 @@ declare function applyImageBorder(element: HTMLElement, border: ImageBorderAttrs
  */
 declare function hasImageVisualAttrs(v: ImageVisualAttrs): boolean;
 declare function hasImageCrop(v: ImageVisualAttrs): boolean;
+/** Apply non-geometric opacity and luminance effects to an image element. */
+declare function applyImageColorAttrs(img: HTMLImageElement, v: ImageVisualAttrs): void;
 /**
  * Apply an OOXML `<a:srcRect>` crop to an `<img>` whose parent already has
  * `overflow: hidden` and is sized to the *visible* (cropped) dimensions
@@ -96,4 +100,4 @@ type RenderImageFragmentOptions = {
  */
 declare function renderImageFragment(fragment: ImageFragment, block: ImageBlock, _measure: ImageMeasure, _context: RenderContext, options?: RenderImageFragmentOptions): HTMLElement;
 //#endregion
-export { IMAGE_CLASS_NAMES, ImageBorderAttrs, ImageVisualAttrs, RenderImageFragmentOptions, applyImageBorder, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, renderImageFragment, wrapImageWithCrop };
+export { IMAGE_CLASS_NAMES, ImageBorderAttrs, ImageVisualAttrs, RenderImageFragmentOptions, applyImageBorder, applyImageColorAttrs, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, renderImageFragment, wrapImageWithCrop };

package/dist/layout-painter/renderImage.js

@@ -1,3 +1,4 @@
+import { imageLuminanceFilter } from "../utils/imageLuminance.js";
 import { applySanitizedImageSrc } from "../utils/sanitizeImageSrc.js";
 import { anchorTargetAttrs, sanitizeExternalUrl } from "../utils/urlSecurity.js";
 //#region src/layout-painter/renderImage.ts
@@ -32,11 +33,17 @@ function applyImageBorder(element, border) {
 */
 function hasImageVisualAttrs(v) {
 	if (v.opacity != null && v.opacity < 1) return true;
-	return hasImageCrop(v);
+	return imageLuminanceFilter(v) !== void 0 || hasImageCrop(v);
 }
 function hasImageCrop(v) {
 	return Boolean(v.cropTop || v.cropRight || v.cropBottom || v.cropLeft);
 }
+/** Apply non-geometric opacity and luminance effects to an image element. */
+function applyImageColorAttrs(img, v) {
+	if (v.opacity != null && v.opacity < 1) img.style.opacity = String(Math.max(0, v.opacity));
+	const filter = imageLuminanceFilter(v);
+	if (filter !== void 0) img.style.filter = filter;
+}
 /**
 * Apply an OOXML `<a:srcRect>` crop to an `<img>` whose parent already has
 * `overflow: hidden` and is sized to the *visible* (cropped) dimensions
@@ -58,7 +65,7 @@ function hasImageCrop(v) {
 * call for plain images.
 */
 function applyImageVisualAttrs(img, v) {
-	if (v.opacity != null && v.opacity < 1) img.style.opacity = String(Math.max(0, v.opacity));
+	applyImageColorAttrs(img, v);
 	const top = v.cropTop ?? 0;
 	const right = v.cropRight ?? 0;
 	const bottom = v.cropBottom ?? 0;
@@ -159,4 +166,4 @@ function renderImageFragment(fragment, block, _measure, _context, options = {})
 	return containerEl;
 }
 //#endregion
-export { IMAGE_CLASS_NAMES, applyImageBorder, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, renderImageFragment, wrapImageWithCrop };
+export { IMAGE_CLASS_NAMES, applyImageBorder, applyImageColorAttrs, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, renderImageFragment, wrapImageWithCrop };

package/dist/layout-painter/renderPage.d.ts

@@ -19,6 +19,8 @@ type PageFloatingImage = {
    * opaque. eigenpal #424 (opacity render pipeline).
    */
   opacity?: number;
+  brightness?: number;
+  contrast?: number;
   /** Which side: 'left' for left margin, 'right' for right margin */
   side: "left" | "right";
   /** X position relative to content area (0 = left edge of content) */

package/dist/layout-painter/renderPage.js

@@ -371,6 +371,8 @@ function extractFloatingImagesFromParagraph(block, fragmentY, geometry) {
 			...imgRun.alt !== void 0 ? { alt: imgRun.alt } : {},
 			...imgRun.transform !== void 0 ? { transform: imgRun.transform } : {},
 			...imgRun.opacity != null ? { opacity: imgRun.opacity } : {},
+			...imgRun.brightness != null ? { brightness: imgRun.brightness } : {},
+			...imgRun.contrast != null ? { contrast: imgRun.contrast } : {},
 			side,
 			x,
 			y,
@@ -460,6 +462,8 @@ function renderHeaderFooterContent(content, context, options, layout) {
 				height: run.height,
 				...run.alt !== void 0 ? { alt: run.alt } : {},
 				...run.opacity != null ? { opacity: run.opacity } : {},
+				...run.brightness != null ? { brightness: run.brightness } : {},
+				...run.contrast != null ? { contrast: run.contrast } : {},
 				...run.pmStart !== void 0 ? { pmStart: run.pmStart } : {},
 				...run.pmEnd !== void 0 ? { pmEnd: run.pmEnd } : {},
 				paragraphY: paragraphStartY,

package/dist/layout-painter/renderParagraph.d.ts

@@ -30,6 +30,18 @@ type RenderParagraphOptions = {
   renderedInlineImageKeys?: Set<string>;
 };
 declare function getRenderableTextColor(run: TextRun | TabRun): string | undefined;
+/**
+ * How CSS spells each bidirectional wrapper: an override switches the
+ * bidirectional algorithm off for its content, an embedding opens a level and
+ * leaves it on.
+ *
+ * Both painters write the keyword from here, so the DOM painter and the
+ * display list cannot spell the pair differently.
+ */
+declare const UNICODE_BIDI_BY_WRAPPER_CONTROL: {
+  readonly override: "bidi-override";
+  readonly embedding: "embed";
+};
 /**
  * Get leader character for tab
  */
@@ -134,4 +146,4 @@ declare function renderLine(block: ParagraphBlock, line: MeasuredLine, alignment
  */
 declare function renderParagraphFragment(fragment: ParagraphFragment, block: ParagraphBlock, measure: ParagraphMeasure, context: RenderContext, options?: RenderParagraphOptions): HTMLElement;
 //#endregion
-export { PARAGRAPH_CLASS_NAMES, RenderParagraphOptions, getLeaderChar, getRenderableTextColor, renderLine, renderParagraphFragment, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap };
+export { PARAGRAPH_CLASS_NAMES, RenderParagraphOptions, UNICODE_BIDI_BY_WRAPPER_CONTROL, getLeaderChar, getRenderableTextColor, renderLine, renderParagraphFragment, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap };

package/dist/layout-painter/renderParagraph.js

@@ -8,6 +8,7 @@ import { DOCX_SCRIPT_FONT_SCALE } from "../layout-engine/measure/measureHelpers.
 import { calculateTabWidth } from "../layout-engine/measure/tabCalculator.js";
 import { FONT_KERNING_MODE, countCompressibleSpaces, getFontKerningMode, getRunFontKerningMode, toPaintedText } from "../layout-engine/measure/textMeasurementPolicy.js";
 import { isFloatingImageRun } from "../layout-engine/types.js";
+import { writeCommentAnchorIds } from "../render-dom/commentAnchorAttributes.js";
 import { AUTHOR_COLORS, getAuthorColorIdx } from "../utils/authorColors.js";
 import { resolveFontFamily } from "../utils/fontResolver.js";
 import "../utils/fontWeights.js";
@@ -20,7 +21,7 @@ import { anchorTargetAttrs, sanitizeExternalUrl } from "../utils/urlSecurity.js"
 import { borderStrokeToCss, resolveParagraphBorderHorizontalOutsets } from "./borderStroke.js";
 import { planCursiveJoiners, withCursiveJoiners } from "./cursiveJoiners.js";
 import { getAutomaticTextColorForBackground, setAuthoredBackgroundColor, setAuthoredTextColor } from "./documentColors.js";
-import { applyImageBorder, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, wrapImageWithCrop } from "./renderImage.js";
+import { applyImageBorder, applyImageColorAttrs, applyImageVisualAttrs, hasImageCrop, hasImageVisualAttrs, wrapImageWithCrop } from "./renderImage.js";
 import { resolveImageLineAlign } from "./renderUtils.js";
 import { applySdtDataAttrs } from "./sdtBoundary.js";
 //#region src/layout-painter/renderParagraph.ts
@@ -164,6 +165,18 @@ function applyHorizontalScaleTransform(element, horizontalScale) {
 	element.style.transformOrigin = "left center";
 }
 /**
+* How CSS spells each bidirectional wrapper: an override switches the
+* bidirectional algorithm off for its content, an embedding opens a level and
+* leaves it on.
+*
+* Both painters write the keyword from here, so the DOM painter and the
+* display list cannot spell the pair differently.
+*/
+const UNICODE_BIDI_BY_WRAPPER_CONTROL = {
+	override: "bidi-override",
+	embedding: "embed"
+};
+/**
 * Apply text run styles to an element
 */
 function applyRunStyles(element, run) {
@@ -192,6 +205,10 @@ function applyRunStyles(element, run) {
 	}
 	if (run.rtl === true) element.dir = RIGHT_TO_LEFT_DIRECTION;
 	else if (run.rtl === false) element.dir = LEFT_TO_RIGHT_DIRECTION;
+	if (run.bidiWrapper) {
+		element.style.unicodeBidi = UNICODE_BIDI_BY_WRAPPER_CONTROL[run.bidiWrapper.control];
+		if (run.bidiWrapper.direction !== void 0 && run.rtl === void 0) element.dir = run.bidiWrapper.direction === "rtl" ? RIGHT_TO_LEFT_DIRECTION : LEFT_TO_RIGHT_DIRECTION;
+	}
 	if (run.textEffect) {
 		element.classList.add("docx-text-effect", `docx-text-effect-${run.textEffect}`);
 		element.dataset["effect"] = run.textEffect;
@@ -238,7 +255,7 @@ function applyRunStyles(element, run) {
 	if (run.commentIds && run.commentIds.length > 0) {
 		element.style.backgroundColor = "rgba(255, 212, 0, 0.08)";
 		element.style.borderBottom = "1px solid rgba(180, 130, 0, 0.24)";
-		element.dataset["commentId"] = String(run.commentIds[0]);
+		writeCommentAnchorIds(element, run.commentIds);
 	}
 	if (run.isInsertion) {
 		const authorIdx = getAuthorColorIdx(run.changeAuthor ?? "");
@@ -492,6 +509,7 @@ function renderInlineImageRun(run, doc) {
 		img.style.transform = run.transform;
 		img.style.transformOrigin = "center center";
 	}
+	applyImageColorAttrs(img, run);
 	if (!hasImageCrop(run)) applyImageBorder(img, run);
 	const rotation = parseRotationDegrees(run.transform);
 	if (rotation !== 0) {
@@ -558,6 +576,7 @@ function renderBlockImage(run, doc) {
 		img.style.transform = run.transform;
 		img.style.transformOrigin = "center center";
 	}
+	applyImageColorAttrs(img, run);
 	if (!hasImageCrop(run)) applyImageBorder(img, run);
 	const rotation = parseRotationDegrees(run.transform);
 	if (rotation !== 0) {
@@ -1667,4 +1686,4 @@ function renderListMarker({ marker, inlineWidth, visualOffset, doc, formatting,
 	return span;
 }
 //#endregion
-export { PARAGRAPH_CLASS_NAMES, getLeaderChar, getRenderableTextColor, renderLine, renderParagraphFragment, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap };
+export { PARAGRAPH_CLASS_NAMES, UNICODE_BIDI_BY_WRAPPER_CONTROL, getLeaderChar, getRenderableTextColor, renderLine, renderParagraphFragment, sliceRunsForLine, splitCollapsibleLineEdgeSpaces, splitTextRunsByEastAsia, startsAfterSoftWrap };

package/dist/managers/autoSaveCodec.d.ts

@@ -1,6 +1,14 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/managers/autoSaveCodec.d.ts
-declare const AUTOSAVE_FORMAT_VERSION = 2;
+/**
+ * Version 3 renamed the model's `bidiWrapper` to `inlineWrapper` and gave it a
+ * `kind`. The codec serialises the model itself, so a version-2 envelope holds
+ * paragraph content under the old discriminator: the model validator would
+ * reject it, and a reader that did not validate would drop the wrapper. The
+ * envelope is a local draft of one editing session, so it is refused and
+ * re-taken rather than migrated.
+ */
+declare const AUTOSAVE_FORMAT_VERSION = 3;
 type DecodedAutoSave = {
   document: document_d_exports.Document;
   savedAt: string;

package/dist/managers/autoSaveCodec.js

@@ -1,7 +1,15 @@
 import { validateFolioDocumentModel } from "../docx/modelValidation.js";
 import { bytesToBase64 } from "../utils/base64.js";
 //#region src/managers/autoSaveCodec.ts
-const AUTOSAVE_FORMAT_VERSION = 2;
+/**
+* Version 3 renamed the model's `bidiWrapper` to `inlineWrapper` and gave it a
+* `kind`. The codec serialises the model itself, so a version-2 envelope holds
+* paragraph content under the old discriminator: the model validator would
+* reject it, and a reader that did not validate would drop the wrapper. The
+* envelope is a local draft of one editing session, so it is refused and
+* re-taken rather than migrated.
+*/
+const AUTOSAVE_FORMAT_VERSION = 3;
 const decodeBase64 = (value) => {
 	const binary = atob(value);
 	const bytes = new Uint8Array(binary.length);
@@ -80,20 +88,20 @@ const encodeAutoSaveDocument = (document) => {
 	};
 	return { json: JSON.stringify(encodeValue(snapshot)) };
 };
-const encodeAutoSaveEnvelopeFromDocument = (document, savedAt) => `{"document":${document.json},"savedAt":${JSON.stringify(savedAt)},"version":2}`;
+const encodeAutoSaveEnvelopeFromDocument = (document, savedAt) => `{"document":${document.json},"savedAt":${JSON.stringify(savedAt)},"version":3}`;
 const encodeAutoSaveEnvelope = (document, savedAt) => encodeAutoSaveEnvelopeFromDocument(encodeAutoSaveDocument(document), savedAt);
 const decodeAutoSaveEnvelope = (json) => {
 	try {
 		const parsed = JSON.parse(json);
 		if (typeof parsed !== "object" || !parsed || !("document" in parsed) || !("savedAt" in parsed) || !("version" in parsed)) return null;
-		if (parsed.version !== 2 || typeof parsed.savedAt !== "string" || !Number.isFinite(Date.parse(parsed.savedAt))) return null;
+		if (parsed.version !== 3 || typeof parsed.savedAt !== "string" || !Number.isFinite(Date.parse(parsed.savedAt))) return null;
 		const document = decodeValue(parsed.document);
 		if (typeof document !== "object" || !document) return null;
 		if (!validateFolioDocumentModel(document).valid) return null;
 		return {
 			document,
 			savedAt: parsed.savedAt,
-			version: 2
+			version: 3
 		};
 	} catch {
 		return null;

package/dist/markdown/renderBlock.js

@@ -71,6 +71,7 @@ function renderBlocks(ctx, pkg, blocks) {
 			}
 			break;
 		}
+		case "preservedBlock": break;
 		default: panic(`Unsupported block content in markdown: ${JSON.stringify(block)}`);
 	}
 	return out.join("\n");

package/dist/markdown/renderRuns.d.ts

@@ -5,6 +5,6 @@ import { RenderContext } from "./types.js";
  * Render the full inline content of a paragraph, tracking comment-range
  * boundaries to apply the configured wrapper.
  */
-declare function renderParagraphInline(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, content: document_d_exports.ParagraphContent[], paraId: string | undefined): string;
+declare function renderParagraphInline(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, content: readonly document_d_exports.ParagraphContent[], paraId: string | undefined): string;
 //#endregion
 export { renderParagraphInline };