superdoc 2.4.0-next.2 → 2.4.0-next.21

package/dist/superdoc/src/helpers/v2-typing-review-hydration.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Coalesce automatic review-catalog reconciliation behind a genuine typing
+ * quiet period. Every typing signal restarts the trailing timer; there is no
+ * maximum-wait escape hatch because that would deliberately run the expensive
+ * catalog reads in the middle of a sustained input burst.
+ */
+export function createV2TypingReviewHydrationScheduler({ hydrate, idleMs, setTimer, clearTimer, }: {
+    hydrate: any;
+    idleMs?: number | undefined;
+    setTimer?: ((callback: any, delay: any) => NodeJS.Timeout) | undefined;
+    clearTimer?: ((timer: any) => void) | undefined;
+}): {
+    schedule: () => void;
+    clear: () => void;
+    isPending: () => boolean;
+};

package/dist/superdoc/src/internal/toolbar/built-in/ToolbarButton.vue.d.ts

@@ -1,20 +1,20 @@
 declare const _default: import('vue').DefineComponent<{}, {
     $emit: (event: "buttonClick" | "textSubmit" | "mainClick", ...args: any[]) => void;
     active: boolean;
-    iconColor: string;
     isNarrow: boolean;
     isWide: boolean;
-    toolbarItem: Record<string, any>;
     defaultLabel: string;
+    iconColor: string;
+    toolbarItem: Record<string, any>;
     isOverflowItem: boolean;
     allowEnterPropagation: boolean;
     $props: {
         readonly active?: boolean | undefined;
-        readonly iconColor?: string | undefined;
         readonly isNarrow?: boolean | undefined;
         readonly isWide?: boolean | undefined;
-        readonly toolbarItem?: Record<string, any> | undefined;
         readonly defaultLabel?: string | undefined;
+        readonly iconColor?: string | undefined;
+        readonly toolbarItem?: Record<string, any> | undefined;
         readonly isOverflowItem?: boolean | undefined;
         readonly allowEnterPropagation?: boolean | undefined;
     };

package/dist/superdoc/src/internal/toolbar/built-in-toolbar.d.ts

@@ -187,6 +187,17 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
     _detachFormatPainterModeChange: any;
     /** Registered custom-button command unregister handles. */
     _customCommandRegs: Map<any, any>;
+    /**
+     * Custom entries already reported as unbuildable.
+     *
+     * `#makeToolbarItems` runs on every throttled resize and on font or
+     * active-editor changes, not only at construction, so a single static
+     * configuration error would otherwise fire `exception` once per rebuild --
+     * unbounded, into consumer telemetry, for a mistake that cannot change
+     * without a reconfigure. Keyed by name plus message so a different fault
+     * on the same entry still reports once.
+     */
+    _reportedInvalidCustomItems: Set<any>;
     /** Signature of the last-built font options, to skip redundant rebuilds. */
     _lastFontOptionsSignature: string;
     app: import('vue').App<Element> | undefined;

package/dist/superdoc/src/internal/toolbar/compatibility-catalog.d.ts

@@ -36,7 +36,7 @@ export interface BuiltInToolbarItemEntry {
  * docs present them; it is documentation-only.
  *
  * Every documented `Available buttons` entry from
- * `apps/docs/editor/built-in-ui/toolbar.mdx` appears here exactly once, plus the
+ * the built-in UI documentation appears here exactly once, plus the
  * `customButtons` shell concept.
  */
 export declare const BUILT_IN_TOOLBAR_CATALOG: readonly BuiltInToolbarItemEntry[];

package/dist/superdoc/src/public/index.d.cts

@@ -9,10 +9,12 @@ import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './index.js'
 import type { CanPerformPermissionParams as __Cjs_CanPerformPermissionParams } from './index.js' with { "resolution-mode": "import" };
 import type { CollaborationConfig as __Cjs_CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentAddress as __Cjs_CommentAddress } from './index.js' with { "resolution-mode": "import" };
+import type { CommentsConfig as __Cjs_CommentsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentsType as __Cjs_CommentsType } from './index.js' with { "resolution-mode": "import" };
 import type { Config as __Cjs_Config } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlActiveChangePayload as __Cjs_ContentControlActiveChangePayload } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlClickPayload as __Cjs_ContentControlClickPayload } from './index.js' with { "resolution-mode": "import" };
