superdoc 2.29.0-next.3 → 2.29.0

package/dist/superdoc/src/SuperDoc.vue.d.ts

@@ -6,38 +6,82 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
     superdocRoot: HTMLDivElement;
     layers: HTMLDivElement;
     selectionLayer: HTMLDivElement;
-    pdfViewerRef: (import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {
-        updateScale: (nextScale: any) => void;
-        $emit: (event: "page-rendered" | "selection-raw" | "bypass-selection" | "pages-loaded" | "document-loaded" | "document-ready" | "document-error", ...args: any[]) => void;
-        file: Record<string, any>;
-        config: Record<string, any>;
-        initialScale: number;
-        fileId?: string | undefined;
-        $props: {
-            readonly file?: Record<string, any> | undefined;
-            readonly config?: Record<string, any> | undefined;
-            readonly initialScale?: number | undefined;
-            readonly fileId?: string | undefined;
+    pdfViewerRef: (import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        config: {
+            type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerConfig>;
+            required: true;
+        };
+        file: {
+            type: import('vue').PropType<Blob | null>;
+            required: true;
+        };
+        fileId: {
+            type: StringConstructor;
         };
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        initialScale: {
+            type: NumberConstructor;
+            default: number;
+        };
+    }>> & Readonly<{
+        "onPage-rendered"?: ((...args: any[]) => any) | undefined;
+        "onSelection-raw"?: ((...args: any[]) => any) | undefined;
+        "onBypass-selection"?: ((...args: any[]) => any) | undefined;
+        "onPages-loaded"?: ((...args: any[]) => any) | undefined;
+        "onDocument-loaded"?: ((...args: any[]) => any) | undefined;
+        "onDocument-ready"?: ((...args: any[]) => any) | undefined;
+        "onDocument-error"?: ((...args: any[]) => any) | undefined;
+    }>, {
+        updateScale: (nextScale: number) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        "page-rendered": (...args: any[]) => void;
+        "selection-raw": (...args: any[]) => void;
+        "bypass-selection": (...args: any[]) => void;
+        "pages-loaded": (...args: any[]) => void;
+        "document-loaded": (...args: any[]) => void;
+        "document-ready": (...args: any[]) => void;
+        "document-error": (...args: any[]) => void;
+    }, import('vue').PublicProps, {
+        initialScale: number;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
         rootRef: HTMLDivElement;
-        documentRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {
-            $emit: (event: "page-rendered" | "page-error" | "selection-raw" | "bypass-selection" | "page-focus", ...args: any[]) => void;
-            pages: unknown[];
-            config: Record<string, any>;
-            hasTextLayer: boolean;
-            scale?: number | undefined;
-            pdf?: Record<string, any> | undefined;
-            outputScale?: number | undefined;
-            $props: {
-                readonly pages?: unknown[] | undefined;
-                readonly config?: Record<string, any> | undefined;
-                readonly hasTextLayer?: boolean | undefined;
-                readonly scale?: number | undefined;
-                readonly pdf?: Record<string, any> | undefined;
-                readonly outputScale?: number | undefined;
+        documentRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+            config: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerConfig>;
+                required: true;
             };
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+            pdf: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerDocumentData | null>;
+            };
+            pages: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerPageData[]>;
+                required: true;
+            };
+            scale: {
+                type: NumberConstructor;
+                required: true;
+            };
+            hasTextLayer: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            outputScale: {
+                type: NumberConstructor;
+            };
+        }>> & Readonly<{
+            "onPage-rendered"?: ((...args: any[]) => any) | undefined;
+            "onPage-error"?: ((...args: any[]) => any) | undefined;
+            "onSelection-raw"?: ((...args: any[]) => any) | undefined;
+            "onBypass-selection"?: ((...args: any[]) => any) | undefined;
+            "onPage-focus"?: ((...args: any[]) => any) | undefined;
+        }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            "page-rendered": (...args: any[]) => void;
+            "page-error": (...args: any[]) => void;
+            "selection-raw": (...args: any[]) => void;
+            "bypass-selection": (...args: any[]) => void;
+            "page-focus": (...args: any[]) => void;
+        }, import('vue').PublicProps, {
+            hasTextLayer: boolean;
+        }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
             documentRef: HTMLDivElement;
             documentWrapper: HTMLDivElement;
         }, HTMLDivElement, import('vue').ComponentProvideOptions, {
@@ -47,23 +91,38 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
             C: {};
             M: {};
             Defaults: {};
-        }, Readonly<{}> & Readonly<{}>, {
-            $emit: (event: "page-rendered" | "page-error" | "selection-raw" | "bypass-selection" | "page-focus", ...args: any[]) => void;
-            pages: unknown[];
-            config: Record<string, any>;
-            hasTextLayer: boolean;
-            scale?: number | undefined;
-            pdf?: Record<string, any> | undefined;
-            outputScale?: number | undefined;
-            $props: {
-                readonly pages?: unknown[] | undefined;
-                readonly config?: Record<string, any> | undefined;
-                readonly hasTextLayer?: boolean | undefined;
-                readonly scale?: number | undefined;
-                readonly pdf?: Record<string, any> | undefined;
-                readonly outputScale?: number | undefined;
+        }, Readonly<import('vue').ExtractPropTypes<{
+            config: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerConfig>;
+                required: true;
+            };
+            pdf: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerDocumentData | null>;
+            };
+            pages: {
+                type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerPageData[]>;
+                required: true;
+            };
+            scale: {
+                type: NumberConstructor;
+                required: true;
+            };
+            hasTextLayer: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            outputScale: {
+                type: NumberConstructor;
             };
-        }, {}, {}, {}, {}> | null;
+        }>> & Readonly<{
+            "onPage-rendered"?: ((...args: any[]) => any) | undefined;
+            "onPage-error"?: ((...args: any[]) => any) | undefined;
+            "onSelection-raw"?: ((...args: any[]) => any) | undefined;
+            "onBypass-selection"?: ((...args: any[]) => any) | undefined;
+            "onPage-focus"?: ((...args: any[]) => any) | undefined;
+        }>, {}, {}, {}, {}, {
+            hasTextLayer: boolean;
+        }> | null;
     }, HTMLDivElement, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -71,20 +130,35 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
         C: {};
         M: {};
         Defaults: {};
-    }, Readonly<{}> & Readonly<{}>, {
-        updateScale: (nextScale: any) => void;
-        $emit: (event: "page-rendered" | "selection-raw" | "bypass-selection" | "pages-loaded" | "document-loaded" | "document-ready" | "document-error", ...args: any[]) => void;
-        file: Record<string, any>;
-        config: Record<string, any>;
-        initialScale: number;
-        fileId?: string | undefined;
-        $props: {
-            readonly file?: Record<string, any> | undefined;
-            readonly config?: Record<string, any> | undefined;
-            readonly initialScale?: number | undefined;
-            readonly fileId?: string | undefined;
+    }, Readonly<import('vue').ExtractPropTypes<{
+        config: {
+            type: import('vue').PropType<import('./components/PdfViewer/pdf-viewer-types.js').PdfViewerConfig>;
+            required: true;
+        };
+        file: {
+            type: import('vue').PropType<Blob | null>;
+            required: true;
         };
-    }, {}, {}, {}, {}> | null)[];
+        fileId: {
+            type: StringConstructor;
+        };
+        initialScale: {
+            type: NumberConstructor;
+            default: number;
+        };
+    }>> & Readonly<{
+        "onPage-rendered"?: ((...args: any[]) => any) | undefined;
+        "onSelection-raw"?: ((...args: any[]) => any) | undefined;
+        "onBypass-selection"?: ((...args: any[]) => any) | undefined;
+        "onPages-loaded"?: ((...args: any[]) => any) | undefined;
+        "onDocument-loaded"?: ((...args: any[]) => any) | undefined;
+        "onDocument-ready"?: ((...args: any[]) => any) | undefined;
+        "onDocument-error"?: ((...args: any[]) => any) | undefined;
+    }>, {
+        updateScale: (nextScale: number) => void;
+    }, {}, {}, {}, {
+        initialScale: number;
+    }> | null)[];
     rightSidebarRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/superdoc/src/components/CommentsLayer/CommentDialog.vue.d.ts

