@embedpdf/react 3.0.0-next.0

package/dist/selection.js

@@ -0,0 +1,49 @@
+import { shallowArray, useCapability, usePage, useSelector } from "./runtime.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect } from "react";
+import { SelectionToken } from "@embedpdf/plugin-selection";
+export * from "@embedpdf/plugin-selection";
+//#region src/selection.tsx
+function SelectionLayer({ color = "rgba(33, 150, 243, 0.35)" }) {
+	const page = usePage();
+	const selection = useCapability(SelectionToken);
+	const rects = useSelector(SelectionToken, (c) => c.rectsForPage(page.pon), shallowArray);
+	const visible = useSelector(SelectionToken, (c) => c.highlightVisible());
+	useEffect(() => {
+		selection.ensurePage(page.pon);
+	}, [selection, page.pon]);
+	if (!visible) return null;
+	return /* @__PURE__ */ jsx("div", {
+		style: {
+			position: "absolute",
+			inset: 0,
+			pointerEvents: "none"
+		},
+		children: rects.map((r, i) => {
+			const tl = page.transform.pageToContent({
+				x: r.x,
+				y: r.y
+			});
+			const br = page.transform.pageToContent({
+				x: r.x + r.width,
+				y: r.y + r.height
+			});
+			return /* @__PURE__ */ jsx("div", { style: {
+				position: "absolute",
+				left: tl.x,
+				top: tl.y,
+				width: br.x - tl.x,
+				height: br.y - tl.y,
+				background: color
+			} }, i);
+		})
+	});
+}
+/** The selection capability (clear(), hasSelection(), …) for app chrome. */
+function useSelection() {
+	return useCapability(SelectionToken);
+}
+//#endregion
+export { SelectionLayer, useSelection };
+
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","names":[],"sources":["../src/selection.tsx"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-selection.\n *\n * <SelectionLayer> is a dumb renderer: it warms the page's geometry on mount,\n * reads the content-space highlight rects from the capability, and paints them —\n * mapping each rect through PageContext.pageToContent (the same path markers use).\n * Zero pointer handling here; that's the PagePointerSource + the hub.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-selection';\nimport * as React from 'react';\nimport { useEffect } from 'react';\nimport { SelectionToken } from '@embedpdf/plugin-selection';\nimport { shallowArray, useCapability, usePage, useSelector } from './runtime';\n\nexport interface SelectionLayerProps {\n  /** Highlight colour (default: translucent blue). */\n  color?: string;\n}\n\nexport function SelectionLayer({ color = 'rgba(33, 150, 243, 0.35)' }: SelectionLayerProps) {\n  const page = usePage();\n  const selection = useCapability(SelectionToken);\n  const rects = useSelector(SelectionToken, (c) => c.rectsForPage(page.pon), shallowArray);\n  // A consumer (e.g. a markup tool drawing its own preview) can take over the\n  // selection visual; when it does, we render nothing so the two never overlap.\n  const visible = useSelector(SelectionToken, (c) => c.highlightVisible());\n\n  // Warm this page's text geometry as soon as it's on screen, so the first\n  // pointer-down can hit-test without waiting on the engine round-trip.\n  useEffect(() => {\n    selection.ensurePage(page.pon);\n  }, [selection, page.pon]);\n\n  if (!visible) return null;\n\n  return (\n    <div style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>\n      {rects.map((r, i) => {\n        // content space → un-rotated content view px (rides the page's CSS rotation)\n        const tl = page.transform.pageToContent({ x: r.x, y: r.y });\n        const br = page.transform.pageToContent({ x: r.x + r.width, y: r.y + r.height });\n        return (\n          <div\n            key={i}\n            style={{\n              position: 'absolute',\n              left: tl.x,\n              top: tl.y,\n              width: br.x - tl.x,\n              height: br.y - tl.y,\n              background: color,\n            }}\n          />\n        );\n      })}\n    </div>\n  );\n}\n\n/** The selection capability (clear(), hasSelection(), …) for app chrome. */\nexport function useSelection() {\n  return useCapability(SelectionToken);\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,eAAe,EAAE,QAAQ,8BAAmD;CAC1F,MAAM,OAAO,QAAQ;CACrB,MAAM,YAAY,cAAc,cAAc;CAC9C,MAAM,QAAQ,YAAY,iBAAiB,MAAM,EAAE,aAAa,KAAK,GAAG,GAAG,YAAY;CAGvF,MAAM,UAAU,YAAY,iBAAiB,MAAM,EAAE,iBAAiB,CAAC;CAIvE,gBAAgB;EACd,UAAU,WAAW,KAAK,GAAG;CAC/B,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC;CAExB,IAAI,CAAC,SAAS,OAAO;CAErB,OACE,oBAAC,OAAD;EAAK,OAAO;GAAE,UAAU;GAAY,OAAO;GAAG,eAAe;EAAO;EACjE,UAAA,MAAM,KAAK,GAAG,MAAM;GAEnB,MAAM,KAAK,KAAK,UAAU,cAAc;IAAE,GAAG,EAAE;IAAG,GAAG,EAAE;GAAE,CAAC;GAC1D,MAAM,KAAK,KAAK,UAAU,cAAc;IAAE,GAAG,EAAE,IAAI,EAAE;IAAO,GAAG,EAAE,IAAI,EAAE;GAAO,CAAC;GAC/E,OACE,oBAAC,OAAD,EAEE,OAAO;IACL,UAAU;IACV,MAAM,GAAG;IACT,KAAK,GAAG;IACR,OAAO,GAAG,IAAI,GAAG;IACjB,QAAQ,GAAG,IAAI,GAAG;IAClB,YAAY;GACd,EACD,GATM,CASN;EAEL,CAAC;CACE,CAAA;AAET;;AAGA,SAAgB,eAAe;CAC7B,OAAO,cAAc,cAAc;AACrC"}

