superdoc 2.3.0 → 2.4.0-next.10

package/dist/chunks/{create-super-doc-ui-CXCqHc2m.cjs → create-super-doc-ui-ByvmsAAG.cjs}

@@ -1,3 +1,64 @@
+const DOM_CLASS_NAMES = {
+	PAGE: "superdoc-page",
+	FRAGMENT: "superdoc-fragment",
+	LINE: "superdoc-line",
+	INLINE_SDT_WRAPPER: "superdoc-structured-content-inline",
+	INLINE_SDT_LABEL: "superdoc-structured-content-inline__label",
+	BLOCK_SDT: "superdoc-structured-content-block",
+	BLOCK_SDT_LABEL: "superdoc-structured-content__label",
+	TABLE_FRAGMENT: "superdoc-table-fragment",
+	DOCUMENT_SECTION: "superdoc-document-section",
+	SDT_GROUP_HOVER: "sdt-group-hover",
+	TOC_ENTRY: "superdoc-toc-entry",
+	TOC_GROUP_HOVER: "toc-group-hover",
+	IMAGE_FRAGMENT: "superdoc-image-fragment",
+	INLINE_IMAGE: "superdoc-inline-image",
+	LIST_MARKER: "superdoc-list-marker",
+	INLINE_IMAGE_CLIP_WRAPPER: "superdoc-inline-image-clip-wrapper",
+	ANNOTATION: "annotation",
+	ANNOTATION_CONTENT: "annotation-content",
+	ANNOTATION_CARET_ANCHOR: "annotation-caret-anchor"
+};
+const STRUCTURED_CONTENT_CHROME_LABEL_CLASS_NAMES = [DOM_CLASS_NAMES.INLINE_SDT_LABEL, DOM_CLASS_NAMES.BLOCK_SDT_LABEL];
+const DATA_ATTRS = {
+	PM_START: "data-pm-start",
+	PM_END: "data-pm-end",
+	LAYOUT_EPOCH: "data-layout-epoch",
+	TABLE_BOUNDARIES: "data-table-boundaries",
+	SDT_ID: "data-sdt-id",
+	SDT_TYPE: "data-sdt-type",
+	FIELD_ID: "data-field-id",
+	FIELD_TYPE: "data-field-type",
+	DRAGGABLE: "data-draggable",
+	DISPLAY_LABEL: "data-display-label",
+	VARIANT: "data-variant",
+	TYPE: "data-type",
+	LAYOUT_BOUNDARY_SCHEMA: "data-layout-boundary-schema",
+	LAYOUT_FRAGMENT_ID: "data-layout-fragment-id",
+	LAYOUT_STORY: "data-layout-story",
+	LAYOUT_BLOCK_REF: "data-layout-block-ref"
+};
+const decodeLayoutStoryDataset = (raw) => {
+	if (!raw) return { kind: "unknown" };
+	if (raw === "body") return { kind: "body" };
+	const idx = raw.indexOf(":");
+	const kind = idx === -1 ? raw : raw.slice(0, idx);
+	const id = idx === -1 ? void 0 : raw.slice(idx + 1);
+	switch (kind) {
+		case "body":
+		case "header":
+		case "footer":
+		case "footnote":
+		case "endnote":
+		case "textbox": return id ? {
+			kind,
+			id
+		} : { kind };
+		default: return { kind: "unknown" };
+	}
+};
+const SDT_BLOCK_WITH_ID_SELECTOR = `.${DOM_CLASS_NAMES.BLOCK_SDT}[${DATA_ATTRS.SDT_ID}]`;
+const DRAGGABLE_SELECTOR = `[${DATA_ATTRS.DRAGGABLE}="true"]`;
 function getParagraphInlineDirection(attrs) {
 	const fromContext = attrs?.directionContext?.inlineDirection;
 	if (fromContext != null) return fromContext;
@@ -309,27 +370,46 @@ function getV2TrackedChangeMutationImpact(event) {
 	if (!payload || typeof payload !== "object") return null;
 	const upsertIds = /* @__PURE__ */ new Set();
 	const removedIds = /* @__PURE__ */ new Set();
+	const remappedPairs = [];
 	const collectEntity = (entry, into) => {
 		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return;
 		if (typeof entry.entityId === "string" && entry.entityId.length > 0) into.add(entry.entityId);
 	};
+	const readEntityId$1 = (entry) => {
+		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return null;
+		return typeof entry.entityId === "string" && entry.entityId.length > 0 ? entry.entityId : null;
+	};
 	if (Array.isArray(payload.inserted)) payload.inserted.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.updated)) payload.updated.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.trackedChangeRefs)) payload.trackedChangeRefs.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.removed)) payload.removed.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.invalidatedRefs)) payload.invalidatedRefs.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.remappedRefs)) for (const mapping of payload.remappedRefs) {
-		collectEntity(mapping?.from, removedIds);
-		collectEntity(mapping?.to, upsertIds);
+		const fromId = readEntityId$1(mapping?.from);
+		const toId = readEntityId$1(mapping?.to);
+		if (fromId) removedIds.add(fromId);
+		if (toId) upsertIds.add(toId);
+		if (fromId && toId && fromId !== toId) remappedPairs.push({
+			from: fromId,
+			to: toId
+		});
 	}
 	for (const id of removedIds) upsertIds.delete(id);
-	if (upsertIds.size === 0 && removedIds.size === 0) return null;
+	const allResolved = readAllResolvedFact(event, payload);
+	if (upsertIds.size === 0 && removedIds.size === 0 && !allResolved) return null;
 	return {
 		upsertIds,
 		removedIds,
-		reconcileMode: event.origin === "history" ? "authoritative" : "targeted"
+		remappedPairs,
+		reconcileMode: event.origin === "history" ? "authoritative" : "targeted",
+		...allResolved ? { allResolved } : {}
 	};
 }
