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

package/dist/runtime.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.cjs","names":["docInfoListEquals"],"sources":["../src/runtime.tsx"],"sourcesContent":["/**\n * @embedpdf/react — the generic binding.\n *\n * Binds the kernel's one change stream to React (useSyncExternalStore), resolves\n * capabilities (document-scoped ones against the active or `<DocumentScope>`-given\n * document), and provides the page coordinate context. Every plugin and layer rides\n * on this — there is no per-plugin framework code.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/core';\nimport * as React from 'react';\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { createKernel, docInfoListEquals } from '@embedpdf/core';\nimport type {\n  AnyPlugin,\n  CapabilityToken,\n  Engine,\n  EngineFactory,\n  EventHook,\n  InitialDocument,\n  Kernel,\n} from '@embedpdf/core';\n// Pure coordinate math from the geometry base — NOT from stage-core. The\n// PageContext seam stays stage-agnostic (it must also serve standalone PageView).\nimport type { PageFrame, PageTransform, Point, Rect } from '@embedpdf/core-geometry';\nimport type { PageViewDemand } from '@embedpdf/plugin-render/contract';\n\nconst KernelCtx = createContext<Kernel | null>(null);\n/** The document a subtree is bound to. null => use the active document. */\nconst DocumentScopeCtx = createContext<string | null>(null);\n\nexport function useKernel(): Kernel {\n  const k = useContext(KernelCtx);\n  if (!k) throw new Error('useKernel must be used within <Viewer>/<EmbedPDF>');\n  return k;\n}\n\nexport const shallowArray = <T,>(a: readonly T[], b: readonly T[]): boolean =>\n  a === b || (a.length === b.length && a.every((x, i) => x === b[i]));\n\n/** Read a value derived from the kernel, cached by equality (no tearing loop). */\nexport function useKernelValue<R>(\n  select: (k: Kernel) => R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    const next = select(kernel);\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\nexport function useActiveDocumentId(): string | null {\n  return useKernelValue((k) => k.documents.activeId());\n}\n\n/** The document id for this subtree: the nearest <DocumentScope>, else the active doc. */\nexport function useDocumentId(): string | null {\n  const scoped = useContext(DocumentScopeCtx);\n  const active = useActiveDocumentId();\n  return scoped ?? active;\n}\n\nexport interface DocumentScopeProps {\n  id: string;\n  children: React.ReactNode;\n}\n/** Bind a subtree to a specific document (panes, comparison). */\nexport function DocumentScope({ id, children }: DocumentScopeProps) {\n  return <DocumentScopeCtx.Provider value={id}>{children}</DocumentScopeCtx.Provider>;\n}\n\nexport interface DocumentGateProps {\n  /** Shown while this subtree has NO document (empty workspace, docs still opening). */\n  fallback?: React.ReactNode;\n  children: React.ReactNode;\n}\n/**\n * Render children only while this subtree has a READY document — the\n * structural way to say \"this UI is defined over a document\". An empty\n * workspace is a legitimate, designable state (the Viewer no longer blocks on\n * documents so chrome can render at t≈0): workspace-scoped UI (toolbars,\n * commands, i18n) lives OUTSIDE the gate; document-scoped UI (Stage, panels,\n * page chrome) lives inside it, or reads through `useOptionalSelector`.\n * A `loading`/`locked`/`error` tab renders `fallback` — so the gate's\n * fallback doubles as the per-tab boot state; richer chrome (a password\n * prompt, an error pane) branches on `useDocumentStatus()` beside the gate.\n * Sibling of <DocumentScope>, which picks WHICH document; this one handles\n * WHETHER.\n */\nexport function DocumentGate({ fallback = null, children }: DocumentGateProps) {\n  const docId = useDocumentId();\n  const ready = useKernelValue((k) => (docId ? k.documents.get(docId)?.status === 'ready' : false));\n  return <>{ready ? children : fallback}</>;\n}\n\n/** Lifecycle status of this subtree's document (loading/locked/ready/error),\n *  or null with no document. The password prompt and error panes key off it. */\nexport function useDocumentStatus() {\n  const docId = useDocumentId();\n  return useKernelValue((k) => (docId ? (k.documents.get(docId)?.status ?? null) : null));\n}\n\n/**\n * Resolve a capability by token, binding document-scoped ones to this\n * subtree's document. Resolution is a REACTIVE read (`tryCapability` through\n * the kernel's one change stream), not a memoized call — under the\n * request-time lifecycle a document can become resolvable while its id stays\n * the same, so any id-keyed cache goes stale; subscribing makes staleness\n * structurally impossible. Fail-fast: while unresolvable, this re-runs the\n * strict resolver so the kernel's truthful reason (`no capability` / `no\n * document` / `document is loading|locked`) is what throws.\n */\nexport function useCapability<T>(token: CapabilityToken<T>): T {\n  const kernel = useKernel();\n  const scoped = useContext(DocumentScopeCtx);\n  const cap = useKernelValue((k) => k.tryCapability(token, scoped ?? undefined));\n  return cap ?? kernel.capability(token, scoped ?? undefined);\n}\n\n/** Like `useCapability`, but null while the token can't resolve (no plugin,\n *  no document, or a document that isn't ready yet). */\nexport function useOptionalCapability<T>(token: CapabilityToken<T>): T | null {\n  const scoped = useContext(DocumentScopeCtx);\n  return useKernelValue((k) => k.tryCapability(token, scoped ?? undefined));\n}\n\n/** Subscribe to a selector over a (document-resolved) capability. */\nexport function useSelector<C, R>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const cap = useCapability(token);\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    const next = select(cap);\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\n/**\n * Null-safe `useSelector`: `fallback` whenever the token can't resolve — no\n * provider, or a document-scoped token with no document. For chrome that stays\n * mounted across the empty-workspace state (a zoom readout, a mode band).\n * `useSelector` stays strict (fail-fast) for code that KNOWS a document exists\n * — e.g. anything inside a <DocumentGate>.\n *\n * The `select` guard also swallows reads through a capability whose document\n * closed between the store notification and this render — that teardown race\n * resolves to `fallback` for one frame, then re-renders against the new state.\n */\nexport function useOptionalSelector<C, R>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => R,\n  fallback: R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const cap = useOptionalCapability(token);\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    let next: R;\n    if (cap === null) {\n      next = fallback;\n    } else {\n      try {\n        next = select(cap);\n      } catch {\n        next = fallback;\n      }\n    }\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\n/**\n * Subscribe to a capability's {@link EventHook} for the mounted lifetime —\n * `useCapabilityEvent(ActionsToken, (c) => c.onAction, handler)`. Events\n * carry occurrences, never state (a late subscriber that needs the current\n * value uses `useSelector`). The handler rides a ref, so a fresh closure per\n * render never resubscribes. Null-safe: no plugin/document → no subscription.\n */\nexport function useCapabilityEvent<C, T>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  const cap = useOptionalCapability(token);\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n  const selectRef = useRef(select);\n  selectRef.current = select;\n  useEffect(() => {\n    if (!cap) return;\n    return selectRef.current(cap)((event) => handlerRef.current(event));\n  }, [cap]);\n}\n\n/** The document registry (open/close/active/list), reactive. */\nexport function useDocuments() {\n  const kernel = useKernel();\n  const docs = useKernelValue((k) => k.documents.list(), docInfoListEquals);\n  const activeId = useActiveDocumentId();\n  return {\n    docs,\n    activeId,\n    open: kernel.documents.open,\n    unlock: kernel.documents.unlock,\n    close: kernel.documents.close,\n    setActive: kernel.documents.setActive,\n    move: kernel.documents.move,\n    swap: kernel.documents.swap,\n    download: kernel.documents.download,\n    downloadLayer: kernel.documents.downloadLayer,\n  };\n}\n\n// `InitialDocument` is the KERNEL's type (re-exported via `export * from\n// '@embedpdf/core'` above) — one shared shape for every adapter.\n\nexport interface ViewerProps {\n  /**\n   * The engine, as an instance or a thunk. Engines construct synchronously and\n   * boot lazily (`localEngine()` allocates nothing until first use), so\n   * ownership follows the SHAPE of what you pass:\n   *\n   *   - An **instance** (`engine={engine}`) is BORROWED: the Viewer uses it and\n   *     never destroys it, because you acquired it and therefore own it. The\n   *     common path — a module-scope `const engine = localEngine()` shared\n   *     across viewers and route changes. The Viewer calls `engine.warmup?.()`\n   *     on mount so the boot overlaps app initialization.\n   *   - A **thunk** (`engine={() => localEngine()}`) is VIEWER-OWNED: the\n   *     Viewer calls it on mount and `destroy()`s the result on unmount. Use it\n   *     for per-mount isolation (StrictMode/HMR-clean teardown, independent\n   *     multi-viewer engines).\n   *\n   * Init-only: captured on first render; later identity changes are ignored (dev warns).\n   */\n  engine: Engine | EngineFactory;\n  /** Init-only: captured on first render; later identity changes are ignored (dev warns). */\n  plugins: AnyPlugin[];\n  /** Documents to open on startup (with optional tab names). Init-only. */\n  initialDocuments?: InitialDocument[];\n  fallback?: React.ReactNode;\n  /** Rendered when kernel construction or `start()` fails. Without it a boot\n   *  failure renders nothing — but never a silent forever-fallback. */\n  renderError?: (error: unknown) => React.ReactNode;\n  children: React.ReactNode;\n}\n\ntype BootState =\n  | { phase: 'booting'; kernel: Kernel | null }\n  | { phase: 'ready'; kernel: Kernel }\n  | { phase: 'error'; error: unknown };\n\n/**\n * Owns the kernel as an EFFECT-scoped resource: each effect setup creates and\n * starts exactly one kernel; each cleanup destroys exactly that one. That is\n * the contract StrictMode exercises (two kernels in dev, the first fully\n * destroyed) — the kernel itself is never restarted after destroy.\n *\n * The kernel is published to context the moment it exists — before `start()`\n * resolves — so the `fallback` can use workspace capabilities (i18n copy on a\n * loading screen) exactly as before. The one exception is the very first\n * render, which happens before the effect: it renders nothing. Children mount\n * once `start()` resolves — which never touches the engine, so the shell is\n * alive while WASM compiles or the transport connects. `initialDocuments`\n * open in the BACKGROUND and stream into the registry (`useDocuments()` is\n * reactive); per-document loading UI is the Stage's job, not a root gate.\n *\n * ENGINE OWNERSHIP. When `engine` is a thunk, the Viewer OWNS it: each effect\n * setup constructs one engine (construction is synchronous and inert — boot\n * happens lazily inside the engine) and each cleanup destroys exactly that one\n * — after the kernel, so handles close first. When `engine` is an instance it\n * is BORROWED and never destroyed here; the Viewer only calls `warmup?.()` so\n * the WASM/transport boot overlaps plugin initialization. StrictMode's\n * double-mount therefore constructs two independent thunk engines and tears\n * the first fully down, matching the kernel's own effect-scoped lifecycle.\n * That means dev-only double resource use (two worker spawns, two font\n * fetches, briefly overlapping) — deliberate, because it is exactly the\n * leak-detection contract StrictMode exists to exercise; production mounts\n * once and boots once.\n */\nexport function Viewer({\n  engine,\n  plugins,\n  initialDocuments,\n  fallback,\n  renderError,\n  children,\n}: ViewerProps) {\n  // Init-only inputs: the kernel's lifetime is the component's lifetime, so a\n  // changed engine/plugins identity cannot mean \"rebuild the workspace\" —\n  // that would silently drop every open document. Capture once, warn in dev.\n  const initial = useRef({ engine, plugins, initialDocuments });\n  const warned = useRef(false);\n  if (process.env.NODE_ENV !== 'production' && !warned.current) {\n    if (initial.current.engine !== engine || initial.current.plugins !== plugins) {\n      warned.current = true;\n      console.warn(\n        '[embedpdf] <Viewer> engine/plugins are init-only. A changed identity is ignored — ' +\n          'pass stable references (module scope, useState, or useMemo). ' +\n          'An inline `plugins={[...]}` array recreates its identity every render.',\n      );\n    }\n  }\n\n  const [boot, setBoot] = useState<BootState>({ phase: 'booting', kernel: null });\n  useEffect(() => {\n    const captured = initial.current;\n    // A thunk is viewer-owned: call it now, destroy on unmount. An instance is\n    // borrowed: use as-is, never destroy. Construction is synchronous and inert\n    // either way — the engine boots lazily on first use — so kick `warmup()`\n    // to overlap the WASM/transport boot with plugin initialization.\n    const ownsEngine = typeof captured.engine === 'function';\n    const engine: Engine = ownsEngine\n      ? (captured.engine as EngineFactory)()\n      : (captured.engine as Engine);\n    engine.warmup?.();\n    let kernel: Kernel;\n    try {\n      kernel = createKernel({ engine, plugins: captured.plugins });\n    } catch (error) {\n      setBoot({ phase: 'error', error }); // plan/graph errors surface, not throw mid-render\n      if (ownsEngine) void engine.destroy();\n      return;\n    }\n    let alive = true;\n    setBoot({ phase: 'booting', kernel }); // context carries the kernel from this frame on\n    kernel.start().then(\n      () => {\n        if (!alive) return; // unmounted mid-boot — don't open anything\n        setBoot({ phase: 'ready', kernel });\n        // Kernel-owned boot policy: all tabs appear immediately in array\n        // order; the `active` entry (else the first) is selected; failures\n        // surface as tab status. See DocumentsCapability.openAll.\n        kernel.documents.openAll(captured.initialDocuments ?? []);\n      },\n      (error) => {\n        if (alive) setBoot({ phase: 'error', error });\n      },\n    );\n    return () => {\n      alive = false;\n      // Kernel first (closes every document handle), THEN the engine we own —\n      // ownership follows acquisition. `engine.destroy()` joins an in-flight\n      // boot (or no-ops if it never started), so an unmount mid-boot is safe.\n      void kernel.destroy().then(() => {\n        if (ownsEngine) void engine.destroy();\n      });\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  if (boot.phase === 'error') {\n    return <>{renderError ? renderError(boot.error) : null}</>;\n  }\n  if (!boot.kernel) return null; // pre-effect first render only\n  return (\n    <KernelCtx.Provider value={boot.kernel}>\n      {boot.phase === 'ready' ? children : (fallback ?? null)}\n    </KernelCtx.Provider>\n  );\n}\nexport const EmbedPDF = Viewer;\n\n/**\n * PageContext — the seam. A layer depends ONLY on this, never on the Stage. So the\n * same layer works inside a virtualized Stage and in a standalone <PageView>.\n */\nexport interface PageContextValue {\n  documentId: string;\n  /** Durable page identity (PDF object number) — use for keys / render / annotations. */\n  pon: number;\n  /** Display index (page N) — use for ordering / human-facing page numbers. */\n  pageIndex: number;\n  /**\n   * Reserved chrome bands around the page (screen px per side). The page-chrome\n   * slot renders into the outer box (content + frame); these thicknesses size\n   * the bands — a label in the bottom band is `bottom:0; height: frame.bottom`.\n   */\n  frame: PageFrame;\n  /**\n   * The single bridge between PDF points, view px, and device px for this page.\n   * Layers do ALL coordinate work through it — `toPixels` to place content-\n   * space overlays, `renderScale`/`deviceWidth` to render, `contentWidth` for\n   * page-relative sizing. Never re-derive `x * scale` or `* dpr`.\n   */\n  transform: PageTransform;\n  /** Client (screen) point → the viewer's coordinates (content point) — the\n   *  one platform-bound hit-test. */\n  toContentPoint(clientX: number, clientY: number): Point;\n  /** Content point → client (screen) px — the exact inverse of `toContentPoint`\n   *  (rotation applied). Lets viewport-space UI (e.g. a selection menu) anchor to a\n   *  page point WITHOUT a Stage camera, so it works the same in `<PageView>`. */\n  toClientPoint(p: Point): Point;\n  /** Content rect → client (screen) px AABB. Rect analog of `toClientPoint`\n   *  for upright viewport-space UI that frames a selected page region. */\n  toClientRect(rect: Rect): Rect;\n  /**\n   * The page-view DEMAND for raster planning uses dependency inversion:\n   * plugin-render defines the shape; the host that CREATED this\n   * context fills it — as a PULL. The Stage host's getter closes over the\n   * stage capability and reads `VisiblePage.visibleRect` live at call time\n   * (visibility is the STAGE's data; adapters never re-derive camera math or\n   * cache a copy). Three states, three meanings: a real sub-rect (visible),\n   * a ZERO rect (stage host, page currently off-screen — want nothing), and\n   * an undefined getter (stage-less `<PageView>` — whole page visible, which\n   * a thumbnail-sized demand turns into \"never engages\" by arithmetic).\n   */\n  getViewDemand?: () => PageViewDemand;\n  /**\n   * The hosting VIEW's identity — the stage lens id (`stage.lensId()`) or a\n   * per-instance PageView id. IDENTITY, not an option: per-view raster\n   * planning (tiles) keys its state by this, so two views showing the SAME\n   * page never fight over one plan (a thumbnail rail's never-engaging demand\n   * must not disturb the main view's tiles). Every page context host must\n   * say which view it is.\n   */\n  view: string;\n}\n\nconst PageCtx = createContext<PageContextValue | null>(null);\nexport const PageProvider = PageCtx.Provider;\n\nexport function usePage(): PageContextValue {\n  const c = useContext(PageCtx);\n  if (!c) throw new Error('usePage must be used inside <PageView> or a <Stage> page');\n  return c;\n}\n\nexport function makePageContext(\n  documentId: string,\n  view: string,\n  pon: number,\n  pageIndex: number,\n  frame: PageFrame,\n  transform: PageTransform,\n  getRect: () => DOMRect,\n  getViewDemand?: () => PageViewDemand,\n): PageContextValue {\n  return {\n    documentId,\n    view,\n    pon,\n    pageIndex,\n    frame,\n    transform,\n    ...(getViewDemand ? { getViewDemand } : {}),\n    toContentPoint: (cx, cy) => {\n      // `getRect()` is the rotated content wrapper's axis-aligned bounding box =\n      // the page's DISPLAY box on screen. Convert client → box-local view px,\n      // then invert rotation + scale via the transform (verified once in geometry,\n      // not re-derived per framework adapter).\n      const r = getRect();\n      return transform.viewToContent({ x: cx - r.left, y: cy - r.top });\n    },\n    toClientPoint: (p) => {\n      // Exact inverse of `toContentPoint`: page/content point → display-box view px\n      // (rotation applied by the transform), offset by the same live display-box\n      // origin. So the two can never drift, in either <Stage> or <PageView>.\n      const r = getRect();\n      const v = transform.contentToView(p);\n      return { x: r.left + v.x, y: r.top + v.y };\n    },\n    toClientRect: (rect) => {\n      const r = getRect();\n      const v = transform.contentToViewRect(rect);\n      return { x: r.left + v.x, y: r.top + v.y, width: v.width, height: v.height };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.tsx"],"sourcesContent":["/**\n * @embedpdf/react — the generic binding.\n *\n * Binds the kernel's one change stream to React (useSyncExternalStore), resolves\n * capabilities (document-scoped ones against the active or `<DocumentScope>`-given\n * document), and provides the page coordinate context. Every plugin and layer rides\n * on this — there is no per-plugin framework code.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/core';\nimport * as React from 'react';\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { createKernel, docInfoListEquals } from '@embedpdf/core';\nimport type {\n  AnyPlugin,\n  CapabilityToken,\n  Engine,\n  EngineFactory,\n  EventHook,\n  InitialDocument,\n  Kernel,\n} from '@embedpdf/core';\n// Pure coordinate math from the geometry base — NOT from stage-core. The\n// PageContext seam stays stage-agnostic (it must also serve standalone PageView).\nimport type { PageFrame, PageTransform, Point, Rect } from '@embedpdf/core-geometry';\nimport type { PageViewDemand } from '@embedpdf/plugin-render/contract';\n\nconst KernelCtx = createContext<Kernel | null>(null);\n/** The document a subtree is bound to. null => use the active document. */\nconst DocumentScopeCtx = createContext<string | null>(null);\n\nexport function useKernel(): Kernel {\n  const k = useContext(KernelCtx);\n  if (!k) throw new Error('useKernel must be used within <Viewer>/<EmbedPDF>');\n  return k;\n}\n\nexport const shallowArray = <T,>(a: readonly T[], b: readonly T[]): boolean =>\n  a === b || (a.length === b.length && a.every((x, i) => x === b[i]));\n\n/** Read a value derived from the kernel, cached by equality (no tearing loop). */\nexport function useKernelValue<R>(\n  select: (k: Kernel) => R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    const next = select(kernel);\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\nexport function useActiveDocumentId(): string | null {\n  return useKernelValue((k) => k.documents.activeId());\n}\n\n/** The document id for this subtree: the nearest <DocumentScope>, else the active doc. */\nexport function useDocumentId(): string | null {\n  const scoped = useContext(DocumentScopeCtx);\n  const active = useActiveDocumentId();\n  return scoped ?? active;\n}\n\nexport interface DocumentScopeProps {\n  id: string;\n  children: React.ReactNode;\n}\n/** Bind a subtree to a specific document (panes, comparison). */\nexport function DocumentScope({ id, children }: DocumentScopeProps) {\n  return <DocumentScopeCtx.Provider value={id}>{children}</DocumentScopeCtx.Provider>;\n}\n\nexport interface DocumentGateProps {\n  /** Shown while this subtree has NO document (empty workspace, docs still opening). */\n  fallback?: React.ReactNode;\n  children: React.ReactNode;\n}\n/**\n * Render children only while this subtree has a READY document — the\n * structural way to say \"this UI is defined over a document\". An empty\n * workspace is a legitimate, designable state (the Viewer no longer blocks on\n * documents so chrome can render at t≈0): workspace-scoped UI (toolbars,\n * commands, i18n) lives OUTSIDE the gate; document-scoped UI (Stage, panels,\n * page chrome) lives inside it, or reads through `useOptionalSelector`.\n * A `loading`/`locked`/`error` tab renders `fallback` — so the gate's\n * fallback doubles as the per-tab boot state; richer chrome (a password\n * prompt, an error pane) branches on `useDocumentStatus()` beside the gate.\n * Sibling of <DocumentScope>, which picks WHICH document; this one handles\n * WHETHER.\n */\nexport function DocumentGate({ fallback = null, children }: DocumentGateProps) {\n  const docId = useDocumentId();\n  const ready = useKernelValue((k) => (docId ? k.documents.get(docId)?.status === 'ready' : false));\n  return <>{ready ? children : fallback}</>;\n}\n\n/** Lifecycle status of this subtree's document (loading/locked/ready/error),\n *  or null with no document. The password prompt and error panes key off it. */\nexport function useDocumentStatus() {\n  const docId = useDocumentId();\n  return useKernelValue((k) => (docId ? (k.documents.get(docId)?.status ?? null) : null));\n}\n\n/**\n * Resolve a capability by token, binding document-scoped ones to this\n * subtree's document. Resolution is a REACTIVE read (`tryCapability` through\n * the kernel's one change stream), not a memoized call — under the\n * request-time lifecycle a document can become resolvable while its id stays\n * the same, so any id-keyed cache goes stale; subscribing makes staleness\n * structurally impossible. Fail-fast: while unresolvable, this re-runs the\n * strict resolver so the kernel's truthful reason (`no capability` / `no\n * document` / `document is loading|locked`) is what throws.\n */\nexport function useCapability<T>(token: CapabilityToken<T>): T {\n  const kernel = useKernel();\n  const scoped = useContext(DocumentScopeCtx);\n  const cap = useKernelValue((k) => k.tryCapability(token, scoped ?? undefined));\n  return cap ?? kernel.capability(token, scoped ?? undefined);\n}\n\n/** Like `useCapability`, but null while the token can't resolve (no plugin,\n *  no document, or a document that isn't ready yet). */\nexport function useOptionalCapability<T>(token: CapabilityToken<T>): T | null {\n  const scoped = useContext(DocumentScopeCtx);\n  return useKernelValue((k) => k.tryCapability(token, scoped ?? undefined));\n}\n\n/** Subscribe to a selector over a (document-resolved) capability. */\nexport function useSelector<C, R>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const cap = useCapability(token);\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    const next = select(cap);\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\n/**\n * Null-safe `useSelector`: `fallback` whenever the token can't resolve — no\n * provider, or a document-scoped token with no document. For chrome that stays\n * mounted across the empty-workspace state (a zoom readout, a mode band).\n * `useSelector` stays strict (fail-fast) for code that KNOWS a document exists\n * — e.g. anything inside a <DocumentGate>.\n *\n * The `select` guard also swallows reads through a capability whose document\n * closed between the store notification and this render — that teardown race\n * resolves to `fallback` for one frame, then re-renders against the new state.\n */\nexport function useOptionalSelector<C, R>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => R,\n  fallback: R,\n  isEqual: (a: R, b: R) => boolean = Object.is,\n): R {\n  const kernel = useKernel();\n  const cap = useOptionalCapability(token);\n  const last = useRef<{ v: R } | null>(null);\n  const get = () => {\n    let next: R;\n    if (cap === null) {\n      next = fallback;\n    } else {\n      try {\n        next = select(cap);\n      } catch {\n        next = fallback;\n      }\n    }\n    if (last.current && isEqual(last.current.v, next)) return last.current.v;\n    last.current = { v: next };\n    return next;\n  };\n  return useSyncExternalStore(kernel.subscribe, get, get);\n}\n\n/**\n * Subscribe to a capability's {@link EventHook} for the mounted lifetime —\n * `useCapabilityEvent(ActionsToken, (c) => c.onAction, handler)`. Events\n * carry occurrences, never state (a late subscriber that needs the current\n * value uses `useSelector`). The handler rides a ref, so a fresh closure per\n * render never resubscribes. Null-safe: no plugin/document → no subscription.\n */\nexport function useCapabilityEvent<C, T>(\n  token: CapabilityToken<C>,\n  select: (cap: C) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  const cap = useOptionalCapability(token);\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n  const selectRef = useRef(select);\n  selectRef.current = select;\n  useEffect(() => {\n    if (!cap) return;\n    return selectRef.current(cap)((event) => handlerRef.current(event));\n  }, [cap]);\n}\n\n/** The document registry (open/close/active/list), reactive. */\nexport function useDocuments() {\n  const kernel = useKernel();\n  const docs = useKernelValue((k) => k.documents.list(), docInfoListEquals);\n  const activeId = useActiveDocumentId();\n  return {\n    docs,\n    activeId,\n    open: kernel.documents.open,\n    unlock: kernel.documents.unlock,\n    close: kernel.documents.close,\n    setActive: kernel.documents.setActive,\n    move: kernel.documents.move,\n    swap: kernel.documents.swap,\n    download: kernel.documents.download,\n    downloadLayer: kernel.documents.downloadLayer,\n  };\n}\n\n// `InitialDocument` is the KERNEL's type (re-exported via `export * from\n// '@embedpdf/core'` above) — one shared shape for every adapter.\n\nexport interface ViewerProps {\n  /**\n   * The engine, as an instance or a thunk. Engines construct synchronously and\n   * boot lazily (`localEngine()` allocates nothing until first use), so\n   * ownership follows the SHAPE of what you pass:\n   *\n   *   - An **instance** (`engine={engine}`) is BORROWED: the Viewer uses it and\n   *     never destroys it, because you acquired it and therefore own it. The\n   *     common path — a module-scope `const engine = localEngine()` shared\n   *     across viewers and route changes. The Viewer calls `engine.warmup?.()`\n   *     on mount so the boot overlaps app initialization.\n   *   - A **thunk** (`engine={() => localEngine()}`) is VIEWER-OWNED: the\n   *     Viewer calls it on mount and `destroy()`s the result on unmount. Use it\n   *     for per-mount isolation (StrictMode/HMR-clean teardown, independent\n   *     multi-viewer engines).\n   *\n   * Init-only: captured on first render; later identity changes are ignored (dev warns).\n   */\n  engine: Engine | EngineFactory;\n  /** Init-only: captured on first render; later identity changes are ignored (dev warns). */\n  plugins: AnyPlugin[];\n  /** Documents to open on startup (with optional tab names). Init-only. */\n  initialDocuments?: InitialDocument[];\n  fallback?: React.ReactNode;\n  /** Rendered when kernel construction or `start()` fails. Without it a boot\n   *  failure renders nothing — but never a silent forever-fallback. */\n  renderError?: (error: unknown) => React.ReactNode;\n  children: React.ReactNode;\n}\n\ntype BootState =\n  | { phase: 'booting'; kernel: Kernel | null }\n  | { phase: 'ready'; kernel: Kernel }\n  | { phase: 'error'; error: unknown };\n\n/**\n * Owns the kernel as an EFFECT-scoped resource: each effect setup creates and\n * starts exactly one kernel; each cleanup destroys exactly that one. That is\n * the contract StrictMode exercises (two kernels in dev, the first fully\n * destroyed) — the kernel itself is never restarted after destroy.\n *\n * The kernel is published to context the moment it exists — before `start()`\n * resolves — so the `fallback` can use workspace capabilities (i18n copy on a\n * loading screen) exactly as before. The one exception is the very first\n * render, which happens before the effect: it renders nothing. Children mount\n * once `start()` resolves — which never touches the engine, so the shell is\n * alive while WASM compiles or the transport connects. `initialDocuments`\n * open in the BACKGROUND and stream into the registry (`useDocuments()` is\n * reactive); per-document loading UI is the Stage's job, not a root gate.\n *\n * ENGINE OWNERSHIP. When `engine` is a thunk, the Viewer OWNS it: each effect\n * setup constructs one engine (construction is synchronous and inert — boot\n * happens lazily inside the engine) and each cleanup destroys exactly that one\n * — after the kernel, so handles close first. When `engine` is an instance it\n * is BORROWED and never destroyed here; the Viewer only calls `warmup?.()` so\n * the WASM/transport boot overlaps plugin initialization. StrictMode's\n * double-mount therefore constructs two independent thunk engines and tears\n * the first fully down, matching the kernel's own effect-scoped lifecycle.\n * That means dev-only double resource use (two worker spawns, two font\n * fetches, briefly overlapping) — deliberate, because it is exactly the\n * leak-detection contract StrictMode exists to exercise; production mounts\n * once and boots once.\n */\nexport function Viewer({\n  engine,\n  plugins,\n  initialDocuments,\n  fallback,\n  renderError,\n  children,\n}: ViewerProps) {\n  // Init-only inputs: the kernel's lifetime is the component's lifetime, so a\n  // changed engine/plugins identity cannot mean \"rebuild the workspace\" —\n  // that would silently drop every open document. Capture once, warn in dev.\n  const initial = useRef({ engine, plugins, initialDocuments });\n  const warned = useRef(false);\n  if (process.env.NODE_ENV !== 'production' && !warned.current) {\n    if (initial.current.engine !== engine || initial.current.plugins !== plugins) {\n      warned.current = true;\n      console.warn(\n        '[embedpdf] <Viewer> engine/plugins are init-only. A changed identity is ignored — ' +\n          'pass stable references (module scope, useState, or useMemo). ' +\n          'An inline `plugins={[...]}` array recreates its identity every render.',\n      );\n    }\n  }\n\n  const [boot, setBoot] = useState<BootState>({ phase: 'booting', kernel: null });\n  useEffect(() => {\n    const captured = initial.current;\n    // A thunk is viewer-owned: call it now, destroy on unmount. An instance is\n    // borrowed: use as-is, never destroy. Construction is synchronous and inert\n    // either way — the engine boots lazily on first use — so kick `warmup()`\n    // to overlap the WASM/transport boot with plugin initialization.\n    const ownsEngine = typeof captured.engine === 'function';\n    const engine: Engine = ownsEngine\n      ? (captured.engine as EngineFactory)()\n      : (captured.engine as Engine);\n    engine.warmup?.();\n    let kernel: Kernel;\n    try {\n      kernel = createKernel({ engine, plugins: captured.plugins });\n    } catch (error) {\n      setBoot({ phase: 'error', error }); // plan/graph errors surface, not throw mid-render\n      if (ownsEngine) void engine.destroy();\n      return;\n    }\n    let alive = true;\n    setBoot({ phase: 'booting', kernel }); // context carries the kernel from this frame on\n    kernel.start().then(\n      () => {\n        if (!alive) return; // unmounted mid-boot — don't open anything\n        setBoot({ phase: 'ready', kernel });\n        // Kernel-owned boot policy: all tabs appear immediately in array\n        // order; the `active` entry (else the first) is selected; failures\n        // surface as tab status. See DocumentsCapability.openAll.\n        kernel.documents.openAll(captured.initialDocuments ?? []);\n      },\n      (error) => {\n        if (alive) setBoot({ phase: 'error', error });\n      },\n    );\n    return () => {\n      alive = false;\n      // Kernel first (closes every document handle), THEN the engine we own —\n      // ownership follows acquisition. `engine.destroy()` joins an in-flight\n      // boot (or no-ops if it never started), so an unmount mid-boot is safe.\n      void kernel.destroy().then(() => {\n        if (ownsEngine) void engine.destroy();\n      });\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  if (boot.phase === 'error') {\n    return <>{renderError ? renderError(boot.error) : null}</>;\n  }\n  if (!boot.kernel) return null; // pre-effect first render only\n  return (\n    <KernelCtx.Provider value={boot.kernel}>\n      {boot.phase === 'ready' ? children : (fallback ?? null)}\n    </KernelCtx.Provider>\n  );\n}\nexport const EmbedPDF = Viewer;\n\n/**\n * PageContext — the seam. A layer depends ONLY on this, never on the Stage. So the\n * same layer works inside a virtualized Stage and in a standalone <PageView>.\n */\nexport interface PageContextValue {\n  documentId: string;\n  /** Durable page identity (PDF object number) — use for keys / render / annotations. */\n  pon: number;\n  /** Display index (page N) — use for ordering / human-facing page numbers. */\n  pageIndex: number;\n  /**\n   * Reserved chrome bands around the page (screen px per side). The page-chrome\n   * slot renders into the outer box (content + frame); these thicknesses size\n   * the bands — a label in the bottom band is `bottom:0; height: frame.bottom`.\n   */\n  frame: PageFrame;\n  /**\n   * The single bridge between PDF points, view px, and device px for this page.\n   * Layers do ALL coordinate work through it — `toPixels` to place content-\n   * space overlays, `renderScale`/`deviceWidth` to render, `contentWidth` for\n   * page-relative sizing. Never re-derive `x * scale` or `* dpr`.\n   */\n  transform: PageTransform;\n  /** Client (screen) point → the viewer's coordinates (content point) — the\n   *  one platform-bound hit-test. */\n  toContentPoint(clientX: number, clientY: number): Point;\n  /** Content point → client (screen) px — the exact inverse of `toContentPoint`\n   *  (rotation applied). Lets viewport-space UI (e.g. a selection menu) anchor to a\n   *  page point WITHOUT a Stage camera, so it works the same in `<PageView>`. */\n  toClientPoint(p: Point): Point;\n  /** Content rect → client (screen) px AABB. Rect analog of `toClientPoint`\n   *  for upright viewport-space UI that frames a selected page region. */\n  toClientRect(rect: Rect): Rect;\n  /**\n   * The page-view DEMAND for raster planning uses dependency inversion:\n   * plugin-render defines the shape; the host that CREATED this\n   * context fills it — as a PULL. The Stage host's getter closes over the\n   * stage capability and reads `VisiblePage.visibleRect` live at call time\n   * (visibility is the STAGE's data; adapters never re-derive camera math or\n   * cache a copy). Three states, three meanings: a real sub-rect (visible),\n   * a ZERO rect (stage host, page currently off-screen — want nothing), and\n   * an undefined getter (stage-less `<PageView>` — whole page visible, which\n   * a thumbnail-sized demand turns into \"never engages\" by arithmetic).\n   */\n  getViewDemand?: () => PageViewDemand;\n  /**\n   * The hosting VIEW's identity — the stage lens id (`stage.lensId()`) or a\n   * per-instance PageView id. IDENTITY, not an option: per-view raster\n   * planning (tiles) keys its state by this, so two views showing the SAME\n   * page never fight over one plan (a thumbnail rail's never-engaging demand\n   * must not disturb the main view's tiles). Every page context host must\n   * say which view it is.\n   */\n  view: string;\n}\n\nconst PageCtx = createContext<PageContextValue | null>(null);\nexport const PageProvider = PageCtx.Provider;\n\nexport function usePage(): PageContextValue {\n  const c = useContext(PageCtx);\n  if (!c) throw new Error('usePage must be used inside <PageView> or a <Stage> page');\n  return c;\n}\n\nexport function makePageContext(\n  documentId: string,\n  view: string,\n  pon: number,\n  pageIndex: number,\n  frame: PageFrame,\n  transform: PageTransform,\n  getRect: () => DOMRect,\n  getViewDemand?: () => PageViewDemand,\n): PageContextValue {\n  return {\n    documentId,\n    view,\n    pon,\n    pageIndex,\n    frame,\n    transform,\n    ...(getViewDemand ? { getViewDemand } : {}),\n    toContentPoint: (cx, cy) => {\n      // `getRect()` is the rotated content wrapper's axis-aligned bounding box =\n      // the page's DISPLAY box on screen. Convert client → box-local view px,\n      // then invert rotation + scale via the transform (verified once in geometry,\n      // not re-derived per framework adapter).\n      const r = getRect();\n      return transform.viewToContent({ x: cx - r.left, y: cy - r.top });\n    },\n    toClientPoint: (p) => {\n      // Exact inverse of `toContentPoint`: page/content point → display-box view px\n      // (rotation applied by the transform), offset by the same live display-box\n      // origin. So the two can never drift, in either <Stage> or <PageView>.\n      const r = getRect();\n      const v = transform.contentToView(p);\n      return { x: r.left + v.x, y: r.top + v.y };\n    },\n    toClientRect: (rect) => {\n      const r = getRect();\n      const v = transform.contentToViewRect(rect);\n      return { x: r.left + v.x, y: r.top + v.y, width: v.width, height: v.height };\n    },\n  };\n}\n"],"mappings":";;;;;;AAmCA,MAAM,YAAY,cAA6B,IAAI;;AAEnD,MAAM,mBAAmB,cAA6B,IAAI;AAE1D,SAAgB,YAAoB;CAClC,MAAM,IAAI,WAAW,SAAS;CAC9B,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,mDAAmD;CAC3E,OAAO;AACT;AAEA,MAAa,gBAAoB,GAAiB,MAChD,MAAM,KAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,MAAM,EAAE,EAAE;;AAGnE,SAAgB,eACd,QACA,UAAmC,OAAO,IACvC;CACH,MAAM,SAAS,UAAU;CACzB,MAAM,OAAO,OAAwB,IAAI;CACzC,MAAM,YAAY;EAChB,MAAM,OAAO,OAAO,MAAM;EAC1B,IAAI,KAAK,WAAW,QAAQ,KAAK,QAAQ,GAAG,IAAI,GAAG,OAAO,KAAK,QAAQ;EACvE,KAAK,UAAU,EAAE,GAAG,KAAK;EACzB,OAAO;CACT;CACA,OAAO,qBAAqB,OAAO,WAAW,KAAK,GAAG;AACxD;AAEA,SAAgB,sBAAqC;CACnD,OAAO,gBAAgB,MAAM,EAAE,UAAU,SAAS,CAAC;AACrD;;AAGA,SAAgB,gBAA+B;CAC7C,MAAM,SAAS,WAAW,gBAAgB;CAC1C,MAAM,SAAS,oBAAoB;CACnC,OAAO,UAAU;AACnB;;AAOA,SAAgB,cAAc,EAAE,IAAI,YAAgC;CAClE,OAAO,oBAAC,iBAAiB,UAAlB;EAA2B,OAAO;EAAK;CAAoC,CAAA;AACpF;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,EAAE,WAAW,MAAM,YAA+B;CAC7E,MAAM,QAAQ,cAAc;CAE5B,OAAO,oBAAA,UAAA,EAAA,UADO,gBAAgB,MAAO,QAAQ,EAAE,UAAU,IAAI,KAAK,CAAC,EAAE,WAAW,UAAU,KAC5E,IAAI,WAAW,SAAW,CAAA;AAC1C;;;AAIA,SAAgB,oBAAoB;CAClC,MAAM,QAAQ,cAAc;CAC5B,OAAO,gBAAgB,MAAO,QAAS,EAAE,UAAU,IAAI,KAAK,CAAC,EAAE,UAAU,OAAQ,IAAK;AACxF;;;;;;;;;;;AAYA,SAAgB,cAAiB,OAA8B;CAC7D,MAAM,SAAS,UAAU;CACzB,MAAM,SAAS,WAAW,gBAAgB;CAE1C,OADY,gBAAgB,MAAM,EAAE,cAAc,OAAO,UAAU,KAAA,CAAS,CACnE,KAAK,OAAO,WAAW,OAAO,UAAU,KAAA,CAAS;AAC5D;;;AAIA,SAAgB,sBAAyB,OAAqC;CAC5E,MAAM,SAAS,WAAW,gBAAgB;CAC1C,OAAO,gBAAgB,MAAM,EAAE,cAAc,OAAO,UAAU,KAAA,CAAS,CAAC;AAC1E;;AAGA,SAAgB,YACd,OACA,QACA,UAAmC,OAAO,IACvC;CACH,MAAM,SAAS,UAAU;CACzB,MAAM,MAAM,cAAc,KAAK;CAC/B,MAAM,OAAO,OAAwB,IAAI;CACzC,MAAM,YAAY;EAChB,MAAM,OAAO,OAAO,GAAG;EACvB,IAAI,KAAK,WAAW,QAAQ,KAAK,QAAQ,GAAG,IAAI,GAAG,OAAO,KAAK,QAAQ;EACvE,KAAK,UAAU,EAAE,GAAG,KAAK;EACzB,OAAO;CACT;CACA,OAAO,qBAAqB,OAAO,WAAW,KAAK,GAAG;AACxD;;;;;;;;;;;;AAaA,SAAgB,oBACd,OACA,QACA,UACA,UAAmC,OAAO,IACvC;CACH,MAAM,SAAS,UAAU;CACzB,MAAM,MAAM,sBAAsB,KAAK;CACvC,MAAM,OAAO,OAAwB,IAAI;CACzC,MAAM,YAAY;EAChB,IAAI;EACJ,IAAI,QAAQ,MACV,OAAO;OAEP,IAAI;GACF,OAAO,OAAO,GAAG;EACnB,QAAQ;GACN,OAAO;EACT;EAEF,IAAI,KAAK,WAAW,QAAQ,KAAK,QAAQ,GAAG,IAAI,GAAG,OAAO,KAAK,QAAQ;EACvE,KAAK,UAAU,EAAE,GAAG,KAAK;EACzB,OAAO;CACT;CACA,OAAO,qBAAqB,OAAO,WAAW,KAAK,GAAG;AACxD;;;;;;;;AASA,SAAgB,mBACd,OACA,QACA,SACM;CACN,MAAM,MAAM,sBAAsB,KAAK;CACvC,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CACrB,MAAM,YAAY,OAAO,MAAM;CAC/B,UAAU,UAAU;CACpB,gBAAgB;EACd,IAAI,CAAC,KAAK;EACV,OAAO,UAAU,QAAQ,GAAG,CAAC,EAAE,UAAU,WAAW,QAAQ,KAAK,CAAC;CACpE,GAAG,CAAC,GAAG,CAAC;AACV;;AAGA,SAAgB,eAAe;CAC7B,MAAM,SAAS,UAAU;CAGzB,OAAO;EACL,MAHW,gBAAgB,MAAM,EAAE,UAAU,KAAK,GAAG,iBAGlD;EACH,UAHe,oBAGR;EACP,MAAM,OAAO,UAAU;EACvB,QAAQ,OAAO,UAAU;EACzB,OAAO,OAAO,UAAU;EACxB,WAAW,OAAO,UAAU;EAC5B,MAAM,OAAO,UAAU;EACvB,MAAM,OAAO,UAAU;EACvB,UAAU,OAAO,UAAU;EAC3B,eAAe,OAAO,UAAU;CAClC;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,OAAO,EACrB,QACA,SACA,kBACA,UACA,aACA,YACc;CAId,MAAM,UAAU,OAAO;EAAE;EAAQ;EAAS;CAAiB,CAAC;CAC5D,MAAM,SAAS,OAAO,KAAK;CAC3B,IAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,OAAO,SAC/C;MAAA,QAAQ,QAAQ,WAAW,UAAU,QAAQ,QAAQ,YAAY,SAAS;GAC5E,OAAO,UAAU;GACjB,QAAQ,KACN,uNAGF;EACF;;CAGF,MAAM,CAAC,MAAM,WAAW,SAAoB;EAAE,OAAO;EAAW,QAAQ;CAAK,CAAC;CAC9E,gBAAgB;EACd,MAAM,WAAW,QAAQ;EAKzB,MAAM,aAAa,OAAO,SAAS,WAAW;EAC9C,MAAM,SAAiB,aAClB,SAAS,OAAyB,IAClC,SAAS;EACd,OAAO,SAAS;EAChB,IAAI;EACJ,IAAI;GACF,SAAS,aAAa;IAAE;IAAQ,SAAS,SAAS;GAAQ,CAAC;EAC7D,SAAS,OAAO;GACd,QAAQ;IAAE,OAAO;IAAS;GAAM,CAAC;GACjC,IAAI,YAAY,OAAY,QAAQ;GACpC;EACF;EACA,IAAI,QAAQ;EACZ,QAAQ;GAAE,OAAO;GAAW;EAAO,CAAC;EACpC,OAAO,MAAM,CAAC,CAAC,WACP;GACJ,IAAI,CAAC,OAAO;GACZ,QAAQ;IAAE,OAAO;IAAS;GAAO,CAAC;GAIlC,OAAO,UAAU,QAAQ,SAAS,oBAAoB,CAAC,CAAC;EAC1D,IACC,UAAU;GACT,IAAI,OAAO,QAAQ;IAAE,OAAO;IAAS;GAAM,CAAC;EAC9C,CACF;EACA,aAAa;GACX,QAAQ;GAIR,OAAY,QAAQ,CAAC,CAAC,WAAW;IAC/B,IAAI,YAAY,OAAY,QAAQ;GACtC,CAAC;EACH;CAEF,GAAG,CAAC,CAAC;CAEL,IAAI,KAAK,UAAU,SACjB,OAAO,oBAAA,UAAA,EAAA,UAAG,cAAc,YAAY,KAAK,KAAK,IAAI,KAAO,CAAA;CAE3D,IAAI,CAAC,KAAK,QAAQ,OAAO;CACzB,OACE,oBAAC,UAAU,UAAX;EAAoB,OAAO,KAAK;EAC7B,UAAA,KAAK,UAAU,UAAU,WAAY,YAAY;CAChC,CAAA;AAExB;AACA,MAAa,WAAW;AA0DxB,MAAM,UAAU,cAAuC,IAAI;AAC3D,MAAa,eAAe,QAAQ;AAEpC,SAAgB,UAA4B;CAC1C,MAAM,IAAI,WAAW,OAAO;CAC5B,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,0DAA0D;CAClF,OAAO;AACT;AAEA,SAAgB,gBACd,YACA,MACA,KACA,WACA,OACA,WACA,SACA,eACkB;CAClB,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;EACzC,iBAAiB,IAAI,OAAO;GAK1B,MAAM,IAAI,QAAQ;GAClB,OAAO,UAAU,cAAc;IAAE,GAAG,KAAK,EAAE;IAAM,GAAG,KAAK,EAAE;GAAI,CAAC;EAClE;EACA,gBAAgB,MAAM;GAIpB,MAAM,IAAI,QAAQ;GAClB,MAAM,IAAI,UAAU,cAAc,CAAC;GACnC,OAAO;IAAE,GAAG,EAAE,OAAO,EAAE;IAAG,GAAG,EAAE,MAAM,EAAE;GAAE;EAC3C;EACA,eAAe,SAAS;GACtB,MAAM,IAAI,QAAQ;GAClB,MAAM,IAAI,UAAU,kBAAkB,IAAI;GAC1C,OAAO;IAAE,GAAG,EAAE,OAAO,EAAE;IAAG,GAAG,EAAE,MAAM,EAAE;IAAG,OAAO,EAAE;IAAO,QAAQ,EAAE;GAAO;EAC7E;CACF;AACF"}

package/dist/scrollbar.cjs

@@ -1,241 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
-let react_jsx_runtime = require("react/jsx-runtime");
-let react = require("react");
-react = require_rolldown_runtime.__toESM(react, 1);
-let _embedpdf_plugin_stage_contract = require("@embedpdf/plugin-stage/contract");
-//#region src/scrollbar.tsx
-/**
-* Headless scrollbar for a Stage lens — a pure view of `stage.scrollMetrics()`.
-*
-* The Stage exposes the native scroller contract (scrollTop/scrollHeight/
-* clientHeight, in screen px — see plugin-stage's README); this component turns
-* it into a native-feeling bar: thumb drag with pointer capture and a preserved
-* grab point, track paging with press-and-hold repeat that stops at the
-* pointer, a minimum thumb length on long documents, and macOS-style overlay
-* auto-hide. On an UNBOUNDED stage the metrics already carry the Figma
-* semantics (the range is the union of content and view), so the same bar
-* shrinks toward the edge as you pan away and rides you back — the mapping is
-* FROZEN for the duration of a thumb drag so the thumb never chases itself
-* while the union re-collapses.
-*
-* Headless styling contract: geometry and behavior live here; looks live in
-* your CSS. Style via `className`/`thumbClassName` (or the style props) against
-*   [data-embedpdf-scrollbar][data-axis="y"][data-state="visible|hidden"]
-*   [data-embedpdf-scrollbar][data-dragging]
-*   [data-embedpdf-scrollbar-thumb]
-* The defaults are deliberately minimal: a transparent track pinned to the
-* viewport edge and a `var(--epdf-scrollbar-thumb, …)` pill, so the bar works
-* unstyled and disappears into any theme. Build something else entirely
-* (minimap, progress ring) from `useScrollMetrics()` + `stage.scrollTo()`.
-*/
-/** Live scroll metrics for a stage lens (reference-stable; see
-*  `StageCapability.scrollMetrics`). The raw material for custom scroll UI. */
-function useScrollMetrics(token = _embedpdf_plugin_stage_contract.StageToken) {
-	return require_runtime.useSelector(token, (c) => c.scrollMetrics());
-}
-const clamp01 = (v) => Math.min(1, Math.max(0, v));
-/** Best-effort pointer capture: an already-released pointer (pen/touch races,
-*  synthetic events in tests) throws NotFoundError — the press must still work,
-*  just without capture (moves keep arriving while the pointer stays on us). */
-const capturePointer = (el, pointerId) => {
-	try {
-		el.setPointerCapture(pointerId);
-	} catch {}
-};
-/** Thumb geometry from metrics + a measured track. One formula for render,
-*  drag capture, and paging — they can never disagree. */
-const geometry = (m, vertical, trackPx, minThumbSize) => {
-	const client = vertical ? m.clientHeight : m.clientWidth;
-	const total = vertical ? m.scrollHeight : m.scrollWidth;
-	const offset = vertical ? m.scrollTop : m.scrollLeft;
-	const maxOffset = Math.max(0, total - client);
-	const thumbLen = Math.min(trackPx, Math.max(minThumbSize, total > 0 ? client / total * trackPx : 0));
-	const travel = Math.max(0, trackPx - thumbLen);
-	return {
-		client,
-		offset,
-		maxOffset,
-		thumbLen,
-		travel,
-		thumbPos: maxOffset > 0 ? offset / maxOffset * travel : 0
-	};
-};
-function Scrollbar({ axis, token = _embedpdf_plugin_stage_contract.StageToken, autoHide = 1200, minThumbSize = 24, trackPress = "page", className, style, thumbClassName, thumbStyle }) {
-	const stage = require_runtime.useCapability(token);
-	const m = useScrollMetrics(token);
-	const vertical = axis === "y";
-	const scrollable = vertical ? m.scrollableY : m.scrollableX;
-	const trackRef = (0, react.useRef)(null);
-	const [trackPx, setTrackPx] = (0, react.useState)(0);
-	const [dragging, setDragging] = (0, react.useState)(false);
-	const [hovered, setHovered] = (0, react.useState)(false);
-	const [active, setActive] = (0, react.useState)(true);
-	const g = geometry(m, vertical, trackPx, minThumbSize);
-	const hideAfter = autoHide === false ? 0 : autoHide;
-	(0, react.useEffect)(() => {
-		if (!hideAfter) return;
-		setActive(true);
-		const t = setTimeout(() => setActive(false), hideAfter);
-		return () => clearTimeout(t);
-	}, [m, hideAfter]);
-	const shown = !hideAfter || active || hovered || dragging;
-	(0, react.useEffect)(() => {
-		const el = trackRef.current;
-		if (!el) return;
-		const measure = () => setTrackPx(vertical ? el.clientHeight : el.clientWidth);
-		const ro = new ResizeObserver(measure);
-		ro.observe(el);
-		measure();
-		return () => ro.disconnect();
-	}, [vertical, scrollable]);
-	const dragRef = (0, react.useRef)(null);
-	const pageRef = (0, react.useRef)(null);
-	const lastPtr = (0, react.useRef)(0);
-	const ptrPos = (e) => {
-		const r = trackRef.current.getBoundingClientRect();
-		return vertical ? e.clientY - r.top : e.clientX - r.left;
-	};
-	/** Fresh geometry for paging steps — read from the capability, never a stale render. */
-	const liveGeometry = () => geometry(stage.scrollMetrics(), vertical, trackPx, minThumbSize);
-	const stopPaging = () => {
-		if (pageRef.current) {
-			clearTimeout(pageRef.current.timer);
-			clearInterval(pageRef.current.timer);
-			pageRef.current = null;
-		}
-	};
-	const endDrag = () => {
-		dragRef.current = null;
-		stopPaging();
-		setDragging(false);
-	};
-	const beginDrag = (grab, applied) => {
-		dragRef.current = {
-			grab,
-			applied,
-			max: g.maxOffset,
-			travel: g.travel
-		};
-		setDragging(true);
-	};
-	const onThumbDown = (e) => {
-		if (e.button !== 0) return;
-		e.preventDefault();
-		e.stopPropagation();
-		capturePointer(e.target, e.pointerId);
-		beginDrag(ptrPos(e) - g.thumbPos, g.offset);
-	};
-	const onTrackDown = (e) => {
-		if (e.button !== 0 || e.target !== e.currentTarget) return;
-		e.preventDefault();
-		capturePointer(e.currentTarget, e.pointerId);
-		const p = lastPtr.current = ptrPos(e);
-		if (trackPress === "jump") {
-			const want = g.travel > 0 ? clamp01((p - g.thumbLen / 2) / g.travel) * g.maxOffset : 0;
-			stage.scrollTo(vertical ? { top: want } : { left: want });
-			beginDrag(g.thumbLen / 2, want);
-			return;
-		}
-		const dir = p < g.thumbPos ? -1 : 1;
-		const step = () => {
-			const live = liveGeometry();
-			if (dir === 1 ? lastPtr.current <= live.thumbPos + live.thumbLen : lastPtr.current >= live.thumbPos) return stopPaging();
-			stage.scrollBy(vertical ? { top: dir * live.client * .9 } : { left: dir * live.client * .9 });
-		};
-		step();
-		const timer = window.setTimeout(() => {
-			if (!pageRef.current) return;
-			pageRef.current.timer = window.setInterval(step, 80);
-		}, 350);
-		pageRef.current = {
-			dir,
-			timer
-		};
-	};
-	const onMove = (e) => {
-		const d = dragRef.current;
-		if (d) {
-			if (d.travel <= 0) return;
-			const want = clamp01((ptrPos(e) - d.grab) / d.travel) * d.max;
-			const delta = want - d.applied;
-			if (delta) {
-				stage.panBy(vertical ? 0 : -delta, vertical ? -delta : 0);
-				d.applied = want;
-			}
-		} else if (pageRef.current) lastPtr.current = ptrPos(e);
-	};
-	(0, react.useEffect)(() => endDrag, []);
-	if (!scrollable) return null;
-	const trackDefaults = vertical ? {
-		position: "absolute",
-		top: 0,
-		right: 0,
-		bottom: 0,
-		width: 12
-	} : {
-		position: "absolute",
-		left: 0,
-		right: 0,
-		bottom: 0,
-		height: 12
-	};
-	const thumbDefaults = vertical ? {
-		position: "absolute",
-		left: 2,
-		right: 2,
-		top: g.thumbPos,
-		height: g.thumbLen
-	} : {
-		position: "absolute",
-		top: 2,
-		bottom: 2,
-		left: g.thumbPos,
-		width: g.thumbLen
-	};
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		ref: trackRef,
-		role: "scrollbar",
-		"aria-orientation": vertical ? "vertical" : "horizontal",
-		"aria-valuemin": 0,
-		"aria-valuemax": Math.round(g.maxOffset),
-		"aria-valuenow": Math.round(g.offset),
-		"data-embedpdf-scrollbar": "",
-		"data-axis": axis,
-		"data-state": shown ? "visible" : "hidden",
-		"data-dragging": dragging ? "" : void 0,
-		className,
-		style: {
-			...trackDefaults,
-			touchAction: "none",
-			userSelect: "none",
-			opacity: shown ? 1 : 0,
-			transition: "opacity 200ms",
-			pointerEvents: shown ? "auto" : "none",
-			...style
-		},
-		onPointerDown: onTrackDown,
-		onPointerMove: onMove,
-		onPointerUp: endDrag,
-		onPointerCancel: endDrag,
-		onPointerEnter: () => setHovered(true),
-		onPointerLeave: () => setHovered(false),
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			"data-embedpdf-scrollbar-thumb": "",
-			className: thumbClassName,
-			style: {
-				...thumbDefaults,
-				borderRadius: 6,
-				background: "var(--epdf-scrollbar-thumb, rgba(0, 0, 0, 0.4))",
-				...thumbStyle
-			},
-			onPointerDown: onThumbDown
-		})
-	});
-}
-//#endregion
-exports.Scrollbar = Scrollbar;
-exports.useScrollMetrics = useScrollMetrics;
-
-//# sourceMappingURL=scrollbar.cjs.map