+import type { ContentControlsConfig as __Cjs_ContentControlsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuConfig as __Cjs_ContextMenuConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuContext as __Cjs_ContextMenuContext } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuItem as __Cjs_ContextMenuItem } from './index.js' with { "resolution-mode": "import" };
@@ -49,6 +51,7 @@ import type { LayoutFragment as __Cjs_LayoutFragment } from './index.js' with {
 import type { LayoutMetrics as __Cjs_LayoutMetrics } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutMode as __Cjs_LayoutMode } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutPage as __Cjs_LayoutPage } from './index.js' with { "resolution-mode": "import" };
+import type { LinkPopoverConfig as __Cjs_LinkPopoverConfig } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverContext as __Cjs_LinkPopoverContext } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverResolution as __Cjs_LinkPopoverResolution } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverResolver as __Cjs_LinkPopoverResolver } from './index.js' with { "resolution-mode": "import" };
@@ -96,6 +99,7 @@ import type { SuperDocExceptionEditorPayload as __Cjs_SuperDocExceptionEditorPay
 import type { SuperDocExceptionPayload as __Cjs_SuperDocExceptionPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionRestorePayload as __Cjs_SuperDocExceptionRestorePayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionStorePayload as __Cjs_SuperDocExceptionStorePayload } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocExceptionToolbarPayload as __Cjs_SuperDocExceptionToolbarPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtension as __Cjs_SuperDocExtension } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtensionActivateReturn as __Cjs_SuperDocExtensionActivateReturn } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtensionCapabilities as __Cjs_SuperDocExtensionCapabilities } from './index.js' with { "resolution-mode": "import" };
@@ -163,7 +167,14 @@ import type { SurfacesModuleConfig as __Cjs_SurfacesModuleConfig } from './index
 import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resolution-mode": "import" };
 import type { TextSegment as __Cjs_TextSegment } from './index.js' with { "resolution-mode": "import" };
 import type { TextTarget as __Cjs_TextTarget } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButton as __Cjs_ToolbarCustomButton } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButtonContext as __Cjs_ToolbarCustomButtonContext } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButtonItem as __Cjs_ToolbarCustomButtonItem } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomDropdownItem as __Cjs_ToolbarCustomDropdownItem } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomDropdownOption as __Cjs_ToolbarCustomDropdownOption } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomSeparatorItem as __Cjs_ToolbarCustomSeparatorItem } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangeAuthor as __Cjs_TrackChangeAuthor } from './index.js' with { "resolution-mode": "import" };
