@epam/pdf-highlighter-kit 0.0.8 → 0.0.10

package/README.md

@@ -82,6 +82,8 @@ Each highlight carries its own style. No categories are required.
 
 **Icon before label:** Optionally set `beforeIcon` to an inline SVG string (e.g. from [Tabler Icons](https://tabler.io/icons)) to render an icon inside the label frame, to the left of the text. The icon inherits the label color via `currentColor`. Use `labelStyle.iconSize` to set the icon size (e.g. `14` or `'14px'`) and `labelStyle.iconColor` to set the icon color (e.g. `'#ff6b6b'`); if `iconColor` is not set, the icon uses the label text color. Only pass trusted SVG content (e.g. from your bundle or `@tabler/icons`); in React with Vite you can use `import iconSvg from '@tabler/icons/icons/outline/alert-circle.svg?raw'` and pass `iconSvg` as `beforeIcon`.
 
+**Scalable label:** Set `isLabelScalable: true` on the highlight so the label’s size (font, padding, icon, border radius) scales with zoom; the label stays proportional to the highlight. Border and outline thickness are not scaled (they stay fixed like the highlight’s outline). Best used with `labelStyle` values in `px` or numbers.
+
 ```ts
 export interface BBox {
   x1: number;
@@ -139,6 +141,7 @@ export interface InputHighlightData {
   style?: HighlightStyle;
   label?: string;
   beforeIcon?: string; // inline SVG string (trusted content only, e.g. Tabler icons)
+  isLabelScalable?: boolean; // when true, label size scales with zoom (borders stay fixed)
   labelStyle?: HighlightLabelStyle;
   tooltipText?: string;
   metadata?: Record<string, any>;
@@ -198,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
@@ -209,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 { 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: string | ArrayBuffer | Blob, 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;
     /**
@@ -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":"AAAA,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EACL,aAAa,EACb,cAAc,EAKd,SAAS,EACT,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAElB,cAAc,EACd,mBAAmB,EACnB,SAAS,EAET,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAuBjB,KAAK,aAAa,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9C,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,oBAAoB,CAAuB;IAEnD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,cAAc,CAAkC;IAExD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,eAAe,CAKrB;IACF,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,QAAQ,CAAM;IAEtB,OAAO,CAAC,cAAc,CAAwD;IAC9E,OAAO,CAAC,iBAAiB,CAAO;IAEhC,OAAO,CAAC,cAAc,CAAoD;IAC1E,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,SAAS,CAKf;;IAyCI,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1E;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,OAAO;IAiHf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,YAAY;IA8DpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;YACW,iBAAiB;IAmB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA0C1B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC3F;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B,8FAA8F;IAC9F,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;YACW,oBAAoB;IA8BlC;;OAEG;YACW,gBAAgB;YAwBhB,qBAAqB;IAoBnC;;OAEG;YACW,UAAU;IAgDxB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASjC,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAU/B,OAAO,CAAC,SAAS;YAUH,WAAW;YAKX,cAAc;YAKd,gBAAgB;IAW9B,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAIf,SAAS,IAAI,IAAI;IAIjB,cAAc,IAAI,MAAM;IAIxB,aAAa,IAAI,MAAM;IAIjB,aAAa,CACjB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAIpC,oBAAoB,CACxB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAc/B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAe3B;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAgB5B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAU9B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAQjC,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAchD,YAAY,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IA4BjD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA4BrC,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,EACnC,eAAe,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC7C,IAAI;IAwCP;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;YACW,oBAAoB;IAoElC,aAAa;sBACC,IAAI;uBAIH,IAAI;4BAIC,MAAM;uCAKK,qBAAqB,GAAG,IAAI;8BAIrC,IAAI;4BAIJ,SAAS,KAAG,IAAI;iCAKZ,OAAO,GAAG,WAAW,GAAG,UAAU,KAAa,IAAI;+CAQpC,cAAc,KAAG,kBAAkB,GAAG,IAAI;MAuBjF;IAMF,OAAO,CAAC,iBAAiB;IAsCzB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,SAAI,GAAG,IAAI;IAuCxD,aAAa,IAAI,IAAI;IASrB,iBAAiB,IAAI,IAAI;IASzB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAyB9D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAwBrD,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAI/C,kBAAkB,IAAI,eAAe;IAQrC,qBAAqB,IAAI,kBAAkB;IAmB3C;;OAEG;IACH,cAAc,IAAI;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAaD,YAAY,IAAI,kBAAkB;IAIlC,eAAe,IAAI,IAAI;IAKvB,gBAAgB,IAAI,IAAI;IASxB,aAAa,EAAE,qBAAqB,CAgClC;IAMF,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI9D,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IASjE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAgBzC,aAAa,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,EAAE,OAAO,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E,WAAW;;;;;;;;;;;IAcX,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,4BAA4B;IAapC;;OAEG;YACW,mBAAmB;IAiOjC,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,oBAAoB;IAQ5B;;SAEK;IACL,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE;IA0FhE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,oBAAoB;IAmD5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IAKhC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA4C3C;;OAEG;IACH,6BAA6B,CAAC,oBAAoB,UAAO,GAAG,IAAI;IA8ChE;;OAEG;YACW,kBAAkB;IA4IhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,IAAI,IAAI;CAsBhB;AAED,eAAe,kBAAkB,CAAC"}

package/dist/PDFHighlightViewer.js

@@ -6,7 +6,7 @@ import { UnifiedInteractionHandler } from './core/interaction-handler';
 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, } from './utils/label-style';
+import { appendLabelIcon, applyBaseOutlineStyle, applyLabelOutlineStyle, applyLabelStyle, scaleLabelStyle, } from './utils/label-style';
 const CONTAINER_PADDING = 40;
 const ZOOM_STEP = 1.2;
 export class PDFHighlightViewer {
@@ -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;
@@ -441,23 +445,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 +485,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 +514,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 +564,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 +572,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 +593,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.debug(`Failed to render page ${pageNumber}:`, error);
                     }));
                 }
             }
@@ -615,7 +658,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);
@@ -881,6 +925,7 @@ export class PDFHighlightViewer {
     async reRenderVisiblePages() {
         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();
@@ -909,12 +954,15 @@ export class PDFHighlightViewer {
         const avgPageHeight = validDimensions > 0 ? totalHeight / validDimensions : this.defaultPageHeight;
         this.viewportManager.updateDimensions(this.container?.clientHeight || 600, avgPageHeight);
         // Render currently visible pages
-        const scrollTop = this.container.scrollTop;
         const containerHeight = this.container.clientHeight;
-        const visiblePages = this.viewportManager.getVisiblePages(scrollTop, containerHeight);
-        console.log('Re-rendering visible pages at new scale:', visiblePages);
+        // Restore scroll so we stay on the same page after zoom
+        this.container.scrollTop = this.getPageScrollTop(pageToKeep);
+        // 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 visiblePages) {
+        for (const pageNumber of visiblePagesAfterRestore) {
             try {
                 await this.renderPage(pageNumber);
             }
@@ -1191,10 +1239,10 @@ export class PDFHighlightViewer {
                     highlightDiv.setAttribute('data-term-id', highlight.id);
                     highlightDiv.setAttribute('data-page', String(pageNumber));
                     highlightDiv.setAttribute('data-bbox-index', String(bboxIndex));
-                    const left = normalizedBBox.x1 * scale;
-                    const top = normalizedBBox.y1 * scale;
-                    const width = (normalizedBBox.x2 - normalizedBBox.x1) * scale;
-                    const height = (normalizedBBox.y2 - normalizedBBox.y1) * scale;
+                    const left = Math.round(normalizedBBox.x1 * scale);
+                    const top = Math.round(normalizedBBox.y1 * scale);
+                    const width = Math.round((normalizedBBox.x2 - normalizedBBox.x1) * scale);
+                    const height = Math.round((normalizedBBox.y2 - normalizedBBox.y1) * scale);
                     highlightDiv.style.position = 'absolute';
                     highlightDiv.style.left = `${left}px`;
                     highlightDiv.style.top = `${top}px`;
@@ -1289,13 +1337,16 @@ export class PDFHighlightViewer {
                     });
                     highlightLayer.appendChild(highlightDiv);
                     if (highlight.label || highlight.beforeIcon) {
+                        const effectiveLabelStyle = highlight.isLabelScalable && scale !== 1
+                            ? scaleLabelStyle(highlight.labelStyle, scale)
+                            : highlight.labelStyle;
                         const labelEl = document.createElement('span');
                         labelEl.className = 'highlight-label';
                         labelEl.setAttribute('data-term-id', highlight.id);
                         labelEl.setAttribute('data-bbox-index', String(bboxIndex));
                         labelEl.dataset.baseLeft = String(left);
                         labelEl.dataset.baseTop = String(top);
-                        const { left: labelOffsetLeft, top: labelOffsetTop } = this.getLabelOffsets(highlight.labelStyle);
+                        const { left: labelOffsetLeft, top: labelOffsetTop } = this.getLabelOffsets(effectiveLabelStyle);
                         labelEl.style.position = 'absolute';
                         labelEl.style.left = `${left + labelOffsetLeft}px`;
                         labelEl.style.top = `${top + labelOffsetTop}px`;
@@ -1305,20 +1356,20 @@ export class PDFHighlightViewer {
                         labelEl.style.display = 'flex';
                         labelEl.style.alignItems = 'center';
                         labelEl.style.justifyContent = 'flex-end';
-                        labelEl.style.gap = '4px';
+                        labelEl.style.gap = highlight.isLabelScalable ? `${4 * scale}px` : '4px';
                         labelEl.style.pointerEvents = 'auto';
                         labelEl.style.cursor = 'pointer';
                         labelEl.style.whiteSpace = 'nowrap';
-                        if (highlight.labelStyle?.borderColor !== undefined ||
-                            highlight.labelStyle?.borderWidth !== undefined) {
-                            const borderColor = highlight.labelStyle?.borderColor ?? 'currentColor';
-                            const borderWidth = highlight.labelStyle?.borderWidth ?? '1px';
+                        if (effectiveLabelStyle?.borderColor !== undefined ||
+                            effectiveLabelStyle?.borderWidth !== undefined) {
+                            const borderColor = effectiveLabelStyle?.borderColor ?? 'currentColor';
+                            const borderWidth = effectiveLabelStyle?.borderWidth ?? '1px';
                             labelEl.style.border = `${borderWidth} solid ${borderColor}`;
                         }
-                        applyLabelOutlineStyle(labelEl, highlight.labelStyle);
-                        applyLabelStyle(labelEl, highlight.labelStyle);
+                        applyLabelOutlineStyle(labelEl, effectiveLabelStyle);
+                        applyLabelStyle(labelEl, effectiveLabelStyle);
                         labelEl.style.opacity = String(effectiveOpacity);
-                        appendLabelIcon(labelEl, highlight.beforeIcon, highlight.labelStyle);
+                        appendLabelIcon(labelEl, highlight.beforeIcon, effectiveLabelStyle);
                         if (highlight.label) {
                             labelEl.appendChild(document.createTextNode(highlight.label));
                         }
@@ -1389,7 +1440,10 @@ export class PDFHighlightViewer {
                 : parseFloat(el.dataset.originalOpacity ?? '0.3');
             const bboxIdx = el.getAttribute('data-bbox-index');
             const isWrapper = el.classList.contains('highlight-wrapper');
-            const labelStyle = highlight?.labelStyle;
+            const scale = this.currentScale;
+            const effectiveLabelStyle = highlight?.isLabelScalable && scale !== 1
+                ? scaleLabelStyle(highlight.labelStyle, scale)
+                : highlight?.labelStyle;
             const labelEl = isWrapper
                 ? el.querySelector('.highlight-label')
                 : bboxIdx !== null
@@ -1399,12 +1453,12 @@ export class PDFHighlightViewer {
                 if (!isWrapper) {
                     const baseLabelLeft = parseFloat(labelEl.dataset.baseLeft ?? '0');
                     const baseLabelTop = parseFloat(labelEl.dataset.baseTop ?? '0');
-                    const { left: labelOffsetLeft, top: labelOffsetTop } = this.getLabelOffsets(labelStyle);
+                    const { left: labelOffsetLeft, top: labelOffsetTop } = this.getLabelOffsets(effectiveLabelStyle);
                     labelEl.style.left = `${baseLabelLeft + labelOffsetLeft}px`;
                     labelEl.style.top = `${baseLabelTop + labelOffsetTop}px`;
                 }
-                applyLabelStyle(labelEl, labelStyle);
-                applyLabelOutlineStyle(labelEl, labelStyle);
+                applyLabelStyle(labelEl, effectiveLabelStyle);
+                applyLabelOutlineStyle(labelEl, effectiveLabelStyle);
                 labelEl.style.opacity = String(highlightBaseOpacity);
             }
             if (this.options.highlightsConfig?.enableMultilineHover &&
@@ -1497,10 +1551,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);
         }
     }