@docmentis/udoc-viewer 0.5.18 → 0.5.20

package/dist/src/UDocViewer.d.ts

@@ -9,6 +9,7 @@ import type { ViewerOptions } from "./UDocClient.js";
 import type { Destination, OutlineItem } from "./ui/viewer/navigation.js";
 import type { Annotation } from "./ui/viewer/annotation/index.js";
 export type { Annotation } from "./ui/viewer/annotation/index.js";
+import { type PanelTab, type ScrollMode, type LayoutMode, type ZoomMode, type PageRotation, type SpacingMode } from "./ui/viewer/state.js";
 import { type IPerformanceCounter } from "./performance/index.js";
 /**
  * Options for rendering a page.
@@ -86,6 +87,10 @@ export interface DownloadProgress {
     /** Progress percentage 0-100 (null if total unknown). */
     percent: number | null;
 }
+/**
+ * UI component identifier for visibility events.
+ */
+export type UIComponent = "toolbar" | "floatingToolbar" | "leftPanel" | "rightPanel" | "fullscreen" | PanelTab;
 /**
  * Event map for viewer events.
  */
@@ -99,6 +104,18 @@ export interface ViewerEventMap {
         error: Error;
         phase: "fetch" | "parse" | "render";
     };
+    "page:change": {
+        page: number;
+        previousPage: number;
+    };
+    "ui:visibilityChange": {
+        component: UIComponent;
+        visible: boolean;
+    };
+    "panel:change": {
+        panel: PanelTab | null;
+        previousPanel: PanelTab | null;
+    };
 }
 type EventHandler<K extends keyof ViewerEventMap> = (payload: ViewerEventMap[K]) => void;
 /**
@@ -120,11 +137,14 @@ export declare class UDocViewer {
     private googleFontsEnabled;
     private viewOverrides;
     private currentFormat;
+    private storeUnsub;
+    private telemetryEnabled;
+    private sdkVersion;
     /**
      * @internal
      * Use `client.createViewer()` instead.
      */
-    constructor(workerClient: WorkerClient, options?: ViewerOptions, showAttribution?: boolean);
+    constructor(workerClient: WorkerClient, options?: ViewerOptions, showAttribution?: boolean, telemetryEnabled?: boolean, sdkVersion?: string);
     /**
      * Performance counter for tracking operation timings.
      * Only records data when `enablePerformanceCounter` is true.
@@ -206,6 +226,105 @@ export declare class UDocViewer {
      * @param destination - Full destination object with page index and display mode
      */
     goToDestination(destination: Destination): void;
+    /**
+     * Navigate to the next page.
+     */
+    nextPage(): void;
+    /**
+     * Navigate to the previous page.
+     */
+    previousPage(): void;
+    /**
+     * Current zoom level (1 = 100%).
+     */
+    get zoom(): number;
+    /**
+     * Current zoom mode.
+     */
+    get zoomMode(): ZoomMode;
+    /**
+     * Zoom in to the next zoom step.
+     */
+    zoomIn(): void;
+    /**
+     * Zoom out to the previous zoom step.
+     */
+    zoomOut(): void;
+    /**
+     * Set zoom to a specific level (1 = 100%). Switches to custom zoom mode.
+     */
+    setZoom(zoom: number): void;
+    /**
+     * Set zoom mode.
+     */
+    setZoomMode(mode: ZoomMode): void;
+    /** Current scroll mode. */
+    get scrollMode(): ScrollMode;
+    /** Current layout mode. */
+    get layoutMode(): LayoutMode;
+    /** Current page rotation in degrees. */
+    get pageRotation(): PageRotation;
+    /** Current spacing mode. */
+    get spacingMode(): SpacingMode;
+    /** Whether the viewer is in fullscreen mode. */
+    get isFullscreen(): boolean;
+    /**
+     * Set scroll mode.
+     */
+    setScrollMode(mode: ScrollMode): void;
+    /**
+     * Set page layout mode.
+     */
+    setLayoutMode(mode: LayoutMode): void;
+    /**
+     * Set page rotation.
+     */
+    setPageRotation(rotation: PageRotation): void;
+    /**
+     * Set spacing mode.
+     */
+    setSpacingMode(mode: SpacingMode): void;
+    /**
+     * Enter or exit fullscreen mode.
+     */
+    setFullscreen(fullscreen: boolean): void;
+    /**
+     * Show or hide the top toolbar.
+     */
+    setToolbarVisible(visible: boolean): void;
+    /**
+     * Show or hide the floating toolbar (page navigation, zoom, view mode controls).
+     */
+    setFloatingToolbarVisible(visible: boolean): void;
+    /**
+     * Enable or disable the fullscreen button.
+     */
+    setFullscreenEnabled(enabled: boolean): void;
+    /**
+     * Enable or disable the entire left panel area.
+     * When disabled, the left panel is hidden and all left panel tabs are inaccessible.
+     */
+    setLeftPanelEnabled(enabled: boolean): void;
+    /**
+     * Enable or disable the entire right panel area.
+     * When disabled, the right panel is hidden and all right panel tabs are inaccessible.
+     */
+    setRightPanelEnabled(enabled: boolean): void;
+    /**
+     * Enable or disable a specific panel tab.
+     * Disabled panels are removed from the UI and cannot be opened.
+     * If the panel is currently open and being disabled, it will be closed.
+     */
+    setPanelEnabled(panel: PanelTab, enabled: boolean): void;
+    /**
+     * Open a specific panel.
+     * Has no effect if the panel is disabled via `setPanelEnabled()` or a `disable*` option.
+     */
+    openPanel(panel: PanelTab): void;
+    /**
+     * Close the currently open panel.
+     */
+    closePanel(): void;
     /**
      * Render a page to an image.
      *
@@ -271,5 +390,6 @@ export declare class UDocViewer {
     private createEngineAdapter;
     private ensureNotDestroyed;
     private ensureLoaded;
+    private ensureUiMode;
 }
 //# sourceMappingURL=UDocViewer.d.ts.map

package/dist/src/UDocViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UDocViewer.d.ts","sourceRoot":"","sources":["../../src/UDocViewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UDocViewer.d.ts","sourceRoot":"","sources":["../../src/UDocViewer.ts"],"names":[],"mappings":"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"}

package/dist/src/UDocViewer.js

@@ -5,8 +5,9 @@
  * Created via `client.createViewer()`.
  */
 import { mountViewerShell } from "./ui/viewer/shell.js";
