superdoc 2.12.0-next.13 → 2.12.0-next.15

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,12 +1021,33 @@ 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> {
+    /**
+     * Observe the document-wide content-control catalog and active field IDs.
+     * The catalog remains requested until the returned disposer runs.
+     */
+    observe(listener: (snapshot: ContentControlsSlice) => void): () => void;
+    /**
+     * Observe the passive content-controls slice without requesting the
+     * document-wide catalog. Meant for consumers that only need the active
+     * field path, such as the core active-change event bridge; a field panel
+     * should use {@link observe}.
+     */
+    observeActivePath(listener: (snapshot: ContentControlsSlice) => void): () => void;
+    /** Event-shaped alias of {@link observe}. */
+    subscribe(listener: (event: {
+        snapshot: ContentControlsSlice;
+    }) => void): () => void;
     /** Read the current content-controls snapshot. */
     getSnapshot(): ContentControlsSlice;
     /** Read the current content-controls snapshot. */

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-BkDVQgqj.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.15";
 	} 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.15";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -45497,7 +45497,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 				this.#pendingContentControlInputSource = null;
 				this.#pendingContentControlInputExpiresAt = null;
 			});
-			contentControlsUnsub = this.#ui.contentControls.observe((snapshot) => {
+			contentControlsUnsub = this.#ui.contentControls.observeActivePath((snapshot) => {
 				const editor = this.activeEditor;
 				const activePath = snapshot.activeIds.map((id) => toContentControlRef(snapshot.items.find((item) => item.id === id)));
 				if (activePath.some((item) => item === null)) return;

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-Biwv0tas.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.15";
 	} 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.15";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -45428,7 +45428,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 				this.#pendingContentControlInputSource = null;
 				this.#pendingContentControlInputExpiresAt = null;
 			});
-			contentControlsUnsub = this.#ui.contentControls.observe((snapshot) => {
+			contentControlsUnsub = this.#ui.contentControls.observeActivePath((snapshot) => {
 				const editor = this.activeEditor;
 				const activePath = snapshot.activeIds.map((id) => toContentControlRef(snapshot.items.find((item) => item.id === id)));
 				if (activePath.some((item) => item === null)) return;