@stll/folio-core 0.59.0 → 0.60.0

package/README.md

@@ -20,9 +20,18 @@ Part of [stella](https://github.com/stella/stella), an open-source legal workspa
 ## Install
 
 ```sh
-bun add @stll/folio-core
+bun add @stll/folio-core \
+  prosemirror-commands@^1.7.1 prosemirror-dropcursor@^1.8.2 prosemirror-gapcursor@^1.4.1 prosemirror-history@^1.5.0 \
+  prosemirror-inputrules@^1.5.0 prosemirror-keymap@^1.2.3 prosemirror-model@^1.25.9 prosemirror-state@^1.4.4 \
+  prosemirror-tables@^1.8.5 prosemirror-transform@^1.12.0 prosemirror-view@^1.42.6 y-prosemirror@^1.3.7 \
+  y-protocols@^1.0.6 yjs@^13.6.31
 ```
 
+ProseMirror and Yjs packages are required peers, including the collaboration
+packages `y-prosemirror` and `y-protocols`. Install one compatible copy of each in the host
+application so schemas, plugins, editor states, and collaborative documents share
+the same runtime. The command above includes the complete editor peer closure.
+
 ## Exports
 
 | Import                      | What it is                                                                                                                                                         |

package/dist/compat/eigenpal.d.ts

@@ -37,9 +37,9 @@ import { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult } from "../markdow
 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 { getGoogleFontsEnabled, 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, DEFAULT_OUTLINE_DEPTH, 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 FolioAIDiagnosticBlock, 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 FolioAIParagraphBlock, 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 FolioContentStatedNumbering, 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 FolioUndefinedReferencePolicy, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type OutlineDepth, 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, filterHeadingsByDepth, 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, DEFAULT_OUTLINE_DEPTH, 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 FolioAIDiagnosticBlock, 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 FolioAIParagraphBlock, 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 FolioContentStatedNumbering, 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 FolioUndefinedReferencePolicy, type FolioWordDiffOptions, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type OutlineDepth, 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, filterHeadingsByDepth, 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, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/compat/eigenpal.js

@@ -32,7 +32,7 @@ import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaSty
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "../style-sets/types.js";
 import { currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
 import { createEmptyDocument } from "../utils/createDocument.js";
-import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
+import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
 import { DEFAULT_OUTLINE_DEPTH, filterHeadingsByDepth } from "../utils/outlineDepth.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, DEFAULT_OUTLINE_DEPTH, 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, filterHeadingsByDepth, 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, DEFAULT_OUTLINE_DEPTH, 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, filterHeadingsByDepth, 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, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/controller/canonicalSession.js

@@ -1,7 +1,7 @@
 import { splitsGraphemeCluster, splitsSurrogatePair } from "../ai-edits/character-boundaries.js";
 import { rangedCommentIds, visitCommentMarkers } from "../docx/commentAnchorIndex.js";
 import { cloneDocumentWithParagraphPropertySources, copyDocumentParagraphPropertySourceContract, copyParagraphPropertySource, restoreParagraphIndentationProjection } from "../docx/paragraphPropertySource.js";
-import { canonicalSelectionRange } from "../prosemirror/canonicalSelectionRange.js";
+import { canonicalContentPosition, canonicalSelectionRange } from "../prosemirror/canonicalSelectionRange.js";
 import { collectPairedBookmarkIds, footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { markPackageChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { runFormattingPatchFromMarks } from "../prosemirror/runFormattingFromMarks.js";
@@ -147,6 +147,7 @@ var CanonicalProjection = class {
 	}
 	addressAt(position) {
 		if (!Number.isInteger(position)) return refuse("The input position is not an integer.");
+		position = canonicalContentPosition(this.doc, position);
 		const paragraph = this.paragraphs.find(({ start, node }) => position >= start && position <= start + node.content.size);
 		if (paragraph === void 0) return refuse("The input is outside a plain paragraph.");
 		const relative = position - paragraph.start;
@@ -169,7 +170,7 @@ var CanonicalProjection = class {
 		if (paragraph === void 0) panic("Input lost its paragraph.");
 		let destination = position;
 		paragraph.node.forEach((node, start) => {
-			if (node.marks.some((mark) => mark.type.name === "deletion") && position > paragraph.start + start && position < paragraph.start + start + node.nodeSize) destination = paragraph.start + start + node.nodeSize;
+			if (node.marks.some((mark) => mark.type.name === "deletion") && destination >= paragraph.start + start && destination < paragraph.start + start + node.nodeSize) destination = paragraph.start + start + node.nodeSize;
 		});
 		return destination === position ? address : this.addressAt(destination);
 	}

package/dist/controller/canonicalStructure.js

@@ -5,9 +5,9 @@ import { effectiveParagraphNumbering, paragraphNumberingSourcesFromBoundary } fr
 import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { collectHeadings } from "../utils/headingCollector.js";
 import { CanonicalSessionError } from "./canonicalSession.js";
-import { Result } from "better-result";
+import { Result, panic } from "better-result";
 import { headingOutlineLevel, paragraphNumberingReference } from "@stll/docx-core/model";
-import { OP_STORIES } from "@stll/docx-core/ops";
+import { OP_STORIES, editorParagraphGroups, editorPositionAtPhysicalPosition, physicalPositionAtEditorOffset } from "@stll/docx-core/ops";
 //#region src/controller/canonicalStructure.ts
 const DEFAULT_TOC_PAGE_WIDTH_TWIPS = 12240;
 const DEFAULT_TOC_MARGIN_TWIPS = 1440;
@@ -322,17 +322,20 @@ const prepareCanonicalAutoformat = (session, state, { from, to, text }) => {
 	if (text !== " " || from !== to) return void 0;
 	const at = session.projection.addressAt(from);
 	if (at.isErr()) return void 0;
-	const address = session.projection.paragraph(at.value.blockId);
+	const logical = editorPositionAtPhysicalPosition(session.document, at.value);
+	const address = session.projection.paragraph(logical.blockId);
 	if (address === void 0 || effectiveNumbering(address.source)?.kind === "reference") return void 0;
+	const group = editorParagraphGroups(session.document, logical.story).find(({ blockId }) => blockId === logical.blockId);
+	if (group === void 0) panic("Autoformat lost its logical paragraph");
 	const source = address.source;
-	const prefix = address.text.slice(0, at.value.offset) + text;
+	const prefix = group.text.slice(0, logical.offset) + text;
 	const requests = listRequestsForMarker(prefix);
 	const heading = /^(?<hashes>#{1,6}) $/u.exec(prefix)?.groups?.["hashes"];
 	if (requests === null && heading === void 0) return void 0;
-	const start = {
-		...at.value,
+	const start = physicalPositionAtEditorOffset(session.document, {
+		...logical,
 		offset: 0
-	};
+	});
 	const request = requests?.at(0);
 	const styleId = `Heading${heading?.length ?? 1}`;
 	if (request === void 0 && !session.hasStyle(styleId)) return void 0;

package/dist/controller/fontReadiness.js

@@ -227,7 +227,7 @@ function addLayoutFontFamilyNameFace(faces, family, descriptor, fontAlternates)
 * the painter and the measurer put in `ctx.font` and `style.fontFamily`.
 */
 function resolvedStackFamilies(family, alternate) {
-	const { cssFallback } = resolveFontFamily(family, alternate);
+	const { cssFallback } = resolveFontFamily(family, { alternateFontName: alternate });
 	return parseFontFamilyList(cssFallback).filter((name) => !CSS_GENERIC_FONT_FAMILIES.has(name));
 }
 function addLayoutFontFace(faces, family, descriptor) {

package/dist/controller/layoutPipeline.js

@@ -42,7 +42,7 @@ const formatEndnoteTexts = (numbers, formatNumber) => {
 	for (const [id, displayNumber] of numbers) texts.set(id, formatNumber(displayNumber));
 	return texts;
 };
-const sameMeasureInputs = (left, right) => left.styles === right.styles && left.theme === right.theme && left.defaultTabStop === right.defaultTabStop && left.pageContentHeight === right.pageContentHeight && left.fontSet === right.fontSet && left.fontAlternates.size === right.fontAlternates.size && [...left.fontAlternates].every(([name, alternate]) => right.fontAlternates.get(name) === alternate) && left.markupView === right.markupView;
+const sameMeasureInputs = (left, right) => left.embeddedFontFamilyMap === right.embeddedFontFamilyMap && left.styles === right.styles && left.theme === right.theme && left.defaultTabStop === right.defaultTabStop && left.pageContentHeight === right.pageContentHeight && left.fontSet === right.fontSet && left.fontAlternates.size === right.fontAlternates.size && [...left.fontAlternates].every(([name, alternate]) => right.fontAlternates.get(name) === alternate) && left.markupView === right.markupView;
 /**
 * The range an incremental pass re-measures, or `null` for a full measure: the
 * committed measures must come from the same measure inputs, and the range is
@@ -154,7 +154,9 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		let phaseStartedAt = performance.now();
 		const pageContentHeight = pageSize.h - margins.top - margins.bottom;
 		const fontAlternates = buildFontAlternates(document?.package.fontTable);
+		const embeddedFontFamilies = session.embeddedFontFamilyMap ? { embeddedFontFamilyMap: session.embeddedFontFamilyMap } : {};
 		const measureInputs = {
+			...embeddedFontFamilies,
 			styles,
 			theme: _theme,
 			defaultTabStop,
@@ -164,6 +166,7 @@ function runLayoutPipelineMeasured(deps, state, options) {
 			markupView
 		};
 		const flowOpts = {
+			...embeddedFontFamilies,
 			pageContentHeight,
 			fontAlternates,
 			...styles ? { styles } : {},
@@ -248,6 +251,7 @@ function runLayoutPipelineMeasured(deps, state, options) {
 				...flowOpts.defaultSize === void 0 ? {} : { defaultSize: flowOpts.defaultSize },
 				..._theme !== void 0 ? { theme: _theme } : {},
 				fontAlternates,
+				...embeddedFontFamilies,
 				measureBlocks: hfMeasureBlocks,
 				...defaultTabStop !== void 0 ? { defaultTabStopTwips: defaultTabStop } : {},
 				...flowOpts.lineBreakRules ? { lineBreakRules: flowOpts.lineBreakRules } : {},
@@ -380,6 +384,7 @@ function runLayoutPipelineMeasured(deps, state, options) {
 			if (_theme !== void 0) noteOptions.theme = _theme;
 			if (document?.package.numbering !== void 0) noteOptions.numbering = document.package.numbering;
 			noteOptions.fontAlternates = fontAlternates;
+			if (session.embeddedFontFamilyMap) noteOptions.embeddedFontFamilyMap = session.embeddedFontFamilyMap;
 			if (defaultTabStop !== void 0) noteOptions.defaultTabStopTwips = defaultTabStop;
 			if (flowOpts.lineBreakRules) noteOptions.lineBreakRules = flowOpts.lineBreakRules;
 			if (flowOpts.justificationCompatibility) noteOptions.justificationCompatibility = flowOpts.justificationCompatibility;
@@ -579,6 +584,7 @@ function runLayoutPipelineMeasured(deps, state, options) {
 			outcome.blockLookup = blockLookup;
 			const footnotesByPage = hasFootnotes ? buildFootnoteRenderItems(pageFootnoteMap, footnoteContentMap, document) : void 0;
 			const renderOpts = {
+				...embeddedFontFamilies,
 				pageGap,
 				showShadow: true,
 				blockLookup,

package/dist/controller/layoutSession.d.ts

@@ -23,6 +23,7 @@ type LayoutTemplatePreview = {
  * that changes how text measures brings new styles or font alternates.
  */
 type LayoutMeasureInputs = {
+  embeddedFontFamilyMap?: ReadonlyMap<string, string>;
   styles: document_d_exports.StyleDefinitions | null | undefined;
   theme: document_d_exports.Theme | null | undefined;
   defaultTabStop: number | undefined;
@@ -37,6 +38,7 @@ type LayoutMeasureInputs = {
   markupView: DisplayMode;
 };
 type LayoutSession = {
+  embeddedFontFamilyMap?: ReadonlyMap<string, string>;
   artifacts: LayoutArtifacts | null;
   lastEditorState: EditorState | null;
   lastPmDoc: EditorState["doc"] | null;

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

@@ -1,6 +1,6 @@
 import { ptToPx } from "../../layout-engine/measure/measureHelpers.js";
 import { getFontMetrics } from "../../layout-engine/measure/measureProvider.js";
-import { resolveFontFamily } from "../../utils/fontResolver.js";
+import { parseFontFamilyList, resolveFontFamily } from "../../utils/fontResolver.js";
 //#region src/display-list/build/fontTable.ts
 const CSS_NORMAL_WEIGHT = 400;
 const CSS_BOLD_WEIGHT = 700;
@@ -12,7 +12,6 @@ const GENERIC_FAMILIES = {
 	fantasy: "fantasy"
 };
 const DEFAULT_GENERIC = "sans-serif";
-const splitFallbackStack = (cssFallback) => cssFallback.split(",").map((entry) => entry.trim().replace(/^["']|["']$/gu, ""));
 /**
 * The category `resolveFontFamily` chose. It is the last CSS generic in the
 * stack it built, which is where `detectFontCategory` puts it; reading it back
@@ -30,8 +29,8 @@ const faceKey = (family, weight, italic) => `${family.toLowerCase()} ${weight} $
 * Package faces keyed by every family name a run can resolve to.
 *
 * `resolveFontFamily` substitutes the scoped `folio-embedded-{nonce}-{name}`
-* family only while the document's embedded-family map is installed; a build
-* that never installed it resolves the same run to the authored name. Both
+* family when the run carries its document-owned embedded-family map; a build
+* without that context resolves the same run to the authored name. Both
 * names therefore key the same face, and the bytes are interned by id so one
 * face's binary appears once however many names reach it.
 */
@@ -64,7 +63,10 @@ var FontTable = class {
 		this.embeddedByKey = indexEmbeddedFonts(embeddedFonts);
 	}
 	intern({ fontFamily, alternateFontFamily, bold, italic, measureStyle }) {
-		const stack = splitFallbackStack(resolveFontFamily(fontFamily, alternateFontFamily).cssFallback);
+		const stack = parseFontFamilyList(resolveFontFamily(fontFamily, {
+			alternateFontName: alternateFontFamily,
+			embeddedFontFamilyMap: measureStyle.embeddedFontFamilyMap
+		}).cssFallback);
 		const family = stack.at(0) ?? fontFamily;
 		const weight = bold ? CSS_BOLD_WEIGHT : CSS_NORMAL_WEIGHT;
 		const isItalic = italic === true;

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

@@ -12,6 +12,7 @@ import { PageComposer } from "./regions.js";
  * caller's `documentFeatures` shows the document had one.
  */
 type PageFurnitureInputs = {
+  embeddedFontFamilyMap?: ReadonlyMap<string, string>;
   /**
    * `w:pgBorders` for the section. Absent: no border is painted, and the gap is
    * reported unless `documentFeatures` says the document has none.

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

@@ -61,6 +61,7 @@ const paintPageFurniture = ({ page, furniture, context }) => {
 	const watermark = !suppliesWatermark(furniture) || selected.watermark === void 0 ? [] : paintWatermark({
 		page,
 		watermark: selected.watermark,
+		...furniture.embeddedFontFamilyMap ? { embeddedFontFamilyMap: furniture.embeddedFontFamilyMap } : {},
 		...furniture.watermarkImageSrc === void 0 ? {} : { imageSrc: furniture.watermarkImageSrc },
 		context
 	});

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

@@ -4,12 +4,13 @@ import { DisplayPrimitive } from "../types.js";
 import { BuildContext } from "./buildContext.js";
 //#region src/display-list/build/watermarkPrimitives.d.ts
 type WatermarkPaintOptions = {
+  embeddedFontFamilyMap?: ReadonlyMap<string, string> | undefined;
   readonly page: Page;
   readonly watermark: document_d_exports.Watermark;
   /** Resolved `data:` source for a picture watermark; absent means unresolved. */
   readonly imageSrc?: string;
   readonly context: BuildContext;
 };
-declare const paintWatermark: ({ page, watermark, imageSrc, context }: WatermarkPaintOptions) => readonly DisplayPrimitive[];
+declare const paintWatermark: ({ page, watermark, imageSrc, context, embeddedFontFamilyMap }: WatermarkPaintOptions) => readonly DisplayPrimitive[];
 //#endregion
 export { WatermarkPaintOptions, paintWatermark };

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

@@ -29,9 +29,10 @@ const TEXT_DEFAULT_OPACITY = .5;
 const TEXT_DIAGONAL_DEGREES = -45;
 const PICTURE_NATIVE_SCALE = 1;
 const PICTURE_WASHOUT_OPACITY = .18;
-const paintTextWatermark = (watermark, page, context) => {
+const paintTextWatermark = ({ watermark, page, context, embeddedFontFamilyMap }) => {
 	if (watermark.text.length === 0) return [];
 	const style = {
+		...embeddedFontFamilyMap ? { embeddedFontFamilyMap } : {},
 		fontFamily: watermark.font ?? TEXT_DEFAULT_FONT,
 		fontSize: pxToPt(TEXT_FONT_SIZE_PX),
 		bold: true
@@ -129,9 +130,14 @@ const paintPictureWatermark = (watermark, page, imageSrc, context) => {
 		opacity: watermark.washout === false ? 1 : PICTURE_WASHOUT_OPACITY
 	}];
 };
-const paintWatermark = ({ page, watermark, imageSrc, context }) => {
+const paintWatermark = ({ page, watermark, imageSrc, context, embeddedFontFamilyMap }) => {
 	switch (watermark.kind) {
-		case "text": return paintTextWatermark(watermark, page, context);
+		case "text": return paintTextWatermark({
+			watermark,
+			page,
+			context,
+			embeddedFontFamilyMap
+		});
 		case "picture": return paintPictureWatermark(watermark, page, imageSrc, context);
 		default: return [];
 	}

package/dist/display-list/editor/pageRenderer.js

@@ -17,6 +17,7 @@ const isPageRendererName = (value) => value === PAGE_RENDERER.legacy || value ==
 * which header a page carries.
 */
 const displayListFurnitureFrom = (options) => ({
+	...options.embeddedFontFamilyMap ? { embeddedFontFamilyMap: options.embeddedFontFamilyMap } : {},
 	...options.pageBorders === void 0 ? {} : { pageBorders: options.pageBorders },
 	...options.theme === void 0 ? {} : { theme: options.theme },
 	...options.watermark === void 0 ? {} : { watermark: options.watermark },

package/dist/docx/bookmarkIdNormalization.d.ts

@@ -0,0 +1,10 @@
+//#region src/docx/bookmarkIdNormalization.d.ts
+/**
+ * Give repeated bookmark ranges independent identities before editor pairing.
+ * The first range keeps its id. Ends close starts in encounter order, including
+ * overlapping ambiguous ranges. Only colliding ids are repaired: those require
+ * unique XML ids for a valid save. Every other source byte stays verbatim.
+ */
+declare const normalizeBookmarkIdsInXmlParts: (parts: ReadonlyMap<string, string>) => ReadonlyMap<string, string>;
+//#endregion
+export { normalizeBookmarkIdsInXmlParts };

package/dist/docx/bookmarkIdNormalization.js

@@ -0,0 +1,100 @@
+import { scanSelectedStreamingXmlElements } from "./selectedXmlIdentityScan.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findAttributeByNamespaceUri, getLocalName, getNamespaceUri } from "./xmlParser.js";
+import { panic } from "better-result";
+//#region src/docx/bookmarkIdNormalization.ts
+const bookmarkIdentity = (element) => {
+	if (!WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "")) return null;
+	const name = getLocalName(element.name);
+	if (name !== "bookmarkStart" && name !== "bookmarkEnd") return null;
+	const attribute = findAttributeByNamespaceUri(element, WORDPROCESSINGML_NAMESPACE_URIS, "id");
+	if (!attribute) return null;
+	const id = Number(attribute.value);
+	if (!Number.isSafeInteger(id) || id < 0) return null;
+	return {
+		name,
+		attribute: attribute.name,
+		id
+	};
+};
+/**
+* Give repeated bookmark ranges independent identities before editor pairing.
+* The first range keeps its id. Ends close starts in encounter order, including
+* overlapping ambiguous ranges. Only colliding ids are repaired: those require
+* unique XML ids for a valid save. Every other source byte stays verbatim.
+*/
+const normalizeBookmarkIdsInXmlParts = (parts) => {
+	const candidates = [...parts].filter(([, xml]) => /bookmark(?:Start|End)/u.test(xml));
+	const reserved = /* @__PURE__ */ new Set();
+	const repeated = /* @__PURE__ */ new Set();
+	const markersByPart = /* @__PURE__ */ new Map();
+	for (const [path, xml] of candidates) {
+		const starts = /* @__PURE__ */ new Set();
+		const markers = [];
+		if (scanSelectedStreamingXmlElements(xml, ({ element, attributeValueSpans }) => {
+			const marker = bookmarkIdentity(element);
+			if (!marker) return;
+			const span = attributeValueSpans.get(marker.attribute);
+			if (!span) panic("Missing bookmark identity source span");
+			markers.push({
+				marker,
+				...span
+			});
+			reserved.add(marker.id);
+			if (marker.name === "bookmarkStart") {
+				if (starts.has(marker.id)) repeated.add(path);
+				starts.add(marker.id);
+			}
+		}).status === "unsupported") {
+			repeated.delete(path);
+			continue;
+		}
+		markersByPart.set(path, markers);
+	}
+	if (repeated.size === 0) return parts;
+	let next = 0;
+	const allocate = () => {
+		while (reserved.has(next)) next += 1;
+		const id = next++;
+		reserved.add(id);
+		return id;
+	};
+	const normalized = new Map(parts);
+	for (const [path, xml] of candidates) {
+		if (!repeated.has(path)) continue;
+		const seen = /* @__PURE__ */ new Set();
+		const open = /* @__PURE__ */ new Map();
+		const chunks = [];
+		let cursor = 0;
+		for (const { marker, start, end } of markersByPart.get(path) ?? []) {
+			let id = marker.id;
+			if (marker.name === "bookmarkStart") {
+				if (seen.has(id)) id = allocate();
+				seen.add(marker.id);
+				let queue = open.get(marker.id);
+				if (!queue) {
+					queue = {
+						ids: [],
+						cursor: 0
+					};
+					open.set(marker.id, queue);
+				}
+				queue.ids.push(id);
+			} else {
+				const queue = open.get(marker.id);
+				const paired = queue?.ids.at(queue.cursor);
+				if (paired !== void 0 && queue) {
+					id = paired;
+					queue.cursor += 1;
+				}
+			}
+			if (id === marker.id) continue;
+			chunks.push(xml.slice(cursor, start), String(id));
+			cursor = end;
+		}
+		chunks.push(xml.slice(cursor));
+		normalized.set(path, chunks.join(""));
+	}
+	return normalized;
+};
+//#endregion
+export { normalizeBookmarkIdsInXmlParts };

package/dist/docx/bookmarkParser.js

@@ -31,8 +31,10 @@ function createBookmarkMap() {
 * @param bookmark - The bookmark start to add
 */
 function addBookmark(map, bookmark) {
-	map.byId.set(bookmark.id, bookmark);
-	if (bookmark.name) map.byName.set(bookmark.name, bookmark);
+	if (!map.byId.has(bookmark.id)) map.byId.set(bookmark.id, bookmark);
+	if (bookmark.name) {
+		if (!map.byName.has(bookmark.name)) map.byName.set(bookmark.name, bookmark);
+	}
 	map.bookmarks.push(bookmark);
 }
 /**

package/dist/docx/importedIdCollisions.d.ts

@@ -0,0 +1,136 @@
+import { ParseContext } from "./parseContext.js";
+//#region src/docx/importedIdCollisions.d.ts
+/** Definition sites only: paired markers and references never claim an identity. */
+declare const IMPORTED_ID_COLLISION_REGISTRY: {
+  readonly bookmark: {
+    readonly kind: "bookmark";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly comment: {
+    readonly kind: "comment";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly footnote: {
+    readonly kind: "footnote";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly endnote: {
+    readonly kind: "endnote";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly revision: {
+    readonly kind: "revision";
+    readonly scope: "package";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly paraId: {
+    readonly kind: "paraId";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }, {
+      readonly namespace: "http://schemas.microsoft.com/office/word/2012/wordml";
+      readonly elements: Set<string>;
+    }, {
+      readonly namespace: string;
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "paraId";
+    readonly attributeNamespace: "http://schemas.microsoft.com/office/word/2010/wordml";
+    readonly encoding: "hex";
+  };
+  readonly textId: {
+    readonly kind: "textId";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "textId";
+    readonly attributeNamespace: "http://schemas.microsoft.com/office/word/2010/wordml";
+    readonly encoding: "hex";
+  };
+  readonly numId: {
+    readonly kind: "numId";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "numId";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly abstractNumId: {
+    readonly kind: "abstractNumId";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "abstractNumId";
+    readonly attributeNamespace: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly encoding: "decimal";
+  };
+  readonly drawing: {
+    readonly kind: "drawing";
+    readonly scope: "package";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "id";
+    readonly attributeNamespace: null;
+    readonly encoding: "decimal";
+  };
+  readonly relationship: {
+    readonly kind: "relationship";
+    readonly scope: "part";
+    readonly sites: readonly [{
+      readonly namespace: "http://schemas.openxmlformats.org/package/2006/relationships";
+      readonly elements: Set<string>;
+    }];
+    readonly attribute: "Id";
+    readonly attributeNamespace: null;
+    readonly encoding: "string";
+  };
+};
+/** Reports repeated source definitions without changing the package or choosing a winner. */
+declare const diagnoseImportedIdCollisions: (parts: ReadonlyMap<string, string>, context: ParseContext) => void;
+//#endregion
+export { IMPORTED_ID_COLLISION_REGISTRY, diagnoseImportedIdCollisions };