superdoc 2.20.0 → 2.20.1-next.10

package/dist/chunks/{create-super-doc-ui-D5VrP4Dx.es.js → create-super-doc-ui-Cfwszc3b.es.js}

@@ -4219,6 +4219,14 @@ function readCollapsedHostTrackChangeId(snapshot) {
 	const focusId = focusVisual?.trackChangeId;
 	return typeof anchorId === "string" && anchorId.length > 0 && anchorId === focusId ? anchorId : null;
 }
+function isNonCollapsedHostSelection(snapshot) {
+	if (!snapshot || typeof snapshot !== "object") return false;
+	const record = snapshot;
+	const anchor = record.anchor;
+	const focus = record.focus;
+	if (typeof anchor?.blockId !== "string" || !anchor.blockId || typeof focus?.blockId !== "string" || !focus.blockId || !Number.isFinite(anchor.blockOffset) || !Number.isFinite(focus.blockOffset)) return false;
+	return anchor.blockId !== focus.blockId || anchor.blockOffset !== focus.blockOffset || Number.isFinite(anchor.trackedBlockOffset) && Number.isFinite(focus.trackedBlockOffset) && anchor.trackedBlockOffset !== focus.trackedBlockOffset;
+}
 var trackedChangeIdContextCache = /* @__PURE__ */ new WeakMap();
 /**
 * Collect the raw source-provenance ids a tracked-change list item exposes,
@@ -5675,6 +5683,7 @@ function createSuperDocUI(options) {
 	let asyncReadFailureRetryAtMs = 0;
 	let foregroundAsyncRetryTimer = null;
 	let pendingSelectionSeedValidationToken = null;
+	let typedCaretValidationHeld = false;
 	let typingContentInvalidationTimer = null;
 	const pendingAsyncReadSettlements = [];
 	const scheduleAsyncRefresh = () => {
@@ -6112,6 +6121,16 @@ function createSuperDocUI(options) {
 				scheduleForegroundAsyncRetry();
 				return;
 			}
+			if (typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS) {
+				const token = selectionReadToken();
+				if (asyncReads.get("selection")?.token !== token) {
+					refreshSelectionFromHost(void 0, true);
+					if (asyncReads.get("selection")?.token === token) recompute();
+				}
+				scheduleForegroundAsyncRetry(HEAVY_READ_IDLE_POLL_MS);
+				return;
+			}
+			typedCaretValidationHeld = false;
 			const validationToken = pendingSelectionSeedValidationToken;
 			pendingSelectionSeedValidationToken = null;
 			if (validationToken === selectionReadToken()) issueAsyncRead("selection", validationToken, selectionCurrentRun, normalizeSelectionInfo);
@@ -6250,7 +6269,7 @@ function createSuperDocUI(options) {
 				}
 				if (pendingPostPaintSelectionRefresh) continue;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost();
+				refreshSelectionFromHost(void 0, true);
 				recompute(paintCompleted ? "post-paint-selection" : "post-paint-selection-failed");
 			}
 		};
@@ -6261,7 +6280,11 @@ function createSuperDocUI(options) {
 		if (typingContentInvalidationTimer) clearTimeout(typingContentInvalidationTimer);
 		typingContentInvalidationTimer = setTimeout(() => {
 			typingContentInvalidationTimer = null;
-			if (!disposed) invalidateDocumentContentAndRecompute();
+			if (!disposed) {
+				invalidateDocumentContent();
+				if (typedCaretValidationHeld && !foregroundMutationActive()) refreshSelectionFromHost(void 0, true);
+				recompute();
+			}
 		}, 500);
 	};
 	const issueAsyncRead = (key, token, run, normalize) => {
@@ -6355,6 +6378,13 @@ function createSuperDocUI(options) {
 			value: entry.value,
 			status: "ready"
 		};
+		if (key === "selection" && typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS) {
+			scheduleForegroundAsyncRetry(HEAVY_READ_IDLE_POLL_MS);
+			return {
+				value: entry?.hasSettled ? entry.value : null,
+				status: entry?.hasSettled ? "stale" : "pending"
+			};
+		}
 		if (isHeavyDocReadKey(key) && !heavyReadDemandActive(key, token)) {
 			if (hostSourceLoadPhase() === "loading") {
 				heavyReadsHeldUntilIdle = true;
@@ -6476,6 +6506,7 @@ function createSuperDocUI(options) {
 		heldSettledInlineValues = null;
 		optimisticParagraphAlignment = null;
 		pendingSelectionSeedValidationToken = null;
+		typedCaretValidationHeld = false;
 		coldAsyncReadDeferrals.clear();
 		demandedHeavyReads.clear();
 		incompleteTrackChangesDirectoryReadTokens.clear();
@@ -6647,8 +6678,9 @@ function createSuperDocUI(options) {
 	* 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
-	* cannot be resolved synchronously in worker mode, so ranges defer to the async
-	* read (seeding an empty value would wrongly disable range-only commands). The
+	* 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
 	* authoritative async read still overwrites marks/text/review overlap, but
 	* foreground typing defers and coalesces that worker hop through the shared
 	* retry gate. Previous marks are carried forward for toolbar continuity. A
@@ -6656,15 +6688,27 @@ function createSuperDocUI(options) {
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
 	*/
