@stll/folio-core 0.63.0 → 0.64.0

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

@@ -1,4 +1,5 @@
 import { Node } from "prosemirror-model";
+import { CellMargins, ConditionalFormatStyle, PreservedMarkup, ShadingProperties, TableCellBorders, TableMeasurement, TextDirection } from "@stll/docx-core/model";
 //#region src/prosemirror/commands/tableMergeFoldDecisions.d.ts
 type TableMergeFoldDecisionsOptions = {
   table: Node;
@@ -15,18 +16,18 @@ export declare const tableMergeFoldDecisions: ({ table, mode, revisionSet }: Tab
 export declare const resolvedTableMergeOriginAttrs: (cell: Node) => {
   _originalFormatting: {
     vMerge: string;
-    width?: import("@stll/docx-core/model").TableMeasurement;
-    borders?: import("@stll/docx-core/model").TableCellBorders;
-    margins?: import("@stll/docx-core/model").CellMargins;
-    shading?: import("@stll/docx-core/model").ShadingProperties;
+    width?: TableMeasurement;
+    borders?: TableCellBorders;
+    margins?: CellMargins;
+    shading?: ShadingProperties;
     verticalAlign?: "top" | "center" | "bottom";
-    textDirection?: import("@stll/docx-core/model").TextDirection;
+    textDirection?: TextDirection;
     gridSpan?: number;
     fitText?: boolean;
     noWrap?: boolean;
     hideMark?: boolean;
-    conditionalFormat?: import("@stll/docx-core/model").ConditionalFormatStyle;
-    preserved?: import("@stll/docx-core/model").PreservedMarkup;
+    conditionalFormat?: ConditionalFormatStyle;
+    preserved?: PreservedMarkup;
     sourceXml?: string;
   };
   _preserveVMergeRestart: boolean;
@@ -40,19 +41,19 @@ type ResolvedVisibleTableCellMergeOptions = {
 export declare const resolvedVisibleTableCellMergeAttrs: ({ cell, mode, origin }: ResolvedVisibleTableCellMergeOptions) => {
   cellMarker: null;
   _originalFormatting: {
-    width?: import("@stll/docx-core/model").TableMeasurement;
-    borders?: import("@stll/docx-core/model").TableCellBorders;
-    margins?: import("@stll/docx-core/model").CellMargins;
-    shading?: import("@stll/docx-core/model").ShadingProperties;
+    width?: TableMeasurement;
+    borders?: TableCellBorders;
+    margins?: CellMargins;
+    shading?: ShadingProperties;
     verticalAlign?: "top" | "center" | "bottom";
-    textDirection?: import("@stll/docx-core/model").TextDirection;
+    textDirection?: TextDirection;
     gridSpan?: number;
     vMerge?: "restart" | "continue";
     fitText?: boolean;
     noWrap?: boolean;
     hideMark?: boolean;
-    conditionalFormat?: import("@stll/docx-core/model").ConditionalFormatStyle;
-    preserved?: import("@stll/docx-core/model").PreservedMarkup;
+    conditionalFormat?: ConditionalFormatStyle;
+    preserved?: PreservedMarkup;
     sourceXml?: string;
   };
   _preserveVMergeRestart: boolean;

package/dist/prosemirror/commentIdAllocator.d.ts

@@ -1,10 +1,11 @@
 import { Comment } from "../types/content.js";
+import { TaggedErrorClass } from "better-result";
 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). */
 export declare const PENDING_COMMENT_ID = -1;
-declare const CommentIdSpaceExhaustedError_base: import("better-result").TaggedErrorClass<"CommentIdSpaceExhaustedError">;
-export declare class CommentIdSpaceExhaustedError extends CommentIdSpaceExhaustedError_base<{
+declare const CommentIdSpaceExhaustedErrorBase: TaggedErrorClass<"CommentIdSpaceExhaustedError">;
+export declare class CommentIdSpaceExhaustedError extends CommentIdSpaceExhaustedErrorBase<{
   message: string;
 }> {}
 /** Allocate a valid, unused comment ID in this realm. */

package/dist/prosemirror/commentIdAllocator.js

@@ -10,7 +10,8 @@ import { MAX_REVISION_ID } from "@stll/docx-core/model";
 */
 /** Sentinel ID for a comment that hasn't been persisted yet (anchored to selection). */
 const PENDING_COMMENT_ID = -1;
-var CommentIdSpaceExhaustedError = class extends TaggedError("CommentIdSpaceExhaustedError") {};
+const CommentIdSpaceExhaustedErrorBase = TaggedError("CommentIdSpaceExhaustedError");
+var CommentIdSpaceExhaustedError = class extends CommentIdSpaceExhaustedErrorBase {};
 let nextId = 1;
 const reservedIds = /* @__PURE__ */ new Set();
 /** Allocate a valid, unused comment ID in this realm. */

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -280,7 +280,8 @@ const restoreLinkedParagraphPropertySources = (content) => {
 		sources: new Set(targetsBySource.keys())
 	};
 };
-var SaveStylesheetSourceMismatch = class extends TaggedError("SaveStylesheetSourceMismatch") {};
+const SaveStylesheetSourceMismatchBase = TaggedError("SaveStylesheetSourceMismatch");
+var SaveStylesheetSourceMismatch = class extends SaveStylesheetSourceMismatchBase {};
 const parsedPackageStyles = (document, liveStyles) => {
 	const source = getDocumentSourceStyles(document, liveStyles);
 	switch (source.type) {
@@ -358,7 +359,8 @@ const saveStylesheet = (source, baseDocument) => {
 		default: return panic(`Unexpected stylesheet source: ${JSON.stringify(source)}`);
 	}
 };
-var MissingSaveStylesheet = class extends TaggedError("MissingSaveStylesheet") {};
+const MissingSaveStylesheetBase = TaggedError("MissingSaveStylesheet");
+var MissingSaveStylesheet = class extends MissingSaveStylesheetBase {};
 const assertSaveStylesheetAvailable = ({ pmDoc, styles, baseDocument, stylesheetSource }) => {
 	if (styles !== void 0) return;
 	if (stylesheetSource.type === "package" && baseDocument !== void 0) return;

package/dist/prosemirror/extensions/core/DocExtension.d.ts

@@ -1,7 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/core/DocExtension.d.ts
-/**
- * Doc Extension — top-level document node
- */
 export declare const DocExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion

package/dist/prosemirror/extensions/core/HistoryExtension.d.ts

@@ -1,8 +1,5 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/core/HistoryExtension.d.ts
-/**
- * History Extension — undo/redo via prosemirror-history
- */
 /**
  * Who answers the undo and redo keys (Mod-z, Mod-y, Mod-Shift-z).
  *  - `"editor"`: the extension binds them. Default.

package/dist/prosemirror/extensions/core/TextExtension.d.ts

@@ -1,7 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/core/TextExtension.d.ts
-/**
- * Text Extension — inline text node
- */
 export declare const TextExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion

package/dist/prosemirror/extensions/features/AutoBidiDetectionExtension.d.ts

@@ -1,9 +1,9 @@
 import { Extension } from "../types.js";
-import { EditorState, Plugin } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/AutoBidiDetectionExtension.d.ts
 export declare const autoBidiDetectionKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<unknown>;
+  createKey: () => PluginKey<unknown>;
   owns: (plugin: Plugin<unknown>) => boolean;
   get: (state: EditorState) => Plugin<unknown> | undefined;
   getState: (state: EditorState) => unknown;

package/dist/prosemirror/extensions/features/BidiShortcutExtension.d.ts

@@ -1,14 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/BidiShortcutExtension.d.ts
-/**
- * Bidi Shortcut Extension — Ctrl/Cmd+Left Shift → LTR, Ctrl/Cmd+Right Shift → RTL
- *
- * Uses KeyboardEvent.code to distinguish ShiftLeft vs ShiftRight, matching the
- * standard Google Docs shortcut behavior. The keydown/keyup state machine lives
- * in {@link createBidiShortcutController}; this module only wires it to the
- * editor view and dispatches the schema command on keyup.
- *
- * Priority: High (50) — should intercept before other keymaps
- */
 export declare const BidiShortcutExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/ContentControlWidgetsExtension.d.ts

@@ -1,14 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/ContentControlWidgetsExtension.d.ts
-/**
- * Content-Control Widgets Extension — wires the interactive widget plugin
- * into the editor so clicking inside a typed content control invokes the
- * appropriate transaction.
- *
- * The plugin owns checkbox toggling outright; dropdown / date picker chrome
- * is delegated to the editor shell via the `onWidgetEvent` callback (the
- * shell renders the menu / picker and dispatches via `dispatchDropdownPick`
- * / `dispatchDatePick`).
- */
 export declare const ContentControlWidgetsExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/DropCursorExtension.d.ts

@@ -1,10 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/DropCursorExtension.d.ts
-/**
- * Drop Cursor Extension — shows a visual indicator when dragging content
- *
- * Uses prosemirror-dropcursor to display a cursor line at the drop position
- * when dragging images or other content within the editor.
- */
 export declare const DropCursorExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/EmptyParagraphFormatExtension.d.ts

@@ -1,12 +1,12 @@
 import { Extension } from "../types.js";
-import { Plugin } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/EmptyParagraphFormatExtension.d.ts
 export declare const emptyParagraphFormatKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<unknown>;
+  createKey: () => PluginKey<unknown>;
   owns: (plugin: Plugin<unknown>) => boolean;
-  get: (state: import("prosemirror-state").EditorState) => Plugin<unknown> | undefined;
-  getState: (state: import("prosemirror-state").EditorState) => unknown;
+  get: (state: EditorState) => Plugin<unknown> | undefined;
+  getState: (state: EditorState) => unknown;
 }>;
 export declare const EmptyParagraphFormatExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/GapCursorExtension.d.ts

@@ -1,17 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/GapCursorExtension.d.ts
-/**
- * GapCursor Extension — provides a caret slot before / between / after
- * isolating block nodes (notably `blockSdt`).
- *
- * Without gapcursor, a user cannot place the caret before a doc-starting
- * SDT, between two adjacent SDTs, or after a doc-final SDT — the
- * `isolating` boundary makes regular text selections refuse those
- * positions. The prosemirror-gapcursor plugin paints a thin "gap" caret
- * at those slots so the document stays fully navigable.
- *
- * The plugin also exposes `Backspace` / `Delete` handlers that join the
- * gap into the neighbour when sensible.
- */
 export declare const GapCursorExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/ImageDragExtension.d.ts

@@ -1,13 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/ImageDragExtension.d.ts
-/**
- * Image Drag Extension — handles drag-to-reposition for images
- *
- * Provides:
- * - Ghost outline visual during drag
- * - Drop indicator showing where image will land
- * - Inline images: reorder within text flow via ProseMirror's default drag
- * - Custom drag initiation from mousedown on selected images
- */
 export declare const ImageDragExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/ImagePasteExtension.d.ts

@@ -1,10 +1,4 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/ImagePasteExtension.d.ts
-/**
- * Image Paste Extension — handles image files pasted from the clipboard
- *
- * When an image file is present on the clipboard, this intercepts the paste,
- * reads the image data, and inserts an image node instead of a file icon.
- */
 export declare const ImagePasteExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/JoinedRunStyleExtension.d.ts

@@ -1,19 +1,5 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/JoinedRunStyleExtension.d.ts
-/**
- * Runs that a join moves into another paragraph take that paragraph's style.
- *
- * Deleting across a paragraph break (Backspace or Delete at the break, a
- * deletion or typing over a selection that spans paragraphs) runs the later
- * paragraph's remaining text on into the earlier one. A run's direct
- * formatting is its own and stays; what the later paragraph's style lent it
- * does not travel, and it reads in the style of the paragraph it now belongs
- * to. The document styles plugin re-reads those runs after an ordinary edit.
- *
- * A transaction that re-reads the runs it moves itself (resolving a tracked
- * change, an operation that merges paragraphs) says so with
- * {@link JOINED_RUNS_RESTYLED_META}, and is left as it is.
- */
 export declare const JOINED_RUNS_RESTYLED_META = "joinedRunsRestyled";
 export declare const JoinedRunStyleExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/ParaIdAllocatorExtension.d.ts

@@ -1,6 +1,6 @@
 import { Extension } from "../types.js";
 import { Node } from "prosemirror-model";
-import { EditorState, Plugin, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.d.ts
 type ParagraphPropertySourceSeed = {
   contract: string | null;
@@ -8,7 +8,7 @@ type ParagraphPropertySourceSeed = {
 };
 export declare const paraIdAllocatorKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<ParagraphPropertySourceSeed>;
+  createKey: () => PluginKey<ParagraphPropertySourceSeed>;
   owns: (plugin: Plugin<ParagraphPropertySourceSeed>) => boolean;
   get: (state: EditorState) => Plugin<ParagraphPropertySourceSeed> | undefined;
   getState: (state: EditorState) => ParagraphPropertySourceSeed | undefined;
@@ -51,6 +51,7 @@ export declare const mapParagraphKeepers: (oldDoc: Node, transactions: readonly
  * below so history, mappings, and duplicate ownership retain their semantics.
  */
 export declare const ensureParaIdsInDoc: (doc: Node) => Node;
+/** {@link ensureParaIdsInDoc} for a state that already exists. */
 export declare const ensureParaIdsInState: (state: EditorState) => EditorState;
 export declare const ParaIdAllocatorExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion

package/dist/prosemirror/extensions/features/ParaIdAllocatorExtension.js

@@ -27,7 +27,10 @@ import { Plugin, Transaction } from "prosemirror-state";
 * ids in an `appendTransaction` hook after every doc-changed step.
 *
 * Id lifecycle rules (locked by the co-located tests):
-* - Missing/empty/reserved-zero id: a fresh random id is minted.
+* - Load: a missing/empty/reserved-zero or duplicate id gets one derived
+*   from the paragraph's text and ordinal (`ensureParaIdsInDoc`), the same
+*   id the headless reviewer derives for the same document.
+* - Missing/empty/reserved-zero id after an edit: a fresh random id is minted.
 * - Split: the half holding the paragraph's original start position
 *   keeps the id; the other half gets a fresh one. Anchors inside the
 *   content stay resolvable on the half that carries them.
@@ -207,7 +210,6 @@ const collectParaIdUpdatesFromCensus = (census, keeperPositions, deterministicSe
 	updates.sort((left, right) => left.pos - right.pos);
 	return updates;
 };
-const collectParaIdUpdates = (doc) => collectParaIdUpdatesFromCensus(collectParagraphCensus(doc));
 const collectParagraphPropertySourceUpdates = (census, keeperPositions, transactions) => {
 	const updates = /* @__PURE__ */ new Map();
 	for (const { pos } of census.invalidSourceTokens) updates.set(pos, null);
@@ -237,49 +239,49 @@ const collectParagraphPropertySourceUpdates = (census, keeperPositions, transact
 		token
 	})).sort((left, right) => left.pos - right.pos);
 };
-const collectInitialParaIds = (doc) => {
-	let needsRewrite = false;
+/**
+* The ids a loaded document's paragraphs take, in document order: `null`
+* keeps the paragraph's own id, a string replaces it.
+*
+* This is the only load-time allocator. The live editor and the headless
+* reviewer both seed through it, so the same document gives the same block ids
+* on either side: an id read from the editor resolves when the edit is applied
+* headlessly, and re-parsing the same bytes mints the same ids. An id is
+* derived from the paragraph's text and its document ordinal, never drawn at
+* random. Authored ids are reserved first, so a minted id never takes one a
+* later paragraph owns; of a duplicated authored id, the first occurrence
+* keeps it.
+*/
+const planLoadParaIds = (doc) => {
+	const paragraphs = [];
 	const taken = /* @__PURE__ */ new Set();
 	doc.descendants((node) => {
 		if (node.type.name !== "paragraph") return true;
+		paragraphs.push(node);
 		const id = node.attrs["paraId"];
-		if (!isUsableParaId(id) || taken.has(id)) needsRewrite = true;
-		else taken.add(id);
+		if (isUsableParaId(id)) taken.add(id);
 		return false;
 	});
-	return {
-		needsRewrite,
-		taken
-	};
-};
-const rewriteInitialParaIds = (parent, taken, seen) => {
-	let changed = false;
-	const children = [];
-	parent.forEach((child) => {
-		let next = child;
-		if (child.type.name === "paragraph") {
-			const id = child.attrs["paraId"];
-			if (!isUsableParaId(id) || seen.has(id)) {
-				let newId = generateHexId();
-				while (taken.has(newId)) newId = generateHexId();
-				taken.add(newId);
-				seen.add(newId);
-				next = recreateProseNodeWithParagraphPropertySource(child, { attrs: {
-					...child.attrs,
-					paraId: newId
-				} });
-			} else seen.add(id);
-			const paraId = next.attrs["paraId"];
-			if (typeof paraId === "string") transferProseParagraphPropertySource(next, child, paraId);
-		} else if (child.childCount > 0) {
-			const content = rewriteInitialParaIds(child, taken, seen);
-			if (content !== child.content) next = recreateProseNodeWithParagraphPropertySource(child, { content });
+	const kept = /* @__PURE__ */ new Set();
+	return paragraphs.map((paragraph, index) => {
+		const id = paragraph.attrs["paraId"];
+		if (isUsableParaId(id) && !kept.has(id)) {
+			kept.add(id);
+			return null;
 		}
-		if (next !== child) changed = true;
-		children.push(next);
+		const seed = `${paragraph.textContent}:${String(index + 1)}`;
+		let minted = deterministicHexId(seed);
+		for (let salt = 1; taken.has(minted); salt++) minted = deterministicHexId(`${seed}:${String(salt)}`);
+		taken.add(minted);
+		return minted;
 	});
-	return changed ? Fragment.fromArray(children) : parent.content;
 };
+/** A paragraph's attrs once it holds an id folio minted rather than read. */
+const mintedParagraphAttrs = (paragraph, paraId) => ({
+	...paragraph.attrs,
+	paraId,
+	...paragraph.type.spec.attrs?.["idStability"] !== void 0 && { idStability: "positional" }
+});
 /**
 * Allocate initial paragraph IDs before constructing editor state.
 *
@@ -288,19 +290,48 @@ const rewriteInitialParaIds = (parent, taken, seen) => {
 * below so history, mappings, and duplicate ownership retain their semantics.
 */
 const ensureParaIdsInDoc = (doc) => {
-	const { needsRewrite, taken } = collectInitialParaIds(doc);
-	if (!needsRewrite) return doc;
-	return recreateProseNodeWithParagraphPropertySource(doc, { content: rewriteInitialParaIds(doc, taken, /* @__PURE__ */ new Set()) });
+	const plan = planLoadParaIds(doc);
+	if (plan.every((paraId) => paraId === null)) return doc;
+	let ordinal = 0;
+	const rewrite = (parent) => {
+		let changed = false;
+		const children = [];
+		parent.forEach((child) => {
+			let next = child;
+			if (child.type.name === "paragraph") {
+				const minted = plan[ordinal];
+				ordinal += 1;
+				if (minted !== null && minted !== void 0) next = recreateProseNodeWithParagraphPropertySource(child, { attrs: mintedParagraphAttrs(child, minted) });
+				const paraId = next.attrs["paraId"];
+				if (typeof paraId === "string") transferProseParagraphPropertySource(next, child, paraId);
+			} else if (child.childCount > 0) {
+				const content = rewrite(child);
+				if (content !== child.content) next = recreateProseNodeWithParagraphPropertySource(child, { content });
+			}
+			if (next !== child) changed = true;
+			children.push(next);
+		});
+		return changed ? Fragment.fromArray(children) : parent.content;
+	};
+	return recreateProseNodeWithParagraphPropertySource(doc, { content: rewrite(doc) });
 };
+/** {@link ensureParaIdsInDoc} for a state that already exists. */
 const ensureParaIdsInState = (state) => {
-	const updates = collectParaIdUpdates(state.doc);
-	if (updates.length === 0) return state;
+	const plan = planLoadParaIds(state.doc);
+	if (plan.every((paraId) => paraId === null)) return state;
 	const tr = state.tr;
-	for (const update of updates) setProseParagraphMarkupWithPropertySource({
-		attrs: update.attrs,
-		ownership: "transfer-allocated-id",
-		pos: update.pos,
-		transaction: tr
+	let ordinal = 0;
+	state.doc.descendants((node, pos) => {
+		if (node.type.name !== "paragraph") return true;
+		const minted = plan[ordinal];
+		ordinal += 1;
+		if (minted !== null && minted !== void 0) setProseParagraphMarkupWithPropertySource({
+			attrs: mintedParagraphAttrs(node, minted),
+			ownership: "transfer-allocated-id",
+			pos,
+			transaction: tr
+		});
+		return false;
 	});
 	ignoreTrackedChanges(tr);
 	tr.setMeta(paraIdAllocatorKey, "allocated");

package/dist/prosemirror/extensions/features/ParagraphChangeTrackerExtension.d.ts

@@ -2,11 +2,11 @@ import { document_d_exports } from "../../../types/document.js";
 import { Extension } from "../types.js";
 import { RemovedSectionReference, TrackedSectionEndpointRemoval } from "../../../internal/sectionEndpointResolution.js";
 import { Node } from "prosemirror-model";
-import { EditorState, Plugin, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParagraphChangeTrackerExtension.d.ts
 export declare const paragraphChangeTrackerKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<InternalParagraphChangeTrackerState>;
+  createKey: () => PluginKey<InternalParagraphChangeTrackerState>;
   owns: (plugin: Plugin<InternalParagraphChangeTrackerState>) => boolean;
   get: (state: EditorState) => Plugin<InternalParagraphChangeTrackerState> | undefined;
   getState: (state: EditorState) => InternalParagraphChangeTrackerState | undefined;

package/dist/prosemirror/extensions/features/PasteCleanupExtension.d.ts

@@ -1,22 +1,5 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/PasteCleanupExtension.d.ts
-/**
- * Paste Cleanup Extension
- *
- * Wires two paste-handling behaviors into the editor:
- *
- * 1. `transformPastedHTML` — strips Office/web producer cruft from pasted HTML
- *    (see {@link cleanPastedHtml}) before the schema parser reads it. Runs at
- *    `Highest` priority so the cleanup happens before the style inliner and the
- *    default clipboard parser; ProseMirror chains every plugin's
- *    `transformPastedHTML`, so this cooperates with the inliner rather than
- *    replacing it, and `<style>` blocks are left intact for it to resolve.
- * 2. `transformPasted` — drops unpaired bookmark and move-range boundaries,
- *    then points pasted headings at the open document's own heading style
- *    (see {@link retargetPastedHeadingStyles}).
- * 3. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
- *    the source formatting stripped (see {@link pasteWithoutFormatting}).
- */
 type PasteCleanupOptions = {
   getInternalClipboardToken?: () => string;
 };

package/dist/prosemirror/extensions/features/PasteStyleInlinerExtension.d.ts

@@ -1,19 +1,5 @@
 import { Extension } from "../types.js";
 //#region src/prosemirror/extensions/features/PasteStyleInlinerExtension.d.ts
-/**
- * Paste Style Inliner Extension
- *
- * When pasting from apps like Google Docs that use class-based CSS
- * (e.g. `<style>.c5 { margin-top: 12pt }</style>`) instead of inline styles,
- * ProseMirror's parseDOM can't read the styles because elements aren't attached
- * to the live document during parsing.
- *
- * This extension provides a `transformPastedHTML` hook that:
- * 1. Parses the pasted HTML string
- * 2. Extracts all `<style>` rules
- * 3. Inlines them onto matching elements
- * 4. Returns the modified HTML so parseDOM can read inline styles
- */
 /**
  * Transform pasted HTML by inlining class-based CSS and unwrapping Google Docs wrappers.
  */

package/dist/prosemirror/extensions/marks/AllCapsExtension.d.ts

@@ -1,7 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/AllCapsExtension.d.ts
-/**
- * All Caps Mark Extension (w:caps)
- */
 export declare const AllCapsExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/BoldExtension.d.ts

@@ -1,7 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/BoldExtension.d.ts
-/**
- * Bold Mark Extension
- */
 export declare const BoldExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/CharacterSpacingExtension.d.ts

@@ -1,12 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/CharacterSpacingExtension.d.ts
-/**
- * Character Spacing Mark Extension
- *
- * Handles: character spacing (w:spacing), position/raise-lower (w:position),
- * horizontal scale (w:w), and kerning (w:kern).
- *
- * Single mark with multiple attributes to avoid mark explosion.
- */
 export declare const CharacterSpacingExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/CharacterStyleExtension.d.ts

@@ -1,18 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/CharacterStyleExtension.d.ts
-/**
- * Character Style Mark Extension (w:rStyle)
- *
- * Carries a run's character style reference through ProseMirror so semantic
- * styles (e.g. a house "DefinedTerm" style) survive the load → edit → save
- * round-trip. The style's resolved formatting is flattened into the regular
- * marks at load for rendering; this mark preserves only the reference. Style
- * formatting resolves through the document's shared style engine so it does
- * not become stale when a run moves between paragraph contexts.
- *
- * The mark renders as an unstyled span with a `data-character-style`
- * attribute. parseDOM restores the styleId (so copy/paste inside the editor
- * keeps the reference).
- */
 export declare const CharacterStyleExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/CommentExtension.d.ts

@@ -1,10 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/CommentExtension.d.ts
-/**
- * Comment Mark Extension — highlights text that has comments
- *
- * Applied to text ranges between commentRangeStart and commentRangeEnd.
- * The comment ID links to the Comment object in the document model.
- */
 export declare const CommentExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/FontFamilyExtension.d.ts

@@ -1,7 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/FontFamilyExtension.d.ts
-/**
- * Font Family Mark Extension
- */
 export declare const FontFamilyExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/FontSizeExtension.d.ts

@@ -1,7 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/FontSizeExtension.d.ts
-/**
- * Font Size Mark Extension
- */
 export declare const FontSizeExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/FootnoteRefExtension.d.ts

@@ -1,9 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/FootnoteRefExtension.d.ts
-/**
- * Footnote Reference Mark Extension
- *
- * Provides footnoteRef mark + insert/delete commands for footnotes and endnotes.
- */
 export declare const FootnoteRefExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

package/dist/prosemirror/extensions/marks/HiddenTextExtension.d.ts

@@ -1,21 +1,4 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/HiddenTextExtension.d.ts
-/**
- * Hidden Text Mark Extension (w:vanish, OOXML §17.3.2.41)
- *
- * Word's editing view dims hidden text with a dotted underline so the
- * author can navigate to and edit it; the print/normal view suppresses it
- * entirely. The painter mirrors the editing-view treatment so PM cursor
- * traversal stays correct across hidden ranges. The `docx-hidden` class
- * hook lets host CSS opt into print-style suppression independently.
- *
- * The dotted-underline visual is delivered via `editor.css` (`.docx-hidden`
- * rule), NOT inline `text-decoration`. Inline `text-decoration: underline`
- * would be picked up by `UnderlineExtension`'s `style: "text-decoration"`
- * parser on DOM/clipboard reparse and add a spurious `<w:u>` alongside
- * `<w:vanish/>` on export.
- *
- * eigenpal #424 (w:vanish gap 9).
- */
 export declare const HiddenTextExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion