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

package/dist/stage.cjs

@@ -1,237 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
-const require_anchored = require("./anchored.cjs");
-let react_jsx_runtime = require("react/jsx-runtime");
-let react = require("react");
-react = require_rolldown_runtime.__toESM(react, 1);
-let _embedpdf_web = require("@embedpdf/web");
-let _embedpdf_plugin_stage = require("@embedpdf/plugin-stage");
-let _embedpdf_plugin_interaction_contract = require("@embedpdf/plugin-interaction/contract");
-//#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, stage.lensId(), 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: "var(--epdf-page-shadow, 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 = true, panFallback = true, zoomGestures = true, token = _embedpdf_plugin_stage.StageToken, className, style }) {
-	const stage = require_runtime.useCapability(token);
-	const ix = require_runtime.useOptionalCapability(_embedpdf_plugin_interaction_contract.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);
-	const projector = (0, react.useMemo)(() => ({
-		space: "overlay",
-		toScreen: (pon, rect) => stage.pageRectToScreen(pon, rect),
-		toScreenPoint: (pon, at) => {
-			const r = stage.pageRectToScreen(pon, {
-				x: at.x,
-				y: at.y,
-				width: 0,
-				height: 0
-			});
-			return r ? {
-				x: r.x,
-				y: r.y
-			} : null;
-		},
-		viewEnv: (pon) => {
-			const t = stage.pageRect(pon)?.transform;
-			return t ? {
-				scale: t.viewScale,
-				rotation: t.rotation,
-				zoom: t.zoom
-			} : null;
-		}
-	}), [stage]);
-	const projectorBinding = (0, react.useMemo)(() => ({
-		projector,
-		revision: pages
-	}), [projector, pages]);
-	(0, react.useLayoutEffect)(() => {
-		const el = ref.current;
-		const detachSurface = (0, _embedpdf_web.createStageSurface)(el, stage, {
-			hub: useHub ? ix : null,
-			source: stage.lensId(),
-			zoomGestures
-		});
-		const offScroll = useHub && ix ? ix.registerHandler((0, _embedpdf_plugin_stage.createScrollHandler)(stage, ix, { panFallback }), { source: stage.lensId() }) : null;
-		return () => {
-			offScroll?.();
-			detachSurface();
-		};
-	}, [
-		stage,
-		ix,
-		useHub,
-		zoomGestures,
-		panFallback
-	]);
-	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.pon)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_anchored.ProjectorProvider, {
-			value: projectorBinding,
-			children: 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;
+const require_stage_scope = require("./stage-scope-CQgCuf1w.cjs");
+const require_stage = require("./stage-BIG6aeVd.cjs");
+exports.Scrollbar = require_stage.Scrollbar;
+exports.Stage = require_stage.Stage;
+exports.StageScope = require_stage_scope.StageScope;
+exports.useScrollMetrics = require_stage.useScrollMetrics;
+exports.useStage = require_stage.useStage;
+exports.useStageEvent = require_stage.useStageEvent;
+exports.useStageSettings = require_stage.useStageSettings;
+exports.useStageState = require_stage.useStageState;
+exports.useStageToken = require_stage_scope.useStageToken;
+var _embedpdf_plugin_stage = require("@embedpdf/plugin-stage");
 Object.keys(_embedpdf_plugin_stage).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
@@ -240,5 +19,3 @@ Object.keys(_embedpdf_plugin_stage).forEach(function(k) {
 		}
 	});
 });
-
-//# sourceMappingURL=stage.cjs.map

package/dist/stage.d.cts

@@ -1,117 +1,3 @@
-import { o as PageContextValue } from "./runtime-umHA_xHt.cjs";
-import * as React from "react";
-import { CapabilityToken } from "@embedpdf/core";
-import { StageCapability } from "@embedpdf/plugin-stage";
+import { a as useStageSettings, c as ScrollbarAxis, d as StageScope, f as StageScopeProps, i as useStageEvent, l as ScrollbarProps, m as useStageToken, n as StageProps, o as useStageState, p as StageTokenProp, r as useStage, s as Scrollbar, t as Stage, u as useScrollMetrics } from "./stage-ByFPD-Fv.cjs";
 export * from "@embedpdf/plugin-stage";
-//#region src/stage.d.ts
-/** Which stage lens to bind to. Defaults to the main StageToken — pass a custom
- *  token to drive an additional lens (e.g. a wrapped thumbnail sidebar). */
-type StageTokenProp = CapabilityToken<StageCapability>;
-interface StageProps {
-  /**
-   * PAGE-SPACE content for each visible page (RenderLayer, annotations,
-   * markers). Rendered inside the page's content frame, so it ROTATES with the
-   * page's display rotation — coordinates are plain PDF points.
-   */
-  children: (page: PageContextValue) => React.ReactNode;
-  /**
-   * BOX-SPACE chrome for each visible page (page-number label, selection
-   * border, a per-page rotate/delete button). Rendered into the OUTER box
-   * (content + reserved `pageFrame`), so it does NOT rotate and the reserved
-   * bands are plain regions (`bottom:0; height: page.frame.bottom`). The three
-   * coordinate spaces: `children` (page content), `pageChrome` (page box +
-   * frame), `overlay` (viewport).
-   */
-  pageChrome?: (page: PageContextValue) => React.ReactNode;
-  /** Viewport-space UI (menus, controls) rendered above the pages. */
-  overlay?: React.ReactNode;
-  /**
-   * Route this Stage's pointer events to the interaction hub (page-resolved via
-   * `pageAt`) — AND register this lens's tool-gated pan-scroll handler with it
-   * (lens-scoped, so multiple stages on one document never pan each other).
-   * Pan is then the `pan` tool's job and dragging in `pointer` mode selects
-   * text (incl. across pages).
-   *
-   * Default TRUE: registering `interactionPlugin()` is the one opt-in — tools
-   * just work; without the hub this is inert and the stage falls back to
-   * built-in drag-to-pan, so a hub-less setup costs nothing. Set `false` on
-   * SECONDARY lenses (a thumbnail rail) that should stay click-to-navigate
-   * instead of feeding the document's tools.
-   */
-  interaction?: boolean;
-  /**
-   * With {@link interaction}: let drags over page GAPS pan regardless of the
-   * active tool (and show a grab cursor there) — the gutter always pans; there
-   * is nothing to draw/select outside a page. Default true.
-   */
-  panFallback?: boolean;
-  /**
-   * Ambient ZOOM gestures on this stage: ctrl/cmd+wheel and trackpad pinch
-   * (Safari gesture events included). Default true. Turn OFF for follower
-   * lenses with a fixed magnification — a thumbnail rail should scroll under
-   * cmd+wheel, not zoom — so a zoom-wheel falls through to ordinary wheel
-   * pan, and pinches are still swallowed (they never page-zoom the browser).
-   */
-  zoomGestures?: boolean;
-  /** The stage lens to drive (default: the main StageToken). */
-  token?: StageTokenProp;
-  className?: string;
-  style?: React.CSSProperties;
-}
-declare function Stage({ children, pageChrome, overlay, interaction, panFallback, zoomGestures, token, className, style }: StageProps): import("react/jsx-runtime").JSX.Element;
-declare function useStage(token?: StageTokenProp): StageCapability;
-declare function useZoom(token?: StageTokenProp): {
-  zoom: number;
-  /** Active zoom intent: 'automatic' | 'fit-page' | 'fit-width' | 'fit-all' | 'custom'. */
-  mode: import("@embedpdf/core-stage").ZoomModeValue | "custom";
-  zoomIn: () => void;
-  zoomOut: () => void;
-  fitWidth: () => void;
-  fitPage: () => void;
-  fitAll: () => void;
-  automatic: () => void;
-  zoomTo: (spec: import("@embedpdf/core-stage").ZoomSpec) => void;
-};
-declare function usePages(token?: StageTokenProp): {
-  currentPage: number;
-  pageCount: number;
-  goToPage: (pageIndex: number, opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  next: (opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  prev: (opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  reveal: (pageIndex: number, opts?: import("@embedpdf/plugin-stage").RevealOptions) => void;
-};
-declare function useLayout(token?: StageTokenProp): {
-  flow: import("@embedpdf/plugin-stage").FlowMode;
-  layout: import("@embedpdf/plugin-stage").LayoutKind;
-  spread: import("@embedpdf/core-stage").SpreadMode;
-  sizing: import("@embedpdf/core-stage").SizingMode;
-  bounded: boolean;
-  setFlow: (flow: import("@embedpdf/plugin-stage").FlowMode) => void;
-  setLayout: (layout: import("@embedpdf/plugin-stage").LayoutKind) => void;
-  setSpread: (spread: import("@embedpdf/core-stage").SpreadMode) => void;
-  setSizing: (sizing: import("@embedpdf/core-stage").SizingMode) => void;
-  setBounded: (bounded: boolean) => void;
-};
-/** The document's page list (with PDF labels) + the current item's pages — the
- *  data for page thumbnails / worksheet-style page tabs. */
-declare function usePageList(token?: StageTokenProp): {
-  pages: {
-    index: number;
-    pon: import("@embedpdf/core").PageObjectNumber;
-    label: string | null;
-  }[];
-  currentItemPages: number[];
-};
-/**
- * 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).
- */
-declare function useStageSettings(token?: StageTokenProp): {
-  settings: import("@embedpdf/plugin-stage").StageSettings;
-  update: (patch: Partial<import("@embedpdf/plugin-stage").StageSettings>) => void;
-  reset: () => void;
-};
-//#endregion
-export { Stage, StageProps, StageTokenProp, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom };
-//# sourceMappingURL=stage.d.cts.map
+export { Scrollbar, type ScrollbarAxis, type ScrollbarProps, Stage, StageProps, StageScope, type StageScopeProps, type StageTokenProp, useScrollMetrics, useStage, useStageEvent, useStageSettings, useStageState, useStageToken };

package/dist/stage.d.ts

@@ -1,117 +1,3 @@
-import { o as PageContextValue } from "./runtime-DE76hlnl.js";
-import { CapabilityToken } from "@embedpdf/core";
-import * as React from "react";
-import { StageCapability } from "@embedpdf/plugin-stage";
+import { a as useStageSettings, c as ScrollbarAxis, d as StageScope, f as StageScopeProps, i as useStageEvent, l as ScrollbarProps, m as useStageToken, n as StageProps, o as useStageState, p as StageTokenProp, r as useStage, s as Scrollbar, t as Stage, u as useScrollMetrics } from "./stage-DaboaheR.js";
 export * from "@embedpdf/plugin-stage";
-//#region src/stage.d.ts
-/** Which stage lens to bind to. Defaults to the main StageToken — pass a custom
- *  token to drive an additional lens (e.g. a wrapped thumbnail sidebar). */
-type StageTokenProp = CapabilityToken<StageCapability>;
-interface StageProps {
-  /**
-   * PAGE-SPACE content for each visible page (RenderLayer, annotations,
-   * markers). Rendered inside the page's content frame, so it ROTATES with the
-   * page's display rotation — coordinates are plain PDF points.
-   */
-  children: (page: PageContextValue) => React.ReactNode;
-  /**
-   * BOX-SPACE chrome for each visible page (page-number label, selection
-   * border, a per-page rotate/delete button). Rendered into the OUTER box
-   * (content + reserved `pageFrame`), so it does NOT rotate and the reserved
-   * bands are plain regions (`bottom:0; height: page.frame.bottom`). The three
-   * coordinate spaces: `children` (page content), `pageChrome` (page box +
-   * frame), `overlay` (viewport).
-   */
-  pageChrome?: (page: PageContextValue) => React.ReactNode;
-  /** Viewport-space UI (menus, controls) rendered above the pages. */
-  overlay?: React.ReactNode;
-  /**
-   * Route this Stage's pointer events to the interaction hub (page-resolved via
-   * `pageAt`) — AND register this lens's tool-gated pan-scroll handler with it
-   * (lens-scoped, so multiple stages on one document never pan each other).
-   * Pan is then the `pan` tool's job and dragging in `pointer` mode selects
-   * text (incl. across pages).
-   *
-   * Default TRUE: registering `interactionPlugin()` is the one opt-in — tools
-   * just work; without the hub this is inert and the stage falls back to
-   * built-in drag-to-pan, so a hub-less setup costs nothing. Set `false` on
-   * SECONDARY lenses (a thumbnail rail) that should stay click-to-navigate
-   * instead of feeding the document's tools.
-   */
-  interaction?: boolean;
-  /**
-   * With {@link interaction}: let drags over page GAPS pan regardless of the
-   * active tool (and show a grab cursor there) — the gutter always pans; there
-   * is nothing to draw/select outside a page. Default true.
-   */
-  panFallback?: boolean;
-  /**
-   * Ambient ZOOM gestures on this stage: ctrl/cmd+wheel and trackpad pinch
-   * (Safari gesture events included). Default true. Turn OFF for follower
-   * lenses with a fixed magnification — a thumbnail rail should scroll under
-   * cmd+wheel, not zoom — so a zoom-wheel falls through to ordinary wheel
-   * pan, and pinches are still swallowed (they never page-zoom the browser).
-   */
-  zoomGestures?: boolean;
-  /** The stage lens to drive (default: the main StageToken). */
-  token?: StageTokenProp;
-  className?: string;
-  style?: React.CSSProperties;
-}
-declare function Stage({ children, pageChrome, overlay, interaction, panFallback, zoomGestures, token, className, style }: StageProps): import("react/jsx-runtime").JSX.Element;
-declare function useStage(token?: StageTokenProp): StageCapability;
-declare function useZoom(token?: StageTokenProp): {
-  zoom: number;
-  /** Active zoom intent: 'automatic' | 'fit-page' | 'fit-width' | 'fit-all' | 'custom'. */
-  mode: import("@embedpdf/core-stage").ZoomModeValue | "custom";
-  zoomIn: () => void;
-  zoomOut: () => void;
-  fitWidth: () => void;
-  fitPage: () => void;
-  fitAll: () => void;
-  automatic: () => void;
-  zoomTo: (spec: import("@embedpdf/core-stage").ZoomSpec) => void;
-};
-declare function usePages(token?: StageTokenProp): {
-  currentPage: number;
-  pageCount: number;
-  goToPage: (pageIndex: number, opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  next: (opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  prev: (opts?: import("@embedpdf/plugin-stage").GoToOptions) => void;
-  reveal: (pageIndex: number, opts?: import("@embedpdf/plugin-stage").RevealOptions) => void;
-};
-declare function useLayout(token?: StageTokenProp): {
-  flow: import("@embedpdf/plugin-stage").FlowMode;
-  layout: import("@embedpdf/plugin-stage").LayoutKind;
-  spread: import("@embedpdf/core-stage").SpreadMode;
-  sizing: import("@embedpdf/core-stage").SizingMode;
-  bounded: boolean;
-  setFlow: (flow: import("@embedpdf/plugin-stage").FlowMode) => void;
-  setLayout: (layout: import("@embedpdf/plugin-stage").LayoutKind) => void;
-  setSpread: (spread: import("@embedpdf/core-stage").SpreadMode) => void;
-  setSizing: (sizing: import("@embedpdf/core-stage").SizingMode) => void;
-  setBounded: (bounded: boolean) => void;
-};
-/** The document's page list (with PDF labels) + the current item's pages — the
- *  data for page thumbnails / worksheet-style page tabs. */
-declare function usePageList(token?: StageTokenProp): {
-  pages: {
-    index: number;
-    pon: import("@embedpdf/core").PageObjectNumber;
-    label: string | null;
-  }[];
-  currentItemPages: number[];
-};
-/**
- * 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).
- */
-declare function useStageSettings(token?: StageTokenProp): {
-  settings: import("@embedpdf/plugin-stage").StageSettings;
-  update: (patch: Partial<import("@embedpdf/plugin-stage").StageSettings>) => void;
-  reset: () => void;
-};
-//#endregion
-export { Stage, StageProps, StageTokenProp, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom };
-//# sourceMappingURL=stage.d.ts.map
+export { Scrollbar, type ScrollbarAxis, type ScrollbarProps, Stage, StageProps, StageScope, type StageScopeProps, type StageTokenProp, useScrollMetrics, useStage, useStageEvent, useStageSettings, useStageState, useStageToken };