superdoc 2.29.0-next.1 → 2.29.0-next.13

package/dist/superdoc/src/public/ui/entity-at.d.ts

@@ -8,7 +8,7 @@ import { ViewportEntityHit } from './types.js';
  * fresh). Kept off the public {@link ViewportEntityHit} so consumers still only
  * switch on the typed public shape.
  */
-export interface CollectedEntityHit extends ViewportEntityHit {
+interface CollectedEntityHit extends ViewportEntityHit {
     storyKey?: string;
 }
 export declare function collectDecorationProvidersFromChain(start: Element | null, stopAt: Element): string[];
@@ -28,3 +28,4 @@ export declare function collectDecorationProvidersFromChain(start: Element | nul
  * browser) without an `instanceof` check that could fail across realms.
  */
 export declare function collectEntityHitsFromChain(start: Element | null, stopAt?: Element | null): CollectedEntityHit[];
+export {};

package/dist/superdoc/src/public/ui/format-painter-helpers.d.ts

@@ -2,22 +2,16 @@
  * Maps SDRunProps field names to InlineRunPatch field names.
  * SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
  * for the same properties; direct assignment between them is forbidden.
- *
- * @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
- * @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
  */
-export function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
+export declare function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
 /**
  * Serializes a selection to a stable string key used to detect whether
  * the target selection is the same as the source (skip apply in that case).
  *
  * Falls back to the plain text target when the host has not populated an
  * explicit `selectionTarget` yet.
- *
- * @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
- * @returns {string}
  */
-export function selectionKey(selection: {
+export declare function selectionKey(selection: {
     selectionTarget?: unknown;
     target?: unknown;
 } | null | undefined): string;

package/dist/superdoc/src/public/ui/style-match-patch.d.ts

@@ -1,7 +1,7 @@
 import { FormatReadSelectionResult, InlineRunPatchKey, StylesStyleRunPatch } from '../../../../document-api/src/index.js';
-export declare const STYLE_MATCH_KEYS: readonly [readonly ["bold", "bold"], readonly ["italic", "italic"], readonly ["underline", "underline"], readonly ["color", "color"], readonly ["fontSize", "fontSize"], readonly ["rFonts", "fontFamily"]];
 export declare const STYLE_MATCH_READ_KEYS: InlineRunPatchKey[];
-export interface StyleMatchPatchOptions {
+interface StyleMatchPatchOptions {
     selectionUsesStyle: boolean;
 }
 export declare function buildStyleMatchPatch(effective: FormatReadSelectionResult, direct: FormatReadSelectionResult, options: StyleMatchPatchOptions): StylesStyleRunPatch;
+export {};

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

@@ -31,7 +31,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, DocumentApiRejectionReason, DocumentApiRejectionDetails, TextRangeRejectionReason, ContentControlCreationRejectionReason, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, BookmarkAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, TemporaryMutationOperation, TemporaryOperationResultTarget, TemporaryOperationEffects, TemporaryMutationInput, TemporaryMutationReplaceInput, TemporaryMutationHandleInput, TemporaryMutationReceipt, StoryLocator as DocumentStoryLocator, OperationId, OperationCall, OperationInput, OperationOptions, OperationOutput, } from '../../../../document-api/src/index.js';
+export type { Receipt, DocumentApiRejectionReason, DocumentApiRejectionDetails, TextRangeRejectionReason, ContentControlCreationRejectionReason, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, BookmarkAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, TemporaryMutationOperation, TemporaryOperationResultTarget, TemporaryOperationEffects, TemporaryMutationInput, TemporaryMutationReplaceInput, TemporaryMutationHandleInput, TemporaryMutationReceipt, StoryLocator as DocumentStoryLocator, OperationId, OperationCall, OperationInput, OperationOptions, OperationOutput, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';

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,13 +102,8 @@ 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 | undefined;
         documentId?: string | null | undefined;
@@ -188,11 +192,45 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -226,7 +264,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
             kind: "trackedChange";
             trackedChangeId: string;
             story?: unknown;
-            side?: "source" | "destination";
+            side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
         } | undefined;
     }) => Promise<any>;
     editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -255,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;
     } | {
@@ -275,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;
-}, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
+}, "COMMENT_EVENTS" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "activeFloatingCommentInstanceId" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "currentCommentMentions" | "commentsList" | "reviewDirectoryList" | "isCommentsListVisible" | "isReviewDirectoryActive" | "isReviewDirectoryLoading" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "committedReviewPresentations" | "skipSelectionUpdate" | "isFloatingCommentsReady" | "instantSidebarAlignmentTargetY" | "instantSidebarAlignmentThreadId" | "instantSidebarAlignmentInstanceId" | "viewingVisibility" | "v2CommentsAdapter" | "v2TrackedChangesAdapter">, Pick<{
     COMMENT_EVENTS: {
         readonly RESOLVED: "resolved";
         readonly NEW: "new";
@@ -290,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>;
@@ -316,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>;
@@ -339,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;
@@ -372,13 +423,8 @@ 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 | undefined;
         documentId?: string | null | undefined;
@@ -467,11 +513,45 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -505,7 +585,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
             kind: "trackedChange";
             trackedChangeId: string;
             story?: unknown;
-            side?: "source" | "destination";
+            side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
         } | undefined;
     }) => Promise<any>;
     editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -534,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;
     } | {
@@ -554,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";
@@ -569,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>;
@@ -595,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>;
@@ -618,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;
@@ -651,13 +744,8 @@ 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 | undefined;
         documentId?: string | null | undefined;
@@ -746,11 +834,45 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
     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;
@@ -784,7 +906,7 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
             kind: "trackedChange";
             trackedChangeId: string;
             story?: unknown;
-            side?: "source" | "destination";
+            side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup;
         } | undefined;
     }) => Promise<any>;
     editCommentV2: ({ superdoc, commentId, text }?: {}) => Promise<any>;