package/dist/shell.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./rolldown-runtime-DDXJien1.cjs");
+const require_runtime = require("./runtime.cjs");
+let react = require("react");
+let _embedpdf_plugin_shell = require("@embedpdf/plugin-shell");
+//#region src/shell.ts
+/** The raw capability — throws without a document; for gated subtrees. */
+function useShell() {
+	return require_runtime.useCapability(_embedpdf_plugin_shell.ShellToken);
+}
+/** One named surface (panel / modal / overlay), bound to this subtree's
+*  document. Reads as closed — and intents no-op — while no document is open. */
+function useSurface(id) {
+	const shell = require_runtime.useOptionalCapability(_embedpdf_plugin_shell.ShellToken);
+	const isOpen = require_runtime.useOptionalSelector(_embedpdf_plugin_shell.ShellToken, (s) => s.isOpen(id), false);
+	const props = require_runtime.useOptionalSelector(_embedpdf_plugin_shell.ShellToken, (s) => s.surfaceProps(id), void 0);
+	return (0, react.useMemo)(() => ({
+		isOpen,
+		props,
+		open: (opts) => shell?.open(id, opts),
+		close: () => shell?.close(id),
+		toggle: (opts) => shell?.toggle(id, opts)
+	}), [
+		shell,
+		id,
+		isOpen,
+		props
+	]);
+}
+const NO_MENUS = [];
+const stringArrayEqual = (a, b) => a === b || a.length === b.length && a.every((x, i) => x === b[i]);
+/** The dropdown-menu stack for this subtree's document (empty without one). */
+function useMenus() {
+	const shell = require_runtime.useOptionalCapability(_embedpdf_plugin_shell.ShellToken);
+	const open = require_runtime.useOptionalSelector(_embedpdf_plugin_shell.ShellToken, (s) => s.openMenus(), NO_MENUS, stringArrayEqual);
+	return (0, react.useMemo)(() => ({
+		open,
+		isOpen: (id) => open.includes(id),
+		toggle: (id) => shell?.toggleMenu(id),
+		close: (id) => shell?.closeMenu(id),
+		closeAll: () => shell?.closeAllMenus()
+	}), [shell, open]);
+}
+//#endregion
+exports.useMenus = useMenus;
+exports.useShell = useShell;
+exports.useSurface = useSurface;
+Object.keys(_embedpdf_plugin_shell).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _embedpdf_plugin_shell[k];
+		}
+	});
+});
+
+//# sourceMappingURL=shell.cjs.map

package/dist/shell.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.cjs","names":["useCapability","ShellToken","useOptionalCapability","useOptionalSelector"],"sources":["../src/shell.ts"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-shell. The app owns every\n * surface's DOM; these hooks bind its open/closed state to the kernel so\n * commands can drive it and applications can restore it.\n *\n * These hooks are TOTAL: shell state is document-scoped, and chrome that uses\n * it (panel buttons, mode bands, menu anchors) stays mounted across the\n * empty-workspace state. With no document, surfaces read as closed, menus as\n * none, and intents no-op — mirroring how command execution `tryGet`s the\n * shell. Use the raw capability (`useShell`) when you need fail-fast access\n * inside a <DocumentGate>.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-shell';\nimport { useMemo } from 'react';\nimport { ShellToken } from '@embedpdf/plugin-shell';\nimport type { OpenSurfaceOptions, ShellCapability } from '@embedpdf/plugin-shell';\nimport { useCapability, useOptionalCapability, useOptionalSelector } from './runtime';\n\n/** The raw capability — throws without a document; for gated subtrees. */\nexport function useShell(): ShellCapability {\n  return useCapability(ShellToken);\n}\n\nexport interface SurfaceHandle {\n  readonly isOpen: boolean;\n  readonly props: Readonly<Record<string, unknown>> | undefined;\n  open(opts?: OpenSurfaceOptions): void;\n  close(): void;\n  toggle(opts?: OpenSurfaceOptions): void;\n}\n\n/** One named surface (panel / modal / overlay), bound to this subtree's\n *  document. Reads as closed — and intents no-op — while no document is open. */\nexport function useSurface(id: string): SurfaceHandle {\n  const shell = useOptionalCapability(ShellToken);\n  const isOpen = useOptionalSelector(ShellToken, (s) => s.isOpen(id), false);\n  const props = useOptionalSelector(ShellToken, (s) => s.surfaceProps(id), undefined);\n  return useMemo(\n    () => ({\n      isOpen,\n      props,\n      open: (opts?: OpenSurfaceOptions) => shell?.open(id, opts),\n      close: () => shell?.close(id),\n      toggle: (opts?: OpenSurfaceOptions) => shell?.toggle(id, opts),\n    }),\n    [shell, id, isOpen, props],\n  );\n}\n\nexport interface MenusHandle {\n  readonly open: readonly string[];\n  isOpen(id: string): boolean;\n  toggle(id: string): void;\n  close(id: string): void;\n  closeAll(): void;\n}\n\nconst NO_MENUS: readonly string[] = [];\nconst stringArrayEqual = (a: readonly string[], b: readonly string[]) =>\n  a === b || (a.length === b.length && a.every((x, i) => x === b[i]));\n\n/** The dropdown-menu stack for this subtree's document (empty without one). */\nexport function useMenus(): MenusHandle {\n  const shell = useOptionalCapability(ShellToken);\n  const open = useOptionalSelector(ShellToken, (s) => s.openMenus(), NO_MENUS, stringArrayEqual);\n  return useMemo(\n    () => ({\n      open,\n      isOpen: (id: string) => open.includes(id),\n      toggle: (id: string) => shell?.toggleMenu(id),\n      close: (id: string) => shell?.closeMenu(id),\n      closeAll: () => shell?.closeAllMenus(),\n    }),\n    [shell, open],\n  );\n}\n"],"mappings":";;;;;;;AAqBA,SAAgB,WAA4B;CAC1C,OAAOA,gBAAAA,cAAcC,uBAAAA,UAAU;AACjC;;;AAYA,SAAgB,WAAW,IAA2B;CACpD,MAAM,QAAQC,gBAAAA,sBAAsBD,uBAAAA,UAAU;CAC9C,MAAM,SAASE,gBAAAA,oBAAoBF,uBAAAA,aAAa,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK;CACzE,MAAM,QAAQE,gBAAAA,oBAAoBF,uBAAAA,aAAa,MAAM,EAAE,aAAa,EAAE,GAAG,KAAA,CAAS;CAClF,QAAA,GAAA,MAAA,QAAA,QACS;EACL;EACA;EACA,OAAO,SAA8B,OAAO,KAAK,IAAI,IAAI;EACzD,aAAa,OAAO,MAAM,EAAE;EAC5B,SAAS,SAA8B,OAAO,OAAO,IAAI,IAAI;CAC/D,IACA;EAAC;EAAO;EAAI;EAAQ;CAAK,CAC3B;AACF;AAUA,MAAM,WAA8B,CAAC;AACrC,MAAM,oBAAoB,GAAsB,MAC9C,MAAM,KAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,MAAM,EAAE,EAAE;;AAGnE,SAAgB,WAAwB;CACtC,MAAM,QAAQC,gBAAAA,sBAAsBD,uBAAAA,UAAU;CAC9C,MAAM,OAAOE,gBAAAA,oBAAoBF,uBAAAA,aAAa,MAAM,EAAE,UAAU,GAAG,UAAU,gBAAgB;CAC7F,QAAA,GAAA,MAAA,QAAA,QACS;EACL;EACA,SAAS,OAAe,KAAK,SAAS,EAAE;EACxC,SAAS,OAAe,OAAO,WAAW,EAAE;EAC5C,QAAQ,OAAe,OAAO,UAAU,EAAE;EAC1C,gBAAgB,OAAO,cAAc;CACvC,IACA,CAAC,OAAO,IAAI,CACd;AACF"}

package/dist/shell.d.cts