+import type { TrackChangeHighlightColors as __Cjs_TrackChangeHighlightColors } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesAuthorColorsConfig as __Cjs_TrackChangesAuthorColorsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesModuleConfig as __Cjs_TrackChangesModuleConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesSemanticColorsConfig as __Cjs_TrackChangesSemanticColorsConfig } from './index.js' with { "resolution-mode": "import" };
@@ -188,11 +199,13 @@ export declare const buildTheme: typeof import('./index.js', { with: { "resoluti
 export type { __Cjs_CanPerformPermissionParams as CanPerformPermissionParams };
 export type { __Cjs_CollaborationConfig as CollaborationConfig };
 export type { __Cjs_CommentAddress as CommentAddress };
+export type { __Cjs_CommentsConfig as CommentsConfig };
 export type { __Cjs_CommentsType as CommentsType };
 export declare const compareVersions: typeof import('./index.js', { with: { "resolution-mode": "import" } }).compareVersions;
 export type { __Cjs_Config as Config };
 export type { __Cjs_ContentControlActiveChangePayload as ContentControlActiveChangePayload };
 export type { __Cjs_ContentControlClickPayload as ContentControlClickPayload };
+export type { __Cjs_ContentControlsConfig as ContentControlsConfig };
 export type { __Cjs_ContextMenuConfig as ContextMenuConfig };
 export type { __Cjs_ContextMenuContext as ContextMenuContext };
 export type { __Cjs_ContextMenuItem as ContextMenuItem };
@@ -234,6 +247,7 @@ export type { __Cjs_LayoutFragment as LayoutFragment };
 export type { __Cjs_LayoutMetrics as LayoutMetrics };
 export type { __Cjs_LayoutMode as LayoutMode };
 export type { __Cjs_LayoutPage as LayoutPage };
+export type { __Cjs_LinkPopoverConfig as LinkPopoverConfig };
 export type { __Cjs_LinkPopoverContext as LinkPopoverContext };
 export type { __Cjs_LinkPopoverResolution as LinkPopoverResolution };
 export type { __Cjs_LinkPopoverResolver as LinkPopoverResolver };
@@ -283,6 +297,7 @@ export type { __Cjs_SuperDocExceptionEditorPayload as SuperDocExceptionEditorPay
 export type { __Cjs_SuperDocExceptionPayload as SuperDocExceptionPayload };
 export type { __Cjs_SuperDocExceptionRestorePayload as SuperDocExceptionRestorePayload };
 export type { __Cjs_SuperDocExceptionStorePayload as SuperDocExceptionStorePayload };
+export type { __Cjs_SuperDocExceptionToolbarPayload as SuperDocExceptionToolbarPayload };
 export type { __Cjs_SuperDocExtension as SuperDocExtension };
 export type { __Cjs_SuperDocExtensionActivateReturn as SuperDocExtensionActivateReturn };
 export type { __Cjs_SuperDocExtensionCapabilities as SuperDocExtensionCapabilities };
@@ -350,7 +365,14 @@ export type { __Cjs_SurfacesModuleConfig as SurfacesModuleConfig };
 export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
 export type { __Cjs_TextTarget as TextTarget };
+export type { __Cjs_ToolbarCustomButton as ToolbarCustomButton };
+export type { __Cjs_ToolbarCustomButtonContext as ToolbarCustomButtonContext };
+export type { __Cjs_ToolbarCustomButtonItem as ToolbarCustomButtonItem };
+export type { __Cjs_ToolbarCustomDropdownItem as ToolbarCustomDropdownItem };
+export type { __Cjs_ToolbarCustomDropdownOption as ToolbarCustomDropdownOption };
+export type { __Cjs_ToolbarCustomSeparatorItem as ToolbarCustomSeparatorItem };
 export type { __Cjs_TrackChangeAuthor as TrackChangeAuthor };
+export type { __Cjs_TrackChangeHighlightColors as TrackChangeHighlightColors };
 export type { __Cjs_TrackChangesAuthorColorsConfig as TrackChangesAuthorColorsConfig };
 export type { __Cjs_TrackChangesModuleConfig as TrackChangesModuleConfig };
 export type { __Cjs_TrackChangesSemanticColorsConfig as TrackChangesSemanticColorsConfig };

package/dist/superdoc/src/public/index.d.ts

@@ -62,6 +62,7 @@ export type { SuperDocAwarenessUpdatePayload } from '../core/types/index.js';
 export type { SuperDocCommentsUpdatePayload } from '../core/types/index.js';
 export type { SuperDocEditorPayload } from '../core/types/index.js';
 export type { SuperDocExceptionEditorPayload } from '../core/types/index.js';
+export type { SuperDocExceptionToolbarPayload } from '../core/types/index.js';
 export type { SuperDocExceptionPayload } from '../core/types/index.js';
 export type { SuperDocExceptionRestorePayload } from '../core/types/index.js';
 export type { SuperDocExceptionStorePayload } from '../core/types/index.js';
@@ -72,6 +73,16 @@ export type { SuperDocLayoutEngineOptions as LayoutEngineOptions } from '../core
 export type { FlowBlock, FlowMode, Layout, Fragment as LayoutFragment, Page as LayoutPage } from '../../../layout-engine/contracts/src/index.js';
 export type { LayoutMetrics } from '../../../layout-engine/layout-bridge/src/index.js';
 export type { LayoutMode } from '../../../layout-engine/painters/dom/src/index.js';
+export type { CommentsConfig } from '../core/types/index.js';
+export type { TrackChangeHighlightColors } from '../core/types/index.js';
+export type { ContentControlsConfig } from '../core/types/index.js';
+export type { ToolbarCustomButton } from '../core/types/index.js';
+export type { ToolbarCustomButtonItem } from '../core/types/index.js';
+export type { ToolbarCustomDropdownItem } from '../core/types/index.js';
+export type { ToolbarCustomDropdownOption } from '../core/types/index.js';
+export type { ToolbarCustomSeparatorItem } from '../core/types/index.js';
+export type { ToolbarCustomButtonContext } from '../core/types/index.js';
+export type { LinkPopoverConfig } from '../core/types/index.js';
 export type { LinkPopoverContext } from '../core/types/index.js';
 export type { LinkPopoverResolution } from '../core/types/index.js';
 export type { LinkPopoverResolver } from '../core/types/index.js';

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

@@ -837,7 +837,19 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     list(query?: CommentsListQuery): readonly CommentInfo[];
     /** Resolve a single comment by id from the best-known loaded state. */
     getById(commentId: string): CommentInfo | null;
-    /** Create a comment from a frozen selection capture. */
+    /**
+     * Create a comment from a frozen selection capture.
+     *
+     * A capture carrying neither `target` nor `selectionTarget` fails closed with
+     * the same `NO_SELECTION` receipt {@link createFromSelection} mints for an
+     * empty selection, because both describe the same user-visible mistake:
+     * commenting with nothing selected. A capture that *has* a target which no
+     * longer resolves is a different failure, and keeps the Document API's own
+     * receipt so the reason stays specific.
+     *
+     * `capturedAt` is provenance for the consumer, not an expiry. A capture stays
+     * usable while its target resolves; elapsed time alone never invalidates it.
+     */
     createFromCapture(capture: CommentAnchorCapture, input: {
         text: string;
     }): WorkflowReceipt;
@@ -853,6 +865,18 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     reply(commentId: string, input: {
         text: string;
     }): WorkflowReceipt;
+    /**
+     * Replace a comment's body text through the Document API
+     * (`comments.patch({ commentId, text })`).
+     *
+     * Gated by the comments `readOnly` policy like every other comment write.
+     * `allowResolve` is deliberately NOT consulted: that policy forbids only the
+     * resolve/reopen transition, and an application that may not resolve threads
+     * can still let an author correct their own wording.
+     */
+    edit(commentId: string, input: {
+        text: string;
+    }): WorkflowReceipt;
     /** Mark a comment resolved. */
     resolve(commentId: string): WorkflowReceipt;
     /** Reopen a resolved comment. */

package/dist/superdoc/src/stores/comments-store.d.ts

@@ -157,7 +157,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         retainedTrackedChangeIds?: Iterable<string>;
     }) => void;
     clearEditorCommentPositions: () => void;
-    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState }: {
+    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState, trackedChangeIdentityIndex, }: {
         superdoc: Object;
         params: Object;
     }) => void;
