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

package/dist/interaction.d.ts

@@ -1,46 +1,37 @@
-import { SvgCursorOptions, vibrationFeedback, wkFeedback } from "@embedpdf/web";
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.js";
+import { EventHook } from "@embedpdf/core";
+import { SvgCursorOptions, ToolCursorImage, ToolCursorSpec, ToolCursorSpec as ToolCursorSpec$1, createClickCounter, svgCursor, vibrationFeedback, wkFeedback } from "@embedpdf/web";
+import { InteractionCapability } from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-interaction";
 //#region src/interaction.d.ts
+declare function PagePointerSource(): import("react/jsx-runtime").JSX.Element;
+/** The interaction capability: switch tools, add your own, set their cursors. */
+declare function useInteraction(): InteractionCapability;
+/** Subscribe to one interaction event for the mounted lifetime: `useInteractionEvent((interaction) => interaction.onGestureStarted, handler)`. */
+declare function useInteractionEvent<T>(select: (interaction: InteractionCapability) => EventHook<T>, handler: (event: T) => void): void;
 /**
- * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so
- * we count clicks ourselves from timing + proximity — the standard double/triple
- * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.
+ * The tools' state: the active tool's id and every tool you can switch to
+ * (the page's State table, declared once in `interactionState`). Takes a
+ * selector, and re-renders only when what it returns changes. Without a
+ * document there is no active tool (`null`) and no tool.
  */
-declare function createClickCounter(maxGapMs?: number, maxDistPx?: number): (now: number, x: number, y: number) => number;
-declare function PagePointerSource(): import("react/jsx-runtime").JSX.Element;
-/** Read + switch the active tool (for a toolbar). */
-declare function useTool(): {
-  activeToolId: string;
-  activate: (id: import("@embedpdf/plugin-interaction").ToolId) => void;
-  tools: import("@embedpdf/plugin-interaction").Tool[];
-};
-/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS
- *  cursor string ('crosshair', 'url(…) 4 4, copy'). */
-type ToolCursorImage = SvgCursorOptions | string;
-/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.
- *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor
- *  and the button can never drift apart. */
-interface ToolCursorSpec {
-  toolId: string;
-  /** keyword → cursor: restyle the keywords this tool can show — its declared
-   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the
-   *  tool's identity. Keywords the map omits render as-is: a markup tool's
-   *  'default' base stays the bare arrow, a foreign 'move' claim drops the
-   *  icon. An SVG value defaults its keyword `fallback` to the keyword it
-   *  replaces. */
-  cursors: Record<string, ToolCursorImage>;
-}
+declare const useInteractionState: StateHook<{
+  activeToolId: import("@embedpdf/plugin-interaction").ToolId | null;
+  tools: readonly import("@embedpdf/plugin-interaction").Tool[];
+}>;
+/** The interaction settings (`defaultTool`, `tools`), with or without a document. Takes a selector. */
+declare const useInteractionSettings: SettingsHook<import("@embedpdf/plugin-interaction").InteractionSettings>;
 /**
- * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only
+ * Give a tool image cursors — the armed-tool indicator. The cursor is the only
  * zero-latency pointer-locked pixel the platform has, and the hub already
  * arbitrates it: unmapped hover claims beat it over annotations/text, page
  * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill
  * controls) carries its own CSS cursor — so nothing chases the pointer in
  * DOM. `null` installs nothing. A re-render with new content rebuilds the
  * cursor (live recolor from tool defaults); unmount restores the tool's
- * declared cursors.
+ * declared cursors. Without a document it installs nothing until one is ready.
  */
-declare function useToolCursor(spec: ToolCursorSpec | null): void;
+declare function useToolCursor(spec: ToolCursorSpec$1 | null): void;
 //#endregion
-export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback };
+export { PagePointerSource, type SvgCursorOptions, type ToolCursorImage, type ToolCursorSpec, createClickCounter, svgCursor, useInteraction, useInteractionEvent, useInteractionSettings, useInteractionState, useToolCursor, vibrationFeedback, wkFeedback };
 //# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.js

@@ -1,94 +1,21 @@
-import "./rolldown-runtime-BBjsoOtd.js";
-import { useCapability, usePage, useSelector } from "./runtime.js";
+import { E as useSelector, S as useOptionalCapability, f as useCapability, p as useCapabilityEvent, w as usePage } from "./runtime-B6xcPsEb.js";
+import { n as stateHook, t as settingsHook } from "./state-CbgxhwLA.js";
 import { jsx } from "react/jsx-runtime";
+import { attachPagePointer, createClickCounter, svgCursor, toolCursorsOf, vibrationFeedback, wkFeedback } from "@embedpdf/web";
 import { useEffect, useRef } from "react";
-import { svgCursor, vibrationFeedback, wkFeedback } from "@embedpdf/web";
-import { InteractionToken } from "@embedpdf/plugin-interaction";
+import { InteractionToken } from "@embedpdf/plugin-interaction/contract/host";
+import { InteractionToken as InteractionToken$1, interactionState } from "@embedpdf/plugin-interaction";
 export * from "@embedpdf/plugin-interaction";
 //#region src/interaction.tsx
-const mods = (e) => ({
-	shift: e.shiftKey,
-	alt: e.altKey,
-	ctrl: e.ctrlKey,
-	meta: e.metaKey
-});
-/**
-* Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so
-* we count clicks ourselves from timing + proximity — the standard double/triple
-* detection. Input normalization belongs in the adapter; the hub/handlers stay pure.
-*/
-function createClickCounter(maxGapMs = 400, maxDistPx = 6) {
-	let last = 0;
-	let lx = 0;
-	let ly = 0;
-	let count = 0;
-	return (now, x, y) => {
-		count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;
-		last = now;
-		lx = x;
-		ly = y;
-		return count;
-	};
-}
 function PagePointerSource() {
 	const page = usePage();
 	const interaction = useCapability(InteractionToken);
-	const cursor = useSelector(InteractionToken, (c) => c.cursor());
+	const cursor = useSelector(InteractionToken, (interaction) => interaction.getCursor());
 	const ref = useRef(null);
 	useEffect(() => {
-		const el = ref.current;
-		if (!el) return;
-		const clicks = createClickCounter();
-		const sample = (phase, e, clickCount = 1) => {
-			const r = el.getBoundingClientRect();
-			return {
-				phase,
-				viewport: {
-					x: e.clientX - r.left,
-					y: e.clientY - r.top
-				},
-				page: {
-					pon: page.pon,
-					point: page.toContentPoint(e.clientX, e.clientY),
-					scale: page.transform.viewScale,
-					rotation: page.transform.rotation,
-					zoom: page.transform.zoom
-				},
-				project: (pon) => pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null,
-				modifiers: mods(e),
-				clickCount,
-				pointerType: e.pointerType || "mouse"
-			};
-		};
-		let dragging = false;
-		const down = (e) => {
-			if (e.button !== 0) return;
-			dragging = true;
-			interaction.dispatch(sample("down", e, clicks(Date.now(), e.clientX, e.clientY)));
-		};
-		const hover = (e) => {
-			if (dragging) return;
-			interaction.dispatch(sample("move", e));
-		};
-		const drag = (e) => {
-			if (!dragging) return;
-			interaction.dispatch(sample("move", e));
-		};
-		const up = (e) => {
-			if (!dragging) return;
-			dragging = false;
-			interaction.dispatch(sample("up", e));
-		};
-		el.addEventListener("pointerdown", down);
-		el.addEventListener("pointermove", hover);
-		window.addEventListener("pointermove", drag);
-		window.addEventListener("pointerup", up);
-		return () => {
-			el.removeEventListener("pointerdown", down);
-			el.removeEventListener("pointermove", hover);
-			window.removeEventListener("pointermove", drag);
-			window.removeEventListener("pointerup", up);
-		};
+		const element = ref.current;
+		if (!element) return;
+		return attachPagePointer(element, interaction, () => page);
 	}, [interaction, page]);
 	return /* @__PURE__ */ jsx("div", {
 		ref,
@@ -100,42 +27,46 @@ function PagePointerSource() {
 		}
 	});
 }
-/** Read + switch the active tool (for a toolbar). */
-function useTool() {
-	const interaction = useCapability(InteractionToken);
-	return {
-		activeToolId: useSelector(InteractionToken, (c) => c.activeToolId()),
-		activate: interaction.activateTool,
-		tools: interaction.tools()
-	};
+/** The interaction capability: switch tools, add your own, set their cursors. */
+function useInteraction() {
+	return useCapability(InteractionToken$1);
 }
-const toCursor = (img, fallback) => typeof img === "string" ? img : svgCursor(img.fallback === void 0 && fallback ? {
-	...img,
-	fallback
-} : img);
+/** Subscribe to one interaction event for the mounted lifetime: `useInteractionEvent((interaction) => interaction.onGestureStarted, handler)`. */
+function useInteractionEvent(select, handler) {
+	useCapabilityEvent(InteractionToken$1, select, handler);
+}
+/**
+* The tools' state: the active tool's id and every tool you can switch to
+* (the page's State table, declared once in `interactionState`). Takes a
+* selector, and re-renders only when what it returns changes. Without a
+* document there is no active tool (`null`) and no tool.
+*/
+const useInteractionState = stateHook(interactionState);
+/** The interaction settings (`defaultTool`, `tools`), with or without a document. Takes a selector. */
+const useInteractionSettings = settingsHook(InteractionToken$1);
 /**
-* Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only
+* Give a tool image cursors — the armed-tool indicator. The cursor is the only
 * zero-latency pointer-locked pixel the platform has, and the hub already
 * arbitrates it: unmapped hover claims beat it over annotations/text, page
 * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill
 * controls) carries its own CSS cursor — so nothing chases the pointer in
 * DOM. `null` installs nothing. A re-render with new content rebuilds the
 * cursor (live recolor from tool defaults); unmount restores the tool's
-* declared cursors.
+* declared cursors. Without a document it installs nothing until one is ready.
 */
 function useToolCursor(spec) {
-	const interaction = useCapability(InteractionToken);
+	const interaction = useOptionalCapability(InteractionToken);
 	const key = spec && JSON.stringify(spec);
 	const ref = useRef(spec);
 	ref.current = spec;
 	useEffect(() => {
-		const s = ref.current;
-		if (!s) return;
-		interaction.setToolCursor(s.toolId, Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])));
-		return () => interaction.setToolCursor(s.toolId, null);
+		const cursorSpec = ref.current;
+		if (!cursorSpec || !interaction) return;
+		interaction.setToolCursor(cursorSpec.toolId, toolCursorsOf(cursorSpec.cursors));
+		return () => interaction.setToolCursor(cursorSpec.toolId, null);
 	}, [interaction, key]);
 }
 //#endregion
