superdoc 2.24.0-next.2 → 2.24.0-next.3

package/dist/chunks/{create-super-doc-ui-BOrgnNVV.es.js → create-super-doc-ui-8UTu16Lw.es.js}

@@ -6074,6 +6074,18 @@ function createSuperDocUI(options) {
 		const host = getEditor()?.host;
 		return host && typeof host === "object" ? host : null;
 	};
+	/**
+	* The host selection snapshot a selection read, slice, or capture was
+	* resolved from. The host replaces its snapshot object on every selection
+	* change, so an identical object means the selection has not moved since.
+	*/
+	const selectionHostSnapshots = /* @__PURE__ */ new WeakMap();
+	const readHostSelectionSnapshot = () => {
+		const selectionHandle = (safeCall(() => getHost()?.getHandles?.() ?? null, null)?.editing)?.selection;
+		if (typeof selectionHandle?.getSnapshot !== "function") return null;
+		const snapshot = safeCall(() => selectionHandle.getSnapshot(), null);
+		return snapshot && typeof snapshot === "object" ? snapshot : null;
+	};
 	const createFirstPartyCommandDoc = () => {
 		const editor = getEditor();
 		const doc = editor?.doc;
@@ -7281,12 +7293,21 @@ function createSuperDocUI(options) {
 			...EMPTY_SELECTION,
 			status
 		};
+		const slice = buildSelectionSlice(info, status);
+		const hostSelection = selectionHostSnapshots.get(info);
+		if (hostSelection) selectionHostSnapshots.set(slice, hostSelection);
+		return slice;
+	};
+	const buildSelectionSlice = (info, status) => {
 		const target = info.target ?? null;
 		const quotedText = typeof info.text === "string" ? info.text : "";
 		return {
 			status,
 			empty: info.empty === true,
 			target,
+			trackedTarget: info.trackedTarget ?? null,
+			trackedChangeRangeDecisionSupported: info.trackedChangeRangeDecisionSupported,
+			trackedChangesWhollySelected: info.trackedChangesWhollySelected,
 			selectionTarget: info.selectionTarget ?? null,
 			tableSelection: info.tableSelection ?? null,
 			activeMarks: Array.isArray(info.activeMarks) ? info.activeMarks : [],
@@ -7295,18 +7316,22 @@ function createSuperDocUI(options) {
 			quotedText
 		};
 	};
-	const readSelectionInfoLive = () => {
-		const selectionApi = getDoc()?.selection;
-		return readAsync("selection", selectionReadToken(), () => selectionApi?.current ? selectionApi.current({ includeText: true }) : void 0, normalizeSelectionInfo);
-	};
+	const readSelectionInfoLive = () => readAsync("selection", selectionReadToken(), selectionCurrentRun, normalizeSelectionInfo);
 	const computeSelection = () => {
 		const { value: info, status } = readSelectionInfoLive();
 		return selectionSliceFromInfo(info, status);
 	};
-	const selectionCurrentRun = () => {
+	function selectionCurrentRun() {
 		const selectionApi = getDoc()?.selection;
-		return selectionApi?.current ? selectionApi.current({ includeText: true }) : void 0;
-	};
+		if (!selectionApi?.current) return void 0;
+		const hostSelection = readHostSelectionSnapshot();
+		const tag = (info) => {
+			if (hostSelection && info && typeof info === "object") selectionHostSnapshots.set(info, hostSelection);
+			return info;
+		};
+		const result = selectionApi.current({ includeText: true });
+		return isPromiseLike(result) ? Promise.resolve(result).then(tag) : tag(result);
+	}
 	/** True when a host sync snapshot is a resolved collapsed caret (not a range). */
 	const isCollapsedCaretSnapshot = (info) => {
 		if (info.empty !== true) return false;
@@ -8286,6 +8311,10 @@ function createSuperDocUI(options) {
 		if (!supported) return command.scope === "all" ? SUPERDOC_UI_REASONS.bulkDecisionsDisabled : unavailableRouteReason(doc);
 		if (disabledReason) return disabledReason;
 		if (command.scope !== "all" && selection.activeChangeIds.length === 0) return SUPERDOC_UI_REASONS.selectionRequired;
+		if (command.scope !== "all") {
+			const plan = planSelectionTrackDecision(selection, true);
+			if (plan?.kind === "blocked") return plan.reason;
+		}
 	};
 	const findTrackChangeForPermission = (id) => {
 		syncCoordinatorEditor();
@@ -8305,20 +8334,22 @@ function createSuperDocUI(options) {
 		if (typeof canPerform !== "function" || ids.length === 0) return void 0;
 		const currentUser = superdoc.config && typeof superdoc.config === "object" ? superdoc.config.user : null;
 		for (const id of ids) {
-			const trackedChange = findTrackChangeForPermission(id) ?? { id };
-			const isOwn = trackedChangeOwnedByCurrentUser(trackedChange, currentUser);
-			const permission = kind === "accept" ? isOwn ? "RESOLVE_OWN" : "RESOLVE_OTHER" : isOwn ? "REJECT_OWN" : "REJECT_OTHER";
-			let allowed;
-			try {
-				allowed = canPerform.call(superdoc, {
-					permission,
-					trackedChange,
-					comment: null
-				});
-			} catch {
-				return;
+			const trackedChange = findTrackChangeForPermission(id);
+			const isOwn = trackedChange ? trackedChangeOwnedByCurrentUser(trackedChange, currentUser) : false;
+			const permissions = trackedChange ? [kind === "accept" ? isOwn ? "RESOLVE_OWN" : "RESOLVE_OTHER" : isOwn ? "REJECT_OWN" : "REJECT_OTHER"] : kind === "accept" ? ["RESOLVE_OWN", "RESOLVE_OTHER"] : ["REJECT_OWN", "REJECT_OTHER"];
+			for (const candidate of permissions) {
+				let allowed;
+				try {
+					allowed = canPerform.call(superdoc, {
+						permission: candidate,
+						trackedChange: trackedChange ?? { id },
+						comment: null
+					});
+				} catch {
+					return trackedChange ? void 0 : SUPERDOC_UI_REASONS.permissionDenied;
+				}
+				if (allowed === false || !trackedChange && allowed !== true) return SUPERDOC_UI_REASONS.permissionDenied;
 			}
-			if (allowed === false) return SUPERDOC_UI_REASONS.permissionDenied;
 		}
 	};
 	const hostCommandSupport = (command) => {
@@ -9998,14 +10029,22 @@ function createSuperDocUI(options) {
 	* ordinary/insertion selections are visible-space, while a selection that
 	* reaches painted deleted text is projected in tracked space by the host.
 	*
-	* A cross-block or malformed selection fails closed. Its intermediate block
-	* coverage cannot be reconstructed from two endpoints without guessing.
+	* Cross-block coverage must come from the model-backed tracked target;
+	* intermediate block lengths cannot be inferred from the endpoints.
 	*/
 	function trackDecisionRangeFromSelection(selection) {
 		if (selection.empty) return null;
 		const explicit = selection.selectionTarget;
 		const start = explicit?.start;
 		const end = explicit?.end;
+		if (start?.kind === "text" && end?.kind === "text" && start.blockId !== end.blockId) {
+			const range = selection.trackedTarget;
+			return range ? {
+				kind: "range",
+				coordinateSpace: "tracked",
+				range
+			} : null;
+		}
 		if (explicit?.kind !== "selection" || start?.kind !== "text" || end?.kind !== "text" || typeof start.blockId !== "string" || start.blockId !== end.blockId || !Number.isInteger(start.offset) || !Number.isInteger(end.offset) || start.offset < 0 || end.offset < 0 || start.offset === end.offset) return null;
 		const rangeStart = Math.min(start.offset, end.offset);
 		const rangeEnd = Math.max(start.offset, end.offset);
@@ -10050,32 +10089,20 @@ function createSuperDocUI(options) {
 	function normalizeTrackDecisionText(value) {
 		return typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "";
 	}
-	function activeChangePartialDecisionRoute() {
-		const activeId = state.selection.activeChangeIds[0];
+	function activeChangePartialDecisionRoute(selection = state.selection) {
+		const activeId = selection.activeChangeIds[0];
 		if (!activeId) return "unavailable";
-		const story = selectionStoryLocator(state.selection);
-		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));
+		const story = selectionStoryLocator(selection);
+		const trackChanges = state?.trackChanges;
+		const item = (trackChanges?.status === "ready" ? 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 change = trackChangesItemPayload(item);
 		const type = change.type;
 		const grouping = change.grouping;
-		if (selectedTextCoversTrackChangeText(state.selection, item)) return "id";
+		if (selectedTextCoversTrackChangeText(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, changeId, story);
-			if (isPromiseLike(result)) return settleCommandExecution(Promise.resolve(result).then((settled) => {
-				return commandResultSucceeded(commandResultFromOperationResult(settled)) ? settled : fallback();
-			}));
-			const commandResult = commandResultFromOperationResult(result);
-			return settleCommandExecution(commandResultSucceeded(commandResult) ? result : fallback());
-		} catch {
-			return false;
-		}
-	}
 	/** A decision target carried by the payload itself, independent of the selection. */
 	function explicitTrackDecisionTarget(payload) {
 		if (typeof payload === "string" && payload.length > 0) return {
@@ -10119,29 +10146,88 @@ function createSuperDocUI(options) {
 			story
 		} : null;
 	}
+	/**
+	* The selection-derived decision for a review command. The command gate and
+	* execution share these rules so an enabled command always has a target.
+	* `null` means the selection does not drive the decision (no active change
+	* or a collapsed caret) and the caller falls back to the active change id.
+	* `gateOnly` stops after the blocking rules and returns only a block or null.
+	*/
+	function planSelectionTrackDecision(selection, gateOnly = false) {
+		if (selection.tableSelection?.kind === "tableCells" && (selection.tableSelection.type === "cells" || selection.tableSelection.type === "table")) return {
+			kind: "blocked",
+			reason: SUPERDOC_UI_REASONS.operationUnavailable
+		};
+		const ids = selection.activeChangeIds;
+		if (ids.length > 1) {
+			if (selection.empty || selection.trackedChangesWhollySelected === true) return {
+				kind: "ids",
+				ids
+			};
+			if (selection.trackedChangeRangeDecisionSupported === false) return {
+				kind: "blocked",
+				reason: SUPERDOC_UI_REASONS.operationUnavailable
+			};
+			const target = trackDecisionRangeFromSelection(selection);
+			return target ? {
+				kind: "range",
+				target,
+				changeId: null,
+				permissionIds: ids
+			} : {
+				kind: "blocked",
+				reason: SUPERDOC_UI_REASONS.targetUnresolved
+			};
+		}
+		if (ids.length !== 1 || selection.empty) return null;
+		const activeId = ids[0];
+		let routeValue;
+		const route = () => routeValue ??= selection.trackedChangesWhollySelected === true ? "id" : activeChangePartialDecisionRoute(selection);
+		if (selection.trackedChangeRangeDecisionSupported === false && route() !== "id") return {
+			kind: "blocked",
+			reason: SUPERDOC_UI_REASONS.operationUnavailable
+		};
+		if (!selection.selectionTarget) return null;
+		const target = trackDecisionRangeFromSelection(selection);
+		if (!target && route() !== "id") return {
+			kind: "blocked",
+			reason: SUPERDOC_UI_REASONS.targetUnresolved
+		};
+		if (gateOnly) return null;
+		if (route() === "id") {
+			const selectedStory = selectionStoryLocator(selection);
+			return {
+				kind: "id",
+				id: activeId,
+				story: selectedStory && storyLocatorSignature(selectedStory) !== storyLocatorSignature(null) ? selectedStory : void 0
+			};
+		}
+		if (route() === "unavailable" && !selection.trackedTarget) return { kind: "unavailable" };
+		return target ? {
+			kind: "range",
+			target,
+			changeId: activeId,
+			story: nonBodySelectionStoryLocator(selection)
+		} : {
+			kind: "blocked",
+			reason: SUPERDOC_UI_REASONS.targetUnresolved
+		};
+	}
 	function executeTrackDecisionCommand(command, payload) {
 		if (command.scope === "id" && payload == null) {
-			if (state.selection.activeChangeIds.length > 1) return executeTrackDecisionTarget(command.kind, {
-				kind: "ids",
-				ids: state.selection.activeChangeIds
-			}, null);
-			if (state.selection.activeChangeIds.length === 1 && !state.selection.empty && state.selection.selectionTarget) {
-				const route = activeChangePartialDecisionRoute();
-				if (route === "unavailable") return false;
-				if (route === "range") {
-					const target = trackDecisionRangeFromSelection(state.selection);
-					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 plan = planSelectionTrackDecision(state.selection);
+			switch (plan?.kind) {
+				case "blocked":
+				case "unavailable": return false;
+				case "ids": return executeTrackDecisionTarget(command.kind, {
+					kind: "ids",
+					ids: plan.ids
+				}, null, void 0, plan.ids);
+				case "range": return executeTrackDecisionTarget(command.kind, plan.target, plan.changeId, plan.story, plan.permissionIds);
+				case "id": return executeTrackDecision(command.kind, plan.story ? {
+					id: plan.id,
+					story: plan.story
+				} : plan.id);
 			}
 		}
 		const resolved = resolveTrackDecisionTarget(command, payload);
@@ -11810,11 +11896,14 @@ function createSuperDocUI(options) {
 			if (snapshot.empty) return null;
 			const cells = currentCellSelectionTarget();
 			if (!snapshot.target && !snapshot.selectionTarget && !cells) return null;
-			return {
+			const capture = {
 				...snapshot,
 				capturedAt: Date.now(),
 				...cells ? { _tableCellSelectionTarget: cells } : {}
 			};
+			const hostSelection = selectionHostSnapshots.get(snapshot);
+			if (hostSelection) selectionHostSnapshots.set(capture, hostSelection);
+			return capture;
 		},
 		restore: (capture) => {
 			const done = (result) => {
@@ -11843,6 +11932,8 @@ function createSuperDocUI(options) {
 				ok: false,
 				reason: SUPERDOC_UI_REASONS.targetUnresolved
 			});
+			const heldHostSelection = selectionHostSnapshots.get(capture);
+			if (!hasCellTarget && target.coordinateSpace === "tracked" && heldHostSelection !== void 0 && readHostSelectionSnapshot() === heldHostSelection) return done({ ok: true });
 			const resolved = getSelectionApplyHelper();
 			if (!("helper" in resolved)) return done({
 				ok: false,
@@ -12679,20 +12770,20 @@ function createSuperDocUI(options) {
 		if (run() === false) return Promise.resolve(false);
 		return lastCommandSettlement;
 	};
-	const executeTrackDecisionTarget = (kind, target, changeId, story) => {
+	const executeTrackDecisionTarget = (kind, target, changeId, story, selectionChangeIds) => {
 		try {
-			return settleCommandExecution(callTrackDecisionTarget(kind, target, changeId, story));
+			return settleCommandExecution(callTrackDecisionTarget(kind, target, changeId, story, selectionChangeIds));
 		} catch {
 			return false;
 		}
 	};
-	const callTrackDecisionTarget = (kind, target, changeId, story) => {
+	const callTrackDecisionTarget = (kind, target, changeId, story, selectionChangeIds) => {
 		if (trackedChangeDecisionsAreDisabled()) return false;
 		const tcApi = getDoc()?.trackChanges;
 		const isAllTarget = target.kind === "all" || target.scope === "all";
 		const isRangeTarget = target.kind === "range";
 		const isMultiIdTarget = target.kind === "ids";
-		const permissionIds = isAllTarget ? [] : isMultiIdTarget && Array.isArray(target.ids) ? target.ids.filter((id) => typeof id === "string" && id.length > 0) : changeId ? [changeId] : [];
+		const permissionIds = isAllTarget ? [] : selectionChangeIds ?? (isMultiIdTarget && Array.isArray(target.ids) ? target.ids.filter((id) => typeof id === "string" && id.length > 0) : changeId ? [changeId] : []);
 		if (permissionIds.length > 0 && trackedChangeDecisionPermissionReason(kind, permissionIds)) return false;
 		if (bulkTrackDecisionBlockedReason({
 			kind,