@embedpdf/plugin-selection 2.6.1 → 2.6.2

package/dist/lib/types.d.ts

@@ -17,6 +17,24 @@ export interface SelectionPluginConfig extends BasePluginConfig {
      * Configuration for marquee selection behavior.
      */
     marquee?: MarqueeSelectionConfig;
+    /**
+     * Tolerance factor for hit-testing glyphs. Multiplied by average glyph
+     * height to derive the tolerance radius. Set to 0 to require exact hits.
+     * @default 1.5
+     */
+    toleranceFactor?: number;
+    /**
+     * Minimum drag distance (in page-coordinate units) the pointer must move
+     * before a drag-selection starts. Prevents accidental selection on simple clicks.
+     * @default 3
+     */
+    minSelectionDragDistance?: number;
+    /**
+     * Maximum number of pages whose geometry data is kept in memory per document.
+     * Oldest unused pages are evicted when this limit is exceeded.
+     * @default 50
+     */
+    maxCachedGeometries?: number;
 }
 export interface SelectionMenuPlacement {
     pageIndex: number;

package/dist/lib/utils.d.ts

@@ -1,12 +1,21 @@
 import { PdfPageGeometry, Position, Rect } from '@embedpdf/models';
 import { SelectionRangeX } from './types';
 /**
- * Hit-test helper using runs
+ * Hit-test helper using runs, with tolerance-based fallback.
+ *
+ * Adapted from PDFium's FPDFText_GetCharIndexAtPos / CPDF_TextPage::GetIndexAtPos:
+ *  1. Exact match: return the glyph whose bounding box contains the point.
+ *  2. Tolerance expansion: expand each glyph box by tolerance/2 on every side,
+ *     then pick the closest glyph by Manhattan distance.
+ *
  * @param geo - page geometry
- * @param pt - point
- * @returns glyph index
+ * @param pt - point in page coordinates
+ * @param toleranceFactor - multiplied by average glyph height to derive the
+ *                          tolerance radius. 0 disables the fallback.
+ *                          Default 1.5 (see Chromium's pdfium-page.cc kTolerance).
+ * @returns glyph index, or -1 if nothing was hit
  */
-export declare function glyphAt(geo: PdfPageGeometry, pt: Position): number;
+export declare function glyphAt(geo: PdfPageGeometry, pt: Position, toleranceFactor?: number): number;
 /**
  * Helper: min/max glyph indices on `page` for current sel
  * @param sel - selection range
@@ -44,11 +53,12 @@ export declare function rectsWithinSlice(geo: PdfPageGeometry, from: number, to:
  * Adapted for TypeScript and this project's Rect/geometry types.
  */
 /**
- * Text run info for rect merging (similar to Chromium's ScreenRectTextRunInfo)
+ * Text run info for rect merging (similar to Chromium's PdfRectTextRunInfo)
  */
 export interface TextRunInfo {
     rect: Rect;
     charCount: number;
+    fontSize?: number;
 }
 /**
  * Helper functions for Rect operations
@@ -65,6 +75,34 @@ export declare function getVerticalOverlap(rect1: Rect, rect2: Rect): number;
  */
 export declare function shouldMergeHorizontalRects(textRun1: TextRunInfo, textRun2: TextRunInfo): boolean;
 /**
- * Merge adjacent rectangles based on proximity and overlap (similar to Chromium's algorithm)
+ * Merge adjacent rectangles based on proximity and overlap.
+ *
+ * Adapted from Chromium's MergeAdjacentRects (pdfium_range.cc):
+ *  - The merge DECISION uses the loose `rect` (via shouldMergeHorizontalRects).
+ *  - The OUTPUT rect always uses loose bounds.
  */
 export declare function mergeAdjacentRects(textRuns: TextRunInfo[]): Rect[];
+/**
+ * Expand a character index to the word surrounding it.
+ *
+ * Walks backward and forward from `charIndex` within the page geometry
+ * until a word-boundary glyph (space or empty) is encountered.
+ *
+ * @returns `{ from, to }` inclusive indices, or null if charIndex is invalid.
+ */
+export declare function expandToWordBoundary(geo: PdfPageGeometry, charIndex: number): {
+    from: number;
+    to: number;
+} | null;
+/**
+ * Expand a character index to the full visual line (row) it belongs to.
+ *
+ * Finds all runs whose vertical extent overlaps with the run containing `charIndex`,
+ * then returns the first-to-last character span across those runs.
+ *
+ * @returns `{ from, to }` inclusive indices, or null if charIndex is invalid.
+ */
+export declare function expandToLineBoundary(geo: PdfPageGeometry, charIndex: number): {
+    from: number;
+    to: number;
+} | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-selection",
-  "version": "2.6.1",
+  "version": "2.6.2",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.cjs",
@@ -34,17 +34,17 @@
     }
   },
   "dependencies": {
-    "@embedpdf/models": "2.6.1",
-    "@embedpdf/utils": "2.6.1"
+    "@embedpdf/models": "2.6.2",
+    "@embedpdf/utils": "2.6.2"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
     "typescript": "^5.0.0",
     "@embedpdf/build": "1.1.0",
-    "@embedpdf/plugin-viewport": "2.6.1",
-    "@embedpdf/core": "2.6.1",
-    "@embedpdf/plugin-scroll": "2.6.1",
-    "@embedpdf/plugin-interaction-manager": "2.6.1"
+    "@embedpdf/core": "2.6.2",
+    "@embedpdf/plugin-viewport": "2.6.2",
+    "@embedpdf/plugin-interaction-manager": "2.6.2",
+    "@embedpdf/plugin-scroll": "2.6.2"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -52,8 +52,8 @@
     "preact": "^10.26.4",
     "vue": ">=3.2.0",
     "svelte": ">=5 <6",
-    "@embedpdf/core": "2.6.1",
-    "@embedpdf/plugin-interaction-manager": "2.6.1"
+    "@embedpdf/core": "2.6.2",
+    "@embedpdf/plugin-interaction-manager": "2.6.2"
   },
   "files": [
     "dist",