superdoc 2.4.0-next.8 → 2.4.0

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

@@ -99,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" };
@@ -121,6 +122,9 @@ import type { SuperDocFontsApi as __Cjs_SuperDocFontsApi } from './index.js' wit
 import type { SuperDocGuardedDoc as __Cjs_SuperDocGuardedDoc } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocGuardedDocQuery as __Cjs_SuperDocGuardedDocQuery } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocGuardedDocSelection as __Cjs_SuperDocGuardedDocSelection } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxAppearance as __Cjs_SuperDocInlineBoxAppearance } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxLayout as __Cjs_SuperDocInlineBoxLayout } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxOptions as __Cjs_SuperDocInlineBoxOptions } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocLayoutEngineOptions as __Cjs_SuperDocLayoutEngineOptions } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocLockedPayload as __Cjs_SuperDocLockedPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocMeasurementUnit as __Cjs_SuperDocMeasurementUnit } from './index.js' with { "resolution-mode": "import" };
@@ -166,6 +170,12 @@ 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" };
@@ -290,6 +300,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 };
@@ -312,6 +323,9 @@ export type { __Cjs_SuperDocFontsApi as SuperDocFontsApi };
 export type { __Cjs_SuperDocGuardedDoc as SuperDocGuardedDoc };
 export type { __Cjs_SuperDocGuardedDocQuery as SuperDocGuardedDocQuery };
 export type { __Cjs_SuperDocGuardedDocSelection as SuperDocGuardedDocSelection };
+export type { __Cjs_SuperDocInlineBoxAppearance as SuperDocInlineBoxAppearance };
+export type { __Cjs_SuperDocInlineBoxLayout as SuperDocInlineBoxLayout };
+export type { __Cjs_SuperDocInlineBoxOptions as SuperDocInlineBoxOptions };
 export type { __Cjs_SuperDocLayoutEngineOptions as SuperDocLayoutEngineOptions };
 export type { __Cjs_SuperDocLockedPayload as SuperDocLockedPayload };
 export type { __Cjs_SuperDocMeasurementUnit as SuperDocMeasurementUnit };
@@ -357,6 +371,12 @@ 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 };

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';
@@ -75,6 +76,12 @@ export type { LayoutMode } from '../../../layout-engine/painters/dom/src/index.j
 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';
@@ -158,6 +165,9 @@ export type { SuperDocExtensionStorage } from '../core/extensions/index.js';
 export type { SuperDocGuardedDoc } from '../core/extensions/index.js';
 export type { SuperDocGuardedDocQuery } from '../core/extensions/index.js';
 export type { SuperDocGuardedDocSelection } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxAppearance } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxLayout } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxOptions } from '../core/extensions/index.js';
 export type { SuperDocMutationAffect } from '../core/extensions/index.js';
 export type { SuperDocMutationEvent } from '../core/extensions/index.js';
 export type { SuperDocMutationFilter } from '../core/extensions/index.js';

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

@@ -356,14 +356,14 @@ export interface ContextMenuItem {
     invoke(): CommandExecutionResult;
 }
 export interface ViewportEntityHit {
-    type: string;
+    type: 'trackedChange' | 'comment' | 'contentControl' | 'citation' | (string & {});
     id: string;
     tag?: string;
     scope?: 'block' | 'inline';
     /**
      * Painted story locator for a tracked-change hit. Meaningful only for
-     * `type: 'trackedChange'`; absent for body-only content and for comment /
-     * content-control hits. Lets point hit-testing disambiguate a tracked-change
+     * `type: 'trackedChange'`; absent for body-only content and for comment,
+     * content-control, and citation hits. Lets point hit-testing disambiguate a tracked-change
      * id that repeats across stories (body, footnote, header/footer, textbox) by
      * resolving to the occurrence actually under the point.
      */
@@ -831,13 +831,25 @@ export type CommentAnchorCapture = {
 };
 /** Comments handle. */
 export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
-    /** Read the current comments snapshot. */
+    /** Read the passive page-window snapshot without starting a document-wide read. Observers receive the complete directory separately. */
     getSnapshot(): CommentsSlice;
     /** List comments through the best-known controller/Document API state. */
     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. */
@@ -881,7 +905,7 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
 }
 /** Track-changes handle. */
 export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSlice> {
-    /** Read the current track-changes snapshot. */
+    /** Read the passive page-window snapshot without starting a document-wide read. Observers receive the complete directory separately. */
     getSnapshot(): TrackChangesSlice;
     /** List tracked changes through the best-known controller state. */
     list(): readonly TrackChangesItem[];

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

@@ -24,7 +24,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
     commentsList: import('vue').Ref<never[], never[]>;
+    reviewDirectoryList: import('vue').ShallowRef<never[], never[]>;
     isCommentsListVisible: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryActive: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryLoading: import('vue').Ref<boolean, boolean>;
     generalCommentIds: import('vue').Ref<never[], never[]>;
     editorCommentIds: import('vue').Ref<never[], never[]>;
     commentsParentElement: import('vue').Ref<null, null>;
@@ -50,6 +53,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         parentComments: any[];
         resolvedComments: any[];
     }>;