@@ -0,0 +1,27 @@
+import { OpenSurfaceOptions, ShellCapability } from "@embedpdf/plugin-shell";
+export * from "@embedpdf/plugin-shell";
+//#region src/shell.d.ts
+/** The raw capability — throws without a document; for gated subtrees. */
+declare function useShell(): ShellCapability;
+interface SurfaceHandle {
+  readonly isOpen: boolean;
+  readonly props: Readonly<Record<string, unknown>> | undefined;
+  open(opts?: OpenSurfaceOptions): void;
+  close(): void;
+  toggle(opts?: OpenSurfaceOptions): void;
+}
+/** One named surface (panel / modal / overlay), bound to this subtree's
+ *  document. Reads as closed — and intents no-op — while no document is open. */
+declare function useSurface(id: string): SurfaceHandle;
+interface MenusHandle {
+  readonly open: readonly string[];
+  isOpen(id: string): boolean;
+  toggle(id: string): void;
+  close(id: string): void;
+  closeAll(): void;
+}
+/** The dropdown-menu stack for this subtree's document (empty without one). */
+declare function useMenus(): MenusHandle;
+//#endregion
+export { MenusHandle, SurfaceHandle, useMenus, useShell, useSurface };
+//# sourceMappingURL=shell.d.cts.map

package/dist/shell.d.ts

@@ -0,0 +1,27 @@
+import { OpenSurfaceOptions, ShellCapability } from "@embedpdf/plugin-shell";
+export * from "@embedpdf/plugin-shell";
+//#region src/shell.d.ts
+/** The raw capability — throws without a document; for gated subtrees. */
+declare function useShell(): ShellCapability;
+interface SurfaceHandle {
+  readonly isOpen: boolean;
+  readonly props: Readonly<Record<string, unknown>> | undefined;
+  open(opts?: OpenSurfaceOptions): void;
+  close(): void;
+  toggle(opts?: OpenSurfaceOptions): void;
+}
+/** One named surface (panel / modal / overlay), bound to this subtree's
+ *  document. Reads as closed — and intents no-op — while no document is open. */
+declare function useSurface(id: string): SurfaceHandle;
+interface MenusHandle {
+  readonly open: readonly string[];
+  isOpen(id: string): boolean;
+  toggle(id: string): void;
+  close(id: string): void;
+  closeAll(): void;
+}
+/** The dropdown-menu stack for this subtree's document (empty without one). */
+declare function useMenus(): MenusHandle;
+//#endregion
+export { MenusHandle, SurfaceHandle, useMenus, useShell, useSurface };
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.js

@@ -0,0 +1,46 @@
+import { useCapability, useOptionalCapability, useOptionalSelector } from "./runtime.js";
+import { useMemo } from "react";
+import { ShellToken } from "@embedpdf/plugin-shell";
+export * from "@embedpdf/plugin-shell";
+//#region src/shell.ts
+/** The raw capability — throws without a document; for gated subtrees. */
+function useShell() {
+	return useCapability(ShellToken);
+}
+/** One named surface (panel / modal / overlay), bound to this subtree's
+*  document. Reads as closed — and intents no-op — while no document is open. */
+function useSurface(id) {
+	const shell = useOptionalCapability(ShellToken);
+	const isOpen = useOptionalSelector(ShellToken, (s) => s.isOpen(id), false);
+	const props = useOptionalSelector(ShellToken, (s) => s.surfaceProps(id), void 0);
+	return useMemo(() => ({
+		isOpen,
+		props,
+		open: (opts) => shell?.open(id, opts),
+		close: () => shell?.close(id),
+		toggle: (opts) => shell?.toggle(id, opts)
+	}), [
+		shell,
+		id,
+		isOpen,
+		props
+	]);
+}
+const NO_MENUS = [];
+const stringArrayEqual = (a, b) => a === b || a.length === b.length && a.every((x, i) => x === b[i]);
+/** The dropdown-menu stack for this subtree's document (empty without one). */
+function useMenus() {
+	const shell = useOptionalCapability(ShellToken);
+	const open = useOptionalSelector(ShellToken, (s) => s.openMenus(), NO_MENUS, stringArrayEqual);
+	return useMemo(() => ({
+		open,
+		isOpen: (id) => open.includes(id),
+		toggle: (id) => shell?.toggleMenu(id),
+		close: (id) => shell?.closeMenu(id),
+		closeAll: () => shell?.closeAllMenus()
+	}), [shell, open]);
+}
+//#endregion
+export { useMenus, useShell, useSurface };
+
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","names":[],"sources":["../src/shell.ts"],"sourcesContent":["/**\n * The React surface for @embedpdf/plugin-shell. The app owns every\n * surface's DOM; these hooks bind its open/closed state to the kernel so\n * commands can drive it and applications can restore it.\n *\n * These hooks are TOTAL: shell state is document-scoped, and chrome that uses\n * it (panel buttons, mode bands, menu anchors) stays mounted across the\n * empty-workspace state. With no document, surfaces read as closed, menus as\n * none, and intents no-op — mirroring how command execution `tryGet`s the\n * shell. Use the raw capability (`useShell`) when you need fail-fast access\n * inside a <DocumentGate>.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-shell';\nimport { useMemo } from 'react';\nimport { ShellToken } from '@embedpdf/plugin-shell';\nimport type { OpenSurfaceOptions, ShellCapability } from '@embedpdf/plugin-shell';\nimport { useCapability, useOptionalCapability, useOptionalSelector } from './runtime';\n\n/** The raw capability — throws without a document; for gated subtrees. */\nexport function useShell(): ShellCapability {\n  return useCapability(ShellToken);\n}\n\nexport interface SurfaceHandle {\n  readonly isOpen: boolean;\n  readonly props: Readonly<Record<string, unknown>> | undefined;\n  open(opts?: OpenSurfaceOptions): void;\n  close(): void;\n  toggle(opts?: OpenSurfaceOptions): void;\n}\n\n/** One named surface (panel / modal / overlay), bound to this subtree's\n *  document. Reads as closed — and intents no-op — while no document is open. */\nexport function useSurface(id: string): SurfaceHandle {\n  const shell = useOptionalCapability(ShellToken);\n  const isOpen = useOptionalSelector(ShellToken, (s) => s.isOpen(id), false);\n  const props = useOptionalSelector(ShellToken, (s) => s.surfaceProps(id), undefined);\n  return useMemo(\n    () => ({\n      isOpen,\n      props,\n      open: (opts?: OpenSurfaceOptions) => shell?.open(id, opts),\n      close: () => shell?.close(id),\n      toggle: (opts?: OpenSurfaceOptions) => shell?.toggle(id, opts),\n    }),\n    [shell, id, isOpen, props],\n  );\n}\n\nexport interface MenusHandle {\n  readonly open: readonly string[];\n  isOpen(id: string): boolean;\n  toggle(id: string): void;\n  close(id: string): void;\n  closeAll(): void;\n}\n\nconst NO_MENUS: readonly string[] = [];\nconst stringArrayEqual = (a: readonly string[], b: readonly string[]) =>\n  a === b || (a.length === b.length && a.every((x, i) => x === b[i]));\n\n/** The dropdown-menu stack for this subtree's document (empty without one). */\nexport function useMenus(): MenusHandle {\n  const shell = useOptionalCapability(ShellToken);\n  const open = useOptionalSelector(ShellToken, (s) => s.openMenus(), NO_MENUS, stringArrayEqual);\n  return useMemo(\n    () => ({\n      open,\n      isOpen: (id: string) => open.includes(id),\n      toggle: (id: string) => shell?.toggleMenu(id),\n      close: (id: string) => shell?.closeMenu(id),\n      closeAll: () => shell?.closeAllMenus(),\n    }),\n    [shell, open],\n  );\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,WAA4B;CAC1C,OAAO,cAAc,UAAU;AACjC;;;AAYA,SAAgB,WAAW,IAA2B;CACpD,MAAM,QAAQ,sBAAsB,UAAU;CAC9C,MAAM,SAAS,oBAAoB,aAAa,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK;CACzE,MAAM,QAAQ,oBAAoB,aAAa,MAAM,EAAE,aAAa,EAAE,GAAG,KAAA,CAAS;CAClF,OAAO,eACE;EACL;EACA;EACA,OAAO,SAA8B,OAAO,KAAK,IAAI,IAAI;EACzD,aAAa,OAAO,MAAM,EAAE;EAC5B,SAAS,SAA8B,OAAO,OAAO,IAAI,IAAI;CAC/D,IACA;EAAC;EAAO;EAAI;EAAQ;CAAK,CAC3B;AACF;AAUA,MAAM,WAA8B,CAAC;AACrC,MAAM,oBAAoB,GAAsB,MAC9C,MAAM,KAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,MAAM,EAAE,EAAE;;AAGnE,SAAgB,WAAwB;CACtC,MAAM,QAAQ,sBAAsB,UAAU;CAC9C,MAAM,OAAO,oBAAoB,aAAa,MAAM,EAAE,UAAU,GAAG,UAAU,gBAAgB;CAC7F,OAAO,eACE;EACL;EACA,SAAS,OAAe,KAAK,SAAS,EAAE;EACxC,SAAS,OAAe,OAAO,WAAW,EAAE;EAC5C,QAAQ,OAAe,OAAO,UAAU,EAAE;EAC1C,gBAAgB,OAAO,cAAc;CACvC,IACA,CAAC,OAAO,IAAI,CACd;AACF"}

package/dist/stage.cjs

@@ -0,0 +1,343 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
+const require_runtime = require("./runtime.cjs");
+const require_interaction = require("./interaction.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_interaction = require("@embedpdf/plugin-interaction");
+//#region src/stage.tsx
+function PageSurface({ documentId, page, frame, stage, render, chrome }) {
+	const ref = (0, react.useRef)(null);
+	const t = page.transform;
+	const rotation = page.rotation;
+	const outerW = t.viewWidth + frame.left + frame.right;
+	const outerH = t.viewHeight + frame.top + frame.bottom;
+	const left = page.screenX - frame.left;
+	const top = page.screenY - frame.top;
+	const contentLeft = frame.left + (t.viewWidth - t.contentWidth) / 2;
+	const contentTop = frame.top + (t.viewHeight - t.contentHeight) / 2;
+	const ctx = (0, react.useMemo)(() => require_runtime.makePageContext(documentId, page.pon, page.pageIndex, frame, t, () => ref.current.getBoundingClientRect(), () => {
+		const live = stage.visiblePages().find((p) => p.pon === page.pon);
+		return live ? {
+			desiredDeviceWidth: live.transform.deviceWidth,
+			visibleRect: live.visibleRect
+		} : {
+			desiredDeviceWidth: t.deviceWidth,
+			visibleRect: {
+				x: 0,
+				y: 0,
+				width: 0,
+				height: 0
+			}
+		};
+	}), [
+		documentId,
+		page.pon,
+		page.pageIndex,
+		frame,
+		t,
+		stage
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		style: {
+			position: "absolute",
+			left,
+			top,
+			width: outerW,
+			height: outerH
+		},
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_runtime.PageProvider, {
+			value: ctx,
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { style: {
+					position: "absolute",
+					left: frame.left,
+					top: frame.top,
+					width: t.viewWidth,
+					height: t.viewHeight,
+					boxShadow: "0 6px 18px rgba(0,0,0,.18)"
+				} }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					ref,
+					style: {
+						position: "absolute",
+						left: contentLeft,
+						top: contentTop,
+						width: t.contentWidth,
+						height: t.contentHeight,
+						background: "#fff",
+						transform: rotation ? `rotate(${rotation}deg)` : void 0,
+						userSelect: "none",
+						WebkitUserSelect: "none"
+					},
+					children: render(ctx)
+				}),
+				chrome?.(ctx)
+			]
+		})
+	});
+}
+function Stage({ children, pageChrome, overlay, interaction = false, zoomGestures = true, token = _embedpdf_plugin_stage.StageToken, className, style }) {
+	const stage = require_runtime.useCapability(token);
+	const ix = require_runtime.useOptionalCapability(_embedpdf_plugin_interaction.InteractionToken);
+	const useHub = interaction && !!ix;
+	const hubCursor = require_runtime.useKernelValue(() => ix?.cursor() ?? "default");
+	const ref = (0, react.useRef)(null);
+	const docId = require_runtime.useDocumentId();
+	const pages = require_runtime.useSelector(token, (c) => c.visiblePages());
+	const frame = require_runtime.useSelector(token, (c) => c.pageFrame(), (a, b) => a.top === b.top && a.right === b.right && a.bottom === b.bottom && a.left === b.left);
+	(0, react.useEffect)(() => {
+		const el = ref.current;
+		const setVp = () => stage.setViewport({
+			width: el.clientWidth,
+			height: el.clientHeight
+		});
+		const ro = new ResizeObserver(setVp);
+		ro.observe(el);
+		setVp();
+		let mq = null;
+		const reportDpr = () => {
+			stage.setDevicePixelRatio(window.devicePixelRatio || 1);
+			mq?.removeEventListener("change", reportDpr);
+			mq = window.matchMedia(`(resolution: ${window.devicePixelRatio}dppx)`);
+			mq.addEventListener("change", reportDpr);
+		};
+		reportDpr();
+		const onWheel = (e) => {
+			e.preventDefault();
+			const r = el.getBoundingClientRect();
+			if (zoomGestures && (e.ctrlKey || e.metaKey)) stage.zoomAround({
+				x: e.clientX - r.left,
+				y: e.clientY - r.top
+			}, (0, _embedpdf_plugin_stage.wheelZoomFactor)(e));
+			else {
+				const dx = e.shiftKey ? e.deltaY : e.deltaX;
+				const dy = e.shiftKey ? e.deltaX : e.deltaY;
+				stage.panBy(-dx, -dy);
+			}
+		};
+		el.addEventListener("wheel", onWheel, { passive: false });
+		let lastScale = 1;
+		const onGestureStart = (e) => {
+			e.preventDefault();
+			lastScale = e.scale ?? 1;
+		};
+		const onGestureChange = (e) => {
+			e.preventDefault();
+			const g = e;
+			const scale = g.scale ?? 1;
+			if (zoomGestures && scale > 0) {
+				const r = el.getBoundingClientRect();
+				stage.zoomAround({
+					x: g.clientX - r.left,
+					y: g.clientY - r.top
+				}, scale / lastScale);
+			}
+			lastScale = scale;
+		};
+		const hasGestureEvents = "GestureEvent" in window;
+		if (hasGestureEvents) {
+			el.addEventListener("gesturestart", onGestureStart);
+			el.addEventListener("gesturechange", onGestureChange);
+			el.addEventListener("gestureend", onGestureStart);
+		}
+		const cleanups = [];
+		if (useHub && ix) {
+			const clicks = require_interaction.createClickCounter();
+			const forward = (phase, e, clickCount = 1) => {
+				const r = el.getBoundingClientRect();
+				const vpt = {
+					x: e.clientX - r.left,
+					y: e.clientY - r.top
+				};
+				ix.dispatch({
+					phase,
+					viewport: vpt,
+					page: stage.pageAt(vpt) ?? void 0,
+					project: (pon) => stage.pointOnPage(pon, vpt),
+					modifiers: {
+						shift: e.shiftKey,
+						alt: e.altKey,
+						ctrl: e.ctrlKey,
+						meta: e.metaKey
+					},
+					clickCount
+				});
+			};
+			let dragging = false;
+			const down = (e) => {
+				if (e.button !== 0) return;
+				dragging = true;
+				forward("down", e, clicks(Date.now(), e.clientX, e.clientY));
+			};
+			const hover = (e) => {
+				if (!dragging) forward("move", e);
+			};
+			const winMove = (e) => {
+				if (dragging) forward("move", e);
+			};
+			const up = (e) => {
+				if (!dragging) return;
+				dragging = false;
+				forward("up", e);
+			};
+			el.addEventListener("pointerdown", down);
+			el.addEventListener("pointermove", hover);
+			window.addEventListener("pointermove", winMove);
+			window.addEventListener("pointerup", up);
+			cleanups.push(() => {
+				el.removeEventListener("pointerdown", down);
+				el.removeEventListener("pointermove", hover);
+				window.removeEventListener("pointermove", winMove);
+				window.removeEventListener("pointerup", up);
+			});
+		} else {
+			let dragging = false;
+			let lx = 0;
+			let ly = 0;
+			const down = (e) => {
+				if (e.button !== 0) return;
+				dragging = true;
+				lx = e.clientX;
+				ly = e.clientY;
+			};
+			const move = (e) => {
+				if (!dragging) return;
+				stage.panBy(e.clientX - lx, e.clientY - ly);
+				lx = e.clientX;
+				ly = e.clientY;
+			};
+			const up = () => {
+				dragging = false;
+			};
+			el.addEventListener("pointerdown", down);
+			window.addEventListener("pointermove", move);
+			window.addEventListener("pointerup", up);
+			cleanups.push(() => {
+				el.removeEventListener("pointerdown", down);
+				window.removeEventListener("pointermove", move);
+				window.removeEventListener("pointerup", up);
+			});
+		}
+		return () => {
+			ro.disconnect();
+			mq?.removeEventListener("change", reportDpr);
+			el.removeEventListener("wheel", onWheel);
+			if (hasGestureEvents) {
+				el.removeEventListener("gesturestart", onGestureStart);
+				el.removeEventListener("gesturechange", onGestureChange);
+				el.removeEventListener("gestureend", onGestureStart);
+			}
+			cleanups.forEach((fn) => fn());
+		};
+	}, [
+		stage,
+		ix,
+		useHub,
+		zoomGestures
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		ref,
+		className,
+		style: {
+			position: "relative",
+			overflow: "hidden",
+			touchAction: "none",
+			...useHub ? { cursor: hubCursor } : null,
+			...style
+		},
+		children: [pages.map((p) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageSurface, {
+			documentId: docId ?? "",
+			page: p,
+			frame,
+			stage,
+			render: children,
+			chrome: pageChrome
+		}, p.pageIndex)), overlay]
+	});
+}
+function useStage(token = _embedpdf_plugin_stage.StageToken) {
+	return require_runtime.useCapability(token);
+}
+function useZoom(token = _embedpdf_plugin_stage.StageToken) {
+	const s = require_runtime.useCapability(token);
+	return {
+		zoom: require_runtime.useSelector(token, (c) => c.zoomLevel()),
+		/** Active zoom intent: 'automatic' | 'fit-page' | 'fit-width' | 'fit-all' | 'custom'. */
+		mode: require_runtime.useSelector(token, (c) => c.zoomMode()),
+		zoomIn: s.zoomIn,
+		zoomOut: s.zoomOut,
+		fitWidth: s.fitWidth,
+		fitPage: s.fitPage,
+		fitAll: s.fitAll,
+		automatic: s.automatic,
+		zoomTo: s.zoomTo
+	};
+}
+function usePages(token = _embedpdf_plugin_stage.StageToken) {
+	const s = require_runtime.useCapability(token);
+	return {
+		currentPage: require_runtime.useSelector(token, (c) => c.currentPage()),
+		pageCount: require_runtime.useSelector(token, (c) => c.pageCount()),
+		goToPage: s.goToPage,
+		next: s.next,
+		prev: s.prev,
+		reveal: s.reveal
+	};
+}
+function useLayout(token = _embedpdf_plugin_stage.StageToken) {
+	const s = require_runtime.useCapability(token);
+	return {
+		flow: require_runtime.useSelector(token, (c) => c.flow()),
+		layout: require_runtime.useSelector(token, (c) => c.layout()),
+		spread: require_runtime.useSelector(token, (c) => c.spread()),
+		sizing: require_runtime.useSelector(token, (c) => c.sizing()),
+		bounded: require_runtime.useSelector(token, (c) => c.bounded()),
+		setFlow: s.setFlow,
+		setLayout: s.setLayout,
+		setSpread: s.setSpread,
+		setSizing: s.setSizing,
+		setBounded: s.setBounded
+	};
+}
+/** The document's page list (with PDF labels) + the current item's pages — the
+*  data for page thumbnails / worksheet-style page tabs. */
+function usePageList(token = _embedpdf_plugin_stage.StageToken) {
+	return {
+		pages: require_runtime.useSelector(token, (c) => c.pages(), (a, b) => a.length === b.length && a.every((p, i) => p.pon === b[i].pon && p.label === b[i].label)),
+		currentItemPages: require_runtime.useSelector(token, (c) => c.currentItemPages(), (a, b) => a.length === b.length && a.every((x, i) => x === b[i]))
+	};
+}
+/**
+* All Stage settings + the batch `update`. This is the seam for "presets are a
+* customer concern": keep your own `Partial<StageSettings>` objects and apply them
+* with `update(preset)` (one anchor-preserving change).
+*/
+function useStageSettings(token = _embedpdf_plugin_stage.StageToken) {
+	const s = require_runtime.useCapability(token);
+	return {
+		settings: require_runtime.useSelector(token, (c) => c.settings(), _embedpdf_plugin_stage.settingsEqual),
+		update: s.update,
+		reset: s.resetView
+	};
+}
+//#endregion
+exports.Stage = Stage;
+exports.useLayout = useLayout;
+exports.usePageList = usePageList;
+exports.usePages = usePages;
+exports.useStage = useStage;
+exports.useStageSettings = useStageSettings;
+exports.useZoom = useZoom;
+Object.keys(_embedpdf_plugin_stage).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _embedpdf_plugin_stage[k];
+		}
+	});
+});
+
+//# sourceMappingURL=stage.cjs.map

package/dist/stage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.cjs","names":["makePageContext","PageProvider","StageToken","useCapability","useOptionalCapability","InteractionToken","useKernelValue","useDocumentId","useSelector","createClickCounter","settingsEqual"],"sources":["../src/stage.tsx"],"sourcesContent":["/**\n * Stage / RenderLayer + facade hooks.\n *\n * <Stage> virtualizes and positions page surfaces by the camera, and hands each\n * one to YOUR render prop — you bring the layers. (The standalone, Stage-free\n * single-page surface lives in `./page-view` so it never pulls the stage plugin.)\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-stage';\nimport * as React from 'react';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { StageToken, settingsEqual, wheelZoomFactor } from '@embedpdf/plugin-stage';\nimport type { StageCapability, VisiblePage } from '@embedpdf/plugin-stage';\nimport type { CapabilityToken } from '@embedpdf/core';\n\n/** Which stage lens to bind to. Defaults to the main StageToken — pass a custom\n *  token to drive an additional lens (e.g. a wrapped thumbnail sidebar). */\nexport type StageTokenProp = CapabilityToken<StageCapability>;\nimport type { PageFrame } from '@embedpdf/core-geometry';\nimport { InteractionToken } from '@embedpdf/plugin-interaction';\nimport type { PointerSample } from '@embedpdf/plugin-interaction';\nimport { createClickCounter } from './interaction';\nimport {\n  makePageContext,\n  PageProvider,\n  useCapability,\n  useDocumentId,\n  useKernelValue,\n  useOptionalCapability,\n  useSelector,\n} from './runtime';\nimport type { PageContextValue } from './runtime';\n\nfunction PageSurface({\n  documentId,\n  page,\n  frame,\n  stage,\n  render,\n  chrome,\n}: {\n  documentId: string;\n  page: VisiblePage;\n  /** Reserved chrome bands around the page (screen px); the layout reserved the\n   *  matching space, so the outer box tiles into it. */\n  frame: PageFrame;\n  /** The stage capability — the demand getter reads visibility LIVE off it. */\n  stage: StageCapability;\n  render: (page: PageContextValue) => React.ReactNode;\n  chrome?: (page: PageContextValue) => React.ReactNode;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const t = page.transform;\n  const rotation = page.rotation;\n  // All geometry comes from the transform: the DISPLAY footprint (viewWidth/Height,\n  // already w↔h-swapped + device-snapped) and the UN-rotated content box\n  // (contentWidth/Height). The shell never re-derives `* zoom` / `* dpr` / snapping.\n  const outerW = t.viewWidth + frame.left + frame.right;\n  const outerH = t.viewHeight + frame.top + frame.bottom;\n  // page.screenX/screenY are the device-snapped footprint top-left; the outer box\n  // sits one frame further out so the content keeps its scene position.\n  const left = page.screenX - frame.left;\n  const top = page.screenY - frame.top;\n  // Center the (possibly rotated) content box on the display box and rotate about\n  // its center — NO translate(), so rotation 0 carries no transform and pixel-snaps\n  // like the axis-aligned shadow behind it (no hairline seam).\n  const contentLeft = frame.left + (t.viewWidth - t.contentWidth) / 2;\n  const contentTop = frame.top + (t.viewHeight - t.contentHeight) / 2;\n  // The page-view DEMAND is a PULL: the getter closes over\n  // stable references (capability + pon) and reads the stage's live state at\n  // call time — visibility is the STAGE's data (`VisiblePage.visibleRect`),\n  // not something an adapter re-derives or caches. Absent from the visible\n  // set = zero rect (\"want nothing\"), distinct from PageView's undefined\n  // getter (\"whole page\").\n  const ctx = useMemo(\n    () =>\n      makePageContext(\n        documentId,\n        page.pon,\n        page.pageIndex,\n        frame,\n        t,\n        () => ref.current!.getBoundingClientRect(),\n        () => {\n          const live = stage.visiblePages().find((p) => p.pon === page.pon);\n          return live\n            ? { desiredDeviceWidth: live.transform.deviceWidth, visibleRect: live.visibleRect }\n            : {\n                desiredDeviceWidth: t.deviceWidth,\n                visibleRect: { x: 0, y: 0, width: 0, height: 0 },\n              };\n        },\n      ),\n    [documentId, page.pon, page.pageIndex, frame, t, stage],\n  );\n  return (\n    <div style={{ position: 'absolute', left, top, width: outerW, height: outerH }}>\n      <PageProvider value={ctx}>\n        {/* drop shadow ONLY — axis-aligned at the content box (inset by the frame),\n            transparent fill so it can never peek out behind the bitmap, and it\n            stays put under rotation. */}\n        <div\n          style={{\n            position: 'absolute',\n            left: frame.left,\n            top: frame.top,\n            width: t.viewWidth,\n            height: t.viewHeight,\n            boxShadow: '0 6px 18px rgba(0,0,0,.18)',\n          }}\n        />\n        {/* the page: white backing + bitmap as ONE rasterized box, so there is no\n            seam between them and nothing white larger than the bitmap to leak.\n            The ONLY thing rotation turns; markers/annotations ride it in content\n            coordinates. Rotation 0 carries no transform → pixel-snaps cleanly. */}\n        <div\n          ref={ref}\n          style={{\n            position: 'absolute',\n            left: contentLeft,\n            top: contentTop,\n            width: t.contentWidth,\n            height: t.contentHeight,\n            background: '#fff',\n            transform: rotation ? `rotate(${rotation}deg)` : undefined,\n            // We render our own selection highlights — suppress native text/image\n            // selection (and the double-click image grab) on the whole page subtree.\n            userSelect: 'none',\n            WebkitUserSelect: 'none',\n          }}\n        >\n          {render(ctx)}\n        </div>\n        {/* box-space chrome — labels, selection border, per-page buttons — fills\n            the outer box, NEVER rotates. Bands are plain regions: a label is\n            `bottom:0; height: frame.bottom`, a button row `top:0; height: frame.top`. */}\n        {chrome?.(ctx)}\n      </PageProvider>\n    </div>\n  );\n}\n\nexport interface StageProps {\n  /**\n   * PAGE-SPACE content for each visible page (RenderLayer, annotations,\n   * markers). Rendered inside the page's content frame, so it ROTATES with the\n   * page's display rotation — coordinates are plain PDF points.\n   */\n  children: (page: PageContextValue) => React.ReactNode;\n  /**\n   * BOX-SPACE chrome for each visible page (page-number label, selection\n   * border, a per-page rotate/delete button). Rendered into the OUTER box\n   * (content + reserved `pageFrame`), so it does NOT rotate and the reserved\n   * bands are plain regions (`bottom:0; height: page.frame.bottom`). The three\n   * coordinate spaces: `children` (page content), `pageChrome` (page box +\n   * frame), `overlay` (viewport).\n   */\n  pageChrome?: (page: PageContextValue) => React.ReactNode;\n  /** Viewport-space UI (menus, controls) rendered above the pages. */\n  overlay?: React.ReactNode;\n  /**\n   * Route this Stage's pointer events to the interaction hub (page-resolved via\n   * `pageAt`) instead of the built-in drag-to-pan. Pan then becomes the `pan`\n   * tool's job and dragging in `pointer` mode selects text (incl. across pages).\n   * Pair with `stagePlugin({ interaction: true })`. Default false (built-in pan).\n   */\n  interaction?: boolean;\n  /**\n   * Ambient ZOOM gestures on this stage: ctrl/cmd+wheel and trackpad pinch\n   * (Safari gesture events included). Default true. Turn OFF for follower\n   * lenses with a fixed magnification — a thumbnail rail should scroll under\n   * cmd+wheel, not zoom — so a zoom-wheel falls through to ordinary wheel\n   * pan, and pinches are still swallowed (they never page-zoom the browser).\n   */\n  zoomGestures?: boolean;\n  /** The stage lens to drive (default: the main StageToken). */\n  token?: StageTokenProp;\n  className?: string;\n  style?: React.CSSProperties;\n}\n\nexport function Stage({\n  children,\n  pageChrome,\n  overlay,\n  interaction = false,\n  zoomGestures = true,\n  token = StageToken,\n  className,\n  style,\n}: StageProps) {\n  const stage = useCapability(token);\n  const ix = useOptionalCapability(InteractionToken);\n  const useHub = interaction && !!ix;\n  // The hub's resolved cursor (text/grab/…), applied to the viewport when driving.\n  const hubCursor = useKernelValue(() => ix?.cursor() ?? 'default');\n  const ref = useRef<HTMLDivElement>(null);\n  const docId = useDocumentId();\n  // visiblePages already folds in the camera (each page carries its device-snapped\n  // screenX/screenY + transform), so panning re-emits the list — no separate\n  // camera subscription needed for positioning.\n  const pages = useSelector(token, (c) => c.visiblePages()); // memoized -> stable ref\n  // Reserved chrome bands (screen px), uniform across pages — the frame the\n  // outer box reserves and `pageChrome` paints into.\n  const frame = useSelector(\n    token,\n    (c) => c.pageFrame(),\n    (a, b) => a.top === b.top && a.right === b.right && a.bottom === b.bottom && a.left === b.left,\n  );\n\n  useEffect(() => {\n    const el = ref.current!;\n    // Only report the viewport size. Initial placement (home) is the Stage plugin's\n    // job — it watches the viewport and homes once it's ready (and a higher-priority\n    // initial-view provider can override that). The shell stays dumb.\n    const setVp = () => stage.setViewport({ width: el.clientWidth, height: el.clientHeight });\n    const ro = new ResizeObserver(setVp);\n    ro.observe(el);\n    setVp();\n\n    // Report the device pixel ratio so page transforms render crisp. dppx changes\n    // (zoom, dragging between monitors) fire the media query; re-subscribe each\n    // time since the query value itself moves.\n    let mq: MediaQueryList | null = null;\n    const reportDpr = () => {\n      stage.setDevicePixelRatio(window.devicePixelRatio || 1);\n      mq?.removeEventListener('change', reportDpr);\n      mq = window.matchMedia(`(resolution: ${window.devicePixelRatio}dppx)`);\n      mq.addEventListener('change', reportDpr);\n    };\n    reportDpr();\n\n    // Wheel is ambient navigation in BOTH modes: ctrl/meta zooms (classified\n    // per input — synthesized pinch, mouse notch, cmd-scroll scrub — by\n    // wheelZoomFactor), else scrolls. With zoom gestures off, a zoom-wheel\n    // falls through to ordinary pan (a cmd+scroll over a thumbnail rail\n    // scrolls the rail).\n    const onWheel = (e: WheelEvent) => {\n      e.preventDefault();\n      const r = el.getBoundingClientRect();\n      if (zoomGestures && (e.ctrlKey || e.metaKey)) {\n        stage.zoomAround({ x: e.clientX - r.left, y: e.clientY - r.top }, wheelZoomFactor(e));\n      } else {\n        const dx = e.shiftKey ? e.deltaY : e.deltaX;\n        const dy = e.shiftKey ? e.deltaX : e.deltaY;\n        stage.panBy(-dx, -dy);\n      }\n    };\n    el.addEventListener('wheel', onWheel, { passive: false });\n\n    // Safari never synthesizes ctrl+wheel for trackpad pinch — it fires\n    // proprietary gesture events carrying an ABSOLUTE scale; convert to the\n    // per-event ratio the camera physics wants. Feature-detected: Chrome and\n    // Firefox don't have GestureEvent, so this wiring costs them nothing.\n    // preventDefault runs even with zoom gestures off — a pinch over the\n    // stage must never zoom the page itself.\n    let lastScale = 1;\n    const onGestureStart = (e: Event) => {\n      e.preventDefault();\n      lastScale = (e as unknown as { scale?: number }).scale ?? 1;\n    };\n    const onGestureChange = (e: Event) => {\n      e.preventDefault();\n      const g = e as unknown as { scale?: number; clientX: number; clientY: number };\n      const scale = g.scale ?? 1;\n      if (zoomGestures && scale > 0) {\n        const r = el.getBoundingClientRect();\n        stage.zoomAround({ x: g.clientX - r.left, y: g.clientY - r.top }, scale / lastScale);\n      }\n      lastScale = scale;\n    };\n    const hasGestureEvents = 'GestureEvent' in window;\n    if (hasGestureEvents) {\n      el.addEventListener('gesturestart', onGestureStart);\n      el.addEventListener('gesturechange', onGestureChange);\n      el.addEventListener('gestureend', onGestureStart); // reset the base\n    }\n\n    const cleanups: Array<() => void> = [];\n    if (useHub && ix) {\n      // Forward to the hub: pan/select/etc. become tool-gated handlers. `pageAt`\n      // resolves the page per event, so a drag can cross pages (text selection).\n      const clicks = createClickCounter();\n      const forward = (phase: PointerSample['phase'], e: PointerEvent, clickCount = 1) => {\n        const r = el.getBoundingClientRect();\n        const vpt = { x: e.clientX - r.left, y: e.clientY - r.top };\n        ix.dispatch({\n          phase,\n          viewport: vpt,\n          page: stage.pageAt(vpt) ?? undefined,\n          // Page-anchored gestures (annotation move/resize) track the origin\n          // page's frame through this even when the cursor is off that page.\n          project: (pon) => stage.pointOnPage(pon, vpt),\n          modifiers: { shift: e.shiftKey, alt: e.altKey, ctrl: e.ctrlKey, meta: e.metaKey },\n          clickCount,\n        });\n      };\n      let dragging = false;\n      const down = (e: PointerEvent) => {\n        if (e.button !== 0) return;\n        dragging = true;\n        forward('down', e, clicks(Date.now(), e.clientX, e.clientY));\n      };\n      const hover = (e: PointerEvent) => {\n        if (!dragging) forward('move', e); // cursor feedback, no gesture\n      };\n      const winMove = (e: PointerEvent) => {\n        if (dragging) forward('move', e);\n      };\n      const up = (e: PointerEvent) => {\n        if (!dragging) return;\n        dragging = false;\n        forward('up', e);\n      };\n      el.addEventListener('pointerdown', down);\n      el.addEventListener('pointermove', hover);\n      window.addEventListener('pointermove', winMove);\n      window.addEventListener('pointerup', up);\n      cleanups.push(() => {\n        el.removeEventListener('pointerdown', down);\n        el.removeEventListener('pointermove', hover);\n        window.removeEventListener('pointermove', winMove);\n        window.removeEventListener('pointerup', up);\n      });\n    } else {\n      // Built-in drag-to-pan (no interaction hub) — unchanged behaviour.\n      let dragging = false;\n      let lx = 0;\n      let ly = 0;\n      const down = (e: PointerEvent) => {\n        if (e.button !== 0) return;\n        dragging = true;\n        lx = e.clientX;\n        ly = e.clientY;\n      };\n      const move = (e: PointerEvent) => {\n        if (!dragging) return;\n        stage.panBy(e.clientX - lx, e.clientY - ly);\n        lx = e.clientX;\n        ly = e.clientY;\n      };\n      const up = () => {\n        dragging = false;\n      };\n      el.addEventListener('pointerdown', down);\n      window.addEventListener('pointermove', move);\n      window.addEventListener('pointerup', up);\n      cleanups.push(() => {\n        el.removeEventListener('pointerdown', down);\n        window.removeEventListener('pointermove', move);\n        window.removeEventListener('pointerup', up);\n      });\n    }\n\n    return () => {\n      ro.disconnect();\n      mq?.removeEventListener('change', reportDpr);\n      el.removeEventListener('wheel', onWheel);\n      if (hasGestureEvents) {\n        el.removeEventListener('gesturestart', onGestureStart);\n        el.removeEventListener('gesturechange', onGestureChange);\n        el.removeEventListener('gestureend', onGestureStart);\n      }\n      cleanups.forEach((fn) => fn());\n    };\n  }, [stage, ix, useHub, zoomGestures]);\n\n  return (\n    <div\n      ref={ref}\n      className={className}\n      style={{\n        position: 'relative',\n        overflow: 'hidden',\n        touchAction: 'none',\n        ...(useHub ? { cursor: hubCursor } : null),\n        ...style,\n      }}\n    >\n      {pages.map((p) => (\n        <PageSurface\n          key={p.pageIndex}\n          documentId={docId ?? ''}\n          page={p}\n          frame={frame}\n          stage={stage}\n          render={children}\n          chrome={pageChrome}\n        />\n      ))}\n      {overlay}\n    </div>\n  );\n}\n\n// ── Facade hooks — thin sugar over the capability + generic binding ───────────\nexport function useStage(token: StageTokenProp = StageToken) {\n  return useCapability(token);\n}\nexport function useZoom(token: StageTokenProp = StageToken) {\n  const s = useCapability(token);\n  const zoom = useSelector(token, (c) => c.zoomLevel());\n  const mode = useSelector(token, (c) => c.zoomMode());\n  return {\n    zoom,\n    /** Active zoom intent: 'automatic' | 'fit-page' | 'fit-width' | 'fit-all' | 'custom'. */\n    mode,\n    zoomIn: s.zoomIn,\n    zoomOut: s.zoomOut,\n    fitWidth: s.fitWidth,\n    fitPage: s.fitPage,\n    fitAll: s.fitAll,\n    automatic: s.automatic,\n    zoomTo: s.zoomTo,\n  };\n}\nexport function usePages(token: StageTokenProp = StageToken) {\n  const s = useCapability(token);\n  const currentPage = useSelector(token, (c) => c.currentPage());\n  const pageCount = useSelector(token, (c) => c.pageCount());\n  return {\n    currentPage,\n    pageCount,\n    goToPage: s.goToPage,\n    next: s.next,\n    prev: s.prev,\n    reveal: s.reveal,\n  };\n}\nexport function useLayout(token: StageTokenProp = StageToken) {\n  const s = useCapability(token);\n  const flow = useSelector(token, (c) => c.flow());\n  const layout = useSelector(token, (c) => c.layout());\n  const spread = useSelector(token, (c) => c.spread());\n  const sizing = useSelector(token, (c) => c.sizing());\n  const bounded = useSelector(token, (c) => c.bounded());\n  return {\n    flow,\n    layout,\n    spread,\n    sizing,\n    bounded,\n    setFlow: s.setFlow,\n    setLayout: s.setLayout,\n    setSpread: s.setSpread,\n    setSizing: s.setSizing,\n    setBounded: s.setBounded,\n  };\n}\n\n/** The document's page list (with PDF labels) + the current item's pages — the\n *  data for page thumbnails / worksheet-style page tabs. */\nexport function usePageList(token: StageTokenProp = StageToken) {\n  const pages = useSelector(\n    token,\n    (c) => c.pages(),\n    (a, b) =>\n      a.length === b.length && a.every((p, i) => p.pon === b[i].pon && p.label === b[i].label),\n  );\n  const current = useSelector(\n    token,\n    (c) => c.currentItemPages(),\n    (a, b) => a.length === b.length && a.every((x, i) => x === b[i]),\n  );\n  return { pages, currentItemPages: current };\n}\n\n/**\n * All Stage settings + the batch `update`. This is the seam for \"presets are a\n * customer concern\": keep your own `Partial<StageSettings>` objects and apply them\n * with `update(preset)` (one anchor-preserving change).\n */\nexport function useStageSettings(token: StageTokenProp = StageToken) {\n  const s = useCapability(token);\n  // settingsEqual derives from the plugin's settings registry — a new setting is\n  // covered here automatically, without this package spelling out the shape.\n  const settings = useSelector(token, (c) => c.settings(), settingsEqual);\n  return { settings, update: s.update, reset: s.resetView };\n}\n"],"mappings":"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"}