teamsync-pdf-viewer 1.3.5 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 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

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

@@ -51,6 +51,9 @@ interface DocumentViewerProps {
     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, onPageRendered, onPageChange, pageTransition, pageLayout, rotation, setRotation, watermark, watermarkText, enableAnnotations: _enableAnnotations, initialPage, page, transientHighlights, permissions, hideAnnotationsUntilPageRendered }: 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/TeamSyncViewer.d.ts

@@ -35,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>`.
@@ -106,6 +107,12 @@ export interface WebViewerOptions {
      * 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 {
@@ -141,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>;