@stll/folio-core 0.11.0 → 0.12.0

package/dist/prosemirror/extensions/ExtensionManager.js

@@ -1,6 +1,6 @@
 import { panic } from "better-result";
-import { keymap } from "prosemirror-keymap";
 import { Schema } from "prosemirror-model";
+import { keymap } from "prosemirror-keymap";
 //#region src/prosemirror/extensions/ExtensionManager.ts
 /**
 * Extension Manager

package/dist/prosemirror/extensions/StarterKit.js

@@ -41,7 +41,7 @@ import { SuperscriptExtension } from "./marks/SuperscriptExtension.js";
 import { TextColorExtension } from "./marks/TextColorExtension.js";
 import { TextEffectExtension } from "./marks/TextEffectExtension.js";
 import { EmbossExtension, EmphasisMarkExtension, ImprintExtension, TextOutlineExtension, TextShadowExtension } from "./marks/TextEffectsExtensions.js";
-import { DeletionExtension, InsertionExtension } from "./marks/TrackedChangeExtensions.js";
+import { DeletionExtension, InsertionExtension, RunPropertyChangeExtension } from "./marks/TrackedChangeExtensions.js";
 import { UnderlineExtension } from "./marks/UnderlineExtension.js";
 import { BlockSdtExtension } from "./nodes/BlockSdtExtension.js";
 import { FieldExtension } from "./nodes/FieldExtension.js";
@@ -50,10 +50,12 @@ import { HorizontalRuleExtension } from "./nodes/HorizontalRuleExtension.js";
 import { ImageExtension } from "./nodes/ImageExtension.js";
 import { MathExtension } from "./nodes/MathExtension.js";
 import { PageBreakExtension } from "./nodes/PageBreakExtension.js";
+import { RenderedPageBreakExtension } from "./nodes/RenderedPageBreakExtension.js";
 import { SdtExtension } from "./nodes/SdtExtension.js";
 import { ShapeExtension } from "./nodes/ShapeExtension.js";
 import { TabExtension } from "./nodes/TabExtension.js";
 import { TextBoxExtension } from "./nodes/TextBoxExtension.js";
+import { TextBoxAnchorExtension } from "./nodes/TextBoxAnchorExtension.js";
 //#region src/prosemirror/extensions/StarterKit.ts
 /**
 * Create the full set of extensions for the DOCX editor
@@ -101,10 +103,12 @@ function createStarterKit(options = {}) {
 	add("comment", CommentExtension());
 	add("insertion", InsertionExtension());
 	add("deletion", DeletionExtension());
+	add("runPropertyChange", RunPropertyChangeExtension());
 	add("hardBreak", HardBreakExtension());
 	add("tab", TabExtension());
 	add("image", ImageExtension());
 	add("textBox", TextBoxExtension());
+	add("textBoxAnchor", TextBoxAnchorExtension());
 	add("shape", ShapeExtension());
 	add("imageDrag", ImageDragExtension());
 	add("imagePaste", ImagePasteExtension());
@@ -112,6 +116,7 @@ function createStarterKit(options = {}) {
 	add("gapCursor", GapCursorExtension());
 	add("horizontalRule", HorizontalRuleExtension());
 	add("pageBreak", PageBreakExtension());
+	add("renderedPageBreak", RenderedPageBreakExtension());
 	add("field", FieldExtension());
 	add("sdt", SdtExtension());
 	add("blockSdt", BlockSdtExtension());

package/dist/prosemirror/extensions/core/ParagraphExtension.js

@@ -1,6 +1,6 @@
-import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { directionIsRtl } from "../../paragraphDirection.js";
 import { expectParagraphAttrs } from "../../attrs/index.js";
+import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { createNodeExtension } from "../create.js";
 import { paragraphToStyle } from "../../../utils/formatToStyle.js";
 import { collectHeadings } from "../../../utils/headingCollector.js";
@@ -187,8 +187,10 @@ const paragraphNodeSpec = {
 		spaceAfter: { default: null },
 		lineSpacing: { default: null },
 		lineSpacingRule: { default: null },
+		snapToGrid: { default: null },
 		spacingExplicit: { default: null },
 		spacingFromDocDefaults: { default: null },
+		spacingFromImplicitDefaultStyle: { default: null },
 		indentLeft: { default: null },
 		indentRight: { default: null },
 		indentFirstLine: { default: null },
@@ -219,6 +221,7 @@ const paragraphNodeSpec = {
 		pageBreakBefore: { default: null },
 		renderedPageBreakBefore: { default: null },
 		_pageBreakCarrier: { default: null },
+		_trailingPageBreak: { default: null },
 		keepNext: { default: null },
 		keepLines: { default: null },
 		widowControl: { default: null },

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

@@ -55,6 +55,7 @@ const INHERITED_PARA_ATTRS = [
 	"styleId",
 	"lineSpacing",
 	"lineSpacingRule",
+	"snapToGrid",
 	"spaceAfter",
 	"spaceBefore",
 	"contextualSpacing"

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

@@ -1,7 +1,7 @@
-import { PPR_CHANGE_SCOPED_ATTR_KEYS } from "../../commands/propertyChangeScope.js";
 import { Priority } from "../types.js";
 import { createExtension } from "../create.js";
 import { SUGGESTION_META, makeRevisionInfo } from "../../plugins/suggestionMode.js";
+import { PPR_CHANGE_SCOPED_ATTR_KEYS } from "../../commands/propertyChangeScope.js";
 import { goToNextCell, goToPrevCell } from "../nodes/TableExtension.js";
 //#region src/prosemirror/extensions/features/ListExtension.ts
 function chainCommands(...commands) {

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

@@ -1,9 +1,18 @@
 import { Extension } from "../types.js";
 import { EditorState, PluginKey } from "prosemirror-state";
+import { Node } from "prosemirror-model";
 
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.d.ts
 declare const paraIdAllocatorKey: PluginKey<any>;
+/**
+ * Allocate initial paragraph IDs before constructing editor state.
+ *
+ * Rebuilding only changed branches avoids applying one ProseMirror transaction
+ * step per missing paragraph. Live edits still use the transaction-based plugin
+ * below so history, mappings, and duplicate ownership retain their semantics.
+ */
+declare const ensureParaIdsInDoc: (doc: Node) => Node;
 declare const ensureParaIdsInState: (state: EditorState) => EditorState;
 declare const ParaIdAllocatorExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion
-export { ParaIdAllocatorExtension, ensureParaIdsInState, paraIdAllocatorKey };
+export { ParaIdAllocatorExtension, ensureParaIdsInDoc, ensureParaIdsInState, paraIdAllocatorKey };

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

@@ -1,8 +1,46 @@
-import { generateHexId } from "../../../utils/hexId.js";
 import { createExtension } from "../create.js";
 import { ignoreTrackedChanges } from "./ParagraphChangeTrackerExtension.js";
+import { generateHexId } from "../../../utils/hexId.js";
+import { Fragment } from "prosemirror-model";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
+/**
+* ParaIdAllocator — assigns a stable `w14:paraId` to every paragraph.
+*
+* Lifted from
+* https://github.com/eigenpal/docx-editor/blob/main/packages/core/src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
+* (Apache-2.0). Adapted to folio's `createExtension` + import style;
+* keep behaviour in sync upstream. folio divergences: duplicate
+* resolution maps the original paragraph's position through the
+* transaction (see below), and the appended allocation transaction is
+* excluded from paragraph change tracking like `ensureParaIdsInState`.
+*
+* Why: AI tooling, chat citation chips, and the change tracker all
+* anchor on `paraId`. A paragraph with `paraId: null` is invisible
+* to those surfaces; a duplicated paraId (the second half of an
+* Enter-split, or content pasted from another doc) silently desyncs
+* their anchors. This plugin closes both gaps by allocating fresh
+* 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.
+* - 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.
+* - Merge/join: the surviving paragraph keeps its id; the absorbed id
+*   dangles by design (consumers degrade to snapshot fallback).
+* - Paste/duplicate carrying an id already in the doc: the paragraph
+*   whose mapped pre-transaction position matches keeps it — pasting a
+*   copy above its source no longer steals the source's id. When no
+*   occurrence maps back (e.g. both are new), the first in document
+*   order keeps it.
+* - Paste of an id unknown to this doc (cross-doc paste, cut-then-
+*   paste move): the id is kept, so a moved paragraph stays anchored.
+* - Undo/redo: allocation applies with `addToHistory: false`, and
+*   ProseMirror remaps it into the originating history event. Redoing a
+*   split therefore restores the same allocated id instead of minting
+*   another one.
+*/
 const paraIdAllocatorKey = new PluginKey("paraIdAllocator");
 const isUsableParaId = (value) => typeof value === "string" && value.length > 0 && value !== "00000000";
 /**
@@ -76,6 +114,59 @@ const collectParaIdUpdates = (doc, keeperPositions) => {
 	updates.sort((a, b) => a.pos - b.pos);
 	return updates;
 };
+const collectInitialParaIds = (doc) => {
+	let needsRewrite = false;
+	const taken = /* @__PURE__ */ new Set();
+	doc.descendants((node) => {
+		if (node.type.name !== "paragraph") return true;
+		const id = node.attrs["paraId"];
+		if (!isUsableParaId(id) || taken.has(id)) needsRewrite = true;
+		else 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 = child.type.create({
+					...child.attrs,
+					paraId: newId
+				}, child.content, child.marks);
+			} else seen.add(id);
+		} else if (child.childCount > 0) {
+			const content = rewriteInitialParaIds(child, taken, seen);
+			if (content !== child.content) next = child.copy(content);
+		}
+		if (next !== child) changed = true;
+		children.push(next);
+	});
+	return changed ? Fragment.fromArray(children) : parent.content;
+};
+/**
+* Allocate initial paragraph IDs before constructing editor state.
+*
+* Rebuilding only changed branches avoids applying one ProseMirror transaction
+* step per missing paragraph. Live edits still use the transaction-based plugin
+* below so history, mappings, and duplicate ownership retain their semantics.
+*/
+const ensureParaIdsInDoc = (doc) => {
+	const { needsRewrite, taken } = collectInitialParaIds(doc);
+	if (!needsRewrite) return doc;
+	return doc.copy(rewriteInitialParaIds(doc, taken, /* @__PURE__ */ new Set()));
+};
 const ensureParaIdsInState = (state) => {
 	const updates = collectParaIdUpdates(state.doc);
 	if (updates.length === 0) return state;
@@ -109,4 +200,4 @@ const ParaIdAllocatorExtension = createExtension({
 	}
 });
 //#endregion
-export { ParaIdAllocatorExtension, ensureParaIdsInState, paraIdAllocatorKey };
+export { ParaIdAllocatorExtension, ensureParaIdsInDoc, ensureParaIdsInState, paraIdAllocatorKey };

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

@@ -30,6 +30,7 @@ declare function hasUntrackedChanges(state: EditorState): boolean;
  */
 declare function clearTrackedChanges(state: EditorState): Transaction;
 declare function ignoreTrackedChanges(tr: Transaction): Transaction;
+declare function markStructuralChange(tr: Transaction): Transaction;
 declare const ParagraphChangeTrackerExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion
-export { ParagraphChangeTrackerExtension, ParagraphChangeTrackerState, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, paragraphChangeTrackerKey };
+export { ParagraphChangeTrackerExtension, ParagraphChangeTrackerState, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, markStructuralChange, paragraphChangeTrackerKey };

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

@@ -12,6 +12,7 @@ import { AddMarkStep, AddNodeMarkStep, RemoveMarkStep, RemoveNodeMarkStep } from
 const paragraphChangeTrackerKey = new PluginKey("paragraphChangeTracker");
 const CLEAR_META = "clear";
 const IGNORE_META = "ignore";
+const STRUCTURAL_META = "structural";
 /**
 * Count paragraph nodes in a ProseMirror document
 */
