teamsync-pdf-viewer 1.3.5 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `teamsync-pdf-viewer` are documented here.
 
+## [1.5.0] — 2026-09-05
+
+### Added
+- **Undo & Redo Annotation Actions**: Added dedicated Undo and Redo buttons to the Annotate toolbar with live state reflection bound to history, alongside existing keyboard shortcuts (`Cmd+Z`/`Ctrl+Z` and `Cmd+Shift+Z`/`Ctrl+Y`).
+- **Underline, Strikeout & Squiggly Tools**: Added first-class text markup annotations with toolbar tools, stroke width and color controls, drag creation, selection tooltip quick actions, SVG rendering (straight lines and sinusoidal waves), full XFDF export/import roundtrip, and PDF export baking via `pdf-lib`.
+- **Text Annotation Automatic Word-Wrapping**: Text annotations now automatically wrap multi-line text cleanly inside SVG `<foreignObject>` containers (`word-break: break-word`, `overflow-wrap: break-word`, `white-space: pre-wrap`) and in baked PDF exports via dynamic text wrapping.
+- **Interactive 8-Handle Text Resizing**: Text annotations now feature an interactive selection bounding box with 8 resize handles (`nw`, `n`, `ne`, `e`, `se`, `s`, `sw`, `w`) with directional cursors, real-time live text reflow during drag, and single-step undo history.
+- **Quick-Markup Selection Tooltip**: Extended the floating selection tooltip with `[Highlight]`, `[Underline]`, `[Strikeout]`, and `[Squiggly]` quick actions.
+
+## [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/annotations/types.d.ts

@@ -6,7 +6,7 @@
  * /Rotate applied (top-left origin, PDF points). UI rotation applied by the viewer is composed on
  * top of this space at render time, so stored annotations are independent of the current view.
  */
-export type AnnotationType = 'rectangle' | 'ellipse' | 'line' | 'arrow' | 'freehand' | 'text' | 'note' | 'callout' | 'signature' | 'highlight' | 'digital_signature_placeholder' | 'link'
+export type AnnotationType = 'rectangle' | 'ellipse' | 'line' | 'arrow' | 'freehand' | 'text' | 'note' | 'callout' | 'signature' | 'highlight' | 'underline' | 'strikeout' | 'squiggly' | 'digital_signature_placeholder' | 'link'
 /**
  * An annotation imported from XFDF that this viewer cannot edit or render natively (e.g.
  * underline, squiggly, polygon, redaction). It is drawn as a read-only outline at its bounding

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/PageRenderer.d.ts

@@ -27,6 +27,9 @@ interface PageRendererProps {
     onMouseMove: (e: React.MouseEvent<Element>, pageNum: number) => void;
     onMouseUp: (e: React.MouseEvent<Element>, pageNum: number) => void;
     onAnnotationClick: (id: string, e: React.MouseEvent) => void;
+    onAnnotationDoubleClick?: (id: string, e: React.MouseEvent) => void;
+    onStartResize?: (id: string, handle: string, e: React.MouseEvent, pageNum: number) => void;
+    onStartMove?: (id: string, e: React.MouseEvent, pageNum: number) => void;
     onAnnotationMouseEnter: (id: string) => void;
     onClearSelection: () => void;
     watermark?: WatermarkOptions;
@@ -38,6 +41,6 @@ interface PageRendererProps {
     /** 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, hideAnnotationsUntilPageRendered }: 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, onAnnotationDoubleClick, onStartResize, onStartMove, 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/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,8 @@
+import { default as React } from 'react';
+interface TextSelectionTooltipProps {
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    onCopy?: (text: string) => void;
+    onAnnotateSelection?: (type: 'highlight' | 'underline' | 'strikeout' | 'squiggly') => 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' | 'underline' | 'strikeout' | 'squiggly' | '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>;