superdoc 2.25.0-next.4 → 2.25.0-next.6

package/dist/superdoc/src/composables/use-link-popover.d.ts

@@ -48,6 +48,15 @@ export type DocumentMode = import('../core/types/index.js').DocumentMode;
 export type Editor = import('../core/types/index.js').Editor;
 export type SuperDocUI = import('../public/ui/types.js').SuperDocUI;
 export type HyperlinkTarget = import('../../../document-api/src/index.js').HyperlinkTarget;
+export type LinkNavigationHost = {
+    getHandles?: () => {
+        editing?: {
+            input?: {
+                runAfterPendingInput?: (action: (signal?: AbortSignal) => Promise<boolean>) => Promise<boolean>;
+            };
+        };
+    };
+};
 /**
  * A single-block text-selection target in the Document API `query.match`
  * result shape.

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C-oN_R2a.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-ABeUNZlq.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BUdjGKyl.cjs");
@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.25.0-next.4";
+		return "2.25.0-next.6";
 	} catch {
 		return "unknown";
 	}
@@ -9236,8 +9236,10 @@ var useCommentsStore = defineStore("comments", () => {
 		};
 		const activeId = normalizeCommentId(activeComment.value);
 		if (activeId && droppedIds.has(activeId)) clearActiveCommentSelection();
+		const adapter = getV2CommentsAdapter(superdoc);
 		removedComments.forEach((comment) => {
 			const payload = typeof comment.getValues === "function" ? comment.getValues() : comment;
+			if (isCurrentV2CommentsAdapter(adapter) && adapter.isPendingCommentCreation?.(payload?.commentId)) return;
 			const event = {
 				type: COMMENT_EVENTS.DELETED,
 				comment: payload,
@@ -15755,7 +15757,9 @@ var _sfc_main$31 = {
 			viewportRevision.value;
 			const viewport = getFloatingViewportRange();
 			if (!viewport) return null;
-			const rail = container.getBoundingClientRect(), stage = props.parent?.getBoundingClientRect?.();
+			const rail = container.getBoundingClientRect();
+			const stage = typeof presentation.readPaintOrigin === "function" ? presentation.readPaintOrigin() : props.parent?.getBoundingClientRect?.();
+			if (!stage || !Number.isFinite(stage.left) || !Number.isFinite(stage.top)) return null;
 			const instances = committedInstances.value ?? [];
 			return {
 				activeThreadId: activeComment.value == null ? null : String(activeComment.value),
@@ -16316,7 +16320,7 @@ var _sfc_main$31 = {
 					"data-comment-page-index": pos.pageIndex ?? "",
 					class: require__plugin_vue_export_helper.normalizeClass([{ "is-direct-decision-continuity-target": pos.id === directDecisionContinuityTargetId.value }, "comment-placeholder"]),
 					style: require__plugin_vue_export_helper.normalizeStyle({
-						top: (pos.isOffscreenReviewCard ? pos.top - sidebarOffsetY.value : pos.top) + "px",
+						top: (pos.isOffscreenReviewCard && !committedPresentation.value ? pos.top - sidebarOffsetY.value : pos.top) + "px",
 						height: pos.height + "px",
 						transition: disableInstantLayoutTransitions.value ? "none" : void 0
 					})
@@ -16344,7 +16348,7 @@ var _sfc_main$31 = {
 		};
 	}
 };
-var FloatingComments_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$31, [["__scopeId", "data-v-f0b1fd79"]]);
+var FloatingComments_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$31, [["__scopeId", "data-v-028441bf"]]);
 //#endregion
 //#region src/components/CommentsLayer/PdfCommentsLayer.vue
 var _hoisted_1$23 = {
@@ -19519,6 +19523,7 @@ function scrollToElement(targetElement, options = {
 /** @typedef {import('../core/types/index.js').Editor} Editor */
 /** @typedef {import('../public/ui/types.js').SuperDocUI} SuperDocUI */
 /** @typedef {import('@superdoc/document-api').HyperlinkTarget} HyperlinkTarget */