+    getGroupedReviewDirectory: import('vue').ComputedRef<{
+        parentComments: any[];
+        resolvedComments: any[];
+    }>;
     hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
     getCommentsByPosition: import('vue').ComputedRef<{
         parentComments: any[];
@@ -146,6 +153,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     removePendingComment: (superdoc: any) => void;
     cancelImportedTrackedChangeBootstrap: (documentId: string | null | undefined) => number;
     removeCommentsForDocument: (documentId: string | null | undefined) => void;
+    setReviewDirectoryFromV2: ({ superdoc, commentItems, trackedChangeItems }?: {
+        commentItems?: never[] | undefined;
+        trackedChangeItems?: never[] | undefined;
+    }) => {
+        ok: boolean;
+        reason: string;
+        count?: undefined;
+    } | {
+        ok: boolean;
+        count: number;
+        reason?: undefined;
+    };
+    clearReviewDirectory: () => void;
     processLoadedDocxComments: ({ superdoc, editor, comments, documentId, replacedFile }: {
         comments: any[];
         documentId: string;
@@ -185,14 +205,7 @@ 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, 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;
-    };
+    applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
     reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
         pruneStale?: boolean | undefined;
@@ -206,13 +219,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
     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, allResolved, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, remappedPairs, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
+        remappedPairs?: never[] | undefined;
     }) => Promise<{
         ok: boolean;
         reason: string;
@@ -221,7 +231,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
@@ -230,22 +240,13 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         allResolved: boolean;
         removedRows: any;
         reason?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
         resolvedIds: never[];
-        unresolvedIds: never[];
-        reason?: undefined;
-        allResolved?: undefined;
-        removedRows?: undefined;
-        failures?: undefined;
-    } | {
-        ok: boolean;
-        items: any[];
-        resolvedIds: (string | null)[];
         unresolvedIds: (string | null)[];
-        failures: any[];
+        removedIds: (string | null)[];
         reason?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
@@ -257,7 +258,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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<{
+}, "suppressInternalExternal" | "activeComment" | "activeFloatingCommentInstanceId" | "floatingCommentsOffset" | "pendingComment" | "currentCommentText" | "isDebugging" | "editingCommentId" | "editorCommentPositions" | "isCommentHighlighted" | "v2CommentsAdapter" | "COMMENT_EVENTS" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "hasInitializedLocations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2TrackedChangesAdapter">, Pick<{
     COMMENT_EVENTS: {
         readonly RESOLVED: "resolved";
         readonly NEW: "new";
@@ -283,7 +284,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
     commentsList: import('vue').Ref<never[], never[]>;
+    reviewDirectoryList: import('vue').ShallowRef<never[], never[]>;
     isCommentsListVisible: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryActive: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryLoading: import('vue').Ref<boolean, boolean>;
     generalCommentIds: import('vue').Ref<never[], never[]>;
     editorCommentIds: import('vue').Ref<never[], never[]>;
     commentsParentElement: import('vue').Ref<null, null>;
@@ -309,6 +313,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         parentComments: any[];
         resolvedComments: any[];
     }>;
+    getGroupedReviewDirectory: import('vue').ComputedRef<{
+        parentComments: any[];
+        resolvedComments: any[];
+    }>;
     hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
     getCommentsByPosition: import('vue').ComputedRef<{
         parentComments: any[];
@@ -405,6 +413,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     removePendingComment: (superdoc: any) => void;
     cancelImportedTrackedChangeBootstrap: (documentId: string | null | undefined) => number;
     removeCommentsForDocument: (documentId: string | null | undefined) => void;
+    setReviewDirectoryFromV2: ({ superdoc, commentItems, trackedChangeItems }?: {
+        commentItems?: never[] | undefined;
+        trackedChangeItems?: never[] | undefined;
+    }) => {
+        ok: boolean;
+        reason: string;
+        count?: undefined;
+    } | {
+        ok: boolean;
+        count: number;
+        reason?: undefined;
+    };
+    clearReviewDirectory: () => void;
     processLoadedDocxComments: ({ superdoc, editor, comments, documentId, replacedFile }: {
         comments: any[];
         documentId: string;
@@ -444,14 +465,7 @@ 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, 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;
-    };
+    applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
     reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
         pruneStale?: boolean | undefined;
@@ -465,13 +479,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
     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, allResolved, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, remappedPairs, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
+        remappedPairs?: never[] | undefined;
     }) => Promise<{
         ok: boolean;
         reason: string;
@@ -480,7 +491,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
@@ -489,22 +500,13 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         allResolved: boolean;
         removedRows: any;
         reason?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
         resolvedIds: never[];
-        unresolvedIds: never[];
-        reason?: undefined;
-        allResolved?: undefined;
-        removedRows?: undefined;
-        failures?: undefined;
-    } | {
-        ok: boolean;
-        items: any[];
-        resolvedIds: (string | null)[];
         unresolvedIds: (string | null)[];
-        failures: any[];
+        removedIds: (string | null)[];
         reason?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
@@ -516,7 +518,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         liveAnchorKeys?: null | undefined;
     }) => any;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-}, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
