From 5948f6e18d35e66cdbef6b85c014f6594a982b1a Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Fri, 9 Jun 2023 19:09:46 +0300
Subject: [PATCH 01/18] wip

---
 examples/package.json                         |   4 +-
 .../src/assets/brown_photostudio_04_256.hdr   | Bin 0 -> 104760 bytes
 examples/src/demos/ControllersEnvMap.tsx      |  56 +++++++++++++
 examples/src/demos/index.tsx                  |   3 +-
 examples/src/global.d.ts                      |   4 +
 examples/vite.config.ts                       |   3 +-
 examples/yarn.lock                            |  77 ++++++++++--------
 src/Controllers.tsx                           |  62 ++++++--------
 src/XRController.tsx                          |  36 ++++++++
 src/XRControllerModelFactory.ts               |  25 +++++-
 vite.config.js                                |   1 +
 vitest.config.ts                              |   1 +
 12 files changed, 195 insertions(+), 77 deletions(-)
 create mode 100644 examples/src/assets/brown_photostudio_04_256.hdr
 create mode 100644 examples/src/demos/ControllersEnvMap.tsx
 create mode 100644 examples/src/global.d.ts

diff --git a/examples/package.json b/examples/package.json
index b71e161..9b72aa8 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -8,8 +8,8 @@
     "serve": "vite preview"
   },
   "dependencies": {
-    "@react-three/drei": "^9.53.0",
-    "@react-three/fiber": "^8.10.0",
+    "@react-three/drei": "^9.74.7",
+    "@react-three/fiber": "^8.13.0",
     "@vanilla-extract/css": "^1.9.5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
diff --git a/examples/src/assets/brown_photostudio_04_256.hdr b/examples/src/assets/brown_photostudio_04_256.hdr
new file mode 100644
index 0000000000000000000000000000000000000000..8342846bc3351459c10fac77a9c188c6b4f0d9bc
GIT binary patch
literal 104760
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
L8$YT4=#&3H4XsQ}

literal 0
HcmV?d00001

diff --git a/examples/src/demos/ControllersEnvMap.tsx b/examples/src/demos/ControllersEnvMap.tsx
new file mode 100644
index 0000000..9e4e17e
--- /dev/null
+++ b/examples/src/demos/ControllersEnvMap.tsx
@@ -0,0 +1,56 @@
+import {Canvas, dispose, useThree} from '@react-three/fiber'
+import {XR, VRButton, Controllers, useXR} from '@react-three/xr'
+import { PMREMGenerator, Texture } from 'three'
+import { RGBELoader } from 'three-stdlib'
+import {useEffect, useRef, useState} from 'react'
+import EnvMap from "../assets/brown_photostudio_04_256.hdr";
+const delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))
+function ControllersWithEnvMap() {
+  const renderer = useThree(({ gl }) => gl)
+  const isPresenting = useXR(({ isPresenting }) => isPresenting)
+  const [envMap, setEnvMap] = useState<Texture>()
+  const g = useRef<PMREMGenerator>()
+  useEffect(() => {
+    const pmremGenerator = new PMREMGenerator(renderer)
+    pmremGenerator.compileEquirectangularShader()
+    g.current = pmremGenerator
+  }, [])
+  useEffect(() => {
+    const foo = async () => {
+      const pmremGenerator = g.current!
+      if (!isPresenting) {
+        return
+      }
+      // if (isPresenting) return
+      await delay(100)
+      const rgbeLoader = new RGBELoader()
+      /**
+       * Чтобы воспроизвести, нажми Enter VR раньше, чем 5 сек
+       * Чтобы починилось, нажми позже, когда карта загрузилась
+       */
+      const dataTexture = await rgbeLoader.loadAsync(EnvMap)
+      const radianceMap = pmremGenerator.fromEquirectangular(dataTexture).texture
+      setEnvMap(radianceMap)
+      pmremGenerator.dispose()
+      console.log('done radianceMap')
+    }
+    foo()
+  }, [isPresenting])
+
+  return <Controllers envMap={envMap} envMapIntensity={1} />
+}
+
+export default function () {
+  return (
+    <>
+      <VRButton onError={(e) => console.error(e)} />
+      <Canvas>
+        <XR>
+          {/*<ambientLight intensity={0.5} />*/}
+          {/*<pointLight position={[5, 5, 5]} />*/}
+          <ControllersWithEnvMap />
+        </XR>
+      </Canvas>
+    </>
+  )
+}
diff --git a/examples/src/demos/index.tsx b/examples/src/demos/index.tsx
index dc69ba6..77bd846 100644
--- a/examples/src/demos/index.tsx
+++ b/examples/src/demos/index.tsx
@@ -5,5 +5,6 @@ const HitTest = { Component: lazy(() => import('./HitTest')) }
 const Player = { Component: lazy(() => import('./Player')) }
 const Text = { Component: lazy(() => import('./Text')) }
 const Hands = { Component: lazy(() => import('./Hands')) }
+const ControllersEnvMap = { Component: lazy(() => import('./ControllersEnvMap')) }
 
-export { Interactive, HitTest, Player, Text, Hands }
+export { Interactive, HitTest, Player, Text, Hands, ControllersEnvMap }
diff --git a/examples/src/global.d.ts b/examples/src/global.d.ts
new file mode 100644
index 0000000..6804e0f
--- /dev/null
+++ b/examples/src/global.d.ts
@@ -0,0 +1,4 @@
+declare module '*.hdr' {
+  const path: string
+  export = path
+}
\ No newline at end of file
diff --git a/examples/vite.config.ts b/examples/vite.config.ts
index 1dafc4d..66cbd81 100644
--- a/examples/vite.config.ts
+++ b/examples/vite.config.ts
@@ -1,8 +1,9 @@
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
-import { vanillaExtractPlugin } from '@vanilla-extract/vite-plugin';
+import { vanillaExtractPlugin } from '@vanilla-extract/vite-plugin'
 
 // https://vitejs.dev/config/
 export default defineConfig({
+  assetsInclude: ['**/*.hdr', '**/*.gltf'],
   plugins: [react(), vanillaExtractPlugin()]
 })
diff --git a/examples/yarn.lock b/examples/yarn.lock
index 7516b06..30dbbef 100644
--- a/examples/yarn.lock
+++ b/examples/yarn.lock
@@ -249,7 +249,7 @@
   dependencies:
     "@babel/helper-plugin-utils" "^7.19.0"
 
-"@babel/runtime@^7.11.2", "@babel/runtime@^7.16.7", "@babel/runtime@^7.17.8":
+"@babel/runtime@^7.11.2", "@babel/runtime@^7.17.8":
   version "7.20.13"
   resolved "https://registry.yarnpkg.com/@babel/runtime/-/runtime-7.20.13.tgz#7055ab8a7cff2b8f6058bf6ae45ff84ad2aded4b"
   integrity sha512-gt3PKXs0DBoL9xCvOIIZ2NEqAGZqHjAnmVbfQtB620V0uReIQutpel14KcneZuer7UioY8ALKZ7iocavvzTNFA==
@@ -504,6 +504,11 @@
     "@jridgewell/resolve-uri" "3.1.0"
     "@jridgewell/sourcemap-codec" "1.4.14"
 
+"@mediapipe/tasks-vision@^0.10.0":
+  version "0.10.1"
+  resolved "https://registry.yarnpkg.com/@mediapipe/tasks-vision/-/tasks-vision-0.10.1.tgz#68047459352019cc141dc9c1d15c05b8ab689423"
+  integrity sha512-/zIKjOAIABx+KVfqe8hA6X2pxBGsBYlEtvD7/gpXecvzKefo/JQO6XaggmJul7+noaqiPYM0CVGZxmFJ2oTdSQ==
+
 "@react-spring/animated@~9.6.1":
   version "9.6.1"
   resolved "https://registry.yarnpkg.com/@react-spring/animated/-/animated-9.6.1.tgz#ccc626d847cbe346f5f8815d0928183c647eb425"
@@ -535,7 +540,7 @@
     "@react-spring/rafz" "~9.6.1"
     "@react-spring/types" "~9.6.1"
 
-"@react-spring/three@^9.3.1":
+"@react-spring/three@~9.6.1":
   version "9.6.1"
   resolved "https://registry.yarnpkg.com/@react-spring/three/-/three-9.6.1.tgz#095fcd1dc6509127c33c14486d88289b89baeb9d"
   integrity sha512-Tyw2YhZPKJAX3t2FcqvpLRb71CyTe1GvT3V+i+xJzfALgpk10uPGdGaQQ5Xrzmok1340DAeg2pR/MCfaW7b8AA==
@@ -550,16 +555,17 @@
   resolved "https://registry.yarnpkg.com/@react-spring/types/-/types-9.6.1.tgz#913d3a68c5cbc1124fdb18eff919432f7b6abdde"
   integrity sha512-POu8Mk0hIU3lRXB3bGIGe4VHIwwDsQyoD1F394OK7STTiX9w4dG3cTLljjYswkQN+hDSHRrj4O36kuVa7KPU8Q==
 
-"@react-three/drei@^9.53.0":
-  version "9.56.19"
-  resolved "https://registry.yarnpkg.com/@react-three/drei/-/drei-9.56.19.tgz#cc52febde5ca35de7218bb54c97439edc823a529"
-  integrity sha512-vbBEbxDrC1VZ16QFtJQoC0QK1d3HSFV0WxPL5wxXZcL1zI0GN9RvoWj9CF9z2ImsaAQYzCnEurPJbsKJopxwzQ==
+"@react-three/drei@^9.74.7":
+  version "9.74.7"
+  resolved "https://registry.yarnpkg.com/@react-three/drei/-/drei-9.74.7.tgz#0b6d8316baa43307fd43a48c3d1812d126710695"
+  integrity sha512-rGl1WHEbVk83KDtRzpuQZkrOLGSmvpuu9uGEZpZzy1csxlVjOA8EWWwSCSKwmY/spWwcLnSIQ30haUMmL8ZSCw==
   dependencies:
     "@babel/runtime" "^7.11.2"
-    "@react-spring/three" "^9.3.1"
+    "@mediapipe/tasks-vision" "^0.10.0"
+    "@react-spring/three" "~9.6.1"
     "@use-gesture/react" "^10.2.24"
-    camera-controls "^2.0.1"
-    detect-gpu "^5.0.9"
+    camera-controls "^2.3.1"
+    detect-gpu "^5.0.14"
     glsl-noise "^0.0.0"
     lodash.clamp "^4.0.3"
     lodash.omit "^4.5.0"
@@ -571,15 +577,15 @@
     stats.js "^0.17.0"
     suspend-react "^0.0.8"
     three-mesh-bvh "^0.5.23"
-    three-stdlib "^2.21.8"
+    three-stdlib "^2.23.5"
     troika-three-text "^0.47.1"
     utility-types "^3.10.0"
     zustand "^3.5.13"
 
-"@react-three/fiber@^8.10.0":
-  version "8.11.0"
-  resolved "https://registry.yarnpkg.com/@react-three/fiber/-/fiber-8.11.0.tgz#3ed67cc3a7951c2aed00fe02ee694a95744c50a5"
-  integrity sha512-n9eM7hVsHbecexKK0isvUOPq1SYMHcLhUTZsMZQSYo5RT1yjbgQbbrVtF9bXN9rQgrD9l3V3Ho3ckPp0cNNs1w==
+"@react-three/fiber@^8.13.0":
+  version "8.13.0"
+  resolved "https://registry.yarnpkg.com/@react-three/fiber/-/fiber-8.13.0.tgz#c9eabe60f2276a66d7ce9a3b927083894f4202f9"
+  integrity sha512-hPFzFNgikEMyEbL+NpSA7q+UWZxInrrkJldWaCR2w34Fwf20x9p68bsyN0/yn9oM2VlWoJcJjR8hw1tN9AxHuA==
   dependencies:
     "@babel/runtime" "^7.17.8"
     "@types/react-reconciler" "^0.26.7"
@@ -607,6 +613,11 @@
     estree-walker "^2.0.2"
     picomatch "^2.3.1"
 
+"@types/draco3d@^1.4.0":
+  version "1.4.2"
+  resolved "https://registry.yarnpkg.com/@types/draco3d/-/draco3d-1.4.2.tgz#7faccb809db2a5e19b9efb97c5f2eb9d64d527ea"
+  integrity sha512-goh23EGr6CLV6aKPwN1p8kBD/7tT5V/bLpToSbarKrwVejqNrspVrv8DhliteYkkhZYrlq/fwKZRRUzH4XN88w==
+
 "@types/estree@^1.0.0":
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/@types/estree/-/estree-1.0.0.tgz#5fb2e536c1ae9bf35366eed879e827fa59ca41c2"
@@ -669,6 +680,11 @@
   resolved "https://registry.yarnpkg.com/@types/webxr/-/webxr-0.5.0.tgz#aae1cef3210d88fd4204f8c33385a0bbc4da07c9"
   integrity sha512-IUMDPSXnYIbEO2IereEFcgcqfDREOgmbGqtrMpVPpACTU6pltYLwHgVkrnYv0XhWEcjio9sYEfIEzgn3c7nDqA==
 
+"@types/webxr@^0.5.2":
+  version "0.5.2"
+  resolved "https://registry.yarnpkg.com/@types/webxr/-/webxr-0.5.2.tgz#5d9627b0ffe223aa3b166de7112ac8a9460dc54f"
+  integrity sha512-szL74BnIcok9m7QwYtVmQ+EdIKwbjPANudfuvDrAF8Cljg9MKUlIoc1w5tjj9PMpeSH3U1Xnx//czQybJ0EfSw==
+
 "@use-gesture/core@10.2.24":
   version "10.2.24"
   resolved "https://registry.yarnpkg.com/@use-gesture/core/-/core-10.2.24.tgz#88d13a60954ba62463c774acb92d12bf7b3d810c"
@@ -748,11 +764,6 @@
     magic-string "^0.27.0"
     react-refresh "^0.14.0"
 
-"@webgpu/glslang@^0.0.15":
-  version "0.0.15"
-  resolved "https://registry.yarnpkg.com/@webgpu/glslang/-/glslang-0.0.15.tgz#f5ccaf6015241e6175f4b90906b053f88483d1f2"
-  integrity sha512-niT+Prh3Aff8Uf1MVBVUsaNjFj9rJAKDXuoHIKiQbB+6IUP/3J3JIhBNyZ7lDhytvXxw6ppgnwKZdDJ08UMj4Q==
-
 acorn@^8.8.2:
   version "8.8.2"
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.8.2.tgz#1b2f25db02af965399b9776b0c2c391276d37c4a"
@@ -794,10 +805,10 @@ browserslist@^4.21.3:
     node-releases "^2.0.8"
     update-browserslist-db "^1.0.10"
 
-camera-controls@^2.0.1:
-  version "2.1.0"
-  resolved "https://registry.yarnpkg.com/camera-controls/-/camera-controls-2.1.0.tgz#75edd73935270af76b4202dc794cf022afcee4b0"
-  integrity sha512-9b2dpUZp+3Rfkh/E8dU9O9/rBbPDzyB5DBINktedRAF4I5ldZUgBiSYtFac7wF3yXNf4UH2pjP3uRcoAtXTh4A==
+camera-controls@^2.3.1:
+  version "2.4.2"
+  resolved "https://registry.yarnpkg.com/camera-controls/-/camera-controls-2.4.2.tgz#815aa5d7c4c43054fc55fb8b6cc685a56540fea2"
+  integrity sha512-blYDPECYFT/4egDMNWqKc2lBrpOfIAjPPRUNVswQELPi8naGBXUvZM3sDJSNuIRaHqid+JKPtlcoZk+Cb+X5qg==
 
 caniuse-lite@^1.0.30001449:
   version "1.0.30001451"
@@ -899,10 +910,10 @@ deepmerge@^4.2.2:
   resolved "https://registry.yarnpkg.com/deepmerge/-/deepmerge-4.3.0.tgz#65491893ec47756d44719ae520e0e2609233b59b"
   integrity sha512-z2wJZXrmeHdvYJp/Ux55wIjqo81G5Bp4c+oELTW+7ar6SogWHajt5a9gO3s3IDaGSAXjDk0vlQKN3rms8ab3og==
 
-detect-gpu@^5.0.9:
-  version "5.0.10"
-  resolved "https://registry.yarnpkg.com/detect-gpu/-/detect-gpu-5.0.10.tgz#4010b89a7f91a24ed8d2a136ee6ac816b39d0801"
-  integrity sha512-V0g0RhtlItrhgBM4/T/lTpjephr9b/xDAOtJZztGTvQxaPSMQ4EAiV9tdHL+4GcT1ATvYmMCm4QbrhyjdEH6Fw==
+detect-gpu@^5.0.14:
+  version "5.0.27"
+  resolved "https://registry.yarnpkg.com/detect-gpu/-/detect-gpu-5.0.27.tgz#821d9331c87e32568c483d85e12a9adee43d7bb2"
+  integrity sha512-IDjjqTkS+f0xm/ntbD21IPYiF0srzpePC/hhUMmctEsoklZwJwStJiMi/KN0pnH0LjSsgjwbP+QwW7y+Qf4/SQ==
   dependencies:
     webgl-constants "^1.1.1"
 
@@ -1413,14 +1424,14 @@ three-mesh-bvh@^0.5.23:
   resolved "https://registry.yarnpkg.com/three-mesh-bvh/-/three-mesh-bvh-0.5.23.tgz#08e5b629144b48b11acbd433519680e457d398ed"
   integrity sha512-nyk+MskdyDgECqkxdv57UjazqqhrMi+Al9PxJN6yFtx1CTW4r0eCQ27FtyYKY5gCIWhxjtNfWYDPVy8lzx6LkA==
 
-three-stdlib@^2.21.8:
-  version "2.21.8"
-  resolved "https://registry.yarnpkg.com/three-stdlib/-/three-stdlib-2.21.8.tgz#37b11b7f62d07b10742c212153b14db21433b3c6"
-  integrity sha512-kqisiKvO4mSy59v5vWqBQSH8famLxp7Z51LxpMJI9GwDxqODaW02rhIwmjYDEzZWNFpjZpoDHVGbdpeHf8h3SA==
+three-stdlib@^2.23.5:
+  version "2.23.9"
+  resolved "https://registry.yarnpkg.com/three-stdlib/-/three-stdlib-2.23.9.tgz#09c74fc6acced3d124e4f9d695156136c587a355"
+  integrity sha512-fYBClVGQptD7UZcoRZGNlR3sKcUW37hVPoEW1v68E4XuiwD0Ml/VqDUJ0yEMVE2DlooDvqgqv/rIcHC/B4N5pg==
   dependencies:
-    "@babel/runtime" "^7.16.7"
+    "@types/draco3d" "^1.4.0"
     "@types/offscreencanvas" "^2019.6.4"
-    "@webgpu/glslang" "^0.0.15"
+    "@types/webxr" "^0.5.2"
     chevrotain "^10.1.2"
     draco3d "^1.4.1"
     fflate "^0.6.9"
diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index f323dbe..69e78c3 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -2,10 +2,11 @@ import * as React from 'react'
 import * as THREE from 'three'
 import { useFrame, Object3DNode, extend, createPortal } from '@react-three/fiber'
 import { useXR } from './XR'
-import { XRController } from './XRController'
+import { ControllerModel, XRController } from './XRController'
 import { useIsomorphicLayoutEffect } from './utils'
-import { XRControllerModel, XRControllerModelFactory } from './XRControllerModelFactory'
-import { XRControllerEvent } from './XREvents'
+import { XRControllerModelFactory } from './XRControllerModelFactory'
+import { useCallback, useEffect } from 'react'
+import { Texture } from 'three'
 
 export interface RayProps extends Partial<JSX.IntrinsicElements['object3D']> {
   /** The XRController to attach the ray to */
@@ -13,6 +14,7 @@ export interface RayProps extends Partial<JSX.IntrinsicElements['object3D']> {
   /** Whether to hide the ray on controller blur. Default is `false` */
   hideOnBlur?: boolean
 }
+
 export const Ray = React.forwardRef<THREE.Line, RayProps>(function Ray({ target, hideOnBlur = false, ...props }, forwardedRef) {
   const hoverState = useXR((state) => state.hoverState)
   const ray = React.useRef<THREE.Line>(null!)
@@ -46,37 +48,6 @@ export const Ray = React.forwardRef<THREE.Line, RayProps>(function Ray({ target,
 
 const modelFactory = new XRControllerModelFactory()
 
-class ControllerModel extends THREE.Group {
-  readonly target: XRController
-  readonly xrControllerModel: XRControllerModel
-
-  constructor(target: XRController) {
-    super()
-    this.xrControllerModel = new XRControllerModel()
-    this.target = target
-    this.add(this.xrControllerModel)
-
-    this._onConnected = this._onConnected.bind(this)
-    this._onDisconnected = this._onDisconnected.bind(this)
-
-    this.target.controller.addEventListener('connected', this._onConnected)
-    this.target.controller.addEventListener('disconnected', this._onDisconnected)
-  }
-
-  private _onConnected(event: XRControllerEvent) {
-    modelFactory.initializeControllerModel(this.xrControllerModel, event)
-  }
-
-  private _onDisconnected(_event: XRControllerEvent) {
-    this.xrControllerModel.disconnect()
-  }
-
-  dispose() {
-    this.target.controller.removeEventListener('connected', this._onConnected)
-    this.target.controller.removeEventListener('disconnected', this._onDisconnected)
-  }
-}
-
 declare global {
   namespace JSX {
     interface IntrinsicElements {
@@ -90,8 +61,11 @@ export interface ControllersProps {
   rayMaterial?: JSX.IntrinsicElements['meshBasicMaterial']
   /** Whether to hide controllers' rays on blur. Default is `false` */
   hideRaysOnBlur?: boolean
+  envMap?: Texture
+  envMapIntensity?: number
 }
-export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false }: ControllersProps) {
+
+export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap, envMapIntensity }: ControllersProps) {
   const controllers = useXR((state) => state.controllers)
   const isHandTracking = useXR((state) => state.isHandTracking)
   const rayMaterialProps = React.useMemo(
@@ -114,11 +88,27 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false }: Contro
     }
   }, [controllers])
 
+  const handleControllerModel = useCallback((r: ControllerModel | null, target: XRController) => {
+    target.controllerModel = r
+  }, [])
+
+  useEffect(() => {
+    if (!envMap) {
+      return
+    }
+    for (const target of controllers) {
+      if (target.controllerModel) {
+        target.controllerModel.xrControllerModel.setEnvironmentMap(envMap, envMapIntensity)
+        console.log('updated environment map')
+      }
+    }
+  }, [envMap, envMapIntensity, controllers])
+
   return (
     <>
       {controllers.map((target, i) => (
         <React.Fragment key={i}>
-          {createPortal(<controllerModel args={[target]} />, target.grip)}
+          {createPortal(<controllerModel ref={(r) => handleControllerModel(r, target)} args={[target, modelFactory]} />, target.grip)}
           {createPortal(
             <Ray visible={!isHandTracking} hideOnBlur={hideRaysOnBlur} target={target} {...rayMaterialProps} />,
             target.controller
diff --git a/src/XRController.tsx b/src/XRController.tsx
index 8c85e8e..8d9b06d 100644
--- a/src/XRController.tsx
+++ b/src/XRController.tsx
@@ -1,5 +1,40 @@
 import * as THREE from 'three'
 import { XRControllerEvent } from './XREvents'
+import {XRControllerModel, XRControllerModelFactory} from "./XRControllerModelFactory";
+
+
+export class ControllerModel extends THREE.Group {
+  readonly target: XRController
+  readonly xrControllerModel: XRControllerModel
+  private modelFactory: XRControllerModelFactory;
+
+  constructor(target: XRController, modelFactory: XRControllerModelFactory) {
+    super()
+    this.xrControllerModel = new XRControllerModel()
+    this.target = target
+    this.modelFactory = modelFactory
+    this.add(this.xrControllerModel)
+
+    this._onConnected = this._onConnected.bind(this)
+    this._onDisconnected = this._onDisconnected.bind(this)
+
+    this.target.controller.addEventListener('connected', this._onConnected)
+    this.target.controller.addEventListener('disconnected', this._onDisconnected)
+  }
+
+  private _onConnected(event: XRControllerEvent) {
+    this.modelFactory.initializeControllerModel(this.xrControllerModel, event)
+  }
+
+  private _onDisconnected(_event: XRControllerEvent) {
+    this.xrControllerModel.disconnect()
+  }
+
+  dispose() {
+    this.target.controller.removeEventListener('connected', this._onConnected)
+    this.target.controller.removeEventListener('disconnected', this._onDisconnected)
+  }
+}
 
 export class XRController extends THREE.Group {
   readonly index: number
@@ -7,6 +42,7 @@ export class XRController extends THREE.Group {
   readonly grip: THREE.XRGripSpace
   readonly hand: THREE.XRHandSpace
   public inputSource!: XRInputSource
+  public controllerModel: ControllerModel | null = null;
 
   constructor(index: number, gl: THREE.WebGLRenderer) {
     super()
diff --git a/src/XRControllerModelFactory.ts b/src/XRControllerModelFactory.ts
index 4578434..ef48299 100644
--- a/src/XRControllerModelFactory.ts
+++ b/src/XRControllerModelFactory.ts
@@ -1,15 +1,27 @@
-import { Mesh, Object3D, SphereGeometry, MeshBasicMaterial } from 'three'
+import {
+  Mesh,
+  Object3D,
+  SphereGeometry,
+  MeshBasicMaterial,
+  MeshStandardMaterial,
+  MeshPhongMaterial,
+  MeshLambertMaterial
+} from 'three'
 import type { Texture } from 'three'
 import { fetchProfile, GLTFLoader, MotionController, MotionControllerConstants } from 'three-stdlib'
 
 const DEFAULT_PROFILES_PATH = 'https://cdn.jsdelivr.net/npm/@webxr-input-profiles/assets@1.0/dist/profiles'
 const DEFAULT_PROFILE = 'generic-trigger'
 
+const isEnvMapApplicable = (
+  material: any
+): material is MeshBasicMaterial | MeshStandardMaterial | MeshPhongMaterial | MeshLambertMaterial => 'envMap' in material
+
 const applyEnvironmentMap = (envMap: Texture, envMapIntensity: number, obj: Object3D): void => {
   obj.traverse((child) => {
-    if (child instanceof Mesh && 'envMap' in child.material) {
+    if (child instanceof Mesh && isEnvMapApplicable(child.material)) {
       child.material.envMap = envMap
-      child.material.envMapIntensity = envMapIntensity
+      if ('envMapIntensity' in child.material) child.material.envMapIntensity = envMapIntensity
       child.material.needsUpdate = true
     }
   })
@@ -37,7 +49,7 @@ export class XRControllerModel extends Object3D {
 
     this.envMap = envMap
     this.envMapIntensity = envMapIntensity
-    applyEnvironmentMap(this.envMap, envMapIntensity, this)
+    applyEnvironmentMap(envMap, envMapIntensity, this)
 
     return this
   }
@@ -48,12 +60,16 @@ export class XRControllerModel extends Object3D {
       return
     }
 
+
+
     this.scene = scene
     addAssetSceneToControllerModel(this, scene)
     this.dispatchEvent({
       type: 'modelconnected',
       data: scene
     })
+
+    console.log('model connected')
   }
 
   connectMotionController(motionController: MotionController): void {
@@ -194,6 +210,7 @@ export class XRControllerModelFactory {
   gltfLoader: GLTFLoader
   path: string
   private _assetCache: Record<string, { scene: Object3D } | undefined>
+
   constructor(gltfLoader: GLTFLoader | null = null, path = DEFAULT_PROFILES_PATH) {
     this.gltfLoader = gltfLoader ?? new GLTFLoader()
     this.path = path
diff --git a/vite.config.js b/vite.config.js
index 4187520..c627648 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -6,6 +6,7 @@ import { defineConfig } from 'vite'
 
 const config = {
   serve: defineConfig({
+    assetsInclude: ['**/*.hdr', '**/*.gltf'],
     root: 'examples',
     plugins: [react(), ssl(), vanillaExtractPlugin()],
     server: { host: '0.0.0.0', https: true },
diff --git a/vitest.config.ts b/vitest.config.ts
index 8faa4fe..4afcd13 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -1,6 +1,7 @@
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
+
   test: {
     environment: 'happy-dom'
   },

From b6940d360042920df06a37f287f5914dab1324c8 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 13 Jun 2023 14:21:08 +0300
Subject: [PATCH 02/18] wip 2

---
 examples/src/demos/ControllersEnvMap.tsx |  34 +-
 examples/src/demos/PMREMGenerator.js     | 757 +++++++++++++++++++++++
 2 files changed, 774 insertions(+), 17 deletions(-)
 create mode 100644 examples/src/demos/PMREMGenerator.js

diff --git a/examples/src/demos/ControllersEnvMap.tsx b/examples/src/demos/ControllersEnvMap.tsx
index 9e4e17e..e8baa04 100644
--- a/examples/src/demos/ControllersEnvMap.tsx
+++ b/examples/src/demos/ControllersEnvMap.tsx
@@ -1,26 +1,23 @@
-import {Canvas, dispose, useThree} from '@react-three/fiber'
-import {XR, VRButton, Controllers, useXR} from '@react-three/xr'
-import { PMREMGenerator, Texture } from 'three'
+import { Canvas, dispose, useThree } from '@react-three/fiber'
+import { XR, VRButton, Controllers, useXR } from '@react-three/xr'
+import {
+  Texture,
+} from 'three'
 import { RGBELoader } from 'three-stdlib'
-import {useEffect, useRef, useState} from 'react'
-import EnvMap from "../assets/brown_photostudio_04_256.hdr";
+import { useEffect, useRef, useState } from 'react'
+import EnvMap from '../assets/brown_photostudio_04_256.hdr'
+import {PMREMGenerator} from "./PMREMGenerator";
+
 const delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))
+
+
 function ControllersWithEnvMap() {
   const renderer = useThree(({ gl }) => gl)
   const isPresenting = useXR(({ isPresenting }) => isPresenting)
   const [envMap, setEnvMap] = useState<Texture>()
-  const g = useRef<PMREMGenerator>()
-  useEffect(() => {
-    const pmremGenerator = new PMREMGenerator(renderer)
-    pmremGenerator.compileEquirectangularShader()
-    g.current = pmremGenerator
-  }, [])
   useEffect(() => {
     const foo = async () => {
-      const pmremGenerator = g.current!
-      if (!isPresenting) {
-        return
-      }
+      if (!isPresenting) return
       // if (isPresenting) return
       await delay(100)
       const rgbeLoader = new RGBELoader()
@@ -29,10 +26,13 @@ function ControllersWithEnvMap() {
        * Чтобы починилось, нажми позже, когда карта загрузилась
        */
       const dataTexture = await rgbeLoader.loadAsync(EnvMap)
-      const radianceMap = pmremGenerator.fromEquirectangular(dataTexture).texture
+      const pmremGenerator = new PMREMGenerator(renderer)
+      pmremGenerator.compileEquirectangularShader()
+      const rt = pmremGenerator.fromEquirectangular(dataTexture)
+      const radianceMap = rt.texture
       setEnvMap(radianceMap)
       pmremGenerator.dispose()
-      console.log('done radianceMap')
+      console.log('done radianceMap', radianceMap.encoding, rt.isXRRenderTarget)
     }
     foo()
   }, [isPresenting])
diff --git a/examples/src/demos/PMREMGenerator.js b/examples/src/demos/PMREMGenerator.js
new file mode 100644
index 0000000..554692c
--- /dev/null
+++ b/examples/src/demos/PMREMGenerator.js
@@ -0,0 +1,757 @@
+import {
+  CubeReflectionMapping,
+  CubeRefractionMapping,
+  CubeUVReflectionMapping,
+  LinearEncoding,
+  LinearFilter,
+  NoToneMapping,
+  NoBlending,
+  RGBAFormat,
+  HalfFloatType,
+  BufferAttribute,
+  BufferGeometry,
+  Mesh,
+  OrthographicCamera,
+  PerspectiveCamera,
+  ShaderMaterial,
+  Vector3,
+  Color,
+  WebGLRenderTarget,
+  MeshBasicMaterial,
+  BoxGeometry,
+  BackSide, sRGBEncoding
+} from 'three'
+
+const LOD_MIN = 4
+
+// The standard deviations (radians) associated with the extra mips. These are
+// chosen to approximate a Trowbridge-Reitz distribution function times the
+// geometric shadowing function. These sigma values squared must match the
+// variance #defines in cube_uv_reflection_fragment.glsl.js.
+const EXTRA_LOD_SIGMA = [0.125, 0.215, 0.35, 0.446, 0.526, 0.582]
+
+// The maximum length of the blur for loop. Smaller sigmas will use fewer
+// samples and exit early, but not recompile the shader.
+const MAX_SAMPLES = 20
+
+const _flatCamera = /*@__PURE__*/ new OrthographicCamera()
+const _clearColor = /*@__PURE__*/ new Color()
+let _oldTarget = null
+
+// Golden Ratio
+const PHI = (1 + Math.sqrt(5)) / 2
+const INV_PHI = 1 / PHI
+
+// Vertices of a dodecahedron (except the opposites, which represent the
+// same axis), used as axis directions evenly spread on a sphere.
+const _axisDirections = [
+  /*@__PURE__*/ new Vector3(1, 1, 1),
+  /*@__PURE__*/ new Vector3(-1, 1, 1),
+  /*@__PURE__*/ new Vector3(1, 1, -1),
+  /*@__PURE__*/ new Vector3(-1, 1, -1),
+  /*@__PURE__*/ new Vector3(0, PHI, INV_PHI),
+  /*@__PURE__*/ new Vector3(0, PHI, -INV_PHI),
+  /*@__PURE__*/ new Vector3(INV_PHI, 0, PHI),
+  /*@__PURE__*/ new Vector3(-INV_PHI, 0, PHI),
+  /*@__PURE__*/ new Vector3(PHI, INV_PHI, 0),
+  /*@__PURE__*/ new Vector3(-PHI, INV_PHI, 0)
+]
+
+/**
+ * This class generates a Prefiltered, Mipmapped Radiance Environment Map
+ * (PMREM) from a cubeMap environment texture. This allows different levels of
+ * blur to be quickly accessed based on material roughness. It is packed into a
+ * special CubeUV format that allows us to perform custom interpolation so that
+ * we can support nonlinear formats such as RGBE. Unlike a traditional mipmap
+ * chain, it only goes down to the LOD_MIN level (above), and then creates extra
+ * even more filtered 'mips' at the same LOD_MIN resolution, associated with
+ * higher roughness levels. In this way we maintain resolution to smoothly
+ * interpolate diffuse lighting while limiting sampling computation.
+ *
+ * Paper: Fast, Accurate Image-Based Lighting
+ * https://drive.google.com/file/d/15y8r_UpKlU9SvV4ILb0C3qCPecS8pvLz/view
+ */
+
+class PMREMGenerator {
+  constructor(renderer) {
+    this._renderer = renderer
+    this._pingPongRenderTarget = null
+
+    this._lodMax = 0
+    this._cubeSize = 0
+    this._lodPlanes = []
+    this._sizeLods = []
+    this._sigmas = []
+
+    this._blurMaterial = null
+    this._cubemapMaterial = null
+    this._equirectMaterial = null
+
+    this._compileMaterial(this._blurMaterial)
+  }
+
+  /**
+   * Generates a PMREM from a supplied Scene, which can be faster than using an
+   * image if networking bandwidth is low. Optional sigma specifies a blur radius
+   * in radians to be applied to the scene before PMREM generation. Optional near
+   * and far planes ensure the scene is rendered in its entirety (the cubeCamera
+   * is placed at the origin).
+   */
+  fromScene(scene, sigma = 0, near = 0.1, far = 100) {
+    _oldTarget = this._renderer.getRenderTarget()
+
+    this._setSize(256)
+
+    const cubeUVRenderTarget = this._allocateTargets()
+    cubeUVRenderTarget.depthBuffer = true
+
+    this._sceneToCubeUV(scene, near, far, cubeUVRenderTarget)
+
+    if (sigma > 0) {
+      this._blur(cubeUVRenderTarget, 0, 0, sigma)
+    }
+
+    this._applyPMREM(cubeUVRenderTarget)
+    this._cleanup(cubeUVRenderTarget)
+
+    return cubeUVRenderTarget
+  }
+
+  /**
+   * Generates a PMREM from an equirectangular texture, which can be either LDR
+   * or HDR. The ideal input image size is 1k (1024 x 512),
+   * as this matches best with the 256 x 256 cubemap output.
+   */
+  fromEquirectangular(equirectangular, renderTarget = null) {
+    return this._fromTexture(equirectangular, renderTarget)
+  }
+
+  /**
+   * Generates a PMREM from an cubemap texture, which can be either LDR
+   * or HDR. The ideal input cube size is 256 x 256,
+   * as this matches best with the 256 x 256 cubemap output.
+   */
+  fromCubemap(cubemap, renderTarget = null) {
+    return this._fromTexture(cubemap, renderTarget)
+  }
+
+  /**
+   * Pre-compiles the cubemap shader. You can get faster start-up by invoking this method during
+   * your texture's network fetch for increased concurrency.
+   */
+  compileCubemapShader() {
+    if (this._cubemapMaterial === null) {
+      this._cubemapMaterial = _getCubemapMaterial()
+      this._compileMaterial(this._cubemapMaterial)
+    }
+  }
+
+  /**
+   * Pre-compiles the equirectangular shader. You can get faster start-up by invoking this method during
+   * your texture's network fetch for increased concurrency.
+   */
+  compileEquirectangularShader() {
+    if (this._equirectMaterial === null) {
+      this._equirectMaterial = _getEquirectMaterial()
+      this._compileMaterial(this._equirectMaterial)
+    }
+  }
+
+  /**
+   * Disposes of the PMREMGenerator's internal memory. Note that PMREMGenerator is a static class,
+   * so you should not need more than one PMREMGenerator object. If you do, calling dispose() on
+   * one of them will cause any others to also become unusable.
+   */
+  dispose() {
+    this._dispose()
+
+    if (this._cubemapMaterial !== null) this._cubemapMaterial.dispose()
+    if (this._equirectMaterial !== null) this._equirectMaterial.dispose()
+  }
+
+  // private interface
+
+  _setSize(cubeSize) {
+    this._lodMax = Math.floor(Math.log2(cubeSize))
+    this._cubeSize = Math.pow(2, this._lodMax)
+  }
+
+  _dispose() {
+    if (this._blurMaterial !== null) this._blurMaterial.dispose()
+
+    if (this._pingPongRenderTarget !== null) this._pingPongRenderTarget.dispose()
+
+    for (let i = 0; i < this._lodPlanes.length; i++) {
+      this._lodPlanes[i].dispose()
+    }
+  }
+
+  _cleanup(outputTarget) {
+    this._renderer.setRenderTarget(_oldTarget)
+    outputTarget.scissorTest = false
+    _setViewport(outputTarget, 0, 0, outputTarget.width, outputTarget.height)
+  }
+
+  _fromTexture(texture, renderTarget) {
+    if (texture.mapping === CubeReflectionMapping || texture.mapping === CubeRefractionMapping) {
+      this._setSize(texture.image.length === 0 ? 16 : texture.image[0].width || texture.image[0].image.width)
+    } else {
+      // Equirectangular
+
+      this._setSize(texture.image.width / 4)
+    }
+
+    _oldTarget = this._renderer.getRenderTarget()
+
+    const cubeUVRenderTarget = renderTarget || this._allocateTargets()
+    this._textureToCubeUV(texture, cubeUVRenderTarget)
+    this._applyPMREM(cubeUVRenderTarget)
+    this._cleanup(cubeUVRenderTarget)
+
+    return cubeUVRenderTarget
+  }
+
+  _allocateTargets() {
+    const width = 3 * Math.max(this._cubeSize, 16 * 7)
+    const height = 4 * this._cubeSize
+
+    const params = {
+      magFilter: LinearFilter,
+      minFilter: LinearFilter,
+      generateMipmaps: false,
+      type: HalfFloatType,
+      format: RGBAFormat,
+      encoding: sRGBEncoding,
+      // encoding: LinearEncoding,
+      depthBuffer: false
+    }
+
+    const cubeUVRenderTarget = _createRenderTarget(width, height, params)
+    cubeUVRenderTarget.isXRRenderTarget = true
+
+    if (this._pingPongRenderTarget === null || this._pingPongRenderTarget.width !== width) {
+      if (this._pingPongRenderTarget !== null) {
+        this._dispose()
+      }
+
+      this._pingPongRenderTarget = _createRenderTarget(width, height, params)
+      // this._pingPongRenderTarget.isXRRenderTarget = true
+
+      const { _lodMax } = this
+      ;({ sizeLods: this._sizeLods, lodPlanes: this._lodPlanes, sigmas: this._sigmas } = _createPlanes(_lodMax))
+
+      this._blurMaterial = _getBlurShader(_lodMax, width, height)
+    }
+
+    return cubeUVRenderTarget
+  }
+
+  _compileMaterial(material) {
+    const tmpMesh = new Mesh(this._lodPlanes[0], material)
+    this._renderer.compile(tmpMesh, _flatCamera)
+  }
+
+  _sceneToCubeUV(scene, near, far, cubeUVRenderTarget) {
+    const fov = 90
+    const aspect = 1
+    const cubeCamera = new PerspectiveCamera(fov, aspect, near, far)
+    const upSign = [1, -1, 1, 1, 1, 1]
+    const forwardSign = [1, 1, 1, -1, -1, -1]
+    const renderer = this._renderer
+
+    const originalAutoClear = renderer.autoClear
+    const toneMapping = renderer.toneMapping
+    renderer.getClearColor(_clearColor)
+
+    renderer.toneMapping = NoToneMapping
+    renderer.autoClear = false
+
+    const backgroundMaterial = new MeshBasicMaterial({
+      name: 'PMREM.Background',
+      side: BackSide,
+      depthWrite: false,
+      depthTest: false
+    })
+
+    const backgroundBox = new Mesh(new BoxGeometry(), backgroundMaterial)
+
+    let useSolidColor = false
+    const background = scene.background
+
+    if (background) {
+      if (background.isColor) {
+        backgroundMaterial.color.copy(background)
+        scene.background = null
+        useSolidColor = true
+      }
+    } else {
+      backgroundMaterial.color.copy(_clearColor)
+      useSolidColor = true
+    }
+
+    for (let i = 0; i < 6; i++) {
+      const col = i % 3
+
+      if (col === 0) {
+        cubeCamera.up.set(0, upSign[i], 0)
+        cubeCamera.lookAt(forwardSign[i], 0, 0)
+      } else if (col === 1) {
+        cubeCamera.up.set(0, 0, upSign[i])
+        cubeCamera.lookAt(0, forwardSign[i], 0)
+      } else {
+        cubeCamera.up.set(0, upSign[i], 0)
+        cubeCamera.lookAt(0, 0, forwardSign[i])
+      }
+
+      const size = this._cubeSize
+
+      _setViewport(cubeUVRenderTarget, col * size, i > 2 ? size : 0, size, size)
+
+      renderer.setRenderTarget(cubeUVRenderTarget)
+
+      if (useSolidColor) {
+        renderer.render(backgroundBox, cubeCamera)
+      }
+
+      renderer.render(scene, cubeCamera)
+    }
+
+    backgroundBox.geometry.dispose()
+    backgroundBox.material.dispose()
+
+    renderer.toneMapping = toneMapping
+    renderer.autoClear = originalAutoClear
+    scene.background = background
+  }
+
+  _textureToCubeUV(texture, cubeUVRenderTarget) {
+    const renderer = this._renderer
+
+    const isCubeTexture = texture.mapping === CubeReflectionMapping || texture.mapping === CubeRefractionMapping
+
+    if (isCubeTexture) {
+      if (this._cubemapMaterial === null) {
+        this._cubemapMaterial = _getCubemapMaterial()
+      }
+
+      this._cubemapMaterial.uniforms.flipEnvMap.value = texture.isRenderTargetTexture === false ? -1 : 1
+    } else {
+      if (this._equirectMaterial === null) {
+        this._equirectMaterial = _getEquirectMaterial()
+      }
+    }
+
+    const material = isCubeTexture ? this._cubemapMaterial : this._equirectMaterial
+    const mesh = new Mesh(this._lodPlanes[0], material)
+
+    const uniforms = material.uniforms
+
+    uniforms['envMap'].value = texture
+
+    const size = this._cubeSize
+
+    _setViewport(cubeUVRenderTarget, 0, 0, 3 * size, 2 * size)
+
+    renderer.setRenderTarget(cubeUVRenderTarget)
+    renderer.render(mesh, _flatCamera)
+  }
+
+  _applyPMREM(cubeUVRenderTarget) {
+    const renderer = this._renderer
+    const autoClear = renderer.autoClear
+    renderer.autoClear = false
+
+    for (let i = 1; i < this._lodPlanes.length; i++) {
+      const sigma = Math.sqrt(this._sigmas[i] * this._sigmas[i] - this._sigmas[i - 1] * this._sigmas[i - 1])
+
+      const poleAxis = _axisDirections[(i - 1) % _axisDirections.length]
+
+      this._blur(cubeUVRenderTarget, i - 1, i, sigma, poleAxis)
+    }
+
+    renderer.autoClear = autoClear
+  }
+
+  /**
+   * This is a two-pass Gaussian blur for a cubemap. Normally this is done
+   * vertically and horizontally, but this breaks down on a cube. Here we apply
+   * the blur latitudinally (around the poles), and then longitudinally (towards
+   * the poles) to approximate the orthogonally-separable blur. It is least
+   * accurate at the poles, but still does a decent job.
+   */
+  _blur(cubeUVRenderTarget, lodIn, lodOut, sigma, poleAxis) {
+    const pingPongRenderTarget = this._pingPongRenderTarget
+
+    this._halfBlur(cubeUVRenderTarget, pingPongRenderTarget, lodIn, lodOut, sigma, 'latitudinal', poleAxis)
+
+    this._halfBlur(pingPongRenderTarget, cubeUVRenderTarget, lodOut, lodOut, sigma, 'longitudinal', poleAxis)
+  }
+
+  _halfBlur(targetIn, targetOut, lodIn, lodOut, sigmaRadians, direction, poleAxis) {
+    const renderer = this._renderer
+    const blurMaterial = this._blurMaterial
+
+    if (direction !== 'latitudinal' && direction !== 'longitudinal') {
+      console.error('blur direction must be either latitudinal or longitudinal!')
+    }
+
+    // Number of standard deviations at which to cut off the discrete approximation.
+    const STANDARD_DEVIATIONS = 3
+
+    const blurMesh = new Mesh(this._lodPlanes[lodOut], blurMaterial)
+    const blurUniforms = blurMaterial.uniforms
+
+    const pixels = this._sizeLods[lodIn] - 1
+    const radiansPerPixel = isFinite(sigmaRadians) ? Math.PI / (2 * pixels) : (2 * Math.PI) / (2 * MAX_SAMPLES - 1)
+    const sigmaPixels = sigmaRadians / radiansPerPixel
+    const samples = isFinite(sigmaRadians) ? 1 + Math.floor(STANDARD_DEVIATIONS * sigmaPixels) : MAX_SAMPLES
+
+    if (samples > MAX_SAMPLES) {
+      console.warn(
+        `sigmaRadians, ${sigmaRadians}, is too large and will clip, as it requested ${samples} samples when the maximum is set to ${MAX_SAMPLES}`
+      )
+    }
+
+    const weights = []
+    let sum = 0
+
+    for (let i = 0; i < MAX_SAMPLES; ++i) {
+      const x = i / sigmaPixels
+      const weight = Math.exp((-x * x) / 2)
+      weights.push(weight)
+
+      if (i === 0) {
+        sum += weight
+      } else if (i < samples) {
+        sum += 2 * weight
+      }
+    }
+
+    for (let i = 0; i < weights.length; i++) {
+      weights[i] = weights[i] / sum
+    }
+
+    blurUniforms['envMap'].value = targetIn.texture
+    blurUniforms['samples'].value = samples
+    blurUniforms['weights'].value = weights
+    blurUniforms['latitudinal'].value = direction === 'latitudinal'
+
+    if (poleAxis) {
+      blurUniforms['poleAxis'].value = poleAxis
+    }
+
+    const { _lodMax } = this
+    blurUniforms['dTheta'].value = radiansPerPixel
+    blurUniforms['mipInt'].value = _lodMax - lodIn
+
+    const outputSize = this._sizeLods[lodOut]
+    const x = 3 * outputSize * (lodOut > _lodMax - LOD_MIN ? lodOut - _lodMax + LOD_MIN : 0)
+    const y = 4 * (this._cubeSize - outputSize)
+
+    _setViewport(targetOut, x, y, 3 * outputSize, 2 * outputSize)
+    renderer.setRenderTarget(targetOut)
+    renderer.render(blurMesh, _flatCamera)
+  }
+}
+
+function _createPlanes(lodMax) {
+  const lodPlanes = []
+  const sizeLods = []
+  const sigmas = []
+
+  let lod = lodMax
+
+  const totalLods = lodMax - LOD_MIN + 1 + EXTRA_LOD_SIGMA.length
+
+  for (let i = 0; i < totalLods; i++) {
+    const sizeLod = Math.pow(2, lod)
+    sizeLods.push(sizeLod)
+    let sigma = 1.0 / sizeLod
+
+    if (i > lodMax - LOD_MIN) {
+      sigma = EXTRA_LOD_SIGMA[i - lodMax + LOD_MIN - 1]
+    } else if (i === 0) {
+      sigma = 0
+    }
+
+    sigmas.push(sigma)
+
+    const texelSize = 1.0 / (sizeLod - 2)
+    const min = -texelSize
+    const max = 1 + texelSize
+    const uv1 = [min, min, max, min, max, max, min, min, max, max, min, max]
+
+    const cubeFaces = 6
+    const vertices = 6
+    const positionSize = 3
+    const uvSize = 2
+    const faceIndexSize = 1
+
+    const position = new Float32Array(positionSize * vertices * cubeFaces)
+    const uv = new Float32Array(uvSize * vertices * cubeFaces)
+    const faceIndex = new Float32Array(faceIndexSize * vertices * cubeFaces)
+
+    for (let face = 0; face < cubeFaces; face++) {
+      const x = ((face % 3) * 2) / 3 - 1
+      const y = face > 2 ? 0 : -1
+      const coordinates = [x, y, 0, x + 2 / 3, y, 0, x + 2 / 3, y + 1, 0, x, y, 0, x + 2 / 3, y + 1, 0, x, y + 1, 0]
+      position.set(coordinates, positionSize * vertices * face)
+      uv.set(uv1, uvSize * vertices * face)
+      const fill = [face, face, face, face, face, face]
+      faceIndex.set(fill, faceIndexSize * vertices * face)
+    }
+
+    const planes = new BufferGeometry()
+    planes.setAttribute('position', new BufferAttribute(position, positionSize))
+    planes.setAttribute('uv', new BufferAttribute(uv, uvSize))
+    planes.setAttribute('faceIndex', new BufferAttribute(faceIndex, faceIndexSize))
+    lodPlanes.push(planes)
+
+    if (lod > LOD_MIN) {
+      lod--
+    }
+  }
+
+  return { lodPlanes, sizeLods, sigmas }
+}
+
+function _createRenderTarget(width, height, params) {
+  const cubeUVRenderTarget = new WebGLRenderTarget(width, height, params)
+  cubeUVRenderTarget.texture.mapping = CubeUVReflectionMapping
+  cubeUVRenderTarget.texture.name = 'PMREM.cubeUv'
+  cubeUVRenderTarget.scissorTest = true
+  return cubeUVRenderTarget
+}
+
+function _setViewport(target, x, y, width, height) {
+  target.viewport.set(x, y, width, height)
+  target.scissor.set(x, y, width, height)
+}
+
+function _getBlurShader(lodMax, width, height) {
+  const weights = new Float32Array(MAX_SAMPLES)
+  const poleAxis = new Vector3(0, 1, 0)
+  const shaderMaterial = new ShaderMaterial({
+    name: 'SphericalGaussianBlur',
+
+    defines: {
+      n: MAX_SAMPLES,
+      CUBEUV_TEXEL_WIDTH: 1.0 / width,
+      CUBEUV_TEXEL_HEIGHT: 1.0 / height,
+      CUBEUV_MAX_MIP: `${lodMax}.0`
+    },
+
+    uniforms: {
+      envMap: { value: null },
+      samples: { value: 1 },
+      weights: { value: weights },
+      latitudinal: { value: false },
+      dTheta: { value: 0 },
+      mipInt: { value: 0 },
+      poleAxis: { value: poleAxis }
+    },
+
+    vertexShader: _getCommonVertexShader(),
+
+    fragmentShader: /* glsl */ `
+
+			precision mediump float;
+			precision mediump int;
+
+			varying vec3 vOutputDirection;
+
+			uniform sampler2D envMap;
+			uniform int samples;
+			uniform float weights[ n ];
+			uniform bool latitudinal;
+			uniform float dTheta;
+			uniform float mipInt;
+			uniform vec3 poleAxis;
+
+			#define ENVMAP_TYPE_CUBE_UV
+			#include <cube_uv_reflection_fragment>
+
+			vec3 getSample( float theta, vec3 axis ) {
+
+				float cosTheta = cos( theta );
+				// Rodrigues' axis-angle rotation
+				vec3 sampleDirection = vOutputDirection * cosTheta
+					+ cross( axis, vOutputDirection ) * sin( theta )
+					+ axis * dot( axis, vOutputDirection ) * ( 1.0 - cosTheta );
+
+				return bilinearCubeUV( envMap, sampleDirection, mipInt );
+
+			}
+
+			void main() {
+
+				vec3 axis = latitudinal ? poleAxis : cross( poleAxis, vOutputDirection );
+
+				if ( all( equal( axis, vec3( 0.0 ) ) ) ) {
+
+					axis = vec3( vOutputDirection.z, 0.0, - vOutputDirection.x );
+
+				}
+
+				axis = normalize( axis );
+
+				gl_FragColor = vec4( 0.0, 0.0, 0.0, 1.0 );
+				gl_FragColor.rgb += weights[ 0 ] * getSample( 0.0, axis );
+
+				for ( int i = 1; i < n; i++ ) {
+
+					if ( i >= samples ) {
+
+						break;
+
+					}
+
+					float theta = dTheta * float( i );
+					gl_FragColor.rgb += weights[ i ] * getSample( -1.0 * theta, axis );
+					gl_FragColor.rgb += weights[ i ] * getSample( theta, axis );
+
+				}
+
+			}
+		`,
+
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false
+  })
+
+  return shaderMaterial
+}
+
+function _getEquirectMaterial() {
+  return new ShaderMaterial({
+    name: 'EquirectangularToCubeUV',
+
+    uniforms: {
+      envMap: { value: null }
+    },
+
+    vertexShader: _getCommonVertexShader(),
+
+    fragmentShader: /* glsl */ `
+
+			precision mediump float;
+			precision mediump int;
+
+			varying vec3 vOutputDirection;
+
+			uniform sampler2D envMap;
+
+			#include <common>
+
+			void main() {
+
+				vec3 outputDirection = normalize( vOutputDirection );
+				vec2 uv = equirectUv( outputDirection );
+
+				gl_FragColor = vec4( texture2D ( envMap, uv ).rgb, 1.0 );
+
+			}
+		`,
+
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false
+  })
+}
+
+function _getCubemapMaterial() {
+  return new ShaderMaterial({
+    name: 'CubemapToCubeUV',
+
+    uniforms: {
+      envMap: { value: null },
+      flipEnvMap: { value: -1 }
+    },
+
+    vertexShader: _getCommonVertexShader(),
+
+    fragmentShader: /* glsl */ `
+
+			precision mediump float;
+			precision mediump int;
+
+			uniform float flipEnvMap;
+
+			varying vec3 vOutputDirection;
+
+			uniform samplerCube envMap;
+
+			void main() {
+
+				gl_FragColor = textureCube( envMap, vec3( flipEnvMap * vOutputDirection.x, vOutputDirection.yz ) );
+
+			}
+		`,
+
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false
+  })
+}
+
+function _getCommonVertexShader() {
+  return /* glsl */ `
+
+		precision mediump float;
+		precision mediump int;
+
+		attribute float faceIndex;
+
+		varying vec3 vOutputDirection;
+
+		// RH coordinate system; PMREM face-indexing convention
+		vec3 getDirection( vec2 uv, float face ) {
+
+			uv = 2.0 * uv - 1.0;
+
+			vec3 direction = vec3( uv, 1.0 );
+
+			if ( face == 0.0 ) {
+
+				direction = direction.zyx; // ( 1, v, u ) pos x
+
+			} else if ( face == 1.0 ) {
+
+				direction = direction.xzy;
+				direction.xz *= -1.0; // ( -u, 1, -v ) pos y
+
+			} else if ( face == 2.0 ) {
+
+				direction.x *= -1.0; // ( -u, v, 1 ) pos z
+
+			} else if ( face == 3.0 ) {
+
+				direction = direction.zyx;
+				direction.xz *= -1.0; // ( -1, v, -u ) neg x
+
+			} else if ( face == 4.0 ) {
+
+				direction = direction.xzy;
+				direction.xy *= -1.0; // ( -u, -1, v ) neg y
+
+			} else if ( face == 5.0 ) {
+
+				direction.z *= -1.0; // ( u, v, -1 ) neg z
+
+			}
+
+			return direction;
+
+		}
+
+		void main() {
+
+			vOutputDirection = getDirection( uv, faceIndex );
+			gl_Position = vec4( position, 1.0 );
+
+		}
+	`
+}
+
+export {PMREMGenerator};

From b8167d9d89303c43931b1f8dc86014d23cccb982 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 4 Jul 2023 17:55:56 +0300
Subject: [PATCH 03/18] wip

---
 examples/src/demos/ControllersEnvMap.tsx |  25 +-
 examples/src/demos/PMREMGenerator.js     | 757 -----------------------
 src/Controllers.tsx                      |   1 -
 3 files changed, 5 insertions(+), 778 deletions(-)
 delete mode 100644 examples/src/demos/PMREMGenerator.js

diff --git a/examples/src/demos/ControllersEnvMap.tsx b/examples/src/demos/ControllersEnvMap.tsx
index e8baa04..35ff313 100644
--- a/examples/src/demos/ControllersEnvMap.tsx
+++ b/examples/src/demos/ControllersEnvMap.tsx
@@ -1,30 +1,16 @@
-import { Canvas, dispose, useThree } from '@react-three/fiber'
-import { XR, VRButton, Controllers, useXR } from '@react-three/xr'
-import {
-  Texture,
-} from 'three'
+import { Canvas, useThree } from '@react-three/fiber'
+import { XR, VRButton, Controllers } from '@react-three/xr'
+import { PMREMGenerator, Texture } from 'three'
 import { RGBELoader } from 'three-stdlib'
-import { useEffect, useRef, useState } from 'react'
+import { useEffect, useState } from 'react'
 import EnvMap from '../assets/brown_photostudio_04_256.hdr'
-import {PMREMGenerator} from "./PMREMGenerator";
-
-const delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))
-
 
 function ControllersWithEnvMap() {
   const renderer = useThree(({ gl }) => gl)
-  const isPresenting = useXR(({ isPresenting }) => isPresenting)
   const [envMap, setEnvMap] = useState<Texture>()
   useEffect(() => {
     const foo = async () => {
-      if (!isPresenting) return
-      // if (isPresenting) return
-      await delay(100)
       const rgbeLoader = new RGBELoader()
-      /**
-       * Чтобы воспроизвести, нажми Enter VR раньше, чем 5 сек
-       * Чтобы починилось, нажми позже, когда карта загрузилась
-       */
       const dataTexture = await rgbeLoader.loadAsync(EnvMap)
       const pmremGenerator = new PMREMGenerator(renderer)
       pmremGenerator.compileEquirectangularShader()
@@ -32,10 +18,9 @@ function ControllersWithEnvMap() {
       const radianceMap = rt.texture
       setEnvMap(radianceMap)
       pmremGenerator.dispose()
-      console.log('done radianceMap', radianceMap.encoding, rt.isXRRenderTarget)
     }
     foo()
-  }, [isPresenting])
+  }, [renderer])
 
   return <Controllers envMap={envMap} envMapIntensity={1} />
 }
diff --git a/examples/src/demos/PMREMGenerator.js b/examples/src/demos/PMREMGenerator.js
deleted file mode 100644
index 554692c..0000000
--- a/examples/src/demos/PMREMGenerator.js
+++ /dev/null
@@ -1,757 +0,0 @@
-import {
-  CubeReflectionMapping,
-  CubeRefractionMapping,
-  CubeUVReflectionMapping,
-  LinearEncoding,
-  LinearFilter,
-  NoToneMapping,
-  NoBlending,
-  RGBAFormat,
-  HalfFloatType,
-  BufferAttribute,
-  BufferGeometry,
-  Mesh,
-  OrthographicCamera,
-  PerspectiveCamera,
-  ShaderMaterial,
-  Vector3,
-  Color,
-  WebGLRenderTarget,
-  MeshBasicMaterial,
-  BoxGeometry,
-  BackSide, sRGBEncoding
-} from 'three'
-
-const LOD_MIN = 4
-
-// The standard deviations (radians) associated with the extra mips. These are
-// chosen to approximate a Trowbridge-Reitz distribution function times the
-// geometric shadowing function. These sigma values squared must match the
-// variance #defines in cube_uv_reflection_fragment.glsl.js.
-const EXTRA_LOD_SIGMA = [0.125, 0.215, 0.35, 0.446, 0.526, 0.582]
-
-// The maximum length of the blur for loop. Smaller sigmas will use fewer
-// samples and exit early, but not recompile the shader.
-const MAX_SAMPLES = 20
-
-const _flatCamera = /*@__PURE__*/ new OrthographicCamera()
-const _clearColor = /*@__PURE__*/ new Color()
-let _oldTarget = null
-
-// Golden Ratio
-const PHI = (1 + Math.sqrt(5)) / 2
-const INV_PHI = 1 / PHI
-
-// Vertices of a dodecahedron (except the opposites, which represent the
-// same axis), used as axis directions evenly spread on a sphere.
-const _axisDirections = [
-  /*@__PURE__*/ new Vector3(1, 1, 1),
-  /*@__PURE__*/ new Vector3(-1, 1, 1),
-  /*@__PURE__*/ new Vector3(1, 1, -1),
-  /*@__PURE__*/ new Vector3(-1, 1, -1),
-  /*@__PURE__*/ new Vector3(0, PHI, INV_PHI),
-  /*@__PURE__*/ new Vector3(0, PHI, -INV_PHI),
-  /*@__PURE__*/ new Vector3(INV_PHI, 0, PHI),
-  /*@__PURE__*/ new Vector3(-INV_PHI, 0, PHI),
-  /*@__PURE__*/ new Vector3(PHI, INV_PHI, 0),
-  /*@__PURE__*/ new Vector3(-PHI, INV_PHI, 0)
-]
-
-/**
- * This class generates a Prefiltered, Mipmapped Radiance Environment Map
- * (PMREM) from a cubeMap environment texture. This allows different levels of
- * blur to be quickly accessed based on material roughness. It is packed into a
- * special CubeUV format that allows us to perform custom interpolation so that
- * we can support nonlinear formats such as RGBE. Unlike a traditional mipmap
- * chain, it only goes down to the LOD_MIN level (above), and then creates extra
- * even more filtered 'mips' at the same LOD_MIN resolution, associated with
- * higher roughness levels. In this way we maintain resolution to smoothly
- * interpolate diffuse lighting while limiting sampling computation.
- *
- * Paper: Fast, Accurate Image-Based Lighting
- * https://drive.google.com/file/d/15y8r_UpKlU9SvV4ILb0C3qCPecS8pvLz/view
- */
-
-class PMREMGenerator {
-  constructor(renderer) {
-    this._renderer = renderer
-    this._pingPongRenderTarget = null
-
-    this._lodMax = 0
-    this._cubeSize = 0
-    this._lodPlanes = []
-    this._sizeLods = []
-    this._sigmas = []
-
-    this._blurMaterial = null
-    this._cubemapMaterial = null
-    this._equirectMaterial = null
-
-    this._compileMaterial(this._blurMaterial)
-  }
-
-  /**
-   * Generates a PMREM from a supplied Scene, which can be faster than using an
-   * image if networking bandwidth is low. Optional sigma specifies a blur radius
-   * in radians to be applied to the scene before PMREM generation. Optional near
-   * and far planes ensure the scene is rendered in its entirety (the cubeCamera
-   * is placed at the origin).
-   */
-  fromScene(scene, sigma = 0, near = 0.1, far = 100) {
-    _oldTarget = this._renderer.getRenderTarget()
-
-    this._setSize(256)
-
-    const cubeUVRenderTarget = this._allocateTargets()
-    cubeUVRenderTarget.depthBuffer = true
-
-    this._sceneToCubeUV(scene, near, far, cubeUVRenderTarget)
-
-    if (sigma > 0) {
-      this._blur(cubeUVRenderTarget, 0, 0, sigma)
-    }
-
-    this._applyPMREM(cubeUVRenderTarget)
-    this._cleanup(cubeUVRenderTarget)
-
-    return cubeUVRenderTarget
-  }
-
-  /**
-   * Generates a PMREM from an equirectangular texture, which can be either LDR
-   * or HDR. The ideal input image size is 1k (1024 x 512),
-   * as this matches best with the 256 x 256 cubemap output.
-   */
-  fromEquirectangular(equirectangular, renderTarget = null) {
-    return this._fromTexture(equirectangular, renderTarget)
-  }
-
-  /**
-   * Generates a PMREM from an cubemap texture, which can be either LDR
-   * or HDR. The ideal input cube size is 256 x 256,
-   * as this matches best with the 256 x 256 cubemap output.
-   */
-  fromCubemap(cubemap, renderTarget = null) {
-    return this._fromTexture(cubemap, renderTarget)
-  }
-
-  /**
-   * Pre-compiles the cubemap shader. You can get faster start-up by invoking this method during
-   * your texture's network fetch for increased concurrency.
-   */
-  compileCubemapShader() {
-    if (this._cubemapMaterial === null) {
-      this._cubemapMaterial = _getCubemapMaterial()
-      this._compileMaterial(this._cubemapMaterial)
-    }
-  }
-
-  /**
-   * Pre-compiles the equirectangular shader. You can get faster start-up by invoking this method during
-   * your texture's network fetch for increased concurrency.
-   */
-  compileEquirectangularShader() {
-    if (this._equirectMaterial === null) {
-      this._equirectMaterial = _getEquirectMaterial()
-      this._compileMaterial(this._equirectMaterial)
-    }
-  }
-
-  /**
-   * Disposes of the PMREMGenerator's internal memory. Note that PMREMGenerator is a static class,
-   * so you should not need more than one PMREMGenerator object. If you do, calling dispose() on
-   * one of them will cause any others to also become unusable.
-   */
-  dispose() {
-    this._dispose()
-
-    if (this._cubemapMaterial !== null) this._cubemapMaterial.dispose()
-    if (this._equirectMaterial !== null) this._equirectMaterial.dispose()
-  }
-
-  // private interface
-
-  _setSize(cubeSize) {
-    this._lodMax = Math.floor(Math.log2(cubeSize))
-    this._cubeSize = Math.pow(2, this._lodMax)
-  }
-
-  _dispose() {
-    if (this._blurMaterial !== null) this._blurMaterial.dispose()
-
-    if (this._pingPongRenderTarget !== null) this._pingPongRenderTarget.dispose()
-
-    for (let i = 0; i < this._lodPlanes.length; i++) {
-      this._lodPlanes[i].dispose()
-    }
-  }
-
-  _cleanup(outputTarget) {
-    this._renderer.setRenderTarget(_oldTarget)
-    outputTarget.scissorTest = false
-    _setViewport(outputTarget, 0, 0, outputTarget.width, outputTarget.height)
-  }
-
-  _fromTexture(texture, renderTarget) {
-    if (texture.mapping === CubeReflectionMapping || texture.mapping === CubeRefractionMapping) {
-      this._setSize(texture.image.length === 0 ? 16 : texture.image[0].width || texture.image[0].image.width)
-    } else {
-      // Equirectangular
-
-      this._setSize(texture.image.width / 4)
-    }
-
-    _oldTarget = this._renderer.getRenderTarget()
-
-    const cubeUVRenderTarget = renderTarget || this._allocateTargets()
-    this._textureToCubeUV(texture, cubeUVRenderTarget)
-    this._applyPMREM(cubeUVRenderTarget)
-    this._cleanup(cubeUVRenderTarget)
-
-    return cubeUVRenderTarget
-  }
-
-  _allocateTargets() {
-    const width = 3 * Math.max(this._cubeSize, 16 * 7)
-    const height = 4 * this._cubeSize
-
-    const params = {
-      magFilter: LinearFilter,
-      minFilter: LinearFilter,
-      generateMipmaps: false,
-      type: HalfFloatType,
-      format: RGBAFormat,
-      encoding: sRGBEncoding,
-      // encoding: LinearEncoding,
-      depthBuffer: false
-    }
-
-    const cubeUVRenderTarget = _createRenderTarget(width, height, params)
-    cubeUVRenderTarget.isXRRenderTarget = true
-
-    if (this._pingPongRenderTarget === null || this._pingPongRenderTarget.width !== width) {
-      if (this._pingPongRenderTarget !== null) {
-        this._dispose()
-      }
-
-      this._pingPongRenderTarget = _createRenderTarget(width, height, params)
-      // this._pingPongRenderTarget.isXRRenderTarget = true
-
-      const { _lodMax } = this
-      ;({ sizeLods: this._sizeLods, lodPlanes: this._lodPlanes, sigmas: this._sigmas } = _createPlanes(_lodMax))
-
-      this._blurMaterial = _getBlurShader(_lodMax, width, height)
-    }
-
-    return cubeUVRenderTarget
-  }
-
-  _compileMaterial(material) {
-    const tmpMesh = new Mesh(this._lodPlanes[0], material)
-    this._renderer.compile(tmpMesh, _flatCamera)
-  }
-
-  _sceneToCubeUV(scene, near, far, cubeUVRenderTarget) {
-    const fov = 90
-    const aspect = 1
-    const cubeCamera = new PerspectiveCamera(fov, aspect, near, far)
-    const upSign = [1, -1, 1, 1, 1, 1]
-    const forwardSign = [1, 1, 1, -1, -1, -1]
-    const renderer = this._renderer
-
-    const originalAutoClear = renderer.autoClear
-    const toneMapping = renderer.toneMapping
-    renderer.getClearColor(_clearColor)
-
-    renderer.toneMapping = NoToneMapping
-    renderer.autoClear = false
-
-    const backgroundMaterial = new MeshBasicMaterial({
-      name: 'PMREM.Background',
-      side: BackSide,
-      depthWrite: false,
-      depthTest: false
-    })
-
-    const backgroundBox = new Mesh(new BoxGeometry(), backgroundMaterial)
-
-    let useSolidColor = false
-    const background = scene.background
-
-    if (background) {
-      if (background.isColor) {
-        backgroundMaterial.color.copy(background)
-        scene.background = null
-        useSolidColor = true
-      }
-    } else {
-      backgroundMaterial.color.copy(_clearColor)
-      useSolidColor = true
-    }
-
-    for (let i = 0; i < 6; i++) {
-      const col = i % 3
-
-      if (col === 0) {
-        cubeCamera.up.set(0, upSign[i], 0)
-        cubeCamera.lookAt(forwardSign[i], 0, 0)
-      } else if (col === 1) {
-        cubeCamera.up.set(0, 0, upSign[i])
-        cubeCamera.lookAt(0, forwardSign[i], 0)
-      } else {
-        cubeCamera.up.set(0, upSign[i], 0)
-        cubeCamera.lookAt(0, 0, forwardSign[i])
-      }
-
-      const size = this._cubeSize
-
-      _setViewport(cubeUVRenderTarget, col * size, i > 2 ? size : 0, size, size)
-
-      renderer.setRenderTarget(cubeUVRenderTarget)
-
-      if (useSolidColor) {
-        renderer.render(backgroundBox, cubeCamera)
-      }
-
-      renderer.render(scene, cubeCamera)
-    }
-
-    backgroundBox.geometry.dispose()
-    backgroundBox.material.dispose()
-
-    renderer.toneMapping = toneMapping
-    renderer.autoClear = originalAutoClear
-    scene.background = background
-  }
-
-  _textureToCubeUV(texture, cubeUVRenderTarget) {
-    const renderer = this._renderer
-
-    const isCubeTexture = texture.mapping === CubeReflectionMapping || texture.mapping === CubeRefractionMapping
-
-    if (isCubeTexture) {
-      if (this._cubemapMaterial === null) {
-        this._cubemapMaterial = _getCubemapMaterial()
-      }
-
-      this._cubemapMaterial.uniforms.flipEnvMap.value = texture.isRenderTargetTexture === false ? -1 : 1
-    } else {
-      if (this._equirectMaterial === null) {
-        this._equirectMaterial = _getEquirectMaterial()
-      }
-    }
-
-    const material = isCubeTexture ? this._cubemapMaterial : this._equirectMaterial
-    const mesh = new Mesh(this._lodPlanes[0], material)
-
-    const uniforms = material.uniforms
-
-    uniforms['envMap'].value = texture
-
-    const size = this._cubeSize
-
-    _setViewport(cubeUVRenderTarget, 0, 0, 3 * size, 2 * size)
-
-    renderer.setRenderTarget(cubeUVRenderTarget)
-    renderer.render(mesh, _flatCamera)
-  }
-
-  _applyPMREM(cubeUVRenderTarget) {
-    const renderer = this._renderer
-    const autoClear = renderer.autoClear
-    renderer.autoClear = false
-
-    for (let i = 1; i < this._lodPlanes.length; i++) {
-      const sigma = Math.sqrt(this._sigmas[i] * this._sigmas[i] - this._sigmas[i - 1] * this._sigmas[i - 1])
-
-      const poleAxis = _axisDirections[(i - 1) % _axisDirections.length]
-
-      this._blur(cubeUVRenderTarget, i - 1, i, sigma, poleAxis)
-    }
-
-    renderer.autoClear = autoClear
-  }
-
-  /**
-   * This is a two-pass Gaussian blur for a cubemap. Normally this is done
-   * vertically and horizontally, but this breaks down on a cube. Here we apply
-   * the blur latitudinally (around the poles), and then longitudinally (towards
-   * the poles) to approximate the orthogonally-separable blur. It is least
-   * accurate at the poles, but still does a decent job.
-   */
-  _blur(cubeUVRenderTarget, lodIn, lodOut, sigma, poleAxis) {
-    const pingPongRenderTarget = this._pingPongRenderTarget
-
-    this._halfBlur(cubeUVRenderTarget, pingPongRenderTarget, lodIn, lodOut, sigma, 'latitudinal', poleAxis)
-
-    this._halfBlur(pingPongRenderTarget, cubeUVRenderTarget, lodOut, lodOut, sigma, 'longitudinal', poleAxis)
-  }
-
-  _halfBlur(targetIn, targetOut, lodIn, lodOut, sigmaRadians, direction, poleAxis) {
-    const renderer = this._renderer
-    const blurMaterial = this._blurMaterial
-
-    if (direction !== 'latitudinal' && direction !== 'longitudinal') {
-      console.error('blur direction must be either latitudinal or longitudinal!')
-    }
-
-    // Number of standard deviations at which to cut off the discrete approximation.
-    const STANDARD_DEVIATIONS = 3
-
-    const blurMesh = new Mesh(this._lodPlanes[lodOut], blurMaterial)
-    const blurUniforms = blurMaterial.uniforms
-
-    const pixels = this._sizeLods[lodIn] - 1
-    const radiansPerPixel = isFinite(sigmaRadians) ? Math.PI / (2 * pixels) : (2 * Math.PI) / (2 * MAX_SAMPLES - 1)
-    const sigmaPixels = sigmaRadians / radiansPerPixel
-    const samples = isFinite(sigmaRadians) ? 1 + Math.floor(STANDARD_DEVIATIONS * sigmaPixels) : MAX_SAMPLES
-
-    if (samples > MAX_SAMPLES) {
-      console.warn(
-        `sigmaRadians, ${sigmaRadians}, is too large and will clip, as it requested ${samples} samples when the maximum is set to ${MAX_SAMPLES}`
-      )
-    }
-
-    const weights = []
-    let sum = 0
-
-    for (let i = 0; i < MAX_SAMPLES; ++i) {
-      const x = i / sigmaPixels
-      const weight = Math.exp((-x * x) / 2)
-      weights.push(weight)
-
-      if (i === 0) {
-        sum += weight
-      } else if (i < samples) {
-        sum += 2 * weight
-      }
-    }
-
-    for (let i = 0; i < weights.length; i++) {
-      weights[i] = weights[i] / sum
-    }
-
-    blurUniforms['envMap'].value = targetIn.texture
-    blurUniforms['samples'].value = samples
-    blurUniforms['weights'].value = weights
-    blurUniforms['latitudinal'].value = direction === 'latitudinal'
-
-    if (poleAxis) {
-      blurUniforms['poleAxis'].value = poleAxis
-    }
-
-    const { _lodMax } = this
-    blurUniforms['dTheta'].value = radiansPerPixel
-    blurUniforms['mipInt'].value = _lodMax - lodIn
-
-    const outputSize = this._sizeLods[lodOut]
-    const x = 3 * outputSize * (lodOut > _lodMax - LOD_MIN ? lodOut - _lodMax + LOD_MIN : 0)
-    const y = 4 * (this._cubeSize - outputSize)
-
-    _setViewport(targetOut, x, y, 3 * outputSize, 2 * outputSize)
-    renderer.setRenderTarget(targetOut)
-    renderer.render(blurMesh, _flatCamera)
-  }
-}
-
-function _createPlanes(lodMax) {
-  const lodPlanes = []
-  const sizeLods = []
-  const sigmas = []
-
-  let lod = lodMax
-
-  const totalLods = lodMax - LOD_MIN + 1 + EXTRA_LOD_SIGMA.length
-
-  for (let i = 0; i < totalLods; i++) {
-    const sizeLod = Math.pow(2, lod)
-    sizeLods.push(sizeLod)
-    let sigma = 1.0 / sizeLod
-
-    if (i > lodMax - LOD_MIN) {
-      sigma = EXTRA_LOD_SIGMA[i - lodMax + LOD_MIN - 1]
-    } else if (i === 0) {
-      sigma = 0
-    }
-
-    sigmas.push(sigma)
-
-    const texelSize = 1.0 / (sizeLod - 2)
-    const min = -texelSize
-    const max = 1 + texelSize
-    const uv1 = [min, min, max, min, max, max, min, min, max, max, min, max]
-
-    const cubeFaces = 6
-    const vertices = 6
-    const positionSize = 3
-    const uvSize = 2
-    const faceIndexSize = 1
-
-    const position = new Float32Array(positionSize * vertices * cubeFaces)
-    const uv = new Float32Array(uvSize * vertices * cubeFaces)
-    const faceIndex = new Float32Array(faceIndexSize * vertices * cubeFaces)
-
-    for (let face = 0; face < cubeFaces; face++) {
-      const x = ((face % 3) * 2) / 3 - 1
-      const y = face > 2 ? 0 : -1
-      const coordinates = [x, y, 0, x + 2 / 3, y, 0, x + 2 / 3, y + 1, 0, x, y, 0, x + 2 / 3, y + 1, 0, x, y + 1, 0]
-      position.set(coordinates, positionSize * vertices * face)
-      uv.set(uv1, uvSize * vertices * face)
-      const fill = [face, face, face, face, face, face]
-      faceIndex.set(fill, faceIndexSize * vertices * face)
-    }
-
-    const planes = new BufferGeometry()
-    planes.setAttribute('position', new BufferAttribute(position, positionSize))
-    planes.setAttribute('uv', new BufferAttribute(uv, uvSize))
-    planes.setAttribute('faceIndex', new BufferAttribute(faceIndex, faceIndexSize))
-    lodPlanes.push(planes)
-
-    if (lod > LOD_MIN) {
-      lod--
-    }
-  }
-
-  return { lodPlanes, sizeLods, sigmas }
-}
-
-function _createRenderTarget(width, height, params) {
-  const cubeUVRenderTarget = new WebGLRenderTarget(width, height, params)
-  cubeUVRenderTarget.texture.mapping = CubeUVReflectionMapping
-  cubeUVRenderTarget.texture.name = 'PMREM.cubeUv'
-  cubeUVRenderTarget.scissorTest = true
-  return cubeUVRenderTarget
-}
-
-function _setViewport(target, x, y, width, height) {
-  target.viewport.set(x, y, width, height)
-  target.scissor.set(x, y, width, height)
-}
-
-function _getBlurShader(lodMax, width, height) {
-  const weights = new Float32Array(MAX_SAMPLES)
-  const poleAxis = new Vector3(0, 1, 0)
-  const shaderMaterial = new ShaderMaterial({
-    name: 'SphericalGaussianBlur',
-
-    defines: {
-      n: MAX_SAMPLES,
-      CUBEUV_TEXEL_WIDTH: 1.0 / width,
-      CUBEUV_TEXEL_HEIGHT: 1.0 / height,
-      CUBEUV_MAX_MIP: `${lodMax}.0`
-    },
-
-    uniforms: {
-      envMap: { value: null },
-      samples: { value: 1 },
-      weights: { value: weights },
-      latitudinal: { value: false },
-      dTheta: { value: 0 },
-      mipInt: { value: 0 },
-      poleAxis: { value: poleAxis }
-    },
-
-    vertexShader: _getCommonVertexShader(),
-
-    fragmentShader: /* glsl */ `
-
-			precision mediump float;
-			precision mediump int;
-
-			varying vec3 vOutputDirection;
-
-			uniform sampler2D envMap;
-			uniform int samples;
-			uniform float weights[ n ];
-			uniform bool latitudinal;
-			uniform float dTheta;
-			uniform float mipInt;
-			uniform vec3 poleAxis;
-
-			#define ENVMAP_TYPE_CUBE_UV
-			#include <cube_uv_reflection_fragment>
-
-			vec3 getSample( float theta, vec3 axis ) {
-
-				float cosTheta = cos( theta );
-				// Rodrigues' axis-angle rotation
-				vec3 sampleDirection = vOutputDirection * cosTheta
-					+ cross( axis, vOutputDirection ) * sin( theta )
-					+ axis * dot( axis, vOutputDirection ) * ( 1.0 - cosTheta );
-
-				return bilinearCubeUV( envMap, sampleDirection, mipInt );
-
-			}
-
-			void main() {
-
-				vec3 axis = latitudinal ? poleAxis : cross( poleAxis, vOutputDirection );
-
-				if ( all( equal( axis, vec3( 0.0 ) ) ) ) {
-
-					axis = vec3( vOutputDirection.z, 0.0, - vOutputDirection.x );
-
-				}
-
-				axis = normalize( axis );
-
-				gl_FragColor = vec4( 0.0, 0.0, 0.0, 1.0 );
-				gl_FragColor.rgb += weights[ 0 ] * getSample( 0.0, axis );
-
-				for ( int i = 1; i < n; i++ ) {
-
-					if ( i >= samples ) {
-
-						break;
-
-					}
-
-					float theta = dTheta * float( i );
-					gl_FragColor.rgb += weights[ i ] * getSample( -1.0 * theta, axis );
-					gl_FragColor.rgb += weights[ i ] * getSample( theta, axis );
-
-				}
-
-			}
-		`,
-
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false
-  })
-
-  return shaderMaterial
-}
-
-function _getEquirectMaterial() {
-  return new ShaderMaterial({
-    name: 'EquirectangularToCubeUV',
-
-    uniforms: {
-      envMap: { value: null }
-    },
-
-    vertexShader: _getCommonVertexShader(),
-
-    fragmentShader: /* glsl */ `
-
-			precision mediump float;
-			precision mediump int;
-
-			varying vec3 vOutputDirection;
-
-			uniform sampler2D envMap;
-
-			#include <common>
-
-			void main() {
-
-				vec3 outputDirection = normalize( vOutputDirection );
-				vec2 uv = equirectUv( outputDirection );
-
-				gl_FragColor = vec4( texture2D ( envMap, uv ).rgb, 1.0 );
-
-			}
-		`,
-
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false
-  })
-}
-
-function _getCubemapMaterial() {
-  return new ShaderMaterial({
-    name: 'CubemapToCubeUV',
-
-    uniforms: {
-      envMap: { value: null },
-      flipEnvMap: { value: -1 }
-    },
-
-    vertexShader: _getCommonVertexShader(),
-
-    fragmentShader: /* glsl */ `
-
-			precision mediump float;
-			precision mediump int;
-
-			uniform float flipEnvMap;
-
-			varying vec3 vOutputDirection;
-
-			uniform samplerCube envMap;
-
-			void main() {
-
-				gl_FragColor = textureCube( envMap, vec3( flipEnvMap * vOutputDirection.x, vOutputDirection.yz ) );
-
-			}
-		`,
-
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false
-  })
-}
-
-function _getCommonVertexShader() {
-  return /* glsl */ `
-
-		precision mediump float;
-		precision mediump int;
-
-		attribute float faceIndex;
-
-		varying vec3 vOutputDirection;
-
-		// RH coordinate system; PMREM face-indexing convention
-		vec3 getDirection( vec2 uv, float face ) {
-
-			uv = 2.0 * uv - 1.0;
-
-			vec3 direction = vec3( uv, 1.0 );
-
-			if ( face == 0.0 ) {
-
-				direction = direction.zyx; // ( 1, v, u ) pos x
-
-			} else if ( face == 1.0 ) {
-
-				direction = direction.xzy;
-				direction.xz *= -1.0; // ( -u, 1, -v ) pos y
-
-			} else if ( face == 2.0 ) {
-
-				direction.x *= -1.0; // ( -u, v, 1 ) pos z
-
-			} else if ( face == 3.0 ) {
-
-				direction = direction.zyx;
-				direction.xz *= -1.0; // ( -1, v, -u ) neg x
-
-			} else if ( face == 4.0 ) {
-
-				direction = direction.xzy;
-				direction.xy *= -1.0; // ( -u, -1, v ) neg y
-
-			} else if ( face == 5.0 ) {
-
-				direction.z *= -1.0; // ( u, v, -1 ) neg z
-
-			}
-
-			return direction;
-
-		}
-
-		void main() {
-
-			vOutputDirection = getDirection( uv, faceIndex );
-			gl_Position = vec4( position, 1.0 );
-
-		}
-	`
-}
-
-export {PMREMGenerator};
diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index 69e78c3..7b2eb6a 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -99,7 +99,6 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap,
     for (const target of controllers) {
       if (target.controllerModel) {
         target.controllerModel.xrControllerModel.setEnvironmentMap(envMap, envMapIntensity)
-        console.log('updated environment map')
       }
     }
   }, [envMap, envMapIntensity, controllers])

From 254dd08c663814b4c1473f7d325f574784b71c43 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 11 Jul 2023 14:59:04 +0300
Subject: [PATCH 04/18] wip

---
 src/Controllers.tsx             | 38 +++++++++++++++-----------
 src/XRController.tsx            | 47 +++++++--------------------------
 src/XRControllerModelFactory.ts | 21 +++------------
 3 files changed, 35 insertions(+), 71 deletions(-)

diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index 7b2eb6a..ab55d17 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -2,9 +2,8 @@ import * as React from 'react'
 import * as THREE from 'three'
 import { useFrame, Object3DNode, extend, createPortal } from '@react-three/fiber'
 import { useXR } from './XR'
-import { ControllerModel, XRController } from './XRController'
-import { useIsomorphicLayoutEffect } from './utils'
-import { XRControllerModelFactory } from './XRControllerModelFactory'
+import { XRController } from './XRController'
+import { XRControllerModel, XRControllerModelFactory } from './XRControllerModelFactory'
 import { useCallback, useEffect } from 'react'
 import { Texture } from 'three'
 
@@ -26,6 +25,10 @@ export const Ray = React.forwardRef<THREE.Line, RayProps>(function Ray({ target,
 
   // Show ray line when hovering objects
   useFrame(() => {
+    if (!target.inputSource) {
+      return
+    }
+
     let rayLength = 1
 
     const intersection: THREE.Intersection = hoverState[target.inputSource.handedness].values().next().value
@@ -51,7 +54,7 @@ const modelFactory = new XRControllerModelFactory()
 declare global {
   namespace JSX {
     interface IntrinsicElements {
-      controllerModel: Object3DNode<ControllerModel, typeof ControllerModel>
+      xRControllerModel: Object3DNode<XRControllerModel, typeof XRControllerModel>
     }
   }
 }
@@ -79,17 +82,20 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap,
       ),
     [JSON.stringify(rayMaterial)] // eslint-disable-line react-hooks/exhaustive-deps
   )
-  React.useMemo(() => extend({ ControllerModel }), [])
+  React.useMemo(() => extend({ XRControllerModel }), [])
 
-  // Send fake connected event (no-op) so models start loading
-  useIsomorphicLayoutEffect(() => {
-    for (const target of controllers) {
-      target.controller.dispatchEvent({ type: 'connected', data: target.inputSource, fake: true })
+  const handleControllerModel = useCallback((xrControllerModel: XRControllerModel | null, target: XRController) => {
+    if (xrControllerModel) {
+      target.xrControllerModel = xrControllerModel
+      if (target.inputSource) {
+        modelFactory.initializeControllerModel(xrControllerModel, target.inputSource)
+      } else {
+        console.warn('no input source on XRController when handleControllerModel')
+      }
+    } else {
+      target.xrControllerModel?.disconnect()
+      target.xrControllerModel = null
     }
-  }, [controllers])
-
-  const handleControllerModel = useCallback((r: ControllerModel | null, target: XRController) => {
-    target.controllerModel = r
   }, [])
 
   useEffect(() => {
@@ -97,8 +103,8 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap,
       return
     }
     for (const target of controllers) {
-      if (target.controllerModel) {
-        target.controllerModel.xrControllerModel.setEnvironmentMap(envMap, envMapIntensity)
+      if (target.xrControllerModel) {
+        target.xrControllerModel.setEnvironmentMap(envMap, envMapIntensity)
       }
     }
   }, [envMap, envMapIntensity, controllers])
@@ -107,7 +113,7 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap,
     <>
       {controllers.map((target, i) => (
         <React.Fragment key={i}>
-          {createPortal(<controllerModel ref={(r) => handleControllerModel(r, target)} args={[target, modelFactory]} />, target.grip)}
+          {createPortal(<xRControllerModel ref={(r) => handleControllerModel(r, target)} args={[]} />, target.grip)}
           {createPortal(
             <Ray visible={!isHandTracking} hideOnBlur={hideRaysOnBlur} target={target} {...rayMaterialProps} />,
             target.controller
diff --git a/src/XRController.tsx b/src/XRController.tsx
index 8d9b06d..df1835c 100644
--- a/src/XRController.tsx
+++ b/src/XRController.tsx
@@ -1,48 +1,17 @@
 import * as THREE from 'three'
 import { XRControllerEvent } from './XREvents'
-import {XRControllerModel, XRControllerModelFactory} from "./XRControllerModelFactory";
-
-
-export class ControllerModel extends THREE.Group {
-  readonly target: XRController
-  readonly xrControllerModel: XRControllerModel
-  private modelFactory: XRControllerModelFactory;
-
-  constructor(target: XRController, modelFactory: XRControllerModelFactory) {
-    super()
-    this.xrControllerModel = new XRControllerModel()
-    this.target = target
-    this.modelFactory = modelFactory
-    this.add(this.xrControllerModel)
-
-    this._onConnected = this._onConnected.bind(this)
-    this._onDisconnected = this._onDisconnected.bind(this)
-
-    this.target.controller.addEventListener('connected', this._onConnected)
-    this.target.controller.addEventListener('disconnected', this._onDisconnected)
-  }
-
-  private _onConnected(event: XRControllerEvent) {
-    this.modelFactory.initializeControllerModel(this.xrControllerModel, event)
-  }
-
-  private _onDisconnected(_event: XRControllerEvent) {
-    this.xrControllerModel.disconnect()
-  }
-
-  dispose() {
-    this.target.controller.removeEventListener('connected', this._onConnected)
-    this.target.controller.removeEventListener('disconnected', this._onDisconnected)
-  }
-}
+import { XRControllerModel } from './XRControllerModelFactory'
 
+/** Counterpart of WebXRController from three ks
+ * in a sense that it's long living */
 export class XRController extends THREE.Group {
   readonly index: number
+  // TODO rename it?
   readonly controller: THREE.XRTargetRaySpace
   readonly grip: THREE.XRGripSpace
   readonly hand: THREE.XRHandSpace
-  public inputSource!: XRInputSource
-  public controllerModel: ControllerModel | null = null;
+  public inputSource: XRInputSource | null = null
+  public xrControllerModel: XRControllerModel | null = null
 
   constructor(index: number, gl: THREE.WebGLRenderer) {
     super()
@@ -57,6 +26,7 @@ export class XRController extends THREE.Group {
     this.hand.userData.name = 'hand'
 
     this.visible = false
+    // TODO is this needed?
     this.add(this.controller, this.grip, this.hand)
 
     this._onConnected = this._onConnected.bind(this)
@@ -68,9 +38,10 @@ export class XRController extends THREE.Group {
 
   _onConnected(event: XRControllerEvent) {
     if (event.fake) return
+    if (!event.data) return
 
     this.visible = true
-    this.inputSource = event.data!
+    this.inputSource = event.data
     this.dispatchEvent(event)
   }
 
diff --git a/src/XRControllerModelFactory.ts b/src/XRControllerModelFactory.ts
index ef48299..6dd08fe 100644
--- a/src/XRControllerModelFactory.ts
+++ b/src/XRControllerModelFactory.ts
@@ -1,12 +1,4 @@
-import {
-  Mesh,
-  Object3D,
-  SphereGeometry,
-  MeshBasicMaterial,
-  MeshStandardMaterial,
-  MeshPhongMaterial,
-  MeshLambertMaterial
-} from 'three'
+import { Mesh, Object3D, SphereGeometry, MeshBasicMaterial, MeshStandardMaterial, MeshPhongMaterial, MeshLambertMaterial, Group } from 'three'
 import type { Texture } from 'three'
 import { fetchProfile, GLTFLoader, MotionController, MotionControllerConstants } from 'three-stdlib'
 
@@ -27,7 +19,7 @@ const applyEnvironmentMap = (envMap: Texture, envMapIntensity: number, obj: Obje
   })
 }
 
-export class XRControllerModel extends Object3D {
+export class XRControllerModel extends Group {
   envMap: Texture | null
   envMapIntensity: number
   motionController: MotionController | null
@@ -60,16 +52,12 @@ export class XRControllerModel extends Object3D {
       return
     }
 
-
-
     this.scene = scene
     addAssetSceneToControllerModel(this, scene)
     this.dispatchEvent({
       type: 'modelconnected',
       data: scene
     })
-
-    console.log('model connected')
   }
 
   connectMotionController(motionController: MotionController): void {
@@ -217,9 +205,8 @@ export class XRControllerModelFactory {
     this._assetCache = {}
   }
 
-  initializeControllerModel(controllerModel: XRControllerModel, event: any): void {
-    const xrInputSource = event.data
-
+  initializeControllerModel(controllerModel: XRControllerModel, xrInputSource: XRInputSource): void {
+    // TODO check gamepad in other condition
     if (xrInputSource.targetRayMode !== 'tracked-pointer' || !xrInputSource.gamepad) return
 
     fetchProfile(xrInputSource, this.path, DEFAULT_PROFILE)

From 0327bd8c2dc55db8a9513848cda94864738859be Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 11 Jul 2023 15:03:56 +0300
Subject: [PATCH 05/18] fix

---
 src/Controllers.tsx | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index f654d98..4cb5b44 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -87,12 +87,18 @@ export function Controllers({ rayMaterial = {}, hideRaysOnBlur = false, envMap,
   const handleControllerModel = useCallback((xrControllerModel: XRControllerModel | null, target: XRController) => {
     if (xrControllerModel) {
       target.xrControllerModel = xrControllerModel
-      if (target.inputSource && !!target.inputSource.hand) {
+      if (target.inputSource?.hand) {
+        return
+      }
+      if (target.inputSource) {
         modelFactory.initializeControllerModel(xrControllerModel, target.inputSource)
       } else {
         console.warn('no input source on XRController when handleControllerModel')
       }
     } else {
+      if (target.inputSource?.hand) {
+        return
+      }
       target.xrControllerModel?.disconnect()
       target.xrControllerModel = null
     }

From 9d57937d746da9bdf24e9c763cf7610f54c8db8c Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 11 Jul 2023 15:04:37 +0300
Subject: [PATCH 06/18] fix

---
 vitest.config.ts | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/vitest.config.ts b/vitest.config.ts
index 4afcd13..7d45fd8 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -1,8 +1,7 @@
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
-
   test: {
     environment: 'happy-dom'
-  },
-})
\ No newline at end of file
+  }
+})

From 004fce2ddcc9f952bbb0d47aad06c9dd537b79d4 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 11 Jul 2023 15:08:53 +0300
Subject: [PATCH 07/18] ts fixes

---
 src/Interactions.tsx          | 6 ++++++
 src/Teleportation.tsx         | 2 +-
 src/XR.tsx                    | 2 +-
 src/XRController.tsx          | 1 +
 src/XREvents.ts               | 2 +-
 src/mocks/XRControllerMock.ts | 5 ++++-
 6 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/src/Interactions.tsx b/src/Interactions.tsx
index 2265fc4..11ce5a3 100644
--- a/src/Interactions.tsx
+++ b/src/Interactions.tsx
@@ -56,6 +56,9 @@ export function InteractionManager({ children }: { children: React.ReactNode })
     if (interactions.size === 0) return
 
     for (const target of controllers) {
+      if (!target.inputSource?.handedness) {
+        return
+      }
       const hovering = hoverState[target.inputSource.handedness]
       const hits = new Set()
       let intersections = intersect(target.controller)
@@ -109,6 +112,9 @@ export function InteractionManager({ children }: { children: React.ReactNode })
 
   const triggerEvent = React.useCallback(
     (interaction: XRInteractionType) => (e: XREvent<XRControllerEvent>) => {
+      if (!e.target.inputSource?.handedness) {
+        return
+      }
       const hovering = hoverState[e.target.inputSource.handedness]
       const intersections = Array.from(new Set(hovering.values()))
 
diff --git a/src/Teleportation.tsx b/src/Teleportation.tsx
index dbb02a0..38d4e0c 100644
--- a/src/Teleportation.tsx
+++ b/src/Teleportation.tsx
@@ -73,7 +73,7 @@ export const TeleportationPlane = React.forwardRef<THREE.Group, TeleportationPla
 
   const isInteractive = React.useCallback(
     (e: XRInteractionEvent): boolean => {
-      const { handedness } = e.target.inputSource
+      const handedness = e.target.inputSource?.handedness
       return !!((handedness !== 'left' || leftHand) && (handedness !== 'right' || rightHand))
     },
     [leftHand, rightHand]
diff --git a/src/XR.tsx b/src/XR.tsx
index 2e0991b..ee59cdc 100644
--- a/src/XR.tsx
+++ b/src/XR.tsx
@@ -476,7 +476,7 @@ export function useXR<T = XRState>(
 export function useController(handedness: XRHandedness) {
   const controllers = useXR((state) => state.controllers)
   const controller = React.useMemo(
-    () => controllers.find(({ inputSource }) => inputSource.handedness === handedness),
+    () => controllers.find(({ inputSource }) => inputSource?.handedness && inputSource.handedness === handedness),
     [handedness, controllers]
   )
 
diff --git a/src/XRController.tsx b/src/XRController.tsx
index df1835c..c988b15 100644
--- a/src/XRController.tsx
+++ b/src/XRController.tsx
@@ -49,6 +49,7 @@ export class XRController extends THREE.Group {
     if (event.fake) return
 
     this.visible = false
+    this.inputSource = null
     this.dispatchEvent(event)
   }
 
diff --git a/src/XREvents.ts b/src/XREvents.ts
index 61418d9..f9cd7d3 100644
--- a/src/XREvents.ts
+++ b/src/XREvents.ts
@@ -30,7 +30,7 @@ export function useXREvent(event: XRControllerEventType, handler: XREventHandler
 
   useIsomorphicLayoutEffect(() => {
     const listeners = controllers.map((target) => {
-      if (handedness && target.inputSource.handedness !== handedness) return
+      if (handedness && target.inputSource && target.inputSource.handedness !== handedness) return
 
       const listener = (nativeEvent: XRControllerEvent) => handlerRef.current({ nativeEvent, target })
       target.controller.addEventListener(event, listener)
diff --git a/src/mocks/XRControllerMock.ts b/src/mocks/XRControllerMock.ts
index 36e21a6..4ffdac8 100644
--- a/src/mocks/XRControllerMock.ts
+++ b/src/mocks/XRControllerMock.ts
@@ -1,4 +1,4 @@
-import { XRController, XRControllerEvent } from '@react-three/xr'
+import { XRController, XRControllerEvent, XRControllerModel } from '@react-three/xr'
 import { Group, XRTargetRaySpace, XRGripSpace, XRHandSpace, Vector3, XRHandInputState, XRHandJoints } from 'three'
 
 export class XRTargetRaySpaceMock extends Group implements XRTargetRaySpace {
@@ -29,6 +29,9 @@ export class XRControllerMock extends Group implements XRController {
   // TODO Implement mocks for inputSource
   // @ts-ignore
   inputSource: XRInputSource
+  // TODO Implement mocks for xrControllerModel
+  // @ts-ignore
+  public xrControllerModel: XRControllerModel | null
 
   constructor(index: number) {
     super()

From c715086da32c6a810aab8e0983d32fdd950f6a0a Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:13:47 +0300
Subject: [PATCH 08/18] wip

---
 examples/src/demos/ControllersEnvMap.tsx |  8 ++++----
 src/Controllers.tsx                      | 22 +++++++++++++++-------
 2 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/examples/src/demos/ControllersEnvMap.tsx b/examples/src/demos/ControllersEnvMap.tsx
index 35ff313..34a10e3 100644
--- a/examples/src/demos/ControllersEnvMap.tsx
+++ b/examples/src/demos/ControllersEnvMap.tsx
@@ -8,8 +8,9 @@ import EnvMap from '../assets/brown_photostudio_04_256.hdr'
 function ControllersWithEnvMap() {
   const renderer = useThree(({ gl }) => gl)
   const [envMap, setEnvMap] = useState<Texture>()
+
   useEffect(() => {
-    const foo = async () => {
+    const generateEnvMap = async () => {
       const rgbeLoader = new RGBELoader()
       const dataTexture = await rgbeLoader.loadAsync(EnvMap)
       const pmremGenerator = new PMREMGenerator(renderer)
@@ -19,7 +20,8 @@ function ControllersWithEnvMap() {
       setEnvMap(radianceMap)
       pmremGenerator.dispose()
     }
-    foo()
+
+    generateEnvMap()
   }, [renderer])
 
   return <Controllers envMap={envMap} envMapIntensity={1} />
@@ -31,8 +33,6 @@ export default function () {
       <VRButton onError={(e) => console.error(e)} />
       <Canvas>
         <XR>
-          {/*<ambientLight intensity={0.5} />*/}
-          {/*<pointLight position={[5, 5, 5]} />*/}
           <ControllersWithEnvMap />
         </XR>
       </Canvas>
diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index 403bbc5..4a97c9a 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -5,6 +5,7 @@ import { useXR } from './XR'
 import { XRController } from './XRController'
 import { XRControllerModelFactory } from './XRControllerModelFactory'
 import { XRControllerModel } from './XRControllerModel'
+import { useCallbackRef } from './utils'
 
 export interface RayProps extends Partial<JSX.IntrinsicElements['object3D']> {
   /** The XRController to attach the ray to */
@@ -77,12 +78,19 @@ const ControllerModel = ({
   envMapIntensity?: number
 }) => {
   const xrControllerModelRef = React.useRef<XRControllerModel | null>(null)
-  
+  const setEnvironmentMapRef = useCallbackRef((xrControllerModel: XRControllerModel) => xrControllerModel.setEnvironmentMap(envMap ?? null))
+  const setEnvironmentMapIntensityRef = useCallbackRef((xrControllerModel: XRControllerModel) => {
+    if (envMapIntensity == null) return
+    xrControllerModel.setEnvironmentMapIntensity(envMapIntensity)
+  })
+
   const handleControllerModel = React.useCallback(
     (xrControllerModel: XRControllerModel | null) => {
       xrControllerModelRef.current = xrControllerModel
       if (xrControllerModel) {
         target.xrControllerModel = xrControllerModel
+        setEnvironmentMapRef.current(xrControllerModel)
+        setEnvironmentMapIntensityRef.current(xrControllerModel)
         if (target.inputSource?.hand) {
           return
         }
@@ -99,20 +107,20 @@ const ControllerModel = ({
         target.xrControllerModel = null
       }
     },
-    [target]
+    [setEnvironmentMapIntensityRef, setEnvironmentMapRef, target]
   )
 
   React.useLayoutEffect(() => {
     if (xrControllerModelRef.current) {
-      xrControllerModelRef.current.setEnvironmentMap(envMap ?? null)
+      setEnvironmentMapRef.current(xrControllerModelRef.current)
     }
-  }, [envMap])
+  }, [envMap, setEnvironmentMapRef])
 
   React.useLayoutEffect(() => {
-    if (xrControllerModelRef.current && envMapIntensity != null) {
-      xrControllerModelRef.current.setEnvironmentMapIntensity(envMapIntensity)
+    if (xrControllerModelRef.current) {
+      setEnvironmentMapIntensityRef.current(xrControllerModelRef.current)
     }
-  }, [envMapIntensity])
+  }, [envMapIntensity, setEnvironmentMapIntensityRef])
 
   return <xRControllerModel ref={handleControllerModel} />
 }

From c5b8406f3ea887ebeba9a2d9522585d84270d2cb Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:14:53 +0300
Subject: [PATCH 09/18] wip

---
 src/XRController.ts | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/XRController.ts b/src/XRController.ts
index 0ed0013..ec6b18e 100644
--- a/src/XRController.ts
+++ b/src/XRController.ts
@@ -6,7 +6,6 @@ import { XRControllerModel } from './XRControllerModel'
  * in a sense that it's long living */
 export class XRController extends THREE.Group {
   readonly index: number
-  // TODO rename it?
   readonly controller: THREE.XRTargetRaySpace
   readonly grip: THREE.XRGripSpace
   readonly hand: THREE.XRHandSpace
@@ -26,7 +25,6 @@ export class XRController extends THREE.Group {
     this.hand.userData.name = 'hand'
 
     this.visible = false
-    // TODO is this needed?
     this.add(this.controller, this.grip, this.hand)
 
     this._onConnected = this._onConnected.bind(this)

From 11389d4b355e93bbf420dc931ed75eccd9db5b78 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:27:51 +0300
Subject: [PATCH 10/18] wip

---
 src/XRControllerModel.test.ts      | 76 ++++++++++++++++++++++++++++--
 src/XRControllerModel.ts           |  7 +--
 src/mocks/XRControllerModelMock.ts |  5 +-
 3 files changed, 81 insertions(+), 7 deletions(-)

diff --git a/src/XRControllerModel.test.ts b/src/XRControllerModel.test.ts
index f92ac95..ea2b502 100644
--- a/src/XRControllerModel.test.ts
+++ b/src/XRControllerModel.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect, vi } from 'vitest'
 import { XRControllerModel } from './XRControllerModel'
-import { Object3D, Texture } from 'three'
+import { BoxBufferGeometry, Mesh, MeshStandardMaterial, Object3D, Texture } from 'three'
 import { MotionControllerMock } from './mocks/MotionControllerMock'
 
 describe('XRControllerModel', () => {
@@ -35,18 +35,88 @@ describe('XRControllerModel', () => {
     expect(xrControllerModel.children).toContain(sceneMock)
   })
 
-  it('should set and apply environment map when setEnvironment map is called', () => {
+  it('should set and apply environment map when setEnvironment map is called after scene is loaded', () => {
     const xrControllerModel = new XRControllerModel()
     const motionControllerMock = new MotionControllerMock()
     const sceneMock = new Object3D()
+    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+    sceneMock.add(mesh)
+    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
     const envMapMock = new Texture()
 
     xrControllerModel.connectMotionController(motionControllerMock)
     xrControllerModel.connectModel(sceneMock)
-    xrControllerModel.setEnvironmentMap(envMapMock, 0.5)
+    xrControllerModel.setEnvironmentMap(envMapMock)
+    xrControllerModel.setEnvironmentMapIntensity(0.5)
 
     expect(xrControllerModel.envMap).toBe(envMapMock)
     expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+    expect(mesh.material.envMap).toBe(envMapMock)
+    expect(mesh.material.envMapIntensity).toBe(0.5)
+    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+  })
+
+
+  it('should set and apply environment map when setEnvironment map is called before scene is loaded', () => {
+    const xrControllerModel = new XRControllerModel()
+    const motionControllerMock = new MotionControllerMock()
+    const sceneMock = new Object3D()
+    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+    sceneMock.add(mesh)
+    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+    const envMapMock = new Texture()
+
+    xrControllerModel.connectMotionController(motionControllerMock)
+    xrControllerModel.setEnvironmentMap(envMapMock)
+    xrControllerModel.setEnvironmentMapIntensity(0.5)
+    xrControllerModel.connectModel(sceneMock)
+
+    expect(xrControllerModel.envMap).toBe(envMapMock)
+    expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+    expect(mesh.material.envMap).toBe(envMapMock)
+    expect(mesh.material.envMapIntensity).toBe(0.5)
+    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+  })
+
+  it('should set environment map intensity when setEnvironment map is called before scene is loaded', () => {
+    const xrControllerModel = new XRControllerModel()
+    const motionControllerMock = new MotionControllerMock()
+    const sceneMock = new Object3D()
+    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+    sceneMock.add(mesh)
+    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+
+    xrControllerModel.connectMotionController(motionControllerMock)
+    xrControllerModel.setEnvironmentMapIntensity(0.5)
+    xrControllerModel.connectModel(sceneMock)
+
+    expect(xrControllerModel.envMap).toBe(null)
+    expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+    expect(mesh.material.envMap).toBe(null)
+    expect(mesh.material.envMapIntensity).toBe(0.5)
+    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+  })
+
+  it('should remove environment map when setEnvironment map is called with null', () => {
+    const xrControllerModel = new XRControllerModel()
+    const motionControllerMock = new MotionControllerMock()
+    const sceneMock = new Object3D()
+    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+    sceneMock.add(mesh)
+    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+    const envMapMock = new Texture()
+
+    xrControllerModel.connectMotionController(motionControllerMock)
+    xrControllerModel.connectModel(sceneMock)
+    xrControllerModel.setEnvironmentMap(envMapMock)
+    xrControllerModel.setEnvironmentMap(null)
+
+    expect(xrControllerModel.envMap).toBe(null)
+    expect(mesh.material.envMap).toBe(null)
+    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
   })
 
   it('should update motioncontroller from gamepad on updateMatrixWorld', () => {
diff --git a/src/XRControllerModel.ts b/src/XRControllerModel.ts
index 5d34871..c0031be 100644
--- a/src/XRControllerModel.ts
+++ b/src/XRControllerModel.ts
@@ -93,9 +93,10 @@ function addAssetSceneToControllerModel(controllerModel: XRControllerModel, scen
   // Apply any environment map that the mesh already has set.
   if (controllerModel.envMap) {
     applyEnvironmentMap(controllerModel.envMap, scene)
-    if (controllerModel.envMapIntensity != null) {
-      applyEnvironmentMapIntensity(controllerModel.envMapIntensity, scene)
-    }
+  }
+
+  if (controllerModel.envMapIntensity != null) {
+    applyEnvironmentMapIntensity(controllerModel.envMapIntensity, scene)
   }
 
   // Add the glTF scene to the controllerModel.
diff --git a/src/mocks/XRControllerModelMock.ts b/src/mocks/XRControllerModelMock.ts
index e555457..364fee5 100644
--- a/src/mocks/XRControllerModelMock.ts
+++ b/src/mocks/XRControllerModelMock.ts
@@ -8,7 +8,10 @@ export class XRControllerModelMock extends Group implements XRControllerModel {
   envMapIntensity = 1
   motionController: MotionController | null = null
   scene: Object3D<Event> | null = null
-  setEnvironmentMap(_envMap: Texture, _envMapIntensity?: number): XRControllerModel {
+  setEnvironmentMap(_envMap: Texture): XRControllerModel {
+    throw new Error('Method not implemented.')
+  }
+  setEnvironmentMapIntensity( _envMapIntensity?: number): XRControllerModel {
     throw new Error('Method not implemented.')
   }
   connectModel = vi.fn<[scene: Object3D<Event>], void>()

From be8ae887ef4ed36a12f480fa066d606866184b95 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:43:24 +0300
Subject: [PATCH 11/18] tests

---
 src/Controllers.test.tsx | 56 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/src/Controllers.test.tsx b/src/Controllers.test.tsx
index c567ecf..9ad6c39 100644
--- a/src/Controllers.test.tsx
+++ b/src/Controllers.test.tsx
@@ -8,6 +8,7 @@ import { XRControllerModel } from './XRControllerModel'
 import { XRControllerModelFactoryMock } from './mocks/XRControllerModelFactoryMock'
 import { XRInputSourceMock } from './mocks/XRInputSourceMock'
 import { act } from '@react-three/test-renderer'
+import { Texture } from 'three'
 
 vi.mock('./XRControllerModelFactory', async () => {
   const { XRControllerModelFactoryMock } = await vi.importActual<typeof import('./mocks/XRControllerModelFactoryMock')>(
@@ -141,4 +142,59 @@ describe('Controllers', () => {
     expect(disconnectSpy).not.toBeCalled()
     expect(xrControllerModelFactory?.initializeControllerModel).toBeCalledTimes(1)
   })
+
+  describe('envMap', () => {
+    it("should not set env map if it's not provided in props", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+
+      await render(<Controllers />, { wrapper: createStoreProvider(store) })
+
+      const xrControllerModel = xrControllerMock.xrControllerModel
+
+      expect(xrControllerModel!.envMap).toBeNull()
+      expect(xrControllerModel!.envMapIntensity).toBe(1)
+    })
+
+    it("should set env map if it's provided in props", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+      const envMap = new Texture()
+
+      await render(<Controllers envMap={envMap} />, { wrapper: createStoreProvider(store) })
+
+      const xrControllerModel = xrControllerMock.xrControllerModel
+
+      expect(xrControllerModel!.envMap).toBe(envMap)
+      expect(xrControllerModel!.envMapIntensity).toBe(1)
+    })
+
+    it("should only set env map intensity if it's provided in props", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+
+      await render(<Controllers envMapIntensity={0.5} />, { wrapper: createStoreProvider(store) })
+
+      const xrControllerModel = xrControllerMock.xrControllerModel
+
+      expect(xrControllerModel!.envMap).toBeNull()
+      expect(xrControllerModel!.envMapIntensity).toBe(0.5)
+    })
+
+    it("should remove env map if it's provided in props first, and then removed", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+      const envMap = new Texture()
+
+      const { rerender } = await render(<Controllers envMap={envMap} />, { wrapper: createStoreProvider(store) })
+      const xrControllerModel = xrControllerMock.xrControllerModel
+      await rerender(<Controllers />)
+
+      expect(xrControllerModel!.envMap).toBeNull()
+    })
+  })
 })

From 3270c36d5ef9eb579a2337c32310623e69251795 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:47:10 +0300
Subject: [PATCH 12/18] docs

---
 src/Controllers.tsx | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index 4a97c9a..c9c0310 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -64,7 +64,16 @@ export interface ControllersProps {
   rayMaterial?: JSX.IntrinsicElements['meshBasicMaterial']
   /** Whether to hide controllers' rays on blur. Default is `false` */
   hideRaysOnBlur?: boolean
+  /**
+   * Optional environment map to apply to controllers' models
+   * Useful for make controllers look more realistic
+   * if you don't want to apply env map globally on a scene
+   */
   envMap?: THREE.Texture
+  /**
+   * Optional environment map intensity to apply to controllers' models
+   * Useful for tweaking the env map intensity if they look too bright or too dark
+   */
   envMapIntensity?: number
 }
 

From d781114c4bafe65f3458fc1f133c09f9b81f025f Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:52:15 +0300
Subject: [PATCH 13/18] docs

---
 README.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 51ce446..8df624e 100644
--- a/README.md
+++ b/README.md
@@ -160,6 +160,10 @@ Controllers can be added with `<Controllers />` for [motion-controllers](https:/
 />
 ```
 
+### Environment map
+
+You can set environment map and/or it's intensity on controller models via props on `<Controllers />`. See [ControllerEnvMap](./examples/src/demos/ControllersEnvMap.tsx) to find out how to do it.
+
 ### useController
 
 `useController` references an `XRController` by handedness, exposing position and orientation info.
@@ -172,14 +176,15 @@ const gazeController = useController('none')
 
 ### XRController
 
-`XRController` is an `Object3D` that represents an [`XRInputSource`](https://developer.mozilla.org/en-US/docs/Web/API/XRInputSource) with the following properties:
+`XRController` is an long-living `Object3D` that represents an [`XRInputSource`](https://developer.mozilla.org/en-US/docs/Web/API/XRInputSource) with the following properties:
 
 ```jsx
 index: number
 controller: THREE.XRTargetRaySpace
 grip: THREE.XRGripSpace
 hand: THREE.XRHandSpace
-inputSource: XRInputSource
+inputSource: XRInputSource | null
+xrControllerModel: XRControllerModel
 ```
 
 ## Interactions

From 7eff42ec17d019b75aca3b2338c5e56f3d45a934 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:53:34 +0300
Subject: [PATCH 14/18] fix docs types

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8df624e..088e480 100644
--- a/README.md
+++ b/README.md
@@ -184,7 +184,7 @@ controller: THREE.XRTargetRaySpace
 grip: THREE.XRGripSpace
 hand: THREE.XRHandSpace
 inputSource: XRInputSource | null
-xrControllerModel: XRControllerModel
+xrControllerModel: XRControllerModel | null
 ```
 
 ## Interactions

From 73370f1e6fa373f550066d56f042f3f814c109e6 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:56:19 +0300
Subject: [PATCH 15/18] tests

---
 src/Controllers.test.tsx | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/Controllers.test.tsx b/src/Controllers.test.tsx
index 9ad6c39..c85e9f4 100644
--- a/src/Controllers.test.tsx
+++ b/src/Controllers.test.tsx
@@ -184,6 +184,19 @@ describe('Controllers', () => {
       expect(xrControllerModel!.envMapIntensity).toBe(0.5)
     })
 
+    it("should change env map intensity if it's provided in props then updated to a different value", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+
+      const { rerender } = await render(<Controllers envMapIntensity={0.5} />, { wrapper: createStoreProvider(store) })
+      const xrControllerModel = xrControllerMock.xrControllerModel
+      await rerender(<Controllers envMapIntensity={0.6} />)
+
+      expect(xrControllerModel!.envMap).toBeNull()
+      expect(xrControllerModel!.envMapIntensity).toBe(0.6)
+    })
+
     it("should remove env map if it's provided in props first, and then removed", async () => {
       const store = createStoreMock()
       const xrControllerMock = new XRControllerMock(0)

From dbcf95595adea1913552cca8b189b8c50413541f Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Tue, 29 Aug 2023 12:58:09 +0300
Subject: [PATCH 16/18] test refactoring

---
 src/XRControllerModel.test.ts | 159 +++++++++++++++++-----------------
 1 file changed, 80 insertions(+), 79 deletions(-)

diff --git a/src/XRControllerModel.test.ts b/src/XRControllerModel.test.ts
index ea2b502..181c776 100644
--- a/src/XRControllerModel.test.ts
+++ b/src/XRControllerModel.test.ts
@@ -35,97 +35,98 @@ describe('XRControllerModel', () => {
     expect(xrControllerModel.children).toContain(sceneMock)
   })
 
-  it('should set and apply environment map when setEnvironment map is called after scene is loaded', () => {
-    const xrControllerModel = new XRControllerModel()
-    const motionControllerMock = new MotionControllerMock()
-    const sceneMock = new Object3D()
-    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
-    sceneMock.add(mesh)
-    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
-    const envMapMock = new Texture()
-
-    xrControllerModel.connectMotionController(motionControllerMock)
-    xrControllerModel.connectModel(sceneMock)
-    xrControllerModel.setEnvironmentMap(envMapMock)
-    xrControllerModel.setEnvironmentMapIntensity(0.5)
-
-    expect(xrControllerModel.envMap).toBe(envMapMock)
-    expect(xrControllerModel.envMapIntensity).toBe(0.5)
-
-    expect(mesh.material.envMap).toBe(envMapMock)
-    expect(mesh.material.envMapIntensity).toBe(0.5)
-    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
-  })
-
-
-  it('should set and apply environment map when setEnvironment map is called before scene is loaded', () => {
+  it('should update motioncontroller from gamepad on updateMatrixWorld', () => {
     const xrControllerModel = new XRControllerModel()
     const motionControllerMock = new MotionControllerMock()
-    const sceneMock = new Object3D()
-    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
-    sceneMock.add(mesh)
-    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
-    const envMapMock = new Texture()
 
     xrControllerModel.connectMotionController(motionControllerMock)
-    xrControllerModel.setEnvironmentMap(envMapMock)
-    xrControllerModel.setEnvironmentMapIntensity(0.5)
-    xrControllerModel.connectModel(sceneMock)
-
-    expect(xrControllerModel.envMap).toBe(envMapMock)
-    expect(xrControllerModel.envMapIntensity).toBe(0.5)
+    xrControllerModel.updateMatrixWorld(false)
 
-    expect(mesh.material.envMap).toBe(envMapMock)
-    expect(mesh.material.envMapIntensity).toBe(0.5)
-    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    expect(xrControllerModel.motionController?.updateFromGamepad).toBeCalled()
   })
 
-  it('should set environment map intensity when setEnvironment map is called before scene is loaded', () => {
-    const xrControllerModel = new XRControllerModel()
-    const motionControllerMock = new MotionControllerMock()
-    const sceneMock = new Object3D()
-    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
-    sceneMock.add(mesh)
-    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
-
-    xrControllerModel.connectMotionController(motionControllerMock)
-    xrControllerModel.setEnvironmentMapIntensity(0.5)
-    xrControllerModel.connectModel(sceneMock)
+  describe('envMap', () => {
+    it('should set and apply environment map when setEnvironment map is called after scene is loaded', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+      sceneMock.add(mesh)
+      const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+      const envMapMock = new Texture()
+
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.connectModel(sceneMock)
+      xrControllerModel.setEnvironmentMap(envMapMock)
+      xrControllerModel.setEnvironmentMapIntensity(0.5)
+
+      expect(xrControllerModel.envMap).toBe(envMapMock)
+      expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+      expect(mesh.material.envMap).toBe(envMapMock)
+      expect(mesh.material.envMapIntensity).toBe(0.5)
+      expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    })
 
-    expect(xrControllerModel.envMap).toBe(null)
-    expect(xrControllerModel.envMapIntensity).toBe(0.5)
+    it('should set and apply environment map when setEnvironment map is called before scene is loaded', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+      sceneMock.add(mesh)
+      const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+      const envMapMock = new Texture()
+
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.setEnvironmentMap(envMapMock)
+      xrControllerModel.setEnvironmentMapIntensity(0.5)
+      xrControllerModel.connectModel(sceneMock)
+
+      expect(xrControllerModel.envMap).toBe(envMapMock)
+      expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+      expect(mesh.material.envMap).toBe(envMapMock)
+      expect(mesh.material.envMapIntensity).toBe(0.5)
+      expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    })
 
-    expect(mesh.material.envMap).toBe(null)
-    expect(mesh.material.envMapIntensity).toBe(0.5)
-    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
-  })
+    it('should set environment map intensity when setEnvironment map is called before scene is loaded', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+      sceneMock.add(mesh)
+      const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
 
-  it('should remove environment map when setEnvironment map is called with null', () => {
-    const xrControllerModel = new XRControllerModel()
-    const motionControllerMock = new MotionControllerMock()
-    const sceneMock = new Object3D()
-    const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
-    sceneMock.add(mesh)
-    const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
-    const envMapMock = new Texture()
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.setEnvironmentMapIntensity(0.5)
+      xrControllerModel.connectModel(sceneMock)
 
-    xrControllerModel.connectMotionController(motionControllerMock)
-    xrControllerModel.connectModel(sceneMock)
-    xrControllerModel.setEnvironmentMap(envMapMock)
-    xrControllerModel.setEnvironmentMap(null)
+      expect(xrControllerModel.envMap).toBe(null)
+      expect(xrControllerModel.envMapIntensity).toBe(0.5)
 
-    expect(xrControllerModel.envMap).toBe(null)
-    expect(mesh.material.envMap).toBe(null)
-    expect(materialNeedsUpdateSpy).toBeCalledWith(true)
-  })
-
-  it('should update motioncontroller from gamepad on updateMatrixWorld', () => {
-    const xrControllerModel = new XRControllerModel()
-    const motionControllerMock = new MotionControllerMock()
-
-    xrControllerModel.connectMotionController(motionControllerMock)
-    xrControllerModel.updateMatrixWorld(false)
+      expect(mesh.material.envMap).toBe(null)
+      expect(mesh.material.envMapIntensity).toBe(0.5)
+      expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    })
 
-    expect(xrControllerModel.motionController?.updateFromGamepad).toBeCalled()
+    it('should remove environment map when setEnvironment map is called with null', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+      sceneMock.add(mesh)
+      const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+      const envMapMock = new Texture()
+
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.connectModel(sceneMock)
+      xrControllerModel.setEnvironmentMap(envMapMock)
+      xrControllerModel.setEnvironmentMap(null)
+
+      expect(xrControllerModel.envMap).toBe(null)
+      expect(mesh.material.envMap).toBe(null)
+      expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    })
   })
 })

From 75e4fe3067d0d11d18c6e84383c0e59c92015442 Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Wed, 30 Aug 2023 16:42:06 +0300
Subject: [PATCH 17/18] review

* supported array materials
* returned api of setEnvironmentMap on XRControllerModel
---
 package.json                  |   2 +-
 src/Controllers.test.tsx      |  14 ++
 src/Controllers.tsx           |  22 ++-
 src/XRControllerModel.test.ts |  63 ++++++-
 src/XRControllerModel.ts      |  70 +++++---
 yarn.lock                     | 309 +++++++++++++++++-----------------
 6 files changed, 288 insertions(+), 192 deletions(-)

diff --git a/package.json b/package.json
index 6737bd7..5130bc9 100644
--- a/package.json
+++ b/package.json
@@ -60,7 +60,7 @@
     "three": "^0.141.0",
     "typescript": "^4.5.5",
     "vite": "^3.0.5",
-    "vitest": "^0.29.1"
+    "vitest": "^0.34.3"
   },
   "dependencies": {
     "@types/webxr": "*",
diff --git a/src/Controllers.test.tsx b/src/Controllers.test.tsx
index c85e9f4..25c60be 100644
--- a/src/Controllers.test.tsx
+++ b/src/Controllers.test.tsx
@@ -209,5 +209,19 @@ describe('Controllers', () => {
 
       expect(xrControllerModel!.envMap).toBeNull()
     })
+
+    it("should change env map intensity if it's provided in props then updated to a different value but envMap stays the same", async () => {
+      const store = createStoreMock()
+      const xrControllerMock = new XRControllerMock(0)
+      store.setState({ controllers: [xrControllerMock] })
+      const envMap = new Texture()
+
+      const { rerender } = await render(<Controllers envMap={envMap} envMapIntensity={0.5} />, { wrapper: createStoreProvider(store) })
+      const xrControllerModel = xrControllerMock.xrControllerModel
+      await rerender(<Controllers envMap={envMap} envMapIntensity={0.6} />)
+
+      expect(xrControllerModel!.envMap).toBe(envMap)
+      expect(xrControllerModel!.envMapIntensity).toBe(0.6)
+    })
   })
 })
diff --git a/src/Controllers.tsx b/src/Controllers.tsx
index c9c0310..74a7164 100644
--- a/src/Controllers.tsx
+++ b/src/Controllers.tsx
@@ -87,7 +87,12 @@ const ControllerModel = ({
   envMapIntensity?: number
 }) => {
   const xrControllerModelRef = React.useRef<XRControllerModel | null>(null)
-  const setEnvironmentMapRef = useCallbackRef((xrControllerModel: XRControllerModel) => xrControllerModel.setEnvironmentMap(envMap ?? null))
+  const setEnvironmentMapRef = useCallbackRef((xrControllerModel: XRControllerModel) => {
+    if (envMap == null) return
+    xrControllerModel.setEnvironmentMap(envMap ?? null)
+  })
+  const clearEnvironmentMapRef = useCallbackRef((xrControllerModel: XRControllerModel) => xrControllerModel.setEnvironmentMap(null))
+  
   const setEnvironmentMapIntensityRef = useCallbackRef((xrControllerModel: XRControllerModel) => {
     if (envMapIntensity == null) return
     xrControllerModel.setEnvironmentMapIntensity(envMapIntensity)
@@ -98,11 +103,12 @@ const ControllerModel = ({
       xrControllerModelRef.current = xrControllerModel
       if (xrControllerModel) {
         target.xrControllerModel = xrControllerModel
-        setEnvironmentMapRef.current(xrControllerModel)
-        setEnvironmentMapIntensityRef.current(xrControllerModel)
         if (target.inputSource?.hand) {
           return
         }
+
+        setEnvironmentMapRef.current(xrControllerModel)
+        setEnvironmentMapIntensityRef.current(xrControllerModel)
         if (target.inputSource) {
           modelFactory.initializeControllerModel(xrControllerModel, target.inputSource)
         } else {
@@ -116,14 +122,18 @@ const ControllerModel = ({
         target.xrControllerModel = null
       }
     },
-    [setEnvironmentMapIntensityRef, setEnvironmentMapRef, target]
+    [target, setEnvironmentMapIntensityRef, setEnvironmentMapRef]
   )
 
   React.useLayoutEffect(() => {
     if (xrControllerModelRef.current) {
-      setEnvironmentMapRef.current(xrControllerModelRef.current)
+      if (envMap) {
+        setEnvironmentMapRef.current(xrControllerModelRef.current)
+      } else {
+        clearEnvironmentMapRef.current(xrControllerModelRef.current)
+      }
     }
-  }, [envMap, setEnvironmentMapRef])
+  }, [envMap, setEnvironmentMapRef, clearEnvironmentMapRef])
 
   React.useLayoutEffect(() => {
     if (xrControllerModelRef.current) {
diff --git a/src/XRControllerModel.test.ts b/src/XRControllerModel.test.ts
index 181c776..d7c5ca8 100644
--- a/src/XRControllerModel.test.ts
+++ b/src/XRControllerModel.test.ts
@@ -46,7 +46,7 @@ describe('XRControllerModel', () => {
   })
 
   describe('envMap', () => {
-    it('should set and apply environment map when setEnvironment map is called after scene is loaded', () => {
+    it('should set and apply environment map when setEnvironmentMap is called after scene is loaded', () => {
       const xrControllerModel = new XRControllerModel()
       const motionControllerMock = new MotionControllerMock()
       const sceneMock = new Object3D()
@@ -57,8 +57,7 @@ describe('XRControllerModel', () => {
 
       xrControllerModel.connectMotionController(motionControllerMock)
       xrControllerModel.connectModel(sceneMock)
-      xrControllerModel.setEnvironmentMap(envMapMock)
-      xrControllerModel.setEnvironmentMapIntensity(0.5)
+      xrControllerModel.setEnvironmentMap(envMapMock, 0.5)
 
       expect(xrControllerModel.envMap).toBe(envMapMock)
       expect(xrControllerModel.envMapIntensity).toBe(0.5)
@@ -68,7 +67,7 @@ describe('XRControllerModel', () => {
       expect(materialNeedsUpdateSpy).toBeCalledWith(true)
     })
 
-    it('should set and apply environment map when setEnvironment map is called before scene is loaded', () => {
+    it('should set and apply environment map when setEnvironmentMap is called after scene is loaded', () => {
       const xrControllerModel = new XRControllerModel()
       const motionControllerMock = new MotionControllerMock()
       const sceneMock = new Object3D()
@@ -78,8 +77,56 @@ describe('XRControllerModel', () => {
       const envMapMock = new Texture()
 
       xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.connectModel(sceneMock)
       xrControllerModel.setEnvironmentMap(envMapMock)
-      xrControllerModel.setEnvironmentMapIntensity(0.5)
+
+      expect(xrControllerModel.envMap).toBe(envMapMock)
+      expect(xrControllerModel.envMapIntensity).toBe(1)
+
+      expect(mesh.material.envMap).toBe(envMapMock)
+      expect(mesh.material.envMapIntensity).toBe(1)
+      expect(materialNeedsUpdateSpy).toBeCalledWith(true)
+    })
+
+    it('should set and apply environment map to an array material when setEnvironment map is called', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const material1 = new MeshStandardMaterial()
+      const material2 = new MeshStandardMaterial()
+      const mesh = new Mesh(new BoxBufferGeometry(), [material1, material2])
+      sceneMock.add(mesh)
+      const material1NeedsUpdateSpy = vi.spyOn(material1, 'needsUpdate', 'set')
+      const material2NeedsUpdateSpy = vi.spyOn(material2, 'needsUpdate', 'set')
+      const envMapMock = new Texture()
+
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.connectModel(sceneMock)
+      xrControllerModel.setEnvironmentMap(envMapMock, 0.5)
+
+      expect(xrControllerModel.envMap).toBe(envMapMock)
+      expect(xrControllerModel.envMapIntensity).toBe(0.5)
+
+      expect(material1.envMap).toBe(envMapMock)
+      expect(material1.envMapIntensity).toBe(0.5)
+      expect(material1NeedsUpdateSpy).toBeCalledWith(true)
+
+      expect(material2.envMap).toBe(envMapMock)
+      expect(material2.envMapIntensity).toBe(0.5)
+      expect(material2NeedsUpdateSpy).toBeCalledWith(true)
+    })
+
+    it('should set and apply environment map when setEnvironment map is called before scene is loaded', () => {
+      const xrControllerModel = new XRControllerModel()
+      const motionControllerMock = new MotionControllerMock()
+      const sceneMock = new Object3D()
+      const mesh = new Mesh(new BoxBufferGeometry(), new MeshStandardMaterial())
+      sceneMock.add(mesh)
+      const materialNeedsUpdateSpy = vi.spyOn(mesh.material, 'needsUpdate', 'set')
+      const envMapMock = new Texture()
+
+      xrControllerModel.connectMotionController(motionControllerMock)
+      xrControllerModel.setEnvironmentMap(envMapMock, 0.5)
       xrControllerModel.connectModel(sceneMock)
 
       expect(xrControllerModel.envMap).toBe(envMapMock)
@@ -90,7 +137,7 @@ describe('XRControllerModel', () => {
       expect(materialNeedsUpdateSpy).toBeCalledWith(true)
     })
 
-    it('should set environment map intensity when setEnvironment map is called before scene is loaded', () => {
+    it('should set environment map intensity when setEnvironmentMapIntensity is called before scene is loaded', () => {
       const xrControllerModel = new XRControllerModel()
       const motionControllerMock = new MotionControllerMock()
       const sceneMock = new Object3D()
@@ -110,7 +157,7 @@ describe('XRControllerModel', () => {
       expect(materialNeedsUpdateSpy).toBeCalledWith(true)
     })
 
-    it('should remove environment map when setEnvironment map is called with null', () => {
+    it('should remove environment map when setEnvironmentMap is called with null', () => {
       const xrControllerModel = new XRControllerModel()
       const motionControllerMock = new MotionControllerMock()
       const sceneMock = new Object3D()
@@ -122,6 +169,8 @@ describe('XRControllerModel', () => {
       xrControllerModel.connectMotionController(motionControllerMock)
       xrControllerModel.connectModel(sceneMock)
       xrControllerModel.setEnvironmentMap(envMapMock)
+      expect.soft(xrControllerModel).toBe(envMapMock)
+
       xrControllerModel.setEnvironmentMap(null)
 
       expect(xrControllerModel.envMap).toBe(null)
diff --git a/src/XRControllerModel.ts b/src/XRControllerModel.ts
index c0031be..3701135 100644
--- a/src/XRControllerModel.ts
+++ b/src/XRControllerModel.ts
@@ -7,30 +7,47 @@ import {
   MeshLambertMaterial,
   MeshPhongMaterial,
   MeshStandardMaterial,
-  SphereGeometry
+  SphereGeometry,
+  Material
 } from 'three'
 import { MotionController, MotionControllerConstants } from 'three-stdlib'
 
-const isEnvMapApplicable = (
-  material: any
-): material is MeshBasicMaterial | MeshStandardMaterial | MeshPhongMaterial | MeshLambertMaterial => 'envMap' in material
+type MaterialsWithEnvMap = MeshBasicMaterial | MeshStandardMaterial | MeshPhongMaterial | MeshLambertMaterial
+
+const isEnvMapApplicable = (material: Material): material is MaterialsWithEnvMap => 'envMap' in material
+
+const updateEnvMap = (material: MaterialsWithEnvMap, envMap: Texture | null) => {
+  material.envMap = envMap
+  material.needsUpdate = true
+}
 
 const applyEnvironmentMap = (envMap: Texture | null, obj: Object3D): void => {
-  obj.traverse((child) => {
-    if (child instanceof Mesh && isEnvMapApplicable(child.material)) {
-      child.material.envMap = envMap
-      child.material.needsUpdate = true
+  if (obj instanceof Mesh) {
+    if (Array.isArray(obj.material)) {
+      obj.material.forEach((m) => (isEnvMapApplicable(m) ? updateEnvMap(m, envMap) : undefined))
+    } else if (isEnvMapApplicable(obj.material)) {
+      updateEnvMap(obj.material, envMap)
     }
-  })
+  }
+}
+
+type MaterialsWithEnvMapIntensity = Material & { envMapIntensity: any }
+
+const isEnvMapIntensityApplicable = (material: Material): material is MaterialsWithEnvMapIntensity => 'envMapIntensity' in material
+
+const updateEnvMapIntensity = (material: MaterialsWithEnvMapIntensity, envMapIntensity: number) => {
+  material.envMapIntensity = envMapIntensity
+  material.needsUpdate = true
 }
 
 const applyEnvironmentMapIntensity = (envMapIntensity: number, obj: Object3D): void => {
-  obj.traverse((child) => {
-    if (child instanceof Mesh && 'envMapIntensity' in child.material) {
-      child.material.envMapIntensity = envMapIntensity
-      child.material.needsUpdate = true
+  if (obj instanceof Mesh) {
+    if (Array.isArray(obj.material)) {
+      obj.material.forEach((m) => (isEnvMapIntensityApplicable(m) ? updateEnvMapIntensity(m, envMapIntensity) : undefined))
+    } else if (isEnvMapIntensityApplicable(obj.material)) {
+      updateEnvMapIntensity(obj.material, envMapIntensity)
     }
-  })
+  }
 }
 
 /**
@@ -91,12 +108,11 @@ function addAssetSceneToControllerModel(controllerModel: XRControllerModel, scen
   findNodes(controllerModel.motionController!, scene)
 
   // Apply any environment map that the mesh already has set.
-  if (controllerModel.envMap) {
-    applyEnvironmentMap(controllerModel.envMap, scene)
-  }
-
-  if (controllerModel.envMapIntensity != null) {
-    applyEnvironmentMapIntensity(controllerModel.envMapIntensity, scene)
+  if (controllerModel.envMap || controllerModel.envMapIntensity != null) {
+    scene.traverse((c) => {
+      if (controllerModel.envMap) applyEnvironmentMap(controllerModel.envMap, c)
+      if (controllerModel.envMapIntensity != null) applyEnvironmentMapIntensity(controllerModel.envMapIntensity, c)
+    })
   }
 
   // Add the glTF scene to the controllerModel.
@@ -118,24 +134,28 @@ export class XRControllerModel extends Group {
     this.scene = null
   }
 
-  setEnvironmentMap(envMap: Texture | null): XRControllerModel {
-    if (this.envMap === envMap) {
+  setEnvironmentMap(envMap: Texture | null, envMapIntensity = 1): XRControllerModel {
+    if (this.envMap === envMap && this.envMapIntensity === envMapIntensity) {
       return this
     }
 
     this.envMap = envMap
-    applyEnvironmentMap(envMap, this)
+    this.envMapIntensity = envMapIntensity
+    this.scene?.traverse((c) => {
+      applyEnvironmentMap(envMap, c)
+      applyEnvironmentMapIntensity(envMapIntensity, c)
+    })
 
     return this
   }
 
-  setEnvironmentMapIntensity(envMapIntensity = 1): XRControllerModel {
+  setEnvironmentMapIntensity(envMapIntensity: number): XRControllerModel {
     if (this.envMapIntensity === envMapIntensity) {
       return this
     }
 
     this.envMapIntensity = envMapIntensity
-    applyEnvironmentMapIntensity(envMapIntensity, this)
+    this.scene?.traverse((c) => applyEnvironmentMapIntensity(envMapIntensity, c))
 
     return this
   }
diff --git a/yarn.lock b/yarn.lock
index 3236158..017f5f5 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -576,6 +576,13 @@
   resolved "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-1.2.1.tgz"
   integrity sha512-ZnQMnLV4e7hDlUvw8H+U8ASL02SS2Gn6+9Ac3wGGLIe7+je2AeAOxPY+izIPJDfFDb7eDjev0Us8MO1iFRN8hA==
 
+"@jest/schemas@^29.6.3":
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.6.3.tgz#430b5ce8a4e0044a7e3819663305a7b3091c8e03"
+  integrity sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==
+  dependencies:
+    "@sinclair/typebox" "^0.27.8"
+
 "@jridgewell/gen-mapping@^0.1.0":
   version "0.1.1"
   resolved "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.1.1.tgz"
@@ -623,6 +630,11 @@
   resolved "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.13.tgz"
   integrity sha512-GryiOJmNcWbovBxTfZSF71V/mXbgcV3MewDe3kIMCLyIh5e7SKAeUZs+rMnJ8jkMolZ/4/VsdBmMrw3l+VdZ3w==
 
+"@jridgewell/sourcemap-codec@^1.4.15":
+  version "1.4.15"
+  resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz#d7c6e6755c78567a951e04ab52ef0fd26de59f32"
+  integrity sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg==
+
 "@jridgewell/trace-mapping@^0.3.17":
   version "0.3.17"
   resolved "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.17.tgz"
@@ -747,6 +759,11 @@
   resolved "https://registry.yarnpkg.com/@react-three/test-renderer/-/test-renderer-8.2.0.tgz#ac69e4f9abc0f21f341378f3235bfeece4a7f782"
   integrity sha512-sYTW/9AkU0f03M/rilYaCB9ORD3tS96bUhM+WRsx/QLtOKdUNCWrWwnxutm5M0orON0A0O84gbUosnqvCAKTsw==
 
+"@sinclair/typebox@^0.27.8":
+  version "0.27.8"
+  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.27.8.tgz#6667fac16c436b5434a387a34dedb013198f6e6e"
+  integrity sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==
+
 "@types/chai-subset@^1.3.3":
   version "1.3.3"
   resolved "https://registry.npmjs.org/@types/chai-subset/-/chai-subset-1.3.3.tgz"
@@ -754,11 +771,16 @@
   dependencies:
     "@types/chai" "*"
 
-"@types/chai@*", "@types/chai@^4.3.4":
+"@types/chai@*":
   version "4.3.4"
   resolved "https://registry.npmjs.org/@types/chai/-/chai-4.3.4.tgz"
   integrity sha512-KnRanxnpfpjUTqTCXslZSEdLfXExwgNxYPdiO2WGUj8+HDjFi8R3k5RVKPeSCzLjCcshCAtVO2QBbVuAV4kTnw==
 
+"@types/chai@^4.3.5":
+  version "4.3.5"
+  resolved "https://registry.yarnpkg.com/@types/chai/-/chai-4.3.5.tgz#ae69bcbb1bebb68c4ac0b11e9d8ed04526b3562b"
+  integrity sha512-mEo1sAde+UCE6b2hxn332f1g1E8WfYRu6p5SvTKr2ZKC1f7gFJXk4h5PyGP9Dt6gCaG8y8XhwnXWC6Iy2cmBng==
+
 "@types/draco3d@^1.4.0":
   version "1.4.2"
   resolved "https://registry.yarnpkg.com/@types/draco3d/-/draco3d-1.4.2.tgz#7faccb809db2a5e19b9efb97c5f2eb9d64d527ea"
@@ -1007,41 +1029,48 @@
     magic-string "^0.26.2"
     react-refresh "^0.14.0"
 
-"@vitest/expect@0.29.1":
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/@vitest/expect/-/expect-0.29.1.tgz"
-  integrity sha512-VFt1u34D+/L4pqjLA8VGPdHbdF8dgjX9Nq573L9KG6/7MIAL9jmbEIKpXudmxjoTwcyczOXRyDuUWBQHZafjoA==
+"@vitest/expect@0.34.3":
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/@vitest/expect/-/expect-0.34.3.tgz#576e1fd6a3a8b8b7a79a06477f3d450a77d67852"
+  integrity sha512-F8MTXZUYRBVsYL1uoIft1HHWhwDbSzwAU9Zgh8S6WFC3YgVb4AnFV2GXO3P5Em8FjEYaZtTnQYoNwwBrlOMXgg==
   dependencies:
-    "@vitest/spy" "0.29.1"
-    "@vitest/utils" "0.29.1"
+    "@vitest/spy" "0.34.3"
+    "@vitest/utils" "0.34.3"
     chai "^4.3.7"
 
-"@vitest/runner@0.29.1":
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/@vitest/runner/-/runner-0.29.1.tgz"
-  integrity sha512-VZ6D+kWpd/LVJjvxkt79OA29FUpyrI5L/EEwoBxH5m9KmKgs1QWNgobo/CGQtIWdifLQLvZdzYEK7Qj96w/ixQ==
+"@vitest/runner@0.34.3":
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/@vitest/runner/-/runner-0.34.3.tgz#ce09b777d133bbcf843e1a67f4a743365764e097"
+  integrity sha512-lYNq7N3vR57VMKMPLVvmJoiN4bqwzZ1euTW+XXYH5kzr3W/+xQG3b41xJn9ChJ3AhYOSoweu974S1V3qDcFESA==
   dependencies:
-    "@vitest/utils" "0.29.1"
+    "@vitest/utils" "0.34.3"
     p-limit "^4.0.0"
-    pathe "^1.1.0"
+    pathe "^1.1.1"
+
+"@vitest/snapshot@0.34.3":
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/@vitest/snapshot/-/snapshot-0.34.3.tgz#cb4767aa44711a1072bd2e06204b659275c4f0f2"
+  integrity sha512-QyPaE15DQwbnIBp/yNJ8lbvXTZxS00kRly0kfFgAD5EYmCbYcA+1EEyRalc93M0gosL/xHeg3lKAClIXYpmUiQ==
+  dependencies:
+    magic-string "^0.30.1"
+    pathe "^1.1.1"
+    pretty-format "^29.5.0"
 
-"@vitest/spy@0.29.1":
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/@vitest/spy/-/spy-0.29.1.tgz"
-  integrity sha512-sRXXK44pPzaizpiZOIQP7YMhxIs80J/b6v1yR3SItpxG952c8tdA7n0O2j4OsVkjiO/ZDrjAYFrXL3gq6hLx6Q==
+"@vitest/spy@0.34.3":
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/@vitest/spy/-/spy-0.34.3.tgz#d4cf25e6ca9230991a0223ecd4ec2df30f0784ff"
+  integrity sha512-N1V0RFQ6AI7CPgzBq9kzjRdPIgThC340DGjdKdPSE8r86aUSmeliTUgkTqLSgtEwWWsGfBQ+UetZWhK0BgJmkQ==
   dependencies:
-    tinyspy "^1.0.2"
+    tinyspy "^2.1.1"
 
-"@vitest/utils@0.29.1":
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/@vitest/utils/-/utils-0.29.1.tgz"
-  integrity sha512-6npOEpmyE6zPS2wsWb7yX5oDpp6WY++cC5BX6/qaaMhGC3ZlPd8BbTz3RtGPi1PfPerPvfs4KqS/JDOIaB6J3w==
+"@vitest/utils@0.34.3":
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/@vitest/utils/-/utils-0.34.3.tgz#6e243189a358b736b9fc0216e6b6979bc857e897"
+  integrity sha512-kiSnzLG6m/tiT0XEl4U2H8JDBjFtwVlaE8I3QfGiMFR0QvnRDfYfdP3YvTBWM/6iJDAyaPY6yVQiCTUc7ZzTHA==
   dependencies:
-    cli-truncate "^3.1.0"
-    diff "^5.1.0"
+    diff-sequences "^29.4.3"
     loupe "^2.3.6"
-    picocolors "^1.0.0"
-    pretty-format "^27.5.1"
+    pretty-format "^29.5.0"
 
 "@webgpu/glslang@^0.0.15":
   version "0.0.15"
@@ -1058,12 +1087,17 @@ acorn-walk@^8.2.0:
   resolved "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.2.0.tgz"
   integrity sha512-k+iyHEuPgSw6SbuDpGQM+06HQUa04DZ3o+F6CSzXMvvI5KMvnaEqXe+YVe555R9nn6GPt404fos4wcgpw12SDA==
 
+acorn@^8.10.0, acorn@^8.9.0:
+  version "8.10.0"
+  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.10.0.tgz#8be5b3907a67221a81ab23c7889c4c5526b62ec5"
+  integrity sha512-F0SAmZ8iUtS//m8DmCTA0jlh6TDKkHQyK6xc6V4KDTyZKA9dnvX9/3sRTVQrWm79glUAZbnmmNcdYwUIHWVybw==
+
 acorn@^8.7.1:
   version "8.7.1"
   resolved "https://registry.npmjs.org/acorn/-/acorn-8.7.1.tgz"
   integrity sha512-Xx54uLJQZ19lKygFXOWsscKUbsBZW0CPykPhVQdhIeIwrbPmJzqeASDInc8nKBnp/JT6igTs82qPXz069H8I/A==
 
-acorn@^8.8.1, acorn@^8.8.2:
+acorn@^8.8.2:
   version "8.8.2"
   resolved "https://registry.npmjs.org/acorn/-/acorn-8.8.2.tgz"
   integrity sha512-xjIYgE8HBrkpd/sJqOGNspf8uHG+NOHGOw6a/Urj8taM2EXfdNAH2oFcPeIFfsv3+kz/mJrS5VuMqbNLjCa2vw==
@@ -1088,11 +1122,6 @@ ansi-regex@^5.0.1:
   resolved "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz"
   integrity sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==
 
-ansi-regex@^6.0.1:
-  version "6.0.1"
-  resolved "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz"
-  integrity sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==
-
 ansi-styles@^3.2.1:
   version "3.2.1"
   resolved "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz"
@@ -1112,11 +1141,6 @@ ansi-styles@^5.0.0:
   resolved "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz"
   integrity sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==
 
-ansi-styles@^6.0.0:
-  version "6.2.1"
-  resolved "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz"
-  integrity sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==
-
 argparse@^2.0.1:
   version "2.0.1"
   resolved "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz"
@@ -1286,14 +1310,6 @@ chevrotain@^10.1.2:
     lodash "4.17.21"
     regexp-to-ast "0.5.0"
 
-cli-truncate@^3.1.0:
-  version "3.1.0"
-  resolved "https://registry.npmjs.org/cli-truncate/-/cli-truncate-3.1.0.tgz"
-  integrity sha512-wfOBkjXteqSnI59oPcJkcPl/ZmwvMMOj340qUIY1SKZCv0B9Cf4D4fAucRkIKQmsIuYK3x1rrgU7MeGRruiuiA==
-  dependencies:
-    slice-ansi "^5.0.0"
-    string-width "^5.0.0"
-
 color-convert@^1.9.0:
   version "1.9.3"
   resolved "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz"
@@ -1427,10 +1443,10 @@ detect-gpu@^4.0.19:
   dependencies:
     webgl-constants "^1.1.1"
 
-diff@^5.1.0:
-  version "5.1.0"
-  resolved "https://registry.npmjs.org/diff/-/diff-5.1.0.tgz"
-  integrity sha512-D+mk+qE8VC/PAUrlAU34N+VfXev0ghe5ywmpqrawphmVZc1bEfn56uo9qpyGp1p4xpzOHkSW4ztBd6L7Xx4ACw==
+diff-sequences@^29.4.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.6.3.tgz#4deaf894d11407c51efc8418012f9e70b84ea921"
+  integrity sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==
 
 dir-glob@^3.0.1:
   version "3.0.1"
@@ -1458,11 +1474,6 @@ draco3d@^1.4.1:
   resolved "https://registry.npmjs.org/draco3d/-/draco3d-1.5.2.tgz"
   integrity sha512-AeRQ25Fb29c14vpjnh167UGW0nGY0ZpEM3ld+zEXoEySlmEXcXfsCHZeTgo5qXH925V1JsdjrzasdaQ22/vXog==
 
-eastasianwidth@^0.2.0:
-  version "0.2.0"
-  resolved "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz"
-  integrity sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==
-
 electron-to-chromium@^1.4.147:
   version "1.4.161"
   resolved "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.161.tgz"
@@ -1473,11 +1484,6 @@ electron-to-chromium@^1.4.284:
   resolved "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.313.tgz"
   integrity sha512-QckB9OVqr2oybjIrbMI99uF+b9+iTja5weFe0ePbqLb5BHqXOJUO1SG6kDj/1WtWPRIBr51N153AEq8m7HuIaA==
 
-emoji-regex@^9.2.2:
-  version "9.2.2"
-  resolved "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz"
-  integrity sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==
-
 es-abstract@^1.19.0, es-abstract@^1.19.1, es-abstract@^1.19.2, es-abstract@^1.19.5:
   version "1.20.1"
   resolved "https://registry.npmjs.org/es-abstract/-/es-abstract-1.20.1.tgz"
@@ -2219,11 +2225,6 @@ is-extglob@^2.1.1:
   resolved "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz"
   integrity sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==
 
-is-fullwidth-code-point@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz"
-  integrity sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==
-
 is-glob@^4.0.0, is-glob@^4.0.1, is-glob@^4.0.3:
   version "4.0.3"
   resolved "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz"
@@ -2369,9 +2370,9 @@ lilconfig@^2.0.5:
   resolved "https://registry.npmjs.org/lilconfig/-/lilconfig-2.0.6.tgz"
   integrity sha512-9JROoBW7pobfsx+Sq2JsASvCo6Pfo6WWoUW79HuB1BCoBXD4PLWJPqDF6fNj67pqBYTbAHkE57M1kS/+L1neOg==
 
-local-pkg@^0.4.2:
+local-pkg@^0.4.3:
   version "0.4.3"
-  resolved "https://registry.npmjs.org/local-pkg/-/local-pkg-0.4.3.tgz"
+  resolved "https://registry.yarnpkg.com/local-pkg/-/local-pkg-0.4.3.tgz#0ff361ab3ae7f1c19113d9bb97b98b905dbc4963"
   integrity sha512-SFppqq5p42fe2qcZQqqEOiVRXl+WCP1MdT6k7BDEW1j++sp5fIY+/fdRQitvKgB5BrBcmrs5m/L0v2FrU5MY1g==
 
 locate-path@^2.0.0:
@@ -2444,6 +2445,13 @@ magic-string@^0.26.2:
   dependencies:
     sourcemap-codec "^1.4.8"
 
+magic-string@^0.30.1:
+  version "0.30.3"
+  resolved "https://registry.yarnpkg.com/magic-string/-/magic-string-0.30.3.tgz#403755dfd9d6b398dfa40635d52e96c5ac095b85"
+  integrity sha512-B7xGbll2fG/VjP+SWg4sX3JynwIU0mjoTc6MPpKNuIvftk6u6vqhDnk1R80b8C2GBR6ywqy+1DcKBrevBg+bmw==
+  dependencies:
+    "@jridgewell/sourcemap-codec" "^1.4.15"
+
 media-query-parser@^2.0.2:
   version "2.0.2"
   resolved "https://registry.npmjs.org/media-query-parser/-/media-query-parser-2.0.2.tgz"
@@ -2491,6 +2499,16 @@ mlly@^1.1.0, mlly@^1.1.1:
     pkg-types "^1.0.1"
     ufo "^1.1.0"
 
+mlly@^1.2.0, mlly@^1.4.0:
+  version "1.4.1"
+  resolved "https://registry.yarnpkg.com/mlly/-/mlly-1.4.1.tgz#7ab9cbb040bf8bd8205a0c341ce9acc3ae0c3a74"
+  integrity sha512-SCDs78Q2o09jiZiE2WziwVBEqXQ02XkGdUy45cbJf+BpYRIjArXRJ1Wbowxkb+NaM9DWvS3UC9GiO/6eqvQ/pg==
+  dependencies:
+    acorn "^8.10.0"
+    pathe "^1.1.1"
+    pkg-types "^1.0.3"
+    ufo "^1.3.0"
+
 mmd-parser@^1.0.4:
   version "1.0.4"
   resolved "https://registry.npmjs.org/mmd-parser/-/mmd-parser-1.0.4.tgz"
@@ -2712,6 +2730,11 @@ pathe@^1.1.0:
   resolved "https://registry.npmjs.org/pathe/-/pathe-1.1.0.tgz"
   integrity sha512-ODbEPR0KKHqECXW1GoxdDb+AZvULmXjVPy4rt+pGo2+TnjJTIPJQSVS6N63n8T2Ip+syHhbn52OewKicV0373w==
 
+pathe@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/pathe/-/pathe-1.1.1.tgz#1dd31d382b974ba69809adc9a7a347e65d84829a"
+  integrity sha512-d+RQGp0MAYTIaDBIMmOfMwz3E+LOZnxx1HZd5R18mmCZY0QBlK0LDZfPc8FW8Ed2DlvsuE6PRjroDY+wg4+j/Q==
+
 pathval@^1.1.1:
   version "1.1.1"
   resolved "https://registry.npmjs.org/pathval/-/pathval-1.1.1.tgz"
@@ -2736,6 +2759,15 @@ pkg-types@^1.0.1:
     mlly "^1.1.1"
     pathe "^1.1.0"
 
+pkg-types@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/pkg-types/-/pkg-types-1.0.3.tgz#988b42ab19254c01614d13f4f65a2cfc7880f868"
+  integrity sha512-nN7pYi0AQqJnoLPC9eHFQ8AcyaixBUOwvqc5TDnIKCMEE6I0y8P7OKA7fPexsXGCGxQDl/cmrLAp26LhcwxZ4A==
+  dependencies:
+    jsonc-parser "^3.2.0"
+    mlly "^1.2.0"
+    pathe "^1.1.0"
+
 postcss-load-config@^3.1.0:
   version "3.1.4"
   resolved "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-3.1.4.tgz"
@@ -2777,14 +2809,14 @@ prettier@^2.5.1:
   resolved "https://registry.npmjs.org/prettier/-/prettier-2.7.1.tgz"
   integrity sha512-ujppO+MkdPqoVINuDFDRLClm7D78qbDt0/NR+wp5FqEZOoTNAjPHWj17QRhu7geIHJfcNhRk1XVQmF8Bp3ye+g==
 
-pretty-format@^27.5.1:
-  version "27.5.1"
-  resolved "https://registry.npmjs.org/pretty-format/-/pretty-format-27.5.1.tgz"
-  integrity sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==
+pretty-format@^29.5.0:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-29.6.3.tgz#d432bb4f1ca6f9463410c3fb25a0ba88e594ace7"
+  integrity sha512-ZsBgjVhFAj5KeK+nHfF1305/By3lechHQSMWCTl8iHSbfOm2TN5nHEtFc/+W7fAyUeCs2n5iow72gld4gW0xDw==
   dependencies:
-    ansi-regex "^5.0.1"
+    "@jest/schemas" "^29.6.3"
     ansi-styles "^5.0.0"
-    react-is "^17.0.1"
+    react-is "^18.0.0"
 
 prop-types@^15.6.0, prop-types@^15.8.1:
   version "15.8.1"
@@ -2820,7 +2852,7 @@ react-dom@^18.2.0:
     loose-envify "^1.1.0"
     scheduler "^0.23.0"
 
-"react-is@^16.12.0 || ^17.0.0 || ^18.0.0", react-is@^18.2.0:
+"react-is@^16.12.0 || ^17.0.0 || ^18.0.0", react-is@^18.0.0, react-is@^18.2.0:
   version "18.2.0"
   resolved "https://registry.npmjs.org/react-is/-/react-is-18.2.0.tgz"
   integrity sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==
@@ -2830,11 +2862,6 @@ react-is@^16.13.1:
   resolved "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz"
   integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==
 
-react-is@^17.0.1:
-  version "17.0.2"
-  resolved "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz"
-  integrity sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==
-
 react-merge-refs@^1.1.0:
   version "1.1.0"
   resolved "https://registry.npmjs.org/react-merge-refs/-/react-merge-refs-1.1.0.tgz"
@@ -3046,24 +3073,11 @@ slash@^3.0.0:
   resolved "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz"
   integrity sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==
 
-slice-ansi@^5.0.0:
-  version "5.0.0"
-  resolved "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz"
-  integrity sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==
-  dependencies:
-    ansi-styles "^6.0.0"
-    is-fullwidth-code-point "^4.0.0"
-
 source-map-js@^1.0.2:
   version "1.0.2"
   resolved "https://registry.npmjs.org/source-map-js/-/source-map-js-1.0.2.tgz"
   integrity sha512-R0XvVJ9WusLiqTCEiGCmICCMplcCkIwwR11mOSD9CR5u+IXYdiseeEuXCVAjS54zqwkLcPNnmU4OeJ6tUrWhDw==
 
-source-map@^0.6.1:
-  version "0.6.1"
-  resolved "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz"
-  integrity sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==
-
 sourcemap-codec@^1.4.8:
   version "1.4.8"
   resolved "https://registry.npmjs.org/sourcemap-codec/-/sourcemap-codec-1.4.8.tgz"
@@ -3079,19 +3093,10 @@ stats.js@^0.17.0:
   resolved "https://registry.npmjs.org/stats.js/-/stats.js-0.17.0.tgz"
   integrity sha512-hNKz8phvYLPEcRkeG1rsGmV5ChMjKDAWU7/OJJdDErPBNChQXxCo3WZurGpnWc6gZhAzEPFad1aVgyOANH1sMw==
 
-std-env@^3.3.1:
-  version "3.3.2"
-  resolved "https://registry.npmjs.org/std-env/-/std-env-3.3.2.tgz"
-  integrity sha512-uUZI65yrV2Qva5gqE0+A7uVAvO40iPo6jGhs7s8keRfHCmtg+uB2X6EiLGCI9IgL1J17xGhvoOqSz79lzICPTA==
-
-string-width@^5.0.0:
-  version "5.1.2"
-  resolved "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz"
-  integrity sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==
-  dependencies:
-    eastasianwidth "^0.2.0"
-    emoji-regex "^9.2.2"
-    strip-ansi "^7.0.1"
+std-env@^3.3.3:
+  version "3.4.3"
+  resolved "https://registry.yarnpkg.com/std-env/-/std-env-3.4.3.tgz#326f11db518db751c83fd58574f449b7c3060910"
+  integrity sha512-f9aPhy8fYBuMN+sNfakZV18U39PbalgjXG3lLB9WkaYTxijru61wb57V9wxxNthXM5Sd88ETBWi29qLAsHO52Q==
 
 string.prototype.codepointat@^0.2.1:
   version "0.2.1"
@@ -3137,13 +3142,6 @@ strip-ansi@^6.0.1:
   dependencies:
     ansi-regex "^5.0.1"
 
-strip-ansi@^7.0.1:
-  version "7.0.1"
-  resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.0.1.tgz"
-  integrity sha512-cXNxvT8dFNRVfhVME3JAe98mkXDYN2O1l7jmcwMnOslDeESg1rF/OZMtK0nRAhiari1unG5cD4jG3rapUAkLbw==
-  dependencies:
-    ansi-regex "^6.0.1"
-
 strip-bom@^3.0.0:
   version "3.0.0"
   resolved "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz"
@@ -3154,12 +3152,12 @@ strip-json-comments@^3.1.0, strip-json-comments@^3.1.1:
   resolved "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz"
   integrity sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==
 
-strip-literal@^1.0.0:
-  version "1.0.1"
-  resolved "https://registry.npmjs.org/strip-literal/-/strip-literal-1.0.1.tgz"
-  integrity sha512-QZTsipNpa2Ppr6v1AmJHESqJ3Uz247MUS0OjrnnZjFAvEoWqxuyFuXn2xLgMtRnijJShAa1HL0gtJyUs7u7n3Q==
+strip-literal@^1.0.1:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/strip-literal/-/strip-literal-1.3.0.tgz#db3942c2ec1699e6836ad230090b84bb458e3a07"
+  integrity sha512-PugKzOsyXpArk0yWmUwqOZecSO0GH0bPoctLcqNDH9J04pVW3lflYE0ujElBGTloevcxF5MofAOZ7C5l2b+wLg==
   dependencies:
-    acorn "^8.8.2"
+    acorn "^8.10.0"
 
 supports-color@^5.3.0:
   version "5.5.0"
@@ -3239,20 +3237,20 @@ tiny-inflate@^1.0.3:
   resolved "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz"
   integrity sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==
 
-tinybench@^2.3.1:
-  version "2.3.1"
-  resolved "https://registry.npmjs.org/tinybench/-/tinybench-2.3.1.tgz"
-  integrity sha512-hGYWYBMPr7p4g5IarQE7XhlyWveh1EKhy4wUBS1LrHXCKYgvz+4/jCqgmJqZxxldesn05vccrtME2RLLZNW7iA==
+tinybench@^2.5.0:
+  version "2.5.0"
+  resolved "https://registry.yarnpkg.com/tinybench/-/tinybench-2.5.0.tgz#4711c99bbf6f3e986f67eb722fed9cddb3a68ba5"
+  integrity sha512-kRwSG8Zx4tjF9ZiyH4bhaebu+EDz1BOx9hOigYHlUW4xxI/wKIUQUqo018UlU4ar6ATPBsaMrdbKZ+tmPdohFA==
 
-tinypool@^0.3.1:
-  version "0.3.1"
-  resolved "https://registry.npmjs.org/tinypool/-/tinypool-0.3.1.tgz"
-  integrity sha512-zLA1ZXlstbU2rlpA4CIeVaqvWq41MTWqLY3FfsAXgC8+f7Pk7zroaJQxDgxn1xNudKW6Kmj4808rPFShUlIRmQ==
+tinypool@^0.7.0:
+  version "0.7.0"
+  resolved "https://registry.yarnpkg.com/tinypool/-/tinypool-0.7.0.tgz#88053cc99b4a594382af23190c609d93fddf8021"
+  integrity sha512-zSYNUlYSMhJ6Zdou4cJwo/p7w5nmAH17GRfU/ui3ctvjXFErXXkruT4MWW6poDeXgCaIBlGLrfU6TbTXxyGMww==
 
-tinyspy@^1.0.2:
-  version "1.1.1"
-  resolved "https://registry.npmjs.org/tinyspy/-/tinyspy-1.1.1.tgz"
-  integrity sha512-UVq5AXt/gQlti7oxoIg5oi/9r0WpF7DGEVwXgqWSMmyN16+e3tl5lIvTaOpJ3TAtu5xFzWccFRM4R5NaWHF+4g==
+tinyspy@^2.1.1:
+  version "2.1.1"
+  resolved "https://registry.yarnpkg.com/tinyspy/-/tinyspy-2.1.1.tgz#9e6371b00c259e5c5b301917ca18c01d40ae558c"
+  integrity sha512-XPJL2uSzcOyBMky6OFrusqWlzfFrXtE0hPuMgW8A2HmaqrPo4ZQHRN/V0QXN3FSjKxpsbRrFc5LI7KOwBsT1/w==
 
 to-fast-properties@^2.0.0:
   version "2.0.0"
@@ -3340,6 +3338,11 @@ ufo@^1.1.0:
   resolved "https://registry.npmjs.org/ufo/-/ufo-1.1.0.tgz"
   integrity sha512-LQc2s/ZDMaCN3QLpa+uzHUOQ7SdV0qgv3VBXOolQGXTaaZpIur6PwUclF5nN2hNkiTRcUugXd1zFOW3FLJ135Q==
 
+ufo@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/ufo/-/ufo-1.3.0.tgz#c92f8ac209daff607c57bbd75029e190930a0019"
+  integrity sha512-bRn3CsoojyNStCZe0BG0Mt4Nr/4KF+rhFlnNXybgqt5pXHNFRlqinSoQaTrGyzE4X8aHplSb+TorH+COin9Yxw==
+
 unbox-primitive@^1.0.2:
   version "1.0.2"
   resolved "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.0.2.tgz"
@@ -3375,15 +3378,15 @@ v8-compile-cache@^2.0.3:
   resolved "https://registry.npmjs.org/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz"
   integrity sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA==
 
-vite-node@0.29.1:
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/vite-node/-/vite-node-0.29.1.tgz"
-  integrity sha512-Ey9bTlQOQrCxQN0oJ7sTg+GrU4nTMLg44iKTFCKf31ry60csqQz4E+Q04hdWhwE4cTgpxUC+zEB1kHbf5jNkFA==
+vite-node@0.34.3:
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/vite-node/-/vite-node-0.34.3.tgz#de134fe38bc1555ac8ab5e489d7df6159a3e1a4c"
+  integrity sha512-+0TzJf1g0tYXj6tR2vEyiA42OPq68QkRZCu/ERSo2PtsDJfBpDyEfuKbRvLmZqi/CgC7SCBtyC+WjTGNMRIaig==
   dependencies:
     cac "^6.7.14"
     debug "^4.3.4"
-    mlly "^1.1.0"
-    pathe "^1.1.0"
+    mlly "^1.4.0"
+    pathe "^1.1.1"
     picocolors "^1.0.0"
     vite "^3.0.0 || ^4.0.0"
 
@@ -3411,34 +3414,34 @@ vite@^3.0.5:
   optionalDependencies:
     fsevents "~2.3.2"
 
-vitest@^0.29.1:
-  version "0.29.1"
-  resolved "https://registry.npmjs.org/vitest/-/vitest-0.29.1.tgz"
-  integrity sha512-iSy6d9VwsIn7pz5I8SjVwdTLDRGKNZCRJVzROwjt0O0cffoymKwazIZ2epyMpRGpeL5tsXAl1cjXiT7agTyVug==
+vitest@^0.34.3:
+  version "0.34.3"
+  resolved "https://registry.yarnpkg.com/vitest/-/vitest-0.34.3.tgz#863d61c133d01b16e49fd52d380c09fa5ac03188"
+  integrity sha512-7+VA5Iw4S3USYk+qwPxHl8plCMhA5rtfwMjgoQXMT7rO5ldWcdsdo3U1QD289JgglGK4WeOzgoLTsGFu6VISyQ==
   dependencies:
-    "@types/chai" "^4.3.4"
+    "@types/chai" "^4.3.5"
     "@types/chai-subset" "^1.3.3"
     "@types/node" "*"
-    "@vitest/expect" "0.29.1"
-    "@vitest/runner" "0.29.1"
-    "@vitest/spy" "0.29.1"
-    "@vitest/utils" "0.29.1"
-    acorn "^8.8.1"
+    "@vitest/expect" "0.34.3"
+    "@vitest/runner" "0.34.3"
+    "@vitest/snapshot" "0.34.3"
+    "@vitest/spy" "0.34.3"
+    "@vitest/utils" "0.34.3"
+    acorn "^8.9.0"
     acorn-walk "^8.2.0"
     cac "^6.7.14"
     chai "^4.3.7"
     debug "^4.3.4"
-    local-pkg "^0.4.2"
-    pathe "^1.1.0"
+    local-pkg "^0.4.3"
+    magic-string "^0.30.1"
+    pathe "^1.1.1"
     picocolors "^1.0.0"
-    source-map "^0.6.1"
-    std-env "^3.3.1"
-    strip-literal "^1.0.0"
-    tinybench "^2.3.1"
-    tinypool "^0.3.1"
-    tinyspy "^1.0.2"
+    std-env "^3.3.3"
+    strip-literal "^1.0.1"
+    tinybench "^2.5.0"
+    tinypool "^0.7.0"
     vite "^3.0.0 || ^4.0.0"
-    vite-node "0.29.1"
+    vite-node "0.34.3"
     why-is-node-running "^2.2.2"
 
 webgl-constants@^1.1.1:

From f8bd39f4c14040a893c80c71b20dd436b89b1f1e Mon Sep 17 00:00:00 2001
From: Michael Bashurov <accounts@saitonakamura.me>
Date: Wed, 30 Aug 2023 16:45:02 +0300
Subject: [PATCH 18/18] fixed broken test

---
 src/XRControllerModel.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/XRControllerModel.test.ts b/src/XRControllerModel.test.ts
index d7c5ca8..6f7ba40 100644
--- a/src/XRControllerModel.test.ts
+++ b/src/XRControllerModel.test.ts
@@ -169,7 +169,7 @@ describe('XRControllerModel', () => {
       xrControllerModel.connectMotionController(motionControllerMock)
       xrControllerModel.connectModel(sceneMock)
       xrControllerModel.setEnvironmentMap(envMapMock)
-      expect.soft(xrControllerModel).toBe(envMapMock)
+      expect.soft(xrControllerModel.envMap).toBe(envMapMock)
 
       xrControllerModel.setEnvironmentMap(null)