superdoc 2.25.0-next.1 → 2.25.0-next.11

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-bTFGKVRb.cjs → create-super-doc-ui-ABeUNZlq.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",
@@ -3970,6 +3970,7 @@ Object.keys(DRAWING_SUPPORT_TAXONOMY);
 Object.freeze([
 	"multiple-sections",
 	"furniture-page-tokens",
+	"body-page-number-tokens",
 	"non-balanceable-multi-column-sections",
 	"body-anchored-objects",
 	"non-flowing-page-relative-body-anchors",
@@ -7346,7 +7347,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 +7357,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 +7372,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;
@@ -7817,7 +7834,16 @@ function createSuperDocUI(options) {
 	* query surfaces only DIRECT run properties, so inherited fonts have no
 	* projected value; the layout has already resolved them for painting.
 	*/
+	const appliedSelectionPresentation = (selection) => {
+		const host = getHost(), read = host?.readAppliedSelectionPresentation;
+		if (typeof read !== "function") return null;
+		const value = safeCall(() => read.call(host), null);
+		const info = normalizeSelectionInfo(value?.selection);
+		return value && info && selectionSignature(selectionSliceFromInfo(info, "ready")) === selectionSignature(selection) ? value : null;
+	};
 	const resolveEffectiveInlineValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -7935,6 +7961,8 @@ function createSuperDocUI(options) {
 	* `{ style: 'single' }`) when active, never a bare `true` — check presence.
 	*/
 	const resolveEffectiveMarkValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -8169,6 +8197,15 @@ function createSuperDocUI(options) {
 		const fromWorker = values?.[key];
 		return fromWorker !== void 0 ? fromWorker : null;
 	};
+	const inlineToggleStateIsCurrent = (commandId, selection) => {
+		const mark = getCommandDescriptor(commandId)?.activeMark;
+		if (!mark || !EFFECTIVE_MARK_KEYS.includes(mark)) return true;
+		if (resolveEffectiveMarkValuesFromLayout(selection)[mark] !== void 0) return true;
+		if (!resolveDocOperation(getDoc(), "format.readEffectiveInlineUniformity")) return true;
+		const { status } = readEffectiveInlineUniformityCached(selection);
+		const key = effectiveInlineUniformityCacheKey(selection);
+		return status === "ready" || key != null && asyncReads.get(key)?.failedToken === contentToken();
+	};
 	const readEffectiveInlineUniformityNow = async (input) => {
 		if (!input) return null;
 		const op = resolveDocOperation(getDoc(), "format.readEffectiveInlineUniformity");
@@ -8770,6 +8807,11 @@ function createSuperDocUI(options) {
 	};
 	/** Read effective paragraph alignments from the mounted, style-resolved layout. */
 	const readEffectiveParagraphAlignments = (selection, blockIds) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return new Map(blockIds.flatMap((id) => {
+			const alignment = normalizeParagraphAlignment(applied.paragraphAlignments?.[id]);
+			return alignment ? [[id, alignment]] : [];
+		}));
 		const host = getHost();
 		const readByIds = host?.readMountedProjectionBlocksByIds;
 		if (typeof readByIds !== "function") return null;
@@ -9486,8 +9528,8 @@ function createSuperDocUI(options) {
 		if (selection.status === "ready") pruneSelectionScopedAsyncReads(selection);
 		reconcilePendingInlineFormat(selection);
 		const selectionSignature = selectionInlineValueSignature(selection);
-		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature) optimisticInlineToggles.delete(commandId);
-		else if (optimistic.settled && selection.status === "ready") optimisticInlineToggles.delete(commandId);
+		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature || optimistic.editorSource !== getEditor() || optimistic.documentSource !== getEditor()?.doc || optimistic.documentMode !== documentMode) optimisticInlineToggles.delete(commandId);
+		else if (optimistic.settled && selection.status === "ready" && inlineToggleStateIsCurrent(commandId, selection)) optimisticInlineToggles.delete(commandId);
 		const nextState = {
 			ready: getEditor() != null,
 			documentMode,
@@ -9617,13 +9659,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;
 		}
@@ -9640,6 +9698,7 @@ function createSuperDocUI(options) {
 		return null;
 	};
 	let trackedChangeNavigationInFlight = 0;
+	let lastPublishedHostReviewTarget;
 	const syncTrackedChangeFocusFromHostReviewTarget = (rawTarget, rawSnapshot) => {
 		const rejection = (rawSnapshot && typeof rawSnapshot === "object" ? rawSnapshot : null)?.lastInteractionRejection;
 		if (rawTarget == null && rejection && typeof rejection === "object" && rejection.code === "review-target-invalidated" && rejection.detail === "not-painted" && explicitActiveChange) return false;
@@ -9667,7 +9726,18 @@ function createSuperDocUI(options) {
 			};
 		}
 		if (rawTarget == null && next == null && explicitActiveChange != null && hasPendingTrackChangeRevealFocus(explicitActiveChange)) return false;
+		const previousPublication = lastPublishedHostReviewTarget;
+		if (previousPublication && (rawTarget === previousPublication.raw || target?.origin === "panel" && previousPublication.origin === "panel" && next && previousPublication.focus && explicitActiveChangesEqual(previousPublication.focus, next))) return false;
+		lastPublishedHostReviewTarget = {
+			raw: rawTarget,
+			focus: next,
+			origin: target?.origin
+		};
 		if (explicitActiveChangesEqual(explicitActiveChange, next)) return false;
+		if (target?.origin === "panel" && explicitActiveChange && next && explicitActiveChange.id === next.id && storyLocatorSignature(explicitActiveChange.story) === storyLocatorSignature(next.story) && !explicitActiveChange.paintedEntityId && next.paintedEntityId) {
+			explicitActiveChange.paintedEntityId = next.paintedEntityId;
+			return false;
+		}
 		setExplicitActiveChange(next);
 		return true;
 	};
@@ -9679,6 +9749,7 @@ function createSuperDocUI(options) {
 			detachHostReview = null;
 		}
 		currentHostReviewSource = next;
+		lastPublishedHostReviewTarget = void 0;
 		if (!next) {
 			syncTrackedChangeFocusFromHostReviewTarget(null);
 			return;
@@ -9751,6 +9822,9 @@ function createSuperDocUI(options) {
 			const off = next.subscribe((event) => {
 				const type = event?.type;
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
+				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
+					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
+				}
 				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
 				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
 					dirtyHosts.add(host);
@@ -9917,6 +9991,7 @@ function createSuperDocUI(options) {
 					hostSeededMutationRevision.delete(replacedDirtyHost);
 				}
 				runDocumentResetHooks();
+				optimisticInlineToggles.clear();
 				asyncReads.clear();
 				invalidateDocumentContent();
 				recompute();
@@ -10410,7 +10485,10 @@ function createSuperDocUI(options) {
 			selectionSignature,
 			active: input.value === true,
 			generation,
-			settled: false
+			settled: false,
+			editorSource: getEditor(),
+			documentSource: getEditor()?.doc,
+			documentMode: readDocumentMode()
 		});
 		recompute();
 		return generation;
@@ -11252,6 +11330,8 @@ function createSuperDocUI(options) {
 		return Boolean(readLinkPayloadTarget(payload) || isLooseObject(record.hyperlinkTarget) || isLooseObject(record.textTarget));
 	};
 	const commandSelectionIsReady = (id, descriptor, payload) => {
+		const foreground = foregroundMutationState();
+		if (foreground && (foreground.active > 0 || foreground.pending > 0)) return false;
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
@@ -12958,6 +13038,23 @@ function createSuperDocUI(options) {
 				success: false,
 				reason: "not-reachable"
 			};
+			const editor = getEditor(), host = getHost();
+			const readiness = editor?.documentMutationReadiness;
+			if (typeof readiness?.whenPainted === "function") {
+				try {
+					await readiness.whenPainted.call(readiness);
+				} catch {
+					return {
+						success: false,
+						reason: "not-reachable"
+					};
+				}
+				if (getEditor() !== editor || getHost() !== host) return {
+					success: false,
+					reason: "not-ready"
+				};
+			}
+			host?.getMountedHandle?.()?.focus?.focus({ preventScroll: true });
 			activateContentControlChrome(id);
 			return { success: true };
 		}

package/dist/chunks/{create-super-doc-ui-8UTu16Lw.es.js → create-super-doc-ui-CCNvH6mr.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",
@@ -3969,6 +3969,7 @@ Object.keys(DRAWING_SUPPORT_TAXONOMY);
 Object.freeze([
 	"multiple-sections",
 	"furniture-page-tokens",
+	"body-page-number-tokens",
 	"non-balanceable-multi-column-sections",
 	"body-anchored-objects",
 	"non-flowing-page-relative-body-anchors",
@@ -7345,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
@@ -7355,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;
@@ -7368,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;
@@ -7816,7 +7833,16 @@ function createSuperDocUI(options) {
 	* query surfaces only DIRECT run properties, so inherited fonts have no
 	* projected value; the layout has already resolved them for painting.
 	*/
+	const appliedSelectionPresentation = (selection) => {
+		const host = getHost(), read = host?.readAppliedSelectionPresentation;
+		if (typeof read !== "function") return null;
+		const value = safeCall(() => read.call(host), null);
+		const info = normalizeSelectionInfo(value?.selection);
+		return value && info && selectionSignature(selectionSliceFromInfo(info, "ready")) === selectionSignature(selection) ? value : null;
+	};
 	const resolveEffectiveInlineValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -7934,6 +7960,8 @@ function createSuperDocUI(options) {
 	* `{ style: 'single' }`) when active, never a bare `true` — check presence.
 	*/
 	const resolveEffectiveMarkValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -8168,6 +8196,15 @@ function createSuperDocUI(options) {
 		const fromWorker = values?.[key];
 		return fromWorker !== void 0 ? fromWorker : null;
 	};
+	const inlineToggleStateIsCurrent = (commandId, selection) => {
+		const mark = getCommandDescriptor(commandId)?.activeMark;
+		if (!mark || !EFFECTIVE_MARK_KEYS.includes(mark)) return true;
+		if (resolveEffectiveMarkValuesFromLayout(selection)[mark] !== void 0) return true;
+		if (!resolveDocOperation(getDoc(), "format.readEffectiveInlineUniformity")) return true;
+		const { status } = readEffectiveInlineUniformityCached(selection);
+		const key = effectiveInlineUniformityCacheKey(selection);
+		return status === "ready" || key != null && asyncReads.get(key)?.failedToken === contentToken();
+	};
 	const readEffectiveInlineUniformityNow = async (input) => {
 		if (!input) return null;
 		const op = resolveDocOperation(getDoc(), "format.readEffectiveInlineUniformity");
@@ -8769,6 +8806,11 @@ function createSuperDocUI(options) {
 	};
 	/** Read effective paragraph alignments from the mounted, style-resolved layout. */
 	const readEffectiveParagraphAlignments = (selection, blockIds) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return new Map(blockIds.flatMap((id) => {
+			const alignment = normalizeParagraphAlignment(applied.paragraphAlignments?.[id]);
+			return alignment ? [[id, alignment]] : [];
+		}));
 		const host = getHost();
 		const readByIds = host?.readMountedProjectionBlocksByIds;
 		if (typeof readByIds !== "function") return null;
@@ -9485,8 +9527,8 @@ function createSuperDocUI(options) {
 		if (selection.status === "ready") pruneSelectionScopedAsyncReads(selection);
 		reconcilePendingInlineFormat(selection);
 		const selectionSignature = selectionInlineValueSignature(selection);
-		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature) optimisticInlineToggles.delete(commandId);
-		else if (optimistic.settled && selection.status === "ready") optimisticInlineToggles.delete(commandId);
+		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature || optimistic.editorSource !== getEditor() || optimistic.documentSource !== getEditor()?.doc || optimistic.documentMode !== documentMode) optimisticInlineToggles.delete(commandId);
+		else if (optimistic.settled && selection.status === "ready" && inlineToggleStateIsCurrent(commandId, selection)) optimisticInlineToggles.delete(commandId);
 		const nextState = {
 			ready: getEditor() != null,
 			documentMode,
@@ -9616,13 +9658,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;
 		}
@@ -9639,6 +9697,7 @@ function createSuperDocUI(options) {
 		return null;
 	};
 	let trackedChangeNavigationInFlight = 0;
+	let lastPublishedHostReviewTarget;
 	const syncTrackedChangeFocusFromHostReviewTarget = (rawTarget, rawSnapshot) => {
 		const rejection = (rawSnapshot && typeof rawSnapshot === "object" ? rawSnapshot : null)?.lastInteractionRejection;
 		if (rawTarget == null && rejection && typeof rejection === "object" && rejection.code === "review-target-invalidated" && rejection.detail === "not-painted" && explicitActiveChange) return false;
@@ -9666,7 +9725,18 @@ function createSuperDocUI(options) {
 			};
 		}
 		if (rawTarget == null && next == null && explicitActiveChange != null && hasPendingTrackChangeRevealFocus(explicitActiveChange)) return false;
+		const previousPublication = lastPublishedHostReviewTarget;
+		if (previousPublication && (rawTarget === previousPublication.raw || target?.origin === "panel" && previousPublication.origin === "panel" && next && previousPublication.focus && explicitActiveChangesEqual(previousPublication.focus, next))) return false;
+		lastPublishedHostReviewTarget = {
+			raw: rawTarget,
+			focus: next,
+			origin: target?.origin
+		};
 		if (explicitActiveChangesEqual(explicitActiveChange, next)) return false;
+		if (target?.origin === "panel" && explicitActiveChange && next && explicitActiveChange.id === next.id && storyLocatorSignature(explicitActiveChange.story) === storyLocatorSignature(next.story) && !explicitActiveChange.paintedEntityId && next.paintedEntityId) {
+			explicitActiveChange.paintedEntityId = next.paintedEntityId;
+			return false;
+		}
 		setExplicitActiveChange(next);
 		return true;
 	};
@@ -9678,6 +9748,7 @@ function createSuperDocUI(options) {
 			detachHostReview = null;
 		}
 		currentHostReviewSource = next;
+		lastPublishedHostReviewTarget = void 0;
 		if (!next) {
 			syncTrackedChangeFocusFromHostReviewTarget(null);
 			return;
@@ -9750,6 +9821,9 @@ function createSuperDocUI(options) {
 			const off = next.subscribe((event) => {
 				const type = event?.type;
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
+				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
+					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
+				}
 				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
 				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
 					dirtyHosts.add(host);
@@ -9916,6 +9990,7 @@ function createSuperDocUI(options) {
 					hostSeededMutationRevision.delete(replacedDirtyHost);
 				}
 				runDocumentResetHooks();
+				optimisticInlineToggles.clear();
 				asyncReads.clear();
 				invalidateDocumentContent();
 				recompute();
@@ -10409,7 +10484,10 @@ function createSuperDocUI(options) {
 			selectionSignature,
 			active: input.value === true,
 			generation,
-			settled: false
+			settled: false,
+			editorSource: getEditor(),
+			documentSource: getEditor()?.doc,
+			documentMode: readDocumentMode()
 		});
 		recompute();
 		return generation;
@@ -11251,6 +11329,8 @@ function createSuperDocUI(options) {
 		return Boolean(readLinkPayloadTarget(payload) || isLooseObject(record.hyperlinkTarget) || isLooseObject(record.textTarget));
 	};
 	const commandSelectionIsReady = (id, descriptor, payload) => {
+		const foreground = foregroundMutationState();
+		if (foreground && (foreground.active > 0 || foreground.pending > 0)) return false;
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
@@ -12957,6 +13037,23 @@ function createSuperDocUI(options) {
 				success: false,
 				reason: "not-reachable"
 			};
+			const editor = getEditor(), host = getHost();
+			const readiness = editor?.documentMutationReadiness;
+			if (typeof readiness?.whenPainted === "function") {
+				try {
+					await readiness.whenPainted.call(readiness);
+				} catch {
+					return {
+						success: false,
+						reason: "not-reachable"
+					};
+				}
+				if (getEditor() !== editor || getHost() !== host) return {
+					success: false,
+					reason: "not-ready"
+				};
+			}
+			host?.getMountedHandle?.()?.focus?.focus({ preventScroll: true });
 			activateContentControlChrome(id);
 			return { success: true };
 		}

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.11",
 	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.11",
 	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.d.ts

@@ -37,7 +37,8 @@ export interface ReplyToCommentInput extends CommentCreateAttributionInput {
 export interface MoveCommentInput {
     commentId: string;
     /**
-     * New anchor target. Accepts a plain {@link TextAddress}, a
+     * New root-thread anchor target. Existing descendant anchors move with the root.
+     * Accepts a plain {@link TextAddress}, a
      * {@link SelectionTarget}, or a {@link TrackedChangeCommentTarget} that
      * names a logical tracked-change id as a convenience re-anchor target.
      */

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[];
 }