@stll/folio-core 0.62.0 → 0.63.0

package/dist/prosemirror/commands/sectionBreak.d.ts

@@ -1,5 +1,5 @@
 import { SectionBreakType } from "../sectionCarrier.js";
-import { Command } from "prosemirror-state";
+import { Command, EditorState } from "prosemirror-state";
 //#region src/prosemirror/commands/sectionBreak.d.ts
 /**
  * Run a command, keeping every section break on the paragraph whose mark
@@ -10,7 +10,9 @@ import { Command } from "prosemirror-state";
  * deleting a section-ending paragraph outright still removes its section: that
  * mark is gone, and nothing inherits it.
  */
-declare const keepSectionBreaksOnSurvivingMarks: (command: Command) => Command;
+export declare const keepSectionBreaksOnSurvivingMarks: (command: Command) => Command;
+/** Section endpoints are valid only on paragraphs directly owned by the document body. */
+export declare const sectionBreakSelectionIsTopLevel: (state: EditorState) => boolean;
 /**
  * End the selection's sections with `breakType`.
  *
@@ -20,7 +22,7 @@ declare const keepSectionBreaksOnSurvivingMarks: (command: Command) => Command;
  * stating that type alone, and inherits the rest from the section that follows
  * it.
  */
-declare const setSectionBreakType: (breakType: SectionBreakType) => Command;
+export declare const setSectionBreakType: (breakType: SectionBreakType) => Command;
 /**
  * Remove the section break the selection's paragraphs carry.
  *
@@ -31,16 +33,15 @@ declare const setSectionBreakType: (breakType: SectionBreakType) => Command;
  * to be merged into the following record, because the following record already
  * states the whole of the section it heads.
  */
-declare const removeSectionBreakAtSelection: Command;
+export declare const removeSectionBreakAtSelection: Command;
 /**
  * Insert a "next page" section break at the cursor — starts a new section on a
  * new page.
  */
-declare const insertSectionBreakNextPage: Command;
+export declare const insertSectionBreakNextPage: Command;
 /**
  * Insert a "continuous" section break at the cursor — starts a new section on
  * the same page.
  */
-declare const insertSectionBreakContinuous: Command;
-//#endregion
-export { insertSectionBreakContinuous, insertSectionBreakNextPage, keepSectionBreaksOnSurvivingMarks, removeSectionBreakAtSelection, setSectionBreakType };
+export declare const insertSectionBreakContinuous: Command;
+//#endregion

package/dist/prosemirror/commands/sectionBreak.js

@@ -100,6 +100,18 @@ const selectedParagraphs = (state) => {
 	});
 	return paragraphs;
 };
