@anaralabs/lector 3.14.13 → 3.15.0

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

@@ -232,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;
 
@@ -302,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;
@@ -319,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,
@@ -411,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;
@@ -472,7 +514,7 @@ export declare class PageResources {
     dispose: () => void;
 }
 
-export declare const Pages: ({ children, gap, virtualizerOptions, initialOffset, onOffsetChange, ...props }: HTMLProps<HTMLDivElement> & {
+export declare const Pages: ({ children, gap, virtualizerOptions, initialOffset, onOffsetChange, copyOptions, ...props }: HTMLProps<HTMLDivElement> & {
     virtualizerOptions?: {
         overscan?: number;
     };
@@ -480,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;
@@ -496,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;
@@ -553,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;
@@ -576,6 +703,9 @@ 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;
 
 /**
@@ -663,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;
@@ -671,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;
@@ -703,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 {
@@ -725,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>;
 
@@ -737,6 +896,13 @@ 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;
@@ -892,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;
@@ -906,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';