teamsync-pdf-viewer 1.3.3 → 1.3.5

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `teamsync-pdf-viewer` are documented here.
 
+## [1.3.5] — 2026-09-04
+
+### Fixed
+- **Annotations Before Document Canvas**: Fixed bug where the SVG annotation overlay and transient citation highlights rendered synchronously over a still-blank white container on initial load, virtualized scroll (pages 2+), and post-open fit re-renders. Annotations now wait until the underlying page canvas has finished rendering its pixels before becoming visible.
+- **`hideAnnotationsUntilPageRendered` Option**: Added `hideAnnotationsUntilPageRendered?: boolean` (defaults to `true`) across `WebViewerOptions`, `TeamSyncViewerProps`, and `DocumentViewerProps`.
+- **`pageRendered` Lifecycle Event**: Added `pageRendered: { url: string; pageNumber: number }` to `ViewerEventMap` and `onPageRendered` callback to `TeamSyncViewerProps` and `DocumentViewerProps`, giving consumers a lifecycle hook whenever any page finishes canvas rendering.
+- **Capped Zoom Level to 800%**: Changed `MAX_SCALE = 8.0` (800%), updated zoom stepping and boundary checks, and updated toolbar preset dropdown to cap at 800%.
+
+## [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

package/dist/src/components/DocumentViewer.d.ts

@@ -35,6 +35,8 @@ interface DocumentViewerProps {
     onLoadError?: (error: Error, info: DocumentLoadErrorInfo) => void;
     /** Fires once per loaded document, after the first page canvas has been painted. */
     onFirstPageRendered?: (pageNumber: number) => void;
+    /** Fires whenever any page canvas has finished rendering. */
+    onPageRendered?: (pageNumber: number) => void;
     onPageChange?: (pageNumber: number, numPages: number) => void;
     pageTransition: 'continuous' | 'page-by-page';
     pageLayout: 'single' | 'double' | 'cover-facing';
@@ -47,6 +49,8 @@ interface DocumentViewerProps {
     page?: number;
     transientHighlights?: TransientHighlight[];
     permissions?: SDKPermissions;
+    /** Whether to hide annotations and transient highlights until the page canvas has finished rendering. Default: true. */
+    hideAnnotationsUntilPageRendered?: boolean;
 }
-export default function DocumentViewer({ leftSidebarOpen, rightSidebarOpen, activeTab, annotationManager, initialDoc, loadNonce, withCredentials, assets, sidebars, redactions, regexRedactions, scale, setScale, sidebarTab, setSidebarTab, onAnnotationsChange, onRedactionsChange, onDocumentLoaded, onLoadError, onFirstPageRendered, onPageChange, pageTransition, pageLayout, rotation, setRotation, watermark, watermarkText, enableAnnotations: _enableAnnotations, initialPage, page, transientHighlights, permissions }: DocumentViewerProps): React.JSX.Element;
+export default function DocumentViewer({ leftSidebarOpen, rightSidebarOpen, activeTab, annotationManager, initialDoc, loadNonce, withCredentials, assets, sidebars, redactions, regexRedactions, scale, setScale, sidebarTab, setSidebarTab, onAnnotationsChange, onRedactionsChange, onDocumentLoaded, onLoadError, onFirstPageRendered, onPageRendered, onPageChange, pageTransition, pageLayout, rotation, setRotation, watermark, watermarkText, enableAnnotations: _enableAnnotations, initialPage, page, transientHighlights, permissions, hideAnnotationsUntilPageRendered }: DocumentViewerProps): React.JSX.Element;
 export {};

package/dist/src/components/PageRenderer.d.ts

@@ -35,7 +35,9 @@ interface PageRendererProps {
     onDiscardRedaction?: (redaction: Redaction) => void;
     /** Called after the page canvas has been painted (used for first-page-rendered telemetry). */
     onRendered?: (pageNum: number) => void;
+    /** Whether to hide annotations and transient highlights until the page canvas has finished rendering. Default: true. */
+    hideAnnotationsUntilPageRendered?: boolean;
 }
-declare function PageRendererComponent({ pageNum, pdfDoc, scale, rotation, containerWidth: _containerWidth, containerHeight: _containerHeight, scrollTop: _scrollTop, scrollLeft: _scrollLeft, pageTop, pageLeft, basePageWidth, basePageHeight, activeTab, activeTool, annotations, selectedAnnotationId, activeSearchResult, transientHighlights, onMouseDown, onMouseMove, onMouseUp, onAnnotationClick, onAnnotationMouseEnter, onClearSelection, watermark, watermarkText, redactions, onDiscardRedaction, onRendered }: PageRendererProps): React.JSX.Element;
+declare function PageRendererComponent({ pageNum, pdfDoc, scale, rotation, containerWidth: _containerWidth, containerHeight: _containerHeight, scrollTop: _scrollTop, scrollLeft: _scrollLeft, pageTop, pageLeft, basePageWidth, basePageHeight, activeTab, activeTool, annotations, selectedAnnotationId, activeSearchResult, transientHighlights, onMouseDown, onMouseMove, onMouseUp, onAnnotationClick, onAnnotationMouseEnter, onClearSelection, watermark, watermarkText, redactions, onDiscardRedaction, onRendered, hideAnnotationsUntilPageRendered }: PageRendererProps): React.JSX.Element;
 declare const PageRenderer: React.MemoExoticComponent<typeof PageRendererComponent>;
 export default PageRenderer;

package/dist/src/components/SideBySideViewer.d.ts

@@ -24,6 +24,7 @@ interface SideBySideViewerProps {
     selectedDiffId?: string | null;
     onSelectDiff?: (id: string) => void;
     onScrollSync?: (scrollTop: number, scrollLeft: number) => void;
+    hideAnnotationsUntilPageRendered?: boolean;
 }
-export default function SideBySideViewer({ pdfDocA, pdfDocB, pageNum, scale, rotation, basePageDims, activeTab, activeTool, annotations, watermark, watermarkText, redactions, diffsA, diffsB, selectedDiffId, onSelectDiff }: SideBySideViewerProps): React.JSX.Element;
+export default function SideBySideViewer({ pdfDocA, pdfDocB, pageNum, scale, rotation, basePageDims, activeTab, activeTool, annotations, watermark, watermarkText, redactions, diffsA, diffsB, selectedDiffId, onSelectDiff, hideAnnotationsUntilPageRendered }: SideBySideViewerProps): React.JSX.Element;
 export {};

package/dist/src/components/TeamSyncViewer.d.ts

@@ -22,6 +22,11 @@ export interface TeamSyncViewerProps extends Omit<WebViewerOptions, 'path'> {
         url: string;
         pageNumber: number;
     }) => void;
