@stll/folio-core 0.63.0 → 0.63.1

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

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

@@ -1,17 +1,5 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/InlineWrapperExtension.d.ts
-/**
- * Inline wrapper mark — the transparent wrappers a leaf sits inside.
- *
- * One mark for every wrapper kind rather than one mark per kind: ProseMirror's
- * mark set is unordered across types, so two marks could not say which wrapper
- * is inside which. The nesting lives in the `stack` attr, outermost first, and
- * the mark excludes itself (ProseMirror's default) because a second one would
- * be a second answer to the same question.
- *
- * `inclusive: false` so typing at the end of a wrapped span does not silently
- * extend the wrapper over text the author wrote outside it.
- */
 export declare const INLINE_WRAPPER_MARK_NAME = "inlineWrapper";
 export declare const InlineWrapperExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,11 +1,5 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/TextEffectsExtensions.d.ts
-/**
- * Additional Text Effect Mark Extensions
- *
- * Emboss (w:emboss), Imprint/Engrave (w:imprint), Text Shadow (w:shadow),
- * Emphasis Marks (w:em), Text Outline (w:outline)
- */
 /**
  * Emboss — raised text effect via text-shadow
  */

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

@@ -1,12 +1,5 @@
 import { MarkExtension } from "../types.js";
 //#region src/prosemirror/extensions/marks/TrackedChangeExtensions.d.ts
-/**
- * Tracked Change Mark Extensions — insertion and deletion marks
- *
- * Renders insertions with colored underline and deletions with colored
- * strikethrough, matching the standard MS Word display for tracked changes.
- * Colors are assigned per author via CSS custom properties (see editor.css).
- */
 /**
  * Insertion mark — text added in tracked changes
  * Renders with per-author colored underline.

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

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

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

@@ -2,6 +2,7 @@ import { document_d_exports } from "../../../types/document.js";
 import { CanonicalCommandIntent } from "../../canonicalCommands.js";
 import { Attrs, Mark, MarkType, Schema } from "prosemirror-model";
 import { Command, EditorState } from "prosemirror-state";
+import { FormattingPatch } from "@stll/docx-core/ops";
 //#region src/prosemirror/extensions/marks/markUtils.d.ts
 type MarkAttrs = Record<string, unknown>;
 export declare const withRunFormattingLock: (command: Command, describe: (state: EditorState) => readonly CanonicalCommandIntent[] | undefined) => Command;
@@ -15,14 +16,14 @@ export declare const canonicalSetMarkFormatting: ({ state, type, attrs }: Canoni
   type: "formatRun";
   from: number;
   to: number;
-  patch: import("@stll/docx-core/ops").FormattingPatch<{
+  patch: FormattingPatch<{
     bold?: boolean | undefined;
     boldCs?: boolean | undefined;
     italic?: boolean | undefined;
     italicCs?: boolean | undefined;
     underline?: {
       style: document_d_exports.UnderlineStyle;
-      color?: import("@stll/docx-core/model").ColorValue;
+      color?: document_d_exports.ColorValue;
     } | undefined;
     strike?: boolean | undefined;
     doubleStrike?: boolean | undefined;
@@ -31,9 +32,9 @@ export declare const canonicalSetMarkFormatting: ({ state, type, attrs }: Canoni
     allCaps?: boolean | undefined;
     hidden?: boolean | undefined;
     noProof?: boolean | undefined;
-    color?: import("@stll/docx-core/model").ColorValue | undefined;
+    color?: document_d_exports.ColorValue | undefined;
     highlight?: "black" | "blue" | "cyan" | "darkBlue" | "darkCyan" | "darkGray" | "darkGreen" | "darkMagenta" | "darkRed" | "darkYellow" | "green" | "lightGray" | "magenta" | "none" | "red" | "white" | "yellow" | undefined;
-    shading?: import("@stll/docx-core/model").ShadingProperties | undefined;
+    shading?: document_d_exports.ShadingProperties | undefined;
     fontSize?: number | undefined;
     fontSizeCs?: number | undefined;
     fontFamily?: {
@@ -56,8 +57,8 @@ export declare const canonicalSetMarkFormatting: ({ state, type, attrs }: Canoni
     position?: number | undefined;
     scale?: number | undefined;
     kerning?: number | undefined;
-    effect?: import("@stll/docx-core/model").TextEffect | undefined;
-    emphasisMark?: import("@stll/docx-core/model").EmphasisMark | undefined;
+    effect?: document_d_exports.TextEffect | undefined;
+    emphasisMark?: document_d_exports.EmphasisMark | undefined;
     emboss?: boolean | undefined;
     imprint?: boolean | undefined;
     outline?: boolean | undefined;
@@ -65,7 +66,7 @@ export declare const canonicalSetMarkFormatting: ({ state, type, attrs }: Canoni
     rtl?: boolean | undefined;
     cs?: boolean | undefined;
     styleId?: string | undefined;
-    preserved?: import("@stll/docx-core/model").PreservedMarkup | undefined;
+    preserved?: document_d_exports.PreservedMarkup | undefined;
   }>;
 }[];
 export declare function setMark(type: MarkType, attrs: MarkAttrs): Command;

package/dist/prosemirror/extensions/nodes/BlockBookmarkBoundaryExtension.d.ts

@@ -1,27 +1,5 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/BlockBookmarkBoundaryExtension.d.ts
-/**
- * A bookmark boundary that stands between two blocks.
- *
- * The block-level twin of `bookmarkBoundary`. `CT_Body`, `CT_Tc` and
- * `CT_SdtContentBlock` declare `w:bookmarkStart`/`w:bookmarkEnd` beside their
- * paragraphs and tables, and Word writes them there whenever the selection was
- * whole blocks: `_GoBack` after an edit, a table-of-contents range around the
- * headings it lists. ProseMirror decides inline or block per node type, so the
- * inline atom cannot also sit here and this is its own node — with the same
- * attributes, read by the same reader, so the two levels cannot describe a
- * bookmark differently.
- *
- * **Position is structure, not an attribute**, for the reason
- * `PreservedBlockExtension` gives: the node sits between the same two blocks it
- * sat between in the source and ProseMirror's own mapping keeps it there, so an
- * edit inside the range cannot change what the range covers.
- *
- * Pairing is owned one level up. A bookmark may open at block level and close
- * inside a paragraph, which is the commoner shape in real documents, so the
- * integrity pass in `BookmarkBoundaryExtension` reads both node types together;
- * a rule enforced here would see half of each such pair and delete it.
- */
 type BlockBookmarkBoundaryOptions = {
   getInternalClipboardToken?: () => string;
 };

package/dist/prosemirror/extensions/nodes/BlockMoveRangeBoundaryExtension.d.ts

@@ -1,19 +1,5 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/BlockMoveRangeBoundaryExtension.d.ts
-/**
- * A tracked-move range boundary that stands between two blocks.
- *
- * The block-level twin of `moveRangeBoundary`, as `blockBookmarkBoundary` is
- * of `bookmarkBoundary`: `CT_Body`, `CT_Tc` and `CT_SdtContentBlock` declare
- * `w:moveFromRangeStart`/`End` and `w:moveToRangeStart`/`End` beside their
- * paragraphs and tables, and a move whose range opens or closes on whole
- * blocks is written there. The node carries the same marker, read by the same
- * reader, so the two levels cannot describe a move range differently.
- *
- * Position is structure, not an attribute: the node sits between the same two
- * blocks it sat between in the source, and ProseMirror's mapping keeps it
- * there.
- */
 type BlockMoveRangeBoundaryOptions = {
   getInternalClipboardToken?: () => string;
 };

package/dist/prosemirror/extensions/nodes/BlockSdtExtension.d.ts

@@ -1,21 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/BlockSdtExtension.d.ts
-/**
- * BlockSdt Extension — block-level content control node.
- *
- * Mirrors OOXML's block `w:sdt` wrapping paragraphs/tables. `isolating: true`
- * keeps user edits scoped to the control (a backspace at the start of an
- * inner paragraph cannot merge through the boundary into a sibling), and
- * `defining: true` preserves the wrapper across split/lift.
- *
- * Attributes:
- * - `sdtType` / `alias` / `tag` / `lock` / `placeholder` /
- *   `showingPlaceholder` / `dateFormat` / `listItems` / `checked` — modeled
- *   projection of `w:sdtPr`; drives addressing and widget UX.
- * - `_preserved` — the `w:sdtPr` children folio does not model, at their
- *   schema ordinal, so `w:dataBinding`, `w15:repeatingSection` and the
- *   control-kind element round-trip without being enumerated here.
- * - `rawEndPropertiesXml` — the verbatim `<w:sdtEndPr>`.
- */
 export declare const BlockSdtExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion

package/dist/prosemirror/extensions/nodes/BookmarkBoundaryExtension.d.ts

@@ -1,6 +1,5 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/BookmarkBoundaryExtension.d.ts
-/** Zero-width bookmark boundary that preserves its position through ProseMirror edits. */
 type BookmarkBoundaryOptions = {
   getInternalClipboardToken?: () => string;
 };

package/dist/prosemirror/extensions/nodes/FieldExtension.d.ts

@@ -1,13 +1,5 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/FieldExtension.d.ts
-/**
- * Field extensions — atomic inline fields (PAGE, NUMPAGES, REF, etc.).
- *
- * Ordinary fields are true ProseMirror leaves, so `textContent`, `textBetween`,
- * and the default plain-text clipboard serializer can use `leafText`.
- * Fields that preserve run metadata or inline structure use a distinct atomic
- * node with inline children; their visible text comes from those children.
- */
 type FieldOptions = {
   getInternalClipboardToken?: () => string;
 };

package/dist/prosemirror/extensions/nodes/HardBreakExtension.d.ts

@@ -1,7 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/HardBreakExtension.d.ts
-/**
- * Hard Break Extension — Shift+Enter line break
- */
 export declare const HardBreakExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion

package/dist/prosemirror/extensions/nodes/HorizontalRuleExtension.d.ts

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

package/dist/prosemirror/extensions/nodes/ImageExtension.d.ts

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

package/dist/prosemirror/extensions/nodes/MathExtension.d.ts

@@ -1,11 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/MathExtension.d.ts
-/**
- * Math Extension — inline/block math equation node (OMML)
- *
- * Represents Office Math Markup Language equations as atomic nodes.
- * Stores the raw OMML XML for round-trip fidelity and shows a plain
- * text fallback in the editor.
- */
 export declare const MathExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion