superdoc 2.29.0-next.9 → 2.30.0-next.4

package/dist/superdoc/src/components/Whiteboard/whiteboard-types.d.ts

@@ -1,4 +1,5 @@
 import { Whiteboard } from '../../core/whiteboard/Whiteboard.js';
+import { WhiteboardPage } from '../../core/whiteboard/WhiteboardPage.js';
 export type WhiteboardPageSize = {
     width: number;
     height: number;
@@ -9,3 +10,4 @@ export type WhiteboardPageOffset = {
     left: number;
 };
 export type WhiteboardDropTarget = Pick<Whiteboard, 'getTool' | 'getType'>;
+export type WhiteboardPageView = Pick<WhiteboardPage, 'pageIndex' | 'size' | 'mount' | 'resize' | 'destroy' | 'addImage' | 'addText'>;

package/dist/superdoc/src/components/surfaces/watermark-surface-runtime.d.ts

@@ -1,8 +1,8 @@
-/** The runtime owns its Vue component; consumers only need the surface request value. */
-export function createWatermarkSurfaceRuntime(getContainer?: () => HTMLElement | null): {
-  component: unknown;
-  captureFocusReturn(): (isCurrent: () => boolean) => Promise<void>;
-  mount(): void;
-  announce(message: string): void;
-  destroy(): void;
+/** Keeps Vue rendering and post-dismissal announcements outside the public type graph. */
+export declare function createWatermarkSurfaceRuntime(getContainer?: () => HTMLElement | null): {
+    component: unknown;
+    captureFocusReturn(): (isCurrent: () => boolean) => Promise<void>;
+    mount(): void;
+    announce(message: string): void;
+    destroy(): void;
 };

package/dist/superdoc/src/composables/use-comment-small-screen.d.ts

@@ -1,10 +1,14 @@
-export function useCommentSmallScreen({ commentsModuleConfig, superdocRoot, layers }: {
-    commentsModuleConfig: any;
-    superdocRoot: any;
-    layers: any;
-}): {
-    superdocContainerWidth: import('vue').Ref<number, number>;
-    isCompactCommentsMode: import('vue').Ref<boolean, boolean>;
+import { Ref } from 'vue';
+import { CommentsConfig } from '../core/types/index.js';
+interface UseCommentSmallScreenOptions {
+    commentsModuleConfig: Readonly<Ref<CommentsConfig | null | undefined>>;
+    superdocRoot: Readonly<Ref<HTMLElement | null>>;
+    layers: Readonly<Ref<HTMLElement | null>>;
+}
+export declare function useCommentSmallScreen({ commentsModuleConfig, superdocRoot, layers }: UseCommentSmallScreenOptions): {
+    superdocContainerWidth: Ref<number, number>;
+    isCompactCommentsMode: Ref<boolean, boolean>;
     recalculateCompactCommentsMode: () => void;
     ensureCompactMeasurementObserver: () => void;
 };
+export {};

package/dist/superdoc/src/composables/use-compact-comment-popover.d.ts

@@ -1,21 +1,47 @@
-export function useCompactCommentPopover({ activeComment, pendingComment, activeCompactComment, showCommentsSidebar, selectionPosition, activeZoom, superdocRoot, layers, documents, resolveCommentPositionEntry, clearActiveComment, clearPendingComment, }: {
-    activeComment: any;
-    pendingComment: any;
-    activeCompactComment: any;
-    showCommentsSidebar: any;
-    selectionPosition: any;
-    activeZoom: any;
-    superdocRoot: any;
-    layers: any;
-    documents: any;
-    resolveCommentPositionEntry: any;
-    clearActiveComment: any;
-    clearPendingComment: any;
-}): {
-    compactCommentPopoverStyle: import('vue').ComputedRef<{
-        top: string;
-        right: string;
-    }>;
+import { Ref } from 'vue';
+import { RuntimeDocument } from '../core/types/index.js';
+type CompactComment = {
+    commentId?: unknown;
+    importedId?: unknown;
+    selection?: {
+        source?: unknown;
+    } | null;
+};
+type CompactSelectionPosition = {
+    top?: unknown;
+    bottom?: unknown;
+    source?: unknown;
+};
+type CommentPositionLookup = (commentOrId: unknown) => {
+    entry: {
+        bounds?: {
+            top?: unknown;
+            bottom?: unknown;
+        } | null;
+    } | null;
+};
+type PopoverStyle = {
+    top: string;
+    left?: string;
+    right: string;
+};
+interface UseCompactCommentPopoverOptions {
+    activeComment: Readonly<Ref<unknown>>;
+    pendingComment: Readonly<Ref<CompactComment | null | undefined>>;
+    activeCompactComment: Readonly<Ref<CompactComment | null | undefined>>;
+    showCommentsSidebar: Readonly<Ref<unknown>>;
+    selectionPosition: Readonly<Ref<CompactSelectionPosition | null | undefined>>;
+    activeZoom: Readonly<Ref<number | null | undefined>>;
+    superdocRoot: Readonly<Ref<HTMLElement | null>>;
+    layers: Readonly<Ref<HTMLElement | null>>;
+    documents: Readonly<Ref<readonly Pick<RuntimeDocument, 'type'>[] | null | undefined>>;
+    resolveCommentPositionEntry: CommentPositionLookup;
+    clearActiveComment: () => void;
+    clearPendingComment: () => void;
+}
+export declare function useCompactCommentPopover({ activeComment, pendingComment, activeCompactComment, showCommentsSidebar, selectionPosition, activeZoom, superdocRoot, layers, documents, resolveCommentPositionEntry, clearActiveComment, clearPendingComment, }: UseCompactCommentPopoverOptions): {
+    compactCommentPopoverStyle: import('vue').ComputedRef<PopoverStyle>;
     closeCompactCommentPopover: () => void;
     resetClickAnchor: () => void;
 };
+export {};

package/dist/superdoc/src/composables/use-document.d.ts

@@ -305,7 +305,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         trackedChangeAnchorKey: string | null;
         trackedChangeCanonicalId: string | null;
         trackedChangePositionAliases: string[];
-        trackedChangeDecision: ("accept" | "reject") | null;
+        trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
         trackedChangeLabel: string | null;
         trackedChangeDetailLines: {
             excerpt: string;
@@ -313,13 +313,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         }[] | null;
         trackedChangeImagePreview: {
             src: string;
-            contentType: string;
-            role: "deleted" | "inserted" | "before" | "after";
-            partUri?: string | undefined;
-            relationshipId?: string | undefined;
+            contentType?: string | undefined;
+            role?: string | undefined;
             width?: number | undefined;
             height?: number | undefined;
-            alt?: string | undefined;
+            alt: string;
         } | null;
         customAttributes: readonly {
             name: string;
@@ -338,7 +336,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         docxCommentJSON: {} | null;
         origin: "word" | "google-docs" | "unknown" | undefined;
         threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-        threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+        threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
         threadingParentCommentId: string | null | undefined;
         originalXmlStructure: {
             hasCommentsExtended: boolean;
@@ -349,7 +347,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc?: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -371,7 +369,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -443,7 +441,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             trackedChangeAnchorKey: string | null;
             trackedChangeCanonicalId: string | null;
             trackedChangePositionAliases: string[];
-            trackedChangeDecision: ("accept" | "reject") | null;
+            trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
             trackedChangeLabel: string | null;
             trackedChangeDetailLines: {
                 excerpt: string;
@@ -451,13 +449,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             }[] | null;
             trackedChangeImagePreview: {
                 src: string;
-                contentType: string;
-                role: "deleted" | "inserted" | "before" | "after";
-                partUri?: string | undefined;
-                relationshipId?: string | undefined;
+                contentType?: string | undefined;
+                role?: string | undefined;
                 width?: number | undefined;
                 height?: number | undefined;
-                alt?: string | undefined;
+                alt: string;
             } | null;
             customAttributes: readonly {
                 name: string;
@@ -472,7 +468,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             resolvedByName: string | null | undefined;
             origin: "word" | "google-docs" | "unknown" | undefined;
             threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-            threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+            threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
             threadingParentCommentId: string | null | undefined;
             originalXmlStructure: {
                 hasCommentsExtended: boolean;
@@ -486,7 +482,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             name?: string | null;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -503,7 +499,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
                     modules?: import('../public/index.js').Modules;
                 };
             };
-            decision?: "accept" | "reject";
+            decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
             reconciliationToken?: symbol;
         }) => {
             ok: false;
@@ -513,7 +509,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             isInternal: boolean;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -534,12 +530,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             ok: false;
             reason: "read-only-document";
         } | undefined;
-        updatePosition: (coords: {
-            top: number;
-            left: number;
-            right: number;
-            bottom: number;
-        }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
+        updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
         getCommentUser: () => {
             name: string;
             email: string | null | undefined;
@@ -551,14 +542,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             email: string | null;
             image: string | null;
         };
-        updateIdentityValues: (updates?: {
-            commentId?: string;
-            importedId?: string | null;
-            parentCommentId?: string | null;
-            trackedChangeParentId?: string | null;
-            trackedChangeThreadParentId?: string | null;
-            threadingParentCommentId?: string | null;
-        }) => void;
+        updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
     }[], {
         uid: string | undefined;
         commentId: string;
@@ -628,7 +612,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         trackedChangeAnchorKey: string | null;
         trackedChangeCanonicalId: string | null;
         trackedChangePositionAliases: string[];
-        trackedChangeDecision: ("accept" | "reject") | null;
+        trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
         trackedChangeLabel: string | null;
         trackedChangeDetailLines: {
             excerpt: string;
@@ -636,13 +620,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         }[] | null;
         trackedChangeImagePreview: {
             src: string;
-            contentType: string;
-            role: "deleted" | "inserted" | "before" | "after";
-            partUri?: string | undefined;
-            relationshipId?: string | undefined;
+            contentType?: string | undefined;
+            role?: string | undefined;
             width?: number | undefined;
             height?: number | undefined;
-            alt?: string | undefined;
+            alt: string;
         } | null;
         customAttributes: readonly {
             name: string;
@@ -661,7 +643,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         docxCommentJSON: {} | null;
         origin: "word" | "google-docs" | "unknown" | undefined;
         threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-        threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+        threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
         threadingParentCommentId: string | null | undefined;
         originalXmlStructure: {
             hasCommentsExtended: boolean;
@@ -672,7 +654,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc?: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -694,7 +676,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -766,7 +748,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             trackedChangeAnchorKey: string | null;
             trackedChangeCanonicalId: string | null;
             trackedChangePositionAliases: string[];
-            trackedChangeDecision: ("accept" | "reject") | null;
+            trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
             trackedChangeLabel: string | null;
             trackedChangeDetailLines: {
                 excerpt: string;
@@ -774,13 +756,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             }[] | null;
             trackedChangeImagePreview: {
                 src: string;
-                contentType: string;
-                role: "deleted" | "inserted" | "before" | "after";
-                partUri?: string | undefined;
-                relationshipId?: string | undefined;
+                contentType?: string | undefined;
+                role?: string | undefined;
                 width?: number | undefined;
                 height?: number | undefined;
-                alt?: string | undefined;
+                alt: string;
             } | null;
             customAttributes: readonly {
                 name: string;
@@ -795,7 +775,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             resolvedByName: string | null | undefined;
             origin: "word" | "google-docs" | "unknown" | undefined;
             threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-            threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+            threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
             threadingParentCommentId: string | null | undefined;
             originalXmlStructure: {
                 hasCommentsExtended: boolean;
@@ -809,7 +789,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             name?: string | null;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -826,7 +806,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
                     modules?: import('../public/index.js').Modules;
                 };
             };
-            decision?: "accept" | "reject";
+            decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
             reconciliationToken?: symbol;
         }) => {
             ok: false;
@@ -836,7 +816,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             isInternal: boolean;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -857,12 +837,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             ok: false;
             reason: "read-only-document";
         } | undefined;
-        updatePosition: (coords: {
-            top: number;
-            left: number;
-            right: number;
-            bottom: number;
-        }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
+        updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
         getCommentUser: () => {
             name: string;
             email: string | null | undefined;
@@ -874,14 +849,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             email: string | null;
             image: string | null;
         };
-        updateIdentityValues: (updates?: {
-            commentId?: string;
-            importedId?: string | null;
-            parentCommentId?: string | null;
-            trackedChangeParentId?: string | null;
-            trackedChangeThreadParentId?: string | null;
-            threadingParentCommentId?: string | null;
-        }) => void;
+        updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
     }[] | {
         uid: string | undefined;
         commentId: string;
@@ -951,7 +919,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         trackedChangeAnchorKey: string | null;
         trackedChangeCanonicalId: string | null;
         trackedChangePositionAliases: string[];
-        trackedChangeDecision: ("accept" | "reject") | null;
+        trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
         trackedChangeLabel: string | null;
         trackedChangeDetailLines: {
             excerpt: string;
@@ -959,13 +927,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         }[] | null;
         trackedChangeImagePreview: {
             src: string;
-            contentType: string;
-            role: "deleted" | "inserted" | "before" | "after";
-            partUri?: string | undefined;
-            relationshipId?: string | undefined;
+            contentType?: string | undefined;
+            role?: string | undefined;
             width?: number | undefined;
             height?: number | undefined;
-            alt?: string | undefined;
+            alt: string;
         } | null;
         customAttributes: readonly {
             name: string;
@@ -984,7 +950,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
         docxCommentJSON: {} | null;
         origin: "word" | "google-docs" | "unknown" | undefined;
         threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-        threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+        threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
         threadingParentCommentId: string | null | undefined;
         originalXmlStructure: {
             hasCommentsExtended: boolean;
@@ -995,7 +961,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc?: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -1017,7 +983,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             text: string;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -1089,7 +1055,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             trackedChangeAnchorKey: string | null;
             trackedChangeCanonicalId: string | null;
             trackedChangePositionAliases: string[];
-            trackedChangeDecision: ("accept" | "reject") | null;
+            trackedChangeDecision: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision | null;
             trackedChangeLabel: string | null;
             trackedChangeDetailLines: {
                 excerpt: string;
@@ -1097,13 +1063,11 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             }[] | null;
             trackedChangeImagePreview: {
                 src: string;
-                contentType: string;
-                role: "deleted" | "inserted" | "before" | "after";
-                partUri?: string | undefined;
-                relationshipId?: string | undefined;
+                contentType?: string | undefined;
+                role?: string | undefined;
                 width?: number | undefined;
                 height?: number | undefined;
-                alt?: string | undefined;
+                alt: string;
             } | null;
             customAttributes: readonly {
                 name: string;
@@ -1118,7 +1082,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             resolvedByName: string | null | undefined;
             origin: "word" | "google-docs" | "unknown" | undefined;
             threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-            threadingStyleOverride: import('../../../../shared/common').CommentThreadingStyle | undefined;
+            threadingStyleOverride: import('../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
             threadingParentCommentId: string | null | undefined;
             originalXmlStructure: {
                 hasCommentsExtended: boolean;
@@ -1132,7 +1096,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             name?: string | null;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -1149,7 +1113,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
                     modules?: import('../public/index.js').Modules;
                 };
             };
-            decision?: "accept" | "reject";
+            decision?: import('../components/CommentsLayer/comment-params.js').TrackedChangeDecision;
             reconciliationToken?: symbol;
         }) => {
             ok: false;
@@ -1159,7 +1123,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             isInternal: boolean;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../shared/common').CommentEvent;
+                    type: import('../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -1180,12 +1144,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             ok: false;
             reason: "read-only-document";
         } | undefined;
-        updatePosition: (coords: {
-            top: number;
-            left: number;
-            right: number;
-            bottom: number;
-        }, parentElement: Pick<Element, "getBoundingClientRect">) => void;
+        updatePosition: (coords: import('../components/CommentsLayer/comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
         getCommentUser: () => {
             name: string;
             email: string | null | undefined;
@@ -1197,14 +1156,7 @@ export default function useDocument(params: UseDocumentParams, superdocConfig: U
             email: string | null;
             image: string | null;
         };
-        updateIdentityValues: (updates?: {
-            commentId?: string;
-            importedId?: string | null;
-            parentCommentId?: string | null;
-            trackedChangeParentId?: string | null;
-            trackedChangeThreadParentId?: string | null;
-            threadingParentCommentId?: string | null;
-        }) => void;
+        updateIdentityValues: (updates?: import('../components/CommentsLayer/comment-params.js').CommentIdentity) => void;
     }[]>;
     commentThreadingProfile: import('vue').Ref<{} | null, {} | null>;
     setEditor: (ref: Editor | null) => Editor | null;

package/dist/superdoc/src/composables/use-find-replace.d.ts

@@ -1,9 +1,19 @@
 import { Ref } from 'vue';
 import { SurfaceManager } from '../core/surface-manager.js';
 import { Editor, FindReplaceConfig } from '../core/types/index.js';
-import { SearchController } from '../public/ui/types.js';
+import { SearchController, SearchSnapshot } from '../public/ui/types.js';
+type FindReplaceSearchQuery = (...args: Parameters<SearchController['find']>) => Partial<SearchSnapshot>;
+export type FindReplaceSearch = Pick<SearchController, 'next' | 'previous' | 'clear' | 'replace' | 'replaceAll'> & {
+    getSnapshot: () => Partial<SearchSnapshot>;
+} & ({
+    find: FindReplaceSearchQuery;
+    search?: FindReplaceSearchQuery;
+} | {
+    find?: undefined;
+    search: FindReplaceSearchQuery;
+});
 type UseFindReplaceOptions = {
-    getSurfaceManager: () => SurfaceManager | null;
+    getSurfaceManager: () => Pick<SurfaceManager, 'open'> | null;
     getActiveEditor: () => Editor | null;
     activeEditorRef?: Ref<Editor | null | undefined>;
     getFindReplaceConfig?: () => boolean | FindReplaceConfig | undefined;
@@ -12,7 +22,7 @@ type UseFindReplaceOptions = {
      * slice is the single find/replace session authority.
      */
     getSuperDocUI?: () => {
-        search?: SearchController | null;
+        search?: FindReplaceSearch | null;
     } | null | undefined;
 };
 /**

package/dist/superdoc/src/composables/use-password-prompt.d.ts

@@ -10,7 +10,7 @@ export interface PasswordPromptException {
     editor?: Editor | null;
 }
 export interface UsePasswordPromptOptions {
-    getSurfaceManager: () => SurfaceManager | null;
+    getSurfaceManager: () => Pick<SurfaceManager, 'open'> | null;
     getPasswordPromptConfig: () => boolean | PasswordPromptConfig | undefined;
     /**
      * Called when a queued prompt cannot be shown (resolver returned `none`, config error, or resolver threw).