@@ -185,10 +185,17 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2CommentsAdapter: import('vue').ShallowRef<null, null>;
     setV2CommentsAdapter: (adapter: any) => void;
     getV2CommentsAdapter: (superdoc: any) => any;
-    hydrateCommentsFromV2: ({ superdoc, adapter, documentId }?: {}) => Promise<any>;
-    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, patch, }?: {}) => any;
-    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs }?: {
+    hydrateCommentsFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, commentIds, isCurrent, signal, hydrationGeneration, }?: {
+        trackedChangesListMode?: string | undefined;
+    }) => Promise<any>;
+    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+    supersedeV2ReviewHydration: ({ commentsAdapter, trackedChangesAdapter }?: {}) => {
+        commentsGeneration: any;
+        trackedChangesGeneration: any;
+    };
+    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
+        pruneStale?: boolean | undefined;
     }) => any;
     isV2EditorActive: (superdoc: any) => boolean;
     replyCommentV2: ({ superdoc, parentCommentId, text }?: {}) => Promise<any>;
@@ -198,10 +205,12 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2TrackedChangesAdapter: import('vue').ShallowRef<null, null>;
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
-    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, }?: {
+    getV2TrackedChangeRowCount: (documentId?: null) => number;
+    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, isCurrent, targetIds, reconciliationBatchSize, signal, hydrationGeneration, }?: {
         trackedChangesListMode?: string | undefined;
+        reconciliationBatchSize?: number | undefined;
     }) => Promise<any>;
-    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
     }) => Promise<{
@@ -210,14 +219,27 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         items?: undefined;
         resolvedIds?: undefined;
         unresolvedIds?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
         failures?: undefined;
     } | {
         ok: boolean;
         items: never[];
         resolvedIds: never[];
         unresolvedIds: never[];
+        allResolved: boolean;
+        removedRows: any;
         reason?: undefined;
         failures?: undefined;
+    } | {
+        ok: boolean;
+        items: never[];
+        resolvedIds: never[];
+        unresolvedIds: never[];
+        reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
+        failures?: undefined;
     } | {
         ok: boolean;
         items: any[];
@@ -225,10 +247,14 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds: (string | null)[];
         failures: any[];
         reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
     }>;
