superdoc 2.20.0-next.8 → 2.20.0

package/README.md

@@ -28,3 +28,29 @@ See [package compatibility](https://docs.superdoc.dev/resources/package-compatib
 ## License
 
 AGPL-3.0. Commercial licenses are available from [SuperDoc](https://www.superdoc.dev).
+
+## Navigate to a bookmark
+
+After the V2 browser editor is ready, navigate by an exact bookmark name:
+
+```js
+const result = await editor.ui.bookmarks.navigateTo('Terms');
+if (!result.success) console.log(result.reason);
+```
+
+You can also pass a `BookmarkAddress` returned by `editor.activeEditor.doc.bookmarks.get()`
+or `.list()`. The method reveals the bookmark's start and selects its complete range,
+including across paragraphs. A collapsed bookmark places a caret. It supports editing,
+suggesting, and viewing modes. Navigation stays local in a shared room and does not change
+content or another client's selection. It does not take native keyboard focus.
+
+Scrolling defaults to instant, centered navigation. Pass `{ block: 'start', behavior: 'auto' }`
+as a second argument to change alignment or scrolling behavior.
+
+The first release supports body bookmarks. Non-body and table-column bookmarks, malformed,
+missing, deleted, or ambiguous targets return `{ success: false, ok: false, reason: 'target-unresolved' }`.
+Name-only lookup requires a unique match across the document; an explicit body address scopes
+lookup to the body. Resolution or reveal failure preserves the existing selection. Navigation
+abandons stale work after content changes, document replacement, or a newer request, and times
+out after 15 seconds. Missing editor or host capabilities return their readiness or availability
+reason. The handle and address types are exported from `superdoc/ui`.

package/dist/chunks/{create-super-doc-ui-Dc2QEczb.cjs → create-super-doc-ui-BQBQsjoe.cjs}

@@ -11275,6 +11275,113 @@ function createSuperDocUI(options) {
 			};
 		}
 	};
