@react-three/fiber 10.0.0-canary.de17310 → 10.0.0-canary.e53bd54

package/dist/extension.d.ts

@@ -1,555 +1,13 @@
-import * as React from 'react';
-import * as THREE from 'three';
-import { WebGPURenderer, CanvasTarget } from 'three/webgpu';
-import { StoreApi } from 'zustand';
-import { UseBoundStoreWithEqualityFn } from 'zustand/traditional';
-import { FrameCallback as FrameCallback$1, FrameTimingState, SchedulerApi, UseFrameNextOptions, FrameNextControls } from '@pmndrs/scheduler';
+import { z as FrameNextCallback } from './shared/fiber.Bw8YnGg5.js';
+export { A as Act, B as Bridge, C as Camera, i as ComputeFunction, w as Disposable, f as DomEvent, D as Dpr, v as EquConfig, g as EventHandlers, k as EventManager, E as Events, h as FilterFunction, G as FrameCallback, x as FrameNextState, y as FrameState, F as Frameloop, a5 as InternalState, I as Intersection, e as IntersectionEvent, p as IsAllOptional, o as IsOptional, M as Mutable, N as NonFunctionKeys, u as ObjectMap, O as Overwrite, c as Performance, l as PointerCaptureTarget, P as PointerState, n as Properties, a4 as R3FRenderer, b as RenderCallback, R as RootExtension, a6 as RootState, d as RootStore, t as SetBlock, a as Size, S as Subscription, q as ThreeCamera, T as ThreeEvent, U as UnblockProps, V as Viewport, m as VisibilityEntry, X as XRManager, j as XRPointerConfig, a3 as context, r as registerRootExtension, s as setRenderOverride, a2 as useStore, a7 as useThree } from './shared/fiber.Bw8YnGg5.js';
+import { UseFrameNextOptions, FrameNextControls } from '@pmndrs/scheduler';
 export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, SchedulerApi, UseFrameNextOptions, UseFrameOptions } from '@pmndrs/scheduler';