-import { getFormatDefaults } from "./ui/viewer/state.js";
+import { getFormatDefaults, } from "./ui/viewer/state.js";
 import { PerformanceCounter, NoOpPerformanceCounter } from "./performance/index.js";
+import { reportDocumentOpen } from "./telemetry.js";
 /**
  * Document viewer component.
  *
@@ -26,13 +27,18 @@ export class UDocViewer {
     googleFontsEnabled;
     viewOverrides;
     currentFormat = null;
+    storeUnsub = null;
+    telemetryEnabled;
+    sdkVersion;
     /**
      * @internal
      * Use `client.createViewer()` instead.
      */
-    constructor(workerClient, options = {}, showAttribution = true) {
+    constructor(workerClient, options = {}, showAttribution = true, telemetryEnabled = true, sdkVersion = "__VERSION__") {
         this.workerClient = workerClient;
         this.googleFontsEnabled = options.googleFonts ?? true;
+        this.telemetryEnabled = telemetryEnabled;
+        this.sdkVersion = sdkVersion;
         this.viewOverrides = this.buildViewModeOverrides(options);
         // Initialize performance counter
         if (options.enablePerformanceCounter) {
@@ -53,6 +59,61 @@ export class UDocViewer {
             this.uiShell.setCallbacks({
                 onPasswordSubmit: (password) => this.handlePasswordSubmit(password),
             });
+            // Subscribe to store state changes to emit public events
+            this.storeUnsub = this.uiShell.store.subscribeEffect((prev, next) => {
+                if (prev.page !== next.page) {
+                    this.emit("page:change", { page: next.page, previousPage: prev.page });
+                }
+                if (prev.activePanel !== next.activePanel) {
+                    this.emit("panel:change", { panel: next.activePanel, previousPanel: prev.activePanel });
+                }
+                if (prev.toolbarVisible !== next.toolbarVisible) {
+                    this.emit("ui:visibilityChange", { component: "toolbar", visible: next.toolbarVisible });
+                }
+                if (prev.floatingToolbarVisible !== next.floatingToolbarVisible) {
+                    this.emit("ui:visibilityChange", {
+                        component: "floatingToolbar",
+                        visible: next.floatingToolbarVisible,
+                    });
+                }
+                if (prev.leftPanelVisible !== next.leftPanelVisible) {
+                    this.emit("ui:visibilityChange", {
+                        component: "leftPanel",
+                        visible: next.leftPanelVisible,
+                    });
+                }
+                if (prev.rightPanelVisible !== next.rightPanelVisible) {
+                    this.emit("ui:visibilityChange", {
+                        component: "rightPanel",
+                        visible: next.rightPanelVisible,
+                    });
+                }
+                if (prev.fullscreenButtonVisible !== next.fullscreenButtonVisible) {
+                    this.emit("ui:visibilityChange", {
+                        component: "fullscreen",
+                        visible: next.fullscreenButtonVisible,
+                    });
+                }
+                if (prev.disabledPanels !== next.disabledPanels) {
+                    // Emit events for panels whose disabled state changed
+                    const allPanels = [
+                        "thumbnail",
+                        "outline",
+                        "bookmarks",
+                        "layers",
+                        "attachments",
+                        "search",
+                        "comments",
+                    ];
+                    for (const panel of allPanels) {
+                        const wasDisabled = prev.disabledPanels.has(panel);
+                        const isDisabled = next.disabledPanels.has(panel);
+                        if (wasDisabled !== isDisabled) {
+                            this.emit("ui:visibilityChange", { component: panel, visible: !isDisabled });
+                        }
+                    }
+                }
+            });
         }
     }
     /**
@@ -82,6 +143,35 @@ export class UDocViewer {
             overrides.spreadSpacing = options.spreadSpacing;
         if (options.activePanel !== undefined)
             overrides.activePanel = options.activePanel;
+        if (options.hideToolbar)
+            overrides.toolbarVisible = false;
+        if (options.hideFloatingToolbar)
+            overrides.floatingToolbarVisible = false;
+        if (options.disableFullscreen)
+            overrides.fullscreenButtonVisible = false;
+        if (options.disableLeftPanel)
+            overrides.leftPanelVisible = false;
+        if (options.disableRightPanel)
+            overrides.rightPanelVisible = false;
+        // Collect individually disabled panels into the internal Set
+        const disabled = [];
+        if (options.disableThumbnails)
+            disabled.push("thumbnail");
+        if (options.disableOutline)
+            disabled.push("outline");
+        if (options.disableBookmarks)
+            disabled.push("bookmarks");
+        if (options.disableLayers)
+            disabled.push("layers");
+        if (options.disableAttachments)
+            disabled.push("attachments");
+        if (options.disableSearch)
+            disabled.push("search");
+        if (options.disableComments)
+            disabled.push("comments");
+        if (disabled.length > 0) {
+            overrides.disabledPanels = new Set(disabled);
+        }
         return overrides;
     }
     buildViewModeOverrides(options) {
@@ -177,6 +267,15 @@ export class UDocViewer {
                 this._performanceCounter.markEnd(initUiId);
             }
             this.emit("document:load", { pageCount: this._pageCount });
+            // Report telemetry (fire-and-forget, never throws)
+            if (this.telemetryEnabled) {
+                reportDocumentOpen({
+                    domain: typeof window !== "undefined" ? window.location.hostname : "unknown",
+                    format,
+                    size_bucket: Math.floor(bytes.length / 100_000),
+                    viewer_version: this.sdkVersion,
+                });
+            }
         }
         catch (error) {
             const phase = error instanceof TypeError ? "fetch" : "parse";
@@ -381,6 +480,231 @@ export class UDocViewer {
         }
         this.uiShell.dispatch({ type: "NAVIGATE_TO_DESTINATION", destination });
     }
+    /**
+     * Navigate to the next page.
+     */
+    nextPage() {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        const state = this.uiShell.getState();
+        if (state.page < state.pageCount) {
+            this.uiShell.dispatch({ type: "NAVIGATE_TO_PAGE", page: state.page + 1 });
+        }
+    }
+    /**
+     * Navigate to the previous page.
+     */
+    previousPage() {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        const state = this.uiShell.getState();
+        if (state.page > 1) {
+            this.uiShell.dispatch({ type: "NAVIGATE_TO_PAGE", page: state.page - 1 });
+        }
+    }
+    // ===========================================================================
+    // Zoom
+    // ===========================================================================
+    /**
+     * Current zoom level (1 = 100%).
+     */
+    get zoom() {
+        if (this.uiShell) {
+            const state = this.uiShell.getState();
+            return state.zoomMode === "custom" ? state.zoom : (state.effectiveZoom ?? state.zoom);
+        }
+        return 1;
+    }
+    /**
+     * Current zoom mode.
+     */
+    get zoomMode() {
+        if (this.uiShell) {
+            return this.uiShell.getState().zoomMode;
+        }
+        return "fit-spread-width";
+    }
+    /**
+     * Zoom in to the next zoom step.
+     */
+    zoomIn() {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "ZOOM_IN" });
+    }
+    /**
+     * Zoom out to the previous zoom step.
+     */
+    zoomOut() {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "ZOOM_OUT" });
+    }
+    /**
+     * Set zoom to a specific level (1 = 100%). Switches to custom zoom mode.
+     */
+    setZoom(zoom) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_ZOOM", zoom });
+    }
+    /**
+     * Set zoom mode.
+     */
+    setZoomMode(mode) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_ZOOM_MODE", mode });
+    }
+    // ===========================================================================
+    // View Modes
+    // ===========================================================================
+    /** Current scroll mode. */
+    get scrollMode() {
+        return this.uiShell?.getState().scrollMode ?? "continuous";
+    }
+    /** Current layout mode. */
+    get layoutMode() {
+        return this.uiShell?.getState().layoutMode ?? "single-page";
+    }
+    /** Current page rotation in degrees. */
+    get pageRotation() {
+        return this.uiShell?.getState().pageRotation ?? 0;
+    }
+    /** Current spacing mode. */
+    get spacingMode() {
+        return this.uiShell?.getState().spacingMode ?? "all";
+    }
+    /** Whether the viewer is in fullscreen mode. */
+    get isFullscreen() {
+        return this.uiShell?.getState().isFullscreen ?? false;
+    }
+    /**
+     * Set scroll mode.
+     */
+    setScrollMode(mode) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_SCROLL_MODE", mode });
+    }
+    /**
+     * Set page layout mode.
+     */
+    setLayoutMode(mode) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_LAYOUT_MODE", mode });
+    }
+    /**
+     * Set page rotation.
+     */
+    setPageRotation(rotation) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_PAGE_ROTATION", rotation });
+    }
+    /**
+     * Set spacing mode.
+     */
+    setSpacingMode(mode) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_SPACING_MODE", mode });
+    }
+    /**
+     * Enter or exit fullscreen mode.
+     */
+    setFullscreen(fullscreen) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_FULLSCREEN", isFullscreen: fullscreen });
+        // Also toggle the actual browser fullscreen
+        const root = this.container?.querySelector(".udoc-viewer-root");
+        if (root) {
+            if (fullscreen && !document.fullscreenElement) {
+                root.requestFullscreen().catch(() => { });
+            }
+            else if (!fullscreen && document.fullscreenElement) {
+                document.exitFullscreen().catch(() => { });
+            }
+        }
+    }
+    // ===========================================================================
+    // UI Component Visibility
+    // ===========================================================================
+    /**
+     * Show or hide the top toolbar.
+     */
+    setToolbarVisible(visible) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_TOOLBAR_VISIBLE", visible });
+    }
+    /**
+     * Show or hide the floating toolbar (page navigation, zoom, view mode controls).
+     */
+    setFloatingToolbarVisible(visible) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_FLOATING_TOOLBAR_VISIBLE", visible });
+    }
+    /**
+     * Enable or disable the fullscreen button.
+     */
+    setFullscreenEnabled(enabled) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_FULLSCREEN_BUTTON_VISIBLE", visible: enabled });
+    }
+    /**
+     * Enable or disable the entire left panel area.
+     * When disabled, the left panel is hidden and all left panel tabs are inaccessible.
+     */
+    setLeftPanelEnabled(enabled) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_LEFT_PANEL_VISIBLE", visible: enabled });
+    }
+    /**
+     * Enable or disable the entire right panel area.
+     * When disabled, the right panel is hidden and all right panel tabs are inaccessible.
+     */
+    setRightPanelEnabled(enabled) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_RIGHT_PANEL_VISIBLE", visible: enabled });
+    }
+    /**
+     * Enable or disable a specific panel tab.
+     * Disabled panels are removed from the UI and cannot be opened.
+     * If the panel is currently open and being disabled, it will be closed.
+     */
+    setPanelEnabled(panel, enabled) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_PANEL_DISABLED", panel, disabled: !enabled });
+    }
+    /**
+     * Open a specific panel.
+     * Has no effect if the panel is disabled via `setPanelEnabled()` or a `disable*` option.
+     */
+    openPanel(panel) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "TOGGLE_PANEL", panel });
+        // If it was already open, TOGGLE_PANEL closed it. Re-open.
+        if (this.uiShell.getState().activePanel !== panel) {
+            this.uiShell.dispatch({ type: "TOGGLE_PANEL", panel });
+        }
+    }
+    /**
+     * Close the currently open panel.
+     */
+    closePanel() {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "CLOSE_PANEL" });
+    }
     // ===========================================================================
     // Page Rendering
     // ===========================================================================
@@ -526,6 +850,10 @@ export class UDocViewer {
         if (this.destroyed)
             return;
         this.destroyed = true;
+        if (this.storeUnsub) {
+            this.storeUnsub();
+            this.storeUnsub = null;
+        }
         if (this.uiShell) {
             this.uiShell.destroy();
             this.uiShell = null;
@@ -701,6 +1029,11 @@ export class UDocViewer {
             throw new Error("No document loaded");
         }
     }
+    ensureUiMode() {
+        if (!this.uiShell) {
+            throw new Error("This method requires UI mode (container must be provided)");
+        }
+    }
 }
 /**
  * Detect document format based on magic bytes and filename.