@docmentis/udoc-viewer 0.1.0

package/dist/components/panels/ThumbnailsPanel.js

@@ -0,0 +1,160 @@
+import { THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT } from '../../constants';
+/**
+ * Panel component for displaying page thumbnails with lazy loading.
+ */
+export class ThumbnailsPanel {
+    container = null;
+    callbacks;
+    observer = null;
+    blobUrls = new Map();
+    queue = [];
+    isRendering = false;
+    pauseRendering = false;
+    currentPage = 0;
+    pageCount = 0;
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+    }
+    /**
+     * Render thumbnails into the given container.
+     */
+    render(container, pageCount, currentPage) {
+        this.container = container;
+        this.pageCount = pageCount;
+        this.currentPage = currentPage;
+        this.clear();
+        // Set up IntersectionObserver for lazy loading
+        this.observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting) {
+                    const img = entry.target;
+                    const pageIndex = parseInt(img.dataset.pageIndex, 10);
+                    const width = parseInt(img.dataset.thumbWidth, 10);
+                    const height = parseInt(img.dataset.thumbHeight, 10);
+                    // Stop observing this thumbnail
+                    this.observer?.unobserve(img);
+                    // Queue the thumbnail for rendering
+                    this.enqueueThumbnail(pageIndex, img, width, height);
+                }
+            }
+        }, {
+            root: container.parentElement, // The panel element
+            rootMargin: '100px', // Pre-load thumbnails 100px before they become visible
+        });
+        for (let i = 0; i < pageCount; i++) {
+            const { width: pageWidth, height: pageHeight } = this.callbacks.getPageSize(i);
+            // Calculate thumbnail size maintaining aspect ratio
+            const scale = Math.min(THUMBNAIL_WIDTH / pageWidth, THUMBNAIL_HEIGHT / pageHeight);
+            const thumbWidth = Math.round(pageWidth * scale);
+            const thumbHeight = Math.round(pageHeight * scale);
+            // Create thumbnail container
+            const thumb = document.createElement('div');
+            thumb.className = 'udoc-thumbnail';
+            if (i === currentPage) {
+                thumb.classList.add('selected');
+            }
+            thumb.addEventListener('click', () => this.callbacks.onPageClick(i));
+            // Create placeholder image with data attributes for lazy loading
+            const img = document.createElement('img');
+            img.style.maxWidth = `${thumbWidth}px`;
+            img.style.aspectRatio = `${thumbWidth} / ${thumbHeight}`;
+            img.alt = `Page ${i + 1}`;
+            img.dataset.pageIndex = String(i);
+            img.dataset.thumbWidth = String(thumbWidth);
+            img.dataset.thumbHeight = String(thumbHeight);
+            // Page number label
+            const label = document.createElement('div');
+            label.className = 'udoc-thumbnail-label';
+            label.textContent = String(i + 1);
+            thumb.append(img, label);
+            container.appendChild(thumb);
+            // Observe the image for lazy loading
+            this.observer.observe(img);
+        }
+    }
+    /**
+     * Update the currently selected page and scroll it into view.
+     * @param scrollBehavior - 'auto' for instant scroll, 'smooth' for animated
+     */
+    setCurrentPage(pageIndex, scrollBehavior = 'smooth') {
+        if (!this.container)
+            return;
+        if (this.currentPage === pageIndex)
+            return;
+        this.currentPage = pageIndex;
+        const thumbnails = this.container.querySelectorAll('.udoc-thumbnail');
+        thumbnails.forEach((thumb, index) => {
+            thumb.classList.toggle('selected', index === pageIndex);
+        });
+        // Scroll selected thumbnail into view
+        const selected = this.container.querySelector('.udoc-thumbnail.selected');
+        selected?.scrollIntoView({ block: 'nearest', behavior: scrollBehavior });
+    }
+    /**
+     * Pause thumbnail rendering (e.g., during scroll).
+     */
+    pause() {
+        this.pauseRendering = true;
+    }
+    /**
+     * Resume thumbnail rendering.
+     */
+    resume() {
+        this.pauseRendering = false;
+        this.processQueue();
+    }
+    /**
+     * Clear all thumbnails and release resources.
+     */
+    clear() {
+        // Disconnect observer
+        if (this.observer) {
+            this.observer.disconnect();
+            this.observer = null;
+        }
+        // Revoke all blob URLs
+        for (const url of this.blobUrls.values()) {
+            URL.revokeObjectURL(url);
+        }
+        this.blobUrls.clear();
+        // Clear queue
+        this.queue = [];
+        this.isRendering = false;
+        // Clear container
+        if (this.container) {
+            this.container.innerHTML = '';
+        }
+    }
+    /**
+     * Destroy the panel and release all resources.
+     */
+    destroy() {
+        this.clear();
+        this.container = null;
+    }
+    enqueueThumbnail(pageIndex, img, width, height) {
+        this.queue.push({ pageIndex, img, width, height });
+        this.processQueue();
+    }
+    async processQueue() {
+        if (this.pauseRendering || this.isRendering)
+            return;
+        const next = this.queue.shift();
+        if (!next)
+            return;
+        this.isRendering = true;
+        try {
+            const url = await this.callbacks.renderThumbnail(next.pageIndex, next.width, next.height);
+            this.blobUrls.set(next.pageIndex, url);
+            next.img.src = url;
+        }
+        catch (error) {
+            console.error(`Failed to render thumbnail for page ${next.pageIndex}:`, error);
+        }
+        finally {
+            this.isRendering = false;
+            this.processQueue();
+        }
+    }
+}
+//# sourceMappingURL=ThumbnailsPanel.js.map

