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

package/dist/index.d.cts

@@ -1,185 +1,26 @@
-import { PageObjectNumber, PluginContext } from "@embedpdf/core";
-import { Mat2D, Point, Rect, TextQuad } from "@embedpdf/core-geometry";
-import { PageGeometrySnapshot, PageTextLayout, PdfPoint, PdfQuad, PdfRect, PdfTextSegment } from "@embedpdf/engine-core/runtime";
-import { InteractionCapability, InteractionHandler } from "@embedpdf/plugin-interaction";
-//#region src/geometry.d.ts
-/**
- * One merged visual line of a selection, in content space — the structural
- * twin of the engine's `PdfTextSegment`. `quad` carries frame-geometric
- * corner semantics (upper = ascent side, start = the frame's −x); `advance`
- * is the READING direction along the baseline (+1 = toward `end`), derived
- * from the glyph sequence — geometry and bidi stay separate concerns.
- * `rect` is the content-space AABB.
- */
-interface SelectionSegment {
-  quad: TextQuad;
-  rect: Rect;
-  advance: 1 | -1;
-}
-/** A page's cached selection geometry: the canonical layout + the seam. */
-interface SelectionPageGeometry {
-  layout: PageTextLayout;
-  toContent: Mat2D<'pdf', 'content'>;
-  fromContent: Mat2D<'content', 'pdf'>;
-}
-/**
- * Build a page's selection geometry. Page display rotation does NOT enter
- * here — the overlay rides the page's CSS rotation, so content space stays
- * un-rotated (the crop-relative y-flip is the only conversion; zoom = 1,
- * the viewer's zoom is applied later by `PageTransform.pageToContent`).
- */
-declare function buildSelectionPageGeometry(snapshot: PageGeometrySnapshot, crop: PdfRect, rotation: 0 | 90 | 180 | 270, userUnit: number): SelectionPageGeometry;
-/** A content-space pointer point in the layout's PDF space. */
-declare function contentPointToPdf(geom: SelectionPageGeometry, p: Point): PdfPoint;
-/**
- * A canonical PDF quad in content space. Engine quads carry frame-geometric
- * slot semantics (`p1..p4` = upper-start, upper-end, lower-start,
- * lower-end) — a trusted producer, so the y-flip maps corners straight onto
- * their names; imported-annotation normalization does NOT apply here.
- */
-declare function toContentTextQuad(geom: SelectionPageGeometry, quad: PdfQuad): TextQuad;
-/** A canonical segment in content space (`rect` recomputed from the mapped
- *  quad so the pair can never drift). */
-declare function toContentSegment(geom: SelectionPageGeometry, segment: PdfTextSegment): SelectionSegment;
-//#endregion
-//#region src/types.d.ts
-/** A glyph address: a page + a flat glyph index within that page's geometry. */
-interface GlyphPointer {
-  pon: PageObjectNumber;
-  glyph: number;
-}
-/** Anchor = where the drag began, focus = the current end. Inclusive. */
-interface SelectionRange {
-  anchor: GlyphPointer;
-  focus: GlyphPointer;
-}
-/**
- * A selection boundary, anchored to the boundary GLYPH's own oriented cell.
- * `advance` is the reading direction of the segment it belongs to (+1 = the
- * frame's +x), so caret consumers place at the trailing edge without
- * re-deriving bidi from geometry. `rect` is the AABB (scroll targets).
- */
-interface SelectionEndpoint {
-  pon: PageObjectNumber;
-  glyphQuad: TextQuad;
-  advance: 1 | -1;
-  rect: Rect;
-}
-interface SelectionSnapshot {
-  /** Per-page canonical segments — the ONE geometry consumers act on.
-   *  Boxes are derived views (`segment.rect`, or `rectsForPage()`). */
-  pages: Array<{
-    pon: PageObjectNumber;
-    segments: SelectionSegment[];
-  }>;
-  start: SelectionEndpoint | null;
-  end: SelectionEndpoint | null;
-  direction: 'forward' | 'backward';
-}
-interface SelectionState {
-  selection: SelectionRange | null;
-  /** Derived per-line segments per page, in CONTENT space (y-down, PDF units). */
-  segments: Record<number, SelectionSegment[]>;
-  /** Pages whose text geometry has loaded (so the layer re-renders when ready). */
-  loaded: Record<number, boolean>;
-  /** When a consumer owns the selection visual (e.g. a markup tool draws its own
-   *  preview), the default highlight rects are suppressed. */
-  highlightHidden: boolean;
-}
-type SelectionAction = {
-  type: 'PAGE_LOADED';
-  pon: PageObjectNumber;
-} | {
-  type: 'SET';
-  selection: SelectionRange;
-  segments: Record<number, SelectionSegment[]>;
-} | {
-  type: 'CLEAR';
-} | {
-  type: 'SET_HIGHLIGHT_HIDDEN';
-  hidden: boolean;
-};
-interface SelectionCapability {
-  /** Warm a page's text geometry (idempotent). Layers call this when a page mounts. */
-  ensurePage(pon: PageObjectNumber): void;
-  isLoaded(pon: PageObjectNumber): boolean;
-  /** Is a content-space point on (or near) text? Drives the I-beam vs pointer cursor. */
-  isOverText(pon: PageObjectNumber, point: Point): boolean;
-  /** Begin a caret selection at a page point. Returns false if not near any text. */
-  beginAt(pon: PageObjectNumber, point: Point): boolean;
-  /** Double-click: select the word around the point. */
-  selectWord(pon: PageObjectNumber, point: Point): void;
-  /** Triple-click: select the whole visual line around the point. */
-  selectLine(pon: PageObjectNumber, point: Point): void;
-  /** Extend the current selection to a page point (drag). */
-  extendTo(pon: PageObjectNumber, point: Point): void;
-  end(): void;
-  clear(): void;
-  /** Coherent read-model for consumers that create annotations or selection UI. */
-  snapshot(): SelectionSnapshot;
-  /** Per-line oriented segments for a page, in content space — the layer's input. */
-  segmentsForPage(pon: PageObjectNumber): SelectionSegment[];
-  /** The segments' AABBs — for consumers that genuinely want boxes (scroll,
-   *  conservative regions). Never a substitute for the oriented quads in
-   *  geometry that gets drawn or persisted. */
-  rectsForPage(pon: PageObjectNumber): Rect[];
-  hasSelection(): boolean;
-  /** The pages the current selection covers (those with at least one rect) — so a
-   *  cross-page action (e.g. text-markup creation) can fan out per page. */
-  selectedPages(): PageObjectNumber[];
-  /** Fires whenever the selection rects change (e.g. drag-extend) — for live preview. */
-  onChange(cb: () => void): () => void;
-  /** Fires when a selection gesture ends (pointer-up) — the commit point. */
-  onCommit(cb: () => void): () => void;
-  /** Suppress / restore the default highlight visual (a consumer drawing its own). */
-  setHighlightVisible(visible: boolean): void;
-  highlightVisible(): boolean;
-}
-declare const SelectionToken: import("@embedpdf/core").CapabilityToken<SelectionCapability>;
-//#endregion
+import { a as SelectionHostCapability, c as SelectionRangeInput, f as TextPosition, h as SelectionSegment, i as SelectionEndpoint, l as SelectionSnapshot, n as SelectionAction, o as SelectionMenuAnchor, p as TextRange, r as SelectionCapability, u as SelectionState } from "./types-DtWaZIsm.cjs";
+import { CapabilityToken } from "@embedpdf/core";
 //#region src/selection.plugin.d.ts
 /**
  * Text selection — document-scoped, requires the interaction hub. In `init` it
  * registers ITS pointer handler with the hub; the hub owns the pointer stream
  * and arbitration. Works with `<Stage>` or a standalone `<PageView>` — selection
  * only needs the page coordinate context + the engine's text geometry.
- */
-declare const selectionPlugin: () => import("@embedpdf/core").PluginDef<SelectionState, SelectionAction, SelectionCapability>;
-//#endregion
-//#region src/capability.d.ts
-/**
- * The selection capability. The reducer state holds the selection range, the
- * derived content-space segments (per page), and per-page loaded flags; the
- * (large, non-serializable) per-page canonical layout is cached HERE in the
- * closure. Segmentation itself is the engine-core text layout — selection
- * owns gestures and state, never how glyphs become lines.
  *
- * 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 and re-runs whenever a mid-span page finishes loading.
+ * Registry/content invalidation is wired inside the capability itself
+ * (revision watch + document event subscription), so headless/programmatic
+ * use gets the same reconciliation as the full viewer.
  */
-declare function createSelectionCapability(ctx: PluginContext<SelectionState, SelectionAction>): SelectionCapability;
+declare const selectionPlugin: () => import("@embedpdf/core").PluginDef<SelectionState, SelectionAction, SelectionHostCapability>;
 //#endregion
-//#region src/handler.d.ts
+//#region src/index.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
+ * The selection capability token, narrowed to the public
+ * {@link SelectionCapability} lens. It is the SAME runtime token the plugin
+ * provides — the host-only surface (pointer gestures, geometry warming) is
+ * reachable only via `@embedpdf/plugin-selection/internal`.
  */
-declare function createTextSelectHandler(selection: SelectionCapability, interaction: InteractionCapability): InteractionHandler;
-//#endregion
-//#region src/reducer.d.ts
-declare const initialSelectionState: SelectionState;
-declare const selectionReducer: (state: SelectionState, action: SelectionAction) => SelectionState;
+declare const SelectionToken: CapabilityToken<SelectionCapability>;
 //#endregion
-export { type GlyphPointer, type SelectionAction, type SelectionCapability, type SelectionEndpoint, type SelectionPageGeometry, type SelectionRange, type SelectionSegment, type SelectionSnapshot, type SelectionState, SelectionToken, buildSelectionPageGeometry, contentPointToPdf, createSelectionCapability, createTextSelectHandler, initialSelectionState, selectionPlugin, selectionReducer, toContentSegment, toContentTextQuad };
+export { type SelectionCapability, type SelectionEndpoint, type SelectionMenuAnchor, type SelectionRangeInput, type SelectionSegment, type SelectionSnapshot, SelectionToken, type TextPosition, type TextRange, selectionPlugin };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,185 +1,26 @@
-import { PageObjectNumber, PluginContext } from "@embedpdf/core";
-import { InteractionCapability, InteractionHandler } from "@embedpdf/plugin-interaction";
-import { Mat2D, Point, Rect, TextQuad } from "@embedpdf/core-geometry";
-import { PageGeometrySnapshot, PageTextLayout, PdfPoint, PdfQuad, PdfRect, PdfTextSegment } from "@embedpdf/engine-core/runtime";
-//#region src/geometry.d.ts
-/**
- * One merged visual line of a selection, in content space — the structural
- * twin of the engine's `PdfTextSegment`. `quad` carries frame-geometric
- * corner semantics (upper = ascent side, start = the frame's −x); `advance`
- * is the READING direction along the baseline (+1 = toward `end`), derived
- * from the glyph sequence — geometry and bidi stay separate concerns.
- * `rect` is the content-space AABB.
- */
-interface SelectionSegment {
-  quad: TextQuad;
-  rect: Rect;
-  advance: 1 | -1;
-}
-/** A page's cached selection geometry: the canonical layout + the seam. */
-interface SelectionPageGeometry {
-  layout: PageTextLayout;
-  toContent: Mat2D<'pdf', 'content'>;
-  fromContent: Mat2D<'content', 'pdf'>;
-}
-/**
- * Build a page's selection geometry. Page display rotation does NOT enter
- * here — the overlay rides the page's CSS rotation, so content space stays
- * un-rotated (the crop-relative y-flip is the only conversion; zoom = 1,
- * the viewer's zoom is applied later by `PageTransform.pageToContent`).
- */
-declare function buildSelectionPageGeometry(snapshot: PageGeometrySnapshot, crop: PdfRect, rotation: 0 | 90 | 180 | 270, userUnit: number): SelectionPageGeometry;
-/** A content-space pointer point in the layout's PDF space. */
-declare function contentPointToPdf(geom: SelectionPageGeometry, p: Point): PdfPoint;
-/**
- * A canonical PDF quad in content space. Engine quads carry frame-geometric
- * slot semantics (`p1..p4` = upper-start, upper-end, lower-start,
- * lower-end) — a trusted producer, so the y-flip maps corners straight onto
- * their names; imported-annotation normalization does NOT apply here.
- */
-declare function toContentTextQuad(geom: SelectionPageGeometry, quad: PdfQuad): TextQuad;
-/** A canonical segment in content space (`rect` recomputed from the mapped
- *  quad so the pair can never drift). */
-declare function toContentSegment(geom: SelectionPageGeometry, segment: PdfTextSegment): SelectionSegment;
-//#endregion
-//#region src/types.d.ts
-/** A glyph address: a page + a flat glyph index within that page's geometry. */
-interface GlyphPointer {
-  pon: PageObjectNumber;
-  glyph: number;
-}
-/** Anchor = where the drag began, focus = the current end. Inclusive. */
-interface SelectionRange {
-  anchor: GlyphPointer;
-  focus: GlyphPointer;
-}
-/**
- * A selection boundary, anchored to the boundary GLYPH's own oriented cell.
- * `advance` is the reading direction of the segment it belongs to (+1 = the
- * frame's +x), so caret consumers place at the trailing edge without
- * re-deriving bidi from geometry. `rect` is the AABB (scroll targets).
- */
-interface SelectionEndpoint {
-  pon: PageObjectNumber;
-  glyphQuad: TextQuad;
-  advance: 1 | -1;
-  rect: Rect;
-}
-interface SelectionSnapshot {
-  /** Per-page canonical segments — the ONE geometry consumers act on.
-   *  Boxes are derived views (`segment.rect`, or `rectsForPage()`). */
-  pages: Array<{
-    pon: PageObjectNumber;
-    segments: SelectionSegment[];
-  }>;
-  start: SelectionEndpoint | null;
-  end: SelectionEndpoint | null;
-  direction: 'forward' | 'backward';
-}
-interface SelectionState {
-  selection: SelectionRange | null;
-  /** Derived per-line segments per page, in CONTENT space (y-down, PDF units). */
-  segments: Record<number, SelectionSegment[]>;
-  /** Pages whose text geometry has loaded (so the layer re-renders when ready). */
-  loaded: Record<number, boolean>;
-  /** When a consumer owns the selection visual (e.g. a markup tool draws its own
-   *  preview), the default highlight rects are suppressed. */
-  highlightHidden: boolean;
-}
-type SelectionAction = {
-  type: 'PAGE_LOADED';
-  pon: PageObjectNumber;
-} | {
-  type: 'SET';
-  selection: SelectionRange;
-  segments: Record<number, SelectionSegment[]>;
-} | {
-  type: 'CLEAR';
-} | {
-  type: 'SET_HIGHLIGHT_HIDDEN';
-  hidden: boolean;
-};
-interface SelectionCapability {
-  /** Warm a page's text geometry (idempotent). Layers call this when a page mounts. */
-  ensurePage(pon: PageObjectNumber): void;
-  isLoaded(pon: PageObjectNumber): boolean;
-  /** Is a content-space point on (or near) text? Drives the I-beam vs pointer cursor. */
-  isOverText(pon: PageObjectNumber, point: Point): boolean;
-  /** Begin a caret selection at a page point. Returns false if not near any text. */
-  beginAt(pon: PageObjectNumber, point: Point): boolean;
-  /** Double-click: select the word around the point. */
-  selectWord(pon: PageObjectNumber, point: Point): void;
-  /** Triple-click: select the whole visual line around the point. */
-  selectLine(pon: PageObjectNumber, point: Point): void;
-  /** Extend the current selection to a page point (drag). */
-  extendTo(pon: PageObjectNumber, point: Point): void;
-  end(): void;
-  clear(): void;
-  /** Coherent read-model for consumers that create annotations or selection UI. */
-  snapshot(): SelectionSnapshot;
-  /** Per-line oriented segments for a page, in content space — the layer's input. */
-  segmentsForPage(pon: PageObjectNumber): SelectionSegment[];
-  /** The segments' AABBs — for consumers that genuinely want boxes (scroll,
-   *  conservative regions). Never a substitute for the oriented quads in
-   *  geometry that gets drawn or persisted. */
-  rectsForPage(pon: PageObjectNumber): Rect[];
-  hasSelection(): boolean;
-  /** The pages the current selection covers (those with at least one rect) — so a
-   *  cross-page action (e.g. text-markup creation) can fan out per page. */
-  selectedPages(): PageObjectNumber[];
-  /** Fires whenever the selection rects change (e.g. drag-extend) — for live preview. */
-  onChange(cb: () => void): () => void;
-  /** Fires when a selection gesture ends (pointer-up) — the commit point. */
-  onCommit(cb: () => void): () => void;
-  /** Suppress / restore the default highlight visual (a consumer drawing its own). */
-  setHighlightVisible(visible: boolean): void;
-  highlightVisible(): boolean;
-}
-declare const SelectionToken: import("@embedpdf/core").CapabilityToken<SelectionCapability>;
-//#endregion
+import { a as SelectionHostCapability, c as SelectionRangeInput, f as TextPosition, h as SelectionSegment, i as SelectionEndpoint, l as SelectionSnapshot, n as SelectionAction, o as SelectionMenuAnchor, p as TextRange, r as SelectionCapability, u as SelectionState } from "./types-DtWaZIsm.js";
+import { CapabilityToken } from "@embedpdf/core";
 //#region src/selection.plugin.d.ts
 /**
  * Text selection — document-scoped, requires the interaction hub. In `init` it
  * registers ITS pointer handler with the hub; the hub owns the pointer stream
  * and arbitration. Works with `<Stage>` or a standalone `<PageView>` — selection
  * only needs the page coordinate context + the engine's text geometry.
- */
-declare const selectionPlugin: () => import("@embedpdf/core").PluginDef<SelectionState, SelectionAction, SelectionCapability>;
-//#endregion
-//#region src/capability.d.ts
-/**
- * The selection capability. The reducer state holds the selection range, the
- * derived content-space segments (per page), and per-page loaded flags; the
- * (large, non-serializable) per-page canonical layout is cached HERE in the
- * closure. Segmentation itself is the engine-core text layout — selection
- * owns gestures and state, never how glyphs become lines.
  *
- * 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 and re-runs whenever a mid-span page finishes loading.
+ * Registry/content invalidation is wired inside the capability itself
+ * (revision watch + document event subscription), so headless/programmatic
+ * use gets the same reconciliation as the full viewer.
  */
-declare function createSelectionCapability(ctx: PluginContext<SelectionState, SelectionAction>): SelectionCapability;
+declare const selectionPlugin: () => import("@embedpdf/core").PluginDef<SelectionState, SelectionAction, SelectionHostCapability>;
 //#endregion
-//#region src/handler.d.ts
+//#region src/index.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
+ * The selection capability token, narrowed to the public
+ * {@link SelectionCapability} lens. It is the SAME runtime token the plugin
+ * provides — the host-only surface (pointer gestures, geometry warming) is
+ * reachable only via `@embedpdf/plugin-selection/internal`.
  */
-declare function createTextSelectHandler(selection: SelectionCapability, interaction: InteractionCapability): InteractionHandler;
-//#endregion
-//#region src/reducer.d.ts
-declare const initialSelectionState: SelectionState;
-declare const selectionReducer: (state: SelectionState, action: SelectionAction) => SelectionState;
+declare const SelectionToken: CapabilityToken<SelectionCapability>;
 //#endregion
-export { type GlyphPointer, type SelectionAction, type SelectionCapability, type SelectionEndpoint, type SelectionPageGeometry, type SelectionRange, type SelectionSegment, type SelectionSnapshot, type SelectionState, SelectionToken, buildSelectionPageGeometry, contentPointToPdf, createSelectionCapability, createTextSelectHandler, initialSelectionState, selectionPlugin, selectionReducer, toContentSegment, toContentTextQuad };
+export { type SelectionCapability, type SelectionEndpoint, type SelectionMenuAnchor, type SelectionRangeInput, type SelectionSegment, type SelectionSnapshot, SelectionToken, type TextPosition, type TextRange, selectionPlugin };
 //# sourceMappingURL=index.d.ts.map