superdoc 2.25.0-next.1 → 2.25.0-next.3

package/dist/chunks/{FindReplaceSurface-BUw19rV8.cjs → FindReplaceSurface-8V8AjgR4.cjs}

@@ -1,4 +1,4 @@
-const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-CYxINHh_.cjs");
+const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-BUdjGKyl.cjs");
 //#region src/components/surfaces/FindReplaceSurface.vue
 var _hoisted_1 = ["onKeydown"];
 var _hoisted_2 = { class: "sd-find-replace__row" };

package/dist/chunks/{FindReplaceSurface-B5dzB2sG.es.js → FindReplaceSurface-RUiTFDt3.es.js}

@@ -1,4 +1,4 @@
-import { D as normalizeClass, F as openBlock, L as ref, N as onMounted, U as toDisplayString, a as computed, c as createCommentVNode, l as createElementBlock, nt as withKeys, rt as withModifiers, t as _plugin_vue_export_helper_default, u as createElementVNode } from "./_plugin-vue_export-helper-DHiJKCsy.es.js";
+import { D as normalizeClass, F as openBlock, N as onMounted, R as ref, W as toDisplayString, a as computed, c as createCommentVNode, it as withModifiers, l as createElementBlock, rt as withKeys, t as _plugin_vue_export_helper_default, u as createElementVNode } from "./_plugin-vue_export-helper-7ZiLY07t.es.js";
 //#region src/components/surfaces/FindReplaceSurface.vue
 var _hoisted_1 = ["onKeydown"];
 var _hoisted_2 = { class: "sd-find-replace__row" };

package/dist/chunks/{PasswordPromptSurface-DaIztq50.cjs → PasswordPromptSurface-B5DHV6qr.cjs}

@@ -1,4 +1,4 @@
-const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-CYxINHh_.cjs");
+const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-BUdjGKyl.cjs");
 //#region src/components/surfaces/PasswordPromptSurface.vue
 var _hoisted_1 = ["onKeydown"];
 var _hoisted_2 = ["id"];

package/dist/chunks/{PasswordPromptSurface-Ciu8aSmK.es.js → PasswordPromptSurface-BDpxqdzp.es.js}

@@ -1,4 +1,4 @@
-import { F as openBlock, L as ref, Q as vModelText, U as toDisplayString, a as computed, c as createCommentVNode, l as createElementBlock, nt as withKeys, rt as withModifiers, t as _plugin_vue_export_helper_default, tt as withDirectives, u as createElementVNode } from "./_plugin-vue_export-helper-DHiJKCsy.es.js";
+import { $ as vModelText, F as openBlock, R as ref, W as toDisplayString, a as computed, c as createCommentVNode, it as withModifiers, l as createElementBlock, nt as withDirectives, rt as withKeys, t as _plugin_vue_export_helper_default, u as createElementVNode } from "./_plugin-vue_export-helper-7ZiLY07t.es.js";
 //#region src/components/surfaces/PasswordPromptSurface.vue
 var _hoisted_1 = ["onKeydown"];
 var _hoisted_2 = ["id"];

package/dist/chunks/{PdfViewer-B8y_9or_.es.js → PdfViewer-DjdsIh6n.es.js}

