superdoc 2.29.0-next.3 → 2.29.0

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

@@ -40,15 +40,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -66,8 +61,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -89,30 +82,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -122,13 +131,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -217,11 +221,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -255,7 +293,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -284,7 +322,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -304,9 +342,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
+    }, "COMMENT_EVENTS" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -319,15 +361,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -345,8 +382,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -368,30 +403,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -401,13 +452,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -496,11 +542,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -534,7 +614,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -563,7 +643,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -583,9 +663,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
+    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -598,15 +682,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -624,8 +703,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -647,30 +724,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -680,13 +773,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -775,11 +863,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -813,7 +935,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -842,7 +964,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -862,9 +984,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getCommentAliasIds" | "getTrackedChangeThread" | "getCommentPositionKey" | "getCommentPosition" | "resolveCommentPositionEntry" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "getComment" | "setActiveComment" | "getCommentLocation" | "hasOverlapId" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;
@@ -894,7 +1020,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
     getPageBounds: (documentId: string, page: number) => {
         top: number;
     } | undefined;
-}, "user" | "pages" | "isInternal" | "measurementUnit" | "commentsStore" | "documents" | "documentBounds" | "documentUsers" | "users" | "activeZoom" | "zoomMode" | "viewportMetrics" | "documentScroll" | "selectionPosition" | "activeSelection" | "isReady" | "modules">, Pick<{
+}, "user" | "pages" | "isInternal" | "measurementUnit" | "commentsStore" | "modules" | "documents" | "users" | "documentBounds" | "documentUsers" | "activeZoom" | "zoomMode" | "viewportMetrics" | "documentScroll" | "selectionPosition" | "activeSelection" | "isReady">, Pick<{
     commentsStore: import('pinia').Store<"comments", Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
@@ -908,15 +1034,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -934,8 +1055,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -957,30 +1076,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -990,13 +1125,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -1085,11 +1215,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -1123,7 +1287,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -1152,7 +1316,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -1172,9 +1336,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
+    }, "COMMENT_EVENTS" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -1187,15 +1355,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -1213,8 +1376,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -1236,30 +1397,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1269,13 +1446,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -1364,11 +1536,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -1402,7 +1608,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -1431,7 +1637,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -1451,9 +1657,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
+    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -1466,15 +1676,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -1492,8 +1697,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -1515,30 +1718,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1548,13 +1767,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -1643,11 +1857,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -1681,7 +1929,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -1710,7 +1958,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -1730,9 +1978,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getCommentAliasIds" | "getTrackedChangeThread" | "getCommentPositionKey" | "getCommentPosition" | "resolveCommentPositionEntry" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "getComment" | "setActiveComment" | "getCommentLocation" | "hasOverlapId" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;
@@ -1776,15 +2028,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -1802,8 +2049,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -1825,30 +2070,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1858,13 +2119,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -1953,11 +2209,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -1991,7 +2281,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -2020,7 +2310,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -2040,9 +2330,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
+    }, "COMMENT_EVENTS" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -2055,15 +2349,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -2081,8 +2370,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -2104,30 +2391,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -2137,13 +2440,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -2232,11 +2530,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -2270,7 +2602,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -2299,7 +2631,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -2319,9 +2651,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getCommentsByPosition" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
+    }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getGroupedReviewDirectory" | "hasOpenTrackedChanges" | "getFloatingComments" | "getFloatingCommentInstances" | "isViewingMode" | "shouldRenderReviewInViewing">, Pick<{
         COMMENT_EVENTS: {
             readonly RESOLVED: "resolved";
             readonly NEW: "new";
@@ -2334,15 +2670,10 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             readonly CHANGE_ACCEPTED: "change-accepted";
             readonly CHANGE_REJECTED: "change-rejected";
         };
-        isDebugging: boolean;
-        hasInitializedComments: Ref<boolean, boolean>;
         hasSyncedCollaborationComments: Ref<boolean, boolean>;
         editingCommentId: Ref<null, null>;
         activeComment: Ref<null, null>;
         activeFloatingCommentInstanceId: Ref<null, null>;
-        commentDialogs: Ref<never[], never[]>;
-        overlappingComments: Ref<never[], never[]>;
-        overlappedIds: Set<never>;
         suppressInternalExternal: Ref<boolean, boolean>;
         pendingComment: Ref<null, null>;
         currentCommentText: Ref<string, string>;
@@ -2360,8 +2691,6 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         isCommentHighlighted: Ref<boolean, boolean>;
         floatingCommentsOffset: Ref<number, number>;
         committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-        sortedConversations: Ref<never[], never[]>;
-        visibleConversations: Ref<never[], never[]>;
         skipSelectionUpdate: Ref<boolean, boolean>;
         isFloatingCommentsReady: Ref<boolean, boolean>;
         instantSidebarAlignmentTargetY: Ref<null, null>;
@@ -2383,30 +2712,46 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedComments: any[];
         }>;
         hasOpenTrackedChanges: import('vue').ComputedRef<boolean>;
