superdoc 2.0.0-next.37 → 2.0.0-next.39

package/dist/chunks/{create-super-doc-ui-C_kKiKQ4.es.js → create-super-doc-ui-BDAxgGrE.es.js}

@@ -2605,6 +2605,11 @@ function createSuperDocUI(options) {
 	let explicitActiveChange = null;
 	let explicitActiveChangeRevision = 0;
 	let queuedTrackChangeNavigationInvalidation = 0;
+	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 mirrorTrackedChangeFocusToHost = (next) => {
 		const host = getHost();
 		if (typeof host?.getHandles !== "function") return;
@@ -5144,6 +5149,8 @@ function createSuperDocUI(options) {
 	};
 	let currentHostSelectionSource = null;
 	let detachHostSelection = null;
+	let currentHostReviewSource = null;
+	let detachHostReview = null;
 	let currentHostEventsSource = null;
 	let detachHostEvents = null;
 	let currentDocumentSelectionSource = null;
@@ -5173,6 +5180,59 @@ function createSuperDocUI(options) {
 			currentHostSelectionSource = null;
 		}
 	};
+	const readHostReviewSource = () => {
+		const host = getEditor()?.host;
+		const review = safeCall(host?.getHandles ? () => host.getHandles() : void 0, null)?.review;
+		return review && typeof review.subscribe === "function" ? review : null;
+	};
+	const readHostActiveReviewTarget = (review) => {
+		if (!review) return null;
+		if (typeof review.getActiveReviewTarget === "function") return safeCall(() => review.getActiveReviewTarget(), null);
+		if (typeof review.getSnapshot === "function") return safeCall(() => review.getSnapshot(), null)?.activeReviewTarget ?? null;
+		return null;
+	};
+	const syncTrackedChangeFocusFromHostReviewTarget = (rawTarget) => {
+		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;
+			next = {
+				id: target.entityId,
+				...story ? { story } : {},
+				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : {}
+			};
+		}
+		if (explicitActiveChangesEqual(explicitActiveChange, next)) return false;
+		setExplicitActiveChange(next);
+		return true;
+	};
+	const syncHostReviewSubscription = () => {
+		const next = readHostReviewSource();
+		if (next === currentHostReviewSource) return;
+		if (detachHostReview) {
+			detachHostReview();
+			detachHostReview = null;
+		}
+		currentHostReviewSource = next;
+		if (!next) {
+			syncTrackedChangeFocusFromHostReviewTarget(null);
+			return;
+		}
+		let attaching = true;
+		try {
+			const unsubscribe = next.subscribe((snapshot) => {
+				const snapshotRecord = snapshot && typeof snapshot === "object" ? snapshot : null;
+				if (!syncTrackedChangeFocusFromHostReviewTarget(snapshotRecord && Object.prototype.hasOwnProperty.call(snapshotRecord, "activeReviewTarget") ? snapshotRecord.activeReviewTarget : readHostActiveReviewTarget(next)) || attaching) return;
+				recompute();
+			});
+			if (typeof unsubscribe === "function") detachHostReview = unsubscribe;
+			syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(next));
+		} catch {
+			currentHostReviewSource = null;
+		} finally {
+			attaching = false;
+		}
+	};
 	const readDocumentSelectionFallbackSource = () => {
 		if (currentHostSelectionSource || readDocumentMode() !== "viewing") return null;
 		const container = (getEditor()?.mount)?.container;
@@ -5202,6 +5262,7 @@ function createSuperDocUI(options) {
 		};
 	};
 	syncCoordinatorEditor();
