@anaralabs/lector 3.14.12 → 3.15.0

package/README.md

@@ -2,7 +2,7 @@
 
 **A headless PDF viewer for React.** Compose pages, text selection, search, and annotations into your own reading experience. Lector handles PDF.js rendering and page virtualization; you control the layout and UI.
 
-[Documentation](https://lector-weld.vercel.app/docs) · [Live demo](https://lector-weld.vercel.app) · [npm](https://www.npmjs.com/package/@anaralabs/lector) · [Contributing](https://github.com/anaralabs/lector/blob/main/CONTRIBUTING.md)
+[Documentation](https://anara.com/lector/docs) · [Live demo](https://anara.com/lector) · [npm](https://www.npmjs.com/package/@anaralabs/lector) · [Contributing](https://github.com/anaralabs/lector/blob/main/CONTRIBUTING.md)
 
 ## Get a PDF on screen
 
@@ -46,7 +46,7 @@ export default function PDFViewer() {
 }
 ```
 
-For **Next.js**, load the viewer through a Client Component using `dynamic(..., { ssr: false })`; keep PDF.js setup inside the dynamically loaded module. See [installation](https://lector-weld.vercel.app/docs/installation) for the full wrapper, Vite worker setup, and deployments below a path prefix.
+For **Next.js**, load the viewer through a Client Component using `dynamic(..., { ssr: false })`; keep PDF.js setup inside the dynamically loaded module. See [installation](https://anara.com/lector/docs/installation) for the full wrapper, Vite worker setup, and deployments below a path prefix.
 
 `Root` loads the document and provides its state. `Pages` owns scrolling and clones one `Page` template for visible pages. `CanvasLayer` paints the PDF; `TextLayer` adds selectable text. Give the viewer a definite height and import the PDF.js stylesheet so its layers align.
 
@@ -54,23 +54,23 @@ For **Next.js**, load the viewer through a Client Component using `dynamic(...,
 
 | Feature | Start here |
 | --- | --- |
-| Toolbar, page input, and layout | [Your first viewer](https://lector-weld.vercel.app/docs/basic-usage) |
-| Authenticated URLs, local files, errors, and self-hosted assets | [Loading documents](https://lector-weld.vercel.app/docs/document-loading) |
-| Page navigation and fit width | [Navigation](https://lector-weld.vercel.app/docs/code/page-navigation), [zoom](https://lector-weld.vercel.app/docs/code/zoom-control) |
-| Page previews | [Thumbnails](https://lector-weld.vercel.app/docs/code/thumbnails) |
-| Text search and highlighted results | [Search](https://lector-weld.vercel.app/docs/code/search) |
-| Selection and citation regions | [Selection](https://lector-weld.vercel.app/docs/code/select), [highlights](https://lector-weld.vercel.app/docs/code/highlight) |
-| PDF links and editable form fields | [Links](https://lector-weld.vercel.app/docs/code/links), [forms](https://lector-weld.vercel.app/docs/code/pdf-form) |
-| Dark page rendering | [Dark mode](https://lector-weld.vercel.app/docs/dark-mode) |
-| Props, hooks, and defaults | [API reference](https://lector-weld.vercel.app/docs/api) |
-
-Lector is a toolkit rather than a finished toolbar or a PDF editor. Your app supplies accessible controls, error UI, and storage for user annotations. Search requires embedded text; it does not perform OCR. Custom highlight overlays do not automatically modify the PDF file. See [troubleshooting](https://lector-weld.vercel.app/docs/troubleshooting) for worker errors, blank pages, and layout issues.
+| Toolbar, page input, and layout | [Your first viewer](https://anara.com/lector/docs/basic-usage) |
+| Authenticated URLs, local files, errors, and self-hosted assets | [Loading documents](https://anara.com/lector/docs/document-loading) |
+| Page navigation and fit width | [Navigation](https://anara.com/lector/docs/code/page-navigation), [zoom](https://anara.com/lector/docs/code/zoom-control) |
+| Page previews | [Thumbnails](https://anara.com/lector/docs/code/thumbnails) |
+| Text search and highlighted results | [Search](https://anara.com/lector/docs/code/search) |
+| Selection and citation regions | [Selection](https://anara.com/lector/docs/code/select), [highlights](https://anara.com/lector/docs/code/highlight) |
+| PDF links and editable form fields | [Links](https://anara.com/lector/docs/code/links), [forms](https://anara.com/lector/docs/code/pdf-form) |
+| Dark page rendering | [Dark mode](https://anara.com/lector/docs/dark-mode) |
+| Props, hooks, and defaults | [API reference](https://anara.com/lector/docs/api) |
+
+Lector is a toolkit rather than a finished toolbar or a PDF editor. Your app supplies accessible controls, error UI, and storage for user annotations. Search requires embedded text; it does not perform OCR. Custom highlight overlays do not automatically modify the PDF file. See [troubleshooting](https://anara.com/lector/docs/troubleshooting) for worker errors, blank pages, and layout issues.
 
 ## Use with a coding assistant
 
-Connect an MCP client to `https://lector-weld.vercel.app/mcp` using Streamable HTTP, with no API key. It can search and read every guide through tools and resources. See [AI agents and MCP](https://lector-weld.vercel.app/docs/agents) for setup and example requests.
+Connect an MCP client to `https://anara.com/lector/mcp` using Streamable HTTP, with no API key. It can search and read every guide through tools and resources. See [AI agents and MCP](https://anara.com/lector/docs/agents) for setup and example requests.
 
-For direct fetching, start with [llms.txt](https://lector-weld.vercel.app/llms.txt), read [individual Markdown guides](https://lector-weld.vercel.app/docs/installation.md), or use the [complete documentation](https://lector-weld.vercel.app/llms-full.txt). These exports are generated from the same source as the website.
+For direct fetching, start with [llms.txt](https://anara.com/lector/llms.txt), read [individual Markdown guides](https://anara.com/lector/docs/installation.md), or use the [complete documentation](https://anara.com/lector/llms-full.txt). These exports are generated from the same source as the website.
 
 ## Work on Lector
 

package/dist/_tsup-dts-rollup.d.ts

@@ -9,9 +9,11 @@ import { JSX as JSX_2 } from 'react';
 import { JSXElementConstructor } from 'react';
 import { MemoExoticComponent } from 'react';
 import type { PageViewport } from 'pdfjs-dist';
+import { PageViewport as PageViewport_2 } from 'pdfjs-dist/types/src/display/display_utils';
 import type { PDFDocumentProxy } from 'pdfjs-dist';
 import { pdfjsDist } from 'pdfjs-dist';
 import type { PDFPageProxy } from 'pdfjs-dist';
+import { PDFPageProxy as PDFPageProxy_2 } from 'pdfjs-dist/types/src/display/api';
 import { default as React_2 } from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
@@ -161,6 +163,11 @@ declare interface AnnotationTooltipProps {
  */
 export declare function applyContextRecolor(ctx: CanvasRenderingContext2D, map: RenderColorMap, options?: RecolorContextOptions): (finalizeRender?: boolean) => void;
 
+/** Keep viewport geometry and zoom subscribers in the same coordinate space. */
+export declare function applyViewportZoom(viewport: HTMLDivElement | null, zoom: number): void;
+
+declare type ApplyZoom = (zoom: number) => void;
+
 declare interface AsyncSearchOptions extends SearchOptions {
     /** Cancelling rejects with AbortError and never publishes partial results. */
     signal?: AbortSignal;
@@ -225,6 +232,14 @@ export declare function computeBaseScale(dpr: number, zoom: number, pageWidth: n
 
 export declare function computeTargetScale(dpr: number, zoom: number): number;
 
+declare type CopyOptions = false | SelectionTextOptions;
+
+declare type CopyRegistration = {
+    container: HTMLElement;
+    options: () => CopyOptions;
+    read?: (options: SelectionTextOptions) => string | null | undefined;
+};
+
 /** Reuses two rows across candidate windows and only visits the edit band. */
 export declare function createBoundedDistance(query: string, maxDistance: number): (text: string, offset: number) => number;
 
@@ -295,6 +310,13 @@ declare const DEFAULT_DARK_MODE_COLORS: Required<DarkModeColors>;
 export { DEFAULT_DARK_MODE_COLORS }
 export { DEFAULT_DARK_MODE_COLORS as DEFAULT_DARK_MODE_COLORS_alias_1 }
 
+declare type Edit = {
+    start: number;
+    end: number;
+    sourceStart: number;
+    sourceEnd: number;
+};
+
 export declare const ensureAnnotationLayerStyles: () => void;
 
 export declare const firstMemo: <T>(first: boolean, memo: unknown, initializer: () => T) => T;
@@ -312,6 +334,13 @@ export declare const getFitWidthZoom: (containerWidth: number, viewports: PageVi
 
 export declare const getMidHeightOfHighlightLine: (selection: ColoredHighlight) => number;
 
+/**
+ * Read mounted PDF text in DOM/PDF.js order, including explicit line breaks.
+ * Null means the selection isn't wholly owned by this viewer or skips pages.
+ * Never reorder columns/RTL runs heuristically or silently omit unmounted pages.
+ */
+export declare function getPdfSelectionText(selection: Selection | null, container: HTMLElement, options?: SelectionTextOptions): string | null;
+
 /**
  * Per-text-node client rects for a selection. Avoids the block-level rects
  * that `range.getClientRects()` returns for `.textLayer` / page wrappers,
@@ -346,6 +375,8 @@ export declare interface HighlightRect_alias_2 {
 }
 
 export declare interface InitialPDFState {
+    pageResources?: PageResources;
+    initialPage?: number;
     pdfDocumentProxy: PDFDocumentProxy;
     pageProxies: PDFPageProxy[];
     viewports: Array<PageViewport>;
@@ -402,6 +433,26 @@ export declare const mergeTextRuns: <T extends Rect>(rects: T[]) => T[];
 
 export declare const NextPage: () => void;
 
+export declare interface NormalizedText {
+    text: string;
+    maps: Edit[][];
+}
+
+/** Search representation; rendering and copied/source text are never lowercased. */
+export declare function normalizeSearchText(text: string, options?: TextNormalizationOptions, lineBreaks?: readonly number[]): NormalizedText;
+
+/** Plain text for quotes/copy. Preserve case, accents, punctuation and paragraphs. */
+export declare function normalizeSelectionText(text: string, options?: SelectionTextOptions): string;
+
+/** Expand typographic ligatures without changing mathematical compatibility symbols. */
+export declare function normalizeUnicode(text: string, matchDiacritics?: boolean): string;
+
+/** Translate a normalized match back to its complete original glyph span. */
+export declare function originalTextRange(normalized: NormalizedText, start: number, end: number): {
+    start: number;
+    end: number;
+};
+
 export declare const Outline: ({ children, ...props }: HTMLProps<HTMLUListElement> & {
     children: ReactElement<typeof OutlineItem>;
 }) => JSX.Element;
@@ -428,7 +479,42 @@ pageNumber?: number;
 
 declare type PageNavigationCallback = (pageNumber: number, explicitDest?: unknown[]) => void;
 
-export declare const Pages: ({ children, gap, virtualizerOptions, initialOffset, onOffsetChange, ...props }: HTMLProps<HTMLDivElement> & {
+/** Owns a document's bounded, deduplicated page acquisition queue. */
+export declare class PageResources {
+    private document;
+    private rotation;
+    private onError;
+    private concurrency;
+    private pages;
+    private requests;
+    private queue;
+    private active;
+    private disposed;
+    private listeners;
+    private notification;
+    private viewports;
+    private completePages;
+    private viewportUpdates;
+    constructor(document: PDFDocumentProxy, firstPage: PDFPageProxy, rotation: number, onError: (error: unknown) => void, concurrency?: number);
+    private viewportFor;
+    get(pageNumber: number): PDFPageProxy_2 | undefined;
+    getSnapshot: () => {
+        viewports: PageViewport_2[];
+        pageProxies: PDFPageProxy_2[] | undefined;
+    };
+    subscribe: (listener: () => void) => () => void;
+    /** Visible pages move ahead of the background queue; in-flight requests are shared. */
+    load: (pageNumber: number) => Promise<PDFPageProxy>;
+    private createRequest;
+    /** Start after the reader mounts, so unrelated page metadata cannot delay its first render. */
+    start: () => void;
+    loadAll: () => Promise<PDFPageProxy[]>;
+    private pump;
+    private notify;
+    dispose: () => void;
+}
+
+export declare const Pages: ({ children, gap, virtualizerOptions, initialOffset, onOffsetChange, copyOptions, ...props }: HTMLProps<HTMLDivElement> & {
     virtualizerOptions?: {
         overscan?: number;
     };
@@ -436,12 +522,19 @@ export declare const Pages: ({ children, gap, virtualizerOptions, initialOffset,
     children: ReactElement;
     initialOffset?: number;
     onOffsetChange?: (offset: number) => void;
+    /** Plain-text PDF copying. Preserve line breaks by default; false uses native copying. */
+    copyOptions?: false | SelectionTextOptions;
 }) => JSX.Element;
 
-declare type PageText = {
+/** Text offsets always address the original, concatenated PDF.js strings. */
+declare interface PageText {
     pageNumber: number;
     text: string;
-};
+    /** Sorted UTF-16 offsets after items with hasEOL, without inserting characters. */
+    lineBreaks?: readonly number[];
+}
+export { PageText }
+export { PageText as PageText_alias_1 }
 
 export declare interface PdfJsAssetUrls {
     wasmUrl: string;
@@ -452,7 +545,68 @@ export declare interface PdfJsAssetUrls {
 
 export declare const PDFLinkServiceContext: Context<LinkService>;
 
+/** Document-owned selection; mounted text layers are replaceable projections. */
+export declare class PDFSelectionController {
+    private readonly options;
+    private snapshot;
+    private listeners;
+    private layers;
+    private pages;
+    private container;
+    private projection;
+    private frame;
+    private work;
+    private structuralChange;
+    private drag;
+    private connectedCleanup;
+    private generation;
+    private keyboardWork;
+    private keyboardMoves;
+    constructor(options: {
+        pageCount: number;
+        loadPage: (page: number) => Promise<PDFPageProxy>;
+        revealPage?: (page: number) => void;
+    });
+    getSnapshot: () => PDFTextSelection | null;
+    subscribe: (listener: () => void) => () => void;
+    get isDragging(): boolean;
+    includesPage(page: number): boolean;
+    private publish;
+    private ordered;
+    private bounds;
+    private remember;
+    private complete;
+    setSelection: (anchor: PDFTextAnchor, focus: PDFTextAnchor) => void;
+    clear: () => void;
+    getText: (options?: SelectionTextOptions) => string | null;
+    getSelection: (options?: SelectionTextOptions) => PDFSelectionResult | null;
+    getSelectionAsync: (options?: SelectionTextOptions) => Promise<PDFSelectionResult | null>;
+    private finishSelection;
+    registerLayer(element: HTMLElement, pageNumber: number, width: number, height: number): () => void;
+    private anchorFor;
+    private capture;
+    private schedule;
+    private project;
+    private hydrate;
+    private caret;
+    private autoScroll;
+    private flushKeyboard;
+    connect(container: HTMLElement): () => void;
+}
+
+declare interface PDFSelectionResult {
+    anchor: PDFTextAnchor;
+    focus: PDFTextAnchor;
+    text: string;
+    highlights: HighlightRect[];
+    underlines: HighlightRect[];
+    isCollapsed: false;
+}
+export { PDFSelectionResult }
+export { PDFSelectionResult as PDFSelectionResult_alias_1 }
+
 declare interface PDFState {
+    selection: PDFSelectionController;
     pdfDocumentProxy: PDFDocumentProxy;
     zoom: number;
     updateZoom: (zoom: number | ((prevZoom: number) => number), isZoomFitWidth?: boolean) => void;
@@ -474,7 +628,14 @@ declare interface PDFState {
     setVirtualizer: (virtualizer: PDFVirtualizer) => void;
     highlights: HighlightRect[];
     setHighlight: (higlights: HighlightRect[]) => void;
+    /** Synchronous access; progressive consumers must load an unresolved page first. */
     getPdfPageProxy: (pageNumber: number) => PDFPageProxy;
+    loadPdfPageProxy: (pageNumber: number) => Promise<PDFPageProxy>;
+    loadPdfPageProxies: () => Promise<PDFPageProxy[]>;
+    isPageLoaded: (pageNumber: number) => boolean;
+    /** False until the ordered pageProxies array is complete in progressive mode. */
+    pagesLoaded: boolean;
+    initialPage: number;
     customSelectionRects: HighlightRect[];
     setCustomSelectionRects: (rects: HighlightRect[]) => void;
     coloredHighlights: ColoredHighlight[];
@@ -502,6 +663,23 @@ export declare const PDFStore: {
     }) => JSX.Element;
 };
 
+/** One-based page and UTF-16 offset in that page's selectable text (BRs excluded). */
+declare interface PDFTextAnchor {
+    pageNumber: number;
+    offset: number;
+}
+export { PDFTextAnchor }
+export { PDFTextAnchor as PDFTextAnchor_alias_1 }
+
+declare interface PDFTextSelection {
+    anchor: PDFTextAnchor;
+    focus: PDFTextAnchor;
+    status: "loading" | "ready" | "error";
+    error?: unknown;
+}
+export { PDFTextSelection }
+export { PDFTextSelection as PDFTextSelection_alias_1 }
+
 export declare type PDFVirtualizer = Virtualizer<any, any>;
 
 export declare const PreviousPage: () => void;
@@ -525,6 +703,11 @@ declare type Rect = {
     height: number;
 };
 
+/** One copy listener per owner document; no work runs during scroll or render. */
+export declare function registerPdfCopy(container: HTMLElement, options: () => CopyOptions, read?: CopyRegistration["read"]): () => void;
+
+export declare function registerViewportZoom(viewport: HTMLDivElement, apply: ApplyZoom): () => void;
+
 /**
  * Removes any recolor wrapper installed on the context. For long-lived
  * contexts (the visible canvas in the no-buffer fallback, thumbnails) that
@@ -610,7 +793,7 @@ export declare function searchDocument(pages: SearchPage[], searchText: string,
 
 export declare function searchDocumentAsync(pages: SearchPage[], searchText: string, options?: AsyncSearchOptions): Promise<SearchResults>;
 
-declare interface SearchOptions {
+declare interface SearchOptions extends TextNormalizationOptions {
     threshold?: number;
     limit?: number;
     textSize?: number;
@@ -618,10 +801,7 @@ declare interface SearchOptions {
 export { SearchOptions }
 export { SearchOptions as SearchOptions_alias_1 }
 
-declare type SearchPage = {
-    pageNumber: number;
-    text: string;
-};
+declare type SearchPage = PageText;
 
 declare interface SearchProps {
     children: React.ReactNode;
@@ -638,6 +818,8 @@ export declare interface SearchResult {
     text: string;
     score: number;
     matchIndex: number;
+    /** Matched UTF-16 span in the original PDF text, when different from searchText.length. */
+    matchLength?: number;
     isExactMatch: boolean;
     searchText?: string;
 }
@@ -648,6 +830,41 @@ export declare interface SearchResults {
     hasMoreResults: boolean;
 }
 
+/** A mounted text layer. Only this object owns DOM nodes; snapshots never do. */
+export declare class SelectionPage {
+    readonly element: HTMLElement;
+    readonly pageNumber: number;
+    readonly width: number;
+    readonly height: number;
+    readonly nodes: {
+        node: Text;
+        start: number;
+        end: number;
+    }[];
+    readonly content: SelectionPageText;
+    constructor(element: HTMLElement, pageNumber: number, width: number, height: number);
+    offset(node: Node, offset: number): number | null;
+    point(offset: number, end?: boolean): {
+        node: Text;
+        offset: number;
+    } | null;
+    rects(from: number, to: number): HighlightRect[];
+}
+
+export declare interface SelectionPageText {
+    text: string;
+    lineBreaks: number[];
+}
+
+declare interface SelectionTextOptions {
+    /** Preserve line and page breaks by default; space joins single line breaks. */
+    lineBreaks?: "preserve" | "space";
+    /** Join wrapped words ending in a hard hyphen. Defaults to false. */
+    ignoreHyphenation?: boolean;
+}
+export { SelectionTextOptions }
+export { SelectionTextOptions as SelectionTextOptions_alias_1 }
+
 export declare const SelectionTooltip: ({ children }: SelectionTooltipProps) => JSX.Element;
 
 declare interface SelectionTooltipProps {
@@ -670,10 +887,7 @@ export declare function sourceSize(source: CanvasImageSource): {
 
 export declare const subscribeToViewportInvalidation: (viewport: HTMLDivElement, callback: ViewportCallback) => () => void;
 
-declare type TextContent = {
-    pageNumber: number;
-    text: string;
-};
+declare type TextContent = PageText;
 
 export declare const TextLayer: MemoExoticComponent<({ className, style, ...props }: HTMLProps<HTMLDivElement>) => JSX.Element>;
 
@@ -682,14 +896,23 @@ declare type TextNodeRect = {
     element: Element | null;
 };
 
+export declare interface TextNormalizationOptions {
+    /** Preserve accents by default. False folds Latin, Greek and Cyrillic accents. */
+    matchDiacritics?: boolean;
+    /** Join letter-hyphen-linebreak-lowercase sequences. Defaults to false. */
+    ignoreHyphenation?: boolean;
+}
+
 declare interface TextPosition {
     pageNumber: number;
     text: string;
     matchIndex: number;
+    matchLength?: number;
     searchText?: string;
 }
 
-export declare const Thumbnail: ({ pageNumber, eager, ...props }: HTMLProps<HTMLCanvasElement> & {
+/** An unresolved page occupies a stable row while its resource is acquired. */
+export declare const Thumbnail: (props: HTMLProps<HTMLCanvasElement> & {
     pageNumber?: number;
     eager?: boolean;
 }) => JSX.Element;
@@ -750,7 +973,7 @@ declare const usePdf: <T>(selector: (state: PDFState) => T) => T;
 export { usePdf }
 export { usePdf as usePdf_alias_1 }
 
-export declare const usePDFDocumentContext: ({ onDocumentLoad, onError, source, initialRotation, isZoomFitWidth, zoom, zoomOptions, documentOptions, colorScheme, darkModeColors, }: usePDFDocumentParams) => {
+export declare const usePDFDocumentContext: ({ onDocumentLoad, onError, source, initialRotation, progressive, initialPage, isZoomFitWidth, zoom, zoomOptions, documentOptions, colorScheme, darkModeColors, }: usePDFDocumentParams) => {
     initialState: InitialPDFState | null | undefined;
 };
 
@@ -780,6 +1003,10 @@ export declare interface usePDFDocumentParams {
         source: Source;
     }) => void;
     initialRotation?: number;
+    /** Render the initial page before acquiring the rest. Unloaded page sizes are estimates. */
+    progressive?: boolean;
+    /** One-based page to load and display first. Read when source changes. */
+    initialPage?: number;
     isZoomFitWidth?: boolean;
     zoom?: number;
     zoomOptions?: ZoomOptions;
@@ -831,11 +1058,20 @@ declare const usePDFOutline: () => {
 
 export declare const usePDFPageNumber: () => number;
 
+/** Selection anchors survive virtualized text-layer removal. */
+declare function usePdfSelection(): {
+    selection: PDFTextSelection | null;
+    setSelection: (anchor: PDFTextAnchor, focus: PDFTextAnchor) => void;
+    clearSelection: () => void;
+    getText: (options?: SelectionTextOptions) => string | null;
+    getSelection: (options?: SelectionTextOptions) => PDFSelectionResult | null;
+    getSelectionAsync: (options?: SelectionTextOptions) => Promise<PDFSelectionResult | null>;
+};
+export { usePdfSelection }
+export { usePdfSelection as usePdfSelection_alias_1 }
+
 export declare const useSearch: () => {
-    textContent: {
-        pageNumber: number;
-        text: string;
-    }[];
+    textContent: PageText[];
     keywords: string[];
     searchResults: SearchResults;
     search: (searchText: string, options?: SearchOptions) => SearchResults;
@@ -845,22 +1081,26 @@ export declare const useSearch: () => {
 };
 
 export declare const useSelectionDimensions: () => {
-    getDimension: () => {
+    getDimension: () => PDFSelectionResult | {
         highlights: HighlightRect[];
         text: string;
         isCollapsed: boolean;
     } | undefined;
     getSelection: () => CollapsibleSelection;
-    getAnnotationDimension: () => {
+    getAnnotationDimension: () => PDFSelectionResult | {
         highlights: HighlightRect[];
         underlines: HighlightRect[];
         text: string;
         isCollapsed: boolean;
     } | undefined;
+    getText: (options?: SelectionTextOptions) => string | null;
 };
 
 declare type ViewportCallback = () => void;
 
+/** Materialize one missing selected page as text only, never as a page canvas. */
+export declare function withSelectionPage<T>(proxy: PDFPageProxy, owner: Document, signal: AbortSignal, read: (page: SelectionPage) => T): Promise<T>;
+
 export declare const ZoomIn: ({ ...props }: HTMLProps<HTMLButtonElement>) => JSX.Element;
 
 export declare interface ZoomOptions {

package/dist/index.d.ts

@@ -39,6 +39,7 @@ export { PDFLinkServiceContext } from './_tsup-dts-rollup.js';
 export { useCreatePDFLinkService } from './_tsup-dts-rollup.js';
 export { usePDFLinkService } from './_tsup-dts-rollup.js';
 export { usePDFPageNumber } from './_tsup-dts-rollup.js';
+export { usePdfSelection } from './_tsup-dts-rollup.js';
 export { useSelectionDimensions } from './_tsup-dts-rollup.js';
 export { ColoredHighlight } from './_tsup-dts-rollup.js';
 export { HighlightRect } from './_tsup-dts-rollup.js';
@@ -48,5 +49,10 @@ export { createDarkModeColorMap } from './_tsup-dts-rollup.js';
 export { DarkModeColors } from './_tsup-dts-rollup.js';
 export { DEFAULT_DARK_MODE_COLORS } from './_tsup-dts-rollup.js';
 export { RenderColorMap } from './_tsup-dts-rollup.js';
+export { PDFSelectionResult } from './_tsup-dts-rollup.js';
+export { PDFTextAnchor } from './_tsup-dts-rollup.js';
+export { PDFTextSelection } from './_tsup-dts-rollup.js';
 export { AsyncSearchOptions } from './_tsup-dts-rollup.js';
 export { SearchOptions } from './_tsup-dts-rollup.js';
+export { PageText } from './_tsup-dts-rollup.js';
+export { SelectionTextOptions } from './_tsup-dts-rollup.js';