+    /** Fires whenever any page canvas has finished rendering. */
+    onPageRendered?: (info: {
+        url: string;
+        pageNumber: number;
+    }) => void;
     /** Fires (in addition to onDocumentLoadError) when the document is password protected. */
     onPasswordRequired?: (info: {
         url: string;

package/dist/src/core/types.d.ts

@@ -100,6 +100,12 @@ export interface WebViewerOptions {
     leftPanelOpen?: boolean;
     /** Focus the viewer on mount so keyboard shortcuts work immediately. Default false. */
     autoFocus?: boolean;
+    /**
+     * Hide SVG annotation overlays and transient highlights until the underlying page canvas has finished rendering.
+     * Prevents annotations from rendering over a blank white page container on initial load, scroll, or fit re-render.
+     * Default true.
+     */
+    hideAnnotationsUntilPageRendered?: boolean;
 }
 /** Events available through `instance.on(type, listener)`. */
 export interface ViewerEventMap {
@@ -116,6 +122,10 @@ export interface ViewerEventMap {
         url: string;
         pageNumber: number;
     };
+    pageRendered: {
+        url: string;
+        pageNumber: number;
+    };
     pageChanged: {
         pageNumber: number;
         numPages: number;

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

@@ -2,16 +2,18 @@
  * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
  */
 export declare const MIN_SCALE = 0.1;
-export declare const MAX_SCALE = 10;
+export declare const MAX_SCALE = 8;
+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%
  * - 200% to 500%: steps by +50%
- * - 500% to 1000%: steps by +100%
+ * - 500% to 800%: steps by +100%
  */
 export declare function calculateNextZoomIn(currentScale: number, maxScale?: number): number;
 /**