teamsync-pdf-viewer 1.3.2 → 1.3.4

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `teamsync-pdf-viewer` are documented here.
 
+## [1.3.4] — 2026-09-04
+
+### Fixed
+- **Mobile & Android Canvas Clamping**: Expanded `isMobileOrTablet()` to comprehensively detect Android and mobile devices, capping max dimension to 2048px and pixel buffer to 4.2 MP (~16MB) to eliminate canvas crashes and blank pages on mobile devices.
+- **Render Task Lifecycle & Race Condition Fix**: Scoped `currentPage` locally within `renderCanvas` so cancelling in-flight renders during rapid zoom clicks never accidentally destroys resources of a newly scheduled page proxy.
+- **Graceful Context Allocation Fallback**: Added half-resolution fallback if `getContext('2d')` ever encounters device memory pressure, preventing invisible pages.
+- **Rapid Click Selection Prevention**: Added `userSelect: none` on toolbar zoom buttons to eliminate browser text selection during rapid clicking.
+
+## [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

package/dist/src/index.d.ts

@@ -31,5 +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 } from './utils/zoomUtils';
+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

@@ -3,10 +3,12 @@
  */
 export declare const MIN_SCALE = 0.1;
 export declare const MAX_SCALE = 10;
+export declare const isMobileOrTablet: () => boolean;
 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;
+export declare const MAX_CANVAS_DIM = 4096;
+export declare const MAX_CANVAS_DIM_MOBILE = 2048;
+export declare const MAX_CANVAS_PIXELS = 8388608;
+export declare const MAX_CANVAS_PIXELS_MOBILE = 4194304;
 /**
  * Calculates the next step when zooming in.
  * - Below 200%: steps by +25%
@@ -30,3 +32,26 @@ export declare function clampScale(scale: number, minScale?: number, maxScale?:
  * 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;