+/** @typedef {{ getHandles?: () => { editing?: { input?: { runAfterPendingInput?: (action: (signal?: AbortSignal) => Promise<boolean>) => Promise<boolean> } } } }} LinkNavigationHost */
 /**
 * A single-block text-selection target in the Document API `query.match`
 * result shape.
@@ -20077,6 +20082,26 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 		const anchorName = decodeAnchorFragment(anchorUrl.slice(1));
 		const editor = getActiveEditor();
 		const generation = openGeneration;
+		/** @param {AbortSignal} [signal] */
+		const navigate = (signal) => navigateAnchorInEditor(anchorName, editor, generation, placeCaret, revalidateCaretAfterReveal, signal);
+		if (revalidateCaretAfterReveal) try {
+			const input = (editor?.host)?.getHandles?.()?.editing?.input;
+			if (typeof input?.runAfterPendingInput === "function") return await input.runAfterPendingInput(navigate);
+		} catch {
+			return false;
+		}
+		return navigate();
+	}
+	/**
+	* @param {string} anchorName
+	* @param {Editor | null | undefined} editor
+	* @param {number} generation
+	* @param {boolean} placeCaret
+	* @param {boolean} revalidateCaretAfterReveal
+	* @param {AbortSignal} [signal]
+	*/
+	async function navigateAnchorInEditor(anchorName, editor, generation, placeCaret, revalidateCaretAfterReveal, signal) {
+		if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 		/** @type {LinkPopoverDocumentApi | null | undefined} */
 		const doc = editor?.doc;
 		const bookmarkGet = doc?.bookmarks?.get;
@@ -20093,14 +20118,16 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			try {
 				const list = doc?.bookmarks?.list;
 				if (typeof list === "function") {
-					if ((await Promise.resolve(list.call(doc.bookmarks)))?.items?.filter((item) => item.name === anchorName).length !== 1) return null;
+					const catalog = await Promise.resolve(list.call(doc.bookmarks));
+					if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return null;
+					if (catalog?.items?.filter((item) => item.name === anchorName).length !== 1) return null;
 				}
 				const bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
 					kind: "entity",
 					entityType: "bookmark",
 					name: anchorName
 				} }));
-				if (editor !== getActiveEditor() || generation !== openGeneration) return null;
+				if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return null;
 				const story = bookmark?.address?.story;
 				if (story && story.storyType !== "body" || bookmark?.tableColumn) return null;
 				const blockId = bookmark?.range?.from?.blockId;
@@ -20115,41 +20142,44 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			}
 		}
 		let position = await readBodyBookmark();
