@embedpdf/react 3.0.0-next.3 → 3.0.0-next.5

package/dist/{AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.cts → AnnotationListSnapshot-CHjkcIaL-CMHGL8-D.d.cts}

@@ -669,7 +669,7 @@ declare enum ZodFirstPartyTypeKind {
   ZodReadonly = "ZodReadonly"
 }
 //#endregion
-//#region ../../engine/core/dist/AnnotationListSnapshot-W0RCsyDE.d.ts
+//#region ../../engine/core/dist/AnnotationListSnapshot-CHjkcIaL.d.ts
 //#endregion
 //#region src/dto/PdfAction.d.ts
 /** Normalized values of an action dictionary's `/S` name. */
@@ -2256,6 +2256,9 @@ interface CaretDraft extends AnnotationDraftBase, ColorStyleDraftFields {
   rect: PdfRect;
   /** `/RD` inset of the drawn caret from `/Rect`. */
   rectDifferences?: PdfRectDifferences | null;
+  /** Tri-state box-rotation pair (see the DTO): omitted/`null` = upright. */
+  rotation?: number | null;
+  unrotatedRect?: PdfRect | null;
 }
 //#endregion
 //#region src/annotation/kinds/caret/dto.d.ts
@@ -2263,6 +2266,12 @@ interface CaretDraft extends AnnotationDraftBase, ColorStyleDraftFields {
  * Caret annotation — a visual marker for a proposed text insertion or edit
  * point. It carries no geometry of its own beyond `/Rect`: just a `/C` color,
  * `/CA` opacity, and an optional `/RD` inset of the drawn symbol from `/Rect`.
+ *
+ * A caret anchored to ROTATED text carries the box-family rotation pair:
+ * `rotation` (`/EMBD_Metadata/Rotation`, PDF-convention degrees) tilts the
+ * baked symbol to ride its text's baseline, `unrotatedRect` is the logical
+ * box, and `/Rect` stays the rotated visual AABB — exactly the shape/free-text
+ * contract, so the generic AP machinery bakes it.
  */
 type CaretAnnotationDTO = AnnotationBase & ColorStyleFields & {
   subtype: 'caret';
@@ -2270,6 +2279,10 @@ type CaretAnnotationDTO = AnnotationBase & ColorStyleFields & {
   intent: CaretIntent | null;
   /** `/RD` inset of the drawn caret from `/Rect`; `null` when absent. */
   rectDifferences: PdfRectDifferences | null;
+  /** `/EMBD_Metadata/Rotation` — degrees, normalized `[0,360)`. */
+  rotation?: number;
+  /** `/EMBD_Metadata/UnrotatedRect` — the logical box (required when rotation != 0). */
+  unrotatedRect?: PdfRect;
 };
 //#endregion
 //#region src/annotation/kinds/caret/patch.d.ts
@@ -2279,6 +2292,10 @@ interface CaretPatch extends AnnotationPatchBase, ColorStylePatchFields {
   rect?: PdfRect;
   /** Tri-state: omitted preserves, a value sets, `null` removes `/RD`. */
   rectDifferences?: PdfRectDifferences | null;
+  /** Tri-state: omitted preserves, `null`/`0` flattens, a value sets (needs the box). */
+  rotation?: number | null;
+  /** Tri-state: omitted preserves, `null` removes, a value sets. */
+  unrotatedRect?: PdfRect | null;
 }
 //#endregion
 //#region src/annotation/kinds/text/draft.d.ts
@@ -2590,4 +2607,4 @@ type DTOFromKind<K> = K extends AnnotationKindModule<infer _S, infer D, infer _D
 type AnnotationDTO = DTOFromKind<AnnotationKind>;
 //#endregion
 export { FormSnapshot as n, SearchQuery as r, AnnotationDTO as t };
-//# sourceMappingURL=AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.cts.map
+//# sourceMappingURL=AnnotationListSnapshot-CHjkcIaL-CMHGL8-D.d.cts.map

package/dist/{AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.ts → AnnotationListSnapshot-CHjkcIaL-CMHGL8-D.d.ts}

@@ -669,7 +669,7 @@ declare enum ZodFirstPartyTypeKind {
   ZodReadonly = "ZodReadonly"
 }
 //#endregion
-//#region ../../engine/core/dist/AnnotationListSnapshot-W0RCsyDE.d.ts
+//#region ../../engine/core/dist/AnnotationListSnapshot-CHjkcIaL.d.ts
 //#endregion
 //#region src/dto/PdfAction.d.ts
 /** Normalized values of an action dictionary's `/S` name. */
@@ -2256,6 +2256,9 @@ interface CaretDraft extends AnnotationDraftBase, ColorStyleDraftFields {
   rect: PdfRect;
   /** `/RD` inset of the drawn caret from `/Rect`. */
   rectDifferences?: PdfRectDifferences | null;
+  /** Tri-state box-rotation pair (see the DTO): omitted/`null` = upright. */
+  rotation?: number | null;
+  unrotatedRect?: PdfRect | null;
 }
 //#endregion
 //#region src/annotation/kinds/caret/dto.d.ts
@@ -2263,6 +2266,12 @@ interface CaretDraft extends AnnotationDraftBase, ColorStyleDraftFields {
  * Caret annotation — a visual marker for a proposed text insertion or edit
  * point. It carries no geometry of its own beyond `/Rect`: just a `/C` color,
  * `/CA` opacity, and an optional `/RD` inset of the drawn symbol from `/Rect`.
+ *
+ * A caret anchored to ROTATED text carries the box-family rotation pair:
+ * `rotation` (`/EMBD_Metadata/Rotation`, PDF-convention degrees) tilts the
+ * baked symbol to ride its text's baseline, `unrotatedRect` is the logical
+ * box, and `/Rect` stays the rotated visual AABB — exactly the shape/free-text
+ * contract, so the generic AP machinery bakes it.
  */
 type CaretAnnotationDTO = AnnotationBase & ColorStyleFields & {
   subtype: 'caret';
@@ -2270,6 +2279,10 @@ type CaretAnnotationDTO = AnnotationBase & ColorStyleFields & {
   intent: CaretIntent | null;
   /** `/RD` inset of the drawn caret from `/Rect`; `null` when absent. */
   rectDifferences: PdfRectDifferences | null;
+  /** `/EMBD_Metadata/Rotation` — degrees, normalized `[0,360)`. */
+  rotation?: number;
+  /** `/EMBD_Metadata/UnrotatedRect` — the logical box (required when rotation != 0). */
+  unrotatedRect?: PdfRect;
 };
 //#endregion
 //#region src/annotation/kinds/caret/patch.d.ts
@@ -2279,6 +2292,10 @@ interface CaretPatch extends AnnotationPatchBase, ColorStylePatchFields {
   rect?: PdfRect;
   /** Tri-state: omitted preserves, a value sets, `null` removes `/RD`. */
   rectDifferences?: PdfRectDifferences | null;
+  /** Tri-state: omitted preserves, `null`/`0` flattens, a value sets (needs the box). */
+  rotation?: number | null;
+  /** Tri-state: omitted preserves, `null` removes, a value sets. */
+  unrotatedRect?: PdfRect | null;
 }
 //#endregion
 //#region src/annotation/kinds/text/draft.d.ts
@@ -2590,4 +2607,4 @@ type DTOFromKind<K> = K extends AnnotationKindModule<infer _S, infer D, infer _D
 type AnnotationDTO = DTOFromKind<AnnotationKind>;
 //#endregion
 export { FormSnapshot as n, SearchQuery as r, AnnotationDTO as t };
-//# sourceMappingURL=AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.ts.map
+//# sourceMappingURL=AnnotationListSnapshot-CHjkcIaL-CMHGL8-D.d.ts.map

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-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 = require("./annotation.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");
 //#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 { projector } = require_anchored.useProjectorBinding();
 	const anchor = require_runtime.useSelector(_embedpdf_plugin_annotation_internal.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;
 	}, 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);
-	});
 	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);
-	});
 	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/internal';\nimport type { CreationDraftAnchor } from '@embedpdf/core-annotation';\nimport { Anchored, useProjectorBinding, type AnchoredPlacement } from './anchored';\nimport { useSelector } from './runtime';\nimport { sameAnchor, sameCreationDraftAnchor } from './annotation';\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,qCAAAA,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,mBAAAA,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,qCAAAA,kBACC,MAAM,EAAE,oBAAoB,GAC7BG,mBAAAA,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