package/dist/scrollbar.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"scrollbar.cjs","names":["StageToken","useSelector","useCapability"],"sources":["../src/scrollbar.tsx"],"sourcesContent":["/**\n * Headless scrollbar for a Stage lens — a pure view of `stage.scrollMetrics()`.\n *\n * The Stage exposes the native scroller contract (scrollTop/scrollHeight/\n * clientHeight, in screen px — see plugin-stage's README); this component turns\n * it into a native-feeling bar: thumb drag with pointer capture and a preserved\n * grab point, track paging with press-and-hold repeat that stops at the\n * pointer, a minimum thumb length on long documents, and macOS-style overlay\n * auto-hide. On an UNBOUNDED stage the metrics already carry the Figma\n * semantics (the range is the union of content and view), so the same bar\n * shrinks toward the edge as you pan away and rides you back — the mapping is\n * FROZEN for the duration of a thumb drag so the thumb never chases itself\n * while the union re-collapses.\n *\n * Headless styling contract: geometry and behavior live here; looks live in\n * your CSS. Style via `className`/`thumbClassName` (or the style props) against\n *   [data-embedpdf-scrollbar][data-axis=\"y\"][data-state=\"visible|hidden\"]\n *   [data-embedpdf-scrollbar][data-dragging]\n *   [data-embedpdf-scrollbar-thumb]\n * The defaults are deliberately minimal: a transparent track pinned to the\n * viewport edge and a `var(--epdf-scrollbar-thumb, …)` pill, so the bar works\n * unstyled and disappears into any theme. Build something else entirely\n * (minimap, progress ring) from `useScrollMetrics()` + `stage.scrollTo()`.\n */\n\nimport * as React from 'react';\nimport { useEffect, useRef, useState } from 'react';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\nimport type { ScrollMetrics, StageCapability } from '@embedpdf/plugin-stage/contract';\nimport type { CapabilityToken } from '@embedpdf/core';\nimport { useCapability, useSelector } from './runtime';\n\nexport type ScrollbarAxis = 'x' | 'y';\n\n/** Live scroll metrics for a stage lens (reference-stable; see\n *  `StageCapability.scrollMetrics`). The raw material for custom scroll UI. */\nexport function useScrollMetrics(\n  token: CapabilityToken<StageCapability> = StageToken,\n): ScrollMetrics {\n  return useSelector(token, (c) => c.scrollMetrics());\n}\n\nexport interface ScrollbarProps {\n  axis: ScrollbarAxis;\n  /** The stage lens to scroll (default: the main StageToken). */\n  token?: CapabilityToken<StageCapability>;\n  /**\n   * Overlay auto-hide: fade `autoHide` ms after the camera stops moving\n   * (drags and hover pin it visible; a hidden bar ignores the pointer, like\n   * macOS). `false` = always visible. Visibility is published as\n   * `data-state=\"visible|hidden\"` — the default style fades opacity; replace\n   * it in CSS for any other treatment. Default 1200.\n   */\n  autoHide?: number | false;\n  /** Minimum thumb length in px — native bars never vanish on long documents.\n   *  Position stays proportional via the standard travel remap. Default 24. */\n  minThumbSize?: number;\n  /**\n   * Pressing the track: 'page' steps by 90% of a viewport toward the pointer,\n   * repeats while held, and stops when the thumb reaches the pointer (the\n   * native default); 'jump' centers the thumb at the pointer and hands off to\n   * a drag (the macOS option-click / Figma feel). Default 'page'.\n   */\n  trackPress?: 'page' | 'jump';\n  /** Track class/style. The default style pins the bar to the right (y) or\n   *  bottom (x) edge of the nearest positioned ancestor — the Stage container\n   *  when rendered in its `overlay`; override to place it anywhere else. */\n  className?: string;\n  style?: React.CSSProperties;\n  thumbClassName?: string;\n  thumbStyle?: React.CSSProperties;\n}\n\nconst clamp01 = (v: number) => Math.min(1, Math.max(0, v));\n\n/** Best-effort pointer capture: an already-released pointer (pen/touch races,\n *  synthetic events in tests) throws NotFoundError — the press must still work,\n *  just without capture (moves keep arriving while the pointer stays on us). */\nconst capturePointer = (el: Element, pointerId: number) => {\n  try {\n    el.setPointerCapture(pointerId);\n  } catch {\n    /* uncaptured is fine */\n  }\n};\n\n/** Thumb geometry from metrics + a measured track. One formula for render,\n *  drag capture, and paging — they can never disagree. */\nconst geometry = (m: ScrollMetrics, vertical: boolean, trackPx: number, minThumbSize: number) => {\n  const client = vertical ? m.clientHeight : m.clientWidth;\n  const total = vertical ? m.scrollHeight : m.scrollWidth;\n  const offset = vertical ? m.scrollTop : m.scrollLeft;\n  const maxOffset = Math.max(0, total - client);\n  const thumbLen = Math.min(\n    trackPx,\n    Math.max(minThumbSize, total > 0 ? (client / total) * trackPx : 0),\n  );\n  const travel = Math.max(0, trackPx - thumbLen);\n  const thumbPos = maxOffset > 0 ? (offset / maxOffset) * travel : 0;\n  return { client, offset, maxOffset, thumbLen, travel, thumbPos };\n};\n\nexport function Scrollbar({\n  axis,\n  token = StageToken,\n  autoHide = 1200,\n  minThumbSize = 24,\n  trackPress = 'page',\n  className,\n  style,\n  thumbClassName,\n  thumbStyle,\n}: ScrollbarProps) {\n  const stage = useCapability(token);\n  const m = useScrollMetrics(token);\n  const vertical = axis === 'y';\n  const scrollable = vertical ? m.scrollableY : m.scrollableX;\n\n  const trackRef = useRef<HTMLDivElement>(null);\n  const [trackPx, setTrackPx] = useState(0);\n  const [dragging, setDragging] = useState(false);\n  const [hovered, setHovered] = useState(false);\n  const [active, setActive] = useState(true); // camera moved recently\n\n  const g = geometry(m, vertical, trackPx, minThumbSize);\n\n  // ── overlay auto-hide: any metrics change re-arms the fade timer ──────────\n  const hideAfter = autoHide === false ? 0 : autoHide;\n  useEffect(() => {\n    if (!hideAfter) return;\n    setActive(true);\n    const t = setTimeout(() => setActive(false), hideAfter);\n    return () => clearTimeout(t);\n  }, [m, hideAfter]);\n  const shown = !hideAfter || active || hovered || dragging;\n\n  // ── track measurement (px mapping needs real geometry) ────────────────────\n  useEffect(() => {\n    const el = trackRef.current;\n    if (!el) return;\n    const measure = () => setTrackPx(vertical ? el.clientHeight : el.clientWidth);\n    const ro = new ResizeObserver(measure);\n    ro.observe(el);\n    measure();\n    return () => ro.disconnect();\n  }, [vertical, scrollable]);\n\n  // ── interactions. Drag state is FROZEN at pointer-down (grab point, travel,\n  //    max offset) and applied as relative pans — absolute-feeling in bounded\n  //    mode (the range is static there) and stable in unbounded mode, where\n  //    the live union would otherwise shift under the pointer mid-drag. ──────\n  const dragRef = useRef<{ grab: number; applied: number; max: number; travel: number } | null>(\n    null,\n  );\n  const pageRef = useRef<{ dir: 1 | -1; timer: number } | null>(null);\n  const lastPtr = useRef(0);\n\n  const ptrPos = (e: React.PointerEvent) => {\n    const r = trackRef.current!.getBoundingClientRect();\n    return vertical ? e.clientY - r.top : e.clientX - r.left;\n  };\n  /** Fresh geometry for paging steps — read from the capability, never a stale render. */\n  const liveGeometry = () => geometry(stage.scrollMetrics(), vertical, trackPx, minThumbSize);\n\n  const stopPaging = () => {\n    if (pageRef.current) {\n      clearTimeout(pageRef.current.timer);\n      clearInterval(pageRef.current.timer);\n      pageRef.current = null;\n    }\n  };\n  const endDrag = () => {\n    dragRef.current = null;\n    stopPaging();\n    setDragging(false);\n  };\n\n  const beginDrag = (grab: number, applied: number) => {\n    dragRef.current = { grab, applied, max: g.maxOffset, travel: g.travel };\n    setDragging(true);\n  };\n\n  const onThumbDown = (e: React.PointerEvent) => {\n    if (e.button !== 0) return;\n    e.preventDefault();\n    e.stopPropagation();\n    capturePointer(e.target as Element, e.pointerId);\n    beginDrag(ptrPos(e) - g.thumbPos, g.offset);\n  };\n\n  const onTrackDown = (e: React.PointerEvent) => {\n    if (e.button !== 0 || e.target !== e.currentTarget) return; // thumb handles its own\n    e.preventDefault();\n    capturePointer(e.currentTarget as Element, e.pointerId);\n    const p = (lastPtr.current = ptrPos(e));\n\n    if (trackPress === 'jump') {\n      // land the thumb centered at the pointer, then it's an ordinary drag\n      const want = g.travel > 0 ? clamp01((p - g.thumbLen / 2) / g.travel) * g.maxOffset : 0;\n      stage.scrollTo(vertical ? { top: want } : { left: want });\n      beginDrag(g.thumbLen / 2, want);\n      return;\n    }\n\n    // 'page': step toward the pointer, repeat while held, stop at the pointer\n    const dir: 1 | -1 = p < g.thumbPos ? -1 : 1;\n    const step = () => {\n      const live = liveGeometry();\n      const reached =\n        dir === 1\n          ? lastPtr.current <= live.thumbPos + live.thumbLen\n          : lastPtr.current >= live.thumbPos;\n      if (reached) return stopPaging();\n      stage.scrollBy(\n        vertical ? { top: dir * live.client * 0.9 } : { left: dir * live.client * 0.9 },\n      );\n    };\n    step();\n    // native cadence: a beat before the repeat kicks in, then a steady march\n    const timer = window.setTimeout(() => {\n      if (!pageRef.current) return;\n      pageRef.current.timer = window.setInterval(step, 80);\n    }, 350);\n    pageRef.current = { dir, timer };\n  };\n\n  // Pointer capture retargets to the pressed element and bubbles here — one\n  // move/up pair serves thumb drags, jump-drags, and paging alike.\n  const onMove = (e: React.PointerEvent) => {\n    const d = dragRef.current;\n    if (d) {\n      if (d.travel <= 0) return;\n      const want = clamp01((ptrPos(e) - d.grab) / d.travel) * d.max;\n      const delta = want - d.applied;\n      if (delta) {\n        stage.panBy(vertical ? 0 : -delta, vertical ? -delta : 0);\n        d.applied = want;\n      }\n    } else if (pageRef.current) {\n      lastPtr.current = ptrPos(e);\n    }\n  };\n\n  useEffect(() => endDrag, []); // unmount: no orphaned repeat timers\n\n  if (!scrollable) return null;\n\n  const trackDefaults: React.CSSProperties = vertical\n    ? { position: 'absolute', top: 0, right: 0, bottom: 0, width: 12 }\n    : { position: 'absolute', left: 0, right: 0, bottom: 0, height: 12 };\n  const thumbDefaults: React.CSSProperties = vertical\n    ? { position: 'absolute', left: 2, right: 2, top: g.thumbPos, height: g.thumbLen }\n    : { position: 'absolute', top: 2, bottom: 2, left: g.thumbPos, width: g.thumbLen };\n\n  return (\n    <div\n      ref={trackRef}\n      role=\"scrollbar\"\n      aria-orientation={vertical ? 'vertical' : 'horizontal'}\n      aria-valuemin={0}\n      aria-valuemax={Math.round(g.maxOffset)}\n      aria-valuenow={Math.round(g.offset)}\n      data-embedpdf-scrollbar=\"\"\n      data-axis={axis}\n      data-state={shown ? 'visible' : 'hidden'}\n      data-dragging={dragging ? '' : undefined}\n      className={className}\n      style={{\n        ...trackDefaults,\n        touchAction: 'none',\n        userSelect: 'none',\n        opacity: shown ? 1 : 0,\n        transition: 'opacity 200ms',\n        // a hidden overlay bar must not eat the clicks under it\n        pointerEvents: shown ? 'auto' : 'none',\n        ...style,\n      }}\n      onPointerDown={onTrackDown}\n      onPointerMove={onMove}\n      onPointerUp={endDrag}\n      onPointerCancel={endDrag}\n      onPointerEnter={() => setHovered(true)}\n      onPointerLeave={() => setHovered(false)}\n    >\n      <div\n        data-embedpdf-scrollbar-thumb=\"\"\n        className={thumbClassName}\n        style={{\n          ...thumbDefaults,\n          borderRadius: 6,\n          background: 'var(--epdf-scrollbar-thumb, rgba(0, 0, 0, 0.4))',\n          ...thumbStyle,\n        }}\n        onPointerDown={onThumbDown}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/scrollbar.d.cts

@@ -1,42 +0,0 @@
-import * as React from "react";
-import { CapabilityToken } from "@embedpdf/core";
-import { ScrollMetrics, StageCapability } from "@embedpdf/plugin-stage/contract";
-//#region src/scrollbar.d.ts
-type ScrollbarAxis = 'x' | 'y';
-/** Live scroll metrics for a stage lens (reference-stable; see
- *  `StageCapability.scrollMetrics`). The raw material for custom scroll UI. */
-declare function useScrollMetrics(token?: CapabilityToken<StageCapability>): ScrollMetrics;
-interface ScrollbarProps {
-  axis: ScrollbarAxis;
-  /** The stage lens to scroll (default: the main StageToken). */
-  token?: CapabilityToken<StageCapability>;
-  /**
-   * Overlay auto-hide: fade `autoHide` ms after the camera stops moving
-   * (drags and hover pin it visible; a hidden bar ignores the pointer, like
-   * macOS). `false` = always visible. Visibility is published as
-   * `data-state="visible|hidden"` — the default style fades opacity; replace
-   * it in CSS for any other treatment. Default 1200.
-   */
-  autoHide?: number | false;
-  /** Minimum thumb length in px — native bars never vanish on long documents.
-   *  Position stays proportional via the standard travel remap. Default 24. */
-  minThumbSize?: number;
-  /**
-   * Pressing the track: 'page' steps by 90% of a viewport toward the pointer,
-   * repeats while held, and stops when the thumb reaches the pointer (the
-   * native default); 'jump' centers the thumb at the pointer and hands off to
-   * a drag (the macOS option-click / Figma feel). Default 'page'.
-   */
-  trackPress?: 'page' | 'jump';
-  /** Track class/style. The default style pins the bar to the right (y) or
-   *  bottom (x) edge of the nearest positioned ancestor — the Stage container
-   *  when rendered in its `overlay`; override to place it anywhere else. */
-  className?: string;
-  style?: React.CSSProperties;
-  thumbClassName?: string;
-  thumbStyle?: React.CSSProperties;
-}
-declare function Scrollbar({ axis, token, autoHide, minThumbSize, trackPress, className, style, thumbClassName, thumbStyle }: ScrollbarProps): import("react/jsx-runtime").JSX.Element | null;
-//#endregion
-export { Scrollbar, ScrollbarAxis, ScrollbarProps, useScrollMetrics };
-//# sourceMappingURL=scrollbar.d.cts.map

package/dist/scrollbar.d.ts

@@ -1,42 +0,0 @@
-import { CapabilityToken } from "@embedpdf/core";
-import * as React from "react";
-import { ScrollMetrics, StageCapability } from "@embedpdf/plugin-stage/contract";
-//#region src/scrollbar.d.ts
-type ScrollbarAxis = 'x' | 'y';
-/** Live scroll metrics for a stage lens (reference-stable; see
- *  `StageCapability.scrollMetrics`). The raw material for custom scroll UI. */
-declare function useScrollMetrics(token?: CapabilityToken<StageCapability>): ScrollMetrics;
-interface ScrollbarProps {
-  axis: ScrollbarAxis;
-  /** The stage lens to scroll (default: the main StageToken). */
-  token?: CapabilityToken<StageCapability>;
-  /**
-   * Overlay auto-hide: fade `autoHide` ms after the camera stops moving
-   * (drags and hover pin it visible; a hidden bar ignores the pointer, like
-   * macOS). `false` = always visible. Visibility is published as
-   * `data-state="visible|hidden"` — the default style fades opacity; replace
-   * it in CSS for any other treatment. Default 1200.
-   */
-  autoHide?: number | false;
-  /** Minimum thumb length in px — native bars never vanish on long documents.
-   *  Position stays proportional via the standard travel remap. Default 24. */
-  minThumbSize?: number;
-  /**
-   * Pressing the track: 'page' steps by 90% of a viewport toward the pointer,
-   * repeats while held, and stops when the thumb reaches the pointer (the
-   * native default); 'jump' centers the thumb at the pointer and hands off to
-   * a drag (the macOS option-click / Figma feel). Default 'page'.
-   */
-  trackPress?: 'page' | 'jump';
-  /** Track class/style. The default style pins the bar to the right (y) or
-   *  bottom (x) edge of the nearest positioned ancestor — the Stage container
-   *  when rendered in its `overlay`; override to place it anywhere else. */
-  className?: string;
-  style?: React.CSSProperties;
-  thumbClassName?: string;
-  thumbStyle?: React.CSSProperties;
-}
-declare function Scrollbar({ axis, token, autoHide, minThumbSize, trackPress, className, style, thumbClassName, thumbStyle }: ScrollbarProps): import("react/jsx-runtime").JSX.Element | null;
-//#endregion
-export { Scrollbar, ScrollbarAxis, ScrollbarProps, useScrollMetrics };
-//# sourceMappingURL=scrollbar.d.ts.map