teamsync-pdf-viewer 1.3.4 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to `teamsync-pdf-viewer` are documented here.
 
+## [1.4.0] — 2026-09-04
+
+### Added
+- **Text Selection & Copying Support**: Users can now select and copy text directly from PDF pages in the viewer.
+- **Select & Pan Tool Modes**: Added `'select'` as a first-class `ToolMode`. Defaulted `activeTool` to `'select'` (matching Adobe Acrobat, Chrome, and PDF.js). Added "Select Text" (`MousePointer`) and "Pan Tool" (`Hand`) toggle buttons to the top toolbar. Added `defaultTool?: 'select' | 'pan'` and `enableTextSelection?: boolean` props to `WebViewerOptions` and `<TeamSyncViewer>`.
+- **Triple-Layer Copy Workflows**:
+  - **Keyboard**: `Cmd+C` (macOS) / `Ctrl+C` (Windows/Linux) copies selected text to the clipboard.
+  - **Native Context Menu**: Right-clicking selected text preserves the native browser context menu ("Copy", "Look Up", "Search", "Translate").
+  - **Floating Quick-Copy Tooltip**: Rendered a sleek floating pill above active text selections with a `[Copy]` button and `✓ Copied!` visual feedback.
+- **Public SDK APIs & Events**: Added `instance.getSelectedText(): string` and `instance.copySelectedText(): Promise<boolean>`, Apryse tool aliases in `instance.UI.setToolMode('select' | 'textSelect' | 'pan')`, and `textSelected` and `textCopied` events to `ViewerEventMap`.
+- **Cross-Environment Clipboard Utility**: Exported `copyTextToClipboard` with modern `navigator.clipboard.writeText` and a hidden `document.execCommand('copy')` fallback for non-HTTPS and iframe environments.
+
+### Fixed
+- **Panning Drag Interference**: Drag-panning is now strictly scoped to `activeTool === 'pan'`, ensuring text selection click-and-drag is never hijacked.
+- **SVG Overlay Pointer Events**: Configured SVG overlay to `pointerEvents: 'none'` in select and pan modes so clicks reach the text layer, while preserving `pointerEvents: 'all'` on individual annotation elements.
+- **PDF.js v6 Text Layer CSS Variables**: Declared `--total-scale-factor: 1; --scale-factor: 1; --user-unit: 1; --min-font-size: 1; --scale-round-x: 1px; --scale-round-y: 1px;` on `.textLayer`, resolving collapsed 0px font sizes and heights. Styled `.textLayer span::selection` with transparent text so the underlying canvas raster remains crisp without double glyphs.
+
+## [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

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,11 @@ 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;
+    enableTextSelection?: boolean;
+    defaultTool?: 'select' | 'pan';
+    showSelectionTooltip?: 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, enableTextSelection, defaultTool, showSelectionTooltip }: 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;
@@ -30,6 +35,14 @@ export interface TeamSyncViewerProps extends Omit<WebViewerOptions, 'path'> {
     onAnnotationsChange?: (annotations: Annotation[]) => void;
     /** Fires whenever transient highlights change. */
     onTransientHighlightsChange?: (highlights: TransientHighlight[]) => void;
+    /** Fires whenever the user selects text within the document. */
+    onTextSelected?: (info: {
+        text: string;
+    }) => void;
+    /** Fires whenever text is copied from the document. */
+    onTextCopied?: (info: {
+        text: string;
+    }) => void;
     className?: string;
     style?: React.CSSProperties;
 }

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

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface TextSelectionTooltipProps {
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    onCopy?: (text: string) => void;
+}
+export declare const TextSelectionTooltip: React.FC<TextSelectionTooltipProps>;
+export default TextSelectionTooltip;

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

