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

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

@@ -194,7 +194,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         trackedChangeAnchorKey: string | null;
         trackedChangeCanonicalId: string | null;
         trackedChangePositionAliases: string[];
-        trackedChangeDecision: ("accept" | "reject") | null;
+        trackedChangeDecision: import('./comment-params.js').TrackedChangeDecision | null;
         trackedChangeLabel: string | null;
         trackedChangeDetailLines: {
             excerpt: string;
@@ -202,13 +202,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         }[] | 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;
@@ -227,7 +225,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         docxCommentJSON: {} | null;
         origin: "word" | "google-docs" | "unknown" | undefined;
         threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-        threadingStyleOverride: import('../../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
+        threadingStyleOverride: import('../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
         threadingParentCommentId: string | null | undefined;
         originalXmlStructure: {
             hasCommentsExtended: boolean;
@@ -238,7 +236,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             text: string;
             superdoc?: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../../shared/common/event-types.js').CommentEvent;
+                    type: import('../../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -260,7 +258,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             text: string;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../../shared/common/event-types.js').CommentEvent;
+                    type: import('../../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -332,7 +330,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             trackedChangeAnchorKey: string | null;
             trackedChangeCanonicalId: string | null;
             trackedChangePositionAliases: string[];
-            trackedChangeDecision: ("accept" | "reject") | null;
+            trackedChangeDecision: import('./comment-params.js').TrackedChangeDecision | null;
             trackedChangeLabel: string | null;
             trackedChangeDetailLines: {
                 excerpt: string;
@@ -340,13 +338,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             }[] | 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;
@@ -361,7 +357,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             resolvedByName: string | null | undefined;
             origin: "word" | "google-docs" | "unknown" | undefined;
             threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-            threadingStyleOverride: import('../../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
+            threadingStyleOverride: import('../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
             threadingParentCommentId: string | null | undefined;
             originalXmlStructure: {
                 hasCommentsExtended: boolean;
@@ -375,7 +371,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             name?: string | null;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../../shared/common/event-types.js').CommentEvent;
+                    type: import('../../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -392,7 +388,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
                     modules?: import('../../public/index.js').Modules;
                 };
             };
-            decision?: "accept" | "reject";
+            decision?: import('./comment-params.js').TrackedChangeDecision;
             reconciliationToken?: symbol;
         }) => {
             ok: false;
@@ -402,7 +398,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             isInternal: boolean;
             superdoc: {
                 emit: (event: "comments-update", payload: {
-                    type: import('../../../../../shared/common/event-types.js').CommentEvent;
+                    type: import('../../../../shared/common/event-types.js').CommentEvent;
                     changes?: {
                         key: string;
                         value: unknown;
@@ -423,12 +419,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             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('./comment-params.js').SelectionBounds, parentElement: Pick<Element, "getBoundingClientRect">) => void;
         getCommentUser: () => {
             name: string;
             email: string | null | undefined;
@@ -440,14 +431,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             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('./comment-params.js').CommentIdentity) => void;
     }[] | null;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
     commentDialogElement: HTMLDivElement;

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,25 @@
-export function collectTrackedChangeThread<Comment extends {
-    commentId: string;
-    parentCommentId?: string | null;
-    threadingParentCommentId?: string | null;
-    trackedChangeThreadParentId?: string | null;
-}>(parentComment: Comment, allComments: ReadonlyArray<Comment>): Array<Comment>;
+type CommentId = string | number;
+/**
+ * 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: CommentId;
+    parentCommentId?: CommentId | null;
+    threadingParentCommentId?: CommentId | null;
+    trackedChangeThreadParentId?: CommentId | null;
+}>(parentComment: Comment, allComments: ReadonlyArray<Comment>) => Array<Comment>;
+export {};

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

@@ -0,0 +1,84 @@
+import { TrackChangeCustomAttribute } from '../../../../document-api/src/index.js';
+import { StoryLocator } from '../../core/types/index.js';
+export type TrackedChangeDecision = 'accept' | 'reject';
+export type SelectionBounds = {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+};
+export type CommentMention = {
+    name?: string | null;
+    email?: string | null;
+};
+export type CommentAuthor = {
+    name?: string | null;
+    email?: string | null;
+};
+export type TrackedChangeDetailLine = {
+    excerpt: string;
+    label: string;
+};
+export type TrackedChangeRowImagePreview = {
+    src: string;
+    contentType?: string;
+    role?: string;
+    width?: number;
+    height?: number;
+    alt: string;
+};
+export type CommentSelectionParams = {
+    documentId?: unknown;
+    page?: number;
+    selectionBounds?: Partial<SelectionBounds> | null;
+    source?: string | null;
+};
+export type CommentIdentity = {
+    commentId?: string;
+    importedId?: string | null;
+    parentCommentId?: string | null;
+    trackedChangeParentId?: string | null;
+    trackedChangeThreadParentId?: string | null;
+    threadingParentCommentId?: string | null;
+};
+export type CommentInputParams = CommentIdentity & {
+    uid?: string;
+    trackedChangeSide?: string | null;
+    fileId?: string | null;
+    fileType?: string | null;
+    createdAtVersionNumber?: number | null;
+    isInternal?: boolean;
+    mentions?: CommentMention[];
+    isFocused?: boolean;
+    creatorId?: string | null;
+    creatorEmail?: string | null;
+    creatorName?: string | null;
+    creatorImage?: string | null;
+    createdTime?: number;
+    importedAuthor?: CommentAuthor | null;
+    docxCommentJSON?: unknown;
+    commentText?: string;
+    selection?: CommentSelectionParams | null;
+    trackedChange?: boolean;
+    trackedChangeType?: string | null;
+    trackedChangeText?: string | null;
+    trackedChangeDisplayType?: string | null;
+    semanticColorKey?: string | null;
+    semanticColor?: string | null;
+    trackedChangeStory?: StoryLocator | null;
+    trackedChangeStoryKind?: string | null;
+    trackedChangeStoryLabel?: string;
+    trackedChangeAnchorKey?: string | null;
+    trackedChangeCanonicalId?: string | null;
+    trackedChangePositionAliases?: string[];
+    deletedText?: string | null;
+    trackedChangeLabel?: string | null;
+    trackedChangeDetailLines?: TrackedChangeDetailLine[] | null;
+    trackedChangeImagePreview?: TrackedChangeRowImagePreview | null;
+    customAttributes?: readonly TrackChangeCustomAttribute[] | null;
+    resolvedTime?: number | null;
+    resolvedById?: string | null;
+    resolvedByEmail?: string | null;
+    resolvedByName?: string | null;
+    trackedChangeDecision?: TrackedChangeDecision | null;
+};

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/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 +1,16 @@
-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

@@ -1,36 +1,13 @@
-import { TrackChangeCustomAttribute, TrackChangeImagePreview } from '../../../../document-api/src/index.js';
-import { CommentEvent, Comment as CommonComment, CommentThreadingStyle } from '../../../../../shared/common';
-import { Modules, StoryLocator } from '../../core/types/index.js';
+import { CommentEvent } from '../../../../shared/common/event-types.js';
+import { Comment as CommonComment } from '../../../../shared/common/comments-types.js';
+import { Modules } from '../../core/types/index.js';
+import { CommentIdentity, CommentInputParams, SelectionBounds, TrackedChangeDecision } from './comment-params.js';
+export type UseCommentParams = CommentInputParams & Pick<CommonComment, 'origin' | 'threadingMethod' | 'threadingStyleOverride' | 'originalXmlStructure'>;
 export declare const COMMENT_RECONCILIATION_TOKEN: unique symbol;
 type ReadOnlyMutationOutcome = {
     ok: false;
     reason: 'read-only-document';
 };
-type TrackedChangeDecision = 'accept' | 'reject';
-type SelectionBounds = {
-    top: number;
-    left: number;
-    right: number;
-    bottom: number;
-};
-type CommentMention = {
-    name?: string | null;
-    email?: string | null;
-};
-type CommentAuthor = {
-    name?: string | null;
-    email?: string | null;
-};
-type TrackedChangeDetailLine = {
-    excerpt: string;
-    label: string;
-};
-type CommentSelectionParams = {
-    documentId?: string | null;
-    page?: number;
-    selectionBounds?: Partial<SelectionBounds> | null;
-    source?: string | null;
-};
 type CommentChange = {
     key: string;
     value: unknown;
@@ -52,59 +29,6 @@ type CommentsHost = {
         modules?: Modules;
     };
 };
-type CommentIdentity = {
-    commentId?: string;
-    importedId?: string | null;
-    parentCommentId?: string | null;
-    trackedChangeParentId?: string | null;
-    trackedChangeThreadParentId?: string | null;
-    threadingParentCommentId?: string | null;
-};
-export type UseCommentParams = CommentIdentity & {
-    uid?: string;
-    trackedChangeSide?: string | null;
-    fileId?: string | null;
-    fileType?: string | null;
-    createdAtVersionNumber?: number | null;
-    isInternal?: boolean;
-    mentions?: CommentMention[];
-    isFocused?: boolean;
-    creatorId?: string | null;
-    creatorEmail?: string | null;
-    creatorName?: string | null;
-    creatorImage?: string | null;
-    createdTime?: number;
-    importedAuthor?: CommentAuthor | null;
-    docxCommentJSON?: unknown;
-    origin?: CommonComment['origin'];
-    threadingMethod?: CommonComment['threadingMethod'];
-    threadingStyleOverride?: CommentThreadingStyle;
-    originalXmlStructure?: CommonComment['originalXmlStructure'];
-    commentText?: string;
-    selection?: CommentSelectionParams;
-    trackedChange?: boolean;
-    trackedChangeType?: string | null;
-    trackedChangeText?: string | null;
-    trackedChangeDisplayType?: string | null;
-    semanticColorKey?: string | null;
-    semanticColor?: string | null;
-    trackedChangeStory?: StoryLocator | null;
-    trackedChangeStoryKind?: string | null;
-    trackedChangeStoryLabel?: string;
-    trackedChangeAnchorKey?: string | null;
-    trackedChangeCanonicalId?: string | null;
-    trackedChangePositionAliases?: string[];
-    deletedText?: string | null;
-    trackedChangeLabel?: string | null;
-    trackedChangeDetailLines?: TrackedChangeDetailLine[] | null;
-    trackedChangeImagePreview?: TrackChangeImagePreview | null;
-    customAttributes?: readonly TrackChangeCustomAttribute[] | null;
-    resolvedTime?: number | null;
-    resolvedById?: string | null;
-    resolvedByEmail?: string | null;
-    resolvedByName?: string | null;
-    trackedChangeDecision?: TrackedChangeDecision | null;
-};
 type ResolveCommentParams = {
     id?: string | null;
     email?: string | null;
@@ -188,7 +112,7 @@ export default function useComment(params: UseCommentParams): {
     trackedChangeDisplayType: string | null;
     semanticColorKey: string | null;
     semanticColor: string | null;
-    trackedChangeStory: StoryLocator | null;
+    trackedChangeStory: import('../../public/index.js').StoryLocator | null;
     trackedChangeStoryKind: string | null;
     trackedChangeStoryLabel: string;
     trackedChangeAnchorKey: string | null;
@@ -202,13 +126,11 @@ export default function useComment(params: UseCommentParams): {
     }[] | 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;
@@ -227,7 +149,7 @@ export default function useComment(params: UseCommentParams): {
     docxCommentJSON: {} | null;
     origin: "word" | "google-docs" | "unknown" | undefined;
     threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-    threadingStyleOverride: CommentThreadingStyle | undefined;
+    threadingStyleOverride: import('../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
     threadingParentCommentId: string | null | undefined;
     originalXmlStructure: {
         hasCommentsExtended: boolean;
@@ -279,7 +201,7 @@ export default function useComment(params: UseCommentParams): {
         trackedChangeDisplayType: string | null;
         semanticColorKey: string | null;
         semanticColor: string | null;
-        trackedChangeStory: StoryLocator | null;
+        trackedChangeStory: import('../../public/index.js').StoryLocator | null;
         trackedChangeStoryKind: string | null;
         trackedChangeStoryLabel: string;
         trackedChangeAnchorKey: string | null;
@@ -293,13 +215,11 @@ export default function useComment(params: UseCommentParams): {
         }[] | 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;
@@ -314,7 +234,7 @@ export default function useComment(params: UseCommentParams): {
         resolvedByName: string | null | undefined;
         origin: "word" | "google-docs" | "unknown" | undefined;
         threadingMethod: "commentsExtended" | "range-based" | "mixed" | undefined;
-        threadingStyleOverride: CommentThreadingStyle | undefined;
+        threadingStyleOverride: import('../../../../shared/common/comments-types.js').CommentThreadingStyle | undefined;
         threadingParentCommentId: string | null | undefined;
         originalXmlStructure: {
             hasCommentsExtended: boolean;

package/dist/superdoc/src/components/Whiteboard/WhiteboardLayer.vue.d.ts

@@ -1,13 +1,12 @@
 import { PropType } from 'vue';
-import { WhiteboardPage as WhiteboardPageModel } from '../../core/whiteboard/WhiteboardPage.js';
-import { WhiteboardDropTarget, WhiteboardPageOffset, WhiteboardPageSize } from './whiteboard-types.js';
+import { WhiteboardDropTarget, WhiteboardPageOffset, WhiteboardPageSize, WhiteboardPageView } from './whiteboard-types.js';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     whiteboard: {
         type: PropType<WhiteboardDropTarget>;
         required: true;
     };
     pages: {
-        type: PropType<WhiteboardPageModel[]>;
+        type: PropType<WhiteboardPageView[]>;
         default: () => never[];
     };
     pageSizes: {
@@ -43,7 +42,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         required: true;
     };
     pages: {
-        type: PropType<WhiteboardPageModel[]>;
+        type: PropType<WhiteboardPageView[]>;
         default: () => never[];
     };
     pageSizes: {
@@ -76,7 +75,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
 }>> & Readonly<{}>, {
     enabled: boolean;
     opacity: number;
-    pages: WhiteboardPageModel[];
+    pages: WhiteboardPageView[];
     pageSizes: Record<number, WhiteboardPageSize>;
     pageOffsets: Record<number, WhiteboardPageOffset>;
     interactive: boolean | null;

package/dist/superdoc/src/components/Whiteboard/WhiteboardPage.vue.d.ts

@@ -1,13 +1,12 @@
 import { PropType } from 'vue';
-import { WhiteboardPage } from '../../core/whiteboard/WhiteboardPage.js';
-import { WhiteboardDropTarget, WhiteboardPageOffset, WhiteboardPageSize } from './whiteboard-types.js';
+import { WhiteboardDropTarget, WhiteboardPageOffset, WhiteboardPageSize, WhiteboardPageView } from './whiteboard-types.js';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     whiteboard: {
         type: PropType<WhiteboardDropTarget>;
         required: true;
     };
     page: {
-        type: PropType<WhiteboardPage>;
+        type: PropType<WhiteboardPageView>;
         required: true;
     };
     pageSize: {
@@ -28,7 +27,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         required: true;
     };
     page: {
-        type: PropType<WhiteboardPage>;
+        type: PropType<WhiteboardPageView>;
         required: true;
     };
     pageSize: {

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

@@ -1,26 +1,47 @@
 import { Ref } from 'vue';
-import { SuperDoc } from '../../core/SuperDoc.js';
+import { EventEmitter } from '../../core/EventEmitter.js';
 import { Document, Modules } from '../../core/types/index.js';
-import { WhiteboardPageSize } from '../../core/whiteboard/Whiteboard.js';
+import { Whiteboard, WhiteboardEventMap, WhiteboardPageSize } from '../../core/whiteboard/Whiteboard.js';
 import { WhiteboardPage } from '../../core/whiteboard/WhiteboardPage.js';
 import { PdfPageRenderedPayload } from '../PdfViewer/pdf-viewer-types.js';
 import { WhiteboardPageOffset } from './whiteboard-types.js';
 type WhiteboardDocument = Pick<Document, 'id' | 'type'>;
-type WhiteboardPageReadyPayload = Pick<PdfPageRenderedPayload, 'pageIndex' | 'width' | 'height' | 'originalWidth' | 'originalHeight'>;
-export type UseWhiteboardOptions = {
+type WhiteboardPageReadyPayload = Pick<PdfPageRenderedPayload, 'pageIndex' | 'width' | 'height'> & Partial<Pick<PdfPageRenderedPayload, 'originalWidth' | 'originalHeight'>>;
+type Bounds = Pick<DOMRect, 'top' | 'left'>;
+type WhiteboardLayerElement = {
+    getBoundingClientRect(): Bounds;
+};
+type WhiteboardPageSource = Pick<WhiteboardPage, 'pageIndex' | 'size' | 'setSize'>;
+type WhiteboardSource = Pick<Whiteboard, 'on' | 'off' | 'setPageSize'> & {
+    getPage(...args: Parameters<Whiteboard['getPage']>): WhiteboardPageSource | undefined;
+    getPages(): WhiteboardPageSource[];
+};
+type WhiteboardSourcePage<Board extends WhiteboardSource> = ReturnType<Board['getPages']>[number];
+type WhiteboardHostEvents<Board extends WhiteboardSource> = {
+    'whiteboard:ready': [{
+        whiteboard: Board;
+    }];
+    'whiteboard:change': WhiteboardEventMap['change'];
+    'whiteboard:enabled': WhiteboardEventMap['enabled'];
+    'whiteboard:tool': WhiteboardEventMap['tool'];
+};
+export type UseWhiteboardOptions<Board extends WhiteboardSource> = {
     proxy: {
-        $superdoc: Pick<SuperDoc, 'emit' | 'whiteboard'>;
+        $superdoc: Pick<EventEmitter<WhiteboardHostEvents<Board>>, 'emit'> & {
+            whiteboard?: Board | null;
+        };
     };
-    layers: Ref<HTMLElement | null>;
+    layers: Ref<WhiteboardLayerElement | null>;
     documents: Ref<WhiteboardDocument[]>;
     modules: Modules;
 };
-export declare const useWhiteboard: ({ proxy, layers, documents, modules }: UseWhiteboardOptions) => {
-    whiteboard: import('../../core/whiteboard/Whiteboard.js').Whiteboard | null;
+type Options<Board extends WhiteboardSource> = UseWhiteboardOptions<Board>;
+export declare const useWhiteboard: <B extends WhiteboardSource>({ proxy, layers, documents, modules }: Options<B>) => {
+    whiteboard: B | null | undefined;
     whiteboardModuleConfig: import('vue').ComputedRef<{
         enabled?: boolean;
     } | null>;
-    whiteboardPages: import('vue').ShallowRef<WhiteboardPage[], WhiteboardPage[]>;
+    whiteboardPages: import('vue').ShallowRef<WhiteboardSourcePage<B>[], WhiteboardSourcePage<B>[]>;
     whiteboardPageSizes: Record<number, WhiteboardPageSize>;
     whiteboardPageOffsets: Record<number, WhiteboardPageOffset>;
     whiteboardEnabled: Ref<boolean, boolean>;