-
-//* Utility Types ==============================
-
-type NonFunctionKeys<P> = { [K in keyof P]-?: P[K] extends Function ? never : K }[keyof P]
-type Overwrite<P, O> = Omit<P, NonFunctionKeys<O>> & O
-type Properties<T> = Pick<T, NonFunctionKeys<T>>
-type Mutable<P> = { -readonly [K in keyof P]: P[K] }
-type IsOptional<T> = undefined extends T ? true : false
-type IsAllOptional<T extends any[]> = T extends [infer First, ...infer Rest]
-  ? IsOptional<First> extends true
-    ? IsAllOptional<Rest>
-    : false
-  : true
-
-//* Camera Types ==============================
-
-type ThreeCamera = (THREE.OrthographicCamera | THREE.PerspectiveCamera) & { manual?: boolean }
-
-//* Act Type ==============================
-
-type Act = <T = any>(cb: () => Promise<T>) => Promise<T>
-
-//* Bridge & Block Types ==============================
-
-type Bridge = React.FC<{ children?: React.ReactNode }>
-
-type SetBlock = false | Promise<null> | null
-type UnblockProps = { set: React.Dispatch<React.SetStateAction<SetBlock>>; children: React.ReactNode }
-
-//* Object Map Type ==============================
-
-/* Original version
-export interface ObjectMap {
-  nodes: { [name: string]: THREE.Object3D }
-  materials: { [name: string]: THREE.Material }
-  meshes: { [name: string]: THREE.Mesh }
-}
-*/
-/* This version is an expansion found in a PR by itsdouges that seems abandoned but looks useful.
-It allows expansion but falls back to the original shape. (deleted due to stale, but If it doesnt conflict
-I will keep the use here)
-https://github.com/pmndrs/react-three-fiber/commits/generic-object-map/
-His description is:
-The object map type is now generic and can optionally declare the available properties for nodes, materials, and meshes.
-*/
-interface ObjectMap<
-  T extends { nodes?: string; materials?: string; meshes?: string } = {
-    nodes: string
-    materials: string
-    meshes: string
-  },
-> {
-  nodes: Record<T['nodes'] extends string ? T['nodes'] : string, THREE.Object3D>
-  materials: Record<T['materials'] extends string ? T['materials'] : string, THREE.Material>
-  meshes: Record<T['meshes'] extends string ? T['meshes'] : string, THREE.Mesh>
-}
-
-//* Equality Config ==============================
-
-interface EquConfig {
-  /** Compare arrays by reference equality a === b (default), or by shallow equality */
-  arrays?: 'reference' | 'shallow'
-  /** Compare objects by reference equality a === b (default), or by shallow equality */
-  objects?: 'reference' | 'shallow'
-  /** If true the keys in both a and b must match 1:1 (default), if false a's keys must intersect b's */
-  strict?: boolean
-}
-
-//* Disposable Type ==============================
-
-interface Disposable {
-  type?: string
-  dispose?: () => void
-}
-
-//* Event-related Types =====================================
-
-interface Intersection extends THREE.Intersection {
-  /** The event source (the object which registered the handler) */
-  eventObject: THREE.Object3D
-}
-
-type Camera = THREE.OrthographicCamera | THREE.PerspectiveCamera
-
-interface IntersectionEvent<TSourceEvent> extends Intersection {
-  /** The event source (the object which registered the handler) */
-  eventObject: THREE.Object3D
-  /** An array of intersections */
-  intersections: Intersection[]
-  /** vec3.set(pointer.x, pointer.y, 0).unproject(camera) */
-  unprojectedPoint: THREE.Vector3
-  /** Normalized event coordinates */
-  pointer: THREE.Vector2
-  /** pointerId of the original event for multiple pointer events */
-  pointerId: number
-  /** Delta between first click and this event */
-  delta: number
-  /** The ray that pierced it */
-  ray: THREE.Ray
-  /** The camera that was used by the raycaster */
-  camera: Camera
-  /** stopPropagation will stop underlying handlers from firing */
-  stopPropagation: () => void
-  /** The original host event */
-  nativeEvent: TSourceEvent
-  /** If the event was stopped by calling stopPropagation */
-  stopped: boolean
-}
-
-type ThreeEvent<TEvent> = IntersectionEvent<TEvent> & Properties<TEvent>
-type DomEvent = PointerEvent | MouseEvent | WheelEvent
-
-/** DOM event handlers registered on the canvas element */
-interface Events {
-  onClick: EventListener
-  onContextMenu: EventListener
-  onDoubleClick: EventListener
-  onWheel: EventListener
-  onPointerDown: EventListener
-  onPointerUp: EventListener
-  onPointerLeave: EventListener
-  onPointerMove: EventListener
-  onPointerCancel: EventListener
-  onLostPointerCapture: EventListener
-  onDragEnter: EventListener
-  onDragLeave: EventListener
-  onDragOver: EventListener
-  onDrop: EventListener
-}
-
-/** Event handlers that can be attached to R3F objects (meshes, groups, etc.) */
-interface EventHandlers {
-  onClick?: (event: ThreeEvent<MouseEvent>) => void
-  onContextMenu?: (event: ThreeEvent<MouseEvent>) => void
-  onDoubleClick?: (event: ThreeEvent<MouseEvent>) => void
-  /** Fires continuously while dragging over the object */
-  onDragOver?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires once when drag enters the object */
-  onDragOverEnter?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires once when drag leaves the object */
-  onDragOverLeave?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires when drag misses this object (for objects that have drag handlers) */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** Fires when a drop occurs on this object */
-  onDrop?: (event: ThreeEvent<DragEvent>) => void
-  /** Fires when a drop misses this object (for objects that have drop handlers) */
-  onDropMissed?: (event: DragEvent) => void
-  onPointerUp?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerDown?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerOver?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerOut?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerEnter?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerLeave?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerMove?: (event: ThreeEvent<PointerEvent>) => void
-  onPointerMissed?: (event: MouseEvent) => void
-  onPointerCancel?: (event: ThreeEvent<PointerEvent>) => void
-  onWheel?: (event: ThreeEvent<WheelEvent>) => void
-  onLostPointerCapture?: (event: ThreeEvent<PointerEvent>) => void
-
-  //* Visibility Events --------------------------------
-  /** Fires when object enters/exits camera frustum. Receives true when in view, false when out. */
-  onFramed?: (inView: boolean) => void
-  /** Fires when object occlusion state changes (WebGPU only, requires occlusionTest=true on object) */
-  onOccluded?: (occluded: boolean) => void
-  /** Fires when combined visibility changes (frustum + occlusion + visible prop) */
-  onVisible?: (visible: boolean) => void
-}
-
-type FilterFunction = (items: THREE.Intersection[], state: RootState) => THREE.Intersection[]
-type ComputeFunction = (event: DomEvent, root: RootState, previous?: RootState) => void
-
-/** Configuration for XR pointer registration (controllers/hands) */
-interface XRPointerConfig {
-  /** Ray origin (updated each frame by XR system) */
-  ray: THREE.Ray
-  /** Optional: custom compute function for this pointer */
-  compute?: (state: RootState) => void
-  /** Pointer type identifier */
-  type: 'controller' | 'hand' | 'gaze'
-  /** Which hand (for controller/hand types) */
-  handedness?: 'left' | 'right'
-}
-
-interface EventManager<TTarget> {
-  /** Determines if the event layer is active */
-  enabled: boolean
-  /** Event layer priority, higher prioritized layers come first and may stop(-propagate) lower layer  */
-  priority: number
-  /** The compute function needs to set up the raycaster and an xy- pointer  */
-  compute?: ComputeFunction
-  /** The filter can re-order or re-structure the intersections  */
-  filter?: FilterFunction
-  /** The target node the event layer is tied to */
-  connected?: TTarget
-  /** All the pointer event handlers through which the host forwards native events */
-  handlers?: Events
-  /** Allows re-connecting to another target */
-  connect?: (target: TTarget) => void
-  /** Removes all existing events handlers from the target */
-  disconnect?: () => void
-  /** Triggers a onPointerMove with the last known event. This can be useful to enable raycasting without
-   *  explicit user interaction, for instance when the camera moves a hoverable object underneath the cursor.
-   *  @param pointerId - Optional pointer ID to update specific pointer only
-   */
-  update?: (pointerId?: number) => void
-  /** Defer pointer move raycasting to frame start (default: true) */
-  frameTimedRaycasts?: boolean
-  /** Always fire raycaster immediately on scroll events (default: true) */
-  alwaysFireOnScroll?: boolean
-  /** Automatically re-raycast every frame to detect hover changes from moving objects/camera (default: false) */
-  updateOnFrame?: boolean
-  /** Flush deferred pointer raycasts. Called by scheduler at frame start (input phase). */
-  flush?: () => void
-  /** Register an XR pointer (controller/hand). Returns assigned pointerId */
-  registerPointer?: (config: XRPointerConfig) => number
-  /** Unregister an XR pointer */
-  unregisterPointer?: (pointerId: number) => void
-}
-
-interface PointerCaptureTarget {
-  intersection: Intersection
-  target: Element
-}
-
-//* Visibility System Types =====================================
-
-/** Entry in the visibility registry for tracking object visibility state */
-interface VisibilityEntry {
-  object: THREE.Object3D
-  handlers: Pick<EventHandlers, 'onFramed' | 'onOccluded' | 'onVisible'>
-  lastFramedState: boolean | null
-  lastOccludedState: boolean | null
-  lastVisibleState: boolean | null
-}
-
-//* Scheduler Types (useFrame) ==============================
-//
-// The generic, framework-agnostic scheduler types now live in @pmndrs/scheduler.
-// This file re-exports them and layers r3f's RootState-aware frame state on top,
-// so existing `#types` imports across the codebase keep resolving unchanged.
-
-
-
-// Frame State (r3f-specific) --------------------------------
-
-/**
- * State passed to useFrame callbacks (extends RootState with timing).
- */
-interface FrameNextState extends RootState, FrameTimingState {}
-
-/** Alias for FrameNextState */
-type FrameState = FrameNextState
-
-// Callback Types (r3f-specific) --------------------------------
-
-/**
- * Callback function for useFrame. Receives the full r3f RootState plus timing.
- */
-type FrameNextCallback = FrameCallback$1<RootState>
-
-/** Alias for FrameNextCallback */
-type FrameCallback = FrameNextCallback
-
-//* Renderer Types ========================================
-
-/** Default renderer type - union of WebGL and WebGPU renderers */
-type R3FRenderer = THREE.WebGLRenderer | WebGPURenderer
-
-//* Core Store Types ========================================
-
-type Subscription = {
-  ref: React.RefObject<RenderCallback>
-  priority: number
-  store: RootStore
-}
-
-/** Per-pointer state for multi-touch and XR support */
-type PointerState = {
-  /** Objects currently hovered by this pointer */
-  hovered: Map<string, ThreeEvent<DomEvent>>
-  /** Objects capturing this pointer */
-  captured: Map<THREE.Object3D, PointerCaptureTarget>
-  /** Initial click position [x, y] */
-  initialClick: [x: number, y: number]
-  /** Objects hit on initial click */
-  initialHits: THREE.Object3D[]
-}
-
-type Dpr = number | [min: number, max: number]
-
-interface Size {
-  width: number
-  height: number
-  top: number
-  left: number
-}
-
-type Frameloop = 'always' | 'demand' | 'never'
-
-interface Viewport extends Size {
-  /** The initial pixel ratio */
-  initialDpr: number
-  /** Current pixel ratio */
-  dpr: number
-  /** size.width / viewport.width */
-  factor: number
-  /** Camera distance */
-  distance: number
-  /** Camera aspect ratio: width / height */
-  aspect: number
-}
-
-type RenderCallback = (state: RootState, delta: number, frame?: XRFrame) => void
-
-interface Performance {
-  /** Current performance normal, between min and max */
-  current: number
-  /** How low the performance can go, between 0 and max */
-  min: number
-  /** How high the performance can go, between min and max */
-  max: number
-  /** Time until current returns to max in ms */
-  debounce: number
-  /** Sets current to min, puts the system in regression */
-  regress: () => void
-}
-
-interface InternalState {
-  interaction: THREE.Object3D[]
-  subscribers: Subscription[]
-  /** Per-pointer state (hover, capture, click tracking) - replaces hovered, capturedMap, initialClick, initialHits */
-  pointerMap: Map<number, PointerState>
-  /** Pointers needing raycast this frame (used with frameTimedRaycasts) */
-  pointerDirty: Map<number, DomEvent>
-  /** Last event received (for events.update() compatibility) */
-  lastEvent: React.RefObject<DomEvent | null>
-  /** @deprecated Use pointerMap.get(pointerId).hovered instead */
-  hovered: Map<string, ThreeEvent<DomEvent>>
-  /** @deprecated Use pointerMap.get(pointerId).captured instead */
-  capturedMap: Map<number, Map<THREE.Object3D, PointerCaptureTarget>>
-  /** @deprecated Use pointerMap.get(pointerId).initialClick instead */
-  initialClick: [x: number, y: number]
-  /** @deprecated Use pointerMap.get(pointerId).initialHits instead */
-  initialHits: THREE.Object3D[]
-  /** Visibility event registry (onFramed, onOccluded, onVisible) */
-  visibilityRegistry: Map<string, VisibilityEntry>
-  /** Whether occlusion queries are enabled (WebGPU only) */
-  occlusionEnabled: boolean
-  /** Reference to the invisible occlusion observer mesh */
-  occlusionObserver: THREE.Mesh | null
-  /** Cached occlusion results from render pass - keyed by Object3D */
-  occlusionCache: Map<THREE.Object3D, boolean | null>
-  /** Internal helper group for R3F system objects (occlusion observer, etc.) */
-  helperGroup: THREE.Group | null
-  active: boolean
-  priority: number
-  frames: number
-  subscribe: (callback: React.RefObject<RenderCallback>, priority: number, store: RootStore) => () => void
-  /** Internal renderer storage - use state.renderer or state.gl to access */
-  actualRenderer: R3FRenderer
-  /** Global scheduler reference (for useFrame hook) */
-  scheduler: SchedulerApi | null
-  /**
-   * Replaces `renderer.render(scene, camera)` in the default render job when set. Set it with
-   * `setRenderOverride(store, fn)`; the job keeps its fps throttle, error handling and user
-   * render-phase takeover. Used by `useRenderPipeline`.
-   */
-  renderOverride?: (() => void) | null
-  /** This root's unique ID in the global scheduler */
-  rootId?: string
-  /** Function to unregister this root from the global scheduler */
-  unregisterRoot?: () => void
-  /** Container for child attachment (scene for root, original container for portals) */
-  container?: THREE.Object3D
-  /**
-   * The CanvasTarget this root sizes and renders through.
-   *
-   * A primary (`<Canvas id>`) owns the renderer's default target -- the one three itself built
-   * around the canvas element -- so sizing it is sizing the renderer. A secondary owns a target
-   * R3F created for its own element. Either way there is exactly one target per canvas element,
-   * and the canvas-target job makes it the renderer's active one before this root renders.
-   * Absent on WebGL and on an id-less WebGPU canvas, where the renderer is sized directly.
-   * @see https://threejs.org/docs/#api/en/renderers/common/CanvasTarget
-   */
-  canvasTarget?: CanvasTarget
-  /**
-   * Set when this root's canvas target has been resized and the backend's cached render pass
-   * descriptor (which holds a depth-stencil view built once per canvas) is therefore stale.
-   *
-   * Flushed by the canvas-target job in the `start` phase, which is the only place this root's
-   * target is guaranteed to be the renderer's active one — `backend.updateSize()` operates on
-   * whatever `getCanvasTarget()` returns, so calling it from the resize subscription would
-   * invalidate some other canvas's descriptor instead.
-   *
-   * @see https://github.com/pmndrs/react-three-fiber/issues/3847
-   */
-  canvasTargetSizeDirty?: boolean
-  /**
-   * Whether multi-canvas rendering is active.
-   * True when any canvas uses `renderer={{ primaryCanvas: 'id' }}` to share a renderer.
-   * When true, setCanvasTarget is called before each render.
-   */
-  isMultiCanvas?: boolean
-  /**
-   * Whether this canvas is a secondary canvas sharing another's renderer.
-   * True when `target` prop is used.
-   */
-  isSecondary?: boolean
-  /**
-   * The id of the primary canvas this secondary canvas targets.
-   * Only set when isSecondary is true.
-   */
-  targetId?: string
-  /**
-   * Function to unregister this primary canvas from the registry.
-   * Only set when this canvas has an `id` prop.
-   */
-  unregisterPrimary?: () => void
-  /** Whether canvas dimensions are forced to even numbers */
-  forceEven?: boolean
-}
-
-interface XRManager {
-  connect: () => void
-  disconnect: () => void
-}
-
-//* Root State Interface ====================================
-
-interface RootState {
-  /** Set current state */
-  set: StoreApi<RootState>['setState']
-  /** Get current state */
-  get: StoreApi<RootState>['getState']
-  /**
-   * The store of the canvas that owns this root's renderer.
-   * - For primary/independent canvases: points to its own store (self-reference)
-   * - For secondary canvases: points to the primary canvas's store
-   * - Portals copy it from their parent
-   *
-   * Anything shared per renderer rather than per canvas (e.g. @react-three/tsl's resources)
-   * resolves through it.
-   */
-  primaryStore: RootStore
-  /** @deprecated Use `renderer` instead. The instance of the renderer (typed as WebGLRenderer for backwards compat) */
-  gl: THREE.WebGLRenderer
-  /** The renderer instance - type depends on entry point (WebGPU, Legacy, or union for default) */
-  renderer: R3FRenderer
-  /** Inspector of the webGPU Renderer. Init in the canvas */
-  inspector: any // Inspector type from three/webgpu
-
-  /** Default camera */
-  camera: ThreeCamera
-  /** Camera frustum for visibility checks - auto-updated each frame when autoUpdateFrustum is true */
-  frustum: THREE.Frustum
-  /** Whether to automatically update the frustum each frame (default: true) */
-  autoUpdateFrustum: boolean
-  /** Default scene (may be overridden in portals to point to the portal container) */
-  scene: THREE.Scene
-  /** The actual root THREE.Scene - always points to the true scene, even inside portals */
-  rootScene: THREE.Scene
-  /** Default raycaster */
-  raycaster: THREE.Raycaster
-  /** Event layer interface, contains the event handler and the node they're connected to */
-  events: EventManager<any>
-  /** XR interface */
-  xr: XRManager
-  /** Currently used controls */
-  controls: THREE.EventDispatcher | null
-  /** Normalized event coordinates */
-  pointer: THREE.Vector2
-  /** @deprecated Normalized event coordinates, use "pointer" instead! */
-  mouse: THREE.Vector2
-  /** Color space assigned to 8-bit input textures (color maps). Most textures are authored in sRGB. */
-  textureColorSpace: THREE.ColorSpace
-  /** Render loop flags */
-  frameloop: Frameloop
-  performance: Performance
-  /** Reactive pixel-size of the canvas */
-  size: Size
-  /** Reactive size of the viewport in threejs units */
-  viewport: Viewport & {
-    getCurrentViewport: (
-      camera?: ThreeCamera,
-      target?: THREE.Vector3 | Parameters<THREE.Vector3['set']>,
-      size?: Size,
-    ) => Omit<Viewport, 'dpr' | 'initialDpr'>
-  }
-  /** Flags the canvas for render, but doesn't render in itself */
-  invalidate: (frames?: number, stackFrames?: boolean) => void
-  /** Advance (render) one step */
-  advance: (timestamp: number, runGlobalEffects?: boolean) => void
-  /** Shortcut to setting the event layer */
-  setEvents: (events: Partial<EventManager<any>>) => void
-  /** Shortcut to manual sizing. No args resets to props/container. Single arg creates square. */
-  setSize: (width?: number, height?: number, top?: number, left?: number) => void
-  /** Shortcut to manual setting the pixel ratio */
-  setDpr: (dpr: Dpr) => void
-  /** Shortcut to setting frameloop flags. No args resets to 'always'. */
-  setFrameloop: (frameloop?: Frameloop) => void
-  /** Set error state to propagate to error boundary */
-  setError: (error: Error | null) => void
-  /** Current error state (null when no error) */
-  error: Error | null
-  /** Global Texture registry (key → Texture, usually keyed by URL) - use useTextures() hook for access + lifecycle */
-  textures: Map<string, THREE.Texture>
-  /** Internal: refcount per texture key, driven by mounted useTexture consumers (registry enrollment is on by default) */
-  _textureRefs: Map<string, number>
-  /** Internal: whether setSize() has taken ownership of canvas dimensions */
-  _sizeImperative: boolean
-  /** Internal: stored size props from Canvas for reset functionality */
-  _sizeProps: { width?: number; height?: number } | null
-  /** When the canvas was clicked but nothing was hit */
-  onPointerMissed?: (event: MouseEvent) => void
-  /** When a dragover event has missed any target */
-  onDragOverMissed?: (event: DragEvent) => void
-  /** When a drop event has missed any target */
-  onDropMissed?: (event: DragEvent) => void
-  /** If this state model is layered (via createPortal) then this contains the previous layer */
-  previousRoot?: RootStore
-  /** Internals */
-  internal: InternalState
-  // flags for triggers
-  // if we are using the webGl renderer, this will be true
-  isLegacy: boolean
-  // regardless of renderer, if the system supports webGpu, this will be true
-  webGPUSupported: boolean
-  //if we are on native
-  isNative: boolean
-}
-
-type RootStore = UseBoundStoreWithEqualityFn<StoreApi<RootState>>
-
-declare const context: React.Context<RootStore>;
-
-/**
- * Returns the R3F Canvas' Zustand store. Useful for [transient updates](https://github.com/pmndrs/zustand#transient-updates-for-often-occurring-state-changes).
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usestore
- */
-declare function useStore(): RootStore;
-/**
- * Accesses R3F's internal state, containing renderer, canvas, scene, etc.
- * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usethree
- */
-declare function useThree<T = RootState>(selector?: (state: RootState) => T, equalityFn?: <T>(state: T, newState: T) => boolean): T;
+import 'react';
+import 'three';
+import 'three/webgpu';
+import 'zustand';
+import 'zustand/traditional';
+import 'three/tsl';
 
 /**
  * Frame hook with phase-based ordering, priority, and FPS throttling.
@@ -595,35 +53,4 @@ declare function useThree<T = RootState>(selector?: (state: RootState) => T, equ
  */
 declare function useFrame(callback?: FrameNextCallback, priorityOrOptions?: number | UseFrameNextOptions): FrameNextControls;
 