-export { PagePointerSource, createClickCounter, useTool, useToolCursor, vibrationFeedback, wkFeedback };
+export { PagePointerSource, createClickCounter, svgCursor, useInteraction, useInteractionEvent, useInteractionSettings, useInteractionState, useToolCursor, vibrationFeedback, wkFeedback };
 
 //# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.js","names":[],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the ONE pointer listener per page: it converts events to\n * page space via PageContext.toContentPoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners — they register handlers with the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\n// The browser feedback providers live in @embedpdf/web (the plugin is\n// DOM-free); re-exported here so app code has one import for the feature.\nexport { vibrationFeedback, wkFeedback } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { Modifiers, PointerSample } from '@embedpdf/plugin-interaction';\nimport { svgCursor } from '@embedpdf/web';\nimport type { SvgCursorOptions } from '@embedpdf/web';\nimport { useCapability, usePage, useSelector } from './runtime';\n\nconst mods = (e: PointerEvent): Modifiers => ({\n  shift: e.shiftKey,\n  alt: e.altKey,\n  ctrl: e.ctrlKey,\n  meta: e.metaKey,\n});\n\n/**\n * Robust multi-click counter. `pointerdown.detail` is 0/1 in several browsers, so\n * we count clicks ourselves from timing + proximity — the standard double/triple\n * detection. Input normalization belongs in the adapter; the hub/handlers stay pure.\n */\nexport function createClickCounter(maxGapMs = 400, maxDistPx = 6) {\n  let last = 0;\n  let lx = 0;\n  let ly = 0;\n  let count = 0;\n  return (now: number, x: number, y: number): number => {\n    count = now - last <= maxGapMs && Math.hypot(x - lx, y - ly) <= maxDistPx ? count + 1 : 1;\n    last = now;\n    lx = x;\n    ly = y;\n    return count;\n  };\n}\n\nexport function PagePointerSource() {\n  const page = usePage();\n  const interaction = useCapability(InteractionToken);\n  const cursor = useSelector(InteractionToken, (c) => c.cursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const clicks = createClickCounter();\n    const sample = (\n      phase: PointerSample['phase'],\n      e: PointerEvent,\n      clickCount = 1,\n    ): PointerSample => {\n      const r = el.getBoundingClientRect();\n      return {\n        phase,\n        viewport: { x: e.clientX - r.left, y: e.clientY - r.top },\n        // `scale`/`rotation`/`zoom` carry the same per-page environmental\n        // context the Stage source resolves via `pageAt` — read off the page\n        // transform so a standalone <PageView> drives handlers identically.\n        page: {\n          pon: page.pon,\n          point: page.toContentPoint(e.clientX, e.clientY),\n          scale: page.transform.viewScale,\n          rotation: page.transform.rotation,\n          zoom: page.transform.zoom,\n        },\n        // A per-page source can only project onto its OWN page — toContentPoint is\n        // already unclamped (the drag listener lives on window), so a gesture\n        // anchored here keeps tracking past the page bounds.\n        project: (pon) => (pon === page.pon ? page.toContentPoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\n        pointerType: (e.pointerType || 'mouse') as PointerSample['pointerType'],\n      };\n    };\n    let dragging = false;\n\n    const down = (e: PointerEvent) => {\n      if (e.button !== 0) return;\n      dragging = true;\n      interaction.dispatch(sample('down', e, clicks(Date.now(), e.clientX, e.clientY)));\n    };\n    // hover (no gesture): drive cursor feedback only — fires from the element\n    const hover = (e: PointerEvent) => {\n      if (dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    // active drag: track on window so it survives leaving the page bounds\n    const drag = (e: PointerEvent) => {\n      if (!dragging) return;\n      interaction.dispatch(sample('move', e));\n    };\n    const up = (e: PointerEvent) => {\n      if (!dragging) return;\n      dragging = false;\n      interaction.dispatch(sample('up', e));\n    };\n\n    el.addEventListener('pointerdown', down);\n    el.addEventListener('pointermove', hover);\n    window.addEventListener('pointermove', drag);\n    window.addEventListener('pointerup', up);\n    return () => {\n      el.removeEventListener('pointerdown', down);\n      el.removeEventListener('pointermove', hover);\n      window.removeEventListener('pointermove', drag);\n      window.removeEventListener('pointerup', up);\n    };\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** Read + switch the active tool (for a toolbar). */\nexport function useTool() {\n  const interaction = useCapability(InteractionToken);\n  const activeToolId = useSelector(InteractionToken, (c) => c.activeToolId());\n  return {\n    activeToolId,\n    activate: interaction.activateTool,\n    tools: interaction.tools(),\n  };\n}\n\n/** One cursor slot: an SVG image ({@link SvgCursorOptions}) or a plain CSS\n *  cursor string ('crosshair', 'url(…) 4 4, copy'). */\nexport type ToolCursorImage = SvgCursorOptions | string;\n\n/** What {@link useToolCursor} installs: the tool to reskin + its keyword map.\n *  Apps build `svg` from the SAME icon their toolbar renders, so the cursor\n *  and the button can never drift apart. */\nexport interface ToolCursorSpec {\n  toolId: string;\n  /** keyword → cursor: restyle the keywords this tool can show — its declared\n   *  base ('crosshair', 'copy') and hover claims ('text' over text) — in the\n   *  tool's identity. Keywords the map omits render as-is: a markup tool's\n   *  'default' base stays the bare arrow, a foreign 'move' claim drops the\n   *  icon. An SVG value defaults its keyword `fallback` to the keyword it\n   *  replaces. */\n  cursors: Record<string, ToolCursorImage>;\n}\n\nconst toCursor = (img: ToolCursorImage, fallback?: string): string =>\n  typeof img === 'string'\n    ? img\n    : svgCursor(img.fallback === undefined && fallback ? { ...img, fallback } : img);\n\n/**\n * Give a tool IMAGE cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useCapability(InteractionToken);\n  // Key the effect by VALUE: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const s = ref.current;\n    if (!s) return;\n    interaction.setToolCursor(\n      s.toolId,\n      Object.fromEntries(Object.entries(s.cursors).map(([k, v]) => [k, toCursor(v, k)])),\n    );\n    return () => interaction.setToolCursor(s.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"interaction.js","names":["InteractionHostToken","InteractionToken"],"sources":["../src/interaction.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-interaction.\n *\n * <PagePointerSource> is the one pointer listener per page: it converts events to\n * page space via PageContext.toPagePoint and forwards normalized samples to the\n * hub. It binds only to the page context, so it works identically inside a\n * virtualized <Stage> page and a standalone <PageView>. Features never attach\n * their own pointer listeners: they register handlers with the hub, and a tool\n * of your own brings its pointer methods (`registerTool`).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\n// The browser helpers live in @embedpdf/web (the plugin is DOM-free); they are\n// re-exported here so app code has one import for the feature.\nexport { createClickCounter, svgCursor, vibrationFeedback, wkFeedback } from '@embedpdf/web';\nexport type { SvgCursorOptions, ToolCursorImage, ToolCursorSpec } from '@embedpdf/web';\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { InteractionToken as InteractionHostToken } from '@embedpdf/plugin-interaction/contract/host';\nimport { InteractionToken, interactionState } from '@embedpdf/plugin-interaction';\nimport type { InteractionCapability } from '@embedpdf/plugin-interaction';\nimport type { EventHook } from '@embedpdf/core';\nimport { attachPagePointer, toolCursorsOf } from '@embedpdf/web';\nimport type { ToolCursorSpec } from '@embedpdf/web';\nimport {\n  useCapability,\n  useCapabilityEvent,\n  useOptionalCapability,\n  usePage,\n  useSelector,\n} from './runtime';\nimport { settingsHook, stateHook } from './state';\n\nexport function PagePointerSource() {\n  const page = usePage();\n  // The pointer source is a host of the hub (it dispatches samples).\n  const interaction = useCapability(InteractionHostToken);\n  const cursor = useSelector(InteractionHostToken, (interaction) => interaction.getCursor());\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return;\n    // The listener is `@embedpdf/web`'s, shared with every framework.\n    return attachPagePointer(element, interaction, () => page);\n  }, [interaction, page]);\n\n  // Sits on top as the page's event surface; visual layers below use pointerEvents:none.\n  return <div ref={ref} style={{ position: 'absolute', inset: 0, cursor, touchAction: 'none' }} />;\n}\n\n/** The interaction capability: switch tools, add your own, set their cursors. */\nexport function useInteraction(): InteractionCapability {\n  return useCapability(InteractionToken);\n}\n\n/** Subscribe to one interaction event for the mounted lifetime: `useInteractionEvent((interaction) => interaction.onGestureStarted, handler)`. */\nexport function useInteractionEvent<T>(\n  select: (interaction: InteractionCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(InteractionToken, select, handler);\n}\n\n/**\n * The tools' state: the active tool's id and every tool you can switch to\n * (the page's State table, declared once in `interactionState`). Takes a\n * selector, and re-renders only when what it returns changes. Without a\n * document there is no active tool (`null`) and no tool.\n */\nexport const useInteractionState = stateHook(interactionState);\n\n/** The interaction settings (`defaultTool`, `tools`), with or without a document. Takes a selector. */\nexport const useInteractionSettings = settingsHook(InteractionToken);\n\n/**\n * Give a tool image cursors — the armed-tool indicator. The cursor is the only\n * zero-latency pointer-locked pixel the platform has, and the hub already\n * arbitrates it: unmapped hover claims beat it over annotations/text, page\n * gaps fall back to the tool's `gapCursor`, and other UI (menus, form fill\n * controls) carries its own CSS cursor — so nothing chases the pointer in\n * DOM. `null` installs nothing. A re-render with new content rebuilds the\n * cursor (live recolor from tool defaults); unmount restores the tool's\n * declared cursors. Without a document it installs nothing until one is ready.\n */\nexport function useToolCursor(spec: ToolCursorSpec | null): void {\n  const interaction = useOptionalCapability(InteractionHostToken);\n  // Key the effect by value: specs are built inline in render, and a\n  // fresh-but-identical object must not thrash the skin.\n  const key = spec && JSON.stringify(spec);\n  const ref = useRef(spec);\n  ref.current = spec;\n  useEffect(() => {\n    const cursorSpec = ref.current;\n    if (!cursorSpec || !interaction) return;\n    interaction.setToolCursor(cursorSpec.toolId, toolCursorsOf(cursorSpec.cursors));\n    return () => interaction.setToolCursor(cursorSpec.toolId, null);\n  }, [interaction, key]);\n}\n"],"mappings":";;;;;;;;;AAkCA,SAAgB,oBAAoB;CAClC,MAAM,OAAO,QAAQ;CAErB,MAAM,cAAc,cAAcA,gBAAoB;CACtD,MAAM,SAAS,YAAYA,mBAAuB,gBAAgB,YAAY,UAAU,CAAC;CACzF,MAAM,MAAM,OAAuB,IAAI;CAEvC,gBAAgB;EACd,MAAM,UAAU,IAAI;EACpB,IAAI,CAAC,SAAS;EAEd,OAAO,kBAAkB,SAAS,mBAAmB,IAAI;CAC3D,GAAG,CAAC,aAAa,IAAI,CAAC;CAGtB,OAAO,oBAAC,OAAD;EAAU;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG;GAAQ,aAAa;EAAO;CAAI,CAAA;AACjG;;AAGA,SAAgB,iBAAwC;CACtD,OAAO,cAAcC,kBAAgB;AACvC;;AAGA,SAAgB,oBACd,QACA,SACM;CACN,mBAAmBA,oBAAkB,QAAQ,OAAO;AACtD;;;;;;;AAQA,MAAa,sBAAsB,UAAU,gBAAgB;;AAG7D,MAAa,yBAAyB,aAAaA,kBAAgB;;;;;;;;;;;AAYnE,SAAgB,cAAc,MAAmC;CAC/D,MAAM,cAAc,sBAAsBD,gBAAoB;CAG9D,MAAM,MAAM,QAAQ,KAAK,UAAU,IAAI;CACvC,MAAM,MAAM,OAAO,IAAI;CACvB,IAAI,UAAU;CACd,gBAAgB;EACd,MAAM,aAAa,IAAI;EACvB,IAAI,CAAC,cAAc,CAAC,aAAa;EACjC,YAAY,cAAc,WAAW,QAAQ,cAAc,WAAW,OAAO,CAAC;EAC9E,aAAa,YAAY,cAAc,WAAW,QAAQ,IAAI;CAChE,GAAG,CAAC,aAAa,GAAG,CAAC;AACvB"}

