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

package/dist/{annotation-nUMefyjw.d.ts → annotation-k38KDlIZ.d.ts}

@@ -1,11 +1,20 @@
-import { t as AnnotationDTO } from "./AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.js";
-import { o as PageContextValue } from "./runtime-DV98q7I0.js";
+import { d as runtime_d_exports, o as PageContextValue } from "./runtime-DE76hlnl.js";
 import * as React from "react";
-import { Rect } from "@embedpdf/core-geometry";
-import { Behavior, FilePickerProvider, SelectionFlags, SelectionFlags as SelectionFlags$1, SelectionProps, SelectionProps as SelectionProps$1 } from "@embedpdf/plugin-annotation";
-import { AnnotationFlags, AnnotationProps, AnnotationProps as AnnotationProps$1, AnnotationPropsPatch, AnnotationPropsPatch as AnnotationPropsPatch$1, Border, CreationDraftAnchor, Geom, LineEnding, LineEndings, PropKey, PropSpec, Rect as Rect$1, RenderItem, RenderItem as RenderItem$1, Style, TextAlign, TextStyle, Vec } from "@embedpdf/core-annotation";
-//#region src/internal/annotation-menu-position.d.ts
-type AnnotationMenuPlacement = 'top' | 'right' | 'bottom' | 'left';
+import { AnnotationHydration, AnnotationRef, Behavior, CommentThread, CommentsApi, FilePickerProvider, SelectionFlags, SelectionFlags as SelectionFlags$1, SelectionProps, SelectionProps as SelectionProps$1 } from "@embedpdf/plugin-annotation";
+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";
+//#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
 /**
@@ -21,7 +30,7 @@ interface AnnotationRendererProps {
   page: PageContextValue;
   appearance: {
     url: string;
-    box: Rect$1;
+    box: Rect;
   } | null;
   native: React.ReactNode;
   interactive: boolean;
@@ -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$1;
-  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-nUMefyjw.d.ts.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-k38KDlIZ.d.ts.map

package/dist/annotation-menu.cjs

@@ -1,111 +1,60 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
 const require_runtime = require("./runtime.cjs");
-const require_annotation = require("./annotation-Ct6dFtzJ.cjs");
+const require_anchored = require("./anchored.cjs");
+const require_annotation_anchors = require("./annotation-anchors-DuYRBJLl.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react, 1);
-let _embedpdf_plugin_stage = require("@embedpdf/plugin-stage");
-let _embedpdf_plugin_annotation_internal = require("@embedpdf/plugin-annotation/internal");
+let _embedpdf_plugin_annotation_contract_host = require("@embedpdf/plugin-annotation/contract/host");
 //#region src/annotation-menu.tsx
 /**
-* <AnnotationMenu> — the DEFAULT, Stage-bound selection menu.
+* Annotation menus — thin anchor plumbing over the ONE `<Anchored>` primitive.
 *
-* Marker-style: it transforms the selected content rect through the Stage camera
-* and renders an upright menu in viewport space. Mount it in the Stage `overlay`
-* slot. It re-renders on `visiblePages()`, so it tracks pan/zoom and page
-* rotation/layout changes with no DOM measurement, no portal, no scroll listeners.
+* These work identically under `<Stage>` (mount in the overlay slot; the
+* camera projects, no DOM reads) and `<PageView>` (measured + portalled) —
+* the SURFACE provides the projector, the menu doesn't care.
 *
-* This module is the ONLY annotation menu that imports `@embedpdf/plugin-stage`.
-* For a Stage-free `<PageView>`, use `<PageAnnotationMenu>` from
-* `@embedpdf/react/annotation` instead.
+* No action bags: actions come from the capability hooks (`useAnnotation()`,
+* `useAnnotationSelected()`, …), which subscribe properly and compose across
+* plugins. Render props carry only the ANCHOR'S DATA (the draft menu's
+* progress facts); the annotation-selection menu takes plain children.
+*/
+/**
+* Floats over the current annotation selection (one anchor regardless of
+* cross-page selection), dodging the rotate knob. Compose the contents from
+* hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /
+* `useSelectionProps()` for the data.
 */
 function AnnotationMenu({ children, gap = 15, placement = "top" }) {
-	const stage = require_runtime.useCapability(_embedpdf_plugin_stage.StageToken);
-	const anno = require_runtime.useCapability(_embedpdf_plugin_annotation_internal.AnnotationToken);
-	require_runtime.useSelector(_embedpdf_plugin_stage.StageToken, (c) => c.visiblePages());
-	const anchor = require_runtime.useSelector(_embedpdf_plugin_annotation_internal.AnnotationToken, (c) => {
+	const { projector } = require_anchored.useProjectorBinding();
+	const anchor = require_runtime.useSelector(_embedpdf_plugin_annotation_contract_host.AnnotationToken, (c) => {
 		const a = c.selectionAnchor();
 		if (!a) return null;
-		const t = stage.pageRect(a.pon)?.transform;
-		return t?.viewScale ? c.selectionAnchor(t.viewScale, t.rotation, t.zoom) : a;
-	}, require_annotation.sameAnchor);
-	const selected = require_annotation.useAnnotationSelected();
-	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);
-	});
+		const env = projector.viewEnv(a.pon);
+		return env ? c.selectionAnchor(env.scale, env.rotation, env.zoom) : a;
+	}, require_annotation_anchors.sameAnchor);
 	if (!anchor) return null;
