@embedpdf/react 3.0.0-next.1 → 3.0.0-next.11

package/dist/anchored.cjs

@@ -0,0 +1,89 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
+let react_jsx_runtime = require("react/jsx-runtime");
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react, 1);
+let react_dom = require("react-dom");
+let _embedpdf_web = require("@embedpdf/web");
+//#region src/anchored.tsx
+/**
+* Anchored overlays — ONE primitive for every piece of UI that floats over
+* page content (selection menus, draft menus, future popovers).
+*
+* The factoring:
+*   - PLUGINS produce anchors (a content-space rect on a page, plus points
+*     to dodge) as capability reads.
+*   - The projection SNAPSHOT contract and the placement math are shared,
+*     framework-neutral, in `@embedpdf/web` ({@link ViewProjector},
+*     `projectAnchoredTarget`).
+*   - SURFACES (<Stage>, <PageView>) provide a {@link ProjectorBinding}:
+*     the snapshot plus REACT's way of knowing when it changed.
+*   - <Anchored> renders at the projected position, isolates pointer
+*     events, and portals when the space demands it.
+*
+* THE SCHEDULING LAW (this is what keeps menus glued to the content): a
+* state-driven projection change (the Stage camera) reaches consumers as a
+* NEW BINDING IDENTITY through context — surface and overlay re-render in
+* the SAME React commit, so they can never paint a frame apart. No
+* listener sets, no post-commit notifications, no second menu-only render.
+* `subscribe` exists ONLY for genuinely browser-driven invalidation (a
+* PageView moving because the document scrolled), where no state change
+* announces the move.
+*/
+const ProjectorContext = (0, react.createContext)(null);
+/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */
+const ProjectorProvider = ProjectorContext.Provider;
+/** The surface's projector binding. Reading it subscribes the caller to
+*  projection changes (the binding's identity IS the revision). */
+function useProjectorBinding() {
+	const binding = (0, react.useContext)(ProjectorContext);
+	if (!binding) throw new Error("No ViewProjector in scope: mount anchored UI under <Stage> (overlay slot) or <PageView>.");
+	return binding;
+}
+/**
+* Position `children` around a content-space anchor, on whichever page
+* surface is in scope. Projection runs during render from the shared pure
+* helper; pointer isolation keeps a click inside anchored UI from reaching
+* the surface's own listener (which would read it as click-outside).
+*/
+function Anchored({ anchor, placement = "top", gap = 8, children }) {
+	const { projector, subscribe } = useProjectorBinding();
+	const [, force] = (0, react.useReducer)((x) => x + 1, 0);
+	(0, react.useLayoutEffect)(() => subscribe ? subscribe(force) : void 0, [subscribe]);
+	(0, react.useLayoutEffect)(() => {
+		if (projector.space === "client") force();
+	}, [projector, anchor]);
+	const ref = (0, react.useRef)(null);
+	(0, react.useEffect)(() => {
+		const el = ref.current;
+		if (!el) return;
+		const stop = (e) => e.stopPropagation();
+		el.addEventListener("pointerdown", stop);
+		return () => el.removeEventListener("pointerdown", stop);
+	});
+	if (!anchor) return null;
+	const pos = (0, _embedpdf_web.projectAnchoredTarget)(projector, anchor, placement, gap);
+	if (!pos) return null;
+	const node = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref,
+		style: {
+			position: projector.space === "client" ? "fixed" : "absolute",
+			left: pos.left,
+			top: pos.top,
+			transform: pos.transform,
+			pointerEvents: "auto"
+		},
+		children
+	});
+	if (projector.space === "client") {
+		if (typeof document === "undefined") return null;
+		return (0, react_dom.createPortal)(node, document.body);
+	}
+	return node;
+}
+//#endregion
+exports.Anchored = Anchored;
+exports.ProjectorProvider = ProjectorProvider;
+exports.useProjectorBinding = useProjectorBinding;
+
+//# sourceMappingURL=anchored.cjs.map

