superdoc 2.24.0-next.1 → 2.24.0-next.11

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-D_FbXpOQ.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-bTFGKVRb.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-CYxINHh_.cjs");
@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.24.0-next.1";
+		return "2.24.0-next.11";
 	} catch {
 		return "unknown";
 	}
@@ -13932,10 +13932,35 @@ var _sfc_main$34 = {
 				require__plugin_vue_export_helper.nextTick(() => emit("resize"));
 			});
 		};
-		const isV2Mode = require__plugin_vue_export_helper.computed(() => proxy.$superdoc?.activeEditor?.editorVersion === 2);
-		const v2CommentsAdapter = require__plugin_vue_export_helper.computed(() => isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2Comments ?? null : null);
-		const v2TrackedChangesAdapter = require__plugin_vue_export_helper.computed(() => isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null : null);
+		const activeEditorRevision = require__plugin_vue_export_helper.ref(0);
+		const v2CapabilityRevision = require__plugin_vue_export_helper.ref(0);
+		const refreshActiveEditor = () => {
+			activeEditorRevision.value += 1;
+		};
+		const isV2Mode = require__plugin_vue_export_helper.computed(() => {
+			activeEditorRevision.value;
+			return proxy.$superdoc?.activeEditor?.editorVersion === 2;
+		});
+		const v2CommentsAdapter = require__plugin_vue_export_helper.computed(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2Comments ?? null : null;
+		});
+		const v2TrackedChangesAdapter = require__plugin_vue_export_helper.computed(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null : null;
+		});
+		require__plugin_vue_export_helper.watch(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.host ?? null : null;
+		}, (host, _previous, onCleanup) => {
+			v2CapabilityRevision.value += 1;
+			const unsubscribe = host?.subscribe?.(() => {
+				v2CapabilityRevision.value += 1;
+			});
+			onCleanup(() => unsubscribe?.());
+		}, { immediate: true });
 		const v2WriteCapability = require__plugin_vue_export_helper.computed(() => {
+			v2CapabilityRevision.value;
 			if (!v2CommentsAdapter.value) return null;
 			const documentMode = commentsStore.viewingVisibility.documentMode;
 			const command = isPendingNewComment.value ? "comments.createFromSelection" : null;
@@ -13959,6 +13984,7 @@ var _sfc_main$34 = {
 			return v2WriteCapability.value?.reason ?? "v2-write-unavailable";
 		});
 		const v2TrackedChangeCapability = require__plugin_vue_export_helper.computed(() => {
+			v2CapabilityRevision.value;
 			if (!v2TrackedChangesAdapter.value) return null;
 			const documentMode = commentsStore.viewingVisibility.documentMode;
 			const capability = v2TrackedChangesAdapter.value.getCapabilityState?.() ?? null;
@@ -14243,6 +14269,7 @@ var _sfc_main$34 = {
 			return users;
 		});
 		require__plugin_vue_export_helper.onMounted(() => {
+			proxy.$superdoc?.on?.("active-editor-change", refreshActiveEditor);
 			if (props.autoFocus) require__plugin_vue_export_helper.nextTick(() => setFocus());
 			if (isPendingNewComment.value) require__plugin_vue_export_helper.nextTick(() => {
 				commentInput.value?.focus?.({ preventScroll: true });
@@ -14256,6 +14283,9 @@ var _sfc_main$34 = {
 				checkOverflow();
 			});
 		});
+		require__plugin_vue_export_helper.onBeforeUnmount(() => {
+			proxy.$superdoc?.off?.("active-editor-change", refreshActiveEditor);
+		});
 		require__plugin_vue_export_helper.watch(showInputSection, (isVisible) => {
 			if (!isVisible) return;
 			require__plugin_vue_export_helper.nextTick(() => {
@@ -14503,7 +14533,7 @@ var _sfc_main$34 = {
 		};
 	}
 };
-var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-c189ab35"]]);
+var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-5ace8cef"]]);
 //#endregion
 //#region src/components/CommentsLayer/commentsList/ReviewDirectoryListItem.vue
 var _hoisted_1$25 = [
@@ -19735,6 +19765,11 @@ function textTargetFromQueryMatch(doc, text, blockId) {
 function isTocEntryLinkElement(element) {
 	return Boolean(element && typeof element.closest === "function" && element.closest(".superdoc-toc-entry"));
 }
+/** @param {Element | null | undefined} element */
+function isNoteCrossReferenceLinkElement(element) {
+	const kind = element?.getAttribute("data-sd-note-cross-reference");
+	return (kind === "ref" || kind === "noteRef") && Boolean(element?.closest("[data-sd-note-role=\"body\"]"));
+}
 /**
 * @param {Object} options
 * @param {() => SurfaceManager | null | undefined} options.getSurfaceManager
@@ -19878,9 +19913,9 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 	* Navigate to a body bookmark through its model address. A mounted-anchor
 	* fallback is reserved for runtimes without a callable bookmark model.
 	* @param {string | null | undefined} anchorUrl
-	* @param {{ placeCaret?: boolean }} [options]
+	* @param {{ placeCaret?: boolean, revalidateCaretAfterReveal?: boolean }} [options]
 	*/
-	async function navigateToAnchor(anchorUrl, { placeCaret = false } = {}) {
+	async function navigateToAnchor(anchorUrl, { placeCaret = false, revalidateCaretAfterReveal = false } = {}) {
 		if (typeof anchorUrl !== "string" || !anchorUrl.startsWith("#")) return false;
 		const anchorName = decodeAnchorFragment(anchorUrl.slice(1));
 		const editor = getActiveEditor();
@@ -19897,48 +19932,65 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			});
 			return true;
 		}
-		/** @type {BookmarkGetResult | null} */
-		let bookmark = null;
-		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 false;
+		async function readBodyBookmark() {
+			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 bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
+					kind: "entity",
+					entityType: "bookmark",
+					name: anchorName
+				} }));
+				if (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;
+				const offset = bookmark?.range?.from?.offset ?? 0;
+				if (typeof blockId !== "string" || !Number.isInteger(offset) || offset < 0) return null;
+				return {
+					blockId,
+					offset
+				};
+			} catch {
+				return null;
 			}
-			bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
-				kind: "entity",
-				entityType: "bookmark",
-				name: anchorName
-			} }));
-			bookmark ??= null;
-		} catch {
-			return false;
 		}
