superdoc 2.4.0-next.1 → 2.4.0-next.10

package/dist/chunks/{create-super-doc-ui-DXdWuTzm.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;
@@ -334,14 +395,21 @@ function getV2TrackedChangeMutationImpact(event) {
 		});
 	}
 	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,
 		remappedPairs,
-		reconcileMode: event.origin === "history" ? "authoritative" : "targeted"
+		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;
@@ -352,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();
@@ -369,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;
@@ -378,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;
@@ -428,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(() => {
@@ -446,6 +549,15 @@ 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);
@@ -460,7 +572,7 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 			else pendingUpserts.delete(id);
 		}
 		const context = getContext();
-		if (removedIds.size > 0 && upsertIds.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
@@ -487,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) {
@@ -509,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() {
@@ -1401,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",
@@ -1716,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;
@@ -1812,12 +1920,12 @@ const HEAVY_DOC_READ_POLICY = [
 	{
 		key: "trackChanges",
 		match: "exact",
-		note: "audited: all-story 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",
@@ -3276,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;
@@ -3287,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}`;
@@ -3365,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();
@@ -4043,6 +4226,7 @@ function createSuperDocUI(options) {
 		detachSourceLoading = null;
 		sourceLoadingSubscriptionHost = null;
 		clearPostDecisionTrackChanges();
+		allTrackedChangesResolvedToken = null;
 	};
 	const invalidateDocumentContent = () => {
 		const carryAuthoritativeTrackChangesHold = authoritativeTrackChangesPendingToken !== null;
@@ -4050,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");
@@ -4253,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;
@@ -4269,7 +4472,7 @@ function createSuperDocUI(options) {
 			value: heldEntry?.hasSettled ? heldEntry.value : null,
 			status: heldEntry?.hasSettled ? "stale" : "pending"
 		} : readAsync("trackChanges", token, () => {
-			if (listTrackedChanges) return listTrackedChanges.call(v2TrackedChanges);
+			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) => {
@@ -4292,7 +4495,7 @@ function createSuperDocUI(options) {
 		}
 		const publicIdItems = allStoryItems ?? items;
 		const selectionIdContext = buildStoryScopedTrackedChangeIdContext(publicIdItems, selectionStory(selection$1));
-		const selectionActiveChangeIds = postDecisionIds ? selection$1.activeChangeIds.filter((id) => !postDecisionIds.has(id)) : selection$1.activeChangeIds;
+		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;
@@ -6055,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();
@@ -6070,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) {
@@ -6303,7 +6527,7 @@ function createSuperDocUI(options) {
 	}
 	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 {
@@ -6549,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) => {
@@ -6578,8 +6800,7 @@ function createSuperDocUI(options) {
 		}
 		onSettled?.(settled);
 		lastCommandSettlement = Promise.resolve(settled);
-		invalidateDocumentContent();
-		recompute();
+		invalidateAfterCommandSettlement();
 		return settled;
 	};
 	const normalizeWorkflowReceipt = (value, fallback) => {
@@ -7741,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,
@@ -8000,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();
@@ -8035,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) => {
@@ -8175,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),
@@ -8330,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({
@@ -8433,6 +8678,7 @@ function createSuperDocUI(options) {
 				success: false,
 				reason: "not-reachable"
 			};
+			activateContentControlChrome(id);
 			return { success: true };
 		}
 	};
@@ -9380,6 +9626,7 @@ function createSuperDocUI(options) {
 	const destroy = () => {
 		if (disposed) return;
 		disposed = true;
+		releaseSharedUiTrackedChangesCatalog(uiTrackedChangesCatalogHost, uiTrackedChangesCatalogState);
 		reviewMutationReconciler.reset();
 		clearAuthoritativeTrackChangesRetry();
 		if (foregroundAsyncRetryTimer) {
@@ -9642,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() {