+function readAllResolvedFact(event, receipt) {
+	const fact = event?.trackedChangeAllResolved;
+	if (event?.origin === "history" || !fact || fact.schemaVersion !== 1 || fact.targetKind !== "all" || fact.decision !== "accept" && fact.decision !== "reject" || fact.remainingLogicalCount !== 0 || typeof fact.catalogRevision !== "string" || !fact.catalogRevision || typeof fact.sourceCoverageRevision !== "string" || !fact.sourceCoverageRevision || !Number.isSafeInteger(fact.logicalTargetCount) || fact.logicalTargetCount <= 0 || !Number.isSafeInteger(fact.physicalCarrierCount) || fact.physicalCarrierCount < fact.logicalTargetCount || typeof fact.txId !== "string" || fact.txId !== receipt.txId || typeof fact.documentEpoch !== "string" || !Number.isSafeInteger(fact.commitSequence) || typeof fact.packagePreviousRevision !== "string" || typeof fact.packageNextRevision !== "string" || fact.packagePreviousRevision === fact.packageNextRevision) return null;
+	return fact;
+}
 var normalizeIds = (values) => new Set(Array.from(values ?? []).filter((value) => typeof value === "string" && value.length > 0));
 var itemId = (item) => {
 	if (typeof item?.id === "string" && item.id.length > 0) return item.id;
@@ -340,10 +420,20 @@ var itemId = (item) => {
 var contextMatches = (left, right) => left?.adapter === right?.adapter && left?.documentId === right?.documentId && left?.editor === right?.editor && left?.reconcileToken === right?.reconcileToken;
 function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onReconciled }) {
 	const pendingUpserts = /* @__PURE__ */ new Map();
+	let pendingAllResolved = null;
 	let sequence = 0;
 	let generation = 0;
 	let flushInFlight = null;
 	let flushRequested = false;
+	const settlementWaiters = [];
+	const resolveSettlementsThrough = (version, value) => {
+		for (let index = settlementWaiters.length - 1; index >= 0; index -= 1) {
+			const waiter = settlementWaiters[index];
+			if (waiter.generation !== generation || waiter.version > version) continue;
+			settlementWaiters.splice(index, 1);
+			waiter.resolve(value === true && waiter.requiresAllResolved ? pendingAllResolved == null : value);
+		}
+	};
 	const isCurrent = (capturedGeneration, context) => generation === capturedGeneration && contextMatches(context, getContext());
 	const clearResolved = (ids, snapshot) => {
 		const clearedIds = /* @__PURE__ */ new Set();
@@ -357,6 +447,10 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	const readySnapshot = (reconcileMode) => new Map([...pendingUpserts].filter(([, entry]) => entry.ready === true && entry.reconcileMode === reconcileMode));
 	const markRenderGatedReady = () => {
 		let changed = false;
+		if (pendingAllResolved?.gate === "render" && !pendingAllResolved.ready) {
+			pendingAllResolved.ready = true;
+			changed = true;
+		}
 		for (const entry of pendingUpserts.values()) {
 			if (entry.gate !== "render" || entry.ready) continue;
 			entry.ready = true;
@@ -366,6 +460,10 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	};
 	const markEntriesReadyThrough = (maxVersion) => {
 		let changed = false;
+		if (pendingAllResolved && pendingAllResolved.version <= maxVersion && !pendingAllResolved.ready) {
+			pendingAllResolved.ready = true;
+			changed = true;
+		}
 		for (const entry of pendingUpserts.values()) {
 			if (entry.version > maxVersion || entry.ready) continue;
 			entry.ready = true;
@@ -416,14 +514,31 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	};
 	const flush = () => {
 		if (flushInFlight) return flushInFlight;
+		const allResolvedSnapshot = pendingAllResolved?.ready ? pendingAllResolved : null;
 		const targetedSnapshot = readySnapshot("targeted");
 		const authoritativeSnapshot = readySnapshot("authoritative");
-		if (targetedSnapshot.size === 0 && authoritativeSnapshot.size === 0) return null;
+		if (!allResolvedSnapshot && targetedSnapshot.size === 0 && authoritativeSnapshot.size === 0) return null;
 		const context = getContext();
 		if (!context?.adapter) return null;
 		flushRequested = false;
 		const capturedGeneration = generation;
 		flushInFlight = Promise.resolve().then(async () => {
+			if (allResolvedSnapshot) {
+				let result = null;
+				try {
+					result = await reconcile(context, {
+						upsertIds: /* @__PURE__ */ new Set(),
+						removedIds: /* @__PURE__ */ new Set(),
+						allResolved: allResolvedSnapshot.fact,
+						reconcileMode: "targeted"
+					});
+				} catch {}
+				if (!isCurrent(capturedGeneration, context)) return;
+				if (result?.ok === true) {
+					if (pendingAllResolved === allResolvedSnapshot) pendingAllResolved = null;
+					await notifyReconciled(context, /* @__PURE__ */ new Set(), result, true);
+				}
+			}
 			if (authoritativeSnapshot.size > 0) await reconcileAuthoritativeSnapshot(context, authoritativeSnapshot, capturedGeneration).catch(() => void 0);
 			if (targetedSnapshot.size > 0) await reconcileTargetedSnapshot(context, targetedSnapshot, capturedGeneration).catch(() => void 0);
 		}).catch(() => {}).finally(() => {
@@ -434,8 +549,18 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	};
 	const enqueueWithGate = (impact, gate) => {
 		if (!impact) return;
+		if (impact.allResolved) {
+			pendingUpserts.clear();
+			pendingAllResolved = {
+				fact: impact.allResolved,
+				version: ++sequence,
+				gate,
+				ready: false
+			};
+		}
 		const reconcileMode = impact.reconcileMode === "authoritative" ? "authoritative" : "targeted";
 		const removedIds = normalizeIds(impact.removedIds);
+		const upsertIds = normalizeIds(impact.upsertIds);
 		for (const id of removedIds) {
 			const existing = pendingUpserts.get(id);
 			if (existing?.reconcileMode === "authoritative") pendingUpserts.set(id, {
@@ -447,13 +572,13 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 			else pendingUpserts.delete(id);
 		}
 		const context = getContext();
-		if (removedIds.size > 0 && context?.adapter) try {
+		if (removedIds.size > 0 && upsertIds.size === 0 && context?.adapter && !impact.allResolved) try {
 			Promise.resolve(reconcile(context, {
 				upsertIds: /* @__PURE__ */ new Set(),
 				removedIds
 			})).catch(() => void 0);
 		} catch {}
-		for (const id of normalizeIds(impact.upsertIds)) if (!removedIds.has(id)) {
+		for (const id of upsertIds) if (!removedIds.has(id)) {
 			const existing = pendingUpserts.get(id);
 			pendingUpserts.set(id, {
 				version: ++sequence,
@@ -474,20 +599,34 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 		enqueueAfterPaint(impact, waitForPaint) {
 			if (!impact || typeof waitForPaint !== "function") {
 				enqueue(impact);
-				return;
+				return Promise.resolve(false);
 			}
 			enqueueWithGate(impact, "exact-paint");
 			const context = getContext();
-			if (!context?.adapter) return;
 			const capturedGeneration = generation;
 			const capturedSequence = sequence;
+			if (!context?.adapter) {
+				markEntriesReadyThrough(capturedSequence);
+				return Promise.resolve(false);
+			}
+			const completion = new Promise((resolve) => {
+				settlementWaiters.push({
+					generation: capturedGeneration,
+					version: capturedSequence,
+					requiresAllResolved: Boolean(impact.allResolved),
+					resolve
+				});
+			});
 			const impactedIds = new Set([...normalizeIds(impact.upsertIds), ...normalizeIds(impact.removedIds)]);
 			const capturedEntries = new Map([...impactedIds].flatMap((id) => {
 				const entry = pendingUpserts.get(id);
 				return entry ? [[id, entry]] : [];
 			}));
-			Promise.resolve().then(() => waitForPaint()).then(() => {
-				if (!isCurrent(capturedGeneration, context)) return;
+			Promise.resolve().then(() => waitForPaint()).then(async () => {
+				if (!isCurrent(capturedGeneration, context)) {
+					resolveSettlementsThrough(capturedSequence, false);
+					return;
+				}
 				let madeReady = markRenderGatedReady();
 				if (markEntriesReadyThrough(capturedSequence)) madeReady = true;
 				for (const [id, entry] of capturedEntries) {
@@ -496,16 +635,35 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 					entry.ready = true;
 				}
 				if (flushInFlight && (madeReady || capturedSequence > 0)) flushRequested = true;
-				flush();
+				const preceding = flushInFlight;
+				const pending = flush();
+				if (pending) await pending;
+				if (preceding) {
+					const followUp = flushInFlight;
+					if (followUp && followUp !== preceding) await followUp;
+				}
+				if (!isCurrent(capturedGeneration, context)) {
+					resolveSettlementsThrough(capturedSequence, false);
+					return;
+				}
+				resolveSettlementsThrough(capturedSequence, true);
 			}).catch(() => {
-				if (!isCurrent(capturedGeneration, context)) return;
+				if (!isCurrent(capturedGeneration, context)) {
+					resolveSettlementsThrough(capturedSequence, false);
+					return;
+				}
 				for (const [id, entry] of capturedEntries) if (pendingUpserts.get(id) === entry) entry.gate = "render";
+				if (pendingAllResolved?.gate === "exact-paint") pendingAllResolved.gate = "render";
+				resolveSettlementsThrough(capturedSequence, false);
 			});
+			return completion;
 		},
 		onRender,
 		reset() {
+			for (const waiter of settlementWaiters.splice(0)) waiter.resolve(false);
 			generation += 1;
 			pendingUpserts.clear();
+			pendingAllResolved = null;
 			flushRequested = false;
 		},
 		getPendingIds() {
@@ -1388,67 +1546,6 @@ function collectEntityHitsFromChain(start, stopAt) {
 	}
 	return hits;
 }
-const DOM_CLASS_NAMES = {
-	PAGE: "superdoc-page",
-	FRAGMENT: "superdoc-fragment",
-	LINE: "superdoc-line",
-	INLINE_SDT_WRAPPER: "superdoc-structured-content-inline",
-	INLINE_SDT_LABEL: "superdoc-structured-content-inline__label",
-	BLOCK_SDT: "superdoc-structured-content-block",
-	BLOCK_SDT_LABEL: "superdoc-structured-content__label",
-	TABLE_FRAGMENT: "superdoc-table-fragment",
-	DOCUMENT_SECTION: "superdoc-document-section",
-	SDT_GROUP_HOVER: "sdt-group-hover",
-	TOC_ENTRY: "superdoc-toc-entry",
-	TOC_GROUP_HOVER: "toc-group-hover",
-	IMAGE_FRAGMENT: "superdoc-image-fragment",
-	INLINE_IMAGE: "superdoc-inline-image",
-	LIST_MARKER: "superdoc-list-marker",
-	INLINE_IMAGE_CLIP_WRAPPER: "superdoc-inline-image-clip-wrapper",
-	ANNOTATION: "annotation",
-	ANNOTATION_CONTENT: "annotation-content",
-	ANNOTATION_CARET_ANCHOR: "annotation-caret-anchor"
-};
-const STRUCTURED_CONTENT_CHROME_LABEL_CLASS_NAMES = [DOM_CLASS_NAMES.INLINE_SDT_LABEL, DOM_CLASS_NAMES.BLOCK_SDT_LABEL];
-const DATA_ATTRS = {
-	PM_START: "data-pm-start",
-	PM_END: "data-pm-end",
-	LAYOUT_EPOCH: "data-layout-epoch",
-	TABLE_BOUNDARIES: "data-table-boundaries",
-	SDT_ID: "data-sdt-id",
-	SDT_TYPE: "data-sdt-type",
-	FIELD_ID: "data-field-id",
-	FIELD_TYPE: "data-field-type",
-	DRAGGABLE: "data-draggable",
-	DISPLAY_LABEL: "data-display-label",
-	VARIANT: "data-variant",
-	TYPE: "data-type",
-	LAYOUT_BOUNDARY_SCHEMA: "data-layout-boundary-schema",
-	LAYOUT_FRAGMENT_ID: "data-layout-fragment-id",
-	LAYOUT_STORY: "data-layout-story",
-	LAYOUT_BLOCK_REF: "data-layout-block-ref"
-};
-const decodeLayoutStoryDataset = (raw) => {
-	if (!raw) return { kind: "unknown" };
-	if (raw === "body") return { kind: "body" };
-	const idx = raw.indexOf(":");
-	const kind = idx === -1 ? raw : raw.slice(0, idx);
-	const id = idx === -1 ? void 0 : raw.slice(idx + 1);
-	switch (kind) {
-		case "body":
-		case "header":
-		case "footer":
-		case "footnote":
-		case "endnote":
-		case "textbox": return id ? {
-			kind,
-			id
-		} : { kind };
-		default: return { kind: "unknown" };
-	}
-};
-const SDT_BLOCK_WITH_ID_SELECTOR = `.${DOM_CLASS_NAMES.BLOCK_SDT}[${DATA_ATTRS.SDT_ID}]`;
-const DRAGGABLE_SELECTOR = `[${DATA_ATTRS.DRAGGABLE}="true"]`;
 var schemaBooleanOrNull = () => ({ oneOf: [{ type: "boolean" }, { type: "null" }] });
 var schemaStringOrNull = () => ({ oneOf: [{
 	type: "string",
@@ -1703,6 +1800,30 @@ const INLINE_PROPERTY_KEYS_BY_STORAGE = {
 	mark: INLINE_PROPERTY_REGISTRY.filter((entry) => entry.storage === "mark").map((entry) => entry.key),
 	runAttribute: INLINE_PROPERTY_REGISTRY.filter((entry) => entry.storage === "runAttribute").map((entry) => entry.key)
 };
+var sharedUiTrackedChangesCatalogByHost = /* @__PURE__ */ new WeakMap();
+function acquireSharedUiTrackedChangesCatalog(host) {
+	let state = sharedUiTrackedChangesCatalogByHost.get(host);
+	if (!state) {
+		state = {
+			refCount: 0,
+			generation: 0,
+			abortController: new AbortController(),
+			inFlight: null,
+			activeMutationTokens: /* @__PURE__ */ new Set()
+		};
+		sharedUiTrackedChangesCatalogByHost.set(host, state);
+	}
+	state.refCount += 1;
+	return state;
+}
+function releaseSharedUiTrackedChangesCatalog(host, state) {
+	state.refCount = Math.max(0, state.refCount - 1);
+	if (state.refCount > 0) return;
+	state.abortController.abort("ui-controller-destroyed");
+	state.inFlight = null;
+	state.activeMutationTokens.clear();
+	sharedUiTrackedChangesCatalogByHost.delete(host);
+}
 var SUPERDOC_UI_REASON_VALUES = new Set(Object.values(SUPERDOC_UI_REASONS));
 function coerceSuperDocUIReason(reason, fallback) {
 	return typeof reason === "string" && SUPERDOC_UI_REASON_VALUES.has(reason) ? reason : fallback;
@@ -1799,12 +1920,12 @@ const HEAVY_DOC_READ_POLICY = [
 	{
 		key: "trackChanges",
 		match: "exact",
-		note: "audited: body tracked-changes list; stale-served during load"
+		note: "audited: shared all-story tracked-changes catalog; stale-served during load"
 	},
 	{
 		key: "trackChanges:all",
 		match: "exact",
-		note: "audited: all-story tracked-changes list; consumers already fail closed on non-ready"
+		note: "audited: current-token validation over the shared all-story catalog; consumers fail closed on non-ready"
 	},
 	{
 		key: "tables",
@@ -1886,6 +2007,48 @@ function readEntityTarget(row) {
 	const target = row.target;
 	return target && typeof target === "object" ? target : null;
 }
+function isHostGeometryTarget(target) {
+	if (!target || typeof target !== "object") return false;
+	const record = target;
+	const isTextPoint = (point) => {
+		if (!point || typeof point !== "object") return false;
+		const candidate = point;
+		return candidate.kind === "text" && typeof candidate.blockId === "string" && typeof candidate.offset === "number";
+	};
+	const isTextSegment = (segment) => {
+		if (!segment || typeof segment !== "object") return false;
+		const candidate = segment;
+		const range$1 = candidate.range;
+		return typeof candidate.blockId === "string" && typeof range$1?.start === "number" && typeof range$1.end === "number";
+	};
+	if (Array.isArray(record.segments)) {
+		const first = record.segments[0];
+		const last = record.segments[record.segments.length - 1];
+		return isTextSegment(first) && isTextSegment(last);
+	}
+	if (record.kind === "selection") return isTextPoint(record.start) && isTextPoint(record.end);
+	if (record.kind !== "text" || typeof record.blockId !== "string") return false;
+	const range = record.range;
+	return typeof range?.start === "number" && typeof range.end === "number";
+}
+function readTrackedChangeNavigationTarget(row) {
+	if (!row || typeof row !== "object") return null;
+	const target = readEntityTarget(row);
+	if (isHostGeometryTarget(target)) return target;
+	const record = row;
+	const navigationTarget = record.navigationTarget && typeof record.navigationTarget === "object" ? record.navigationTarget : null;
+	if (navigationTarget?.kind === "block" && typeof navigationTarget.blockId === "string" && navigationTarget.blockId.length > 0) return {
+		kind: "text",
+		blockId: navigationTarget.blockId,
+		range: {
+			start: 0,
+			end: 0
+		},
+		...navigationTarget.story && typeof navigationTarget.story === "object" ? { story: navigationTarget.story } : {},
+		...record.address && typeof record.address === "object" ? { address: record.address } : {}
+	};
+	return target;
+}
 function storyLocatorSignature(story) {
 	if (!story || typeof story !== "object") return "story:body";
 	const record = story;
@@ -2092,6 +2255,7 @@ function buildTrackedChangeIdContext(items) {
 	return context;
 }
 var storyScopedTrackedChangeIdContextCache = /* @__PURE__ */ new WeakMap();
+var declaredBodyItemsCache = /* @__PURE__ */ new WeakMap();
 function buildStoryScopedTrackedChangeIdContext(items, story) {
 	const signature = storyLocatorSignature(story);
 	let byStory = storyScopedTrackedChangeIdContextCache.get(items);
@@ -2105,6 +2269,56 @@ function buildStoryScopedTrackedChangeIdContext(items, story) {
 	byStory.set(signature, context);
 	return context;
 }
+function isTextboxStory(story) {
+	return !!story && typeof story === "object" && story.storyType === "textbox";
+}
+function resolveStorylessCanonicalTrackedChangeId(items, selectionIds) {
+	const storyless = selectionIds.filter((id) => items.some((item) => readEntityId(item) === id && readEntityStory(item) == null));
+	if (storyless.length === 0) return null;
+	if (storyless.length === 1) return storyless[0];
+	const seen = /* @__PURE__ */ new Set();
+	for (const id of storyless) {
+		const row = items.find((item) => readEntityId(item) === id);
+		if (!row) continue;
+		for (const raw of readTrackChangeProvenanceIds(row)) {
+			if (seen.has(raw)) return null;
+			seen.add(raw);
+		}
+	}
+	return storyless[0];
+}
+function declaredBodyItems(items) {
+	const cached = declaredBodyItemsCache.get(items);
+	if (cached) return cached;
+	const declared = items.filter((item) => readEntityStory(item) != null);
+	const result = declared.length === items.length ? items : declared;
+	declaredBodyItemsCache.set(items, result);
+	return result;
+}
+function resolveSelectionActiveChangeId(options) {
+	const { selectionIds, publicIds, selection, bodyItems, allStoryItems } = options;
+	if (selectionIds.length === 0) return null;
+	const mapIds = (context) => {
+		for (const id of selectionIds) {
+			const publicId = context.toPublicId(id);
+			if (publicId) return publicId;
+		}
+		return null;
+	};
+	const story = selectionStory(selection);
+	const isBodySelection = storyLocatorSignature(story) === storyLocatorSignature(null);
+	if (allStoryItems) {
+		const scopedItems = isBodySelection ? declaredBodyItems(allStoryItems) : allStoryItems;
+		const fromStory = mapIds(buildStoryScopedTrackedChangeIdContext(scopedItems, story));
+		if (fromStory) return fromStory;
+		const fromPublic = publicIds?.find((id) => scopedItems.some((item) => entityRowMatchesRequest(item, id, story)));
+		if (fromPublic) return fromPublic;
+		if (!isBodySelection) return isTextboxStory(story) ? resolveStorylessCanonicalTrackedChangeId(allStoryItems, selectionIds) : null;
+		return mapIds(buildTrackedChangeIdContext(bodyItems));
+	}
+	if (isBodySelection) return mapIds(buildTrackedChangeIdContext(bodyItems)) ?? selectionIds[0] ?? null;
+	return null;
+}
 function resolveActiveCommentId(items, commentId) {
 	const item = items.find((candidate) => readEntityId(candidate) === commentId || candidate.importedId === commentId);
 	if (!item) return null;
@@ -3082,11 +3296,14 @@ function createSuperDocUI(options) {
 	let explicitActiveChange = null;
 	let explicitActiveChangeRevision = 0;
 	let queuedTrackChangeNavigationInvalidation = 0;
+	let trackChangeRevealInvalidation = 0;
+	const pendingTrackChangeRevealFocuses = /* @__PURE__ */ new Set();
 	const explicitActiveChangesEqual = (left, right) => {
 		if (left === right) return true;
 		if (!left || !right) return false;
 		return left.id === right.id && left.paintedEntityId === right.paintedEntityId && storyLocatorSignature(left.story) === storyLocatorSignature(right.story);
 	};
+	const hasPendingTrackChangeRevealFocus = (focus) => Array.from(pendingTrackChangeRevealFocuses).some((pendingFocus) => explicitActiveChangesEqual(pendingFocus, focus));
 	const mirrorTrackedChangeFocusToHost = (next) => {
 		const host = getHost();
 		if (typeof host?.getHandles !== "function") return;
@@ -3115,6 +3332,7 @@ function createSuperDocUI(options) {
 	const setExplicitActiveChange = (next, options$1) => {
 		explicitActiveChange = next;
 		explicitActiveChangeRevision += 1;
+		trackChangeRevealInvalidation += 1;
 		if (options$1?.invalidateQueuedNavigation !== false) queuedTrackChangeNavigationInvalidation += 1;
 	};
 	const listeners = /* @__PURE__ */ new Set();
@@ -3166,6 +3384,63 @@ function createSuperDocUI(options) {
 	};
 	let documentMutationRevision = 0;
 	let reviewMutationToken = {};
+	const uiTrackedChangesCatalogHost = options.superdoc;
+	const uiTrackedChangesCatalogState = acquireSharedUiTrackedChangesCatalog(uiTrackedChangesCatalogHost);
+	const supersedeUiTrackedChangesCatalogRead = () => {
+		uiTrackedChangesCatalogState.abortController.abort("review-mutation-started");
+		uiTrackedChangesCatalogState.inFlight = null;
+	};
+	const renewUiTrackedChangesCatalogRead = () => {
+		uiTrackedChangesCatalogState.generation += 1;
+		uiTrackedChangesCatalogState.abortController = new AbortController();
+		uiTrackedChangesCatalogState.inFlight = null;
+	};
+	const beginUiReviewMutation = (token) => {
+		const activeTokens = uiTrackedChangesCatalogState.activeMutationTokens;
+		if (typeof token !== "string" || token.length === 0 || activeTokens.has(token)) return;
+		const firstToken = activeTokens.size === 0;
+		activeTokens.add(token);
+		if (firstToken) supersedeUiTrackedChangesCatalogRead();
+	};
+	const settleUiReviewMutation = (token) => {
+		const activeTokens = uiTrackedChangesCatalogState.activeMutationTokens;
+		if (typeof token !== "string" || !activeTokens.delete(token)) return;
+		if (activeTokens.size === 0) renewUiTrackedChangesCatalogRead();
+	};
+	const runUiTrackedChangesCatalogRead = (fallback) => {
+		const v2TrackedChanges = getV2TrackedChanges();
+		const listTrackedChanges = v2TrackedChanges?.listTrackedChanges;
+		if (typeof listTrackedChanges !== "function") {
+			if (getEditor()?.editorVersion === 2) return Promise.reject(/* @__PURE__ */ new Error("v2-tracked-changes-bridge-pending"));
+			return fallback();
+		}
+		if (uiTrackedChangesCatalogState.activeMutationTokens.size > 0) return Promise.reject(/* @__PURE__ */ new Error("ui-review-catalog-superseded"));
+		if ((getEditor()?.reviewHydration?.getDiagnostics?.())?.inFlight === true) return Promise.reject(/* @__PURE__ */ new Error("shell-review-hydration-in-flight"));
+		const generation = uiTrackedChangesCatalogState.generation;
+		const existing = uiTrackedChangesCatalogState.inFlight;
+		if (existing?.generation === generation) return existing.promise;
+		const signal = uiTrackedChangesCatalogState.abortController.signal;
+		const validateResult = (result) => {
+			if (signal.aborted || generation !== uiTrackedChangesCatalogState.generation || result?.reason === "review-hydration-superseded") throw new Error("ui-review-catalog-superseded");
+			return result;
+		};
+		const rawResult = listTrackedChanges.call(v2TrackedChanges, {
+			blocking: false,
+			signal
+		});
+		if (!isPromiseLike(rawResult)) return validateResult(rawResult);
+		const promise = Promise.resolve(rawResult).then(validateResult);
+		uiTrackedChangesCatalogState.inFlight = {
+			generation,
+			promise
+		};
+		promise.then(() => {
+			if (uiTrackedChangesCatalogState.inFlight?.promise === promise) uiTrackedChangesCatalogState.inFlight = null;
+		}, () => {
+			if (uiTrackedChangesCatalogState.inFlight?.promise === promise) uiTrackedChangesCatalogState.inFlight = null;
+		});
+		return promise;
+	};
 	let authoritativeTrackChangesPendingToken = null;
 	let authoritativeTrackChangesRetryTimer = null;
 	let authoritativeTrackChangesFailureCount = 0;
@@ -3177,6 +3452,7 @@ function createSuperDocUI(options) {
 	let scheduleAuthoritativeTrackChangesRetry = (_reconcileToken) => void 0;
 	let postDecisionTrackChangesToken = null;
 	let postDecisionTrackChangeIds = /* @__PURE__ */ new Set();
+	let allTrackedChangesResolvedToken = null;
 	let selectionEpoch = 0;
 	let lastCoordinatorEditor = null;
 	const contentToken = () => `${editorIdentityId(getEditor())}|m${documentMutationRevision}`;
@@ -3255,6 +3531,23 @@ function createSuperDocUI(options) {
 		};
 		notifyPostDecisionTrackChanges(receipt);
 	};
+	const publishAllTrackedChangesResolved = (receipt) => {
+		const previous = state.trackChanges;
+		const changed = previous.items.length > 0 || previous.total !== 0 || previous.activeId !== null || previous.authors.length > 0;
+		allTrackedChangesResolvedToken = contentToken();
+		if (explicitActiveChange !== null) setExplicitActiveChange(null);
+		state = {
+			...state,
+			trackChanges: {
+				...previous,
+				items: [],
+				total: 0,
+				activeId: null,
+				authors: []
+			}
+		};
+		if (changed) notifyPostDecisionTrackChanges(receipt);
+	};
 	const markPostDecisionTrackChanges = (ids, receipt) => {
 		if (ids.size === 0) return;
 		const token = contentToken();
@@ -3520,7 +3813,7 @@ function createSuperDocUI(options) {
 		const read = host?.getDocumentLoadingSnapshot;
 		if (typeof read !== "function") return "unknown";
 		const stage = safeCall(() => read.call(host), null)?.sourceStage;
-		if (stage === "opening" || stage === "ready-window" || stage === "source-loading") return "loading";
+		if (stage === "opening" || stage === "bootstrap-ready" || stage === "source-loading") return "loading";
 		if (stage === "source-complete" || stage === "source-failed" || stage === "source-cancelled") return "complete";
 		return "unknown";
 	};
@@ -3933,6 +4226,7 @@ function createSuperDocUI(options) {
 		detachSourceLoading = null;
 		sourceLoadingSubscriptionHost = null;
 		clearPostDecisionTrackChanges();
+		allTrackedChangesResolvedToken = null;
 	};
 	const invalidateDocumentContent = () => {
 		const carryAuthoritativeTrackChangesHold = authoritativeTrackChangesPendingToken !== null;
@@ -3940,6 +4234,15 @@ function createSuperDocUI(options) {
 		if (carryAuthoritativeTrackChangesHold) authoritativeTrackChangesPendingToken = contentToken();
 		clearPostDecisionTrackChanges();
 	};
+	const invalidateAfterCommandSettlement = () => {
+		const carryAllResolvedCatalog = allTrackedChangesResolvedToken === contentToken();
+		invalidateDocumentContent();
+		if (carryAllResolvedCatalog) {
+			replaceTrackedChangeItemsInCache([]);
+			allTrackedChangesResolvedToken = contentToken();
+		}
+		recompute();
+	};
 	const insertText = (text) => {
 		if (typeof text !== "string" || text.length === 0) return failedReceipt("insertText requires a non-empty string.", "INVALID_INPUT");
 		if (readDocumentMode() === "viewing") return failedReceipt("The document is read-only.", "DOCUMENT_READONLY");
@@ -4143,7 +4446,17 @@ function createSuperDocUI(options) {
 		const { value, status } = authoritativeTrackChangesPendingToken === token ? {
 			value: heldEntry?.hasSettled ? heldEntry.value : null,
 			status: heldEntry?.hasSettled ? "stale" : "pending"
-		} : readAsync("trackChanges:all", token, () => tcApi?.list ? tcApi.list({ in: "all" }) : void 0, (raw) => {
+		} : readAsync("trackChanges:all", token, () => {
+			if (!tcApi?.list) return void 0;
+			const fallback = () => tcApi.list({ in: "all" });
+			const bridgeOwnsCatalog = typeof getV2TrackedChanges()?.listTrackedChanges === "function";
+			const shared = runUiTrackedChangesCatalogRead(fallback);
+			if (!bridgeOwnsCatalog) return shared;
+			return Promise.resolve(shared).then((raw) => {
+				const record = isLooseObject(raw) ? raw : null;
+				return (Array.isArray(record?.items) ? record.items : []).some((item) => readEntityStory(item) == null) ? fallback() : raw;
+			});
+		}, (raw) => {
 			return (raw && Array.isArray(raw.items) ? raw.items : []).map(projectTrackChangesItem).filter((item) => item != null);
 		});
 		return status === "ready" ? value : null;
@@ -4159,9 +4472,9 @@ function createSuperDocUI(options) {
 			value: heldEntry?.hasSettled ? heldEntry.value : null,
 			status: heldEntry?.hasSettled ? "stale" : "pending"
 		} : readAsync("trackChanges", token, () => {
-			if (listTrackedChanges) return listTrackedChanges.call(v2TrackedChanges);
-			return tcApi?.list ? tcApi.list() : void 0;
-		}, (raw) => raw && Array.isArray(raw.items) ? raw.items.filter((item) => !listTrackedChanges || storyLocatorSignature(readEntityStory(item)) === "story:body") : []);
+			if (listTrackedChanges) return runUiTrackedChangesCatalogRead(() => tcApi?.list?.());
+			return tcApi?.list ? tcApi.list({ in: "all" }) : void 0;
+		}, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
 		const items = (value ?? []).map(projectTrackChangesItem).filter((item) => item != null).filter((item) => {
 			const id = readEntityId(item);
 			return !id || !postDecisionIds?.has(id);
@@ -4180,8 +4493,20 @@ function createSuperDocUI(options) {
 				if (allStoryItems && !allStoryItems.some((row) => entityRowMatchesRequest(row, active.id, active.story))) setExplicitActiveChange(null);
 			} else if (!items.some((item) => readEntityId(item) === active.id)) setExplicitActiveChange(null);
 		}
-		const selectionActiveChangeIds = postDecisionIds ? selection$1.activeChangeIds.filter((id) => !postDecisionIds.has(id)) : selection$1.activeChangeIds;
-		const activeId = explicitActiveChange?.id ?? selectionActiveChangeIds[0] ?? null;
+		const publicIdItems = allStoryItems ?? items;
+		const selectionIdContext = buildStoryScopedTrackedChangeIdContext(publicIdItems, selectionStory(selection$1));
+		const selectionActiveChangeIds = allTrackedChangesResolvedToken === token ? [] : postDecisionIds ? selection$1.activeChangeIds.filter((id) => !postDecisionIds.has(id)) : selection$1.activeChangeIds;
+		const selectionPublicChangeIds = selectionActiveChangeIds.map((id) => selectionIdContext.toPublicId(id) ?? id);
+		const explicitActiveIdContext = explicitActiveChange?.story ? buildStoryScopedTrackedChangeIdContext(publicIdItems, explicitActiveChange.story) : buildTrackedChangeIdContext(publicIdItems);
+		const explicitActiveId = explicitActiveChange ? explicitActiveIdContext.toPublicId(explicitActiveChange.id) ?? explicitActiveChange.id : null;
+		const selectionActiveId = resolveSelectionActiveChangeId({
+			selectionIds: selectionActiveChangeIds,
+			publicIds: selectionPublicChangeIds,
+			selection: selection$1,
+			bodyItems: items,
+			allStoryItems
+		});
+		const activeId = explicitActiveId ?? selectionActiveId;
 		return {
 			status: combineStatus(listStatus, selection$1.status),
 			items,
@@ -5845,13 +6170,18 @@ function createSuperDocUI(options) {
 		const target = rawTarget && typeof rawTarget === "object" ? rawTarget : null;
 		let next = null;
 		if (target?.entityType === "trackedChange" && typeof target.entityId === "string" && target.entityId.length > 0) {
-			const story = target.story && storyLocatorSignature(target.story) !== storyLocatorSignature(null) ? target.story : void 0;
+			const paintedEntityId = target.entityId;
+			const targetStory = target.story && typeof target.story === "object" ? target.story : void 0;
+			const allStoryItems = readAllStoryTrackChanges();
+			const entityId = (allStoryItems ? targetStory ? buildStoryScopedTrackedChangeIdContext(allStoryItems, targetStory).toPublicId(paintedEntityId) : buildTrackedChangeIdContext(allStoryItems).toPublicId(paintedEntityId) : null) ?? paintedEntityId;
+			const story = targetStory && storyLocatorSignature(targetStory) !== storyLocatorSignature(null) ? targetStory : void 0;
 			next = {
-				id: target.entityId,
+				id: entityId,
 				...story ? { story } : {},
-				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : {}
+				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : entityId !== paintedEntityId ? { paintedEntityId } : {}
 			};
 		}
+		if (rawTarget == null && next == null && explicitActiveChange != null && hasPendingTrackChangeRevealFocus(explicitActiveChange)) return false;
 		if (explicitActiveChangesEqual(explicitActiveChange, next)) return false;
 		setExplicitActiveChange(next);
 		return true;
@@ -5928,6 +6258,20 @@ function createSuperDocUI(options) {
 		try {
 			const off = next.subscribe((event) => {
 				const type = event?.type;
+				if (type === "review-mutation:started") {
+					beginUiReviewMutation(event.reviewMutation?.token);
+					return;
+				}
+				if (type === "review-mutation:aborted") {
+					settleUiReviewMutation(event.reviewMutation?.token);
+					scheduleAsyncRefresh();
+					return;
+				}
+				if (type === "mutation:rejected" && event.reviewMutation) {
+					settleUiReviewMutation(event.reviewMutation.token);
+					scheduleAsyncRefresh();
+				}
+				if (type === "mutation:committed" && event.reviewMutation) settleUiReviewMutation(event.reviewMutation.token);
 				if (type === "source:complete" || type === "source:signals-complete") {
 					if (authoritativeTrackChangesPendingToken !== null) {
 						clearAuthoritativeTrackChangesRetry();
@@ -5943,6 +6287,13 @@ function createSuperDocUI(options) {
 				if (type === "mutation:committed" || type === "save:completed" || type === "collaboration:remote-changed") {
 					const impact = type === "mutation:committed" ? getV2TrackedChangeMutationImpact(event) : null;
 					const supersedesPendingReviewReconcile = type === "mutation:committed" && reviewMutationReconciler.getPendingIds().size > 0;
+					if (impact?.allResolved) {
+						reviewMutationReconciler.reset();
+						replaceTrackedChangeItemsInCache([]);
+						authoritativeTrackChangesPendingToken = null;
+						publishAllTrackedChangesResolved(event.receipt);
+						return;
+					}
 					if (impact?.removedIds.size) markPostDecisionTrackChanges(new Set(impact.removedIds), event.receipt);
 					const authoritativeHistoryImpact = impact?.reconcileMode === "authoritative" && impact.upsertIds.size > 0;
 					if (authoritativeHistoryImpact) {
@@ -6089,6 +6440,17 @@ function createSuperDocUI(options) {
 	function readTrackDecisionTargetId(target) {
 		return target && typeof target === "object" && typeof target.id === "string" ? String(target.id) : null;
 	}
+	function nonBodySelectionStoryLocator(selection$1) {
+		const story = selectionStoryLocator(selection$1);
+		return story && storyLocatorSignature(story) !== storyLocatorSignature(null) ? story : void 0;
+	}
+	function trackDecisionIdTarget(changeId, story) {
+		return {
+			kind: "id",
+			id: changeId,
+			...story ? { story } : {}
+		};
+	}
 	function trackDecisionRangeFromSelection(selection$1) {
 		if (selection$1.empty) return null;
 		const explicit = selection$1.selectionTarget;
@@ -6114,22 +6476,58 @@ function createSuperDocUI(options) {
 			}
 		};
 	}
+	function readBodyTrackChangeForDecision(activeId, story) {
+		if (storyLocatorSignature(story) !== storyLocatorSignature(null)) return void 0;
+		const trackChanges$1 = getDoc()?.trackChanges;
+		const list = trackChanges$1?.list;
+		if (typeof list !== "function") return void 0;
+		const raw = safeCall(() => list.call(trackChanges$1), null);
+		if (isPromiseLike(raw) || !raw || typeof raw !== "object") return void 0;
+		const items = raw.items;
+		if (!Array.isArray(items)) return void 0;
+		return items.map(projectTrackChangesItem).find((item) => item != null && entityRowMatchesRequest(item, activeId, story));
+	}
+	function selectedTextCoversTrackChangeText(selection$1, item) {
+		const selected = normalizeTrackDecisionText(selection$1.quotedText);
+		if (!selected) return false;
+		const payload = trackChangesItemPayload(item);
+		return [
+			payload.insertedText,
+			payload.deletedText,
+			payload.excerpt
+		].some((value) => normalizeTrackDecisionText(value) === selected);
+	}
+	function normalizeTrackDecisionText(value) {
+		return typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "";
+	}
 	function activeChangePartialDecisionRoute() {
 		const activeId = state.selection.activeChangeIds[0];
 		if (!activeId) return "unavailable";
-		const items = readAllStoryTrackChanges();
-		if (!items) return "unavailable";
 		const story = selectionStoryLocator(state.selection);
-		const item = items.find((candidate) => entityRowMatchesRequest(candidate, activeId, story));
+		const item = (state.trackChanges.status === "ready" ? state.trackChanges.items.find((candidate) => entityRowMatchesRequest(candidate, activeId, story)) : void 0) ?? readBodyTrackChangeForDecision(activeId, story) ?? readAllStoryTrackChanges()?.find((candidate) => entityRowMatchesRequest(candidate, activeId, story));
 		if (!item) return "unavailable";
-		const type = trackChangesItemPayload(item).type;
-		const grouping = trackChangesItemPayload(item).grouping;
+		const change = trackChangesItemPayload(item);
+		const type = change.type;
+		const grouping = change.grouping;
+		if (selectedTextCoversTrackChangeText(state.selection, item)) return "id";
 		if (type === "replacement" && grouping === "replacement-pair") return "range";
 		return (type === "insertion" || type === "deletion" || type === "insert" || type === "delete") && grouping === "standalone" ? "range" : "id";
 	}
+	function executeTrackDecisionRangeWithIdFallback(kind, rangeTarget, changeId, story) {
+		const fallback = () => callTrackDecisionTarget(kind, trackDecisionIdTarget(changeId, story), changeId, story);
+		try {
+			const result = callTrackDecisionTarget(kind, rangeTarget, null);
+			if (isPromiseLike(result)) return settleCommandExecution(Promise.resolve(result).then((settled) => {
+				return commandResultSucceeded(commandResultFromOperationResult(settled)) ? settled : fallback();
+			}));
+			return settleCommandExecution(commandResultSucceeded(commandResultFromOperationResult(result)) ? result : fallback());
+		} catch {
+			return false;
+		}
+	}
 	function resolveTrackDecisionTarget(command, payload) {
 		if (command.scope === "all") return {
-			target: { scope: "all" },
+			target: { kind: "all" },
 			changeId: null
 		};
 		if (typeof payload === "string" && payload.length > 0) return {
@@ -6141,26 +6539,27 @@ function createSuperDocUI(options) {
 		};
 		if (payload && typeof payload === "object") {
 			const record = payload;
-			if (record.target && typeof record.target === "object") return {
-				target: record.target,
-				changeId: readTrackDecisionTargetId(record.target)
-			};
+			if (record.target && typeof record.target === "object") {
+				const target = record.target;
+				return {
+					target,
+					changeId: readTrackDecisionTargetId(target),
+					story: target.story
+				};
+			}
 			const id = typeof record.changeId === "string" ? record.changeId : record.id;
 			if (typeof id === "string" && id.length > 0) return {
-				target: {
-					kind: "id",
-					id
-				},
-				changeId: id
+				target: trackDecisionIdTarget(id, record.story),
+				changeId: id,
+				story: record.story
 			};
 		}
 		const selectedId = state.selection.activeChangeIds[0];
+		const story = nonBodySelectionStoryLocator(state.selection);
 		return selectedId ? {
-			target: {
-				kind: "id",
-				id: selectedId
-			},
-			changeId: selectedId
+			target: trackDecisionIdTarget(selectedId, story),
+			changeId: selectedId,
+			story
 		} : null;
 	}
 	function executeTrackDecisionCommand(command, payload) {
@@ -6174,13 +6573,23 @@ function createSuperDocUI(options) {
 				if (route === "unavailable") return false;
 				if (route === "range") {
 					const target = trackDecisionRangeFromSelection(state.selection);
-					return target ? executeTrackDecisionTarget(command.kind, target, null) : false;
+					const story = nonBodySelectionStoryLocator(state.selection);
+					return target ? executeTrackDecisionRangeWithIdFallback(command.kind, target, state.selection.activeChangeIds[0], story) : false;
+				}
+				if (route === "id") {
+					const activeId = state.selection.activeChangeIds[0];
+					const selectedStory = selectionStoryLocator(state.selection);
+					const story = selectedStory && storyLocatorSignature(selectedStory) !== storyLocatorSignature(null) ? selectedStory : void 0;
+					return executeTrackDecision(command.kind, story ? {
+						id: activeId,
+						story
+					} : activeId);
 				}
 			}
 		}
 		const resolved = resolveTrackDecisionTarget(command, payload);
 		if (!resolved) return false;
-		return executeTrackDecisionTarget(command.kind, resolved.target, resolved.changeId);
+		return executeTrackDecisionTarget(command.kind, resolved.target, resolved.changeId, resolved.story);
 	}
 	function executeListToggleCommand(kind, payload) {
 		const lists = getEditCommands()?.lists;
@@ -6364,13 +6773,11 @@ function createSuperDocUI(options) {
 	};
 	const finalizeCommandSettlement = (promise, onSettled) => promise.then((settled) => {
 		onSettled?.(settled);
-		invalidateDocumentContent();
-		recompute();
+		invalidateAfterCommandSettlement();
 		return settled;
 	}, () => {
 		onSettled?.(false);
-		invalidateDocumentContent();
-		recompute();
+		invalidateAfterCommandSettlement();
 		return false;
 	});
 	const settleCommandExecution = (result, onSettled) => {
@@ -6393,8 +6800,7 @@ function createSuperDocUI(options) {
 		}
 		onSettled?.(settled);
 		lastCommandSettlement = Promise.resolve(settled);
-		invalidateDocumentContent();
-		recompute();
+		invalidateAfterCommandSettlement();
 		return settled;
 	};
 	const normalizeWorkflowReceipt = (value, fallback) => {
@@ -7556,6 +7962,14 @@ function createSuperDocUI(options) {
 		if (typeof helper?.apply !== "function") return { reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable };
 		return { helper };
 	};
+	const activateContentControlChrome = (id) => {
+		const host = getHost();
+		if (typeof host?.getHandles !== "function") return;
+		try {
+			const contentControls$1 = (host.getHandles()?.editing)?.contentControls;
+			if (typeof contentControls$1?.activate === "function") contentControls$1.activate({ id });
+		} catch {}
+	};
 	const selection = {
 		get: selectionSnap.get,
 		getSnapshot: selectionSnap.getSnapshot,
@@ -7700,11 +8114,12 @@ function createSuperDocUI(options) {
 			reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable
 		};
 		try {
-			const result = await Promise.resolve(scroll.call(host, {
+			const input = {
 				target,
 				block: options$1?.block ?? "center",
 				behavior: options$1?.behavior ?? "smooth"
-			}));
+			};
+			const result = await Promise.resolve(options$1?.shouldContinue ? scroll.call(host, input, options$1.shouldContinue) : scroll.call(host, input));
 			if (result && typeof result === "object" && result.success === false) return {
 				success: false,
 				ok: false,
@@ -7734,19 +8149,32 @@ function createSuperDocUI(options) {
 				story: requestedStory
 			};
 		};
-		const fromList = readEntityTarget(loaded.find((row) => entityRowMatchesRequest(row, id, requestedStory)));
-		if (fromList) return withRequestedStory(fromList);
+		const readTarget = namespace === "trackChanges" ? readTrackedChangeNavigationTarget : readEntityTarget;
+		const loadedRow = loaded.find((row) => entityRowMatchesRequest(row, id, requestedStory));
+		const loadedRecord = loadedRow && typeof loadedRow === "object" ? loadedRow : null;
+		const moveSide = namespace === "trackChanges" && loadedRecord?.type === "move" && (loadedRecord.subtype === "move-to" || loadedRecord.subtype === "move-from") ? loadedRecord.subtype : null;
+		const trackedChangeLookupId = moveSide && typeof loadedRecord?.trackedChangeCanonicalId === "string" ? loadedRecord.trackedChangeCanonicalId : id;
+		const readResolvedTarget = (row) => {
+			if (!moveSide) return readTarget(row);
+			const moveTarget = readEntityTarget(row);
+			if (moveTarget?.kind !== "move") return null;
+			const sideTarget = moveSide === "move-to" ? moveTarget.destination : moveTarget.source;
+			return isHostGeometryTarget(sideTarget) ? sideTarget : null;
+		};
+		const fromList = readTarget(loadedRow);
+		const listTargetIsAuthoritative = namespace !== "trackChanges" || !moveSide && isHostGeometryTarget(readEntityTarget(loadedRow));
+		if (fromList && listTargetIsAuthoritative) return withRequestedStory(fromList);
 		const api = getDoc()?.[namespace];
 		const input = namespace === "comments" ? { commentId: id } : {
-			id,
+			id: trackedChangeLookupId,
 			...requestedStory ? { story: requestedStory } : {}
 		};
 		const get = api?.get;
-		if (typeof get !== "function") return null;
+		if (typeof get !== "function") return withRequestedStory(fromList);
 		try {
-			return withRequestedStory(readEntityTarget(await Promise.resolve(get.call(api, input))));
+			return withRequestedStory(readResolvedTarget(await Promise.resolve(get.call(api, input))) ?? fromList);
 		} catch {
-			return null;
+			return withRequestedStory(fromList);
 		}
 	};
 	function patchCommentStatus(commentId, status) {
@@ -7801,10 +8229,14 @@ function createSuperDocUI(options) {
 			const op = commentsApi?.create;
 			if (typeof op !== "function") return failedReceipt("comments.create is unavailable.");
 			const fallback = failedReceipt("comments.create failed.");
-			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
-				target: capture.target ?? capture.selectionTarget,
-				text: input.text
-			}), fallback), fallback);
+			return safeCall(() => {
+				const target = capture && typeof capture === "object" ? capture.target ?? capture.selectionTarget : null;
+				if (target == null) return failedReceipt("A range selection is required to comment.", "NO_SELECTION");
+				return settleWorkflowReceipt(op.call(commentsApi, {
+					target,
+					text: input.text
+				}), fallback);
+			}, fallback);
 		},
 		createFromSelection: (input) => {
 			const refusal = commentWriteRefusal();
@@ -7836,6 +8268,18 @@ function createSuperDocUI(options) {
 				text: input.text
 			}), fallback), fallback);
 		},
+		edit: (commentId, input) => {
+			const refusal = commentWriteRefusal();
+			if (refusal) return refusal;
+			const commentsApi = getDoc()?.comments;
+			const op = commentsApi?.patch;
+			if (typeof op !== "function") return failedReceipt("comments.patch is unavailable.");
+			const fallback = failedReceipt("comments.patch failed.");
+			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
+				commentId,
+				text: input.text
+			}), fallback), fallback);
+		},
 		resolve: (commentId) => patchCommentStatus(commentId, "resolved"),
 		reopen: (commentId) => patchCommentStatus(commentId, "active"),
 		delete: (commentId) => {
@@ -7880,10 +8324,12 @@ function createSuperDocUI(options) {
 	};
 	const trackChangesSub = sliceHandle((s) => s.trackChanges);
 	const navigateTrackChange = (step, options$1) => {
-		const rows = trackChangesSub.get().items.filter((item) => readEntityId(item) !== null);
-		if (rows.length === 0) return null;
+		const allRows = trackChangesSub.get().items.filter((item) => readEntityId(item) !== null);
+		if (allRows.length === 0) return null;
 		const currentId = state.trackChanges.activeId;
 		const currentStory = explicitActiveChange?.id === currentId ? explicitActiveChange.story : void 0;
+		const bodyRows = allRows.filter((row) => readEntityRequestStory(row) == null);
+		const rows = currentStory || bodyRows.length === 0 ? allRows : bodyRows;
 		let currentIdx = currentId ? rows.findIndex((row) => entityRowMatchesRequest(row, currentId, currentStory)) : -1;
 		if (currentIdx === -1 && currentId && currentStory) currentIdx = rows.findIndex((row) => entityRowMatchesRequest(row, currentId));
 		const nextRow = rows[currentIdx === -1 ? step > 0 ? 0 : rows.length - 1 : (currentIdx + step + rows.length) % rows.length];
@@ -7908,33 +8354,41 @@ function createSuperDocUI(options) {
 		if (activeId == null) return { success: false };
 		const optimisticActiveChange = explicitActiveChange;
 		const optimisticRevision = explicitActiveChangeRevision;
-		const isCurrent = () => explicitActiveChange === optimisticActiveChange && explicitActiveChangeRevision === optimisticRevision;
+		const isCurrent = () => queuedTrackChangeNavigationInvalidation === requestedAtInvalidation && explicitActiveChange === optimisticActiveChange && explicitActiveChangeRevision === optimisticRevision;
 		const rollback = () => {
 			if (!isCurrent()) return;
 			setExplicitActiveChange(previousActiveChange, { invalidateQueuedNavigation: false });
 			recompute();
 		};
-		const target = await resolveEntityTarget("trackChanges", activeId, trackChangesSub.get().items, optimisticActiveChange?.story ? { story: optimisticActiveChange.story } : void 0);
-		if (!isCurrent()) return { success: false };
-		if (!target) {
-			rollback();
-			return { success: false };
-		}
-		trackedChangeNavigationInFlight += 1;
+		if (optimisticActiveChange) pendingTrackChangeRevealFocuses.add(optimisticActiveChange);
 		try {
-			const result = await scrollTargetIntoView(target, { behavior: "auto" });
+			const target = await resolveEntityTarget("trackChanges", activeId, trackChangesSub.get().items, optimisticActiveChange?.story ? { story: optimisticActiveChange.story } : void 0);
 			if (!isCurrent()) return { success: false };
-			if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
+			if (!target) {
 				rollback();
-				mirrorTrackedChangeFocusToHost(previousActiveChange);
-			} else mirrorTrackedChangeFocusToHost(optimisticActiveChange);
-			return { success: result.ok };
-		} finally {
-			trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
-			if (trackedChangeNavigationInFlight === 0) {
-				if (!isCurrent()) mirrorTrackedChangeFocusToHost(explicitActiveChange);
-				else if (currentHostReviewSource) syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(currentHostReviewSource));
+				return { success: false };
+			}
+			trackedChangeNavigationInFlight += 1;
+			try {
+				const result = await scrollTargetIntoView(target, {
+					behavior: "auto",
+					shouldContinue: isCurrent
+				});
+				if (!isCurrent()) return { success: false };
+				if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
+					rollback();
+					mirrorTrackedChangeFocusToHost(previousActiveChange);
+				} else mirrorTrackedChangeFocusToHost(optimisticActiveChange);
+				return { success: result.ok };
+			} finally {
+				trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
+				if (trackedChangeNavigationInFlight === 0) {
+					if (!isCurrent()) mirrorTrackedChangeFocusToHost(explicitActiveChange);
+					else if (currentHostReviewSource) syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(currentHostReviewSource));
+				}
 			}
+		} finally {
+			if (optimisticActiveChange) pendingTrackChangeRevealFocuses.delete(optimisticActiveChange);
 		}
 	};
 	const navigateAndScroll = (step) => {
@@ -7966,8 +8420,8 @@ function createSuperDocUI(options) {
 		},
 		accept: (changeId) => executeTrackDecision("accept", changeId),
 		reject: (changeId) => executeTrackDecision("reject", changeId),
-		acceptAll: () => executeTrackDecisionTarget("accept", { scope: "all" }, null),
-		rejectAll: () => executeTrackDecisionTarget("reject", { scope: "all" }, null),
+		acceptAll: () => executeTrackDecisionTarget("accept", { kind: "all" }, null),
+		rejectAll: () => executeTrackDecisionTarget("reject", { kind: "all" }, null),
 		next: () => navigateTrackChange(1),
 		previous: () => navigateTrackChange(-1),
 		navigateNext: () => navigateAndScroll(1),
@@ -7976,7 +8430,7 @@ function createSuperDocUI(options) {
 			if (!input || typeof input !== "object" || typeof input.x !== "number" || typeof input.y !== "number") return null;
 			const hits = entityAt(input);
 			if (hits.length === 0) return null;
-			const bodyItems = trackChangesSub.get().items;
+			const items = trackChangesSub.get().items;
 			let allStoryItems;
 			for (const hit of hits) {
 				if (hit.type !== "trackedChange") continue;
@@ -7985,7 +8439,7 @@ function createSuperDocUI(options) {
 					if (allStoryItems === void 0) allStoryItems = readAllStoryTrackChanges();
 					if (!allStoryItems) continue;
 					candidates = allStoryItems;
-				} else candidates = bodyItems;
+				} else candidates = items;
 				const item = candidates.find((candidate) => entityRowMatchesRequest(candidate, hit.id, hit.story));
 				if (item) return hit.story ? {
 					id: item.id,
@@ -8019,10 +8473,12 @@ function createSuperDocUI(options) {
 				if (!allStoryItems.some((row) => entityRowMatchesRequest(row, publicId, requested.story))) return false;
 				requested.id = publicId;
 			} else {
-				const bodyItems = trackChangesSub.get().items;
-				const publicId = buildTrackedChangeIdContext(bodyItems).toPublicId(requested.id) ?? requested.id;
-				if (!bodyItems.some((item) => readEntityId(item) === publicId)) return false;
+				const items = trackChangesSub.get().items;
+				const publicId = buildTrackedChangeIdContext(items).toPublicId(requested.id) ?? requested.id;
+				const item = items.find((candidate) => readEntityId(candidate) === publicId);
+				if (!item) return false;
 				requested.id = publicId;
+				requested.story = readEntityRequestStory(item);
 			}
 			if (paintedEntityId !== requested.id) requested.paintedEntityId = paintedEntityId;
 			setExplicitActiveChange(requested);
@@ -8036,47 +8492,65 @@ function createSuperDocUI(options) {
 				ok: false,
 				reason: getEditor() ? SUPERDOC_UI_REASONS.documentApiUnavailable : SUPERDOC_UI_REASONS.notReady
 			};
+			queuedTrackChangeNavigationInvalidation += 1;
+			trackChangeRevealInvalidation += 1;
+			const requestedAtInvalidation = trackChangeRevealInvalidation;
 			const loadedItems = trackChangesSub.get().items;
-			const story = readEntityRequestStory(loadedItems.find((item) => readEntityId(item) === changeId));
-			const target = await resolveEntityTarget("trackChanges", changeId, loadedItems, story ? { story } : void 0);
-			if (!target) return {
-				success: false,
-				ok: false,
-				reason: SUPERDOC_UI_REASONS.targetUnresolved
-			};
+			const publicId = buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
+			const story = readEntityRequestStory(loadedItems.find((item) => readEntityId(item) === publicId));
 			const previousActiveChange = explicitActiveChange;
-			const requestedActiveChange = story ? {
-				id: changeId,
-				story
-			} : { id: changeId };
-			setExplicitActiveChange(requestedActiveChange);
-			recompute();
-			const optimisticActiveChange = explicitActiveChange;
-			const optimisticRevision = explicitActiveChangeRevision;
-			const isCurrent = () => explicitActiveChange === optimisticActiveChange && explicitActiveChangeRevision === optimisticRevision;
-			const rollback = () => {
-				if (!isCurrent()) return;
-				setExplicitActiveChange(previousActiveChange, { invalidateQueuedNavigation: false });
-				recompute();
+			const requestedActiveChange = {
+				id: publicId,
+				...story ? { story } : {},
+				...publicId !== changeId ? { paintedEntityId: changeId } : {}
 			};
-			trackedChangeNavigationInFlight += 1;
+			pendingTrackChangeRevealFocuses.add(requestedActiveChange);
 			try {
-				const result = await scrollTargetIntoView(target, { behavior: "auto" });
-				if (!isCurrent()) return {
+				const target = await resolveEntityTarget("trackChanges", publicId, loadedItems, story ? { story } : void 0);
+				if (trackChangeRevealInvalidation !== requestedAtInvalidation) return {
 					success: false,
 					ok: false
 				};
-				if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
-					rollback();
-					mirrorTrackedChangeFocusToHost(previousActiveChange);
-				} else mirrorTrackedChangeFocusToHost(requestedActiveChange);
-				return result;
-			} finally {
-				trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
-				if (trackedChangeNavigationInFlight === 0) {
-					if (!isCurrent()) mirrorTrackedChangeFocusToHost(explicitActiveChange);
-					else if (currentHostReviewSource) syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(currentHostReviewSource));
+				if (!target) return {
+					success: false,
+					ok: false,
+					reason: SUPERDOC_UI_REASONS.targetUnresolved
+				};
+				setExplicitActiveChange(requestedActiveChange);
+				const revealInvalidation = trackChangeRevealInvalidation;
+				const optimisticActiveChange = explicitActiveChange;
+				const optimisticRevision = explicitActiveChangeRevision;
+				const isCurrent = () => trackChangeRevealInvalidation === revealInvalidation && explicitActiveChange === optimisticActiveChange && explicitActiveChangeRevision === optimisticRevision;
+				const rollback = () => {
+					if (!isCurrent()) return;
+					setExplicitActiveChange(previousActiveChange, { invalidateQueuedNavigation: false });
+					recompute();
+				};
+				recompute();
+				trackedChangeNavigationInFlight += 1;
+				try {
+					const result = await scrollTargetIntoView(target, {
+						behavior: "auto",
+						shouldContinue: isCurrent
+					});
+					if (!isCurrent()) return {
+						success: false,
+						ok: false
+					};
+					if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
+						rollback();
+						mirrorTrackedChangeFocusToHost(previousActiveChange);
+					} else mirrorTrackedChangeFocusToHost(requestedActiveChange);
+					return result;
+				} finally {
+					trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
+					if (trackedChangeNavigationInFlight === 0) {
+						if (!isCurrent()) mirrorTrackedChangeFocusToHost(explicitActiveChange);
+						else if (currentHostReviewSource) syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(currentHostReviewSource));
+					}
 				}
+			} finally {
+				pendingTrackChangeRevealFocuses.delete(requestedActiveChange);
 			}
 		}
 	};
@@ -8101,7 +8575,7 @@ function createSuperDocUI(options) {
 	const callTrackDecisionTarget = (kind, target, changeId, story) => {
 		if (reviewMutationsAreReadOnly()) return false;
 		const tcApi = getDoc()?.trackChanges;
-		const isAllTarget = target.scope === "all";
+		const isAllTarget = target.kind === "all" || target.scope === "all";
 		const isRangeTarget = target.kind === "range";
 		const isMultiIdTarget = target.kind === "ids";
 		if (bulkTrackDecisionBlockedReason({
@@ -8204,6 +8678,7 @@ function createSuperDocUI(options) {
 				success: false,
 				reason: "not-reachable"
 			};
+			activateContentControlChrome(id);
 			return { success: true };
 		}
 	};
@@ -8331,8 +8806,8 @@ function createSuperDocUI(options) {
 		const rawHits = collectEntityHitsFromChain(startEls[0], container);
 		for (let i = 1; i < startEls.length; i += 1) for (const hit of collectEntityHitsFromChain(startEls[i], container)) rawHits.push(hit);
 		if (rawHits.length === 0) return rawHits;
-		const bodyItems = trackChangesSub.get().items;
-		const bodyIdContext = buildTrackedChangeIdContext(bodyItems);
+		const items = trackChangesSub.get().items;
+		const idContext = buildTrackedChangeIdContext(items);
 		let allStoryItems;
 		const seen = /* @__PURE__ */ new Set();
 		const hits = [];
@@ -8352,7 +8827,7 @@ function createSuperDocUI(options) {
 				publicId = buildStoryScopedTrackedChangeIdContext(allStoryItems, story).toPublicId(hit.id);
 				if (!publicId || !allStoryItems.some((item) => entityRowMatchesRequest(item, publicId, story))) continue;
 			} else {
-				publicId = bodyIdContext.toPublicId(hit.id);
+				publicId = idContext.toPublicId(hit.id);
 				if (!publicId) continue;
 			}
 			const key = `trackedChange:${publicId}`;
@@ -9151,6 +9626,7 @@ function createSuperDocUI(options) {
 	const destroy = () => {
 		if (disposed) return;
 		disposed = true;
+		releaseSharedUiTrackedChangesCatalog(uiTrackedChangesCatalogHost, uiTrackedChangesCatalogState);
 		reviewMutationReconciler.reset();
 		clearAuthoritativeTrackChangesRetry();
 		if (foregroundAsyncRetryTimer) {
@@ -9413,6 +9889,12 @@ Object.defineProperty(exports, "BUILT_IN_COMMAND_IDS", {
 		return BUILT_IN_COMMAND_IDS;
 	}
 });
+Object.defineProperty(exports, "DOM_CLASS_NAMES", {
+	enumerable: true,
+	get: function() {
+		return DOM_CLASS_NAMES;
+	}
+});
 Object.defineProperty(exports, "composeAuthorColorResolver", {
 	enumerable: true,
 	get: function() {