-		if (editor !== getActiveEditor() || generation !== openGeneration) return false;
-		const story = bookmark?.address?.story;
-		if (story && story.storyType !== "body" || bookmark?.tableColumn) return false;
-		const blockId = bookmark?.range?.from?.blockId;
-		const offset = bookmark?.range?.from?.offset ?? 0;
-		if (typeof blockId !== "string" || !Number.isInteger(offset) || offset < 0) return false;
-		if (placeCaret) await placeCaretAtBookmark(blockId, offset);
+		let position = await readBodyBookmark();
+		if (!position) 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;
-		const target = {
-			kind: "text",
-			blockId,
-			range: {
-				start: offset,
-				end: offset
-			}
-		};
 		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) return true;
+			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;
+					}
+					if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
+					if (editor !== getActiveEditor() || generation !== openGeneration) return false;
+				}
+				return true;
+			}
 		} catch {
 			return false;
 		}
@@ -20064,8 +20116,13 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			return;
 		}
 		if (ctx.defaultAction === "navigate") {
-			if (ctx.isAnchorLink) navigateToAnchor(ctx.href);
-			else if (ctx.href) {
+			if (ctx.isAnchorLink) {
+				const noteReference = isNoteCrossReferenceLinkElement(ctx.element);
+				navigateToAnchor(ctx.href, {
+					placeCaret: noteReference && ctx.documentMode !== "viewing",
+					revalidateCaretAfterReveal: noteReference && ctx.documentMode !== "viewing"
+				});
+			} else if (ctx.href) {
 				const target = ctx.target || "_self";
 				const features = linkOpenFeaturesForTarget(ctx.rel, target);
 				if (features) window.open(ctx.href, target, features);
@@ -21060,9 +21117,10 @@ function createV2SessionShortcutRoutes(deps) {
 			handled: false,
 			reason: "document-api-unavailable"
 		};
-		let ran = runListThenApply(doc.toc?.list, doc.toc?.update);
-		ran = runListThenApply(doc.fields?.list, doc.fields?.rebuild) || ran;
-		ran = runListThenApply(doc.index?.list, doc.index?.rebuild) || ran;
+		const apply = (memberPath, mutation) => isFn(mutation) ? (input) => deps.runReferenceMutation ? deps.runReferenceMutation(memberPath, input) : mutation(input) : void 0;
+		let ran = runListThenApply(doc.toc?.list, apply("toc.update", doc.toc?.update));
+		ran = runListThenApply(doc.fields?.list, apply("fields.rebuild", doc.fields?.rebuild)) || ran;
+		ran = runListThenApply(doc.index?.list, apply("index.rebuild", doc.index?.rebuild)) || ran;
 		return ran ? true : {
 			handled: false,
 			reason: "field-update-workflow-unavailable"
@@ -22431,7 +22489,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				console.warn("[SuperDoc] v2 session-shortcut unbind failed", err);
 			}
 		};
-		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi }) => {
+		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi, firstPartyCommandMutation }) => {
 			if (!documentId) return;
 			clearV2SessionShortcutBinding(documentId);
 			if (typeof bindSessionShortcuts !== "function") return;
@@ -22439,6 +22497,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				routes: createV2SessionShortcutRoutes({
 					resolveToolbarElement: () => proxy.$superdoc?.toolbar?.toolbarContainer ?? null,
 					getDocumentApi: () => documentApi ?? null,
+					...firstPartyCommandMutation ? { runReferenceMutation: (memberPath, input) => firstPartyCommandMutation.run(memberPath, [input]) } : {},
 					pageNumberCommand: {
 						isEnabled: () => getSuperDocUI()?.commands.get("page-number-insert").getState().enabled === true,
 						execute: () => {
@@ -22945,7 +23004,8 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			installV2SessionShortcutBinding({
 				documentId,
 				bindSessionShortcuts,
-				documentApi
+				documentApi,
+				firstPartyCommandMutation
 			});
 			if (collaborationProvider && resolveDocumentV2Collaboration(getDocument(documentId)).state === "valid") onEditorCollaborationReady({ editor: facade });
 			if (pageMetrics && pageLayout) syncV2RulerActiveEditor();
@@ -24760,7 +24820,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-f53aafe0"]]);
+}, [["__scopeId", "data-v-38ecd481"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46564,7 +46624,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.24.0-next.1";
+		this.version = "2.24.0-next.11";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -48742,11 +48802,12 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	async #replaceActiveDocument(source) {
 		const activeEditor = this.activeEditor;
 		if (isV2ActiveEditorFacade(activeEditor) && typeof activeEditor.replaceFile === "function") {
-			const result = await activeEditor.replaceFile(source);
+			const replacementSource = this.#savedDocxToBlob(source);
+			const result = await activeEditor.replaceFile(replacementSource);
 			const state = result && typeof result === "object" ? result.state : null;
 			const confirmed = state === null || state === "review-ready" || state === "editing-ready";
 			if (confirmed) {
-				this.#replaceActiveDocumentData(activeEditor, source);
+				this.#replaceActiveDocumentData(activeEditor, replacementSource);
 				this.emit("document-replaced", {
 					editor: activeEditor,
 					host: activeEditor?.host

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-DFNXiKvQ.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-8UTu16Lw.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 watch$1, A as onActivated, B as resolveDirective, C as isRef$1, D as normalizeClass, E as nextTick, F as openBlock, G as toRef, H as shallowRef$1, I as reactive, J as useAttrs, K as toRefs, L as ref, M as onDeactivated, N as onMounted, O as normalizeProps, P as onScopeDispose$1, Q as vModelText, R as renderList, S as isReactive$1, T as mergeProps, U as toDisplayString, V as resolveDynamicComponent, W as toRaw$2, X as vModelCheckbox, Y as useSlots, Z as vModelSelect, _ as getCurrentInstance, a as computed$1, b as hasInjectionContext, c as createCommentVNode, d as createStaticVNode, et as withCtx, f as createTextVNode, g as effectScope, h as defineComponent, i as Transition, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, m as defineAsyncComponent, n as Fragment, nt as withKeys, o as createApp, p as createVNode, q as unref, r as Teleport, rt as withModifiers, s as createBlock, t as _plugin_vue_export_helper_default, tt as withDirectives, u as createElementVNode, v as getCurrentScope, w as markRaw, x as inject$1, y as h, z as renderSlot } from "./chunks/_plugin-vue_export-helper-DHiJKCsy.es.js";
@@ -302,7 +302,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.24.0-next.1";
+		return "2.24.0-next.11";
 	} catch {
 		return "unknown";
 	}
@@ -13925,10 +13925,35 @@ var CommentDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				nextTick(() => emit("resize"));
 			});
 		};
-		const isV2Mode = computed$1(() => proxy.$superdoc?.activeEditor?.editorVersion === 2);
-		const v2CommentsAdapter = computed$1(() => isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2Comments ?? null : null);
-		const v2TrackedChangesAdapter = computed$1(() => isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null : null);
+		const activeEditorRevision = ref(0);
+		const v2CapabilityRevision = ref(0);
+		const refreshActiveEditor = () => {
+			activeEditorRevision.value += 1;
+		};
+		const isV2Mode = computed$1(() => {
+			activeEditorRevision.value;
+			return proxy.$superdoc?.activeEditor?.editorVersion === 2;
+		});
+		const v2CommentsAdapter = computed$1(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2Comments ?? null : null;
+		});
+		const v2TrackedChangesAdapter = computed$1(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null : null;
+		});
+		watch$1(() => {
+			activeEditorRevision.value;
+			return isV2Mode.value ? proxy.$superdoc?.activeEditor?.host ?? null : null;
+		}, (host, _previous, onCleanup) => {
+			v2CapabilityRevision.value += 1;
+			const unsubscribe = host?.subscribe?.(() => {
+				v2CapabilityRevision.value += 1;
+			});
+			onCleanup(() => unsubscribe?.());
+		}, { immediate: true });
 		const v2WriteCapability = computed$1(() => {
+			v2CapabilityRevision.value;
 			if (!v2CommentsAdapter.value) return null;
 			const documentMode = commentsStore.viewingVisibility.documentMode;
 			const command = isPendingNewComment.value ? "comments.createFromSelection" : null;
@@ -13952,6 +13977,7 @@ var CommentDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			return v2WriteCapability.value?.reason ?? "v2-write-unavailable";
 		});
 		const v2TrackedChangeCapability = computed$1(() => {
+			v2CapabilityRevision.value;
 			if (!v2TrackedChangesAdapter.value) return null;
 			const documentMode = commentsStore.viewingVisibility.documentMode;
 			const capability = v2TrackedChangesAdapter.value.getCapabilityState?.() ?? null;
@@ -14236,6 +14262,7 @@ var CommentDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			return users;
 		});
 		onMounted(() => {
+			proxy.$superdoc?.on?.("active-editor-change", refreshActiveEditor);
 			if (props.autoFocus) nextTick(() => setFocus());
 			if (isPendingNewComment.value) nextTick(() => {
 				commentInput.value?.focus?.({ preventScroll: true });
@@ -14249,6 +14276,9 @@ var CommentDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				checkOverflow();
 			});
 		});
+		onBeforeUnmount(() => {
+			proxy.$superdoc?.off?.("active-editor-change", refreshActiveEditor);
+		});
 		watch$1(showInputSection, (isVisible) => {
 			if (!isVisible) return;
 			nextTick(() => {
@@ -14495,7 +14525,7 @@ var CommentDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 64))], 14, _hoisted_1$26)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
-}, [["__scopeId", "data-v-c189ab35"]]);
+}, [["__scopeId", "data-v-5ace8cef"]]);
 //#endregion
 //#region src/components/CommentsLayer/commentsList/ReviewDirectoryListItem.vue
 var _hoisted_1$25 = [
@@ -19702,6 +19732,11 @@ function textTargetFromQueryMatch(doc, text, blockId) {
 function isTocEntryLinkElement(element) {
 	return Boolean(element && typeof element.closest === "function" && element.closest(".superdoc-toc-entry"));
 }
+/** @param {Element | null | undefined} element */
+function isNoteCrossReferenceLinkElement(element) {
+	const kind = element?.getAttribute("data-sd-note-cross-reference");
+	return (kind === "ref" || kind === "noteRef") && Boolean(element?.closest("[data-sd-note-role=\"body\"]"));
+}
 /**
 * @param {Object} options
 * @param {() => SurfaceManager | null | undefined} options.getSurfaceManager
@@ -19845,9 +19880,9 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 	* Navigate to a body bookmark through its model address. A mounted-anchor
 	* fallback is reserved for runtimes without a callable bookmark model.
 	* @param {string | null | undefined} anchorUrl
-	* @param {{ placeCaret?: boolean }} [options]
+	* @param {{ placeCaret?: boolean, revalidateCaretAfterReveal?: boolean }} [options]
 	*/
-	async function navigateToAnchor(anchorUrl, { placeCaret = false } = {}) {
+	async function navigateToAnchor(anchorUrl, { placeCaret = false, revalidateCaretAfterReveal = false } = {}) {
 		if (typeof anchorUrl !== "string" || !anchorUrl.startsWith("#")) return false;
 		const anchorName = decodeAnchorFragment(anchorUrl.slice(1));
 		const editor = getActiveEditor();
@@ -19864,48 +19899,65 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			});
 			return true;
 		}
-		/** @type {BookmarkGetResult | null} */
-		let bookmark = null;
-		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 false;
+		async function readBodyBookmark() {
+			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 bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
+					kind: "entity",
+					entityType: "bookmark",
+					name: anchorName
+				} }));
+				if (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;
+				const offset = bookmark?.range?.from?.offset ?? 0;
+				if (typeof blockId !== "string" || !Number.isInteger(offset) || offset < 0) return null;
+				return {
+					blockId,
+					offset
+				};
+			} catch {
+				return null;
 			}
