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

package/dist/chunks/{create-super-doc-ui-Cr_04XnJ.es.js → create-super-doc-ui-DqCrc6Vw.es.js}

@@ -4340,6 +4340,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();
 }
@@ -6081,6 +6084,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;
@@ -7375,6 +7379,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,
@@ -7420,10 +7439,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,
@@ -7432,7 +7464,7 @@ function createSuperDocUI(options) {
 				inflightToken: null
 			});
 			recompute();
-			return state.selection;
+			return selectionSliceFromInfo(null, "pending");
 		}
 		let raw;
 		try {
@@ -7442,15 +7474,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;
@@ -8101,6 +8135,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"
@@ -8296,9 +8334,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,
@@ -8627,6 +8665,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;
@@ -8669,13 +8708,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;
 		}
@@ -10319,7 +10355,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();
@@ -10448,6 +10492,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);
@@ -10698,7 +10743,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();
@@ -10709,7 +10754,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") {
@@ -10998,155 +11043,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) => {
@@ -11338,9 +11442,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;
@@ -11354,14 +11469,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;
@@ -11407,17 +11519,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 {
@@ -11428,12 +11541,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?.();
@@ -11446,6 +11559,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;
@@ -11495,16 +11609,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,
@@ -11883,20 +11997,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)),
@@ -13522,6 +13661,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());
@@ -13538,9 +13678,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 {
@@ -14605,4 +14751,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { BUILT_IN_COMMAND_IDS as a, createImageFilePicker as c, DOM_CLASS_NAMES as d, closeInteractionHistory as f, recordInteraction as g, isWorkflowRecordingEnabled as h, registerFirstPartyCommandMutation as i, resolveImageSrc as l, getWorkflowRecording as m, executeFirstPartyCommandAsync as n, applyV2CommentInvalidationFromMutation as o, createInteractionHistory as p, readFirstPartyPageNumbers as r, getV2TrackedChangeMutationImpact as s, createSuperDocUI as t, shallowEqual as u };
+export { recordInteraction as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, shallowEqual as d, DOM_CLASS_NAMES as f, isWorkflowRecordingEnabled as g, getWorkflowRecording as h, readFirstPartyPageNumbers as i, createImageFilePicker as l, createInteractionHistory as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, closeInteractionHistory as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, resolveImageSrc as u };