superdoc 2.28.0 → 2.29.0-next.13

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,27 +82,43 @@ 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;
@@ -122,31 +131,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -183,16 +207,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -215,7 +282,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -243,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;
         } | {
@@ -263,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;
-    }, "suppressInternalExternal" | "activeComment" | "activeFloatingCommentInstanceId" | "floatingCommentsOffset" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "isDebugging" | "editingCommentId" | "editorCommentPositions" | "isCommentHighlighted" | "v2CommentsAdapter" | "COMMENT_EVENTS" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "hasInitializedLocations" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "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";
@@ -278,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>;
@@ -304,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>;
@@ -327,27 +403,43 @@ 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;
@@ -360,31 +452,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -421,16 +528,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -453,7 +603,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -481,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;
         } | {
@@ -501,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";
@@ -516,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>;
@@ -542,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>;
@@ -565,27 +724,43 @@ 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;
@@ -598,31 +773,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -659,16 +849,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -691,7 +924,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -719,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;
         } | {
@@ -739,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" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "belongsToDocument" | "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[]>;
@@ -771,7 +1020,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
     getPageBounds: (documentId: string, page: number) => {
         top: number;
     } | undefined;
-}, "user" | "pages" | "isInternal" | "users" | "measurementUnit" | "isReady" | "activeZoom" | "zoomMode" | "viewportMetrics" | "documents" | "commentsStore" | "documentBounds" | "documentUsers" | "documentScroll" | "selectionPosition" | "activeSelection" | "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";
@@ -785,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>;
@@ -811,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>;
@@ -834,27 +1076,43 @@ 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;
@@ -867,31 +1125,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -928,16 +1201,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -960,7 +1276,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -988,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;
         } | {
@@ -1008,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;
-    }, "suppressInternalExternal" | "activeComment" | "activeFloatingCommentInstanceId" | "floatingCommentsOffset" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "isDebugging" | "editingCommentId" | "editorCommentPositions" | "isCommentHighlighted" | "v2CommentsAdapter" | "COMMENT_EVENTS" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "hasInitializedLocations" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "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";
@@ -1023,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>;
@@ -1049,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>;
@@ -1072,27 +1397,43 @@ 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;
@@ -1105,31 +1446,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -1166,16 +1522,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -1198,7 +1597,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -1226,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;
         } | {
@@ -1246,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";
@@ -1261,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>;
@@ -1287,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>;
@@ -1310,27 +1718,43 @@ 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;
@@ -1343,31 +1767,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -1404,16 +1843,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -1436,7 +1918,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -1464,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;
         } | {
@@ -1484,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" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "belongsToDocument" | "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[]>;
@@ -1530,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>;
@@ -1556,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>;
@@ -1579,27 +2070,43 @@ 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;
@@ -1612,31 +2119,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -1673,16 +2195,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -1705,7 +2270,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -1733,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;
         } | {
@@ -1753,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;
-    }, "suppressInternalExternal" | "activeComment" | "activeFloatingCommentInstanceId" | "floatingCommentsOffset" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "isDebugging" | "editingCommentId" | "editorCommentPositions" | "isCommentHighlighted" | "v2CommentsAdapter" | "COMMENT_EVENTS" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "hasInitializedLocations" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "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";
@@ -1768,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>;
@@ -1794,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>;
@@ -1817,27 +2391,43 @@ 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;
@@ -1850,31 +2440,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -1911,16 +2516,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -1943,7 +2591,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -1971,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;
         } | {
@@ -1991,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";
@@ -2006,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>;
@@ -2032,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>;
@@ -2055,27 +2712,43 @@ 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;
@@ -2088,31 +2761,46 @@ 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;
-            documentId: string;
-            parentCommentId: string;
-        }) => Object;
+            selection?: Object | undefined;
+            documentId?: string | null | undefined;
+            parentCommentId?: string | null | undefined;
+        }) => ReturnType<any>;
         showAddComment: (superdoc: any, targetClientY?: null) => any;
         addComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         addHydratedComment: ({ superdoc, comment, skipEditorUpdate, broadcastChanges }: {
             superdoc: any;
             comment: any;
             skipEditorUpdate?: boolean | undefined;
             broadcastChanges?: boolean | undefined;
-        }) => void;
+        }) => {
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        } | Promise<{
+            ok: boolean;
+            reason?: string;
+            detail?: string;
+            code?: string;
+        }>;
         cancelComment: (superdoc: any) => void;
         deleteComment: ({ commentId: commentIdToDelete, superdoc }: {
             commentId: any;
@@ -2149,16 +2837,59 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         clearInstantSidebarAlignment: () => void;
         decideTrackedChangeFromSidebar: ({ superdoc, comment, decision }: {
             superdoc: Object;
-            editor: Object;
-        }) => void;
+            comment: Object;
+            decision: string;
+        }) => {
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        } | Promise<{
+            ok: boolean;
+            success?: boolean;
+            reason?: string;
+        }>;
         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;
@@ -2181,7 +2912,19 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
         };
         isV2EditorActive: (superdoc: any) => boolean;
         replyCommentV2: ({ superdoc, parentCommentId, text, mentions, trackedChangeTarget }?: {
-            mentions?: never[] | undefined;
+            superdoc?: Object | undefined;
+            parentCommentId?: string | null | undefined;
+            text?: string | undefined;
+            mentions?: {
+                name?: string | null;
+                email?: string | null;
+            }[] | undefined;
+            trackedChangeTarget?: {
+                kind: "trackedChange";
+                trackedChangeId: string;
+                story?: unknown;
+                side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
+            } | undefined;
         }) => Promise<any>;
         editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
         resolveCommentV2: ({ superdoc, commentId }?: {}) => Promise<any>;
@@ -2209,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;
         } | {
@@ -2229,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" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "belongsToDocument" | "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[]>;