superdoc 2.25.0-next.16 → 2.25.0-next.18

package/dist/chunks/{create-super-doc-ui-BbTRF-Z9.cjs → create-super-doc-ui-DZIB6Pd4.cjs}

@@ -4341,6 +4341,9 @@ function readFirstPartyPageNumbers(ui) {
 function executeFirstPartyCommandAsync(ui, id, payload) {
 	return firstPartyCommandExecutors.get(ui)?.(id, payload) ?? ui.commands.executeAsync(id, payload);
 }
+function executeFirstPartyShortcutAsync(ui, id, payload) {
+	return firstPartyCommandExecutors.get(ui)?.(id, payload, true) ?? Promise.resolve(false);
+}
 function uiBenchNowMs() {
 	return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
 }
@@ -6082,6 +6085,7 @@ function createSuperDocUI(options) {
 	* change, so an identical object means the selection has not moved since.
 	*/
 	const selectionHostSnapshots = /* @__PURE__ */ new WeakMap();
+	let wholeTableParagraphSeed = null;
 	const readHostSelectionSnapshot = () => {
 		const selectionHandle = (safeCall(() => getHost()?.getHandles?.() ?? null, null)?.editing)?.selection;
 		if (typeof selectionHandle?.getSnapshot !== "function") return null;
@@ -7376,6 +7380,21 @@ function createSuperDocUI(options) {
 		if (wholeTableSelectionChanged) {
 			typedCaretValidationHeld = false;
 			pendingSelectionSeedValidationToken = null;
+			wholeTableParagraphSeed = null;
+			const editor = getEditor();
+			const lifetime = safeCall(() => host?.getForegroundInteractionLifetime?.() ?? null, null);
+			const mount = safeCall(() => host?.getMountedHandle?.() ?? null, null);
+			const mode = readDocumentMode();
+			if (host && editor && mount && lifetime && !lifetime.aborted && mode !== null && !seed.empty && seed.tableSelection?.kind === "tableCells" && seed.tableSelection.type === "table" && seed.target?.segments.length && seed.selectionTarget) wholeTableParagraphSeed = {
+				editor,
+				host,
+				doc: editor.doc,
+				mount,
+				lifetime,
+				sourceToken: contentToken(),
+				mode,
+				info: seed
+			};
 			const token = selectionReadToken();
 			asyncReads.set("selection", {
 				token,
@@ -7421,10 +7440,23 @@ function createSuperDocUI(options) {
 			inflightToken: deferAuthoritativeRead ? null : prev?.inflightToken ?? null
 		});
 	};
+	const selectionInfoMatchesHost = (info) => {
+		const snapshot = readHostSelectionSnapshot();
+		const target = info?.selectionTarget;
+		if (!snapshot || target?.kind !== "selection") return false;
+		const matches = (point, endpoint) => {
+			const offset = target.coordinateSpace === "tracked" ? endpoint?.trackedBlockOffset : endpoint?.blockOffset;
+			return point?.kind === "text" && typeof point.blockId === "string" && point.blockId === endpoint?.blockId && typeof point.offset === "number" && point.offset === offset && storyLocatorSignature(point.story ?? target.story) === storyLocatorSignature(endpoint?.story ?? snapshot.story);
+		};
+		return matches(target.start, snapshot.anchor) && matches(target.end, snapshot.focus) || matches(target.start, snapshot.focus) && matches(target.end, snapshot.anchor);
+	};
 	const readSelectionInfoFresh = async (attempt = 0) => {
-		const selectionApi = getDoc()?.selection;
+		const doc = getDoc();
+		const selectionApi = doc?.selection;
 		const current = selectionApi?.current;
 		const token = selectionReadToken();
+		const sourceToken = contentToken();
+		const mode = readDocumentMode();
 		if (typeof current !== "function") {
 			asyncReads.set("selection", {
 				token,
@@ -7433,7 +7465,7 @@ function createSuperDocUI(options) {
 				inflightToken: null
 			});
 			recompute();
-			return state.selection;
+			return selectionSliceFromInfo(null, "pending");
 		}
 		let raw;
 		try {
@@ -7443,15 +7475,17 @@ function createSuperDocUI(options) {
 			raw = null;
 		}
 		if (disposed) return selectionSliceFromInfo(null, "pending");
-		if (selectionReadToken() !== token) return attempt < 1 ? readSelectionInfoFresh(attempt + 1) : state.selection;
+		const info = normalizeSelectionInfo(raw);
+		if (selectionReadToken() !== token && !(getDoc() === doc && contentToken() === sourceToken && readDocumentMode() === mode && selectionInfoMatchesHost(info))) return attempt < 1 ? readSelectionInfoFresh(attempt + 1) : selectionSliceFromInfo(null, "pending");
 		asyncReads.set("selection", {
-			token,
-			value: normalizeSelectionInfo(raw),
+			token: selectionReadToken(),
+			value: info,
 			hasSettled: true,
 			inflightToken: null
 		});
+		const selection = selectionSliceFromInfo(info, info ? "ready" : "pending");
 		recompute();
-		return state.selection;
+		return selection;
 	};
 	const readCommentsDirectory = () => {
 		const commentsApi = getDoc()?.comments;
@@ -8102,6 +8136,10 @@ function createSuperDocUI(options) {
 				effectiveUniformityStatus: uniformity.status
 			};
 		}
+		if (selection.empty && typeof getHost()?.readAppliedSelectionPresentation === "function" && !appliedSelectionPresentation(selection)) return {
+			values: combined,
+			effectiveUniformityStatus: "pending"
+		};
 		return {
 			values: combined,
 			effectiveUniformityStatus: "ready"
@@ -8297,9 +8335,9 @@ function createSuperDocUI(options) {
 	const projectInlineValuesWithSettledHold = (selection) => {
 		const projection = projectSelectionInlineValuesWithStatus(selection);
 		const projected = projection.values;
-		if (selection.empty) return projection;
 		const signature = selectionInlineValueSignature(selection);
 		if (!signature) return projection;
+		if (heldSettledInlineValues?.key !== signature) heldSettledInlineValues = null;
 		if (selection.status === "ready" && selectionQueryStatus(selection) === "ready" && projection.effectiveUniformityStatus === "ready") {
 			heldSettledInlineValues = {
 				key: signature,
@@ -8628,6 +8666,7 @@ function createSuperDocUI(options) {
 		}, "builtin");
 	};
 	function hyperlinkOverlapsSelection(link, selection) {
+		if (storyLocatorSignature(readEntityStory(link)) !== storyLocatorSignature(selectionStoryLocator(selection))) return false;
 		const anchor = link.address?.anchor;
 		const start = anchor?.start;
 		const end = anchor?.end;
@@ -8670,13 +8709,10 @@ function createSuperDocUI(options) {
 		if (!linksApi || typeof linksApi.list !== "function") return null;
 		const blockIds = selectionBlockIds(selection);
 		if (!canProbeEverySelectedBlock(blockIds)) return null;
+		const story = selectionStoryLocator(selection);
 		for (const blockId of blockIds) {
-			const within = {
-				kind: "block",
-				nodeType: "paragraph",
-				nodeId: blockId
-			};
-			const { value: result } = readAsync(`hyperlinks:${blockId}`, contentToken(), () => linksApi.list({ within }), (raw) => raw && typeof raw === "object" ? raw : null);
+			const within = paragraphTarget(blockId, story);
+			const { value: result } = readAsync(story ? `hyperlinks:${storyLocatorSignature(story)}:${blockId}` : `hyperlinks:${blockId}`, contentToken(), () => linksApi.list({ within }), (raw) => raw && typeof raw === "object" ? raw : null);
 			const hit = (result && Array.isArray(result.items) ? result.items : []).find((item) => hyperlinkOverlapsSelection(item, selection));
 			if (hit) return hit;
 		}
@@ -10320,7 +10356,15 @@ function createSuperDocUI(options) {
 		if (!resolved) return false;
 		return executeTrackDecisionTarget(command.kind, resolved.target, resolved.changeId, resolved.story);
 	}
+	const hasInactiveTextSelection = () => {
+		const host = getHost();
+		const read = host?.readLiveSelectionSyncSnapshot;
+		if (typeof read !== "function") return false;
+		const info = safeCall(() => read.call(host), null);
+		return !info || info.empty === true && !info.target && !info.selectionTarget;
+	};
 	function executeListToggleCommand(kind, payload) {
+		if (hasInactiveTextSelection()) return false;
 		const lists = getEditCommands()?.lists;
 		const apply = lists?.apply;
 		const host = getHost();
@@ -10449,6 +10493,7 @@ function createSuperDocUI(options) {
 	/** Clear-patch to send for the current document mode (see TRACKED_CLEAR_INLINE_PATCH). */
 	const clearInlinePatchForMode = () => readDocumentMode() === "suggesting" ? TRACKED_CLEAR_INLINE_PATCH : CLEAR_INLINE_PATCH;
 	const callEditorMutation = (route, op, input) => {
+		if ((route.startsWith("format.paragraph.") || route.startsWith("lists.") || route.startsWith("styles.paragraph.")) && hasInactiveTextSelection()) return false;
 		const options = editorMutationOptionsForRoute(route);
 		if (options && options.success === false) return options;
 		return options ? op(input, options) : op(input);
@@ -10699,7 +10744,7 @@ function createSuperDocUI(options) {
 	* command drops all stored marks. The host applies the store to the created
 	* span on the next insert; settleCommandExecution drives the recompute.
 	*/
-	const storePendingInlineFormat = (descriptor, payload) => {
+	const storePendingInlineFormat = (descriptor, payload, selection = state.selection) => {
 		const spec = descriptor.inline;
 		const method = inlineFormatMethod(descriptor);
 		const host = getHost();
@@ -10710,7 +10755,7 @@ function createSuperDocUI(options) {
 		}
 		if (!method) return false;
 		let value;
-		if (spec.kind === "toggle") value = !commandActiveState(descriptor, getDoc(), state.selection);
+		if (spec.kind === "toggle") value = !commandActiveState(descriptor, getDoc(), selection);
 		else {
 			const raw = payload && typeof payload === "object" && "value" in payload ? payload.value : payload;
 			if (spec.kind === "value-number") {
@@ -10999,155 +11044,214 @@ function createSuperDocUI(options) {
 		const currentText = typeof record.currentText === "string" ? record.currentText : void 0;
 		const requestedHyperlinkTarget = isLooseObject(record.hyperlinkTarget) ? record.hyperlinkTarget : null;
 		const requestedTextTarget = isLooseObject(record.textTarget) ? record.textTarget : null;
-		const existing = resolveCurrentHyperlink(doc, state.selection);
 		const hasRequestedHyperlinkTarget = typeof requestedHyperlinkTarget?.storyId === "string" && typeof requestedHyperlinkTarget?.hyperlinkNodeId === "string";
-		if (hasRequestedHyperlinkTarget && href === null) {
-			const remove = linksApi.remove;
-			if (typeof remove !== "function") return false;
-			try {
-				return callEditorMutation("hyperlinks.remove", remove, {
-					storyId: requestedHyperlinkTarget.storyId,
-					hyperlinkNodeId: requestedHyperlinkTarget.hyperlinkNodeId,
-					keepText: true
-				});
-			} catch {
-				return false;
-			}
-		}
-		if (existing && href === null) {
-			const remove = trustedLinksApi?.remove;
-			if (typeof remove !== "function") return false;
-			try {
-				return callEditorMutation("hyperlinks.remove", remove, {
-					target: existing.address,
-					mode: "unwrap"
-				});
-			} catch {
-				return false;
-			}
-		}
-		if ((existing || requestedHyperlinkTarget) && typeof href === "string" && href.trim() !== "") {
-			const patch = trustedLinksApi?.patch;
-			const updateTarget = linksApi.updateTarget;
-			if (!(!hasRequestedHyperlinkTarget && existing && typeof patch === "function") && !(hasRequestedHyperlinkTarget && typeof updateTarget === "function")) return false;
-			const shouldReplaceText = typeof text === "string" && text !== (hasRequestedHyperlinkTarget ? currentText : existing?.text ?? currentText);
-			const replace = (doc?.text)?.replace;
-			const target = shouldReplaceText ? hasRequestedHyperlinkTarget ? requestedTextTarget : hyperlinkAddressToSelectionTarget(existing?.address) : null;
-			const canReplaceText = shouldReplaceText && Boolean(target) && typeof replace === "function";
-			if (shouldReplaceText && !canReplaceText) return false;
-			const results = [];
-			const settledResults = [];
-			let hyperlinkResult = null;
-			let committedHyperlinkResult = null;
-			let settledHyperlinkResult = null;
-			let hyperlinkWasDeferred = false;
-			try {
-				if (hasRequestedHyperlinkTarget) {
-					if (typeof updateTarget !== "function") return false;
-					const operationResult = callEditorMutation("hyperlinks.updateTarget", updateTarget, {
+		const textTargets = textAddressesFromTarget(payloadTarget);
+		const caretTarget = collapsedTextAddressFromTarget(payloadTarget);
+		if (payloadTarget !== null && !textTargets.length && !caretTarget && !hasRequestedHyperlinkTarget) return false;
+		const addresses = textTargets.length ? textTargets : caretTarget ? [caretTarget] : [];
+		const linkSelection = payloadTarget !== null ? {
+			...EMPTY_SELECTION,
+			empty: textTargets.length === 0,
+			target: {
+				kind: "text",
+				segments: addresses.map((address) => ({
+					blockId: address.blockId,
+					range: address.range
+				})),
+				...addresses[0]?.story ? { story: addresses[0].story } : {}
+			}
+		} : state.selection;
+		const executeMutation = (existing) => {
+			if (hasRequestedHyperlinkTarget && href === null) {
+				const remove = linksApi.remove;
+				if (typeof remove !== "function") return false;
+				try {
+					return callEditorMutation("hyperlinks.remove", remove, {
 						storyId: requestedHyperlinkTarget.storyId,
 						hyperlinkNodeId: requestedHyperlinkTarget.hyperlinkNodeId,
-						newTarget: hyperlinkTargetFromHref(href)
+						keepText: true
 					});
-					hyperlinkWasDeferred = isPromiseLike(operationResult);
-					const result = settleOperationResult(operationResult);
-					if (!commandResultSucceeded(result.immediate)) return false;
-					results.push(result.immediate);
-					settledResults.push(result.settled);
-					hyperlinkResult = result.immediate;
-					committedHyperlinkResult = result.committed;
-					settledHyperlinkResult = result.settled;
-				} else if (existing) {
-					if (typeof patch !== "function") return false;
-					const operationResult = callEditorMutation("hyperlinks.patch", patch, {
+				} catch {
+					return false;
+				}
+			}
+			if (existing && href === null) {
+				const remove = trustedLinksApi?.remove;
+				if (typeof remove !== "function") return false;
+				try {
+					return callEditorMutation("hyperlinks.remove", remove, {
 						target: existing.address,
-						patch: { href }
+						mode: "unwrap"
 					});
-					hyperlinkWasDeferred = isPromiseLike(operationResult);
-					const result = settleOperationResult(operationResult);
-					if (!commandResultSucceeded(result.immediate)) return false;
-					results.push(result.immediate);
-					settledResults.push(result.settled);
-					hyperlinkResult = result.immediate;
-					committedHyperlinkResult = result.committed;
-					settledHyperlinkResult = result.settled;
+				} catch {
+					return false;
 				}
-			} catch {
-				return false;
 			}
-			if (canReplaceText) {
-				const combineSettledLinkEdit = (finalHyperlinkResult, finalTextResult) => {
-					if (!commandResultSucceeded(finalTextResult)) return commandResultSucceeded(finalHyperlinkResult) ? partialLinkEditFailure(finalHyperlinkResult, finalTextResult) : finalTextResult;
-					return combineCommandResults([finalHyperlinkResult, finalTextResult]);
-				};
-				const replaceTextAfterHyperlinkCommit = (finalHyperlinkResult) => {
-					if (!commandResultSucceeded(finalHyperlinkResult)) return finalHyperlinkResult;
+			if ((existing || requestedHyperlinkTarget) && typeof href === "string" && href.trim() !== "") {
+				const patch = trustedLinksApi?.patch;
+				const updateTarget = linksApi.updateTarget;
+				if (!(!hasRequestedHyperlinkTarget && existing && typeof patch === "function") && !(hasRequestedHyperlinkTarget && typeof updateTarget === "function")) return false;
+				const shouldReplaceText = typeof text === "string" && text !== (hasRequestedHyperlinkTarget ? currentText : existing?.text ?? currentText);
+				const replace = (doc?.text)?.replace;
+				const target = shouldReplaceText ? hasRequestedHyperlinkTarget ? requestedTextTarget : hyperlinkAddressToSelectionTarget(existing?.address) : null;
+				const canReplaceText = shouldReplaceText && Boolean(target) && typeof replace === "function";
+				if (shouldReplaceText && !canReplaceText) return false;
+				const results = [];
+				const settledResults = [];
+				let hyperlinkResult = null;
+				let committedHyperlinkResult = null;
+				let settledHyperlinkResult = null;
+				let hyperlinkWasDeferred = false;
+				try {
+					if (hasRequestedHyperlinkTarget) {
+						if (typeof updateTarget !== "function") return false;
+						const operationResult = callEditorMutation("hyperlinks.updateTarget", updateTarget, {
+							storyId: requestedHyperlinkTarget.storyId,
+							hyperlinkNodeId: requestedHyperlinkTarget.hyperlinkNodeId,
+							newTarget: hyperlinkTargetFromHref(href)
+						});
+						hyperlinkWasDeferred = isPromiseLike(operationResult);
+						const result = settleOperationResult(operationResult);
+						if (!commandResultSucceeded(result.immediate)) return false;
+						results.push(result.immediate);
+						settledResults.push(result.settled);
+						hyperlinkResult = result.immediate;
+						committedHyperlinkResult = result.committed;
+						settledHyperlinkResult = result.settled;
+					} else if (existing) {
+						if (typeof patch !== "function") return false;
+						const operationResult = callEditorMutation("hyperlinks.patch", patch, {
+							target: existing.address,
+							patch: { href }
+						});
+						hyperlinkWasDeferred = isPromiseLike(operationResult);
+						const result = settleOperationResult(operationResult);
+						if (!commandResultSucceeded(result.immediate)) return false;
+						results.push(result.immediate);
+						settledResults.push(result.settled);
+						hyperlinkResult = result.immediate;
+						committedHyperlinkResult = result.committed;
+						settledHyperlinkResult = result.settled;
+					}
+				} catch {
+					return false;
+				}
+				if (canReplaceText) {
+					const combineSettledLinkEdit = (finalHyperlinkResult, finalTextResult) => {
+						if (!commandResultSucceeded(finalTextResult)) return commandResultSucceeded(finalHyperlinkResult) ? partialLinkEditFailure(finalHyperlinkResult, finalTextResult) : finalTextResult;
+						return combineCommandResults([finalHyperlinkResult, finalTextResult]);
+					};
+					const replaceTextAfterHyperlinkCommit = (finalHyperlinkResult) => {
+						if (!commandResultSucceeded(finalHyperlinkResult)) return finalHyperlinkResult;
+						try {
+							const result = settleOperationResult(callEditorMutation("text.replace", replace, {
+								target,
+								text
+							}));
+							if (!commandResultSucceeded(result.immediate)) return partialLinkEditFailure(finalHyperlinkResult, result.immediate);
+							return Promise.all([settledHyperlinkResult ?? Promise.resolve(finalHyperlinkResult), result.settled]).then(([settledHyperlink, finalTextResult]) => combineSettledLinkEdit(settledHyperlink, finalTextResult));
+						} catch {
+							return partialLinkEditFailure(finalHyperlinkResult, false);
+						}
+					};
+					if (hyperlinkWasDeferred) {
+						pendingCommandSettlement = (committedHyperlinkResult ?? Promise.resolve(hyperlinkResult ?? false)).then(replaceTextAfterHyperlinkCommit);
+						return combineCommandResults(results);
+					}
 					try {
 						const result = settleOperationResult(callEditorMutation("text.replace", replace, {
 							target,
 							text
 						}));
-						if (!commandResultSucceeded(result.immediate)) return partialLinkEditFailure(finalHyperlinkResult, result.immediate);
-						return Promise.all([settledHyperlinkResult ?? Promise.resolve(finalHyperlinkResult), result.settled]).then(([settledHyperlink, finalTextResult]) => combineSettledLinkEdit(settledHyperlink, finalTextResult));
+						if (!commandResultSucceeded(result.immediate)) return hyperlinkResult ? partialLinkEditFailure(hyperlinkResult, result.immediate) : result.immediate;
+						results.push(result.immediate);
+						settledResults.push(result.settled);
+						pendingCommandSettlement = Promise.all([settledHyperlinkResult ?? Promise.resolve(hyperlinkResult ?? false), result.settled]).then(([finalHyperlinkResult, finalTextResult]) => {
+							return combineSettledLinkEdit(finalHyperlinkResult, finalTextResult);
+						});
 					} catch {
-						return partialLinkEditFailure(finalHyperlinkResult, false);
+						return hyperlinkResult ? partialLinkEditFailure(hyperlinkResult, false) : false;
 					}
-				};
-				if (hyperlinkWasDeferred) {
-					pendingCommandSettlement = (committedHyperlinkResult ?? Promise.resolve(hyperlinkResult ?? false)).then(replaceTextAfterHyperlinkCommit);
-					return combineCommandResults(results);
 				}
-				try {
-					const result = settleOperationResult(callEditorMutation("text.replace", replace, {
-						target,
-						text
-					}));
-					if (!commandResultSucceeded(result.immediate)) return hyperlinkResult ? partialLinkEditFailure(hyperlinkResult, result.immediate) : result.immediate;
-					results.push(result.immediate);
-					settledResults.push(result.settled);
-					pendingCommandSettlement = Promise.all([settledHyperlinkResult ?? Promise.resolve(hyperlinkResult ?? false), result.settled]).then(([finalHyperlinkResult, finalTextResult]) => {
-						return combineSettledLinkEdit(finalHyperlinkResult, finalTextResult);
-					});
-				} catch {
-					return hyperlinkResult ? partialLinkEditFailure(hyperlinkResult, false) : false;
+				if (!canReplaceText && settledResults.length > 0) pendingCommandSettlement = Promise.all(settledResults).then((settled) => combineCommandResults(settled));
+				return combineCommandResults(results);
+			}
+			if (typeof href === "string" && href.trim() !== "") {
+				const normalizedHref = href.trim();
+				const wrap = trustedLinksApi?.wrap;
+				const wrapTargets = payloadTarget !== null ? textTargets : selectionTextAddresses(state.selection);
+				if (wrapTargets.length > 0) {
+					if (typeof wrap !== "function") return false;
+					try {
+						return applyPerTextAddress("hyperlinks.wrap", wrap, wrapTargets, (target) => ({
+							target,
+							link: { destination: { href: normalizedHref } }
+						}));
+					} catch {
+						return false;
+					}
 				}
-			}
-			if (!canReplaceText && settledResults.length > 0) pendingCommandSettlement = Promise.all(settledResults).then((settled) => combineCommandResults(settled));
-			return combineCommandResults(results);
-		}
-		if (typeof href === "string" && href.trim() !== "") {
-			const normalizedHref = href.trim();
-			const wrap = trustedLinksApi?.wrap;
-			const textTargets = textAddressesFromTarget(payloadTarget);
-			const wrapTargets = textTargets.length > 0 ? textTargets : selectionTextAddresses(state.selection);
-			if (wrapTargets.length > 0) {
-				if (typeof wrap !== "function") return false;
+				if (requestedTextTarget && !collapsedTextAddressFromTarget(requestedTextTarget)) return false;
+				const insert = trustedLinksApi?.insert;
+				const text = readLinkPayloadText(payload, normalizedHref);
+				if (typeof insert !== "function" || text.trim() === "") return false;
+				const target = payloadTarget !== null ? caretTarget : collapsedTextAddressFromSelection(state.selection);
+				if (!target) return false;
 				try {
-					return applyPerTextAddress("hyperlinks.wrap", wrap, wrapTargets, (target) => ({
+					return callEditorMutation("hyperlinks.insert", insert, {
 						target,
+						text,
 						link: { destination: { href: normalizedHref } }
-					}));
+					});
 				} catch {
 					return false;
 				}
 			}
-			if (requestedTextTarget && !collapsedTextAddressFromTarget(requestedTextTarget)) return false;
-			const insert = trustedLinksApi?.insert;
-			const text = readLinkPayloadText(payload, normalizedHref);
-			if (typeof insert !== "function" || text.trim() === "") return false;
-			const target = collapsedTextAddressFromTarget(payloadTarget) ?? collapsedTextAddressFromSelection(state.selection);
-			if (!target) return false;
+			return false;
+		};
+		const executeResolved = (existing) => {
+			const previousSettlement = pendingCommandSettlement;
+			pendingCommandSettlement = null;
 			try {
-				return callEditorMutation("hyperlinks.insert", insert, {
-					target,
-					text,
-					link: { destination: { href: normalizedHref } }
-				});
-			} catch {
-				return false;
+				return {
+					immediate: executeMutation(existing),
+					settled: pendingCommandSettlement
+				};
+			} finally {
+				pendingCommandSettlement = previousSettlement;
 			}
+		};
+		const finish = (existing) => {
+			const result = executeResolved(existing);
+			pendingCommandSettlement = result.settled;
+			return result.immediate;
+		};
+		if (requestedHyperlinkTarget) return finish(null);
+		if (payloadTarget === null) return finish(resolveCurrentHyperlink(doc, linkSelection));
+		const blockIds = selectionBlockIds(linkSelection);
+		if (!canProbeEverySelectedBlock(blockIds) || typeof linksApi.list !== "function") return false;
+		const commandEditor = getEditor(), commandDocSource = commandEditor?.doc;
+		const commandMode = readDocumentMode(), commandContent = contentToken();
+		const story = selectionStoryLocator(linkSelection);
+		try {
+			const reads = blockIds.map((blockId) => linksApi.list({ within: paragraphTarget(blockId, story) }));
+			const validReports = (reports) => reports.every((report) => isLooseObject(report) && Array.isArray(report.items));
+			const existingFrom = (reports) => {
+				for (const report of reports) {
+					const hit = (isLooseObject(report) && Array.isArray(report.items) ? report.items : []).find((item) => hyperlinkOverlapsSelection(item, linkSelection));
+					if (hit) return hit;
+				}
+				return null;
+			};
+			if (!reads.some(isPromiseLike)) return validReports(reads) ? finish(existingFrom(reads)) : false;
+			return Promise.all(reads).then(async (reports) => {
+				if (disposed || getEditor() !== commandEditor || commandEditor?.doc !== commandDocSource || readDocumentMode() !== commandMode || contentToken() !== commandContent || !validReports(reports)) return false;
+				const result = executeResolved(existingFrom(reports));
+				return result.settled ? await result.settled : result.immediate;
+			}, () => false);
+		} catch {
+			return false;
 		}
-		return false;
 	};
 	/** Route a create command (`create.table` / `create.image` / `create.tableOfContents`). */
 	const executeCreateCommand = (descriptor, op, payload) => {
@@ -11339,9 +11443,20 @@ function createSuperDocUI(options) {
 		const record = readLinkPayloadRecord(payload);
 		return Boolean(readLinkPayloadTarget(payload) || isLooseObject(record.hyperlinkTarget) || isLooseObject(record.textTarget));
 	};
+	const currentWholeTableParagraphSelection = () => {
+		const owner = wholeTableParagraphSeed, host = getHost();
+		if (!owner || disposed || owner.lifetime.aborted || owner.host !== host || owner.editor !== getEditor() || owner.editor.doc !== owner.doc || owner.sourceToken !== contentToken() || owner.mode !== readDocumentMode() || safeCall(() => host?.getMountedHandle?.(), null) !== owner.mount) return false;
+		const tableId = owner.info.tableSelection?.tableId;
+		const activeTable = safeCall(() => host?.getHandles?.().selection?.getWholeTableNodeId?.(), null);
+		if (!tableId || activeTable !== tableId || state.selection.tableSelection?.type !== "table" || state.selection.tableSelection.tableId !== tableId || selectionSignature(state.selection) !== selectionSignature(selectionSliceFromInfo(owner.info, "ready"))) return false;
+		const applied = appliedSelectionPresentation(state.selection);
+		const info = normalizeSelectionInfo(applied?.selection);
+		return !!info && selectionInfoMatchesHost(info) && JSON.stringify(info.tableSelection) === JSON.stringify(owner.info.tableSelection);
+	};
 	const commandSelectionIsReady = (id, descriptor, payload) => {
 		const foreground = foregroundMutationState();
 		if (foreground && (foreground.active > 0 || foreground.pending > 0)) return false;
+		if (descriptor?.blockParagraph && currentWholeTableParagraphSelection()) return true;
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
@@ -11355,14 +11470,11 @@ function createSuperDocUI(options) {
 		const trackCommand = trackDecisionCommand(id);
 		const descriptor = getCommandDescriptor(id);
 		if (trackCommand?.scope === "id" && explicitTrackDecisionTarget(payload)) return false;
+		if (descriptor?.link && linkPayloadHasExplicitTarget(payload)) return false;
 		if (trackCommand?.scope !== "id" && !descriptorNeedsFreshSelection(descriptor)) return false;
 		return !commandSelectionIsReady(id, descriptor, payload);
 	};
-	const prepareCommandSelectionAsync = (id, payload) => {
-		if (!commandNeedsFreshSelection(id, payload)) return null;
-		return readSelectionInfoFresh().then(() => void 0);
-	};
-	const executeCommandInternal = (id, payload, context) => {
+	const executeCommandInternal = (id, payload, context, preparedSelection) => {
 		pendingCommandSettlement = null;
 		lastCommandSettlement = Promise.resolve(false);
 		if (disposed) return false;
@@ -11408,17 +11520,18 @@ function createSuperDocUI(options) {
 		const op = resolveDocOperation(doc, route);
 		if (!op) return false;
 		if (descriptor.inline) {
-			const { lockModesById } = computeActiveContentControlLockModes(doc?.contentControls, state.selection);
+			const selection = preparedSelection ?? state.selection;
+			const { lockModesById } = computeActiveContentControlLockModes(doc?.contentControls, selection);
 			if (contentControlLockReason(lockModesById)) return false;
-			const target = resolveInlineCommandTarget(state.selection);
+			const target = resolveInlineCommandTarget(selection);
 			if (!target) {
-				if (!canStorePendingInlineFormat(state.selection)) return settleCommandExecution(false);
-				return settleCommandExecution(storePendingInlineFormat(descriptor, normalized));
+				if (!canStorePendingInlineFormat(selection)) return settleCommandExecution(false);
+				return settleCommandExecution(storePendingInlineFormat(descriptor, normalized, selection));
 			}
-			const active = commandActiveState(descriptor, doc, state.selection);
+			const active = commandActiveState(descriptor, doc, selection);
 			const input = buildInlineFormatInput(descriptor.inline, target, normalized, active);
 			if (!input) return false;
-			const commandSelection = state.selection;
+			const commandSelection = selection;
 			const tableCellSelection = tableCellSelectionForTarget(target);
 			let releaseScheduledMutation = null;
 			try {
@@ -11429,12 +11542,12 @@ function createSuperDocUI(options) {
 					if (getEditor() !== commandEditor || commandEditor?.doc !== commandDocSource || readDocumentMode() !== commandMode) return false;
 					return callInlineFormatMutation(route, op, input, commandSelection, tableCellSelection);
 				};
-				const selectionSignature = selectionInlineValueSignature(state.selection) ?? selectionKey(state.selection);
+				const selectionSignature = selectionInlineValueSignature(selection) ?? selectionKey(selection);
 				const scheduledMutation = descriptor.inline.kind === "toggle" ? scheduleInlineToggleMutation(`${descriptor.id}:${selectionSignature}`, mutate) : null;
 				releaseScheduledMutation = scheduledMutation?.release ?? null;
 				const mutationResult = scheduledMutation ? scheduledMutation.result : mutate();
-				const optimisticGeneration = captureOptimisticInlineToggle(descriptor, state.selection, input, mutationResult);
-				const result = decorateInlineCommandResult(descriptor, state.selection, input, mutationResult);
+				const optimisticGeneration = captureOptimisticInlineToggle(descriptor, selection, input, mutationResult);
+				const result = decorateInlineCommandResult(descriptor, selection, input, mutationResult);
 				const immediate = settleCommandExecution(result, (settled) => {
 					settleOptimisticInlineToggle(descriptor, optimisticGeneration, settled);
 					releaseScheduledMutation?.();
@@ -11447,6 +11560,7 @@ function createSuperDocUI(options) {
 				return false;
 			}
 		}
+		if ((descriptor.blockParagraph || descriptor.list) && hasInactiveTextSelection()) return false;
 		if (descriptor.blockParagraph) {
 			const result = executeBlockParagraph(descriptor, op, normalized);
 			const optimisticAlignmentGeneration = descriptor.blockParagraph.kind === "alignment" && commandResultSucceeded(result) ? armOptimisticParagraphAlignment(state.selection, normalized) : null;
@@ -11496,16 +11610,16 @@ function createSuperDocUI(options) {
 			return false;
 		}
 	};
-	const runCommand = (id, payload, context, firstParty) => {
+	const runCommand = (id, payload, context, firstParty, preparedSelection) => {
 		const actionId = beginInteraction(superdoc, "command:started", () => ({
 			commandId: id,
-			selection: state.selection
+			selection: preparedSelection ?? state.selection
 		}));
 		let result;
 		const previousCommandDoc = firstPartyCommandDoc;
 		firstPartyCommandDoc = firstParty && !customCommands.has(id) ? createFirstPartyCommandDoc() : void 0;
 		try {
-			result = executeCommandInternal(id, payload, context);
+			result = executeCommandInternal(id, payload, context, preparedSelection);
 		} catch (error) {
 			recordInteraction(superdoc, "command:settled", () => ({
 				actionId,
@@ -11884,20 +11998,45 @@ function createSuperDocUI(options) {
 		if (painter.mode === "armed") exitFormatPainter();
 		recompute();
 	};
-	const runCommandAsync = (id, payload, context, firstParty) => {
-		const prepared = prepareCommandSelectionAsync(id, payload);
-		const settlement = prepared ? prepared.then(() => {
-			runCommand(id, payload, context, firstParty);
-			return lastCommandSettlement;
-		}) : (() => {
-			runCommand(id, payload, context, firstParty);
-			return lastCommandSettlement;
-		})();
+	const runCommandAsync = (id, payload, context, firstParty, requireEnabled = false) => {
+		const editor = getEditor();
+		const doc = editor?.doc;
+		const mode = readDocumentMode();
+		const host = editor?.host;
+		const reader = firstParty && getCommandDescriptor(id)?.inline?.kind === "toggle" && !customCommands.has(id) && host ? firstPartyCommandMutations.get(superdoc)?.get(host)?.selectionReader?.capture() : null;
+		let rawSelection;
+		const needsSelection = !!reader || commandNeedsFreshSelection(id, payload);
+		const execute = () => {
+			const prepared = reader ? reader.read().then((raw) => {
+				rawSelection = raw;
+				const info = reader.isCurrent(raw) ? normalizeSelectionInfo(raw) : null;
+				return selectionSliceFromInfo(info, info ? "ready" : "pending");
+			}, () => selectionSliceFromInfo(null, "pending")) : needsSelection ? readSelectionInfoFresh() : null;
+			return prepared ? prepared.then((selection) => {
+				if (disposed || getEditor() !== editor || editor?.doc !== doc || readDocumentMode() !== mode || selection.status !== "ready" || reader && !reader.isCurrent(rawSelection)) return false;
+				if (requireEnabled) {
+					const command = computeCommandState(id, getDoc(), selection, projectSelectionInlineValues(selection));
+					if (!command.supported || !command.enabled) return false;
+				}
+				runCommand(id, payload, context, firstParty, selection);
+				return lastCommandSettlement;
+			}) : (() => {
+				if (requireEnabled) {
+					const command = computeCommandState(id, getDoc(), state.selection, projectSelectionInlineValues(state.selection));
+					if (!command.supported || !command.enabled) return false;
+				}
+				runCommand(id, payload, context, firstParty);
+				return lastCommandSettlement;
+			})();
+		};
+		const runForeground = host?.runForegroundInteraction;
+		const lifetime = safeCall(() => host?.getForegroundInteractionLifetime?.(), void 0);
+		const settlement = needsSelection && typeof runForeground === "function" ? Promise.resolve(runForeground.call(host, execute, lifetime)) : Promise.resolve(execute());
 		if (getCommandDescriptor(id)?.inline?.kind === "toggle") lastInlineToggleCommandSettlement = settlement;
 		return settlement;
 	};
 	const executeCommandAsync = (id, payload, context) => runCommandAsync(id, payload, context, false);
-	const executeFirstPartyCommandAsync = (id, payload) => runCommandAsync(id, payload, void 0, true);
+	const executeFirstPartyCommandAsync = (id, payload, requireEnabled = false) => runCommandAsync(id, payload, void 0, true, requireEnabled);
 	const makeCommandHandle = (id) => ({
 		id,
 		getState: () => state.toolbar.commands[id] ?? computeCommandState(id, getDoc(), state.selection, projectSelectionInlineValues(state.selection)),
@@ -13523,6 +13662,7 @@ function createSuperDocUI(options) {
 		getContextAsync: async () => {
 			for (let attempt = 0; attempt < 2; attempt += 1) {
 				const token = selectionReadToken();
+				const editor = getEditor(), doc = editor?.doc, content = contentToken(), mode = readDocumentMode();
 				const host = getHost();
 				const read = host?.getTableContextAsync;
 				if (typeof read !== "function") return publicTableContext(readHostTableContext());
@@ -13539,9 +13679,15 @@ function createSuperDocUI(options) {
 					...EMPTY_TABLE_CONTEXT,
 					status: "pending"
 				};
-				if (token !== selectionReadToken() || host !== getHost()) continue;
+				if (host !== getHost() || editor !== getEditor() || doc !== getEditor()?.doc || content !== contentToken() || mode !== readDocumentMode()) continue;
 				const context = publicTableContext(snapshot);
 				if (context.status === "stale") continue;
+				if (token !== selectionReadToken()) {
+					const appliedSnapshot = readHostTableContext();
+					if (appliedSnapshot?.status !== "ready") continue;
+					const applied = publicTableContext(appliedSnapshot);
+					if (context.status !== "ready" || applied.status !== "ready" || JSON.stringify(context) !== JSON.stringify(applied)) continue;
+				}
 				return context;
 			}
 			return {
@@ -14654,6 +14800,12 @@ Object.defineProperty(exports, "executeFirstPartyCommandAsync", {
 		return executeFirstPartyCommandAsync;
 	}
 });
+Object.defineProperty(exports, "executeFirstPartyShortcutAsync", {
+	enumerable: true,
+	get: function() {
+		return executeFirstPartyShortcutAsync;
+	}
+});
 Object.defineProperty(exports, "getV2TrackedChangeMutationImpact", {
 	enumerable: true,
 	get: function() {