@@ -149,21 +149,31 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         isInternal: boolean;
         commentText: string;
         selection: {
-            documentId: any;
-            page: any;
-            selectionBounds: any;
+            documentId: unknown;
+            page: number | undefined;
+            selectionBounds: {
+                top?: number | undefined;
+                left?: number | undefined;
+                right?: number | undefined;
+                bottom?: number | undefined;
+            };
             getValues: () => {
-                documentId: any;
-                page: any;
-                selectionBounds: any;
-                source: any;
+                documentId: unknown;
+                page: number | undefined;
+                selectionBounds: {
+                    top?: number;
+                    left?: number;
+                    right?: number;
+                    bottom?: number;
+                };
+                source: string | null | undefined;
             };
             getContainerId: () => string;
-            getContainerLocation: (parentContainer: any) => {
+            getContainerLocation: (parentContainer: Pick<Element, "getBoundingClientRect"> | null | undefined) => {
                 top: number;
                 left: number;
             };
-            source: any;
+            source: string | null | undefined;
         };
         floatingPosition: {
             top?: number | undefined;
@@ -300,10 +310,15 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             isInternal: boolean;
             commentText: string;
             selection: {
-                documentId: any;
-                page: any;
-                selectionBounds: any;
-                source: any;
+                documentId: unknown;
+                page: number | undefined;
+                selectionBounds: {
+                    top?: number;
+                    left?: number;
+                    right?: number;
+                    bottom?: number;
+                };
+                source: string | null | undefined;
             } | null;
             trackedChange: boolean | undefined;
             trackedChangeText: string | null;

package/dist/superdoc/src/components/CommentsLayer/collect-removed-comment-ids.d.ts

@@ -1 +1,11 @@
-export function collectRemovedCommentIds(comments: ReadonlyArray<Record<string, any>>, targetIds: ReadonlyArray<string>, isInScope?: (comment: Record<string, any>) => boolean): Set<string>;
+import { TrackedChangeThreadSource } from './tracked-change-threading.js';
+type RemovableComment = TrackedChangeThreadSource<unknown> & {
+    commentId?: unknown;
+    importedId?: unknown;
+    parentCommentId?: unknown;
+};
+/**
+ * Expand deleted comment ids through comment and tracked-change descendants.
+ */
+export declare const collectRemovedCommentIds: <Comment extends RemovableComment>(comments: ReadonlyArray<Comment>, targetIds: ReadonlyArray<string>, isInScope?: (comment: Comment) => boolean) => Set<string>;
+export {};

package/dist/superdoc/src/components/CommentsLayer/collect-tracked-change-thread.d.ts

@@ -1,6 +1,23 @@
-export function collectTrackedChangeThread<Comment extends {
+/**
+ * Collect every comment that should appear inside the tracked-change dialog
+ * for `parentComment`. Walks two sources of membership:
+ *
+ *   1. **Seed**: comments explicitly threaded to this TC via
+ *      `trackedChangeThreadParentId`
+ *      whose conversational thread *starts here* (no `parentCommentId`),
+ *      plus direct replies whose stored or UI-threading parent points at
+ *      `parentComment.commentId`.
+ *   2. **BFS**: replies-of-replies — any comment whose `parentCommentId`
+ *      points to something already in the thread.
+ *
+ * Pure function — no side effects, no Vue, no store. Extracted from
+ * CommentDialog.vue so the logic can be unit-tested in isolation.
+ *
+ * Returns the comments belonging to this tracked-change thread, in original list order.
+ */
+export declare const collectTrackedChangeThread: <Comment extends {
     commentId: string;
     parentCommentId?: string | null;
     threadingParentCommentId?: string | null;
     trackedChangeThreadParentId?: string | null;
-}>(parentComment: Comment, allComments: ReadonlyArray<Comment>): Array<Comment>;
+}>(parentComment: Comment, allComments: ReadonlyArray<Comment>) => Array<Comment>;

package/dist/superdoc/src/components/CommentsLayer/comment-urls.d.ts

@@ -1,2 +1,2 @@
 /** Render links without rewriting stored comment HTML or its rich-text structure. */
-export function renderCommentHtml(value: any): string;
+export declare function renderCommentHtml(value: unknown): string;

package/dist/superdoc/src/components/CommentsLayer/commentsList/super-comments-list.d.ts

@@ -1,33 +1,36 @@
 import { EventEmitter } from 'eventemitter3';
+import { App, ComponentPublicInstance } from 'vue';
+import { SuperDoc } from '../../../core/types/index.js';
+type DirectoryFamily = 'comments' | 'trackChanges';
+type DirectoryItems = Record<DirectoryFamily, readonly unknown[] | null>;
+type SuperCommentsConfig = {
+    comments: unknown[];
+    element: Element | string | null | undefined;
+    commentsStore: unknown;
+    selector?: string;
+    [key: string]: unknown;
+};
+type SuperCommentsOptions = Partial<SuperCommentsConfig>;
 /**
  * Comments list renderer (not floating comments)
  *
  * This renders a list of comments into an element, connected to main SuperDoc instance
  */
-export class SuperComments extends EventEmitter<string | symbol, any> {
-    constructor(options: any, superdoc: any);
-    element: any;
-    config: {
-        comments: never[];
-        element: null;
-        commentsStore: null;
-    };
-    app: import('vue').App<Element> | null;
-    superdoc: any;
-    stopDirectoryObservers: any[];
-    directorySnapshots: {
-        comments: null;
-        trackChanges: null;
-    };
-    directoryItemRefs: {
-        comments: null;
-        trackChanges: null;
-    };
+export declare class SuperComments extends EventEmitter {
+    element: Element | string | null | undefined;
+    config: SuperCommentsConfig;
+    app: App | null;
+    superdoc: SuperDoc;
+    container: ComponentPublicInstance | null | undefined;
+    stopDirectoryObservers: Array<() => void>;
+    directorySnapshots: DirectoryItems;
+    directoryItemRefs: DirectoryItems;
     directoryGeneration: number;
+    constructor(options: SuperCommentsOptions | undefined, superdoc: SuperDoc);
     syncDirectory(): void;
     startDirectoryObservers(): void;
     createVueApp(): void;
-    container: import('vue').ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import('vue').ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, import('vue').ComponentProvideOptions>, {}, {}, "", {}, any> | null | undefined;
     close(): void;
     open(): void;
 }
+export {};

package/dist/superdoc/src/components/CommentsLayer/floating-comment-positioning.d.ts

@@ -1,25 +1,26 @@
-export function normalizeFloatingAnchorTop(top: any): any;
-export function isAnchorOutsideFloatingViewport(anchorTop: any, viewportTop: any, viewportBottom: any, anchorBottom?: any): boolean;
-export function shouldKeepFloatingCardAtAnchor({ anchorTop, anchorBottom, viewportTop, viewportBottom }: {
-    anchorTop: any;
-    anchorBottom: any;
-    viewportTop: any;
-    viewportBottom: any;
-}): boolean;
-export function resolveOffscreenFloatingCardTop({ anchorTop, anchorBottom, cardHeight, viewportTop, viewportBottom, }: {
-    anchorTop: any;
-    anchorBottom: any;
-    cardHeight: any;
-    viewportTop: any;
-    viewportBottom: any;
-}): any;
-export function shouldMountFloatingCommentDialog({ id, visibleIds, activeCommentInstanceId }: {
-    id: any;
-    visibleIds: any;
-    activeCommentInstanceId: any;
-}): boolean;
-export function resolveRemovedReviewCardContinuityTarget({ previousIds, currentIds, removedId }: {
+type OptionalNumber = number | null | undefined;
+type FloatingAnchorGeometry = {
+    anchorTop: OptionalNumber;
+    anchorBottom?: OptionalNumber;
+    viewportTop: OptionalNumber;
+    viewportBottom: OptionalNumber;
+};
+type OffscreenFloatingCardInput = FloatingAnchorGeometry & {
+    cardHeight: OptionalNumber;
+};
+type FloatingCommentDialogMountInput = {
+    id: string | null | undefined;
+    visibleIds?: ReadonlySet<string> | null;
+    activeCommentInstanceId?: string | null;
+};
+type RemovedReviewCardContinuityInput = {
     previousIds: readonly string[];
     currentIds: ReadonlySet<string>;
-    removedId: string;
-}): string | null;
+    removedId: string | null | undefined;
+};
+export declare const isAnchorOutsideFloatingViewport: (anchorTop: OptionalNumber, viewportTop: OptionalNumber, viewportBottom: OptionalNumber, anchorBottom?: OptionalNumber) => boolean;
+export declare const shouldKeepFloatingCardAtAnchor: ({ anchorTop, anchorBottom, viewportTop, viewportBottom, }: FloatingAnchorGeometry) => boolean;
+export declare const resolveOffscreenFloatingCardTop: ({ anchorTop, anchorBottom, cardHeight, viewportTop, viewportBottom, }: OffscreenFloatingCardInput) => number | null;
+export declare const shouldMountFloatingCommentDialog: ({ id, visibleIds, activeCommentInstanceId, }: FloatingCommentDialogMountInput) => boolean;
+export declare const resolveRemovedReviewCardContinuityTarget: ({ previousIds, currentIds, removedId, }: RemovedReviewCardContinuityInput) => string | null;
+export {};

package/dist/superdoc/src/components/CommentsLayer/helpers.d.ts

@@ -1,7 +1,4 @@
 /**
  * Comments helper to format dates from timestamp
- *
- * @param {Number} timestamp The timestamp to format
- * @returns {String} The formatted date
  */
-export function formatDate(timestamp: number): string;
+export declare function formatDate(timestamp: number): string;

package/dist/superdoc/src/components/CommentsLayer/tracked-change-threading.d.ts

@@ -1,2 +1,16 @@
-export function hasLegacyTrackedChangeThreadSignal(comment: Record<string, any> | null | undefined): boolean;
-export function trackedChangeThreadParentIdForComment(comment: Record<string, any> | null | undefined): string | number | null;
+export type TrackedChangeThreadSource<Id> = {
+    trackedChangeThreadParentId?: Id | null;
+    trackedChangeParentId?: Id | null;
+    trackedChangeLink?: unknown;
+    trackedChangeType?: unknown;
+    trackedChangeDisplayType?: unknown;
+    trackedChangeText?: unknown;
+    deletedText?: unknown;
+    trackedChange?: unknown;
+};
+/**
+ * Resolve explicit thread provenance first, then the guarded legacy fallback.
+ * Spatial-only v2 comments carry neither the explicit field nor a legacy
+ * review signal and therefore remain standalone.
+ */
+export declare const trackedChangeThreadParentIdForComment: <Id>(comment: TrackedChangeThreadSource<Id> | null | undefined) => Id | null;

package/dist/superdoc/src/components/CommentsLayer/use-comment.d.ts

@@ -149,21 +149,31 @@ export default function useComment(params: UseCommentParams): {
     isInternal: boolean;
     commentText: string;
     selection: {
-        documentId: any;
-        page: any;
-        selectionBounds: any;
+        documentId: unknown;
+        page: number | undefined;
+        selectionBounds: {
+            top?: number | undefined;
+            left?: number | undefined;
+            right?: number | undefined;
+            bottom?: number | undefined;
+        };
         getValues: () => {
-            documentId: any;
-            page: any;
-            selectionBounds: any;
-            source: any;
+            documentId: unknown;
+            page: number | undefined;
+            selectionBounds: {
+                top?: number;
+                left?: number;
+                right?: number;
+                bottom?: number;
+            };
+            source: string | null | undefined;
         };
         getContainerId: () => string;
-        getContainerLocation: (parentContainer: any) => {
+        getContainerLocation: (parentContainer: Pick<Element, "getBoundingClientRect"> | null | undefined) => {
             top: number;
             left: number;
         };
-        source: any;
+        source: string | null | undefined;
     };
     floatingPosition: {
         top?: number | undefined;
@@ -253,10 +263,15 @@ export default function useComment(params: UseCommentParams): {
         isInternal: boolean;
         commentText: string;
         selection: {
-            documentId: any;
-            page: any;
-            selectionBounds: any;
-            source: any;
+            documentId: unknown;
+            page: number | undefined;
+            selectionBounds: {
+                top?: number;
+                left?: number;
+                right?: number;
+                bottom?: number;
+            };
+            source: string | null | undefined;
         } | null;
         trackedChange: boolean | undefined;
         trackedChangeText: string | null;