superdoc 2.0.0-next.46 → 2.0.0-next.48

package/dist/chunks/{create-super-doc-ui-6FUZ9d-y.cjs → create-super-doc-ui-BNo2DvD1.cjs}

@@ -4814,7 +4814,11 @@ function createSuperDocUI(options) {
 		if (mirroredEditCommandState) {
 			const shippedStatus = mirroredEditCommandState.shippedStatus;
 			const supported = shippedStatus !== "not-shipped" && shippedStatus !== "disabled";
-			const reason = mirroredEditCommandState.reason === void 0 ? void 0 : coerceSuperDocUIReason(mirroredEditCommandState.reason, SUPERDOC_UI_REASONS.commandUnsupported);
+			const mirroredEnabled = typeof mirroredEditCommandState.enabled === "boolean" ? mirroredEditCommandState.enabled : true;
+			const isHistoryCommand = id === "undo" || id === "redo";
+			const historyUnread = isHistoryCommand && mirroredEditCommandState.historyResolved === false;
+			const isEmptyHistoryStack = isHistoryCommand && supported && mirroredEnabled === false && mirroredEditCommandState.reason === null && !historyUnread;
+			const reason = mirroredEditCommandState.reason === void 0 ? void 0 : isEmptyHistoryStack ? SUPERDOC_UI_REASONS.historyEmpty : historyUnread ? SUPERDOC_UI_REASONS.notReady : coerceSuperDocUIReason(mirroredEditCommandState.reason, SUPERDOC_UI_REASONS.commandUnsupported);
 			if (descriptor.mutates && readonly) return normalizeCommandState({
 				enabled: false,
 				active: false,
@@ -4822,7 +4826,7 @@ function createSuperDocUI(options) {
 				reason: SUPERDOC_UI_REASONS.documentReadonly
 			}, "builtin");
 			return normalizeCommandState({
-				enabled: supported && (typeof mirroredEditCommandState.enabled === "boolean" ? mirroredEditCommandState.enabled : true),
+				enabled: supported && mirroredEnabled,
 				active: false,
 				supported,
 				reason
@@ -5747,6 +5751,37 @@ function createSuperDocUI(options) {
 	};
 	let currentHostSelectionSource = null;
 	let detachHostSelection = null;
+	let currentEditCommandsSource = null;
+	let detachEditCommands = null;
+	let editCommandsRecomputeQueued = false;
+	const requestEditCommandsRecompute = () => {
+		if (disposed || editCommandsRecomputeQueued) return;
+		editCommandsRecomputeQueued = true;
+		const run = () => {
+			if (!editCommandsRecomputeQueued) return;
+			editCommandsRecomputeQueued = false;
+			if (disposed) return;
+			recompute();
+		};
+		if (typeof queueMicrotask === "function") queueMicrotask(run);
+		else Promise.resolve().then(run);
+	};
+	const syncEditCommandsSubscription = () => {
+		const next = getEditCommands();
+		if (next === currentEditCommandsSource) return;
+		if (detachEditCommands) {
+			detachEditCommands();
+			detachEditCommands = null;
+		}
+		currentEditCommandsSource = next;
+		if (!next || typeof next.subscribe !== "function") return;
+		try {
+			const unsubscribe = next.subscribe(() => requestEditCommandsRecompute());
+			if (typeof unsubscribe === "function") detachEditCommands = unsubscribe;
+		} catch {
+			currentEditCommandsSource = null;
+		}
+	};
 	let currentHostReviewSource = null;
 	let detachHostReview = null;
 	let currentHostEventsSource = null;
@@ -5941,8 +5976,10 @@ function createSuperDocUI(options) {
 	};
 	const recompute = () => {
 		if (disposed) return;
+		editCommandsRecomputeQueued = false;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
+		syncEditCommandsSubscription();
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
@@ -5977,6 +6014,7 @@ function createSuperDocUI(options) {
 	};
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
+	syncEditCommandsSubscription();
 	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
@@ -8810,13 +8848,19 @@ function createSuperDocUI(options) {
 					reason: SUPERDOC_UI_REASONS.operationUnavailable
 				};
 				const result = safeCall(() => editSearch.next(), null);
-				if (isPromiseLike(result)) Promise.resolve(result).then((resolved) => applyHostSearchResult(resolved, readEditCommandCanReplace())).catch(() => {
-					setSearchState({
-						available: false,
-						reason: SUPERDOC_UI_REASONS.searchUnavailable
+				if (isPromiseLike(result)) {
+					const generation = searchRequestGeneration;
+					Promise.resolve(result).then((resolved) => {
+						if (generation !== searchRequestGeneration) return;
+						applyHostSearchResult(resolved, readEditCommandCanReplace());
+					}).catch(() => {
+						if (generation !== searchRequestGeneration) return;
+						setSearchState({
+							available: false,
+							reason: SUPERDOC_UI_REASONS.searchUnavailable
+						});
 					});
-				});
-				else applyHostSearchResult(result, readEditCommandCanReplace());
+				} else applyHostSearchResult(result, readEditCommandCanReplace());
 				applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace());
 				return { ok: true };
 			}
@@ -8840,13 +8884,19 @@ function createSuperDocUI(options) {
 					reason: SUPERDOC_UI_REASONS.operationUnavailable
 				};
 				const result = safeCall(() => editSearch.previous(), null);
-				if (isPromiseLike(result)) Promise.resolve(result).then((resolved) => applyHostSearchResult(resolved, readEditCommandCanReplace())).catch(() => {
-					setSearchState({
-						available: false,
-						reason: SUPERDOC_UI_REASONS.searchUnavailable
+				if (isPromiseLike(result)) {
+					const generation = searchRequestGeneration;
+					Promise.resolve(result).then((resolved) => {
+						if (generation !== searchRequestGeneration) return;
+						applyHostSearchResult(resolved, readEditCommandCanReplace());
+					}).catch(() => {
+						if (generation !== searchRequestGeneration) return;
+						setSearchState({
+							available: false,
+							reason: SUPERDOC_UI_REASONS.searchUnavailable
+						});
 					});
-				});
-				else applyHostSearchResult(result, readEditCommandCanReplace());
+				} else applyHostSearchResult(result, readEditCommandCanReplace());
 				applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace());
 				return { ok: true };
 			}
@@ -8858,6 +8908,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		clear: () => {
+			searchRequestGeneration += 1;
 			const host = getHostSearch();
 			if (host && typeof host.clear === "function") safeCall(() => host.clear(), null);
 			if (!host || typeof host.clear !== "function") {
@@ -8885,15 +8936,19 @@ function createSuperDocUI(options) {
 				};
 				const result$1 = safeCall(() => editSearch.replace({ replacement: typeof replacement === "string" ? replacement : "" }), null);
 				if (isPromiseLike(result$1)) {
+					const generation = searchRequestGeneration;
 					syncSearchStateFromHost();
 					emitSearch();
+					const isCurrent = () => generation === searchRequestGeneration;
 					return Promise.resolve(result$1).then((resolved) => {
-						applyHostSearchResult(resolved, readEditCommandCanReplace());
-						syncSearchStateFromHost();
-						emitSearch();
+						if (isCurrent()) {
+							applyHostSearchResult(resolved, readEditCommandCanReplace());
+							syncSearchStateFromHost();
+							emitSearch();
+						}
 						return mapHostReplaceResult(resolved);
 					}, () => {
-						setSearchState({
+						if (isCurrent()) setSearchState({
 							available: false,
 							reason: SUPERDOC_UI_REASONS.searchUnavailable
 						});
@@ -8930,15 +8985,19 @@ function createSuperDocUI(options) {
 				};
 				const result$1 = safeCall(() => editSearch.replaceAll({ replacement: typeof replacement === "string" ? replacement : "" }), null);
 				if (isPromiseLike(result$1)) {
+					const generation = searchRequestGeneration;
 					syncSearchStateFromHost();
 					emitSearch();
+					const isCurrent = () => generation === searchRequestGeneration;
 					return Promise.resolve(result$1).then((resolved) => {
-						applyHostSearchResult(resolved, readEditCommandCanReplace());
-						syncSearchStateFromHost();
-						emitSearch();
+						if (isCurrent()) {
+							applyHostSearchResult(resolved, readEditCommandCanReplace());
+							syncSearchStateFromHost();
+							emitSearch();
+						}
 						return mapHostReplaceResult(resolved);
 					}, () => {
-						setSearchState({
+						if (isCurrent()) setSearchState({
 							available: false,
 							reason: SUPERDOC_UI_REASONS.searchUnavailable
 						});
@@ -9028,6 +9087,9 @@ function createSuperDocUI(options) {
 		if (detachHostSelection) detachHostSelection();
 		detachHostSelection = null;
 		currentHostSelectionSource = null;
+		if (detachEditCommands) detachEditCommands();
+		detachEditCommands = null;
+		currentEditCommandsSource = null;
 		if (detachHostReview) detachHostReview();
 		detachHostReview = null;
 		currentHostReviewSource = null;
@@ -9041,6 +9103,7 @@ function createSuperDocUI(options) {
 		searchListeners.clear();
 		painterCaptureEpoch += 1;
 		painterModeListeners.clear();
+		searchRequestGeneration += 1;
 		customCommands.clear();
 	};
 	const controller = {

package/dist/chunks/{create-super-doc-ui-DCFTmVRK.es.js → create-super-doc-ui-BmtUtDDR.es.js}

@@ -4592,7 +4592,11 @@ function createSuperDocUI(options) {
 		if (mirroredEditCommandState) {
 			const shippedStatus = mirroredEditCommandState.shippedStatus;
 			const supported = shippedStatus !== "not-shipped" && shippedStatus !== "disabled";
-			const reason = mirroredEditCommandState.reason === void 0 ? void 0 : coerceSuperDocUIReason(mirroredEditCommandState.reason, SUPERDOC_UI_REASONS.commandUnsupported);
+			const mirroredEnabled = typeof mirroredEditCommandState.enabled === "boolean" ? mirroredEditCommandState.enabled : true;
+			const isHistoryCommand = id === "undo" || id === "redo";
+			const historyUnread = isHistoryCommand && mirroredEditCommandState.historyResolved === false;
+			const isEmptyHistoryStack = isHistoryCommand && supported && mirroredEnabled === false && mirroredEditCommandState.reason === null && !historyUnread;
+			const reason = mirroredEditCommandState.reason === void 0 ? void 0 : isEmptyHistoryStack ? SUPERDOC_UI_REASONS.historyEmpty : historyUnread ? SUPERDOC_UI_REASONS.notReady : coerceSuperDocUIReason(mirroredEditCommandState.reason, SUPERDOC_UI_REASONS.commandUnsupported);
 			if (descriptor.mutates && readonly) return normalizeCommandState({
 				enabled: false,
 				active: false,
@@ -4600,7 +4604,7 @@ function createSuperDocUI(options) {
 				reason: SUPERDOC_UI_REASONS.documentReadonly
 			}, "builtin");
 			return normalizeCommandState({
-				enabled: supported && (typeof mirroredEditCommandState.enabled === "boolean" ? mirroredEditCommandState.enabled : true),
+				enabled: supported && mirroredEnabled,
 				active: false,
 				supported,
 				reason
@@ -5525,6 +5529,37 @@ function createSuperDocUI(options) {
 	};
 	let currentHostSelectionSource = null;
 	let detachHostSelection = null;
+	let currentEditCommandsSource = null;
+	let detachEditCommands = null;
+	let editCommandsRecomputeQueued = false;
+	const requestEditCommandsRecompute = () => {
+		if (disposed || editCommandsRecomputeQueued) return;
+		editCommandsRecomputeQueued = true;
+		const run = () => {
+			if (!editCommandsRecomputeQueued) return;
+			editCommandsRecomputeQueued = false;
+			if (disposed) return;
+			recompute();
+		};
+		if (typeof queueMicrotask === "function") queueMicrotask(run);
+		else Promise.resolve().then(run);
+	};
+	const syncEditCommandsSubscription = () => {
+		const next = getEditCommands();
+		if (next === currentEditCommandsSource) return;
+		if (detachEditCommands) {
+			detachEditCommands();
+			detachEditCommands = null;
+		}
+		currentEditCommandsSource = next;
+		if (!next || typeof next.subscribe !== "function") return;
+		try {
+			const unsubscribe = next.subscribe(() => requestEditCommandsRecompute());
+			if (typeof unsubscribe === "function") detachEditCommands = unsubscribe;
+		} catch {
+			currentEditCommandsSource = null;
+		}
+	};
 	let currentHostReviewSource = null;
 	let detachHostReview = null;
 	let currentHostEventsSource = null;
@@ -5719,8 +5754,10 @@ function createSuperDocUI(options) {
 	};
 	const recompute = () => {
 		if (disposed) return;
+		editCommandsRecomputeQueued = false;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
+		syncEditCommandsSubscription();
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
@@ -5755,6 +5792,7 @@ function createSuperDocUI(options) {
 	};
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
+	syncEditCommandsSubscription();
 	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
@@ -8588,13 +8626,19 @@ function createSuperDocUI(options) {
 					reason: SUPERDOC_UI_REASONS.operationUnavailable
 				};
 				const result = safeCall(() => editSearch.next(), null);
-				if (isPromiseLike(result)) Promise.resolve(result).then((resolved) => applyHostSearchResult(resolved, readEditCommandCanReplace())).catch(() => {
-					setSearchState({
-						available: false,
-						reason: SUPERDOC_UI_REASONS.searchUnavailable
+				if (isPromiseLike(result)) {
+					const generation = searchRequestGeneration;
+					Promise.resolve(result).then((resolved) => {
+						if (generation !== searchRequestGeneration) return;
+						applyHostSearchResult(resolved, readEditCommandCanReplace());
+					}).catch(() => {
+						if (generation !== searchRequestGeneration) return;
+						setSearchState({
+							available: false,
+							reason: SUPERDOC_UI_REASONS.searchUnavailable
+						});
 					});
-				});
-				else applyHostSearchResult(result, readEditCommandCanReplace());
+				} else applyHostSearchResult(result, readEditCommandCanReplace());
 				applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace());
 				return { ok: true };
 			}
@@ -8618,13 +8662,19 @@ function createSuperDocUI(options) {
 					reason: SUPERDOC_UI_REASONS.operationUnavailable
 				};
 				const result = safeCall(() => editSearch.previous(), null);
-				if (isPromiseLike(result)) Promise.resolve(result).then((resolved) => applyHostSearchResult(resolved, readEditCommandCanReplace())).catch(() => {
-					setSearchState({
-						available: false,
-						reason: SUPERDOC_UI_REASONS.searchUnavailable
+				if (isPromiseLike(result)) {
+					const generation = searchRequestGeneration;
+					Promise.resolve(result).then((resolved) => {
+						if (generation !== searchRequestGeneration) return;
+						applyHostSearchResult(resolved, readEditCommandCanReplace());
+					}).catch(() => {
+						if (generation !== searchRequestGeneration) return;
+						setSearchState({
+							available: false,
+							reason: SUPERDOC_UI_REASONS.searchUnavailable
+						});
 					});
-				});
-				else applyHostSearchResult(result, readEditCommandCanReplace());
+				} else applyHostSearchResult(result, readEditCommandCanReplace());
 				applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace());
 				return { ok: true };
 			}
@@ -8636,6 +8686,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		clear: () => {
+			searchRequestGeneration += 1;
 			const host = getHostSearch();
 			if (host && typeof host.clear === "function") safeCall(() => host.clear(), null);
 			if (!host || typeof host.clear !== "function") {
@@ -8663,15 +8714,19 @@ function createSuperDocUI(options) {
 				};
 				const result$1 = safeCall(() => editSearch.replace({ replacement: typeof replacement === "string" ? replacement : "" }), null);
 				if (isPromiseLike(result$1)) {
+					const generation = searchRequestGeneration;
 					syncSearchStateFromHost();
 					emitSearch();
+					const isCurrent = () => generation === searchRequestGeneration;
 					return Promise.resolve(result$1).then((resolved) => {
-						applyHostSearchResult(resolved, readEditCommandCanReplace());
-						syncSearchStateFromHost();
-						emitSearch();
+						if (isCurrent()) {
+							applyHostSearchResult(resolved, readEditCommandCanReplace());
+							syncSearchStateFromHost();
+							emitSearch();
+						}
 						return mapHostReplaceResult(resolved);
 					}, () => {
-						setSearchState({
+						if (isCurrent()) setSearchState({
 							available: false,
 							reason: SUPERDOC_UI_REASONS.searchUnavailable
 						});
@@ -8708,15 +8763,19 @@ function createSuperDocUI(options) {
 				};
 				const result$1 = safeCall(() => editSearch.replaceAll({ replacement: typeof replacement === "string" ? replacement : "" }), null);
 				if (isPromiseLike(result$1)) {
+					const generation = searchRequestGeneration;
 					syncSearchStateFromHost();
 					emitSearch();
+					const isCurrent = () => generation === searchRequestGeneration;
 					return Promise.resolve(result$1).then((resolved) => {
-						applyHostSearchResult(resolved, readEditCommandCanReplace());
-						syncSearchStateFromHost();
-						emitSearch();
+						if (isCurrent()) {
+							applyHostSearchResult(resolved, readEditCommandCanReplace());
+							syncSearchStateFromHost();
+							emitSearch();
+						}
 						return mapHostReplaceResult(resolved);
 					}, () => {
-						setSearchState({
+						if (isCurrent()) setSearchState({
 							available: false,
 							reason: SUPERDOC_UI_REASONS.searchUnavailable
 						});
@@ -8806,6 +8865,9 @@ function createSuperDocUI(options) {
 		if (detachHostSelection) detachHostSelection();
 		detachHostSelection = null;
 		currentHostSelectionSource = null;
+		if (detachEditCommands) detachEditCommands();
+		detachEditCommands = null;
+		currentEditCommandsSource = null;
 		if (detachHostReview) detachHostReview();
 		detachHostReview = null;
 		currentHostReviewSource = null;
@@ -8819,6 +8881,7 @@ function createSuperDocUI(options) {
 		searchListeners.clear();
 		painterCaptureEpoch += 1;
 		painterModeListeners.clear();
+		searchRequestGeneration += 1;
 		customCommands.clear();
 	};
 	const controller = {

package/dist/collaboration-upgrade-engine.cjs

@@ -7,7 +7,7 @@ const 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.0.0-next.46",
+	superdocVersion: "2.0.0-next.48",
 	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

@@ -6,7 +6,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.0.0-next.46",
+	superdocVersion: "2.0.0-next.48",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/public/ui-react.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-_dR15c8t.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-6FUZ9d-y.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BNo2DvD1.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
 function disposeOwnedUi(ref) {

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCFTmVRK.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BmtUtDDR.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
 function disposeOwnedUi(ref) {

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-6FUZ9d-y.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BNo2DvD1.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 { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCFTmVRK.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BmtUtDDR.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/composables/replace-continuation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The find/replace panel's settled-replace continuation.
+ *
+ * A worker-backed replace resolves asynchronously, and the session it belongs to
+ * can be gone by the time it does: the search handle is reassigned when the
+ * active editor changes and nulled on teardown. Publishing the resolved snapshot
+ * anyway would repopulate the panel with matches from a document the user is no
+ * longer looking at.
+ *
+ * A leaf module rather than a closure inside `useFindReplace`, following
+ * `find-shortcut-owner.js`. The guard previously lived in two byte-identical
+ * inline closures, each of which needed a full composable driving a
+ * worker-backed host caught mid-swap to reach one branch. Nothing could, so it
+ * shipped with a comment admitting it was verified by inspection only. The
+ * duplication was the tell: logic worth stating twice is worth naming once.
+ */
+/**
+ * Build the continuation that publishes a settled replace back into the panel.
+ *
+ * The session handle itself is the identity. `onSettled` always runs, including
+ * when the write is skipped: it clears the pending flag that gates the replace
+ * controls, and leaving it set would disable them with nothing left to settle.
+ *
+ * @param {{ getSnapshot: () => unknown }} session The handle captured when the replace was issued.
+ * @param {object} deps
+ * @param {() => unknown} deps.getCurrentSession Reads the live session identity.
+ * @param {(snapshot: unknown) => void} deps.applySlice Publishes a snapshot into the panel.
+ * @param {() => void} deps.onSettled Runs whether or not the write was skipped.
+ * @returns {() => void}
+ */
+export function createReplaceContinuation(session: {
+    getSnapshot: () => unknown;
+}, { getCurrentSession, applySlice, onSettled }: {
+    getCurrentSession: () => unknown;
+    applySlice: (snapshot: unknown) => void;
+    onSettled: () => void;
+}): () => void;

package/dist/superdoc/src/internal/toolbar/built-in/default-items.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Set or clear the link item's `href` without disturbing the rest of its
+ * attributes. The static configuration (`ariaLabel`, and anything added later)
+ * lives in the same object as the transient href, so rebuilding that object
+ * from the keys a caller knows about silently drops the others.
+ *
+ * Exported because the built-in toolbar's `updateToolbarState()` writes the
+ * href on its own path, without going through this item's handlers. Both
+ * callers share this one rule so the two cannot drift apart.
+ */
+export function withLinkHref(attributes: any, href: any): any;
 export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, }?: {
     isDev?: boolean | undefined;
 }): {

package/dist/superdoc.cjs

@@ -6,7 +6,7 @@ const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-BdUBlUeG.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BTwbGDKw.cjs");
 const require_constants = require("./chunks/constants-sbCZ2O_A.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-6FUZ9d-y.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BNo2DvD1.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -10554,6 +10554,14 @@ function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig, onUnhan
 		destroy
 	};
 }
+function createReplaceContinuation(session, { getCurrentSession, applySlice, onSettled }) {
+	return () => {
+		if (session === getCurrentSession()) try {
+			applySlice(session.getSnapshot());
+		} catch {}
+		onSettled();
+	};
+}
 var DEFAULT_TEXTS = {
 	findPlaceholder: "Find",
 	findAriaLabel: "Find text",
@@ -10738,12 +10746,13 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			if (!canReplaceState.value) return;
 			const search = currentV2Search;
 			replacePending.value = true;
-			const finish = () => {
-				try {
-					applyV2Slice(search.getSnapshot());
-				} catch {}
-				replacePending.value = false;
-			};
+			const finish = createReplaceContinuation(search, {
+				getCurrentSession: () => currentV2Search,
+				applySlice: applyV2Slice,
+				onSettled: () => {
+					replacePending.value = false;
+				}
+			});
 			let result = null;
 			try {
 				result = search.replace(replaceText.value);
@@ -10767,12 +10776,13 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			if (!canReplaceState.value) return;
 			const search = currentV2Search;
 			replacePending.value = true;
-			const finish = () => {
-				try {
-					applyV2Slice(search.getSnapshot());
-				} catch {}
-				replacePending.value = false;
-			};
+			const finish = createReplaceContinuation(search, {
+				getCurrentSession: () => currentV2Search,
+				applySlice: applyV2Slice,
+				onSettled: () => {
+					replacePending.value = false;
+				}
+			});
 			let result = null;
 			try {
 				result = search.replaceAll(replaceText.value);
@@ -32628,6 +32638,12 @@ var check_default = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 448
 var closeDropdown = (dropdown) => {
 	dropdown.expand.value = false;
 };
+function withLinkHref(attributes, href) {
+	const next = { ...attributes ?? {} };
+	if (href) next.href = href;
+	else delete next.href;
+	return next;
+}
 function selectionTargetFromTextTarget(target) {
 	const segments = Array.isArray(target?.segments) ? target.segments : [];
 	if (target?.kind !== "text" || !segments.length) return null;
@@ -32905,11 +32921,10 @@ const makeDefaultItems = ({ superToolbar, toolbarIcons: toolbarIcons$1, toolbarT
 			render: () => renderLinkDropdown(link)
 		}],
 		onActivate: ({ href }) => {
-			if (href) link.attributes.value = { href };
-			else link.attributes.value = {};
+			link.attributes.value = withLinkHref(link.attributes.value, href);
 		},
 		onDeactivate: () => {
-			link.attributes.value = {};
+			link.attributes.value = withLinkHref(link.attributes.value, null);
 			link.expand.value = false;
 		}
 	});
@@ -34192,7 +34207,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 			},
 			link: () => {
 				item.active.value = Boolean(commandState?.active);
-				item.attributes.value = commandState?.value ? { href: commandState.value } : {};
+				item.attributes.value = withLinkHref(item.attributes.value, commandState?.value ?? null);
 			},
 			fontFamily: () => {
 				if (commandState?.value != null) {
@@ -34695,7 +34710,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.0.0-next.46";
+		this.version = "2.0.0-next.48";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];