superdoc 2.29.0-next.13 → 2.29.0-next.17

package/dist/superdoc/src/stores/helpers/tracked-change-decision.d.ts

@@ -0,0 +1,45 @@
+export type TrackedChangeDecisionRow = {
+    trackedChangeType?: unknown;
+    trackedChangeDisplayType?: unknown;
+    trackedChangeCanonicalId?: unknown;
+    trackedChangeAnchorKey?: unknown;
+};
+export type TrackedChangeReceiptRef = {
+    kind?: unknown;
+    entityType?: unknown;
+    entityId?: unknown;
+};
+export type TrackedChangeDecisionReceipt = {
+    success?: unknown;
+    txId?: unknown;
+    removed?: unknown;
+    invalidatedRefs?: unknown;
+};
+export type TrackedChangeDecisionOutcome = {
+    decidedId?: unknown;
+    decidedIds?: unknown;
+    receipt?: TrackedChangeDecisionReceipt | null;
+};
+export type ActiveTrackedChangeTargetAdapter = {
+    clearActiveTrackedChangeTargetIfMatches?: (decidedId: string) => unknown;
+};
+export type CanonicalPaintHost = {
+    activeEditor?: {
+        documentMutationReadiness?: {
+            whenPainted?: (receipt: TrackedChangeDecisionReceipt) => unknown;
+        } | null;
+    } | null;
+};
+export declare const normalizeTrackedChangeDecisionType: (value: unknown) => string | null;
+export declare const trackedChangeDecisionKeepsCommentAnchor: ({ comment, decision, }?: {
+    comment?: TrackedChangeDecisionRow | null;
+    decision?: unknown;
+}) => boolean;
+export declare const collectTrackedChangeDecisionIdsWithAliases: (comment: TrackedChangeDecisionRow | null | undefined, aliasIds: Iterable<string>) => Set<string>;
+export declare const collectTrackedChangeEntityIdsFromReceipt: (receipt: TrackedChangeDecisionReceipt | null | undefined) => Set<string>;
+export declare const collectReliableDecidedTrackedChangeIds: (outcome: TrackedChangeDecisionOutcome | null | undefined) => Set<string>;
+export declare const clearV2ActiveTrackedChangeTarget: (adapter: ActiveTrackedChangeTargetAdapter | null | undefined, decidedId: string | null | undefined) => void;
+export declare const waitForTrackedDecisionCanonicalPaint: ({ superdoc, receipt, }?: {
+    superdoc?: CanonicalPaintHost | null;
+    receipt?: TrackedChangeDecisionReceipt | null;
+}) => Promise<void>;

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

@@ -120,8 +120,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -441,8 +441,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -762,8 +762,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -990,7 +990,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             appliedCount: number;
         } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "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">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;
@@ -1114,8 +1114,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1435,8 +1435,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1756,8 +1756,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -1984,7 +1984,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             appliedCount: number;
         } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "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">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;
@@ -2108,8 +2108,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -2429,8 +2429,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -2750,8 +2750,8 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             key: null;
             entry: null;
         };
-        getCommentDocumentId: (comment: any) => string | null;
-        belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+        getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+        belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
         viewingVisibility: {
             documentMode: string;
             commentsVisible: boolean;
@@ -2978,7 +2978,7 @@ export declare const useSuperdocStore: import('pinia').StoreDefinition<"superdoc
             appliedCount: number;
         } | undefined;
         remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-    }, "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">>;
+    }, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
     documents: Ref<StoreDocument[], StoreDocument[]>;
     documentBounds: Ref<unknown[], unknown[]>;
     pages: Record<string, PageEntry[]>;