superdoc 2.4.0-next.1 → 2.4.0-next.10

package/dist/superdoc/src/core/types/index.d.ts

@@ -843,6 +843,111 @@ export type LinkPopoverResolution = {
  * default popover.
  */
 export type LinkPopoverResolver = (ctx: LinkPopoverContext) => LinkPopoverResolution | null | undefined;
+/**
+ * Canonical presentation settings for the built-in comments UI.
+ *
+ * Presentation only, and deliberately not the whole of `modules.comments`.
+ * That block also carries `readOnly` and `allowResolve`, which resolve through
+ * `interaction.comments`, and `permissionResolver`, which is read off
+ * `modules.comments` or the top-level `Config`. All three are stripped from
+ * this bag: policy outlives the built-in UI, so an application drawing its own
+ * comment surface still has to honor it. See the fields themselves, which are
+ * rejected by name with the spelling that applies to each.
+ *
+ * Open on purpose, for the same reason `modules.comments` is: the runtime
+ * merges this bag over that block and spreads the result through the comments
+ * store, which accepts pass-through keys. Closing it would reject working
+ * configurations, which is a worse failure than the missing autocomplete it
+ * would buy. The named fields are the ones the shell reads.
+ */
+export type CommentsConfig = {
+    /** How comments present themselves as the surface narrows. */
+    displayMode?: 'auto' | 'sidebar' | 'inline';
+    /** CSS selector for an explicit width measurement target in `auto` mode. */
+    compactMeasurementSelector?: string;
+    /** Fixed compact-mode breakpoint override, in pixels. */
+    compactBreakpointPx?: number;
+    /** Comment highlight colors (internal/external and active overrides). */
+    highlightColors?: {
+        /** Base highlight color for internal comments. */
+        internal?: string;
+        /** Base highlight color for external comments. */
+        external?: string;
+        /** Active highlight color override for internal comments. */
+        activeInternal?: string;
+        /** Active highlight color override for external comments. */
+        activeExternal?: string;
+    };
+    /** Comment highlight opacity, active and inactive. */
+    highlightOpacity?: {
+        /** Opacity for the active comment highlight. */
+        active?: number;
+        /** Opacity for inactive comment highlights. */
+        inactive?: number;
+    };
+    /** Highlight color used while hovering a comment. */
+    highlightHoverColor?: string;
+    /** Tracked-change highlight colors. */
+    trackChangeHighlightColors?: TrackChangeHighlightColors;
+    /** Active tracked-change highlight colors (defaults to the above). */
+    trackChangeActiveHighlightColors?: TrackChangeHighlightColors;
+    /**
+     * Policy, not presentation. `normalizeUiConfig` strips all three from this
+     * bag before anything reads it, so accepting them here would advertise a
+     * setting that is silently discarded.
+     *
+     * `readOnly` and `allowResolve` belong on `interaction.comments`, where they
+     * resolve and keep applying to an application drawing its own comment
+     * surface.
+     *
+     * `permissionResolver` is collaboration wiring rather than policy, and has
+     * no `ui` spelling at all. `pickResolver` takes the first of
+     * `modules.comments.permissionResolver` and the top-level
+     * `Config.permissionResolver`, in that order, so either works and the
+     * comments-scoped one wins.
+     */
+    readOnly?: never;
+    allowResolve?: never;
+    permissionResolver?: never;
+} & Record<string, unknown>;
+/** Border and background colors for one tracked-change highlight state. */
+export interface TrackChangeHighlightColors {
+    /** Border color for inserted text. */
+    insertBorder?: string;
+    /** Background color for inserted text. */
+    insertBackground?: string;
+    /** Border color for deleted text. */
+    deleteBorder?: string;
+    /** Background color for deleted text. */
+    deleteBackground?: string;
+    /** Border color for a format change. */
+    formatBorder?: string;
+}
+/**
+ * Canonical configuration for the chrome drawn around content controls.
+ *
+ * `chrome` is the whole option bag this surface has. `'default'` and `'none'`
+ * are the only values the painter and the v2 host accept; anything else is
+ * coerced back to `'default'`.
+ */
+export interface ContentControlsConfig {
+    /** Whether SuperDoc draws its own chrome around each content control. */
+    chrome?: 'default' | 'none';
+}
+/**
+ * Canonical configuration for the built-in link popover.
+ *
+ * `popoverResolver` supersedes `modules.links.popoverResolver`, which stays
+ * supported for all of v2. Setting both keeps the canonical one; the legacy
+ * spelling only applies when the canonical one is absent.
+ */
+export interface LinkPopoverConfig {
+    /**
+     * Called when a user clicks a link, to decide which popover to show.
+     * Returning `null` or `undefined` falls back to the built-in popover.
+     */
+    popoverResolver?: LinkPopoverResolver;
+}
 /** Context object passed to context menu callbacks (showWhen, render, action, menuProvider). */
 export interface ContextMenuContext {
     /** The editor instance. */
@@ -1650,6 +1755,17 @@ export interface FindReplaceConfig {
         width?: number | string;
         maxWidth?: number | string;
         maxHeight?: number | string;
+        /**
+         * Focus the find input when the surface opens. Defaults to `true`; set
+         * `false` to leave focus wherever the user had it.
+         *
+         * Honored but undeclared until #1094: `useFindReplace` spreads this whole
+         * bag into the surface request, and `SurfaceManager` applies it last, over
+         * the `modules.surfaces.floating` defaults.
+         */
+        autoFocus?: boolean;
+        /** Close the surface on a pointer press outside it. Defaults to `false`. */
+        closeOnOutsidePointerDown?: boolean;
     };
 }
 /**
@@ -2654,7 +2770,7 @@ export interface UIConfig {
         showTableOfContentsButton?: boolean;
     };
     /** Built-in comments UI. Enabled by default. */
-    comments?: boolean | Record<string, unknown>;
+    comments?: boolean | CommentsConfig;
     /** Built-in right-click and slash context menu. Enabled by default. */
     contextMenu?: boolean | ContextMenuConfig;
     /**
@@ -2662,16 +2778,20 @@ export interface UIConfig {
      * SuperDoc intercept Cmd+F / Ctrl+F; `editor.ui.search` stays available to
      * custom UI either way.
      */
-    search?: boolean | Record<string, unknown>;
-    /** Built-in popover shown when a link is selected. Disabled by default. */
-    linkPopover?: boolean | Record<string, unknown>;
+    search?: boolean | FindReplaceConfig;
+    /**
+     * Built-in popover shown when a link is clicked. It renders by default;
+     * pass `false` (or `ui: false`) to suppress it. Supplying a
+     * {@link LinkPopoverConfig.popoverResolver} replaces it with your own UI.
+     */
+    linkPopover?: boolean | LinkPopoverConfig;
     /** Built-in ruler. Disabled by default. */
     ruler?: boolean | {
         /** Element or selector to render the ruler into. */
         container?: string | HTMLElement;
     };
     /** Built-in chrome drawn around content controls. Enabled by default. */
-    contentControls?: boolean | Record<string, unknown>;
+    contentControls?: boolean | ContentControlsConfig;
 }
 /**
  * What the user is permitted to do, as distinct from what SuperDoc draws.

package/dist/superdoc/src/helpers/v2-review-mutation-impact.d.ts

@@ -9,6 +9,7 @@
  * one authoritative catalog after render instead of issuing one read per id.
  */
 export function getV2TrackedChangeMutationImpact(event: any): {
+    allResolved?: any;
     upsertIds: Set<any>;
     removedIds: Set<any>;
     remappedPairs: {

package/dist/superdoc/src/helpers/v2-review-mutation-reconciler.d.ts

@@ -12,7 +12,7 @@ export function createV2ReviewMutationReconciler({ getContext, reconcile, hydrat
     onReconciled: any;
 }): {
     enqueue: (impact: any) => void;
-    enqueueAfterPaint(impact: any, waitForPaint: any): void;
+    enqueueAfterPaint(impact: any, waitForPaint: any): Promise<any>;
     onRender: (supersedesInFlight?: boolean) => void;
     reset(): void;
     getPendingIds(): Set<any>;

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" };
@@ -164,6 +167,7 @@ import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resol
 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 { 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 +192,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 +240,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 };
@@ -351,6 +358,7 @@ export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
 export type { __Cjs_TextTarget as TextTarget };
 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

@@ -72,6 +72,10 @@ 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 { 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, 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, 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, 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">>;