pdfjs-reader-core 0.1.3 → 0.1.5

package/dist/index.d.cts

@@ -252,18 +252,20 @@ interface PDFViewerProps {
     src: string | ArrayBuffer | Uint8Array;
     /** Initial page number (1-indexed) */
     initialPage?: number;
-    /** Initial scale/zoom level */
+    /** Initial scale/zoom level. Use 'auto' or 'page-width' to fit to container width. */
     initialScale?: number | 'page-fit' | 'page-width' | 'auto';
     /** Theme mode */
     theme?: 'light' | 'dark' | 'sepia';
     /** Custom class name */
     className?: string;
-    /** Whether to show the toolbar */
+    /** Whether to show the toolbar (default: true) */
     showToolbar?: boolean;
-    /** Whether to show the sidebar */
+    /** Whether to show the sidebar (default: true) */
     showSidebar?: boolean;
-    /** Whether to show the annotation toolbar */
+    /** Whether to show the annotation toolbar (default: false) */
     showAnnotationToolbar?: boolean;
+    /** Whether to show floating zoom controls (default: true) */
+    showFloatingZoom?: boolean;
     /** Default sidebar panel */
     defaultSidebarPanel?: SidebarPanel;
     /** View mode for the document */
@@ -327,7 +329,7 @@ interface ViewerState {
     isPresentationMode: boolean;
 }
 interface ViewerActions {
-    setDocument: (doc: PDFDocumentProxy) => void;
+    setDocument: (doc: PDFDocumentProxy | null) => void;
     setLoading: (loading: boolean) => void;
     setError: (error: Error | null) => void;
     setCurrentPage: (page: number) => void;
@@ -469,6 +471,196 @@ interface PDFViewerEventMap {
     textselect: TextSelection;
     error: Error;
 }
+interface HighlightTextOptions {
+    /** Highlight color (default: 'yellow') */
+    color?: HighlightColor;
+    /** Only highlight on specific page (default: all pages) */
+    page?: number;
+    /** Case sensitive search (default: false) */
+    caseSensitive?: boolean;
+    /** Scroll to first match (default: true) */
+    scrollTo?: boolean;
+}
+interface DrawRectOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Width (percentage of page width) */
+    width: number;
+    /** Height (percentage of page height) */
+    height: number;
+    /** Border color (default: 'blue') */
+    color?: string;
+    /** Border width in pixels (default: 2) */
+    strokeWidth?: number;
+    /** Fill color (optional, transparent if not set) */
+    fillColor?: string;
+}
+interface DrawCircleOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Center X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Center Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Radius (percentage of page width) */
+    radius: number;
+    /** Border color (default: 'blue') */
+    color?: string;
+    /** Border width in pixels (default: 2) */
+    strokeWidth?: number;
+    /** Fill color (optional, transparent if not set) */
+    fillColor?: string;
+}
+interface AddNoteOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Note content */
+    content: string;
+    /** Note color (default: 'yellow') */
+    color?: string;
+}
+interface SearchOptions {
+    /** Case sensitive search (default: false) */
+    caseSensitive?: boolean;
+    /** Match whole words only (default: false) */
+    wholeWord?: boolean;
+    /** Highlight all matches (default: true) */
+    highlightAll?: boolean;
+}
+/**
+ * Imperative handle for PDFViewerClient.
+ * Use this to programmatically control the PDF viewer.
+ *
+ * @example
+ * ```tsx
+ * const viewerRef = useRef<PDFViewerHandle>(null);
+ *
+ * // Highlight text
+ * viewerRef.current?.highlightText("important keyword");
+ *
+ * // Draw a rectangle
+ * viewerRef.current?.drawRect({ page: 1, x: 10, y: 20, width: 30, height: 10 });
+ *
+ * // Navigate
+ * viewerRef.current?.goToPage(5);
+ * ```
+ */
+interface PDFViewerHandle {
+    /**
+     * Find and highlight text in the PDF.
+     * @param text - Text to find and highlight
+     * @param options - Highlight options
+     * @returns Array of highlight IDs created
+     */
+    highlightText: (text: string, options?: HighlightTextOptions) => Promise<string[]>;
+    /**
+     * Remove a specific highlight by ID.
+     */
+    removeHighlight: (id: string) => void;
+    /**
+     * Clear all highlights.
+     */
+    clearHighlights: () => void;
+    /**
+     * Draw a rectangle on the PDF.
+     * @param options - Rectangle options (coordinates are percentages 0-100)
+     * @returns Annotation ID
+     */
+    drawRect: (options: DrawRectOptions) => string;
+    /**
+     * Draw a circle on the PDF.
+     * @param options - Circle options (coordinates are percentages 0-100)
+     * @returns Annotation ID
+     */
+    drawCircle: (options: DrawCircleOptions) => string;
+    /**
+     * Add a note annotation.
+     * @param options - Note options
+     * @returns Annotation ID
+     */
+    addNote: (options: AddNoteOptions) => string;
+    /**
+     * Remove a specific annotation by ID.
+     */
+    removeAnnotation: (id: string) => void;
+    /**
+     * Clear all annotations.
+     */
+    clearAnnotations: () => void;
+    /**
+     * Go to a specific page.
+     * @param page - Page number (1-indexed)
+     */
+    goToPage: (page: number) => void;
+    /**
+     * Go to the next page.
+     */
+    nextPage: () => void;
+    /**
+     * Go to the previous page.
+     */
+    previousPage: () => void;
+    /**
+     * Get the current page number.
+     */
+    getCurrentPage: () => number;
+    /**
+     * Get total number of pages.
+     */
+    getNumPages: () => number;
+    /**
+     * Set the zoom level.
+     * @param scale - Zoom scale (1.0 = 100%)
+     */
+    setZoom: (scale: number) => void;
+    /**
+     * Get the current zoom level.
+     */
+    getZoom: () => number;
+    /**
+     * Zoom in.
+     */
+    zoomIn: () => void;
+    /**
+     * Zoom out.
+     */
+    zoomOut: () => void;
+    /**
+     * Search for text in the PDF.
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Search results
+     */
+    search: (query: string, options?: SearchOptions) => Promise<SearchResult[]>;
+    /**
+     * Go to the next search result.
+     */
+    nextSearchResult: () => void;
+    /**
+     * Go to the previous search result.
+     */
+    previousSearchResult: () => void;
+    /**
+     * Clear search results.
+     */
+    clearSearch: () => void;
+    /**
+     * Get the underlying PDF document (pdfjs-dist PDFDocumentProxy).
+     */
+    getDocument: () => PDFDocumentProxy | null;
+    /**
+     * Check if the document is loaded.
+     */
+    isLoaded: () => boolean;
+}
 
 /**
  * Main PDF Viewer component.
@@ -496,10 +688,27 @@ interface PDFViewerEventMap {
 declare const PDFViewer: react.NamedExoticComponent<PDFViewerProps>;
 
 /**
- * SSR-safe PDF Viewer component.
- * Wraps the inner viewer with the context provider.
+ * PDF Viewer component with imperative API.
+ *
+ * @example
+ * ```tsx
+ * const viewerRef = useRef<PDFViewerHandle>(null);
+ *
+ * <PDFViewerClient
+ *   ref={viewerRef}
+ *   src="/document.pdf"
+ *   onDocumentLoad={() => {
+ *     // Highlight text when document loads
+ *     viewerRef.current?.highlightText("important", { color: "yellow" });
+ *   }}
+ * />
+ *
+ * // Call methods anytime
+ * viewerRef.current?.goToPage(5);
+ * viewerRef.current?.drawRect({ page: 1, x: 10, y: 20, width: 30, height: 10 });
+ * ```
  */