-		if (!position) return false;
+		if (!position || signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 		if (placeCaret && !revalidateCaretAfterReveal) await placeCaretAtBookmark(position.blockId, position.offset);
 		const viewport = getUi()?.viewport;
 		const scrollIntoView = viewport?.scrollIntoView;
 		if (typeof scrollIntoView !== "function") return false;
-		for (let step = 0; step < MAX_ANCHOR_NAVIGATION_STEPS; step += 1) try {
-			const target = {
-				kind: "text",
-				blockId: position.blockId,
-				range: {
-					start: position.offset,
-					end: position.offset
-				}
-			};
-			const result = await Promise.resolve(scrollIntoView.call(viewport, {
-				target,
-				block: "start",
-				behavior: "instant"
-			}));
-			if (editor !== getActiveEditor() || generation !== openGeneration) return false;
-			if (result?.success !== false) {
-				if (revalidateCaretAfterReveal) {
-					const current = await readBodyBookmark();
-					if (!current) return false;
-					if (current.blockId !== position.blockId || current.offset !== position.offset) {
-						position = current;
-						continue;
+		for (let step = 0; step < MAX_ANCHOR_NAVIGATION_STEPS; step += 1) {
+			if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+			try {
+				const target = {
+					kind: "text",
+					blockId: position.blockId,
+					range: {
+						start: position.offset,
+						end: position.offset
+					}
+				};
+				const result = await Promise.resolve(scrollIntoView.call(viewport, {
+					target,
+					block: "start",
+					behavior: "instant"
+				}));
+				if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+				if (result?.success !== false) {
+					if (revalidateCaretAfterReveal) {
+						const current = await readBodyBookmark();
+						if (!current || signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+						if (current.blockId !== position.blockId || current.offset !== position.offset) {
+							position = current;
+							continue;
+						}
+						if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
+						if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 					}
-					if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
-					if (editor !== getActiveEditor() || generation !== openGeneration) return false;
+					return true;
 				}
-				return true;
+			} catch {
+				return false;
 			}
-		} catch {
-			return false;
 		}
 		return false;
 	}
@@ -22923,7 +22953,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				if (typeof selectionTargets?.apply !== "function") return createV2AuthoringFailure("selection-target-unavailable", "editing.selectionTargets.apply is not available");
 				let result;
 				try {
-					result = selectionTargets.apply(selectionTarget);
+					result = await (selectionTargets.applyAndWait ?? selectionTargets.apply).call(selectionTargets, selectionTarget);
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
 					return createV2AuthoringFailure("selection-target-threw", message);
@@ -24978,7 +25008,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 46, _hoisted_1$17);
 		};
 	}
-}, [["__scopeId", "data-v-c57da6ae"]]);
+}, [["__scopeId", "data-v-c843616f"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46568,6 +46598,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		return this.#surfacesConfig;
 	}
 	#surfaceManager;
+	#sourceLifecycleReady;
+	#pendingSourceLifecycle;
 	/**
 	* SuperDoc-owned editor runtime registry. This is the internal place to ask
 	* which mounted editor runtime is active and which runtime owns a DOM event
@@ -46640,6 +46672,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.whiteboard = null;
 		this.colors = [];
 		this.readyEditors = 0;
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#editorRuntimeRegistry = new EditorRuntimeRegistry();
 		this.#editorRuntimeRegistryUnsub = null;
 		this.#applyingRuntimeActiveChange = false;
@@ -46793,7 +46827,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.25.0-next.4";
+		this.version = "2.25.0-next.6";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46830,6 +46864,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Mount the Vue app, stores, and editor runtime.
 	*/
 	#startRuntime() {
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#initVueApp();
 		this.readyEditors = 0;
 		if (!this.app) throw new Error("SuperDoc: #startRuntime called before #initVueApp populated this.app");
@@ -47865,7 +47901,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Triggered when the superdoc is ready
 	*/
 	broadcastReady() {
-		if (this.readyEditors === this.requiredNumberOfEditors) this.emit("ready", { superdoc: this });
+		if (this.#destroyed) return;
+		if (this.readyEditors === this.requiredNumberOfEditors) {
+			this.emit("ready", { superdoc: this });
+			if (this.#destroyed) return;
+			this.#sourceLifecycleReady = true;
+			for (const type of this.#pendingSourceLifecycle.splice(0)) this.emit(type);
+		}
 	}
 	/**
 	* Triggered before an editor is created
@@ -47884,11 +47926,19 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.#wireFontsChangedRelay(editor);
 		this.emit("editorCreate", { editor: createDeprecatedEditorProxy(editor) });
 	}
+	#broadcastSourceLifecycle(type) {
+		if (this.#destroyed) return;
+		if (!this.#sourceLifecycleReady) {
+			this.#pendingSourceLifecycle.push(type);
+			return;
+		}
+		this.emit(type);
+	}
 	broadcastSourceComplete() {
-		this.emit("source:complete");
+		this.#broadcastSourceLifecycle("source:complete");
 	}
 	broadcastSourceSignalsComplete() {
-		this.emit("source:signals-complete");
+		this.#broadcastSourceLifecycle("source:signals-complete");
 	}
 	/** Editors whose `fonts-changed` we already relay, so a repeated create wires once. */
 	#fontsRelayEditors;
@@ -49150,6 +49200,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	destroy() {
 		require_create_super_doc_ui.closeInteractionHistory(this);
 		this.#destroyed = true;
+		this.#pendingSourceLifecycle = [];
 		this.#contentControlClickRoot?.removeEventListener("click", this.#handleContentControlClick, true);
 		this.#contentControlClickRoot?.removeEventListener("pointerdown", this.#handleContentControlPointerDown, true);
 		this.#contentControlClickRoot?.ownerDocument.removeEventListener("pointerup", this.#handleContentControlPointerEnd, true);

package/dist/superdoc.es.js

@@ -1,6 +1,6 @@
 import { i as __toESM$2 } from "./chunks/rolldown-runtime-0pSA04fp.es.js";
 import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
-import { c as createImageFilePicker, d as DOM_CLASS_NAMES, f as closeInteractionHistory, g as recordInteraction, h as isWorkflowRecordingEnabled, i as registerFirstPartyCommandMutation, l as resolveImageSrc, m as getWorkflowRecording, n as executeFirstPartyCommandAsync, o as applyV2CommentInvalidationFromMutation, p as createInteractionHistory, r as readFirstPartyPageNumbers, s as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-D5waZHl3.es.js";
+import { c as createImageFilePicker, d as DOM_CLASS_NAMES, f as closeInteractionHistory, g as recordInteraction, h as isWorkflowRecordingEnabled, i as registerFirstPartyCommandMutation, l as resolveImageSrc, m as getWorkflowRecording, n as executeFirstPartyCommandAsync, o as applyV2CommentInvalidationFromMutation, p as createInteractionHistory, r as readFirstPartyPageNumbers, s as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-CCNvH6mr.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { $ as vModelText, A as onActivated, B as renderSlot, C as isRef$1, D as normalizeClass, E as nextTick, F as openBlock, G as toRaw$2, H as resolveDynamicComponent, I as provide$1, J as unref, K as toRef, L as reactive, M as onDeactivated, N as onMounted, O as normalizeProps, P as onScopeDispose$1, Q as vModelSelect, R as ref, S as isReactive$1, T as mergeProps, U as shallowRef$1, V as resolveDirective, W as toDisplayString, X as useSlots, Y as useAttrs, Z as vModelCheckbox, _ as getCurrentInstance, a as computed$1, b as hasInjectionContext, c as createCommentVNode, d as createStaticVNode, et as watch$1, f as createTextVNode, g as effectScope, h as defineComponent, i as Transition, it as withModifiers, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, m as defineAsyncComponent, n as Fragment, nt as withDirectives, o as createApp, p as createVNode, q as toRefs, r as Teleport, rt as withKeys, s as createBlock, t as _plugin_vue_export_helper_default, tt as withCtx, u as createElementVNode, v as getCurrentScope, w as markRaw, x as inject$1, y as h, z as renderList } from "./chunks/_plugin-vue_export-helper-7ZiLY07t.es.js";
@@ -302,7 +302,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.25.0-next.4";
+		return "2.25.0-next.6";
 	} catch {
 		return "unknown";
 	}
@@ -9234,8 +9234,10 @@ var useCommentsStore = defineStore("comments", () => {
 		};
 		const activeId = normalizeCommentId(activeComment.value);
 		if (activeId && droppedIds.has(activeId)) clearActiveCommentSelection();
+		const adapter = getV2CommentsAdapter(superdoc);
 		removedComments.forEach((comment) => {
 			const payload = typeof comment.getValues === "function" ? comment.getValues() : comment;
+			if (isCurrentV2CommentsAdapter(adapter) && adapter.isPendingCommentCreation?.(payload?.commentId)) return;
 			const event = {
 				type: COMMENT_EVENTS.DELETED,
 				comment: payload,
@@ -15745,7 +15747,9 @@ var FloatingComments_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			viewportRevision.value;
 			const viewport = getFloatingViewportRange();
 			if (!viewport) return null;
-			const rail = container.getBoundingClientRect(), stage = props.parent?.getBoundingClientRect?.();
+			const rail = container.getBoundingClientRect();
+			const stage = typeof presentation.readPaintOrigin === "function" ? presentation.readPaintOrigin() : props.parent?.getBoundingClientRect?.();
+			if (!stage || !Number.isFinite(stage.left) || !Number.isFinite(stage.top)) return null;
 			const instances = committedInstances.value ?? [];
 			return {
 				activeThreadId: activeComment.value == null ? null : String(activeComment.value),
@@ -16306,7 +16310,7 @@ var FloatingComments_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 					"data-comment-page-index": pos.pageIndex ?? "",
 					class: normalizeClass([{ "is-direct-decision-continuity-target": pos.id === directDecisionContinuityTargetId.value }, "comment-placeholder"]),
 					style: normalizeStyle({
-						top: (pos.isOffscreenReviewCard ? pos.top - sidebarOffsetY.value : pos.top) + "px",
+						top: (pos.isOffscreenReviewCard && !committedPresentation.value ? pos.top - sidebarOffsetY.value : pos.top) + "px",
 						height: pos.height + "px",
 						transition: disableInstantLayoutTransitions.value ? "none" : void 0
 					})
@@ -16333,7 +16337,7 @@ var FloatingComments_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			}), 128))], 4)], 36);
 		};
 	}
-}, [["__scopeId", "data-v-f0b1fd79"]]);
+}, [["__scopeId", "data-v-028441bf"]]);
 //#endregion
 //#region src/components/CommentsLayer/PdfCommentsLayer.vue
 var _hoisted_1$23 = {
@@ -19486,6 +19490,7 @@ function scrollToElement(targetElement, options = {
 /** @typedef {import('../core/types/index.js').Editor} Editor */
 /** @typedef {import('../public/ui/types.js').SuperDocUI} SuperDocUI */
 /** @typedef {import('@superdoc/document-api').HyperlinkTarget} HyperlinkTarget */
+/** @typedef {{ getHandles?: () => { editing?: { input?: { runAfterPendingInput?: (action: (signal?: AbortSignal) => Promise<boolean>) => Promise<boolean> } } } }} LinkNavigationHost */
 /**
 * A single-block text-selection target in the Document API `query.match`
 * result shape.
@@ -20044,6 +20049,26 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 		const anchorName = decodeAnchorFragment(anchorUrl.slice(1));
 		const editor = getActiveEditor();
 		const generation = openGeneration;
+		/** @param {AbortSignal} [signal] */
+		const navigate = (signal) => navigateAnchorInEditor(anchorName, editor, generation, placeCaret, revalidateCaretAfterReveal, signal);
+		if (revalidateCaretAfterReveal) try {
+			const input = (editor?.host)?.getHandles?.()?.editing?.input;
+			if (typeof input?.runAfterPendingInput === "function") return await input.runAfterPendingInput(navigate);
+		} catch {
+			return false;
+		}
+		return navigate();
+	}
+	/**
+	* @param {string} anchorName
+	* @param {Editor | null | undefined} editor
+	* @param {number} generation
+	* @param {boolean} placeCaret
+	* @param {boolean} revalidateCaretAfterReveal
+	* @param {AbortSignal} [signal]
+	*/
+	async function navigateAnchorInEditor(anchorName, editor, generation, placeCaret, revalidateCaretAfterReveal, signal) {
+		if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 		/** @type {LinkPopoverDocumentApi | null | undefined} */
 		const doc = editor?.doc;
 		const bookmarkGet = doc?.bookmarks?.get;
@@ -20060,14 +20085,16 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			try {
 				const list = doc?.bookmarks?.list;
 				if (typeof list === "function") {
-					if ((await Promise.resolve(list.call(doc.bookmarks)))?.items?.filter((item) => item.name === anchorName).length !== 1) return null;
+					const catalog = await Promise.resolve(list.call(doc.bookmarks));
+					if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return null;
+					if (catalog?.items?.filter((item) => item.name === anchorName).length !== 1) return null;
 				}
 				const bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
 					kind: "entity",
 					entityType: "bookmark",
 					name: anchorName
 				} }));