-	const box = stage.pageRectToScreen(anchor.pon, anchor.bounds);
-	if (!box) return null;
-	const kr = anchor.knob ? stage.pageRectToScreen(anchor.pon, {
-		x: anchor.knob.x,
-		y: anchor.knob.y,
-		width: 0,
-		height: 0
-	}) : null;
-	const pos = require_annotation.positionMenuAroundRect(box, placement, gap, kr ? {
-		x: kr.x,
-		y: kr.y
-	} : null);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		ref,
-		style: {
-			position: "absolute",
-			left: pos.left,
-			top: pos.top,
-			transform: pos.transform,
-			pointerEvents: "auto"
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_anchored.Anchored, {
+		anchor: {
+			pon: anchor.pon,
+			bounds: anchor.bounds,
+			...anchor.knob ? { avoid: [anchor.knob] } : {}
 		},
-		children: children({
-			selected,
-			deleteSelection: anno.deleteSelection,
-			deselect: anno.deselect,
-			updateSelection: anno.updateSelection,
-			rotate90: anno.rotateSelection90,
-			resetRotation: anno.resetSelectionRotation,
-			group: anno.group,
-			ungroup: anno.ungroup,
-			canGroup: anno.canGroup(),
-			canUngroup: anno.canUngroup()
-		})
+		placement,
+		gap,
+		children
 	});
 }
+/** Floats over a live multi-click creation draft (polygon, polyline, …). */
 function AnnotationDraftMenu({ children, gap = 8, placement = "top" }) {
-	const stage = require_runtime.useCapability(_embedpdf_plugin_stage.StageToken);
-	const anno = require_runtime.useCapability(_embedpdf_plugin_annotation_internal.AnnotationToken);
-	require_runtime.useSelector(_embedpdf_plugin_stage.StageToken, (c) => c.visiblePages());
-	const anchor = require_runtime.useSelector(_embedpdf_plugin_annotation_internal.AnnotationToken, (c) => c.creationDraftAnchor(), require_annotation.sameCreationDraftAnchor);
-	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);
-	});
+	const anchor = require_runtime.useSelector(_embedpdf_plugin_annotation_contract_host.AnnotationToken, (c) => c.creationDraftAnchor(), require_annotation_anchors.sameCreationDraftAnchor);
 	if (!anchor) return null;
-	const box = stage.pageRectToScreen(anchor.pon, anchor.bounds);
-	if (!box) return null;
-	const pos = require_annotation.positionMenuAroundRect(box, placement, gap);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		ref,
-		style: {
-			position: "absolute",
-			left: pos.left,
-			top: pos.top,
-			transform: pos.transform,
-			pointerEvents: "auto"
-		},
-		children: children({
-			...anchor,
-			finish: anno.finishCreationDraft,
-			cancel: anno.cancelCreationDraft
-		})
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_anchored.Anchored, {
+		anchor,
+		placement,
+		gap,
+		children: children(anchor)
 	});
 }
 //#endregion

package/dist/annotation-menu.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"annotation-menu.cjs","names":["useCapability","StageToken","AnnotationHostToken","useSelector","sameAnchor","useAnnotationSelected","positionMenuAroundRect","sameCreationDraftAnchor"],"sources":["../src/annotation-menu.tsx"],"sourcesContent":["/**\n * <AnnotationMenu> — the DEFAULT, Stage-bound selection menu.\n *\n * Marker-style: it transforms the selected content rect through the Stage camera\n * and renders an upright menu in viewport space. Mount it in the Stage `overlay`\n * slot. It re-renders on `visiblePages()`, so it tracks pan/zoom and page\n * rotation/layout changes with no DOM measurement, no portal, no scroll listeners.\n *\n * This module is the ONLY annotation menu that imports `@embedpdf/plugin-stage`.\n * For a Stage-free `<PageView>`, use `<PageAnnotationMenu>` from\n * `@embedpdf/react/annotation` instead.\n */\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { StageToken } from '@embedpdf/plugin-stage';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/internal';\nimport { useCapability, useSelector } from './runtime';\nimport {\n  sameAnchor,\n  sameCreationDraftAnchor,\n  useAnnotationSelected,\n  type AnnotationDraftMenuProps,\n  type AnnotationMenuProps,\n} from './annotation';\nimport { positionMenuAroundRect } from './internal/annotation-menu-position';\n\nexport function AnnotationMenu({ children, gap = 15, placement = 'top' }: AnnotationMenuProps) {\n  const stage = useCapability(StageToken);\n  const anno = useCapability(AnnotationHostToken);\n  // Reposition on pan/zoom AND rotation/layout changes. `visiblePages()` folds in\n  // the scene key, camera, viewport, and DPR, while staying referentially stable.\n  useSelector(StageToken, (c) => c.visiblePages());\n  // Two-step anchor resolve: the pon comes from the scale-less anchor, then the\n  // knob is re-projected with THAT page's view scale so the menu dodges the knob\n  // where it actually renders (screen-constant stalk).\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => {\n      const a = c.selectionAnchor();\n      if (!a) return null;\n      const t = stage.pageRect(a.pon)?.transform;\n      return t?.viewScale ? c.selectionAnchor(t.viewScale, t.rotation, t.zoom) : a;\n    },\n    sameAnchor,\n  );\n  const selected = useAnnotationSelected();\n\n  // Isolate the menu from the Stage's pointer forwarding: a pointerdown inside it\n  // must NOT bubble up to the Stage container's NATIVE listener, which would\n  // forward to the interaction hub and read it as a click-outside → deselect (and\n  // unmount this menu). Native listener (not React's) so it runs during real DOM\n  // bubbling, before the Stage's own native listener on the ancestor. Inner button\n  // `onClick` still fires — `click` is a separate event that reaches React's root.\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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);\n  if (!box) return null;\n  // Transform the knob via a zero-size rect so page rotation is respected; the\n  // menu then nudges only the edge it sits on (and only if the knob protrudes).\n  const kr = anchor.knob\n    ? stage.pageRectToScreen(anchor.pon, {\n        x: anchor.knob.x,\n        y: anchor.knob.y,\n        width: 0,\n        height: 0,\n      })\n    : null;\n  const pos = positionMenuAroundRect(box, placement, gap, kr ? { x: kr.x, y: kr.y } : null);\n  return (\n    <div\n      ref={ref}\n      style={{\n        position: 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children({\n        selected,\n        deleteSelection: anno.deleteSelection,\n        deselect: anno.deselect,\n        updateSelection: anno.updateSelection,\n        rotate90: anno.rotateSelection90,\n        resetRotation: anno.resetSelectionRotation,\n        group: anno.group,\n        ungroup: anno.ungroup,\n        canGroup: anno.canGroup(),\n        canUngroup: anno.canUngroup(),\n      })}\n    </div>\n  );\n}\n\nexport function AnnotationDraftMenu({\n  children,\n  gap = 8,\n  placement = 'top',\n}: AnnotationDraftMenuProps) {\n  const stage = useCapability(StageToken);\n  const anno = useCapability(AnnotationHostToken);\n  useSelector(StageToken, (c) => c.visiblePages());\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => c.creationDraftAnchor(),\n    sameCreationDraftAnchor,\n  );\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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);\n  if (!box) return null;\n  const pos = positionMenuAroundRect(box, placement, gap);\n  return (\n    <div\n      ref={ref}\n      style={{\n        position: 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children({\n        ...anchor,\n        finish: anno.finishCreationDraft,\n        cancel: anno.cancelCreationDraft,\n      })}\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"annotation-menu.cjs","names":["useProjectorBinding","useSelector","AnnotationHostToken","sameAnchor","Anchored","sameCreationDraftAnchor"],"sources":["../src/annotation-menu.tsx"],"sourcesContent":["/**\n * Annotation menus — thin anchor plumbing over the ONE `<Anchored>` primitive.\n *\n * These work identically under `<Stage>` (mount in the overlay slot; the\n * camera projects, no DOM reads) and `<PageView>` (measured + portalled) —\n * the SURFACE provides the projector, the menu doesn't care.\n *\n * No action bags: actions come from the capability hooks (`useAnnotation()`,\n * `useAnnotationSelected()`, …), which subscribe properly and compose across\n * plugins. Render props carry only the ANCHOR'S DATA (the draft menu's\n * progress facts); the annotation-selection menu takes plain children.\n */\nimport * as React from 'react';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport type { CreationDraftAnchor } from '@embedpdf/core-annotation';\nimport { Anchored, useProjectorBinding, type AnchoredPlacement } from './anchored';\nimport { useSelector } from './runtime';\nimport { sameAnchor, sameCreationDraftAnchor } from './annotation-anchors';\n\nexport interface AnnotationMenuProps {\n  children: React.ReactNode;\n  /** Gap in screen px between the selection box and the menu (default 15). */\n  gap?: number;\n  /** Where to place the menu relative to the selection box. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/**\n * Floats over the current annotation selection (one anchor regardless of\n * cross-page selection), dodging the rotate knob. Compose the contents from\n * hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /\n * `useSelectionProps()` for the data.\n */\nexport function AnnotationMenu({ children, gap = 15, placement = 'top' }: AnnotationMenuProps) {\n  // Reading the binding subscribes this component to projection changes\n  // (its identity IS the revision), so the anchor read below re-runs with\n  // fresh view facts in the SAME commit as the surface — the knob offset is\n  // screen-constant, so its content-space position depends on the page's\n  // live view scale.\n  const { projector } = useProjectorBinding();\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => {\n      const a = c.selectionAnchor();\n      if (!a) return null;\n      const env = projector.viewEnv(a.pon);\n      return env ? c.selectionAnchor(env.scale, env.rotation, env.zoom) : a;\n    },\n    sameAnchor,\n  );\n  if (!anchor) return null;\n  return (\n    <Anchored\n      anchor={{\n        pon: anchor.pon,\n        bounds: anchor.bounds,\n        ...(anchor.knob ? { avoid: [anchor.knob] } : {}),\n      }}\n      placement={placement}\n      gap={gap}\n    >\n      {children}\n    </Anchored>\n  );\n}\n\nexport interface AnnotationDraftMenuProps {\n  /** Render prop receiving the DRAFT ANCHOR'S DATA (subtype, pointCount,\n   *  minPoints, canFinish, …). The verbs are capability calls:\n   *  `useAnnotation().finishCreationDraft()` / `.cancelCreationDraft()`. */\n  children: (anchor: CreationDraftAnchor) => React.ReactNode;\n  /** Gap in screen px between the draft anchor and the menu (default 8). */\n  gap?: number;\n  /** Where to place the menu relative to the draft anchor. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/** Floats over a live multi-click creation draft (polygon, polyline, …). */\nexport function AnnotationDraftMenu({\n  children,\n  gap = 8,\n  placement = 'top',\n}: AnnotationDraftMenuProps) {\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => c.creationDraftAnchor(),\n    sameCreationDraftAnchor,\n  );\n  if (!anchor) return null;\n  return (\n    <Anchored anchor={anchor} placement={placement} gap={gap}>\n      {children(anchor)}\n    </Anchored>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,eAAe,EAAE,UAAU,MAAM,IAAI,YAAY,SAA8B;CAM7F,MAAM,EAAE,cAAcA,iBAAAA,oBAAoB;CAC1C,MAAM,SAASC,gBAAAA,YACbC,0CAAAA,kBACC,MAAM;EACL,MAAM,IAAI,EAAE,gBAAgB;EAC5B,IAAI,CAAC,GAAG,OAAO;EACf,MAAM,MAAM,UAAU,QAAQ,EAAE,GAAG;EACnC,OAAO,MAAM,EAAE,gBAAgB,IAAI,OAAO,IAAI,UAAU,IAAI,IAAI,IAAI;CACtE,GACAC,2BAAAA,UACF;CACA,IAAI,CAAC,QAAQ,OAAO;CACpB,OACE,iBAAA,GAAA,kBAAA,IAAA,CAACC,iBAAAA,UAAD;EACE,QAAQ;GACN,KAAK,OAAO;GACZ,QAAQ,OAAO;GACf,GAAI,OAAO,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC;EAChD;EACW;EACN;EAEJ;CACO,CAAA;AAEd;;AAcA,SAAgB,oBAAoB,EAClC,UACA,MAAM,GACN,YAAY,SACe;CAC3B,MAAM,SAASH,gBAAAA,YACbC,0CAAAA,kBACC,MAAM,EAAE,oBAAoB,GAC7BG,2BAAAA,uBACF;CACA,IAAI,CAAC,QAAQ,OAAO;CACpB,OACE,iBAAA,GAAA,kBAAA,IAAA,CAACD,iBAAAA,UAAD;EAAkB;EAAmB;EAAgB;EAClD,UAAA,SAAS,MAAM;CACR,CAAA;AAEd"}

package/dist/annotation-menu.d.cts

@@ -1,7 +1,33 @@
-import { o as AnnotationMenuProps, t as AnnotationDraftMenuProps } from "./annotation-B6jwfTCh.cjs";
+import { AnchoredPlacement } from "./anchored.cjs";
+import * as React from "react";
+import { CreationDraftAnchor } from "@embedpdf/core-annotation";
 //#region src/annotation-menu.d.ts
+interface AnnotationMenuProps {
+  children: React.ReactNode;
+  /** Gap in screen px between the selection box and the menu (default 15). */
+  gap?: number;
+  /** Where to place the menu relative to the selection box. Default 'top'. */
+  placement?: AnchoredPlacement;
+}
+/**
+ * Floats over the current annotation selection (one anchor regardless of
+ * cross-page selection), dodging the rotate knob. Compose the contents from
+ * hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /
+ * `useSelectionProps()` for the data.
+ */
 declare function AnnotationMenu({ children, gap, placement }: AnnotationMenuProps): import("react/jsx-runtime").JSX.Element | null;
+interface AnnotationDraftMenuProps {
+  /** Render prop receiving the DRAFT ANCHOR'S DATA (subtype, pointCount,
+   *  minPoints, canFinish, …). The verbs are capability calls:
+   *  `useAnnotation().finishCreationDraft()` / `.cancelCreationDraft()`. */
+  children: (anchor: CreationDraftAnchor) => 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?: AnchoredPlacement;
+}
+/** Floats over a live multi-click creation draft (polygon, polyline, …). */
 declare function AnnotationDraftMenu({ children, gap, placement }: AnnotationDraftMenuProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { AnnotationDraftMenu, AnnotationMenu };
+export { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationMenu, AnnotationMenuProps };
 //# sourceMappingURL=annotation-menu.d.cts.map

package/dist/annotation-menu.d.ts

@@ -1,7 +1,33 @@
-import { o as AnnotationMenuProps, t as AnnotationDraftMenuProps } from "./annotation-nUMefyjw.js";
+import { AnchoredPlacement } from "./anchored.js";
+import * as React from "react";
+import { CreationDraftAnchor } from "@embedpdf/core-annotation";
 //#region src/annotation-menu.d.ts
+interface AnnotationMenuProps {
+  children: React.ReactNode;
+  /** Gap in screen px between the selection box and the menu (default 15). */
+  gap?: number;
+  /** Where to place the menu relative to the selection box. Default 'top'. */
+  placement?: AnchoredPlacement;
+}
+/**
+ * Floats over the current annotation selection (one anchor regardless of
+ * cross-page selection), dodging the rotate knob. Compose the contents from
+ * hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /
+ * `useSelectionProps()` for the data.
+ */
 declare function AnnotationMenu({ children, gap, placement }: AnnotationMenuProps): import("react/jsx-runtime").JSX.Element | null;
+interface AnnotationDraftMenuProps {
+  /** Render prop receiving the DRAFT ANCHOR'S DATA (subtype, pointCount,
+   *  minPoints, canFinish, …). The verbs are capability calls:
+   *  `useAnnotation().finishCreationDraft()` / `.cancelCreationDraft()`. */
+  children: (anchor: CreationDraftAnchor) => 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?: AnchoredPlacement;
+}
+/** Floats over a live multi-click creation draft (polygon, polyline, …). */
 declare function AnnotationDraftMenu({ children, gap, placement }: AnnotationDraftMenuProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { AnnotationDraftMenu, AnnotationMenu };
+export { AnnotationDraftMenu, AnnotationDraftMenuProps, AnnotationMenu, AnnotationMenuProps };
 //# sourceMappingURL=annotation-menu.d.ts.map

package/dist/annotation-menu.js

@@ -1,96 +1,45 @@
-import { useCapability, useSelector } from "./runtime.js";
-import { a as sameAnchor, l as useAnnotationSelected, m as positionMenuAroundRect, o as sameCreationDraftAnchor } from "./annotation-DjGWJljY.js";
+import { useSelector } from "./runtime.js";
+import { Anchored, useProjectorBinding } from "./anchored.js";
+import { n as sameCreationDraftAnchor, t as sameAnchor } from "./annotation-anchors-CetwM1g7.js";
 import { jsx } from "react/jsx-runtime";
-import { useEffect, useRef } from "react";
-import { StageToken } from "@embedpdf/plugin-stage";
-import { AnnotationToken } from "@embedpdf/plugin-annotation/internal";
+import "react";
+import { AnnotationToken } from "@embedpdf/plugin-annotation/contract/host";
 //#region src/annotation-menu.tsx
+/**
+* Floats over the current annotation selection (one anchor regardless of
+* cross-page selection), dodging the rotate knob. Compose the contents from
+* hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /
+* `useSelectionProps()` for the data.
+*/
 function AnnotationMenu({ children, gap = 15, placement = "top" }) {
-	const stage = useCapability(StageToken);
-	const anno = useCapability(AnnotationToken);
-	useSelector(StageToken, (c) => c.visiblePages());
+	const { projector } = useProjectorBinding();
 	const anchor = useSelector(AnnotationToken, (c) => {
 		const a = c.selectionAnchor();
 		if (!a) return null;
-		const t = stage.pageRect(a.pon)?.transform;
-		return t?.viewScale ? c.selectionAnchor(t.viewScale, t.rotation, t.zoom) : a;
+		const env = projector.viewEnv(a.pon);
+		return env ? c.selectionAnchor(env.scale, env.rotation, env.zoom) : a;
 	}, sameAnchor);
-	const selected = useAnnotationSelected();
-	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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);
-	if (!box) return null;
-	const kr = anchor.knob ? stage.pageRectToScreen(anchor.pon, {
-		x: anchor.knob.x,
-		y: anchor.knob.y,
-		width: 0,
-		height: 0
-	}) : null;
-	const pos = positionMenuAroundRect(box, placement, gap, kr ? {
-		x: kr.x,
-		y: kr.y
-	} : null);
-	return /* @__PURE__ */ jsx("div", {
-		ref,
-		style: {
-			position: "absolute",
-			left: pos.left,
-			top: pos.top,
-			transform: pos.transform,
-			pointerEvents: "auto"
+	return /* @__PURE__ */ jsx(Anchored, {
+		anchor: {
+			pon: anchor.pon,
+			bounds: anchor.bounds,
+			...anchor.knob ? { avoid: [anchor.knob] } : {}
 		},
-		children: children({
-			selected,
-			deleteSelection: anno.deleteSelection,
-			deselect: anno.deselect,
-			updateSelection: anno.updateSelection,
-			rotate90: anno.rotateSelection90,
-			resetRotation: anno.resetSelectionRotation,
-			group: anno.group,
-			ungroup: anno.ungroup,
-			canGroup: anno.canGroup(),
-			canUngroup: anno.canUngroup()
-		})
+		placement,
+		gap,
+		children
 	});
 }
+/** Floats over a live multi-click creation draft (polygon, polyline, …). */
 function AnnotationDraftMenu({ children, gap = 8, placement = "top" }) {
-	const stage = useCapability(StageToken);
-	const anno = useCapability(AnnotationToken);
-	useSelector(StageToken, (c) => c.visiblePages());
 	const anchor = useSelector(AnnotationToken, (c) => c.creationDraftAnchor(), sameCreationDraftAnchor);
-	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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);
-	if (!box) return null;
-	const pos = positionMenuAroundRect(box, placement, gap);
-	return /* @__PURE__ */ jsx("div", {
-		ref,
-		style: {
-			position: "absolute",
-			left: pos.left,
-			top: pos.top,
-			transform: pos.transform,
-			pointerEvents: "auto"
-		},
-		children: children({
-			...anchor,
-			finish: anno.finishCreationDraft,
-			cancel: anno.cancelCreationDraft
-		})
+	return /* @__PURE__ */ jsx(Anchored, {
+		anchor,
+		placement,
+		gap,
+		children: children(anchor)
 	});
 }
 //#endregion

package/dist/annotation-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotation-menu.js","names":["AnnotationHostToken"],"sources":["../src/annotation-menu.tsx"],"sourcesContent":["/**\n * <AnnotationMenu> — the DEFAULT, Stage-bound selection menu.\n *\n * Marker-style: it transforms the selected content rect through the Stage camera\n * and renders an upright menu in viewport space. Mount it in the Stage `overlay`\n * slot. It re-renders on `visiblePages()`, so it tracks pan/zoom and page\n * rotation/layout changes with no DOM measurement, no portal, no scroll listeners.\n *\n * This module is the ONLY annotation menu that imports `@embedpdf/plugin-stage`.\n * For a Stage-free `<PageView>`, use `<PageAnnotationMenu>` from\n * `@embedpdf/react/annotation` instead.\n */\nimport * as React from 'react';\nimport { useEffect, useRef } from 'react';\nimport { StageToken } from '@embedpdf/plugin-stage';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/internal';\nimport { useCapability, useSelector } from './runtime';\nimport {\n  sameAnchor,\n  sameCreationDraftAnchor,\n  useAnnotationSelected,\n  type AnnotationDraftMenuProps,\n  type AnnotationMenuProps,\n} from './annotation';\nimport { positionMenuAroundRect } from './internal/annotation-menu-position';\n\nexport function AnnotationMenu({ children, gap = 15, placement = 'top' }: AnnotationMenuProps) {\n  const stage = useCapability(StageToken);\n  const anno = useCapability(AnnotationHostToken);\n  // Reposition on pan/zoom AND rotation/layout changes. `visiblePages()` folds in\n  // the scene key, camera, viewport, and DPR, while staying referentially stable.\n  useSelector(StageToken, (c) => c.visiblePages());\n  // Two-step anchor resolve: the pon comes from the scale-less anchor, then the\n  // knob is re-projected with THAT page's view scale so the menu dodges the knob\n  // where it actually renders (screen-constant stalk).\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => {\n      const a = c.selectionAnchor();\n      if (!a) return null;\n      const t = stage.pageRect(a.pon)?.transform;\n      return t?.viewScale ? c.selectionAnchor(t.viewScale, t.rotation, t.zoom) : a;\n    },\n    sameAnchor,\n  );\n  const selected = useAnnotationSelected();\n\n  // Isolate the menu from the Stage's pointer forwarding: a pointerdown inside it\n  // must NOT bubble up to the Stage container's NATIVE listener, which would\n  // forward to the interaction hub and read it as a click-outside → deselect (and\n  // unmount this menu). Native listener (not React's) so it runs during real DOM\n  // bubbling, before the Stage's own native listener on the ancestor. Inner button\n  // `onClick` still fires — `click` is a separate event that reaches React's root.\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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);\n  if (!box) return null;\n  // Transform the knob via a zero-size rect so page rotation is respected; the\n  // menu then nudges only the edge it sits on (and only if the knob protrudes).\n  const kr = anchor.knob\n    ? stage.pageRectToScreen(anchor.pon, {\n        x: anchor.knob.x,\n        y: anchor.knob.y,\n        width: 0,\n        height: 0,\n      })\n    : null;\n  const pos = positionMenuAroundRect(box, placement, gap, kr ? { x: kr.x, y: kr.y } : null);\n  return (\n    <div\n      ref={ref}\n      style={{\n        position: 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children({\n        selected,\n        deleteSelection: anno.deleteSelection,\n        deselect: anno.deselect,\n        updateSelection: anno.updateSelection,\n        rotate90: anno.rotateSelection90,\n        resetRotation: anno.resetSelectionRotation,\n        group: anno.group,\n        ungroup: anno.ungroup,\n        canGroup: anno.canGroup(),\n        canUngroup: anno.canUngroup(),\n      })}\n    </div>\n  );\n}\n\nexport function AnnotationDraftMenu({\n  children,\n  gap = 8,\n  placement = 'top',\n}: AnnotationDraftMenuProps) {\n  const stage = useCapability(StageToken);\n  const anno = useCapability(AnnotationHostToken);\n  useSelector(StageToken, (c) => c.visiblePages());\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => c.creationDraftAnchor(),\n    sameCreationDraftAnchor,\n  );\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 box = stage.pageRectToScreen(anchor.pon, anchor.bounds);\n  if (!box) return null;\n  const pos = positionMenuAroundRect(box, placement, gap);\n  return (\n    <div\n      ref={ref}\n      style={{\n        position: 'absolute',\n        left: pos.left,\n        top: pos.top,\n        transform: pos.transform,\n        pointerEvents: 'auto',\n      }}\n    >\n      {children({\n        ...anchor,\n        finish: anno.finishCreationDraft,\n        cancel: anno.cancelCreationDraft,\n      })}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;AA0BA,SAAgB,eAAe,EAAE,UAAU,MAAM,IAAI,YAAY,SAA8B;CAC7F,MAAM,QAAQ,cAAc,UAAU;CACtC,MAAM,OAAO,cAAcA,eAAmB;CAG9C,YAAY,aAAa,MAAM,EAAE,aAAa,CAAC;CAI/C,MAAM,SAAS,YACbA,kBACC,MAAM;EACL,MAAM,IAAI,EAAE,gBAAgB;EAC5B,IAAI,CAAC,GAAG,OAAO;EACf,MAAM,IAAI,MAAM,SAAS,EAAE,GAAG,CAAC,EAAE;EACjC,OAAO,GAAG,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,IAAI;CAC7E,GACA,UACF;CACA,MAAM,WAAW,sBAAsB;CAQvC,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,MAAM,iBAAiB,OAAO,KAAK,OAAO,MAAM;CAC5D,IAAI,CAAC,KAAK,OAAO;CAGjB,MAAM,KAAK,OAAO,OACd,MAAM,iBAAiB,OAAO,KAAK;EACjC,GAAG,OAAO,KAAK;EACf,GAAG,OAAO,KAAK;EACf,OAAO;EACP,QAAQ;CACV,CAAC,IACD;CACJ,MAAM,MAAM,uBAAuB,KAAK,WAAW,KAAK,KAAK;EAAE,GAAG,GAAG;EAAG,GAAG,GAAG;CAAE,IAAI,IAAI;CACxF,OACE,oBAAC,OAAD;EACO;EACL,OAAO;GACL,UAAU;GACV,MAAM,IAAI;GACV,KAAK,IAAI;GACT,WAAW,IAAI;GACf,eAAe;EACjB;EAEC,UAAA,SAAS;GACR;GACA,iBAAiB,KAAK;GACtB,UAAU,KAAK;GACf,iBAAiB,KAAK;GACtB,UAAU,KAAK;GACf,eAAe,KAAK;GACpB,OAAO,KAAK;GACZ,SAAS,KAAK;GACd,UAAU,KAAK,SAAS;GACxB,YAAY,KAAK,WAAW;EAC9B,CAAC;CACE,CAAA;AAET;AAEA,SAAgB,oBAAoB,EAClC,UACA,MAAM,GACN,YAAY,SACe;CAC3B,MAAM,QAAQ,cAAc,UAAU;CACtC,MAAM,OAAO,cAAcA,eAAmB;CAC9C,YAAY,aAAa,MAAM,EAAE,aAAa,CAAC;CAC/C,MAAM,SAAS,YACbA,kBACC,MAAM,EAAE,oBAAoB,GAC7B,uBACF;CAEA,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,MAAM,iBAAiB,OAAO,KAAK,OAAO,MAAM;CAC5D,IAAI,CAAC,KAAK,OAAO;CACjB,MAAM,MAAM,uBAAuB,KAAK,WAAW,GAAG;CACtD,OACE,oBAAC,OAAD;EACO;EACL,OAAO;GACL,UAAU;GACV,MAAM,IAAI;GACV,KAAK,IAAI;GACT,WAAW,IAAI;GACf,eAAe;EACjB;EAEC,UAAA,SAAS;GACR,GAAG;GACH,QAAQ,KAAK;GACb,QAAQ,KAAK;EACf,CAAC;CACE,CAAA;AAET"}
+{"version":3,"file":"annotation-menu.js","names":["AnnotationHostToken"],"sources":["../src/annotation-menu.tsx"],"sourcesContent":["/**\n * Annotation menus — thin anchor plumbing over the ONE `<Anchored>` primitive.\n *\n * These work identically under `<Stage>` (mount in the overlay slot; the\n * camera projects, no DOM reads) and `<PageView>` (measured + portalled) —\n * the SURFACE provides the projector, the menu doesn't care.\n *\n * No action bags: actions come from the capability hooks (`useAnnotation()`,\n * `useAnnotationSelected()`, …), which subscribe properly and compose across\n * plugins. Render props carry only the ANCHOR'S DATA (the draft menu's\n * progress facts); the annotation-selection menu takes plain children.\n */\nimport * as React from 'react';\nimport { AnnotationToken as AnnotationHostToken } from '@embedpdf/plugin-annotation/contract/host';\nimport type { CreationDraftAnchor } from '@embedpdf/core-annotation';\nimport { Anchored, useProjectorBinding, type AnchoredPlacement } from './anchored';\nimport { useSelector } from './runtime';\nimport { sameAnchor, sameCreationDraftAnchor } from './annotation-anchors';\n\nexport interface AnnotationMenuProps {\n  children: React.ReactNode;\n  /** Gap in screen px between the selection box and the menu (default 15). */\n  gap?: number;\n  /** Where to place the menu relative to the selection box. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/**\n * Floats over the current annotation selection (one anchor regardless of\n * cross-page selection), dodging the rotate knob. Compose the contents from\n * hooks: `useAnnotation()` for the verbs, `useAnnotationSelected()` /\n * `useSelectionProps()` for the data.\n */\nexport function AnnotationMenu({ children, gap = 15, placement = 'top' }: AnnotationMenuProps) {\n  // Reading the binding subscribes this component to projection changes\n  // (its identity IS the revision), so the anchor read below re-runs with\n  // fresh view facts in the SAME commit as the surface — the knob offset is\n  // screen-constant, so its content-space position depends on the page's\n  // live view scale.\n  const { projector } = useProjectorBinding();\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => {\n      const a = c.selectionAnchor();\n      if (!a) return null;\n      const env = projector.viewEnv(a.pon);\n      return env ? c.selectionAnchor(env.scale, env.rotation, env.zoom) : a;\n    },\n    sameAnchor,\n  );\n  if (!anchor) return null;\n  return (\n    <Anchored\n      anchor={{\n        pon: anchor.pon,\n        bounds: anchor.bounds,\n        ...(anchor.knob ? { avoid: [anchor.knob] } : {}),\n      }}\n      placement={placement}\n      gap={gap}\n    >\n      {children}\n    </Anchored>\n  );\n}\n\nexport interface AnnotationDraftMenuProps {\n  /** Render prop receiving the DRAFT ANCHOR'S DATA (subtype, pointCount,\n   *  minPoints, canFinish, …). The verbs are capability calls:\n   *  `useAnnotation().finishCreationDraft()` / `.cancelCreationDraft()`. */\n  children: (anchor: CreationDraftAnchor) => React.ReactNode;\n  /** Gap in screen px between the draft anchor and the menu (default 8). */\n  gap?: number;\n  /** Where to place the menu relative to the draft anchor. Default 'top'. */\n  placement?: AnchoredPlacement;\n}\n\n/** Floats over a live multi-click creation draft (polygon, polyline, …). */\nexport function AnnotationDraftMenu({\n  children,\n  gap = 8,\n  placement = 'top',\n}: AnnotationDraftMenuProps) {\n  const anchor = useSelector(\n    AnnotationHostToken,\n    (c) => c.creationDraftAnchor(),\n    sameCreationDraftAnchor,\n  );\n  if (!anchor) return null;\n  return (\n    <Anchored anchor={anchor} placement={placement} gap={gap}>\n      {children(anchor)}\n    </Anchored>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAiCA,SAAgB,eAAe,EAAE,UAAU,MAAM,IAAI,YAAY,SAA8B;CAM7F,MAAM,EAAE,cAAc,oBAAoB;CAC1C,MAAM,SAAS,YACbA,kBACC,MAAM;EACL,MAAM,IAAI,EAAE,gBAAgB;EAC5B,IAAI,CAAC,GAAG,OAAO;EACf,MAAM,MAAM,UAAU,QAAQ,EAAE,GAAG;EACnC,OAAO,MAAM,EAAE,gBAAgB,IAAI,OAAO,IAAI,UAAU,IAAI,IAAI,IAAI;CACtE,GACA,UACF;CACA,IAAI,CAAC,QAAQ,OAAO;CACpB,OACE,oBAAC,UAAD;EACE,QAAQ;GACN,KAAK,OAAO;GACZ,QAAQ,OAAO;GACf,GAAI,OAAO,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC;EAChD;EACW;EACN;EAEJ;CACO,CAAA;AAEd;;AAcA,SAAgB,oBAAoB,EAClC,UACA,MAAM,GACN,YAAY,SACe;CAC3B,MAAM,SAAS,YACbA,kBACC,MAAM,EAAE,oBAAoB,GAC7B,uBACF;CACA,IAAI,CAAC,QAAQ,OAAO;CACpB,OACE,oBAAC,UAAD;EAAkB;EAAmB;EAAgB;EAClD,UAAA,SAAS,MAAM;CACR,CAAA;AAEd"}