@embedpdf/plugin-selection 3.0.0-next.3 → 3.0.0-next.5

package/dist/internal.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_reducer = require("./reducer-Dyf8p5h-.cjs");
+exports.SelectionToken = require_reducer.SelectionToken;
+exports.buildSelectionPageGeometry = require_reducer.buildSelectionPageGeometry;
+exports.contentPointToPdf = require_reducer.contentPointToPdf;
+exports.createSelectionCapability = require_reducer.createSelectionCapability;
+exports.createTextSelectHandler = require_reducer.createTextSelectHandler;
+exports.initialSelectionState = require_reducer.initialSelectionState;
+exports.selectionReducer = require_reducer.selectionReducer;
+exports.toContentSegment = require_reducer.toContentSegment;
+exports.toContentTextQuad = require_reducer.toContentTextQuad;

package/dist/internal.d.cts

@@ -0,0 +1,62 @@
+import { _ as contentPointToPdf, a as SelectionHostCapability, d as SelectionToken, g as buildSelectionPageGeometry, m as SelectionPageGeometry, n as SelectionAction, s as SelectionRange, t as GlyphPointer, u as SelectionState, v as toContentSegment, y as toContentTextQuad } from "./types-DtWaZIsm.cjs";
+import { PluginContext } from "@embedpdf/core";
+import { InteractionCapability, InteractionHandler } from "@embedpdf/plugin-interaction";
+//#region src/capability.d.ts
+/**
+ * The selection capability — ONE closure returning the host lens (the
+ * public lens is the same object, narrowed at the package root).
+ *
+ * State model: the reducer holds the selection range and the derived
+ * content-space segments; the large, non-serializable per-page caches live
+ * HERE in the closure, split by what invalidates them:
+ *
+ *   - `rawGeometry` — PDF-space geometry snapshots, rotation-independent
+ *     (pages load normalized; see `PageRotateResult`). Dropped only when a
+ *     page leaves the registry or page CONTENT changes (redaction apply /
+ *     flatten).
+ *   - `derived` — the content-space transform + layout, keyed by the
+ *     layout params (crop/rotation/userUnit) so a view-rotate re-derives
+ *     from the cached raw snapshot with NO refetch.
+ *   - `textSnapshots` — per-page text (for `readText`), same content-only
+ *     invalidation as `rawGeometry`.
+ *
+ * Permission model: `doc.text.select` gates geometry (selection exists),
+ * `doc.text.copy` gates text (extraction) — neither implies the other.
+ * Host gesture functions are INERT when select is denied (`ensurePage`
+ * no-ops, so nothing warms and nothing hit-tests: the pointer handler
+ * needs no special-casing); the public `select()` THROWS `PermissionDenied`
+ * so programmatic misuse is loud; `clear()` is always allowed. The engine
+ * independently enforces both scopes — these gates exist so the plugin
+ * never issues a request that is guaranteed to fail.
+ *
+ * Selection is cross-page: glyphs are ordered globally by (pageIndex,
+ * glyph), so a drag from page 2 into page 4 selects the tail of 2, all of
+ * 3, and the head of 4. `recompute` rebuilds the merged line segments for
+ * every loaded page in the span, re-runs whenever a mid-span page finishes
+ * loading, and CLAMPS stored endpoints once their page's geometry is known
+ * (so `selectAll`'s open-ended focus settles to the real last character).
+ */
+declare function createSelectionCapability(ctx: PluginContext<SelectionState, SelectionAction>): SelectionHostCapability;
+//#endregion
+//#region src/handler.d.ts
+/**
+ * The text-selection pointer handler. It is live only under tools that enable the
+ * `'text-select'` tag (the built-in `pointer` tool does; `pan` does not — so
+ * switching to pan disables text selection with zero special-casing here).
+ *
+ *  - single click        → deselect; records an anchor but selects NOTHING until
+ *                          the pointer moves past the drag threshold (Chrome/Acrobat feel)
+ *  - single-click + drag → caret selection from the anchor (extends across pages)
+ *  - double-click        → select the word
+ *  - triple-click        → select the visual line
+ *  - down off-text       → deselect, and DON'T capture (so it can't block)
+ *  - hover               → I-beam only when over text, else the pointer cursor
+ */
+declare function createTextSelectHandler(selection: SelectionHostCapability, interaction: InteractionCapability): InteractionHandler;
+//#endregion
+//#region src/reducer.d.ts
+declare const initialSelectionState: SelectionState;
+declare const selectionReducer: (state: SelectionState, action: SelectionAction) => SelectionState;
+//#endregion
+export { type GlyphPointer, type SelectionAction, type SelectionHostCapability, type SelectionPageGeometry, type SelectionRange, type SelectionState, SelectionToken, buildSelectionPageGeometry, contentPointToPdf, createSelectionCapability, createTextSelectHandler, initialSelectionState, selectionReducer, toContentSegment, toContentTextQuad };
+//# sourceMappingURL=internal.d.cts.map

package/dist/internal.d.ts

@@ -0,0 +1,62 @@
+import { _ as contentPointToPdf, a as SelectionHostCapability, d as SelectionToken, g as buildSelectionPageGeometry, m as SelectionPageGeometry, n as SelectionAction, s as SelectionRange, t as GlyphPointer, u as SelectionState, v as toContentSegment, y as toContentTextQuad } from "./types-DtWaZIsm.js";
+import { PluginContext } from "@embedpdf/core";
+import { InteractionCapability, InteractionHandler } from "@embedpdf/plugin-interaction";
+//#region src/capability.d.ts
+/**
+ * The selection capability — ONE closure returning the host lens (the
+ * public lens is the same object, narrowed at the package root).
+ *
+ * State model: the reducer holds the selection range and the derived
+ * content-space segments; the large, non-serializable per-page caches live
+ * HERE in the closure, split by what invalidates them:
+ *
+ *   - `rawGeometry` — PDF-space geometry snapshots, rotation-independent
+ *     (pages load normalized; see `PageRotateResult`). Dropped only when a
+ *     page leaves the registry or page CONTENT changes (redaction apply /
+ *     flatten).
+ *   - `derived` — the content-space transform + layout, keyed by the
+ *     layout params (crop/rotation/userUnit) so a view-rotate re-derives
+ *     from the cached raw snapshot with NO refetch.
+ *   - `textSnapshots` — per-page text (for `readText`), same content-only
+ *     invalidation as `rawGeometry`.
+ *
+ * Permission model: `doc.text.select` gates geometry (selection exists),
+ * `doc.text.copy` gates text (extraction) — neither implies the other.
+ * Host gesture functions are INERT when select is denied (`ensurePage`
+ * no-ops, so nothing warms and nothing hit-tests: the pointer handler
+ * needs no special-casing); the public `select()` THROWS `PermissionDenied`
+ * so programmatic misuse is loud; `clear()` is always allowed. The engine
+ * independently enforces both scopes — these gates exist so the plugin
+ * never issues a request that is guaranteed to fail.
+ *
+ * Selection is cross-page: glyphs are ordered globally by (pageIndex,
+ * glyph), so a drag from page 2 into page 4 selects the tail of 2, all of
+ * 3, and the head of 4. `recompute` rebuilds the merged line segments for
+ * every loaded page in the span, re-runs whenever a mid-span page finishes
+ * loading, and CLAMPS stored endpoints once their page's geometry is known
+ * (so `selectAll`'s open-ended focus settles to the real last character).
+ */
+declare function createSelectionCapability(ctx: PluginContext<SelectionState, SelectionAction>): SelectionHostCapability;
+//#endregion
+//#region src/handler.d.ts
+/**
+ * The text-selection pointer handler. It is live only under tools that enable the
+ * `'text-select'` tag (the built-in `pointer` tool does; `pan` does not — so
+ * switching to pan disables text selection with zero special-casing here).
+ *
+ *  - single click        → deselect; records an anchor but selects NOTHING until
+ *                          the pointer moves past the drag threshold (Chrome/Acrobat feel)
+ *  - single-click + drag → caret selection from the anchor (extends across pages)
+ *  - double-click        → select the word
+ *  - triple-click        → select the visual line
+ *  - down off-text       → deselect, and DON'T capture (so it can't block)
+ *  - hover               → I-beam only when over text, else the pointer cursor
+ */
+declare function createTextSelectHandler(selection: SelectionHostCapability, interaction: InteractionCapability): InteractionHandler;
+//#endregion
+//#region src/reducer.d.ts
+declare const initialSelectionState: SelectionState;
+declare const selectionReducer: (state: SelectionState, action: SelectionAction) => SelectionState;
+//#endregion
+export { type GlyphPointer, type SelectionAction, type SelectionHostCapability, type SelectionPageGeometry, type SelectionRange, type SelectionState, SelectionToken, buildSelectionPageGeometry, contentPointToPdf, createSelectionCapability, createTextSelectHandler, initialSelectionState, selectionReducer, toContentSegment, toContentTextQuad };
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.js

@@ -0,0 +1,2 @@
+import { a as buildSelectionPageGeometry, c as toContentTextQuad, i as createSelectionCapability, l as SelectionToken, n as selectionReducer, o as contentPointToPdf, r as createTextSelectHandler, s as toContentSegment, t as initialSelectionState } from "./reducer-CZG2TZgo.js";
+export { SelectionToken, buildSelectionPageGeometry, contentPointToPdf, createSelectionCapability, createTextSelectHandler, initialSelectionState, selectionReducer, toContentSegment, toContentTextQuad };