package/dist/link.cjs

@@ -1,71 +1,56 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
+const require_runtime = require("./runtime-fzpGv78v.cjs");
+const require_stage_scope = require("./stage-scope-CQgCuf1w.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
+let _embedpdf_web = require("@embedpdf/web");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react, 1);
-let _embedpdf_web = require("@embedpdf/web");
-let _embedpdf_plugin_interaction_contract = require("@embedpdf/plugin-interaction/contract");
+let _embedpdf_plugin_interaction_contract_host = require("@embedpdf/plugin-interaction/contract/host");
 let _embedpdf_plugin_link = require("@embedpdf/plugin-link");
 let _embedpdf_plugin_actions_contract = require("@embedpdf/plugin-actions/contract");
+let _embedpdf_plugin_link_contract_host = require("@embedpdf/plugin-link/contract/host");
 //#region src/link.tsx
 /**
-* Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE
-* place in the codebase that turns a link target into a browser tab. The
-* plugin owns resolution (goto → stage reveal, policy, analytics) and stays
-* DOM-free; opening is this framework layer's job. Every click path — the nav
-* anchors below, the selection menu's "Open link", the style editor's "Go to
-* link" — goes through here, so none of them can drop the uri outcome again.
+* A link's anchor. A press inside it must not reach the Stage's native listener (it would start
+* the active tool's gesture, or end an edit as a click outside), so it stops with a native
+* listener on the anchor itself: React's own `onPointerDown` runs from the root, after the Stage
+* has already seen the press. The same listener sends the link's "mouse down" action.
 */
