@docmentis/udoc-viewer 0.1.0

package/dist/styles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/styles/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+rC3B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export all types from core/types.ts for backward compatibility.
+ * New code should import directly from './core' or './core/types'.
+ */
+export * from './core/types';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,cAAc,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Re-export all types from core/types.ts for backward compatibility.
+ * New code should import directly from './core' or './core/types'.
+ */
+export * from './core/types';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,cAAc,CAAC"}

package/dist/ui/Component.d.ts

@@ -0,0 +1,127 @@
+import type { ViewerStateMap, StateListener } from '../core/ViewerState';
+import type { UDocViewer } from '../UDocViewer';
+/**
+ * Base class for all UI components in the viewer.
+ *
+ * Uses two-phase initialization to avoid the "virtual method call in constructor" anti-pattern.
+ * Subclasses must call init() after construction to complete initialization.
+ *
+ * Provides a consistent pattern for:
+ * - DOM element creation and management
+ * - Event binding with automatic cleanup
+ * - State subscription with automatic cleanup
+ * - Component lifecycle (mount, update, destroy)
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends Component<HTMLDivElement> {
+ *   protected createElement(): HTMLDivElement {
+ *     const div = document.createElement('div');
+ *     div.className = 'my-component';
+ *     return div;
+ *   }
+ *
+ *   protected subscribeToState(): void {
+ *     this.subscribe('zoom', (zoom) => {
+ *       this.element.style.transform = `scale(${zoom})`;
+ *     });
+ *   }
+ * }
+ *
+ * // Usage:
+ * const component = new MyComponent(viewer).init();
+ * ```
+ */
+export declare abstract class Component<T extends HTMLElement = HTMLElement> {
+    protected element: T;
+    protected viewer: UDocViewer;
+    private subscriptions;
+    private eventCleanups;
+    private mounted;
+    private initialized;
+    constructor(viewer: UDocViewer);
+    /**
+     * Initialize the component. Must be called after construction.
+     * This two-phase initialization allows subclass instance fields to be
+     * initialized before createElement() is called.
+     *
+     * @returns this for method chaining
+     */
+    init(): this;
+    /**
+     * Create the component's DOM element.
+     * Must be implemented by subclasses.
+     */
+    protected abstract createElement(): T;
+    /**
+     * Bind DOM event listeners.
+     * Override in subclasses to add event handlers.
+     * Use addEventCleanup() to register cleanup functions.
+     */
+    protected bindEvents(): void;
+    /**
+     * Subscribe to state changes.
+     * Override in subclasses to react to state updates.
+     * Use subscribe() helper for automatic cleanup.
+     */
+    protected subscribeToState(): void;
+    /**
+     * Subscribe to a state key with automatic cleanup.
+     *
+     * @param key The state key to subscribe to
+     * @param callback Function called when state changes
+     * @param immediate If true, call callback immediately with current value (default: true)
+     */
+    protected subscribe<K extends keyof ViewerStateMap>(key: K, callback: StateListener<K>, immediate?: boolean): void;
+    /**
+     * Register an event cleanup function.
+     * Will be called during destroy().
+     */
+    protected addEventCleanup(cleanup: () => void): void;
+    /**
+     * Helper to add an event listener with automatic cleanup.
+     */
+    protected addEventListener<K extends keyof HTMLElementEventMap>(target: HTMLElement | Document | Window, type: K, listener: (ev: HTMLElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+    /**
+     * Mount component to a parent element.
+     *
+     * @param parent The parent element to mount to
+     * @param position Optional position (default: append at end)
+     */
+    mount(parent: HTMLElement, position?: 'prepend' | 'append'): void;
+    /**
+     * Called after the component is mounted.
+     * Override in subclasses for post-mount initialization.
+     */
+    protected onMount(): void;
+    /**
+     * Update component state.
+     * Override in subclasses for imperative updates.
+     */
+    update(): void;
+    /**
+     * Check if component is initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if component is mounted.
+     */
+    isMounted(): boolean;
+    /**
+     * Get the underlying DOM element.
+     * @throws Error if component is not initialized
+     */
+    getElement(): T;
+    /**
+     * Cleanup and remove component.
+     * Removes event listeners, state subscriptions, and DOM element.
+     * Safe to call even if init() was never called.
+     */
+    destroy(): void;
+    /**
+     * Called during destroy for subclass cleanup.
+     * Override in subclasses for additional cleanup.
+     */
+    protected onDestroy(): void;
+}
+//# sourceMappingURL=Component.d.ts.map

package/dist/ui/Component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../../src/ui/Component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,8BAAsB,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC/D,SAAS,CAAC,OAAO,EAAG,CAAC,CAAC;IACtB,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;IAC7B,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,UAAU;IAI9B;;;;;;OAMG;IACH,IAAI,IAAI,IAAI;IAYZ;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,UAAU,IAAI,IAAI;IAE5B;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAElC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,cAAc,EAC9C,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,SAAS,GAAE,OAAc,GAC1B,IAAI;IAWP;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAC1D,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,EACvC,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC5C,IAAI;IAOP;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAE,SAAS,GAAG,QAAmB,GAAG,IAAI;IAmB3E;;;OAGG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAEzB;;;OAGG;IACH,MAAM,IAAI,IAAI;IAEd;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,UAAU,IAAI,CAAC;IAOf;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAgCf;;;OAGG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;CAC9B"}

package/dist/ui/Component.js

@@ -0,0 +1,201 @@
+/**
+ * Base class for all UI components in the viewer.
+ *
+ * Uses two-phase initialization to avoid the "virtual method call in constructor" anti-pattern.
+ * Subclasses must call init() after construction to complete initialization.
+ *
+ * Provides a consistent pattern for:
+ * - DOM element creation and management
+ * - Event binding with automatic cleanup
+ * - State subscription with automatic cleanup
+ * - Component lifecycle (mount, update, destroy)
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends Component<HTMLDivElement> {
+ *   protected createElement(): HTMLDivElement {
+ *     const div = document.createElement('div');
+ *     div.className = 'my-component';
+ *     return div;
+ *   }
+ *
+ *   protected subscribeToState(): void {
+ *     this.subscribe('zoom', (zoom) => {
+ *       this.element.style.transform = `scale(${zoom})`;
+ *     });
+ *   }
+ * }
+ *
+ * // Usage:
+ * const component = new MyComponent(viewer).init();
+ * ```
+ */
+export class Component {
+    element;
+    viewer;
+    subscriptions = [];
+    eventCleanups = [];
+    mounted = false;
+    initialized = false;
+    constructor(viewer) {
+        this.viewer = viewer;
+    }
+    /**
+     * Initialize the component. Must be called after construction.
+     * This two-phase initialization allows subclass instance fields to be
+     * initialized before createElement() is called.
+     *
+     * @returns this for method chaining
+     */
+    init() {
+        if (this.initialized) {
+            console.warn('Component already initialized');
+            return this;
+        }
+        this.element = this.createElement();
+        this.bindEvents();
+        this.subscribeToState();
+        this.initialized = true;
+        return this;
+    }
+    /**
+     * Bind DOM event listeners.
+     * Override in subclasses to add event handlers.
+     * Use addEventCleanup() to register cleanup functions.
+     */
+    bindEvents() { }
+    /**
+     * Subscribe to state changes.
+     * Override in subclasses to react to state updates.
+     * Use subscribe() helper for automatic cleanup.
+     */
+    subscribeToState() { }
+    /**
+     * Subscribe to a state key with automatic cleanup.
+     *
+     * @param key The state key to subscribe to
+     * @param callback Function called when state changes
+     * @param immediate If true, call callback immediately with current value (default: true)
+     */
+    subscribe(key, callback, immediate = true) {
+        const unsubscribe = this.viewer.state.subscribe(key, callback);
+        this.subscriptions.push(unsubscribe);
+        // Optionally call immediately with current value
+        if (immediate) {
+            const currentValue = this.viewer.state.get(key);
+            callback(currentValue, currentValue);
+        }
+    }
+    /**
+     * Register an event cleanup function.
+     * Will be called during destroy().
+     */
+    addEventCleanup(cleanup) {
+        this.eventCleanups.push(cleanup);
+    }
+    /**
+     * Helper to add an event listener with automatic cleanup.
+     */
+    addEventListener(target, type, listener, options) {
+        target.addEventListener(type, listener, options);
+        this.addEventCleanup(() => {
+            target.removeEventListener(type, listener, options);
+        });
+    }
+    /**
+     * Mount component to a parent element.
+     *
+     * @param parent The parent element to mount to
+     * @param position Optional position (default: append at end)
+     */
+    mount(parent, position = 'append') {
+        if (!this.initialized) {
+            throw new Error('Component must be initialized before mounting. Call init() first.');
+        }
+        if (this.mounted) {
+            console.warn('Component already mounted');
+            return;
+        }
+        if (position === 'prepend') {
+            parent.prepend(this.element);
+        }
+        else {
+            parent.appendChild(this.element);
+        }
+        this.mounted = true;
+        this.onMount();
+    }
+    /**
+     * Called after the component is mounted.
+     * Override in subclasses for post-mount initialization.
+     */
+    onMount() { }
+    /**
+     * Update component state.
+     * Override in subclasses for imperative updates.
+     */
+    update() { }
+    /**
+     * Check if component is initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Check if component is mounted.
+     */
+    isMounted() {
+        return this.mounted;
+    }
+    /**
+     * Get the underlying DOM element.
+     * @throws Error if component is not initialized
+     */
+    getElement() {
+        if (!this.initialized) {
+            throw new Error('Component must be initialized before accessing element. Call init() first.');
+        }
+        return this.element;
+    }
+    /**
+     * Cleanup and remove component.
+     * Removes event listeners, state subscriptions, and DOM element.
+     * Safe to call even if init() was never called.
+     */
+    destroy() {
+        // Cleanup event listeners
+        for (const cleanup of this.eventCleanups) {
+            try {
+                cleanup();
+            }
+            catch (error) {
+                console.error('Error during event cleanup:', error);
+            }
+        }
+        this.eventCleanups = [];
+        // Cleanup state subscriptions
+        for (const unsubscribe of this.subscriptions) {
+            try {
+                unsubscribe();
+            }
+            catch (error) {
+                console.error('Error during subscription cleanup:', error);
+            }
+        }
+        this.subscriptions = [];
+        // Remove DOM element (only if initialized)
+        if (this.initialized && this.element) {
+            this.element.remove();
+        }
+        this.mounted = false;
+        this.initialized = false;
+        // Hook for subclass cleanup
+        this.onDestroy();
+    }
+    /**
+     * Called during destroy for subclass cleanup.
+     * Override in subclasses for additional cleanup.
+     */
+    onDestroy() { }
+}
+//# sourceMappingURL=Component.js.map

package/dist/ui/Component.js.map

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

package/dist/ui/annotation/AnnotationLayer.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Manages annotation rendering and interaction for a document viewer.
+ *
+ * Annotations are rendered directly inside page slot elements for accurate positioning.
+ * This class orchestrates the specialized renderers for different annotation types.
+ */
+import type { Annotation, Destination } from '../../core/types';
+/**
+ * Manages annotation rendering and interaction for a document viewer.
+ */
+export declare class AnnotationLayer {
+    /** Annotations indexed by page index */
+    private pageAnnotations;
+    /** Overlay elements indexed by page index */
+    private overlays;
+    /** Current zoom level */
+    private zoom;
+    /** Currently active popup element */
+    private activePopup;
+    /** Bound handler for clicking outside popup */
+    private boundHandleDocumentClick;
+    /** Bound handler for escape key */
+    private boundHandleEscapeKey;
+    private markupRenderer;
+    private linkRenderer;
+    private shapeRenderer;
+    private textRenderer;
+    constructor();
+    /**
+     * Set the callback for internal link navigation.
+     */
+    setNavigateCallback(callback: (destination: Destination) => void): void;
+    /**
+     * Set the callback for external URI links.
+     */
+    setOpenUriCallback(callback: (uri: string) => void): void;
+    /**
+     * Set annotations for a specific page.
+     */
+    setPageAnnotations(pageIndex: number, annotations: Annotation[]): void;
+    /**
+     * Get annotations for a specific page.
+     */
+    getPageAnnotations(pageIndex: number): Annotation[];
+    /**
+     * Get all annotations with metadata, grouped by page.
+     * Returns only annotations that have metadata (comments).
+     */
+    getAllAnnotationsWithMetadata(): Map<number, Annotation[]>;
+    /**
+     * Clear all annotations and overlays.
+     */
+    clear(): void;
+    /**
+     * Set the current zoom level.
+     */
+    setZoom(zoom: number): void;
+    /**
+     * Show a popup for an annotation.
+     * @param anchorElement The element to anchor the popup to
+     * @param metadata The annotation metadata to display
+     * @param color The annotation color for styling
+     */
+    private showPopup;
+    /**
+     * Hide the currently active popup.
+     */
+    private hidePopup;
+    /**
+     * Create or get an annotation overlay for a slot element.
+     * The overlay is positioned absolutely within the slot.
+     *
+     * @param slotEl The slot element to attach the overlay to
+     * @param pageIndex The page index for this slot
+     * @returns The overlay element
+     */
+    getOrCreateOverlay(slotEl: HTMLElement, pageIndex: number): HTMLDivElement;
+    /**
+     * Render annotations for a specific page into its slot overlay.
+     *
+     * @param slotEl The slot element containing the page
+     * @param pageIndex The page index
+     */
+    renderPageAnnotations(slotEl: HTMLElement, pageIndex: number): void;
+    /**
+     * Render a single annotation using the appropriate renderer.
+     */
+    private renderAnnotation;
+}
+//# sourceMappingURL=AnnotationLayer.d.ts.map

package/dist/ui/annotation/AnnotationLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationLayer.d.ts","sourceRoot":"","sources":["../../../src/ui/annotation/AnnotationLayer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACR,UAAU,EACV,WAAW,EAiBd,MAAM,kBAAkB,CAAC;AAO1B;;GAEG;AACH,qBAAa,eAAe;IACxB,wCAAwC;IACxC,OAAO,CAAC,eAAe,CAAwC;IAE/D,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAA0C;IAE1D,yBAAyB;IACzB,OAAO,CAAC,IAAI,CAAK;IAEjB,qCAAqC;IACrC,OAAO,CAAC,WAAW,CAA+B;IAElD,+CAA+C;IAC/C,OAAO,CAAC,wBAAwB,CAA0C;IAE1E,mCAAmC;IACnC,OAAO,CAAC,oBAAoB,CAA6C;IAGzE,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;;IAWnC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIvE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIzD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI;IAItE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAInD;;;OAGG;IACH,6BAA6B,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAW1D;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ3B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IA8GjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc;IAuB1E;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAsBnE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA2D3B"}