+	let bookmarkNavigationGeneration = 0;
+	documentResetHooks.push(() => {
+		bookmarkNavigationGeneration += 1;
+	});
+	const bookmarks = { navigateTo: async (input, options) => {
+		const generation = ++bookmarkNavigationGeneration;
+		const unresolved = () => ({
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.targetUnresolved
+		});
+		const address = typeof input === "string" ? {
+			kind: "entity",
+			entityType: "bookmark",
+			name: input
+		} : input;
+		if (!address || address.kind !== "entity" || address.entityType !== "bookmark" || typeof address.name !== "string" || address.name.length === 0 || address.story !== void 0 && (!address.story || address.story.kind !== "story" || address.story.storyType !== "body")) return unresolved();
+		const editor = getEditor();
+		if (!editor || disposed) return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.notReady
+		};
+		const doc = getDoc();
+		const api = doc?.bookmarks;
+		if (typeof api?.list !== "function" || typeof api?.get !== "function") return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.operationUnavailable
+		};
+		const helper = getSelectionApplyHelper();
+		if (!("helper" in helper)) return {
+			success: false,
+			ok: false,
+			reason: helper.reason
+		};
+		const host = getHost();
+		if (typeof host?.scrollTargetIntoView !== "function") return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable
+		};
+		const token = metadataResolutionToken();
+		let active = true;
+		const current = () => active && !disposed && generation === bookmarkNavigationGeneration && getEditor() === editor && getDoc() === doc && getHost() === host && metadataResolutionToken() === token;
+		const run = async () => {
+			try {
+				const directory = await api.list.call(api, address.story ? { in: address.story } : {});
+				if (!current()) return unresolved();
+				if ((Array.isArray(directory?.items) ? directory.items : []).filter((item) => item?.name === address.name).length !== 1) return unresolved();
+				const info = await api.get.call(api, { target: address });
+				if (!current()) return unresolved();
+				const from = info?.range?.from;
+				const to = info?.range?.to;
+				const pointValid = (point) => typeof point?.blockId === "string" && point.blockId.length > 0 && Number.isInteger(point.offset) && point.offset >= 0;
+				if (info?.name !== address.name || info?.address?.story && info.address.story.storyType !== "body" || info?.tableColumn || !pointValid(from) || !pointValid(to) || from.blockId === to.blockId && from.offset > to.offset) return unresolved();
+				const result = await scrollTargetIntoView({
+					kind: "text",
+					segments: [{
+						blockId: from.blockId,
+						range: {
+							start: from.offset,
+							end: from.offset
+						}
+					}]
+				}, {
+					block: options?.block ?? "center",
+					behavior: options?.behavior ?? "instant",
+					shouldContinue: current
+				});
+				if (!current()) return unresolved();
+				if (!result.ok) return result;
+				const applied = selection.apply({
+					kind: "selection",
+					start: {
+						kind: "text",
+						blockId: from.blockId,
+						offset: from.offset
+					},
+					end: {
+						kind: "text",
+						blockId: to.blockId,
+						offset: to.offset
+					}
+				});
+				return {
+					...applied,
+					success: applied.ok
+				};
+			} catch {
+				return unresolved();
+			}
+		};
+		let timer;
+		const timeout = new Promise((resolve) => {
+			timer = setTimeout(() => {
+				active = false;
+				resolve(unresolved());
+			}, 15e3);
+		});
+		try {
+			return await Promise.race([run(), timeout]);
+		} finally {
+			active = false;
+			clearTimeout(timer);
+		}
+	} };
 	/**
 	* Derive the browser-shell's `importedId` carrier-lookup alias from a
 	* public list row's `wordRevisionIds` / `sourceIds` provenance fields,
@@ -12508,6 +12615,7 @@ function createSuperDocUI(options) {
 	};
 	let searchRequestGeneration = 0;
 	let pendingFallbackGeneration = null;
+	let completedFallbackSearch = null;
 	/**
 	* How to tear down the session that is currently open, captured when it was
 	* opened.
@@ -12556,6 +12664,7 @@ function createSuperDocUI(options) {
 	* is deliberately not made here.
 	*/
 	const resetSearchForActiveEditorChange = () => {
+		completedFallbackSearch = null;
 		searchRequestGeneration += 1;
 		pendingFallbackGeneration = null;
 		shellFallbackOutstanding = false;
@@ -12609,8 +12718,8 @@ function createSuperDocUI(options) {
 		const editSearch = getEditCommandSearch();
 		if (editSearch && typeof editSearch.query === "function") safeCall(() => editSearch.query({ query: "" }), null);
 	};
-	const readEditCommandCanReplace = () => readEditCommandStateEntry("find.replace")?.enabled === true;
-	const readEditCommandCanReplaceAll = () => readEditCommandStateEntry("find.replaceAll")?.enabled === true;
+	const readEditCommandCanReplace = () => pendingFallbackGeneration !== searchRequestGeneration && readEditCommandStateEntry("find.replace")?.enabled === true;
+	const readEditCommandCanReplaceAll = () => pendingFallbackGeneration !== searchRequestGeneration && readEditCommandStateEntry("find.replaceAll")?.enabled === true;
 	const applyHostSearchResult = (result, fallbackCanReplace = false, fallbackCanReplaceAll = fallbackCanReplace) => {
 		const snapshot = normalizeHostSearchResult(result, fallbackCanReplace, fallbackCanReplaceAll);
 		if (!snapshot) {
@@ -12771,6 +12880,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		close: () => {
+			completedFallbackSearch = null;
 			searchRequestGeneration += 1;
 			cancelRefreshShellSearch();
 			if (releaseActiveSearchSession) releaseSearchSession();
@@ -12795,6 +12905,16 @@ function createSuperDocUI(options) {
 			const caseSensitive = Boolean(options?.caseSensitive);
 			const includeDeletedText = (options?.includeTrackedDeletions ?? options?.includeDeletedText) === true;
 			const regex = options?.regex === true;
+			if ((!host || typeof host.setSession !== "function") && completedFallbackSearch !== null && completedFallbackSearch === getEditCommandSearch() && pendingFallbackGeneration !== searchRequestGeneration && searchRefreshTimer === null && searchState.open && searchState.available && !searchState.reason && searchState.query === query && searchState.caseSensitive === caseSensitive && searchState.includeDeletedText === includeDeletedText && searchState.regex === regex) {
+				syncSearchStateFromHost();
+				emitSearch();
+				return searchState;
+			}
+			completedFallbackSearch = null;
+			if (searchRefreshTimer !== null) {
+				clearTimeout(searchRefreshTimer);
+				searchRefreshTimer = null;
+			}
 			const generation = ++searchRequestGeneration;
 			cancelRefreshShellSearch();
 			cancelOutstandingShellFallback();
@@ -12830,6 +12950,7 @@ function createSuperDocUI(options) {
 							if (generation !== searchRequestGeneration) return;
 							shellFallbackOutstanding = false;
 							pendingFallbackGeneration = null;
+							completedFallbackSearch = editSearch;
 							applyHostSearchResult(resolved, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 						}, () => {
 							if (generation !== searchRequestGeneration) return;
@@ -12842,6 +12963,7 @@ function createSuperDocUI(options) {
 						return searchState;
 					}
 					pendingFallbackGeneration = null;
+					completedFallbackSearch = editSearch;
 					applyHostSearchResult(result, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 					applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 					return searchState;
@@ -12984,6 +13106,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		clear: () => {
+			completedFallbackSearch = null;
 			searchRequestGeneration += 1;
 			cancelRefreshShellSearch();
 			cancelOutstandingShellFallback();
@@ -13099,6 +13222,7 @@ function createSuperDocUI(options) {
 	};
 	let searchRefreshTimer = null;
 	scheduleActiveSearchRefresh = () => {
+		completedFallbackSearch = null;
 		if (searchRefreshTimer !== null) clearTimeout(searchRefreshTimer);
 		if (!searchState.open || !searchState.query) return;
 		const scheduledGeneration = searchRequestGeneration;
@@ -13125,19 +13249,29 @@ function createSuperDocUI(options) {
 			const result = typeof editSearch?.refresh === "function" ? safeCall(() => editSearch.refresh(input), null) : safeCall(() => host.refresh(), null);
 			if (isPromiseLike(result)) {
 				pendingFallbackGeneration = generation;
+				setSearchState({
+					canReplace: false,
+					canReplaceAll: false
+				});
 				Promise.resolve(result).then((resolved) => {
 					if (generation !== searchRequestGeneration || disposed) return;
+					releaseRefreshShellSearch = null;
 					pendingFallbackGeneration = null;
+					completedFallbackSearch = editSearch;
 					applyHostSearchResult(resolved, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 				}, () => {
 					if (generation !== searchRequestGeneration || disposed) return;
-					pendingFallbackGeneration = null;
+					releaseRefreshShellSearch = null;
 					setSearchState({
 						available: false,
 						reason: SUPERDOC_UI_REASONS.searchUnavailable
 					});
 				});
-			} else if (result !== null) applyHostSearchResult(result);
+			} else if (result !== null) {
+				releaseRefreshShellSearch = null;
+				completedFallbackSearch = editSearch;
+				applyHostSearchResult(result);
+			}
 		}, 120);
 	};
 	const stylesSub = sliceHandle((s) => s.styles);
@@ -13187,6 +13321,7 @@ function createSuperDocUI(options) {
 		watermark.destroy();
 		clearContentControlHighlight();
 		disposed = true;
+		completedFallbackSearch = null;
 		if (searchRefreshTimer !== null) clearTimeout(searchRefreshTimer);
 		searchRefreshTimer = null;
 		cancelRefreshShellSearch();
@@ -13262,6 +13397,7 @@ function createSuperDocUI(options) {
 		comments,
 		trackChanges,
 		contentControls,
+		bookmarks,
 		fonts,
 		zoom,
 		document: documentHandle,

package/dist/chunks/{create-super-doc-ui-B8olYVBF.es.js → create-super-doc-ui-D5VrP4Dx.es.js}

@@ -11274,6 +11274,113 @@ function createSuperDocUI(options) {
 			};
 		}
 	};
+	let bookmarkNavigationGeneration = 0;
+	documentResetHooks.push(() => {
+		bookmarkNavigationGeneration += 1;
+	});
+	const bookmarks = { navigateTo: async (input, options) => {
+		const generation = ++bookmarkNavigationGeneration;
+		const unresolved = () => ({
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.targetUnresolved
+		});
+		const address = typeof input === "string" ? {
+			kind: "entity",
+			entityType: "bookmark",
+			name: input
+		} : input;
+		if (!address || address.kind !== "entity" || address.entityType !== "bookmark" || typeof address.name !== "string" || address.name.length === 0 || address.story !== void 0 && (!address.story || address.story.kind !== "story" || address.story.storyType !== "body")) return unresolved();
+		const editor = getEditor();
+		if (!editor || disposed) return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.notReady
+		};
+		const doc = getDoc();
+		const api = doc?.bookmarks;
+		if (typeof api?.list !== "function" || typeof api?.get !== "function") return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.operationUnavailable
+		};
+		const helper = getSelectionApplyHelper();
+		if (!("helper" in helper)) return {
+			success: false,
+			ok: false,
+			reason: helper.reason
+		};
+		const host = getHost();
+		if (typeof host?.scrollTargetIntoView !== "function") return {
+			success: false,
+			ok: false,
+			reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable
+		};
+		const token = metadataResolutionToken();
+		let active = true;
+		const current = () => active && !disposed && generation === bookmarkNavigationGeneration && getEditor() === editor && getDoc() === doc && getHost() === host && metadataResolutionToken() === token;
+		const run = async () => {
+			try {
+				const directory = await api.list.call(api, address.story ? { in: address.story } : {});
+				if (!current()) return unresolved();
+				if ((Array.isArray(directory?.items) ? directory.items : []).filter((item) => item?.name === address.name).length !== 1) return unresolved();
+				const info = await api.get.call(api, { target: address });
+				if (!current()) return unresolved();
+				const from = info?.range?.from;
+				const to = info?.range?.to;
+				const pointValid = (point) => typeof point?.blockId === "string" && point.blockId.length > 0 && Number.isInteger(point.offset) && point.offset >= 0;
+				if (info?.name !== address.name || info?.address?.story && info.address.story.storyType !== "body" || info?.tableColumn || !pointValid(from) || !pointValid(to) || from.blockId === to.blockId && from.offset > to.offset) return unresolved();
+				const result = await scrollTargetIntoView({
+					kind: "text",
+					segments: [{
+						blockId: from.blockId,
+						range: {
+							start: from.offset,
+							end: from.offset
+						}
+					}]
+				}, {
+					block: options?.block ?? "center",
+					behavior: options?.behavior ?? "instant",
+					shouldContinue: current
+				});
+				if (!current()) return unresolved();
+				if (!result.ok) return result;
+				const applied = selection.apply({
+					kind: "selection",
+					start: {
+						kind: "text",
+						blockId: from.blockId,
+						offset: from.offset
+					},
+					end: {
+						kind: "text",
+						blockId: to.blockId,
+						offset: to.offset
+					}
+				});
+				return {
+					...applied,
+					success: applied.ok
+				};
+			} catch {
+				return unresolved();
+			}
+		};
+		let timer;
+		const timeout = new Promise((resolve) => {
+			timer = setTimeout(() => {
+				active = false;
+				resolve(unresolved());
+			}, 15e3);
+		});
+		try {
+			return await Promise.race([run(), timeout]);
+		} finally {
+			active = false;
+			clearTimeout(timer);
+		}
+	} };
 	/**
 	* Derive the browser-shell's `importedId` carrier-lookup alias from a
 	* public list row's `wordRevisionIds` / `sourceIds` provenance fields,
@@ -12507,6 +12614,7 @@ function createSuperDocUI(options) {
 	};
 	let searchRequestGeneration = 0;
 	let pendingFallbackGeneration = null;
+	let completedFallbackSearch = null;
 	/**
 	* How to tear down the session that is currently open, captured when it was
 	* opened.
@@ -12555,6 +12663,7 @@ function createSuperDocUI(options) {
 	* is deliberately not made here.
 	*/
 	const resetSearchForActiveEditorChange = () => {
+		completedFallbackSearch = null;
 		searchRequestGeneration += 1;
 		pendingFallbackGeneration = null;
 		shellFallbackOutstanding = false;
@@ -12608,8 +12717,8 @@ function createSuperDocUI(options) {
 		const editSearch = getEditCommandSearch();
 		if (editSearch && typeof editSearch.query === "function") safeCall(() => editSearch.query({ query: "" }), null);
 	};
-	const readEditCommandCanReplace = () => readEditCommandStateEntry("find.replace")?.enabled === true;
-	const readEditCommandCanReplaceAll = () => readEditCommandStateEntry("find.replaceAll")?.enabled === true;
+	const readEditCommandCanReplace = () => pendingFallbackGeneration !== searchRequestGeneration && readEditCommandStateEntry("find.replace")?.enabled === true;
+	const readEditCommandCanReplaceAll = () => pendingFallbackGeneration !== searchRequestGeneration && readEditCommandStateEntry("find.replaceAll")?.enabled === true;
 	const applyHostSearchResult = (result, fallbackCanReplace = false, fallbackCanReplaceAll = fallbackCanReplace) => {
 		const snapshot = normalizeHostSearchResult(result, fallbackCanReplace, fallbackCanReplaceAll);
 		if (!snapshot) {
@@ -12770,6 +12879,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		close: () => {
+			completedFallbackSearch = null;
 			searchRequestGeneration += 1;
 			cancelRefreshShellSearch();
 			if (releaseActiveSearchSession) releaseSearchSession();
@@ -12794,6 +12904,16 @@ function createSuperDocUI(options) {
 			const caseSensitive = Boolean(options?.caseSensitive);
 			const includeDeletedText = (options?.includeTrackedDeletions ?? options?.includeDeletedText) === true;
 			const regex = options?.regex === true;
+			if ((!host || typeof host.setSession !== "function") && completedFallbackSearch !== null && completedFallbackSearch === getEditCommandSearch() && pendingFallbackGeneration !== searchRequestGeneration && searchRefreshTimer === null && searchState.open && searchState.available && !searchState.reason && searchState.query === query && searchState.caseSensitive === caseSensitive && searchState.includeDeletedText === includeDeletedText && searchState.regex === regex) {
+				syncSearchStateFromHost();
+				emitSearch();
+				return searchState;
+			}
+			completedFallbackSearch = null;
+			if (searchRefreshTimer !== null) {
+				clearTimeout(searchRefreshTimer);
+				searchRefreshTimer = null;
+			}
 			const generation = ++searchRequestGeneration;
 			cancelRefreshShellSearch();
 			cancelOutstandingShellFallback();
@@ -12829,6 +12949,7 @@ function createSuperDocUI(options) {
 							if (generation !== searchRequestGeneration) return;
 							shellFallbackOutstanding = false;
 							pendingFallbackGeneration = null;
+							completedFallbackSearch = editSearch;
 							applyHostSearchResult(resolved, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 						}, () => {
 							if (generation !== searchRequestGeneration) return;
@@ -12841,6 +12962,7 @@ function createSuperDocUI(options) {
 						return searchState;
 					}
 					pendingFallbackGeneration = null;
+					completedFallbackSearch = editSearch;
 					applyHostSearchResult(result, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 					applyHostSearchResult(safeCall(() => editSearch.getState(), null), readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 					return searchState;
@@ -12983,6 +13105,7 @@ function createSuperDocUI(options) {
 			return { ok: true };
 		},
 		clear: () => {
+			completedFallbackSearch = null;
 			searchRequestGeneration += 1;
 			cancelRefreshShellSearch();
 			cancelOutstandingShellFallback();
@@ -13098,6 +13221,7 @@ function createSuperDocUI(options) {
 	};
 	let searchRefreshTimer = null;
 	scheduleActiveSearchRefresh = () => {
+		completedFallbackSearch = null;
 		if (searchRefreshTimer !== null) clearTimeout(searchRefreshTimer);
 		if (!searchState.open || !searchState.query) return;
 		const scheduledGeneration = searchRequestGeneration;
@@ -13124,19 +13248,29 @@ function createSuperDocUI(options) {
 			const result = typeof editSearch?.refresh === "function" ? safeCall(() => editSearch.refresh(input), null) : safeCall(() => host.refresh(), null);
 			if (isPromiseLike(result)) {
 				pendingFallbackGeneration = generation;
+				setSearchState({
+					canReplace: false,
+					canReplaceAll: false
+				});
 				Promise.resolve(result).then((resolved) => {
 					if (generation !== searchRequestGeneration || disposed) return;
+					releaseRefreshShellSearch = null;
 					pendingFallbackGeneration = null;
+					completedFallbackSearch = editSearch;
 					applyHostSearchResult(resolved, readEditCommandCanReplace(), readEditCommandCanReplaceAll());
 				}, () => {
 					if (generation !== searchRequestGeneration || disposed) return;
-					pendingFallbackGeneration = null;
+					releaseRefreshShellSearch = null;
 					setSearchState({
 						available: false,
 						reason: SUPERDOC_UI_REASONS.searchUnavailable
 					});
 				});
-			} else if (result !== null) applyHostSearchResult(result);
+			} else if (result !== null) {
+				releaseRefreshShellSearch = null;
+				completedFallbackSearch = editSearch;
+				applyHostSearchResult(result);
+			}
 		}, 120);
 	};
 	const stylesSub = sliceHandle((s) => s.styles);
@@ -13186,6 +13320,7 @@ function createSuperDocUI(options) {
 		watermark.destroy();
 		clearContentControlHighlight();
 		disposed = true;
+		completedFallbackSearch = null;
 		if (searchRefreshTimer !== null) clearTimeout(searchRefreshTimer);
 		searchRefreshTimer = null;
 		cancelRefreshShellSearch();
@@ -13261,6 +13396,7 @@ function createSuperDocUI(options) {
 		comments,
 		trackChanges,
 		contentControls,
+		bookmarks,
 		fonts,
 		zoom,
 		document: documentHandle,

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var 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.20.0-next.8",
+	superdocVersion: "2.20.0",
 	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

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.20.0-next.8",
+	superdocVersion: "2.20.0",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -3649,7 +3649,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly find: {
         readonly memberPath: "find";
         readonly description: "Search the document for text or node matches using SDM/1 selectors. Returns discovery-grade results: for mutation targeting, use query.match instead.";
-        readonly expectedResult: "Returns an SDFindResult envelope ({ total, limit, offset, items }). Each item is an SDNodeResult ({ node, address }).";
+        readonly expectedResult: "Returns an SDFindResult envelope ({ total, limit, offset, items }). Each item is an SDNodeResult ({ node, address }). Text hits contain only the matched text; use getNode or getNodeById for the full containing node. Node selectors return full node projections.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "find.mdx";

package/dist/layout-engine/contracts/src/index.d.ts

@@ -452,6 +452,7 @@ export type TabRun = RunMarks & {
 };
 export type LineBreakRun = {
     kind: 'lineBreak';
+    trackedChange?: TrackedChangeMeta;
     /**
      * Optional attributes carried through from the source document.
      * Mirrors OOXML <w:br> attributes (type/clear) to preserve fidelity.

package/dist/layout-engine/layout-bridge/src/index.d.ts

@@ -13,7 +13,6 @@ export type { BoundaryRange } from './text-boundaries.js';
 export { buildSectionAwareHeaderFooterLayoutKey, buildSectionContentWidth, buildEffectiveHeaderFooterRefsBySection, collectReferencedHeaderFooterRIds, buildSectionAwareHeaderFooterMeasurementGroups, } from './sectionAwareHeaderFooter.js';
 export type { HeaderFooterSectionKind, HeaderFooterRefs, SectionAwareHeaderFooterMeasurementGroup, } from './sectionAwareHeaderFooter.js';
 export { clearIncrementalModuleState, incrementalLayout, measureCache, normalizeMargin } from './incrementalLayout.js';
-export { hydrateTableTextboxMeasures } from './hydrateTableTextboxMeasures.js';
 export { hashMeasureContent } from './cache.js';
 export type { HeaderFooterLayoutResult, HeaderFooterGeometrySeed, IncrementalLayoutBridgeTiming, IncrementalLayoutResult, IncrementalLayoutExecutionControl, IncrementalMeasureReuseProof, IncrementalLayoutReuseOptions, IncrementalLayoutReuseSummary, IncrementalSectionPageNumberTransform, IncrementalLayoutTailAdoption, IncrementalLayoutTailDisposition, IncrementalPaginationProof, LayoutPositionTransform, FootnoteReserveSeed, } from './incrementalLayout.js';
 export { collectFootnoteLedgers, getPreferredReserveCandidates, getPreferredReserveTrialTargets, isMandatoryOnlyFootnotePage, scoreFootnoteWindow, summarizeFootnoteWindow, } from './footnote-scorer.js';

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Dc2QEczb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BQBQsjoe.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B8olYVBF.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Dc2QEczb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BQBQsjoe.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B8olYVBF.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

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-Dc2QEczb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BQBQsjoe.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 { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-B8olYVBF.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };