@embedpdf/react 3.0.0-next.0

package/dist/interaction.cjs

@@ -0,0 +1,152 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
+const require_runtime = require("./runtime.cjs");
+let react_jsx_runtime = require("react/jsx-runtime");
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react, 1);
+let _embedpdf_plugin_interaction = require("@embedpdf/plugin-interaction");
+let _embedpdf_web = require("@embedpdf/web");
+//#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 = require_runtime.usePage();
+	const interaction = require_runtime.useCapability(_embedpdf_plugin_interaction.InteractionToken);
+	const cursor = require_runtime.useSelector(_embedpdf_plugin_interaction.InteractionToken, (c) => c.cursor());
+	const ref = (0, react.useRef)(null);
+	(0, react.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.toPagePoint(e.clientX, e.clientY),
+					scale: page.transform.viewScale,
+					rotation: page.transform.rotation,
+					zoom: page.transform.zoom
+				},
+				project: (pon) => pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null,
+				modifiers: mods(e),
+				clickCount
+			};
+		};
+		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);
+		};
+	}, [interaction, page]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref,
+		style: {
+			position: "absolute",
+			inset: 0,
+			cursor,
+			touchAction: "none"
+		}
+	});
+}
+/** Read + switch the active tool (for a toolbar). */
+function useTool() {
+	const interaction = require_runtime.useCapability(_embedpdf_plugin_interaction.InteractionToken);
+	return {
+		activeToolId: require_runtime.useSelector(_embedpdf_plugin_interaction.InteractionToken, (c) => c.activeToolId()),
+		activate: interaction.activateTool,
+		tools: interaction.tools()
+	};
+}
+const toCursor = (img, fallback) => typeof img === "string" ? img : (0, _embedpdf_web.svgCursor)(img.fallback === void 0 && fallback ? {
+	...img,
+	fallback
+} : img);
+/**
+* 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.
+*/
+function useToolCursor(spec) {
+	const interaction = require_runtime.useCapability(_embedpdf_plugin_interaction.InteractionToken);
+	const key = spec && JSON.stringify(spec);
+	const ref = (0, react.useRef)(spec);
+	ref.current = spec;
+	(0, react.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);
+	}, [interaction, key]);
+}
+//#endregion
+exports.PagePointerSource = PagePointerSource;
+exports.createClickCounter = createClickCounter;
+exports.useTool = useTool;
+exports.useToolCursor = useToolCursor;
+Object.keys(_embedpdf_plugin_interaction).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _embedpdf_plugin_interaction[k];
+		}
+	});
+});
+
+//# sourceMappingURL=interaction.cjs.map

package/dist/interaction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.cjs","names":["usePage","useCapability","InteractionToken","useSelector"],"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.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\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.toPagePoint(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 — toPagePoint 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.toPagePoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\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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"}

package/dist/interaction.d.cts

@@ -0,0 +1,46 @@
+import { SvgCursorOptions } from "@embedpdf/web";
+export * from "@embedpdf/plugin-interaction";
+//#region src/interaction.d.ts
+/**
+ * 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.
+ */
+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>;
+}
+/**
+ * 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.
+ */
+declare function useToolCursor(spec: ToolCursorSpec | null): void;
+//#endregion
+export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor };
+//# sourceMappingURL=interaction.d.cts.map

package/dist/interaction.d.ts

@@ -0,0 +1,46 @@
+import { SvgCursorOptions } from "@embedpdf/web";
+export * from "@embedpdf/plugin-interaction";
+//#region src/interaction.d.ts
+/**
+ * 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.
+ */
+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>;
+}
+/**
+ * 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.
+ */
+declare function useToolCursor(spec: ToolCursorSpec | null): void;
+//#endregion
+export { PagePointerSource, ToolCursorImage, ToolCursorSpec, createClickCounter, useTool, useToolCursor };
+//# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.js

@@ -0,0 +1,139 @@
+import { useCapability, usePage, useSelector } from "./runtime.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { InteractionToken } from "@embedpdf/plugin-interaction";
+import { svgCursor } from "@embedpdf/web";
+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 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.toPagePoint(e.clientX, e.clientY),
+					scale: page.transform.viewScale,
+					rotation: page.transform.rotation,
+					zoom: page.transform.zoom
+				},
+				project: (pon) => pon === page.pon ? page.toPagePoint(e.clientX, e.clientY) : null,
+				modifiers: mods(e),
+				clickCount
+			};
+		};
+		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);
+		};
+	}, [interaction, page]);
+	return /* @__PURE__ */ jsx("div", {
+		ref,
+		style: {
+			position: "absolute",
+			inset: 0,
+			cursor,
+			touchAction: "none"
+		}
+	});
+}
+/** 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()
+	};
+}
+const toCursor = (img, fallback) => typeof img === "string" ? img : svgCursor(img.fallback === void 0 && fallback ? {
+	...img,
+	fallback
+} : img);
+/**
+* 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.
+*/
+function useToolCursor(spec) {
+	const interaction = useCapability(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);
+	}, [interaction, key]);
+}
+//#endregion
+export { PagePointerSource, createClickCounter, useTool, useToolCursor };
+
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

