@stll/folio-core 0.15.1 → 0.15.3

package/dist/ai-edits/apply.js

@@ -5,10 +5,10 @@ import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { buildCleanBlockText } from "./clean-text.js";
 import { hasInlineEmphasis, parseInlineEmphasisRuns, stripInlineEmphasisMarkers } from "./inline-emphasis.js";
 import { hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
-import { planTableMutations } from "./table-mutation-plan.js";
-import { findEnclosingTableBoundary, findEnclosingTableCell, findEnclosingTableRow, tableRectangleCutsMergedCell } from "./table-targets.js";
 import { mergeTableRectangle, mergeTrackedVerticalTableCells, splitTableRectangle, splitTrackedVerticalTableCell } from "./table-cell-mutations.js";
+import { planTableMutations } from "./table-mutation-plan.js";
 import { applyTableColumnDeletion, applyTableColumnInsertion, applyTableRowDeletion, applyTableRowInsertion, findTableColumnInsertion, findTableRowInsertion, getTableColumnCoordinateKey } from "./table-row-column-mutations.js";
+import { findEnclosingTableBoundary, findEnclosingTableCell, findEnclosingTableRow, tableRectangleCutsMergedCell } from "./table-targets.js";
 import { diffWordSegments } from "./word-diff.js";
 import { TableMap } from "prosemirror-tables";
 //#region src/ai-edits/apply.ts

package/dist/ai-edits/blockRange.js

@@ -1,7 +1,7 @@
+import { findParagraphByParaId } from "../prosemirror/utils/findParagraphByParaId.js";
 import { getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex } from "../types/block-id.js";
 import { buildCleanBlockText } from "./clean-text.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText } from "./snapshot.js";
-import { findParagraphByParaId } from "../prosemirror/utils/findParagraphByParaId.js";
 //#region src/ai-edits/blockRange.ts
 const resolveFolioAIBlockRange = ({ blockId, doc, snapshot }) => {
 	const paraId = getFolioParaIdFromBlockId(blockId);

package/dist/ai-edits/headless.js

@@ -1,19 +1,19 @@
-import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
-import { deterministicHexId } from "../utils/hexId.js";
-import { schema, singletonManager } from "../prosemirror/schema/index.js";
-import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
-import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
-import { buildAnnotatedBlockText } from "./clean-text.js";
-import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { getHeaderFooterText } from "../docx/headerFooterParser.js";
 import { parseDocx } from "../docx/parser.js";
-import { repackDocx } from "../docx/rezip.js";
-import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createReply } from "../docx/replyToComment.js";
+import { repackDocx } from "../docx/rezip.js";
 import { attemptSelectiveSave } from "../docx/selectiveSave.js";
 import { acceptAIEditRevision, acceptAllChanges, rejectAIEditRevision, rejectAllChanges } from "../prosemirror/commands/comments.js";
+import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
+import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
+import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
+import { schema, singletonManager } from "../prosemirror/schema/index.js";
+import { deterministicHexId } from "../utils/hexId.js";
+import { buildAnnotatedBlockText } from "./clean-text.js";
+import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
+import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { TaggedError } from "better-result";
 import { EditorState } from "prosemirror-state";
 //#region src/ai-edits/headless.ts

package/dist/ai-edits/index.js

@@ -1,11 +1,11 @@
+import { 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, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-import { buildAnnotatedBlockText } from "./clean-text.js";
-import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
-import { diffWordSegments } from "./word-diff.js";
 import { applyFolioAIEditOperations } from "./apply.js";
-import { 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, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
+import { buildAnnotatedBlockText } from "./clean-text.js";
+import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
-import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
+import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
+import { diffWordSegments } from "./word-diff.js";
 export { 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_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/read.js

@@ -1,6 +1,6 @@
 import { expectRunPropertyChangeMarkAttrs } from "../prosemirror/attrs/index.js";
-import { createFolioAIEditSnapshot } from "./snapshot.js";
 import { getTableCellMergeChange } from "../prosemirror/tableCellMergeRevision.js";
+import { createFolioAIEditSnapshot } from "./snapshot.js";
 //#region src/ai-edits/read.ts
 /** Map each snapshot block's start position to its stable id. */
 const blockStartIdsFromDoc = (doc) => {

package/dist/ai-edits/table-cell-mutations.js

@@ -1,7 +1,7 @@
 import { expectTableCellAttrs } from "../prosemirror/attrs/index.js";
-import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
-import { standaloneTableCellToProseMirror } from "../prosemirror/conversion/toProseDoc.js";
 import { standaloneTableCellFromProseMirror } from "../prosemirror/conversion/fromProseDoc.js";
+import { standaloneTableCellToProseMirror } from "../prosemirror/conversion/toProseDoc.js";
+import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { tableRectanglesEqual } from "./table-mutation-plan.js";
 import { tableRectangleCutsMergedCell } from "./table-targets.js";
 import { Result } from "better-result";

package/dist/compat/eigenpal.js

@@ -1,31 +1,31 @@
-import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
-import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
+import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
 import { diffWordSegments } from "../ai-edits/word-diff.js";
-import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
+import { applySuggestions } from "../ai-suggestions/apply.js";
+import { isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
+import { buildPositionalText } from "../ai-suggestions/text-positions.js";
+import { DEFAULT_AI_SUGGESTION_PRESETS } from "../ai-suggestions/types.js";
 import { 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, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
-import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "../style-sets/types.js";
-import { createEmptyDocument } from "../utils/createDocument.js";
-import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
-import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "../style-sets/extract.js";
-import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "../style-sets/stellaStyle.js";
-import { createDocx } from "../docx/rezip.js";
 import { inspectDocxCompatibility } from "../docx/compatibility.js";
-import { DEFAULT_AI_SUGGESTION_PRESETS } from "../ai-suggestions/types.js";
-import { buildPositionalText } from "../ai-suggestions/text-positions.js";
-import { isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
-import { applySuggestions } from "../ai-suggestions/apply.js";
-import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
+import { createDocx } from "../docx/rezip.js";
+import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "../fonts/embeddedFonts.js";
+import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
+import { fromMarkdown } from "../markdown/fromMarkdown.js";
+import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
 import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "../paged-layout/selectionViewportRect.js";
 import { createAICitationDecorationsPlugin, setAICitationsMeta, setActiveCitationMeta } from "../prosemirror/plugins/aiCitationDecorations.js";
+import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { anonymizationDecorationsKey, getAnonymizationMatches, setAnonymizationTermsMeta } from "../prosemirror/plugins/anonymizationDecorations.js";
+import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "../prosemirror/plugins/autocompleteSuggestion.js";
 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 { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "../prosemirror/plugins/autocompleteSuggestion.js";
-import { fromMarkdown } from "../markdown/fromMarkdown.js";
-import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
-import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "../fonts/embeddedFonts.js";
-import { DOCX_CONFORMANCE_CLASSES } from "../index.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";
+import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
+import { createEmptyDocument } from "../utils/createDocument.js";
+import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
+import { mergeDocumentContent } from "../utils/mergeDocumentContent.js";
 export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, 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, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/content-controls/mutateContentControls.js

@@ -1,5 +1,5 @@
-import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "./errors.js";
 import { formatDate } from "../docx/fieldParser.js";
+import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "./errors.js";
 //#region src/content-controls/mutateContentControls.ts
 /**
 * Pure (immutable) write helpers for block-level content controls.

package/dist/controller/contentControlWidgetController.js

@@ -1,5 +1,5 @@
-import { CONTENT_CONTROL_WIDGET_EVENT_NAME, dispatchDatePick, dispatchDropdownPick, handleContentControlWidgetClick } from "../prosemirror/plugins/contentControlWidgets.js";
 import { Subscribable } from "../managers/Subscribable.js";
+import { CONTENT_CONTROL_WIDGET_EVENT_NAME, dispatchDatePick, dispatchDropdownPick, handleContentControlWidgetClick } from "../prosemirror/plugins/contentControlWidgets.js";
 //#region src/controller/contentControlWidgetController.ts
 const CLOSED_SNAPSHOT = { status: "closed" };
 const PICKER_GAP_PX = 4;

package/dist/controller/headerFooterEditorManager.js

@@ -1,12 +1,12 @@
+import { clearHeaderFooterVerbatimXml } from "../docx/headerFooterVerbatim.js";
+import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
+import { headerFooterToProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { ExtensionManager } from "../prosemirror/extensions/ExtensionManager.js";
+import { createStarterKit } from "../prosemirror/extensions/StarterKit.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
-import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdAllocatorExtension.js";
-import { createStarterKit } from "../prosemirror/extensions/StarterKit.js";
+import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
-import { headerFooterToProseDoc } from "../prosemirror/conversion/toProseDoc.js";
-import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
-import { clearHeaderFooterVerbatimXml } from "../docx/headerFooterVerbatim.js";
 import { EditorState } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/controller/headerFooterEditorManager.ts

package/dist/controller/hiddenEditorManager.js

@@ -1,12 +1,12 @@
+import { recordHiddenEditorPhase, recordHiddenEditorStateCreate } from "../layout-engine/layoutInstrumentation.js";
+import { suppressHiddenEditorScrollToSelection } from "../paged-layout/hiddenEditorScroll.js";
+import { isReadOnlyEditKey } from "../paged-layout/readOnlyEditAttempt.js";
+import { createEmptyDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
-import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { ensureParaIdsInDoc, ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdAllocatorExtension.js";
+import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
-import { createEmptyDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { createHiddenEditorApi } from "./hiddenEditorApi.js";
-import { recordHiddenEditorPhase, recordHiddenEditorStateCreate } from "../layout-engine/layoutInstrumentation.js";
-import { suppressHiddenEditorScrollToSelection } from "../paged-layout/hiddenEditorScroll.js";
-import { isReadOnlyEditKey } from "../paged-layout/readOnlyEditAttempt.js";
 import { panic } from "better-result";
 import { EditorState } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";

package/dist/controller/layoutPipeline.js

@@ -1,26 +1,26 @@
-import { getDocumentWatermark } from "../watermark/index.js";
-import "../layout-engine/types.js";
-import { resolveEffectiveParagraphSpacingTree } from "../layout-engine/paragraphSpacing.js";
-import { renderPages } from "../layout-painter/renderPage.js";
-import { templatePreviewValuesKey } from "../prosemirror/plugins/templatePreviewValues.js";
 import { resolveDocumentGridLinePitch } from "../docx/documentGrid.js";
-import { getMargins, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
-import { getColumns } from "../layout-bridge/sectionColumns.js";
-import { toFlowBlocks } from "../layout-bridge/convert/toFlowBlocks.js";
-import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart } from "../layout-engine/layoutInstrumentation.js";
 import { buildBookmarkPageMap } from "../fields/bookmarkPages.js";
 import { buildBookmarkText } from "../fields/bookmarkText.js";
 import { buildHeaderFooterFieldValues, fieldValuesEqual, resolveFieldValues } from "../fields/resolveFieldValues.js";
 import { buildSectionPageCounts } from "../fields/sectionPageCounts.js";
 import { buildSeqValues } from "../fields/seqValues.js";
-import { installCanvasMeasureProvider } from "../layout-engine/measure/measureContainer.js";
 import { buildFootnoteContentMap, collectEndnoteRefs, collectFootnoteRefs, computeNoteDisplayNumbers, remapNoteMarkerText } from "../layout-bridge/convert/footnoteLayout.js";
 import { applyTemplatePreviewToBlocks } from "../layout-bridge/convert/templatePreviewFlow.js";
+import { toFlowBlocks } from "../layout-bridge/convert/toFlowBlocks.js";
+import { getColumns } from "../layout-bridge/sectionColumns.js";
 import { layoutDocument } from "../layout-engine/index.js";
 import { resolveJustificationCompatibility } from "../layout-engine/justificationCompatibility.js";
+import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart } from "../layout-engine/layoutInstrumentation.js";
 import { measureBlocks, measureSingleBlockWithoutFloatingZones } from "../layout-engine/measure/measureBlocks.js";
+import { installCanvasMeasureProvider } from "../layout-engine/measure/measureContainer.js";
+import { resolveEffectiveParagraphSpacingTree } from "../layout-engine/paragraphSpacing.js";
+import "../layout-engine/types.js";
+import { renderPages } from "../layout-painter/renderPage.js";
 import { tryBuildIncrementalMeasures } from "../paged-layout/incrementalMeasure.js";
 import { computePerBlockMeasureInputs } from "../paged-layout/sectionBlockWidths.js";
+import { getMargins, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
+import { templatePreviewValuesKey } from "../prosemirror/plugins/templatePreviewValues.js";
+import { getDocumentWatermark } from "../watermark/index.js";
 //#region src/controller/layoutPipeline.ts
 function bodyMarginsClearHeaderFooter({ authoredMargins, preparedHeader, preparedFooter }) {
 	const headerBottom = preparedHeader ? (authoredMargins.header ?? 0) + (preparedHeader.marginPushBottom ?? preparedHeader.height) : authoredMargins.top;

package/dist/controller/noteEditorManager.js

@@ -1,12 +1,12 @@
+import { isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
+import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
+import { footnoteToProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { ExtensionManager } from "../prosemirror/extensions/ExtensionManager.js";
+import { createStarterKit } from "../prosemirror/extensions/StarterKit.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
-import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdAllocatorExtension.js";
-import { createStarterKit } from "../prosemirror/extensions/StarterKit.js";
+import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
-import { footnoteToProseDoc } from "../prosemirror/conversion/toProseDoc.js";
-import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
-import { isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { EditorState } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/controller/noteEditorManager.ts

package/dist/docx/blockContentParser.js

@@ -1,12 +1,12 @@
-import { elementToXml, findChild, getChildElements, getLocalName, mergeXmlnsDeclarations } from "./xmlParser.js";
-import { padDecimal } from "./numberingParser.js";
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
-import { parseSdtProperties } from "./sdtProperties.js";
-import { parseParagraph } from "./paragraphParser.js";
 import { appendBookmarkMarkerToLastParagraphInBlocks, prependBookmarkMarkersToFirstParagraphInBlocks } from "./bookmarkPlacement.js";
 import { convertBulletToUnicode } from "./bulletMarkers.js";
+import { padDecimal } from "./numberingParser.js";
+import { parseParagraph } from "./paragraphParser.js";
 import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
+import { parseSdtProperties } from "./sdtProperties.js";
 import { parseTable } from "./tableParser.js";
+import { elementToXml, findChild, getChildElements, getLocalName, mergeXmlnsDeclarations } from "./xmlParser.js";
 //#region src/docx/blockContentParser.ts
 const toRoman = (numParam) => {
 	let num = numParam;

package/dist/docx/commentParser.js

@@ -1,6 +1,26 @@
-import { findChild, getAttribute, getChildElements, parseXml } from "./xmlParser.js";
 import { parseParagraph } from "./paragraphParser.js";
+import { parseRunProperties } from "./runParser.js";
+import { findChild, getAttribute, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
 //#region src/docx/commentParser.ts
+const DEFAULT_ANNOTATION_REFERENCE_STYLE_ID = "CommentReference";
+const normalizeAnnotationReferenceFormatting = (formatting) => {
+	if (formatting?.styleId === DEFAULT_ANNOTATION_REFERENCE_STYLE_ID && Object.keys(formatting).length === 1) return;
+	return formatting;
+};
+const normalizeFirstCommentParagraph = (paragraphElement, paragraph, theme) => {
+	const firstContentElement = getChildElements(paragraphElement).find((element) => getLocalName(element.name) !== "pPr");
+	if (!firstContentElement || getLocalName(firstContentElement.name) !== "r" || !findChild(firstContentElement, "w", "annotationRef")) return { paragraph };
+	const runProperties = findChild(firstContentElement, "w", "rPr");
+	const annotationReferenceFormatting = normalizeAnnotationReferenceFormatting(runProperties ? parseRunProperties(runProperties, theme) : void 0);
+	const firstParsedContent = paragraph.content.at(0);
+	return {
+		paragraph: firstParsedContent?.type === "run" && firstParsedContent.content.length === 0 ? {
+			...paragraph,
+			content: paragraph.content.slice(1)
+		} : paragraph,
+		...annotationReferenceFormatting !== void 0 ? { annotationReferenceFormatting } : {}
+	};
+};
 /**
 * Build a lookup from paraId → dateUtc from commentsExtensible.xml
 *
@@ -91,9 +111,16 @@ function parseComments(commentsXml, styles, theme, rels, media, commentsExtensib
 		const date = (paraId ? dateUtcByParaId.get(paraId) : void 0) ?? localDate;
 		const done = (paraId ? extendedByParaId.get(paraId) : void 0)?.done;
 		const paragraphs = [];
+		let annotationReferenceFormatting;
 		for (const contentChild of getChildElements(child)) if ((contentChild.name?.replace(/^.*:/u, "") ?? "") === "p") {
 			const paragraph = parseParagraph(contentChild, styles, theme, null, rels, media);
-			paragraphs.push(paragraph);
+			if (paragraphs.length > 0) {
+				paragraphs.push(paragraph);
+				continue;
+			}
+			const normalized = normalizeFirstCommentParagraph(contentChild, paragraph, theme);
+			annotationReferenceFormatting = normalized.annotationReferenceFormatting;
+			paragraphs.push(normalized.paragraph);
 		}
 		const commentIndex = comments.length;
 		if (paraId) {
@@ -106,6 +133,7 @@ function parseComments(commentsXml, styles, theme, rels, media, commentsExtensib
 			...initials !== void 0 ? { initials } : {},
 			...date !== void 0 ? { date } : {},
 			...done !== void 0 ? { done } : {},
+			...annotationReferenceFormatting !== void 0 ? { annotationReferenceFormatting } : {},
 			content: paragraphs
 		});
 	}

package/dist/docx/documentParser.js

@@ -1,8 +1,8 @@
-import { collectXmlnsDeclarations, findChild, parseXml } from "./xmlParser.js";
-import { getDefaultSectionProperties, parseSectionProperties } from "./sectionParser.js";
-import { getParagraphText } from "./paragraphParser.js";
 import { parseBlockContent } from "./blockContentParser.js";
+import { getParagraphText } from "./paragraphParser.js";
+import { getDefaultSectionProperties, parseSectionProperties } from "./sectionParser.js";
 import { parseStreamingXml } from "./streamingXmlParser.js";
+import { collectXmlnsDeclarations, findChild, getLocalName, parseXml } from "./xmlParser.js";
 //#region src/docx/documentParser.ts
 /**
 * Regular expression to match template variables {{...}}
@@ -86,6 +86,29 @@ function buildSections(content, finalSectPr) {
 	return sections;
 }
 /**
+* Some producers place the body-level sectPr before all content. Consumers
+* apply section properties in source order, but canonical serialization moves
+* the body-level sectPr to the end and would therefore reverse the effective
+* formats around paragraph section breaks.
+*
+* Rotate that leading property through the canonical paragraph-break slots so
+* serialization repairs the element order without changing the observed
+* section sequence.
+*/
+function canonicalizeLeadingBodySectionProperties(bodyElement, body) {
+	const firstBodyChild = bodyElement.elements?.find(({ type }) => type === "element");
+	if (getLocalName(firstBodyChild?.name) !== "sectPr" || body.finalSectionProperties === void 0) return;
+	const sectionBreakParagraphs = body.content.filter((block) => block.type === "paragraph" && block.sectionProperties !== void 0);
+	if (sectionBreakParagraphs.length === 0) return;
+	let nextProperties = body.finalSectionProperties;
+	for (const paragraph of sectionBreakParagraphs) {
+		const currentProperties = paragraph.sectionProperties;
+		paragraph.sectionProperties = nextProperties;
+		nextProperties = currentProperties;
+	}
+	body.finalSectionProperties = nextProperties;
+}
+/**
 * Parse document.xml body content
 *
 * @param xml - Raw XML content of document.xml
@@ -107,6 +130,7 @@ function parseDocumentBody(xml, styles = null, theme = null, numbering = null, r
 	result.content = parseBlockContent(bodyEl, styles, theme, numbering, rels, media, { rootXmlns: collectXmlnsDeclarations(documentEl) });
 	const finalSectPr = findChild(bodyEl, "w", "sectPr");
 	if (finalSectPr) result.finalSectionProperties = parseSectionProperties(finalSectPr);
+	canonicalizeLeadingBodySectionProperties(bodyEl, result);
 	result.sections = buildSections(result.content, result.finalSectionProperties);
 	return result;
 }

package/dist/docx/drawingIdNormalization.d.ts

@@ -0,0 +1,5 @@
+import { DocxParagraphSurfaces } from "./paragraphTraversal.js";
+//#region src/docx/drawingIdNormalization.d.ts
+declare const normalizeDrawingIds: (surfaces: DocxParagraphSurfaces) => void;
+//#endregion
+export { normalizeDrawingIds };

package/dist/docx/drawingIdNormalization.js

@@ -0,0 +1,35 @@
+import { visitDocxParagraphs, visitParagraphRuns } from "./paragraphTraversal.js";
+//#region src/docx/drawingIdNormalization.ts
+const GENERATED_DRAWING_ID_START = 1e5;
+const needsGeneratedId = ({ id }) => id === void 0 || id === "" || id === "0";
+const normalizeDrawingIds = (surfaces) => {
+	const entries = [];
+	visitDocxParagraphs(surfaces, (paragraph) => {
+		visitParagraphRuns(paragraph, (run) => {
+			for (const content of run.content) {
+				if (content.type === "shape") {
+					entries.push({
+						drawing: content.shape,
+						generateWhenMissing: true
+					});
+					continue;
+				}
+				if (content.type === "drawing") entries.push({
+					drawing: content.image,
+					generateWhenMissing: content.rawXml === void 0
+				});
+			}
+		});
+	});
+	const usedIds = new Set(entries.flatMap(({ drawing }) => needsGeneratedId(drawing) ? [] : [drawing.id]));
+	let nextId = GENERATED_DRAWING_ID_START;
+	for (const { drawing, generateWhenMissing } of entries) {
+		if (!generateWhenMissing || !needsGeneratedId(drawing)) continue;
+		while (usedIds.has(String(nextId))) nextId += 1;
+		drawing.id = String(nextId);
+		usedIds.add(drawing.id);
+		nextId += 1;
+	}
+};
+//#endregion
+export { normalizeDrawingIds };

package/dist/docx/drawingUtils.d.ts

@@ -48,7 +48,7 @@ declare function parsePositionV(posV: XmlElement | null): document_d_exports.Ima
 /**
  * Parse position for anchored drawings (combines positionH + positionV).
  */
-declare function parseAnchorPosition(anchor: XmlElement): document_d_exports.ImagePosition | undefined;
+declare function parseAnchorPosition(anchor: XmlElement): document_d_exports.ImagePosition;
 /** Known wrap element names */
 declare const WRAP_ELEMENT_NAMES: string[];
 /**