@react-three/fiber 10.0.0-canary.ca63ccd → 10.0.0-canary.da7a768

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/legacy.d.cts CHANGED
@@ -10,7 +10,6 @@ import { FrameTimingState, FrameCallback as FrameCallback$1, SchedulerApi, UseFr
10
10
  export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, Scheduler, SchedulerApi, UseFrameNextOptions, UseFrameOptions, getScheduler } from '@pmndrs/scheduler';
11
11
  import { Options } from 'react-use-measure';
12
12
  import * as react_jsx_runtime from 'react/jsx-runtime';
13
- import { ThreeElement as ThreeElement$1, Euler as Euler$2 } from '@react-three/fiber';
14
13
  import { GroundedSkybox } from 'three/examples/jsm/objects/GroundedSkybox.js';
15
14
 
16
15
  function _mergeNamespaces(n, m) {
@@ -39,9 +38,9 @@ function _mergeNamespaces(n, m) {
39
38
  declare const R3F_BUILD_LEGACY = true;
40
39
  declare const R3F_BUILD_WEBGPU = false;
41
40
 
42
- declare const Inspector: {
43
- new (): {};
44
- };
41
+ type Inspector = never;
42
+ /** Not available on the legacy (WebGL-only) entry. */
43
+ declare function loadInspector(): Promise<never>;
45
44
  declare const WebGPURenderer: {
46
45
  new (): {};
47
46
  };
@@ -59,7 +58,8 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
59
58
  R3F_BUILD_WEBGPU: R3F_BUILD_WEBGPU,
60
59
  RenderTarget: RenderTarget,
61
60
  RenderTargetCompat: WebGLRenderTarget,
62
- WebGPURenderer: WebGPURenderer
61
+ WebGPURenderer: WebGPURenderer,
62
+ loadInspector: loadInspector
63
63
  }, [THREE$1]);
64
64
 
65
65
  //* Utility Types ==============================