@@ -0,0 +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.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.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-interaction';\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.toPagePoint(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 — toPagePoint 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.toPagePoint(e.clientX, e.clientY) : null),\n        modifiers: mods(e),\n        clickCount,\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":";;;;;;;AAoBA,MAAM,QAAQ,OAAgC;CAC5C,OAAO,EAAE;CACT,KAAK,EAAE;CACP,MAAM,EAAE;CACR,MAAM,EAAE;AACV;;;;;;AAOA,SAAgB,mBAAmB,WAAW,KAAK,YAAY,GAAG;CAChE,IAAI,OAAO;CACX,IAAI,KAAK;CACT,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,QAAQ,KAAa,GAAW,MAAsB;EACpD,QAAQ,MAAM,QAAQ,YAAY,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,KAAK,YAAY,QAAQ,IAAI;EACxF,OAAO;EACP,KAAK;EACL,KAAK;EACL,OAAO;CACT;AACF;AAEA,SAAgB,oBAAoB;CAClC,MAAM,OAAO,QAAQ;CACrB,MAAM,cAAc,cAAc,gBAAgB;CAClD,MAAM,SAAS,YAAY,mBAAmB,MAAM,EAAE,OAAO,CAAC;CAC9D,MAAM,MAAM,OAAuB,IAAI;CAEvC,gBAAgB;EACd,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,SAAS,mBAAmB;EAClC,MAAM,UACJ,OACA,GACA,aAAa,MACK;GAClB,MAAM,IAAI,GAAG,sBAAsB;GACnC,OAAO;IACL;IACA,UAAU;KAAE,GAAG,EAAE,UAAU,EAAE;KAAM,GAAG,EAAE,UAAU,EAAE;IAAI;IAIxD,MAAM;KACJ,KAAK,KAAK;KACV,OAAO,KAAK,YAAY,EAAE,SAAS,EAAE,OAAO;KAC5C,OAAO,KAAK,UAAU;KACtB,UAAU,KAAK,UAAU;KACzB,MAAM,KAAK,UAAU;IACvB;IAIA,UAAU,QAAS,QAAQ,KAAK,MAAM,KAAK,YAAY,EAAE,SAAS,EAAE,OAAO,IAAI;IAC/E,WAAW,KAAK,CAAC;IACjB;GACF;EACF;EACA,IAAI,WAAW;EAEf,MAAM,QAAQ,MAAoB;GAChC,IAAI,EAAE,WAAW,GAAG;GACpB,WAAW;GACX,YAAY,SAAS,OAAO,QAAQ,GAAG,OAAO,KAAK,IAAI,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;EAClF;EAEA,MAAM,SAAS,MAAoB;GACjC,IAAI,UAAU;GACd,YAAY,SAAS,OAAO,QAAQ,CAAC,CAAC;EACxC;EAEA,MAAM,QAAQ,MAAoB;GAChC,IAAI,CAAC,UAAU;GACf,YAAY,SAAS,OAAO,QAAQ,CAAC,CAAC;EACxC;EACA,MAAM,MAAM,MAAoB;GAC9B,IAAI,CAAC,UAAU;GACf,WAAW;GACX,YAAY,SAAS,OAAO,MAAM,CAAC,CAAC;EACtC;EAEA,GAAG,iBAAiB,eAAe,IAAI;EACvC,GAAG,iBAAiB,eAAe,KAAK;EACxC,OAAO,iBAAiB,eAAe,IAAI;EAC3C,OAAO,iBAAiB,aAAa,EAAE;EACvC,aAAa;GACX,GAAG,oBAAoB,eAAe,IAAI;GAC1C,GAAG,oBAAoB,eAAe,KAAK;GAC3C,OAAO,oBAAoB,eAAe,IAAI;GAC9C,OAAO,oBAAoB,aAAa,EAAE;EAC5C;CACF,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,UAAU;CACxB,MAAM,cAAc,cAAc,gBAAgB;CAElD,OAAO;EACL,cAFmB,YAAY,mBAAmB,MAAM,EAAE,aAAa,CAE5D;EACX,UAAU,YAAY;EACtB,OAAO,YAAY,MAAM;CAC3B;AACF;AAoBA,MAAM,YAAY,KAAsB,aACtC,OAAO,QAAQ,WACX,MACA,UAAU,IAAI,aAAa,KAAA,KAAa,WAAW;CAAE,GAAG;CAAK;AAAS,IAAI,GAAG;;;;;;;;;;;AAYnF,SAAgB,cAAc,MAAmC;CAC/D,MAAM,cAAc,cAAc,gBAAgB;CAGlD,MAAM,MAAM,QAAQ,KAAK,UAAU,IAAI;CACvC,MAAM,MAAM,OAAO,IAAI;CACvB,IAAI,UAAU;CACd,gBAAgB;EACd,MAAM,IAAI,IAAI;EACd,IAAI,CAAC,GAAG;EACR,YAAY,cACV,EAAE,QACF,OAAO,YAAY,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CACnF;EACA,aAAa,YAAY,cAAc,EAAE,QAAQ,IAAI;CACvD,GAAG,CAAC,aAAa,GAAG,CAAC;AACvB"}

