@epam/pdf-highlighter-kit 0.0.9 → 0.0.13

package/README.md

@@ -201,9 +201,14 @@ export interface ViewerOptions {
 
   // Page dimensions for which bbox coordinates were calculated
   bboxSourceDimensions?: BBoxDimensions;
+
+  // Only show these document page numbers (1-based). If empty or omitted, all pages are shown.
+  selectedPages?: number[];
 }
 ```
 
+**Displaying only selected pages:** Use `selectedPages` to show a subset of the document (e.g. `[1, 3, 5]` or `[2, 4, 6, 8]`). The full PDF is still loaded; only the listed pages get DOM containers and participate in scrolling and rendering. Page numbers in the API (e.g. `setPage`, events, highlights) remain physical document page numbers. You can pass `selectedPages` in `init` options or per load via `loadPDF(source, { selectedPages })`; the latter overrides the init value for that load. `getTotalPages()` returns the length of the displayed list when `selectedPages` is set.
+
 ## API Reference
 
 ### Main Methods
@@ -212,9 +217,18 @@ export interface ViewerOptions {
 
 Initialize the viewer with a container element and optional configuration.
 
-#### `loadPDF(source: string | ArrayBuffer | Blob): Promise<void>`
+#### `loadPDF(source: string | ArrayBuffer | Blob, options?: LoadPDFOptions): Promise<void>`
+
+Load a PDF document from URL or ArrayBuffer. Optional second argument:
+
+```ts
+interface LoadPDFOptions {
+  /** Only show these document page numbers (1-based). If empty or omitted, all pages are shown. */
+  selectedPages?: number[];
+}
+```
 
-Load a PDF document from URL or ArrayBuffer.
+Example: `await viewer.loadPDF(url, { selectedPages: [1, 3, 5] });` shows only pages 1, 3, and 5. When `options.selectedPages` is provided, it overrides `ViewerOptions.selectedPages` for this load.
 
 #### `loadHighlights(highlights: InputHighlightData[]): void`
 

package/dist/PDFHighlightViewer.d.ts

@@ -1,5 +1,5 @@
 import { PDFHighlightViewer as IPDFHighlightViewer } from './api';
-import { ViewerOptions, 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 } from './types';
 type EventCallback = (data?: unknown) => void;
 export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     private pdfEngine;
@@ -15,6 +15,10 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     private currentPage;
     private currentScale;
     private totalPages;
+    /** Actual number of pages in the loaded PDF (1..documentNumPages). */
+    private documentNumPages;
+    /** When set, only these physical page numbers are shown; null = all pages. */
+    private selectedPages;
     private selectedTermId;
     private isInitialized;
     private navIndex;
@@ -58,9 +62,15 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
      * Handle keyboard navigation
      */
     private handleKeyboardNavigation;
-    loadPDF(source: string | ArrayBuffer | Blob): Promise<void>;
+    loadPDF(source: PDFSource, options?: LoadPDFOptions): Promise<void>;
     /**
-     * Create DOM containers for all pages with real PDF dimensions
+     * Normalize selectedPages: filter to 1..numPages, dedupe, sort. Empty result => null (show all).
+     */
+    private normalizeSelectedPages;
+    /** List of physical page numbers to display (either selectedPages or 1..documentNumPages). */
+    private getDisplayedPageList;
+    /**
+     * Create DOM containers for displayed pages only (selectedPages or all)
      */
     private createPageContainers;
     /**
@@ -125,7 +135,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;
     };
@@ -188,7 +198,7 @@ export declare class PDFHighlightViewer implements IPDFHighlightViewer {
     private toPageCoordinateDimensions;
     private normalizeBBoxForPage;
     /**
-     * Build spatial indices for all pages
+     * Build spatial indices for displayed pages only
      */
     private buildAllSpatialIndices;
     /**

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

@@ -23,6 +23,10 @@ export class PDFHighlightViewer {
         this.currentPage = 1;
         this.currentScale = 1.5;
         this.totalPages = 0;
+        /** Actual number of pages in the loaded PDF (1..documentNumPages). */
+        this.documentNumPages = 0;
+        /** When set, only these physical page numbers are shown; null = all pages. */
+        this.selectedPages = null;
         this.selectedTermId = null;
         this.isInitialized = false;
         this.navIndex = -1;
@@ -56,9 +60,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();
@@ -441,23 +444,30 @@ export class PDFHighlightViewer {
      * Handle keyboard navigation
      */
     handleKeyboardNavigation(event) {
+        const displayed = this.getDisplayedPageList();
+        if (displayed.length === 0)
+            return;
+        const currentIdx = displayed.indexOf(this.currentPage);
+        const idx = currentIdx >= 0 ? currentIdx : 0;
         switch (event.key) {
             case 'PageDown':
             case 'ArrowDown':
-                this.setPage(Math.min(this.totalPages, this.currentPage + 1));
+                if (idx < displayed.length - 1)
+                    this.setPage(displayed[idx + 1]);
                 event.preventDefault();
                 break;
             case 'PageUp':
             case 'ArrowUp':
-                this.setPage(Math.max(1, this.currentPage - 1));
+                if (idx > 0)
+                    this.setPage(displayed[idx - 1]);
                 event.preventDefault();
                 break;
             case 'Home':
-                this.setPage(1);
+                this.setPage(displayed[0]);
                 event.preventDefault();
                 break;
             case 'End':
-                this.setPage(this.totalPages);
+                this.setPage(displayed[displayed.length - 1]);
                 event.preventDefault();
                 break;
             case '+':
@@ -474,20 +484,23 @@ export class PDFHighlightViewer {
     // =============================================================================
     // PDF Management
     // =============================================================================
-    async loadPDF(source) {
+    async loadPDF(source, options) {
         if (!this.isInitialized) {
             throw new Error('Viewer must be initialized before loading PDF');
         }
         try {
-            // Load document with PDF engine
             await this.pdfEngine.loadDocument(source);
             const docInfo = this.pdfEngine.getDocumentInfo();
-            this.totalPages = docInfo.numPages;
-            // Update viewport manager with total pages
+            this.documentNumPages = docInfo.numPages;
+            const rawSelected = options?.selectedPages ?? this.options.selectedPages;
+            const selectedPages = this.normalizeSelectedPages(rawSelected, this.documentNumPages);
+            this.selectedPages = selectedPages;
+            this.totalPages = selectedPages !== null ? selectedPages.length : this.documentNumPages;
+            this.viewportManager.setSelectedPages(selectedPages);
             this.viewportManager.setTotalPages(this.totalPages);
-            // Create page containers
             await this.createPageContainers();
-            // Load initial pages
+            const displayed = this.getDisplayedPageList();
+            this.currentPage = displayed.length > 0 ? displayed[0] : 1;
             await this.loadInitialPages();
             if (this.options.enableVirtualScrolling === false) {
                 await this.renderAllPagesBatched(2);
@@ -500,17 +513,45 @@ export class PDFHighlightViewer {
         }
     }
     /**
-     * Create DOM containers for all pages with real PDF dimensions
+     * Normalize selectedPages: filter to 1..numPages, dedupe, sort. Empty result => null (show all).
+     */
+    normalizeSelectedPages(raw, numPages) {
+        if (!raw || raw.length === 0)
+            return null;
+        const set = new Set();
+        for (const p of raw) {
+            if (Number.isInteger(p) && p >= 1 && p <= numPages)
+                set.add(p);
+        }
+        if (set.size === 0)
+            return null;
+        return Array.from(set).sort((a, b) => a - b);
+    }
+    /** List of physical page numbers to display (either selectedPages or 1..documentNumPages). */
+    getDisplayedPageList() {
+        if (this.selectedPages !== null && this.selectedPages.length > 0) {
+            return this.selectedPages;
+        }
+        const list = [];
+        for (let i = 1; i <= this.documentNumPages; i++) {
+            list.push(i);
+        }
+        return list;
+    }
+    /**
+     * Create DOM containers for displayed pages only (selectedPages or all)
      */
     async createPageContainers() {
         if (!this.pdfContainer)
             return;
-        // Clear existing containers
         this.pdfContainer.innerHTML = '';
         this.pageContainers.clear();
-        const firstPageDimensions = await this.getPageDimensions(1);
+        const displayed = this.getDisplayedPageList();
+        if (displayed.length === 0)
+            return;
+        const firstPageDimensions = await this.getPageDimensions(displayed[0]);
         const avgPageHeight = firstPageDimensions.height;
-        for (let pageNumber = 1; pageNumber <= this.totalPages; pageNumber++) {
+        for (const pageNumber of displayed) {
             const pageContainer = document.createElement('div');
             pageContainer.className = 'pdf-page-container';
             pageContainer.setAttribute('data-page-number', pageNumber.toString());
@@ -522,7 +563,6 @@ export class PDFHighlightViewer {
             this.pdfContainer.appendChild(pageContainer);
             this.pageContainers.set(pageNumber, pageContainer);
         }
-        // Update viewport manager with real page dimensions
         this.viewportManager.updateDimensions(this.container?.clientHeight || 600, avgPageHeight);
     }
     /**
@@ -531,19 +571,19 @@ export class PDFHighlightViewer {
     async loadInitialPages() {
         if (!this.container)
             return;
-        // Get what should be visible at the top
         const visiblePages = this.viewportManager.getVisiblePages(0, this.container.clientHeight);
-        // Load first page immediately
+        const firstPage = this.getDisplayedPageList()[0];
+        if (firstPage === undefined)
+            return;
         try {
-            await this.renderPage(1);
+            await this.renderPage(firstPage);
         }
         catch (error) {
             console.error('Failed to load initial page:', error);
         }
-        // Load other visible pages with small delay
         setTimeout(() => {
             visiblePages
-                .filter((page) => page > 1)
+                .filter((page) => page !== firstPage)
                 .forEach((pageNumber) => {
                 this.renderPage(pageNumber).catch((error) => {
                     console.error(`Failed to load initial page ${pageNumber}:`, error);
@@ -552,13 +592,15 @@ export class PDFHighlightViewer {
         }, 100);
     }
     async renderAllPagesBatched(batchSize = 2) {
-        for (let i = 1; i <= this.totalPages; i += batchSize) {
+        const displayed = this.getDisplayedPageList();
+        for (let i = 0; i < displayed.length; i += batchSize) {
             const batch = [];
-            for (let j = i; j < i + batchSize && j <= this.totalPages; j++) {
-                const pageContainer = this.pageContainers.get(j);
+            for (let j = i; j < i + batchSize && j < displayed.length; j++) {
+                const pageNumber = displayed[j];
+                const pageContainer = this.pageContainers.get(pageNumber);
                 if (pageContainer && !pageContainer.classList.contains('rendered')) {
-                    batch.push(this.renderPage(j).catch((error) => {
-                        console.debug(`Failed to render page ${j}:`, error);
+                    batch.push(this.renderPage(pageNumber).catch((error) => {
+                        console.error(`Failed to render page ${pageNumber}:`, error);
                     }));
                 }
             }
@@ -575,10 +617,8 @@ 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');
@@ -615,7 +655,8 @@ export class PDFHighlightViewer {
         });
     }
     setPage(pageNumber) {
-        if (pageNumber < 1 || pageNumber > this.totalPages)
+        const displayed = this.getDisplayedPageList();
+        if (!displayed.includes(pageNumber))
             return;
         if (this.container) {
             this.container.scrollTop = this.getPageScrollTop(pageNumber);
@@ -882,7 +923,6 @@ 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
@@ -916,7 +956,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 {
@@ -1074,11 +1113,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
@@ -1507,10 +1544,10 @@ export class PDFHighlightViewer {
         };
     }
     /**
-     * Build spatial indices for all pages
+     * Build spatial indices for displayed pages only
      */
     buildAllSpatialIndices() {
-        for (let pageNumber = 1; pageNumber <= this.totalPages; pageNumber++) {
+        for (const pageNumber of this.getDisplayedPageList()) {
             this.buildSpatialIndexForPage(pageNumber);
         }
     }
@@ -1741,8 +1778,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);
@@ -1758,8 +1793,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);