@@ -1635,9 +1635,9 @@ type EnvironmentProps = {
1635
1635
  blur?: number;
1636
1636
  backgroundBlurriness?: number;
1637
1637
  backgroundIntensity?: number;
1638
- backgroundRotation?: Euler$2;
1638
+ backgroundRotation?: Euler;
1639
1639
  environmentIntensity?: number;
1640
- environmentRotation?: Euler$2;
1640
+ environmentRotation?: Euler;
1641
1641
  map?: Texture$1;
1642
1642
  preset?: PresetsType;
1643
1643
  scene?: Scene | React$1.RefObject<Scene>;
@@ -1721,7 +1721,7 @@ declare function EnvironmentCube({ background, scene, blur, backgroundBlurriness
1721
1721
  declare function EnvironmentPortal({ children, near, far, resolution, frames, map, background, blur, backgroundBlurriness, backgroundIntensity, backgroundRotation, environmentIntensity, environmentRotation, scene, files, path, preset, extensions, }: EnvironmentProps): react_jsx_runtime.JSX.Element;
1722
1722
  declare module '@react-three/fiber' {
1723
1723
  interface ThreeElements {
1724
- groundProjectedEnvImpl: ThreeElement$1<typeof GroundedSkybox>;
1724
+ groundProjectedEnvImpl: ThreeElement<typeof GroundedSkybox>;
1725
1725
  }
1726
1726
  }
1727
1727
  /**
@@ -1821,6 +1821,24 @@ declare module '@react-three/fiber' {
1821
1821
  */
1822
1822
  declare function Environment(props: EnvironmentProps): react_jsx_runtime.JSX.Element;
1823
1823
 
1824
+ /**
1825
+ * Moves every trace of interactivity from one object to its replacement, for reconstruction.
1826
+ *
1827
+ * When `args` or a `primitive`'s `object` changes, R3F builds a new three object and keeps the same
1828
+ * instance. Removing the old object from the interaction state and registering the new one from
1829
+ * scratch makes events *work* again (#3778), but it forgets what was in flight: a pointer resting on
1830
+ * the object fires a second `onPointerEnter` without ever having left, and an active pointer capture
1831
+ * is dropped mid-drag. Rewriting the references instead keeps the interaction continuous across a
1832
+ * swap the user never asked to see (#3744).
1833
+ *
1834
+ * Captures are re-keyed rather than released, so the DOM-level capture on `captureData.target` is
1835
+ * left alone — releasing and re-acquiring it is precisely the glitch being avoided.
1836
+ *
1837
+ * Visibility handlers are deliberately not transferred: that registry is keyed by `object.uuid`, so
1838
+ * the replacement re-registers itself through `applyProps`. The old entry is dropped here so it
1839
+ * cannot outlive the object it described.
1840
+ */
1841
+ declare function swapInteractivity(store: RootStore, object: Object3D, newObject: Object3D): void;
1824
1842
  declare function removeInteractivity(store: RootStore, object: Object3D): void;
1825
1843
  declare function createEvents(store: RootStore): {
1826
1844
  handlePointer: (name: string) => (event: DomEvent) => void;
@@ -3246,11 +3264,6 @@ declare function flushSync<R>(fn: () => R): R;
3246
3264
  declare const context: React$1.Context<RootStore>;
3247
3265
  declare const createStore: (invalidate: (state?: RootState, frames?: number, stackFrames?: boolean) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState, frame?: XRFrame) => void) => RootStore;
3248
3266
 
3249
- /**
3250
- * Safely flush async effects when testing, simulating a legacy root.
3251
- * @deprecated Import from React instead. import { act } from 'react'
3252
- */
3253
- declare const act: typeof React$1.act;
3254
3267
  /**
3255
3268
  * An SSR-friendly useLayoutEffect.
3256
3269
  *
@@ -3734,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3734
3747
  */
3735
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3736
3749
 
3737
- export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, 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, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3750
+ export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, Texture, _roots, addAfterEffect, addEffect, addTail, advance, applyProps, attach, buildGraph, calculateDpr, context, createEvents, createPointerEvents, createPortal, createRoot, createStore, detach, diffProps, dispose, createPointerEvents as events, extend, findInitialRoot, flushSync, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, swapInteractivity, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3738
3751
  export type { Act, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferLike, BufferRecord, BufferStore, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DisposeOptions, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, LegacyInternalState as InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeProps, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, PresetsType, PrimaryCanvasEntry, Properties, Quaternion, LegacyRenderer as R3FRenderer, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, LegacyRootState as RootState, RootStore, SetBlock, Size, StorageLike, StorageRecord, StorageStore, Subscription, TSLNodeInput, TextureInput, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager, XRPointerConfig };
package/dist/legacy.d.mts CHANGED
@@ -10,7 +10,6 @@ import { FrameTimingState, FrameCallback as FrameCallback$1, SchedulerApi, UseFr
10
10
  export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, Scheduler, SchedulerApi, UseFrameNextOptions, UseFrameOptions, getScheduler } from '@pmndrs/scheduler';
11
11
  import { Options } from 'react-use-measure';
12
12
  import * as react_jsx_runtime from 'react/jsx-runtime';
13
- import { ThreeElement as ThreeElement$1, Euler as Euler$2 } from '@react-three/fiber';
14
13
  import { GroundedSkybox } from 'three/examples/jsm/objects/GroundedSkybox.js';
15
14
 
16
15
  function _mergeNamespaces(n, m) {
@@ -39,9 +38,9 @@ function _mergeNamespaces(n, m) {
39
38
  declare const R3F_BUILD_LEGACY = true;
40
39
  declare const R3F_BUILD_WEBGPU = false;
41
40
 
42
- declare const Inspector: {
43
- new (): {};
44
- };
41
+ type Inspector = never;
42
+ /** Not available on the legacy (WebGL-only) entry. */
43
+ declare function loadInspector(): Promise<never>;
45
44
  declare const WebGPURenderer: {
46
45
  new (): {};
47
46
  };
@@ -59,7 +58,8 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
59
58
  R3F_BUILD_WEBGPU: R3F_BUILD_WEBGPU,
60
59
  RenderTarget: RenderTarget,
61
60
  RenderTargetCompat: WebGLRenderTarget,
62
- WebGPURenderer: WebGPURenderer
61
+ WebGPURenderer: WebGPURenderer,
62
+ loadInspector: loadInspector
63
63
  }, [THREE$1]);
64
64
 
65
65
  //* Utility Types ==============================
@@ -1635,9 +1635,9 @@ type EnvironmentProps = {
1635
1635
  blur?: number;
1636
1636
  backgroundBlurriness?: number;
1637
1637
  backgroundIntensity?: number;
1638
- backgroundRotation?: Euler$2;
1638
+ backgroundRotation?: Euler;
1639
1639
  environmentIntensity?: number;
1640
- environmentRotation?: Euler$2;
1640
+ environmentRotation?: Euler;
1641
1641
  map?: Texture$1;
1642
1642
  preset?: PresetsType;
1643
1643
  scene?: Scene | React$1.RefObject<Scene>;
@@ -1721,7 +1721,7 @@ declare function EnvironmentCube({ background, scene, blur, backgroundBlurriness
1721
1721
  declare function EnvironmentPortal({ children, near, far, resolution, frames, map, background, blur, backgroundBlurriness, backgroundIntensity, backgroundRotation, environmentIntensity, environmentRotation, scene, files, path, preset, extensions, }: EnvironmentProps): react_jsx_runtime.JSX.Element;
1722
1722
  declare module '@react-three/fiber' {
1723
1723
  interface ThreeElements {
1724
- groundProjectedEnvImpl: ThreeElement$1<typeof GroundedSkybox>;
1724
+ groundProjectedEnvImpl: ThreeElement<typeof GroundedSkybox>;
1725
1725
  }
1726
1726
  }
1727
1727
  /**
@@ -1821,6 +1821,24 @@ declare module '@react-three/fiber' {
1821
1821
  */
1822
1822
  declare function Environment(props: EnvironmentProps): react_jsx_runtime.JSX.Element;
1823
1823
 
1824
+ /**
1825
+ * Moves every trace of interactivity from one object to its replacement, for reconstruction.
1826
+ *
1827
+ * When `args` or a `primitive`'s `object` changes, R3F builds a new three object and keeps the same
1828
+ * instance. Removing the old object from the interaction state and registering the new one from
1829
+ * scratch makes events *work* again (#3778), but it forgets what was in flight: a pointer resting on
1830
+ * the object fires a second `onPointerEnter` without ever having left, and an active pointer capture
1831
+ * is dropped mid-drag. Rewriting the references instead keeps the interaction continuous across a
1832
+ * swap the user never asked to see (#3744).
1833
+ *
1834
+ * Captures are re-keyed rather than released, so the DOM-level capture on `captureData.target` is
1835
+ * left alone — releasing and re-acquiring it is precisely the glitch being avoided.
1836
+ *
1837
+ * Visibility handlers are deliberately not transferred: that registry is keyed by `object.uuid`, so
1838
+ * the replacement re-registers itself through `applyProps`. The old entry is dropped here so it
1839
+ * cannot outlive the object it described.
1840
+ */
1841
+ declare function swapInteractivity(store: RootStore, object: Object3D, newObject: Object3D): void;
1824
1842
  declare function removeInteractivity(store: RootStore, object: Object3D): void;
1825
1843
  declare function createEvents(store: RootStore): {
1826
1844
  handlePointer: (name: string) => (event: DomEvent) => void;
@@ -3246,11 +3264,6 @@ declare function flushSync<R>(fn: () => R): R;
3246
3264
  declare const context: React$1.Context<RootStore>;
3247
3265
  declare const createStore: (invalidate: (state?: RootState, frames?: number, stackFrames?: boolean) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState, frame?: XRFrame) => void) => RootStore;
3248
3266
 
3249
- /**
3250
- * Safely flush async effects when testing, simulating a legacy root.
3251
- * @deprecated Import from React instead. import { act } from 'react'
3252
- */
3253
- declare const act: typeof React$1.act;
3254
3267
  /**
3255
3268
  * An SSR-friendly useLayoutEffect.
3256
3269
  *
@@ -3734,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3734
3747
  */
3735
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3736
3749
 
3737
- export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, 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, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3750
+ export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, Texture, _roots, addAfterEffect, addEffect, addTail, advance, applyProps, attach, buildGraph, calculateDpr, context, createEvents, createPointerEvents, createPortal, createRoot, createStore, detach, diffProps, dispose, createPointerEvents as events, extend, findInitialRoot, flushSync, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, swapInteractivity, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3738
3751
  export type { Act, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferLike, BufferRecord, BufferStore, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DisposeOptions, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, LegacyInternalState as InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeProps, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, PresetsType, PrimaryCanvasEntry, Properties, Quaternion, LegacyRenderer as R3FRenderer, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, LegacyRootState as RootState, RootStore, SetBlock, Size, StorageLike, StorageRecord, StorageStore, Subscription, TSLNodeInput, TextureInput, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager, XRPointerConfig };
package/dist/legacy.d.ts CHANGED
@@ -10,7 +10,6 @@ import { FrameTimingState, FrameCallback as FrameCallback$1, SchedulerApi, UseFr
10
10
  export { AddPhaseOptions, FrameControls, FrameNextControls, FrameTimingState, RootOptions, Scheduler, SchedulerApi, UseFrameNextOptions, UseFrameOptions, getScheduler } from '@pmndrs/scheduler';
11
11
  import { Options } from 'react-use-measure';
12
12
  import * as react_jsx_runtime from 'react/jsx-runtime';
13
- import { ThreeElement as ThreeElement$1, Euler as Euler$2 } from '@react-three/fiber';
14
13
  import { GroundedSkybox } from 'three/examples/jsm/objects/GroundedSkybox.js';
15
14
 
16
15
  function _mergeNamespaces(n, m) {
@@ -39,9 +38,9 @@ function _mergeNamespaces(n, m) {
39
38
  declare const R3F_BUILD_LEGACY = true;
40
39
  declare const R3F_BUILD_WEBGPU = false;
41
40
 
42
- declare const Inspector: {
43
- new (): {};
44
- };
41
+ type Inspector = never;
42
+ /** Not available on the legacy (WebGL-only) entry. */
43
+ declare function loadInspector(): Promise<never>;
45
44
  declare const WebGPURenderer: {
46
45
  new (): {};
47
46
  };
@@ -59,7 +58,8 @@ var THREE = /*#__PURE__*/_mergeNamespaces({
59
58
  R3F_BUILD_WEBGPU: R3F_BUILD_WEBGPU,
60
59
  RenderTarget: RenderTarget,
61
60
  RenderTargetCompat: WebGLRenderTarget,
62
- WebGPURenderer: WebGPURenderer
61
+ WebGPURenderer: WebGPURenderer,
62
+ loadInspector: loadInspector
63
63
  }, [THREE$1]);
64
64
 
65
65
  //* Utility Types ==============================
@@ -1635,9 +1635,9 @@ type EnvironmentProps = {
1635
1635
  blur?: number;
1636
1636
  backgroundBlurriness?: number;
1637
1637
  backgroundIntensity?: number;
1638
- backgroundRotation?: Euler$2;
1638
+ backgroundRotation?: Euler;
1639
1639
  environmentIntensity?: number;
1640
- environmentRotation?: Euler$2;
1640
+ environmentRotation?: Euler;
1641
1641
  map?: Texture$1;
1642
1642
  preset?: PresetsType;
1643
1643
  scene?: Scene | React$1.RefObject<Scene>;
@@ -1721,7 +1721,7 @@ declare function EnvironmentCube({ background, scene, blur, backgroundBlurriness
1721
1721
  declare function EnvironmentPortal({ children, near, far, resolution, frames, map, background, blur, backgroundBlurriness, backgroundIntensity, backgroundRotation, environmentIntensity, environmentRotation, scene, files, path, preset, extensions, }: EnvironmentProps): react_jsx_runtime.JSX.Element;
1722
1722
  declare module '@react-three/fiber' {
1723
1723
  interface ThreeElements {
1724
- groundProjectedEnvImpl: ThreeElement$1<typeof GroundedSkybox>;
1724
+ groundProjectedEnvImpl: ThreeElement<typeof GroundedSkybox>;
1725
1725
  }
1726
1726
  }
1727
1727
  /**
@@ -1821,6 +1821,24 @@ declare module '@react-three/fiber' {
1821
1821
  */
1822
1822
  declare function Environment(props: EnvironmentProps): react_jsx_runtime.JSX.Element;
1823
1823
 
1824
+ /**
1825
+ * Moves every trace of interactivity from one object to its replacement, for reconstruction.
1826
+ *
1827
+ * When `args` or a `primitive`'s `object` changes, R3F builds a new three object and keeps the same
1828
+ * instance. Removing the old object from the interaction state and registering the new one from
1829
+ * scratch makes events *work* again (#3778), but it forgets what was in flight: a pointer resting on
1830
+ * the object fires a second `onPointerEnter` without ever having left, and an active pointer capture
1831
+ * is dropped mid-drag. Rewriting the references instead keeps the interaction continuous across a
1832
+ * swap the user never asked to see (#3744).
1833
+ *
1834
+ * Captures are re-keyed rather than released, so the DOM-level capture on `captureData.target` is
1835
+ * left alone — releasing and re-acquiring it is precisely the glitch being avoided.
1836
+ *
1837
+ * Visibility handlers are deliberately not transferred: that registry is keyed by `object.uuid`, so
1838
+ * the replacement re-registers itself through `applyProps`. The old entry is dropped here so it
1839
+ * cannot outlive the object it described.
1840
+ */
1841
+ declare function swapInteractivity(store: RootStore, object: Object3D, newObject: Object3D): void;
1824
1842
  declare function removeInteractivity(store: RootStore, object: Object3D): void;
1825
1843
  declare function createEvents(store: RootStore): {
1826
1844
  handlePointer: (name: string) => (event: DomEvent) => void;
@@ -3246,11 +3264,6 @@ declare function flushSync<R>(fn: () => R): R;
3246
3264
  declare const context: React$1.Context<RootStore>;
3247
3265
  declare const createStore: (invalidate: (state?: RootState, frames?: number, stackFrames?: boolean) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState, frame?: XRFrame) => void) => RootStore;
3248
3266
 
3249
- /**
3250
- * Safely flush async effects when testing, simulating a legacy root.
3251
- * @deprecated Import from React instead. import { act } from 'react'
3252
- */
3253
- declare const act: typeof React$1.act;
3254
3267
  /**
3255
3268
  * An SSR-friendly useLayoutEffect.
3256
3269
  *
@@ -3734,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3734
3747
  */
3735
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3736
3749
 
3737
- export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, 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, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3750
+ export { Block, Canvas, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, ErrorBoundary, FROM_REF, IsObject, ONCE, Portal, R3F_BUILD_LEGACY, R3F_BUILD_WEBGPU, REACT_INTERNAL_PROPS, RESERVED_PROPS, three_d as ReactThreeFiber, Texture, _roots, addAfterEffect, addEffect, addTail, advance, applyProps, attach, buildGraph, calculateDpr, context, createEvents, createPointerEvents, createPortal, createRoot, createStore, detach, diffProps, dispose, createPointerEvents as events, extend, findInitialRoot, flushSync, fromRef, getInstanceProps, getPrimary, getPrimaryIds, getRootState, getUuidPrefix, hasConstructor, hasPrimary, invalidate, invalidateInstance, is, isColorRepresentation, isCopyable, isFromRef, isObject3D, isOnce, isOrthographicCamera, isRef, isRenderer, isTexture, isVectorLike, once, prepare, presetsObj, reconciler, registerPrimary, removeInteractivity, resolve, swapInteractivity, unmountComponentAtNode, unregisterPrimary, updateCamera, updateFrustum, useBridge, useEnvironment, useFrame, useGraph, useInstanceHandle, useIsomorphicLayoutEffect, useLoader, useMutableCallback, useRenderTarget, useStore, useTexture, useTextures, useThree, waitForPrimary };
3738
3751
  export type { Act, Args, ArgsProp, AttachFnType, AttachType, BackgroundConfig, BackgroundProp, BaseRendererProps, Bridge, BufferLike, BufferRecord, BufferStore, Camera, CameraProps, CanvasProps, CanvasSchedulerConfig, Catalogue, Color, ColorManagementConfig, ComputeFunction, ConstructorRepresentation, DefaultGLProps, DefaultRendererProps, Disposable, DisposeOptions, DomEvent, Dpr, ElementProps, EnvironmentLoaderProps, EnvironmentProps, EquConfig, Euler, EventHandlers, EventManager, EventProps, Events, Extensions, FiberRoot, FilterFunction, FrameCallback, FrameNextCallback, FrameNextState, FrameState, Frameloop, GLProps, GLTFLike, GeometryProps, GeometryTransformProps, GlobalEffectType, GlobalRenderCallback, HostConfig, InferLoadResult, InjectState, InputLike, Instance, InstanceProps, LegacyInternalState as InternalState, Intersection, IntersectionEvent, IsAllOptional, IsOptional, Layers, LegacyInternalState, LegacyRenderer, LegacyRootState, LoaderInstance, LoaderLike, LoaderResult, MappedTextureType, MathProps, MathRepresentation, MathType, MathTypes, Matrix3, Matrix4, Mutable, MutableOrReadonlyParameters, NodeProps, NonFunctionKeys, ObjectMap, OffscreenCanvas$1 as OffscreenCanvas, Overwrite, Performance, PointerCaptureTarget, PointerState, PresetsType, PrimaryCanvasEntry, Properties, Quaternion, LegacyRenderer as R3FRenderer, RaycastableRepresentation, ReactProps, ReconcilerRoot, RenderCallback, RenderProps, RenderTargetOptions, Renderer, RendererConfigExtended, RendererFactory, RendererProps, Root, LegacyRootState as RootState, RootStore, SetBlock, Size, StorageLike, StorageRecord, StorageStore, Subscription, TSLNodeInput, TextureInput, TextureResult, ThreeCamera, ThreeElement, ThreeElements, ThreeElementsImpl, ThreeEvent, ThreeExports, ThreeToJSXElements, UnblockProps, UseTextureOptions, UseTexturesReturn, Vector2, Vector3, Vector4, VectorRepresentation, Viewport, VisibilityEntry, WebGLDefaultProps, WebGLProps, WebGLShadowConfig, XRManager, XRPointerConfig };