-function openLinkTarget(link, target, context) {
-	const activation = link.activate(target, context);
-	if (activation.outcome === "uri") {
-		const href = (0, _embedpdf_web.sanitizeExternalUri)(activation.uri);
-		if (href && typeof window !== "undefined") window.open(href, "_blank", "noopener,noreferrer");
-	}
-	return activation;
-}
-/** Content rect → view px (the page wrapper's own space) — the same idiom as
-*  the annotation and form layers: never re-derive `x * scale`. */
-function boxOf(item, page) {
-	const tl = page.transform.toPixels({
-		x: item.rect.x,
-		y: item.rect.y
+function LinkAnchor({ onPress, ...props }) {
+	const ref = (0, react.useRef)(null);
+	const press = (0, react.useRef)(onPress);
+	press.current = onPress;
+	(0, react.useEffect)(() => ref.current ? (0, _embedpdf_web.isolatePointerDown)(ref.current, () => press.current()) : void 0, []);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+		ref,
+		...props
 	});
-	const br = page.transform.toPixels({
-		x: item.rect.x + item.rect.width,
-		y: item.rect.y + item.rect.height
-	});
-	return {
-		left: tl.x,
-		top: tl.y,
-		width: br.x - tl.x,
-		height: br.y - tl.y
-	};
 }
-/** A human label for the hover tooltip. Apps with i18n render their own via
-*  `renderLink`; this is the sensible default. */
-function labelOf(item) {
-	switch (item.target.kind) {
-		case "uri": return item.target.uri;
-		case "goto": return "Go to destination";
-		case "named": return item.target.name;
-		default: return "Link";
-	}
+/**
+* Hand the link plugin this binding's website opener (`openExternalUri`)
+* while the component is mounted: an allowed address opens in a new tab,
+* anything else is refused and the plugin reports it.
+*/
+function useUriOpener() {
+	const host = require_runtime.useOptionalCapability(_embedpdf_plugin_link_contract_host.LinkToken);
+	(0, react.useEffect)(() => host?.registerUriOpener(_embedpdf_web.openExternalUri), [host]);
 }
 function LinkLayer({ renderLink } = {}) {
 	const page = require_runtime.usePage();
 	const link = require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
+	useUriOpener();
+	const stage = require_runtime.useOptionalCapability(require_stage_scope.useStageToken());
 	const actions = require_runtime.useOptionalCapability(_embedpdf_plugin_actions_contract.ActionsToken);
 	const linkPump = (0, react.useMemo)(() => actions ? (0, _embedpdf_plugin_actions_contract.createHoverPump)(actions.dispatch) : null, [actions]);
-	const items = require_runtime.useSelector(_embedpdf_plugin_link.LinkToken, (c) => c.linksOn(page.pon), require_runtime.shallowArray);
-	const engaged = require_runtime.useSelector(_embedpdf_plugin_link.LinkToken, (c) => c.engaged());
-	const editEnabled = require_runtime.useOptionalSelector(_embedpdf_plugin_interaction_contract.InteractionToken, (c) => c.activeTool()?.enables.has("annotation-edit") ?? false, false);
+	const items = require_runtime.useSelector(_embedpdf_plugin_link.LinkToken, (link) => link.listLinks(page.ref), require_runtime.shallowArray);
+	const engaged = require_runtime.useSelector(_embedpdf_plugin_link_contract_host.LinkToken, (link) => link.isNavigationEngaged());
+	const editEnabled = require_runtime.useOptionalSelector(_embedpdf_plugin_interaction_contract_host.InteractionToken, (interaction) => interaction.activeToolEnables("annotation-edit"), false);
 	(0, react.useEffect)(() => {
-		link.ensurePage(page.pon);
-	}, [link, page.pon]);
+		link.ensureLoaded(page.ref);
+	}, [link, page.ref]);
 	if (!engaged || !items.length) return null;
-	const visible = editEnabled ? items.filter((i) => !i.attached) : items;
+	const visible = (0, _embedpdf_web.navigableLinksOf)(items, editEnabled);
 	if (!visible.length) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		style: {
@@ -74,66 +59,33 @@ function LinkLayer({ renderLink } = {}) {
 			pointerEvents: "none"
 		},
 		children: visible.map((item) => {
-			const box = boxOf(item, page);
-			const chained = (item.activate?.root?.next.length ?? 0) > 0;
-			const href = item.target.kind === "uri" && !chained ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null;
-			const context = {
-				activate: item.activate,
-				ref: item.ref,
-				pon: page.pon
-			};
-			const linkSource = item.ref ? {
-				kind: "link",
-				annotation: item.ref,
-				pon: page.pon
-			} : null;
-			const notify = (event) => {
-				if (!actions || !item.ref || !linkSource) return;
-				actions.dispatch({
-					scope: "annotation",
-					event,
-					ref: item.ref,
-					pon: page.pon,
-					source: linkSource
-				});
-			};
-			const native = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+			const { box, href, label } = (0, _embedpdf_web.linkAnchorOf)(item, page.transform, (each) => link.getLabel(each));
+			const context = (0, _embedpdf_web.linkActivateContextOf)(item, page.ref, stage);
+			const native = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LinkAnchor, {
+				onPress: () => (0, _embedpdf_web.sendLinkEvent)(actions, item, page.ref, "mouseDown"),
 				href: href ?? void 0,
 				target: "_blank",
 				rel: "noopener noreferrer",
 				role: "link",
 				tabIndex: 0,
-				title: labelOf(item),
-				"aria-label": labelOf(item),
-				onClick: (e) => {
-					if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
-					if (href) return;
-					e.preventDefault();
-					openLinkTarget(link, item.target, context);
+				title: label,
+				"aria-label": label,
+				onClick: (event) => {
+					if (href && (0, _embedpdf_web.isModifiedClick)(event)) return;
+					event.preventDefault();
+					link.activate(item, context);
 				},
-				onKeyDown: (e) => {
-					if (e.key === "Enter" || e.key === " ") {
-						e.preventDefault();
-						openLinkTarget(link, item.target, context);
+				onKeyDown: (event) => {
+					if (event.key === "Enter" || event.key === " ") {
+						event.preventDefault();
+						link.activate(item, context);
 					}
 				},
-				onPointerEnter: () => {
-					if (!linkPump || !item.ref || !item.hoverEvents) return;
-					linkPump.hover({
-						ref: item.ref,
-						pon: page.pon,
-						...linkSource ? { source: linkSource } : {},
-						events: item.hoverEvents
-					});
-				},
+				onPointerEnter: () => (0, _embedpdf_web.hoverLink)(linkPump, item, page.ref),
 				onPointerLeave: () => linkPump?.hover(null),
-				onPointerUp: () => notify("mouseUp"),
-				onFocus: () => notify("focus"),
-				onBlur: () => notify("blur"),
-				onPointerDown: (e) => {
-					e.stopPropagation();
-					notify("mouseDown");
-				},
+				onPointerUp: () => (0, _embedpdf_web.sendLinkEvent)(actions, item, page.ref, "mouseUp"),
+				onFocus: () => (0, _embedpdf_web.sendLinkEvent)(actions, item, page.ref, "focus"),
+				onBlur: () => (0, _embedpdf_web.sendLinkEvent)(actions, item, page.ref, "blur"),
 				style: {
 					position: "absolute",
 					left: box.left,
@@ -144,21 +96,30 @@ function LinkLayer({ renderLink } = {}) {
 					pointerEvents: "auto"
 				}
 			});
-			const out = renderLink?.({
-				item,
-				nativeComponent: native
+			const drawn = renderLink?.({
+				link: item,
+				native
 			}) ?? native;
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: out }, item.id);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: drawn }, item.id);
 		})
 	});
 }