package/dist/components/panels/ThumbnailsPanel.js.map

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

package/dist/components/panels/index.d.ts

@@ -0,0 +1,7 @@
+export { ThumbnailsPanel } from './ThumbnailsPanel';
+export type { ThumbnailsPanelCallbacks } from './ThumbnailsPanel';
+export { OutlinePanel } from './OutlinePanel';
+export type { OutlinePanelCallbacks } from './OutlinePanel';
+export { CommentsPanel } from './CommentsPanel';
+export type { CommentsPanelCallbacks } from './CommentsPanel';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/panels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/panels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/panels/index.js

@@ -0,0 +1,4 @@
+export { ThumbnailsPanel } from './ThumbnailsPanel';
+export { OutlinePanel } from './OutlinePanel';
+export { CommentsPanel } from './CommentsPanel';
+//# sourceMappingURL=index.js.map

package/dist/components/panels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/panels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,25 @@
+import type { UDocViewerOptions } from './types';
+export { PAGE_GAP_SIZE } from './types';
+/**
+ * Zoom levels for stepped zoom (used by zoomIn/zoomOut buttons).
+ */
+export declare const ZOOM_LEVELS: number[];
+/**
+ * Default options for UDocViewer.
+ */
+export declare const DEFAULT_OPTIONS: Required<UDocViewerOptions>;
+/**
+ * PDF uses 72 points per inch, CSS uses 96 pixels per inch.
+ * This factor converts PDF points to CSS pixels at "actual size" (100% zoom).
+ */
+export declare const POINTS_TO_CSS_PIXELS: number;
+/**
+ * Empty 1x1 transparent GIF used as placeholder image.
+ */
+export declare const EMPTY_IMAGE_DATA_URL = "data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=";
+/**
+ * Thumbnail display dimensions.
+ */
+export declare const THUMBNAIL_WIDTH = 120;
+export declare const THUMBNAIL_HEIGHT = 160;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,WAAW,UAA6D,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,iBAAiB,CAqBvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,oBAAoB,+DAA+D,CAAC;AAEjG;;GAEG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC"}

package/dist/constants.js

