teamsync-pdf-viewer 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to `teamsync-pdf-viewer` are documented here.
 
+## [1.3.3] — 2026-09-04
+
+### Fixed
+- **Initial Programmatic Fit Scroll Compensation**: Fixed view jump on initial fit where scaling from seed 1.0 to ~2.27 at `scrollTop = 0` triggered viewport center compensation and hid page 1's top. Added `calculateScrollCompensation` with programmatic fit bypass and top-of-document boundary guard.
+- **Capped Canvas Output Scale**: Capped `outputScale = Math.min(window.devicePixelRatio || 1, 2)` in `PageRenderer` and `LeftSidebar`, reducing GPU canvas raster memory and repaint strain on 3x+ Retina and mobile displays by over 55% while preserving 2x sharpness.
+- **Scroll Shaking & Up-Front Dimension Reservation**: Replaced asynchronous sequential dimension streaming with up-front dimension measurement and space pre-allocation (`estimatePageDimensions`). Full scroll container height and row tops are reserved on the first frame, eliminating layout recalculations and page shifting/shaking during scrolling.
+- **Exported Layout & Zoom Utilities**: Exported `calculateScrollCompensation`, `estimatePageDimensions`, `computeRowLayout`, `DEFAULT_FALLBACK_DIMS`, and related types from the package root.
+
+## [1.3.2] — 2026-09-04
+
+### Fixed
+- **Hardware-Bounded Canvas Texture Clamping**: Fixed crash and invisible content when zooming past 800% (up to 1000%) by clamping internal raster buffers to safe hardware limits (`MAX_CANVAS_DIM` = 4096 / 8192 px, `MAX_CANVAS_PIXELS` = 16.7 MP / ~64MB buffer) while keeping CSS layout full-sized for smooth, distortion-free GPU scaling.
+- **In-Flight Render Task Cancellation**: Resolved UI freezing and crashes during rapid clicking of `+` / `-` zoom buttons by cancelling running PDF.js render tasks directly by reference and releasing completed/cancelled page resources (`page.cleanup()`).
+- **Immediate GPU Texture Deallocation**: Zeroed offscreen `tempCanvas` dimensions immediately after raster blitting to return GPU backing texture memory to the system without waiting for garbage collection.
+- **Zoom Gesture Debouncing**: Added 150ms debounce on zoom changes to allow existing textures to scale at 60fps via CSS transforms before triggering expensive PDF.js vector rasterization upon motion settling.
+- **Eliminated False Cache Invalidation in `React.memo`**: Removed stale `scrollTop` / `scrollLeft` checks in `PageRenderer`, preventing re-rendering of all mounted pages on every scroll and zoom frame.
+- **Scale-Aware Virtualization Window**: Virtualized document rows dynamically based on zoom scale, keeping mounted pages to a maximum of 3 at high zoom levels.
+- **Intuitive Zoom Stepping Curves & Controls**: Implemented responsive stepping curves (+0.25 under 2x, +0.5 under 5x, +1.0 above 5x), capped max zoom at 1000% (`MAX_SCALE = 10.0`), and disabled `+` / `-` toolbar buttons at boundary limits. Exported `MIN_SCALE`, `MAX_SCALE`, `clampScale`, `calculateNextZoomIn`, and `calculateNextZoomOut`.
+
 ## [1.3.1] — 2026-09-04
 
 ### Fixed

package/dist/src/index.d.ts

@@ -31,4 +31,8 @@ export type { PrintOptions } from './core/print';
 export { usePdfSearch, searchPdfText } from './hooks/usePdfSearch';
 export type { SearchResult, SearchBounds } from './hooks/usePdfSearch';
 export type { TransientHighlight } from './core/types';
+export { MIN_SCALE, MAX_SCALE, clampScale, calculateNextZoomIn, calculateNextZoomOut, calculateScrollCompensation } from './utils/zoomUtils';
+export type { ScrollCompensationParams, ScrollPosition } from './utils/zoomUtils';
+export { estimatePageDimensions, computeRowLayout, DEFAULT_FALLBACK_DIMS, hasDimensionMismatch } from './utils/layoutUtils';
+export type { PageDimension, RowLayout } from './utils/layoutUtils';
 export * from './plugins/types';

package/dist/src/utils/layoutUtils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ */
+export interface PageDimension {
+    width: number;
+    height: number;
+}
+export interface RowLayout {
+    heights: number[];
+    tops: number[];
+    total: number;
+}
+/** Standard US Letter dimensions in PDF points (72 points/inch: 8.5 x 11 inches). */
+export declare const DEFAULT_FALLBACK_DIMS: PageDimension;
+/**
+ * Pre-allocates an array of page dimensions for the entire document up front,
+ * reserving estimated space based on a sample page (e.g. Page 1).
+ */
+export declare function estimatePageDimensions(numPages: number, sampleDim?: PageDimension): PageDimension[];
+/**
+ * Computes row heights, vertical tops, and total container scroll height
+ * for given rows of pages and scale.
+ */
+export declare function computeRowLayout(rows: number[][], dimsFor: (page: number) => PageDimension, scale: number, gap?: number): RowLayout;
+/**
+ * Checks if any page dimension in array A differs from array B beyond a tolerance.
+ */
+export declare function hasDimensionMismatch(dimsA: PageDimension[], dimsB: PageDimension[], tolerance?: number): boolean;

package/dist/src/utils/zoomUtils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ */
+export declare const MIN_SCALE = 0.1;
+export declare const MAX_SCALE = 10;
+export declare const isSafariOrMobile: () => boolean;
+export declare const MAX_CANVAS_DIM = 8192;
+export declare const MAX_CANVAS_DIM_MOBILE = 4096;
+export declare const MAX_CANVAS_PIXELS = 16777216;
+/**
+ * Calculates the next step when zooming in.
+ * - Below 200%: steps by +25%
+ * - 200% to 500%: steps by +50%
+ * - 500% to 1000%: steps by +100%
+ */
+export declare function calculateNextZoomIn(currentScale: number, maxScale?: number): number;
+/**
+ * Calculates the next step when zooming out.
+ * - At or below 200%: steps by -25%
+ * - 200% to 500%: steps by -50%
+ * - Above 500%: steps by -100%
+ */
+export declare function calculateNextZoomOut(currentScale: number, minScale?: number): number;
+/**
+ * Clamps and rounds a requested zoom level within [minScale, maxScale].
+ */
+export declare function clampScale(scale: number, minScale?: number, maxScale?: number): number;
+/**
+ * Calculates the safe rasterization scale for PDF.js viewport rendering so that
+ * canvas dimensions and texture memory stay strictly within hardware limits.
+ */
+export declare function calculateSafeRenderScale(scale: number, outputScale: number, unscaledWidth: number, unscaledHeight: number, maxDim?: number, maxPixels?: number): number;
+export interface ScrollCompensationParams {
+    prevScale: number;
+    newScale: number;
+    containerWidth: number;
+    containerHeight: number;
+    currentScrollLeft: number;
+    currentScrollTop: number;
+    basePageWidth: number;
+    focusPoint?: {
+        vx: number | null;
+        vy: number | null;
+    } | null;
+    isProgrammatic?: boolean;
+}
+export interface ScrollPosition {
+    scrollLeft: number;
+    scrollTop: number;
+}
+/**
+ * Calculates compensating scroll offsets during scale changes.
+ * Prevents view jumping or pushing page 1 down on initial fit or programmatic fit.
+ */
+export declare function calculateScrollCompensation(params: ScrollCompensationParams): ScrollPosition;