@react-three/fiber 10.0.0-canary.6d6e5ab → 10.0.0-canary.6eb9584

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;
@@ -3729,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3729
3747
  */
3730
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3731
3749
 
3732
- 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, 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 };
3733
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;
@@ -3729,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3729
3747
  */
3730
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3731
3749
 
3732
- 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, 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 };
3733
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;
@@ -3729,5 +3747,5 @@ declare function isOnce(value: unknown): value is {
3729
3747
  */
3730
3748
  declare function Canvas(props: CanvasProps): react_jsx_runtime.JSX.Element;
3731
3749
 
3732
- 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, 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 };
3733
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 };