package/dist/anchored.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.cjs","names":[],"sources":["../src/anchored.tsx"],"sourcesContent":["/**\n * Anchored overlays — ONE primitive for every piece of UI that floats over\n * page content (selection menus, draft menus, future popovers).\n *\n * The factoring:\n *   - PLUGINS produce anchors (a content-space rect on a page, plus points\n *     to dodge) as capability reads.\n *   - The projection SNAPSHOT contract and the placement math are shared,\n *     framework-neutral, in `@embedpdf/web` ({@link ViewProjector},\n *     `projectAnchoredTarget`).\n *   - SURFACES (<Stage>, <PageView>) provide a {@link ProjectorBinding}:\n *     the snapshot plus REACT's way of knowing when it changed.\n *   - <Anchored> renders at the projected position, isolates pointer\n *     events, and portals when the space demands it.\n *\n * THE SCHEDULING LAW (this is what keeps menus glued to the content): a\n * state-driven projection change (the Stage camera) reaches consumers as a\n * NEW BINDING IDENTITY through context — surface and overlay re-render in\n * the SAME React commit, so they can never paint a frame apart. No\n * listener sets, no post-commit notifications, no second menu-only render.\n * `subscribe` exists ONLY for genuinely browser-driven invalidation (a\n * PageView moving because the document scrolled), where no state change\n * announces the move.\n */\nimport * as React from 'react';\nimport { createContext, useContext, useEffect, useLayoutEffect, useReducer, useRef } from 'react';\nimport { createPortal } from 'react-dom';\nimport {\n  projectAnchoredTarget,\n  type AnchoredPlacement,\n  type AnchorTarget,\n  type ViewProjector,\n} from '@embedpdf/web';\n\nexport type { AnchoredPlacement, AnchorTarget, ViewProjector } from '@embedpdf/web';\n\n/**\n * What a page surface provides via context: the pure projection snapshot,\n * bound to React's reactivity.\n */\nexport interface ProjectorBinding {\n  projector: ViewProjector;\n  /**\n   * Changes identity exactly when projection may have changed for\n   * STATE-driven reasons — the Stage uses its `visiblePages()` value (a\n   * stable reference that already folds camera, viewport, scene and DPR).\n   * Consumers re-render because the binding's identity changes with it;\n   * nothing reads this field, but it is what makes the memoized binding\n   * change, so do not \"optimize\" it away.\n   */\n  revision: unknown;\n  /** Browser-driven invalidation ONLY (PageView scroll/resize — see\n   *  `observeClientGeometry`). The Stage deliberately provides none. */\n  subscribe?: (callback: () => void) => () => void;\n}\n\nconst ProjectorContext = createContext<ProjectorBinding | null>(null);\n\n/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */\nexport const ProjectorProvider = ProjectorContext.Provider;\n\n/** The surface's projector binding. Reading it subscribes the caller to\n *  projection changes (the binding's identity IS the revision). */\nexport function useProjectorBinding(): ProjectorBinding {\n  const binding = useContext(ProjectorContext);\n  if (!binding) {\n    throw new Error(\n      'No ViewProjector in scope: mount anchored UI under <Stage> (overlay slot) or <PageView>.',\n    );\n  }\n  return binding;\n}\n\nexport interface AnchoredProps {\n  anchor: AnchorTarget | null;\n  /** Which side of the anchor to sit on. Default 'top'. */\n  placement?: AnchoredPlacement;\n  /** Gap in screen px between the anchor box and the content. Default 8. */\n  gap?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Position `children` around a content-space anchor, on whichever page\n * surface is in scope. Projection runs during render from the shared pure\n * helper; pointer isolation keeps a click inside anchored UI from reaching\n * the surface's own listener (which would read it as click-outside).\n */\nexport function Anchored({ anchor, placement = 'top', gap = 8, children }: AnchoredProps) {\n  const { projector, subscribe } = useProjectorBinding();\n\n  // Browser-driven invalidation only (PageView). State-driven changes come\n  // through the binding identity — no local bump involved.\n  const [, force] = useReducer((x: number) => x + 1, 0);\n  useLayoutEffect(() => (subscribe ? subscribe(force) : undefined), [subscribe]);\n  // Client-space surfaces measure the DOM, which does not exist during the\n  // surface's first render — force one post-commit pass so the position\n  // appears as soon as it is measurable. (Solves measurability, not\n  // reactivity.)\n  useLayoutEffect(() => {\n    if (projector.space === 'client') force();\n  }, [projector, anchor]);\n\n  const ref = useRef<HTMLDivElement>(null);\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const stop = (e: Event) => e.stopPropagation();\n    el.addEventListener('pointerdown', stop);\n    return () => el.removeEventListener('pointerdown', stop);\n  });\n\n  if (!anchor) return null;\n  const pos = projectAnchoredTarget(projector, anchor, placement, gap);\n  if (!pos) return null;\n\n  const node = (\n    <div\n      ref={ref}\n      style={{\n        position: projector.space === 'client' ? 'fixed' : 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children}\n    </div>\n  );\n  if (projector.space === 'client') {\n    if (typeof document === 'undefined') return null;\n    return createPortal(node, document.body);\n  }\n  return node;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,MAAM,oBAAA,GAAA,MAAA,cAAA,CAA0D,IAAI;;AAGpE,MAAa,oBAAoB,iBAAiB;;;AAIlD,SAAgB,sBAAwC;CACtD,MAAM,WAAA,GAAA,MAAA,WAAA,CAAqB,gBAAgB;CAC3C,IAAI,CAAC,SACH,MAAM,IAAI,MACR,0FACF;CAEF,OAAO;AACT;;;;;;;AAiBA,SAAgB,SAAS,EAAE,QAAQ,YAAY,OAAO,MAAM,GAAG,YAA2B;CACxF,MAAM,EAAE,WAAW,cAAc,oBAAoB;CAIrD,MAAM,GAAG,UAAA,GAAA,MAAA,WAAA,EAAqB,MAAc,IAAI,GAAG,CAAC;CACpD,CAAA,GAAA,MAAA,gBAAA,OAAuB,YAAY,UAAU,KAAK,IAAI,KAAA,GAAY,CAAC,SAAS,CAAC;CAK7E,CAAA,GAAA,MAAA,gBAAA,OAAsB;EACpB,IAAI,UAAU,UAAU,UAAU,MAAM;CAC1C,GAAG,CAAC,WAAW,MAAM,CAAC;CAEtB,MAAM,OAAA,GAAA,MAAA,OAAA,CAA6B,IAAI;CACvC,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,QAAQ,MAAa,EAAE,gBAAgB;EAC7C,GAAG,iBAAiB,eAAe,IAAI;EACvC,aAAa,GAAG,oBAAoB,eAAe,IAAI;CACzD,CAAC;CAED,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,OAAA,GAAA,cAAA,sBAAA,CAA4B,WAAW,QAAQ,WAAW,GAAG;CACnE,IAAI,CAAC,KAAK,OAAO;CAEjB,MAAM,OACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EACO;EACL,OAAO;GACL,UAAU,UAAU,UAAU,WAAW,UAAU;GACnD,MAAM,IAAI;GACV,KAAK,IAAI;GACT,WAAW,IAAI;GACf,eAAe;EACjB;EAEC;CACE,CAAA;CAEP,IAAI,UAAU,UAAU,UAAU;EAChC,IAAI,OAAO,aAAa,aAAa,OAAO;EAC5C,QAAA,GAAA,UAAA,aAAA,CAAoB,MAAM,SAAS,IAAI;CACzC;CACA,OAAO;AACT"}

package/dist/anchored.d.cts

@@ -0,0 +1,45 @@
+import * as React from "react";
+import { AnchorTarget, AnchorTarget as AnchorTarget$1, AnchoredPlacement, AnchoredPlacement as AnchoredPlacement$1, ViewProjector, ViewProjector as ViewProjector$1 } from "@embedpdf/web";
+//#region src/anchored.d.ts
+/**
+ * What a page surface provides via context: the pure projection snapshot,
+ * bound to React's reactivity.
+ */
+interface ProjectorBinding {
+  projector: ViewProjector$1;
+  /**
+   * Changes identity exactly when projection may have changed for
+   * STATE-driven reasons — the Stage uses its `visiblePages()` value (a
+   * stable reference that already folds camera, viewport, scene and DPR).
+   * Consumers re-render because the binding's identity changes with it;
+   * nothing reads this field, but it is what makes the memoized binding
+   * change, so do not "optimize" it away.
+   */
+  revision: unknown;
+  /** Browser-driven invalidation ONLY (PageView scroll/resize — see
+   *  `observeClientGeometry`). The Stage deliberately provides none. */
+  subscribe?: (callback: () => void) => () => void;
+}
+/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */
+declare const ProjectorProvider: React.Provider<ProjectorBinding | null>;
+/** The surface's projector binding. Reading it subscribes the caller to
+ *  projection changes (the binding's identity IS the revision). */
+declare function useProjectorBinding(): ProjectorBinding;
+interface AnchoredProps {
+  anchor: AnchorTarget$1 | null;
+  /** Which side of the anchor to sit on. Default 'top'. */
+  placement?: AnchoredPlacement$1;
+  /** Gap in screen px between the anchor box and the content. Default 8. */
+  gap?: number;
+  children: React.ReactNode;
+}
+/**
+ * Position `children` around a content-space anchor, on whichever page
+ * surface is in scope. Projection runs during render from the shared pure
+ * helper; pointer isolation keeps a click inside anchored UI from reaching
+ * the surface's own listener (which would read it as click-outside).
+ */
+declare function Anchored({ anchor, placement, gap, children }: AnchoredProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, ProjectorBinding, ProjectorProvider, type ViewProjector, useProjectorBinding };
+//# sourceMappingURL=anchored.d.cts.map

package/dist/anchored.d.ts

@@ -0,0 +1,45 @@
+import * as React from "react";
+import { AnchorTarget, AnchorTarget as AnchorTarget$1, AnchoredPlacement, AnchoredPlacement as AnchoredPlacement$1, ViewProjector, ViewProjector as ViewProjector$1 } from "@embedpdf/web";
+//#region src/anchored.d.ts
+/**
+ * What a page surface provides via context: the pure projection snapshot,
+ * bound to React's reactivity.
+ */
+interface ProjectorBinding {
+  projector: ViewProjector$1;
+  /**
+   * Changes identity exactly when projection may have changed for
+   * STATE-driven reasons — the Stage uses its `visiblePages()` value (a
+   * stable reference that already folds camera, viewport, scene and DPR).
+   * Consumers re-render because the binding's identity changes with it;
+   * nothing reads this field, but it is what makes the memoized binding
+   * change, so do not "optimize" it away.
+   */
+  revision: unknown;
+  /** Browser-driven invalidation ONLY (PageView scroll/resize — see
+   *  `observeClientGeometry`). The Stage deliberately provides none. */
+  subscribe?: (callback: () => void) => () => void;
+}
+/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */
+declare const ProjectorProvider: React.Provider<ProjectorBinding | null>;
+/** The surface's projector binding. Reading it subscribes the caller to
+ *  projection changes (the binding's identity IS the revision). */
+declare function useProjectorBinding(): ProjectorBinding;
+interface AnchoredProps {
+  anchor: AnchorTarget$1 | null;
+  /** Which side of the anchor to sit on. Default 'top'. */
+  placement?: AnchoredPlacement$1;
+  /** Gap in screen px between the anchor box and the content. Default 8. */
+  gap?: number;
+  children: React.ReactNode;
+}
+/**
+ * Position `children` around a content-space anchor, on whichever page
+ * surface is in scope. Projection runs during render from the shared pure
+ * helper; pointer isolation keeps a click inside anchored UI from reaching
+ * the surface's own listener (which would read it as click-outside).
+ */
+declare function Anchored({ anchor, placement, gap, children }: AnchoredProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { type AnchorTarget, Anchored, type AnchoredPlacement, AnchoredProps, ProjectorBinding, ProjectorProvider, type ViewProjector, useProjectorBinding };
+//# sourceMappingURL=anchored.d.ts.map

package/dist/anchored.js

@@ -0,0 +1,60 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useLayoutEffect, useReducer, useRef } from "react";
+import { createPortal } from "react-dom";
+import { projectAnchoredTarget } from "@embedpdf/web";
+//#region src/anchored.tsx
+const ProjectorContext = createContext(null);
+/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */
+const ProjectorProvider = ProjectorContext.Provider;
+/** The surface's projector binding. Reading it subscribes the caller to
+*  projection changes (the binding's identity IS the revision). */
+function useProjectorBinding() {
+	const binding = useContext(ProjectorContext);
+	if (!binding) throw new Error("No ViewProjector in scope: mount anchored UI under <Stage> (overlay slot) or <PageView>.");
+	return binding;
+}
+/**
+* Position `children` around a content-space anchor, on whichever page
+* surface is in scope. Projection runs during render from the shared pure
+* helper; pointer isolation keeps a click inside anchored UI from reaching
+* the surface's own listener (which would read it as click-outside).
+*/
+function Anchored({ anchor, placement = "top", gap = 8, children }) {
+	const { projector, subscribe } = useProjectorBinding();
+	const [, force] = useReducer((x) => x + 1, 0);
+	useLayoutEffect(() => subscribe ? subscribe(force) : void 0, [subscribe]);
+	useLayoutEffect(() => {
+		if (projector.space === "client") force();
+	}, [projector, anchor]);
+	const ref = useRef(null);
+	useEffect(() => {
+		const el = ref.current;
+		if (!el) return;
+		const stop = (e) => e.stopPropagation();
+		el.addEventListener("pointerdown", stop);
+		return () => el.removeEventListener("pointerdown", stop);
+	});
+	if (!anchor) return null;
+	const pos = projectAnchoredTarget(projector, anchor, placement, gap);
+	if (!pos) return null;
+	const node = /* @__PURE__ */ jsx("div", {
+		ref,
+		style: {
+			position: projector.space === "client" ? "fixed" : "absolute",
+			left: pos.left,
+			top: pos.top,
+			transform: pos.transform,
+			pointerEvents: "auto"
+		},
+		children
+	});
+	if (projector.space === "client") {
+		if (typeof document === "undefined") return null;
+		return createPortal(node, document.body);
+	}
+	return node;
+}
+//#endregion
+export { Anchored, ProjectorProvider, useProjectorBinding };
+
+//# sourceMappingURL=anchored.js.map

package/dist/anchored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.js","names":[],"sources":["../src/anchored.tsx"],"sourcesContent":["/**\n * Anchored overlays — ONE primitive for every piece of UI that floats over\n * page content (selection menus, draft menus, future popovers).\n *\n * The factoring:\n *   - PLUGINS produce anchors (a content-space rect on a page, plus points\n *     to dodge) as capability reads.\n *   - The projection SNAPSHOT contract and the placement math are shared,\n *     framework-neutral, in `@embedpdf/web` ({@link ViewProjector},\n *     `projectAnchoredTarget`).\n *   - SURFACES (<Stage>, <PageView>) provide a {@link ProjectorBinding}:\n *     the snapshot plus REACT's way of knowing when it changed.\n *   - <Anchored> renders at the projected position, isolates pointer\n *     events, and portals when the space demands it.\n *\n * THE SCHEDULING LAW (this is what keeps menus glued to the content): a\n * state-driven projection change (the Stage camera) reaches consumers as a\n * NEW BINDING IDENTITY through context — surface and overlay re-render in\n * the SAME React commit, so they can never paint a frame apart. No\n * listener sets, no post-commit notifications, no second menu-only render.\n * `subscribe` exists ONLY for genuinely browser-driven invalidation (a\n * PageView moving because the document scrolled), where no state change\n * announces the move.\n */\nimport * as React from 'react';\nimport { createContext, useContext, useEffect, useLayoutEffect, useReducer, useRef } from 'react';\nimport { createPortal } from 'react-dom';\nimport {\n  projectAnchoredTarget,\n  type AnchoredPlacement,\n  type AnchorTarget,\n  type ViewProjector,\n} from '@embedpdf/web';\n\nexport type { AnchoredPlacement, AnchorTarget, ViewProjector } from '@embedpdf/web';\n\n/**\n * What a page surface provides via context: the pure projection snapshot,\n * bound to React's reactivity.\n */\nexport interface ProjectorBinding {\n  projector: ViewProjector;\n  /**\n   * Changes identity exactly when projection may have changed for\n   * STATE-driven reasons — the Stage uses its `visiblePages()` value (a\n   * stable reference that already folds camera, viewport, scene and DPR).\n   * Consumers re-render because the binding's identity changes with it;\n   * nothing reads this field, but it is what makes the memoized binding\n   * change, so do not \"optimize\" it away.\n   */\n  revision: unknown;\n  /** Browser-driven invalidation ONLY (PageView scroll/resize — see\n   *  `observeClientGeometry`). The Stage deliberately provides none. */\n  subscribe?: (callback: () => void) => () => void;\n}\n\nconst ProjectorContext = createContext<ProjectorBinding | null>(null);\n\n/** Installed by page surfaces (<Stage>, <PageView>) — not by app code. */\nexport const ProjectorProvider = ProjectorContext.Provider;\n\n/** The surface's projector binding. Reading it subscribes the caller to\n *  projection changes (the binding's identity IS the revision). */\nexport function useProjectorBinding(): ProjectorBinding {\n  const binding = useContext(ProjectorContext);\n  if (!binding) {\n    throw new Error(\n      'No ViewProjector in scope: mount anchored UI under <Stage> (overlay slot) or <PageView>.',\n    );\n  }\n  return binding;\n}\n\nexport interface AnchoredProps {\n  anchor: AnchorTarget | null;\n  /** Which side of the anchor to sit on. Default 'top'. */\n  placement?: AnchoredPlacement;\n  /** Gap in screen px between the anchor box and the content. Default 8. */\n  gap?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Position `children` around a content-space anchor, on whichever page\n * surface is in scope. Projection runs during render from the shared pure\n * helper; pointer isolation keeps a click inside anchored UI from reaching\n * the surface's own listener (which would read it as click-outside).\n */\nexport function Anchored({ anchor, placement = 'top', gap = 8, children }: AnchoredProps) {\n  const { projector, subscribe } = useProjectorBinding();\n\n  // Browser-driven invalidation only (PageView). State-driven changes come\n  // through the binding identity — no local bump involved.\n  const [, force] = useReducer((x: number) => x + 1, 0);\n  useLayoutEffect(() => (subscribe ? subscribe(force) : undefined), [subscribe]);\n  // Client-space surfaces measure the DOM, which does not exist during the\n  // surface's first render — force one post-commit pass so the position\n  // appears as soon as it is measurable. (Solves measurability, not\n  // reactivity.)\n  useLayoutEffect(() => {\n    if (projector.space === 'client') force();\n  }, [projector, anchor]);\n\n  const ref = useRef<HTMLDivElement>(null);\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const stop = (e: Event) => e.stopPropagation();\n    el.addEventListener('pointerdown', stop);\n    return () => el.removeEventListener('pointerdown', stop);\n  });\n\n  if (!anchor) return null;\n  const pos = projectAnchoredTarget(projector, anchor, placement, gap);\n  if (!pos) return null;\n\n  const node = (\n    <div\n      ref={ref}\n      style={{\n        position: projector.space === 'client' ? 'fixed' : 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children}\n    </div>\n  );\n  if (projector.space === 'client') {\n    if (typeof document === 'undefined') return null;\n    return createPortal(node, document.body);\n  }\n  return node;\n}\n"],"mappings":";;;;;AAwDA,MAAM,mBAAmB,cAAuC,IAAI;;AAGpE,MAAa,oBAAoB,iBAAiB;;;AAIlD,SAAgB,sBAAwC;CACtD,MAAM,UAAU,WAAW,gBAAgB;CAC3C,IAAI,CAAC,SACH,MAAM,IAAI,MACR,0FACF;CAEF,OAAO;AACT;;;;;;;AAiBA,SAAgB,SAAS,EAAE,QAAQ,YAAY,OAAO,MAAM,GAAG,YAA2B;CACxF,MAAM,EAAE,WAAW,cAAc,oBAAoB;CAIrD,MAAM,GAAG,SAAS,YAAY,MAAc,IAAI,GAAG,CAAC;CACpD,sBAAuB,YAAY,UAAU,KAAK,IAAI,KAAA,GAAY,CAAC,SAAS,CAAC;CAK7E,sBAAsB;EACpB,IAAI,UAAU,UAAU,UAAU,MAAM;CAC1C,GAAG,CAAC,WAAW,MAAM,CAAC;CAEtB,MAAM,MAAM,OAAuB,IAAI;CACvC,gBAAgB;EACd,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,QAAQ,MAAa,EAAE,gBAAgB;EAC7C,GAAG,iBAAiB,eAAe,IAAI;EACvC,aAAa,GAAG,oBAAoB,eAAe,IAAI;CACzD,CAAC;CAED,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,MAAM,sBAAsB,WAAW,QAAQ,WAAW,GAAG;CACnE,IAAI,CAAC,KAAK,OAAO;CAEjB,MAAM,OACJ,oBAAC,OAAD;EACO;EACL,OAAO;GACL,UAAU,UAAU,UAAU,WAAW,UAAU;GACnD,MAAM,IAAI;GACV,KAAK,IAAI;GACT,WAAW,IAAI;GACf,eAAe;EACjB;EAEC;CACE,CAAA;CAEP,IAAI,UAAU,UAAU,UAAU;EAChC,IAAI,OAAO,aAAa,aAAa,OAAO;EAC5C,OAAO,aAAa,MAAM,SAAS,IAAI;CACzC;CACA,OAAO;AACT"}

package/dist/{annotation-B6jwfTCh.d.cts → annotation-BCED_p9H.d.cts}

@@ -1,11 +1,20 @@
-import { t as AnnotationDTO } from "./AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.cjs";
-import { o as PageContextValue } from "./runtime-CMxIuF2O.cjs";
-import { Behavior, FilePickerProvider, SelectionFlags, SelectionFlags as SelectionFlags$1, SelectionProps, SelectionProps as SelectionProps$1 } from "@embedpdf/plugin-annotation";
+import { d as runtime_d_exports, o as PageContextValue } from "./runtime-umHA_xHt.cjs";
 import * as React from "react";
-import { AnnotationFlags, AnnotationProps, AnnotationProps as AnnotationProps$1, AnnotationPropsPatch, AnnotationPropsPatch as AnnotationPropsPatch$1, Border, CreationDraftAnchor, Geom, LineEnding, LineEndings, PropKey, PropSpec, Rect, RenderItem, RenderItem as RenderItem$1, Style, TextAlign, TextStyle, Vec } from "@embedpdf/core-annotation";
-import { Rect as Rect$1 } from "@embedpdf/core-geometry";
-//#region src/internal/annotation-menu-position.d.ts
-type AnnotationMenuPlacement = 'top' | 'right' | 'bottom' | 'left';
+import { AnnotationFlags, AnnotationProps, AnnotationProps as AnnotationProps$1, AnnotationPropsPatch, Border, CreationDraftAnchor, CreationDraftAnchor as CreationDraftAnchor$1, Geom, LineEnding, LineEndings, PropKey, PropSpec, Rect, RenderItem, RenderItem as RenderItem$1, Style, TextAlign, TextStyle, Vec } from "@embedpdf/core-annotation";
+import { AnnotationHydration, AnnotationRef, Behavior, CommentThread, CommentsApi, FilePickerProvider, SelectionFlags, SelectionFlags as SelectionFlags$1, SelectionProps, SelectionProps as SelectionProps$1 } from "@embedpdf/plugin-annotation";
+//#region src/annotation-anchors.d.ts
+/** The selection's menu anchor on its primary page, in content space. */
+type SelectionAnchor = {
+  pon: number;
+  bounds: Rect;
+  knob?: Vec;
+};
+declare function sameAnchor(a: SelectionAnchor | null, b: SelectionAnchor | null): boolean;
+declare function sameCreationDraftAnchor(a: CreationDraftAnchor | null, b: CreationDraftAnchor | null): boolean;
+//#endregion
+//#region src/annotation-hooks.d.ts
+/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */
+declare function useAnnotationSelected(): import("@embedpdf/plugin-annotation").AnnotationDTO[];
 //#endregion
 //#region src/annotation.d.ts
 /**
@@ -81,8 +90,6 @@ declare const filePickerProvider: FilePickerProvider;
 declare function useFilePickerProvider(provider?: FilePickerProvider | null): void;
 declare function useAnnotation(): import("@embedpdf/plugin-annotation").AnnotationCapability;
 declare function useAnnotationSelection(): string[];
-/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */
-declare function useAnnotationSelected(): AnnotationDTO[];
 /**
  * A tool's RESOLVED defaults (base + per-tool override) as a full flat props
  * bag, subscribed so a `setDefaults` re-renders the consumer. Use this — not the
@@ -107,67 +114,47 @@ declare function useSelectionProps(): SelectionProps;
  * between model changes, like {@link useSelectionProps}.
  */
 declare function useSelectionFlags(): SelectionFlags | null;
-/** The selection's menu anchor: the primary page + the union box of the selection
- *  on that page (content space). */
-type SelectionAnchor = {
-  pon: number;
-  bounds: Rect;
-  knob?: Vec;
-};
-/** Structural equality for the selection anchor — keeps the menu from re-rendering
- *  on unrelated dispatches (the capability returns a fresh object each call). */
-declare function sameAnchor(a: SelectionAnchor | null, b: SelectionAnchor | null): boolean;
-/** What a menu's render prop receives: the live selection (engine DTOs) + the
- *  selection-scoped intents. Fully headless — you render all UI. */
-interface AnnotationMenuRenderArgs {
-  selected: ReturnType<typeof useAnnotationSelected>;
-  deleteSelection: () => void;
-  deselect: () => void;
-  /** Restyle the selection with a flat props patch (see `useSelectionProps`). */
-  updateSelection: (patch: AnnotationPropsPatch) => void;
-  /** Rotate the current selection a quarter-turn clockwise about its centre. */
-  rotate90: () => void;
-  /** Reset the current selection to its as-authored orientation. */
-  resetRotation: () => void;
-  /** Group the current selection into one unit (selecting any member then
-   *  selects all). */
-  group: () => Promise<void>;
-  /** Ungroup the group(s) the current selection touches. */
-  ungroup: () => Promise<void>;
-  /** Whether {@link group} would do something for the current selection. */
-  canGroup: boolean;
-  /** Whether {@link ungroup} would do something for the current selection. */
-  canUngroup: boolean;
-}
-interface AnnotationMenuProps {
-  children: (args: AnnotationMenuRenderArgs) => React.ReactNode;
-  /** Gap in screen px between the selection box and the menu (default 8). */
-  gap?: number;
-  /** Where to place the menu relative to the selection box. Default 'top'. */
-  placement?: AnnotationMenuPlacement;
-}
-declare function sameCreationDraftAnchor(a: CreationDraftAnchor | null, b: CreationDraftAnchor | null): boolean;
-interface AnnotationDraftMenuRenderArgs extends CreationDraftAnchor {
-  finish: () => void;
-  cancel: () => void;
-}
-interface AnnotationDraftMenuProps {
-  children: (args: AnnotationDraftMenuRenderArgs) => React.ReactNode;
-  /** Gap in screen px between the draft anchor and the menu (default 8). */
-  gap?: number;
-  /** Where to place the menu relative to the draft anchor. Default 'top'. */
-  placement?: AnnotationMenuPlacement;
+/**
+ * A {@link CommentThread} enriched with its page's live display position —
+ * the framework-layer join. Identity stays `pageObjectNumber` (like every
+ * annotation surface); these two fields are PRESENTATION, tracking page
+ * moves and deletes.
+ */
+interface CommentThreadView extends CommentThread {
+  /** Current 0-based display index of the thread's page; `-1` when the page
+   *  is no longer in the document (one-frame teardown race on delete). */
+  pageIndex: number;
+  /** The page's `/PageLabels` label when the PDF declares one ("iv", "A-2"),
+   *  else the 1-based position as a string — print it verbatim. */
+  pageLabel: string;
+  /**
+   * The root annotation's rect in CONTENT space (y-down, crop-relative,
+   * unscaled points) — the space `StageCapability.reveal` takes, so a
+   * "jump to this comment" is `stage.reveal(pageIndex, { rect: contentRect })`.
+   * Null when the page is gone. Identity still travels as `pageObjectNumber`;
+   * this, like `pageIndex`, is presentation.
+   */
+  contentRect: Rect | null;
 }
+/** Pure join behind {@link useCommentThreads} — exported for tests. */
+declare function enrichCommentThreads(threads: readonly CommentThread[], pages: readonly runtime_d_exports.PageLayout[]): CommentThreadView[];
+/** The comments surface (verbs + `permissionsFor`) — imperative; pair with
+ *  {@link useCommentThreads} for the subscribed view. */
+declare function useComments(): CommentsApi;
 /**
- * The Stage-FREE selection menu, for `<PageView>` (no camera). It transforms a
- * selected content rect to client px via `page.toClientRect`, then renders an
- * UPRIGHT menu through a portal to
- * `document.body` (so it never rotates with the page nor clips at a container
- * edge). Re-measures on scroll/resize. For `<Stage>`, prefer `<AnnotationMenu>`
- * from `@embedpdf/react/annotation-menu` (camera-driven, more responsive).
+ * Every comment thread in the document, display-ordered (page position →
+ * top of page → creation date) and enriched with `pageIndex`/`pageLabel`.
+ * Subscribed to BOTH stores: annotation writes (own, remote, hydration)
+ * recompute the threads; page moves/deletes re-run the join. Reference-
+ * stable between changes — safe to memo child renders on the array.
  */
-declare function PageAnnotationMenu({ children, gap, placement }: AnnotationMenuProps): React.ReactPortal | null;
-declare function PageAnnotationDraftMenu({ children, gap, placement }: AnnotationDraftMenuProps): React.ReactPortal | null;
+declare function useCommentThreads(): CommentThreadView[];
+/** The enriched thread containing ANY member ref (root, reply, grouped part,
+ *  state annotation), or null. */
+declare function useCommentThread(ref: AnnotationRef | null): CommentThreadView | null;
+/** Whole-document hydration status — the comments sidebar's honest loading
+ *  state (`loading` until `listRawAll` lands, then `complete`/`error`). */
+declare function useCommentsHydration(): AnnotationHydration;
 //#endregion
-export { useAnnotation as A, SelectionProps$1 as C, filePickerProvider as D, TextStyle as E, useSelectionFlags as F, useSelectionProps as I, AnnotationMenuPlacement as L, useAnnotationSelected as M, useAnnotationSelection as N, sameAnchor as O, useFilePickerProvider as P, SelectionFlags$1 as S, TextAlign as T, PageAnnotationMenu as _, AnnotationLayerProps as a, RenderItem$1 as b, AnnotationProps$1 as c, AnnotationRendererProps as d, Border as f, PageAnnotationDraftMenu as g, LineEndings as h, AnnotationLayer as i, useAnnotationDefaults as j, sameCreationDraftAnchor as k, AnnotationPropsPatch$1 as l, LineEnding as m, AnnotationDraftMenuRenderArgs as n, AnnotationMenuProps as o, Geom as p, AnnotationFlags as r, AnnotationMenuRenderArgs as s, AnnotationDraftMenuProps as t, AnnotationRenderer as u, PropKey as v, Style as w, SelectionAnchor as x, PropSpec as y };
-//# sourceMappingURL=annotation-B6jwfTCh.d.cts.map
+export { useCommentsHydration as A, filePickerProvider as C, useCommentThread as D, useAnnotationSelection as E, SelectionAnchor as F, sameAnchor as I, sameCreationDraftAnchor as L, useSelectionFlags as M, useSelectionProps as N, useCommentThreads as O, useAnnotationSelected as P, enrichCommentThreads as S, useAnnotationDefaults as T, SelectionFlags$1 as _, AnnotationPropsPatch as a, TextAlign as b, Border as c, Geom as d, LineEnding as f, RenderItem$1 as g, PropSpec as h, AnnotationProps$1 as i, useFilePickerProvider as j, useComments as k, CommentThreadView as l, PropKey as m, AnnotationLayer as n, AnnotationRenderer as o, LineEndings as p, AnnotationLayerProps as r, AnnotationRendererProps as s, AnnotationFlags as t, CreationDraftAnchor$1 as u, SelectionProps$1 as v, useAnnotation as w, TextStyle as x, Style as y };
+//# sourceMappingURL=annotation-BCED_p9H.d.cts.map

package/dist/annotation-anchors-CetwM1g7.js

@@ -0,0 +1,15 @@
+//#region src/annotation-anchors.ts
+function sameAnchor(a, b) {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	return a.pon === b.pon && a.bounds.x === b.bounds.x && a.bounds.y === b.bounds.y && a.bounds.width === b.bounds.width && a.bounds.height === b.bounds.height && a.knob?.x === b.knob?.x && a.knob?.y === b.knob?.y;
+}
+function sameCreationDraftAnchor(a, b) {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	return a.kind === b.kind && a.subtype === b.subtype && a.pon === b.pon && a.pointCount === b.pointCount && a.minPoints === b.minPoints && a.canFinish === b.canFinish && a.bounds.x === b.bounds.x && a.bounds.y === b.bounds.y && a.bounds.width === b.bounds.width && a.bounds.height === b.bounds.height;
+}
+//#endregion
+export { sameCreationDraftAnchor as n, sameAnchor as t };
+
+//# sourceMappingURL=annotation-anchors-CetwM1g7.js.map

package/dist/annotation-anchors-CetwM1g7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-anchors-CetwM1g7.js","names":[],"sources":["../src/annotation-anchors.ts"],"sourcesContent":["import type { CreationDraftAnchor, Rect, Vec } from '@embedpdf/core-annotation';\n\n/** The selection's menu anchor on its primary page, in content space. */\nexport type SelectionAnchor = { pon: number; bounds: Rect; knob?: Vec };\n\nexport function sameAnchor(a: SelectionAnchor | null, b: SelectionAnchor | null): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.pon === b.pon &&\n    a.bounds.x === b.bounds.x &&\n    a.bounds.y === b.bounds.y &&\n    a.bounds.width === b.bounds.width &&\n    a.bounds.height === b.bounds.height &&\n    a.knob?.x === b.knob?.x &&\n    a.knob?.y === b.knob?.y\n  );\n}\n\nexport function sameCreationDraftAnchor(\n  a: CreationDraftAnchor | null,\n  b: CreationDraftAnchor | null,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.kind === b.kind &&\n    a.subtype === b.subtype &&\n    a.pon === b.pon &&\n    a.pointCount === b.pointCount &&\n    a.minPoints === b.minPoints &&\n    a.canFinish === b.canFinish &&\n    a.bounds.x === b.bounds.x &&\n    a.bounds.y === b.bounds.y &&\n    a.bounds.width === b.bounds.width &&\n    a.bounds.height === b.bounds.height\n  );\n}\n"],"mappings":";AAKA,SAAgB,WAAW,GAA2B,GAAoC;CACxF,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,OACE,EAAE,QAAQ,EAAE,OACZ,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,UAAU,EAAE,OAAO,SAC5B,EAAE,OAAO,WAAW,EAAE,OAAO,UAC7B,EAAE,MAAM,MAAM,EAAE,MAAM,KACtB,EAAE,MAAM,MAAM,EAAE,MAAM;AAE1B;AAEA,SAAgB,wBACd,GACA,GACS;CACT,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,OACE,EAAE,SAAS,EAAE,QACb,EAAE,YAAY,EAAE,WAChB,EAAE,QAAQ,EAAE,OACZ,EAAE,eAAe,EAAE,cACnB,EAAE,cAAc,EAAE,aAClB,EAAE,cAAc,EAAE,aAClB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,UAAU,EAAE,OAAO,SAC5B,EAAE,OAAO,WAAW,EAAE,OAAO;AAEjC"}

package/dist/annotation-anchors-DuYRBJLl.cjs

@@ -0,0 +1,26 @@
+//#region src/annotation-anchors.ts
+function sameAnchor(a, b) {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	return a.pon === b.pon && a.bounds.x === b.bounds.x && a.bounds.y === b.bounds.y && a.bounds.width === b.bounds.width && a.bounds.height === b.bounds.height && a.knob?.x === b.knob?.x && a.knob?.y === b.knob?.y;
+}
+function sameCreationDraftAnchor(a, b) {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	return a.kind === b.kind && a.subtype === b.subtype && a.pon === b.pon && a.pointCount === b.pointCount && a.minPoints === b.minPoints && a.canFinish === b.canFinish && a.bounds.x === b.bounds.x && a.bounds.y === b.bounds.y && a.bounds.width === b.bounds.width && a.bounds.height === b.bounds.height;
+}
+//#endregion
+Object.defineProperty(exports, "sameAnchor", {
+	enumerable: true,
+	get: function() {
+		return sameAnchor;
+	}
+});
+Object.defineProperty(exports, "sameCreationDraftAnchor", {
+	enumerable: true,
+	get: function() {
+		return sameCreationDraftAnchor;
+	}
+});
+
+//# sourceMappingURL=annotation-anchors-DuYRBJLl.cjs.map

package/dist/annotation-anchors-DuYRBJLl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-anchors-DuYRBJLl.cjs","names":[],"sources":["../src/annotation-anchors.ts"],"sourcesContent":["import type { CreationDraftAnchor, Rect, Vec } from '@embedpdf/core-annotation';\n\n/** The selection's menu anchor on its primary page, in content space. */\nexport type SelectionAnchor = { pon: number; bounds: Rect; knob?: Vec };\n\nexport function sameAnchor(a: SelectionAnchor | null, b: SelectionAnchor | null): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.pon === b.pon &&\n    a.bounds.x === b.bounds.x &&\n    a.bounds.y === b.bounds.y &&\n    a.bounds.width === b.bounds.width &&\n    a.bounds.height === b.bounds.height &&\n    a.knob?.x === b.knob?.x &&\n    a.knob?.y === b.knob?.y\n  );\n}\n\nexport function sameCreationDraftAnchor(\n  a: CreationDraftAnchor | null,\n  b: CreationDraftAnchor | null,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.kind === b.kind &&\n    a.subtype === b.subtype &&\n    a.pon === b.pon &&\n    a.pointCount === b.pointCount &&\n    a.minPoints === b.minPoints &&\n    a.canFinish === b.canFinish &&\n    a.bounds.x === b.bounds.x &&\n    a.bounds.y === b.bounds.y &&\n    a.bounds.width === b.bounds.width &&\n    a.bounds.height === b.bounds.height\n  );\n}\n"],"mappings":";AAKA,SAAgB,WAAW,GAA2B,GAAoC;CACxF,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,OACE,EAAE,QAAQ,EAAE,OACZ,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,UAAU,EAAE,OAAO,SAC5B,EAAE,OAAO,WAAW,EAAE,OAAO,UAC7B,EAAE,MAAM,MAAM,EAAE,MAAM,KACtB,EAAE,MAAM,MAAM,EAAE,MAAM;AAE1B;AAEA,SAAgB,wBACd,GACA,GACS;CACT,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,OACE,EAAE,SAAS,EAAE,QACb,EAAE,YAAY,EAAE,WAChB,EAAE,QAAQ,EAAE,OACZ,EAAE,eAAe,EAAE,cACnB,EAAE,cAAc,EAAE,aAClB,EAAE,cAAc,EAAE,aAClB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,MAAM,EAAE,OAAO,KACxB,EAAE,OAAO,UAAU,EAAE,OAAO,SAC5B,EAAE,OAAO,WAAW,EAAE,OAAO;AAEjC"}

package/dist/annotation-hooks-BB5ZhPpf.cjs

@@ -0,0 +1,16 @@
+const require_runtime = require("./runtime.cjs");
+let _embedpdf_plugin_annotation_contract = require("@embedpdf/plugin-annotation/contract");
+//#region src/annotation-hooks.ts
+/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */
+function useAnnotationSelected() {
+	return require_runtime.useSelector(_embedpdf_plugin_annotation_contract.AnnotationToken, (c) => c.getSelected(), require_runtime.shallowArray);
+}
+//#endregion
+Object.defineProperty(exports, "useAnnotationSelected", {
+	enumerable: true,
+	get: function() {
+		return useAnnotationSelected;
+	}
+});
+
+//# sourceMappingURL=annotation-hooks-BB5ZhPpf.cjs.map

package/dist/annotation-hooks-BB5ZhPpf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-hooks-BB5ZhPpf.cjs","names":["useSelector","AnnotationToken","shallowArray"],"sources":["../src/annotation-hooks.ts"],"sourcesContent":["import { AnnotationToken } from '@embedpdf/plugin-annotation/contract';\n\nimport { shallowArray, useSelector } from './runtime';\n\n/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */\nexport function useAnnotationSelected() {\n  return useSelector(AnnotationToken, (c) => c.getSelected(), shallowArray);\n}\n"],"mappings":";;;;AAKA,SAAgB,wBAAwB;CACtC,OAAOA,gBAAAA,YAAYC,qCAAAA,kBAAkB,MAAM,EAAE,YAAY,GAAGC,gBAAAA,YAAY;AAC1E"}

package/dist/annotation-hooks-Df8EmzDO.js

@@ -0,0 +1,11 @@
+import { shallowArray, useSelector } from "./runtime.js";
+import { AnnotationToken } from "@embedpdf/plugin-annotation/contract";
+//#region src/annotation-hooks.ts
+/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */
+function useAnnotationSelected() {
+	return useSelector(AnnotationToken, (c) => c.getSelected(), shallowArray);
+}
+//#endregion
+export { useAnnotationSelected as t };
+
+//# sourceMappingURL=annotation-hooks-Df8EmzDO.js.map

package/dist/annotation-hooks-Df8EmzDO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-hooks-Df8EmzDO.js","names":[],"sources":["../src/annotation-hooks.ts"],"sourcesContent":["import { AnnotationToken } from '@embedpdf/plugin-annotation/contract';\n\nimport { shallowArray, useSelector } from './runtime';\n\n/** The selected annotations as engine DTOs — for selection-aware toolbars/sidebars. */\nexport function useAnnotationSelected() {\n  return useSelector(AnnotationToken, (c) => c.getSelected(), shallowArray);\n}\n"],"mappings":";;;;AAKA,SAAgB,wBAAwB;CACtC,OAAO,YAAY,kBAAkB,MAAM,EAAE,YAAY,GAAG,YAAY;AAC1E"}