@@ -813,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;
     } | {
@@ -833,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">>;

package/dist/superdoc/src/stores/helpers/comment-draft-text.d.ts

@@ -0,0 +1 @@
+export declare const normalizeV2CommentDraftText: (value: unknown) => string;

package/dist/superdoc/src/stores/helpers/comment-grouping.d.ts

@@ -0,0 +1,30 @@
+type CommentId = string | number;
+export type GroupableComment = {
+    commentId: CommentId;
+    fileId?: CommentId | null;
+    parentCommentId?: CommentId | null;
+    threadingParentCommentId?: CommentId | null;
+    trackedChange?: boolean;
+    trackedChangeCanonicalId?: CommentId | null;
+    trackedChangeSide?: string | null;
+    trackedChangeParentId?: CommentId | null;
+    trackedChangeThreadParentId?: CommentId | null;
+    semanticColorKey?: string | null;
+    createdTime?: number | null;
+    resolvedTime?: number | null;
+};
+type GroupedComments<Comment> = {
+    parentComments: Comment[];
+    resolvedComments: Comment[];
+};
+type CommittedReviewPresentation = {
+    groupOrder: {
+        open: readonly CommentId[];
+        resolved: readonly CommentId[];
+    };
+};
+type CommittedReviewPresentations = Readonly<Record<string, CommittedReviewPresentation>>;
+export declare const groupComments: <Comment extends GroupableComment>(source: readonly Comment[], isVisible: (comment: Comment) => boolean) => GroupedComments<Comment>;
+export declare const groupCommittedComments: <Comment extends GroupableComment>(comments: readonly Comment[], presentations: CommittedReviewPresentations, isVisible: (comment: Comment) => boolean) => GroupedComments<Comment>;
+export declare const hasOpenTrackedChange: ({ parentComments }: GroupedComments<GroupableComment>) => boolean;
+export {};