-	const seedCaretSelectionFromHost = (hostSelectionSnapshot) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false) => {
+		const foreground = foregroundMutationState();
+		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
+			typedCaretValidationHeld = false;
+			pendingSelectionSeedValidationToken = null;
+			issueAsyncRead("selection", selectionReadToken(), selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
 		const host = getHost();
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
 		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
+		const previousCaret = collapsedTextAddressFromSelection(state.selection);
+		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
+		const previousRange = previousCaret?.range;
+		const nextRange = nextCaret?.range;
+		const sameSeedCaret = Boolean(previousCaret && nextCaret && previousCaret.blockId === nextCaret.blockId && storyLocatorSignature(previousCaret.story) === storyLocatorSignature(nextCaret.story) && previousRange?.start === nextRange?.start);
+		typedCaretValidationHeld = Boolean(foreground && foreground.active > 0) || typedCaretValidationHeld && (afterTypingPaint || sameSeedCaret);
 		const token = selectionReadToken();
-		const foreground = foregroundMutationState();
-		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0));
+		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0)) || typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS;
 		if (!deferAuthoritativeRead) {
 			pendingSelectionSeedValidationToken = null;
 			if (issueAsyncRead("selection", token, selectionCurrentRun, normalizeSelectionInfo)) return;
@@ -6676,10 +6720,6 @@ function createSuperDocUI(options) {
 		const seedMarks = Array.isArray(seed.activeMarks) && seed.activeMarks.length > 0 ? seed.activeMarks : Array.isArray(state.selection.activeMarks) ? state.selection.activeMarks : [];
 		const seedCommentIds = Array.isArray(seed.activeCommentIds) ? seed.activeCommentIds : [];
 		const paintedTrackChangeId = readCollapsedHostTrackChangeId(hostSelectionSnapshot);
-		const previousCaret = collapsedTextAddressFromSelection(state.selection);
-		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
-		const previousRange = previousCaret?.range;
-		const nextRange = nextCaret?.range;
 		const sameActiveTypingCaret = Boolean(foreground && foreground.active > 0 && previousCaret && nextCaret && previousCaret.blockId === nextCaret.blockId && storyLocatorSignature(previousCaret.story) === storyLocatorSignature(nextCaret.story) && typeof previousRange?.start === "number" && typeof nextRange?.start === "number" && Math.abs(nextRange.start - previousRange.start) <= 2);
 		const carriedChangeIds = paintedTrackChangeId != null || sameActiveTypingCaret ? state.selection.activeChangeIds.filter((id) => paintedTrackChangeId == null || buildTrackedChangeIdContext(state.trackChanges.items).aliasesFor(id).includes(paintedTrackChangeId)) : [];
 		const seedChangeIds = Array.isArray(seed.activeChangeIds) && seed.activeChangeIds.length > 0 ? seed.activeChangeIds : carriedChangeIds;
@@ -7646,6 +7686,7 @@ function createSuperDocUI(options) {
 		if (support && (support.status === "supported" || support.enabled === true)) return void 0;
 		return SUPERDOC_UI_REASONS.bulkDecisionsDisabled;
 	};
+	const canStorePendingInlineFormat = (selection) => selection.empty && collapsedTextAddressFromSelection(selection) != null && typeof getHost()?.setPendingInlineFormat === "function";
 	const computeCommandState = (id, doc, selection, projectedInlineValues, lockModesById = /* @__PURE__ */ new Map()) => {
 		if (customCommands.has(id)) return normalizeCommandState({
 			supported: true,
@@ -7800,7 +7841,7 @@ function createSuperDocUI(options) {
 				value,
 				reason: lockReason
 			}, "builtin");
-			return normalizeCommandState(selectionBlockIds(selection).length > 0 && typeof getHost()?.setPendingInlineFormat === "function" ? {
+			return normalizeCommandState(canStorePendingInlineFormat(selection) ? {
 				enabled: true,
 				active,
 				supported: true,
@@ -8895,7 +8936,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost(snapshot);
+				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
@@ -10452,7 +10493,7 @@ function createSuperDocUI(options) {
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
 		if (descriptor.inline?.kind === "clear") return selectionBlockIds(state.selection).length > 0 || resolveInlineSelectionTarget(state.selection) != null;
-		if (descriptor.inline) return resolveInlineSelectionTarget(state.selection) != null || selectionBlockIds(state.selection).length > 0;
+		if (descriptor.inline) return resolveInlineSelectionTarget(state.selection) != null || canStorePendingInlineFormat(state.selection);
 		if (descriptor.blockParagraph || descriptor.list) return selectionBlockIds(state.selection).length > 0;
 		if (descriptor.link) return linkPayloadHasExplicitTarget(payload) || selectionTextAddresses(state.selection).length > 0 || collapsedTextAddressFromSelection(state.selection) != null || commandActiveState(descriptor, getDoc(), state.selection);
 		return true;
@@ -10518,7 +10559,7 @@ function createSuperDocUI(options) {
 			if (contentControlLockReason(lockModesById)) return false;
 			const target = resolveInlineSelectionTarget(state.selection);
 			if (!target) {
-				if (state.selection.empty === false) return settleCommandExecution(false);
+				if (!canStorePendingInlineFormat(state.selection)) return settleCommandExecution(false);
 				return settleCommandExecution(storePendingInlineFormat(descriptor, normalized));
 			}
 			const active = commandActiveState(descriptor, doc, state.selection);

package/dist/chunks/{create-super-doc-ui-BQBQsjoe.cjs → create-super-doc-ui-j8Qm5SYa.cjs}

@@ -4220,6 +4220,14 @@ function readCollapsedHostTrackChangeId(snapshot) {
 	const focusId = focusVisual?.trackChangeId;
 	return typeof anchorId === "string" && anchorId.length > 0 && anchorId === focusId ? anchorId : null;
 }
+function isNonCollapsedHostSelection(snapshot) {
+	if (!snapshot || typeof snapshot !== "object") return false;
+	const record = snapshot;
+	const anchor = record.anchor;
+	const focus = record.focus;
+	if (typeof anchor?.blockId !== "string" || !anchor.blockId || typeof focus?.blockId !== "string" || !focus.blockId || !Number.isFinite(anchor.blockOffset) || !Number.isFinite(focus.blockOffset)) return false;
+	return anchor.blockId !== focus.blockId || anchor.blockOffset !== focus.blockOffset || Number.isFinite(anchor.trackedBlockOffset) && Number.isFinite(focus.trackedBlockOffset) && anchor.trackedBlockOffset !== focus.trackedBlockOffset;
+}
 var trackedChangeIdContextCache = /* @__PURE__ */ new WeakMap();
 /**
 * Collect the raw source-provenance ids a tracked-change list item exposes,
@@ -5676,6 +5684,7 @@ function createSuperDocUI(options) {
 	let asyncReadFailureRetryAtMs = 0;
 	let foregroundAsyncRetryTimer = null;
 	let pendingSelectionSeedValidationToken = null;
+	let typedCaretValidationHeld = false;
 	let typingContentInvalidationTimer = null;
 	const pendingAsyncReadSettlements = [];
 	const scheduleAsyncRefresh = () => {
@@ -6113,6 +6122,16 @@ function createSuperDocUI(options) {
 				scheduleForegroundAsyncRetry();
 				return;
 			}
+			if (typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS) {
+				const token = selectionReadToken();
+				if (asyncReads.get("selection")?.token !== token) {
+					refreshSelectionFromHost(void 0, true);
+					if (asyncReads.get("selection")?.token === token) recompute();
+				}
+				scheduleForegroundAsyncRetry(HEAVY_READ_IDLE_POLL_MS);
+				return;
+			}
+			typedCaretValidationHeld = false;
 			const validationToken = pendingSelectionSeedValidationToken;
 			pendingSelectionSeedValidationToken = null;
 			if (validationToken === selectionReadToken()) issueAsyncRead("selection", validationToken, selectionCurrentRun, normalizeSelectionInfo);
@@ -6251,7 +6270,7 @@ function createSuperDocUI(options) {
 				}
 				if (pendingPostPaintSelectionRefresh) continue;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost();
+				refreshSelectionFromHost(void 0, true);
 				recompute(paintCompleted ? "post-paint-selection" : "post-paint-selection-failed");
 			}
 		};
@@ -6262,7 +6281,11 @@ function createSuperDocUI(options) {
 		if (typingContentInvalidationTimer) clearTimeout(typingContentInvalidationTimer);
 		typingContentInvalidationTimer = setTimeout(() => {
 			typingContentInvalidationTimer = null;
-			if (!disposed) invalidateDocumentContentAndRecompute();
+			if (!disposed) {
+				invalidateDocumentContent();
+				if (typedCaretValidationHeld && !foregroundMutationActive()) refreshSelectionFromHost(void 0, true);
+				recompute();
+			}
 		}, 500);
 	};
 	const issueAsyncRead = (key, token, run, normalize) => {
@@ -6356,6 +6379,13 @@ function createSuperDocUI(options) {
 			value: entry.value,
 			status: "ready"
 		};
+		if (key === "selection" && typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS) {
+			scheduleForegroundAsyncRetry(HEAVY_READ_IDLE_POLL_MS);
+			return {
+				value: entry?.hasSettled ? entry.value : null,
+				status: entry?.hasSettled ? "stale" : "pending"
+			};
+		}
 		if (isHeavyDocReadKey(key) && !heavyReadDemandActive(key, token)) {
 			if (hostSourceLoadPhase() === "loading") {
 				heavyReadsHeldUntilIdle = true;
@@ -6477,6 +6507,7 @@ function createSuperDocUI(options) {
 		heldSettledInlineValues = null;
 		optimisticParagraphAlignment = null;
 		pendingSelectionSeedValidationToken = null;
+		typedCaretValidationHeld = false;
 		coldAsyncReadDeferrals.clear();
 		demandedHeavyReads.clear();
 		incompleteTrackChangesDirectoryReadTokens.clear();
@@ -6648,8 +6679,9 @@ function createSuperDocUI(options) {
 	* 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
-	* cannot be resolved synchronously in worker mode, so ranges defer to the async
-	* read (seeding an empty value would wrongly disable range-only commands). The
+	* 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
 	* authoritative async read still overwrites marks/text/review overlap, but
 	* foreground typing defers and coalesces that worker hop through the shared
 	* retry gate. Previous marks are carried forward for toolbar continuity. A
@@ -6657,15 +6689,27 @@ function createSuperDocUI(options) {
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
 	*/
-	const seedCaretSelectionFromHost = (hostSelectionSnapshot) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot, afterTypingPaint = false) => {
+		const foreground = foregroundMutationState();
+		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
+			typedCaretValidationHeld = false;
+			pendingSelectionSeedValidationToken = null;
+			issueAsyncRead("selection", selectionReadToken(), selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
 		const host = getHost();
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
 		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
+		const previousCaret = collapsedTextAddressFromSelection(state.selection);
+		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
+		const previousRange = previousCaret?.range;
+		const nextRange = nextCaret?.range;
+		const sameSeedCaret = Boolean(previousCaret && nextCaret && previousCaret.blockId === nextCaret.blockId && storyLocatorSignature(previousCaret.story) === storyLocatorSignature(nextCaret.story) && previousRange?.start === nextRange?.start);
+		typedCaretValidationHeld = Boolean(foreground && foreground.active > 0) || typedCaretValidationHeld && (afterTypingPaint || sameSeedCaret);
 		const token = selectionReadToken();
-		const foreground = foregroundMutationState();
-		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0));
+		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0)) || typedCaretValidationHeld && Date.now() - lastTypingMutationAtMs < HEAVY_READ_IDLE_MS;
 		if (!deferAuthoritativeRead) {
 			pendingSelectionSeedValidationToken = null;
 			if (issueAsyncRead("selection", token, selectionCurrentRun, normalizeSelectionInfo)) return;
@@ -6677,10 +6721,6 @@ function createSuperDocUI(options) {
 		const seedMarks = Array.isArray(seed.activeMarks) && seed.activeMarks.length > 0 ? seed.activeMarks : Array.isArray(state.selection.activeMarks) ? state.selection.activeMarks : [];
 		const seedCommentIds = Array.isArray(seed.activeCommentIds) ? seed.activeCommentIds : [];
 		const paintedTrackChangeId = readCollapsedHostTrackChangeId(hostSelectionSnapshot);
-		const previousCaret = collapsedTextAddressFromSelection(state.selection);
-		const nextCaret = collapsedTextAddressFromTarget(seed.selectionTarget) ?? collapsedTextAddressFromTarget(seed.target);
-		const previousRange = previousCaret?.range;
-		const nextRange = nextCaret?.range;
 		const sameActiveTypingCaret = Boolean(foreground && foreground.active > 0 && previousCaret && nextCaret && previousCaret.blockId === nextCaret.blockId && storyLocatorSignature(previousCaret.story) === storyLocatorSignature(nextCaret.story) && typeof previousRange?.start === "number" && typeof nextRange?.start === "number" && Math.abs(nextRange.start - previousRange.start) <= 2);
 		const carriedChangeIds = paintedTrackChangeId != null || sameActiveTypingCaret ? state.selection.activeChangeIds.filter((id) => paintedTrackChangeId == null || buildTrackedChangeIdContext(state.trackChanges.items).aliasesFor(id).includes(paintedTrackChangeId)) : [];
 		const seedChangeIds = Array.isArray(seed.activeChangeIds) && seed.activeChangeIds.length > 0 ? seed.activeChangeIds : carriedChangeIds;
@@ -7647,6 +7687,7 @@ function createSuperDocUI(options) {
 		if (support && (support.status === "supported" || support.enabled === true)) return void 0;
 		return SUPERDOC_UI_REASONS.bulkDecisionsDisabled;
 	};
+	const canStorePendingInlineFormat = (selection) => selection.empty && collapsedTextAddressFromSelection(selection) != null && typeof getHost()?.setPendingInlineFormat === "function";
 	const computeCommandState = (id, doc, selection, projectedInlineValues, lockModesById = /* @__PURE__ */ new Map()) => {
 		if (customCommands.has(id)) return normalizeCommandState({
 			supported: true,
@@ -7801,7 +7842,7 @@ function createSuperDocUI(options) {
 				value,
 				reason: lockReason
 			}, "builtin");
-			return normalizeCommandState(selectionBlockIds(selection).length > 0 && typeof getHost()?.setPendingInlineFormat === "function" ? {
+			return normalizeCommandState(canStorePendingInlineFormat(selection) ? {
 				enabled: true,
 				active,
 				supported: true,
@@ -8896,7 +8937,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost(snapshot);
+				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
@@ -10453,7 +10494,7 @@ function createSuperDocUI(options) {
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
 		if (descriptor.inline?.kind === "clear") return selectionBlockIds(state.selection).length > 0 || resolveInlineSelectionTarget(state.selection) != null;
-		if (descriptor.inline) return resolveInlineSelectionTarget(state.selection) != null || selectionBlockIds(state.selection).length > 0;
+		if (descriptor.inline) return resolveInlineSelectionTarget(state.selection) != null || canStorePendingInlineFormat(state.selection);
 		if (descriptor.blockParagraph || descriptor.list) return selectionBlockIds(state.selection).length > 0;
 		if (descriptor.link) return linkPayloadHasExplicitTarget(payload) || selectionTextAddresses(state.selection).length > 0 || collapsedTextAddressFromSelection(state.selection) != null || commandActiveState(descriptor, getDoc(), state.selection);
 		return true;
@@ -10519,7 +10560,7 @@ function createSuperDocUI(options) {
 			if (contentControlLockReason(lockModesById)) return false;
 			const target = resolveInlineSelectionTarget(state.selection);
 			if (!target) {
-				if (state.selection.empty === false) return settleCommandExecution(false);
+				if (!canStorePendingInlineFormat(state.selection)) return settleCommandExecution(false);
 				return settleCommandExecution(storePendingInlineFormat(descriptor, normalized));
 			}
 			const active = commandActiveState(descriptor, doc, state.selection);

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.20.0",
+	superdocVersion: "2.20.1-next.10",
 	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.20.0",
+	superdocVersion: "2.20.1-next.10",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -262,7 +262,9 @@ export interface ContentControlsPatchInput {
     tag?: string | null;
     appearance?: ContentControlAppearance | null;
     color?: string | null;
+    /** V2 rejects the entire patch with CAPABILITY_UNAVAILABLE when this field is defined, including null. */
     placeholder?: string | null;
+    /** V2 rejects the entire patch with CAPABILITY_UNAVAILABLE when this field is defined, including false. */
     showingPlaceholder?: boolean;
     temporary?: boolean;
     tabIndex?: number | null;

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -2310,8 +2310,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'contentControls.patch': {
         readonly memberPath: "contentControls.patch";
-        readonly description: "Patch metadata properties on a content control (tag, alias, appearance, color, etc.).";
-        readonly expectedResult: "Returns a ContentControlMutationResult; reports NO_OP if no fields changed.";
+        readonly description: "Patch metadata properties on a content control (tag, alias, appearance, color, etc.). V2 does not support placeholder or showingPlaceholder; defining either field rejects the entire patch without changing properties or content.";
+        readonly expectedResult: "Returns a ContentControlMutationResult; reports NO_OP if no fields changed, or CAPABILITY_UNAVAILABLE for unsupported V2 placeholder fields.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "content-controls/patch.mdx";

package/dist/document-api/src/replace/replace.d.ts

@@ -1,5 +1,5 @@
 import { RichContentMutationOptions, WriteAdapter } from '../write/write.js';
-import { SelectionTarget, TargetLocator } from '../types/address.js';
+import { SelectionTarget } from '../types/address.js';
 import { SDMutationReceipt } from '../types/sd-contract.js';
 import { SDReplaceInput } from '../types/structural-input.js';
 import { BodyStoryLocator, StoryLocator } from '../types/story.types.js';
@@ -7,15 +7,24 @@ import { BlockNodeAddress } from '../types/base.js';
 import { NestingPolicy } from '../types/placement.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
 /** Text replacement input: uses SelectionTarget / ref, or the complete main body. */
-export type TextReplaceInput = (TargetLocator & {
-    target?: SelectionTarget;
-    ref?: string;
+export type TextReplaceInput = {
+    target: SelectionTarget;
+    ref?: never;
     text: string;
+    /** Require this exact selected text before replacing a single-paragraph text selection. */
+    expectedText?: string;
     /** Target a specific document story (body, header, footer, footnote, endnote). */
     in?: StoryLocator;
-}) | {
+} | {
+    ref: string;
+    target?: never;
+    text: string;
+    expectedText?: never;
+    in?: StoryLocator;
+} | {
     target: BodyStoryLocator;
     text: string;
+    expectedText?: never;
     ref?: never;
     in?: never;
 };

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

@@ -16,6 +16,8 @@ export type SelectionReplaceRequest = TargetLocator & {
     target?: SelectionTarget;
     ref?: string;
     text: string;
+    /** Exact selected-text precondition for an explicit single-paragraph selection. */
+    expectedText?: string;
     /** Story locator threaded from the operation input's `in` field. */
     in?: StoryLocator;
 };

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-BQBQsjoe.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-j8Qm5SYa.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-D5VrP4Dx.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Cfwszc3b.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-BQBQsjoe.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-j8Qm5SYa.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-D5VrP4Dx.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Cfwszc3b.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-BQBQsjoe.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-j8Qm5SYa.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-D5VrP4Dx.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-Cfwszc3b.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };