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

package/dist/link.d.ts

@@ -1,25 +1,30 @@
-import * as React from "react";
-import { LinkActivateContext, LinkActivation, LinkCapability, LinkNavItem, PdfLinkTarget } from "@embedpdf/plugin-link";
+import { EventHook } from "@embedpdf/core";
+import * as React$1 from "react";
+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$1.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$1.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.ts.map

package/dist/link.js

@@ -1,71 +1,55 @@
-import "./rolldown-runtime-BBjsoOtd.js";
-import { shallowArray, useCapability, useOptionalCapability, useOptionalSelector, usePage, useSelector } from "./runtime.js";
+import { C as useOptionalSelector, E as useSelector, S as useOptionalCapability, f as useCapability, p as useCapabilityEvent, u as shallowArray, w as usePage } from "./runtime-B6xcPsEb.js";
+import { n as useStageToken } from "./stage-scope-D7ZeNduT.js";
 import { jsx } from "react/jsx-runtime";
-import * as React from "react";
-import { useEffect, useMemo } from "react";
-import { sanitizeExternalUri } from "@embedpdf/web";
-import { InteractionToken } from "@embedpdf/plugin-interaction/contract";
+import { hoverLink, isModifiedClick, isolatePointerDown, linkActivateContextOf, linkAnchorOf, navigableLinksOf, openExternalUri, sendLinkEvent } from "@embedpdf/web";
+import * as React$1 from "react";
+import { useEffect, useMemo, useRef } from "react";
+import { InteractionToken } from "@embedpdf/plugin-interaction/contract/host";
 import { LinkToken } from "@embedpdf/plugin-link";
 import { ActionsToken, createHoverPump } from "@embedpdf/plugin-actions/contract";
+import { LinkToken as LinkToken$1 } from "@embedpdf/plugin-link/contract/host";
 export * from "@embedpdf/plugin-link";
 //#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 = 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
-	});
-	const br = page.transform.toPixels({
-		x: item.rect.x + item.rect.width,
-		y: item.rect.y + item.rect.height
+function LinkAnchor({ onPress, ...props }) {
+	const ref = useRef(null);
+	const press = useRef(onPress);
+	press.current = onPress;
+	useEffect(() => ref.current ? isolatePointerDown(ref.current, () => press.current()) : void 0, []);
+	return /* @__PURE__ */ jsx("a", {
+		ref,
+		...props
 	});
-	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 = useOptionalCapability(LinkToken$1);
+	useEffect(() => host?.registerUriOpener(openExternalUri), [host]);
 }
 function LinkLayer({ renderLink } = {}) {
 	const page = usePage();
 	const link = useCapability(LinkToken);
+	useUriOpener();
+	const stage = useOptionalCapability(useStageToken());
 	const actions = useOptionalCapability(ActionsToken);
 	const linkPump = useMemo(() => actions ? createHoverPump(actions.dispatch) : null, [actions]);
-	const items = useSelector(LinkToken, (c) => c.linksOn(page.pon), shallowArray);
-	const engaged = useSelector(LinkToken, (c) => c.engaged());
-	const editEnabled = useOptionalSelector(InteractionToken, (c) => c.activeTool()?.enables.has("annotation-edit") ?? false, false);
+	const items = useSelector(LinkToken, (link) => link.listLinks(page.ref), shallowArray);
+	const engaged = useSelector(LinkToken$1, (link) => link.isNavigationEngaged());
+	const editEnabled = useOptionalSelector(InteractionToken, (interaction) => interaction.activeToolEnables("annotation-edit"), false);
 	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 = navigableLinksOf(items, editEnabled);
 	if (!visible.length) return null;
 	return /* @__PURE__ */ jsx("div", {
 		style: {
@@ -74,66 +58,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 ? 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__ */ jsx("a", {
+			const { box, href, label } = linkAnchorOf(item, page.transform, (each) => link.getLabel(each));
+			const context = linkActivateContextOf(item, page.ref, stage);
+			const native = /* @__PURE__ */ jsx(LinkAnchor, {
+				onPress: () => 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 && 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: () => 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: () => sendLinkEvent(actions, item, page.ref, "mouseUp"),
+				onFocus: () => sendLinkEvent(actions, item, page.ref, "focus"),
+				onBlur: () => sendLinkEvent(actions, item, page.ref, "blur"),
 				style: {
 					position: "absolute",
 					left: box.left,
@@ -144,18 +95,27 @@ function LinkLayer({ renderLink } = {}) {
 					pointerEvents: "auto"
 				}
 			});
-			const out = renderLink?.({
-				item,
-				nativeComponent: native
+			const drawn = renderLink?.({
+				link: item,
+				native
 			}) ?? native;
-			return /* @__PURE__ */ jsx(React.Fragment, { children: out }, item.id);
+			return /* @__PURE__ */ jsx(React$1.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 useCapability(LinkToken);
 }
+/** Subscribe to one link event for the mounted lifetime: `useLinkEvent((link) => link.onActivated, handler)`. */
+function useLinkEvent(select, handler) {
+	useCapabilityEvent(LinkToken, select, handler);
+}
 //#endregion
-export { LinkLayer, openLinkTarget, useLink };
+export { LinkLayer, useLink, useLinkEvent };
 
 //# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":[],"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.js","names":["LinkHostToken","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/measurement.cjs

@@ -1,23 +1,48 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
+const require_runtime = require("./runtime-fzpGv78v.cjs");
+const require_state = require("./state-CsfZy_Eq.cjs");
 let _embedpdf_plugin_measurement = require("@embedpdf/plugin-measurement");
 //#region src/measurement.tsx
+/** The measurement capability: scales, calibration, readouts and creating measurements. */
 function useMeasurement() {
-	const cap = require_runtime.useCapability(_embedpdf_plugin_measurement.MeasurementToken);
-	const busy = require_runtime.useSelector(_embedpdf_plugin_measurement.MeasurementToken, (c) => c.isBusy());
-	const canCalibratePage = require_runtime.useSelector(_embedpdf_plugin_measurement.MeasurementToken, (c) => c.canCalibrate());
-	return {
-		...cap,
-		busy,
-		canCalibratePage
-	};
+	return require_runtime.useCapability(_embedpdf_plugin_measurement.MeasurementToken);
+}
+/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */
+function useMeasurementEvent(select, handler) {
+	require_runtime.useCapabilityEvent(_embedpdf_plugin_measurement.MeasurementToken, select, handler);
+}
+/**
+* The measurement state: whether a scale change runs, the calibration
+* request waiting for its length, and the last change's reports (the page's
+* State table, declared once in `measurementState`). Takes a selector, and
+* re-renders only when what it returns changes.
+*/
+const useMeasurementState = require_state.stateHook(_embedpdf_plugin_measurement.measurementState);
+/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */
+const useMeasurementSettings = require_state.settingsHook(_embedpdf_plugin_measurement.MeasurementToken);
+function usePageScale(page) {
+	const scoped = require_runtime.useDocumentScope();
+	return require_runtime.useKernelValue((kernel) => {
+		if (page === null) return null;
+		return kernel.tryCapability(_embedpdf_plugin_measurement.MeasurementToken, scoped ?? void 0)?.getPageScale(page) ?? _embedpdf_plugin_measurement.NO_PAGE_SCALE;
+	});
+}
+/**
+* A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.
+* Readouts are reference-stable in the plugin, so this re-renders only when the measurement's
+* changes.
+*/
+function useMeasurementReadout(ref) {
+	const scoped = require_runtime.useDocumentScope();
+	return require_runtime.useKernelValue((kernel) => kernel.tryCapability(_embedpdf_plugin_measurement.MeasurementToken, scoped ?? void 0)?.getReadout(ref) ?? _embedpdf_plugin_measurement.NO_READOUT);
 }
-const usePageScale = (pon) => require_runtime.useSelector(_embedpdf_plugin_measurement.MeasurementToken, (c) => c.pageScale(pon));
-const useMeasurementReadout = (ref) => require_runtime.useSelector(_embedpdf_plugin_measurement.MeasurementToken, (c) => c.readout(ref), (a, b) => JSON.stringify(a) === JSON.stringify(b));
 //#endregion
 exports.useMeasurement = useMeasurement;
+exports.useMeasurementEvent = useMeasurementEvent;
 exports.useMeasurementReadout = useMeasurementReadout;
+exports.useMeasurementSettings = useMeasurementSettings;
+exports.useMeasurementState = useMeasurementState;
 exports.usePageScale = usePageScale;
 Object.keys(_embedpdf_plugin_measurement).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {

package/dist/measurement.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"measurement.cjs","names":["useCapability","MeasurementToken","useSelector"],"sources":["../src/measurement.tsx"],"sourcesContent":["import { MeasurementToken } from '@embedpdf/plugin-measurement';\nimport type { MeasurementCapability } from '@embedpdf/plugin-measurement';\nimport type { AnnotationRef } from '@embedpdf/plugin-measurement';\nimport { useCapability, useSelector } from './runtime';\n\nexport * from '@embedpdf/plugin-measurement';\n\nexport function useMeasurement(): MeasurementCapability & {\n  busy: boolean;\n  canCalibratePage: boolean;\n} {\n  const cap = useCapability(MeasurementToken);\n  const busy = useSelector(MeasurementToken, (c) => c.isBusy());\n  const canCalibratePage = useSelector(MeasurementToken, (c) => c.canCalibrate());\n  return { ...cap, busy, canCalibratePage };\n}\n\nexport const usePageScale = (pon: number) => useSelector(MeasurementToken, (c) => c.pageScale(pon));\n\nexport const useMeasurementReadout = (ref: AnnotationRef) =>\n  useSelector(\n    MeasurementToken,\n    (c) => c.readout(ref),\n    (a, b) => JSON.stringify(a) === JSON.stringify(b),\n  );\n"],"mappings":";;;;;AAOA,SAAgB,iBAGd;CACA,MAAM,MAAMA,gBAAAA,cAAcC,6BAAAA,gBAAgB;CAC1C,MAAM,OAAOC,gBAAAA,YAAYD,6BAAAA,mBAAmB,MAAM,EAAE,OAAO,CAAC;CAC5D,MAAM,mBAAmBC,gBAAAA,YAAYD,6BAAAA,mBAAmB,MAAM,EAAE,aAAa,CAAC;CAC9E,OAAO;EAAE,GAAG;EAAK;EAAM;CAAiB;AAC1C;AAEA,MAAa,gBAAgB,QAAgBC,gBAAAA,YAAYD,6BAAAA,mBAAmB,MAAM,EAAE,UAAU,GAAG,CAAC;AAElG,MAAa,yBAAyB,QACpCC,gBAAAA,YACED,6BAAAA,mBACC,MAAM,EAAE,QAAQ,GAAG,IACnB,GAAG,MAAM,KAAK,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,CAClD"}
+{"version":3,"file":"measurement.cjs","names":["useCapability","MeasurementToken","stateHook","measurementState","settingsHook","useDocumentScope","useKernelValue","NO_PAGE_SCALE","NO_READOUT"],"sources":["../src/measurement.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-measurement: the four hooks every\n * plugin has, plus one per page scale and one per measurement, so a\n * component re-renders only for its own page or measurement. Every hook\n * works before a document opens.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-measurement';\nimport type { EventHook, PageRef } from '@embedpdf/core';\nimport {\n  MeasurementToken,\n  measurementState,\n  NO_PAGE_SCALE,\n  NO_READOUT,\n} from '@embedpdf/plugin-measurement';\nimport type {\n  AnnotationRef,\n  MeasurementCapability,\n  MeasurementReadout,\n  MeasurementUnavailable,\n  PageScale,\n} from '@embedpdf/plugin-measurement';\nimport { useCapability, useCapabilityEvent, useDocumentScope, useKernelValue } from './runtime';\nimport { settingsHook, stateHook } from './state';\n\n/** The measurement capability: scales, calibration, readouts and creating measurements. */\nexport function useMeasurement(): MeasurementCapability {\n  return useCapability(MeasurementToken);\n}\n\n/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */\nexport function useMeasurementEvent<T>(\n  select: (measurement: MeasurementCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(MeasurementToken, select, handler);\n}\n\n/**\n * The measurement state: whether a scale change runs, the calibration\n * request waiting for its length, and the last change's reports (the page's\n * State table, declared once in `measurementState`). Takes a selector, and\n * re-renders only when what it returns changes.\n */\nexport const useMeasurementState = stateHook(measurementState);\n\n/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */\nexport const useMeasurementSettings = settingsHook(MeasurementToken);\n\n/**\n * A page's measurement scale (its ref or its index), for a scale bar or a\n * \"1:100\" badge. Accepts `null` (no current page) and answers `null` then,\n * so chrome can stay mounted without inventing a page.\n */\nexport function usePageScale(page: PageRef | number): PageScale;\nexport function usePageScale(page: PageRef | number | null): PageScale | null;\nexport function usePageScale(page: PageRef | number | null): PageScale | null {\n  const scoped = useDocumentScope();\n  // Scales are reference-stable in the plugin, so this re-renders only when this page's changes.\n  return useKernelValue((kernel) => {\n    if (page === null) return null;\n    return (\n      kernel.tryCapability(MeasurementToken, scoped ?? undefined)?.getPageScale(page) ??\n      NO_PAGE_SCALE\n    );\n  });\n}\n\n/**\n * A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.\n * Readouts are reference-stable in the plugin, so this re-renders only when the measurement's\n * changes.\n */\nexport function useMeasurementReadout(\n  ref: AnnotationRef,\n): MeasurementReadout | MeasurementUnavailable {\n  const scoped = useDocumentScope();\n  return useKernelValue(\n    (kernel) =>\n      kernel.tryCapability(MeasurementToken, scoped ?? undefined)?.getReadout(ref) ?? NO_READOUT,\n  );\n}\n"],"mappings":";;;;;;;AA2BA,SAAgB,iBAAwC;CACtD,OAAOA,gBAAAA,cAAcC,6BAAAA,gBAAgB;AACvC;;AAGA,SAAgB,oBACd,QACA,SACM;CACN,gBAAA,mBAAmBA,6BAAAA,kBAAkB,QAAQ,OAAO;AACtD;;;;;;;AAQA,MAAa,sBAAsBC,cAAAA,UAAUC,6BAAAA,gBAAgB;;AAG7D,MAAa,yBAAyBC,cAAAA,aAAaH,6BAAAA,gBAAgB;AASnE,SAAgB,aAAa,MAAiD;CAC5E,MAAM,SAASI,gBAAAA,iBAAiB;CAEhC,OAAOC,gBAAAA,gBAAgB,WAAW;EAChC,IAAI,SAAS,MAAM,OAAO;EAC1B,OACE,OAAO,cAAcL,6BAAAA,kBAAkB,UAAU,KAAA,CAAS,CAAC,EAAE,aAAa,IAAI,KAC9EM,6BAAAA;CAEJ,CAAC;AACH;;;;;;AAOA,SAAgB,sBACd,KAC6C;CAC7C,MAAM,SAASF,gBAAAA,iBAAiB;CAChC,OAAOC,gBAAAA,gBACJ,WACC,OAAO,cAAcL,6BAAAA,kBAAkB,UAAU,KAAA,CAAS,CAAC,EAAE,WAAW,GAAG,KAAKO,6BAAAA,UACpF;AACF"}

package/dist/measurement.d.cts

@@ -1,12 +1,38 @@
-import { AnnotationRef, MeasurementCapability } from "@embedpdf/plugin-measurement";
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.cjs";
+import { EventHook, PageRef } from "@embedpdf/core";
+import { AnnotationRef, MeasurementCapability, MeasurementReadout, MeasurementUnavailable, PageScale } from "@embedpdf/plugin-measurement";
 export * from "@embedpdf/plugin-measurement";
 //#region src/measurement.d.ts
-declare function useMeasurement(): MeasurementCapability & {
+/** The measurement capability: scales, calibration, readouts and creating measurements. */
+declare function useMeasurement(): MeasurementCapability;
+/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */
+declare function useMeasurementEvent<T>(select: (measurement: MeasurementCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The measurement state: whether a scale change runs, the calibration
+ * request waiting for its length, and the last change's reports (the page's
+ * State table, declared once in `measurementState`). Takes a selector, and
+ * re-renders only when what it returns changes.
+ */
+declare const useMeasurementState: StateHook<{
   busy: boolean;
-  canCalibratePage: boolean;
-};
-declare const usePageScale: (pon: number) => import("@embedpdf/plugin-measurement").PageScale;
-declare const useMeasurementReadout: (ref: AnnotationRef) => import("@embedpdf/plugin-measurement").MeasurementReadout | import("@embedpdf/plugin-measurement").MeasurementUnavailable;
+  calibrationRequest: import("@embedpdf/plugin-measurement").CalibrationRequest | null;
+  lastReports: readonly import("@embedpdf/plugin-measurement").ScaleChangeReport[];
+}>;
+/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */
+declare const useMeasurementSettings: SettingsHook<import("@embedpdf/plugin-measurement").MeasurementSettings>;
+/**
+ * A page's measurement scale (its ref or its index), for a scale bar or a
+ * "1:100" badge. Accepts `null` (no current page) and answers `null` then,
+ * so chrome can stay mounted without inventing a page.
+ */
+declare function usePageScale(page: PageRef | number): PageScale;
+declare function usePageScale(page: PageRef | number | null): PageScale | null;
+/**
+ * A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.
+ * Readouts are reference-stable in the plugin, so this re-renders only when the measurement's
+ * changes.
+ */
+declare function useMeasurementReadout(ref: AnnotationRef): MeasurementReadout | MeasurementUnavailable;
 //#endregion
-export { useMeasurement, useMeasurementReadout, usePageScale };
+export { useMeasurement, useMeasurementEvent, useMeasurementReadout, useMeasurementSettings, useMeasurementState, usePageScale };
 //# sourceMappingURL=measurement.d.cts.map

package/dist/measurement.d.ts

@@ -1,12 +1,38 @@
-import { AnnotationRef, MeasurementCapability } from "@embedpdf/plugin-measurement";
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.js";
+import { EventHook, PageRef } from "@embedpdf/core";
+import { AnnotationRef, MeasurementCapability, MeasurementReadout, MeasurementUnavailable, PageScale } from "@embedpdf/plugin-measurement";
 export * from "@embedpdf/plugin-measurement";
 //#region src/measurement.d.ts
-declare function useMeasurement(): MeasurementCapability & {
+/** The measurement capability: scales, calibration, readouts and creating measurements. */
+declare function useMeasurement(): MeasurementCapability;
+/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */
+declare function useMeasurementEvent<T>(select: (measurement: MeasurementCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The measurement state: whether a scale change runs, the calibration
+ * request waiting for its length, and the last change's reports (the page's
+ * State table, declared once in `measurementState`). Takes a selector, and
+ * re-renders only when what it returns changes.
+ */
+declare const useMeasurementState: StateHook<{
   busy: boolean;
-  canCalibratePage: boolean;
-};
-declare const usePageScale: (pon: number) => import("@embedpdf/plugin-measurement").PageScale;
-declare const useMeasurementReadout: (ref: AnnotationRef) => import("@embedpdf/plugin-measurement").MeasurementReadout | import("@embedpdf/plugin-measurement").MeasurementUnavailable;
+  calibrationRequest: import("@embedpdf/plugin-measurement").CalibrationRequest | null;
+  lastReports: readonly import("@embedpdf/plugin-measurement").ScaleChangeReport[];
+}>;
+/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */
+declare const useMeasurementSettings: SettingsHook<import("@embedpdf/plugin-measurement").MeasurementSettings>;
+/**
+ * A page's measurement scale (its ref or its index), for a scale bar or a
+ * "1:100" badge. Accepts `null` (no current page) and answers `null` then,
+ * so chrome can stay mounted without inventing a page.
+ */
+declare function usePageScale(page: PageRef | number): PageScale;
+declare function usePageScale(page: PageRef | number | null): PageScale | null;
+/**
+ * A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.
+ * Readouts are reference-stable in the plugin, so this re-renders only when the measurement's
+ * changes.
+ */
+declare function useMeasurementReadout(ref: AnnotationRef): MeasurementReadout | MeasurementUnavailable;
 //#endregion
-export { useMeasurement, useMeasurementReadout, usePageScale };
+export { useMeasurement, useMeasurementEvent, useMeasurementReadout, useMeasurementSettings, useMeasurementState, usePageScale };
 //# sourceMappingURL=measurement.d.ts.map

package/dist/measurement.js

@@ -1,21 +1,42 @@
-import "./rolldown-runtime-BBjsoOtd.js";
-import { useCapability, useSelector } from "./runtime.js";
-import { MeasurementToken } from "@embedpdf/plugin-measurement";
+import { f as useCapability, g as useDocumentScope, p as useCapabilityEvent, x as useKernelValue } from "./runtime-B6xcPsEb.js";
+import { n as stateHook, t as settingsHook } from "./state-CbgxhwLA.js";
+import { MeasurementToken, NO_PAGE_SCALE, NO_READOUT, measurementState } from "@embedpdf/plugin-measurement";
 export * from "@embedpdf/plugin-measurement";
 //#region src/measurement.tsx
+/** The measurement capability: scales, calibration, readouts and creating measurements. */
 function useMeasurement() {
-	const cap = useCapability(MeasurementToken);
-	const busy = useSelector(MeasurementToken, (c) => c.isBusy());
-	const canCalibratePage = useSelector(MeasurementToken, (c) => c.canCalibrate());
-	return {
-		...cap,
-		busy,
-		canCalibratePage
-	};
+	return useCapability(MeasurementToken);
+}
+/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */
+function useMeasurementEvent(select, handler) {
+	useCapabilityEvent(MeasurementToken, select, handler);
+}
+/**
+* The measurement state: whether a scale change runs, the calibration
+* request waiting for its length, and the last change's reports (the page's
+* State table, declared once in `measurementState`). Takes a selector, and
+* re-renders only when what it returns changes.
+*/
+const useMeasurementState = stateHook(measurementState);
+/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */
+const useMeasurementSettings = settingsHook(MeasurementToken);
+function usePageScale(page) {
+	const scoped = useDocumentScope();
+	return useKernelValue((kernel) => {
+		if (page === null) return null;
+		return kernel.tryCapability(MeasurementToken, scoped ?? void 0)?.getPageScale(page) ?? NO_PAGE_SCALE;
+	});
+}
+/**
+* A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.
+* Readouts are reference-stable in the plugin, so this re-renders only when the measurement's
+* changes.
+*/
+function useMeasurementReadout(ref) {
+	const scoped = useDocumentScope();
+	return useKernelValue((kernel) => kernel.tryCapability(MeasurementToken, scoped ?? void 0)?.getReadout(ref) ?? NO_READOUT);
 }
-const usePageScale = (pon) => useSelector(MeasurementToken, (c) => c.pageScale(pon));
-const useMeasurementReadout = (ref) => useSelector(MeasurementToken, (c) => c.readout(ref), (a, b) => JSON.stringify(a) === JSON.stringify(b));
 //#endregion
-export { useMeasurement, useMeasurementReadout, usePageScale };
+export { useMeasurement, useMeasurementEvent, useMeasurementReadout, useMeasurementSettings, useMeasurementState, usePageScale };
 
 //# sourceMappingURL=measurement.js.map

package/dist/measurement.js.map

@@ -1 +1 @@
-{"version":3,"file":"measurement.js","names":[],"sources":["../src/measurement.tsx"],"sourcesContent":["import { MeasurementToken } from '@embedpdf/plugin-measurement';\nimport type { MeasurementCapability } from '@embedpdf/plugin-measurement';\nimport type { AnnotationRef } from '@embedpdf/plugin-measurement';\nimport { useCapability, useSelector } from './runtime';\n\nexport * from '@embedpdf/plugin-measurement';\n\nexport function useMeasurement(): MeasurementCapability & {\n  busy: boolean;\n  canCalibratePage: boolean;\n} {\n  const cap = useCapability(MeasurementToken);\n  const busy = useSelector(MeasurementToken, (c) => c.isBusy());\n  const canCalibratePage = useSelector(MeasurementToken, (c) => c.canCalibrate());\n  return { ...cap, busy, canCalibratePage };\n}\n\nexport const usePageScale = (pon: number) => useSelector(MeasurementToken, (c) => c.pageScale(pon));\n\nexport const useMeasurementReadout = (ref: AnnotationRef) =>\n  useSelector(\n    MeasurementToken,\n    (c) => c.readout(ref),\n    (a, b) => JSON.stringify(a) === JSON.stringify(b),\n  );\n"],"mappings":";;;;;AAOA,SAAgB,iBAGd;CACA,MAAM,MAAM,cAAc,gBAAgB;CAC1C,MAAM,OAAO,YAAY,mBAAmB,MAAM,EAAE,OAAO,CAAC;CAC5D,MAAM,mBAAmB,YAAY,mBAAmB,MAAM,EAAE,aAAa,CAAC;CAC9E,OAAO;EAAE,GAAG;EAAK;EAAM;CAAiB;AAC1C;AAEA,MAAa,gBAAgB,QAAgB,YAAY,mBAAmB,MAAM,EAAE,UAAU,GAAG,CAAC;AAElG,MAAa,yBAAyB,QACpC,YACE,mBACC,MAAM,EAAE,QAAQ,GAAG,IACnB,GAAG,MAAM,KAAK,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,CAClD"}
+{"version":3,"file":"measurement.js","names":[],"sources":["../src/measurement.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-measurement: the four hooks every\n * plugin has, plus one per page scale and one per measurement, so a\n * component re-renders only for its own page or measurement. Every hook\n * works before a document opens.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-measurement';\nimport type { EventHook, PageRef } from '@embedpdf/core';\nimport {\n  MeasurementToken,\n  measurementState,\n  NO_PAGE_SCALE,\n  NO_READOUT,\n} from '@embedpdf/plugin-measurement';\nimport type {\n  AnnotationRef,\n  MeasurementCapability,\n  MeasurementReadout,\n  MeasurementUnavailable,\n  PageScale,\n} from '@embedpdf/plugin-measurement';\nimport { useCapability, useCapabilityEvent, useDocumentScope, useKernelValue } from './runtime';\nimport { settingsHook, stateHook } from './state';\n\n/** The measurement capability: scales, calibration, readouts and creating measurements. */\nexport function useMeasurement(): MeasurementCapability {\n  return useCapability(MeasurementToken);\n}\n\n/** Subscribe to one measurement event for the mounted lifetime: `useMeasurementEvent((measurement) => measurement.onScaleChanged, handler)`. */\nexport function useMeasurementEvent<T>(\n  select: (measurement: MeasurementCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(MeasurementToken, select, handler);\n}\n\n/**\n * The measurement state: whether a scale change runs, the calibration\n * request waiting for its length, and the last change's reports (the page's\n * State table, declared once in `measurementState`). Takes a selector, and\n * re-renders only when what it returns changes.\n */\nexport const useMeasurementState = stateHook(measurementState);\n\n/** The measurement settings (`defaultScale`, `presets`), with or without a document. Takes a selector. */\nexport const useMeasurementSettings = settingsHook(MeasurementToken);\n\n/**\n * A page's measurement scale (its ref or its index), for a scale bar or a\n * \"1:100\" badge. Accepts `null` (no current page) and answers `null` then,\n * so chrome can stay mounted without inventing a page.\n */\nexport function usePageScale(page: PageRef | number): PageScale;\nexport function usePageScale(page: PageRef | number | null): PageScale | null;\nexport function usePageScale(page: PageRef | number | null): PageScale | null {\n  const scoped = useDocumentScope();\n  // Scales are reference-stable in the plugin, so this re-renders only when this page's changes.\n  return useKernelValue((kernel) => {\n    if (page === null) return null;\n    return (\n      kernel.tryCapability(MeasurementToken, scoped ?? undefined)?.getPageScale(page) ??\n      NO_PAGE_SCALE\n    );\n  });\n}\n\n/**\n * A measurement's `{ kind, value, label }`, or `{ unavailable }` with why there's none.\n * Readouts are reference-stable in the plugin, so this re-renders only when the measurement's\n * changes.\n */\nexport function useMeasurementReadout(\n  ref: AnnotationRef,\n): MeasurementReadout | MeasurementUnavailable {\n  const scoped = useDocumentScope();\n  return useKernelValue(\n    (kernel) =>\n      kernel.tryCapability(MeasurementToken, scoped ?? undefined)?.getReadout(ref) ?? NO_READOUT,\n  );\n}\n"],"mappings":";;;;;;AA2BA,SAAgB,iBAAwC;CACtD,OAAO,cAAc,gBAAgB;AACvC;;AAGA,SAAgB,oBACd,QACA,SACM;CACN,mBAAmB,kBAAkB,QAAQ,OAAO;AACtD;;;;;;;AAQA,MAAa,sBAAsB,UAAU,gBAAgB;;AAG7D,MAAa,yBAAyB,aAAa,gBAAgB;AASnE,SAAgB,aAAa,MAAiD;CAC5E,MAAM,SAAS,iBAAiB;CAEhC,OAAO,gBAAgB,WAAW;EAChC,IAAI,SAAS,MAAM,OAAO;EAC1B,OACE,OAAO,cAAc,kBAAkB,UAAU,KAAA,CAAS,CAAC,EAAE,aAAa,IAAI,KAC9E;CAEJ,CAAC;AACH;;;;;;AAOA,SAAgB,sBACd,KAC6C;CAC7C,MAAM,SAAS,iBAAiB;CAChC,OAAO,gBACJ,WACC,OAAO,cAAc,kBAAkB,UAAU,KAAA,CAAS,CAAC,EAAE,WAAW,GAAG,KAAK,UACpF;AACF"}