+}, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
     COMMENT_EVENTS: {
         readonly RESOLVED: "resolved";
         readonly NEW: "new";
@@ -542,7 +544,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
     commentsList: import('vue').Ref<never[], never[]>;
+    reviewDirectoryList: import('vue').ShallowRef<never[], never[]>;
     isCommentsListVisible: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryActive: import('vue').Ref<boolean, boolean>;
+    isReviewDirectoryLoading: import('vue').Ref<boolean, boolean>;
     generalCommentIds: import('vue').Ref<never[], never[]>;
     editorCommentIds: import('vue').Ref<never[], never[]>;
     commentsParentElement: import('vue').Ref<null, null>;
@@ -568,6 +573,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         parentComments: any[];
         resolvedComments: any[];
     }>;
+    getGroupedReviewDirectory: import('vue').ComputedRef<{
+        parentComments: any[];
+        resolvedComments: any[];
+    }>;
     hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
     getCommentsByPosition: import('vue').ComputedRef<{
         parentComments: any[];
@@ -664,6 +673,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     removePendingComment: (superdoc: any) => void;
     cancelImportedTrackedChangeBootstrap: (documentId: string | null | undefined) => number;
     removeCommentsForDocument: (documentId: string | null | undefined) => void;
+    setReviewDirectoryFromV2: ({ superdoc, commentItems, trackedChangeItems }?: {
+        commentItems?: never[] | undefined;
+        trackedChangeItems?: never[] | undefined;
+    }) => {
+        ok: boolean;
+        reason: string;
+        count?: undefined;
+    } | {
+        ok: boolean;
+        count: number;
+        reason?: undefined;
+    };
+    clearReviewDirectory: () => void;
     processLoadedDocxComments: ({ superdoc, editor, comments, documentId, replacedFile }: {
         comments: any[];
         documentId: string;
@@ -703,14 +725,7 @@ 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, 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;
-    };
+    applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
     reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
         preparedInputs?: null | undefined;
         pruneStale?: boolean | undefined;
@@ -724,13 +739,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     setV2TrackedChangesAdapter: (adapter: any) => void;
     getV2TrackedChangesAdapter: (superdoc: any) => any;
     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, allResolved, }?: {
+    reconcileTrackedChangeMutationFromV2: ({ superdoc, adapter, documentId, upsertIds, removedIds, remappedPairs, allResolved, }?: {
         upsertIds?: never[] | undefined;
         removedIds?: never[] | undefined;
+        remappedPairs?: never[] | undefined;
     }) => Promise<{
         ok: boolean;
         reason: string;
@@ -739,7 +751,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         unresolvedIds?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
@@ -748,22 +760,13 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         allResolved: boolean;
         removedRows: any;
         reason?: undefined;
-        failures?: undefined;
+        removedIds?: undefined;
     } | {
         ok: boolean;
         items: never[];
         resolvedIds: never[];
-        unresolvedIds: never[];
-        reason?: undefined;
-        allResolved?: undefined;
-        removedRows?: undefined;
-        failures?: undefined;
-    } | {
-        ok: boolean;
-        items: any[];
-        resolvedIds: (string | null)[];
         unresolvedIds: (string | null)[];
-        failures: any[];
+        removedIds: (string | null)[];
         reason?: undefined;
         allResolved?: undefined;
         removedRows?: undefined;
@@ -775,4 +778,4 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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" | "supersedeV2ReviewHydration" | "reconcileCommentsFromV2" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "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" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "processLoadedDocxComments" | "translateCommentsForExport" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "refreshTrackedChangeCommentsByIds" | "syncResolvedCommentsWithDocument" | "syncTrackedChangePositionsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "syncTrackedChangeComments" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;