teamsync-pdf-viewer 1.1.0 → 1.2.1

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

@@ -6,7 +6,13 @@
  * /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' | '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
+ * box and re-exported verbatim (`rawXfdf`) so nothing is lost on a save round-trip.
+ */
+ | 'opaque';
 export interface AnnotationPoint {
     x: number;
     y: number;
@@ -42,4 +48,25 @@ export interface Annotation {
     authorId?: string;
     /** When true the annotation cannot be moved, edited or deleted in the UI. */
     readOnly?: boolean;
+    /** Multi-stroke ink (each stroke a polyline). `points` holds the first stroke for legacy consumers. */
+    strokes?: AnnotationPoint[][];
+    /** ISO-8601 timestamps (XFDF creationdate / date). */
+    createdAt?: string;
+    modifiedAt?: string;
+    /** Subject / XFDF element name of an opaque annotation (informational). */
+    opaqueKind?: string;
+    /** Verbatim XFDF element for `opaque` annotations. */
+    rawXfdf?: string;
+    /**
+     * XFDF attributes and child elements this viewer does not model (e.g. Apryse `trn-custom-data`,
+     * `defaultappearance`). Preserved on import and re-emitted on export so other viewers keep
+     * their metadata across a round-trip.
+     */
+    xfdfExtras?: {
+        attrs?: Record<string, string>;
+        children?: string[];
+    };
 }
+export type AnnotationInput = Omit<Annotation, 'id'> & {
+    id?: string;
+};

package/dist/src/annotations/xfdf.d.ts

@@ -0,0 +1,18 @@
+import { Annotation } from './types';
+import { GeometryResolver } from './geometry';
+export declare const XFDF_NS = "http://ns.adobe.com/xfdf/";
+export interface XfdfExportOptions {
+    /** Annotations to serialize (default: all given). */
+    annotList?: Annotation[];
+    /** Write the author's display name into `title` (default true). */
+    useDisplayAuthor?: boolean;
+}
+/** ISO-8601 -> PDF date `D:YYYYMMDDHHmmSS+HH'mm'`. */
+export declare function toPdfDate(iso: string | undefined): string;
+/** PDF date -> ISO-8601 (best effort; returns undefined when unparseable). */
+export declare function fromPdfDate(pdf: string | null | undefined): string | undefined;
+/** Serialize one annotation to an XFDF element (no envelope). */
+export declare function annotationToXfdfFragment(a: Annotation, resolve: GeometryResolver, opts?: XfdfExportOptions): Promise<string>;
+/** Serialize annotations to a complete XFDF document. */
+export declare function annotationsToXfdf(annotations: Annotation[], resolve: GeometryResolver, opts?: XfdfExportOptions): Promise<string>;
+export declare function parseXfdf(xml: string, resolve: GeometryResolver): Promise<Annotation[]>;

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

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+interface CompareCurtainSliderProps {
+    positionPercent: number;
+    onChangePosition: (pos: number) => void;
+    containerRef: React.RefObject<HTMLDivElement | null>;
+}
+export default function CompareCurtainSlider({ positionPercent, onChangePosition, containerRef }: CompareCurtainSliderProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { CompareMode, CompareState } from '../types/compare';
+interface CompareToolbarProps {
+    compareState: CompareState;
+    onSetMode: (mode: CompareMode) => void;
+    onSetColors: (colorA: string, colorB: string) => void;
+    onToggleCurtain: () => void;
+    onPrevDiff: () => void;
+    onNextDiff: () => void;
+    onExit: () => void;
+}
+export default function CompareToolbar({ compareState, onSetMode, onSetColors, onToggleCurtain, onPrevDiff, onNextDiff, onExit }: CompareToolbarProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { DiffBoundingBox } from '../types/compare';
+interface DiffHighlightOverlayProps {
+    boxes: DiffBoundingBox[];
+    scale: number;
+    colorScheme?: 'deletions' | 'additions' | 'all';
+    selectedDiffId?: string | null;
+    onSelectDiff?: (id: string) => void;
+}
+export default function DiffHighlightOverlay({ boxes, scale, colorScheme, selectedDiffId, onSelectDiff }: DiffHighlightOverlayProps): React.JSX.Element | null;
+export {};

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

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { DiffItem, TextDiffSegment } from '../types/compare';
+interface DiffSummarySidebarProps {
+    isOpen: boolean;
+    onClose: () => void;
+    diffItems: DiffItem[];
+    textDiffs: TextDiffSegment[];
+    currentDiffIndex: number;
+    onSelectDiff: (index: number) => void;
+    onJumpToPage: (pageIndex: number) => void;
+}
+export default function DiffSummarySidebar({ isOpen, diffItems, textDiffs, currentDiffIndex, onSelectDiff, onJumpToPage }: DiffSummarySidebarProps): React.JSX.Element | null;
+export {};

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

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { Annotation } from '../annotations/types';
+import { AnnotationManager } from '../annotations/AnnotationManager';
 import { Redaction, WatermarkOptions, SDKPermissions, PdfAssetPaths } from '../core/types';
 import * as pdfjsLib from 'pdfjs-dist';
 export interface DocumentLoadErrorInfo {
@@ -10,6 +11,8 @@ interface DocumentViewerProps {
     leftSidebarOpen: boolean;
     rightSidebarOpen: boolean;
     activeTab: string;
+    /** Canonical annotation list, history, permissions and XFDF (owned by the viewer instance). */
+    annotationManager: AnnotationManager;
     initialDoc?: string;
     /** Bump to force a reload of the same URL (retry after a load error). */
     loadNonce?: number;
@@ -43,5 +46,5 @@ interface DocumentViewerProps {
     initialPage?: number;
     permissions?: SDKPermissions;
 }
-export default function DocumentViewer({ leftSidebarOpen, rightSidebarOpen, activeTab, 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, 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, onPageChange, pageTransition, pageLayout, rotation, setRotation, watermark, watermarkText, enableAnnotations: _enableAnnotations, initialPage, permissions }: DocumentViewerProps): React.JSX.Element;
 export {};

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

@@ -16,6 +16,7 @@ interface HeaderProps {
     onDownload: () => void;
     onFullScreen: () => void;
     onSaveAs: () => void;
+    onPrint?: () => void;
     onOpenSettings: () => void;
     onOpenAbout: () => void;
     onOpenSidebarTab: (tab: 'Comments' | 'Search') => void;
@@ -31,5 +32,5 @@ interface HeaderProps {
     plugins?: ViewerPlugin[];
     permissions?: SDKPermissions;
 }
-export default function Header({ activeTab, setActiveTab, leftSidebarOpen, setLeftSidebarOpen, rightSidebarOpen, setRightSidebarOpen: _setRightSidebarOpen, sidebarTab, scale, onZoomIn, onZoomOut, onZoomSet, onDownload, onFullScreen, onSaveAs, onOpenSettings, onOpenAbout, onOpenSidebarTab, pageTransition, setPageTransition, pageLayout, setPageLayout, rotation, setRotation, signatureCount, enableAnnotations, enableSign, plugins, permissions }: HeaderProps): React.JSX.Element;
+export default function Header({ activeTab, setActiveTab, leftSidebarOpen, setLeftSidebarOpen, rightSidebarOpen, setRightSidebarOpen: _setRightSidebarOpen, sidebarTab, scale, onZoomIn, onZoomOut, onZoomSet, onDownload, onFullScreen, onSaveAs, onPrint, onOpenSettings, onOpenAbout, onOpenSidebarTab, pageTransition, setPageTransition, pageLayout, setPageLayout, rotation, setRotation, signatureCount, enableAnnotations, enableSign, plugins, permissions }: HeaderProps): React.JSX.Element;
 export {};

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

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+import { SDKPermissions, WatermarkOptions, Redaction } from '../core/types';
+import { DiffBoundingBox } from '../types/compare';
+import * as pdfjsLib from 'pdfjs-dist';
+interface SideBySideViewerProps {
+    pdfDocA: pdfjsLib.PDFDocumentProxy | null;
+    pdfDocB: pdfjsLib.PDFDocumentProxy | null;
+    pageNum: number;
+    scale: number;
+    rotation: number;
+    basePageDims: {
+        width: number;
+        height: number;
+    };
+    activeTab: string;
+    activeTool: string | null;
+    annotations: any[];
+    permissions?: SDKPermissions;
+    watermark?: WatermarkOptions;
+    watermarkText?: string;
+    redactions?: Redaction[];
+    diffsA?: DiffBoundingBox[];
+    diffsB?: DiffBoundingBox[];
+    selectedDiffId?: string | null;
+    onSelectDiff?: (id: string) => void;
+    onScrollSync?: (scrollTop: number, scrollLeft: number) => void;
+}
+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 {};

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

@@ -1,6 +1,7 @@
 import { ViewerBus } from './eventBus';
 import { ExportOptions } from './export';
 import { Annotation } from '../annotations/types';
+import { AnnotationManager } from '../annotations/AnnotationManager';
 import { Redaction, WatermarkOptions, ViewerEventMap, ViewerEventType } from './types';
 /**
  * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
@@ -23,12 +24,14 @@ export interface ViewerBinding {
 }
 export declare class WebViewerInstance {
     readonly bus: ViewerBus;
+    /** Annotation list, history, permissions and XFDF import/export. */
+    readonly annotationManager: AnnotationManager;
     /** Root element of the viewer once mounted. */
     element: HTMLElement | null;
     private binding;
     private unmountRoot;
     private destroyed;
-    constructor(bus: ViewerBus);
+    constructor(bus: ViewerBus, annotationManager?: AnnotationManager);
     /** @internal */
     _bind(binding: ViewerBinding, element: HTMLElement | null): void;
     /** @internal */
@@ -54,6 +57,8 @@ export declare class WebViewerInstance {
     getCurrentPage(): number;
     getPageCount(): number;
     getAnnotations(): Annotation[];
+    /** Print the exported document (annotations, redactions and watermark baked in). */
+    print(): void;
     /**
      * Build the exported PDF (annotations + watermark baked, redacted pages rasterized).
      * Uses the bytes of the loaded document; never re-fetches the URL.
@@ -72,13 +77,14 @@ export declare class WebViewerInstance {
         fitPage: () => void;
         fitToWidth: () => void;
         fitToPage: () => void;
+        startCompare: (docA: any, docB: any, options?: any) => void;
+        stopCompare: () => void;
+        setCompareMode: (mode: "overlay" | "side-by-side" | "semantic") => void;
+        setCompareColors: (colorA: string, colorB: string) => void;
     };
     readonly Core: {
-        annotationManager: {
-            /** Legacy: returns the bespoke JSON annotation list. XFDF import/export arrives in 1.2.0. */
-            exportAnnotations: () => string;
-            getAnnotationsList: () => Annotation[];
-        };
+        /** The real AnnotationManager (XFDF import/export, granular events, permissions). */
+        readonly annotationManager: AnnotationManager;
         documentViewer: {
             addEventListener: (event: string, callback: (detail: unknown) => void) => (() => void);
             removeEventListener: (event: string, callback: (detail: unknown) => void) => void;

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

@@ -1,10 +1,13 @@
 import { Annotation } from '../annotations/types';
 import { Redaction, WatermarkOptions } from './types';
+import { GeometryResolver } from '../annotations/geometry';
 /** Refuse to build documents larger than this in the browser (memory safety). */
 export declare const MAX_EXPORT_BYTES: number;
 export interface ExportInput {
     /** Returns the original document bytes (prefer `pdfDocument.getData()`). */
     getSourceBytes: () => Promise<Uint8Array | ArrayBuffer>;
+    /** Page geometry resolver (from the loaded pdf.js document). Derived from the bytes when absent. */
+    getPageGeometry?: GeometryResolver;
     annotations: Annotation[];
     redactions: Redaction[];
     watermark?: WatermarkOptions;
@@ -14,7 +17,7 @@ export interface ExportInput {
 export interface ExportOptions {
     /** Bake exactly these annotations instead of the live list. */
     explicitAnnotations?: Annotation[];
-    /** Accepted for API compatibility. Honoured from 1.2.0 (native XFDF import). */
+    /** Accepted for API compatibility; annotations are always taken from the live list / explicitAnnotations. */
     xfdfString?: string;
 }
 export declare function buildPdfBytes(input: ExportInput, options?: ExportOptions): Promise<Uint8Array>;

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

@@ -0,0 +1,12 @@
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ * Printing: the exported document (annotations / redactions / watermark baked in) is loaded into a
+ * hidden iframe and printed through the browser's PDF viewer. Falls back to opening the PDF in a
+ * new tab when the frame cannot print (e.g. the browser has no inline PDF viewer).
+ */
+export interface PrintOptions {
+    title?: string;
+    /** How long the hidden frame is kept alive for the print dialog (default 60s). */
+    timeoutMs?: number;
+}
+export declare function printPdfBytes(bytes: Uint8Array, opts?: PrintOptions): Promise<void>;

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

@@ -1,5 +1,6 @@
 import { ViewerPlugin } from '../plugins/types';
 import { Annotation } from '../annotations/types';
+import { AnnotationChangedEvent } from '../annotations/AnnotationManager';
 import { PdfAssetPaths } from './pdfAssets';
 export type { PdfAssetPaths };
 export interface Redaction {
@@ -24,6 +25,8 @@ export interface SDKPermissions {
     canEditAnnotations?: boolean;
     canDeleteAnnotations?: boolean;
     canRedact?: boolean;
+    /** Allow editing/deleting annotations authored by other users (default false). */
+    canEditOthers?: boolean;
 }
 export interface ViewerUser {
     id: string;
@@ -95,6 +98,8 @@ export interface ViewerEventMap {
     annotationsChanged: {
         annotations: Annotation[];
     };
+    /** Granular add / modify / delete (with the `imported` flag) from the AnnotationManager. */
+    annotationChanged: AnnotationChangedEvent;
     toolChanged: {
         tool: string | null;
     };

package/dist/src/index.d.ts

@@ -9,6 +9,8 @@ export { createWebViewer, WebViewer } from './core/createWebViewer';
 export { WebViewerInstance } from './core/ViewerInstance';
 export { TeamSyncViewer } from './components/TeamSyncViewer';
 export type { TeamSyncViewerProps } from './components/TeamSyncViewer';
+export * from './types/compare';
+export * from './utils/pdfDiffEngine';
 export { configurePdfAssets, getPdfAssetPaths, isWorkerConfigured, pdfjsVersion } from './core/pdfAssets';
 export type { PdfAssetPaths } from './core/pdfAssets';
 export { ViewerBus } from './core/eventBus';
@@ -16,5 +18,14 @@ 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 { Annotation, AnnotationType, AnnotationPoint } from './annotations/types';
+export type { Annotation, AnnotationType, AnnotationPoint, AnnotationInput } from './annotations/types';
+export { AnnotationManager } from './annotations/AnnotationManager';
+export type { AnnotationAction, AnnotationChangedEvent, CommitOptions, ViewerUserInfo } from './annotations/AnnotationManager';
+export { newAnnotationId } from './annotations/ids';
+export { createPageGeometry, geometryFromPage, createGeometryResolver, toPdfPoint, fromPdfPoint, rectToPdf, rectFromPdf, rectToQuadPoints, quadPointsToRects, } from './annotations/geometry';
+export type { PageGeometry, GeometryResolver, PdfRect, Rect, Point } from './annotations/geometry';
+export { annotationsToXfdf, annotationToXfdfFragment, parseXfdf, toPdfDate, fromPdfDate, XFDF_NS } from './annotations/xfdf';
+export type { XfdfExportOptions } from './annotations/xfdf';
+export { printPdfBytes } from './core/print';
+export type { PrintOptions } from './core/print';
 export * from './plugins/types';

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

@@ -0,0 +1,56 @@
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ */
+export type CompareMode = 'overlay' | 'side-by-side' | 'semantic';
+export interface CompareOptions {
+    docA?: string | ArrayBuffer | Uint8Array;
+    docB?: string | ArrayBuffer | Uint8Array;
+    mode?: CompareMode;
+    colorA?: string;
+    colorB?: string;
+    opacityA?: number;
+    opacityB?: number;
+    blendMode?: 'multiply' | 'difference' | 'screen' | 'normal';
+}
+export interface TextDiffSegment {
+    type: 'equal' | 'add' | 'delete';
+    text: string;
+    pageIndex: number;
+}
+export interface DiffBoundingBox {
+    id: string;
+    pageIndex: number;
+    type: 'addition' | 'deletion' | 'modification';
+    text: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface DiffItem {
+    id: string;
+    pageIndex: number;
+    type: 'addition' | 'deletion' | 'modification';
+    description: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}
+export interface CompareState {
+    isActive: boolean;
+    docA?: string | ArrayBuffer | Uint8Array;
+    docB?: string | ArrayBuffer | Uint8Array;
+    mode: CompareMode;
+    colorA: string;
+    colorB: string;
+    opacityA: number;
+    opacityB: number;
+    blendMode: 'multiply' | 'difference' | 'screen' | 'normal';
+    curtainPosition: number;
+    showCurtain: boolean;
+    diffItems: DiffItem[];
+    currentDiffIndex: number;
+    pageDiffsA?: Record<number, DiffBoundingBox[]>;
+    pageDiffsB?: Record<number, DiffBoundingBox[]>;
+}

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

@@ -0,0 +1,37 @@
+import { TextDiffSegment, DiffItem, DiffBoundingBox } from '../types/compare';
+/**
+ * © 2026 AngelBot Ai Pvt Ltd. All rights reserved.
+ */
+import type * as pdfjsLib from 'pdfjs-dist';
+export interface PageDiffResult {
+    diffsA: DiffBoundingBox[];
+    diffsB: DiffBoundingBox[];
+    summary: DiffItem[];
+}
+export interface WordToken {
+    text: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Extracts individual words with precise unscaled viewport bounding boxes from a PDF.js page.
+ */
+export declare function extractWordsFromPage(page: pdfjsLib.PDFPageProxy): Promise<WordToken[]>;
+/**
+ * Computes exact text difference bounding boxes on a page for both Document A and Document B.
+ */
+export declare function computePageDiffBoxes(pdfDocA: pdfjsLib.PDFDocumentProxy, pdfDocB: pdfjsLib.PDFDocumentProxy, pageIndex: number): Promise<PageDiffResult>;
+/**
+ * Lightweight client-side Myers Diff algorithm for raw text comparison.
+ */
+export declare function computeTextDiff(textA: string, textB: string, pageIndex: number): TextDiffSegment[];
+/**
+ * Colorizes a rendered page canvas with a custom hex tint.
+ */
+export declare function tintCanvas(ctx: CanvasRenderingContext2D, width: number, height: number, colorHex: string, opacity?: number): void;
+/**
+ * Computes pixel-level difference bounding boxes between two rendered page canvases.
+ */
+export declare function computeCanvasPixelDiff(canvasA: HTMLCanvasElement, canvasB: HTMLCanvasElement, pageIndex: number, scale: number): DiffItem[];