superdoc 2.12.0-next.13 → 2.12.0-next.14

package/dist/chunks/{create-super-doc-ui-C-AuEM9F.es.js → create-super-doc-ui-D3_JSfLV.es.js}

@@ -7453,11 +7453,8 @@ function createSuperDocUI(options) {
 			return false;
 		}
 	}
-	function resolveTrackDecisionTarget(command, payload) {
-		if (command.scope === "all") return {
-			target: { kind: "all" },
-			changeId: null
-		};
+	/** A decision target carried by the payload itself, independent of the selection. */
+	function explicitTrackDecisionTarget(payload) {
 		if (typeof payload === "string" && payload.length > 0) return {
 			target: {
 				kind: "id",
@@ -7482,6 +7479,15 @@ function createSuperDocUI(options) {
 				story: record.story
 			};
 		}
+		return null;
+	}
+	function resolveTrackDecisionTarget(command, payload) {
+		if (command.scope === "all") return {
+			target: { kind: "all" },
+			changeId: null
+		};
+		const explicit = explicitTrackDecisionTarget(payload);
+		if (explicit) return explicit;
 		const selectedId = state.selection.activeChangeIds[0];
 		const story = nonBodySelectionStoryLocator(state.selection);
 		return selectedId ? {
@@ -8435,6 +8441,7 @@ function createSuperDocUI(options) {
 	const commandNeedsFreshSelection = (id, payload) => {
 		const trackCommand = trackDecisionCommand(id);
 		const descriptor = getCommandDescriptor(id);
+		if (trackCommand?.scope === "id" && explicitTrackDecisionTarget(payload)) return false;
 		if (trackCommand?.scope !== "id" && !descriptorNeedsFreshSelection(descriptor)) return false;
 		return !commandSelectionIsReady(id, descriptor, payload);
 	};
@@ -9212,6 +9219,7 @@ function createSuperDocUI(options) {
 	*/
 	const resolveEntityTarget = async (namespace, id, loaded, request) => {
 		const requestedStory = namespace === "trackChanges" ? request?.story : void 0;
+		const rowStory = namespace === "trackChanges" ? request?.matchStory ?? requestedStory : void 0;
 		const withRequestedStory = (target) => {
 			if (!requestedStory || !target || typeof target !== "object") return target;
 			const record = target;
@@ -9223,7 +9231,7 @@ function createSuperDocUI(options) {
 			};
 		};
 		const readTarget = namespace === "trackChanges" ? readTrackedChangeNavigationTarget : readEntityTarget;
-		const loadedRow = loaded.find((row) => entityRowMatchesRequest(row, id, requestedStory));
+		const loadedRow = loaded.find((row) => entityRowMatchesRequest(row, id, rowStory));
 		const loadedRecord = loadedRow && typeof loadedRow === "object" ? loadedRow : null;
 		const moveSide = namespace === "trackChanges" && loadedRecord?.type === "move" && (loadedRecord.subtype === "move-to" || loadedRecord.subtype === "move-from") ? loadedRecord.subtype : null;
 		const trackedChangeLookupId = moveSide && typeof loadedRecord?.trackedChangeCanonicalId === "string" ? loadedRecord.trackedChangeCanonicalId : id;
@@ -9517,9 +9525,13 @@ function createSuperDocUI(options) {
 			});
 		},
 		accept: (changeId) => executeTrackDecision("accept", changeId),
+		acceptAsync: (changeId) => settleTrackDecision(() => executeTrackDecision("accept", changeId)),
 		reject: (changeId) => executeTrackDecision("reject", changeId),
+		rejectAsync: (changeId) => settleTrackDecision(() => executeTrackDecision("reject", changeId)),
 		acceptAll: () => executeTrackDecisionTarget("accept", { kind: "all" }, null),
+		acceptAllAsync: () => settleTrackDecision(() => executeTrackDecisionTarget("accept", { kind: "all" }, null)),
 		rejectAll: () => executeTrackDecisionTarget("reject", { kind: "all" }, null),
+		rejectAllAsync: () => settleTrackDecision(() => executeTrackDecisionTarget("reject", { kind: "all" }, null)),
 		next: () => navigateTrackChange(1),
 		previous: () => navigateTrackChange(-1),
 		navigateNext: () => navigateAndScroll(1),
@@ -9584,19 +9596,27 @@ function createSuperDocUI(options) {
 			recompute();
 			return true;
 		},
-		scrollTo: async (changeId) => {
+		scrollTo: async (input) => {
 			if (!getDoc()) return {
 				success: false,
 				ok: false,
 				reason: getEditor() ? SUPERDOC_UI_REASONS.documentApiUnavailable : SUPERDOC_UI_REASONS.notReady
 			};
+			const changeId = typeof input === "string" ? input : input.id;
+			const matchStory = typeof input === "string" || !input.story || typeof input.story !== "object" ? void 0 : input.story;
+			const requestedStory = matchStory ? readEntityRequestStory({ address: { story: matchStory } }) : void 0;
+			if (typeof changeId !== "string" || changeId.length === 0) return {
+				success: false,
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.targetUnresolved
+			};
 			queuedTrackChangeNavigationInvalidation += 1;
 			trackChangeRevealInvalidation += 1;
 			const requestedAtInvalidation = trackChangeRevealInvalidation;
-			const loadedItems = trackChangesSub.get().items;
-			const publicId = buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
-			const matchingRow = loadedItems.find((item) => readEntityId(item) === publicId);
-			const story = readEntityRequestStory(matchingRow);
+			const loadedItems = matchStory ? readAllStoryTrackChanges() ?? trackChangesSub.get().items : trackChangesSub.get().items;
+			const publicId = matchStory ? buildStoryScopedTrackedChangeIdContext(loadedItems, matchStory).toPublicId(changeId) ?? changeId : buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
+			const matchingRow = matchStory ? loadedItems.find((item) => entityRowMatchesRequest(item, publicId, matchStory)) : loadedItems.find((item) => readEntityId(item) === publicId);
+			const story = matchStory ? requestedStory : readEntityRequestStory(matchingRow);
 			const importedId = deriveTrackedChangeImportedId(matchingRow);
 			const previousActiveChange = explicitActiveChange;
 			const requestedActiveChange = {
@@ -9606,7 +9626,10 @@ function createSuperDocUI(options) {
 			};
 			pendingTrackChangeRevealFocuses.add(requestedActiveChange);
 			try {
-				const target = await resolveEntityTarget("trackChanges", publicId, loadedItems, story ? { story } : void 0);
+				const target = await resolveEntityTarget("trackChanges", publicId, loadedItems, story || matchStory ? {
+					story,
+					matchStory
+				} : void 0);
 				if (trackChangeRevealInvalidation !== requestedAtInvalidation) return {
 					success: false,
 					ok: false
@@ -9666,6 +9689,7 @@ function createSuperDocUI(options) {
 			id: input,
 			story: void 0
 		} : input;
+		if (typeof id !== "string" || id.length === 0) return false;
 		const target = {
 			kind: "id",
 			id,
@@ -9673,6 +9697,19 @@ function createSuperDocUI(options) {
 		};
 		return executeTrackDecisionTarget(kind, target, id, story);
 	};
+	/**
+	* Run a domain decision and resolve with its settled result. The domain
+	* helpers call the decision route directly so an application command that
+	* reuses a built-in tracked-change id cannot intercept them; only the command
+	* registry (`commands.execute*`) honours those overrides.
+	*/
+	const settleTrackDecision = (run) => {
+		pendingCommandSettlement = null;
+		lastCommandSettlement = Promise.resolve(false);
+		if (disposed) return Promise.resolve(false);
+		if (run() === false) return Promise.resolve(false);
+		return lastCommandSettlement;
+	};
 	const executeTrackDecisionTarget = (kind, target, changeId, story) => {
 		try {
 			return settleCommandExecution(callTrackDecisionTarget(kind, target, changeId, story));

package/dist/chunks/{create-super-doc-ui-CBFGggZ2.cjs → create-super-doc-ui-D8QSZN4i.cjs}

@@ -7453,11 +7453,8 @@ function createSuperDocUI(options) {
 			return false;
 		}
 	}
-	function resolveTrackDecisionTarget(command, payload) {
-		if (command.scope === "all") return {
-			target: { kind: "all" },
-			changeId: null
-		};
+	/** A decision target carried by the payload itself, independent of the selection. */
+	function explicitTrackDecisionTarget(payload) {
 		if (typeof payload === "string" && payload.length > 0) return {
 			target: {
 				kind: "id",
@@ -7482,6 +7479,15 @@ function createSuperDocUI(options) {
 				story: record.story
 			};
 		}
+		return null;
+	}
+	function resolveTrackDecisionTarget(command, payload) {
+		if (command.scope === "all") return {
+			target: { kind: "all" },
+			changeId: null
+		};
+		const explicit = explicitTrackDecisionTarget(payload);
+		if (explicit) return explicit;
 		const selectedId = state.selection.activeChangeIds[0];
 		const story = nonBodySelectionStoryLocator(state.selection);
 		return selectedId ? {
@@ -8435,6 +8441,7 @@ function createSuperDocUI(options) {
 	const commandNeedsFreshSelection = (id, payload) => {
 		const trackCommand = trackDecisionCommand(id);
 		const descriptor = getCommandDescriptor(id);
+		if (trackCommand?.scope === "id" && explicitTrackDecisionTarget(payload)) return false;
 		if (trackCommand?.scope !== "id" && !descriptorNeedsFreshSelection(descriptor)) return false;
 		return !commandSelectionIsReady(id, descriptor, payload);
 	};
@@ -9212,6 +9219,7 @@ function createSuperDocUI(options) {
 	*/
 	const resolveEntityTarget = async (namespace, id, loaded, request) => {
 		const requestedStory = namespace === "trackChanges" ? request?.story : void 0;
+		const rowStory = namespace === "trackChanges" ? request?.matchStory ?? requestedStory : void 0;
 		const withRequestedStory = (target) => {
 			if (!requestedStory || !target || typeof target !== "object") return target;
 			const record = target;
@@ -9223,7 +9231,7 @@ function createSuperDocUI(options) {
 			};
 		};
 		const readTarget = namespace === "trackChanges" ? readTrackedChangeNavigationTarget : readEntityTarget;
-		const loadedRow = loaded.find((row) => entityRowMatchesRequest(row, id, requestedStory));
+		const loadedRow = loaded.find((row) => entityRowMatchesRequest(row, id, rowStory));
 		const loadedRecord = loadedRow && typeof loadedRow === "object" ? loadedRow : null;
 		const moveSide = namespace === "trackChanges" && loadedRecord?.type === "move" && (loadedRecord.subtype === "move-to" || loadedRecord.subtype === "move-from") ? loadedRecord.subtype : null;
 		const trackedChangeLookupId = moveSide && typeof loadedRecord?.trackedChangeCanonicalId === "string" ? loadedRecord.trackedChangeCanonicalId : id;
@@ -9517,9 +9525,13 @@ function createSuperDocUI(options) {
 			});
 		},
 		accept: (changeId) => executeTrackDecision("accept", changeId),
+		acceptAsync: (changeId) => settleTrackDecision(() => executeTrackDecision("accept", changeId)),
 		reject: (changeId) => executeTrackDecision("reject", changeId),
+		rejectAsync: (changeId) => settleTrackDecision(() => executeTrackDecision("reject", changeId)),
 		acceptAll: () => executeTrackDecisionTarget("accept", { kind: "all" }, null),
+		acceptAllAsync: () => settleTrackDecision(() => executeTrackDecisionTarget("accept", { kind: "all" }, null)),
 		rejectAll: () => executeTrackDecisionTarget("reject", { kind: "all" }, null),
+		rejectAllAsync: () => settleTrackDecision(() => executeTrackDecisionTarget("reject", { kind: "all" }, null)),
 		next: () => navigateTrackChange(1),
 		previous: () => navigateTrackChange(-1),
 		navigateNext: () => navigateAndScroll(1),
@@ -9584,19 +9596,27 @@ function createSuperDocUI(options) {
 			recompute();
 			return true;
 		},
-		scrollTo: async (changeId) => {
+		scrollTo: async (input) => {
 			if (!getDoc()) return {
 				success: false,
 				ok: false,
 				reason: getEditor() ? SUPERDOC_UI_REASONS.documentApiUnavailable : SUPERDOC_UI_REASONS.notReady
 			};
+			const changeId = typeof input === "string" ? input : input.id;
+			const matchStory = typeof input === "string" || !input.story || typeof input.story !== "object" ? void 0 : input.story;
+			const requestedStory = matchStory ? readEntityRequestStory({ address: { story: matchStory } }) : void 0;
+			if (typeof changeId !== "string" || changeId.length === 0) return {
+				success: false,
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.targetUnresolved
+			};
 			queuedTrackChangeNavigationInvalidation += 1;
 			trackChangeRevealInvalidation += 1;
 			const requestedAtInvalidation = trackChangeRevealInvalidation;
-			const loadedItems = trackChangesSub.get().items;
-			const publicId = buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
-			const matchingRow = loadedItems.find((item) => readEntityId(item) === publicId);
-			const story = readEntityRequestStory(matchingRow);
+			const loadedItems = matchStory ? readAllStoryTrackChanges() ?? trackChangesSub.get().items : trackChangesSub.get().items;
+			const publicId = matchStory ? buildStoryScopedTrackedChangeIdContext(loadedItems, matchStory).toPublicId(changeId) ?? changeId : buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
+			const matchingRow = matchStory ? loadedItems.find((item) => entityRowMatchesRequest(item, publicId, matchStory)) : loadedItems.find((item) => readEntityId(item) === publicId);
+			const story = matchStory ? requestedStory : readEntityRequestStory(matchingRow);
 			const importedId = deriveTrackedChangeImportedId(matchingRow);
 			const previousActiveChange = explicitActiveChange;
 			const requestedActiveChange = {
@@ -9606,7 +9626,10 @@ function createSuperDocUI(options) {
 			};
 			pendingTrackChangeRevealFocuses.add(requestedActiveChange);
 			try {
-				const target = await resolveEntityTarget("trackChanges", publicId, loadedItems, story ? { story } : void 0);
+				const target = await resolveEntityTarget("trackChanges", publicId, loadedItems, story || matchStory ? {
+					story,
+					matchStory
+				} : void 0);
 				if (trackChangeRevealInvalidation !== requestedAtInvalidation) return {
 					success: false,
 					ok: false
@@ -9666,6 +9689,7 @@ function createSuperDocUI(options) {
 			id: input,
 			story: void 0
 		} : input;
+		if (typeof id !== "string" || id.length === 0) return false;
 		const target = {
 			kind: "id",
 			id,
@@ -9673,6 +9697,19 @@ function createSuperDocUI(options) {
 		};
 		return executeTrackDecisionTarget(kind, target, id, story);
 	};
+	/**
+	* Run a domain decision and resolve with its settled result. The domain
+	* helpers call the decision route directly so an application command that
+	* reuses a built-in tracked-change id cannot intercept them; only the command
+	* registry (`commands.execute*`) honours those overrides.
+	*/
+	const settleTrackDecision = (run) => {
+		pendingCommandSettlement = null;
+		lastCommandSettlement = Promise.resolve(false);
+		if (disposed) return Promise.resolve(false);
+		if (run() === false) return Promise.resolve(false);
+		return lastCommandSettlement;
+	};
 	const executeTrackDecisionTarget = (kind, target, changeId, story) => {
 		try {
 			return settleCommandExecution(callTrackDecisionTarget(kind, target, changeId, story));

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.12.0-next.13",
+	superdocVersion: "2.12.0-next.14",
 	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.12.0-next.13",
+	superdocVersion: "2.12.0-next.14",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/painters/dom/src/derived-run-text-plane.d.ts

@@ -0,0 +1,9 @@
+import { FlowBlock, Run } from '../../../contracts/src/index.js';
+export type DerivedRunTextPlane = {
+    generation: number;
+    revision: string;
+    valuesByDataAttribute: ReadonlyMap<string, ReadonlyMap<string, string>>;
+};
+export declare function validateDerivedRunTextPlane(plane: DerivedRunTextPlane | null | undefined, generation: number): void;
+export declare function resolveDerivedRunText(run: Run, plane: DerivedRunTextPlane | null | undefined): string | undefined;
+export declare function blockUsesDerivedRunTextPlane(block: FlowBlock | undefined, plane: DerivedRunTextPlane | null | undefined): boolean;

package/dist/layout-engine/painters/dom/src/index.d.ts

@@ -15,6 +15,7 @@ export type { RulerDefinition, RulerConfig, RulerConfigPx, RulerTick, CreateRule
 export type { PaintSnapshot, PaintSnapshotAnnotationEntity, PaintSnapshotStructuredContentBlockEntity, PaintSnapshotStructuredContentInlineEntity, PaintSnapshotImageEntity, PaintSnapshotEntities, } from './renderer.js';
 export type { DomPainterInput, PositionMapping } from './renderer.js';
 export type { DomPainterPersistentPacketSource, DomPainterPersistentPageInput, DomPainterPersistentScaffold, DomPainterPersistentScaffoldPage, } from './persistent-page-surface.js';
+export type { DerivedRunTextPlane } from './derived-run-text-plane.js';
 export type { PaintWorkSummary } from './page-content.js';
 export type { RenderedLineInfo } from './runs/index.js';
 export { sanitizeUrl, linkMetrics, applyRunDataAttributes } from './runs/index.js';

package/dist/layout-engine/painters/dom/src/page-content.d.ts

@@ -3,6 +3,7 @@ import { FragmentRenderContext, PositionMapping } from './renderer.js';
 import { SdtBoundaryOptions } from './sdt/container.js';
 import { BetweenBorderInfo } from './paragraph/borders/index.js';
 import { PageStyles } from './styles.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 export type FragmentDomState = {
     key: string;
     signature: string;
@@ -116,7 +117,7 @@ export declare function createEmptyPaintWorkSummary(): PaintWorkSummary;
  * attribute-for-attribute — that exactness is the proof, never normalize it
  * away at the pass level (only the §7.7 unit tests use the normalized form).
  */
-export declare function persistentPageVersionKey(page: ResolvedPage, totalPages: number, sectionPageCount: number): string | null;
+export declare function persistentPageVersionKey(page: ResolvedPage, totalPages: number, sectionPageCount: number, derivedRunTextPlane?: DerivedRunTextPlane | null): string | null;
 /**
  * The class state `renderPage`/`patchPage` consume, made explicit. The
  * DomPainter builds one per call (values like `totalPages`, `layoutEpoch`,
@@ -130,6 +131,7 @@ export interface PageContentContext {
     totalPages: number;
     currentMapping: PositionMapping | null;
     changedBlocks: ReadonlySet<string>;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
     /** Record the smallest newly painted subtree for transaction finalization. */
     recordChangedRoot?(root: HTMLElement): void;
     sdtLabelsRendered: Set<string>;

package/dist/layout-engine/painters/dom/src/persistent-page-surface.d.ts

@@ -1,4 +1,5 @@
 import { DocumentBackground, ResolvedPage } from '../../../contracts/src/index.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 import { PageContentContext, PageDomState, PaintWorkSummary } from './page-content.js';
 /**
  * One exact page band of the committed scaffold (numbers-only,
@@ -69,6 +70,7 @@ export type DomPainterPersistentPageInput = {
     packetsByPageIndex: DomPainterPersistentPacketSource;
     sectionPageCounts?: Readonly<Record<string, number>>;
     documentBackground?: DocumentBackground | null;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
     captureSnapshot?: boolean;
 };
 /** Shell registry entry: the persistent page root and its geometry/style reuse key. */

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -1,6 +1,7 @@
 import { FlowMode, Fragment, PageMargins, PageNumberChapterSeparator, PageNumberFormat, SourceAnchor, ResolvedLayout, ResolvedPage, ResolvedPaintItem, LayoutSourceIdentity, LayoutStoryLocator } from '../../../contracts/src/index.js';
 import { PaintWorkSummary } from './page-content.js';
 import { DomPainterPersistentPageInput } from './persistent-page-surface.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 import { PageStyles } from './styles.js';
 import { PaintSnapshotStructuredContentBlockEntity, PaintSnapshotStructuredContentInlineEntity } from './sdt/snapshot.js';
 import { PositionValidationOptions, PositionValidationSummary } from './pm-position-validation.js';
@@ -143,6 +144,7 @@ export type FragmentRenderContext = {
      * `totalPages` / `sectionPageCount`. Absent/`true` = exact (default).
      */
     pageCountFieldsExact?: boolean;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
 };
 export type PaintSnapshotLineStyle = {
     paddingLeftPx?: number;
@@ -305,6 +307,7 @@ export declare class DomPainter {
      * `dispose()` so a stale window value can never leak across modes/mounts.
      */
     private persistentDocumentBackground;
+    private persistentDerivedRunTextPlane;
     private paintWork;
     /**
      * P5 §4.6 (review fix): per-page attribution arrays are opt-in. Counters

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-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8QSZN4i.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.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-C-AuEM9F.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D3_JSfLV.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8QSZN4i.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D3_JSfLV.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.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-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8QSZN4i.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 shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-D3_JSfLV.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/public/ui/types.d.ts

@@ -920,33 +920,49 @@ export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSli
      * already identifies one occurrence, anywhere in the document). A
      * `{ id, story }` record (e.g. a {@link getAt}/{@link setActive} hit) is
      * also accepted for convenience, so a hit can be passed straight through.
-     * Structured failure receipt or `false` if unsupported.
+     * Returns the immediate routed result. Use {@link acceptAsync} when later UI
+     * depends on the settled document operation.
      */
     accept(changeId: string | {
         id: string;
         story?: unknown;
     }): CommandExecutionResult;
+    /** Accept a change and resolve after the document operation settles. */
+    acceptAsync(changeId: string | {
+        id: string;
+        story?: unknown;
+    }): Promise<CommandExecutionResult>;
     /**
      * Reject a change. The id is sufficient on its own (a tracked-change id
      * already identifies one occurrence, anywhere in the document). A
      * `{ id, story }` record (e.g. a {@link getAt}/{@link setActive} hit) is
      * also accepted for convenience, so a hit can be passed straight through.
-     * Structured failure receipt or `false` if unsupported.
+     * Returns the immediate routed result. Use {@link rejectAsync} when later UI
+     * depends on the settled document operation.
      */
     reject(changeId: string | {
         id: string;
         story?: unknown;
     }): CommandExecutionResult;
+    /** Reject a change and resolve after the document operation settles. */
+    rejectAsync(changeId: string | {
+        id: string;
+        story?: unknown;
+    }): Promise<CommandExecutionResult>;
     /**
      * Accept every active tracked change. Returns the Document API receipt, or
      * `false` when bulk decisions are unavailable / disabled on the host.
      */
     acceptAll(): CommandExecutionResult;
+    /** Accept every active tracked change and resolve after the operation settles. */
+    acceptAllAsync(): Promise<CommandExecutionResult>;
     /**
      * Reject every active tracked change. Returns the Document API receipt, or
      * `false` when bulk decisions are unavailable / disabled on the host.
      */
     rejectAll(): CommandExecutionResult;
+    /** Reject every active tracked change and resolve after the operation settles. */
+    rejectAllAsync(): Promise<CommandExecutionResult>;
     /**
      * Move focus to the next tracked change in document order (relative to the
      * active change). Returns the id that became active, or `null` when there are
@@ -1005,9 +1021,14 @@ export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSli
     /**
      * Scroll the tracked-change anchor into view through the host navigation
      * surface. Resolves with both v1/main `{ success }` and v2 `{ ok, reason? }`
-     * fields.
+     * fields. A bare id resolves its story from the loaded rows; a
+     * `{ id, story }` record pins the occurrence when the same id repeats across
+     * the body and a footnote, header, or footer.
      */
-    scrollTo(changeId: string): Promise<WorkflowScrollResult>;
+    scrollTo(input: string | {
+        id: string;
+        story?: unknown;
+    }): Promise<WorkflowScrollResult>;
 }
 /** Content-controls handle. */
 export interface ContentControlsHandle extends SnapshotSubscribable<ContentControlsSlice> {

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-D8mAFF-r.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-D8QSZN4i.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-SDR04tiH.cjs");
 const require_constants = require("./chunks/constants-DpXuDx_g.cjs");
 let vue = require("vue");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.13";
+		return "2.12.0-next.14";
 	} catch {
 		return "unknown";
 	}
@@ -45328,7 +45328,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.12.0-next.13";
+		this.version = "2.12.0-next.14";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-BzJ3CyxR.es.js";
-import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-D3_JSfLV.es.js";
 import { t as _plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-BOaGB7Aw.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./chunks/constants-B6VBlmKp.es.js";
 import * as Vue from "vue";
@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.13";
+		return "2.12.0-next.14";
 	} catch {
 		return "unknown";
 	}
@@ -45259,7 +45259,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.12.0-next.13";
+		this.version = "2.12.0-next.14";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];