@docmentis/udoc-viewer 0.1.0

package/dist/core/ViewerState.js

@@ -0,0 +1,179 @@
+/**
+ * Default state values for the viewer.
+ */
+export const DEFAULT_STATE = {
+    isLoading: false,
+    isLoaded: false,
+    pageCount: 0,
+    currentPage: 0,
+    zoom: 1.0,
+    zoomMode: 'fit-page',
+    displayMode: 'scroll',
+    layoutMode: 'single',
+    rotation: 0,
+    seamless: false,
+    grid: { columns: 2, rows: 2 },
+    leftPanelOpen: false,
+    rightPanelOpen: false,
+    leftPanelActiveTab: 'thumbnails',
+    rightPanelActiveTab: 'comments',
+    activeTool: 'select',
+    isFullscreen: false,
+};
+/**
+ * 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 class ViewerState {
+    state;
+    listeners;
+    batchDepth = 0;
+    pendingNotifications = new Map();
+    constructor(initialState) {
+        this.state = { ...DEFAULT_STATE, ...initialState };
+        this.listeners = new Map();
+    }
+    /**
+     * Get a state value.
+     */
+    get(key) {
+        return this.state[key];
+    }
+    /**
+     * Get a snapshot of the entire state.
+     */
+    getAll() {
+        return { ...this.state };
+    }
+    /**
+     * Set a state value and notify subscribers.
+     * Uses strict equality (===) to determine if the value has changed.
+     */
+    set(key, value) {
+        const oldValue = this.state[key];
+        if (oldValue === value)
+            return;
+        this.state[key] = value;
+        if (this.batchDepth > 0) {
+            // During batch, accumulate notifications
+            // Only store first old value if key not already pending
+            if (!this.pendingNotifications.has(key)) {
+                this.pendingNotifications.set(key, { newValue: value, oldValue });
+            }
+            else {
+                // Update to latest new value, keep original old value
+                this.pendingNotifications.get(key).newValue = value;
+            }
+        }
+        else {
+            this.notify(key, value, oldValue);
+        }
+    }
+    /**
+     * Subscribe to state changes for a specific key.
+     * @returns Unsubscribe function
+     */
+    subscribe(key, callback) {
+        if (!this.listeners.has(key)) {
+            this.listeners.set(key, new Set());
+        }
+        this.listeners.get(key).add(callback);
+        // Return unsubscribe function
+        return () => {
+            this.listeners.get(key)?.delete(callback);
+        };
+    }
+    /**
+     * 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) {
+        this.batchDepth++;
+        try {
+            updates();
+        }
+        finally {
+            this.batchDepth--;
+            if (this.batchDepth === 0) {
+                this.flushNotifications();
+            }
+        }
+    }
+    /**
+     * Update multiple state values at once.
+     * This is a convenience method that wraps updates in a batch.
+     */
+    update(updates) {
+        this.batch(() => {
+            for (const [key, value] of Object.entries(updates)) {
+                this.set(key, value);
+            }
+        });
+    }
+    /**
+     * Reset state to initial values, optionally with overrides.
+     */
+    reset(overrides) {
+        const newState = { ...DEFAULT_STATE, ...overrides };
+        this.batch(() => {
+            for (const key of Object.keys(this.state)) {
+                this.set(key, newState[key]);
+            }
+        });
+    }
+    /**
+     * Remove all listeners. Useful for cleanup.
+     */
+    clearListeners() {
+        this.listeners.clear();
+    }
+    notify(key, value, oldValue) {
+        const callbacks = this.listeners.get(key);
+        if (callbacks) {
+            // Create a copy to handle unsubscriptions during iteration
+            for (const callback of Array.from(callbacks)) {
+                try {
+                    callback(value, oldValue);
+                }
+                catch (error) {
+                    console.error(`Error in ViewerState listener for '${key}':`, error);
+                }
+            }
+        }
+    }
+    flushNotifications() {
+        const notifications = this.pendingNotifications;
+        this.pendingNotifications = new Map();
+        for (const [key, { newValue, oldValue }] of notifications) {
+            this.notify(key, newValue, oldValue);
+        }
+    }
+}
+//# sourceMappingURL=ViewerState.js.map

package/dist/core/ViewerState.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,24 @@
+import type { UDocViewerOptions } from './types';
+/**
+ * Zoom levels for stepped zoom (used by zoomIn/zoomOut buttons).
+ */
+export declare const ZOOM_LEVELS: number[];
+/**
+ * Default options for the viewer.
+ */
+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 image data URL for placeholder images.
+ */
+export declare const EMPTY_IMAGE_DATA_URL = "data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=";
+/**
+ * Thumbnail settings.
+ */
+export declare const THUMBNAIL_WIDTH = 120;
+export declare const THUMBNAIL_HEIGHT = 160;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,WAAW,UAA6D,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,iBAAiB,CAmBvD,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/core/constants.js

@@ -0,0 +1,42 @@
+/**
+ * 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 the viewer.
+ */
+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,
+    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 image data URL for placeholder images.
+ */
+export const EMPTY_IMAGE_DATA_URL = 'data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=';
+/**
+ * Thumbnail settings.
+ */
+export const THUMBNAIL_WIDTH = 120;
+export const THUMBNAIL_HEIGHT = 160;
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

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

@@ -0,0 +1,8 @@
+export * from './types';
+export { ZOOM_LEVELS, DEFAULT_OPTIONS, POINTS_TO_CSS_PIXELS, EMPTY_IMAGE_DATA_URL, THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT, } from './constants';
+export { ViewerState, DEFAULT_STATE } from './ViewerState';
+export type { ViewerStateMap, StateListener } from './ViewerState';
+export { PerfTimer } from './PerfTimer';
+export { NavigationController } from './NavigationController';
+export type { NavigationDeps } from './NavigationController';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACH,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,11 @@
+// Types
+export * from './types';
+// Constants
+export { ZOOM_LEVELS, DEFAULT_OPTIONS, POINTS_TO_CSS_PIXELS, EMPTY_IMAGE_DATA_URL, THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT, } from './constants';
+// State management
+export { ViewerState, DEFAULT_STATE } from './ViewerState';
+// Utilities
+export { PerfTimer } from './PerfTimer';
+// Navigation
+export { NavigationController } from './NavigationController';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,YAAY;AACZ,OAAO,EACH,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACnB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG3D,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,aAAa;AACb,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}