-        getCommentsByPosition: import('vue').ComputedRef<{
-            parentComments: any[];
-            resolvedComments: any[];
-        }>;
         getFloatingComments: import('vue').ComputedRef<any[]>;
         getFloatingCommentInstances: import('vue').ComputedRef<{
-            id: any;
-            threadId: any;
+            id: string;
+            threadId: string | null;
             comment: any;
-            positionKey: any;
-            pageIndex: any;
+            positionKey: string | null;
+            positionEntry: {
+                pageIndex?: number | null;
+                rects?: readonly ({
+                    pageIndex?: number | null;
+                    left?: number;
+                    top?: number;
+                    right?: number;
+                    bottom?: number;
+                } | null | undefined)[] | null;
+                bounds?: Partial<{
+                    left: number;
+                    top: number;
+                    right: number;
+                    bottom: number;
+                    width: number;
+                    height: number;
+                }> | null;
+            } | null;
+            pageIndex: number | null;
             isPrimary: boolean;
-            positionEntry: any;
         }[]>;
-        getCommentAliasIds: (commentOrId: any) => (string | null)[];
+        getCommentAliasIds: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined) => string[];
         getTrackedChangeThread: (parentComment: any) => any[] | readonly never[];
-        getCommentPositionKey: (commentOrId: Object | string | null | undefined) => string | null;
+        getCommentPositionKey: (commentOrId: import('./helpers/comment-identity.js').CommentIdentityRow | string | null | undefined) => unknown;
         getCommentPosition: (commentOrId: Object | string) => Object | null;
-        resolveCommentPositionEntry: (commentOrId: any, preferredId: any) => {
-            key: string | null;
-            entry: any;
+        resolveCommentPositionEntry: (commentOrId: string | number | import('./helpers/comment-identity.js').CommentIdentityRow | null | undefined, preferredId?: unknown) => {
+            key: string;
+            entry: import('./helpers/comment-identity.js').CommentPositionEntry;
+        } | {
+            key: null;
+            entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -2416,13 +2761,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         shouldRenderReviewInViewing: import('vue').ComputedRef<boolean>;
         init: (config?: Object) => void;
         setViewingVisibility: ({ documentMode, commentsVisible, trackChangesVisible }?: {}) => void;
-        getComment: (id: string) => Record<string, unknown> | null | undefined;
+        getComment: (id: unknown) => import('./helpers/comment-identity.js').CommentIdentityRow | null;
         setActiveComment: (superdoc: Object | undefined | null, id: string | undefined | null) => void;
-        getCommentLocation: (selection: any, parent: any) => {
-            top: any;
-            left: any;
-        };
-        hasOverlapId: (id: any) => any;
         getPendingComment: ({ selection, documentId, parentCommentId, ...options }: {
             selection?: Object | undefined;
             documentId?: string | null | undefined;
@@ -2511,11 +2851,45 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         v2CommentsAdapter: import('vue').ShallowRef<null, null>;
         setV2CommentsAdapter: (adapter: any) => void;
         getV2CommentsAdapter: (superdoc: any) => any;
-        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => any;
+        applyReviewWindowFromV2: ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch, }?: {}) => {
+            ok: boolean;
+            geometryOnly: boolean;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            commentItems: any;
+            trackedItems: any;
+            geometryOnly?: undefined;
+            reason?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+            detail?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            detail: any;
+            geometryOnly?: undefined;
+            commentItems?: undefined;
+            trackedItems?: undefined;
+        };
         reconcileCommentsFromV2: ({ superdoc, adapter, documentId, items, preparedInputs, pruneStale, hydrationGeneration, }?: {
             preparedInputs?: null | undefined;
             pruneStale?: boolean | undefined;
-        }) => any;
+        }) => {
+            added: null;
+            dropped: string;
+        } | {
+            added: any;
+            dropped?: undefined;
+        };
         announceV2CommentCreated: ({ superdoc, commentId }?: {}) => Promise<{
             ok: boolean;
             reason: string;
@@ -2549,7 +2923,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
                 kind: "trackedChange";
                 trackedChangeId: string;
                 story?: unknown;
-                side?: "source" | "destination";
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
             } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -2578,7 +2952,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             resolvedIds: never[];
             unresolvedIds: never[];
             allResolved: boolean;
-            removedRows: any;
+            removedRows: number;
             reason?: undefined;
             removedIds?: undefined;
         } | {
@@ -2598,9 +2972,13 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             previousPreparedPresentation?: null | undefined;
             liveIds?: null | undefined;
             liveAnchorKeys?: null | undefined;
-        }) => any;
+        }) => {
+            liveIds: Set<any>;
+            liveAnchorKeys: Set<any>;
+            appliedCount: number;
+        } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "getCommentAliasIds" | "getTrackedChangeThread" | "getCommentPositionKey" | "getCommentPosition" | "resolveCommentPositionEntry" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "getComment" | "setActiveComment" | "getCommentLocation" | "hasOverlapId" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;