+	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
 	let state = computeState();
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
@@ -5284,6 +5345,7 @@ function createSuperDocUI(options) {
 		if (disposed) return;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
+		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
 		const nextState = computeState();
@@ -5308,6 +5370,7 @@ function createSuperDocUI(options) {
 	};
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
+	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
 	const select = (selector, equality = shallowEqual) => {
@@ -5359,15 +5422,19 @@ function createSuperDocUI(options) {
 		const rangeEnd = Math.max(start.offset, end.offset);
 		const story = selectionStoryLocator(selection$1);
 		return {
-			kind: "text",
-			...story ? { story } : {},
-			segments: [{
-				blockId: start.blockId,
-				range: {
-					start: rangeStart,
-					end: rangeEnd
-				}
-			}]
+			kind: "range",
+			coordinateSpace: explicit.coordinateSpace === "tracked" ? "tracked" : "visible",
+			range: {
+				kind: "text",
+				...story ? { story } : {},
+				segments: [{
+					blockId: start.blockId,
+					range: {
+						start: rangeStart,
+						end: rangeEnd
+					}
+				}]
+			}
 		};
 	}
 	function activeChangePartialDecisionRoute() {
@@ -5428,11 +5495,8 @@ function createSuperDocUI(options) {
 				const route = activeChangePartialDecisionRoute();
 				if (route === "unavailable") return false;
 				if (route === "range") {
-					const range = trackDecisionRangeFromSelection(state.selection);
-					return range ? executeTrackDecisionTarget(command.kind, {
-						kind: "range",
-						range
-					}, null) : false;
+					const target = trackDecisionRangeFromSelection(state.selection);
+					return target ? executeTrackDecisionTarget(command.kind, target, null) : false;
 				}
 			}
 		}
@@ -8299,6 +8363,9 @@ function createSuperDocUI(options) {
 		if (detachHostSelection) detachHostSelection();
 		detachHostSelection = null;
 		currentHostSelectionSource = null;
+		if (detachHostReview) detachHostReview();
+		detachHostReview = null;
+		currentHostReviewSource = null;
 		if (detachHostEvents) detachHostEvents();
 		detachHostEvents = null;
 		currentHostEventsSource = null;

package/dist/chunks/{create-super-doc-ui-DLyJzmj9.cjs → create-super-doc-ui-kkZK7Tc-.cjs}

@@ -2824,6 +2824,11 @@ function createSuperDocUI(options) {
 	let explicitActiveChange = null;
 	let explicitActiveChangeRevision = 0;
 	let queuedTrackChangeNavigationInvalidation = 0;
+	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 mirrorTrackedChangeFocusToHost = (next) => {
 		const host = getHost();
 		if (typeof host?.getHandles !== "function") return;
@@ -5363,6 +5368,8 @@ function createSuperDocUI(options) {
 	};
 	let currentHostSelectionSource = null;
 	let detachHostSelection = null;
+	let currentHostReviewSource = null;
+	let detachHostReview = null;
 	let currentHostEventsSource = null;
 	let detachHostEvents = null;
 	let currentDocumentSelectionSource = null;
@@ -5392,6 +5399,59 @@ function createSuperDocUI(options) {
 			currentHostSelectionSource = null;
 		}
 	};
+	const readHostReviewSource = () => {
+		const host = getEditor()?.host;
+		const review = safeCall(host?.getHandles ? () => host.getHandles() : void 0, null)?.review;
+		return review && typeof review.subscribe === "function" ? review : null;
+	};
+	const readHostActiveReviewTarget = (review) => {
+		if (!review) return null;
+		if (typeof review.getActiveReviewTarget === "function") return safeCall(() => review.getActiveReviewTarget(), null);
+		if (typeof review.getSnapshot === "function") return safeCall(() => review.getSnapshot(), null)?.activeReviewTarget ?? null;
+		return null;
+	};
+	const syncTrackedChangeFocusFromHostReviewTarget = (rawTarget) => {
+		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;
+			next = {
+				id: target.entityId,
+				...story ? { story } : {},
+				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : {}
+			};
+		}
+		if (explicitActiveChangesEqual(explicitActiveChange, next)) return false;
+		setExplicitActiveChange(next);
+		return true;
+	};
+	const syncHostReviewSubscription = () => {
+		const next = readHostReviewSource();
+		if (next === currentHostReviewSource) return;
+		if (detachHostReview) {
+			detachHostReview();
+			detachHostReview = null;
+		}
+		currentHostReviewSource = next;
+		if (!next) {
+			syncTrackedChangeFocusFromHostReviewTarget(null);
+			return;
+		}
+		let attaching = true;
+		try {
+			const unsubscribe = next.subscribe((snapshot) => {
+				const snapshotRecord = snapshot && typeof snapshot === "object" ? snapshot : null;
+				if (!syncTrackedChangeFocusFromHostReviewTarget(snapshotRecord && Object.prototype.hasOwnProperty.call(snapshotRecord, "activeReviewTarget") ? snapshotRecord.activeReviewTarget : readHostActiveReviewTarget(next)) || attaching) return;
+				recompute();
+			});
+			if (typeof unsubscribe === "function") detachHostReview = unsubscribe;
+			syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(next));
+		} catch {
+			currentHostReviewSource = null;
+		} finally {
+			attaching = false;
+		}
+	};
 	const readDocumentSelectionFallbackSource = () => {
 		if (currentHostSelectionSource || readDocumentMode() !== "viewing") return null;
 		const container = (getEditor()?.mount)?.container;
@@ -5421,6 +5481,7 @@ function createSuperDocUI(options) {
 		};
 	};
 	syncCoordinatorEditor();
+	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
 	let state = computeState();
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
@@ -5503,6 +5564,7 @@ function createSuperDocUI(options) {
 		if (disposed) return;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
+		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
 		const nextState = computeState();
@@ -5527,6 +5589,7 @@ function createSuperDocUI(options) {
 	};
 	attach(superdoc, HOST_EVENTS);
 	syncHostSelectionSubscription();
+	syncHostReviewSubscription();
 	syncDocumentSelectionFallbackSubscription();
 	syncHostEventsSubscription();
 	const select = (selector, equality = shallowEqual) => {
@@ -5578,15 +5641,19 @@ function createSuperDocUI(options) {
 		const rangeEnd = Math.max(start.offset, end.offset);
 		const story = selectionStoryLocator(selection$1);
 		return {
-			kind: "text",
-			...story ? { story } : {},
-			segments: [{
-				blockId: start.blockId,
-				range: {
-					start: rangeStart,
-					end: rangeEnd
-				}
-			}]
+			kind: "range",
+			coordinateSpace: explicit.coordinateSpace === "tracked" ? "tracked" : "visible",
+			range: {
+				kind: "text",
+				...story ? { story } : {},
+				segments: [{
+					blockId: start.blockId,
+					range: {
+						start: rangeStart,
+						end: rangeEnd
+					}
+				}]
+			}
 		};
 	}
 	function activeChangePartialDecisionRoute() {
@@ -5647,11 +5714,8 @@ function createSuperDocUI(options) {
 				const route = activeChangePartialDecisionRoute();
 				if (route === "unavailable") return false;
 				if (route === "range") {
-					const range = trackDecisionRangeFromSelection(state.selection);
-					return range ? executeTrackDecisionTarget(command.kind, {
-						kind: "range",
-						range
-					}, null) : false;
+					const target = trackDecisionRangeFromSelection(state.selection);
+					return target ? executeTrackDecisionTarget(command.kind, target, null) : false;
 				}
 			}
 		}
@@ -8518,6 +8582,9 @@ function createSuperDocUI(options) {
 		if (detachHostSelection) detachHostSelection();
 		detachHostSelection = null;
 		currentHostSelectionSource = null;
+		if (detachHostReview) detachHostReview();
+		detachHostReview = null;
+		currentHostReviewSource = null;
 		if (detachHostEvents) detachHostEvents();
 		detachHostEvents = null;
 		currentHostEventsSource = null;

package/dist/collaboration-upgrade-engine.cjs

@@ -7,7 +7,7 @@ const 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.0.0-next.37",
+	superdocVersion: "2.0.0-next.39",
 	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

@@ -6,7 +6,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.0.0-next.37",
+	superdocVersion: "2.0.0-next.39",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/track-changes/track-changes.d.ts

@@ -1,6 +1,6 @@
 import { Receipt, TrackChangeInfo, TrackChangesListQuery, TrackChangesListResult } from '../types/index.js';
 import { StoryLocator } from '../types/story.types.js';
-import { TextTarget } from '../types/address.js';
+import { TextCoordinateSpace, TextTarget } from '../types/address.js';
 import { RevisionGuardOptions } from '../write/write.js';
 export type TrackChangesListInput = TrackChangesListQuery;
 export interface TrackChangesGetInput {
@@ -27,6 +27,8 @@ export interface TrackChangesRejectAllInput {
 export interface TrackChangesRangeInput {
     range: TextTarget;
     story?: StoryLocator;
+    /** Coordinate space of the TextTarget offsets. Omitted preserves legacy tracked-space behavior. */
+    coordinateSpace?: TextCoordinateSpace;
 }
 export type ReviewDecideTargetSide = 'insert' | 'inserted' | 'delete' | 'deleted' | 'source' | 'destination';
 export type ReviewDecideIdTargetSide = 'insert' | 'inserted' | 'delete' | 'deleted';
@@ -56,6 +58,8 @@ export interface ReviewDecideRangeTargetOptions {
 export type ReviewDecideTextRangeTarget = ReviewDecideRangeTargetOptions & {
     kind: 'range';
     range: TextTarget;
+    /** Coordinate space of `range`. Omitted preserves legacy tracked-space behavior. */
+    coordinateSpace?: TextCoordinateSpace;
 };
 export type ReviewDecideLogicalRangeTarget = ReviewDecideRangeTargetOptions & {
     kind: 'range';

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

@@ -98,8 +98,8 @@ export type SelectionTarget = {
     story?: StoryLocator;
     /**
      * Coordinate space for text endpoint offsets. Omitted means `visible`.
-     * Present as `tracked` only for additive v2 search matches that include
-     * deletion-side tracked text.
+     * Present as `tracked` for targets that include deletion-side tracked text,
+     * including additive search matches and live review selections.
      */
     coordinateSpace?: TextCoordinateSpace;
 };

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

@@ -2099,6 +2099,8 @@ export type Page = {
     numberText?: string;
     /** Numeric page number after section page numbering settings are applied. */
     effectivePageNumber?: number;
+    /** One-based physical position within the owning section. */
+    sectionPageNumber?: number;
     /** Section PAGE number format before any run-local PAGE switch is applied. */
     pageNumberFormat?: PageNumberFormat;
     /** MVP chapter prefix text derived from the nearest numbered Heading N marker. */

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

@@ -55,6 +55,8 @@ export type ResolvedPage = {
     numberText?: string;
     /** Numeric page number after section page numbering settings are applied. */
     effectivePageNumber?: number;
+    /** One-based physical position within the owning section. */
+    sectionPageNumber?: number;
     /** Section PAGE number format before any run-local PAGE switch is applied. */
     pageNumberFormat?: PageNumberFormat;
     /** MVP chapter prefix text derived from the nearest numbered Heading N marker. */

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

@@ -162,12 +162,19 @@ export type LayoutPositionTransform = {
     atChar: number;
     delta: number;
 };
+export type IncrementalSectionPageNumberTransform = {
+    /** Section whose retained pages need rebasing before its next boundary. */
+    sectionIndex: number;
+    /** Difference between target and source section-relative page positions. */
+    delta: number;
+};
 export type IncrementalLayoutTailAdoption = {
     startPageIndex: number;
     endPageIndexExclusive: number;
     sourcePageStartIndex: number;
     sourcePageEndIndexExclusive: number;
     pageIndexDelta: number;
+    sectionPageNumberTransform: IncrementalSectionPageNumberTransform | null;
     sourceLayoutEpoch: number | null;
     positionTransforms: readonly LayoutPositionTransform[];
     /** Lazy old->current block-id rekeys for an ordinal-changing structural splice. */

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

@@ -12,7 +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 type { HeaderFooterLayoutResult, IncrementalLayoutBridgeTiming, IncrementalLayoutResult, IncrementalMeasureReuseProof, IncrementalLayoutReuseOptions, IncrementalLayoutReuseSummary, IncrementalLayoutTailAdoption, IncrementalLayoutTailDisposition, IncrementalPaginationProof, LayoutPositionTransform, FootnoteReserveSeed, } from './incrementalLayout.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';
 export { computeDisplayPageNumber } from '../../layout-engine/src/index.js';

package/dist/public/ui-react.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-_dR15c8t.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DLyJzmj9.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-kkZK7Tc-.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
 function SuperDocUIProvider(props) {

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C_kKiKQ4.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BDAxgGrE.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
 function SuperDocUIProvider(props) {

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-DLyJzmj9.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-kkZK7Tc-.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C_kKiKQ4.es.js";
+import { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BDAxgGrE.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };