superdoc 2.4.0-next.16 → 2.4.0-next.18

package/dist/chunks/{create-super-doc-ui-BRBwfV-s.es.js → create-super-doc-ui-BbNbi0cj.es.js}

@@ -763,56 +763,6 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	};
 }
 //#endregion
-//#region src/helpers/v2-typing-mutation-event.js
-/**
-* Command kinds whose committed mutations belong to the sustained typing
-* cadence class (insert / replace / plain paste / Backspace / Delete).
-*
-* The SuperDoc shell debounces per-keystroke review-row hydration for these
-* kinds instead of refreshing comments + tracked changes on every commit —
-* hydrating immediately per keystroke was a measured worker-read storm during
-* typing and backspace bursts. The `text.*` aliases cover integrations that
-* forward Document API style command ids rather than editable-input kinds.
-*/
-var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
-	"insert-text",
-	"replace-text",
-	"plain-text-paste",
-	"delete-backward",
-	"delete-forward",
-	"text.insert",
-	"text.replace",
-	"text.pastePlain",
-	"text.deleteBackward",
-	"text.deleteForward",
-	"structural.enter",
-	"structural:enter-split-paragraph",
-	"structural:enter-insert-paragraph-before",
-	"structural:enter-insert-paragraph-after",
-	"structural:shift-enter-line-break",
-	"structural:backspace-boundary-merge-with-previous",
-	"structural:delete-boundary-merge-with-next",
-	"backspace:boundary-merge-with-previous",
-	"backspace:list-remove",
-	"backspace:list-outdent"
-]);
-/**
-* True when a forwarded v2 host event is a committed editable-input mutation
-* of the sustained-typing class, i.e. review-row hydration for it should be
-* debounced rather than fired immediately.
-*
-* Events without a forwarded `editableCommandKind` (programmatic Document API
-* mutations, history commits, unclassified structural commands) return false
-* so they keep hydrating immediately.
-*
-* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
-* @returns {boolean}
-*/
-var isV2EditableTextMutationEvent = (event) => {
-	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
-	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
-};
-//#endregion
 //#region src/public/ui/reasons.ts
 /**
 * Stable public reason taxonomy for the v2-native `superdoc/ui` controller.
@@ -1768,6 +1718,56 @@ function selectionKey(selection) {
 	}
 }
 //#endregion
+//#region src/helpers/v2-typing-mutation-event.js
+/**
+* Command kinds whose committed mutations belong to the sustained typing
+* cadence class (insert / replace / plain paste / Backspace / Delete).
+*
+* The SuperDoc shell debounces per-keystroke review-row hydration for these
+* kinds instead of refreshing comments + tracked changes on every commit —
+* hydrating immediately per keystroke was a measured worker-read storm during
+* typing and backspace bursts. The `text.*` aliases cover integrations that
+* forward Document API style command ids rather than editable-input kinds.
+*/
+var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
+	"insert-text",
+	"replace-text",
+	"plain-text-paste",
+	"delete-backward",
+	"delete-forward",
+	"text.insert",
+	"text.replace",
+	"text.pastePlain",
+	"text.deleteBackward",
+	"text.deleteForward",
+	"structural.enter",
+	"structural:enter-split-paragraph",
+	"structural:enter-insert-paragraph-before",
+	"structural:enter-insert-paragraph-after",
+	"structural:shift-enter-line-break",
+	"structural:backspace-boundary-merge-with-previous",
+	"structural:delete-boundary-merge-with-next",
+	"backspace:boundary-merge-with-previous",
+	"backspace:list-remove",
+	"backspace:list-outdent"
+]);
+/**
+* True when a forwarded v2 host event is a committed editable-input mutation
+* of the sustained-typing class, i.e. review-row hydration for it should be
+* debounced rather than fired immediately.
+*
+* Events without a forwarded `editableCommandKind` (programmatic Document API
+* mutations, history commits, unclassified structural commands) return false
+* so they keep hydrating immediately.
+*
+* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
+* @returns {boolean}
+*/
+var isV2EditableTextMutationEvent = (event) => {
+	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
+	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
+};
+//#endregion
 //#region src/public/ui/entity-at.ts
 function parseCommaSeparatedIds(value) {
 	return value.split(",").map((id) => id.trim()).filter(Boolean);
@@ -3727,6 +3727,23 @@ function createSuperDocUI(options) {
 		const trackedChanges = getEditor()?.v2TrackedChanges;
 		return trackedChanges && typeof trackedChanges === "object" ? trackedChanges : null;
 	};
+	/** Read the committed V2 page-window review feed (never a document catalog). */
+	const getV2ReviewWindowSource = () => {
+		const editor = getEditor();
+		if (editor?.editorVersion !== 2) return null;
+		const reviewHydration = editor.reviewHydration;
+		return reviewHydration && typeof reviewHydration === "object" ? reviewHydration : null;
+	};
+	const getV2ReviewWindowSnapshot = () => {
+		const source = getV2ReviewWindowSource();
+		if (!source || typeof source.getSnapshot !== "function") return null;
+		return safeCall(() => source.getSnapshot(), null);
+	};
+	const hasV2ReviewWindowFeed = () => typeof getV2ReviewWindowSource()?.getSnapshot === "function";
+	const reviewWindowSliceStatus = (snapshot) => {
+		const status = snapshot?.status;
+		return status === "ready" || status === "stale" ? status : "pending";
+	};
 	/** Read the live v2 editor host (inline mode only), when exposed. */
 	const getHost = () => {
 		const host = getEditor()?.host;
@@ -4481,6 +4498,12 @@ function createSuperDocUI(options) {
 		if (entry?.hasSettled || entry?.inflightToken != null) return;
 		demandHeavyDocRead("trackChanges");
 	};
+	/** Demand-driven route for an explicitly consumed comments list. */
+	const ensureCommentsCatalog = () => {
+		const entry = asyncReads.get("comments");
+		if (entry?.hasSettled || entry?.inflightToken != null) return;
+		demandHeavyDocRead("comments");
+	};
 	const HEAVY_READ_IDLE_MS = 6500;
 	const HEAVY_READ_IDLE_POLL_MS = 250;
 	let lastEditableMutationAtMs = 0;
@@ -5114,7 +5137,12 @@ function createSuperDocUI(options) {
 	};
 	const computeComments = (selection) => {
 		const commentsApi = getDoc()?.comments;
-		const { value, status: listStatus } = readAsync("comments", contentToken(), () => commentsApi?.list ? commentsApi.list() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const reviewWindow = getV2ReviewWindowSnapshot();
+		const catalog = readAsync("comments", contentToken(), () => commentsApi?.list ? commentsApi.list() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const windowItems = hasV2ReviewWindowFeed() && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const useWindowSlice = catalog.status === "pending" && windowItems != null;
+		const value = useWindowSlice ? windowItems : catalog.value;
+		const listStatus = useWindowSlice ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
 		const activeIds = selection.activeCommentIds;
 		if (explicitActiveCommentId && !items.some((item) => readEntityId(item) === explicitActiveCommentId)) explicitActiveCommentId = null;
@@ -5157,13 +5185,18 @@ function createSuperDocUI(options) {
 		const token = contentToken();
 		const postDecisionIds = postDecisionTrackChangeIdsForToken(token);
 		const heldEntry = asyncReads.get("trackChanges");
-		const { value, status: listStatus } = authoritativeTrackChangesPendingToken === token ? {
+		const reviewWindow = getV2ReviewWindowSnapshot();
+		const catalog = authoritativeTrackChangesPendingToken === token ? {
 			value: heldEntry?.hasSettled ? heldEntry.value : null,
 			status: heldEntry?.hasSettled ? "stale" : "pending"
 		} : readAsync("trackChanges", token, () => {
 			if (listTrackedChanges) return runUiTrackedChangesCatalogRead(() => tcApi?.list?.());
 			return tcApi?.list ? tcApi.list({ in: "all" }) : void 0;
 		}, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const windowItems = hasV2ReviewWindowFeed() && Array.isArray(reviewWindow?.trackedChangeItems) ? reviewWindow.trackedChangeItems : null;
+		const useWindowSlice = catalog.status === "pending" && windowItems != null;
+		const value = useWindowSlice ? windowItems : catalog.value;
+		const listStatus = useWindowSlice ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = (value ?? []).map(projectTrackChangesItem).filter((item) => item != null).filter((item) => {
 			const id = readEntityId(item);
 			return !id || !postDecisionIds?.has(id);
@@ -6934,6 +6967,8 @@ function createSuperDocUI(options) {
 	let detachHostSelection = null;
 	let currentEditCommandsSource = null;
 	let detachEditCommands = null;
+	let currentV2ReviewWindowSource = null;
+	let detachV2ReviewWindow = null;
 	let editCommandsRecomputeQueued = false;
 	const requestEditCommandsRecompute = () => {
 		if (disposed || editCommandsRecomputeQueued) return;
@@ -6963,6 +6998,22 @@ function createSuperDocUI(options) {
 			currentEditCommandsSource = null;
 		}
 	};
+	const syncV2ReviewWindowSubscription = () => {
+		const next = getV2ReviewWindowSource();
+		if (next === currentV2ReviewWindowSource) return;
+		if (detachV2ReviewWindow) {
+			detachV2ReviewWindow();
+			detachV2ReviewWindow = null;
+		}
+		currentV2ReviewWindowSource = next;
+		if (!next || typeof next.subscribe !== "function") return;
+		try {
+			const unsubscribe = next.subscribe(() => recompute());
+			if (typeof unsubscribe === "function") detachV2ReviewWindow = unsubscribe;
+		} catch {
+			currentV2ReviewWindowSource = null;
+		}
+	};
 	let currentHostReviewSource = null;
 	let detachHostReview = null;
 	let currentHostEventsSource = null;
@@ -7195,6 +7246,7 @@ function createSuperDocUI(options) {
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
 		syncEditCommandsSubscription();
+		syncV2ReviewWindowSubscription();
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
@@ -7267,6 +7319,7 @@ function createSuperDocUI(options) {
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
 	syncEditCommandsSubscription();
+	syncV2ReviewWindowSubscription();
 	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
@@ -9189,6 +9242,7 @@ function createSuperDocUI(options) {
 		subscribe: commentsSnap.subscribe,
 		observe: commentsSnap.observe,
 		list: (query) => {
+			ensureCommentsCatalog();
 			const snapshot = commentsSub.get();
 			if (snapshot.status !== "pending") return filterCommentsSnapshot(snapshot.items, query);
 			const commentsApi = getDoc()?.comments;
@@ -9323,6 +9377,19 @@ function createSuperDocUI(options) {
 		recompute();
 		return activeId;
 	};
+	const restampVisibleTrackedChangeCarrierAliases = async (publicId) => {
+		const v2TrackedChanges = getV2TrackedChanges();
+		const listTrackedChanges = v2TrackedChanges?.listTrackedChanges;
+		if (typeof listTrackedChanges !== "function") return;
+		try {
+			await Promise.resolve(listTrackedChanges.call(v2TrackedChanges, {
+				mode: "visible-window",
+				targetIds: [publicId],
+				refreshReason: "ui-track-change-reveal-restamp",
+				blocking: true
+			}));
+		} catch {}
+	};
 	let trackChangeNavigationTail = Promise.resolve();
 	const navigateAndScrollNow = (step) => {
 		const requestedAtInvalidation = queuedTrackChangeNavigationInvalidation;
@@ -9359,7 +9426,11 @@ function createSuperDocUI(options) {
 				if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
 					rollback();
 					mirrorTrackedChangeFocusToHost(previousActiveChange);
-				} else mirrorTrackedChangeFocusToHost(optimisticActiveChange);
+				} else {
+					if (result.ok) await restampVisibleTrackedChangeCarrierAliases(activeId);
+					if (!isCurrent()) return { success: false };
+					mirrorTrackedChangeFocusToHost(optimisticActiveChange);
+				}
 				return { success: result.ok };
 			} finally {
 				trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
@@ -9509,7 +9580,14 @@ function createSuperDocUI(options) {
 					if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
 						rollback();
 						mirrorTrackedChangeFocusToHost(previousActiveChange);
-					} else mirrorTrackedChangeFocusToHost(requestedActiveChange);
+					} else {
+						if (result.ok) await restampVisibleTrackedChangeCarrierAliases(publicId);
+						if (!isCurrent()) return {
+							success: false,
+							ok: false
+						};
+						mirrorTrackedChangeFocusToHost(requestedActiveChange);
+					}
 					return result;
 				} finally {
 					trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
@@ -10681,6 +10759,9 @@ function createSuperDocUI(options) {
 		if (detachEditCommands) detachEditCommands();
 		detachEditCommands = null;
 		currentEditCommandsSource = null;
+		if (detachV2ReviewWindow) detachV2ReviewWindow();
+		detachV2ReviewWindow = null;
+		currentV2ReviewWindowSource = null;
 		if (detachHostReview) detachHostReview();
 		detachHostReview = null;
 		currentHostReviewSource = null;
@@ -10928,4 +11009,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { createV2ReviewMutationReconciler as a, isV2EditableTextMutationEvent as i, shallowEqual as n, getV2TrackedChangeMutationImpact as o, BUILT_IN_COMMAND_IDS as r, DOM_CLASS_NAMES as s, createSuperDocUI as t };
+export { getV2TrackedChangeMutationImpact as a, createV2ReviewMutationReconciler as i, shallowEqual as n, DOM_CLASS_NAMES as o, BUILT_IN_COMMAND_IDS as r, createSuperDocUI as t };

package/dist/chunks/{create-super-doc-ui-CTe12b19.cjs → create-super-doc-ui-CPuOlTWb.cjs}

@@ -763,56 +763,6 @@ function createV2ReviewMutationReconciler({ getContext, reconcile, hydrate, onRe
 	};
 }
 //#endregion
-//#region src/helpers/v2-typing-mutation-event.js
-/**
-* Command kinds whose committed mutations belong to the sustained typing
-* cadence class (insert / replace / plain paste / Backspace / Delete).
-*
-* The SuperDoc shell debounces per-keystroke review-row hydration for these
-* kinds instead of refreshing comments + tracked changes on every commit —
-* hydrating immediately per keystroke was a measured worker-read storm during
-* typing and backspace bursts. The `text.*` aliases cover integrations that
-* forward Document API style command ids rather than editable-input kinds.
-*/
-var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
-	"insert-text",
-	"replace-text",
-	"plain-text-paste",
-	"delete-backward",
-	"delete-forward",
-	"text.insert",
-	"text.replace",
-	"text.pastePlain",
-	"text.deleteBackward",
-	"text.deleteForward",
-	"structural.enter",
-	"structural:enter-split-paragraph",
-	"structural:enter-insert-paragraph-before",
-	"structural:enter-insert-paragraph-after",
-	"structural:shift-enter-line-break",
-	"structural:backspace-boundary-merge-with-previous",
-	"structural:delete-boundary-merge-with-next",
-	"backspace:boundary-merge-with-previous",
-	"backspace:list-remove",
-	"backspace:list-outdent"
-]);
-/**
-* True when a forwarded v2 host event is a committed editable-input mutation
-* of the sustained-typing class, i.e. review-row hydration for it should be
-* debounced rather than fired immediately.
-*
-* Events without a forwarded `editableCommandKind` (programmatic Document API
-* mutations, history commits, unclassified structural commands) return false
-* so they keep hydrating immediately.
-*
-* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
-* @returns {boolean}
-*/
-var isV2EditableTextMutationEvent = (event) => {
-	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
-	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
-};
-//#endregion
 //#region src/public/ui/reasons.ts
 /**
 * Stable public reason taxonomy for the v2-native `superdoc/ui` controller.
@@ -1768,6 +1718,56 @@ function selectionKey(selection) {
 	}
 }
 //#endregion
+//#region src/helpers/v2-typing-mutation-event.js
+/**
+* Command kinds whose committed mutations belong to the sustained typing
+* cadence class (insert / replace / plain paste / Backspace / Delete).
+*
+* The SuperDoc shell debounces per-keystroke review-row hydration for these
+* kinds instead of refreshing comments + tracked changes on every commit —
+* hydrating immediately per keystroke was a measured worker-read storm during
+* typing and backspace bursts. The `text.*` aliases cover integrations that
+* forward Document API style command ids rather than editable-input kinds.
+*/
+var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
+	"insert-text",
+	"replace-text",
+	"plain-text-paste",
+	"delete-backward",
+	"delete-forward",
+	"text.insert",
+	"text.replace",
+	"text.pastePlain",
+	"text.deleteBackward",
+	"text.deleteForward",
+	"structural.enter",
+	"structural:enter-split-paragraph",
+	"structural:enter-insert-paragraph-before",
+	"structural:enter-insert-paragraph-after",
+	"structural:shift-enter-line-break",
+	"structural:backspace-boundary-merge-with-previous",
+	"structural:delete-boundary-merge-with-next",
+	"backspace:boundary-merge-with-previous",
+	"backspace:list-remove",
+	"backspace:list-outdent"
+]);
+/**
+* True when a forwarded v2 host event is a committed editable-input mutation
+* of the sustained-typing class, i.e. review-row hydration for it should be
+* debounced rather than fired immediately.
+*
+* Events without a forwarded `editableCommandKind` (programmatic Document API
+* mutations, history commits, unclassified structural commands) return false
+* so they keep hydrating immediately.
+*
+* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
+* @returns {boolean}
+*/
+var isV2EditableTextMutationEvent = (event) => {
+	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
+	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
+};
+//#endregion
 //#region src/public/ui/entity-at.ts
 function parseCommaSeparatedIds(value) {
 	return value.split(",").map((id) => id.trim()).filter(Boolean);
@@ -3727,6 +3727,23 @@ function createSuperDocUI(options) {
 		const trackedChanges = getEditor()?.v2TrackedChanges;
 		return trackedChanges && typeof trackedChanges === "object" ? trackedChanges : null;
 	};
+	/** Read the committed V2 page-window review feed (never a document catalog). */
+	const getV2ReviewWindowSource = () => {
+		const editor = getEditor();
+		if (editor?.editorVersion !== 2) return null;
+		const reviewHydration = editor.reviewHydration;
+		return reviewHydration && typeof reviewHydration === "object" ? reviewHydration : null;
+	};
+	const getV2ReviewWindowSnapshot = () => {
+		const source = getV2ReviewWindowSource();
+		if (!source || typeof source.getSnapshot !== "function") return null;
+		return safeCall(() => source.getSnapshot(), null);
+	};
+	const hasV2ReviewWindowFeed = () => typeof getV2ReviewWindowSource()?.getSnapshot === "function";
+	const reviewWindowSliceStatus = (snapshot) => {
+		const status = snapshot?.status;
+		return status === "ready" || status === "stale" ? status : "pending";
+	};
 	/** Read the live v2 editor host (inline mode only), when exposed. */
 	const getHost = () => {
 		const host = getEditor()?.host;
@@ -4481,6 +4498,12 @@ function createSuperDocUI(options) {
 		if (entry?.hasSettled || entry?.inflightToken != null) return;
 		demandHeavyDocRead("trackChanges");
 	};
+	/** Demand-driven route for an explicitly consumed comments list. */
+	const ensureCommentsCatalog = () => {
+		const entry = asyncReads.get("comments");
+		if (entry?.hasSettled || entry?.inflightToken != null) return;
+		demandHeavyDocRead("comments");
+	};
 	const HEAVY_READ_IDLE_MS = 6500;
 	const HEAVY_READ_IDLE_POLL_MS = 250;
 	let lastEditableMutationAtMs = 0;
@@ -5114,7 +5137,12 @@ function createSuperDocUI(options) {
 	};
 	const computeComments = (selection) => {
 		const commentsApi = getDoc()?.comments;
-		const { value, status: listStatus } = readAsync("comments", contentToken(), () => commentsApi?.list ? commentsApi.list() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const reviewWindow = getV2ReviewWindowSnapshot();
+		const catalog = readAsync("comments", contentToken(), () => commentsApi?.list ? commentsApi.list() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const windowItems = hasV2ReviewWindowFeed() && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const useWindowSlice = catalog.status === "pending" && windowItems != null;
+		const value = useWindowSlice ? windowItems : catalog.value;
+		const listStatus = useWindowSlice ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
 		const activeIds = selection.activeCommentIds;
 		if (explicitActiveCommentId && !items.some((item) => readEntityId(item) === explicitActiveCommentId)) explicitActiveCommentId = null;
@@ -5157,13 +5185,18 @@ function createSuperDocUI(options) {
 		const token = contentToken();
 		const postDecisionIds = postDecisionTrackChangeIdsForToken(token);
 		const heldEntry = asyncReads.get("trackChanges");
-		const { value, status: listStatus } = authoritativeTrackChangesPendingToken === token ? {
+		const reviewWindow = getV2ReviewWindowSnapshot();
+		const catalog = authoritativeTrackChangesPendingToken === token ? {
 			value: heldEntry?.hasSettled ? heldEntry.value : null,
 			status: heldEntry?.hasSettled ? "stale" : "pending"
 		} : readAsync("trackChanges", token, () => {
 			if (listTrackedChanges) return runUiTrackedChangesCatalogRead(() => tcApi?.list?.());
 			return tcApi?.list ? tcApi.list({ in: "all" }) : void 0;
 		}, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		const windowItems = hasV2ReviewWindowFeed() && Array.isArray(reviewWindow?.trackedChangeItems) ? reviewWindow.trackedChangeItems : null;
+		const useWindowSlice = catalog.status === "pending" && windowItems != null;
+		const value = useWindowSlice ? windowItems : catalog.value;
+		const listStatus = useWindowSlice ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = (value ?? []).map(projectTrackChangesItem).filter((item) => item != null).filter((item) => {
 			const id = readEntityId(item);
 			return !id || !postDecisionIds?.has(id);
@@ -6934,6 +6967,8 @@ function createSuperDocUI(options) {
 	let detachHostSelection = null;
 	let currentEditCommandsSource = null;
 	let detachEditCommands = null;
+	let currentV2ReviewWindowSource = null;
+	let detachV2ReviewWindow = null;
 	let editCommandsRecomputeQueued = false;
 	const requestEditCommandsRecompute = () => {
 		if (disposed || editCommandsRecomputeQueued) return;
@@ -6963,6 +6998,22 @@ function createSuperDocUI(options) {
 			currentEditCommandsSource = null;
 		}
 	};
+	const syncV2ReviewWindowSubscription = () => {
+		const next = getV2ReviewWindowSource();
+		if (next === currentV2ReviewWindowSource) return;
+		if (detachV2ReviewWindow) {
+			detachV2ReviewWindow();
+			detachV2ReviewWindow = null;
+		}
+		currentV2ReviewWindowSource = next;
+		if (!next || typeof next.subscribe !== "function") return;
+		try {
+			const unsubscribe = next.subscribe(() => recompute());
+			if (typeof unsubscribe === "function") detachV2ReviewWindow = unsubscribe;
+		} catch {
+			currentV2ReviewWindowSource = null;
+		}
+	};
 	let currentHostReviewSource = null;
 	let detachHostReview = null;
 	let currentHostEventsSource = null;
@@ -7195,6 +7246,7 @@ function createSuperDocUI(options) {
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
 		syncEditCommandsSubscription();
+		syncV2ReviewWindowSubscription();
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
@@ -7267,6 +7319,7 @@ function createSuperDocUI(options) {
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
 	syncEditCommandsSubscription();
+	syncV2ReviewWindowSubscription();
 	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
@@ -9189,6 +9242,7 @@ function createSuperDocUI(options) {
 		subscribe: commentsSnap.subscribe,
 		observe: commentsSnap.observe,
 		list: (query) => {
+			ensureCommentsCatalog();
 			const snapshot = commentsSub.get();
 			if (snapshot.status !== "pending") return filterCommentsSnapshot(snapshot.items, query);
 			const commentsApi = getDoc()?.comments;
@@ -9323,6 +9377,19 @@ function createSuperDocUI(options) {
 		recompute();
 		return activeId;
 	};
+	const restampVisibleTrackedChangeCarrierAliases = async (publicId) => {
+		const v2TrackedChanges = getV2TrackedChanges();
+		const listTrackedChanges = v2TrackedChanges?.listTrackedChanges;
+		if (typeof listTrackedChanges !== "function") return;
+		try {
+			await Promise.resolve(listTrackedChanges.call(v2TrackedChanges, {
+				mode: "visible-window",
+				targetIds: [publicId],
+				refreshReason: "ui-track-change-reveal-restamp",
+				blocking: true
+			}));
+		} catch {}
+	};
 	let trackChangeNavigationTail = Promise.resolve();
 	const navigateAndScrollNow = (step) => {
 		const requestedAtInvalidation = queuedTrackChangeNavigationInvalidation;
@@ -9359,7 +9426,11 @@ function createSuperDocUI(options) {
 				if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
 					rollback();
 					mirrorTrackedChangeFocusToHost(previousActiveChange);
-				} else mirrorTrackedChangeFocusToHost(optimisticActiveChange);
+				} else {
+					if (result.ok) await restampVisibleTrackedChangeCarrierAliases(activeId);
+					if (!isCurrent()) return { success: false };
+					mirrorTrackedChangeFocusToHost(optimisticActiveChange);
+				}
 				return { success: result.ok };
 			} finally {
 				trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
@@ -9509,7 +9580,14 @@ function createSuperDocUI(options) {
 					if (!result.ok && result.reason !== SUPERDOC_UI_REASONS.targetNotVisible) {
 						rollback();
 						mirrorTrackedChangeFocusToHost(previousActiveChange);
-					} else mirrorTrackedChangeFocusToHost(requestedActiveChange);
+					} else {
+						if (result.ok) await restampVisibleTrackedChangeCarrierAliases(publicId);
+						if (!isCurrent()) return {
+							success: false,
+							ok: false
+						};
+						mirrorTrackedChangeFocusToHost(requestedActiveChange);
+					}
 					return result;
 				} finally {
 					trackedChangeNavigationInFlight = Math.max(0, trackedChangeNavigationInFlight - 1);
@@ -10681,6 +10759,9 @@ function createSuperDocUI(options) {
 		if (detachEditCommands) detachEditCommands();
 		detachEditCommands = null;
 		currentEditCommandsSource = null;
+		if (detachV2ReviewWindow) detachV2ReviewWindow();
+		detachV2ReviewWindow = null;
+		currentV2ReviewWindowSource = null;
 		if (detachHostReview) detachHostReview();
 		detachHostReview = null;
 		currentHostReviewSource = null;
@@ -10958,12 +11039,6 @@ Object.defineProperty(exports, "getV2TrackedChangeMutationImpact", {
 		return getV2TrackedChangeMutationImpact;
 	}
 });
-Object.defineProperty(exports, "isV2EditableTextMutationEvent", {
-	enumerable: true,
-	get: function() {
-		return isV2EditableTextMutationEvent;
-	}
-});
 Object.defineProperty(exports, "shallowEqual", {
 	enumerable: true,
 	get: function() {

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.16",
+	superdocVersion: "2.4.0-next.18",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

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

package/dist/document-api/src/comments/comments.types.d.ts

@@ -200,6 +200,13 @@ export interface CommentsListQuery {
     includeResolved?: boolean;
     limit?: number;
     offset?: number;
+    /**
+     * Optional bounded review-window filter. Each id may be canonical or an
+     * imported/source alias. Only matching visible threads are projected.
+     */
+    visibleCommentIds?: readonly string[];
+    /** Include every reply belonging to a matched visible thread. */
+    includeThreadReplies?: boolean;
 }
 /**
  * Domain fields for a comment discovery item (C2).

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

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

package/dist/public/ui-react.cjs

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

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BRBwfV-s.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BbNbi0cj.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CTe12b19.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CPuOlTWb.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;