@epam/pdf-highlighter-kit 0.0.10 → 0.0.14

package/dist/PDFHighlightViewer.d.ts

@@ -1,5 +1,5 @@
 import { PDFHighlightViewer as IPDFHighlightViewer } from './api';
-import { ViewerOptions, LoadPDFOptions, TextRange, SelectionWithMetadata, PerformanceMetrics, HighlightAnalytics, AccessibilityFeatures, InteractionMode, InputHighlightData, HighlightStyle, HighlightLabelStyle, ZoomValue, ThumbnailOptions } from './types';
+import { PDFSource, ViewerOptions, LoadPDFOptions, TextRange, SelectionWithMetadata, PerformanceMetrics, HighlightAnalytics, AccessibilityFeatures, InteractionMode, InputHighlightData, HighlightStyle, HighlightLabelStyle, ZoomValue, ThumbnailOptions, PageRotationDegrees, RotationDirection } from './types';
 type EventCallback = (data?: unknown) => void;
 export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     private pdfEngine;
@@ -23,12 +23,17 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     private isInitialized;
     private navIndex;
     private pageDimensions;
+    /** Intrinsic page size in normalized units (PDF default viewport at currentScale / scale). */
+    private intrinsicPageNormalized;
+    /** Extra clockwise rotation per page on top of PDF `/Rotate`. */
+    private pageDisplayRotations;
     private defaultPageHeight;
     private eventListeners;
     private scrollListener;
     private analytics;
     constructor();
     init(container: HTMLElement, options?: ViewerOptions): Promise<void>;
+    private syncPageDisplayRotationsFromOptions;
     /**
      * Setup container with proper structure and styling
      */
@@ -50,8 +55,11 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
      * Set placeholder size for a page container using real PDF dimensions
      */
     private setPagePlaceholderSize;
+    private getUserClockwiseRotation;
+    private effectiveViewportRotationDegrees;
     /**
-     * Get and cache real page dimensions
+     * Get and cache display page dimensions (rotated viewport pixels at currentScale)
+     * and intrinsic normalized size for highlight mapping.
      */
     private getPageDimensions;
     /**
@@ -62,7 +70,7 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
      * Handle keyboard navigation
      */
     private handleKeyboardNavigation;
-    loadPDF(source: string | ArrayBuffer | Blob, options?: LoadPDFOptions): Promise<void>;
+    loadPDF(source: PDFSource, options?: LoadPDFOptions): Promise<void>;
     /**
      * Normalize selectedPages: filter to 1..numPages, dedupe, sort. Empty result => null (show all).
      */
@@ -95,6 +103,8 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     resetZoom(): void;
     getCurrentPage(): number;
     getTotalPages(): number;
+    setPageDisplayRotation(pageNumber: number, degrees: PageRotationDegrees, direction?: RotationDirection): void;
+    getPageDisplayRotation(pageNumber: number): PageRotationDegrees;
     getThumbnails(pageNumbers: number[], options?: ThumbnailOptions): Promise<Map<number, HTMLCanvasElement>>;
     getThumbnailsDataUrl(pageNumbers: number[], options?: ThumbnailOptions): Promise<Map<number, string>>;
     /**
@@ -135,7 +145,7 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
         getSelection: () => string;
         getSelectionWithContext: () => SelectionWithMetadata | null;
         clearSelection: () => void;
-        selectText: (range: TextRange) => void;
+        selectText: (_range: TextRange) => void;
         copySelection: (format?: "plain" | "formatted" | "citation") => void;
         createHighlightFromSelection: (style?: HighlightStyle) => InputHighlightData | null;
     };

package/dist/PDFHighlightViewer.d.ts.map

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

package/dist/PDFHighlightViewer.js

@@ -1,4 +1,4 @@
-import { ZoomMode, } from './types';
+import { ZoomMode, RotationDirection, } from './types';
 import { PDFEngine } from './core/pdf-engine';
 import { ViewportManager } from './core/viewport-manager';
 import { UnifiedLayerBuilder } from './core/unified-layer-builder';
@@ -7,6 +7,8 @@ import { PerformanceOptimizer } from './core/performance-optimizer';
 import { buildHighlightsIndex } from './utils/highlight-adapter';
 import { applyHighlightVisualStyle, getHighlightBaseOpacity, getHighlightHoverOpacity, resolveHighlightStyle, } from './utils/highlight-style';
 import { appendLabelIcon, applyBaseOutlineStyle, applyLabelOutlineStyle, applyLabelStyle, scaleLabelStyle, } from './utils/label-style';
+import { clockwiseToCcw, displayRotationToClockwise, rotateBoundingBoxForCcwRotation, } from './utils/rotate-bbox';
+import { sumPdfIntrinsicAndUserRotation } from './utils/pdf-rotation-math';
 const CONTAINER_PADDING = 40;
 const ZOOM_STEP = 1.2;
 export class PDFHighlightViewer {
@@ -31,6 +33,10 @@ export class PDFHighlightViewer {
         this.isInitialized = false;
         this.navIndex = -1;
         this.pageDimensions = new Map();
+        /** Intrinsic page size in normalized units (PDF default viewport at currentScale / scale). */
+        this.intrinsicPageNormalized = new Map();
+        /** Extra clockwise rotation per page on top of PDF `/Rotate`. */
+        this.pageDisplayRotations = new Map();
         this.defaultPageHeight = 800;
         this.eventListeners = [];
         this.scrollListener = null;
@@ -60,9 +66,8 @@ export class PDFHighlightViewer {
             clearSelection: () => {
                 this.interactionHandler.clearSelection();
             },
-            selectText: (range) => {
+            selectText: (_range) => {
                 // TODO: Implement programmatic text selection
-                console.log('selectText not yet implemented:', range);
             },
             copySelection: (format = 'plain') => {
                 const selection = this.textSelection.getSelection();
@@ -175,9 +180,22 @@ export class PDFHighlightViewer {
         if (this.options.accessibility) {
             this.setupAccessibility();
         }
+        this.syncPageDisplayRotationsFromOptions();
         this.isInitialized = true;
         this.emit('initialized');
     }
+    syncPageDisplayRotationsFromOptions() {
+        this.pageDisplayRotations.clear();
+        const raw = this.options.pageDisplayRotations;
+        if (!raw)
+            return;
+        for (const [key, value] of Object.entries(raw)) {
+            const n = Number(key);
+            if (Number.isInteger(n) && n >= 1) {
+                this.pageDisplayRotations.set(n, value);
+            }
+        }
+    }
     /**
      * Setup container with proper structure and styling
      */
@@ -409,22 +427,38 @@ export class PDFHighlightViewer {
             pageContainer.style.height = `${this.defaultPageHeight}px`;
         }
     }
+    getUserClockwiseRotation(pageNumber) {
+        return this.pageDisplayRotations.get(pageNumber) ?? 0;
+    }
+    effectiveViewportRotationDegrees(intrinsicRotateDegrees, pageNumber) {
+        return sumPdfIntrinsicAndUserRotation(intrinsicRotateDegrees, this.getUserClockwiseRotation(pageNumber));
+    }
     /**
-     * Get and cache real page dimensions
+     * Get and cache display page dimensions (rotated viewport pixels at currentScale)
+     * and intrinsic normalized size for highlight mapping.
      */
     async getPageDimensions(pageNumber) {
-        // Return cached dimensions if available
-        const cached = this.pageDimensions.get(pageNumber);
-        if (cached)
-            return cached;
-        // Get PDF page and its viewport at current scale
-        const page = await this.pdfEngine.getPage(pageNumber);
-        const viewport = page.getViewport({ scale: this.currentScale });
+        const cachedDisplay = this.pageDimensions.get(pageNumber);
+        const cachedIntrinsic = this.intrinsicPageNormalized.get(pageNumber);
+        if (cachedDisplay && cachedIntrinsic) {
+            return cachedDisplay;
+        }
+        const pdfPage = await this.pdfEngine.getPage(pageNumber);
+        const intrinsicVp = pdfPage.getViewport({ scale: this.currentScale });
+        const scale = this.currentScale > 0 ? this.currentScale : 1;
+        this.intrinsicPageNormalized.set(pageNumber, {
+            width: intrinsicVp.width / scale,
+            height: intrinsicVp.height / scale,
+        });
+        const effectiveRotation = this.effectiveViewportRotationDegrees(pdfPage.rotate, pageNumber);
+        const displayVp = pdfPage.getViewport({
+            scale: this.currentScale,
+            rotation: effectiveRotation,
+        });
         const dimensions = {
-            width: viewport.width,
-            height: viewport.height,
+            width: displayVp.width,
+            height: displayVp.height,
         };
-        // Cache the dimensions
         this.pageDimensions.set(pageNumber, dimensions);
         return dimensions;
     }
@@ -493,6 +527,7 @@ export class PDFHighlightViewer {
             await this.pdfEngine.loadDocument(source);
             const docInfo = this.pdfEngine.getDocumentInfo();
             this.documentNumPages = docInfo.numPages;
+            this.syncPageDisplayRotationsFromOptions();
             const rawSelected = options?.selectedPages ?? this.options.selectedPages;
             const selectedPages = this.normalizeSelectedPages(rawSelected, this.documentNumPages);
             this.selectedPages = selectedPages;
@@ -601,7 +636,7 @@ export class PDFHighlightViewer {
                 const pageContainer = this.pageContainers.get(pageNumber);
                 if (pageContainer && !pageContainer.classList.contains('rendered')) {
                     batch.push(this.renderPage(pageNumber).catch((error) => {
-                        console.debug(`Failed to render page ${pageNumber}:`, error);
+                        console.error(`Failed to render page ${pageNumber}:`, error);
                     }));
                 }
             }
@@ -618,15 +653,15 @@ export class PDFHighlightViewer {
             return;
         // Check if already rendered
         if (pageContainer.classList.contains('rendered')) {
-            console.log(`Page ${pageNumber}: skipping, already has 'rendered' class`);
             return;
         }
-        console.log(`Page ${pageNumber}: rendering at scale ${this.currentScale}`);
         try {
             // Add loading state
             pageContainer.classList.add('loading');
+            const pdfPage = await this.pdfEngine.getPage(pageNumber);
+            const effectiveRotation = this.effectiveViewportRotationDegrees(pdfPage.rotate, pageNumber);
             // Render PDF canvas
-            const canvas = await this.pdfEngine.renderPage(pageNumber, this.currentScale);
+            const canvas = await this.pdfEngine.renderPage(pageNumber, this.currentScale, undefined, effectiveRotation);
             // Clear container and add canvas
             pageContainer.innerHTML = '';
             pageContainer.appendChild(canvas);
@@ -698,8 +733,10 @@ export class PDFHighlightViewer {
         if (!this.container) {
             return { scaleX: 1, scaleY: 1 };
         }
-        const page = await this.pdfEngine.getPage(this.currentPage || 1);
-        const viewport = page.getViewport({ scale: 1 });
+        const pageNum = this.currentPage || 1;
+        const page = await this.pdfEngine.getPage(pageNum);
+        const effectiveRotation = this.effectiveViewportRotationDegrees(page.rotate, pageNum);
+        const viewport = page.getViewport({ scale: 1, rotation: effectiveRotation });
         const scaleX = (this.container.clientWidth - CONTAINER_PADDING) / viewport.width;
         const scaleY = (this.container.clientHeight - CONTAINER_PADDING) / viewport.height;
         return { scaleX, scaleY };
@@ -719,8 +756,38 @@ export class PDFHighlightViewer {
     getTotalPages() {
         return this.totalPages;
     }
+    setPageDisplayRotation(pageNumber, degrees, direction = RotationDirection.Clockwise) {
+        if (degrees === 0) {
+            this.pageDisplayRotations.delete(pageNumber);
+            if (this.options.pageDisplayRotations) {
+                const next = { ...this.options.pageDisplayRotations };
+                delete next[pageNumber];
+                this.options.pageDisplayRotations = Object.keys(next).length > 0 ? next : undefined;
+            }
+        }
+        else {
+            const cw = displayRotationToClockwise(degrees, direction);
+            this.pageDisplayRotations.set(pageNumber, cw);
+            this.options.pageDisplayRotations = {
+                ...(this.options.pageDisplayRotations ?? {}),
+                [pageNumber]: cw,
+            };
+        }
+        void this.reRenderVisiblePages();
+        this.emit('pageRotationChanged', { pageNumber, degrees, direction });
+    }
+    getPageDisplayRotation(pageNumber) {
+        return this.pageDisplayRotations.get(pageNumber) ?? 0;
+    }
     async getThumbnails(pageNumbers, options) {
-        return this.pdfEngine.getThumbnails(pageNumbers, options);
+        const viewportRotations = { ...(options?.viewportRotations ?? {}) };
+        for (const n of pageNumbers) {
+            if (viewportRotations[n] !== undefined)
+                continue;
+            const pdfPage = await this.pdfEngine.getPage(n);
+            viewportRotations[n] = this.effectiveViewportRotationDegrees(pdfPage.rotate, n);
+        }
+        return this.pdfEngine.getThumbnails(pageNumbers, { ...options, viewportRotations });
     }
     async getThumbnailsDataUrl(pageNumbers, options) {
         const canvases = await this.getThumbnails(pageNumbers, options);
@@ -814,7 +881,7 @@ export class PDFHighlightViewer {
         // Refresh only affected pages
         for (const pageNumber of affectedPages) {
             this.refreshHighlightLayerForPage(pageNumber);
-            this.updatePageUnifiedLayer(pageNumber);
+            void this.updatePageUnifiedLayer(pageNumber);
             this.buildSpatialIndexForPage(pageNumber);
         }
         this.emit('highlightAdded', { highlight, pages: Array.from(affectedPages) });
@@ -836,7 +903,7 @@ export class PDFHighlightViewer {
         this.updateAnalytics();
         for (const pageNumber of affectedPages) {
             this.refreshHighlightLayerForPage(pageNumber);
-            this.updatePageUnifiedLayer(pageNumber);
+            void this.updatePageUnifiedLayer(pageNumber);
             this.buildSpatialIndexForPage(pageNumber);
         }
         this.emit('highlightRemoved', { termId, pages: Array.from(affectedPages) });
@@ -869,7 +936,7 @@ export class PDFHighlightViewer {
         this.updateAnalytics();
         for (const pageNumber of affectedPages) {
             this.refreshHighlightLayerForPage(pageNumber);
-            this.updatePageUnifiedLayer(pageNumber);
+            void this.updatePageUnifiedLayer(pageNumber);
             this.buildSpatialIndexForPage(pageNumber);
         }
         this.emit('styleUpdated', { termId, style: next.style, patch: stylePatch });
@@ -877,7 +944,7 @@ export class PDFHighlightViewer {
     /**
      * Update unified layer for a specific page
      */
-    updatePageUnifiedLayer(pageNumber) {
+    async updatePageUnifiedLayer(pageNumber) {
         const pageContainer = this.pageContainers.get(pageNumber);
         if (!pageContainer)
             return;
@@ -897,7 +964,19 @@ export class PDFHighlightViewer {
                 };
             }),
         }));
-        this.layerBuilder.updateHighlights(pageContainer, normalizedHighlights, pageNumber, pageData.textContent, this.currentScale);
+        let viewport;
+        try {
+            const pdfPage = await this.pdfEngine.getPage(pageNumber);
+            const effectiveRotation = this.effectiveViewportRotationDegrees(pdfPage.rotate, pageNumber);
+            viewport = pdfPage.getViewport({
+                scale: this.currentScale,
+                rotation: effectiveRotation,
+            });
+        }
+        catch {
+            viewport = undefined;
+        }
+        this.layerBuilder.updateHighlights(pageContainer, normalizedHighlights, pageNumber, pageData.textContent, this.currentScale, viewport);
     }
     /**
      * Update all unified layers
@@ -926,10 +1005,10 @@ export class PDFHighlightViewer {
         if (!this.container)
             return;
         const pageToKeep = this.currentPage;
-        console.log('Zoom changed to:', this.currentScale);
         // Clear ALL cached data for the new scale
         this.pdfEngine.clearAllPageCache();
-        this.pageDimensions.clear(); // Clear dimension cache
+        this.pageDimensions.clear();
+        this.intrinsicPageNormalized.clear();
         // Clear all containers and update their sizes for new scale
         let totalHeight = 0;
         let validDimensions = 0;
@@ -960,7 +1039,6 @@ export class PDFHighlightViewer {
         // Recompute visible pages after scroll restore for correct rendering
         const scrollTopAfterRestore = this.container.scrollTop;
         const visiblePagesAfterRestore = this.viewportManager.getVisiblePages(scrollTopAfterRestore, containerHeight);
-        console.log('Re-rendering visible pages at new scale:', visiblePagesAfterRestore);
         // Render visible pages immediately
         for (const pageNumber of visiblePagesAfterRestore) {
             try {
@@ -1041,14 +1119,8 @@ export class PDFHighlightViewer {
         if (!this.container)
             return;
         const pageTop = this.getPageScrollTop(pageNumber);
-        const origin = this.options.bboxOrigin ?? 'bottom-right';
-        const pixelDimensions = this.pageDimensions.get(pageNumber);
-        if (!pixelDimensions) {
-            throw new Error(`Page dimensions for page ${pageNumber} are not available`);
-        }
-        const dimensions = this.toPageCoordinateDimensions(pixelDimensions);
-        const normalizedY = origin.startsWith('bottom') ? dimensions.height - y : y;
-        const targetY = pageTop + normalizedY * this.currentScale - this.container.clientHeight * 0.3;
+        const normalizedBBox = this.normalizeBBoxForPage({ page: pageNumber, x1: x, y1: y, x2: x, y2: y }, pageNumber, this.options.bboxSourceDimensions, this.options.bboxOrigin);
+        const targetY = pageTop + normalizedBBox.y1 * this.currentScale - this.container.clientHeight * 0.3;
         this.container.scrollTop = Math.max(0, targetY);
         this.emit('coordinateNavigation', { pageNumber, x, y });
     }
@@ -1118,11 +1190,9 @@ export class PDFHighlightViewer {
     }
     enableProfiling() {
         // TODO: Enable detailed performance profiling
-        console.log('Profiling enabled');
     }
     disableProfiling() {
         // TODO: Disable detailed performance profiling
-        console.log('Profiling disabled');
     }
     // =============================================================================
     // Event Management
@@ -1516,11 +1586,12 @@ export class PDFHighlightViewer {
     normalizeBBoxForPage(bbox, pageNumber, bboxSourceDimensions, bboxOrigin) {
         const origin = bboxOrigin ?? this.options.bboxOrigin ?? 'bottom-right';
         const computedSourceDimensions = bboxSourceDimensions ?? this.options.bboxSourceDimensions;
-        const pixelDimensions = this.pageDimensions.get(pageNumber);
-        if (!pixelDimensions) {
+        const intrinsic = this.intrinsicPageNormalized.get(pageNumber);
+        if (!intrinsic) {
             throw new Error(`Page dimensions for page ${pageNumber} are not available`);
         }
-        const { width: pageWidth, height: pageHeight } = this.toPageCoordinateDimensions(pixelDimensions);
+        const pageWidth = intrinsic.width;
+        const pageHeight = intrinsic.height;
         let x1 = bbox.x1;
         let x2 = bbox.x2;
         let y1 = bbox.y1;
@@ -1543,12 +1614,18 @@ export class PDFHighlightViewer {
             y1 = pageHeight - y1;
             y2 = pageHeight - y2;
         }
-        return {
+        let result = {
             x1: Math.min(x1, x2),
             y1: Math.min(y1, y2),
             x2: Math.max(x1, x2),
             y2: Math.max(y1, y2),
         };
+        const userCw = this.getUserClockwiseRotation(pageNumber);
+        if (userCw !== 0) {
+            const ccw = clockwiseToCcw(userCw);
+            result = rotateBoundingBoxForCcwRotation(result, pageWidth, pageHeight, ccw);
+        }
+        return result;
     }
     /**
      * Build spatial indices for displayed pages only
@@ -1683,9 +1760,12 @@ export class PDFHighlightViewer {
             return;
         }
         try {
-            // Get the PDF page and its viewport
             const pdfPage = await this.pdfEngine.getPage(pageNumber);
-            const viewport = pdfPage.getViewport({ scale: this.currentScale });
+            const effectiveRotation = this.effectiveViewportRotationDegrees(pdfPage.rotate, pageNumber);
+            const viewport = pdfPage.getViewport({
+                scale: this.currentScale,
+                rotation: effectiveRotation,
+            });
             // Extract text content from PDF
             const textContent = await pdfPage.getTextContent();
             // Create text layer container
@@ -1785,8 +1865,6 @@ export class PDFHighlightViewer {
                 textLayer.appendChild(textSpan);
             });
             pageContainer.appendChild(textLayer);
-            console.log(`Text layer added to page ${pageNumber} with ${textContent.items.length} text items`);
-            console.log('Text span style applied:', textLayer.children[0]?.getAttribute('style'));
         }
         catch (error) {
             console.error(`Failed to add text layer to page ${pageNumber}:`, error);
@@ -1802,8 +1880,8 @@ export class PDFHighlightViewer {
         const targetHeight = (coord.y2 - coord.y1) * scale;
         const existingHighlights = highlightLayer.children;
         let overlappingCount = 0;
-        for (let i = 0; i < existingHighlights.length; i++) {
-            const existing = existingHighlights[i];
+        for (const existingHighlight of existingHighlights) {
+            const existing = existingHighlight;
             const existingLeft = parseFloat(existing.style.left);
             const existingTop = parseFloat(existing.style.top);
             const existingWidth = parseFloat(existing.style.width);
@@ -1888,6 +1966,9 @@ export class PDFHighlightViewer {
         // Clear state
         this.eventListeners = [];
         this.isInitialized = false;
+        this.pageDimensions.clear();
+        this.intrinsicPageNormalized.clear();
+        this.pageDisplayRotations.clear();
         this.emit('destroyed');
     }
 }