-    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, }?: {
+    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, liveIds: suppliedLiveIds, liveAnchorKeys: suppliedLiveAnchorKeys, hydrationGeneration, }?: {
         pruneStale?: boolean | undefined;
         preparedParams?: null | undefined;
+        liveIds?: null | undefined;
+        liveAnchorKeys?: null | undefined;
     }) => any;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
 }, "suppressInternalExternal" | "activeComment" | "activeFloatingCommentInstanceId" | "floatingCommentsOffset" | "pendingComment" | "currentCommentText" | "isDebugging" | "editingCommentId" | "editorCommentPositions" | "isCommentHighlighted" | "v2CommentsAdapter" | "COMMENT_EVENTS" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "commentsList" | "isCommentsListVisible" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "hasInitializedLocations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2TrackedChangesAdapter">, Pick<{
@@ -390,7 +416,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         retainedTrackedChangeIds?: Iterable<string>;
     }) => void;
     clearEditorCommentPositions: () => void;
-    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState }: {
+    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState, trackedChangeIdentityIndex, }: {
         superdoc: Object;
         params: Object;
     }) => void;
@@ -418,10 +444,17 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2CommentsAdapter: import('vue').ShallowRef<null, null>;
     setV2CommentsAdapter: (adapter: any) => void;
     getV2CommentsAdapter: (superdoc: any) => any;
-    hydrateCommentsFromV2: ({ superdoc, adapter, documentId }?: {}) => Promise<any>;
-    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, patch, }?: {}) => any;
-    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs }?: {
+    hydrateCommentsFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, commentIds, isCurrent, signal, hydrationGeneration, }?: {
+        trackedChangesListMode?: string | undefined;
+    }) => Promise<any>;
+    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+    supersedeV2ReviewHydration: ({ commentsAdapter, trackedChangesAdapter }?: {}) => {
+        commentsGeneration: any;
+        trackedChangesGeneration: any;
+    };
+    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
+        pruneStale?: boolean | undefined;
     }) => any;
     isV2EditorActive: (superdoc: any) => boolean;
     replyCommentV2: ({ superdoc, parentCommentId, text }?: {}) => Promise<any>;
@@ -431,10 +464,12 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2TrackedChangesAdapter: import('vue').ShallowRef<null, null>;
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
-    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, }?: {
+    getV2TrackedChangeRowCount: (documentId?: null) => number;
+    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, isCurrent, targetIds, reconciliationBatchSize, signal, hydrationGeneration, }?: {
         trackedChangesListMode?: string | undefined;
+        reconciliationBatchSize?: number | undefined;
     }) => Promise<any>;
-    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
     }) => Promise<{
@@ -443,14 +478,27 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         items?: undefined;
         resolvedIds?: undefined;
         unresolvedIds?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
         failures?: undefined;
     } | {
         ok: boolean;
         items: never[];
         resolvedIds: never[];
         unresolvedIds: never[];
+        allResolved: boolean;
+        removedRows: any;
         reason?: undefined;
         failures?: undefined;
+    } | {
+        ok: boolean;
+        items: never[];
+        resolvedIds: never[];
+        unresolvedIds: never[];
+        reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
+        failures?: undefined;
     } | {
         ok: boolean;
         items: any[];
@@ -458,10 +506,14 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds: (string | null)[];
         failures: any[];
         reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
     }>;
-    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, }?: {
+    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, liveIds: suppliedLiveIds, liveAnchorKeys: suppliedLiveAnchorKeys, hydrationGeneration, }?: {
         pruneStale?: boolean | undefined;
         preparedParams?: null | undefined;
+        liveIds?: null | undefined;
+        liveAnchorKeys?: null | undefined;
     }) => any;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
 }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
@@ -623,7 +675,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         retainedTrackedChangeIds?: Iterable<string>;
     }) => void;
     clearEditorCommentPositions: () => void;