+/**
+* The link capability (`listLinks`, `activate`, …) for app code. While a
+* component uses it, `activate()` opens a website in a new tab.
+*/
 function useLink() {
+	useUriOpener();
 	return require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
 }
+/** Subscribe to one link event for the mounted lifetime: `useLinkEvent((link) => link.onActivated, handler)`. */
+function useLinkEvent(select, handler) {
+	require_runtime.useCapabilityEvent(_embedpdf_plugin_link.LinkToken, select, handler);
+}
 //#endregion
 exports.LinkLayer = LinkLayer;
-exports.openLinkTarget = openLinkTarget;
 exports.useLink = useLink;
+exports.useLinkEvent = useLinkEvent;
 Object.keys(_embedpdf_plugin_link).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,

package/dist/link.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"link.cjs","names":["usePage","useCapability","LinkToken","useOptionalCapability","ActionsToken","useSelector","shallowArray","useOptionalSelector","InteractionToken","React"],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free), internal destinations activate through the\n * plugin (stage reveal). The layer stands down entirely while the active\n * tool doesn't enable `link-nav` — the annotation plane owns links then\n * (select / move / resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect, useMemo } from 'react';\nimport { ActionsToken, createHoverPump } from '@embedpdf/plugin-actions/contract';\nimport type {\n  ActionSource,\n  PdfAnnotationEventKind,\n} from '@embedpdf/plugin-actions/contract';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract';\nimport {\n  LinkToken,\n  type LinkActivateContext,\n  type LinkActivation,\n  type LinkCapability,\n  type LinkNavItem,\n  type PdfLinkTarget,\n} from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport {\n  shallowArray,\n  useCapability,\n  useOptionalCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\n/**\n * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE\n * place in the codebase that turns a link target into a browser tab. The\n * plugin owns resolution (goto → stage reveal, policy, analytics) and stays\n * DOM-free; opening is this framework layer's job. Every click path — the nav\n * anchors below, the selection menu's \"Open link\", the style editor's \"Go to\n * link\" — goes through here, so none of them can drop the uri outcome again.\n */\nexport function openLinkTarget(\n  link: LinkCapability,\n  target: PdfLinkTarget,\n  context?: LinkActivateContext,\n): LinkActivation {\n  const activation = link.activate(target, context);\n  if (activation.outcome === 'uri') {\n    const href = sanitizeExternalUri(activation.uri);\n    if (href && typeof window !== 'undefined') window.open(href, '_blank', 'noopener,noreferrer');\n  }\n  // 'dispatched': the action engine took it — the actions UI adapter owns any\n  // URI open (the no-double-open rule); this opener must do NOTHING.\n  return activation;\n}\n\n/** Content rect → view px (the page wrapper's own space) — the same idiom as\n *  the annotation and form layers: never re-derive `x * scale`. */\nfunction boxOf(item: LinkNavItem, page: PageContextValue) {\n  const tl = page.transform.toPixels({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.toPixels({\n    x: item.rect.x + item.rect.width,\n    y: item.rect.y + item.rect.height,\n  });\n  return { left: tl.x, top: tl.y, width: br.x - tl.x, height: br.y - tl.y };\n}\n\n/** A human label for the hover tooltip. Apps with i18n render their own via\n *  `renderLink`; this is the sensible default. */\nfunction labelOf(item: LinkNavItem): string {\n  switch (item.target.kind) {\n    case 'uri':\n      return item.target.uri;\n    case 'goto':\n      return 'Go to destination';\n    case 'named':\n      return item.target.name;\n    default:\n      return 'Link';\n  }\n}\n\nexport interface LinkLayerProps {\n  /** Wrap or replace a link's native anchor (badging, custom tooltips). */\n  renderLink?: (args: {\n    item: LinkNavItem;\n    nativeComponent: React.ReactNode;\n  }) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  // The link plane's /AA event feed: links are behavior-inert to the\n  // annotation plane's hover feed while navigable (their pixels are THESE\n  // anchors), so E/X/D/U/Fo/Bl can only fire from here. One shared pump per\n  // layer — crossing layers still orders Exit before Enter because both\n  // sides submit synchronously in DOM event order.\n  const actions = useOptionalCapability(ActionsToken);\n  const linkPump = useMemo(() => (actions ? createHoverPump(actions.dispatch) : null), [actions]);\n  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\n  // One owner per pixel: an ATTACHED link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (c) => c.activeTool()?.enables.has('annotation-edit') ?? false,\n    false,\n  );\n\n  useEffect(() => {\n    link.ensurePage(page.pon);\n  }, [link, page.pon]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = editEnabled ? items.filter((i) => !i.attached) : items;\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for a chain-free sanitized external URI; blocked\n        // schemes, internal targets, and chain-bearing trees (/Next after the\n        // URI) activate through the plugin instead — a native navigation\n        // would perform the first action and silently drop the rest.\n        const chained = (item.activate?.root?.next.length ?? 0) > 0;\n        const href =\n          item.target.kind === 'uri' && !chained ? sanitizeExternalUri(item.target.uri) : null;\n        const context: LinkActivateContext = { activate: item.activate, ref: item.ref, pon: page.pon };\n        const linkSource: ActionSource | null = item.ref\n          ? { kind: 'link', annotation: item.ref, pon: page.pon }\n          : null;\n        const notify = (event: Exclude<PdfAnnotationEventKind, 'cursorEnter' | 'cursorExit'>) => {\n          if (!actions || !item.ref || !linkSource) return;\n          void actions.dispatch({\n            scope: 'annotation',\n            event,\n            ref: item.ref,\n            pon: page.pon,\n            source: linkSource,\n          });\n        };\n        const native = (\n          <a\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={labelOf(item)}\n            aria-label={labelOf(item)}\n            onClick={(e) => {\n              // Modified clicks and middle-clicks on a real href keep their\n              // native browser behaviour (new tab / copy link).\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              // A plain left-click on a real href: let the anchor be an\n              // anchor — native navigation, target=_blank, status bar. Only\n              // non-href targets (goto / named / blocked schemes) route\n              // through the plugin, whose uri outcome the opener PERFORMS\n              // (the old code preventDefault-ed AND dropped the outcome, so\n              // clicking a URL link did nothing at all).\n              if (href) return;\n              e.preventDefault();\n              openLinkTarget(link, item.target, context);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                openLinkTarget(link, item.target, context);\n              }\n            }}\n            onPointerEnter={() => {\n              if (!linkPump || !item.ref || !item.hoverEvents) return;\n              linkPump.hover({\n                ref: item.ref,\n                pon: page.pon,\n                ...(linkSource ? { source: linkSource } : {}),\n                events: item.hoverEvents,\n              });\n            }}\n            onPointerLeave={() => linkPump?.hover(null)}\n            onPointerUp={() => notify('mouseUp')}\n            onFocus={() => notify('focus')}\n            onBlur={() => notify('blur')}\n            // Keep the hub out of it: a down inside the anchor must not reach\n            // the Stage's native listener (same isolation idiom as FreeText).\n            onPointerDown={(e) => {\n              e.stopPropagation();\n              notify('mouseDown');\n            }}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const out = renderLink?.({ item, nativeComponent: native }) ?? native;\n        return <React.Fragment key={item.id}>{out}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\nexport function useLink() {\n  return useCapability(LinkToken);\n}\n"],"mappings":"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"}
+{"version":3,"file":"link.cjs","names":["useOptionalCapability","LinkHostToken","openExternalUri","usePage","useCapability","LinkToken","useStageToken","ActionsToken","useSelector","shallowArray","useOptionalSelector","InteractionToken","React"],"sources":["../src/link.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-link — the navigation plane's paint.\n *\n * One absolutely-positioned <a> per clickable link area, real anchors on\n * purpose: URIs get an `href` (middle-click, copy-link, status-bar preview\n * and keyboard focus for free). A click or a key follows the link through\n * the plugin's `activate()`, so every way of following one fires\n * `onActivated`; the plugin opens websites through the opener this binding\n * registers. The layer stands down entirely while the active tool doesn't\n * enable `link-nav` — the annotation plane owns links then (select / move /\n * resize / retarget through the selection editor).\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-link';\nimport * as React from 'react';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { ActionsToken, createHoverPump } from '@embedpdf/plugin-actions/contract';\nimport { InteractionToken } from '@embedpdf/plugin-interaction/contract/host';\nimport { LinkToken, type Link, type LinkCapability } from '@embedpdf/plugin-link';\n// The layer paints anchors only while a navigation tool is active, and opens\n// websites for the plugin: both host facts.\nimport { LinkToken as LinkHostToken } from '@embedpdf/plugin-link/contract/host';\nimport {\n  hoverLink,\n  isolatePointerDown,\n  isModifiedClick,\n  linkActivateContextOf,\n  linkAnchorOf,\n  navigableLinksOf,\n  openExternalUri,\n  sendLinkEvent,\n} from '@embedpdf/web';\nimport type { EventHook } from '@embedpdf/core';\n\nimport {\n  shallowArray,\n  useCapability,\n  useCapabilityEvent,\n  useOptionalCapability,\n  useOptionalSelector,\n  usePage,\n  useSelector,\n} from './runtime';\nimport { useStageToken } from './stage-scope';\n\n/**\n * A link's anchor. A press inside it must not reach the Stage's native listener (it would start\n * the active tool's gesture, or end an edit as a click outside), so it stops with a native\n * listener on the anchor itself: React's own `onPointerDown` runs from the root, after the Stage\n * has already seen the press. The same listener sends the link's \"mouse down\" action.\n */\nfunction LinkAnchor({\n  onPress,\n  ...props\n}: { onPress: () => void } & React.AnchorHTMLAttributes<HTMLAnchorElement>) {\n  const ref = useRef<HTMLAnchorElement>(null);\n  const press = useRef(onPress);\n  press.current = onPress;\n  useEffect(\n    () => (ref.current ? isolatePointerDown(ref.current, () => press.current()) : undefined),\n    [],\n  );\n  return <a ref={ref} {...props} />;\n}\n\n/**\n * Hand the link plugin this binding's website opener (`openExternalUri`)\n * while the component is mounted: an allowed address opens in a new tab,\n * anything else is refused and the plugin reports it.\n */\nfunction useUriOpener(): void {\n  const host = useOptionalCapability(LinkHostToken);\n  useEffect(() => host?.registerUriOpener(openExternalUri), [host]);\n}\n\n/** What `renderLink` receives for each link. */\nexport interface LinkRenderProps {\n  /** The link: its `id`, its `bounds` on the page and its `target`. */\n  link: Link;\n  /** The layer's own clickable area: wrap it to keep what a click does. */\n  native: React.ReactNode;\n}\n\nexport interface LinkLayerProps {\n  /**\n   * Draw a link yourself, usually around `native`. Return `undefined` for a\n   * link you don't want to change.\n   */\n  renderLink?: (props: LinkRenderProps) => React.ReactNode | undefined;\n}\n\nexport function LinkLayer({ renderLink }: LinkLayerProps = {}) {\n  const page = usePage();\n  const link = useCapability(LinkToken);\n  useUriOpener();\n  // A page destination moves the view this page is shown in.\n  const stage = useOptionalCapability(useStageToken());\n  // The link plane's /AA event feed: links are behavior-inert to the\n  // annotation plane's hover feed while navigable (their pixels are these\n  // anchors), so E/X/D/U/Fo/Bl can only fire from here. One shared pump per\n  // layer — crossing layers still orders Exit before Enter because both\n  // sides submit synchronously in DOM event order.\n  const actions = useOptionalCapability(ActionsToken);\n  const linkPump = useMemo(() => (actions ? createHoverPump(actions.dispatch) : null), [actions]);\n  const items = useSelector(LinkToken, (link) => link.listLinks(page.ref), shallowArray);\n  const engaged = useSelector(LinkHostToken, (link) => link.isNavigationEngaged());\n  // One owner per pixel: an attached link is a property of its parent — while\n  // the active tool can edit annotations, the parent owns those pixels and\n  // the anchor stands down (select/move/resize work; no tooltip, no swallowed\n  // pointer). Standalone document links navigate under any link-nav tool.\n  const editEnabled = useOptionalSelector(\n    InteractionToken,\n    (interaction) => interaction.activeToolEnables('annotation-edit'),\n    false,\n  );\n\n  useEffect(() => {\n    void link.ensureLoaded(page.ref);\n  }, [link, page.ref]);\n\n  // An authoring tool is active → the annotation plane owns links (they're\n  // plain editable rects there); no nav anchors, no swallowed pointer events.\n  if (!engaged || !items.length) return null;\n  const visible = navigableLinksOf(items, editEnabled);\n  if (!visible.length) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {visible.map((item) => {\n        // Its box, its label, and a native href only for a website with nothing chained after it.\n        const { box, href, label } = linkAnchorOf(item, page.transform, (each) =>\n          link.getLabel(each),\n        );\n        const context = linkActivateContextOf(item, page.ref, stage);\n        const native = (\n          <LinkAnchor\n            onPress={() => sendLinkEvent(actions, item, page.ref, 'mouseDown')}\n            href={href ?? undefined}\n            target=\"_blank\"\n            rel=\"noopener noreferrer\"\n            role=\"link\"\n            tabIndex={0}\n            title={label}\n            aria-label={label}\n            onClick={(event) => {\n              // A modified click on a real href keeps the browser's own\n              // behaviour (a background tab, a new window).\n              if (href && isModifiedClick(event)) return;\n              // Every other click follows the link through the plugin, which\n              // opens a website through this binding's opener.\n              event.preventDefault();\n              link.activate(item, context);\n            }}\n            onKeyDown={(event) => {\n              if (event.key === 'Enter' || event.key === ' ') {\n                event.preventDefault();\n                link.activate(item, context);\n              }\n            }}\n            onPointerEnter={() => hoverLink(linkPump, item, page.ref)}\n            onPointerLeave={() => linkPump?.hover(null)}\n            onPointerUp={() => sendLinkEvent(actions, item, page.ref, 'mouseUp')}\n            onFocus={() => sendLinkEvent(actions, item, page.ref, 'focus')}\n            onBlur={() => sendLinkEvent(actions, item, page.ref, 'blur')}\n            style={{\n              position: 'absolute',\n              left: box.left,\n              top: box.top,\n              width: box.width,\n              height: box.height,\n              cursor: 'pointer',\n              pointerEvents: 'auto',\n            }}\n          />\n        );\n        const drawn = renderLink?.({ link: item, native }) ?? native;\n        return <React.Fragment key={item.id}>{drawn}</React.Fragment>;\n      })}\n    </div>\n  );\n}\n\n/**\n * The link capability (`listLinks`, `activate`, …) for app code. While a\n * component uses it, `activate()` opens a website in a new tab.\n */\nexport function useLink(): LinkCapability {\n  useUriOpener();\n  return useCapability(LinkToken);\n}\n\n/** Subscribe to one link event for the mounted lifetime: `useLinkEvent((link) => link.onActivated, handler)`. */\nexport function useLinkEvent<T>(\n  select: (link: LinkCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(LinkToken, select, handler);\n}\n"],"mappings":"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"}

package/dist/link.d.cts

@@ -1,25 +1,30 @@
+import { EventHook } from "@embedpdf/core";
 import * as React from "react";
-import { LinkActivateContext, LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
+import { Link, LinkCapability } from "@embedpdf/plugin-link";
 export * from "@embedpdf/plugin-link";
 //#region src/link.d.ts
-/**
- * Resolve a target through the plugin and PERFORM the `uri` outcome — the ONE
- * place in the codebase that turns a link target into a browser tab. The
- * plugin owns resolution (goto → stage reveal, policy, analytics) and stays
- * DOM-free; opening is this framework layer's job. Every click path — the nav
- * anchors below, the selection menu's "Open link", the style editor's "Go to
- * link" — goes through here, so none of them can drop the uri outcome again.
- */
-declare function openLinkTarget(link: LinkCapability, target: PdfLinkTarget, context?: LinkActivateContext): LinkActivation;
+/** What `renderLink` receives for each link. */
+interface LinkRenderProps {
+  /** The link: its `id`, its `bounds` on the page and its `target`. */
+  link: Link;
+  /** The layer's own clickable area: wrap it to keep what a click does. */
+  native: React.ReactNode;
+}
 interface LinkLayerProps {
-  /** Wrap or replace a link's native anchor (badging, custom tooltips). */
-  renderLink?: (args: {
-    item: LinkNavItem;
-    nativeComponent: React.ReactNode;
-  }) => React.ReactNode | undefined;
+  /**
+   * Draw a link yourself, usually around `native`. Return `undefined` for a
+   * link you don't want to change.
+   */
+  renderLink?: (props: LinkRenderProps) => React.ReactNode | undefined;
 }
 declare function LinkLayer({ renderLink }?: LinkLayerProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * The link capability (`listLinks`, `activate`, …) for app code. While a
+ * component uses it, `activate()` opens a website in a new tab.
+ */
 declare function useLink(): LinkCapability;
+/** Subscribe to one link event for the mounted lifetime: `useLinkEvent((link) => link.onActivated, handler)`. */
+declare function useLinkEvent<T>(select: (link: LinkCapability) => EventHook<T>, handler: (event: T) => void): void;
 //#endregion
-export { LinkLayer, LinkLayerProps, openLinkTarget, useLink };
+export { LinkLayer, LinkLayerProps, LinkRenderProps, useLink, useLinkEvent };
 //# sourceMappingURL=link.d.cts.map