@@ -0,0 +1,46 @@
+// Re-export PAGE_GAP_SIZE for convenience
+export { PAGE_GAP_SIZE } from './types';
+/**
+ * Zoom levels for stepped zoom (used by zoomIn/zoomOut buttons).
+ */
+export const ZOOM_LEVELS = [0.1, 0.25, 0.5, 0.75, 1.0, 1.25, 1.5, 2.0, 3.0, 4.0, 5.0];
+/**
+ * Default options for UDocViewer.
+ */
+export const DEFAULT_OPTIONS = {
+    initialZoom: 1.0,
+    initialZoomMode: 'fit-page',
+    displayMode: 'scroll',
+    layoutMode: 'single',
+    rotation: 0,
+    seamless: false,
+    grid: { columns: 2, rows: 2 },
+    maxZoom: 5.0,
+    minZoom: 0.05,
+    zoomStep: 0.25,
+    renderFormat: 'png',
+    pageCacheSize: 100,
+    showHeader: true,
+    showSidebar: true,
+    sidebarOpen: false,
+    showLeftPanel: true,
+    leftPanelOpen: false,
+    showRightPanel: true,
+    rightPanelOpen: false,
+    showFloatingBar: true,
+};
+/**
+ * PDF uses 72 points per inch, CSS uses 96 pixels per inch.
+ * This factor converts PDF points to CSS pixels at "actual size" (100% zoom).
+ */
+export const POINTS_TO_CSS_PIXELS = 96 / 72;
+/**
+ * Empty 1x1 transparent GIF used as placeholder image.
+ */
+export const EMPTY_IMAGE_DATA_URL = 'data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=';
+/**
+ * Thumbnail display dimensions.
+ */
+export const THUMBNAIL_WIDTH = 120;
+export const THUMBNAIL_HEIGHT = 160;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgC;IACxD,WAAW,EAAE,GAAG;IAChB,eAAe,EAAE,UAAU;IAC3B,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IAC7B,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,IAAI;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,4DAA4D,CAAC;AAEjG;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC"}

package/dist/core/NavigationController.d.ts

@@ -0,0 +1,54 @@
+import type { ViewerState } from './ViewerState';
+import type { LayoutState } from '../layout/LayoutState';
+import type { DestinationDisplay } from './types';
+/**
+ * Dependencies required by NavigationController.
+ */
+export interface NavigationDeps {
+    state: ViewerState;
+    layoutState: LayoutState;
+    viewport: HTMLElement;
+    getEffectivePadding: () => number;
+    getEffectiveBandOffset: (bandIndex: number) => number;
+}
+/**
+ * Handles scroll position calculations and navigation within the document.
+ *
+ * This controller manages:
+ * - Scrolling to page centers
+ * - Scrolling to specific destinations (PDF destinations with various display types)
+ * - Calculating page positions in content coordinates
+ */
+export declare class NavigationController {
+    private deps;
+    private suppressScrollHandling;
+    constructor(deps: NavigationDeps);
+    /**
+     * Scroll to center a page in the viewport.
+     */
+    scrollToPageCenter(pageIndex: number): void;
+    /**
+     * Scroll to a specific destination within a page.
+     *
+     * Converts document coordinates (points, top-left origin) to viewport scroll position.
+     */
+    scrollToDestination(pageIndex: number, display: DestinationDisplay): void;
+    /**
+     * Get the center position of a page in content coordinates.
+     */
+    getPageCenterInContent(pageIndex: number): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Check if scroll handling is currently suppressed.
+     */
+    isScrollSuppressed(): boolean;
+    /**
+     * Execute an action with scroll handling suppressed.
+     * This prevents scroll events from triggering page change detection
+     * while programmatically setting scroll position.
+     */
+    withScrollSuppressed(action: () => void): void;
+}
+//# sourceMappingURL=NavigationController.d.ts.map

package/dist/core/NavigationController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationController.d.ts","sourceRoot":"","sources":["../../src/core/NavigationController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,IAAI,EAAE,cAAc;IAIhC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAe3C;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAoFzE;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAe1E;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;CAOjD"}

package/dist/core/NavigationController.js

@@ -0,0 +1,145 @@
+import { POINTS_TO_CSS_PIXELS } from './constants';
+/**
+ * Handles scroll position calculations and navigation within the document.
+ *
+ * This controller manages:
+ * - Scrolling to page centers
+ * - Scrolling to specific destinations (PDF destinations with various display types)
+ * - Calculating page positions in content coordinates
+ */
+export class NavigationController {
+    deps;
+    suppressScrollHandling = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Scroll to center a page in the viewport.
+     */
+    scrollToPageCenter(pageIndex) {
+        const center = this.getPageCenterInContent(pageIndex);
+        if (!center)
+            return;
+        const { viewport } = this.deps;
+        const padding = this.deps.getEffectivePadding();
+        const scrollLeft = center.x + padding - viewport.clientWidth / 2;
+        const scrollTop = center.y + padding - viewport.clientHeight / 2;
+        this.withScrollSuppressed(() => {
+            viewport.scrollLeft = scrollLeft;
+            viewport.scrollTop = scrollTop;
+        });
+    }
+    /**
+     * Scroll to a specific destination within a page.
+     *
+     * Converts document coordinates (points, top-left origin) to viewport scroll position.
+     */
+    scrollToDestination(pageIndex, display) {
+        const entry = this.deps.layoutState.getSlotForPage(pageIndex);
+        if (!entry) {
+            // Fallback to page center if slot not found
+            this.scrollToPageCenter(pageIndex);
+            return;
+        }
+        const { state, viewport } = this.deps;
+        const padding = this.deps.getEffectivePadding();
+        const zoom = state.get('zoom');
+        const displayMode = state.get('displayMode');
+        const bandOffset = displayMode === 'scroll'
+            ? this.deps.getEffectiveBandOffset(entry.bandIndex)
+            : 0;
+        // Page origin in content coordinates (CSS pixels × zoom)
+        const pageOriginX = entry.slot.x;
+        const pageOriginY = bandOffset + entry.slot.y;
+        // Calculate scroll position based on display type
+        let scrollLeft;
+        let scrollTop;
+        switch (display.type) {
+            case 'fitH':
+            case 'fitBH': {
+                // Fit width - scroll Y to specified top position
+                const top = display.top ?? 0;
+                const contentY = pageOriginY + top * POINTS_TO_CSS_PIXELS * zoom;
+                // Center horizontally, position top at viewport top
+                scrollLeft = pageOriginX + entry.slot.width / 2 + padding - viewport.clientWidth / 2;
+                scrollTop = contentY + padding;
+                break;
+            }
+            case 'fitV':
+            case 'fitBV': {
+                // Fit height - scroll X to specified left position
+                const left = display.left ?? 0;
+                const contentX = pageOriginX + left * POINTS_TO_CSS_PIXELS * zoom;
+                // Position left at viewport left, center vertically
+                scrollLeft = contentX + padding;
+                scrollTop = pageOriginY + entry.slot.height / 2 + padding - viewport.clientHeight / 2;
+                break;
+            }
+            case 'xyz': {
+                // Go to specific position
+                const left = display.left ?? 0;
+                const top = display.top ?? 0;
+                const contentX = pageOriginX + left * POINTS_TO_CSS_PIXELS * zoom;
+                const contentY = pageOriginY + top * POINTS_TO_CSS_PIXELS * zoom;
+                // Position (left, top) at viewport top-left corner
+                scrollLeft = contentX + padding;
+                scrollTop = contentY + padding;
+                break;
+            }
+            case 'fitR': {
+                // Fit rectangle - scroll to center of rectangle
+                const centerX = (display.left + display.right) / 2;
+                const centerY = (display.top + display.bottom) / 2;
+                const contentX = pageOriginX + centerX * POINTS_TO_CSS_PIXELS * zoom;
+                const contentY = pageOriginY + centerY * POINTS_TO_CSS_PIXELS * zoom;
+                // Center the rectangle in viewport
+                scrollLeft = contentX + padding - viewport.clientWidth / 2;
+                scrollTop = contentY + padding - viewport.clientHeight / 2;
+                break;
+            }
+            default:
+                // For fit/fitB, just center the page
+                this.scrollToPageCenter(pageIndex);
+                return;
+        }
+        this.withScrollSuppressed(() => {
+            viewport.scrollLeft = Math.max(0, scrollLeft);
+            viewport.scrollTop = Math.max(0, scrollTop);
+        });
+    }
+    /**
+     * Get the center position of a page in content coordinates.
+     */
+    getPageCenterInContent(pageIndex) {
+        const entry = this.deps.layoutState.getSlotForPage(pageIndex);
+        if (!entry)
+            return null;
+        const displayMode = this.deps.state.get('displayMode');
+        const bandOffset = displayMode === 'scroll'
+            ? this.deps.getEffectiveBandOffset(entry.bandIndex)
+            : 0;
+        return {
+            x: entry.slot.x + entry.slot.width / 2,
+            y: bandOffset + entry.slot.y + entry.slot.height / 2,
+        };
+    }
+    /**
+     * Check if scroll handling is currently suppressed.
+     */
+    isScrollSuppressed() {
+        return this.suppressScrollHandling;
+    }
+    /**
+     * Execute an action with scroll handling suppressed.
+     * This prevents scroll events from triggering page change detection
+     * while programmatically setting scroll position.
+     */
+    withScrollSuppressed(action) {
+        this.suppressScrollHandling = true;
+        action();
+        requestAnimationFrame(() => {
+            this.suppressScrollHandling = false;
+        });
+    }
+}
+//# sourceMappingURL=NavigationController.js.map

package/dist/core/NavigationController.js.map

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

package/dist/core/PerfTimer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Performance timing helper for debugging and profiling.
+ * Provides simple start/end markers with elapsed time logging.
+ */
+export declare class PerfTimer {
+    private startTime;
+    private marks;
+    constructor();
+    start(name: string): void;
+    end(name: string): void;
+}
+//# sourceMappingURL=PerfTimer.d.ts.map

package/dist/core/PerfTimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfTimer.d.ts","sourceRoot":"","sources":["../../src/core/PerfTimer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAkC;;IAO/C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAY1B"}

package/dist/core/PerfTimer.js

@@ -0,0 +1,32 @@
+/**
+ * Performance timing helper for debugging and profiling.
+ * Provides simple start/end markers with elapsed time logging.
+ */
+export class PerfTimer {
+    startTime;
+    marks = new Map();
+    constructor() {
+        this.startTime = performance.now();
+        console.log('[perf] timer-start @0.0ms');
+    }
+    start(name) {
+        const now = performance.now();
+        const elapsed = now - this.startTime;
+        this.marks.set(name, now);
+        console.log(`[perf] ${name}-start @${elapsed.toFixed(1)}ms`);
+    }
+    end(name) {
+        const now = performance.now();
+        const startTime = this.marks.get(name);
+        const elapsed = now - this.startTime;
+        if (startTime !== undefined) {
+            const duration = now - startTime;
+            console.log(`[perf] ${name}-end @${elapsed.toFixed(1)}ms (duration: ${duration.toFixed(1)}ms)`);
+            this.marks.delete(name);
+        }
+        else {
+            console.log(`[perf] ${name}-end @${elapsed.toFixed(1)}ms (no start)`);
+        }
+    }
+}
+//# sourceMappingURL=PerfTimer.js.map

package/dist/core/PerfTimer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfTimer.js","sourceRoot":"","sources":["../../src/core/PerfTimer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAS;IACV,SAAS,CAAS;IAClB,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE/C;QACI,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAY;QACd,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,GAAG,GAAG,SAAS,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC1E,CAAC;IACL,CAAC;CACJ"}

package/dist/core/ViewerState.d.ts

