superdoc 2.4.0-next.21 → 2.4.0-next.22

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

@@ -105,15 +105,17 @@ export interface SuperDocSelectionTarget {
     start: SuperDocSelectionPoint;
     end: SuperDocSelectionPoint;
     story?: SuperDocStoryLocator;
+    /** Coordinate space for text endpoint offsets. Omitted means `visible`. */
+    coordinateSpace?: 'visible' | 'tracked';
 }
-/** Locations an extension anchor can be created from. */
+/** Visible-coordinate locations an extension anchor can be created from. */
 export type SuperDocAnchorTarget = SuperDocSelectionTarget | SuperDocTextTarget | SuperDocTextAddress;
 /** Lifecycle status of a {@link SuperDocAnchor}. */
 export type SuperDocAnchorStatus = 'active' | 'stale' | 'disposed' | 'pending';
 /**
- * A session-stable location handle. The runtime remaps anchors as it observes
- * Document API receipts; an anchor that cannot be remapped safely fails closed
- * to `stale` and never silently points at the wrong range.
+ * A session-stable location handle. The runtime rebases anchors from
+ * block-local Document API receipt data; an anchor that cannot be rebased
+ * safely fails closed to `stale` and never silently points at the wrong range.
  */
 export interface SuperDocAnchor {
     readonly id: string;
@@ -171,7 +173,7 @@ export interface SuperDocDecorationProvider {
     id: string;
     provide(context: SuperDocDecorationContext): SuperDocDecoration[];
 }
-export type SuperDocMutationOrigin = 'local' | 'history' | 'extension';
+export type SuperDocMutationOrigin = 'local' | 'history' | 'extension' | 'remote';
 export type SuperDocMutationAffect = 'text' | 'block' | 'comment' | 'trackedChange' | 'bookmark';
 /** Synchronous filter applied before a mutation handler runs. */
 export interface SuperDocMutationFilter {
@@ -390,6 +392,50 @@ export interface SuperDocVisualOptions {
      */
     scope?: 'text' | 'block';
 }
+/**
+ * Layout-affecting inline-box values in non-negative integer CSS pixels.
+ * Padding, gaps, and borders participate in wrapping and pagination.
+ */
+export interface SuperDocInlineBoxLayout {
+    paddingInline?: number | {
+        start: number;
+        end: number;
+    };
+    paddingBlock?: number | {
+        start: number;
+        end: number;
+    };
+    /** Logical spacing outside the range, paid once at each boundary. */
+    gapBefore?: number;
+    gapAfter?: number;
+    /** Border width consumes layout space. */
+    borderWidth?: number;
+}
+/** Paint-only appearance for a layout-aware inline box. */
+export interface SuperDocInlineBoxAppearance {
+    backgroundColor?: string;
+    borderColor?: string;
+    borderStyle?: 'solid' | 'dashed' | 'dotted';
+    borderRadius?: number;
+    color?: string;
+}
+/**
+ * Options for {@link SuperDocVisualApi.inlineBox}. Inline boxes are
+ * render-only and byte-neutral. They currently support LTR visible-text
+ * targets only; unsupported directions and overlapping boxes fail closed.
+ */
+export interface SuperDocInlineBoxOptions {
+    layout?: SuperDocInlineBoxLayout;
+    appearance?: SuperDocInlineBoxAppearance;
+    /** Additive paint-only class. It must not alter geometry. */
+    className?: string;
+    /** Sanitized data attributes stamped on the painted text leaves. */
+    data?: SuperDocDecorationData;
+    /** Paint-only cursor. */
+    cursor?: 'default' | 'pointer' | 'text' | 'help';
+    /** Wrapped ranges clone their box edges on every line. */
+    wrap?: 'clone';
+}
 /**
  * The easy, beginner-facing visual authoring layer exposed as `ctx.visuals`.
  * Backed by the same render-only decoration runtime as
@@ -400,6 +446,13 @@ export interface SuperDocVisualOptions {
  * const risks = ctx.visuals.highlight('risks', { className: 'acme-risk' });
  * const result = await ctx.doc.query.match({ select: { type: 'text', pattern: /risk/i } });
  * risks.replace(result.items.map((item) => item.target));
+ *
+ * const pills = ctx.visuals.inlineBox('citations', {
+ *   layout: { paddingInline: 4, paddingBlock: 2, borderWidth: 1 },
+ *   appearance: { backgroundColor: '#eef4ff', borderColor: '#8aa8d8', borderRadius: 8 },
+ *   cursor: 'pointer',
+ * });
+ * pills.replace(citationTargets);
  * ```
  */
 export interface SuperDocVisualApi {
@@ -407,6 +460,11 @@ export interface SuperDocVisualApi {
     highlight(id: string, options?: SuperDocVisualOptions): SuperDocVisualHandle;
     /** Create a neutral class/data visual layer (synonym of highlight). */
     decorate(id: string, options?: SuperDocVisualOptions): SuperDocVisualHandle;
+    /**
+     * Create a layout-aware box over anchored visible text. Local typing,
+     * undo, and redo rebase its anchors; dispose the returned handle on cleanup.
+     */
+    inlineBox(id: string, options?: SuperDocInlineBoxOptions): SuperDocVisualHandle;
 }
 /** Advanced escape-hatch generic event surface. */
 export interface SuperDocExtensionEventApi {

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

@@ -3195,6 +3195,19 @@ export interface SurfacesConfig {
         autoFocus?: boolean;
     };
 }
+/**
+ * Browser worker asset URLs for deployments where application code and built
+ * SuperDoc assets are served from different origins. Each URL must resolve to
+ * a same-origin module worker served by the embedding application.
+ */
+interface V2WorkerUrlsConfig {
+    /** Main document worker used by non-collaborative v2 documents. */
+    document?: string | URL;
+    /** Collaboration-capable document worker used by v2 collaboration rooms. */
+    collaboration?: string | URL;
+    /** Isolated review-index worker used for comments and tracked changes. */
+    reviewIndex?: string | URL;
+}
 export interface Config {
     /** The ID of the SuperDoc. */
     superdocId?: string;
@@ -3561,6 +3574,12 @@ export interface Config {
      * toolbar shows the baseline and documents render with system fonts.
      */
     fonts?: FontsConfig;
+    /**
+     * Optional same-origin URLs for v2's browser worker assets. Configure these
+     * when the application and SuperDoc bundle are served from different origins.
+     * Omitted entries keep SuperDoc's bundled worker URLs.
+     */
+    workerUrls?: V2WorkerUrlsConfig;
     /**
      * Opt-in toggle for the layout engine. Auto-disabled when web layout is
      * requested without `layoutEngineOptions.flowMode === 'semantic'`; the

package/dist/superdoc/src/core/v2-integration/v2-integration.d.ts

@@ -55,7 +55,7 @@ export function hasRealV2Integration(integration: SuperDocV2Integration | null |
  * @property {unknown} EditorComponent Vue component that boots the V2 DOCX editor.
  * @property {unknown} [RulerComponent] Optional Vue component for the V2 ruler.
  * @property {(...args: unknown[]) => unknown} [createGeometryPublisher] Factory for the V2 geometry publisher.
- * @property {(...args: unknown[]) => unknown} [createReviewHydrationController] Factory for the V2 review-row hydration controller.
+ * @property {(...args: unknown[]) => unknown} [createReviewWindowController] Factory for the committed V2 review-window controller.
  * @property {(value: unknown) => boolean} [isSyntheticTrackedChangeCommentLaneItem] Predicate for synthetic tracked-change comment-lane items.
  * @property {(value: unknown) => boolean} [isV2SyntheticTrackedChangeRow] Predicate for synthesized V2 tracked-change rows.
  */
@@ -83,9 +83,9 @@ export type SuperDocV2Integration = {
      */
     createGeometryPublisher?: ((...args: unknown[]) => unknown) | undefined;
     /**
-     * Factory for the V2 review-row hydration controller.
+     * Factory for the committed V2 review-window controller.
      */
-    createReviewHydrationController?: ((...args: unknown[]) => unknown) | undefined;
+    createReviewWindowController?: ((...args: unknown[]) => unknown) | undefined;
     /**
      * Predicate for synthetic tracked-change comment-lane items.
      */

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

@@ -2,11 +2,9 @@
  * Classify the tracked-change identities carried by a v2 mutation event.
  *
  * Receipt entities are the durable invalidation contract between the document
- * kernel and derived review UI. Consumers can refresh `upsertIds` narrowly via
- * `trackChanges.get(...)`, drop `removedIds` immediately, and leave a bounded
- * full-list reconciliation as background verification. History results are
- * different: undo/redo can restore many identities at once, so consumers use
- * one authoritative catalog after render instead of issuing one read per id.
+ * kernel and derived review UI. Consumers apply removals/remaps locally; the
+ * next committed window supplies surviving or restored rows. History follows
+ * the same bounded path and never enumerates invisible review identities.
  */
 export function getV2TrackedChangeMutationImpact(event: any): {
     allResolved?: any;

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

@@ -122,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" };
@@ -320,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 };

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

@@ -165,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,7 +831,7 @@ 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[];
@@ -905,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, 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;
-    };
+    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, 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;
-    };
+    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, 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;
-    };
+    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">>;