@react-three/fiber 8.0.12 → 8.0.15

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @react-three/fiber
 
+## 8.0.15
+
+### Patch Changes
+
+- c4715d5f: allow invalidate to preempt more than 1 frame
+
+## 8.0.14
+
+### Patch Changes
+
+- 5559a119: Add support for recoverable errors
+
+## 8.0.13
+
+### Patch Changes
+
+- 9d77d8e2: fix: detach attribute removal
+
 ## 8.0.12
 
 ### Patch Changes

package/dist/declarations/src/core/index.d.ts

@@ -9,7 +9,7 @@ import { addEffect, addAfterEffect, addTail } from './loop';
 import { EventManager, ComputeFunction } from './events';
 import { dispose, getRootState, Camera } from './utils';
 declare const roots: Map<Element, Root>;
-declare const invalidate: (state?: RootState | undefined) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState | undefined, frame?: THREE.XRFrame | undefined) => void;
+declare const invalidate: (state?: RootState | undefined, frames?: number) => void, advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState | undefined, frame?: THREE.XRFrame | undefined) => void;
 declare const reconciler: import("react-reconciler").Reconciler<unknown, unknown, unknown, unknown, unknown>, applyProps: typeof import("./utils").applyProps;
 declare type Properties<T> = Pick<T, {
     [K in keyof T]: T[K] extends (_: any) => any ? never : K;

package/dist/declarations/src/core/loop.d.ts

@@ -7,7 +7,7 @@ export declare const addAfterEffect: (callback: GlobalRenderCallback) => () => v
 export declare const addTail: (callback: GlobalRenderCallback) => () => void;
 export declare function createLoop<TCanvas>(roots: Map<TCanvas, Root>): {
     loop: (timestamp: number) => void;
-    invalidate: (state?: RootState | undefined) => void;
+    invalidate: (state?: RootState | undefined, frames?: number) => void;
     advance: (timestamp: number, runGlobalEffects?: boolean, state?: RootState | undefined, frame?: THREE.XRFrame | undefined) => void;
 };
 export {};

package/dist/declarations/src/core/store.d.ts

@@ -77,7 +77,7 @@ export declare type RootState = {
     viewport: Viewport & {
         getCurrentViewport: (camera?: Camera, target?: THREE.Vector3 | Parameters<THREE.Vector3['set']>, size?: Size) => Omit<Viewport, 'dpr' | 'initialDpr'>;
     };
-    invalidate: () => void;
+    invalidate: (frames?: number) => void;
     advance: (timestamp: number, runGlobalEffects?: boolean) => void;
     setEvents: (events: Partial<EventManager<any>>) => void;
     setSize: (width: number, height: number) => void;
@@ -88,5 +88,5 @@ export declare type RootState = {
     internal: InternalState;
 };
 declare const context: React.Context<UseBoundStore<RootState, StoreApi<RootState>>>;
-declare const createStore: (invalidate: (state?: RootState | undefined) => void, advance: (timestamp: number, runGlobalEffects?: boolean | undefined, state?: RootState | undefined, frame?: THREE.XRFrame | undefined) => void) => UseBoundStore<RootState>;
+declare const createStore: (invalidate: (state?: RootState | undefined, frames?: number | undefined) => void, advance: (timestamp: number, runGlobalEffects?: boolean | undefined, state?: RootState | undefined, frame?: THREE.XRFrame | undefined) => void) => UseBoundStore<RootState>;
 export { createStore, context };

package/dist/{index-e322e5c8.cjs.prod.js → index-05d06e15.cjs.prod.js}

@@ -228,7 +228,10 @@ function detach(parent, child, type) {
       target,
       key
     } = resolve(parent, type);
-    target[key] = child.__r3f.previousAttach;
+    const previous = child.__r3f.previousAttach; // When the previous value was undefined, it means the value was never set to begin with
+
+    if (previous === undefined) delete target[key]; // Otherwise set the previous value
+    else target[key] = previous;
   } else (_child$__r3f = child.__r3f) == null ? void 0 : _child$__r3f.previousAttach == null ? void 0 : _child$__r3f.previousAttach(parent, child);
 
   (_child$__r3f2 = child.__r3f) == null ? true : delete _child$__r3f2.previousAttach;
@@ -870,7 +873,7 @@ function createRenderer(roots, getEventPriority) {
       const target = catalogue[name];
 
       if (!target) {
-        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://github.com/pmndrs/react-three-fiber/blob/master/markdown/api.md#using-3rd-party-objects-declaratively`;
+        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://docs.pmnd.rs/react-three-fiber/api/objects#using-3rd-party-objects-declaratively`;
       } // Throw if an object or literal was passed for args
 
 
@@ -1139,7 +1142,6 @@ function createRenderer(roots, getEventPriority) {
     shouldSetTextContent: () => false,
     clearContainer: () => false,
     detachDeletedInstance: () => {},
-    createTextInstance: () => {},
 
     hideInstance(instance) {
       var _instance$__r3f5;
@@ -1167,10 +1169,11 @@ function createRenderer(roots, getEventPriority) {
       invalidateInstance(instance);
     },
 
+    createTextInstance: () => {},
     hideTextInstance: () => {
       throw new Error('Text is not allowed in the R3F tree.');
     },
-    // prettier-ignore
+    unhideTextInstance: () => {},
     getCurrentEventPriority: () => getEventPriority ? getEventPriority() : constants.DefaultEventPriority,
     // @ts-ignore
     now: typeof performance !== 'undefined' && is.fun(performance.now) ? performance.now : is.fun(Date.now) ? Date.now : undefined,
@@ -1252,7 +1255,7 @@ const createStore = (invalidate, advance) => {
         connected: false
       },
       xr: null,
-      invalidate: () => invalidate(get()),
+      invalidate: (frames = 1) => invalidate(get(), frames),
       advance: (timestamp, runGlobalEffects) => advance(timestamp, runGlobalEffects, get()),
       legacy: false,
       linear: false,
@@ -1504,13 +1507,13 @@ function createLoop(roots) {
     }
   }
 
-  function invalidate(state) {
+  function invalidate(state, frames = 1) {
     var _state$gl$xr2;
 
-    if (!state) return roots.forEach(root => invalidate(root.store.getState()));
+    if (!state) return roots.forEach(root => invalidate(root.store.getState()), frames);
     if ((_state$gl$xr2 = state.gl.xr) != null && _state$gl$xr2.isPresenting || !state.internal.active || state.frameloop === 'never') return; // Increase frames, do not go higher than 60
 
-    state.internal.frames = Math.min(60, state.internal.frames + 1); // If the render-loop isn't active, start it
+    state.internal.frames = Math.min(60, state.internal.frames + frames); // If the render-loop isn't active, start it
 
     if (!running) {
       running = true;
@@ -1655,11 +1658,17 @@ function createRoot(canvas) {
   let prevRoot = roots.get(canvas);
   let prevFiber = prevRoot == null ? void 0 : prevRoot.fiber;
   let prevStore = prevRoot == null ? void 0 : prevRoot.store;
-  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Create store
+  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Report when an error was detected in a previous render
+  // https://github.com/pmndrs/react-three-fiber/pull/2261
+
+  const logRecoverableError = typeof reportError === 'function' ? // In modern browsers, reportError will dispatch an error event,
+  // emulating an uncaught JavaScript error.
+  reportError : // In older browsers and test environments, fallback to console.error.
+  console.error; // Create store
 
   const store = prevStore || createStore(invalidate, advance); // Create renderer
 
-  const fiber = prevFiber || reconciler.createContainer(store, constants.ConcurrentRoot, false, null); // Map it
+  const fiber = prevFiber || reconciler.createContainer(store, constants.ConcurrentRoot, null, false, null, null, logRecoverableError, null); // Map it
 
   if (!prevRoot) roots.set(canvas, {
     fiber,

package/dist/{index-38c121a8.esm.js → index-208291a3.esm.js}

@@ -201,7 +201,10 @@ function detach(parent, child, type) {
       target,
       key
     } = resolve(parent, type);
-    target[key] = child.__r3f.previousAttach;
+    const previous = child.__r3f.previousAttach; // When the previous value was undefined, it means the value was never set to begin with
+
+    if (previous === undefined) delete target[key]; // Otherwise set the previous value
+    else target[key] = previous;
   } else (_child$__r3f = child.__r3f) == null ? void 0 : _child$__r3f.previousAttach == null ? void 0 : _child$__r3f.previousAttach(parent, child);
 
   (_child$__r3f2 = child.__r3f) == null ? true : delete _child$__r3f2.previousAttach;
@@ -843,7 +846,7 @@ function createRenderer(roots, getEventPriority) {
       const target = catalogue[name];
 
       if (!target) {
-        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://github.com/pmndrs/react-three-fiber/blob/master/markdown/api.md#using-3rd-party-objects-declaratively`;
+        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://docs.pmnd.rs/react-three-fiber/api/objects#using-3rd-party-objects-declaratively`;
       } // Throw if an object or literal was passed for args
 
 
@@ -1112,7 +1115,6 @@ function createRenderer(roots, getEventPriority) {
     shouldSetTextContent: () => false,
     clearContainer: () => false,
     detachDeletedInstance: () => {},
-    createTextInstance: () => {},
 
     hideInstance(instance) {
       var _instance$__r3f5;
@@ -1140,10 +1142,11 @@ function createRenderer(roots, getEventPriority) {
       invalidateInstance(instance);
     },
 
+    createTextInstance: () => {},
     hideTextInstance: () => {
       throw new Error('Text is not allowed in the R3F tree.');
     },
-    // prettier-ignore
+    unhideTextInstance: () => {},
     getCurrentEventPriority: () => getEventPriority ? getEventPriority() : DefaultEventPriority,
     // @ts-ignore
     now: typeof performance !== 'undefined' && is.fun(performance.now) ? performance.now : is.fun(Date.now) ? Date.now : undefined,
@@ -1225,7 +1228,7 @@ const createStore = (invalidate, advance) => {
         connected: false
       },
       xr: null,
-      invalidate: () => invalidate(get()),
+      invalidate: (frames = 1) => invalidate(get(), frames),
       advance: (timestamp, runGlobalEffects) => advance(timestamp, runGlobalEffects, get()),
       legacy: false,
       linear: false,
@@ -1477,13 +1480,13 @@ function createLoop(roots) {
     }
   }
 
-  function invalidate(state) {
+  function invalidate(state, frames = 1) {
     var _state$gl$xr2;
 
-    if (!state) return roots.forEach(root => invalidate(root.store.getState()));
+    if (!state) return roots.forEach(root => invalidate(root.store.getState()), frames);
     if ((_state$gl$xr2 = state.gl.xr) != null && _state$gl$xr2.isPresenting || !state.internal.active || state.frameloop === 'never') return; // Increase frames, do not go higher than 60
 
-    state.internal.frames = Math.min(60, state.internal.frames + 1); // If the render-loop isn't active, start it
+    state.internal.frames = Math.min(60, state.internal.frames + frames); // If the render-loop isn't active, start it
 
     if (!running) {
       running = true;
@@ -1628,11 +1631,17 @@ function createRoot(canvas) {
   let prevRoot = roots.get(canvas);
   let prevFiber = prevRoot == null ? void 0 : prevRoot.fiber;
   let prevStore = prevRoot == null ? void 0 : prevRoot.store;
-  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Create store
+  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Report when an error was detected in a previous render
+  // https://github.com/pmndrs/react-three-fiber/pull/2261
+
+  const logRecoverableError = typeof reportError === 'function' ? // In modern browsers, reportError will dispatch an error event,
+  // emulating an uncaught JavaScript error.
+  reportError : // In older browsers and test environments, fallback to console.error.
+  console.error; // Create store
 
   const store = prevStore || createStore(invalidate, advance); // Create renderer
 
-  const fiber = prevFiber || reconciler.createContainer(store, ConcurrentRoot, false, null); // Map it
+  const fiber = prevFiber || reconciler.createContainer(store, ConcurrentRoot, null, false, null, null, logRecoverableError, null); // Map it
 
   if (!prevRoot) roots.set(canvas, {
     fiber,

package/dist/{index-f67eaa0c.cjs.dev.js → index-606d3385.cjs.dev.js}

@@ -228,7 +228,10 @@ function detach(parent, child, type) {
       target,
       key
     } = resolve(parent, type);
-    target[key] = child.__r3f.previousAttach;
+    const previous = child.__r3f.previousAttach; // When the previous value was undefined, it means the value was never set to begin with
+
+    if (previous === undefined) delete target[key]; // Otherwise set the previous value
+    else target[key] = previous;
   } else (_child$__r3f = child.__r3f) == null ? void 0 : _child$__r3f.previousAttach == null ? void 0 : _child$__r3f.previousAttach(parent, child);
 
   (_child$__r3f2 = child.__r3f) == null ? true : delete _child$__r3f2.previousAttach;
@@ -870,7 +873,7 @@ function createRenderer(roots, getEventPriority) {
       const target = catalogue[name];
 
       if (!target) {
-        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://github.com/pmndrs/react-three-fiber/blob/master/markdown/api.md#using-3rd-party-objects-declaratively`;
+        throw `${name} is not part of the THREE namespace! Did you forget to extend? See: https://docs.pmnd.rs/react-three-fiber/api/objects#using-3rd-party-objects-declaratively`;
       } // Throw if an object or literal was passed for args
 
 
@@ -1139,7 +1142,6 @@ function createRenderer(roots, getEventPriority) {
     shouldSetTextContent: () => false,
     clearContainer: () => false,
     detachDeletedInstance: () => {},
-    createTextInstance: () => {},
 
     hideInstance(instance) {
       var _instance$__r3f5;
@@ -1167,10 +1169,11 @@ function createRenderer(roots, getEventPriority) {
       invalidateInstance(instance);
     },
 
+    createTextInstance: () => {},
     hideTextInstance: () => {
       throw new Error('Text is not allowed in the R3F tree.');
     },
-    // prettier-ignore
+    unhideTextInstance: () => {},
     getCurrentEventPriority: () => getEventPriority ? getEventPriority() : constants.DefaultEventPriority,
     // @ts-ignore
     now: typeof performance !== 'undefined' && is.fun(performance.now) ? performance.now : is.fun(Date.now) ? Date.now : undefined,
@@ -1252,7 +1255,7 @@ const createStore = (invalidate, advance) => {
         connected: false
       },
       xr: null,
-      invalidate: () => invalidate(get()),
+      invalidate: (frames = 1) => invalidate(get(), frames),
       advance: (timestamp, runGlobalEffects) => advance(timestamp, runGlobalEffects, get()),
       legacy: false,
       linear: false,
@@ -1504,13 +1507,13 @@ function createLoop(roots) {
     }
   }
 
-  function invalidate(state) {
+  function invalidate(state, frames = 1) {
     var _state$gl$xr2;
 
-    if (!state) return roots.forEach(root => invalidate(root.store.getState()));
+    if (!state) return roots.forEach(root => invalidate(root.store.getState()), frames);
     if ((_state$gl$xr2 = state.gl.xr) != null && _state$gl$xr2.isPresenting || !state.internal.active || state.frameloop === 'never') return; // Increase frames, do not go higher than 60
 
-    state.internal.frames = Math.min(60, state.internal.frames + 1); // If the render-loop isn't active, start it
+    state.internal.frames = Math.min(60, state.internal.frames + frames); // If the render-loop isn't active, start it
 
     if (!running) {
       running = true;
@@ -1655,11 +1658,17 @@ function createRoot(canvas) {
   let prevRoot = roots.get(canvas);
   let prevFiber = prevRoot == null ? void 0 : prevRoot.fiber;
   let prevStore = prevRoot == null ? void 0 : prevRoot.store;
-  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Create store
+  if (prevRoot) console.warn('R3F.createRoot should only be called once!'); // Report when an error was detected in a previous render
+  // https://github.com/pmndrs/react-three-fiber/pull/2261
+
+  const logRecoverableError = typeof reportError === 'function' ? // In modern browsers, reportError will dispatch an error event,
+  // emulating an uncaught JavaScript error.
+  reportError : // In older browsers and test environments, fallback to console.error.
+  console.error; // Create store
 
   const store = prevStore || createStore(invalidate, advance); // Create renderer
 
-  const fiber = prevFiber || reconciler.createContainer(store, constants.ConcurrentRoot, false, null); // Map it
+  const fiber = prevFiber || reconciler.createContainer(store, constants.ConcurrentRoot, null, false, null, null, logRecoverableError, null); // Map it
 
   if (!prevRoot) roots.set(canvas, {
     fiber,

package/dist/react-three-fiber.cjs.dev.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var index = require('./index-f67eaa0c.cjs.dev.js');
+var index = require('./index-606d3385.cjs.dev.js');
 var _extends = require('@babel/runtime/helpers/extends');
 var React = require('react');
 var THREE = require('three');

package/dist/react-three-fiber.cjs.prod.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var index = require('./index-e322e5c8.cjs.prod.js');
+var index = require('./index-05d06e15.cjs.prod.js');
 var _extends = require('@babel/runtime/helpers/extends');
 var React = require('react');
 var THREE = require('three');

package/dist/react-three-fiber.esm.js

@@ -1,5 +1,5 @@
-import { c as createEvents, e as extend, u as useMutableCallback, a as createRoot, E as ErrorBoundary, B as Block, b as useIsomorphicLayoutEffect, d as unmountComponentAtNode } from './index-38c121a8.esm.js';
-export { t as ReactThreeFiber, s as _roots, q as act, n as addAfterEffect, m as addEffect, o as addTail, l as advance, i as applyProps, f as context, g as createPortal, a as createRoot, j as dispose, e as extend, p as getRootState, k as invalidate, h as reconciler, r as render, d as unmountComponentAtNode, x as useFrame, y as useGraph, z as useLoader, v as useStore, w as useThree } from './index-38c121a8.esm.js';
+import { c as createEvents, e as extend, u as useMutableCallback, a as createRoot, E as ErrorBoundary, B as Block, b as useIsomorphicLayoutEffect, d as unmountComponentAtNode } from './index-208291a3.esm.js';
+export { t as ReactThreeFiber, s as _roots, q as act, n as addAfterEffect, m as addEffect, o as addTail, l as advance, i as applyProps, f as context, g as createPortal, a as createRoot, j as dispose, e as extend, p as getRootState, k as invalidate, h as reconciler, r as render, d as unmountComponentAtNode, x as useFrame, y as useGraph, z as useLoader, v as useStore, w as useThree } from './index-208291a3.esm.js';
 import _extends from '@babel/runtime/helpers/esm/extends';
 import * as React from 'react';
 import * as THREE from 'three';

package/native/dist/react-three-fiber-native.cjs.dev.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var THREE = require('three');
 var expoAsset = require('expo-asset');
-var index = require('../../dist/index-f67eaa0c.cjs.dev.js');
+var index = require('../../dist/index-606d3385.cjs.dev.js');
 var _extends = require('@babel/runtime/helpers/extends');
 var React = require('react');
 var mergeRefs = require('react-merge-refs');

package/native/dist/react-three-fiber-native.cjs.prod.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var THREE = require('three');
 var expoAsset = require('expo-asset');
-var index = require('../../dist/index-e322e5c8.cjs.prod.js');
+var index = require('../../dist/index-05d06e15.cjs.prod.js');
 var _extends = require('@babel/runtime/helpers/extends');
 var React = require('react');
 var mergeRefs = require('react-merge-refs');

package/native/dist/react-three-fiber-native.esm.js

@@ -1,7 +1,7 @@
 import * as THREE from 'three';
 import { Asset } from 'expo-asset';
-import { c as createEvents, e as extend, u as useMutableCallback, a as createRoot, E as ErrorBoundary, B as Block, d as unmountComponentAtNode } from '../../dist/index-38c121a8.esm.js';
-export { t as ReactThreeFiber, s as _roots, q as act, n as addAfterEffect, m as addEffect, o as addTail, l as advance, i as applyProps, f as context, g as createPortal, a as createRoot, j as dispose, e as extend, p as getRootState, k as invalidate, h as reconciler, r as render, d as unmountComponentAtNode, x as useFrame, y as useGraph, z as useLoader, v as useStore, w as useThree } from '../../dist/index-38c121a8.esm.js';
+import { c as createEvents, e as extend, u as useMutableCallback, a as createRoot, E as ErrorBoundary, B as Block, d as unmountComponentAtNode } from '../../dist/index-208291a3.esm.js';
+export { t as ReactThreeFiber, s as _roots, q as act, n as addAfterEffect, m as addEffect, o as addTail, l as advance, i as applyProps, f as context, g as createPortal, a as createRoot, j as dispose, e as extend, p as getRootState, k as invalidate, h as reconciler, r as render, d as unmountComponentAtNode, x as useFrame, y as useGraph, z as useLoader, v as useStore, w as useThree } from '../../dist/index-208291a3.esm.js';
 import _extends from '@babel/runtime/helpers/esm/extends';
 import * as React from 'react';
 import mergeRefs from 'react-merge-refs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-three/fiber",
-  "version": "8.0.12",
+  "version": "8.0.15",
   "description": "A React renderer for Threejs",
   "keywords": [
     "react",