-			bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
-				kind: "entity",
-				entityType: "bookmark",
-				name: anchorName
-			} }));
-			bookmark ??= null;
-		} catch {
-			return false;
 		}
-		if (editor !== getActiveEditor() || generation !== openGeneration) return false;
-		const story = bookmark?.address?.story;
-		if (story && story.storyType !== "body" || bookmark?.tableColumn) return false;
-		const blockId = bookmark?.range?.from?.blockId;
-		const offset = bookmark?.range?.from?.offset ?? 0;
-		if (typeof blockId !== "string" || !Number.isInteger(offset) || offset < 0) return false;
-		if (placeCaret) await placeCaretAtBookmark(blockId, offset);
+		let position = await readBodyBookmark();
+		if (!position) 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;
-		const target = {
-			kind: "text",
-			blockId,
-			range: {
-				start: offset,
-				end: offset
-			}
-		};
 		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) return true;
+			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;
+					}
+					if (placeCaret) await placeCaretAtBookmark(current.blockId, current.offset);
+					if (editor !== getActiveEditor() || generation !== openGeneration) return false;
+				}
+				return true;
+			}
 		} catch {
 			return false;
 		}
@@ -20031,8 +20083,13 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 			return;
 		}
 		if (ctx.defaultAction === "navigate") {
-			if (ctx.isAnchorLink) navigateToAnchor(ctx.href);
-			else if (ctx.href) {
+			if (ctx.isAnchorLink) {
+				const noteReference = isNoteCrossReferenceLinkElement(ctx.element);
+				navigateToAnchor(ctx.href, {
+					placeCaret: noteReference && ctx.documentMode !== "viewing",
+					revalidateCaretAfterReveal: noteReference && ctx.documentMode !== "viewing"
+				});
+			} else if (ctx.href) {
 				const target = ctx.target || "_self";
 				const features = linkOpenFeaturesForTarget(ctx.rel, target);
 				if (features) window.open(ctx.href, target, features);
@@ -21027,9 +21084,10 @@ function createV2SessionShortcutRoutes(deps) {
 			handled: false,
 			reason: "document-api-unavailable"
 		};
-		let ran = runListThenApply(doc.toc?.list, doc.toc?.update);
-		ran = runListThenApply(doc.fields?.list, doc.fields?.rebuild) || ran;
-		ran = runListThenApply(doc.index?.list, doc.index?.rebuild) || ran;
+		const apply = (memberPath, mutation) => isFn(mutation) ? (input) => deps.runReferenceMutation ? deps.runReferenceMutation(memberPath, input) : mutation(input) : void 0;
+		let ran = runListThenApply(doc.toc?.list, apply("toc.update", doc.toc?.update));
+		ran = runListThenApply(doc.fields?.list, apply("fields.rebuild", doc.fields?.rebuild)) || ran;
+		ran = runListThenApply(doc.index?.list, apply("index.rebuild", doc.index?.rebuild)) || ran;
 		return ran ? true : {
 			handled: false,
 			reason: "field-update-workflow-unavailable"
@@ -22390,7 +22448,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				console.warn("[SuperDoc] v2 session-shortcut unbind failed", err);
 			}
 		};
-		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi }) => {
+		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi, firstPartyCommandMutation }) => {
 			if (!documentId) return;
 			clearV2SessionShortcutBinding(documentId);
 			if (typeof bindSessionShortcuts !== "function") return;
@@ -22398,6 +22456,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				routes: createV2SessionShortcutRoutes({
 					resolveToolbarElement: () => proxy.$superdoc?.toolbar?.toolbarContainer ?? null,
 					getDocumentApi: () => documentApi ?? null,
+					...firstPartyCommandMutation ? { runReferenceMutation: (memberPath, input) => firstPartyCommandMutation.run(memberPath, [input]) } : {},
 					pageNumberCommand: {
 						isEnabled: () => getSuperDocUI()?.commands.get("page-number-insert").getState().enabled === true,
 						execute: () => {
@@ -22904,7 +22963,8 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			installV2SessionShortcutBinding({
 				documentId,
 				bindSessionShortcuts,
-				documentApi
+				documentApi,
+				firstPartyCommandMutation
 			});
 			if (collaborationProvider && resolveDocumentV2Collaboration(getDocument(documentId)).state === "valid") onEditorCollaborationReady({ editor: facade });
 			if (pageMetrics && pageLayout) syncV2RulerActiveEditor();
@@ -24719,7 +24779,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-f53aafe0"]]);
+}, [["__scopeId", "data-v-38ecd481"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46493,7 +46553,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.24.0-next.1";
+		this.version = "2.24.0-next.11";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -48671,11 +48731,12 @@ var SuperDoc = class extends import_eventemitter3.default {
 	async #replaceActiveDocument(source) {
 		const activeEditor = this.activeEditor;
 		if (isV2ActiveEditorFacade(activeEditor) && typeof activeEditor.replaceFile === "function") {
-			const result = await activeEditor.replaceFile(source);
+			const replacementSource = this.#savedDocxToBlob(source);
+			const result = await activeEditor.replaceFile(replacementSource);
 			const state = result && typeof result === "object" ? result.state : null;
 			const confirmed = state === null || state === "review-ready" || state === "editing-ready";
 			if (confirmed) {
-				this.#replaceActiveDocumentData(activeEditor, source);
+				this.#replaceActiveDocumentData(activeEditor, replacementSource);
 				this.emit("document-replaced", {
 					editor: activeEditor,
 					host: activeEditor?.host