package/dist/link.cjs

@@ -0,0 +1,108 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
+const require_runtime = require("./runtime.cjs");
+let react_jsx_runtime = require("react/jsx-runtime");
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react, 1);
+let _embedpdf_web = require("@embedpdf/web");
+let _embedpdf_plugin_link = require("@embedpdf/plugin-link");
+//#region src/link.tsx
+/** 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.pageToContent({
+		x: item.rect.x,
+		y: item.rect.y
+	});
+	const br = page.transform.pageToContent({
+		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";
+	}
+}
+function LinkLayer({ renderLink } = {}) {
+	const page = require_runtime.usePage();
+	const link = require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
+	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());
+	(0, react.useEffect)(() => {
+		link.ensurePage(page.pon);
+	}, [link, page.pon]);
+	if (!engaged || !items.length) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		style: {
+			position: "absolute",
+			inset: 0,
+			pointerEvents: "none"
+		},
+		children: items.map((item) => {
+			const box = boxOf(item, page);
+			const native = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+				href: (item.target.kind === "uri" ? (0, _embedpdf_web.sanitizeExternalUri)(item.target.uri) : null) ?? 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;
+					e.preventDefault();
+					link.activate(item.target);
+				},
+				onKeyDown: (e) => {
+					if (e.key === "Enter" || e.key === " ") {
+						e.preventDefault();
+						link.activate(item.target);
+					}
+				},
+				onPointerDown: (e) => e.stopPropagation(),
+				style: {
+					position: "absolute",
+					left: box.left,
+					top: box.top,
+					width: box.width,
+					height: box.height,
+					cursor: "pointer",
+					pointerEvents: "auto"
+				}
+			});
+			const out = renderLink?.({
+				item,
+				nativeComponent: native
+			}) ?? native;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: out }, item.id);
+		})
+	});
+}
+function useLink() {
+	return require_runtime.useCapability(_embedpdf_plugin_link.LinkToken);
+}
+//#endregion
+exports.LinkLayer = LinkLayer;
+exports.useLink = useLink;
+Object.keys(_embedpdf_plugin_link).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _embedpdf_plugin_link[k];
+		}
+	});
+});
+
+//# sourceMappingURL=link.cjs.map

package/dist/link.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.cjs","names":["usePage","useCapability","LinkToken","useSelector","shallowArray","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 } from 'react';\nimport { LinkToken, type LinkNavItem } from '@embedpdf/plugin-link';\nimport { sanitizeExternalUri } from '@embedpdf/web';\n\nimport { shallowArray, useCapability, usePage, useSelector } from './runtime';\nimport type { PageContextValue } from './runtime';\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.pageToContent({ x: item.rect.x, y: item.rect.y });\n  const br = page.transform.pageToContent({\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  const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);\n  const engaged = useSelector(LinkToken, (c) => c.engaged());\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\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {items.map((item) => {\n        const box = boxOf(item, page);\n        // Real href ONLY for sanitized external URIs; blocked schemes and\n        // internal targets activate through the plugin instead.\n        const href = item.target.kind === 'uri' ? sanitizeExternalUri(item.target.uri) : null;\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              // Plain left-click activates through the plugin (stage reveal /\n              // policy / analytics). Modified clicks and middle-clicks on a\n              // real href keep their native browser behaviour.\n              if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;\n              e.preventDefault();\n              link.activate(item.target);\n            }}\n            onKeyDown={(e) => {\n              if (e.key === 'Enter' || e.key === ' ') {\n                e.preventDefault();\n                link.activate(item.target);\n              }\n            }}\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) => e.stopPropagation()}\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":";;;;;;;;;;;AAuBA,SAAS,MAAM,MAAmB,MAAwB;CACxD,MAAM,KAAK,KAAK,UAAU,cAAc;EAAE,GAAG,KAAK,KAAK;EAAG,GAAG,KAAK,KAAK;CAAE,CAAC;CAC1E,MAAM,KAAK,KAAK,UAAU,cAAc;EACtC,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK;EAC3B,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK;CAC7B,CAAC;CACD,OAAO;EAAE,MAAM,GAAG;EAAG,KAAK,GAAG;EAAG,OAAO,GAAG,IAAI,GAAG;EAAG,QAAQ,GAAG,IAAI,GAAG;CAAE;AAC1E;;;AAIA,SAAS,QAAQ,MAA2B;CAC1C,QAAQ,KAAK,OAAO,MAApB;EACE,KAAK,OACH,OAAO,KAAK,OAAO;EACrB,KAAK,QACH,OAAO;EACT,KAAK,SACH,OAAO,KAAK,OAAO;EACrB,SACE,OAAO;CACX;AACF;AAUA,SAAgB,UAAU,EAAE,eAA+B,CAAC,GAAG;CAC7D,MAAM,OAAOA,gBAAAA,QAAQ;CACrB,MAAM,OAAOC,gBAAAA,cAAcC,sBAAAA,SAAS;CACpC,MAAM,QAAQC,gBAAAA,YAAYD,sBAAAA,YAAY,MAAM,EAAE,QAAQ,KAAK,GAAG,GAAGE,gBAAAA,YAAY;CAC7E,MAAM,UAAUD,gBAAAA,YAAYD,sBAAAA,YAAY,MAAM,EAAE,QAAQ,CAAC;CAEzD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,KAAK,WAAW,KAAK,GAAG;CAC1B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;CAInB,IAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,OAAO;CAEtC,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG,eAAe;EAAO;EACjE,UAAA,MAAM,KAAK,SAAS;GACnB,MAAM,MAAM,MAAM,MAAM,IAAI;GAI5B,MAAM,SACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,KAAD;IACE,OAHS,KAAK,OAAO,SAAS,SAAA,GAAA,cAAA,oBAAA,CAA4B,KAAK,OAAO,GAAG,IAAI,SAG/D,KAAA;IACd,QAAO;IACP,KAAI;IACJ,MAAK;IACL,UAAU;IACV,OAAO,QAAQ,IAAI;IACnB,cAAY,QAAQ,IAAI;IACxB,UAAU,MAAM;KAId,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ;KACtD,EAAE,eAAe;KACjB,KAAK,SAAS,KAAK,MAAM;IAC3B;IACA,YAAY,MAAM;KAChB,IAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;MACtC,EAAE,eAAe;MACjB,KAAK,SAAS,KAAK,MAAM;KAC3B;IACF;IAGA,gBAAgB,MAAM,EAAE,gBAAgB;IACxC,OAAO;KACL,UAAU;KACV,MAAM,IAAI;KACV,KAAK,IAAI;KACT,OAAO,IAAI;KACX,QAAQ,IAAI;KACZ,QAAQ;KACR,eAAe;IACjB;GACD,CAAA;GAEH,MAAM,MAAM,aAAa;IAAE;IAAM,iBAAiB;GAAO,CAAC,KAAK;GAC/D,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAACG,MAAM,UAAP,EAAA,UAA+B,IAAoB,GAA9B,KAAK,EAAyB;EAC5D,CAAC;CACE,CAAA;AAET;AAEA,SAAgB,UAAU;CACxB,OAAOJ,gBAAAA,cAAcC,sBAAAA,SAAS;AAChC"}

package/dist/link.d.cts

@@ -0,0 +1,16 @@
+import * as React from "react";
+import { LinkNavItem } from "@embedpdf/plugin-link";
+export * from "@embedpdf/plugin-link";
+//#region src/link.d.ts
+interface LinkLayerProps {
+  /** Wrap or replace a link's native anchor (badging, custom tooltips). */
+  renderLink?: (args: {
+    item: LinkNavItem;
+    nativeComponent: React.ReactNode;
+  }) => React.ReactNode | undefined;
+}
+declare function LinkLayer({ renderLink }?: LinkLayerProps): import("react/jsx-runtime").JSX.Element | null;
+declare function useLink(): import("@embedpdf/plugin-link").LinkCapability;
+//#endregion
+export { LinkLayer, LinkLayerProps, useLink };
+//# sourceMappingURL=link.d.cts.map

package/dist/link.d.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+import { LinkNavItem } from "@embedpdf/plugin-link";
+export * from "@embedpdf/plugin-link";
+//#region src/link.d.ts
+interface LinkLayerProps {
+  /** Wrap or replace a link's native anchor (badging, custom tooltips). */
+  renderLink?: (args: {
+    item: LinkNavItem;
+    nativeComponent: React.ReactNode;
+  }) => React.ReactNode | undefined;
+}
+declare function LinkLayer({ renderLink }?: LinkLayerProps): import("react/jsx-runtime").JSX.Element | null;
+declare function useLink(): import("@embedpdf/plugin-link").LinkCapability;
+//#endregion
+export { LinkLayer, LinkLayerProps, useLink };
+//# sourceMappingURL=link.d.ts.map