-				if (editor !== getActiveEditor() || generation !== openGeneration) return null;
+				if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return null;
 				const story = bookmark?.address?.story;
 				if (story && story.storyType !== "body" || bookmark?.tableColumn) return null;
 				const blockId = bookmark?.range?.from?.blockId;
@@ -20082,41 +20109,44 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			}
 		}
 		let position = await readBodyBookmark();
-		if (!position) return false;
+		if (!position || signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 		if (placeCaret && !revalidateCaretAfterReveal) await placeCaretAtBookmark(position.blockId, position.offset);
 		const viewport = getUi()?.viewport;
 		const scrollIntoView = viewport?.scrollIntoView;
 		if (typeof scrollIntoView !== "function") return false;
-		for (let step = 0; step < MAX_ANCHOR_NAVIGATION_STEPS; step += 1) try {
-			const target = {
-				kind: "text",
-				blockId: position.blockId,
-				range: {
-					start: position.offset,
-					end: position.offset
-				}
-			};
-			const result = await Promise.resolve(scrollIntoView.call(viewport, {
-				target,
-				block: "start",
-				behavior: "instant"
-			}));
-			if (editor !== getActiveEditor() || generation !== openGeneration) return false;
-			if (result?.success !== false) {
-				if (revalidateCaretAfterReveal) {
-					const current = await readBodyBookmark();
-					if (!current) return false;
-					if (current.blockId !== position.blockId || current.offset !== position.offset) {
-						position = current;
-						continue;
+		for (let step = 0; step < MAX_ANCHOR_NAVIGATION_STEPS; step += 1) {
+			if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+			try {
+				const target = {
+					kind: "text",
+					blockId: position.blockId,
+					range: {
+						start: position.offset,
+						end: position.offset
+					}
+				};
+				const result = await Promise.resolve(scrollIntoView.call(viewport, {
+					target,
+					block: "start",
+					behavior: "instant"
+				}));
+				if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+				if (result?.success !== false) {
+					if (revalidateCaretAfterReveal) {
+						const current = await readBodyBookmark();
+						if (!current || signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
+						if (current.blockId !== position.blockId || current.offset !== position.offset) {
+							position = current;
+							continue;
+						}
+						if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
+						if (signal?.aborted || editor !== getActiveEditor() || generation !== openGeneration) return false;
 					}
-					if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
-					if (editor !== getActiveEditor() || generation !== openGeneration) return false;
+					return true;
 				}
-				return true;
+			} catch {
+				return false;
 			}
-		} catch {
-			return false;
 		}
 		return false;
 	}
@@ -22882,7 +22912,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				if (typeof selectionTargets?.apply !== "function") return createV2AuthoringFailure("selection-target-unavailable", "editing.selectionTargets.apply is not available");
 				let result;
 				try {
-					result = selectionTargets.apply(selectionTarget);
+					result = await (selectionTargets.applyAndWait ?? selectionTargets.apply).call(selectionTargets, selectionTarget);
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
 					return createV2AuthoringFailure("selection-target-threw", message);
@@ -24937,7 +24967,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 46, _hoisted_1$17);
 		};
 	}
-}, [["__scopeId", "data-v-c57da6ae"]]);
+}, [["__scopeId", "data-v-c843616f"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46497,6 +46527,8 @@ var SuperDoc = class extends import_eventemitter3.default {
 		return this.#surfacesConfig;
 	}
 	#surfaceManager;
+	#sourceLifecycleReady;
+	#pendingSourceLifecycle;
 	/**
 	* SuperDoc-owned editor runtime registry. This is the internal place to ask
 	* which mounted editor runtime is active and which runtime owns a DOM event
@@ -46569,6 +46601,8 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.whiteboard = null;
 		this.colors = [];
 		this.readyEditors = 0;
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#editorRuntimeRegistry = new EditorRuntimeRegistry();
 		this.#editorRuntimeRegistryUnsub = null;
 		this.#applyingRuntimeActiveChange = false;
@@ -46722,7 +46756,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.25.0-next.4";
+		this.version = "2.25.0-next.6";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -46759,6 +46793,8 @@ var SuperDoc = class extends import_eventemitter3.default {
 	* Mount the Vue app, stores, and editor runtime.
 	*/
 	#startRuntime() {
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#initVueApp();
 		this.readyEditors = 0;
 		if (!this.app) throw new Error("SuperDoc: #startRuntime called before #initVueApp populated this.app");
@@ -47794,7 +47830,13 @@ var SuperDoc = class extends import_eventemitter3.default {
 	* Triggered when the superdoc is ready
 	*/
 	broadcastReady() {
-		if (this.readyEditors === this.requiredNumberOfEditors) this.emit("ready", { superdoc: this });
+		if (this.#destroyed) return;
+		if (this.readyEditors === this.requiredNumberOfEditors) {
+			this.emit("ready", { superdoc: this });
+			if (this.#destroyed) return;
+			this.#sourceLifecycleReady = true;
+			for (const type of this.#pendingSourceLifecycle.splice(0)) this.emit(type);
+		}
 	}
 	/**
 	* Triggered before an editor is created
@@ -47813,11 +47855,19 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.#wireFontsChangedRelay(editor);
 		this.emit("editorCreate", { editor: createDeprecatedEditorProxy(editor) });
 	}
+	#broadcastSourceLifecycle(type) {
+		if (this.#destroyed) return;
+		if (!this.#sourceLifecycleReady) {
+			this.#pendingSourceLifecycle.push(type);
+			return;
+		}
+		this.emit(type);
+	}
 	broadcastSourceComplete() {
-		this.emit("source:complete");
+		this.#broadcastSourceLifecycle("source:complete");
 	}
 	broadcastSourceSignalsComplete() {
-		this.emit("source:signals-complete");
+		this.#broadcastSourceLifecycle("source:signals-complete");
 	}
 	/** Editors whose `fonts-changed` we already relay, so a repeated create wires once. */
 	#fontsRelayEditors;
@@ -49079,6 +49129,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 	destroy() {
 		closeInteractionHistory(this);
 		this.#destroyed = true;
+		this.#pendingSourceLifecycle = [];
 		this.#contentControlClickRoot?.removeEventListener("click", this.#handleContentControlClick, true);
 		this.#contentControlClickRoot?.removeEventListener("pointerdown", this.#handleContentControlPointerDown, true);
 		this.#contentControlClickRoot?.ownerDocument.removeEventListener("pointerup", this.#handleContentControlPointerEnd, true);