@@ -103,7 +104,7 @@ function createParagraphChangeTrackerPlugin() {
 				const newCount = countParagraphs(tr.doc);
 				const newState = {
 					changedParaIds: new Set(prevState.changedParaIds),
-					structuralChange: prevState.structuralChange,
+					structuralChange: prevState.structuralChange || meta === STRUCTURAL_META,
 					hasUntrackedChanges: prevState.hasUntrackedChanges,
 					paragraphCount: newCount
 				};
@@ -177,6 +178,9 @@ function clearTrackedChanges(state) {
 function ignoreTrackedChanges(tr) {
 	return tr.setMeta(paragraphChangeTrackerKey, IGNORE_META);
 }
+function markStructuralChange(tr) {
+	return tr.setMeta(paragraphChangeTrackerKey, STRUCTURAL_META);
+}
 const ParagraphChangeTrackerExtension = createExtension({
 	name: "paragraphChangeTracker",
 	defaultOptions: {},
@@ -185,4 +189,4 @@ const ParagraphChangeTrackerExtension = createExtension({
 	}
 });
 //#endregion
-export { ParagraphChangeTrackerExtension, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, paragraphChangeTrackerKey };
+export { ParagraphChangeTrackerExtension, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, markStructuralChange, paragraphChangeTrackerKey };

package/dist/prosemirror/extensions/marks/CharacterSpacingExtension.js

@@ -1,5 +1,5 @@
-import { formatPx, twipsToPixels } from "../../../utils/units.js";
 import { expectCharacterSpacingMarkAttrs } from "../../attrs/index.js";
+import { formatPx, twipsToPixels } from "../../../utils/units.js";
 import { createMarkExtension } from "../create.js";
 //#region src/prosemirror/extensions/marks/CharacterSpacingExtension.ts
 /**

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

@@ -18,5 +18,13 @@ declare const InsertionExtension: (options?: Partial<Record<string, unknown>> |
  * Renders with per-author colored strikethrough.
  */
 declare const DeletionExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+/**
+ * Run property change — formatting changed while review tracking was active.
+ *
+ * The current formatting remains represented by the normal formatting marks;
+ * this mark carries the previous run properties and revision metadata needed
+ * to serialize, list, accept, and reject the change.
+ */
+declare const RunPropertyChangeExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion
-export { DeletionExtension, InsertionExtension };
+export { DeletionExtension, InsertionExtension, RunPropertyChangeExtension };

package/dist/prosemirror/extensions/marks/TrackedChangeExtensions.js

@@ -109,5 +109,28 @@ const DeletionExtension = createMarkExtension({
 		}
 	}
 });
+/**
+* Run property change — formatting changed while review tracking was active.
+*
+* The current formatting remains represented by the normal formatting marks;
+* this mark carries the previous run properties and revision metadata needed
+* to serialize, list, accept, and reject the change.
+*/
+const RunPropertyChangeExtension = createMarkExtension({
+	name: "runPropertyChange",
+	schemaMarkName: "runPropertyChange",
+	markSpec: {
+		attrs: { changes: { default: [] } },
+		inclusive: false,
+		parseDOM: [{ tag: "span.docx-run-property-change" }],
+		toDOM() {
+			return [
+				"span",
+				{ class: "docx-run-property-change" },
+				0
+			];
+		}
+	}
+});
 //#endregion
-export { DeletionExtension, InsertionExtension };
+export { DeletionExtension, InsertionExtension, RunPropertyChangeExtension };

package/dist/prosemirror/extensions/nodes/FieldExtension.js

@@ -1,6 +1,6 @@
-import { parseFieldInstruction } from "../../../docx/fieldParser.js";
 import { expectFieldAttrs } from "../../attrs/index.js";
 import { createNodeExtension } from "../create.js";
+import { parseFieldInstruction } from "../../../docx/fieldParser.js";
 //#region src/prosemirror/extensions/nodes/FieldExtension.ts
 /**
 * Field Extension — inline field node (PAGE, NUMPAGES, DATE, MERGEFIELD, etc.)

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

@@ -0,0 +1,7 @@
+import { NodeExtension } from "../types.js";
+
+//#region src/prosemirror/extensions/nodes/RenderedPageBreakExtension.d.ts
+/** Zero-width cached pagination boundary preserved from DOCX. */
+declare const RenderedPageBreakExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion
+export { RenderedPageBreakExtension };

package/dist/prosemirror/extensions/nodes/RenderedPageBreakExtension.js

@@ -0,0 +1,22 @@
+import { createNodeExtension } from "../create.js";
+//#region src/prosemirror/extensions/nodes/RenderedPageBreakExtension.ts
+/** Zero-width cached pagination boundary preserved from DOCX. */
+const RenderedPageBreakExtension = createNodeExtension({
+	name: "renderedPageBreak",
+	schemaNodeName: "renderedPageBreak",
+	nodeSpec: {
+		inline: true,
+		group: "inline",
+		atom: true,
+		selectable: false,
+		parseDOM: [{ tag: "span[data-docx-rendered-page-break]" }],
+		toDOM() {
+			return ["span", {
+				"data-docx-rendered-page-break": "true",
+				style: "display: none;"
+			}];
+		}
+	}
+});
+//#endregion
+export { RenderedPageBreakExtension };

package/dist/prosemirror/extensions/nodes/TableExtension.js

@@ -3,8 +3,8 @@ import { expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, mergeTable
 import { createExtension, createNodeExtension } from "../create.js";
 import { resolveColor } from "../../../utils/colorResolver.js";
 import { panic } from "better-result";
-import { Plugin, PluginKey, Selection, TextSelection } from "prosemirror-state";
 import { CellSelection, TableMap, columnResizing, mergeCells, removeRow, selectedRect, splitCell, tableEditing } from "prosemirror-tables";
+import { Plugin, PluginKey, Selection, TextSelection } from "prosemirror-state";
 import { Decoration, DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/extensions/nodes/TableExtension.ts
 /**
@@ -190,7 +190,7 @@ const tableSpec = {
 	}
 };
 const tableRowSpec = {
-	content: "(tableCell | tableHeader)+",
+	content: "(tableCell | tableHeader)*",
 	tableRole: "row",
 	attrs: {
 		height: { default: null },
@@ -198,7 +198,9 @@ const tableRowSpec = {
 		isHeader: { default: false },
 		hidden: { default: false },
 		_originalFormatting: { default: null },
-		trPrChange: { default: null }
+		trPrChange: { default: null },
+		trIns: { default: null },
+		trDel: { default: null }
 	},
 	parseDOM: [{ tag: "tr" }],
 	toDOM(node) {
@@ -315,8 +317,10 @@ const tableCellSpec = {
 		margins: { default: null },
 		textDirection: { default: null },
 		noWrap: { default: false },
+		hideMark: { default: false },
 		_originalFormatting: { default: null },
 		tcPrChange: { default: null },
+		cellMarker: { default: null },
 		_preserveVMergeRestart: { default: null },
 		_docxVMergeContinuationCells: { default: null }
 	},
@@ -369,8 +373,10 @@ const tableHeaderSpec = {
 		margins: { default: null },
 		textDirection: { default: null },
 		noWrap: { default: false },
+		hideMark: { default: false },
 		_originalFormatting: { default: null },
 		tcPrChange: { default: null },
+		cellMarker: { default: null },
 		_preserveVMergeRestart: { default: null },
 		_docxVMergeContinuationCells: { default: null }
 	},

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

@@ -0,0 +1,13 @@
+import { NodeExtension } from "../types.js";
+
+//#region src/prosemirror/extensions/nodes/TextBoxAnchorExtension.d.ts
+/**
+ * Zero-width inline anchor for a text box extracted to a sibling PM block.
+ *
+ * Keeping the anchor in the paragraph lets ordinary ProseMirror transactions
+ * map its position as surrounding text is edited. The save conversion consumes
+ * it when the sibling text box is restored to the DOCX run stream.
+ */
+declare const TextBoxAnchorExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion
+export { TextBoxAnchorExtension };

package/dist/prosemirror/extensions/nodes/TextBoxAnchorExtension.js

@@ -0,0 +1,41 @@
+import { expectTextBoxAnchorAttrs } from "../../textBoxAnchorAttrs.js";
+import { createNodeExtension } from "../create.js";
+//#region src/prosemirror/extensions/nodes/TextBoxAnchorExtension.ts
+/**
+* Zero-width inline anchor for a text box extracted to a sibling PM block.
+*
+* Keeping the anchor in the paragraph lets ordinary ProseMirror transactions
+* map its position as surrounding text is edited. The save conversion consumes
+* it when the sibling text box is restored to the DOCX run stream.
+*/
+const TextBoxAnchorExtension = createNodeExtension({
+	name: "textBoxAnchor",
+	schemaNodeName: "textBoxAnchor",
+	nodeSpec: {
+		inline: true,
+		group: "inline",
+		marks: "_",
+		atom: true,
+		selectable: false,
+		attrs: { anchorId: {} },
+		parseDOM: [{
+			tag: "span[data-docx-textbox-anchor]",
+			getAttrs(dom) {
+				if (!(dom instanceof HTMLElement)) return false;
+				const anchorId = dom.dataset["docxTextboxAnchor"];
+				return anchorId ? { anchorId } : false;
+			}
+		}],
+		toDOM(node) {
+			const { anchorId } = expectTextBoxAnchorAttrs(node);
+			return ["span", {
+				"data-docx-textbox-anchor": anchorId,
+				"aria-hidden": "true",
+				contenteditable: "false",
+				style: "display: inline-block; width: 0; height: 0; overflow: hidden; pointer-events: none;"
+			}];
+		}
+	}
+});
+//#endregion
+export { TextBoxAnchorExtension };

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

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../../../types/document.js";
 import { OutlineStyleAttr } from "../../../types/documentEnumValues.js";
 import { NodeExtension } from "../types.js";
-import { ImagePositionAttrs } from "../../schema/nodes.js";
+import { ImagePositionAttrs, TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
 
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
 type TextBoxAttrs = {
@@ -28,7 +28,10 @@ type TextBoxAttrs = {
   distRight?: number; /** Position for floating/anchored text boxes. */
   position?: ImagePositionAttrs; /** Original DOCX placement hint for save-path reconstruction. */
   _docxPlacement?: "standalone" | "inlineWithPrevious"; /** Original DOCX paragraph group for standalone text-box reconstruction. */
-  _docxGroupId?: string;
+  _docxGroupId?: string; /** Inline anchor linking this block node to its source run position. */
+  _docxAnchorId?: string; /** Original run-level revision wrapper for save-path reconstruction. */
+  _docxTrackedChange?: TextBoxAttrs$1["_docxTrackedChange"]; /** Original inline content-control ancestry for save-path reconstruction. */
+  _docxInlineSdts?: TextBoxAttrs$1["_docxInlineSdts"];
 };
 declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -50,7 +50,10 @@ const TextBoxExtension = createNodeExtension({
 			distRight: { default: null },
 			position: { default: null },
 			_docxPlacement: { default: null },
-			_docxGroupId: { default: null }
+			_docxGroupId: { default: null },
+			_docxAnchorId: { default: null },
+			_docxTrackedChange: { default: null },
+			_docxInlineSdts: { default: null }
 		},
 		parseDOM: [{
 			tag: "div.docx-textbox",

package/dist/prosemirror/plugins/contentControlWidgets.d.ts

@@ -3,18 +3,24 @@ import { Plugin, PluginKey } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 
 //#region src/prosemirror/plugins/contentControlWidgets.d.ts
+type ContentControlWidgetAnchor = {
+  getBoundingClientRect: () => {
+    bottom: number;
+    left: number;
+  };
+};
 type ContentControlWidgetEvent = {
   kind: "dropdownOpen";
   tag: string; /** PM position of the clicked SDT instance — disambiguates duplicates. */
   pmPos: number;
   sdtType: "dropdown" | "comboBox";
-  anchor: HTMLElement;
+  anchor: ContentControlWidgetAnchor;
   listItemsJson: string | undefined;
 } | {
   kind: "datePick";
   tag: string;
   pmPos: number;
-  anchor: HTMLElement;
+  anchor: ContentControlWidgetAnchor;
   currentValue: string | undefined;
 } | {
   /**
@@ -26,21 +32,41 @@ type ContentControlWidgetEvent = {
   tag: string;
   pmPos: number;
   sdtType: string;
-  anchor: HTMLElement;
+  anchor: ContentControlWidgetAnchor;
   error: ContentControlLockedError | ContentControlTypeError;
 };
 type ContentControlWidgetCallback = (event: ContentControlWidgetEvent) => void;
+type ContentControlWidgetClickEvent = {
+  preventDefault: () => void;
+  target: unknown;
+};
+type ContentControlWidgetView = Pick<EditorView, "dispatch" | "state">;
+type HandleContentControlWidgetClickOptions = {
+  event: ContentControlWidgetClickEvent;
+  onEvent: ContentControlWidgetCallback;
+  view: ContentControlWidgetView;
+};
 declare const contentControlWidgetsPluginKey: PluginKey<unknown>;
 /**
  * CustomEvent name dispatched on the editor view DOM whenever the plugin
- * needs to surface a `ContentControlWidgetEvent` to the React shell. The
- * shell subscribes via `addEventListener` and renders the matching chrome.
+ * needs to surface a `ContentControlWidgetEvent` to an adapter shell. The
+ * adapter subscribes via `addEventListener` and renders the matching chrome.
  *
- * Using a CustomEvent keeps the plugin from owning a React reference and
- * makes the host's responsibility explicit: receive event → render UI →
+ * Using a CustomEvent keeps the plugin framework-neutral and makes the
+ * adapter's responsibility explicit: receive event → render UI →
  * call dispatchDropdownPick / dispatchDatePick.
  */
 declare const CONTENT_CONTROL_WIDGET_EVENT_NAME = "folio:content-control-widget";
+/**
+ * Interpret one click from either the live ProseMirror DOM or the painted page
+ * tree. Both surfaces carry the same `data-sdt-*` projection, so adapters only
+ * need to forward the click and render the resulting typed event.
+ */
+declare const handleContentControlWidgetClick: ({
+  event,
+  onEvent,
+  view
+}: HandleContentControlWidgetClickOptions) => boolean;
 declare function createContentControlWidgetsPlugin(onEvent?: ContentControlWidgetCallback): Plugin;
 /**
  * Stable resolver helpers exposed for the UI shell so a popover menu or
@@ -53,4 +79,4 @@ declare function createContentControlWidgetsPlugin(onEvent?: ContentControlWidge
 declare function dispatchDropdownPick(view: EditorView, pmPos: number, value: string): boolean;
 declare function dispatchDatePick(view: EditorView, pmPos: number, date: string): boolean;
 //#endregion
-export { CONTENT_CONTROL_WIDGET_EVENT_NAME, ContentControlWidgetCallback, ContentControlWidgetEvent, contentControlWidgetsPluginKey, createContentControlWidgetsPlugin, dispatchDatePick, dispatchDropdownPick };
+export { CONTENT_CONTROL_WIDGET_EVENT_NAME, ContentControlWidgetAnchor, ContentControlWidgetCallback, ContentControlWidgetEvent, contentControlWidgetsPluginKey, createContentControlWidgetsPlugin, dispatchDatePick, dispatchDropdownPick, handleContentControlWidgetClick };