@@ -0,0 +1,108 @@
+import type { ZoomMode, DisplayMode, LayoutMode, Rotation, GridOptions, LeftPanelTab, RightPanelTab, Tool } from './types';
+/**
+ * Map of all viewer state properties and their types.
+ */
+export interface ViewerStateMap {
+    isLoading: boolean;
+    isLoaded: boolean;
+    pageCount: number;
+    currentPage: number;
+    zoom: number;
+    zoomMode: ZoomMode;
+    displayMode: DisplayMode;
+    layoutMode: LayoutMode;
+    rotation: Rotation;
+    seamless: boolean;
+    grid: GridOptions;
+    leftPanelOpen: boolean;
+    rightPanelOpen: boolean;
+    leftPanelActiveTab: LeftPanelTab;
+    rightPanelActiveTab: RightPanelTab;
+    activeTool: Tool;
+    isFullscreen: boolean;
+}
+/**
+ * Default state values for the viewer.
+ */
+export declare const DEFAULT_STATE: ViewerStateMap;
+/**
+ * Callback type for state change listeners.
+ */
+export type StateListener<K extends keyof ViewerStateMap> = (value: ViewerStateMap[K], oldValue: ViewerStateMap[K]) => void;
+/**
+ * Centralized reactive state management for the viewer.
+ *
+ * Provides a simple pub/sub pattern for state changes, allowing components
+ * to subscribe to specific state keys and be notified when they change.
+ *
+ * @example
+ * ```typescript
+ * const state = new ViewerState();
+ *
+ * // Subscribe to zoom changes
+ * const unsubscribe = state.subscribe('zoom', (newZoom, oldZoom) => {
+ *   console.log(`Zoom changed from ${oldZoom} to ${newZoom}`);
+ * });
+ *
+ * // Update state
+ * state.set('zoom', 1.5);
+ *
+ * // Cleanup
+ * unsubscribe();
+ * ```
+ */
+export declare class ViewerState {
+    private state;
+    private listeners;
+    private batchDepth;
+    private pendingNotifications;
+    constructor(initialState?: Partial<ViewerStateMap>);
+    /**
+     * Get a state value.
+     */
+    get<K extends keyof ViewerStateMap>(key: K): ViewerStateMap[K];
+    /**
+     * Get a snapshot of the entire state.
+     */
+    getAll(): Readonly<ViewerStateMap>;
+    /**
+     * Set a state value and notify subscribers.
+     * Uses strict equality (===) to determine if the value has changed.
+     */
+    set<K extends keyof ViewerStateMap>(key: K, value: ViewerStateMap[K]): void;
+    /**
+     * Subscribe to state changes for a specific key.
+     * @returns Unsubscribe function
+     */
+    subscribe<K extends keyof ViewerStateMap>(key: K, callback: StateListener<K>): () => void;
+    /**
+     * Batch multiple state updates together.
+     * Notifications are deferred until the batch completes.
+     *
+     * @example
+     * ```typescript
+     * state.batch(() => {
+     *   state.set('zoom', 1.5);
+     *   state.set('zoomMode', 'custom');
+     * });
+     * // Both notifications fire together after batch completes
+     * ```
+     */
+    batch(updates: () => void): void;
+    /**
+     * Update multiple state values at once.
+     * This is a convenience method that wraps updates in a batch.
+     */
+    update(updates: Partial<ViewerStateMap>): void;
+    /**
+     * Reset state to initial values, optionally with overrides.
+     */
+    reset(overrides?: Partial<ViewerStateMap>): void;
+    /**
+     * Remove all listeners. Useful for cleanup.
+     */
+    clearListeners(): void;
+    private notify;
+    private flushNotifications;
+}
+//# sourceMappingURL=ViewerState.d.ts.map

package/dist/core/ViewerState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerState.d.ts","sourceRoot":"","sources":["../../src/core/ViewerState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,QAAQ,EACR,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,IAAI,EACP,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,cAAc;IAE3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAGpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAGlB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,YAAY,CAAC;IACjC,mBAAmB,EAAE,aAAa,CAAC;IAGnC,UAAU,EAAE,IAAI,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,cAkB3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,cAAc,IAAI,CACxD,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,KAC1B,IAAI,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,oBAAoB,CAA0E;gBAE1F,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKlD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IAI9D;;OAEG;IACH,MAAM,IAAI,QAAQ,CAAC,cAAc,CAAC;IAIlC;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAoB3E;;;OAGG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,cAAc,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAC3B,MAAM,IAAI;IAYb;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAYhC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAQ9C;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAShD;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,kBAAkB;CAQ7B"}