-declare const PDFViewerClient: react.NamedExoticComponent<PDFViewerProps>;
+declare const PDFViewerClient: react.MemoExoticComponent<react.ForwardRefExoticComponent<PDFViewerProps & react.RefAttributes<PDFViewerHandle>>>;
 
 interface DocumentContainerProps {
     className?: string;
@@ -1020,6 +1229,24 @@ interface MinimapProps {
  */
 declare const Minimap: react.NamedExoticComponent<MinimapProps>;
 
+interface FloatingZoomControlsProps {
+    /** Position of the controls */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Additional class name */
+    className?: string;
+    /** Show fit to width button */
+    showFitToWidth?: boolean;
+    /** Show fit to page button */
+    showFitToPage?: boolean;
+    /** Show zoom percentage */
+    showZoomLevel?: boolean;
+}
+/**
+ * Floating zoom controls for easy zoom adjustment.
+ * Shows +/- buttons and optionally fit-to-width/fit-to-page buttons.
+ */
+declare const FloatingZoomControls: react.NamedExoticComponent<FloatingZoomControlsProps>;
+
 interface PDFErrorBoundaryProps {
     /** Child components to render */
     children: ReactNode;
@@ -1058,6 +1285,8 @@ interface SearchActions {
     nextResult: () => void;
     previousResult: () => void;
     goToResult: (index: number) => void;
+    setCaseSensitive: (value: boolean) => void;
+    setWholeWord: (value: boolean) => void;
     toggleCaseSensitive: () => void;
     toggleWholeWord: () => void;
     getCurrentResult: () => SearchResult | null;
@@ -2032,4 +2261,4 @@ declare function createAgentAPI(stores: AgentAPIStores): AgentAPI;
  */
 type AgentAPIInstance = ReturnType<typeof createAgentAPI>;
 
-export { type AgentAPI, type AgentAPIInstance, type AgentAPIStores, type AgentActions, type AgentContext, type AgentHighlightParams, type AgentState, type AgentStore, type AgentStoreApi, type Annotation, type AnnotationActions, AnnotationLayer, type AnnotationLayerProps, type AnnotationState, type AnnotationStore, type AnnotationStoreApi, type AnnotationTool, AnnotationToolbar, type AnnotationToolbarProps, type AnnotationType, type AskAboutContext, AskAboutOverlay, type AskAboutOverlayProps, AskAboutTrigger, type AskAboutTriggerProps, type Bookmark, BookmarksPanel, type BookmarksPanelProps, CanvasLayer, type CanvasLayerProps, type ContextMenuItem, ContinuousScrollContainer, type ContinuousScrollContainerProps, DocumentContainer, type DocumentContainerProps, type DrawingAnnotation, DrawingCanvas, type DrawingCanvasProps, type DrawingPath, DualPageContainer, type DualPageContainerProps, type ExportData, FocusRegionLayer, type FocusRegionLayerProps, type FocusedRegion, type Highlight, type HighlightColor, HighlightLayer, type HighlightLayerProps, HighlightPopover, type HighlightPopoverProps, type HighlightRect, HighlightsPanel, type HighlightsPanelProps, type LoadDocumentOptions, type LoadDocumentResult, Minimap, type MinimapProps, MobileSidebar, type MobileSidebarProps, MobileToolbar, type MobileToolbarProps, type NoteAnnotation, type OutlineItem, OutlinePanel, type OutlinePanelProps, type PDFDocumentLoadedEvent, PDFErrorBoundary, type PDFErrorBoundaryProps, PDFPage, type PDFPageProps, type PDFPageState, type PDFRegion, PDFViewer, PDFViewerClient, PDFViewerContext, type PDFViewerContextValue, type PDFViewerController, type PDFViewerControllerOptions, type PDFViewerEventMap, type PDFViewerProps, PDFViewerProvider, type PDFViewerProviderProps, type PageDimensions, type Plugin, type PluginAPI, PluginManager, type PluginManagerOptions, type QuickNote, QuickNoteButton, type QuickNoteButtonProps, QuickNotePopover, type QuickNotePopoverProps, type ScrollMode, type SearchActions, SearchPanel, type SearchPanelProps, type SearchResult, type SearchState, type SearchStore, type SearchStoreApi, SelectionToolbar, type SelectionToolbarProps, type ShapeAnnotation, ShapePreview, type ShapePreviewProps, ShapeRenderer, type ShapeRendererProps, type ShapeType, Sidebar, type SidebarPanel, type SidebarPanelConfig, type SidebarProps, StickyNote, type StickyNoteProps, type StoredStudentData, type StudentActions, type StudentData, type StudentModeCallbacks, type StudentModeProps, type StudentState, type StudentStore, type StudentStoreApi, type Takeaway, TakeawaysPanel, type TakeawaysPanelProps, TextLayer, type TextLayerProps, type TextSelection, type Theme, ThumbnailPanel, type ThumbnailPanelProps, Toolbar, type ToolbarItem, type ToolbarProps, type UseAgentContextOptions, type UseAgentContextReturn, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAskAboutOptions, type UseAskAboutReturn, type UseBookmarksOptions, type UseBookmarksReturn, type UseHighlightsOptions, type UseHighlightsReturn, type UsePageNavigationOptions, type UsePluginsOptions, type UsePluginsReturn, type UseQuickNotesOptions, type UseQuickNotesReturn, type UseStudentProgressOptions, type UseStudentProgressReturn, type UseTextSelectionOptions, type UseTouchGesturesOptions, type UseZoomOptions, type ViewMode, type ViewerActions, type ViewerState, type ViewerStore, type ViewerStoreApi, VirtualizedDocumentContainer, type VirtualizedDocumentContainerProps, type WithErrorBoundaryProps, clearHighlights, clearStudentData, cn, createAgentAPI, createAgentStore, createAnnotationStore, createPDFViewer, createPluginManager, createSearchStore, createStudentStore, createViewerStore, downloadAnnotationsAsJSON, downloadAnnotationsAsMarkdown, downloadFile, exportAnnotationsAsJSON, exportAnnotationsAsMarkdown, exportHighlightsAsJSON, exportHighlightsAsMarkdown, generateDocumentId, getAllDocumentIds, getAllStudentDataDocumentIds, getMetadata, getOutline, getPage, getPageTextContent, getPluginManager, getStorageStats, importHighlightsFromJSON, initializePDFJS, isPDFJSInitialized, loadDocument, loadHighlights, loadStudentData, quickViewer, saveHighlights, saveStudentData, useAgentContext, useAgentStore, useAnnotationStore, useAnnotations, useAskAbout, useBookmarks, useHighlights, useIsMobile, useIsTouchDevice, usePDFViewer, usePDFViewerStores, usePageNavigation, usePlugins, useQuickNotes, useSearchStore, useStudentProgress, useStudentStore, useTextSelection, useTouchGestures, useViewerStore, useZoom, withErrorBoundary };
+export { type AddNoteOptions, type AgentAPI, type AgentAPIInstance, type AgentAPIStores, type AgentActions, type AgentContext, type AgentHighlightParams, type AgentState, type AgentStore, type AgentStoreApi, type Annotation, type AnnotationActions, AnnotationLayer, type AnnotationLayerProps, type AnnotationState, type AnnotationStore, type AnnotationStoreApi, type AnnotationTool, AnnotationToolbar, type AnnotationToolbarProps, type AnnotationType, type AskAboutContext, AskAboutOverlay, type AskAboutOverlayProps, AskAboutTrigger, type AskAboutTriggerProps, type Bookmark, BookmarksPanel, type BookmarksPanelProps, CanvasLayer, type CanvasLayerProps, type ContextMenuItem, ContinuousScrollContainer, type ContinuousScrollContainerProps, DocumentContainer, type DocumentContainerProps, type DrawCircleOptions, type DrawRectOptions, type DrawingAnnotation, DrawingCanvas, type DrawingCanvasProps, type DrawingPath, DualPageContainer, type DualPageContainerProps, type ExportData, FloatingZoomControls, type FloatingZoomControlsProps, FocusRegionLayer, type FocusRegionLayerProps, type FocusedRegion, type Highlight, type HighlightColor, HighlightLayer, type HighlightLayerProps, HighlightPopover, type HighlightPopoverProps, type HighlightRect, type HighlightTextOptions, HighlightsPanel, type HighlightsPanelProps, type LoadDocumentOptions, type LoadDocumentResult, Minimap, type MinimapProps, MobileSidebar, type MobileSidebarProps, MobileToolbar, type MobileToolbarProps, type NoteAnnotation, type OutlineItem, OutlinePanel, type OutlinePanelProps, type PDFDocumentLoadedEvent, PDFErrorBoundary, type PDFErrorBoundaryProps, PDFPage, type PDFPageProps, type PDFPageState, type PDFRegion, PDFViewer, PDFViewerClient, PDFViewerContext, type PDFViewerContextValue, type PDFViewerController, type PDFViewerControllerOptions, type PDFViewerEventMap, type PDFViewerHandle, type PDFViewerProps, PDFViewerProvider, type PDFViewerProviderProps, type PageDimensions, type Plugin, type PluginAPI, PluginManager, type PluginManagerOptions, type QuickNote, QuickNoteButton, type QuickNoteButtonProps, QuickNotePopover, type QuickNotePopoverProps, type ScrollMode, type SearchActions, type SearchOptions, SearchPanel, type SearchPanelProps, type SearchResult, type SearchState, type SearchStore, type SearchStoreApi, SelectionToolbar, type SelectionToolbarProps, type ShapeAnnotation, ShapePreview, type ShapePreviewProps, ShapeRenderer, type ShapeRendererProps, type ShapeType, Sidebar, type SidebarPanel, type SidebarPanelConfig, type SidebarProps, StickyNote, type StickyNoteProps, type StoredStudentData, type StudentActions, type StudentData, type StudentModeCallbacks, type StudentModeProps, type StudentState, type StudentStore, type StudentStoreApi, type Takeaway, TakeawaysPanel, type TakeawaysPanelProps, TextLayer, type TextLayerProps, type TextSelection, type Theme, ThumbnailPanel, type ThumbnailPanelProps, Toolbar, type ToolbarItem, type ToolbarProps, type UseAgentContextOptions, type UseAgentContextReturn, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAskAboutOptions, type UseAskAboutReturn, type UseBookmarksOptions, type UseBookmarksReturn, type UseHighlightsOptions, type UseHighlightsReturn, type UsePageNavigationOptions, type UsePluginsOptions, type UsePluginsReturn, type UseQuickNotesOptions, type UseQuickNotesReturn, type UseStudentProgressOptions, type UseStudentProgressReturn, type UseTextSelectionOptions, type UseTouchGesturesOptions, type UseZoomOptions, type ViewMode, type ViewerActions, type ViewerState, type ViewerStore, type ViewerStoreApi, VirtualizedDocumentContainer, type VirtualizedDocumentContainerProps, type WithErrorBoundaryProps, clearHighlights, clearStudentData, cn, createAgentAPI, createAgentStore, createAnnotationStore, createPDFViewer, createPluginManager, createSearchStore, createStudentStore, createViewerStore, downloadAnnotationsAsJSON, downloadAnnotationsAsMarkdown, downloadFile, exportAnnotationsAsJSON, exportAnnotationsAsMarkdown, exportHighlightsAsJSON, exportHighlightsAsMarkdown, generateDocumentId, getAllDocumentIds, getAllStudentDataDocumentIds, getMetadata, getOutline, getPage, getPageTextContent, getPluginManager, getStorageStats, importHighlightsFromJSON, initializePDFJS, isPDFJSInitialized, loadDocument, loadHighlights, loadStudentData, quickViewer, saveHighlights, saveStudentData, useAgentContext, useAgentStore, useAnnotationStore, useAnnotations, useAskAbout, useBookmarks, useHighlights, useIsMobile, useIsTouchDevice, usePDFViewer, usePDFViewerStores, usePageNavigation, usePlugins, useQuickNotes, useSearchStore, useStudentProgress, useStudentStore, useTextSelection, useTouchGestures, useViewerStore, useZoom, withErrorBoundary };

package/dist/index.d.ts

@@ -252,18 +252,20 @@ interface PDFViewerProps {
     src: string | ArrayBuffer | Uint8Array;
     /** Initial page number (1-indexed) */
     initialPage?: number;
-    /** Initial scale/zoom level */
+    /** Initial scale/zoom level. Use 'auto' or 'page-width' to fit to container width. */
     initialScale?: number | 'page-fit' | 'page-width' | 'auto';
     /** Theme mode */
     theme?: 'light' | 'dark' | 'sepia';
     /** Custom class name */
     className?: string;
-    /** Whether to show the toolbar */
+    /** Whether to show the toolbar (default: true) */
     showToolbar?: boolean;
-    /** Whether to show the sidebar */
+    /** Whether to show the sidebar (default: true) */
     showSidebar?: boolean;
-    /** Whether to show the annotation toolbar */
+    /** Whether to show the annotation toolbar (default: false) */
     showAnnotationToolbar?: boolean;
+    /** Whether to show floating zoom controls (default: true) */
+    showFloatingZoom?: boolean;
     /** Default sidebar panel */
     defaultSidebarPanel?: SidebarPanel;
     /** View mode for the document */
@@ -327,7 +329,7 @@ interface ViewerState {
     isPresentationMode: boolean;
 }
 interface ViewerActions {
-    setDocument: (doc: PDFDocumentProxy) => void;
+    setDocument: (doc: PDFDocumentProxy | null) => void;
     setLoading: (loading: boolean) => void;
     setError: (error: Error | null) => void;
     setCurrentPage: (page: number) => void;
@@ -469,6 +471,196 @@ interface PDFViewerEventMap {
     textselect: TextSelection;
     error: Error;
 }
+interface HighlightTextOptions {
+    /** Highlight color (default: 'yellow') */
+    color?: HighlightColor;
+    /** Only highlight on specific page (default: all pages) */
+    page?: number;
+    /** Case sensitive search (default: false) */
+    caseSensitive?: boolean;
+    /** Scroll to first match (default: true) */
+    scrollTo?: boolean;
+}
+interface DrawRectOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Width (percentage of page width) */
+    width: number;
+    /** Height (percentage of page height) */
+    height: number;
+    /** Border color (default: 'blue') */
+    color?: string;
+    /** Border width in pixels (default: 2) */
+    strokeWidth?: number;
+    /** Fill color (optional, transparent if not set) */
+    fillColor?: string;
+}
+interface DrawCircleOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Center X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Center Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Radius (percentage of page width) */
+    radius: number;
+    /** Border color (default: 'blue') */
+    color?: string;
+    /** Border width in pixels (default: 2) */
+    strokeWidth?: number;
+    /** Fill color (optional, transparent if not set) */
+    fillColor?: string;
+}
+interface AddNoteOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** X coordinate (percentage of page width, 0-100) */
+    x: number;
+    /** Y coordinate (percentage of page height, 0-100) */
+    y: number;
+    /** Note content */
+    content: string;
+    /** Note color (default: 'yellow') */
+    color?: string;
+}
+interface SearchOptions {
+    /** Case sensitive search (default: false) */
+    caseSensitive?: boolean;
+    /** Match whole words only (default: false) */
+    wholeWord?: boolean;
+    /** Highlight all matches (default: true) */
+    highlightAll?: boolean;
+}
+/**
+ * Imperative handle for PDFViewerClient.
+ * Use this to programmatically control the PDF viewer.
+ *
+ * @example
+ * ```tsx
+ * const viewerRef = useRef<PDFViewerHandle>(null);
+ *
+ * // Highlight text
+ * viewerRef.current?.highlightText("important keyword");
+ *
+ * // Draw a rectangle
+ * viewerRef.current?.drawRect({ page: 1, x: 10, y: 20, width: 30, height: 10 });
+ *
+ * // Navigate
+ * viewerRef.current?.goToPage(5);
+ * ```
+ */
+interface PDFViewerHandle {
+    /**
+     * Find and highlight text in the PDF.
+     * @param text - Text to find and highlight
+     * @param options - Highlight options
+     * @returns Array of highlight IDs created
+     */
+    highlightText: (text: string, options?: HighlightTextOptions) => Promise<string[]>;
+    /**
+     * Remove a specific highlight by ID.
+     */
+    removeHighlight: (id: string) => void;
+    /**
+     * Clear all highlights.
+     */
+    clearHighlights: () => void;
+    /**
+     * Draw a rectangle on the PDF.
+     * @param options - Rectangle options (coordinates are percentages 0-100)
+     * @returns Annotation ID
+     */
+    drawRect: (options: DrawRectOptions) => string;
+    /**
+     * Draw a circle on the PDF.
+     * @param options - Circle options (coordinates are percentages 0-100)
+     * @returns Annotation ID
+     */
+    drawCircle: (options: DrawCircleOptions) => string;
+    /**
+     * Add a note annotation.
+     * @param options - Note options
+     * @returns Annotation ID
+     */
+    addNote: (options: AddNoteOptions) => string;
+    /**
+     * Remove a specific annotation by ID.
+     */
+    removeAnnotation: (id: string) => void;
+    /**
+     * Clear all annotations.
+     */
+    clearAnnotations: () => void;
+    /**
+     * Go to a specific page.
+     * @param page - Page number (1-indexed)
+     */
+    goToPage: (page: number) => void;
+    /**
+     * Go to the next page.
+     */
+    nextPage: () => void;
+    /**
+     * Go to the previous page.
+     */
+    previousPage: () => void;
+    /**
+     * Get the current page number.
+     */
+    getCurrentPage: () => number;
+    /**
+     * Get total number of pages.
+     */
+    getNumPages: () => number;
+    /**
+     * Set the zoom level.
+     * @param scale - Zoom scale (1.0 = 100%)
+     */
+    setZoom: (scale: number) => void;
+    /**
+     * Get the current zoom level.
+     */
+    getZoom: () => number;
+    /**
+     * Zoom in.
+     */
+    zoomIn: () => void;
+    /**
+     * Zoom out.
+     */
+    zoomOut: () => void;
+    /**
+     * Search for text in the PDF.
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Search results
+     */
+    search: (query: string, options?: SearchOptions) => Promise<SearchResult[]>;
+    /**
+     * Go to the next search result.
+     */
+    nextSearchResult: () => void;
+    /**
+     * Go to the previous search result.
+     */
+    previousSearchResult: () => void;
+    /**
+     * Clear search results.
+     */
+    clearSearch: () => void;
+    /**
+     * Get the underlying PDF document (pdfjs-dist PDFDocumentProxy).
+     */
+    getDocument: () => PDFDocumentProxy | null;
+    /**
+     * Check if the document is loaded.
+     */
+    isLoaded: () => boolean;
+}
 
 /**
  * Main PDF Viewer component.
@@ -496,10 +688,27 @@ interface PDFViewerEventMap {
 declare const PDFViewer: react.NamedExoticComponent<PDFViewerProps>;
 
 /**
- * SSR-safe PDF Viewer component.
- * Wraps the inner viewer with the context provider.
+ * PDF Viewer component with imperative API.
+ *
+ * @example
+ * ```tsx
+ * const viewerRef = useRef<PDFViewerHandle>(null);
+ *
+ * <PDFViewerClient
+ *   ref={viewerRef}
+ *   src="/document.pdf"
+ *   onDocumentLoad={() => {
+ *     // Highlight text when document loads
+ *     viewerRef.current?.highlightText("important", { color: "yellow" });
+ *   }}
+ * />
+ *
+ * // Call methods anytime
+ * viewerRef.current?.goToPage(5);
+ * viewerRef.current?.drawRect({ page: 1, x: 10, y: 20, width: 30, height: 10 });
+ * ```
  */
-declare const PDFViewerClient: react.NamedExoticComponent<PDFViewerProps>;
+declare const PDFViewerClient: react.MemoExoticComponent<react.ForwardRefExoticComponent<PDFViewerProps & react.RefAttributes<PDFViewerHandle>>>;
 
 interface DocumentContainerProps {
     className?: string;
@@ -1020,6 +1229,24 @@ interface MinimapProps {
  */
 declare const Minimap: react.NamedExoticComponent<MinimapProps>;
 
+interface FloatingZoomControlsProps {
+    /** Position of the controls */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Additional class name */
+    className?: string;
+    /** Show fit to width button */
+    showFitToWidth?: boolean;
+    /** Show fit to page button */
+    showFitToPage?: boolean;
+    /** Show zoom percentage */
+    showZoomLevel?: boolean;
+}
+/**
+ * Floating zoom controls for easy zoom adjustment.
+ * Shows +/- buttons and optionally fit-to-width/fit-to-page buttons.
+ */
+declare const FloatingZoomControls: react.NamedExoticComponent<FloatingZoomControlsProps>;
+
 interface PDFErrorBoundaryProps {
     /** Child components to render */
     children: ReactNode;
@@ -1058,6 +1285,8 @@ interface SearchActions {
     nextResult: () => void;
     previousResult: () => void;
     goToResult: (index: number) => void;
+    setCaseSensitive: (value: boolean) => void;
+    setWholeWord: (value: boolean) => void;
     toggleCaseSensitive: () => void;
     toggleWholeWord: () => void;
     getCurrentResult: () => SearchResult | null;
@@ -2032,4 +2261,4 @@ declare function createAgentAPI(stores: AgentAPIStores): AgentAPI;
  */
 type AgentAPIInstance = ReturnType<typeof createAgentAPI>;
 
-export { type AgentAPI, type AgentAPIInstance, type AgentAPIStores, type AgentActions, type AgentContext, type AgentHighlightParams, type AgentState, type AgentStore, type AgentStoreApi, type Annotation, type AnnotationActions, AnnotationLayer, type AnnotationLayerProps, type AnnotationState, type AnnotationStore, type AnnotationStoreApi, type AnnotationTool, AnnotationToolbar, type AnnotationToolbarProps, type AnnotationType, type AskAboutContext, AskAboutOverlay, type AskAboutOverlayProps, AskAboutTrigger, type AskAboutTriggerProps, type Bookmark, BookmarksPanel, type BookmarksPanelProps, CanvasLayer, type CanvasLayerProps, type ContextMenuItem, ContinuousScrollContainer, type ContinuousScrollContainerProps, DocumentContainer, type DocumentContainerProps, type DrawingAnnotation, DrawingCanvas, type DrawingCanvasProps, type DrawingPath, DualPageContainer, type DualPageContainerProps, type ExportData, FocusRegionLayer, type FocusRegionLayerProps, type FocusedRegion, type Highlight, type HighlightColor, HighlightLayer, type HighlightLayerProps, HighlightPopover, type HighlightPopoverProps, type HighlightRect, HighlightsPanel, type HighlightsPanelProps, type LoadDocumentOptions, type LoadDocumentResult, Minimap, type MinimapProps, MobileSidebar, type MobileSidebarProps, MobileToolbar, type MobileToolbarProps, type NoteAnnotation, type OutlineItem, OutlinePanel, type OutlinePanelProps, type PDFDocumentLoadedEvent, PDFErrorBoundary, type PDFErrorBoundaryProps, PDFPage, type PDFPageProps, type PDFPageState, type PDFRegion, PDFViewer, PDFViewerClient, PDFViewerContext, type PDFViewerContextValue, type PDFViewerController, type PDFViewerControllerOptions, type PDFViewerEventMap, type PDFViewerProps, PDFViewerProvider, type PDFViewerProviderProps, type PageDimensions, type Plugin, type PluginAPI, PluginManager, type PluginManagerOptions, type QuickNote, QuickNoteButton, type QuickNoteButtonProps, QuickNotePopover, type QuickNotePopoverProps, type ScrollMode, type SearchActions, SearchPanel, type SearchPanelProps, type SearchResult, type SearchState, type SearchStore, type SearchStoreApi, SelectionToolbar, type SelectionToolbarProps, type ShapeAnnotation, ShapePreview, type ShapePreviewProps, ShapeRenderer, type ShapeRendererProps, type ShapeType, Sidebar, type SidebarPanel, type SidebarPanelConfig, type SidebarProps, StickyNote, type StickyNoteProps, type StoredStudentData, type StudentActions, type StudentData, type StudentModeCallbacks, type StudentModeProps, type StudentState, type StudentStore, type StudentStoreApi, type Takeaway, TakeawaysPanel, type TakeawaysPanelProps, TextLayer, type TextLayerProps, type TextSelection, type Theme, ThumbnailPanel, type ThumbnailPanelProps, Toolbar, type ToolbarItem, type ToolbarProps, type UseAgentContextOptions, type UseAgentContextReturn, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAskAboutOptions, type UseAskAboutReturn, type UseBookmarksOptions, type UseBookmarksReturn, type UseHighlightsOptions, type UseHighlightsReturn, type UsePageNavigationOptions, type UsePluginsOptions, type UsePluginsReturn, type UseQuickNotesOptions, type UseQuickNotesReturn, type UseStudentProgressOptions, type UseStudentProgressReturn, type UseTextSelectionOptions, type UseTouchGesturesOptions, type UseZoomOptions, type ViewMode, type ViewerActions, type ViewerState, type ViewerStore, type ViewerStoreApi, VirtualizedDocumentContainer, type VirtualizedDocumentContainerProps, type WithErrorBoundaryProps, clearHighlights, clearStudentData, cn, createAgentAPI, createAgentStore, createAnnotationStore, createPDFViewer, createPluginManager, createSearchStore, createStudentStore, createViewerStore, downloadAnnotationsAsJSON, downloadAnnotationsAsMarkdown, downloadFile, exportAnnotationsAsJSON, exportAnnotationsAsMarkdown, exportHighlightsAsJSON, exportHighlightsAsMarkdown, generateDocumentId, getAllDocumentIds, getAllStudentDataDocumentIds, getMetadata, getOutline, getPage, getPageTextContent, getPluginManager, getStorageStats, importHighlightsFromJSON, initializePDFJS, isPDFJSInitialized, loadDocument, loadHighlights, loadStudentData, quickViewer, saveHighlights, saveStudentData, useAgentContext, useAgentStore, useAnnotationStore, useAnnotations, useAskAbout, useBookmarks, useHighlights, useIsMobile, useIsTouchDevice, usePDFViewer, usePDFViewerStores, usePageNavigation, usePlugins, useQuickNotes, useSearchStore, useStudentProgress, useStudentStore, useTextSelection, useTouchGestures, useViewerStore, useZoom, withErrorBoundary };
+export { type AddNoteOptions, type AgentAPI, type AgentAPIInstance, type AgentAPIStores, type AgentActions, type AgentContext, type AgentHighlightParams, type AgentState, type AgentStore, type AgentStoreApi, type Annotation, type AnnotationActions, AnnotationLayer, type AnnotationLayerProps, type AnnotationState, type AnnotationStore, type AnnotationStoreApi, type AnnotationTool, AnnotationToolbar, type AnnotationToolbarProps, type AnnotationType, type AskAboutContext, AskAboutOverlay, type AskAboutOverlayProps, AskAboutTrigger, type AskAboutTriggerProps, type Bookmark, BookmarksPanel, type BookmarksPanelProps, CanvasLayer, type CanvasLayerProps, type ContextMenuItem, ContinuousScrollContainer, type ContinuousScrollContainerProps, DocumentContainer, type DocumentContainerProps, type DrawCircleOptions, type DrawRectOptions, type DrawingAnnotation, DrawingCanvas, type DrawingCanvasProps, type DrawingPath, DualPageContainer, type DualPageContainerProps, type ExportData, FloatingZoomControls, type FloatingZoomControlsProps, FocusRegionLayer, type FocusRegionLayerProps, type FocusedRegion, type Highlight, type HighlightColor, HighlightLayer, type HighlightLayerProps, HighlightPopover, type HighlightPopoverProps, type HighlightRect, type HighlightTextOptions, HighlightsPanel, type HighlightsPanelProps, type LoadDocumentOptions, type LoadDocumentResult, Minimap, type MinimapProps, MobileSidebar, type MobileSidebarProps, MobileToolbar, type MobileToolbarProps, type NoteAnnotation, type OutlineItem, OutlinePanel, type OutlinePanelProps, type PDFDocumentLoadedEvent, PDFErrorBoundary, type PDFErrorBoundaryProps, PDFPage, type PDFPageProps, type PDFPageState, type PDFRegion, PDFViewer, PDFViewerClient, PDFViewerContext, type PDFViewerContextValue, type PDFViewerController, type PDFViewerControllerOptions, type PDFViewerEventMap, type PDFViewerHandle, type PDFViewerProps, PDFViewerProvider, type PDFViewerProviderProps, type PageDimensions, type Plugin, type PluginAPI, PluginManager, type PluginManagerOptions, type QuickNote, QuickNoteButton, type QuickNoteButtonProps, QuickNotePopover, type QuickNotePopoverProps, type ScrollMode, type SearchActions, type SearchOptions, SearchPanel, type SearchPanelProps, type SearchResult, type SearchState, type SearchStore, type SearchStoreApi, SelectionToolbar, type SelectionToolbarProps, type ShapeAnnotation, ShapePreview, type ShapePreviewProps, ShapeRenderer, type ShapeRendererProps, type ShapeType, Sidebar, type SidebarPanel, type SidebarPanelConfig, type SidebarProps, StickyNote, type StickyNoteProps, type StoredStudentData, type StudentActions, type StudentData, type StudentModeCallbacks, type StudentModeProps, type StudentState, type StudentStore, type StudentStoreApi, type Takeaway, TakeawaysPanel, type TakeawaysPanelProps, TextLayer, type TextLayerProps, type TextSelection, type Theme, ThumbnailPanel, type ThumbnailPanelProps, Toolbar, type ToolbarItem, type ToolbarProps, type UseAgentContextOptions, type UseAgentContextReturn, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAskAboutOptions, type UseAskAboutReturn, type UseBookmarksOptions, type UseBookmarksReturn, type UseHighlightsOptions, type UseHighlightsReturn, type UsePageNavigationOptions, type UsePluginsOptions, type UsePluginsReturn, type UseQuickNotesOptions, type UseQuickNotesReturn, type UseStudentProgressOptions, type UseStudentProgressReturn, type UseTextSelectionOptions, type UseTouchGesturesOptions, type UseZoomOptions, type ViewMode, type ViewerActions, type ViewerState, type ViewerStore, type ViewerStoreApi, VirtualizedDocumentContainer, type VirtualizedDocumentContainerProps, type WithErrorBoundaryProps, clearHighlights, clearStudentData, cn, createAgentAPI, createAgentStore, createAnnotationStore, createPDFViewer, createPluginManager, createSearchStore, createStudentStore, createViewerStore, downloadAnnotationsAsJSON, downloadAnnotationsAsMarkdown, downloadFile, exportAnnotationsAsJSON, exportAnnotationsAsMarkdown, exportHighlightsAsJSON, exportHighlightsAsMarkdown, generateDocumentId, getAllDocumentIds, getAllStudentDataDocumentIds, getMetadata, getOutline, getPage, getPageTextContent, getPluginManager, getStorageStats, importHighlightsFromJSON, initializePDFJS, isPDFJSInitialized, loadDocument, loadHighlights, loadStudentData, quickViewer, saveHighlights, saveStudentData, useAgentContext, useAgentStore, useAnnotationStore, useAnnotations, useAskAbout, useBookmarks, useHighlights, useIsMobile, useIsTouchDevice, usePDFViewer, usePDFViewerStores, usePageNavigation, usePlugins, useQuickNotes, useSearchStore, useStudentProgress, useStudentStore, useTextSelection, useTouchGestures, useViewerStore, useZoom, withErrorBoundary };