-    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState }: {
+    handleTrackedChangeUpdate: ({ superdoc, params, broadcastChanges, documentState, trackedChangeIdentityIndex, }: {
         superdoc: Object;
         params: Object;
     }) => void;
@@ -651,10 +703,17 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2CommentsAdapter: import('vue').ShallowRef<null, null>;
     setV2CommentsAdapter: (adapter: any) => void;
     getV2CommentsAdapter: (superdoc: any) => any;
-    hydrateCommentsFromV2: ({ superdoc, adapter, documentId }?: {}) => Promise<any>;
-    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, patch, }?: {}) => any;
-    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs }?: {
+    hydrateCommentsFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, commentIds, isCurrent, signal, hydrationGeneration, }?: {
+        trackedChangesListMode?: string | undefined;
+    }) => Promise<any>;
+    applyReviewSnapshotFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+    supersedeV2ReviewHydration: ({ commentsAdapter, trackedChangesAdapter }?: {}) => {
+        commentsGeneration: any;
+        trackedChangesGeneration: any;
+    };
+    reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
+        pruneStale?: boolean | undefined;
     }) => any;
     isV2EditorActive: (superdoc: any) => boolean;
     replyCommentV2: ({ superdoc, parentCommentId, text }?: {}) => Promise<any>;
@@ -664,10 +723,12 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     v2TrackedChangesAdapter: import('vue').ShallowRef<null, null>;
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
-    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, }?: {
+    getV2TrackedChangeRowCount: (documentId?: null) => number;
+    hydrateTrackedChangesFromV2: ({ superdoc, adapter, documentId, trackedChangesListMode, refreshReason, blocking, isCurrent, targetIds, reconciliationBatchSize, signal, hydrationGeneration, }?: {
         trackedChangesListMode?: string | undefined;
+        reconciliationBatchSize?: number | undefined;
     }) => Promise<any>;
-    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
     }) => Promise<{
@@ -676,6 +737,17 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         items?: undefined;
         resolvedIds?: undefined;
         unresolvedIds?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
+        failures?: undefined;
+    } | {
+        ok: boolean;
+        items: never[];
+        resolvedIds: never[];
+        unresolvedIds: never[];
+        allResolved: boolean;
+        removedRows: any;
+        reason?: undefined;
         failures?: undefined;
     } | {
         ok: boolean;
@@ -683,6 +755,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         resolvedIds: never[];
         unresolvedIds: never[];
         reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
         failures?: undefined;
     } | {
         ok: boolean;
@@ -691,10 +765,14 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds: (string | null)[];
         failures: any[];
         reason?: undefined;
+        allResolved?: undefined;
+        removedRows?: undefined;
     }>;
-    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, }?: {
+    reconcileTrackedChangesFromV2: ({ superdoc, adapter, documentId, items, pruneStale, preparedParams, liveIds: suppliedLiveIds, liveAnchorKeys: suppliedLiveAnchorKeys, hydrationGeneration, }?: {
         pruneStale?: boolean | undefined;
         preparedParams?: null | undefined;
+        liveIds?: null | undefined;
+        liveAnchorKeys?: null | undefined;
     }) => any;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-}, "getCommentAliasIds" | "getTrackedChangeThread" | "getCommentPositionKey" | "getCommentPosition" | "getCommentAnchoredText" | "getCommentAnchorData" | "resolveCommentPositionEntry" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "getComment" | "setActiveComment" | "getCommentLocation" | "hasOverlapId" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "cancelImportedTrackedChangeBootstrap" | "removeCommentsForDocument" | "processLoadedDocxComments" | "translateCommentsForExport" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "refreshTrackedChangeCommentsByIds" | "syncResolvedCommentsWithDocument" | "syncTrackedChangePositionsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "syncTrackedChangeComments" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "hydrateCommentsFromV2" | "applyReviewSnapshotFromV2" | "reconcileCommentsFromV2" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "hydrateTrackedChangesFromV2" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+}, "getCommentAliasIds" | "getTrackedChangeThread" | "getCommentPositionKey" | "getCommentPosition" | "getCommentAnchoredText" | "getCommentAnchorData" | "resolveCommentPositionEntry" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "getComment" | "setActiveComment" | "getCommentLocation" | "hasOverlapId" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "cancelImportedTrackedChangeBootstrap" | "removeCommentsForDocument" | "processLoadedDocxComments" | "translateCommentsForExport" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "refreshTrackedChangeCommentsByIds" | "syncResolvedCommentsWithDocument" | "syncTrackedChangePositionsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "syncTrackedChangeComments" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "hydrateCommentsFromV2" | "applyReviewSnapshotFromV2" | "supersedeV2ReviewHydration" | "reconcileCommentsFromV2" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "hydrateTrackedChangesFromV2" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;