@react-three/fiber 9.4.2 → 10.0.0-alpha.0

package/dist/index.d.cts

@@ -0,0 +1,3350 @@
+import * as three_webgpu from 'three/webgpu';
+import { Node, ShaderNodeObject, Euler as Euler$1, Color as Color$2, ColorRepresentation as ColorRepresentation$1, Layers as Layers$1, Raycaster, Intersection as Intersection$1, Vector2 as Vector2$1, Vector3 as Vector3$1, Vector4 as Vector4$1, Quaternion as Quaternion$1, Matrix3 as Matrix3$1, Matrix4 as Matrix4$1, Object3D, Texture as Texture$1, OrthographicCamera } from 'three/webgpu';
+import * as THREE$1 from 'three';
+import { WebGLRenderer, Color as Color$1, ColorRepresentation } from 'three';
+import { WebGLRendererParameters } from 'three/src/renderers/WebGLRenderer.js';
+import { Inspector } from 'three/addons/inspector/Inspector.js';
+import * as React$1 from 'react';
+import { ReactNode, Component, RefObject, JSX } from 'react';
+import { StoreApi } from 'zustand';
+import { UseBoundStoreWithEqualityFn } from 'zustand/traditional';
+import * as react_reconciler from 'C:\\dev\\react-three-fiber\\node_modules\\.pnpm\\@types+react-reconciler@0.32.3_@types+react@19.2.7\\node_modules\\@types\\react-reconciler\\index.d.ts';
+import { Options } from 'react-use-measure';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+function _mergeNamespaces(n, m) {
+  m.forEach(function (e) {
+    e && typeof e !== 'string' && !Array.isArray(e) && Object.keys(e).forEach(function (k) {
+      if (k !== 'default' && !(k in n)) {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  });
+  return Object.freeze(n);
+}
+
+/**
+ * @fileoverview Internal Three.js re-exports - DEFAULT ENTRY
+ *
+ * This is the single source of truth for Three.js imports within R3F.
+ * All internal code should import from '#three' (or '../three' relative).
+ *
+ * DEFAULT behavior (root import):
+ * - Exports from three/webgpu (the new standard)
+ * - Also exports WebGLRenderer for backwards compatibility (with deprecation)
+ * - Both renderer types available, runtime decides which to use
+ *
+ * For explicit legacy or webgpu-only builds, use:
+ * - #three/legacy - WebGL only, no WebGPU
+ * - #three/webgpu - WebGPU only, no WebGL legacy
+ */
+declare const R3F_BUILD_LEGACY = true;
+declare const R3F_BUILD_WEBGPU = true;
+
+var THREE = /*#__PURE__*/_mergeNamespaces({
+  __proto__: null,
+  Inspector: Inspector,
+  R3F_BUILD_LEGACY: R3F_BUILD_LEGACY,
+  R3F_BUILD_WEBGPU: R3F_BUILD_WEBGPU,
+  WebGLRenderer: WebGLRenderer,
+  WebGLRendererParameters: WebGLRendererParameters
+}, [three_webgpu]);
+
+//* 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> = { [K in keyof P]: P[K] | Readonly<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$1.OrthographicCamera | THREE$1.PerspectiveCamera) & { manual?: boolean }
+
+//* Act Type ==============================
+
+type Act = <T = any>(cb: () => Promise<T>) => Promise<T>
+
+//* Bridge & Block Types ==============================
+
+type Bridge = React$1.FC<{ children?: React$1.ReactNode }>
+
+type SetBlock = false | Promise<null> | null
+type UnblockProps = { set: React$1.Dispatch<React$1.SetStateAction<SetBlock>>; children: React$1.ReactNode }
+
+//* Object Map Type ==============================
+
+interface ObjectMap {
+  nodes: { [name: string]: THREE$1.Object3D }
+  materials: { [name: string]: THREE$1.Material }
+  meshes: { [name: string]: THREE$1.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$1.Intersection {
+  /** The event source (the object which registered the handler) */
+  eventObject: THREE$1.Object3D
+}
+
+type Camera = THREE$1.OrthographicCamera | THREE$1.PerspectiveCamera
+
+interface IntersectionEvent<TSourceEvent> extends Intersection {
+  /** The event source (the object which registered the handler) */
+  eventObject: THREE$1.Object3D
+  /** An array of intersections */
+  intersections: Intersection[]
+  /** vec3.set(pointer.x, pointer.y, 0).unproject(camera) */
+  unprojectedPoint: THREE$1.Vector3
+  /** Normalized event coordinates */
+  pointer: THREE$1.Vector2
+  /** Delta between first click and this event */
+  delta: number
+  /** The ray that pierced it */
+  ray: THREE$1.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
+}
+
+type FilterFunction = (items: THREE$1.Intersection[], state: RootState) => THREE$1.Intersection[]
+type ComputeFunction = (event: DomEvent, root: RootState, previous?: RootState) => void
+
+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.
+   */
+  update?: () => void
+}
+
+interface PointerCaptureTarget {
+  intersection: Intersection
+  target: Element
+}
+
+//* Scheduler Types (useFrame) ==============================
+
+
+
+// Public Options --------------------------------
+
+/**
+ * Options for useFrame hook
+ */
+interface UseFrameNextOptions {
+  /** Optional stable id for the job. Auto-generated if not provided */
+  id?: string
+  /** Named phase to run in. Default: 'update' */
+  phase?: string
+  /** Run before this phase or job id */
+  before?: string | string[]
+  /** Run after this phase or job id */
+  after?: string | string[]
+  /** Priority within phase. Higher runs first. Default: 0 */
+  priority?: number
+  /** Max frames per second for this job */
+  fps?: number
+  /** If true, skip frames when behind. If false, try to catch up. Default: true */
+  drop?: boolean
+  /** Enable/disable without unregistering. Default: true */
+  enabled?: boolean
+}
+
+/** Alias for UseFrameNextOptions */
+type UseFrameOptions = UseFrameNextOptions
+
+/**
+ * Options for addPhase
+ */
+interface AddPhaseOptions {
+  /** Insert this phase before the specified phase */
+  before?: string
+  /** Insert this phase after the specified phase */
+  after?: string
+}
+
+// Frame State --------------------------------
+
+/**
+ * State passed to useFrame callbacks
+ */
+interface FrameNextState extends RootState {
+  /** High-resolution timestamp from RAF (ms) */
+  time: number
+  /** Time since last frame in seconds (for legacy compatibility with THREE.Clock) */
+  delta: number
+  /** Elapsed time since first frame in seconds (for legacy compatibility with THREE.Clock) */
+  elapsed: number
+  /** Incrementing frame counter */
+  frame: number
+}
+
+/** Alias for FrameNextState */
+type FrameState = FrameNextState
+
+// Callback Types --------------------------------
+
+/**
+ * Callback function for useFrame
+ */
+type FrameNextCallback = (state: FrameNextState, delta: number) => void
+
+/** Alias for FrameNextCallback */
+type FrameCallback = FrameNextCallback
+
+// Controls returned from useFrame --------------------------------
+
+/**
+ * Controls object returned from useFrame hook
+ */
+interface FrameNextControls {
+  /** The job's unique ID */
+  id: string
+  /** Access to the global scheduler for frame loop control */
+  scheduler: SchedulerApi
+  /** Manually step this job only (bypasses FPS limiting) */
+  step(timestamp?: number): void
+  /** Manually step ALL jobs in the scheduler */
+  stepAll(timestamp?: number): void
+  /** Pause this job (set enabled=false) */
+  pause(): void
+  /** Resume this job (set enabled=true) */
+  resume(): void
+  /** Reactive paused state - automatically triggers re-render when changed */
+  isPaused: boolean
+}
+
+/** Alias for FrameNextControls */
+type FrameControls = FrameNextControls
+
+// Scheduler Interface --------------------------------
+
+/**
+ * Public interface for the global Scheduler
+ */
+interface SchedulerApi {
+  //* Phase Management --------------------------------
+
+  /** Add a named phase to the scheduler */
+  addPhase(name: string, options?: AddPhaseOptions): void
+  /** Get the ordered list of phase names */
+  readonly phases: string[]
+  /** Check if a phase exists */
+  hasPhase(name: string): boolean
+
+  //* Root Management --------------------------------
+
+  /** Register a root (Canvas) with the scheduler. Returns unsubscribe function. */
+  registerRoot(id: string, getState: () => RootState): () => void
+  /** Unregister a root */
+  unregisterRoot(id: string): void
+  /** Generate a unique root ID */
+  generateRootId(): string
+  /** Get the number of registered roots */
+  getRootCount(): number
+
+  //* Job Registration --------------------------------
+
+  /** Register a job with the scheduler (returns unsubscribe function) */
+  register(
+    callback: FrameNextCallback,
+    options?: {
+      id?: string
+      rootId?: string
+      phase?: string
+      before?: string | string[]
+      after?: string | string[]
+      priority?: number
+      fps?: number
+      drop?: boolean
+      enabled?: boolean
+    },
+  ): () => void
+  /** Update a job's options */
+  updateJob(
+    id: string,
+    options: {
+      priority?: number
+      fps?: number
+      drop?: boolean
+      enabled?: boolean
+      phase?: string
+      before?: string | string[]
+      after?: string | string[]
+    },
+  ): void
+  /** Unregister a job by ID */
+  unregister(id: string, rootId?: string): void
+  /** Get the number of registered jobs */
+  getJobCount(): number
+  /** Get all job IDs */
+  getJobIds(): string[]
+
+  //* Global Jobs (for legacy addEffect/addAfterEffect) --------------------------------
+
+  /** Register a global job (runs once per frame, not per-root). Returns unsubscribe function. */
+  registerGlobal(phase: 'before' | 'after', id: string, callback: (timestamp: number) => void): () => void
+
+  //* Idle Callbacks (for legacy addTail) --------------------------------
+
+  /** Register an idle callback (fires when loop stops). Returns unsubscribe function. */
+  onIdle(callback: (timestamp: number) => void): () => void
+
+  //* Frame Loop Control --------------------------------
+
+  /** Start the scheduler loop */
+  start(): void
+  /** Stop the scheduler loop */
+  stop(): void
+  /** Check if the scheduler is running */
+  readonly isRunning: boolean
+  /** Get/set the frameloop mode ('always', 'demand', 'never') */
+  frameloop: Frameloop
+
+  //* Manual Stepping --------------------------------
+
+  /** Manually step all jobs once (for frameloop='never' or testing) */
+  step(timestamp?: number): void
+  /** Manually step a single job by ID */
+  stepJob(id: string, timestamp?: number): void
+  /** Request frame(s) to be rendered (for frameloop='demand') */
+  invalidate(frames?: number): void
+
+  //* Per-Job Control --------------------------------
+
+  /** Check if a job is paused */
+  isJobPaused(id: string): boolean
+  /** Pause a job */
+  pauseJob(id: string): void
+  /** Resume a job */
+  resumeJob(id: string): void
+  /** Subscribe to job state changes (for reactive isPaused). Returns unsubscribe function. */
+  subscribeJobState(id: string, listener: () => void): () => void
+}
+
+//* Core Store Types ========================================
+
+type Subscription = {
+  ref: React$1.RefObject<RenderCallback>
+  priority: number
+  store: RootStore
+}
+
+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$1.Object3D[]
+  hovered: Map<string, ThreeEvent<DomEvent>>
+  subscribers: Subscription[]
+  capturedMap: Map<number, Map<THREE$1.Object3D, PointerCaptureTarget>>
+  initialClick: [x: number, y: number]
+  initialHits: THREE$1.Object3D[]
+  lastEvent: React$1.RefObject<DomEvent | null>
+  active: boolean
+  priority: number
+  frames: number
+  subscribe: (callback: React$1.RefObject<RenderCallback>, priority: number, store: RootStore) => () => void
+  /** Internal renderer storage - use state.renderer or state.gl to access */
+  actualRenderer: THREE$1.WebGLRenderer | any // WebGPURenderer when available
+  /** Global scheduler reference (for useFrame hook) */
+  scheduler: SchedulerApi | 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$1.Object3D
+}
+
+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']
+  /** (deprecated) The instance of the WebGLrenderer */
+  gl: THREE$1.WebGLRenderer
+  /** The instance of the WebGPU renderer, the fallback, OR the default renderer as a mask of gl */
+  renderer: THREE$1.WebGLRenderer | any // WebGPURenderer when available
+  /** Inspector of the webGPU Renderer. Init in the canvas */
+  inspector: any // Inspector type from three/webgpu
+
+  /** Default camera */
+  camera: ThreeCamera
+  /** Default scene (may be overridden in portals to point to the portal container) */
+  scene: THREE$1.Scene
+  /** The actual root THREE.Scene - always points to the true scene, even inside portals */
+  rootScene: THREE$1.Scene
+  /** Default raycaster */
+  raycaster: THREE$1.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$1.EventDispatcher | null
+  /** Normalized event coordinates */
+  pointer: THREE$1.Vector2
+  /** @deprecated Normalized event coordinates, use "pointer" instead! */
+  mouse: THREE$1.Vector2
+  /* Whether to enable r139's THREE.ColorManagement */
+  legacy: boolean
+  /** Shortcut to gl.outputColorSpace = THREE.LinearSRGBColorSpace */
+  linear: boolean
+  /** Shortcut to gl.toneMapping = NoTonemapping */
+  flat: boolean
+  /** Color space assigned to 8-bit input textures (color maps). Most textures are authored in sRGB. */
+  textureColorSpace: THREE$1.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$1.Vector3 | Parameters<THREE$1.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 */
+  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 */
+  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 TSL uniform nodes - root-level uniforms + scoped sub-objects. Use useUniforms() hook */
+  uniforms: UniformStore
+  /** Global TSL nodes - root-level nodes + scoped sub-objects. Use useNodes() hook */
+  nodes: Record<string, any>
+  /** Global TSL texture nodes - use useTextures() hook for operations */
+  textures: Map<string, any>
+  /** WebGPU PostProcessing instance - use usePostProcessing() hook */
+  postProcessing: any | null // THREE.PostProcessing when available
+  /** Global TSL pass nodes for post-processing - use usePostProcessing() hook */
+  passes: Record<string, any>
+  /** 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>>
+
+//* Base Renderer Types =====================================
+
+// Shim for OffscreenCanvas since it was removed from DOM types
+interface OffscreenCanvas$1 extends EventTarget {}
+
+interface BaseRendererProps {
+  canvas: HTMLCanvasElement | OffscreenCanvas$1
+  powerPreference?: 'high-performance' | 'low-power' | 'default'
+  antialias?: boolean
+  alpha?: boolean
+}
+
+type RendererFactory<TRenderer, TParams> =
+  | TRenderer
+  | ((defaultProps: TParams) => TRenderer)
+  | ((defaultProps: TParams) => Promise<TRenderer>)
+
+interface Renderer {
+  render: (scene: THREE$1.Scene, camera: THREE$1.Camera) => any
+}
+
+//* WebGL Renderer Props ==============================
+
+type DefaultGLProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & {
+  canvas: HTMLCanvasElement | OffscreenCanvas$1
+}
+
+type GLProps =
+  | Renderer
+  | ((defaultProps: DefaultGLProps) => Renderer)
+  | ((defaultProps: DefaultGLProps) => Promise<Renderer>)
+  | Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters>
+
+//* WebGPU Renderer Props ==============================
+
+type DefaultRendererProps = {
+  canvas: HTMLCanvasElement | OffscreenCanvas$1
+  [key: string]: any
+}
+
+type RendererProps =
+  | any // WebGPURenderer
+  | ((defaultProps: DefaultRendererProps) => any)
+  | ((defaultProps: DefaultRendererProps) => Promise<any>)
+  | Partial<Properties<any> | Record<string, any>>
+
+//* Camera Props ==============================
+
+type CameraProps = (
+  | THREE$1.Camera
+  | Partial<
+      ThreeElement<typeof THREE$1.Camera> &
+        ThreeElement<typeof THREE$1.PerspectiveCamera> &
+        ThreeElement<typeof THREE$1.OrthographicCamera>
+    >
+) & {
+  /** Flags the camera as manual, putting projection into your own hands */
+  manual?: boolean
+}
+
+//* Render Props ==============================
+
+interface RenderProps<TCanvas extends HTMLCanvasElement | OffscreenCanvas$1> {
+  /** A threejs renderer instance or props that go into the default renderer */
+  gl?: GLProps
+  /** A WebGPU renderer instance or props that go into the default renderer */
+  renderer?: RendererProps
+  /** Dimensions to fit the renderer to. Will measure canvas dimensions if omitted */
+  size?: Size
+  /**
+   * Enables shadows (by default PCFsoft). Can accept `gl.shadowMap` options for fine-tuning,
+   * but also strings: 'basic' | 'percentage' | 'soft' | 'variance'.
+   * @see https://threejs.org/docs/#api/en/renderers/WebGLRenderer.shadowMap
+   */
+  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
+  /**
+   * Disables three r139 color management.
+   * @see https://threejs.org/docs/#manual/en/introduction/Color-management
+   */
+  legacy?: boolean
+  /** Switch off automatic sRGB encoding and gamma correction */
+  linear?: boolean
+  /** Use `THREE.NoToneMapping` instead of `THREE.ACESFilmicToneMapping` */
+  flat?: boolean
+  /** Working color space for automatic texture colorspace assignment. Defaults to THREE.SRGBColorSpace */
+  /** Color space assigned to 8-bit input textures (color maps). Defaults to sRGB. Most textures are authored in sRGB. */
+  textureColorSpace?: THREE$1.ColorSpace
+  /** Creates an orthographic camera */
+  orthographic?: boolean
+  /**
+   * R3F's render mode. Set to `demand` to only render on state change or `never` to take control.
+   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#on-demand-rendering
+   */
+  frameloop?: Frameloop
+  /**
+   * R3F performance options for adaptive performance.
+   * @see https://docs.pmnd.rs/react-three-fiber/advanced/scaling-performance#movement-regression
+   */
+  performance?: Partial<Omit<Performance, 'regress'>>
+  /** Target pixel ratio. Can clamp between a range: `[min, max]` */
+  dpr?: Dpr
+  /** Props that go into the default raycaster */
+  raycaster?: Partial<THREE$1.Raycaster>
+  /** A `THREE.Scene` instance or props that go into the default scene */
+  scene?: THREE$1.Scene | Partial<THREE$1.Scene>
+  /** A `THREE.Camera` instance or props that go into the default camera */
+  camera?: CameraProps
+  /** An R3F event manager to manage elements' pointer events */
+  events?: (store: RootStore) => EventManager<HTMLElement>
+  /** Callback after the canvas has rendered (but not yet committed) */
+  onCreated?: (state: RootState) => void
+  /** Response for pointer clicks that have missed any target */
+  onPointerMissed?: (event: MouseEvent) => void
+  /** Response for dragover events that have missed any target */
+  onDragOverMissed?: (event: DragEvent) => void
+  /** Response for drop events that have missed any target */
+  onDropMissed?: (event: DragEvent) => void
+}
+
+//* Reconciler Root ==============================
+
+interface ReconcilerRoot<TCanvas extends HTMLCanvasElement | OffscreenCanvas$1> {
+  configure: (config?: RenderProps<TCanvas>) => Promise<ReconcilerRoot<TCanvas>>
+  render: (element: ReactNode) => RootStore
+  unmount: () => void
+}
+
+//* Inject State ==============================
+
+type InjectState = Partial<
+  Omit<RootState, 'events'> & {
+    events?: {
+      enabled?: boolean
+      priority?: number
+      compute?: ComputeFunction
+      connected?: any
+    }
+    /**
+     * When true (default), injects a THREE.Scene between container and children if container isn't already a Scene.
+     * This ensures state.scene is always a real THREE.Scene with proper properties (background, environment, fog).
+     * Set to false to use the container directly as scene (anti-pattern, but supported for edge cases).
+     */
+    injectScene?: boolean
+  }
+>
+
+//* Reconciler Types ==============================
+
+interface Root {
+  fiber: react_reconciler.FiberRoot
+  store: RootStore
+}
+
+type AttachFnType<O = any> = (parent: any, self: O) => () => void
+type AttachType<O = any> = string | AttachFnType<O>
+
+type ConstructorRepresentation<T = any> = new (...args: any[]) => T
+
+interface Catalogue {
+  [name: string]: ConstructorRepresentation
+}
+
+// TODO: handle constructor overloads
+// https://github.com/pmndrs/react-three-fiber/pull/2931
+// https://github.com/microsoft/TypeScript/issues/37079
+type Args<T> = T extends ConstructorRepresentation
+  ? T extends typeof Color$1
+    ? [r: number, g: number, b: number] | [color: ColorRepresentation]
+    : ConstructorParameters<T>
+  : any[]
+
+type ArgsProp<P> = P extends ConstructorRepresentation
+  ? IsAllOptional<ConstructorParameters<P>> extends true
+    ? { args?: Args<P> }
+    : { args: Args<P> }
+  : { args: unknown[] }
+
+type InstanceProps<T = any, P = any> = ArgsProp<P> & {
+  object?: T
+  dispose?: null
+  attach?: AttachType<T>
+  onUpdate?: (self: T) => void
+}
+
+interface Instance<O = any> {
+  root: RootStore
+  type: string
+  parent: Instance | null
+  children: Instance[]
+  props: InstanceProps<O> & Record<string, unknown>
+  object: O & { __r3f?: Instance<O> }
+  eventCount: number
+  handlers: Partial<EventHandlers>
+  attach?: AttachType<O>
+  previousAttach?: any
+  isHidden: boolean
+}
+
+interface HostConfig {
+  type: string
+  props: Instance['props']
+  container: RootStore
+  instance: Instance
+  textInstance: void
+  suspenseInstance: Instance
+  hydratableInstance: never
+  formInstance: never
+  publicInstance: Instance['object']
+  hostContext: {}
+  childSet: never
+  timeoutHandle: number | undefined
+  noTimeout: -1
+  TransitionStatus: null
+}
+declare global {
+  var IS_REACT_ACT_ENVIRONMENT: boolean | undefined
+}
+
+//* Loop Types ==============================
+
+type GlobalRenderCallback = (timestamp: number) => void
+
+type GlobalEffectType = 'before' | 'after' | 'tail'
+
+//* Canvas Types ==============================
+
+interface CanvasProps
+  extends Omit<RenderProps<HTMLCanvasElement>, 'size'>,
+    React$1.HTMLAttributes<HTMLDivElement> {
+  children?: React$1.ReactNode
+  ref?: React$1.Ref<HTMLCanvasElement>
+  /** Canvas fallback content, similar to img's alt prop */
+  fallback?: React$1.ReactNode
+  /**
+   * Options to pass to useMeasure.
+   * @see https://github.com/pmndrs/react-use-measure#api
+   */
+  resize?: Options
+  /** The target where events are being subscribed to, default: the div that wraps canvas */
+  eventSource?: HTMLElement | React$1.RefObject<HTMLElement>
+  /** The event prefix that is cast into canvas pointer x/y events, default: "offset" */
+  eventPrefix?: 'offset' | 'client' | 'page' | 'layer' | 'screen'
+}
+
+//* Loader Types ==============================
+
+type InputLike = string | string[] | string[][] | Readonly<string | string[] | string[][]>
+
+// Define a loader-like interface that matches THREE.Loader's load signature
+// This works for both generic and non-generic THREE.Loader instances
+interface LoaderLike {
+  load(
+    url: InputLike,
+    onLoad?: (result: any) => void,
+    onProgress?: (event: ProgressEvent<EventTarget>) => void,
+    onError?: (error: unknown) => void,
+  ): any
+}
+
+type GLTFLike = { scene: THREE$1.Object3D }
+
+type LoaderInstance<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> =
+  T extends ConstructorRepresentation<LoaderLike> ? InstanceType<T> : T
+
+// Infer result type from the load method's callback parameter
+type InferLoadResult<T> = T extends {
+  load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
+}
+  ? R
+  : T extends ConstructorRepresentation<any>
+  ? InstanceType<T> extends {
+      load(url: any, onLoad?: (result: infer R) => void, ...args: any[]): any
+    }
+    ? R
+    : any
+  : any
+
+type LoaderResult<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> = InferLoadResult<
+  LoaderInstance<T>
+> extends infer R
+  ? R extends GLTFLike
+    ? R & ObjectMap
+    : R
+  : never
+
+type Extensions<T extends LoaderLike | ConstructorRepresentation<LoaderLike>> = (
+  loader: LoaderInstance<T>,
+) => void
+
+type WebGLDefaultProps = Omit<THREE$1.WebGLRendererParameters, 'canvas'> & BaseRendererProps
+
+type WebGLProps =
+  | RendererFactory<THREE$1.WebGLRenderer, WebGLDefaultProps>
+  | Partial<Properties<THREE$1.WebGLRenderer> | THREE$1.WebGLRendererParameters>
+
+interface WebGLShadowConfig {
+  shadows?: boolean | 'basic' | 'percentage' | 'soft' | 'variance' | Partial<THREE$1.WebGLShadowMap>
+}
+
+//* Global Types ==============================
+
+declare global {
+  /** Uniform node type - a Node with a value property (matches Three.js UniformNode) */
+  interface UniformNode<T = unknown> extends Node {
+    value: T
+  }
+
+  /** Flat record of uniform nodes (no nested scopes) */
+  type UniformRecord<T extends UniformNode = UniformNode> = Record<string, T>
+
+  /**
+   * Uniform store that can contain both root-level uniforms and scoped uniform objects
+   * Used by state.uniforms which has structure like:
+   * { uTime: UniformNode, player: { uHealth: UniformNode }, enemy: { uHealth: UniformNode } }
+   */
+  type UniformStore = Record<string, UniformNode | UniformRecord>
+
+  /**
+   * Acceptable input values for useUniforms - raw values that get converted to UniformNodes
+   * Supports: primitives, Three.js types, plain objects (converted to vectors), and UniformNodes
+   */
+  type UniformValue =
+    | number
+    | string
+    | boolean
+    | three_webgpu.Color
+    | three_webgpu.Vector2
+    | three_webgpu.Vector3
+    | three_webgpu.Vector4
+    | three_webgpu.Matrix3
+    | three_webgpu.Matrix4
+    | three_webgpu.Euler
+    | three_webgpu.Quaternion
+    | { x: number; y?: number; z?: number; w?: number } // Plain objects converted to vectors
+    | UniformNode
+
+  /** Input record for useUniforms - accepts raw values or UniformNodes */
+  type UniformInputRecord = Record<string, UniformValue>
+}
+
+//* Fn Return Type ==============================
+
+/** The return type of Fn() - a callable shader function node */
+type ShaderCallable<R extends Node = Node> = ((...params: unknown[]) => ShaderNodeObject<R>) & Node
+
+//* Module Augmentation ==============================
+
+declare module 'three/tsl' {
+  /**
+   * Fn with array parameter destructuring
+   * @example Fn(([uv, skew]) => { ... })
+   */
+  export function Fn<R extends Node = Node>(
+    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with object parameter destructuring
+   * @example Fn(({ color, intensity }) => { ... })
+   */
+  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
+    jsFunc: (inputs: T) => ShaderNodeObject<R>,
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with array params + layout
+   * @example Fn(([a, b]) => { ... }, { layout: [...] })
+   */
+  export function Fn<R extends Node = Node>(
+    jsFunc: (inputs: ShaderNodeObject<Node>[]) => ShaderNodeObject<R>,
+    layout: { layout?: unknown },
+  ): ShaderCallable<R>
+
+  /**
+   * Fn with object params + layout
+   */
+  export function Fn<T extends Record<string, unknown>, R extends Node = Node>(
+    jsFunc: (inputs: T) => ShaderNodeObject<R>,
+    layout: { layout?: unknown },
+  ): ShaderCallable<R>
+}
+
+/**
+ * PostProcessing Types for usePostProcessing hook (WebGPU only)
+ */
+
+
+
+declare global {
+  /** Pass record - stores TSL pass nodes for post-processing */
+  type PassRecord = Record<string, any>
+
+  /** Setup callback - runs first to configure MRT, create additional passes */
+  type PostProcessingSetupCallback = (state: RootState) => PassRecord | void
+
+  /** Main callback - runs second to configure outputNode, create effect passes */
+  type PostProcessingMainCallback = (state: RootState) => PassRecord | void
+
+  /** Return type for usePostProcessing hook */
+  interface UsePostProcessingReturn {
+    /** Current passes from state */
+    passes: PassRecord
+    /** PostProcessing instance (null if not initialized) */
+    postProcessing: any | null // THREE.PostProcessing
+    /** Clear all passes from state */
+    clearPasses: () => void
+    /** Reset PostProcessing entirely (clears PP + passes) */
+    reset: () => void
+    /** Re-run setup/main callbacks with current closure values */
+    rebuild: () => void
+    /** True when PostProcessing is configured and ready */
+    isReady: boolean
+  }
+}
+
+//* Global Type Declarations ==============================
+
+declare global {
+  // Job --------------------------------
+
+  /**
+   * Internal job representation in the scheduler
+   */
+  interface Job {
+    /** Unique identifier */
+    id: string
+    /** The callback to execute */
+    callback: FrameNextCallback
+    /** Phase this job belongs to */
+    phase: string
+    /** Run before these phases/job ids */
+    before: Set<string>
+    /** Run after these phases/job ids */
+    after: Set<string>
+    /** Priority within phase (higher first) */
+    priority: number
+    /** Insertion order for deterministic tie-breaking */
+    index: number
+    /** Max FPS for this job (undefined = no limit) */
+    fps?: number
+    /** Drop frames when behind (true) or catch up (false) */
+    drop: boolean
+    /** Last run timestamp (ms) */
+    lastRun?: number
+    /** Whether job is enabled */
+    enabled: boolean
+    /** Internal flag: system jobs (like default render) don't block user render takeover */
+    system?: boolean
+  }
+
+  // Phase Graph --------------------------------
+
+  /**
+   * A node in the phase graph
+   */
+  interface PhaseNode {
+    /** Phase name */
+    name: string
+    /** Whether this was auto-generated from a before/after constraint */
+    isAutoGenerated: boolean
+  }
+
+  /**
+   * Options for creating a job from hook options
+   */
+  interface JobOptions {
+    id?: string
+    phase?: string
+    before?: string | string[]
+    after?: string | string[]
+    priority?: number
+    fps?: number
+    drop?: boolean
+    enabled?: boolean
+  }
+
+  // Frame Loop State --------------------------------
+
+  /**
+   * Internal frame loop state
+   */
+  interface FrameLoopState {
+    /** Whether the loop is running */
+    running: boolean
+    /** Current RAF handle */
+    rafHandle: number | null
+    /** Last frame timestamp in ms (null = uninitialized) */
+    lastTime: number | null
+    /** Frame counter */
+    frameCount: number
+    /** Elapsed time since first frame in ms */
+    elapsedTime: number
+    /** createdAt timestamp in ms */
+    createdAt: number
+  }
+
+  // Root Entry --------------------------------
+
+  /**
+   * Internal representation of a registered root (Canvas).
+   * Tracks jobs and manages rebuild state for this root.
+   * @internal
+   */
+  interface RootEntry {
+    /** Unique identifier for this root */
+    id: string
+    /** Function to get the root's current state */
+    getState: () => RootState
+    /** Map of job IDs to Job objects */
+    jobs: Map<string, Job>
+    /** Cached sorted job list for execution order */
+    sortedJobs: Job[]
+    /** Whether sortedJobs needs rebuilding */
+    needsRebuild: boolean
+  }
+
+  /**
+   * Internal representation of a global job (deprecated API).
+   * Global jobs run once per frame, not per-root.
+   * Used by legacy addEffect/addAfterEffect APIs.
+   * @internal
+   * @deprecated Use useFrame with phases instead
+   */
+  interface GlobalJob {
+    /** Unique identifier for this global job */
+    id: string
+    /** Callback invoked with RAF timestamp in ms */
+    callback: (timestamp: number) => void
+  }
+
+  // HMR Support --------------------------------
+
+  /**
+   * Hot Module Replacement data structure for preserving scheduler state
+   * @internal
+   */
+  interface HMRData {
+    /** Shared data object for storing values across reloads */
+    data: Record<string, any>
+    /** Optional function to accept HMR updates */
+    accept?: () => void
+  }
+
+  // Default Phases --------------------------------
+
+  /**
+   * Default phase names for the scheduler
+   */
+  type DefaultPhase = 'start' | 'input' | 'physics' | 'update' | 'render' | 'finish'
+}
+
+type MutableOrReadonlyParameters<T extends (...args: any) => any> = Parameters<T> | Readonly<Parameters<T>>
+
+interface MathRepresentation {
+  set(...args: number[]): any
+}
+interface VectorRepresentation extends MathRepresentation {
+  setScalar(value: number): any
+}
+type MathTypes = MathRepresentation | Euler$1 | Color$2
+
+type MathType<T extends MathTypes> = T extends Color$2
+  ? Args<typeof Color$2> | ColorRepresentation$1
+  : T extends VectorRepresentation | Layers$1 | Euler$1
+  ? T | MutableOrReadonlyParameters<T['set']> | number
+  : T | MutableOrReadonlyParameters<T['set']>
+
+type MathProps<P> = {
+  [K in keyof P as P[K] extends MathTypes ? K : never]: P[K] extends MathTypes ? MathType<P[K]> : never
+}
+
+type Vector2 = MathType<Vector2$1>
+type Vector3 = MathType<Vector3$1>
+type Vector4 = MathType<Vector4$1>
+type Color = MathType<Color$2>
+type Layers = MathType<Layers$1>
+type Quaternion = MathType<Quaternion$1>
+type Euler = MathType<Euler$1>
+type Matrix3 = MathType<Matrix3$1>
+type Matrix4 = MathType<Matrix4$1>
+
+interface RaycastableRepresentation {
+  raycast(raycaster: Raycaster, intersects: Intersection$1[]): void
+}
+type EventProps<P> = P extends RaycastableRepresentation ? Partial<EventHandlers> : {}
+
+interface ReactProps<P> {
+  children?: React.ReactNode
+  ref?: React.Ref<P>
+  key?: React.Key
+}
+
+type ElementProps<T extends ConstructorRepresentation, P = InstanceType<T>> = Partial<
+  Overwrite<P, MathProps<P> & ReactProps<P> & EventProps<P>>
+>
+
+type ThreeElement<T extends ConstructorRepresentation> = Mutable<
+  Overwrite<ElementProps<T>, Omit<InstanceProps<InstanceType<T>, T>, 'object'>>
+>
+
+type ThreeToJSXElements<T extends Record<string, any>> = {
+  [K in keyof T & string as Uncapitalize<K>]: T[K] extends ConstructorRepresentation ? ThreeElement<T[K]> : never
+}
+
+type ThreeExports = typeof THREE
+type ThreeElementsImpl = ThreeToJSXElements<ThreeExports>
+
+interface ThreeElements extends Omit<ThreeElementsImpl, 'audio' | 'source' | 'line' | 'path'> {
+  primitive: Omit<ThreeElement<any>, 'args'> & { object: object }
+  // Conflicts with DOM types can be accessed through a three* prefix
+  threeAudio: ThreeElementsImpl['audio']
+  threeSource: ThreeElementsImpl['source']
+  threeLine: ThreeElementsImpl['line']
+  threePath: ThreeElementsImpl['path']
+}
+
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
+}
+
+declare module 'react/jsx-runtime' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
+}
+
+declare module 'react/jsx-dev-runtime' {
+  namespace JSX {
+    interface IntrinsicElements extends ThreeElements {}
+  }
+}
+
+type three_d_Color = Color;
+type three_d_ElementProps<T extends ConstructorRepresentation, P = InstanceType<T>> = ElementProps<T, P>;
+type three_d_Euler = Euler;
+type three_d_EventProps<P> = EventProps<P>;
+type three_d_Layers = Layers;
+type three_d_MathProps<P> = MathProps<P>;
+type three_d_MathRepresentation = MathRepresentation;
+type three_d_MathType<T extends MathTypes> = MathType<T>;
+type three_d_MathTypes = MathTypes;
+type three_d_Matrix3 = Matrix3;
+type three_d_Matrix4 = Matrix4;
+type three_d_MutableOrReadonlyParameters<T extends (...args: any) => any> = MutableOrReadonlyParameters<T>;
+type three_d_Quaternion = Quaternion;
+type three_d_RaycastableRepresentation = RaycastableRepresentation;
+type three_d_ReactProps<P> = ReactProps<P>;
+type three_d_ThreeElement<T extends ConstructorRepresentation> = ThreeElement<T>;
+type three_d_ThreeElements = ThreeElements;
+type three_d_ThreeElementsImpl = ThreeElementsImpl;
+type three_d_ThreeExports = ThreeExports;
+type three_d_ThreeToJSXElements<T extends Record<string, any>> = ThreeToJSXElements<T>;
+type three_d_Vector2 = Vector2;
+type three_d_Vector3 = Vector3;
+type three_d_Vector4 = Vector4;
+type three_d_VectorRepresentation = VectorRepresentation;
+declare namespace three_d {
+  export type { three_d_Color as Color, three_d_ElementProps as ElementProps, three_d_Euler as Euler, three_d_EventProps as EventProps, three_d_Layers as Layers, three_d_MathProps as MathProps, three_d_MathRepresentation as MathRepresentation, three_d_MathType as MathType, three_d_MathTypes as MathTypes, three_d_Matrix3 as Matrix3, three_d_Matrix4 as Matrix4, three_d_MutableOrReadonlyParameters as MutableOrReadonlyParameters, three_d_Quaternion as Quaternion, three_d_RaycastableRepresentation as RaycastableRepresentation, three_d_ReactProps as ReactProps, three_d_ThreeElement as ThreeElement, three_d_ThreeElements as ThreeElements, three_d_ThreeElementsImpl as ThreeElementsImpl, three_d_ThreeExports as ThreeExports, three_d_ThreeToJSXElements as ThreeToJSXElements, three_d_Vector2 as Vector2, three_d_Vector3 as Vector3, three_d_Vector4 as Vector4, three_d_VectorRepresentation as VectorRepresentation };
+}
+
+declare function removeInteractivity(store: RootStore, object: Object3D): void;
+declare function createEvents(store: RootStore): {
+    handlePointer: (name: string) => (event: DomEvent) => void;
+};
+/** Default R3F event manager for web */
+declare function createPointerEvents(store: RootStore): EventManager<HTMLElement>;
+
+/**
+ * Gets or creates a memoized loader instance from a loader constructor or returns the loader if it's already an instance.
+ * This allows external code to access loader methods like abort().
+ */
+declare function getLoader<L extends LoaderLike | ConstructorRepresentation<LoaderLike>>(Proto: L): L extends ConstructorRepresentation<infer T> ? T : L;
+/**
+ * Synchronously loads and caches assets with a three loader.
+ *
+ * Note: this hook's caller must be wrapped with `React.Suspense`
+ * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#useloader
+ */
+declare function useLoader<I extends InputLike, L extends LoaderLike | ConstructorRepresentation<LoaderLike>>(loader: L, input: I, extensions?: Extensions<L>, onProgress?: (event: ProgressEvent<EventTarget>) => void): I extends any[] ? LoaderResult<L>[] : LoaderResult<L>;
+declare namespace useLoader {
+    var preload: <I extends InputLike, L extends LoaderLike | ConstructorRepresentation<LoaderLike>>(loader: L, input: I, extensions?: Extensions<L>, onProgress?: (event: ProgressEvent<EventTarget>) => void) => void;
+    var clear: <I extends InputLike, L extends LoaderLike | ConstructorRepresentation<LoaderLike>>(loader: L, input: I) => void;
+    var loader: typeof getLoader;
+}
+
+/**
+ * Global Singleton Scheduler - manages the frame loop and job execution for ALL R3F roots.
+ *
+ * Features:
+ * - Single RAF loop for entire application
+ * - Root registration (multiple Canvas support)
+ * - Global phases for addEffect/addAfterEffect (deprecated)
+ * - Per-root job management with phases, priorities, FPS throttling
+ * - onIdle callbacks for addTail (deprecated)
+ * - Demand mode support via invalidate()
+ */
+declare class Scheduler {
+    private static instance;
+    /**
+     * Get the global scheduler instance (creates if doesn't exist).
+     * Uses HMR data to preserve instance across hot reloads.
+     * @returns {Scheduler} The singleton scheduler instance
+     */
+    static get(): Scheduler;
+    /**
+     * Reset the singleton instance. Stops the loop and clears all state.
+     * Primarily used for testing to ensure clean state between tests.
+     * @returns {void}
+     */
+    static reset(): void;
+    private roots;
+    private phaseGraph;
+    private loopState;
+    private stoppedTime;
+    private nextRootIndex;
+    private globalBeforeJobs;
+    private globalAfterJobs;
+    private nextGlobalIndex;
+    private idleCallbacks;
+    private nextJobIndex;
+    private jobStateListeners;
+    private pendingFrames;
+    private _frameloop;
+    get phases(): string[];
+    get frameloop(): Frameloop;
+    set frameloop(mode: Frameloop);
+    get isRunning(): boolean;
+    constructor();
+    /**
+     * Register a root (Canvas) with the scheduler.
+     * The first root to register starts the RAF loop (if frameloop='always').
+     * @param {string} id - Unique identifier for this root
+     * @param {() => RootState} getState - Function to get the root's current state
+     * @returns {() => void} Unsubscribe function to remove this root
+     */
+    registerRoot(id: string, getState: () => RootState): () => void;
+    /**
+     * Unregister a root from the scheduler.
+     * Cleans up all job state listeners for this root's jobs.
+     * The last root to unregister stops the RAF loop.
+     * @param {string} id - The root ID to unregister
+     * @returns {void}
+     */
+    unregisterRoot(id: string): void;
+    /**
+     * Add a named phase to the scheduler's execution order.
+     * Marks all roots for rebuild to incorporate the new phase.
+     * @param {string} name - The phase name (e.g., 'physics', 'postprocess')
+     * @param {AddPhaseOptions} [options] - Positioning options (before/after other phases)
+     * @returns {void}
+     * @example
+     * scheduler.addPhase('physics', { before: 'update' });
+     * scheduler.addPhase('postprocess', { after: 'render' });
+     */
+    addPhase(name: string, options?: AddPhaseOptions): void;
+    /**
+     * Check if a phase exists in the scheduler.
+     * @param {string} name - The phase name to check
+     * @returns {boolean} True if the phase exists
+     */
+    hasPhase(name: string): boolean;
+    /**
+     * Register a global job that runs once per frame (not per-root).
+     * Used internally by deprecated addEffect/addAfterEffect APIs.
+     * @param {'before' | 'after'} phase - When to run: 'before' all roots or 'after' all roots
+     * @param {string} id - Unique identifier for this global job
+     * @param {(timestamp: number) => void} callback - Function called each frame with RAF timestamp
+     * @returns {() => void} Unsubscribe function to remove this global job
+     * @deprecated Use useFrame with phases instead
+     */
+    registerGlobal(phase: 'before' | 'after', id: string, callback: (timestamp: number) => void): () => void;
+    /**
+     * Register an idle callback that fires when the loop stops.
+     * Used internally by deprecated addTail API.
+     * @param {(timestamp: number) => void} callback - Function called when loop becomes idle
+     * @returns {() => void} Unsubscribe function to remove this idle callback
+     * @deprecated Use demand mode with invalidate() instead
+     */
+    onIdle(callback: (timestamp: number) => void): () => void;
+    /**
+     * Notify all registered idle callbacks.
+     * Called when the loop stops in demand mode.
+     * @param {number} timestamp - The RAF timestamp when idle occurred
+     * @returns {void}
+     * @private
+     */
+    private notifyIdle;
+    /**
+     * Register a job (frame callback) with a specific root.
+     * This is the core registration method used by useFrame internally.
+     * @param {FrameNextCallback} callback - The function to call each frame
+     * @param {JobOptions & { rootId?: string; system?: boolean }} [options] - Job configuration
+     * @param {string} [options.rootId] - Target root ID (defaults to first registered root)
+     * @param {string} [options.id] - Unique job ID (auto-generated if not provided)
+     * @param {string} [options.phase] - Execution phase (defaults to 'update')
+     * @param {number} [options.priority] - Priority within phase (higher = earlier, default 0)
+     * @param {number} [options.fps] - FPS throttle limit
+     * @param {boolean} [options.drop] - Drop frames when behind (default true)
+     * @param {boolean} [options.enabled] - Whether job is active (default true)
+     * @param {boolean} [options.system] - Internal flag for system jobs (not user-facing)
+     * @returns {() => void} Unsubscribe function to remove this job
+     */
+    register(callback: FrameNextCallback, options?: JobOptions & {
+        rootId?: string;
+        system?: boolean;
+    }): () => void;
+    /**
+     * Unregister a job by its ID.
+     * Searches all roots if rootId is not provided.
+     * @param {string} id - The job ID to unregister
+     * @param {string} [rootId] - Optional root ID to search (searches all if not provided)
+     * @returns {void}
+     */
+    unregister(id: string, rootId?: string): void;
+    /**
+     * Update a job's options dynamically.
+     * Searches all roots to find the job by ID.
+     * Phase/constraint changes trigger a rebuild of the sorted job list.
+     * @param {string} id - The job ID to update
+     * @param {Partial<JobOptions>} options - The options to update
+     * @returns {void}
+     */
+    updateJob(id: string, options: Partial<JobOptions>): void;
+    /**
+     * Check if a job is currently paused (disabled).
+     * @param {string} id - The job ID to check
+     * @returns {boolean} True if the job exists and is paused
+     */
+    isJobPaused(id: string): boolean;
+    /**
+     * Subscribe to state changes for a specific job.
+     * Listener is called when job is paused or resumed.
+     * @param {string} id - The job ID to subscribe to
+     * @param {() => void} listener - Callback invoked on state changes
+     * @returns {() => void} Unsubscribe function
+     */
+    subscribeJobState(id: string, listener: () => void): () => void;
+    /**
+     * Notify all listeners that a job's state has changed.
+     * @param {string} id - The job ID that changed
+     * @returns {void}
+     * @private
+     */
+    private notifyJobStateChange;
+    /**
+     * Pause a job by ID (sets enabled=false).
+     * Notifies any subscribed state listeners.
+     * @param {string} id - The job ID to pause
+     * @returns {void}
+     */
+    pauseJob(id: string): void;
+    /**
+     * Resume a paused job by ID (sets enabled=true).
+     * Resets job timing to prevent frame accumulation.
+     * Notifies any subscribed state listeners.
+     * @param {string} id - The job ID to resume
+     * @returns {void}
+     */
+    resumeJob(id: string): void;
+    /**
+     * Start the requestAnimationFrame loop.
+     * Resets timing state (elapsedTime, frameCount) on start.
+     * No-op if already running.
+     * @returns {void}
+     */
+    start(): void;
+    /**
+     * Stop the requestAnimationFrame loop.
+     * Cancels any pending RAF callback.
+     * No-op if not running.
+     * @returns {void}
+     */
+    stop(): void;
+    /**
+     * Request frames to be rendered in demand mode.
+     * Accumulates pending frames (capped at 60) and starts the loop if not running.
+     * No-op if frameloop is not 'demand'.
+     * @param {number} [frames=1] - Number of frames to request
+     * @param {boolean} [stackFrames=false] - Whether to add frames to existing pending count
+     *   - `false` (default): Sets pending frames to the specified value (replaces existing count)
+     *   - `true`: Adds frames to existing pending count (useful for accumulating invalidations)
+     * @returns {void}
+     * @example
+     * // Request a single frame render
+     * scheduler.invalidate();
+     *
+     * @example
+     * // Request 5 frames (e.g., for animations)
+     * scheduler.invalidate(5);
+     *
+     * @example
+     * // Set pending frames to exactly 3 (don't stack with existing)
+     * scheduler.invalidate(3, false);
+     *
+     * @example
+     * // Add 2 more frames to existing pending count
+     * scheduler.invalidate(2, true);
+     */
+    invalidate(frames?: number, stackFrames?: boolean): void;
+    /**
+     * Reset timing state for deterministic testing.
+     * Preserves jobs and roots but resets lastTime, frameCount, elapsedTime, etc.
+     * @returns {void}
+     */
+    resetTiming(): void;
+    /**
+     * Manually execute a single frame for all roots.
+     * Useful for frameloop='never' mode or testing scenarios.
+     * @param {number} [timestamp] - Optional timestamp (defaults to performance.now())
+     * @returns {void}
+     * @example
+     * // Manual control mode
+     * scheduler.frameloop = 'never';
+     * scheduler.step(); // Execute one frame
+     */
+    step(timestamp?: number): void;
+    /**
+     * Manually execute a single job by its ID.
+     * Useful for testing individual job callbacks in isolation.
+     * @param {string} id - The job ID to step
+     * @param {number} [timestamp] - Optional timestamp (defaults to performance.now())
+     * @returns {void}
+     */
+    stepJob(id: string, timestamp?: number): void;
+    /**
+     * Main RAF loop callback.
+     * Executes frame, handles demand mode, and schedules next frame.
+     * @param {number} timestamp - RAF timestamp in milliseconds
+     * @returns {void}
+     * @private
+     */
+    private loop;
+    /**
+     * Execute a single frame across all roots.
+     * Order: globalBefore → each root's jobs → globalAfter
+     * @param {number} timestamp - RAF timestamp in milliseconds
+     * @returns {void}
+     * @private
+     */
+    private executeFrame;
+    /**
+     * Run all global jobs from a job map.
+     * Catches and logs errors without stopping execution.
+     * @param {Map<string, GlobalJob>} jobs - The global jobs map to execute
+     * @param {number} timestamp - RAF timestamp in milliseconds
+     * @returns {void}
+     * @private
+     */
+    private runGlobalJobs;
+    /**
+     * Execute all jobs for a single root in sorted order.
+     * Rebuilds sorted job list if needed, then dispatches each job.
+     * Errors are caught and propagated to the root's error boundary.
+     * @param {RootEntry} root - The root entry to tick
+     * @param {number} timestamp - RAF timestamp in milliseconds
+     * @param {number} delta - Time since last frame in seconds
+     * @returns {void}
+     * @private
+     */
+    private tickRoot;
+    /**
+     * Get the total number of registered jobs across all roots.
+     * Includes both per-root jobs and global before/after jobs.
+     * @returns {number} Total job count
+     */
+    getJobCount(): number;
+    /**
+     * Get all registered job IDs across all roots.
+     * Includes both per-root jobs and global before/after jobs.
+     * @returns {string[]} Array of all job IDs
+     */
+    getJobIds(): string[];
+    /**
+     * Get the number of registered roots (Canvas instances).
+     * @returns {number} Number of registered roots
+     */
+    getRootCount(): number;
+    /**
+     * Check if any user (non-system) jobs are registered in a specific phase.
+     * Used by the default render job to know if a user has taken over rendering.
+     *
+     * @param phase The phase to check
+     * @param rootId Optional root ID to check (checks all roots if not provided)
+     * @returns true if any user jobs exist in the phase
+     */
+    hasUserJobsInPhase(phase: string, rootId?: string): boolean;
+    /**
+     * Generate a unique root ID for automatic root registration.
+     * @returns {string} A unique root ID in the format 'root_N'
+     */
+    generateRootId(): string;
+    /**
+     * Generate a unique job ID.
+     * @returns {string} A unique job ID in the format 'job_N'
+     * @private
+     */
+    private generateJobId;
+    /**
+     * Normalize before/after constraints to a Set.
+     * Handles undefined, single string, or array inputs.
+     * @param {string | string[] | undefined} value - The constraint value(s)
+     * @returns {Set<string>} Normalized Set of constraint strings
+     * @private
+     */
+    private normalizeConstraints;
+}
+/**
+ * Get the global scheduler instance.
+ * Creates one if it doesn't exist.
+ */
+declare const getScheduler: () => Scheduler;
+
+/**
+ * Frame hook with phase-based ordering, priority, and FPS throttling.
+ *
+ * Returns a controls object for manual stepping, pausing, and resuming.
+ *
+ * @param callback - Function called each frame with (state, delta). Optional if you only need scheduler access.
+ * @param priorityOrOptions - Either a priority number (backwards compat) or options object
+ * @returns Controls object with step(), stepAll(), pause(), resume(), isPaused, id, scheduler
+ *
+ * @example
+ * // Simple priority (backwards compat)
+ * useFrame((state, delta) => { ... }, 5)
+ *
+ * @example
+ * // With phase-based ordering
+ * useFrame((state, delta) => { ... }, { phase: 'physics' })
+ *
+ * @example
+ * // With controls
+ * const controls = useFrame(cb, { phase: 'physics', id: 'my-physics' })
+ * controls.step()      // Step this job only
+ * controls.stepAll()   // Step all jobs
+ * controls.pause()     // Pause this job
+ * controls.resume()    // Resume this job
+ *
+ * @example
+ * // Manual mode (frameloop='never')
+ * const { stepAll } = useFrame(cb)
+ * // In your animation controller:
+ * stepAll()  // Advance all useFrame jobs
+ *
+ * @example
+ * // Scheduler-only access (no callback)
+ * const { scheduler } = useFrame()
+ * scheduler.pauseJob('some-job-id')
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#useframe
+ */
+declare function useFrame(callback?: FrameNextCallback, priorityOrOptions?: number | UseFrameNextOptions): FrameNextControls;
+
+declare const IsObject: (url: unknown) => url is Record<string, string>;
+type TextureArray<T> = T extends string[] ? Texture$1[] : never;
+type TextureRecord<T> = T extends Record<string, string> ? {
+    [key in keyof T]: Texture$1;
+} : never;
+type SingleTexture<T> = T extends string ? Texture$1 : never;
+type MappedTextureType<T extends string[] | string | Record<string, string>> = TextureArray<T> | TextureRecord<T> | SingleTexture<T>;
+/** Options for useTexture hook */
+type UseTextureOptions<Url extends string[] | string | Record<string, string>> = {
+    /** Callback when texture(s) finish loading */
+    onLoad?: (texture: MappedTextureType<Url>) => void;
+    /**
+     * Cache the texture in R3F's global state for access via useTextures().
+     * When true:
+     * - Textures persist until explicitly disposed
+     * - Returns existing cached textures if available (preserving modifications like colorSpace)
+     * @default false
+     */
+    cache?: boolean;
+};
+/**
+ * Load texture(s) using Three's TextureLoader with Suspense support.
+ *
+ * @param input - URL string, array of URLs, or object mapping keys to URLs
+ * @param optionsOrOnLoad - Options object or legacy onLoad callback
+ *
+ * @example
+ * ```tsx
+ * // Single texture
+ * const diffuse = useTexture('/textures/diffuse.png')
+ *
+ * // Multiple textures (array)
+ * const [diffuse, normal] = useTexture(['/diffuse.png', '/normal.png'])
+ *
+ * // Named textures (object)
+ * const { diffuse, normal } = useTexture({
+ *   diffuse: '/diffuse.png',
+ *   normal: '/normal.png'
+ * })
+ *
+ * // With caching - returns same texture object across components
+ * // Modifications (colorSpace, wrapS, etc.) are preserved
+ * const diffuse = useTexture('/diffuse.png', { cache: true })
+ * diffuse.colorSpace = THREE.SRGBColorSpace
+ *
+ * // Another component gets the SAME texture with colorSpace already set
+ * const sameDiffuse = useTexture('/diffuse.png', { cache: true })
+ *
+ * // Access cache directly
+ * const { get } = useTextures()
+ * const cached = get('/diffuse.png')
+ * ```
+ */
+declare function useTexture<Url extends string[] | string | Record<string, string>>(input: Url, optionsOrOnLoad?: UseTextureOptions<Url> | ((texture: MappedTextureType<Url>) => void)): MappedTextureType<Url>;
+declare namespace useTexture {
+    var preload: (url: string | string[]) => void;
+    var clear: (input: string | string[]) => void;
+}
+declare const Texture: ({ children, input, onLoad, cache, }: {
+    children?: (texture: ReturnType<typeof useTexture>) => ReactNode;
+    input: Parameters<typeof useTexture>[0];
+    onLoad?: Parameters<typeof useTexture>[1];
+    cache?: boolean;
+}) => react_jsx_runtime.JSX.Element;
+
+type TextureEntry = Texture$1 | {
+    value: Texture$1;
+    [key: string]: any;
+};
+interface UseTexturesReturn {
+    /** Map of all textures currently in cache */
+    textures: Map<string, TextureEntry>;
+    /** Get a specific texture by key (usually URL) */
+    get: (key: string) => TextureEntry | undefined;
+    /** Check if a texture exists in cache */
+    has: (key: string) => boolean;
+    /** Add a texture to the cache */
+    add: (key: string, value: TextureEntry) => void;
+    /** Add multiple textures to the cache */
+    addMultiple: (items: Map<string, TextureEntry> | Record<string, TextureEntry>) => void;
+    /** Remove a texture from cache (does NOT dispose GPU resources) */
+    remove: (key: string) => void;
+    /** Remove multiple textures from cache */
+    removeMultiple: (keys: string[]) => void;
+    /** Dispose a texture's GPU resources and remove from cache */
+    dispose: (key: string) => void;
+    /** Dispose multiple textures */
+    disposeMultiple: (keys: string[]) => void;
+    /** Dispose ALL cached textures - use with caution */
+    disposeAll: () => void;
+}
+/**
+ * Hook for managing the global texture cache in R3F state.
+ *
+ * Textures are stored in a Map with URL/path keys for efficient lookup.
+ * Useful for sharing texture references across materials and components.
+ *
+ * @example
+ * ```tsx
+ * const { textures, add, get, remove, has, dispose } = useTextures()
+ *
+ * // Check if texture is already cached
+ * if (!has('/textures/diffuse.png')) {
+ *   // Load with useTexture and cache: true, or manually add
+ *   const tex = useTexture('/textures/diffuse.png', { cache: true })
+ * }
+ *
+ * // Access cached texture from anywhere
+ * const diffuse = get('/textures/diffuse.png')
+ * if (diffuse) material.map = diffuse
+ *
+ * // Remove from cache only (texture still in GPU memory)
+ * remove('/textures/old.png')
+ *
+ * // Fully dispose (frees GPU memory + removes from cache)
+ * dispose('/textures/unused.png')
+ *
+ * // Nuclear option - dispose everything
+ * disposeAll()
+ * ```
+ */
+declare function useTextures(): UseTexturesReturn;
+
+/**
+ * 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;
+/**
+ * Exposes an object's {@link Instance}.
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#useInstanceHandle
+ *
+ * **Note**: this is an escape hatch to react-internal fields. Expect this to change significantly between versions.
+ */
+declare function useInstanceHandle<T>(ref: React.RefObject<T>): React.RefObject<Instance<T>>;
+/**
+ * Returns a node graph of an object with named nodes & materials.
+ * @see https://docs.pmnd.rs/react-three-fiber/api/hooks#usegraph
+ */
+declare function useGraph(object: Object3D): ObjectMap;
+
+/**
+ * Adds a global render callback which is called each frame BEFORE rendering.
+ *
+ * @deprecated Use `useFrame(callback, { phase: 'start' })` instead.
+ * This function will be removed in a future version.
+ *
+ * @param callback - Function called each frame with timestamp
+ * @returns Unsubscribe function
+ *
+ * @example
+ * // OLD (deprecated)
+ * const unsub = addEffect((timestamp) => { ... })
+ *
+ * // NEW
+ * useFrame((state, delta) => { ... }, { phase: 'start' })
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#addEffect
+ */
+declare function addEffect(callback: GlobalRenderCallback): () => void;
+/**
+ * Adds a global after-render callback which is called each frame AFTER rendering.
+ *
+ * @deprecated Use `useFrame(callback, { phase: 'finish' })` instead.
+ * This function will be removed in a future version.
+ *
+ * @param callback - Function called each frame with timestamp
+ * @returns Unsubscribe function
+ *
+ * @example
+ * // OLD (deprecated)
+ * const unsub = addAfterEffect((timestamp) => { ... })
+ *
+ * // NEW
+ * useFrame((state, delta) => { ... }, { phase: 'finish' })
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#addAfterEffect
+ */
+declare function addAfterEffect(callback: GlobalRenderCallback): () => void;
+/**
+ * Adds a global callback which is called when rendering stops.
+ *
+ * @deprecated Use `scheduler.onIdle(callback)` instead.
+ * This function will be removed in a future version.
+ *
+ * @param callback - Function called when rendering stops
+ * @returns Unsubscribe function
+ *
+ * @example
+ * // OLD (deprecated)
+ * const unsub = addTail((timestamp) => { ... })
+ *
+ * // NEW
+ * const { scheduler } = useFrame()
+ * const unsub = scheduler.onIdle((timestamp) => { ... })
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#addTail
+ */
+declare function addTail(callback: GlobalRenderCallback): () => void;
+/**
+ * Invalidates the view, requesting a frame to be rendered.
+ * In demand mode, this triggers the scheduler to run frames.
+ *
+ * @param state - Optional root state (ignored in new scheduler, kept for backwards compat)
+ * @param frames - Number of frames to request (default: 1)
+ * @param stackFrames - If false, sets pendingFrames to frames. If true, adds to existing pendingFrames (default: false)
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#invalidate
+ */
+declare function invalidate(state?: RootState, frames?: number, stackFrames?: boolean): void;
+/**
+ * Advances the frameloop and runs render effects.
+ * Useful for when manually rendering via `frameloop="never"`.
+ *
+ * @param timestamp - The timestamp to use for this frame
+ * @param runGlobalEffects - Ignored (kept for backwards compat, global effects always run)
+ * @param state - Ignored (kept for backwards compat)
+ * @param frame - Ignored (kept for backwards compat)
+ *
+ * @see https://docs.pmnd.rs/react-three-fiber/api/additional-exports#advance
+ */
+declare function advance(timestamp: number, runGlobalEffects?: boolean, state?: RootState, frame?: XRFrame): void;
+
+/* eslint-disable @definitelytyped/no-unnecessary-generics */
+declare function ReactReconciler<
+    Type,
+    Props,
+    Container,
+    Instance,
+    TextInstance,
+    SuspenseInstance,
+    HydratableInstance,
+    FormInstance,
+    PublicInstance,
+    HostContext,
+    ChildSet,
+    TimeoutHandle,
+    NoTimeout,
+    TransitionStatus,
+>(
+    /* eslint-enable @definitelytyped/no-unnecessary-generics */
+    config: ReactReconciler.HostConfig<
+        Type,
+        Props,
+        Container,
+        Instance,
+        TextInstance,
+        SuspenseInstance,
+        HydratableInstance,
+        FormInstance,
+        PublicInstance,
+        HostContext,
+        ChildSet,
+        TimeoutHandle,
+        NoTimeout,
+        TransitionStatus
+    >,
+): ReactReconciler.Reconciler<Container, Instance, TextInstance, SuspenseInstance, FormInstance, PublicInstance>;
+
+declare namespace ReactReconciler {
+    interface HostConfig<
+        Type,
+        Props,
+        Container,
+        Instance,
+        TextInstance,
+        SuspenseInstance,
+        HydratableInstance,
+        FormInstance,
+        PublicInstance,
+        HostContext,
+        ChildSet,
+        TimeoutHandle,
+        NoTimeout,
+        TransitionStatus,
+    > {
+        // -------------------
+        //        Modes
+        // -------------------
+        /**
+         * The reconciler has two modes: mutation mode and persistent mode. You must specify one of them.
+         *
+         * If your target platform is similar to the DOM and has methods similar to `appendChild`, `removeChild`, and so on, you'll want to use the **mutation mode**. This is the same mode used by React DOM, React ART, and the classic React Native renderer.
+         *
+         * ```js
+         * const HostConfig = {
+         *   // ...
+         *   supportsMutation: true,
+         *   // ...
+         * }
+         * ```
+         *
+         * Depending on the mode, the reconciler will call different methods on your host config.
+         *
+         * If you're not sure which one you want, you likely need the mutation mode.
+         */
+        supportsMutation: boolean;
+
+        /**
+         * The reconciler has two modes: mutation mode and persistent mode. You must specify one of them.
+         *
+         * If your target platform has immutable trees, you'll want the **persistent mode** instead. In that mode, existing nodes are never mutated, and instead every change clones the parent tree and then replaces the whole parent tree at the root. This is the node used by the new React Native renderer, codenamed "Fabric".
+         *
+         * ```js
+         * const HostConfig = {
+         *   // ...
+         *   supportsPersistence: true,
+         *   // ...
+         * }
+         * ```
+         *
+         * Depending on the mode, the reconciler will call different methods on your host config.
+         *
+         * If you're not sure which one you want, you likely need the mutation mode.
+         */
+        supportsPersistence: boolean;
+
+        // -------------------
+        //    Core Methods
+        // -------------------
+
+        /**
+         * This method should return a newly created node. For example, the DOM renderer would call `document.createElement(type)` here and then set the properties from `props`.
+         *
+         * You can use `rootContainer` to access the root container associated with that tree. For example, in the DOM renderer, this is useful to get the correct `document` reference that the root belongs to.
+         *
+         * The `hostContext` parameter lets you keep track of some information about your current place in the tree. To learn more about it, see `getChildHostContext` below.
+         *
+         * The `internalHandle` data structure is meant to be opaque. If you bend the rules and rely on its internal fields, be aware that it may change significantly between versions. You're taking on additional maintenance risk by reading from it, and giving up all guarantees if you write something to it.
+         *
+         * This method happens **in the render phase**. It can (and usually should) mutate the node it has just created before returning it, but it must not modify any other nodes. It must not register any event handlers on the parent tree. This is because an instance being created doesn't guarantee it would be placed in the tree — it could be left unused and later collected by GC. If you need to do something when an instance is definitely in the tree, look at `commitMount` instead.
+         */
+        createInstance(
+            type: Type,
+            props: Props,
+            rootContainer: Container,
+            hostContext: HostContext,
+            internalHandle: OpaqueHandle,
+        ): Instance;
+
+        /**
+         * Same as `createInstance`, but for text nodes. If your renderer doesn't support text nodes, you can throw here.
+         */
+        createTextInstance(
+            text: string,
+            rootContainer: Container,
+            hostContext: HostContext,
+            internalHandle: OpaqueHandle,
+        ): TextInstance;
+
+        /**
+         * This method should mutate the `parentInstance` and add the child to its list of children. For example, in the DOM this would translate to a `parentInstance.appendChild(child)` call.
+         *
+         * This method happens **in the render phase**. It can mutate `parentInstance` and `child`, but it must not modify any other nodes. It's called while the tree is still being built up and not connected to the actual tree on the screen.
+         */
+        appendInitialChild(parentInstance: Instance, child: Instance | TextInstance): void;
+
+        /**
+         * In this method, you can perform some final mutations on the `instance`. Unlike with `createInstance`, by the time `finalizeInitialChildren` is called, all the initial children have already been added to the `instance`, but the instance itself has not yet been connected to the tree on the screen.
+         *
+         * This method happens **in the render phase**. It can mutate `instance`, but it must not modify any other nodes. It's called while the tree is still being built up and not connected to the actual tree on the screen.
+         *
+         * There is a second purpose to this method. It lets you specify whether there is some work that needs to happen when the node is connected to the tree on the screen. If you return `true`, the instance will receive a `commitMount` call later. See its documentation below.
+         *
+         * If you don't want to do anything here, you should return `false`.
+         */
+        finalizeInitialChildren(
+            instance: Instance,
+            type: Type,
+            props: Props,
+            rootContainer: Container,
+            hostContext: HostContext,
+        ): boolean;
+
+        /**
+         * Some target platforms support setting an instance's text content without manually creating a text node. For example, in the DOM, you can set `node.textContent` instead of creating a text node and appending it.
+         *
+         * If you return `true` from this method, React will assume that this node's children are text, and will not create nodes for them. It will instead rely on you to have filled that text during `createInstance`. This is a performance optimization. For example, the DOM renderer returns `true` only if `type` is a known text-only parent (like `'textarea'`) or if `props.children` has a `'string'` type. If you return `true`, you will need to implement `resetTextContent` too.
+         *
+         * If you don't want to do anything here, you should return `false`.
+         *
+         * This method happens **in the render phase**. Do not mutate the tree from it.
+         */
+        shouldSetTextContent(type: Type, props: Props): boolean;
+
+        /**
+         * This method lets you return the initial host context from the root of the tree. See `getChildHostContext` for the explanation of host context.
+         *
+         * If you don't intend to use host context, you can return `null`.
+         *
+         * This method happens **in the render phase**. Do not mutate the tree from it.
+         */
+        getRootHostContext(rootContainer: Container): HostContext | null;
+
+        /**
+         * Host context lets you track some information about where you are in the tree so that it's available inside `createInstance` as the `hostContext` parameter. For example, the DOM renderer uses it to track whether it's inside an HTML or an SVG tree, because `createInstance` implementation needs to be different for them.
+         *
+         * If the node of this `type` does not influence the context you want to pass down, you can return `parentHostContext`. Alternatively, you can return any custom object representing the information you want to pass down.
+         *
+         * If you don't want to do anything here, return `parentHostContext`.
+         *
+         * This method happens **in the render phase**. Do not mutate the tree from it.
+         */
+        getChildHostContext(parentHostContext: HostContext, type: Type, rootContainer: Container): HostContext;
+
+        /**
+         * Determines what object gets exposed as a ref. You'll likely want to return the `instance` itself. But in some cases it might make sense to only expose some part of it.
+         *
+         * If you don't want to do anything here, return `instance`.
+         */
+        getPublicInstance(instance: Instance | TextInstance): PublicInstance;
+
+        /**
+         * This method lets you store some information before React starts making changes to the tree on the screen. For example, the DOM renderer stores the current text selection so that it can later restore it. This method is mirrored by `resetAfterCommit`.
+         *
+         * Even if you don't want to do anything here, you need to return `null` from it.
+         */
+        prepareForCommit(containerInfo: Container): Record<string, any> | null;
+
+        /**
+         * This method is called right after React has performed the tree mutations. You can use it to restore something you've stored in `prepareForCommit` — for example, text selection.
+         *
+         * You can leave it empty.
+         */
+        resetAfterCommit(containerInfo: Container): void;
+
+        /**
+         * This method is called for a container that's used as a portal target. Usually you can leave it empty.
+         */
+        preparePortalMount(containerInfo: Container): void;
+
+        /**
+         * You can proxy this to `setTimeout` or its equivalent in your environment.
+         */
+        scheduleTimeout(fn: (...args: unknown[]) => unknown, delay?: number): TimeoutHandle;
+
+        /**
+         * You can proxy this to `clearTimeout` or its equivalent in your environment.
+         */
+        cancelTimeout(id: TimeoutHandle): void;
+
+        /**
+         * This is a property (not a function) that should be set to something that can never be a valid timeout ID. For example, you can set it to `-1`.
+         */
+        noTimeout: NoTimeout;
+
+        /**
+         * Set this to true to indicate that your renderer supports `scheduleMicrotask`. We use microtasks as part of our discrete event implementation in React DOM. If you're not sure if your renderer should support this, you probably should. The option to not implement `scheduleMicrotask` exists so that platforms with more control over user events, like React Native, can choose to use a different mechanism.
+         */
+        supportsMicrotasks?: boolean;
+
+        /**
+         * Optional. You can proxy this to `queueMicrotask` or its equivalent in your environment.
+         */
+        scheduleMicrotask?(fn: () => unknown): void;
+
+        /**
+         * This is a property (not a function) that should be set to `true` if your renderer is the main one on the page. For example, if you're writing a renderer for the Terminal, it makes sense to set it to `true`, but if your renderer is used *on top of* React DOM or some other existing renderer, set it to `false`.
+         */
+        isPrimaryRenderer: boolean;
+
+        /**
+         * Whether the renderer shouldn't trigger missing `act()` warnings
+         */
+        warnsIfNotActing?: boolean;
+
+        getInstanceFromNode(node: any): Fiber | null | undefined;
+
+        beforeActiveInstanceBlur(): void;
+
+        afterActiveInstanceBlur(): void;
+
+        prepareScopeUpdate(scopeInstance: any, instance: any): void;
+
+        getInstanceFromScope(scopeInstance: any): null | Instance;
+
+        detachDeletedInstance(node: Instance): void;
+
+        // -------------------
+        //  Mutation Methods
+        //    (optional)
+        //  If you're using React in mutation mode (you probably do), you'll need to implement a few more methods.
+        // -------------------
+
+        /**
+         * This method should mutate the `parentInstance` and add the child to its list of children. For example, in the DOM this would translate to a `parentInstance.appendChild(child)` call.
+         *
+         * Although this method currently runs in the commit phase, you still should not mutate any other nodes in it. If you need to do some additional work when a node is definitely connected to the visible tree, look at `commitMount`.
+         */
+        appendChild?(parentInstance: Instance, child: Instance | TextInstance): void;
+
+        /**
+         * Same as `appendChild`, but for when a node is attached to the root container. This is useful if attaching to the root has a slightly different implementation, or if the root container nodes are of a different type than the rest of the tree.
+         */
+        appendChildToContainer?(container: Container, child: Instance | TextInstance): void;
+
+        /**
+         * This method should mutate the `parentInstance` and place the `child` before `beforeChild` in the list of its children. For example, in the DOM this would translate to a `parentInstance.insertBefore(child, beforeChild)` call.
+         *
+         * Note that React uses this method both for insertions and for reordering nodes. Similar to DOM, it is expected that you can call `insertBefore` to reposition an existing child. Do not mutate any other parts of the tree from it.
+         */
+        insertBefore?(
+            parentInstance: Instance,
+            child: Instance | TextInstance,
+            beforeChild: Instance | TextInstance | SuspenseInstance,
+        ): void;
+
+        /**
+         * Same as `insertBefore`, but for when a node is attached to the root container. This is useful if attaching to the root has a slightly different implementation, or if the root container nodes are of a different type than the rest of the tree.
+         */
+        insertInContainerBefore?(
+            container: Container,
+            child: Instance | TextInstance,
+            beforeChild: Instance | TextInstance | SuspenseInstance,
+        ): void;
+
+        /**
+         * This method should mutate the `parentInstance` to remove the `child` from the list of its children.
+         *
+         * React will only call it for the top-level node that is being removed. It is expected that garbage collection would take care of the whole subtree. You are not expected to traverse the child tree in it.
+         */
+        removeChild?(parentInstance: Instance, child: Instance | TextInstance | SuspenseInstance): void;
+
+        /**
+         * Same as `removeChild`, but for when a node is detached from the root container. This is useful if attaching to the root has a slightly different implementation, or if the root container nodes are of a different type than the rest of the tree.
+         */
+        removeChildFromContainer?(container: Container, child: Instance | TextInstance | SuspenseInstance): void;
+
+        /**
+         * If you returned `true` from `shouldSetTextContent` for the previous props, but returned `false` from `shouldSetTextContent` for the next props, React will call this method so that you can clear the text content you were managing manually. For example, in the DOM you could set `node.textContent = ''`.
+         *
+         * If you never return `true` from `shouldSetTextContent`, you can leave it empty.
+         */
+        resetTextContent?(instance: Instance): void;
+
+        /**
+         * This method should mutate the `textInstance` and update its text content to `nextText`.
+         *
+         * Here, `textInstance` is a node created by `createTextInstance`.
+         */
+        commitTextUpdate?(textInstance: TextInstance, oldText: string, newText: string): void;
+
+        /**
+         * This method is only called if you returned `true` from `finalizeInitialChildren` for this instance.
+         *
+         * It lets you do some additional work after the node is actually attached to the tree on the screen for the first time. For example, the DOM renderer uses it to trigger focus on nodes with the `autoFocus` attribute.
+         *
+         * Note that `commitMount` does not mirror `removeChild` one to one because `removeChild` is only called for the top-level removed node. This is why ideally `commitMount` should not mutate any nodes other than the `instance` itself. For example, if it registers some events on some node above, it will be your responsibility to traverse the tree in `removeChild` and clean them up, which is not ideal.
+         *
+         * The `internalHandle` data structure is meant to be opaque. If you bend the rules and rely on its internal fields, be aware that it may change significantly between versions. You're taking on additional maintenance risk by reading from it, and giving up all guarantees if you write something to it.
+         *
+         * If you never return `true` from `finalizeInitialChildren`, you can leave it empty.
+         */
+        commitMount?(instance: Instance, type: Type, props: Props, internalInstanceHandle: OpaqueHandle): void;
+
+        /**
+         * This method should mutate the instance to match nextProps.
+         *
+         * The internalHandle data structure is meant to be opaque. If you bend the rules and rely on its internal fields, be aware that it may change significantly between versions. You're taking on additional maintenance risk by reading from it, and giving up all guarantees if you write something to it.
+         */
+        commitUpdate?(
+            instance: Instance,
+            type: Type,
+            prevProps: Props,
+            nextProps: Props,
+            internalHandle: OpaqueHandle,
+        ): void;
+
+        /**
+         * This method should make the `instance` invisible without removing it from the tree. For example, it can apply visual styling to hide it. It is used by Suspense to hide the tree while the fallback is visible.
+         */
+        hideInstance?(instance: Instance): void;
+
+        /**
+         * Same as `hideInstance`, but for nodes created by `createTextInstance`.
+         */
+        hideTextInstance?(textInstance: TextInstance): void;
+
+        /**
+         * This method should make the `instance` visible, undoing what `hideInstance` did.
+         */
+        unhideInstance?(instance: Instance, props: Props): void;
+
+        /**
+         * Same as `unhideInstance`, but for nodes created by `createTextInstance`.
+         */
+        unhideTextInstance?(textInstance: TextInstance, text: string): void;
+
+        /**
+         * This method should mutate the `container` root node and remove all children from it.
+         */
+        clearContainer?(container: Container): void;
+
+        // -------------------
+        // Persistence Methods
+        //    (optional)
+        //  If you use the persistent mode instead of the mutation mode, you would still need the "Core Methods". However, instead of the Mutation Methods above you will implement a different set of methods that performs cloning nodes and replacing them at the root level. You can find a list of them in the "Persistence" section [listed in this file](https://github.com/facebook/react/blob/master/packages/react-reconciler/src/forks/ReactFiberConfig.custom.js). File an issue if you need help.
+        // -------------------
+        cloneInstance?(
+            instance: Instance,
+            type: Type,
+            oldProps: Props,
+            newProps: Props,
+            keepChildren: boolean,
+            recyclableInstance: null | Instance,
+        ): Instance;
+        createContainerChildSet?(container: Container): ChildSet;
+        appendChildToContainerChildSet?(childSet: ChildSet, child: Instance | TextInstance): void;
+        finalizeContainerChildren?(container: Container, newChildren: ChildSet): void;
+        replaceContainerChildren?(container: Container, newChildren: ChildSet): void;
+        cloneHiddenInstance?(
+            instance: Instance,
+            type: Type,
+            props: Props,
+            internalInstanceHandle: OpaqueHandle,
+        ): Instance;
+        cloneHiddenTextInstance?(instance: Instance, text: Type, internalInstanceHandle: OpaqueHandle): TextInstance;
+
+        // -------------------
+        // Hydration Methods
+        //    (optional)
+        // You can optionally implement hydration to "attach" to the existing tree during the initial render instead of creating it from scratch. For example, the DOM renderer uses this to attach to an HTML markup.
+        //
+        // To support hydration, you need to declare `supportsHydration: true` and then implement the methods in the "Hydration" section [listed in this file](https://github.com/facebook/react/blob/master/packages/react-reconciler/src/forks/ReactFiberConfig.custom.js). File an issue if you need help.
+        // -------------------
+        supportsHydration: boolean;
+
+        canHydrateInstance?(instance: HydratableInstance, type: Type, props: Props): null | Instance;
+
+        canHydrateTextInstance?(instance: HydratableInstance, text: string): null | TextInstance;
+
+        canHydrateSuspenseInstance?(instance: HydratableInstance): null | SuspenseInstance;
+
+        isSuspenseInstancePending?(instance: SuspenseInstance): boolean;
+
+        isSuspenseInstanceFallback?(instance: SuspenseInstance): boolean;
+
+        registerSuspenseInstanceRetry?(instance: SuspenseInstance, callback: () => void): void;
+
+        getNextHydratableSibling?(instance: HydratableInstance): null | HydratableInstance;
+
+        getFirstHydratableChild?(parentInstance: Container | Instance): null | HydratableInstance;
+
+        hydrateInstance?(
+            instance: Instance,
+            type: Type,
+            props: Props,
+            rootContainerInstance: Container,
+            hostContext: HostContext,
+            internalInstanceHandle: any,
+        ): null | any[];
+
+        hydrateTextInstance?(textInstance: TextInstance, text: string, internalInstanceHandle: any): boolean;
+
+        hydrateSuspenseInstance?(suspenseInstance: SuspenseInstance, internalInstanceHandle: any): void;
+
+        getNextHydratableInstanceAfterSuspenseInstance?(suspenseInstance: SuspenseInstance): null | HydratableInstance;
+
+        // Returns the SuspenseInstance if this node is a direct child of a
+        // SuspenseInstance. I.e. if its previous sibling is a Comment with
+        // SUSPENSE_x_START_DATA. Otherwise, null.
+        getParentSuspenseInstance?(targetInstance: any): null | SuspenseInstance;
+
+        commitHydratedContainer?(container: Container): void;
+
+        commitHydratedSuspenseInstance?(suspenseInstance: SuspenseInstance): void;
+
+        didNotMatchHydratedContainerTextInstance?(
+            parentContainer: Container,
+            textInstance: TextInstance,
+            text: string,
+        ): void;
+
+        didNotMatchHydratedTextInstance?(
+            parentType: Type,
+            parentProps: Props,
+            parentInstance: Instance,
+            textInstance: TextInstance,
+            text: string,
+        ): void;
+
+        didNotHydrateContainerInstance?(parentContainer: Container, instance: HydratableInstance): void;
+
+        didNotHydrateInstance?(
+            parentType: Type,
+            parentProps: Props,
+            parentInstance: Instance,
+            instance: HydratableInstance,
+        ): void;
+
+        didNotFindHydratableContainerInstance?(parentContainer: Container, type: Type, props: Props): void;
+
+        didNotFindHydratableContainerTextInstance?(parentContainer: Container, text: string): void;
+
+        didNotFindHydratableContainerSuspenseInstance?(parentContainer: Container): void;
+
+        didNotFindHydratableInstance?(
+            parentType: Type,
+            parentProps: Props,
+            parentInstance: Instance,
+            type: Type,
+            props: Props,
+        ): void;
+
+        didNotFindHydratableTextInstance?(
+            parentType: Type,
+            parentProps: Props,
+            parentInstance: Instance,
+            text: string,
+        ): void;
+
+        didNotFindHydratableSuspenseInstance?(parentType: Type, parentProps: Props, parentInstance: Instance): void;
+
+        errorHydratingContainer?(parentContainer: Container): void;
+
+        // Undocumented
+        // https://github.com/facebook/react/pull/26722
+        NotPendingTransition: TransitionStatus | null;
+        HostTransitionContext: ReactContext<TransitionStatus>;
+
+        // https://github.com/facebook/react/pull/28751
+        setCurrentUpdatePriority(newPriority: EventPriority): void;
+        getCurrentUpdatePriority(): EventPriority;
+        resolveUpdatePriority(): EventPriority;
+
+        // https://github.com/facebook/react/pull/28804
+        resetFormInstance(form: FormInstance): void;
+
+        // https://github.com/facebook/react/pull/25105
+        requestPostPaintCallback(callback: (time: number) => void): void;
+
+        // https://github.com/facebook/react/pull/26025
+        shouldAttemptEagerTransition(): boolean;
+
+        // https://github.com/facebook/react/pull/31528
+        trackSchedulerEvent(): void;
+
+        // https://github.com/facebook/react/pull/31008
+        resolveEventType(): null | string;
+        resolveEventTimeStamp(): number;
+
+        /**
+         * This method is called during render to determine if the Host Component type and props require some kind of loading process to complete before committing an update.
+         */
+        maySuspendCommit(type: Type, props: Props): boolean;
+
+        /**
+         * This method may be called during render if the Host Component type and props might suspend a commit. It can be used to initiate any work that might shorten the duration of a suspended commit.
+         */
+        preloadInstance(type: Type, props: Props): boolean;
+
+        /**
+         * This method is called just before the commit phase. Use it to set up any necessary state while any Host Components that might suspend this commit are evaluated to determine if the commit must be suspended.
+         */
+        startSuspendingCommit(): void;
+
+        /**
+         * This method is called after `startSuspendingCommit` for each Host Component that indicated it might suspend a commit.
+         */
+        suspendInstance(type: Type, props: Props): void;
+
+        /**
+         * This method is called after all `suspendInstance` calls are complete.
+         *
+         * Return `null` if the commit can happen immediately.
+         *
+         * Return `(initiateCommit: Function) => Function` if the commit must be suspended. The argument to this callback will initiate the commit when called. The return value is a cancellation function that the Reconciler can use to abort the commit.
+         */
+        waitForCommitToBeReady():
+            | ((initiateCommit: (...args: unknown[]) => unknown) => (...args: unknown[]) => unknown)
+            | null;
+    }
+
+    interface Thenable<T> {
+        then(resolve: () => T, reject?: () => T): T;
+    }
+
+    type RootTag = 0 | 1 | 2;
+
+    type WorkTag =
+        | 0
+        | 1
+        | 2
+        | 3
+        | 4
+        | 5
+        | 6
+        | 7
+        | 8
+        | 9
+        | 10
+        | 11
+        | 12
+        | 13
+        | 14
+        | 15
+        | 16
+        | 17
+        | 18
+        | 19
+        | 20
+        | 21
+        | 22
+        | 23
+        | 24;
+
+    type HookType =
+        | "useState"
+        | "useReducer"
+        | "useContext"
+        | "useRef"
+        | "useEffect"
+        | "useLayoutEffect"
+        | "useCallback"
+        | "useMemo"
+        | "useImperativeHandle"
+        | "useDebugValue"
+        | "useDeferredValue"
+        | "useTransition"
+        | "useMutableSource"
+        | "useOpaqueIdentifier"
+        | "useCacheRefresh";
+
+    interface Source {
+        fileName: string;
+        lineNumber: number;
+    }
+
+    // TODO: Ideally these types would be opaque but that doesn't work well with
+    // our reconciler fork infra, since these leak into non-reconciler packages.
+    type LanePriority = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17;
+
+    type Lanes = number;
+    type Lane = number;
+
+    type Flags = number;
+
+    type TypeOfMode = number;
+
+    type EventPriority = number;
+
+    interface ReactProvider<T> {
+        $$typeof: symbol | number;
+        type: ReactProviderType<T>;
+        key: null | string;
+        ref: null;
+        props: {
+            value: T;
+            children?: ReactNode;
+        };
+    }
+
+    interface ReactProviderType<T> {
+        $$typeof: symbol | number;
+        _context: ReactContext<T>;
+    }
+
+    interface ReactConsumer<T> {
+        $$typeof: symbol | number;
+        type: ReactContext<T>;
+        key: null | string;
+        ref: null;
+        props: {
+            children: (value: T) => ReactNode;
+            unstable_observedBits?: number;
+        };
+    }
+
+    interface ReactContext<T> {
+        $$typeof: symbol | number;
+        Consumer: ReactContext<T>;
+        Provider: ReactProviderType<T>;
+        _currentValue: T;
+        _currentValue2: T;
+        _threadCount: number;
+        // DEV only
+        _currentRenderer?: {
+            [key: string]: any;
+        } | null;
+        _currentRenderer2?: {
+            [key: string]: any;
+        } | null;
+        // This value may be added by application code
+        // to improve DEV tooling display names
+        displayName?: string;
+    }
+
+    interface ReactPortal {
+        $$typeof: symbol | number;
+        key: null | string;
+        containerInfo: any;
+        children: ReactNode;
+        // TODO: figure out the API for cross-renderer implementation.
+        implementation: any;
+    }
+
+    interface RefObject {
+        current: any;
+    }
+
+    interface ContextDependency<T> {
+        context: ReactContext<T>;
+        observedBits: number;
+        next: ContextDependency<unknown> | null;
+    }
+
+    interface Dependencies {
+        lanes: Lanes;
+        firstContext: ContextDependency<unknown> | null;
+    }
+
+    interface Fiber {
+        // These first fields are conceptually members of an Instance. This used to
+        // be split into a separate type and intersected with the other Fiber fields,
+        // but until Flow fixes its intersection bugs, we've merged them into a
+        // single type.
+
+        // An Instance is shared between all versions of a component. We can easily
+        // break this out into a separate object to avoid copying so much to the
+        // alternate versions of the tree. We put this on a single object for now to
+        // minimize the number of objects created during the initial render.
+
+        // Tag identifying the type of fiber.
+        tag: WorkTag;
+
+        // Unique identifier of this child.
+        key: null | string;
+
+        // The value of element.type which is used to preserve the identity during
+        // reconciliation of this child.
+        elementType: any;
+
+        // The resolved function/class/ associated with this fiber.
+        type: any;
+
+        // The local state associated with this fiber.
+        stateNode: any;
+
+        // Conceptual aliases
+        // parent : Instance -> return The parent happens to be the same as the
+        // return fiber since we've merged the fiber and instance.
+
+        // Remaining fields belong to Fiber
+
+        // The Fiber to return to after finishing processing this one.
+        // This is effectively the parent, but there can be multiple parents (two)
+        // so this is only the parent of the thing we're currently processing.
+        // It is conceptually the same as the return address of a stack frame.
+        return: Fiber | null;
+
+        // Singly Linked List Tree Structure.
+        child: Fiber | null;
+        sibling: Fiber | null;
+        index: number;
+
+        // The ref last used to attach this node.
+        // I'll avoid adding an owner field for prod and model that as functions.
+        ref:
+            | null
+            | (((handle: unknown) => void) & {
+                _stringRef?: string | null;
+            })
+            | RefObject;
+
+        // Input is the data coming into process this fiber. Arguments. Props.
+        pendingProps: any; // This type will be more specific once we overload the tag.
+        memoizedProps: any; // The props used to create the output.
+
+        // A queue of state updates and callbacks.
+        updateQueue: unknown;
+
+        // The state used to create the output
+        memoizedState: any;
+
+        // Dependencies (contexts, events) for this fiber, if it has any
+        dependencies: Dependencies | null;
+
+        // Bitfield that describes properties about the fiber and its subtree. E.g.
+        // the ConcurrentMode flag indicates whether the subtree should be async-by-
+        // default. When a fiber is created, it inherits the mode of its
+        // parent. Additional flags can be set at creation time, but after that the
+        // value should remain unchanged throughout the fiber's lifetime, particularly
+        // before its child fibers are created.
+        mode: TypeOfMode;
+
+        // Effect
+        flags: Flags;
+        subtreeFlags: Flags;
+        deletions: Fiber[] | null;
+
+        // Singly linked list fast path to the next fiber with side-effects.
+        nextEffect: Fiber | null;
+
+        // The first and last fiber with side-effect within this subtree. This allows
+        // us to reuse a slice of the linked list when we reuse the work done within
+        // this fiber.
+        firstEffect: Fiber | null;
+        lastEffect: Fiber | null;
+
+        lanes: Lanes;
+        childLanes: Lanes;
+
+        // This is a pooled version of a Fiber. Every fiber that gets updated will
+        // eventually have a pair. There are cases when we can clean up pairs to save
+        // memory if we need to.
+        alternate: Fiber | null;
+
+        // Time spent rendering this Fiber and its descendants for the current update.
+        // This tells us how well the tree makes use of sCU for memoization.
+        // It is reset to 0 each time we render and only updated when we don't bailout.
+        // This field is only set when the enableProfilerTimer flag is enabled.
+        actualDuration?: number;
+
+        // If the Fiber is currently active in the "render" phase,
+        // This marks the time at which the work began.
+        // This field is only set when the enableProfilerTimer flag is enabled.
+        actualStartTime?: number;
+
+        // Duration of the most recent render time for this Fiber.
+        // This value is not updated when we bailout for memoization purposes.
+        // This field is only set when the enableProfilerTimer flag is enabled.
+        selfBaseDuration?: number;
+
+        // Sum of base times for all descendants of this Fiber.
+        // This value bubbles up during the "complete" phase.
+        // This field is only set when the enableProfilerTimer flag is enabled.
+        treeBaseDuration?: number;
+
+        // Conceptual aliases
+        // workInProgress : Fiber ->  alternate The alternate used for reuse happens
+        // to be the same as work in progress.
+        // __DEV__ only
+        _debugID?: number;
+        _debugSource?: Source | null;
+        _debugOwner?: Fiber | null;
+        _debugIsCurrentlyTiming?: boolean;
+        _debugNeedsRemount?: boolean;
+
+        // Used to verify that the order of hooks does not change between renders.
+        _debugHookTypes?: HookType[] | null;
+    }
+
+    type FiberRoot = any;
+
+    // Concurrent related struct
+    type MutableSource = any;
+
+    type OpaqueHandle = any;
+    type OpaqueRoot = any;
+
+    // 0 is PROD, 1 is DEV.
+    // Might add PROFILE later.
+    type BundleType = 0 | 1;
+
+    interface DevToolsConfig<Instance, TextInstance, RendererInspectionConfig> {
+        bundleType: BundleType;
+        version: string;
+        rendererPackageName: string;
+        // Note: this actually *does* depend on Fiber internal fields.
+        // Used by "inspect clicked DOM element" in React DevTools.
+        findFiberByHostInstance?: (instance: Instance | TextInstance) => Fiber | null;
+        rendererConfig?: RendererInspectionConfig;
+    }
+
+    interface SuspenseHydrationCallbacks<SuspenseInstance> {
+        onHydrated?: (suspenseInstance: SuspenseInstance) => void;
+        onDeleted?: (suspenseInstance: SuspenseInstance) => void;
+    }
+
+    interface TransitionTracingCallbacks {
+        onTransitionStart?: (transitionName: string, startTime: number) => void;
+        onTransitionProgress?: (
+            transitionName: string,
+            startTime: number,
+            currentTime: number,
+            pending: Array<{ name: null | string }>,
+        ) => void;
+        onTransitionIncomplete?: (
+            transitionName: string,
+            startTime: number,
+            deletions: Array<{
+                type: string;
+                name?: string;
+                newName?: string;
+                endTime: number;
+            }>,
+        ) => void;
+        onTransitionComplete?: (transitionName: string, startTime: number, endTime: number) => void;
+        onMarkerProgress?: (
+            transitionName: string,
+            marker: string,
+            startTime: number,
+            currentTime: number,
+            pending: Array<{ name: null | string }>,
+        ) => void;
+        onMarkerIncomplete?: (
+            transitionName: string,
+            marker: string,
+            startTime: number,
+            deletions: Array<{
+                type: string;
+                name?: string;
+                newName?: string;
+                endTime: number;
+            }>,
+        ) => void;
+        onMarkerComplete?: (transitionName: string, marker: string, startTime: number, endTime: number) => void;
+    }
+
+    interface ComponentSelector {
+        $$typeof: symbol | number;
+        value: React$AbstractComponent<never, unknown>;
+    }
+
+    interface HasPseudoClassSelector {
+        $$typeof: symbol | number;
+        value: Selector[];
+    }
+
+    interface RoleSelector {
+        $$typeof: symbol | number;
+        value: string;
+    }
+
+    interface TextSelector {
+        $$typeof: symbol | number;
+        value: string;
+    }
+
+    interface TestNameSelector {
+        $$typeof: symbol | number;
+        value: string;
+    }
+
+    type Selector = ComponentSelector | HasPseudoClassSelector | RoleSelector | TextSelector | TestNameSelector;
+
+    // TODO can not find React$AbstractComponent def
+    type React$AbstractComponent<Config, Instance = any> = any;
+
+    interface BoundingRect {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }
+
+    type IntersectionObserverOptions = any;
+
+    interface BaseErrorInfo {
+        componentStack?: string;
+    }
+
+    interface Reconciler<Container, Instance, TextInstance, SuspenseInstance, FormInstance, PublicInstance> {
+        createContainer(
+            containerInfo: Container,
+            tag: RootTag,
+            hydrationCallbacks: null | SuspenseHydrationCallbacks<SuspenseInstance>,
+            isStrictMode: boolean,
+            concurrentUpdatesByDefaultOverride: null | boolean,
+            identifierPrefix: string,
+            onUncaughtError: (error: Error, info: BaseErrorInfo & { errorBoundary?: Component }) => void,
+            onCaughtError: (error: Error, info: BaseErrorInfo) => void,
+            onRecoverableError: (error: Error, info: BaseErrorInfo) => void,
+            onDefaultTransitionIndicator: () => void,
+            transitionCallbacks: null | TransitionTracingCallbacks,
+        ): OpaqueRoot;
+
+        createPortal(
+            children: ReactNode,
+            containerInfo: any, // TODO: figure out the API for cross-renderer implementation.
+            implementation: any,
+            key?: string | null,
+        ): ReactPortal;
+
+        registerMutableSourceForHydration(root: FiberRoot, mutableSource: MutableSource): void;
+
+        createComponentSelector(component: React$AbstractComponent<never, unknown>): ComponentSelector;
+
+        createHasPseudoClassSelector(selectors: Selector[]): HasPseudoClassSelector;
+
+        createRoleSelector(role: string): RoleSelector;
+
+        createTextSelector(text: string): TextSelector;
+
+        createTestNameSelector(id: string): TestNameSelector;
+
+        getFindAllNodesFailureDescription(hostRoot: Instance, selectors: Selector[]): string | null;
+
+        findAllNodes(hostRoot: Instance, selectors: Selector[]): Instance[];
+
+        findBoundingRects(hostRoot: Instance, selectors: Selector[]): BoundingRect[];
+
+        focusWithin(hostRoot: Instance, selectors: Selector[]): boolean;
+
+        observeVisibleRects(
+            hostRoot: Instance,
+            selectors: Selector[],
+            callback: (intersections: Array<{ ratio: number; rect: BoundingRect }>) => void,
+            options?: IntersectionObserverOptions,
+        ): { disconnect: () => void };
+
+        createHydrationContainer(
+            initialChildren: ReactNode,
+            callback: (() => void) | null | undefined,
+            containerInfo: Container,
+            tag: RootTag,
+            hydrationCallbacks: null | SuspenseHydrationCallbacks<SuspenseInstance>,
+            isStrictMode: boolean,
+            concurrentUpdatesByDefaultOverride: null | boolean,
+            identifierPrefix: string,
+            onRecoverableError: (error: Error) => void,
+            transitionCallbacks: null | TransitionTracingCallbacks,
+        ): OpaqueRoot;
+
+        updateContainer(
+            element: ReactNode,
+            container: OpaqueRoot,
+            parentComponent?: Component<any, any> | null,
+            callback?: (() => void) | null,
+        ): Lane;
+
+        batchedUpdates<A, R>(fn: (a: A) => R, a: A): R;
+
+        deferredUpdates<A>(fn: () => A): A;
+
+        discreteUpdates<A, B, C, D, R>(fn: (arg0: A, arg1: B, arg2: C, arg3: D) => R, a: A, b: B, c: C, d: D): R;
+
+        flushControlled(fn: () => any): void;
+
+        flushSync(): void;
+        flushSync<R>(fn: () => R): R;
+
+        isAlreadyRendering(): boolean;
+
+        flushPassiveEffects(): boolean;
+
+        getPublicRootInstance(container: OpaqueRoot): Component<any, any> | PublicInstance | null;
+
+        attemptSynchronousHydration(fiber: Fiber): void;
+
+        attemptDiscreteHydration(fiber: Fiber): void;
+
+        attemptContinuousHydration(fiber: Fiber): void;
+
+        attemptHydrationAtCurrentPriority(fiber: Fiber): void;
+
+        getCurrentUpdatePriority(): LanePriority;
+
+        runWithPriority<T>(priority: LanePriority, fn: () => T): T;
+
+        findHostInstance(component: any): PublicInstance | null;
+
+        findHostInstanceWithWarning(component: any, methodName: string): PublicInstance | null;
+
+        findHostInstanceWithNoPortals(fiber: Fiber): PublicInstance | null;
+
+        shouldError(fiber: Fiber): boolean | undefined;
+
+        shouldSuspend(fiber: Fiber): boolean;
+
+        injectIntoDevTools(devToolsConfig: DevToolsConfig<Instance, TextInstance, any>): boolean;
+    }
+}
+
+declare function extend<T extends ConstructorRepresentation>(objects: T): React$1.ExoticComponent<ThreeElement<T>>;
+declare function extend<T extends Catalogue>(objects: T): void;
+declare const reconciler: ReactReconciler.Reconciler<RootStore, Instance<any>, void, Instance<any>, never, any>;
+
+declare const isRenderer: (def: any) => boolean;
+interface OffscreenCanvas extends EventTarget {
+}
+declare const _roots: Map<HTMLCanvasElement | OffscreenCanvas, Root>;
+declare function createRoot<TCanvas extends HTMLCanvasElement | OffscreenCanvas>(canvas: TCanvas): ReconcilerRoot<TCanvas>;
+declare function unmountComponentAtNode<TCanvas extends HTMLCanvasElement | OffscreenCanvas>(canvas: TCanvas, callback?: (canvas: TCanvas) => void): void;
+declare function createPortal(children: ReactNode, container: Object3D | RefObject<Object3D | null> | RefObject<Object3D>, state?: InjectState): JSX.Element;
+/**
+ * Force React to flush any updates inside the provided callback synchronously and immediately.
+ * All the same caveats documented for react-dom's `flushSync` apply here (see https://react.dev/reference/react-dom/flushSync).
+ * Nevertheless, sometimes one needs to render synchronously, for example to keep DOM and 3D changes in lock-step without
+ * having to revert to a non-React solution. Note: this will only flush updates within the `Canvas` root.
+ */
+declare function flushSync<R>(fn: () => R): R;
+
+declare const context: React$1.Context<RootStore>;
+declare const createStore: (invalidate: (state?: RootState, frames?: number, stackFrames?: boolean) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState, frame?: XRFrame) => void) => RootStore;
+
+/**
+ * Safely flush async effects when testing, simulating a legacy root.
+ * @deprecated Import from React instead. import { act } from 'react'
+ */
+declare const act: typeof React$1.act;
+/**
+ * An SSR-friendly useLayoutEffect.
+ *
+ * React currently throws a warning when using useLayoutEffect on the server.
+ * To get around it, we can conditionally useEffect on the server (no-op) and
+ * useLayoutEffect elsewhere.
+ *
+ * @see https://github.com/facebook/react/issues/14927
+ */
+declare const useIsomorphicLayoutEffect: typeof React$1.useLayoutEffect;
+/**
+ * Creates a stable ref that always contains the latest callback.
+ * Useful for avoiding dependency arrays while ensuring the latest closure is called.
+ *
+ * @param fn - The callback function to wrap
+ * @returns A ref containing the current callback
+ */
+declare function useMutableCallback<T>(fn: T): React$1.RefObject<T>;
+/**
+ * Bridges renderer Context and StrictMode from a primary renderer.
+ * Used to maintain React context when rendering into portals or secondary canvases.
+ *
+ * @returns A Bridge component that wraps children with the parent renderer's context
+ */
+declare function useBridge(): Bridge;
+/**
+ * Internal component that blocks rendering until a promise resolves.
+ * Used for suspense-like blocking behavior.
+ *
+ * @param set - Function to set the blocking promise
+ */
+declare function Block({ set }: Omit<UnblockProps, 'children'>): null;
+/**
+ * Error boundary component for catching and handling errors in the React tree.
+ * Forwards errors to a state setter for external handling.
+ *
+ * NOTE: static members get down-level transpiled to mutations which break tree-shaking
+ */
+declare const ErrorBoundary: {
+    new (props: {
+        set: React$1.Dispatch<Error | undefined>;
+        children: React$1.ReactNode;
+    }): {
+        state: {
+            error: boolean;
+        };
+        componentDidCatch(err: Error): void;
+        render(): React$1.ReactNode;
+        context: unknown;
+        setState<K extends "error">(state: {
+            error: boolean;
+        } | ((prevState: Readonly<{
+            error: boolean;
+        }>, props: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>) => {
+            error: boolean;
+        } | Pick<{
+            error: boolean;
+        }, K> | null) | Pick<{
+            error: boolean;
+        }, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>;
+        componentDidMount?(): void;
+        shouldComponentUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, prevState: Readonly<{
+            error: boolean;
+        }>): any;
+        componentDidUpdate?(prevProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, prevState: Readonly<{
+            error: boolean;
+        }>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): void;
+    };
+    new (props: {
+        set: React$1.Dispatch<Error | undefined>;
+        children: React$1.ReactNode;
+    }, context: any): {
+        state: {
+            error: boolean;
+        };
+        componentDidCatch(err: Error): void;
+        render(): React$1.ReactNode;
+        context: unknown;
+        setState<K extends "error">(state: {
+            error: boolean;
+        } | ((prevState: Readonly<{
+            error: boolean;
+        }>, props: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>) => {
+            error: boolean;
+        } | Pick<{
+            error: boolean;
+        }, K> | null) | Pick<{
+            error: boolean;
+        }, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>;
+        componentDidMount?(): void;
+        shouldComponentUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, prevState: Readonly<{
+            error: boolean;
+        }>): any;
+        componentDidUpdate?(prevProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, prevState: Readonly<{
+            error: boolean;
+        }>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<{
+            set: React$1.Dispatch<Error | undefined>;
+            children: React$1.ReactNode;
+        }>, nextState: Readonly<{
+            error: boolean;
+        }>, nextContext: any): void;
+    };
+    getDerivedStateFromError: () => {
+        error: boolean;
+    };
+    contextType?: React$1.Context<any> | undefined;
+    propTypes?: any;
+};
+
+/**
+ * React internal props that should not be passed to Three.js objects.
+ */
+declare const REACT_INTERNAL_PROPS: string[];
+/**
+ * Returns the instance's initial (outermost) root.
+ * Traverses through previousRoot links to find the original root store.
+ *
+ * @param instance - R3F instance to find root for
+ * @returns The outermost root store
+ */
+declare function findInitialRoot<T>(instance: Instance<T>): RootStore;
+/**
+ * Returns instance root state.
+ * If the object doesn't have __r3f (e.g., child meshes in primitives/GLTFs),
+ * traverses ancestors to find the nearest managed parent.
+ *
+ * @param obj - Three.js object to get root state for
+ * @returns Root state if found, undefined otherwise
+ */
+declare function getRootState<T extends Object3D = Object3D>(obj: T): RootState | undefined;
+/**
+ * Collects nodes, materials, and meshes from a Three.js Object3D hierarchy.
+ * Handles duplicate material names by appending UUID prefixes.
+ *
+ * @param object - Root object to traverse
+ * @returns ObjectMap containing named nodes, materials, and meshes
+ *
+ * @example
+ * const { nodes, materials, meshes } = buildGraph(gltf.scene)
+ * // Access by name: nodes.Head, materials.Metal, meshes.Body
+ */
+declare function buildGraph(object: Object3D): ObjectMap;
+/**
+ * Disposes an object and all its disposable properties.
+ * Skips Scene objects as they should not be disposed automatically.
+ *
+ * @param obj - Object to dispose
+ */
+declare function dispose<T extends Disposable>(obj: T): void;
+/**
+ * Extracts instance props from React reconciler fiber props.
+ * Filters out React-internal props (children, key, ref).
+ *
+ * @param queue - Pending props from reconciler fiber
+ * @returns Props object without React-internal keys
+ */
+declare function getInstanceProps<T = any>(pendingProps: Record<string, unknown>): Instance<T>['props'];
+/**
+ * Creates or retrieves an R3F instance descriptor for a Three.js object.
+ * Each object in the scene carries a LocalState descriptor (__r3f).
+ *
+ * @param target - Target object to prepare
+ * @param root - Root store for this instance
+ * @param type - String identifier for the object type
+ * @param props - Initial props for the instance
+ * @returns Instance descriptor
+ */
+declare function prepare<T = any>(target: T, root: RootStore, type: string, props: Instance<T>['props']): Instance<T>;
+/**
+ * Triggers an update for an instance.
+ * Calls onUpdate callback and invalidates the frame if necessary.
+ *
+ * @param instance - Instance to invalidate
+ */
+declare function invalidateInstance(instance: Instance): void;
+
+/**
+ * Reserved prop names that should not be applied to Three.js objects.
+ */
+declare const RESERVED_PROPS: string[];
+/**
+ * Resolves a potentially pierced property key (e.g., 'material-color' → material.color).
+ * First tries the entire key as a single property, then attempts piercing.
+ *
+ * @param root - Root object to resolve from
+ * @param key - Property key (may contain dashes for piercing)
+ * @returns Object containing root, key, and target value
+ *
+ * @example
+ * resolve(mesh, 'material-color')
+ * // => { root: mesh.material, key: 'color', target: mesh.material.color }
+ */
+declare function resolve(root: any, key: string): {
+    root: any;
+    key: string;
+    target: any;
+};
+/**
+ * Attaches a child instance to a parent instance.
+ * Handles both string-based attachment (e.g., 'geometry', 'material-map')
+ * and function-based attachment for custom logic.
+ *
+ * @param parent - Parent instance
+ * @param child - Child instance to attach
+ *
+ * @example
+ * // String attachment
+ * <bufferGeometry attach="geometry" />
+ * // Array attachment
+ * <light attach="lights-0" />
+ * // Function attachment
+ * <thing attach={(parent, self) => { parent.customProp = self }} />
+ */
+declare function attach(parent: Instance, child: Instance): void;
+/**
+ * Detaches a child instance from a parent instance.
+ * Restores the previous value or deletes the property if it was never set.
+ *
+ * @param parent - Parent instance
+ * @param child - Child instance to detach
+ */
+declare function detach(parent: Instance, child: Instance): void;
+/**
+ * Compares old and new props to determine which properties have changed.
+ * Also handles resetting removed props for HMR/fast-refresh.
+ *
+ * @param instance - Instance to diff props for
+ * @param newProps - New props to compare against
+ * @returns Object containing only changed props
+ *
+ * @example
+ * const changes = diffProps(instance, { position: [1, 2, 3], color: 'red' })
+ * // => { position: [1, 2, 3] } (only if position changed)
+ */
+declare function diffProps<T = any>(instance: Instance<T>, newProps: Instance<T>['props']): Instance<T>['props'];
+/**
+ * Applies a set of props to a Three.js object.
+ * Handles special cases like colors, vectors, textures, events, and pierced props.
+ *
+ * @param object - Three.js object to apply props to
+ * @param props - Props to apply
+ * @returns The object with props applied
+ *
+ * @example
+ * applyProps(mesh, { position: [0, 1, 0], 'material-color': 'red' })
+ */
+declare function applyProps<T = any>(object: Instance<T>['object'], props: Instance<T>['props']): Instance<T>['object'];
+
+/**
+ * Calculates the device pixel ratio for rendering.
+ * Handles array DPR ranges [min, max] to clamp devicePixelRatio.
+ *
+ * @param dpr - Target DPR value or [min, max] range
+ * @returns Calculated DPR value
+ *
+ * @example
+ * calculateDpr(2) // => 2
+ * calculateDpr([1, 2]) // => clamps window.devicePixelRatio between 1 and 2
+ */
+declare function calculateDpr(dpr: Dpr): number;
+/**
+ * Extracts the first segment of a UUID string (before the first hyphen).
+ * Used for creating unique material names when duplicates exist.
+ *
+ * @param uuid - UUID string to extract prefix from
+ * @returns First segment of the UUID
+ *
+ * @example
+ * getUuidPrefix('a1b2c3d4-e5f6-g7h8-i9j0') // => 'a1b2c3d4'
+ */
+declare function getUuidPrefix(uuid: string): string;
+/**
+ * Updates camera projection based on viewport size.
+ * Adjusts aspect ratio for perspective cameras or bounds for orthographic cameras.
+ * Respects camera.manual flag - manual cameras are not modified.
+ *
+ * @param camera - Camera to update
+ * @param size - Current viewport size
+ */
+declare function updateCamera(camera: ThreeCamera, size: Size): void;
+
+declare const is: {
+    obj: (a: any) => boolean;
+    fun: (a: any) => a is Function;
+    str: (a: any) => a is string;
+    num: (a: any) => a is number;
+    boo: (a: any) => a is boolean;
+    und: (a: any) => boolean;
+    nul: (a: any) => boolean;
+    arr: (a: any) => a is any[];
+    equ(a: any, b: any, { arrays, objects, strict }?: EquConfig): boolean;
+};
+declare const isOrthographicCamera: (def: ThreeCamera) => def is OrthographicCamera;
+declare const isRef: (obj: unknown) => obj is React.RefObject<unknown>;
+declare const isColorRepresentation: (value: unknown) => value is ColorRepresentation$1;
+declare const isObject3D: (object: any) => object is Object3D;
+declare const isTexture: (value: unknown) => value is Texture$1;
+type VectorLike = {
+    set: (...args: any[]) => void;
+    constructor?: Function;
+};
+declare const isVectorLike: (object: unknown) => object is VectorLike;
+type Copyable = {
+    copy: (...args: any[]) => void;
+    constructor?: Function;
+};
+declare const isCopyable: (object: unknown) => object is Copyable;
+declare const hasConstructor: (object: unknown) => object is {
+    constructor?: Function;
+};
+
+/**
+ * A DOM canvas which accepts threejs elements as children.
+ * @see https://docs.pmnd.rs/react-three-fiber/api/canvas
+ */
+declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
+
+export { Block, Canvas, ErrorBoundary, IsObject, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, Scheduler, Texture, _roots, act, addAfterEffect, addEffect, addTail, advance, applyProps, attach, buildGraph, calculateDpr, context, createEvents, createPointerEvents, createPortal, createRoot, createStore, detach, diffProps, dispose, createPointerEvents as events, extend, findInitialRoot, flushSync, getInstanceProps, getRootState, getScheduler, getUuidPrefix, hasConstructor, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isObject3D, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, prepare, reconciler, removeInteractivity, resolve, unmountComponentAtNode, updateCamera, useBridge, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useStore, useTexture, useTextures, useThree };
+export type { Act, AddPhaseOptions, Args, ArgsProp, AttachFnType, AttachType, BaseRendererProps, Bridge, Camera, CameraProps, CanvasProps, Catalogue, Color, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DomEvent, Dpr, ElementProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FilterFunction, FrameCallback, FrameControls, FrameNextCallback, FrameNextControls, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LoaderInstance, LoaderLike, LoaderResult, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, Properties, Quaternion, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, Renderer, RendererFactory, RendererProps, Root, RootState, RootStore, SchedulerApi, SetBlock, Size, Subscription, TextureEntry, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UseFrameNextOptions, UseFrameOptions, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager };