@embedpdf/react 3.0.0-next.13 → 3.0.0-next.15

package/dist/selection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"selection.cjs","names":["usePage","useCapability","SelectionHostToken","useSelector","shallowArray","SelectionToken","Anchored","StageToken","useOptionalCapability","HANDLE_PAD","HANDLE_HEAD","HANDLE_BAR"],"sources":["../src/selection.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-selection.\n *\n * <SelectionLayer> is a dumb renderer: it warms the page's geometry on mount,\n * reads the content-space highlight rects from the capability, and paints them —\n * mapping each rect through PageContext.toPixels (the same path markers use).\n * Zero pointer handling here; that's the PagePointerSource + the hub.\n *\n * The layer resolves the HOST lens (`/internal`: geometry warming, the\n * highlight handshake) — the adapter is exactly what that entry exists for.\n * `useSelection()` hands app code the PUBLIC lens only.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-selection';\n// The clipboard side effect lives in @embedpdf/web (the plugin is DOM-free);\n// re-exported here so app code has one import for the whole feature.\nexport { copySelection } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { textQuadEquals } from '@embedpdf/core-geometry';\nimport type { CapabilityToken } from '@embedpdf/core';\nimport {\n  HANDLE_BAR,\n  HANDLE_HEAD,\n  HANDLE_PAD,\n  SelectionToken,\n  createSelectionHandleDrag,\n  selectionHandleGeom,\n  type SelectionHandleEndpoint,\n  type SelectionHandleView,\n  type SelectionMenuAnchor,\n} from '@embedpdf/plugin-selection';\nimport { SelectionToken as SelectionHostToken } from '@embedpdf/plugin-selection/internal';\nimport { StageToken, type StageCapability } from '@embedpdf/plugin-stage/contract';\nimport {\n  attachSelectionHandle,\n  wireSelectionClipboard,\n  type SelectionClipboardOptions,\n} from '@embedpdf/web';\nimport { Anchored, type AnchoredPlacement } from './anchored';\nimport {\n  shallowArray,\n  useCapability,\n  useKernelValue,\n  useOptionalCapability,\n  usePage,\n  useSelector,\n} from './runtime';\n\nexport interface SelectionLayerProps {\n  /** Highlight colour (default: translucent blue). */\n  color?: string;\n}\n\nexport function SelectionLayer({ color = 'rgba(33, 150, 243, 0.35)' }: SelectionLayerProps) {\n  const page = usePage();\n  const selection = useCapability(SelectionHostToken);\n  const segments = useSelector(\n    SelectionHostToken,\n    (c) => c.segmentsForPage(page.pon),\n    shallowArray,\n  );\n  // A consumer (e.g. a markup tool drawing its own preview) can take over the\n  // selection visual; when it does, we render nothing so the two never overlap.\n  const visible = useSelector(SelectionHostToken, (c) => c.highlightVisible());\n\n  // Warm this page's text geometry as soon as it's on screen, so the first\n  // pointer-down can hit-test without waiting on the engine round-trip.\n  // (A no-op without doc.text.select — nothing warms, nothing renders.)\n  useEffect(() => {\n    selection.ensurePage(page.pon);\n  }, [selection, page.pon]);\n\n  if (!visible) return null;\n\n  return (\n    <svg\n      style={{\n        position: 'absolute',\n        inset: 0,\n        width: '100%',\n        height: '100%',\n        overflow: 'visible',\n        pointerEvents: 'none',\n      }}\n    >\n      {segments.map((s, i) => {\n        // content space → un-rotated content view px (rides the page's CSS\n        // rotation). An affine map, so mapping the four corners is exact —\n        // upright segments render pixel-identical to the old div-per-rect.\n        const ring = [s.quad.upperStart, s.quad.upperEnd, s.quad.lowerEnd, s.quad.lowerStart].map(\n          (p) => page.transform.toPixels(p),\n        );\n        return (\n          <polygon key={i} points={ring.map((p) => `${p.x},${p.y}`).join(' ')} fill={color} />\n        );\n      })}\n    </svg>\n  );\n}\n\n/** The PUBLIC selection capability (select(), readText(), canCopy(), …) for\n *  app chrome — toolbars, context menus, automation. */\nexport function useSelection() {\n  return useCapability(SelectionToken);\n}\n\n/** Structural equality for the selection's menu anchor — keeps the menu from\n *  re-rendering on unrelated dispatches (the capability returns a fresh\n *  object each call). */\nconst sameMenuAnchor = (\n  a: SelectionMenuAnchor | null,\n  b: SelectionMenuAnchor | null,\n): boolean => {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.pon === b.pon &&\n    a.bounds.x === b.bounds.x &&\n    a.bounds.y === b.bounds.y &&\n    a.bounds.width === b.bounds.width &&\n    a.bounds.height === b.bounds.height\n  );\n};\n\nexport interface SelectionMenuProps {\n  children: React.ReactNode;\n  /** Gap in screen px between the selection and the menu (default 8). */\n  gap?: number;\n  /** Where to place the menu relative to the selection. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/**\n * Floats over the current TEXT selection (one anchor regardless of\n * cross-page selection; it rides the gesture's end page) — and only once the\n * selection SETTLES: hidden while `isSelecting()` (mid-drag), it appears at\n * pointer-up; programmatic selections show immediately (born settled). Works\n * under `<Stage>` (mount in the overlay slot) and `<PageView>` alike — the\n * surface provides the projection. Compose the contents from hooks:\n * `useSelection()` for copy/clear, `useAnnotation()` for\n * `markupFromSelection('highlight')`, `copySelection` for the clipboard.\n * For live-follow UI during the drag, compose `<Anchored>` with\n * `menuAnchor()` yourself — the primitive carries no policy.\n */\nexport function SelectionMenu({ children, gap = 8, placement = 'top' }: SelectionMenuProps) {\n  const selecting = useSelector(SelectionToken, (c) => c.isSelecting());\n  const anchor = useSelector(SelectionToken, (c) => c.menuAnchor(), sameMenuAnchor);\n  if (selecting || !anchor) return null;\n  return (\n    <Anchored anchor={anchor} placement={placement} gap={gap}>\n      {children}\n    </Anchored>\n  );\n}\n\n// ── selection handles (the touch affordance) ────────────────────────────────\n//\n// Policy lives out of this file, per the layering razor: the geometry and the\n// drag session are `@embedpdf/plugin-selection`'s pure `handles` module (one\n// source for every adapter), the native listener mechanics are\n// `@embedpdf/web`'s `attachSelectionHandle` (the down-shield timing subtlety\n// lives ONCE), and this component keeps what only React can do —\n// subscriptions, markup, theming.\n\ninterface Endpoints {\n  start: SelectionHandleEndpoint;\n  end: SelectionHandleEndpoint;\n}\nconst sameEndpoints = (a: Endpoints | null, b: Endpoints | null): boolean => {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.start.pon === b.start.pon &&\n    a.end.pon === b.end.pon &&\n    a.start.advance === b.start.advance &&\n    a.end.advance === b.end.advance &&\n    // corner-wise, so a boundary that ROTATES without moving its bounding box\n    // still re-renders (an AABB comparison would call that \"unchanged\")\n    textQuadEquals(a.start.glyphQuad, b.start.glyphQuad) &&\n    textQuadEquals(a.end.glyphQuad, b.end.glyphQuad)\n  );\n};\n\n/** The plugin's structural view over this Stage: point-exact projection in,\n *  page resolution out. (`pageRectToScreen` is the AABB projector — upright\n *  overlays only — and would collapse exactly the orientation handles need.) */\nconst handleView = (stage: StageCapability): SelectionHandleView => ({\n  toOverlay: (pon, pt) => {\n    const world = stage.pageToWorld(pon, pt);\n    return world ? stage.toScreen(world) : null;\n  },\n  pageAt: (overlay) => stage.pageAt(overlay),\n  pointOnPage: (pon, overlay) => stage.pointOnPage(pon, overlay),\n});\n\nexport interface SelectionHandlesProps {\n  /** Handle colour (default: the selection blue). */\n  color?: string;\n  /** The stage lens hosting this overlay (default: the main StageToken). */\n  token?: CapabilityToken<StageCapability>;\n}\n\n/**\n * iOS-style draggable selection handles. Each is drawn the way the platform\n * draws them: a thin caret BAR that forms the selection's own start/end edge\n * — the boundary glyph's oriented edge, so rotated text and rotated pages\n * carry the handle with them — capped by a screen-constant circle, above the\n * first line at the start, below the last line at the end.\n *\n * On touch, where a caret drag isn't available, the handles ARE the way to\n * grow or shrink a selection: a long-press selects a word, then each handle\n * extends from the OPPOSITE endpoint, snapping to glyphs and crossing pages\n * exactly like a pointer drag — it rides the same `beginAt`/`extendTo`\n * gesture path, so highlights, menus, and commit signals all behave\n * identically. Mount in the `<Stage>` overlay slot next to `<SelectionMenu>`;\n * outside a Stage it renders nothing (a `PageView` has no camera to project\n * through). Pointer-isolated, so grabbing a handle never pans the stage.\n */\nexport function SelectionHandles({ color = '#2196f3', token = StageToken }: SelectionHandlesProps) {\n  const host = useCapability(SelectionHostToken);\n  const stage = useOptionalCapability(token);\n  const selecting = useSelector(SelectionToken, (c) => c.isSelecting());\n  const visible = useSelector(SelectionHostToken, (c) => c.highlightVisible());\n  const endpoints = useSelector(\n    SelectionHostToken,\n    (c): Endpoints | null => {\n      const s = c.snapshot();\n      if (!s.start || !s.end) return null;\n      return {\n        start: { pon: s.start.pon, glyphQuad: s.start.glyphQuad, advance: s.start.advance },\n        end: { pon: s.end.pon, glyphQuad: s.end.glyphQuad, advance: s.end.advance },\n      };\n    },\n    sameEndpoints,\n  );\n  // The handles are positioned by PROJECTING the endpoint corners through the\n  // camera, so they must re-render whenever the camera moves — visiblePages is\n  // the stage's reference-stable revision for exactly that (the same value the\n  // page surfaces re-render on, so handle and highlight move in one commit).\n  useKernelValue(() => stage?.visiblePages() ?? null);\n  const [dragging, setDragging] = useState<'start' | 'end' | null>(null);\n  // The web binder's `arm` must read the CURRENT endpoints/stage at pointer\n  // down, not the ones captured when the listener attached — a stable ref\n  // callback with a live arm-source is the standard escape from that.\n  const armSource = useRef<{ stage: StageCapability; endpoints: Endpoints } | null>(null);\n  armSource.current = stage && endpoints ? { stage, endpoints } : null;\n  const bindHandle = useMemo(() => {\n    const detach: Partial<Record<'start' | 'end', () => void>> = {};\n    const make = (role: 'start' | 'end') => (el: HTMLDivElement | null) => {\n      detach[role]?.();\n      delete detach[role];\n      if (!el) return;\n      detach[role] = attachSelectionHandle(el, {\n        arm: () => {\n          const src = armSource.current;\n          if (!src) return null;\n          const view = handleView(src.stage);\n          const geom = selectionHandleGeom(view, src.endpoints[role], role);\n          if (!geom) return null;\n          const opposite = src.endpoints[role === 'start' ? 'end' : 'start'];\n          const drag = createSelectionHandleDrag(\n            host,\n            view,\n            opposite,\n            src.endpoints[role].pon,\n          );\n          setDragging(role);\n          return {\n            // the point the user grabbed: the bar's midpoint\n            base: {\n              x: (geom.bar.from.x + geom.bar.to.x) / 2,\n              y: (geom.bar.from.y + geom.bar.to.y) / 2,\n            },\n            session: {\n              move: drag.move,\n              end: () => {\n                drag.end(); // settle → menu reappears, onCommit fires\n                setDragging(null);\n              },\n            },\n          };\n        },\n      });\n    };\n    return { start: make('start'), end: make('end') };\n  }, [host]);\n\n  if (!stage || !endpoints || !visible) return null;\n  // Hidden while a pointer drag-select is in flight (like the menu) — but a\n  // HANDLE drag is itself a selection gesture, so it keeps its handles.\n  if (selecting && !dragging) return null;\n  const view = handleView(stage);\n\n  const renderHandle = (role: 'start' | 'end') => {\n    const geom = selectionHandleGeom(view, endpoints[role], role);\n    if (!geom) return null; // endpoint page not laid out right now\n    // The shell is laid out UPRIGHT in its own frame — bar of the edge's\n    // length, head stacked above (start) or below (end) — then rotated onto\n    // the projected edge. The pivot is the bar's ascent-side tip, the one\n    // point that must land exactly on the glyph corner.\n    const barTop = HANDLE_PAD + (role === 'start' ? HANDLE_HEAD : 0);\n    const pivotX = HANDLE_PAD + HANDLE_BAR / 2;\n    return (\n      <div\n        key={role}\n        ref={bindHandle[role]}\n        style={{\n          position: 'absolute',\n          left: geom.bar.from.x - pivotX,\n          top: geom.bar.from.y - barTop,\n          width: HANDLE_BAR + 2 * HANDLE_PAD,\n          height: geom.length + HANDLE_HEAD + 2 * HANDLE_PAD,\n          // Upright text carries NO transform — pixel-identical to an\n          // axis-aligned box (the geometry's float-noise guard decides).\n          ...(geom.upright\n            ? null\n            : {\n                transform: `rotate(${geom.rotation}deg)`,\n                transformOrigin: `${pivotX}px ${barTop}px`,\n              }),\n          touchAction: 'none',\n          cursor: 'grab',\n          pointerEvents: 'auto',\n        }}\n      >\n        {/* the caret bar — the selection's own edge, spanning the glyph's ink\n            height (which is why it stays the text's height at any tilt) */}\n        <div\n          style={{\n            position: 'absolute',\n            left: HANDLE_PAD,\n            top: barTop,\n            width: HANDLE_BAR,\n            height: geom.length,\n            background: color,\n            borderRadius: HANDLE_BAR / 2,\n          }}\n        />\n        {/* the head — flush against the bar, beyond the ascent at the start and\n            past the baseline at the end, in the TEXT's frame */}\n        <div\n          style={{\n            position: 'absolute',\n            left: pivotX - HANDLE_HEAD / 2,\n            top: role === 'start' ? HANDLE_PAD : HANDLE_PAD + geom.length,\n            width: HANDLE_HEAD,\n            height: HANDLE_HEAD,\n            borderRadius: '50%',\n            background: color,\n            boxShadow: '0 1px 4px rgba(0, 0, 0, 0.35)',\n          }}\n        />\n      </div>\n    );\n  };\n\n  return (\n    <>\n      {renderHandle('start')}\n      {renderHandle('end')}\n    </>\n  );\n}\n\n\nexport type SelectionClipboardProps = Pick<SelectionClipboardOptions, 'prefetch'>;\n\n/**\n * Mount ONCE per viewer to wire clipboard copy: prefetches the selected text\n * when the selection settles, answers the native `copy` event synchronously,\n * and falls back to the async Clipboard API for ctrl/cmd+C when the page has\n * no DOM selection. Renders nothing. For a toolbar Copy button, call\n * `copySelection(useSelection())` from its click handler instead.\n */\nexport function SelectionClipboard({ prefetch }: SelectionClipboardProps = {}) {\n  const selection = useCapability(SelectionToken);\n  useEffect(\n    () => wireSelectionClipboard(selection, prefetch === undefined ? {} : { prefetch }),\n    [selection, prefetch],\n  );\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"selection.cjs","names":["usePage","useCapability","SelectionHostToken","useSelector","shallowArray","useViewerSettings","SelectionToken","stateHook","selectionState","settingsHook","samePageBounds","Anchored","useStageToken","useOptionalCapability","useOptionalProjectorBinding","sameSelectionEndpoints","HANDLE_PAD","HANDLE_HEAD","HANDLE_BAR"],"sources":["../src/selection.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-selection.\n *\n * <SelectionLayer> is a dumb renderer: it warms the page's geometry on mount,\n * reads the page-space highlight rects from the capability, and paints them —\n * mapping each rect through PageContext.toPixels (the same path markers use),\n * in the plugin's `color` setting, which the `--epdf-text-selection` CSS\n * variable overrides. Zero pointer handling here; that's the\n * PagePointerSource + the hub.\n *\n * The layer resolves the host lens (`/contract/host`: geometry warming, the\n * highlight handshake) — the adapter is exactly what that entry exists for.\n * `useSelection()` hands app code the public lens only.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-selection';\n// The clipboard side effect lives in @embedpdf/web (the plugin is DOM-free);\n// re-exported here so app code has one import for the whole feature.\nexport { copySelection } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useMemo, useRef, useState, type RefObject } from 'react';\nimport type { CapabilityToken, EventHook } from '@embedpdf/core';\nimport {\n  HANDLE_BAR,\n  HANDLE_HEAD,\n  HANDLE_PAD,\n  SelectionToken,\n  armSelectionHandle,\n  selectionHandleEndpointsOf,\n  selectionHandleGeom,\n  selectionHandleViewOf,\n  selectionState,\n  type SelectionHandleEndpoints,\n  type SelectionCapability,\n} from '@embedpdf/plugin-selection';\nimport { SelectionToken as SelectionHostToken } from '@embedpdf/plugin-selection/contract/host';\nimport type { StageCapability } from '@embedpdf/plugin-stage/contract';\nimport {\n  attachSelectionHandle,\n  mixAccent,\n  paint,\n  quadInPixels,\n  samePageBounds,\n  sameSelectionEndpoints,\n  svgPoints,\n  wireSelectionClipboard,\n  type SelectionClipboardOptions,\n} from '@embedpdf/web';\nimport { Anchored, useOptionalProjectorBinding, type AnchoredPlacement } from './anchored';\nimport { devWarn } from './dev';\nimport { useStageToken } from './stage-scope';\nimport {\n  shallowArray,\n  useCapability,\n  useCapabilityEvent,\n  useKernelValue,\n  useOptionalCapability,\n  usePage,\n  useSelector,\n  useViewerSettings,\n} from './runtime';\nimport { settingsHook, stateHook } from './state';\n\n/**\n * The highlight of the selected text on one page, in the selection plugin's\n * `color` setting; the `--epdf-text-selection` CSS variable wins over it.\n */\nexport function SelectionLayer() {\n  const page = usePage();\n  const selection = useCapability(SelectionHostToken);\n  const segments = useSelector(\n    SelectionHostToken,\n    (selection) => selection.listSegments(page.ref),\n    shallowArray,\n  );\n  // A consumer (e.g. a markup tool drawing its own preview) can take over the\n  // selection visual; when it does, we render nothing so the two never overlap.\n  const visible = useSelector(SelectionHostToken, (selection) => selection.isHighlightVisible());\n  const color = useSelectionSettings((settings) => settings.color);\n  // An unset color follows the viewer's accent, behind the `--epdf-accent` variable.\n  const accent = useViewerSettings((settings) => settings.accent);\n\n  // Warm this page's text geometry as soon as it's on screen, so the first\n  // pointer-down can hit-test without waiting on the engine round-trip.\n  // (A no-op without doc.text.select — nothing warms, nothing renders.)\n  useEffect(() => {\n    void selection.ensureLoaded(page.ref);\n  }, [selection, page.ref]);\n\n  if (!visible) return null;\n\n  // Unset, the color is the accent at 35%, the accent variables included.\n  const fill = paint('text-selection', color ?? mixAccent('text-selection', accent));\n\n  return (\n    <svg\n      style={{\n        position: 'absolute',\n        inset: 0,\n        width: '100%',\n        height: '100%',\n        overflow: 'visible',\n        pointerEvents: 'none',\n      }}\n    >\n      {segments.map((segment, i) => (\n        // Page space → the page layer's pixels, which ride the page's CSS\n        // rotation: mapping the four corners is exact, for turned text too.\n        <polygon\n          key={i}\n          points={svgPoints(quadInPixels(segment.quad, page.transform))}\n          // In `style`: an SVG attribute doesn't read var().\n          style={{ fill }}\n        />\n      ))}\n    </svg>\n  );\n}\n\n/** The public selection capability (select(), readText(), canCopy(), …) for\n *  app chrome — toolbars, context menus, automation. */\nexport function useSelection() {\n  return useCapability(SelectionToken);\n}\n\n/** Subscribe to one selection event for the mounted lifetime: `useSelectionEvent((selection) => selection.onCommitted, handler)`. */\nexport function useSelectionEvent<T>(\n  select: (selection: SelectionCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(SelectionToken, select, handler);\n}\n\n/**\n * The selection's state: whether anything is selected, whether the user is\n * still selecting, the character range and the pages it's on (the page's State\n * table, declared once in `selectionState`). Takes a selector, re-renders only\n * when what it returns changes, and returns the empty state without a document.\n */\nexport const useSelectionState = stateHook(selectionState);\n\n/** The selection settings (`dragThreshold`, `color`, `handles`), with or without a document. Takes a selector. */\nexport const useSelectionSettings = settingsHook(SelectionToken);\n\nexport interface SelectionMenuProps {\n  children: React.ReactNode;\n  /** Gap in screen px between the selection and the menu (default 8). */\n  gap?: number;\n  /** Where to place the menu relative to the selection. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/**\n * Floats over the current text selection (one anchor regardless of\n * cross-page selection; it rides the gesture's end page) — and only once the\n * selection settles: hidden while a gesture is active (mid-drag), it appears at\n * pointer-up; programmatic selections show immediately (born settled). Works\n * under `<Stage>` (mount in the overlay slot) and `<PageView>` alike — the\n * surface provides the projection. Compose the contents from hooks:\n * `useSelection()` for copy/clear, `useAnnotation()` for\n * `markupFromSelection('highlight')`, `copySelection` for the clipboard.\n * For live-follow UI during the drag, compose `<Anchored>` with\n * `getAnchor()` yourself — the primitive carries no policy.\n */\nexport function SelectionMenu({ children, gap = 8, placement = 'top' }: SelectionMenuProps) {\n  const selecting = useSelectionState((state) => state.isSelecting);\n  // The capability returns a fresh anchor on every read: compare by value, so\n  // the menu re-renders only when the selection moved.\n  const anchor = useSelector(SelectionToken, (selection) => selection.getAnchor(), samePageBounds);\n  if (selecting || !anchor) return null;\n  return (\n    <Anchored anchor={anchor} placement={placement} gap={gap}>\n      {children}\n    </Anchored>\n  );\n}\n\n// ── selection handles (the touch affordance) ────────────────────────────────\n//\n// Policy lives out of this file, per the layering razor: the view over the\n// Stage, the endpoints, the geometry and the armed drag are\n// `@embedpdf/plugin-selection`'s pure `handles` module (one source for every\n// adapter), the native listener mechanics are\n// `@embedpdf/web`'s `attachSelectionHandle` (the down-shield timing subtlety\n// lives once), and this component keeps what only React can do —\n// subscriptions, markup, theming.\n\nexport interface SelectionHandlesProps {\n  /** The stage lens hosting this overlay (default: the enclosing `<Stage>`'s lens). */\n  token?: CapabilityToken<StageCapability>;\n}\n\n/**\n * iOS-style draggable selection handles. Each is drawn the way the platform\n * draws them: a thin caret bar that forms the selection's own start/end edge\n * — the boundary glyph's oriented edge, so rotated text and rotated pages\n * carry the handle with them — capped by a screen-constant circle, above the\n * first line at the start, below the last line at the end.\n *\n * On touch, where a caret drag isn't available, the handles are the way to\n * grow or shrink a selection: a long-press selects a word, then each handle\n * extends from the opposite endpoint, snapping to glyphs and crossing pages\n * exactly like a pointer drag — it rides the same `beginGestureAt`/`extendTo`\n * gesture path, so highlights, menus, and commit signals all behave\n * identically. Mount in the `<Stage>` overlay slot next to `<SelectionMenu>`;\n * outside a Stage it renders nothing (a `PageView` has no camera to project\n * through). Pointer-isolated, so grabbing a handle never pans the stage.\n * Painted in the plugin's `handles` setting, which the\n * `--epdf-text-selection-handle` and `--epdf-text-selection-handle-shadow` CSS\n * variables override.\n */\nexport function SelectionHandles({ token: explicitToken }: SelectionHandlesProps = {}) {\n  const token = useStageToken(explicitToken);\n  const host = useCapability(SelectionHostToken);\n  const stage = useOptionalCapability(token);\n  // Outside a Stage there is no camera to project through: say so instead of\n  // rendering nothing silently.\n  const surface = useOptionalProjectorBinding();\n  if (!surface || surface.projector.space !== 'overlay') {\n    devWarn(\n      'selection-handles-outside-stage',\n      '<SelectionHandles> renders nothing here: mount it in the <Stage> overlay slot ' +\n        '(a <PageView> has no camera to project the handles through).',\n    );\n  }\n  const selecting = useSelectionState((state) => state.isSelecting);\n  const visible = useSelector(SelectionHostToken, (selection) => selection.isHighlightVisible());\n  const handles = useSelectionSettings((settings) => settings.handles);\n  const accent = useViewerSettings((settings) => settings.accent);\n  const endpoints = useSelector(\n    SelectionHostToken,\n    (selection) => selectionHandleEndpointsOf(selection.getSnapshot()),\n    sameSelectionEndpoints,\n  );\n  // The handles are positioned by projecting the endpoint corners through the\n  // camera, so they must re-render whenever the camera moves — visiblePages is\n  // the stage's reference-stable revision for exactly that (the same value the\n  // page surfaces re-render on, so handle and highlight move in one commit).\n  useKernelValue(() => stage?.listVisiblePages() ?? null);\n  const [dragging, setDragging] = useState<'start' | 'end' | null>(null);\n  // The web binder's `arm` must read the current endpoints/stage at pointer\n  // down, not the ones captured when the listener attached — a stable ref\n  // callback with a live arm-source is the standard escape from that.\n  const armSource = useRef<{ stage: StageCapability; endpoints: SelectionHandleEndpoints } | null>(\n    null,\n  );\n  armSource.current = stage && endpoints ? { stage, endpoints } : null;\n  const bindHandle = useMemo(() => {\n    const detach: Partial<Record<'start' | 'end', () => void>> = {};\n    const make = (role: 'start' | 'end') => (element: HTMLDivElement | null) => {\n      detach[role]?.();\n      delete detach[role];\n      if (!element) return;\n      detach[role] = attachSelectionHandle(element, {\n        arm: () => {\n          const src = armSource.current;\n          if (!src) return null;\n          const armed = armSelectionHandle(\n            host,\n            selectionHandleViewOf(src.stage),\n            src.endpoints,\n            role,\n          );\n          if (!armed) return null;\n          setDragging(role);\n          return {\n            // the point the user grabbed: the bar's midpoint\n            base: armed.base,\n            session: {\n              move: armed.drag.move,\n              end: () => {\n                armed.drag.end(); // settle → menu reappears, onCommitted fires\n                setDragging(null);\n              },\n            },\n          };\n        },\n      });\n    };\n    return { start: make('start'), end: make('end') };\n  }, [host]);\n\n  if (!stage || !endpoints || !visible) return null;\n  // Hidden while a pointer drag-select is in flight (like the menu) — but a\n  // handle drag is itself a selection gesture, so it keeps its handles.\n  if (selecting && !dragging) return null;\n  const view = selectionHandleViewOf(stage);\n  // Each is its CSS variable first, then the setting; an unset color is the accent.\n  const color = paint('text-selection-handle', handles.color ?? accent);\n  const shadow = paint('text-selection-handle-shadow', handles.shadow);\n\n  const renderHandle = (role: 'start' | 'end') => {\n    const geometry = selectionHandleGeom(view, endpoints[role], role);\n    if (!geometry) return null; // endpoint page not laid out right now\n    // The shell is laid out upright in its own frame — bar of the edge's\n    // length, head stacked above (start) or below (end) — then rotated onto\n    // the projected edge. The pivot is the bar's ascent-side tip, the one\n    // point that must land exactly on the glyph corner.\n    const barTop = HANDLE_PAD + (role === 'start' ? HANDLE_HEAD : 0);\n    const pivotX = HANDLE_PAD + HANDLE_BAR / 2;\n    return (\n      <div\n        key={role}\n        ref={bindHandle[role]}\n        style={{\n          position: 'absolute',\n          left: geometry.bar.from.x - pivotX,\n          top: geometry.bar.from.y - barTop,\n          width: HANDLE_BAR + 2 * HANDLE_PAD,\n          height: geometry.length + HANDLE_HEAD + 2 * HANDLE_PAD,\n          // Upright text carries no transform — pixel-identical to an\n          // axis-aligned box (the geometry's float-noise guard decides).\n          ...(geometry.upright\n            ? null\n            : {\n                transform: `rotate(${geometry.rotation}deg)`,\n                transformOrigin: `${pivotX}px ${barTop}px`,\n              }),\n          touchAction: 'none',\n          cursor: 'grab',\n          pointerEvents: 'auto',\n        }}\n      >\n        {/* the caret bar — the selection's own edge, spanning the glyph's ink\n            height (which is why it stays the text's height at any tilt) */}\n        <div\n          style={{\n            position: 'absolute',\n            left: HANDLE_PAD,\n            top: barTop,\n            width: HANDLE_BAR,\n            height: geometry.length,\n            background: color,\n            borderRadius: HANDLE_BAR / 2,\n          }}\n        />\n        {/* the head — flush against the bar, beyond the ascent at the start and\n            past the baseline at the end, in the TEXT's frame */}\n        <div\n          style={{\n            position: 'absolute',\n            left: pivotX - HANDLE_HEAD / 2,\n            top: role === 'start' ? HANDLE_PAD : HANDLE_PAD + geometry.length,\n            width: HANDLE_HEAD,\n            height: HANDLE_HEAD,\n            borderRadius: '50%',\n            background: color,\n            boxShadow: shadow,\n          }}\n        />\n      </div>\n    );\n  };\n\n  return (\n    <>\n      {renderHandle('start')}\n      {renderHandle('end')}\n    </>\n  );\n}\n\nexport interface SelectionClipboardProps\n  extends Pick<SelectionClipboardOptions, 'prefetch' | 'onRefused'> {\n  /**\n   * Copy only while focus is inside this element, for a page with more than one viewer.\n   * Default: anywhere on the page.\n   */\n  target?: RefObject<HTMLElement | null>;\n}\n\n/**\n * Mount once per viewer to wire clipboard copy: prefetches the selected text\n * when the selection settles, answers the native `copy` event synchronously,\n * and falls back to the async Clipboard API for ctrl/cmd+C when the page has\n * no DOM selection. A selection the user may not copy isn't copied, and\n * `onRefused` is called. Renders nothing, and wires nothing until a document\n * is ready. For a toolbar Copy button, call `copySelection(useSelection())`\n * from its click handler instead.\n */\nexport function SelectionClipboard({ prefetch, onRefused, target }: SelectionClipboardProps = {}) {\n  const selection = useOptionalCapability(SelectionToken);\n  // The latest callback, so a new function each render doesn't wire the clipboard again.\n  const refused = useRef(onRefused);\n  refused.current = onRefused;\n  useEffect(() => {\n    // The element mounts before this effect runs, so its ref is set by now.\n    const element = target ? target.current : undefined;\n    if (!selection || element === null) return;\n    return wireSelectionClipboard(selection, {\n      ...(prefetch === undefined ? {} : { prefetch }),\n      ...(element ? { target: element } : {}),\n      onRefused: () => refused.current?.(),\n    });\n  }, [selection, prefetch, target]);\n  return null;\n}\n"],"mappings":"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"}

package/dist/selection.d.cts

@@ -1,18 +1,37 @@
-import { AnchoredPlacement as AnchoredPlacement$1 } from "./anchored.cjs";
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.cjs";
+import { r as AnchoredPlacement$1 } from "./anchored-DzN3JywS.cjs";
+import { CapabilityToken, EventHook } from "@embedpdf/core";
 import * as React from "react";
+import { RefObject } from "react";
 import { SelectionClipboardOptions, copySelection } from "@embedpdf/web";
-import { CapabilityToken } from "@embedpdf/core";
 import { StageCapability } from "@embedpdf/plugin-stage/contract";
+import { SelectionCapability } from "@embedpdf/plugin-selection";
 export * from "@embedpdf/plugin-selection";
 //#region src/selection.d.ts
-interface SelectionLayerProps {
-  /** Highlight colour (default: translucent blue). */
-  color?: string;
-}
-declare function SelectionLayer({ color }: SelectionLayerProps): import("react/jsx-runtime").JSX.Element | null;
-/** The PUBLIC selection capability (select(), readText(), canCopy(), …) for
+/**
+ * The highlight of the selected text on one page, in the selection plugin's
+ * `color` setting; the `--epdf-text-selection` CSS variable wins over it.
+ */
+declare function SelectionLayer(): import("react/jsx-runtime").JSX.Element | null;
+/** The public selection capability (select(), readText(), canCopy(), …) for
  *  app chrome — toolbars, context menus, automation. */
-declare function useSelection(): import("@embedpdf/plugin-selection").SelectionCapability;
+declare function useSelection(): SelectionCapability;
+/** Subscribe to one selection event for the mounted lifetime: `useSelectionEvent((selection) => selection.onCommitted, handler)`. */
+declare function useSelectionEvent<T>(select: (selection: SelectionCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The selection's state: whether anything is selected, whether the user is
+ * still selecting, the character range and the pages it's on (the page's State
+ * table, declared once in `selectionState`). Takes a selector, re-renders only
+ * when what it returns changes, and returns the empty state without a document.
+ */
+declare const useSelectionState: StateHook<{
+  hasSelection: boolean;
+  isSelecting: boolean;
+  range: import("@embedpdf/plugin-selection").TextRange | null;
+  pages: readonly import("@embedpdf/core").PageRef[];
+}>;
+/** The selection settings (`dragThreshold`, `color`, `handles`), with or without a document. Takes a selector. */
+declare const useSelectionSettings: SettingsHook<import("@embedpdf/plugin-selection").SelectionSettings>;
 interface SelectionMenuProps {
   children: React.ReactNode;
   /** Gap in screen px between the selection and the menu (default 8). */
@@ -21,50 +40,59 @@ interface SelectionMenuProps {
   placement?: AnchoredPlacement$1;
 }
 /**
- * Floats over the current TEXT selection (one anchor regardless of
+ * Floats over the current text selection (one anchor regardless of
  * cross-page selection; it rides the gesture's end page) — and only once the
- * selection SETTLES: hidden while `isSelecting()` (mid-drag), it appears at
+ * selection settles: hidden while a gesture is active (mid-drag), it appears at
  * pointer-up; programmatic selections show immediately (born settled). Works
  * under `<Stage>` (mount in the overlay slot) and `<PageView>` alike — the
  * surface provides the projection. Compose the contents from hooks:
  * `useSelection()` for copy/clear, `useAnnotation()` for
  * `markupFromSelection('highlight')`, `copySelection` for the clipboard.
  * For live-follow UI during the drag, compose `<Anchored>` with
- * `menuAnchor()` yourself — the primitive carries no policy.
+ * `getAnchor()` yourself — the primitive carries no policy.
  */
 declare function SelectionMenu({ children, gap, placement }: SelectionMenuProps): import("react/jsx-runtime").JSX.Element | null;
 interface SelectionHandlesProps {
-  /** Handle colour (default: the selection blue). */
-  color?: string;
-  /** The stage lens hosting this overlay (default: the main StageToken). */
+  /** The stage lens hosting this overlay (default: the enclosing `<Stage>`'s lens). */
   token?: CapabilityToken<StageCapability>;
 }
 /**
  * iOS-style draggable selection handles. Each is drawn the way the platform
- * draws them: a thin caret BAR that forms the selection's own start/end edge
+ * draws them: a thin caret bar that forms the selection's own start/end edge
  * — the boundary glyph's oriented edge, so rotated text and rotated pages
  * carry the handle with them — capped by a screen-constant circle, above the
  * first line at the start, below the last line at the end.
  *
- * On touch, where a caret drag isn't available, the handles ARE the way to
+ * On touch, where a caret drag isn't available, the handles are the way to
  * grow or shrink a selection: a long-press selects a word, then each handle
- * extends from the OPPOSITE endpoint, snapping to glyphs and crossing pages
- * exactly like a pointer drag — it rides the same `beginAt`/`extendTo`
+ * extends from the opposite endpoint, snapping to glyphs and crossing pages
+ * exactly like a pointer drag — it rides the same `beginGestureAt`/`extendTo`
  * gesture path, so highlights, menus, and commit signals all behave
  * identically. Mount in the `<Stage>` overlay slot next to `<SelectionMenu>`;
  * outside a Stage it renders nothing (a `PageView` has no camera to project
  * through). Pointer-isolated, so grabbing a handle never pans the stage.
+ * Painted in the plugin's `handles` setting, which the
+ * `--epdf-text-selection-handle` and `--epdf-text-selection-handle-shadow` CSS
+ * variables override.
  */
-declare function SelectionHandles({ color, token }: SelectionHandlesProps): import("react/jsx-runtime").JSX.Element | null;
-type SelectionClipboardProps = Pick<SelectionClipboardOptions, 'prefetch'>;
+declare function SelectionHandles({ token: explicitToken }?: SelectionHandlesProps): import("react/jsx-runtime").JSX.Element | null;
+interface SelectionClipboardProps extends Pick<SelectionClipboardOptions, 'prefetch' | 'onRefused'> {
+  /**
+   * Copy only while focus is inside this element, for a page with more than one viewer.
+   * Default: anywhere on the page.
+   */
+  target?: RefObject<HTMLElement | null>;
+}
 /**
- * Mount ONCE per viewer to wire clipboard copy: prefetches the selected text
+ * Mount once per viewer to wire clipboard copy: prefetches the selected text
  * when the selection settles, answers the native `copy` event synchronously,
  * and falls back to the async Clipboard API for ctrl/cmd+C when the page has
- * no DOM selection. Renders nothing. For a toolbar Copy button, call
- * `copySelection(useSelection())` from its click handler instead.
+ * no DOM selection. A selection the user may not copy isn't copied, and
+ * `onRefused` is called. Renders nothing, and wires nothing until a document
+ * is ready. For a toolbar Copy button, call `copySelection(useSelection())`
+ * from its click handler instead.
  */
-declare function SelectionClipboard({ prefetch }?: SelectionClipboardProps): null;
+declare function SelectionClipboard({ prefetch, onRefused, target }?: SelectionClipboardProps): null;
 //#endregion
-export { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, copySelection, useSelection };
+export { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionMenu, SelectionMenuProps, copySelection, useSelection, useSelectionEvent, useSelectionSettings, useSelectionState };
 //# sourceMappingURL=selection.d.cts.map

package/dist/selection.d.ts

@@ -1,70 +1,98 @@
-import { AnchoredPlacement as AnchoredPlacement$1 } from "./anchored.js";
-import { CapabilityToken } from "@embedpdf/core";
-import * as React from "react";
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.js";
+import { r as AnchoredPlacement$1 } from "./anchored-DeX95xSd.js";
+import { CapabilityToken, EventHook } from "@embedpdf/core";
 import { SelectionClipboardOptions, copySelection } from "@embedpdf/web";
+import * as React$1 from "react";
+import { RefObject } from "react";
 import { StageCapability } from "@embedpdf/plugin-stage/contract";
+import { SelectionCapability } from "@embedpdf/plugin-selection";
 export * from "@embedpdf/plugin-selection";
 //#region src/selection.d.ts
-interface SelectionLayerProps {
-  /** Highlight colour (default: translucent blue). */
-  color?: string;
-}
-declare function SelectionLayer({ color }: SelectionLayerProps): import("react/jsx-runtime").JSX.Element | null;
-/** The PUBLIC selection capability (select(), readText(), canCopy(), …) for
+/**
+ * The highlight of the selected text on one page, in the selection plugin's
+ * `color` setting; the `--epdf-text-selection` CSS variable wins over it.
+ */
+declare function SelectionLayer(): import("react/jsx-runtime").JSX.Element | null;
+/** The public selection capability (select(), readText(), canCopy(), …) for
  *  app chrome — toolbars, context menus, automation. */
-declare function useSelection(): import("@embedpdf/plugin-selection").SelectionCapability;
+declare function useSelection(): SelectionCapability;
+/** Subscribe to one selection event for the mounted lifetime: `useSelectionEvent((selection) => selection.onCommitted, handler)`. */
+declare function useSelectionEvent<T>(select: (selection: SelectionCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The selection's state: whether anything is selected, whether the user is
+ * still selecting, the character range and the pages it's on (the page's State
+ * table, declared once in `selectionState`). Takes a selector, re-renders only
+ * when what it returns changes, and returns the empty state without a document.
+ */
+declare const useSelectionState: StateHook<{
+  hasSelection: boolean;
+  isSelecting: boolean;
+  range: import("@embedpdf/plugin-selection").TextRange | null;
+  pages: readonly import("@embedpdf/core").PageRef[];
+}>;
+/** The selection settings (`dragThreshold`, `color`, `handles`), with or without a document. Takes a selector. */
+declare const useSelectionSettings: SettingsHook<import("@embedpdf/plugin-selection").SelectionSettings>;
 interface SelectionMenuProps {
-  children: React.ReactNode;
+  children: React$1.ReactNode;
   /** Gap in screen px between the selection and the menu (default 8). */
   gap?: number;
   /** Where to place the menu relative to the selection. Default 'top'. */
   placement?: AnchoredPlacement$1;
 }
 /**
- * Floats over the current TEXT selection (one anchor regardless of
+ * Floats over the current text selection (one anchor regardless of
  * cross-page selection; it rides the gesture's end page) — and only once the
- * selection SETTLES: hidden while `isSelecting()` (mid-drag), it appears at
+ * selection settles: hidden while a gesture is active (mid-drag), it appears at
  * pointer-up; programmatic selections show immediately (born settled). Works
  * under `<Stage>` (mount in the overlay slot) and `<PageView>` alike — the
  * surface provides the projection. Compose the contents from hooks:
  * `useSelection()` for copy/clear, `useAnnotation()` for
  * `markupFromSelection('highlight')`, `copySelection` for the clipboard.
  * For live-follow UI during the drag, compose `<Anchored>` with
- * `menuAnchor()` yourself — the primitive carries no policy.
+ * `getAnchor()` yourself — the primitive carries no policy.
  */
 declare function SelectionMenu({ children, gap, placement }: SelectionMenuProps): import("react/jsx-runtime").JSX.Element | null;
 interface SelectionHandlesProps {
-  /** Handle colour (default: the selection blue). */
-  color?: string;
-  /** The stage lens hosting this overlay (default: the main StageToken). */
+  /** The stage lens hosting this overlay (default: the enclosing `<Stage>`'s lens). */
   token?: CapabilityToken<StageCapability>;
 }
 /**
  * iOS-style draggable selection handles. Each is drawn the way the platform
- * draws them: a thin caret BAR that forms the selection's own start/end edge
+ * draws them: a thin caret bar that forms the selection's own start/end edge
  * — the boundary glyph's oriented edge, so rotated text and rotated pages
  * carry the handle with them — capped by a screen-constant circle, above the
  * first line at the start, below the last line at the end.
  *
- * On touch, where a caret drag isn't available, the handles ARE the way to
+ * On touch, where a caret drag isn't available, the handles are the way to
  * grow or shrink a selection: a long-press selects a word, then each handle
- * extends from the OPPOSITE endpoint, snapping to glyphs and crossing pages
- * exactly like a pointer drag — it rides the same `beginAt`/`extendTo`
+ * extends from the opposite endpoint, snapping to glyphs and crossing pages
+ * exactly like a pointer drag — it rides the same `beginGestureAt`/`extendTo`
  * gesture path, so highlights, menus, and commit signals all behave
  * identically. Mount in the `<Stage>` overlay slot next to `<SelectionMenu>`;
  * outside a Stage it renders nothing (a `PageView` has no camera to project
  * through). Pointer-isolated, so grabbing a handle never pans the stage.
+ * Painted in the plugin's `handles` setting, which the
+ * `--epdf-text-selection-handle` and `--epdf-text-selection-handle-shadow` CSS
+ * variables override.
  */
-declare function SelectionHandles({ color, token }: SelectionHandlesProps): import("react/jsx-runtime").JSX.Element | null;
-type SelectionClipboardProps = Pick<SelectionClipboardOptions, 'prefetch'>;
+declare function SelectionHandles({ token: explicitToken }?: SelectionHandlesProps): import("react/jsx-runtime").JSX.Element | null;
+interface SelectionClipboardProps extends Pick<SelectionClipboardOptions, 'prefetch' | 'onRefused'> {
+  /**
+   * Copy only while focus is inside this element, for a page with more than one viewer.
+   * Default: anywhere on the page.
+   */
+  target?: RefObject<HTMLElement | null>;
+}
 /**
- * Mount ONCE per viewer to wire clipboard copy: prefetches the selected text
+ * Mount once per viewer to wire clipboard copy: prefetches the selected text
  * when the selection settles, answers the native `copy` event synchronously,
  * and falls back to the async Clipboard API for ctrl/cmd+C when the page has
- * no DOM selection. Renders nothing. For a toolbar Copy button, call
- * `copySelection(useSelection())` from its click handler instead.
+ * no DOM selection. A selection the user may not copy isn't copied, and
+ * `onRefused` is called. Renders nothing, and wires nothing until a document
+ * is ready. For a toolbar Copy button, call `copySelection(useSelection())`
+ * from its click handler instead.
  */
-declare function SelectionClipboard({ prefetch }?: SelectionClipboardProps): null;
+declare function SelectionClipboard({ prefetch, onRefused, target }?: SelectionClipboardProps): null;
 //#endregion
-export { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionLayerProps, SelectionMenu, SelectionMenuProps, copySelection, useSelection };
+export { SelectionClipboard, SelectionClipboardProps, SelectionHandles, SelectionHandlesProps, SelectionLayer, SelectionMenu, SelectionMenuProps, copySelection, useSelection, useSelectionEvent, useSelectionSettings, useSelectionState };
 //# sourceMappingURL=selection.d.ts.map