superdoc 2.28.0 → 2.29.0-next.13

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

@@ -11,15 +11,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         readonly CHANGE_ACCEPTED: "change-accepted";
         readonly CHANGE_REJECTED: "change-rejected";
     };
-    isDebugging: boolean;
-    hasInitializedComments: import('vue').Ref<boolean, boolean>;
     hasSyncedCollaborationComments: import('vue').Ref<boolean, boolean>;
     editingCommentId: import('vue').Ref<null, null>;
     activeComment: import('vue').Ref<null, null>;
     activeFloatingCommentInstanceId: import('vue').Ref<null, null>;
-    commentDialogs: import('vue').Ref<never[], never[]>;
-    overlappingComments: import('vue').Ref<never[], never[]>;
-    overlappedIds: Set<never>;
     suppressInternalExternal: import('vue').Ref<boolean, boolean>;
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
@@ -37,8 +32,6 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     isCommentHighlighted: import('vue').Ref<boolean, boolean>;
     floatingCommentsOffset: import('vue').Ref<number, number>;
     committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-    sortedConversations: import('vue').Ref<never[], never[]>;
-    visibleConversations: import('vue').Ref<never[], never[]>;
     skipSelectionUpdate: import('vue').Ref<boolean, boolean>;
     isFloatingCommentsReady: import('vue').Ref<boolean, boolean>;
     instantSidebarAlignmentTargetY: import('vue').Ref<null, null>;
@@ -60,27 +53,43 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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;
@@ -93,31 +102,46 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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<typeof useComment>;
     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;
@@ -154,16 +178,59 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -186,7 +253,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     };
     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>;
@@ -214,7 +293,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         resolvedIds: never[];
         unresolvedIds: never[];
         allResolved: boolean;
-        removedRows: any;
+        removedRows: number;
         reason?: undefined;
         removedIds?: undefined;
     } | {
@@ -234,9 +313,13 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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";
@@ -249,15 +332,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         readonly CHANGE_ACCEPTED: "change-accepted";
         readonly CHANGE_REJECTED: "change-rejected";
     };
-    isDebugging: boolean;
-    hasInitializedComments: import('vue').Ref<boolean, boolean>;
     hasSyncedCollaborationComments: import('vue').Ref<boolean, boolean>;
     editingCommentId: import('vue').Ref<null, null>;
     activeComment: import('vue').Ref<null, null>;
     activeFloatingCommentInstanceId: import('vue').Ref<null, null>;
-    commentDialogs: import('vue').Ref<never[], never[]>;
-    overlappingComments: import('vue').Ref<never[], never[]>;
-    overlappedIds: Set<never>;
     suppressInternalExternal: import('vue').Ref<boolean, boolean>;
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
@@ -275,8 +353,6 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     isCommentHighlighted: import('vue').Ref<boolean, boolean>;
     floatingCommentsOffset: import('vue').Ref<number, number>;
     committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-    sortedConversations: import('vue').Ref<never[], never[]>;
-    visibleConversations: import('vue').Ref<never[], never[]>;
     skipSelectionUpdate: import('vue').Ref<boolean, boolean>;
     isFloatingCommentsReady: import('vue').Ref<boolean, boolean>;
     instantSidebarAlignmentTargetY: import('vue').Ref<null, null>;
@@ -298,27 +374,43 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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;
@@ -331,31 +423,46 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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<typeof useComment>;
     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;
@@ -392,16 +499,59 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -424,7 +574,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     };
     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>;
@@ -452,7 +614,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         resolvedIds: never[];
         unresolvedIds: never[];
         allResolved: boolean;
-        removedRows: any;
+        removedRows: number;
         reason?: undefined;
         removedIds?: undefined;
     } | {
@@ -472,9 +634,13 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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";
@@ -487,15 +653,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         readonly CHANGE_ACCEPTED: "change-accepted";
         readonly CHANGE_REJECTED: "change-rejected";
     };
-    isDebugging: boolean;
-    hasInitializedComments: import('vue').Ref<boolean, boolean>;
     hasSyncedCollaborationComments: import('vue').Ref<boolean, boolean>;
     editingCommentId: import('vue').Ref<null, null>;
     activeComment: import('vue').Ref<null, null>;
     activeFloatingCommentInstanceId: import('vue').Ref<null, null>;
-    commentDialogs: import('vue').Ref<never[], never[]>;
-    overlappingComments: import('vue').Ref<never[], never[]>;
-    overlappedIds: Set<never>;
     suppressInternalExternal: import('vue').Ref<boolean, boolean>;
     pendingComment: import('vue').Ref<null, null>;
     currentCommentText: import('vue').Ref<string, string>;
@@ -513,8 +674,6 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     isCommentHighlighted: import('vue').Ref<boolean, boolean>;
     floatingCommentsOffset: import('vue').Ref<number, number>;
     committedReviewPresentations: import('vue').ShallowRef<{}, {}>;
-    sortedConversations: import('vue').Ref<never[], never[]>;
-    visibleConversations: import('vue').Ref<never[], never[]>;
     skipSelectionUpdate: import('vue').Ref<boolean, boolean>;
     isFloatingCommentsReady: import('vue').Ref<boolean, boolean>;
     instantSidebarAlignmentTargetY: import('vue').Ref<null, null>;
@@ -536,27 +695,43 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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;
@@ -569,31 +744,46 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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<typeof useComment>;
     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;
@@ -630,16 +820,59 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -662,7 +895,19 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     };
     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>;
@@ -690,7 +935,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         resolvedIds: never[];
         unresolvedIds: never[];
         allResolved: boolean;
-        removedRows: any;
+        removedRows: number;
         reason?: undefined;
         removedIds?: undefined;
     } | {
@@ -710,6 +955,10 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         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">>;