@@ -1,4 +1,4 @@
-import { $ as watch, F as openBlock, H as shallowRef, L as ref, N as onMounted, R as renderList, T as mergeProps, a as computed, c as createCommentVNode, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, n as Fragment, p as createVNode, s as createBlock, t as _plugin_vue_export_helper_default, u as createElementVNode, w as markRaw } from "./_plugin-vue_export-helper-DHiJKCsy.es.js";
+import { F as openBlock, N as onMounted, R as ref, T as mergeProps, U as shallowRef, a as computed, c as createCommentVNode, et as watch, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, n as Fragment, p as createVNode, s as createBlock, t as _plugin_vue_export_helper_default, u as createElementVNode, w as markRaw, z as renderList } from "./_plugin-vue_export-helper-7ZiLY07t.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./constants-B6VBlmKp.es.js";
 //#region src/core/pdf/helpers/floor.js
 var floor = (val, precision) => {

package/dist/chunks/{PdfViewer-DRzLH3eS.cjs → PdfViewer-omriDChK.cjs}

@@ -1,4 +1,4 @@
-const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-CYxINHh_.cjs");
+const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-BUdjGKyl.cjs");
 const require_constants = require("./constants-DpXuDx_g.cjs");
 //#region src/core/pdf/helpers/floor.js
 var floor = (val, precision) => {

package/dist/chunks/{_plugin-vue_export-helper-DHiJKCsy.es.js → _plugin-vue_export-helper-7ZiLY07t.es.js}

@@ -140,6 +140,9 @@ function onScopeDispose(...args) {
 function openBlock(...args) {
 	return runtime().openBlock(...args);
 }
+function provide(...args) {
+	return runtime().provide(...args);
+}
 function reactive(...args) {
 	return runtime().reactive(...args);
 }
@@ -208,4 +211,4 @@ var _plugin_vue_export_helper_default = (sfc, props) => {
 	return target;
 };
 //#endregion
-export { watch as $, onActivated as A, resolveDirective as B, isRef as C, normalizeClass as D, nextTick as E, openBlock as F, toRef as G, shallowRef as H, reactive as I, useAttrs as J, toRefs as K, ref as L, onDeactivated as M, onMounted as N, normalizeProps as O, onScopeDispose as P, vModelText as Q, renderList as R, isReactive as S, mergeProps as T, toDisplayString as U, resolveDynamicComponent as V, toRaw as W, vModelCheckbox as X, useSlots as Y, vModelSelect as Z, getCurrentInstance as _, computed as a, hasInjectionContext as b, createCommentVNode as c, createStaticVNode as d, withCtx as et, createTextVNode as f, effectScope as g, defineComponent as h, Transition as i, onBeforeUnmount as j, normalizeStyle as k, createElementBlock as l, defineAsyncComponent as m, Fragment as n, withKeys as nt, createApp as o, createVNode as p, unref as q, Teleport as r, withModifiers as rt, createBlock as s, _plugin_vue_export_helper_default as t, withDirectives as tt, createElementVNode as u, getCurrentScope as v, markRaw as w, inject as x, h as y, renderSlot as z };
+export { vModelText as $, onActivated as A, renderSlot as B, isRef as C, normalizeClass as D, nextTick as E, openBlock as F, toRaw as G, resolveDynamicComponent as H, provide as I, unref as J, toRef as K, reactive as L, onDeactivated as M, onMounted as N, normalizeProps as O, onScopeDispose as P, vModelSelect as Q, ref as R, isReactive as S, mergeProps as T, shallowRef as U, resolveDirective as V, toDisplayString as W, useSlots as X, useAttrs as Y, vModelCheckbox as Z, getCurrentInstance as _, computed as a, hasInjectionContext as b, createCommentVNode as c, createStaticVNode as d, watch as et, createTextVNode as f, effectScope as g, defineComponent as h, Transition as i, withModifiers as it, onBeforeUnmount as j, normalizeStyle as k, createElementBlock as l, defineAsyncComponent as m, Fragment as n, withDirectives as nt, createApp as o, createVNode as p, toRefs as q, Teleport as r, withKeys as rt, createBlock as s, _plugin_vue_export_helper_default as t, withCtx as tt, createElementVNode as u, getCurrentScope as v, markRaw as w, inject as x, h as y, renderList as z };

package/dist/chunks/{_plugin-vue_export-helper-CYxINHh_.cjs → _plugin-vue_export-helper-BUdjGKyl.cjs}

@@ -140,6 +140,9 @@ function onScopeDispose(...args) {
 function openBlock(...args) {
 	return runtime().openBlock(...args);
 }
+function provide(...args) {
+	return runtime().provide(...args);
+}
 function reactive(...args) {
 	return runtime().reactive(...args);
 }
@@ -418,6 +421,12 @@ Object.defineProperty(exports, "openBlock", {
 		return openBlock;
 	}
 });
+Object.defineProperty(exports, "provide", {
+	enumerable: true,
+	get: function() {
+		return provide;
+	}
+});
 Object.defineProperty(exports, "reactive", {
 	enumerable: true,
 	get: function() {

package/dist/chunks/{create-super-doc-ui-8UTu16Lw.es.js → create-super-doc-ui-3habU4hL.es.js}

@@ -1,4 +1,4 @@
-import { $ as watch, D as normalizeClass, E as nextTick, F as openBlock, H as shallowRef, L as ref, N as onMounted, R as renderList, U as toDisplayString, a as computed, c as createCommentVNode, f as createTextVNode, h as defineComponent, j as onBeforeUnmount, l as createElementBlock, n as Fragment, q as unref, rt as withModifiers, t as _plugin_vue_export_helper_default, u as createElementVNode } from "./_plugin-vue_export-helper-DHiJKCsy.es.js";
+import { D as normalizeClass, E as nextTick, F as openBlock, J as unref, N as onMounted, R as ref, U as shallowRef, W as toDisplayString, a as computed, c as createCommentVNode, et as watch, f as createTextVNode, h as defineComponent, it as withModifiers, j as onBeforeUnmount, l as createElementBlock, n as Fragment, t as _plugin_vue_export_helper_default, u as createElementVNode, z as renderList } from "./_plugin-vue_export-helper-7ZiLY07t.es.js";
 //#region src/internal/diagnostics/workflow-recording.ts
 var fields$1 = /* @__PURE__ */ new Set([
 	"documentId",
@@ -7345,7 +7345,7 @@ function createSuperDocUI(options) {
 	* host's local snapshot so the toolbar reflects the NEW caret's block (and the
 	* effective font resolved from it) on the next recompute, instead of serving
 	* the previous selection until the worker `selection.current` round-trip lands
-	* (SD-3652). Only a resolvable COLLAPSED CARET is seeded - a range's snapshot
+	* (SD-3652). A resolvable collapsed caret is seeded; a range's snapshot
 	* cannot be resolved synchronously in worker mode, so a new range starts an
 	* authoritative async read without waiting for the input-idle gate (SD-5394).
 	* Seeding an empty value would wrongly disable range-only commands. The
@@ -7355,8 +7355,10 @@ function createSuperDocUI(options) {
 	* tracked-change id is carried only when the host's painted caret proves the
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
+	* Explicit whole-table changes have a complete local source range and also
+	* seed clears, so a delayed worker read cannot retain a cleared table target.
 	*/
-	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false, wholeTableSelectionChanged = false) => {
 		const foreground = foregroundMutationState();
 		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
 			typedCaretValidationHeld = false;
@@ -7368,7 +7370,21 @@ function createSuperDocUI(options) {
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
-		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
+		if (!seed) return;
+		if (wholeTableSelectionChanged) {
+			typedCaretValidationHeld = false;
+			pendingSelectionSeedValidationToken = null;
+			const token = selectionReadToken();
+			asyncReads.set("selection", {
+				token,
+				value: seed,
+				hasSettled: true,
+				inflightToken: null
+			});
+			issueAsyncRead("selection", token, selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
+		if (!isCollapsedCaretSnapshot(seed)) return;
 		const previousCaret = collapsedTextAddressFromSelection(state.selection);
 		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
 		const previousRange = previousCaret?.range;
@@ -9616,13 +9632,29 @@ function createSuperDocUI(options) {
 		currentHostSelectionSource = next;
 		if (!next) return;
 		try {
+			const unsubscribeCallbacks = [];
+			detachHostSelection = () => {
+				for (const detach of unsubscribeCallbacks) detach();
+			};
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
 				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
-			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
+			if (typeof unsubscribe === "function") unsubscribeCallbacks.push(unsubscribe);
+			const host = getHost();
+			const tableSelection = safeCall(host?.getHandles ? () => host.getHandles() : void 0, null)?.selection;
+			if (typeof tableSelection?.subscribeWholeTable === "function") {
+				const refreshWholeTable = () => {
+					selectionEpoch += 1;
+					refreshSelectionFromHost(void 0, false, true);
+					recompute("host-selection");
+				};
+				const detach = tableSelection.subscribeWholeTable(refreshWholeTable);
+				if (typeof detach === "function") unsubscribeCallbacks.push(detach);
+				if (tableSelection.getWholeTableNodeId?.()) refreshWholeTable();
+			}
 		} catch {
 			currentHostSelectionSource = null;
 		}

package/dist/chunks/{create-super-doc-ui-bTFGKVRb.cjs → create-super-doc-ui-D8ss5E0J.cjs}

@@ -1,4 +1,4 @@
-const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-CYxINHh_.cjs");
+const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-BUdjGKyl.cjs");
 //#region src/internal/diagnostics/workflow-recording.ts
 var fields$1 = /* @__PURE__ */ new Set([
 	"documentId",
@@ -7346,7 +7346,7 @@ function createSuperDocUI(options) {
 	* host's local snapshot so the toolbar reflects the NEW caret's block (and the
 	* effective font resolved from it) on the next recompute, instead of serving
 	* the previous selection until the worker `selection.current` round-trip lands
-	* (SD-3652). Only a resolvable COLLAPSED CARET is seeded - a range's snapshot
+	* (SD-3652). A resolvable collapsed caret is seeded; a range's snapshot
 	* cannot be resolved synchronously in worker mode, so a new range starts an
 	* authoritative async read without waiting for the input-idle gate (SD-5394).
 	* Seeding an empty value would wrongly disable range-only commands. The
@@ -7356,8 +7356,10 @@ function createSuperDocUI(options) {
 	* tracked-change id is carried only when the host's painted caret proves the
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
+	* Explicit whole-table changes have a complete local source range and also
+	* seed clears, so a delayed worker read cannot retain a cleared table target.
 	*/
-	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false, wholeTableSelectionChanged = false) => {
 		const foreground = foregroundMutationState();
 		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
 			typedCaretValidationHeld = false;
@@ -7369,7 +7371,21 @@ function createSuperDocUI(options) {
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
-		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
+		if (!seed) return;
+		if (wholeTableSelectionChanged) {
+			typedCaretValidationHeld = false;
+			pendingSelectionSeedValidationToken = null;
+			const token = selectionReadToken();
+			asyncReads.set("selection", {
+				token,
+				value: seed,
+				hasSettled: true,
+				inflightToken: null
+			});
+			issueAsyncRead("selection", token, selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
+		if (!isCollapsedCaretSnapshot(seed)) return;
 		const previousCaret = collapsedTextAddressFromSelection(state.selection);
 		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
 		const previousRange = previousCaret?.range;
@@ -9617,13 +9633,29 @@ function createSuperDocUI(options) {
 		currentHostSelectionSource = next;
 		if (!next) return;
 		try {
+			const unsubscribeCallbacks = [];
+			detachHostSelection = () => {
+				for (const detach of unsubscribeCallbacks) detach();
+			};
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
 				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
-			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
+			if (typeof unsubscribe === "function") unsubscribeCallbacks.push(unsubscribe);
+			const host = getHost();
+			const tableSelection = safeCall(host?.getHandles ? () => host.getHandles() : void 0, null)?.selection;
+			if (typeof tableSelection?.subscribeWholeTable === "function") {
+				const refreshWholeTable = () => {
+					selectionEpoch += 1;
+					refreshSelectionFromHost(void 0, false, true);
+					recompute("host-selection");
+				};
+				const detach = tableSelection.subscribeWholeTable(refreshWholeTable);
+				if (typeof detach === "function") unsubscribeCallbacks.push(detach);
+				if (tableSelection.getWholeTableNodeId?.()) refreshWholeTable();
+			}
 		} catch {
 			currentHostSelectionSource = null;
 		}

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.1",
+	superdocVersion: "2.25.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.1",
+	superdocVersion: "2.25.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/comments/comments.types.d.ts

@@ -216,6 +216,8 @@ export interface CommentsListQuery {
  */
 export interface CommentDomain {
     address: CommentAddress;
+    /** Canonical comment id alias returned by native runtimes. */
+    commentId?: string;
     /** See {@link CommentInfo.externalId}. */
     externalId?: string;
     /** See {@link CommentInfo.metadata}. */

package/dist/document-api/src/content-controls/content-controls.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, NodeKind } from '../types/base.js';
 import { SelectionTarget } from '../types/address.js';
 import { SDFragment } from '../types/fragment.js';
-import { ReceiptFailure, ReceiptInsert } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 /**
  * Semantic SDT subtype derived from `w:sdtPr` children.
@@ -154,11 +154,13 @@ export interface ContentControlInfo {
     /** Authoritative structural emptiness when the adapter can determine it. */
     isEmpty?: boolean;
 }
-export interface ContentControlMutationSuccess {
+export interface ContentControlMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     contentControl: ContentControlTarget;
     updatedRef?: ContentControlTarget;
+    /** Identity of the block created by an adjacent-content insertion. */
+    createdBlockId?: string;
     affectedStories?: StoryLocator[];
     trackedChangeRefs?: ReceiptInsert[];
 }

package/dist/document-api/src/hyperlinks/hyperlinks.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, InlineNodeAddress } from '../types/base.js';
 import { TextAddress } from '../types/address.js';
 import { DiscoveryOutput } from '../types/discovery.js';
-import { ReceiptFailure } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptSuccess } from '../types/receipt.js';
 /** Narrowed inline address for hyperlink targets. */
 export type HyperlinkTarget = InlineNodeAddress & {
     nodeType: 'hyperlink';
@@ -74,10 +74,17 @@ export interface HyperlinkInfo {
     properties: HyperlinkReadProperties;
     text?: string;
 }
-export interface HyperlinkMutationSuccess {
+export interface HyperlinkMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     hyperlink: HyperlinkTarget;
+    /** Legacy native identifier for the mutated hyperlink, null after removal. */
+    hyperlinkNodeId?: string | null;
+    /** Package parts created or modified by the mutation. */
+    partsCreated?: readonly string[];
+    partsModified?: readonly string[];
+    /** Relationship identity created for an external destination, when present. */
+    createdRId?: string;
 }
 export interface HyperlinkMutationFailure {
     success: false;

package/dist/document-api/src/images/images.types.d.ts

@@ -1,5 +1,5 @@
 import { BlockNodeAddress } from '../types/index.js';
-import { ReceiptInsert } from '../types/receipt.js';
+import { ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 import { ContentControlTarget } from '../content-controls/content-controls.types.js';
 import { ImageProperties, ImageWrapType, ImageWrapSide, ImageMarginOffset, ImageSize, ImageCropInfo } from '../types/media.types.js';
@@ -186,7 +186,7 @@ export interface SetZOrderInput {
     imageId: string;
     zOrder: ImageZOrderInput;
 }
-export interface CreateImageSuccessResult {
+export interface CreateImageSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;
@@ -206,7 +206,7 @@ export interface ImagesListResult {
     total: number;
     items: ImageSummary[];
 }
-export interface ImagesMutationSuccessResult {
+export interface ImagesMutationSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;

package/dist/document-api/src/lists/lists.types.d.ts

@@ -1,4 +1,4 @@
-import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
+import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, ReceiptSuccess, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 export type ListItemAddress = {
     kind: 'block';
@@ -356,14 +356,14 @@ export interface ListsCaptureTemplateSuccessResult {
     template: ListTemplate;
 }
 export type ListsCaptureTemplateResult = ListsCaptureTemplateSuccessResult | ListsFailureResult;
-export interface ListsInsertSuccessResult {
+export interface ListsInsertSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
     insertionPoint: TextAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }
-export interface ListsMutateItemSuccessResult {
+export interface ListsMutateItemSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
@@ -375,38 +375,38 @@ export interface ListsMutateItemSuccessResult {
     txId?: string;
     changed?: boolean;
 }
-export interface ListsCreateSuccessResult {
+export interface ListsCreateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     item: ListItemAddress;
 }
-export interface ListsJoinSuccessResult {
+export interface ListsJoinSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
 }
-export interface ListsSeparateSuccessResult {
+export interface ListsSeparateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
 }
-export interface ListsMergeSuccessResult {
+export interface ListsMergeSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     absorbedCount: number;
     removedEmptyBlocks: number;
 }
-export interface ListsSplitSuccessResult {
+export interface ListsSplitSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
     restartedAt: number | null;
 }
-export interface ListsDetachSuccessResult {
+export interface ListsDetachSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -415,7 +415,7 @@ export interface ListsDetachSuccessResult {
         nodeId: string;
     };
 }
-export interface ListsConvertToTextSuccessResult {
+export interface ListsConvertToTextSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -447,7 +447,7 @@ export type ListsMergeResult = ListsMergeSuccessResult | ListsFailureResult;
 export type ListsSplitResult = ListsSplitSuccessResult | ListsFailureResult;
 export type ListsDetachResult = ListsDetachSuccessResult | ListsFailureResult;
 export type ListsConvertToTextResult = ListsConvertToTextSuccessResult | ListsFailureResult;
-export interface ListsDeleteSuccessResult {
+export interface ListsDeleteSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     /** Number of list items removed. */

package/dist/document-api/src/receipt-bridge.d.ts

@@ -8,6 +8,9 @@ export interface MutationReceiptBridgeContext {
 }
 interface CanonicalSuccessMetadata {
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

package/dist/document-api/src/selection/selection.types.d.ts

@@ -165,8 +165,9 @@ export interface SelectionInfo {
     selectionTarget?: SelectionTarget | null;
     /**
      * V2 browser cell context with inclusive, zero-based logical bounds.
-     * Whole-cell selections clear text targets. Character selections preserve
-     * their targets and include the containing cells, including endpoint cells.
+     * Whole-cell selections clear text targets; explicit whole-table handle selections
+     * retain resolved formatting targets. Character selections preserve their targets
+     * and include the containing cells, including endpoint cells.
      * Exact cell IDs and spans describe merged or nonrectangular selections;
      * only rectangular whole-cell metadata can become a table-cells target.
      */

package/dist/document-api/src/types/blocks.types.d.ts

@@ -144,7 +144,7 @@ export interface BlocksSplitInput {
     /** Include deleted tracked text in the offset ruler. Defaults to `visible`. */
     coordinateSpace?: 'visible' | 'tracked';
 }
-export interface BlocksSplitSuccessResult {
+export interface BlocksSplitSuccessResult extends Omit<ReceiptSuccess, 'inserted'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the new paragraph created by the split (the tail). */
@@ -173,7 +173,7 @@ export interface BlocksMergeInput {
     /** Paragraph immediately after `first` in the same story. */
     second: BlockNodeAddress;
 }
-export interface BlocksMergeSuccessResult {
+export interface BlocksMergeSuccessResult extends Omit<ReceiptSuccess, 'removed'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the paragraph that was removed (the second paragraph). */

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -5,7 +5,7 @@ import { InsertStylePolicy, StylePolicy } from './style-policy.types.js';
 import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
-import { AffectedRef } from './receipt.js';
+import { AffectedRef, ReceiptSuccess } from './receipt.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -241,7 +241,7 @@ export type StepOutcome = {
     trackedChangeIds?: string[];
     data: StepOutcomeData;
 };
-export type PlanReceipt = {
+export type PlanReceipt = ReceiptSuccess & {
     success: true;
     /** Effective mode when every committed step used the same mode. */
     appliedChangeMode?: ChangeMode;

package/dist/document-api/src/types/receipt.d.ts

@@ -110,6 +110,12 @@ export interface ReceiptEffects {
 }
 export type ReceiptSuccess = {
     success: true;
+    /** Whether a successful request changed the document; false represents a no-op commit. */
+    changed?: boolean;
+    /** Tracked changes authored by this mutation. */
+    trackedChangeRefs?: ReceiptInsert[];
+    /** Number of tracked changes authored by this mutation. */
+    trackedChangeCount?: number;
     /**
      * Mode in which this call's document content was committed. An edit folded
      * into the author's existing insertion is tracked; auxiliary style and
@@ -202,6 +208,12 @@ export type TextMutationResolution = {
 };
 export type TextMutationReceipt = (ReceiptSuccess & {
     resolution: TextMutationResolution;
+    /** Per-edit tracked-change results for atomic multi-edit mutations. */
+    trackedChangeOutcomes?: {
+        editIndex: number;
+        trackedChangeCount: number;
+        trackedChangeRefs: ReceiptInsert[];
+    }[];
 }) | (ReceiptFailureResult & {
     resolution: TextMutationResolution;
 });

package/dist/document-api/src/types/sd-contract.d.ts

@@ -32,6 +32,9 @@ export interface SDMutationReceipt {
         before: string;
         after: string;
     };
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -351,9 +351,17 @@ export interface TrackChangeStructuralDescriptor {
 export type TrackChangeTarget = {
     kind: 'text';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'replacement';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'formatting';
     address: TrackedChangeAddress;

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8ss5E0J.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8ss5E0J.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-bTFGKVRb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8ss5E0J.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-8UTu16Lw.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };