@react-three/drei 9.121.3 → 10.0.0-rc.0

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.
Files changed (212) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +852 -852
  3. package/core/AccumulativeShadows.d.ts +8 -10
  4. package/core/ArcballControls.d.ts +3 -3
  5. package/core/AsciiRenderer.d.ts +1 -2
  6. package/core/BBAnchor.d.ts +3 -3
  7. package/core/Backdrop.d.ts +2 -1
  8. package/core/Billboard.d.ts +3 -2
  9. package/core/Billboard.js +8 -8
  10. package/core/Bounds.d.ts +2 -1
  11. package/core/Bounds.js +2 -2
  12. package/core/Bvh.d.ts +3 -2
  13. package/core/Bvh.js +2 -2
  14. package/core/CameraControls.d.ts +4 -4
  15. package/core/CatmullRomLine.d.ts +2 -3
  16. package/core/Caustics.d.ts +14 -17
  17. package/core/Center.d.ts +3 -2
  18. package/core/Clone.d.ts +4 -4
  19. package/core/Cloud.cjs.js +1 -1
  20. package/core/Cloud.d.ts +50 -12
  21. package/core/Cloud.js +3 -3
  22. package/core/ComputedAttribute.cjs.js +1 -1
  23. package/core/ComputedAttribute.d.ts +3 -4
  24. package/core/ComputedAttribute.js +5 -5
  25. package/core/ContactShadows.d.ts +3 -2
  26. package/core/CubeCamera.d.ts +3 -3
  27. package/core/CubeTexture.d.ts +5 -6
  28. package/core/CubeTexture.js +2 -7
  29. package/core/CubicBezierLine.d.ts +2 -3
  30. package/core/CurveModifier.d.ts +2 -1
  31. package/core/Decal.d.ts +2 -2
  32. package/core/Detailed.d.ts +3 -3
  33. package/core/DetectGPU.d.ts +1 -2
  34. package/core/DeviceOrientationControls.d.ts +2 -2
  35. package/core/Edges.cjs.js +1 -1
  36. package/core/Edges.d.ts +2 -2
  37. package/core/Edges.js +2 -2
  38. package/core/Effects.cjs.js +1 -1
  39. package/core/Effects.d.ts +9 -13
  40. package/core/Effects.js +3 -3
  41. package/core/Environment.cjs.js +1 -1
  42. package/core/Environment.d.ts +5 -7
  43. package/core/Example.js +2 -2
  44. package/core/Fbo.d.ts +1 -4
  45. package/core/Fbo.js +0 -2
  46. package/core/Fbx.d.ts +1 -1
  47. package/core/FirstPersonControls.d.ts +2 -2
  48. package/core/Fisheye.d.ts +2 -1
  49. package/core/Float.d.ts +2 -1
  50. package/core/FlyControls.d.ts +2 -2
  51. package/core/GizmoHelper.d.ts +2 -1
  52. package/core/GizmoViewport.d.ts +2 -2
  53. package/core/Gltf.d.ts +9 -5
  54. package/core/GradientTexture.d.ts +4 -4
  55. package/core/GradientTexture.js +0 -2
  56. package/core/Grid.d.ts +6 -7
  57. package/core/Helper.cjs.js +1 -1
  58. package/core/Helper.d.ts +1 -1
  59. package/core/Helper.js +1 -1
  60. package/core/Hud.d.ts +1 -2
  61. package/core/Image.d.ts +6 -8
  62. package/core/Instances.cjs.js +1 -1
  63. package/core/Instances.d.ts +27 -35
  64. package/core/Instances.js +38 -33
  65. package/core/Ktx2.d.ts +1 -1
  66. package/core/Lightformer.d.ts +3 -3
  67. package/core/Line.d.ts +4 -4
  68. package/core/MapControls.d.ts +4 -4
  69. package/core/MarchingCubes.d.ts +6 -6
  70. package/core/Mask.d.ts +3 -3
  71. package/core/MeshDiscardMaterial.d.ts +6 -7
  72. package/core/MeshDistortMaterial.d.ts +15 -17
  73. package/core/MeshPortalMaterial.cjs.js +1 -1
  74. package/core/MeshPortalMaterial.d.ts +14 -17
  75. package/core/MeshPortalMaterial.js +2 -2
  76. package/core/MeshReflectorMaterial.cjs.js +1 -1
  77. package/core/MeshReflectorMaterial.d.ts +9 -22
  78. package/core/MeshReflectorMaterial.js +2 -4
  79. package/core/MeshRefractionMaterial.cjs.js +1 -1
  80. package/core/MeshRefractionMaterial.d.ts +5 -8
  81. package/core/MeshRefractionMaterial.js +2 -2
  82. package/core/MeshTransmissionMaterial.cjs.js +1 -1
  83. package/core/MeshTransmissionMaterial.d.ts +7 -8
  84. package/core/MeshTransmissionMaterial.js +2 -1
  85. package/core/MeshWobbleMaterial.d.ts +15 -17
  86. package/core/MotionPathControls.cjs.js +1 -1
  87. package/core/MotionPathControls.d.ts +18 -6
  88. package/core/MotionPathControls.js +2 -3
  89. package/core/MultiMaterial.cjs.js +1 -1
  90. package/core/MultiMaterial.d.ts +3 -1
  91. package/core/MultiMaterial.js +2 -3
  92. package/core/OrbitControls.d.ts +4 -4
  93. package/core/OrthographicCamera.d.ts +3 -3
  94. package/core/Outlines.cjs.js +1 -1
  95. package/core/Outlines.d.ts +2 -3
  96. package/core/Outlines.js +2 -2
  97. package/core/PerformanceMonitor.d.ts +2 -2
  98. package/core/PerspectiveCamera.d.ts +3 -3
  99. package/core/PointMaterial.d.ts +3 -11
  100. package/core/PointerLockControls.d.ts +2 -2
  101. package/core/Points.cjs.js +1 -1
  102. package/core/Points.d.ts +10 -13
  103. package/core/Points.js +10 -20
  104. package/core/PositionalAudio.d.ts +3 -3
  105. package/core/Preload.d.ts +2 -3
  106. package/core/QuadraticBezierLine.d.ts +5 -7
  107. package/core/RenderCubeTexture.d.ts +2 -2
  108. package/core/RenderTexture.cjs.js +1 -1
  109. package/core/RenderTexture.d.ts +3 -3
  110. package/core/RenderTexture.js +3 -2
  111. package/core/Resize.d.ts +9 -2
  112. package/core/RoundedBox.d.ts +4 -4
  113. package/core/Sampler.d.ts +4 -4
  114. package/core/ScreenQuad.d.ts +3 -3
  115. package/core/ScreenSizer.d.ts +3 -3
  116. package/core/ScreenSizer.js +12 -12
  117. package/core/ScreenSpace.d.ts +3 -2
  118. package/core/Segments.d.ts +6 -8
  119. package/core/Shadow.d.ts +3 -3
  120. package/core/ShadowAlpha.cjs.js +1 -1
  121. package/core/ShadowAlpha.d.ts +1 -2
  122. package/core/ShadowAlpha.js +9 -9
  123. package/core/Sky.d.ts +2 -3
  124. package/core/Sparkles.d.ts +14 -16
  125. package/core/Splat.d.ts +6 -8
  126. package/core/SpotLight.d.ts +2 -1
  127. package/core/SpriteAnimator.cjs.js +1 -1
  128. package/core/SpriteAnimator.d.ts +36 -3
  129. package/core/Stage.cjs.js +1 -1
  130. package/core/Stage.d.ts +3 -2
  131. package/core/Stars.cjs.js +1 -1
  132. package/core/Stars.d.ts +6 -8
  133. package/core/Stars.js +1 -1
  134. package/core/Stats.d.ts +2 -3
  135. package/core/StatsGl.d.ts +2 -2
  136. package/core/Svg.d.ts +6 -6
  137. package/core/Text.d.ts +3 -4
  138. package/core/Text3D.d.ts +7 -10
  139. package/core/Text3D.js +3 -3
  140. package/core/Texture.d.ts +1 -1
  141. package/core/TrackballControls.d.ts +4 -4
  142. package/core/Trail.cjs.js +1 -1
  143. package/core/Trail.d.ts +3 -3
  144. package/core/Trail.js +3 -3
  145. package/core/TrailTexture.d.ts +3 -2
  146. package/core/TransformControls.cjs.js +1 -1
  147. package/core/TransformControls.d.ts +3 -3
  148. package/core/TransformControls.js +4 -5
  149. package/core/VideoTexture.cjs.js +1 -1
  150. package/core/VideoTexture.js +1 -1
  151. package/core/Wireframe.d.ts +5 -7
  152. package/core/index.cjs.js +1 -1
  153. package/core/index.d.ts +0 -1
  154. package/core/index.js +2 -4
  155. package/core/shapes.d.ts +21 -20
  156. package/core/softShadows.d.ts +1 -2
  157. package/core/softShadows.js +13 -13
  158. package/core/useAnimations.cjs.js +1 -1
  159. package/core/useAnimations.d.ts +2 -2
  160. package/core/useAnimations.js +1 -1
  161. package/core/useBoxProjectedEnv.d.ts +1 -1
  162. package/core/useCamera.cjs.js +1 -1
  163. package/core/useCamera.d.ts +1 -1
  164. package/core/useCamera.js +1 -8
  165. package/core/useContextBridge.d.ts +1 -1
  166. package/core/useContextBridge.js +4 -4
  167. package/core/useEnvironment.cjs.js +1 -1
  168. package/core/useEnvironment.d.ts +3 -4
  169. package/core/useEnvironment.js +11 -19
  170. package/core/useIntersect.d.ts +1 -1
  171. package/core/useSpriteLoader.d.ts +1 -1
  172. package/helpers/deprecated.cjs.js +1 -1
  173. package/helpers/deprecated.d.ts +1 -4
  174. package/helpers/deprecated.js +4 -16
  175. package/helpers/ts-utils.d.ts +4 -0
  176. package/helpers/useEffectfulState.d.ts +1 -1
  177. package/index.cjs.js +1 -1
  178. package/index.js +0 -1
  179. package/materials/BlurPass.js +0 -1
  180. package/materials/MeshReflectorMaterial.d.ts +0 -16
  181. package/native/index.cjs.js +1 -1
  182. package/native/index.js +0 -2
  183. package/package.json +7 -8
  184. package/web/CycleRaycast.d.ts +1 -1
  185. package/web/FaceControls.js +8 -8
  186. package/web/FaceLandmarker.d.ts +1 -2
  187. package/web/Facemesh.d.ts +3 -2
  188. package/web/Html.cjs.js +1 -1
  189. package/web/Html.d.ts +4 -4
  190. package/web/Html.js +1 -1
  191. package/web/KeyboardControls.d.ts +1 -1
  192. package/web/PresentationControls.cjs.js +1 -1
  193. package/web/PresentationControls.d.ts +3 -4
  194. package/web/PresentationControls.js +20 -28
  195. package/web/ScreenVideoTexture.js +2 -2
  196. package/web/ScrollControls.d.ts +1 -1
  197. package/web/Select.d.ts +3 -3
  198. package/web/Select.js +6 -2
  199. package/web/View.cjs.js +1 -1
  200. package/web/View.d.ts +8 -10
  201. package/web/View.js +4 -34
  202. package/web/WebcamVideoTexture.js +2 -2
  203. package/web/index.cjs.js +1 -1
  204. package/web/index.js +1 -4
  205. package/web/pivotControls/AxisArrow.js +0 -2
  206. package/web/pivotControls/AxisRotator.js +0 -2
  207. package/web/pivotControls/PlaneSlider.js +1 -3
  208. package/web/pivotControls/ScalingSphere.js +0 -1
  209. package/web/pivotControls/index.d.ts +1 -2
  210. package/core/Reflector.cjs.js +0 -1
  211. package/core/Reflector.d.ts +0 -30
  212. package/core/Reflector.js +0 -180
@@ -1,10 +1,10 @@
1
1
  import * as React from 'react';
2
2
  import { LOD, Object3D } from 'three';
3
+ import { ThreeElements } from '@react-three/fiber';
3
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
4
- type Props = JSX.IntrinsicElements['lOD'] & {
5
+ export type DetailedProps = Omit<ThreeElements['lOD'], 'ref'> & {
5
6
  children: React.ReactElement<Object3D>[];
6
7
  hysteresis?: number;
7
8
  distances: number[];
8
9
  };
9
- export declare const Detailed: ForwardRefComponent<Props, LOD>;
10
- export {};
10
+ export declare const Detailed: ForwardRefComponent<DetailedProps, LOD>;
@@ -1,8 +1,7 @@
1
1
  import * as React from 'react';
2
2
  import { GetGPUTier } from 'detect-gpu';
3
3
  export declare const useDetectGPU: (props?: GetGPUTier) => import("detect-gpu").TierResult;
4
- type DetectGPUProps = {
4
+ export type DetectGPUProps = {
5
5
  children?: (result: ReturnType<typeof useDetectGPU>) => React.ReactNode;
6
6
  } & Parameters<typeof useDetectGPU>[0];
7
7
  export declare function DetectGPU({ children, ...options }: DetectGPUProps): React.JSX.Element;
8
- export {};
@@ -1,8 +1,8 @@
1
- import { ReactThreeFiber } from '@react-three/fiber';
1
+ import { ThreeElement } from '@react-three/fiber';
2
2
  import * as THREE from 'three';
3
3
  import { DeviceOrientationControls as DeviceOrientationControlsImp } from 'three-stdlib';
4
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
5
- export type DeviceOrientationControlsProps = ReactThreeFiber.Object3DNode<DeviceOrientationControlsImp, typeof DeviceOrientationControlsImp> & {
5
+ export type DeviceOrientationControlsProps = Omit<ThreeElement<typeof DeviceOrientationControlsImp>, 'ref'> & {
6
6
  camera?: THREE.Camera;
7
7
  onChange?: (e?: THREE.Event) => void;
8
8
  makeDefault?: boolean;
package/core/Edges.cjs.js CHANGED
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("three"),n=require("./Line.cjs.js");function u(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function s(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}require("@react-three/fiber"),require("three-stdlib");var c=u(e),i=s(t),o=s(r);const a=i.forwardRef((({threshold:e=15,geometry:t,...r},u)=>{const s=i.useRef(null);i.useImperativeHandle(u,(()=>s.current),[]);const a=i.useMemo((()=>[0,0,0,1,0,0]),[]),f=i.useRef(),l=i.useRef();return i.useLayoutEffect((()=>{const r=s.current.parent,n=null!=t?t:null==r?void 0:r.geometry;if(!n)return;if(f.current===n&&l.current===e)return;f.current=n,l.current=e;const u=new o.EdgesGeometry(n,e).attributes.position.array;s.current.geometry.setPositions(u),s.current.geometry.attributes.instanceStart.needsUpdate=!0,s.current.geometry.attributes.instanceEnd.needsUpdate=!0,s.current.computeLineDistances()})),i.createElement(n.Line,c.default({segments:!0,points:a,ref:s,raycast:()=>null},r))}));exports.Edges=a;
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("three"),n=require("./Line.cjs.js");function u(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function s(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}require("@react-three/fiber"),require("three-stdlib");var c=u(e),i=s(t),o=s(r);const a=i.forwardRef((({threshold:e=15,geometry:t,...r},u)=>{const s=i.useRef(null);i.useImperativeHandle(u,(()=>s.current),[]);const a=i.useMemo((()=>[0,0,0,1,0,0]),[]),l=i.useRef(null),f=i.useRef(null);return i.useLayoutEffect((()=>{const r=s.current.parent,n=null!=t?t:null==r?void 0:r.geometry;if(!n)return;if(l.current===n&&f.current===e)return;l.current=n,f.current=e;const u=new o.EdgesGeometry(n,e).attributes.position.array;s.current.geometry.setPositions(u),s.current.geometry.attributes.instanceStart.needsUpdate=!0,s.current.geometry.attributes.instanceEnd.needsUpdate=!0,s.current.computeLineDistances()})),i.createElement(n.Line,c.default({segments:!0,points:a,ref:s,raycast:()=>null},r))}));exports.Edges=a;
package/core/Edges.d.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  import * as THREE from 'three';
2
- import { ReactThreeFiber, type ThreeElements } from '@react-three/fiber';
2
+ import { ThreeElement, type ThreeElements } from '@react-three/fiber';
3
3
  import { LineSegmentsGeometry, LineMaterial, LineMaterialParameters, Line2 } from 'three-stdlib';
4
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
5
5
  export type EdgesRef = THREE.Mesh<LineSegmentsGeometry, LineMaterial>;
6
6
  export type EdgesProps = Partial<ThreeElements['mesh']> & {
7
7
  threshold?: number;
8
8
  lineWidth?: number;
9
- } & Omit<LineMaterialParameters, 'vertexColors' | 'color'> & Omit<ReactThreeFiber.Object3DNode<Line2, typeof Line2>, 'args' | 'geometry'> & Omit<ReactThreeFiber.Object3DNode<LineMaterial, [LineMaterialParameters]>, 'color' | 'vertexColors' | 'args'> & {
9
+ } & Omit<LineMaterialParameters, 'vertexColors' | 'color'> & Omit<ThreeElement<typeof Line2>, 'args' | 'geometry'> & Omit<ThreeElement<typeof LineMaterial>, 'color' | 'vertexColors' | 'args'> & {
10
10
  geometry?: THREE.BufferGeometry;
11
11
  color?: THREE.ColorRepresentation;
12
12
  };
package/core/Edges.js CHANGED
@@ -11,8 +11,8 @@ const Edges = /* @__PURE__ */React.forwardRef(({
11
11
  const ref = React.useRef(null);
12
12
  React.useImperativeHandle(fref, () => ref.current, []);
13
13
  const tmpPoints = React.useMemo(() => [0, 0, 0, 1, 0, 0], []);
14
- const memoizedGeometry = React.useRef();
15
- const memoizedThreshold = React.useRef();
14
+ const memoizedGeometry = React.useRef(null);
15
+ const memoizedThreshold = React.useRef(null);
16
16
  React.useLayoutEffect(() => {
17
17
  const parent = ref.current.parent;
18
18
  const geometry = explicitGeometry !== null && explicitGeometry !== void 0 ? explicitGeometry : parent == null ? void 0 : parent.geometry;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),r=require("react"),t=require("three"),n=require("@react-three/fiber"),a=require("three-stdlib");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function c(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var n=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,n.get?n:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var u=s(e),l=c(r);const o=l.forwardRef((({children:e,multisamping:r=8,renderIndex:s=1,disableRender:c,disableGamma:o,disableRenderPass:i,depthBuffer:d=!0,stencilBuffer:f=!1,anisotropy:p=1,encoding:h,type:m,...g},b)=>{l.useMemo((()=>n.extend({EffectComposer:a.EffectComposer,RenderPass:a.RenderPass,ShaderPass:a.ShaderPass})),[]);const y=l.useRef(null);l.useImperativeHandle(b,(()=>y.current),[]);const{scene:v,camera:x,gl:E,size:P,viewport:R}=n.useThree(),[w]=l.useState((()=>{const e=new t.WebGLRenderTarget(P.width,P.height,{type:m||t.HalfFloatType,format:t.RGBAFormat,depthBuffer:d,stencilBuffer:f,anisotropy:p});return m===t.UnsignedByteType&&null!=h&&("colorSpace"in e?e.texture.colorSpace=h:e.texture.encoding=h),e.samples=r,e}));l.useEffect((()=>{var e,r;null==(e=y.current)||e.setSize(P.width,P.height),null==(r=y.current)||r.setPixelRatio(R.dpr)}),[E,P,R.dpr]),n.useFrame((()=>{var e;c||null==(e=y.current)||e.render()}),s);const j=[];return i||j.push(l.createElement("renderPass",{key:"renderpass",attach:`passes-${j.length}`,args:[v,x]})),o||j.push(l.createElement("shaderPass",{attach:`passes-${j.length}`,key:"gammapass",args:[a.GammaCorrectionShader]})),l.Children.forEach(e,(e=>{e&&j.push(l.cloneElement(e,{key:j.length,attach:`passes-${j.length}`}))})),l.createElement("effectComposer",u.default({ref:y,args:[E,w]},g),j)}));exports.Effects=o,exports.isWebGL2Available=()=>{try{var e=document.createElement("canvas");return!(!window.WebGL2RenderingContext||!e.getContext("webgl2"))}catch(e){return!1}};
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),r=require("react"),t=require("three"),a=require("@react-three/fiber"),n=require("three-stdlib");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function u(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var a=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,a.get?a:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var c=s(e),l=u(r);const o=l.forwardRef((({children:e,multisamping:r=8,renderIndex:s=1,disableRender:u,disableGamma:o,disableRenderPass:i,depthBuffer:d=!0,stencilBuffer:f=!1,anisotropy:p=1,colorSpace:h,type:m,...b},g)=>{l.useMemo((()=>a.extend({EffectComposer:n.EffectComposer,RenderPass:n.RenderPass,ShaderPass:n.ShaderPass})),[]);const y=l.useRef(null);l.useImperativeHandle(g,(()=>y.current),[]);const{scene:v,camera:E,gl:P,size:x,viewport:R}=a.useThree(),[w]=l.useState((()=>{const e=new t.WebGLRenderTarget(x.width,x.height,{type:m||t.HalfFloatType,format:t.RGBAFormat,depthBuffer:d,stencilBuffer:f,anisotropy:p});return m===t.UnsignedByteType&&null!=h&&(e.texture.colorSpace=h),e.samples=r,e}));l.useEffect((()=>{var e,r;null==(e=y.current)||e.setSize(x.width,x.height),null==(r=y.current)||r.setPixelRatio(R.dpr)}),[P,x,R.dpr]),a.useFrame((()=>{var e;u||null==(e=y.current)||e.render()}),s);const j=[];return i||j.push(l.createElement("renderPass",{key:"renderpass",attach:`passes-${j.length}`,args:[v,E]})),o||j.push(l.createElement("shaderPass",{attach:`passes-${j.length}`,key:"gammapass",args:[n.GammaCorrectionShader]})),l.Children.forEach(e,(e=>{e&&j.push(l.cloneElement(e,{key:j.length,attach:`passes-${j.length}`}))})),l.createElement("effectComposer",c.default({ref:y,args:[P,w]},b),j)}));exports.Effects=o,exports.isWebGL2Available=()=>{try{var e=document.createElement("canvas");return!(!window.WebGL2RenderingContext||!e.getContext("webgl2"))}catch(e){return!1}};
package/core/Effects.d.ts CHANGED
@@ -1,11 +1,10 @@
1
1
  import { TextureDataType } from 'three';
2
- import { ReactThreeFiber } from '@react-three/fiber';
2
+ import { ThreeElement, ThreeElements } from '@react-three/fiber';
3
3
  import { EffectComposer, RenderPass, ShaderPass } from 'three-stdlib';
4
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
5
- import { TextureEncoding } from '../helpers/deprecated';
6
- type Props = ReactThreeFiber.Node<EffectComposer, typeof EffectComposer> & {
5
+ export type EffectsProps = Omit<ThreeElements['effectComposer'], 'ref' | 'args'> & {
7
6
  multisamping?: number;
8
- encoding?: TextureEncoding;
7
+ colorSpace?: THREE.ColorSpace;
9
8
  type?: TextureDataType;
10
9
  renderIndex?: number;
11
10
  disableGamma?: boolean;
@@ -15,15 +14,12 @@ type Props = ReactThreeFiber.Node<EffectComposer, typeof EffectComposer> & {
15
14
  stencilBuffer?: boolean;
16
15
  anisotropy?: number;
17
16
  };
18
- declare global {
19
- namespace JSX {
20
- interface IntrinsicElements {
21
- effectComposer: ReactThreeFiber.Node<EffectComposer, typeof EffectComposer>;
22
- renderPass: ReactThreeFiber.Node<RenderPass, typeof RenderPass>;
23
- shaderPass: ReactThreeFiber.Node<ShaderPass, typeof ShaderPass>;
24
- }
17
+ declare module '@react-three/fiber' {
18
+ interface ThreeElements {
19
+ effectComposer: ThreeElement<typeof EffectComposer>;
20
+ renderPass: ThreeElement<typeof RenderPass>;
21
+ shaderPass: ThreeElement<typeof ShaderPass>;
25
22
  }
26
23
  }
27
24
  export declare const isWebGL2Available: () => boolean;
28
- export declare const Effects: ForwardRefComponent<Props, EffectComposer>;
29
- export {};
25
+ export declare const Effects: ForwardRefComponent<EffectsProps, EffectComposer>;
package/core/Effects.js CHANGED
@@ -22,7 +22,7 @@ const Effects = /* @__PURE__ */React.forwardRef(({
22
22
  depthBuffer = true,
23
23
  stencilBuffer = false,
24
24
  anisotropy = 1,
25
- encoding,
25
+ colorSpace,
26
26
  type,
27
27
  ...props
28
28
  }, ref) => {
@@ -50,8 +50,8 @@ const Effects = /* @__PURE__ */React.forwardRef(({
50
50
  });
51
51
 
52
52
  // sRGB textures must be RGBA8 since r137 https://github.com/mrdoob/three.js/pull/23129
53
- if (type === UnsignedByteType && encoding != null) {
54
- if ('colorSpace' in t) t.texture.colorSpace = encoding;else t.texture.encoding = encoding;
53
+ if (type === UnsignedByteType && colorSpace != null) {
54
+ t.texture.colorSpace = colorSpace;
55
55
  }
56
56
  t.samples = multisamping;
57
57
  return t;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),n=require("react"),t=require("@react-three/fiber"),r=require("three"),o=require("three-stdlib"),u=require("./useEnvironment.cjs.js");function a(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function i(e){if(e&&e.__esModule)return e;var n=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var r=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(n,t,r.get?r:{enumerable:!0,get:function(){return e[t]}})}})),n.default=e,Object.freeze(n)}require("@monogrid/gainmap-js"),require("../helpers/environment-assets.cjs.js"),require("../helpers/deprecated.cjs.js");var s=a(e),c=i(n);function l(e,n,r,o,u={}){var a,i,s,c;u={backgroundBlurriness:0,backgroundIntensity:1,backgroundRotation:[0,0,0],environmentIntensity:1,environmentRotation:[0,0,0],...u};const l=(e=>{return(n=e).current&&n.current.isScene?e.current:e;var n})(n||r),d=l.background,m=l.environment,g={backgroundBlurriness:l.backgroundBlurriness,backgroundIntensity:l.backgroundIntensity,backgroundRotation:null!==(a=null==(i=l.backgroundRotation)||null==i.clone?void 0:i.clone())&&void 0!==a?a:[0,0,0],environmentIntensity:l.environmentIntensity,environmentRotation:null!==(s=null==(c=l.environmentRotation)||null==c.clone?void 0:c.clone())&&void 0!==s?s:[0,0,0]};return"only"!==e&&(l.environment=o),e&&(l.background=o),t.applyProps(l,u),()=>{"only"!==e&&(l.environment=m),e&&(l.background=d),t.applyProps(l,g)}}function d({scene:e,background:n=!1,map:r,...o}){const u=t.useThree((e=>e.scene));return c.useLayoutEffect((()=>{if(r)return l(n,e,u,r,o)})),null}function m({background:e=!1,scene:n,blur:r,backgroundBlurriness:o,backgroundIntensity:a,backgroundRotation:i,environmentIntensity:s,environmentRotation:d,...m}){const g=u.useEnvironment(m),b=t.useThree((e=>e.scene));return c.useLayoutEffect((()=>l(e,n,b,g,{backgroundBlurriness:null!=r?r:o,backgroundIntensity:a,backgroundRotation:i,environmentIntensity:s,environmentRotation:d}))),c.useEffect((()=>()=>{g.dispose()}),[g]),null}function g({children:e,near:n=.1,far:o=1e3,resolution:u=256,frames:a=1,map:i,background:s=!1,blur:g,backgroundBlurriness:b,backgroundIntensity:f,backgroundRotation:v,environmentIntensity:p,environmentRotation:k,scene:E,files:y,path:h,preset:j,extensions:I}){const R=t.useThree((e=>e.gl)),x=t.useThree((e=>e.scene)),P=c.useRef(null),[q]=c.useState((()=>new r.Scene)),C=c.useMemo((()=>{const e=new r.WebGLCubeRenderTarget(u);return e.texture.type=r.HalfFloatType,e}),[u]);c.useEffect((()=>()=>{C.dispose()}),[C]),c.useLayoutEffect((()=>{if(1===a){const e=R.autoClear;R.autoClear=!0,P.current.update(R,q),R.autoClear=e}return l(s,E,x,C.texture,{backgroundBlurriness:null!=g?g:b,backgroundIntensity:f,backgroundRotation:v,environmentIntensity:p,environmentRotation:k})}),[e,q,C.texture,E,x,s,a,R]);let B=1;return t.useFrame((()=>{if(a===1/0||B<a){const e=R.autoClear;R.autoClear=!0,P.current.update(R,q),R.autoClear=e,B++}})),c.createElement(c.Fragment,null,t.createPortal(c.createElement(c.Fragment,null,e,c.createElement("cubeCamera",{ref:P,args:[n,o,C]}),y||j?c.createElement(m,{background:!0,files:y,preset:j,path:h,extensions:I}):i?c.createElement(d,{background:!0,map:i,extensions:I}):null),q))}function b(e){var n,r,a,i;const l=u.useEnvironment(e),m=e.map||l;c.useMemo((()=>t.extend({GroundProjectedEnvImpl:o.GroundProjectedEnv})),[]),c.useEffect((()=>()=>{l.dispose()}),[l]);const g=c.useMemo((()=>[m]),[m]),b=null==(n=e.ground)?void 0:n.height,f=null==(r=e.ground)?void 0:r.radius,v=null!==(a=null==(i=e.ground)?void 0:i.scale)&&void 0!==a?a:1e3;return c.createElement(c.Fragment,null,c.createElement(d,s.default({},e,{map:m})),c.createElement("groundProjectedEnvImpl",{args:g,scale:v,height:b,radius:f}))}exports.Environment=function(e){return e.ground?c.createElement(b,e):e.map?c.createElement(d,e):e.children?c.createElement(g,e):c.createElement(m,e)},exports.EnvironmentCube=m,exports.EnvironmentMap=d,exports.EnvironmentPortal=g;
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),n=require("react"),t=require("@react-three/fiber"),r=require("three"),o=require("three-stdlib"),u=require("./useEnvironment.cjs.js");function a(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function i(e){if(e&&e.__esModule)return e;var n=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var r=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(n,t,r.get?r:{enumerable:!0,get:function(){return e[t]}})}})),n.default=e,Object.freeze(n)}require("@monogrid/gainmap-js"),require("../helpers/environment-assets.cjs.js");var s=a(e),c=i(n);function l(e,n,r,o,u={}){var a,i,s,c;u={backgroundBlurriness:0,backgroundIntensity:1,backgroundRotation:[0,0,0],environmentIntensity:1,environmentRotation:[0,0,0],...u};const l=(e=>{return(n=e).current&&n.current.isScene?e.current:e;var n})(n||r),d=l.background,m=l.environment,g={backgroundBlurriness:l.backgroundBlurriness,backgroundIntensity:l.backgroundIntensity,backgroundRotation:null!==(a=null==(i=l.backgroundRotation)||null==i.clone?void 0:i.clone())&&void 0!==a?a:[0,0,0],environmentIntensity:l.environmentIntensity,environmentRotation:null!==(s=null==(c=l.environmentRotation)||null==c.clone?void 0:c.clone())&&void 0!==s?s:[0,0,0]};return"only"!==e&&(l.environment=o),e&&(l.background=o),t.applyProps(l,u),()=>{"only"!==e&&(l.environment=m),e&&(l.background=d),t.applyProps(l,g)}}function d({scene:e,background:n=!1,map:r,...o}){const u=t.useThree((e=>e.scene));return c.useLayoutEffect((()=>{if(r)return l(n,e,u,r,o)})),null}function m({background:e=!1,scene:n,blur:r,backgroundBlurriness:o,backgroundIntensity:a,backgroundRotation:i,environmentIntensity:s,environmentRotation:d,...m}){const g=u.useEnvironment(m),b=t.useThree((e=>e.scene));return c.useLayoutEffect((()=>l(e,n,b,g,{backgroundBlurriness:null!=r?r:o,backgroundIntensity:a,backgroundRotation:i,environmentIntensity:s,environmentRotation:d}))),c.useEffect((()=>()=>{g.dispose()}),[g]),null}function g({children:e,near:n=.1,far:o=1e3,resolution:u=256,frames:a=1,map:i,background:s=!1,blur:g,backgroundBlurriness:b,backgroundIntensity:f,backgroundRotation:v,environmentIntensity:p,environmentRotation:k,scene:E,files:y,path:h,preset:I,extensions:R}){const j=t.useThree((e=>e.gl)),x=t.useThree((e=>e.scene)),P=c.useRef(null),[C]=c.useState((()=>new r.Scene)),q=c.useMemo((()=>{const e=new r.WebGLCubeRenderTarget(u);return e.texture.type=r.HalfFloatType,e}),[u]);c.useEffect((()=>()=>{q.dispose()}),[q]),c.useLayoutEffect((()=>{if(1===a){const e=j.autoClear;j.autoClear=!0,P.current.update(j,C),j.autoClear=e}return l(s,E,x,q.texture,{backgroundBlurriness:null!=g?g:b,backgroundIntensity:f,backgroundRotation:v,environmentIntensity:p,environmentRotation:k})}),[e,C,q.texture,E,x,s,a,j]);let B=1;return t.useFrame((()=>{if(a===1/0||B<a){const e=j.autoClear;j.autoClear=!0,P.current.update(j,C),j.autoClear=e,B++}})),c.createElement(c.Fragment,null,t.createPortal(c.createElement(c.Fragment,null,e,c.createElement("cubeCamera",{ref:P,args:[n,o,q]}),y||I?c.createElement(m,{background:!0,files:y,preset:I,path:h,extensions:R}):i?c.createElement(d,{background:!0,map:i,extensions:R}):null),C))}function b(e){var n,r,a,i;const l=u.useEnvironment(e),m=e.map||l;c.useMemo((()=>t.extend({GroundProjectedEnvImpl:o.GroundProjectedEnv})),[]),c.useEffect((()=>()=>{l.dispose()}),[l]);const g=c.useMemo((()=>[m]),[m]),b=null==(n=e.ground)?void 0:n.height,f=null==(r=e.ground)?void 0:r.radius,v=null!==(a=null==(i=e.ground)?void 0:i.scale)&&void 0!==a?a:1e3;return c.createElement(c.Fragment,null,c.createElement(d,s.default({},e,{map:m})),c.createElement("groundProjectedEnvImpl",{args:g,scale:v,height:b,radius:f}))}exports.Environment=function(e){return e.ground?c.createElement(b,e):e.map?c.createElement(d,e):e.children?c.createElement(g,e):c.createElement(m,e)},exports.EnvironmentCube=m,exports.EnvironmentMap=d,exports.EnvironmentPortal=g;
@@ -1,5 +1,5 @@
1
1
  import * as React from 'react';
2
- import { Object3DNode, Euler } from '@react-three/fiber';
2
+ import { Euler, ThreeElement } from '@react-three/fiber';
3
3
  import { Texture, Scene } from 'three';
4
4
  import { GroundProjectedEnv as GroundProjectedEnvImpl } from 'three-stdlib';
5
5
  import { PresetsType } from '../helpers/environment-assets';
@@ -19,7 +19,7 @@ export type EnvironmentProps = {
19
19
  environmentRotation?: Euler;
20
20
  map?: Texture;
21
21
  preset?: PresetsType;
22
- scene?: Scene | React.MutableRefObject<Scene>;
22
+ scene?: Scene | React.RefObject<Scene>;
23
23
  ground?: boolean | {
24
24
  radius?: number;
25
25
  height?: number;
@@ -29,11 +29,9 @@ export type EnvironmentProps = {
29
29
  export declare function EnvironmentMap({ scene, background, map, ...config }: EnvironmentProps): null;
30
30
  export declare function EnvironmentCube({ background, scene, blur, backgroundBlurriness, backgroundIntensity, backgroundRotation, environmentIntensity, environmentRotation, ...rest }: EnvironmentProps): null;
31
31
  export declare function EnvironmentPortal({ children, near, far, resolution, frames, map, background, blur, backgroundBlurriness, backgroundIntensity, backgroundRotation, environmentIntensity, environmentRotation, scene, files, path, preset, extensions, }: EnvironmentProps): React.JSX.Element;
32
- declare global {
33
- namespace JSX {
34
- interface IntrinsicElements {
35
- groundProjectedEnvImpl: Object3DNode<GroundProjectedEnvImpl, typeof GroundProjectedEnvImpl>;
36
- }
32
+ declare module '@react-three/fiber' {
33
+ interface ThreeElements {
34
+ groundProjectedEnvImpl: ThreeElement<typeof GroundProjectedEnvImpl>;
37
35
  }
38
36
  }
39
37
  export declare function Environment(props: EnvironmentProps): React.JSX.Element;
package/core/Example.js CHANGED
@@ -3,8 +3,8 @@ import { Text3D } from './Text3D.js';
3
3
  import { Center } from './Center.js';
4
4
 
5
5
  /* eslint react-hooks/exhaustive-deps: 1 */
6
- /**
7
- * A simple counter example component. Click to increment, meta-click to decrement.
6
+ /**
7
+ * A simple counter example component. Click to increment, meta-click to decrement.
8
8
  */
9
9
  const Example = /* @__PURE__ */React.forwardRef(({
10
10
  font,
package/core/Fbo.d.ts CHANGED
@@ -1,7 +1,5 @@
1
1
  import * as React from 'react';
2
2
  import * as THREE from 'three';
3
- import { TextureEncoding } from '../helpers/deprecated';
4
- type ColorSpace = 'srgb' | 'srgb-linear' | '' | string;
5
3
  type FBOSettings = {
6
4
  samples?: number;
7
5
  depth?: boolean;
@@ -16,8 +14,7 @@ type FBOSettings = {
16
14
  stencilBuffer?: boolean | undefined;
17
15
  generateMipmaps?: boolean | undefined;
18
16
  depthTexture?: THREE.DepthTexture | undefined;
19
- encoding?: TextureEncoding | undefined;
20
- colorSpace?: ColorSpace | undefined;
17
+ colorSpace?: THREE.ColorSpace | undefined;
21
18
  };
22
19
  export declare function useFBO(width?: number | FBOSettings, height?: number, settings?: FBOSettings): THREE.WebGLRenderTarget;
23
20
  export declare const Fbo: ({ children, width, height, ...settings }: {
package/core/Fbo.js CHANGED
@@ -2,8 +2,6 @@ import * as React from 'react';
2
2
  import * as THREE from 'three';
3
3
  import { useThree } from '@react-three/fiber';
4
4
 
5
- // TODO: consume this from three >r154 when SemVer allows
6
-
7
5
  // 👇 uncomment when TS version supports function overloads
8
6
  // export function useFBO(settings?: FBOSettings)
9
7
  function useFBO(/** Width in pixels, or settings (will render fullscreen by default) */
package/core/Fbx.d.ts CHANGED
@@ -3,7 +3,7 @@ import { Group } from 'three';
3
3
  import { Clone } from './Clone';
4
4
  export declare function useFBX(path: string): Group;
5
5
  export declare namespace useFBX {
6
- var preload: (path: string) => undefined;
6
+ var preload: (path: string) => void;
7
7
  var clear: (input: string | string[]) => void;
8
8
  }
9
9
  export declare function Fbx({ path, ...props }: {
@@ -1,7 +1,7 @@
1
- import { Object3DNode } from '@react-three/fiber';
1
+ import { ThreeElement } from '@react-three/fiber';
2
2
  import { FirstPersonControls as FirstPersonControlImpl } from 'three-stdlib';
3
3
  import { ForwardRefComponent } from '../helpers/ts-utils';
4
- export type FirstPersonControlsProps = Object3DNode<FirstPersonControlImpl, typeof FirstPersonControlImpl> & {
4
+ export type FirstPersonControlsProps = Omit<ThreeElement<typeof FirstPersonControlImpl>, 'ref'> & {
5
5
  domElement?: HTMLElement;
6
6
  makeDefault?: boolean;
7
7
  };
package/core/Fisheye.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import * as React from 'react';
2
- export type FisheyeProps = JSX.IntrinsicElements['mesh'] & {
2
+ import { ThreeElements } from '@react-three/fiber';
3
+ export type FisheyeProps = ThreeElements['mesh'] & {
3
4
  zoom?: number;
4
5
  segments?: number;
5
6
  resolution?: number;
package/core/Float.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  import * as React from 'react';
2
+ import { ThreeElements } from '@react-three/fiber';
2
3
  import * as THREE from 'three';
3
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
4
- export type FloatProps = JSX.IntrinsicElements['group'] & {
5
+ export type FloatProps = Omit<ThreeElements['group'], 'ref'> & {
5
6
  enabled?: boolean;
6
7
  speed?: number;
7
8
  rotationIntensity?: number;
@@ -1,8 +1,8 @@
1
- import { ReactThreeFiber } from '@react-three/fiber';
1
+ import { ThreeElement } from '@react-three/fiber';
2
2
  import * as THREE from 'three';
3
3
  import { FlyControls as FlyControlsImpl } from 'three-stdlib';
4
4
  import { ForwardRefComponent } from '../helpers/ts-utils';
5
- export type FlyControlsProps = ReactThreeFiber.Object3DNode<FlyControlsImpl, typeof FlyControlsImpl> & {
5
+ export type FlyControlsProps = Omit<ThreeElement<typeof FlyControlsImpl>, 'ref' | 'args'> & {
6
6
  onChange?: (e?: THREE.Event) => void;
7
7
  domElement?: HTMLElement;
8
8
  makeDefault?: boolean;
@@ -1,9 +1,10 @@
1
+ import { ThreeElements } from '@react-three/fiber';
1
2
  import { Vector3 } from 'three';
2
3
  type GizmoHelperContext = {
3
4
  tweenCamera: (direction: Vector3) => void;
4
5
  };
5
6
  export declare const useGizmoContext: () => GizmoHelperContext;
6
- export type GizmoHelperProps = JSX.IntrinsicElements['group'] & {
7
+ export type GizmoHelperProps = ThreeElements['group'] & {
7
8
  alignment?: 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left' | 'bottom-center' | 'center-right' | 'center-left' | 'center-center' | 'top-center';
8
9
  margin?: [number, number];
9
10
  renderPriority?: number;
@@ -1,6 +1,6 @@
1
1
  import * as React from 'react';
2
- import { ThreeEvent } from '@react-three/fiber';
3
- type GizmoViewportProps = JSX.IntrinsicElements['group'] & {
2
+ import { ThreeEvent, ThreeElements } from '@react-three/fiber';
3
+ type GizmoViewportProps = ThreeElements['group'] & {
4
4
  axisColors?: [string, string, string];
5
5
  axisScale?: [number, number, number];
6
6
  labels?: [string, string, string];
package/core/Gltf.d.ts CHANGED
@@ -1,23 +1,27 @@
1
1
  import * as React from 'react';
2
2
  import { GLTFLoader, GLTF } from 'three-stdlib';
3
3
  import { ObjectMap } from '@react-three/fiber';
4
- import { Clone } from './Clone';
4
+ import { CloneProps } from './Clone';
5
5
  type Path = string | string[];
6
6
  type UseDraco = boolean | string;
7
7
  type UseMeshopt = boolean;
8
8
  type ExtendLoader = (loader: GLTFLoader) => void;
9
9
  export declare const useGLTF: {
10
10
  <T extends Path>(path: T, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader): T extends any[] ? (GLTF & ObjectMap)[] : GLTF & ObjectMap;
11
- preload(path: Path, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader): undefined;
11
+ preload(path: Path, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader): void;
12
12
  clear(path: Path): void;
13
13
  setDecoderPath(path: string): void;
14
14
  };
15
- type CloneProps = React.ComponentProps<typeof Clone>;
16
- type GltfProps = Omit<CloneProps, 'object'> & {
15
+ export type GltfProps = Omit<CloneProps, 'object'> & {
17
16
  src: string;
18
17
  useDraco?: UseDraco;
19
18
  useMeshOpt?: UseMeshopt;
20
19
  extendLoader?: ExtendLoader;
21
20
  };
22
- export declare const Gltf: React.ForwardRefExoticComponent<Omit<GltfProps, "ref"> & React.RefAttributes<import("three").Group>>;
21
+ export declare const Gltf: React.ForwardRefExoticComponent<Omit<CloneProps, "object"> & {
22
+ src: string;
23
+ useDraco?: UseDraco;
24
+ useMeshOpt?: UseMeshopt;
25
+ extendLoader?: ExtendLoader;
26
+ } & React.RefAttributes<import("three").Group<import("three").Object3DEventMap>>>;
23
27
  export {};
@@ -1,10 +1,11 @@
1
1
  import * as React from 'react';
2
+ import { ThreeElements } from '@react-three/fiber';
2
3
  import * as THREE from 'three';
3
4
  export declare enum GradientType {
4
5
  Linear = "linear",
5
6
  Radial = "radial"
6
7
  }
7
- type Props = {
8
+ export type GradientTextureProps = {
8
9
  stops: Array<number>;
9
10
  colors: Array<THREE.ColorRepresentation>;
10
11
  attach?: string;
@@ -13,6 +14,5 @@ type Props = {
13
14
  type?: GradientType;
14
15
  innerCircleRadius?: number;
15
16
  outerCircleRadius?: string | number;
16
- } & Omit<JSX.IntrinsicElements['texture'], 'type'>;
17
- export declare function GradientTexture({ stops, colors, size, width, type, innerCircleRadius, outerCircleRadius, ...props }: Props): React.JSX.Element;
18
- export {};
17
+ } & Omit<ThreeElements['texture'], 'args' | 'type'>;
18
+ export declare function GradientTexture({ stops, colors, size, width, type, innerCircleRadius, outerCircleRadius, ...props }: GradientTextureProps): React.JSX.Element;
@@ -44,8 +44,6 @@ function GradientTexture({
44
44
  context.restore();
45
45
  return canvas;
46
46
  }, [stops]);
47
-
48
- // @ts-ignore ????
49
47
  return /*#__PURE__*/React.createElement("canvasTexture", _extends({
50
48
  colorSpace: gl.outputColorSpace,
51
49
  args: [canvas],
package/core/Grid.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import * as THREE from 'three';
2
+ import { ThreeElements } from '@react-three/fiber';
2
3
  import { ForwardRefComponent } from '../helpers/ts-utils';
3
4
  export type GridMaterialType = {
4
5
  cellSize?: number;
@@ -14,14 +15,12 @@ export type GridMaterialType = {
14
15
  fadeFrom?: number;
15
16
  side?: THREE.Side;
16
17
  };
17
- export type GridProps = GridMaterialType & {
18
+ export type GridProps = Omit<ThreeElements['mesh'], 'ref' | 'args'> & GridMaterialType & {
18
19
  args?: ConstructorParameters<typeof THREE.PlaneGeometry>;
19
20
  };
20
- declare global {
21
- namespace JSX {
22
- interface IntrinsicElements {
23
- gridMaterial: JSX.IntrinsicElements['shaderMaterial'] & GridMaterialType;
24
- }
21
+ declare module '@react-three/fiber' {
22
+ interface ThreeElements {
23
+ gridMaterial: ThreeElements['shaderMaterial'] & GridMaterialType;
25
24
  }
26
25
  }
27
- export declare const Grid: ForwardRefComponent<Omit<JSX.IntrinsicElements['mesh'], 'args'> & GridProps, THREE.Mesh>;
26
+ export declare const Grid: ForwardRefComponent<GridProps, THREE.Mesh>;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),r=require("@react-three/fiber");function t(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var u=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,u.get?u:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var u=t(e);function n(e,t,...n){const c=u.useRef(),s=r.useThree((e=>e.scene));return u.useLayoutEffect((()=>{let r;if(e&&null!=e&&e.current&&t&&(c.current=r=new t(e.current,...n)),r)return r.traverse((e=>e.raycast=()=>null)),s.add(r),()=>{c.current=void 0,s.remove(r),null==r.dispose||r.dispose()}}),[s,t,e,...n]),r.useFrame((()=>{var e;null==(e=c.current)||null==e.update||e.update()})),c}exports.Helper=({type:e,args:r=[]})=>{const t=u.useRef(null),c=u.useRef(null);return u.useLayoutEffect((()=>{c.current=t.current.parent})),n(c,e,...r),u.createElement("object3D",{ref:t})},exports.useHelper=n;
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),r=require("@react-three/fiber");function t(e){if(e&&e.__esModule)return e;var r=Object.create(null);return e&&Object.keys(e).forEach((function(t){if("default"!==t){var u=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(r,t,u.get?u:{enumerable:!0,get:function(){return e[t]}})}})),r.default=e,Object.freeze(r)}var u=t(e);function n(e,t,...n){const c=u.useRef(null),l=r.useThree((e=>e.scene));return u.useLayoutEffect((()=>{let r;if(e&&null!=e&&e.current&&t&&(c.current=r=new t(e.current,...n)),r)return r.traverse((e=>e.raycast=()=>null)),l.add(r),()=>{c.current=void 0,l.remove(r),null==r.dispose||r.dispose()}}),[l,t,e,...n]),r.useFrame((()=>{var e;null==(e=c.current)||null==e.update||e.update()})),c}exports.Helper=({type:e,args:r=[]})=>{const t=u.useRef(null),c=u.useRef(null);return u.useLayoutEffect((()=>{c.current=t.current.parent})),n(c,e,...r),u.createElement("object3D",{ref:t})},exports.useHelper=n;
package/core/Helper.d.ts CHANGED
@@ -7,7 +7,7 @@ type HelperType = Object3D & {
7
7
  };
8
8
  type HelperConstructor = new (...args: any[]) => any;
9
9
  type HelperArgs<T> = T extends [infer _, ...infer R] ? R : never;
10
- export declare function useHelper<T extends HelperConstructor>(object3D: React.MutableRefObject<Object3D> | Falsey, helperConstructor: T, ...args: HelperArgs<ConstructorParameters<T>>): React.MutableRefObject<HelperType | undefined>;
10
+ export declare function useHelper<T extends HelperConstructor>(object3D: React.RefObject<Object3D> | Falsey, helperConstructor: T, ...args: HelperArgs<ConstructorParameters<T>>): React.RefObject<HelperType | null>;
11
11
  export type HelperProps<T extends HelperConstructor> = {
12
12
  type: T;
13
13
  args?: HelperArgs<ConstructorParameters<T>>;
package/core/Helper.js CHANGED
@@ -2,7 +2,7 @@ import * as React from 'react';
2
2
  import { useThree, useFrame } from '@react-three/fiber';
3
3
 
4
4
  function useHelper(object3D, helperConstructor, ...args) {
5
- const helper = React.useRef();
5
+ const helper = React.useRef(null);
6
6
  const scene = useThree(state => state.scene);
7
7
  React.useLayoutEffect(() => {
8
8
  let currentHelper = undefined;
package/core/Hud.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  import * as React from 'react';
2
- type HudProps = {
2
+ export type HudProps = {
3
3
  children: React.ReactNode;
4
4
  renderPriority?: number;
5
5
  };
6
6
  export declare function Hud({ children, renderPriority }: HudProps): React.JSX.Element;
7
- export {};
package/core/Image.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import * as THREE from 'three';
2
- import { Color } from '@react-three/fiber';
2
+ import { Color, ThreeElements } from '@react-three/fiber';
3
3
  import { ForwardRefComponent } from '../helpers/ts-utils';
4
- export type ImageProps = Omit<JSX.IntrinsicElements['mesh'], 'scale'> & {
4
+ export type ImageProps = Omit<ThreeElements['mesh'], 'scale'> & {
5
5
  segments?: number;
6
6
  scale?: number | [number, number];
7
7
  color?: Color;
@@ -19,7 +19,7 @@ export type ImageProps = Omit<JSX.IntrinsicElements['mesh'], 'scale'> & {
19
19
  texture?: never;
20
20
  url: string;
21
21
  });
22
- type ImageMaterialType = JSX.IntrinsicElements['shaderMaterial'] & {
22
+ type ImageMaterialType = ThreeElements['shaderMaterial'] & {
23
23
  scale?: number[];
24
24
  imageBounds?: number[];
25
25
  radius?: number;
@@ -29,11 +29,9 @@ type ImageMaterialType = JSX.IntrinsicElements['shaderMaterial'] & {
29
29
  zoom?: number;
30
30
  grayscale?: number;
31
31
  };
32
- declare global {
33
- namespace JSX {
34
- interface IntrinsicElements {
35
- imageMaterial: ImageMaterialType;
36
- }
32
+ declare module '@react-three/fiber' {
33
+ interface ThreeElements {
34
+ imageMaterial: ImageMaterialType;
37
35
  }
38
36
  }
39
37
  export declare const Image: ForwardRefComponent<ImageProps, THREE.Mesh>;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("three"),r=require("react"),n=require("@react-three/fiber"),a=require("react-composer"),s=require("../helpers/deprecated.cjs.js");function c(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function i(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var u=c(e),o=i(t),l=i(r),f=c(a);const d=new o.Matrix4,m=new o.Matrix4,y=[],p=new o.Mesh;class g extends o.Group{constructor(){super(),this.color=new o.Color("white"),this.instance={current:void 0},this.instanceKey={current:void 0}}get geometry(){var e;return null==(e=this.instance.current)?void 0:e.geometry}raycast(e,t){const r=this.instance.current;if(!r)return;if(!r.geometry||!r.material)return;p.geometry=r.geometry;const n=r.matrixWorld,a=r.userData.instances.indexOf(this.instanceKey);if(!(-1===a||a>r.count)){r.getMatrixAt(a,d),m.multiplyMatrices(n,d),p.matrixWorld=m,r.material instanceof o.Material?p.material.side=r.material.side:p.material.side=r.material[0].side,p.raycast(e,y);for(let e=0,r=y.length;e<r;e++){const r=y[e];r.instanceId=a,r.object=this,t.push(r)}y.length=0}}}const x=l.createContext(null),h=new o.Matrix4,b=new o.Matrix4,M=new o.Matrix4,w=new o.Vector3,A=new o.Quaternion,v=new o.Vector3,E=l.forwardRef((({context:e,children:t,...r},a)=>{l.useMemo((()=>n.extend({PositionMesh:g})),[]);const s=l.useRef();l.useImperativeHandle(a,(()=>s.current),[]);const{subscribe:c,getParent:i}=l.useContext(e||x);return l.useLayoutEffect((()=>c(s)),[]),l.createElement("positionMesh",u.default({instance:i(),instanceKey:s,ref:s},r),t)})),j=l.forwardRef((({context:e,children:t,range:r,limit:a=1e3,frames:c=1/0,...i},f)=>{const[{localContext:d,instance:m}]=l.useState((()=>{const e=l.createContext(null);return{localContext:e,instance:l.forwardRef(((t,r)=>l.createElement(E,u.default({context:e},t,{ref:r}))))}})),y=l.useRef(null);l.useImperativeHandle(f,(()=>y.current),[]);const[p,g]=l.useState([]),[[j,D]]=l.useState((()=>{const e=new Float32Array(16*a);for(let t=0;t<a;t++)M.identity().toArray(e,16*t);return[e,new Float32Array([...new Array(3*a)].map((()=>1)))]}));l.useEffect((()=>{y.current.instanceMatrix.needsUpdate=!0}));let R=0,O=0;const C=l.useRef([]);l.useLayoutEffect((()=>{C.current=Object.entries(y.current.geometry.attributes).filter((([e,t])=>t.isInstancedBufferAttribute))})),n.useFrame((()=>{if(c===1/0||R<c){y.current.updateMatrix(),y.current.updateMatrixWorld(),h.copy(y.current.matrixWorld).invert(),O=Math.min(a,void 0!==r?r:a,p.length),y.current.count=O,s.setUpdateRange(y.current.instanceMatrix,{offset:0,count:16*O}),s.setUpdateRange(y.current.instanceColor,{offset:0,count:3*O});for(let e=0;e<p.length;e++){const t=p[e].current;t.matrixWorld.decompose(w,A,v),b.compose(w,A,v).premultiply(h),b.toArray(j,16*e),y.current.instanceMatrix.needsUpdate=!0,t.color.toArray(D,3*e),y.current.instanceColor.needsUpdate=!0}R++}}));const P=l.useMemo((()=>({getParent:()=>y,subscribe:e=>(g((t=>[...t,e])),()=>g((t=>t.filter((t=>t.current!==e.current)))))})),[]);return l.createElement("instancedMesh",u.default({userData:{instances:p,limit:a,frames:c},matrixAutoUpdate:!1,ref:y,args:[null,null,0],raycast:()=>null},i),l.createElement("instancedBufferAttribute",{attach:"instanceMatrix",count:j.length/16,array:j,itemSize:16,usage:o.DynamicDrawUsage}),l.createElement("instancedBufferAttribute",{attach:"instanceColor",count:D.length/3,array:D,itemSize:3,usage:o.DynamicDrawUsage}),"function"==typeof t?l.createElement(d.Provider,{value:P},t(m)):e?l.createElement(e.Provider,{value:P},t):l.createElement(x.Provider,{value:P},t))})),D=l.forwardRef((function({meshes:e,children:t,...r},n){const a=Array.isArray(e);if(!a)for(const t of Object.keys(e))e[t].isMesh||delete e[t];return l.createElement("group",{ref:n},l.createElement(f.default,{components:(a?e:Object.values(e)).map((({geometry:e,material:t})=>l.createElement(j,u.default({key:e.uuid,geometry:e,material:t},r))))},(r=>a?t(...r):t(Object.keys(e).filter((t=>e[t].isMesh)).reduce(((e,t,n)=>({...e,[t]:r[n]})),{})))))}));const R=l.forwardRef((({name:e,defaultValue:t,normalized:r,usage:a=o.DynamicDrawUsage},s)=>{const c=l.useRef(null);l.useImperativeHandle(s,(()=>c.current),[]),l.useLayoutEffect((()=>{const r=c.current.__r3f.parent;r.geometry.attributes[e]=c.current;const n=Array.isArray(t)?t:[t],a=Array.from({length:r.userData.limit},(()=>n)).flat();return c.current.array=new Float32Array(a),c.current.itemSize=n.length,c.current.count=a.length/c.current.itemSize,()=>{delete r.geometry.attributes[e]}}),[e]);let i=0;return n.useFrame((()=>{const t=c.current.__r3f.parent;if(t.userData.frames===1/0||i<t.userData.frames){for(let r=0;r<t.userData.instances.length;r++){const n=t.userData.instances[r].current[e];void 0!==n&&(c.current.set(Array.isArray(n)?n:"function"==typeof n.toArray?n.toArray():[n],r*c.current.itemSize),c.current.needsUpdate=!0)}i++}})),l.createElement("instancedBufferAttribute",{ref:c,usage:a,normalized:r})}));exports.Instance=E,exports.InstancedAttribute=R,exports.Instances=j,exports.Merged=D,exports.PositionMesh=g,exports.createInstances=function(){const e=l.createContext(null);return[l.forwardRef(((t,r)=>l.createElement(j,u.default({ref:r,context:e},t)))),l.forwardRef(((t,r)=>l.createElement(E,u.default({ref:r,context:e},t))))]};
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("three"),r=require("react"),n=require("@react-three/fiber"),a=require("../helpers/deprecated.cjs.js");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function c(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var u=s(e),i=c(t),o=c(r);const l=new i.Matrix4,f=new i.Matrix4,d=[],m=new i.Mesh;class y extends i.Group{constructor(){super(),this.color=new i.Color("white"),this.instance={current:void 0},this.instanceKey={current:void 0}}get geometry(){var e;return null==(e=this.instance.current)?void 0:e.geometry}raycast(e,t){const r=this.instance.current;if(!r)return;if(!r.geometry||!r.material)return;m.geometry=r.geometry;const n=r.matrixWorld,a=r.userData.instances.indexOf(this.instanceKey);if(!(-1===a||a>r.count)){r.getMatrixAt(a,l),f.multiplyMatrices(n,l),m.matrixWorld=f,r.material instanceof i.Material?m.material.side=r.material.side:m.material.side=r.material[0].side,m.raycast(e,d);for(let e=0,r=d.length;e<r;e++){const r=d[e];r.instanceId=a,r.object=this,t.push(r)}d.length=0}}}const p=o.createContext(null),g=new i.Matrix4,x=new i.Matrix4,h=new i.Matrix4,b=new i.Vector3,M=new i.Quaternion,w=new i.Vector3,A=o.forwardRef((({context:e,children:t,...r},a)=>{o.useMemo((()=>n.extend({PositionMesh:y})),[]);const s=o.useRef(null);o.useImperativeHandle(a,(()=>s.current),[]);const{subscribe:c,getParent:i}=o.useContext(e||p);return o.useLayoutEffect((()=>c(s)),[]),o.createElement("positionMesh",u.default({instance:i(),instanceKey:s,ref:s},r),t)})),v=o.forwardRef((({context:e,children:t,range:r,limit:s=1e3,frames:c=1/0,...l},f)=>{const[{localContext:d,instance:m}]=o.useState((()=>{const e=o.createContext(null);return{localContext:e,instance:o.forwardRef(((t,r)=>o.createElement(A,u.default({context:e},t,{ref:r}))))}})),y=o.useRef(null);o.useImperativeHandle(f,(()=>y.current),[]);const[v,E]=o.useState([]),[[j,D]]=o.useState((()=>{const e=new Float32Array(16*s);for(let t=0;t<s;t++)h.identity().toArray(e,16*t);return[e,new Float32Array([...new Array(3*s)].map((()=>1)))]}));o.useEffect((()=>{y.current.instanceMatrix.needsUpdate=!0}));let R=0,C=0;const P=o.useRef([]);o.useLayoutEffect((()=>{P.current=Object.entries(y.current.geometry.attributes).filter((([e,t])=>t.isInstancedBufferAttribute))})),n.useFrame((()=>{if(c===1/0||R<c){y.current.updateMatrix(),y.current.updateMatrixWorld(),g.copy(y.current.matrixWorld).invert(),C=Math.min(s,void 0!==r?r:s,v.length),y.current.count=C,a.setUpdateRange(y.current.instanceMatrix,{start:0,count:16*C}),a.setUpdateRange(y.current.instanceColor,{start:0,count:3*C});for(let e=0;e<v.length;e++){const t=v[e].current;t.matrixWorld.decompose(b,M,w),x.compose(b,M,w).premultiply(g),x.toArray(j,16*e),y.current.instanceMatrix.needsUpdate=!0,t.color.toArray(D,3*e),y.current.instanceColor.needsUpdate=!0}R++}}));const U=o.useMemo((()=>({getParent:()=>y,subscribe:e=>(E((t=>[...t,e])),()=>E((t=>t.filter((t=>t.current!==e.current)))))})),[]);return o.createElement("instancedMesh",u.default({userData:{instances:v,limit:s,frames:c},matrixAutoUpdate:!1,ref:y,args:[null,null,0],raycast:()=>null},l),o.createElement("instancedBufferAttribute",{attach:"instanceMatrix",args:[j,16],usage:i.DynamicDrawUsage}),o.createElement("instancedBufferAttribute",{attach:"instanceColor",args:[D,3],usage:i.DynamicDrawUsage}),"function"==typeof t?o.createElement(d.Provider,{value:U},t(m)):e?o.createElement(e.Provider,{value:U},t):o.createElement(p.Provider,{value:U},t))})),E=o.forwardRef((function({meshes:e,children:t,...r},n){const a=[];if(Array.isArray(e))for(const t of e)null!=t&&t.isMesh&&a.push((e=>o.createElement(v,u.default({key:t.geometry.uuid,geometry:t.geometry,material:t.material},r,e))));else if(null!=e&&"object"==typeof e)for(const t in e){const n=e[t];null!=n&&n.isMesh&&a.push((e=>o.createElement(v,u.default({key:n.geometry.uuid,geometry:n.geometry,material:n.material},r,e))))}return o.createElement("group",{ref:n},t(a))}));const j=o.forwardRef((({name:e,defaultValue:t,normalized:r,usage:a=i.DynamicDrawUsage},s)=>{const c=o.useRef(null);o.useImperativeHandle(s,(()=>c.current),[]),o.useLayoutEffect((()=>{const r=c.current.__r3f.parent.object;r.geometry.attributes[e]=c.current;const n=Array.isArray(t)?t:[t],a=Array.from({length:r.userData.limit},(()=>n)).flat();return c.current.array=new Float32Array(a),c.current.itemSize=n.length,c.current.count=a.length/c.current.itemSize,()=>{delete r.geometry.attributes[e]}}),[e]);let u=0;return n.useFrame((()=>{const t=c.current.__r3f.parent.object;if(t.userData.frames===1/0||u<t.userData.frames){for(let r=0;r<t.userData.instances.length;r++){const n=t.userData.instances[r].current[e];void 0!==n&&(c.current.set(Array.isArray(n)?n:"function"==typeof n.toArray?n.toArray():[n],r*c.current.itemSize),c.current.needsUpdate=!0)}u++}})),o.createElement("instancedBufferAttribute",{ref:c,usage:a,normalized:r})}));exports.Instance=A,exports.InstancedAttribute=j,exports.Instances=v,exports.Merged=E,exports.PositionMesh=y,exports.createInstances=function(){const e=o.createContext(null);return[o.forwardRef(((t,r)=>o.createElement(v,u.default({ref:r,context:e},t)))),o.forwardRef(((t,r)=>o.createElement(A,u.default({ref:r,context:e},t))))]};