@react-three/drei 9.64.0 → 9.65.1

package/README.md

@@ -129,7 +129,8 @@ The `native` route of the library **does not** export `Html` or `Loader`. The de
           <li><a href="#usektx2">useKTX2</a></li>
           <li><a href="#usecubetexture">useCubeTexture</a></li>
           <li><a href="#usevideotexture">useVideoTexture</a></li>
-          <li><a href="#usetrailtexture">useTrailTexture</a></li>          
+          <li><a href="#usetrailtexture">useTrailTexture</a></li>
+          <li><a href="#usefont">useFont</a></li>
         </ul>
         <li><a href="#performance">Performance</a></li>
         <ul>
@@ -2500,6 +2501,21 @@ return (
     <meshStandardMaterial displacementMap={texture} />
 ```
 
+#### useFont
+
+Uses THREE.FontLoader to load a font and returns a `THREE.Font` object. It also accepts a JSON object as a parameter. You can use this to preload or share a font across multiple components.
+
+```jsx
+const font = useFont('/fonts/helvetiker_regular.typeface.json')
+return <Text3D font={font} />
+```
+
+In order to preload you do this:
+
+```jsx
+useFont.preload('/fonts/helvetiker_regular.typeface.json')
+```
+
 # Performance
 
 #### Instances

package/core/Center.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("three"),r=require("react");function n(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function u(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 i=n(e),o=u(r);const c=o.forwardRef((function({children:e,disable:r,disableX:n,disableY:u,disableZ:c,left:a,right:l,top:f,bottom:d,front:s,back:p,onCentered:b,precise:m=!0,...g},h){const x=o.useRef(null),y=o.useRef(null),j=o.useRef(null);return o.useLayoutEffect((()=>{y.current.matrixWorld.identity();const e=(new t.Box3).setFromObject(j.current,m),i=new t.Vector3,o=new t.Sphere,g=e.max.x-e.min.x,h=e.max.y-e.min.y,v=e.max.z-e.min.z;e.getCenter(i),e.getBoundingSphere(o);const O=f?h/2:d?-h/2:0,w=a?-g/2:l?g/2:0,z=s?v/2:p?-v/2:0;y.current.position.set(r||n?0:-i.x+w,r||u?0:-i.y+O,r||c?0:-i.z+z),void 0!==b&&b({parent:x.current.parent,container:x.current,width:g,height:h,depth:v,boundingBox:e,boundingSphere:o,center:i,verticalAlignment:O,horizontalAlignment:w,depthAlignment:z})})),o.useImperativeHandle(h,(()=>x.current),[]),o.createElement("group",i.default({ref:x},g),o.createElement("group",{ref:y},o.createElement("group",{ref:j},e)))}));exports.Center=c;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("three"),r=require("react");function n(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function u(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 o=n(e),i=u(r);const c=i.forwardRef((function({children:e,disable:r,disableX:n,disableY:u,disableZ:c,left:a,right:l,top:f,bottom:s,front:d,back:p,onCentered:b,precise:m=!0,...g},h){const x=i.useRef(null),y=i.useRef(null),j=i.useRef(null),v=i.useRef(new t.Box3);return i.useLayoutEffect((()=>{y.current.matrixWorld.identity();const e=(new t.Box3).setFromObject(j.current,m),o=new t.Vector3,i=new t.Sphere,g=e.max.x-e.min.x,h=e.max.y-e.min.y,O=e.max.z-e.min.z;e.getCenter(o),e.getBoundingSphere(i);const w=f?h/2:s?-h/2:0,z=a?-g/2:l?g/2:0,E=d?O/2:p?-O/2:0;y.current.position.set(r||n?0:-o.x+z,r||u?0:-o.y+w,r||c?0:-o.z+E),void 0===b||v.current.equals(e)||(v.current.copy(e),b({parent:x.current.parent,container:x.current,width:g,height:h,depth:O,boundingBox:e,boundingSphere:i,center:o,verticalAlignment:w,horizontalAlignment:z,depthAlignment:E}))})),i.useImperativeHandle(h,(()=>x.current),[]),i.createElement("group",o.default({ref:x},g),i.createElement("group",{ref:y},i.createElement("group",{ref:j},e)))}));exports.Center=c;

package/core/Center.js

@@ -21,6 +21,7 @@ const Center = /*#__PURE__*/React.forwardRef(function Center({
   const ref = React.useRef(null);
   const outer = React.useRef(null);
   const inner = React.useRef(null);
+  const oldBox = React.useRef(new Box3());
   React.useLayoutEffect(() => {
     outer.current.matrixWorld.identity();
     const box3 = new Box3().setFromObject(inner.current, precise);
@@ -34,9 +35,10 @@ const Center = /*#__PURE__*/React.forwardRef(function Center({
     const vAlign = top ? height / 2 : bottom ? -height / 2 : 0;
     const hAlign = left ? -width / 2 : right ? width / 2 : 0;
     const dAlign = front ? depth / 2 : back ? -depth / 2 : 0;
-    outer.current.position.set(disable || disableX ? 0 : -center.x + hAlign, disable || disableY ? 0 : -center.y + vAlign, disable || disableZ ? 0 : -center.z + dAlign);
+    outer.current.position.set(disable || disableX ? 0 : -center.x + hAlign, disable || disableY ? 0 : -center.y + vAlign, disable || disableZ ? 0 : -center.z + dAlign); // Only fire onCentered if the bounding box has changed
 
-    if (typeof onCentered !== 'undefined') {
+    if (typeof onCentered !== 'undefined' && !oldBox.current.equals(box3)) {
+      oldBox.current.copy(box3);
       onCentered({
         parent: ref.current.parent,
         container: ref.current,

package/core/Text3D.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("@react-three/fiber"),n=require("suspend-react"),s=require("three-stdlib");function u(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 o=u(e),c=i(t);const l=["string","number"],a=c.forwardRef((({font:e,letterSpacing:u=0,lineHeight:i=1,size:a=1,height:f=.2,bevelThickness:m=.1,bevelSize:b=.01,bevelEnabled:d=!1,bevelOffset:g=0,bevelSegments:h=4,curveSegments:p=8,smooth:v,children:y,...x},O)=>{c.useMemo((()=>r.extend({RenamedTextGeometry:s.TextGeometry})),[]);const j=c.useRef(null),S=n.suspend((async()=>{let t="string"==typeof e?await(await fetch(e)).json():e;return(new s.FontLoader).parse(t)}),[e]),E=t.useMemo((()=>({font:S,size:a,height:f,bevelThickness:m,bevelSize:b,bevelEnabled:d,bevelSegments:h,bevelOffset:g,curveSegments:p,letterSpacing:u,lineHeight:i})),[S,a,f,m,b,d,h,g,p,u,i]),[M,...T]=t.useMemo((()=>(e=>{let t="";const r=[];return c.Children.forEach(e,(e=>{l.includes(typeof e)?t+=e+"":r.push(e)})),[t,...r]})(y)),[y]),q=c.useMemo((()=>[M,E]),[M,E]);return c.useLayoutEffect((()=>{v&&(j.current.geometry=s.mergeVertices(j.current.geometry,v),j.current.geometry.computeVertexNormals())}),[q,v]),c.useImperativeHandle(O,(()=>j.current),[]),c.createElement("mesh",o.default({},x,{ref:j}),c.createElement("renamedTextGeometry",{args:q}),T)}));exports.Text3D=a;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/extends"),t=require("react"),r=require("@react-three/fiber"),n=require("three-stdlib"),u=require("./useFont.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)}require("suspend-react");var i=s(e),l=c(t);const o=["string","number"],a=l.forwardRef((({font:e,letterSpacing:s=0,lineHeight:c=1,size:a=1,height:f=.2,bevelThickness:m=.1,bevelSize:b=.01,bevelEnabled:d=!1,bevelOffset:g=0,bevelSegments:h=4,curveSegments:v=8,smooth:p,children:y,...j},x)=>{l.useMemo((()=>r.extend({RenamedTextGeometry:n.TextGeometry})),[]);const O=l.useRef(null),S=u.useFont(e),E=t.useMemo((()=>({font:S,size:a,height:f,bevelThickness:m,bevelSize:b,bevelEnabled:d,bevelSegments:h,bevelOffset:g,curveSegments:v,letterSpacing:s,lineHeight:c})),[S,a,f,m,b,d,h,g,v,s,c]),[q,...M]=t.useMemo((()=>(e=>{let t="";const r=[];return l.Children.forEach(e,(e=>{o.includes(typeof e)?t+=e+"":r.push(e)})),[t,...r]})(y)),[y]),T=l.useMemo((()=>[q,E]),[q,E]);return l.useLayoutEffect((()=>{p&&(O.current.geometry=n.mergeVertices(O.current.geometry,p),O.current.geometry.computeVertexNormals())}),[T,p]),l.useImperativeHandle(x,(()=>O.current),[]),l.createElement("mesh",i.default({},j,{ref:O}),l.createElement("renamedTextGeometry",{args:T}),M)}));exports.Text3D=a;

package/core/Text3D.d.ts

@@ -2,6 +2,7 @@ import * as React from 'react';
 import * as THREE from 'three';
 import { Node } from '@react-three/fiber';
 import { TextGeometryParameters } from 'three-stdlib';
+import { FontData } from './useFont';
 declare global {
     namespace JSX {
         interface IntrinsicElements {
@@ -9,23 +10,6 @@ declare global {
         }
     }
 }
-declare type Glyph = {
-    _cachedOutline: string[];
-    ha: number;
-    o: string;
-};
-declare type FontData = {
-    boundingBox: {
-        yMax: number;
-        yMin: number;
-    };
-    familyName: string;
-    glyphs: {
-        [k: string]: Glyph;
-    };
-    resolution: number;
-    underlineThickness: number;
-};
 export declare const Text3D: React.ForwardRefExoticComponent<Pick<React.PropsWithChildren<{
     font: FontData | string;
     bevelSegments?: number | undefined;
@@ -52,4 +36,3 @@ export declare const Text3D: React.ForwardRefExoticComponent<Pick<React.PropsWit
     letterSpacing?: number | undefined;
     lineHeight?: number | undefined;
 }>, "visible" | "attach" | "args" | "children" | "key" | "onUpdate" | "position" | "up" | "scale" | "rotation" | "matrix" | "quaternion" | "layers" | "dispose" | "type" | "id" | "uuid" | "name" | "parent" | "modelViewMatrix" | "normalMatrix" | "matrixWorld" | "matrixAutoUpdate" | "matrixWorldAutoUpdate" | "matrixWorldNeedsUpdate" | "castShadow" | "receiveShadow" | "frustumCulled" | "renderOrder" | "animations" | "userData" | "customDepthMaterial" | "customDistanceMaterial" | "isObject3D" | "onBeforeRender" | "onAfterRender" | "applyMatrix4" | "applyQuaternion" | "setRotationFromAxisAngle" | "setRotationFromEuler" | "setRotationFromMatrix" | "setRotationFromQuaternion" | "rotateOnAxis" | "rotateOnWorldAxis" | "rotateX" | "rotateY" | "rotateZ" | "translateOnAxis" | "translateX" | "translateY" | "translateZ" | "localToWorld" | "worldToLocal" | "lookAt" | "add" | "remove" | "removeFromParent" | "clear" | "getObjectById" | "getObjectByName" | "getObjectByProperty" | "getObjectsByProperty" | "getWorldPosition" | "getWorldQuaternion" | "getWorldScale" | "getWorldDirection" | "raycast" | "traverse" | "traverseVisible" | "traverseAncestors" | "updateMatrix" | "updateMatrixWorld" | "updateWorldMatrix" | "toJSON" | "clone" | "copy" | "addEventListener" | "hasEventListener" | "removeEventListener" | "dispatchEvent" | keyof import("@react-three/fiber/dist/declarations/src/core/events").EventHandlers | "material" | "geometry" | "size" | "font" | "smooth" | "morphTargetInfluences" | "morphTargetDictionary" | "isMesh" | "updateMorphTargets" | "getVertexPosition" | "height" | "letterSpacing" | "lineHeight" | "bevelEnabled" | "bevelOffset" | "bevelSize" | "bevelThickness" | "curveSegments" | "bevelSegments"> & React.RefAttributes<THREE.Mesh<THREE.BufferGeometry, THREE.Material | THREE.Material[]>>>;
-export {};

package/core/Text3D.js

@@ -2,8 +2,8 @@ import _extends from '@babel/runtime/helpers/esm/extends';
 import * as React from 'react';
 import { useMemo } from 'react';
 import { extend } from '@react-three/fiber';
-import { suspend } from 'suspend-react';
-import { TextGeometry, FontLoader, mergeVertices } from 'three-stdlib';
+import { TextGeometry, mergeVertices } from 'three-stdlib';
+import { useFont } from './useFont.js';
 
 const types = ['string', 'number'];
 
@@ -36,11 +36,7 @@ const Text3D = /*#__PURE__*/React.forwardRef(({
     RenamedTextGeometry: TextGeometry
   }), []);
   const ref = React.useRef(null);
-  const font = suspend(async () => {
-    let data = typeof _font === 'string' ? await (await fetch(_font)).json() : _font;
-    let loader = new FontLoader();
-    return loader.parse(data);
-  }, [_font]);
+  const font = useFont(_font);
   const opts = useMemo(() => {
     return {
       font,

package/core/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./Billboard.cjs.js"),r=require("./ScreenSpace.cjs.js"),s=require("./QuadraticBezierLine.cjs.js"),t=require("./CubicBezierLine.cjs.js"),o=require("./CatmullRomLine.cjs.js"),i=require("./Line.cjs.js"),a=require("./PositionalAudio.cjs.js"),u=require("./Text.cjs.js"),c=require("./Text3D.cjs.js"),n=require("./Effects.cjs.js"),j=require("./GradientTexture.cjs.js"),p=require("./Image.cjs.js"),x=require("./Edges.cjs.js"),l=require("./Trail.cjs.js"),q=require("./Sampler.cjs.js"),d=require("./ComputedAttribute.cjs.js"),m=require("./Clone.cjs.js"),C=require("./MarchingCubes.cjs.js"),h=require("./Decal.cjs.js"),M=require("./Svg.cjs.js"),S=require("./Gltf.cjs.js"),T=require("./AsciiRenderer.cjs.js"),b=require("./OrthographicCamera.cjs.js"),f=require("./PerspectiveCamera.cjs.js"),B=require("./CubeCamera.cjs.js"),P=require("./DeviceOrientationControls.cjs.js"),g=require("./FlyControls.cjs.js"),v=require("./MapControls.cjs.js"),A=require("./OrbitControls.cjs.js"),L=require("./TrackballControls.cjs.js"),D=require("./ArcballControls.cjs.js"),k=require("./TransformControls.cjs.js"),G=require("./PointerLockControls.cjs.js"),E=require("./FirstPersonControls.cjs.js"),R=require("./CameraControls.cjs.js"),w=require("./GizmoHelper.cjs.js"),z=require("./GizmoViewcube.cjs.js"),F=require("./GizmoViewport.cjs.js"),O=require("./Grid.cjs.js"),I=require("./useCubeTexture.cjs.js"),H=require("./useFBX.cjs.js"),V=require("./useGLTF.cjs.js"),y=require("./useKTX2.cjs.js"),W=require("./useProgress.cjs.js"),Q=require("./useTexture.cjs.js"),X=require("./useVideoTexture.cjs.js"),K=require("./Stats.cjs.js"),N=require("./useDepthBuffer.cjs.js"),U=require("./useAspect.cjs.js"),_=require("./useCamera.cjs.js"),J=require("./useDetectGPU.cjs.js"),Y=require("./useHelper.cjs.js"),Z=require("./useBVH.cjs.js"),$=require("./useContextBridge.cjs.js"),ee=require("./useAnimations.cjs.js"),re=require("./useFBO.cjs.js"),se=require("./useIntersect.cjs.js"),te=require("./useBoxProjectedEnv.cjs.js"),oe=require("./BBAnchor.cjs.js"),ie=require("./useTrailTexture.cjs.js"),ae=require("./useCubeCamera.cjs.js"),ue=require("./CurveModifier.cjs.js"),ce=require("./MeshDistortMaterial.cjs.js"),ne=require("./MeshWobbleMaterial.cjs.js"),je=require("./MeshReflectorMaterial.cjs.js"),pe=require("./MeshRefractionMaterial.cjs.js"),xe=require("./MeshTransmissionMaterial.cjs.js"),le=require("./MeshDiscardMaterial.cjs.js"),qe=require("./PointMaterial.cjs.js"),de=require("./shaderMaterial.cjs.js"),me=require("./softShadows.cjs.js"),Ce=require("./shapes.cjs.js"),he=require("./RoundedBox.cjs.js"),Me=require("./ScreenQuad.cjs.js"),Se=require("./Center.cjs.js"),Te=require("./Bounds.cjs.js"),be=require("./CameraShake.cjs.js"),fe=require("./Float.cjs.js"),Be=require("./Stage.cjs.js"),Pe=require("./Backdrop.cjs.js"),ge=require("./Shadow.cjs.js"),ve=require("./Caustics.cjs.js"),Ae=require("./ContactShadows.cjs.js"),Le=require("./AccumulativeShadows.cjs.js"),De=require("./Reflector.cjs.js"),ke=require("./SpotLight.cjs.js"),Ge=require("./Environment.cjs.js"),Ee=require("./Lightformer.cjs.js"),Re=require("./Sky.cjs.js"),we=require("./Stars.cjs.js"),ze=require("./Cloud.cjs.js"),Fe=require("./Sparkles.cjs.js"),Oe=require("./useEnvironment.cjs.js"),Ie=require("./useMatcapTexture.cjs.js"),He=require("./useNormalTexture.cjs.js"),Ve=require("./Wireframe.cjs.js"),ye=require("./Points.cjs.js"),We=require("./Instances.cjs.js"),Qe=require("./Segments.cjs.js"),Xe=require("./Detailed.cjs.js"),Ke=require("./Preload.cjs.js"),Ne=require("./BakeShadows.cjs.js"),Ue=require("./meshBounds.cjs.js"),_e=require("./AdaptiveDpr.cjs.js"),Je=require("./AdaptiveEvents.cjs.js"),Ye=require("./PerformanceMonitor.cjs.js"),Ze=require("./RenderTexture.cjs.js"),$e=require("./Mask.cjs.js"),er=require("./Hud.cjs.js");require("@babel/runtime/helpers/extends"),require("react"),require("@react-three/fiber"),require("react-merge-refs"),require("three"),require("three-stdlib"),require("troika-three-text"),require("suspend-react"),require("meshline"),require("lodash.pick"),require("lodash.omit"),require("camera-controls"),require("zustand"),require("stats.js"),require("../helpers/useEffectfulState.cjs.js"),require("detect-gpu"),require("three-mesh-bvh"),require("../materials/BlurPass.cjs.js"),require("../materials/ConvolutionMaterial.cjs.js"),require("../materials/MeshReflectorMaterial.cjs.js"),require("../materials/MeshRefractionMaterial.cjs.js"),require("../materials/DiscardMaterial.cjs.js"),require("../helpers/environment-assets.cjs.js"),require("../materials/SpotLightMaterial.cjs.js"),require("../materials/WireframeMaterial.cjs.js"),require("react-composer"),exports.Billboard=e.Billboard,exports.ScreenSpace=r.ScreenSpace,exports.QuadraticBezierLine=s.QuadraticBezierLine,exports.CubicBezierLine=t.CubicBezierLine,exports.CatmullRomLine=o.CatmullRomLine,exports.Line=i.Line,exports.PositionalAudio=a.PositionalAudio,exports.Text=u.Text,exports.Text3D=c.Text3D,exports.Effects=n.Effects,exports.isWebGL2Available=n.isWebGL2Available,exports.GradientTexture=j.GradientTexture,exports.Image=p.Image,exports.Edges=x.Edges,exports.Trail=l.Trail,exports.useTrail=l.useTrail,exports.Sampler=q.Sampler,exports.useSurfaceSampler=q.useSurfaceSampler,exports.ComputedAttribute=d.ComputedAttribute,exports.Clone=m.Clone,exports.MarchingCube=C.MarchingCube,exports.MarchingCubes=C.MarchingCubes,exports.MarchingPlane=C.MarchingPlane,exports.Decal=h.Decal,exports.Svg=M.Svg,exports.Gltf=S.Gltf,exports.AsciiRenderer=T.AsciiRenderer,exports.OrthographicCamera=b.OrthographicCamera,exports.PerspectiveCamera=f.PerspectiveCamera,exports.CubeCamera=B.CubeCamera,exports.DeviceOrientationControls=P.DeviceOrientationControls,exports.FlyControls=g.FlyControls,exports.MapControls=v.MapControls,exports.OrbitControls=A.OrbitControls,exports.TrackballControls=L.TrackballControls,exports.ArcballControls=D.ArcballControls,exports.TransformControls=k.TransformControls,exports.PointerLockControls=G.PointerLockControls,exports.FirstPersonControls=E.FirstPersonControls,exports.CameraControls=R.CameraControls,exports.GizmoHelper=w.GizmoHelper,exports.useGizmoContext=w.useGizmoContext,exports.GizmoViewcube=z.GizmoViewcube,exports.GizmoViewport=F.GizmoViewport,exports.Grid=O.Grid,exports.useCubeTexture=I.useCubeTexture,exports.useFBX=H.useFBX,exports.useGLTF=V.useGLTF,exports.useKTX2=y.useKTX2,exports.useProgress=W.useProgress,exports.IsObject=Q.IsObject,exports.useTexture=Q.useTexture,exports.useVideoTexture=X.useVideoTexture,exports.Stats=K.Stats,exports.useDepthBuffer=N.useDepthBuffer,exports.useAspect=U.useAspect,exports.useCamera=_.useCamera,exports.useDetectGPU=J.useDetectGPU,exports.useHelper=Y.useHelper,exports.Bvh=Z.Bvh,exports.useBVH=Z.useBVH,exports.useContextBridge=$.useContextBridge,exports.useAnimations=ee.useAnimations,exports.useFBO=re.useFBO,exports.useIntersect=se.useIntersect,exports.useBoxProjectedEnv=te.useBoxProjectedEnv,exports.BBAnchor=oe.BBAnchor,exports.useTrailTexture=ie.useTrailTexture,exports.useCubeCamera=ae.useCubeCamera,exports.CurveModifier=ue.CurveModifier,exports.MeshDistortMaterial=ce.MeshDistortMaterial,exports.MeshWobbleMaterial=ne.MeshWobbleMaterial,exports.MeshReflectorMaterial=je.MeshReflectorMaterial,exports.MeshRefractionMaterial=pe.MeshRefractionMaterial,exports.MeshTransmissionMaterial=xe.MeshTransmissionMaterial,exports.MeshDiscardMaterial=le.MeshDiscardMaterial,exports.PointMaterial=qe.PointMaterial,exports.PointMaterialImpl=qe.PointMaterialImpl,exports.shaderMaterial=de.shaderMaterial,exports.SoftShadows=me.SoftShadows,exports.Box=Ce.Box,exports.Capsule=Ce.Capsule,exports.Circle=Ce.Circle,exports.Cone=Ce.Cone,exports.Cylinder=Ce.Cylinder,exports.Dodecahedron=Ce.Dodecahedron,exports.Extrude=Ce.Extrude,exports.Icosahedron=Ce.Icosahedron,exports.Lathe=Ce.Lathe,exports.Octahedron=Ce.Octahedron,exports.Plane=Ce.Plane,exports.Polyhedron=Ce.Polyhedron,exports.Ring=Ce.Ring,exports.Shape=Ce.Shape,exports.Sphere=Ce.Sphere,exports.Tetrahedron=Ce.Tetrahedron,exports.Torus=Ce.Torus,exports.TorusKnot=Ce.TorusKnot,exports.Tube=Ce.Tube,exports.RoundedBox=he.RoundedBox,exports.ScreenQuad=Me.ScreenQuad,exports.Center=Se.Center,exports.Bounds=Te.Bounds,exports.useBounds=Te.useBounds,exports.CameraShake=be.CameraShake,exports.Float=fe.Float,exports.Stage=Be.Stage,exports.Backdrop=Pe.Backdrop,exports.Shadow=ge.Shadow,exports.Caustics=ve.Caustics,exports.ContactShadows=Ae.ContactShadows,exports.AccumulativeShadows=Le.AccumulativeShadows,exports.RandomizedLight=Le.RandomizedLight,exports.accumulativeContext=Le.accumulativeContext,exports.Reflector=De.Reflector,exports.SpotLight=ke.SpotLight,exports.SpotLightShadow=ke.SpotLightShadow,exports.Environment=Ge.Environment,exports.EnvironmentCube=Ge.EnvironmentCube,exports.EnvironmentMap=Ge.EnvironmentMap,exports.EnvironmentPortal=Ge.EnvironmentPortal,exports.Lightformer=Ee.Lightformer,exports.Sky=Re.Sky,exports.calcPosFromAngles=Re.calcPosFromAngles,exports.Stars=we.Stars,exports.Cloud=ze.Cloud,exports.Sparkles=Fe.Sparkles,exports.useEnvironment=Oe.useEnvironment,exports.useMatcapTexture=Ie.useMatcapTexture,exports.useNormalTexture=He.useNormalTexture,exports.Wireframe=Ve.Wireframe,exports.Point=ye.Point,exports.Points=ye.Points,exports.PointsBuffer=ye.PointsBuffer,exports.PositionPoint=ye.PositionPoint,exports.Instance=We.Instance,exports.Instances=We.Instances,exports.Merged=We.Merged,exports.Segment=Qe.Segment,exports.SegmentObject=Qe.SegmentObject,exports.Segments=Qe.Segments,exports.Detailed=Xe.Detailed,exports.Preload=Ke.Preload,exports.BakeShadows=Ne.BakeShadows,exports.meshBounds=Ue.meshBounds,exports.AdaptiveDpr=_e.AdaptiveDpr,exports.AdaptiveEvents=Je.AdaptiveEvents,exports.PerformanceMonitor=Ye.PerformanceMonitor,exports.usePerformanceMonitor=Ye.usePerformanceMonitor,exports.RenderTexture=Ze.RenderTexture,exports.Mask=$e.Mask,exports.useMask=$e.useMask,exports.Hud=er.Hud;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./Billboard.cjs.js"),r=require("./ScreenSpace.cjs.js"),s=require("./QuadraticBezierLine.cjs.js"),t=require("./CubicBezierLine.cjs.js"),o=require("./CatmullRomLine.cjs.js"),i=require("./Line.cjs.js"),a=require("./PositionalAudio.cjs.js"),u=require("./Text.cjs.js"),c=require("./Text3D.cjs.js"),n=require("./Effects.cjs.js"),j=require("./GradientTexture.cjs.js"),p=require("./Image.cjs.js"),x=require("./Edges.cjs.js"),l=require("./Trail.cjs.js"),q=require("./Sampler.cjs.js"),d=require("./ComputedAttribute.cjs.js"),m=require("./Clone.cjs.js"),C=require("./MarchingCubes.cjs.js"),h=require("./Decal.cjs.js"),M=require("./Svg.cjs.js"),S=require("./Gltf.cjs.js"),T=require("./AsciiRenderer.cjs.js"),b=require("./OrthographicCamera.cjs.js"),f=require("./PerspectiveCamera.cjs.js"),B=require("./CubeCamera.cjs.js"),P=require("./DeviceOrientationControls.cjs.js"),g=require("./FlyControls.cjs.js"),v=require("./MapControls.cjs.js"),A=require("./OrbitControls.cjs.js"),L=require("./TrackballControls.cjs.js"),D=require("./ArcballControls.cjs.js"),k=require("./TransformControls.cjs.js"),G=require("./PointerLockControls.cjs.js"),E=require("./FirstPersonControls.cjs.js"),R=require("./CameraControls.cjs.js"),w=require("./GizmoHelper.cjs.js"),F=require("./GizmoViewcube.cjs.js"),z=require("./GizmoViewport.cjs.js"),O=require("./Grid.cjs.js"),I=require("./useCubeTexture.cjs.js"),H=require("./useFBX.cjs.js"),V=require("./useGLTF.cjs.js"),y=require("./useKTX2.cjs.js"),W=require("./useProgress.cjs.js"),Q=require("./useTexture.cjs.js"),X=require("./useVideoTexture.cjs.js"),K=require("./useFont.cjs.js"),N=require("./Stats.cjs.js"),U=require("./useDepthBuffer.cjs.js"),_=require("./useAspect.cjs.js"),J=require("./useCamera.cjs.js"),Y=require("./useDetectGPU.cjs.js"),Z=require("./useHelper.cjs.js"),$=require("./useBVH.cjs.js"),ee=require("./useContextBridge.cjs.js"),re=require("./useAnimations.cjs.js"),se=require("./useFBO.cjs.js"),te=require("./useIntersect.cjs.js"),oe=require("./useBoxProjectedEnv.cjs.js"),ie=require("./BBAnchor.cjs.js"),ae=require("./useTrailTexture.cjs.js"),ue=require("./useCubeCamera.cjs.js"),ce=require("./CurveModifier.cjs.js"),ne=require("./MeshDistortMaterial.cjs.js"),je=require("./MeshWobbleMaterial.cjs.js"),pe=require("./MeshReflectorMaterial.cjs.js"),xe=require("./MeshRefractionMaterial.cjs.js"),le=require("./MeshTransmissionMaterial.cjs.js"),qe=require("./MeshDiscardMaterial.cjs.js"),de=require("./PointMaterial.cjs.js"),me=require("./shaderMaterial.cjs.js"),Ce=require("./softShadows.cjs.js"),he=require("./shapes.cjs.js"),Me=require("./RoundedBox.cjs.js"),Se=require("./ScreenQuad.cjs.js"),Te=require("./Center.cjs.js"),be=require("./Bounds.cjs.js"),fe=require("./CameraShake.cjs.js"),Be=require("./Float.cjs.js"),Pe=require("./Stage.cjs.js"),ge=require("./Backdrop.cjs.js"),ve=require("./Shadow.cjs.js"),Ae=require("./Caustics.cjs.js"),Le=require("./ContactShadows.cjs.js"),De=require("./AccumulativeShadows.cjs.js"),ke=require("./Reflector.cjs.js"),Ge=require("./SpotLight.cjs.js"),Ee=require("./Environment.cjs.js"),Re=require("./Lightformer.cjs.js"),we=require("./Sky.cjs.js"),Fe=require("./Stars.cjs.js"),ze=require("./Cloud.cjs.js"),Oe=require("./Sparkles.cjs.js"),Ie=require("./useEnvironment.cjs.js"),He=require("./useMatcapTexture.cjs.js"),Ve=require("./useNormalTexture.cjs.js"),ye=require("./Wireframe.cjs.js"),We=require("./Points.cjs.js"),Qe=require("./Instances.cjs.js"),Xe=require("./Segments.cjs.js"),Ke=require("./Detailed.cjs.js"),Ne=require("./Preload.cjs.js"),Ue=require("./BakeShadows.cjs.js"),_e=require("./meshBounds.cjs.js"),Je=require("./AdaptiveDpr.cjs.js"),Ye=require("./AdaptiveEvents.cjs.js"),Ze=require("./PerformanceMonitor.cjs.js"),$e=require("./RenderTexture.cjs.js"),er=require("./Mask.cjs.js"),rr=require("./Hud.cjs.js");require("@babel/runtime/helpers/extends"),require("react"),require("@react-three/fiber"),require("react-merge-refs"),require("three"),require("three-stdlib"),require("troika-three-text"),require("suspend-react"),require("meshline"),require("lodash.pick"),require("lodash.omit"),require("camera-controls"),require("zustand"),require("stats.js"),require("../helpers/useEffectfulState.cjs.js"),require("detect-gpu"),require("three-mesh-bvh"),require("../materials/BlurPass.cjs.js"),require("../materials/ConvolutionMaterial.cjs.js"),require("../materials/MeshReflectorMaterial.cjs.js"),require("../materials/MeshRefractionMaterial.cjs.js"),require("../materials/DiscardMaterial.cjs.js"),require("../helpers/environment-assets.cjs.js"),require("../materials/SpotLightMaterial.cjs.js"),require("../materials/WireframeMaterial.cjs.js"),require("react-composer"),exports.Billboard=e.Billboard,exports.ScreenSpace=r.ScreenSpace,exports.QuadraticBezierLine=s.QuadraticBezierLine,exports.CubicBezierLine=t.CubicBezierLine,exports.CatmullRomLine=o.CatmullRomLine,exports.Line=i.Line,exports.PositionalAudio=a.PositionalAudio,exports.Text=u.Text,exports.Text3D=c.Text3D,exports.Effects=n.Effects,exports.isWebGL2Available=n.isWebGL2Available,exports.GradientTexture=j.GradientTexture,exports.Image=p.Image,exports.Edges=x.Edges,exports.Trail=l.Trail,exports.useTrail=l.useTrail,exports.Sampler=q.Sampler,exports.useSurfaceSampler=q.useSurfaceSampler,exports.ComputedAttribute=d.ComputedAttribute,exports.Clone=m.Clone,exports.MarchingCube=C.MarchingCube,exports.MarchingCubes=C.MarchingCubes,exports.MarchingPlane=C.MarchingPlane,exports.Decal=h.Decal,exports.Svg=M.Svg,exports.Gltf=S.Gltf,exports.AsciiRenderer=T.AsciiRenderer,exports.OrthographicCamera=b.OrthographicCamera,exports.PerspectiveCamera=f.PerspectiveCamera,exports.CubeCamera=B.CubeCamera,exports.DeviceOrientationControls=P.DeviceOrientationControls,exports.FlyControls=g.FlyControls,exports.MapControls=v.MapControls,exports.OrbitControls=A.OrbitControls,exports.TrackballControls=L.TrackballControls,exports.ArcballControls=D.ArcballControls,exports.TransformControls=k.TransformControls,exports.PointerLockControls=G.PointerLockControls,exports.FirstPersonControls=E.FirstPersonControls,exports.CameraControls=R.CameraControls,exports.GizmoHelper=w.GizmoHelper,exports.useGizmoContext=w.useGizmoContext,exports.GizmoViewcube=F.GizmoViewcube,exports.GizmoViewport=z.GizmoViewport,exports.Grid=O.Grid,exports.useCubeTexture=I.useCubeTexture,exports.useFBX=H.useFBX,exports.useGLTF=V.useGLTF,exports.useKTX2=y.useKTX2,exports.useProgress=W.useProgress,exports.IsObject=Q.IsObject,exports.useTexture=Q.useTexture,exports.useVideoTexture=X.useVideoTexture,exports.useFont=K.useFont,exports.Stats=N.Stats,exports.useDepthBuffer=U.useDepthBuffer,exports.useAspect=_.useAspect,exports.useCamera=J.useCamera,exports.useDetectGPU=Y.useDetectGPU,exports.useHelper=Z.useHelper,exports.Bvh=$.Bvh,exports.useBVH=$.useBVH,exports.useContextBridge=ee.useContextBridge,exports.useAnimations=re.useAnimations,exports.useFBO=se.useFBO,exports.useIntersect=te.useIntersect,exports.useBoxProjectedEnv=oe.useBoxProjectedEnv,exports.BBAnchor=ie.BBAnchor,exports.useTrailTexture=ae.useTrailTexture,exports.useCubeCamera=ue.useCubeCamera,exports.CurveModifier=ce.CurveModifier,exports.MeshDistortMaterial=ne.MeshDistortMaterial,exports.MeshWobbleMaterial=je.MeshWobbleMaterial,exports.MeshReflectorMaterial=pe.MeshReflectorMaterial,exports.MeshRefractionMaterial=xe.MeshRefractionMaterial,exports.MeshTransmissionMaterial=le.MeshTransmissionMaterial,exports.MeshDiscardMaterial=qe.MeshDiscardMaterial,exports.PointMaterial=de.PointMaterial,exports.PointMaterialImpl=de.PointMaterialImpl,exports.shaderMaterial=me.shaderMaterial,exports.SoftShadows=Ce.SoftShadows,exports.Box=he.Box,exports.Capsule=he.Capsule,exports.Circle=he.Circle,exports.Cone=he.Cone,exports.Cylinder=he.Cylinder,exports.Dodecahedron=he.Dodecahedron,exports.Extrude=he.Extrude,exports.Icosahedron=he.Icosahedron,exports.Lathe=he.Lathe,exports.Octahedron=he.Octahedron,exports.Plane=he.Plane,exports.Polyhedron=he.Polyhedron,exports.Ring=he.Ring,exports.Shape=he.Shape,exports.Sphere=he.Sphere,exports.Tetrahedron=he.Tetrahedron,exports.Torus=he.Torus,exports.TorusKnot=he.TorusKnot,exports.Tube=he.Tube,exports.RoundedBox=Me.RoundedBox,exports.ScreenQuad=Se.ScreenQuad,exports.Center=Te.Center,exports.Bounds=be.Bounds,exports.useBounds=be.useBounds,exports.CameraShake=fe.CameraShake,exports.Float=Be.Float,exports.Stage=Pe.Stage,exports.Backdrop=ge.Backdrop,exports.Shadow=ve.Shadow,exports.Caustics=Ae.Caustics,exports.ContactShadows=Le.ContactShadows,exports.AccumulativeShadows=De.AccumulativeShadows,exports.RandomizedLight=De.RandomizedLight,exports.accumulativeContext=De.accumulativeContext,exports.Reflector=ke.Reflector,exports.SpotLight=Ge.SpotLight,exports.SpotLightShadow=Ge.SpotLightShadow,exports.Environment=Ee.Environment,exports.EnvironmentCube=Ee.EnvironmentCube,exports.EnvironmentMap=Ee.EnvironmentMap,exports.EnvironmentPortal=Ee.EnvironmentPortal,exports.Lightformer=Re.Lightformer,exports.Sky=we.Sky,exports.calcPosFromAngles=we.calcPosFromAngles,exports.Stars=Fe.Stars,exports.Cloud=ze.Cloud,exports.Sparkles=Oe.Sparkles,exports.useEnvironment=Ie.useEnvironment,exports.useMatcapTexture=He.useMatcapTexture,exports.useNormalTexture=Ve.useNormalTexture,exports.Wireframe=ye.Wireframe,exports.Point=We.Point,exports.Points=We.Points,exports.PointsBuffer=We.PointsBuffer,exports.PositionPoint=We.PositionPoint,exports.Instance=Qe.Instance,exports.Instances=Qe.Instances,exports.Merged=Qe.Merged,exports.Segment=Xe.Segment,exports.SegmentObject=Xe.SegmentObject,exports.Segments=Xe.Segments,exports.Detailed=Ke.Detailed,exports.Preload=Ne.Preload,exports.BakeShadows=Ue.BakeShadows,exports.meshBounds=_e.meshBounds,exports.AdaptiveDpr=Je.AdaptiveDpr,exports.AdaptiveEvents=Ye.AdaptiveEvents,exports.PerformanceMonitor=Ze.PerformanceMonitor,exports.usePerformanceMonitor=Ze.usePerformanceMonitor,exports.RenderTexture=$e.RenderTexture,exports.Mask=er.Mask,exports.useMask=er.useMask,exports.Hud=rr.Hud;

package/core/index.d.ts

@@ -44,6 +44,7 @@ export * from './useKTX2';
 export * from './useProgress';
 export * from './useTexture';
 export * from './useVideoTexture';
+export * from './useFont';
 export * from './Stats';
 export * from './useDepthBuffer';
 export * from './useAspect';

package/core/index.js

@@ -44,6 +44,7 @@ export { useKTX2 } from './useKTX2.js';
 export { useProgress } from './useProgress.js';
 export { IsObject, useTexture } from './useTexture.js';
 export { useVideoTexture } from './useVideoTexture.js';
+export { useFont } from './useFont.js';
 export { Stats } from './Stats.js';
 export { useDepthBuffer } from './useDepthBuffer.js';
 export { useAspect } from './useAspect.js';

package/core/useFont.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("three-stdlib"),r=require("suspend-react");let t=null;async function n(r){t||(t=new e.FontLoader);let n="string"==typeof r?await(await fetch(r)).json():r;return t.parse(n)}function s(e){return r.suspend(n,[e])}s.preload=e=>r.preload(n,[e]),s.clear=e=>r.clear([e]),exports.useFont=s;

package/core/useFont.d.ts

@@ -0,0 +1,22 @@
+export declare type Glyph = {
+    _cachedOutline: string[];
+    ha: number;
+    o: string;
+};
+export declare type FontData = {
+    boundingBox: {
+        yMax: number;
+        yMin: number;
+    };
+    familyName: string;
+    glyphs: {
+        [k: string]: Glyph;
+    };
+    resolution: number;
+    underlineThickness: number;
+};
+export declare function useFont(font: string | FontData): import("three-stdlib").Font;
+export declare namespace useFont {
+    var preload: (font: string | FontData) => undefined;
+    var clear: (font: string | FontData) => void;
+}

package/core/useFont.js

@@ -0,0 +1,20 @@
+import { FontLoader } from 'three-stdlib';
+import { suspend, preload, clear } from 'suspend-react';
+
+let fontLoader = null;
+
+async function loader(font) {
+  if (!fontLoader) fontLoader = new FontLoader();
+  let data = typeof font === 'string' ? await (await fetch(font)).json() : font;
+  return fontLoader.parse(data);
+}
+
+function useFont(font) {
+  return suspend(loader, [font]);
+}
+
+useFont.preload = font => preload(loader, [font]);
+
+useFont.clear = font => clear([font]);
+
+export { useFont };