@@ -103,6 +103,15 @@ export declare class WebViewerInstance {
      * Uses the bytes of the loaded document; never re-fetches the URL.
      */
     getFileData(options?: ExportOptions): Promise<Uint8Array>;
+    /**
+     * Returns the currently selected text string from the document viewer, or an empty string if nothing is selected.
+     */
+    getSelectedText(): string;
+    /**
+     * Copies the currently selected text to the system clipboard.
+     * Resolves to true if copying succeeded, false otherwise.
+     */
+    copySelectedText(): Promise<boolean>;
     readonly UI: {
         /** Theming is not implemented; kept for API compatibility. */
         setTheme: (_theme: string) => void;
@@ -114,6 +123,8 @@ export declare class WebViewerInstance {
         disableElements: (elements: string[]) => void;
         setActiveLeftPanel: (panel: string) => void;
         setToolMode: (tool: string | null) => void;
+        getSelectedText: () => string;
+        copySelectedText: () => Promise<boolean>;
         fitWidth: () => void;
         fitPage: () => void;
         fitToWidth: () => void;

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

@@ -54,6 +54,7 @@ export interface ViewerUser {
     name: string;
 }
 export type InitialScale = number | 'fit-width' | 'fit-page';
+export type ToolMode = 'select' | 'pan' | 'rectangle' | 'ellipse' | 'line' | 'arrow' | 'freehand' | 'highlight' | 'text' | 'eraser' | 'note' | 'callout' | 'signature' | 'digital_signature' | 'link' | 'redaction' | null;
 /**
  * Options accepted by `createWebViewer()` (and the deprecated `WebViewer()` alias).
  * Every option is also available as a prop on `<TeamSyncViewer>`.
@@ -100,6 +101,18 @@ 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;
+    /** Allow selecting text from PDF pages (default true). */
+    enableTextSelection?: boolean;
+    /** Initial tool mode on load. Defaults to 'select'. */
+    defaultTool?: 'select' | 'pan';
+    /** Show floating quick-action copy badge above selected text (default true). */
+    showSelectionTooltip?: boolean;
 }
 /** Events available through `instance.on(type, listener)`. */
 export interface ViewerEventMap {
@@ -116,6 +129,10 @@ export interface ViewerEventMap {
         url: string;
         pageNumber: number;
     };
+    pageRendered: {
+        url: string;
+        pageNumber: number;
+    };
     pageChanged: {
         pageNumber: number;
         numPages: number;
@@ -131,6 +148,12 @@ export interface ViewerEventMap {
     toolChanged: {
         tool: string | null;
     };
+    textSelected: {
+        text: string;
+    };
+    textCopied: {
+        text: string;
+    };
     destroy: Record<string, never>;
 }
 export type ViewerEventType = keyof ViewerEventMap;

package/dist/src/index.d.ts

@@ -17,7 +17,9 @@ export { ViewerBus } from './core/eventBus';
 export type { BusListener } from './core/eventBus';
 export { buildPdfBytes, MAX_EXPORT_BYTES } from './core/export';
 export type { ExportInput, ExportOptions } from './core/export';
-export type { WebViewerOptions, Redaction, WatermarkOptions, SDKPermissions, ViewerUser, InitialScale, ViewerEventMap, ViewerEventType, } from './core/types';
+export type { WebViewerOptions, Redaction, WatermarkOptions, SDKPermissions, ViewerUser, InitialScale, ViewerEventMap, ViewerEventType, ToolMode, } from './core/types';
+export { copyTextToClipboard } from './utils/clipboardUtils';
+export { TextSelectionTooltip } from './components/TextSelectionTooltip';
 export type { Annotation, AnnotationType, AnnotationPoint, AnnotationInput } from './annotations/types';
 export { AnnotationManager } from './annotations/AnnotationManager';
 export type { AnnotationAction, AnnotationChangedEvent, CommitOptions, ViewerUserInfo } from './annotations/AnnotationManager';

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

@@ -0,0 +1,5 @@
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ * Cross-environment clipboard utility with secure and fallback execCommand copying.
+ */
+export declare function copyTextToClipboard(text: string): Promise<boolean>;

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

@@ -2,7 +2,7 @@
  * © 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 = 4096;
@@ -13,7 +13,7 @@ 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;
 /**