+/** Section endpoints are valid only on paragraphs directly owned by the document body. */
+const sectionBreakSelectionIsTopLevel = (state) => {
+	let found = false;
+	let topLevel = true;
+	state.doc.nodesBetween(state.selection.from, state.selection.to, (node, position) => {
+		if (node.type.name !== "paragraph") return true;
+		found = true;
+		if (state.doc.resolve(position).depth !== 0) topLevel = false;
+		return false;
+	});
+	return found && topLevel;
+};
 /**
 * Rewrite the section record of every paragraph the selection touches.
 *
@@ -113,6 +125,7 @@ const selectedParagraphs = (state) => {
 * paragraphs in one selection author two sections rather than share one.
 */
 const rewriteSelectedSectionRecords = (rewrite) => (state, dispatch) => {
+	if (!sectionBreakSelectionIsTopLevel(state)) return false;
 	const selected = selectedParagraphs(state);
 	if (selected.length === 0) return false;
 	const replacements = /* @__PURE__ */ new Map();
@@ -228,4 +241,4 @@ const insertSectionBreakNextPage = insertSectionBreakAtCursor("nextPage");
 */
 const insertSectionBreakContinuous = insertSectionBreakAtCursor("continuous");
 //#endregion
-export { insertSectionBreakContinuous, insertSectionBreakNextPage, keepSectionBreaksOnSurvivingMarks, removeSectionBreakAtSelection, setSectionBreakType };
+export { insertSectionBreakContinuous, insertSectionBreakNextPage, keepSectionBreaksOnSurvivingMarks, removeSectionBreakAtSelection, sectionBreakSelectionIsTopLevel, setSectionBreakType };

package/dist/prosemirror/commands/table.d.ts

@@ -3,38 +3,38 @@ import { BorderPreset, TableBorderPreset, TableContextInfo, getTableContext, isI
 import { TableBorderCommandSpec, TableCellBorderCommandSpec, TableCellMarginsCommand, TableStyleCommand } from "../extensions/types.js";
 import { EditorState, Transaction } from "prosemirror-state";
 //#region src/prosemirror/commands/table.d.ts
-declare function insertTable(rows: number, cols: number): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function addRowAbove(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function addRowBelow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function deleteRow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function addColumnLeft(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function addColumnRight(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function deleteColumn(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function deleteTable(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function selectTable(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function selectRow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function selectColumn(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function mergeCells(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function splitCell(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function setCellBorder(side: "top" | "bottom" | "left" | "right" | "all", spec: TableCellBorderCommandSpec | null, clearOthers?: boolean): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setTableBorderPreset(preset: TableBorderPreset): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setTableBorders(preset: BorderPreset, borderSpec?: TableBorderCommandSpec): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function removeTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
-declare function setAllTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
-declare function setOutsideTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
-declare function setInsideTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
-declare function setCellVerticalAlign(align: "top" | "center" | "bottom"): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setCellMargins(margins: TableCellMarginsCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setCellTextDirection(direction: string | null): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function toggleNoWrap(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setRowHeight(height: number | null, rule?: "auto" | "atLeast" | "exact"): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function toggleHeaderRow(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function distributeColumns(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function autoFitContents(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setTableProperties(props: TablePropertiesCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function applyTableStyle(styleData: TableStyleCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setCellFillColor(color: string | null): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setTableBorderColor(color: string): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
-declare function setTableBorderWidth(size: number): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function insertTable(rows: number, cols: number): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function addRowAbove(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function addRowBelow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function deleteRow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function addColumnLeft(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function addColumnRight(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function deleteColumn(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function deleteTable(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function selectTable(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function selectRow(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function selectColumn(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function mergeCells(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function splitCell(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function setCellBorder(side: "top" | "bottom" | "left" | "right" | "all", spec: TableCellBorderCommandSpec | null, clearOthers?: boolean): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setTableBorderPreset(preset: TableBorderPreset): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setTableBorders(preset: BorderPreset, borderSpec?: TableBorderCommandSpec): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function removeTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+export declare function setAllTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
+export declare function setOutsideTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
+export declare function setInsideTableBorders(state: EditorState, dispatch?: (tr: Transaction) => void, borderSpec?: TableBorderCommandSpec): boolean;
+export declare function setCellVerticalAlign(align: "top" | "center" | "bottom"): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setCellMargins(margins: TableCellMarginsCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setCellTextDirection(direction: string | null): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function toggleNoWrap(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setRowHeight(height: number | null, rule?: "auto" | "atLeast" | "exact"): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function toggleHeaderRow(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function distributeColumns(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function autoFitContents(): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setTableProperties(props: TablePropertiesCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function applyTableStyle(styleData: TableStyleCommand): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setCellFillColor(color: string | null): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setTableBorderColor(color: string): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
+export declare function setTableBorderWidth(size: number): (state: EditorState, dispatch?: (tr: Transaction) => void) => boolean;
 //#endregion
-export { type BorderPreset, type TableBorderPreset, type TableContextInfo, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyTableStyle, autoFitContents, deleteColumn, deleteRow, deleteTable, distributeColumns, getTableContext, insertTable, isInTableCell as isInTable, mergeCells, removeTableBorders, selectColumn, selectRow, selectTable, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setInsideTableBorders, setOutsideTableBorders, setRowHeight, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, splitCell, toggleHeaderRow, toggleNoWrap };
+export { type BorderPreset, type TableBorderPreset, type TableContextInfo, getTableContext, isInTableCell as isInTable };

package/dist/prosemirror/commands/tableCellMergeResolution.d.ts

@@ -3,18 +3,18 @@ import { DecodedTableCellParagraphSourcePayload } from "../../docx/paragraphProp
 import { Node } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
 //#region src/prosemirror/commands/tableCellMergeResolution.d.ts
-declare const tableCellContinuationPayload: (node: Node) => DecodedTableCellParagraphSourcePayload | null;
-declare const hasMatchingCollapsedTableCellMerge: (node: Node, revisionSet: Set<number> | null) => boolean;
+export declare const tableCellContinuationPayload: (node: Node) => DecodedTableCellParagraphSourcePayload | null;
+export declare const hasMatchingCollapsedTableCellMerge: (node: Node, revisionSet: Set<number> | null) => boolean;
 type ResolveVisibleTableCellMergeOptions = {
   tr: Transaction;
   cellPos: number;
   mode: "accept" | "reject";
   revisionSet: ReadonlySet<number> | null;
 };
-declare const resolveVisibleTableCellMerge: ({ tr, cellPos, mode, revisionSet }: ResolveVisibleTableCellMergeOptions) => boolean;
-declare const tableCellContinuationCells: (cell: Node, rowspan: number) => document_d_exports.TableCell[];
-declare const tableCellContinuationFromNode: (cell: Node) => document_d_exports.TableCell;
-declare const resolveCollapsedTableCellMerge: (tr: Transaction, cellPos: number, mode: "accept" | "reject", revisionSet: Set<number> | null) => boolean;
-declare const createRestoredTableCell: (origin: Node, source: document_d_exports.TableCell) => Node | null;
+export declare const resolveVisibleTableCellMerge: ({ tr, cellPos, mode, revisionSet }: ResolveVisibleTableCellMergeOptions) => boolean;
+export declare const tableCellContinuationCells: (cell: Node, rowspan: number) => document_d_exports.TableCell[];
+export declare const tableCellContinuationFromNode: (cell: Node) => document_d_exports.TableCell;
+export declare const resolveCollapsedTableCellMerge: (tr: Transaction, cellPos: number, mode: "accept" | "reject", revisionSet: Set<number> | null) => boolean;
+export declare const createRestoredTableCell: (origin: Node, source: document_d_exports.TableCell) => Node | null;
 //#endregion
-export { createRestoredTableCell, hasMatchingCollapsedTableCellMerge, resolveCollapsedTableCellMerge, resolveVisibleTableCellMerge, tableCellContinuationCells, tableCellContinuationFromNode, tableCellContinuationPayload };
+export {};

package/dist/prosemirror/commands/tableCellMergeResolution.js

@@ -195,12 +195,13 @@ const resolveCollapsedTableCellMerge = (tr, cellPos, mode, revisionSet) => {
 const createRestoredTableCell = (origin, source) => {
 	const formatting = source.formatting ? { ...source.formatting } : void 0;
 	if (formatting) delete formatting.vMerge;
-	const restored = standaloneTableCellToProseMirror({
+	const restoredSource = {
 		type: "tableCell",
 		...formatting ? { formatting } : {},
 		...source.propertyChanges ? { propertyChanges: source.propertyChanges } : {},
 		content: source.content
-	}, origin.type.name === "tableHeader" ? "tableHeader" : "tableCell");
+	};
+	const restored = standaloneTableCellToProseMirror(restoredSource, origin.type.name === "tableHeader" ? "tableHeader" : "tableCell");
 	return Result.try(() => origin.type.schema.nodeFromJSON(restored.toJSON())).unwrapOr(null);
 };
 //#endregion

package/dist/prosemirror/commands/tableMergeFoldDecisions.d.ts

@@ -6,13 +6,13 @@ type TableMergeFoldDecisionsOptions = {
   revisionSet: ReadonlySet<number> | null;
 };
 /** Resolve raw merge states without converting unrelated table revisions. */
-declare const tableMergeFoldDecisions: ({ table, mode, revisionSet }: TableMergeFoldDecisionsOptions) => {
+export declare const tableMergeFoldDecisions: ({ table, mode, revisionSet }: TableMergeFoldDecisionsOptions) => {
   folds: Map<number, boolean>;
   origins: Set<number>;
   invalid: Set<number>;
 };
 /** Persist an implicit merge origin even when reader rules retain its continuation. */
-declare const resolvedTableMergeOriginAttrs: (cell: Node) => {
+export declare const resolvedTableMergeOriginAttrs: (cell: Node) => {
   _originalFormatting: {
     vMerge: string;
     width?: import("@stll/docx-core/model").TableMeasurement;
@@ -37,7 +37,7 @@ type ResolvedVisibleTableCellMergeOptions = {
   origin: boolean;
 };
 /** A retained continuation must save the merge state the reviewer resolved. */
-declare const resolvedVisibleTableCellMergeAttrs: ({ cell, mode, origin }: ResolvedVisibleTableCellMergeOptions) => {
+export declare const resolvedVisibleTableCellMergeAttrs: ({ cell, mode, origin }: ResolvedVisibleTableCellMergeOptions) => {
   cellMarker: null;
   _originalFormatting: {
     width?: import("@stll/docx-core/model").TableMeasurement;
@@ -58,4 +58,4 @@ declare const resolvedVisibleTableCellMergeAttrs: ({ cell, mode, origin }: Resol
   _preserveVMergeRestart: boolean;
 };
 //#endregion
-export { resolvedTableMergeOriginAttrs, resolvedVisibleTableCellMergeAttrs, tableMergeFoldDecisions };
+export {};

package/dist/prosemirror/commentBoundaryOwnership.d.ts

@@ -0,0 +1,15 @@
+//#region src/prosemirror/commentBoundaryOwnership.d.ts
+export type TrackedCommentBoundary = {
+  readonly type: "start" | "end";
+  readonly commentId: number;
+  readonly owner: "revision" | "parent";
+};
+type TrackedCommentBoundaryOwnerOptions = {
+  boundaries: readonly TrackedCommentBoundary[] | null | undefined;
+  type: TrackedCommentBoundary["type"];
+  commentId: number;
+  fallback: TrackedCommentBoundary["owner"];
+};
+export declare const trackedCommentBoundaryOwner: ({ boundaries, type, commentId, fallback }: TrackedCommentBoundaryOwnerOptions) => TrackedCommentBoundary["owner"];
+//#endregion
+export {};

package/dist/prosemirror/commentBoundaryOwnership.js

@@ -0,0 +1,4 @@
+//#region src/prosemirror/commentBoundaryOwnership.ts
+const trackedCommentBoundaryOwner = ({ boundaries, type, commentId, fallback }) => boundaries?.find((boundary) => boundary.type === type && boundary.commentId === commentId)?.owner ?? fallback;
+//#endregion
+export { trackedCommentBoundaryOwner };

package/dist/prosemirror/commentIdAllocator.d.ts

@@ -2,24 +2,24 @@ import { Comment } from "../types/content.js";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/commentIdAllocator.d.ts
 /** Sentinel ID for a comment that hasn't been persisted yet (anchored to selection). */
-declare const PENDING_COMMENT_ID = -1;
+export declare const PENDING_COMMENT_ID = -1;
 declare const CommentIdSpaceExhaustedError_base: import("better-result").TaggedErrorClass<"CommentIdSpaceExhaustedError">;
-declare class CommentIdSpaceExhaustedError extends CommentIdSpaceExhaustedError_base<{
+export declare class CommentIdSpaceExhaustedError extends CommentIdSpaceExhaustedError_base<{
   message: string;
 }> {}
 /** Allocate a valid, unused comment ID in this realm. */
-declare function allocateCommentId(): number;
+export declare function allocateCommentId(): number;
 /** Reserve a loaded ID and advance past it when the upper bound permits. */
-declare function seedCommentIdAbove(id: number): void;
-type CommentIdAllocator = {
+export declare function seedCommentIdAbove(id: number): void;
+export type CommentIdAllocator = {
   /** Allocate the next unused ID. */
   next(): number;
   /** Reserve a loaded ID and seed above it when possible. */
   seedAbove(id: number): void;
 };
 /** Every handle uses the same counter, including separate editor instances. */
-declare function createCommentIdAllocator(): CommentIdAllocator;
+export declare function createCommentIdAllocator(): CommentIdAllocator;
 /** Seed from comments, replies, and the document's conservative annotation maximum. */
-declare function seedCommentAllocator(allocator: CommentIdAllocator, comments: Comment[] | undefined, view: Pick<EditorView, "state"> | null): void;
+export declare function seedCommentAllocator(allocator: CommentIdAllocator, comments: Comment[] | undefined, view: Pick<EditorView, "state"> | null): void;
 //#endregion
-export { CommentIdAllocator, CommentIdSpaceExhaustedError, PENDING_COMMENT_ID, allocateCommentId, createCommentIdAllocator, seedCommentAllocator, seedCommentIdAbove };
+export {};

package/dist/prosemirror/commentIdAllocator.js

@@ -1,3 +1,4 @@
+import { expectCommentRangeBoundaryAttrs } from "./commentRangeBoundaryAttrs.js";
 import { maxAnnotationIdInDoc, seedRevisionIdsAbove } from "./plugins/revisionIds.js";
 import { readRangeAnchorAttrs } from "./rangeAnchorAttrs.js";
 import { TaggedError } from "better-result";
@@ -55,6 +56,7 @@ function seedCommentAllocator(allocator, comments, view) {
 				const attrs = readRangeAnchorAttrs(node);
 				if (attrs.ok && attrs.value.start.type === "commentRangeStart") allocator.seedAbove(attrs.value.start.id);
 			}
+			if (node.type.name === "commentRangeBoundary") allocator.seedAbove(expectCommentRangeBoundaryAttrs(node).marker.id);
 		});
 		max = Math.max(max, maxAnnotationIdInDoc(view.state.doc));
 	}

package/dist/prosemirror/commentOps.d.ts

@@ -3,8 +3,8 @@ import { CommentIdAllocator } from "./commentIdAllocator.js";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/commentOps.d.ts
 /** Build a Comment object with a freshly-allocated ID. */
-declare function createComment(allocator: CommentIdAllocator, text: string, authorName: string, parentId?: number): Comment;
-type AddCommentOptions = {
+export declare function createComment(allocator: CommentIdAllocator, text: string, authorName: string, parentId?: number): Comment;
+export type AddCommentOptions = {
   paraId: string;
   text: string;
   author: string;
@@ -16,8 +16,8 @@ type AddCommentOptions = {
  * lacks a comment mark or the range can't be resolved. The caller owns adding
  * the comment to its own state and showing the sidebar.
  */
-declare function addCommentToRange(view: EditorView, options: AddCommentOptions, allocator: CommentIdAllocator): Comment | null;
-type ProposeChangeOptions = {
+export declare function addCommentToRange(view: EditorView, options: AddCommentOptions, allocator: CommentIdAllocator): Comment | null;
+export type ProposeChangeOptions = {
   paraId: string;
   search: string;
   replaceWith: string;
@@ -29,6 +29,5 @@ type ProposeChangeOptions = {
  * ''` means a pure deletion. Refuses to layer onto an existing tracked change.
  * Returns true when a change was dispatched, false otherwise.
  */
-declare function applyProposedChange(view: EditorView, options: ProposeChangeOptions, allocator: CommentIdAllocator): boolean;
-//#endregion
-export { AddCommentOptions, ProposeChangeOptions, addCommentToRange, applyProposedChange, createComment };
+export declare function applyProposedChange(view: EditorView, options: ProposeChangeOptions, allocator: CommentIdAllocator): boolean;
+//#endregion

package/dist/prosemirror/commentOps.js

@@ -1,32 +1,16 @@
+import { commentTextParagraph } from "../docx/commentTextParagraph.js";
 import { addTrackedDeletionMark } from "./addTrackedDeletionMark.js";
 import { findTextInPmParagraph } from "./paraText.js";
 import { findParagraphByParaId } from "./utils/findParagraphByParaId.js";
 //#region src/prosemirror/commentOps.ts
-/**
-* Comment + tracked-change (proposeChange) PM transaction builders shared by
-* the React and Vue adapters. They locate the target range, apply the mark(s),
-* dispatch, and return a result. ID allocation lives in `commentIdAllocator.ts`
-* and is injected. Adapter-specific state mutation, event emission, and sidebar
-* UI stay in each adapter.
-*/
 /** Build a Comment object with a freshly-allocated ID. */
 function createComment(allocator, text, authorName, parentId) {
 	return {
 		id: allocator.next(),
+		...parentId === void 0 && { anchorKind: "range" },
 		author: authorName,
 		date: (/* @__PURE__ */ new Date()).toISOString(),
-		content: [{
-			type: "paragraph",
-			formatting: {},
-			content: [{
-				type: "run",
-				formatting: {},
-				content: [{
-					type: "text",
-					text
-				}]
-			}]
-		}],
+		content: [commentTextParagraph(text)],
 		...parentId !== void 0 && { parentId }
 	};
 }

package/dist/prosemirror/commentRangeBoundaryAttrs.d.ts

@@ -0,0 +1,16 @@
+import { ParagraphContent } from "../types/content.js";
+import { ReadProseMirrorAttrsResult } from "../internal/prosemirrorAttrBoundary.js";
+import "./attrs/index.js";
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/commentRangeBoundaryAttrs.d.ts
+type CommentRangeBoundaryMarker = Extract<ParagraphContent, {
+  type: "commentRangeStart" | "commentRangeEnd";
+}>;
+type CommentRangeBoundaryAttrs = {
+  marker: CommentRangeBoundaryMarker;
+};
+export declare const readCommentRangeBoundaryMarker: (value: unknown) => CommentRangeBoundaryMarker | undefined;
+export declare const readCommentRangeBoundaryAttrs: (node: Node) => ReadProseMirrorAttrsResult<CommentRangeBoundaryAttrs>;
+export declare const expectCommentRangeBoundaryAttrs: (node: Node) => CommentRangeBoundaryAttrs;
+//#endregion
+export {};

package/dist/prosemirror/commentRangeBoundaryAttrs.js

@@ -0,0 +1,51 @@
+import { isDisplacedByCustomXml } from "./bookmarkBoundaryAttrs.js";
+import { panic } from "better-result";
+//#region src/prosemirror/commentRangeBoundaryAttrs.ts
+const attrsCache = /* @__PURE__ */ new WeakMap();
+const isRecord = (value) => typeof value === "object" && value !== null;
+const readCommentRangeBoundaryMarker = (value) => {
+	if (!isRecord(value)) return void 0;
+	const marker = value;
+	const type = marker["type"];
+	const id = marker["id"];
+	const displacedByCustomXml = marker["displacedByCustomXml"];
+	if (type !== "commentRangeStart" && type !== "commentRangeEnd" || typeof id !== "number" || !Number.isSafeInteger(id) || id < 0 || displacedByCustomXml !== void 0 && !isDisplacedByCustomXml(displacedByCustomXml)) return;
+	return {
+		type,
+		id,
+		...displacedByCustomXml === void 0 ? {} : { displacedByCustomXml }
+	};
+};
+const readCommentRangeBoundaryAttrs = (node) => {
+	const issues = [];
+	if (node.type.name !== "commentRangeBoundary") issues.push({
+		path: "commentRangeBoundary.type.name",
+		message: `Expected commentRangeBoundary, got ${node.type.name}.`
+	});
+	const marker = readCommentRangeBoundaryMarker(node.attrs["marker"]);
+	if (!marker) issues.push({
+		path: "commentRangeBoundary.attrs.marker",
+		message: "Expected a comment range start or end marker."
+	});
+	if (issues.length > 0 || !marker) return {
+		ok: false,
+		issues
+	};
+	return {
+		ok: true,
+		value: { marker }
+	};
+};
+const expectCommentRangeBoundaryAttrs = (node) => {
+	const cached = attrsCache.get(node);
+	if (cached) return cached;
+	const result = readCommentRangeBoundaryAttrs(node);
+	if (!result.ok) {
+		const details = result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n");
+		panic(`Invalid ProseMirror comment range boundary attrs:\n${details}`);
+	}
+	attrsCache.set(node, result.value);
+	return result.value;
+};
+//#endregion
+export { expectCommentRangeBoundaryAttrs, readCommentRangeBoundaryAttrs, readCommentRangeBoundaryMarker };

package/dist/prosemirror/commentRangeInlineAtoms.d.ts

@@ -12,11 +12,12 @@ import { Node } from "prosemirror-model";
  * stay inside its tracked-change wrapper, but it can never hold a comment on
  * its own.
  */
-type CommentRangeInlineAtomParticipation = "extends" | "inert";
+export type CommentRangeInlineAtomParticipation = "extends" | "inert";
 /** Keyed by the tracked-run atom set, which the fixed-point test binds to the schema. */
-declare const COMMENT_RANGE_INLINE_ATOM_PARTICIPATION: Readonly<{
+export declare const COMMENT_RANGE_INLINE_ATOM_PARTICIPATION: Readonly<{
   readonly bookmarkBoundary: "extends";
   readonly commentReference: "inert";
+  readonly commentRangeBoundary: "inert";
   readonly field: "extends";
   readonly hardBreak: "extends";
   readonly image: "extends";
@@ -35,6 +36,5 @@ declare const COMMENT_RANGE_INLINE_ATOM_PARTICIPATION: Readonly<{
   readonly textBoxAnchor: "extends";
 }>;
 /** Whether a node is an inline atom that must never carry or extend a comment range. */
-declare const isCommentRangeInertAtom: (node: Node) => boolean;
-//#endregion
-export { COMMENT_RANGE_INLINE_ATOM_PARTICIPATION, CommentRangeInlineAtomParticipation, isCommentRangeInertAtom };
+export declare const isCommentRangeInertAtom: (node: Node) => boolean;
+//#endregion

package/dist/prosemirror/commentRangeInlineAtoms.js

@@ -4,6 +4,7 @@ import { panic } from "better-result";
 const COMMENT_RANGE_INLINE_ATOM_PARTICIPATION = Object.freeze({
 	bookmarkBoundary: "extends",
 	commentReference: "inert",
+	commentRangeBoundary: "inert",
 	field: "extends",
 	hardBreak: "extends",
 	image: "extends",

package/dist/prosemirror/commentReferenceAttrs.d.ts

@@ -3,7 +3,6 @@ import { ReadProseMirrorAttrsResult } from "../internal/prosemirrorAttrBoundary.
 import "./attrs/index.js";
 import { Node } from "prosemirror-model";
 //#region src/prosemirror/commentReferenceAttrs.d.ts
-declare const readCommentReferenceAttrs: (node: Node) => ReadProseMirrorAttrsResult<CommentReferenceAttrs>;
-declare const expectCommentReferenceAttrs: (node: Node) => CommentReferenceAttrs;
-//#endregion
-export { expectCommentReferenceAttrs, readCommentReferenceAttrs };
+export declare const readCommentReferenceAttrs: (node: Node) => ReadProseMirrorAttrsResult<CommentReferenceAttrs>;
+export declare const expectCommentReferenceAttrs: (node: Node) => CommentReferenceAttrs;
+//#endregion

package/dist/prosemirror/commentReferenceAttrs.js

@@ -25,7 +25,10 @@ const expectCommentReferenceAttrs = (node) => {
 	const cached = attrsCache.get(node);
 	if (cached) return cached;
 	const result = readCommentReferenceAttrs(node);
-	if (!result.ok) panic(`Invalid ProseMirror comment reference attrs:\n${result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n")}`);
+	if (!result.ok) {
+		const details = result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n");
+		panic(`Invalid ProseMirror comment reference attrs:\n${details}`);
+	}
 	attrsCache.set(node, result.value);
 	return result.value;
 };

package/dist/prosemirror/commentReferenceIntegrity.d.ts

@@ -1,3 +1,5 @@
+import { Node } from "prosemirror-model";
+import { Step, StepMap } from "prosemirror-transform";
 //#region src/prosemirror/commentReferenceIntegrity.d.ts
 /**
  * What a document must hold for every comment: exactly one `commentReference`
@@ -8,26 +10,26 @@
  * twice. Editing cannot be trusted to keep that true — a paste duplicates a
  * reference, deleting the commented text orphans one, and a command that adds
  * a comment mark creates none — so the repair is computed here and applied by
- * the extension's `appendTransaction`, rather than left to each call site.
+ * the editor extension and shared whole-story revision resolver.
  */
 type PositionedReference = {
   position: number;
   /** Node size, so a caller can delete the node without re-reading it. */
   size: number;
 };
-type CommentReferenceOccurrence = (PositionedReference & {
+export type CommentReferenceOccurrence = (PositionedReference & {
   status: "valid";
   commentId: number;
 }) | (PositionedReference & {
   status: "malformed";
 });
 /** Where a comment's mark last covers content, and how far that content runs. */
-type CommentMarkExtent = {
+export type CommentMarkExtent = {
   commentId: number;
   /** Document position just past the last inline node carrying the mark. */
   end: number;
 };
-type CommentReferenceRepair = {
+export type CommentReferenceRepair = {
   type: "delete";
   position: number;
   size: number;
@@ -40,12 +42,19 @@ type CommentReferenceRepairInput = {
   references: readonly CommentReferenceOccurrence[];
   markExtents: readonly CommentMarkExtent[];
 };
+export declare const COMMENT_REFERENCE_NODE_NAME = "commentReference";
 /**
  * The repairs that make a document total, as positions in the document they
  * were read from. Deletions come first, last-first, so they apply in sequence
  * without mapping; the insertions that follow still carry pre-repair positions
  * and the applier maps them through the transaction.
  */
-declare const planCommentReferenceRepairs: ({ references, markExtents }: CommentReferenceRepairInput) => readonly CommentReferenceRepair[];
+export declare const planCommentReferenceRepairs: ({ references, markExtents }: CommentReferenceRepairInput) => readonly CommentReferenceRepair[];
+type CommentReferenceResolution = {
+  doc: Node;
+  steps: Step[];
+  positionMaps: readonly StepMap[];
+};
+export declare const resolveCommentReferences: (doc: Node) => CommentReferenceResolution | null;
 //#endregion
-export { CommentMarkExtent, CommentReferenceOccurrence, CommentReferenceRepair, planCommentReferenceRepairs };
+export {};