-interface RootExtension {
-    /** Unique name. Registering the same name again replaces the entry (HMR-safe); roots it already
-     *  set up are not set up a second time, but get the new entry's dispose and hmr. */
-    name: string;
-    /**
-     * Called once per root, after its renderer exists and before `onCreated` and the first frame.
-     * `isLegacy` and `primaryStore` are known by then, so an extension can skip WebGL roots or defer
-     * to the primary canvas. Return fields to merge into the root's state, or nothing.
-     */
-    setup?(store: RootStore): Partial<RootState> | void;
-    /** Called when a root this extension set up unmounts. */
-    dispose?(store: RootStore): void;
-    /** Called when `<Canvas>` detects hot module replacement (skipped with `hmr={false}`). */
-    hmr?(store: RootStore): void;
-}
-/**
- * Register an extension. It is set up on every live root immediately, and on every root created
- * afterwards. Returns a function that unregisters it: new roots are no longer set up, while roots
- * it already set up keep its state and still get its dispose when they unmount.
- */
-declare function registerRootExtension(extension: RootExtension): () => void;
-/**
- * Point a root's default render job at a different render function, or back at
- * `renderer.render(scene, camera)` with `null`.
- *
- * The default job keeps everything else: the Canvas `fps` throttle, error propagation to the error
- * boundary, and backing off when a user `useFrame(..., { phase: 'render' })` job takes over.
- */
-declare function setRenderOverride(store: RootStore, render: (() => void) | null): void;
-
-export { context, registerRootExtension, setRenderOverride, useFrame, useStore, useThree };
-export type { Act, Bridge, Camera, ComputeFunction, Disposable, DomEvent, Dpr, EquConfig, EventHandlers, EventManager, Events, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Mutable, NonFunctionKeys, ObjectMap, Overwrite, Performance, PointerCaptureTarget, PointerState, Properties, R3FRenderer, RenderCallback, RootExtension, RootState, RootStore, SetBlock, Size, Subscription, ThreeCamera, ThreeEvent, UnblockProps, Viewport, VisibilityEntry, XRManager, XRPointerConfig };
+export { FrameNextCallback, useFrame };