feat(three): migrate to super-three@0.181.0 and centralize version management

felixtrz · meta-codesync[bot] · commit 7317fdb93a0f · 2025-12-15T14:24:15.000-08:00
Summary:
- Upgrade three.js from `super-three@0.177.0` to `0.181.0` across all packages and examples
- Replace deprecated `RGBELoader` with `HDRLoader` in HDR texture loading
- Centralize version management via pnpm overrides in root `package.json`
- Make version check script dynamic by reading expected versions from `package.json`
- Use wildcard `"three": "*"` in pnpm-managed packages (overrides enforce correct version)
- Maintain explicit `npm:super-three@0.181.0` in npm-based examples for proper deduplication
- Update documentation to reference `HDRLoader` instead of deprecated `RGBELoader`

Reviewed By: zjm-meta

Differential Revision:
D87742740

Privacy Context Container: L1334777

fbshipit-source-id: 9d7de697f5a2091c9de247b219a7994139f5de68
diff --git a/docs/concepts/three-basics/meshes-geometry-materials.md b/docs/concepts/three-basics/meshes-geometry-materials.md
@@ -253,9 +253,10 @@ IWSDK provides good default lighting:
 For realistic reflections and lighting:
 
 ```ts
-import { RGBELoader, PMREMGenerator } from '@iwsdk/core';
+import { HDRLoader } from 'three/examples/jsm/loaders/HDRLoader.js';
+import { PMREMGenerator } from '@iwsdk/core';
 
-const loader = new RGBELoader();
+const loader = new HDRLoader();
 const pmremGenerator = new PMREMGenerator(world.renderer);
 
 loader.load('/environments/sunset.hdr', (texture) => {
diff --git a/examples/audio/package.json b/examples/audio/package.json
@@ -16,7 +16,7 @@
     "@iwsdk/core": "file:../../packages/core/iwsdk-core.tgz",
     "@pmndrs/uikit-horizon": "^1.0.60",
     "@pmndrs/uikit-lucide": "^1.0.60",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
diff --git a/examples/grab/package.json b/examples/grab/package.json
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "@iwsdk/core": "file:../../packages/core/iwsdk-core.tgz",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
diff --git a/examples/locomotion/package.json b/examples/locomotion/package.json
@@ -16,7 +16,7 @@
     "@iwsdk/core": "file:../../packages/core/iwsdk-core.tgz",
     "@pmndrs/uikit-horizon": "^1.0.60",
     "@pmndrs/uikit-lucide": "^1.0.60",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
diff --git a/examples/physics/package.json b/examples/physics/package.json
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "@iwsdk/core": "file:../../packages/core/iwsdk-core.tgz",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
diff --git a/examples/scene-understanding/package.json b/examples/scene-understanding/package.json
@@ -15,7 +15,7 @@
   "dependencies": {
     "@iwsdk/core": "file:../../packages/core/iwsdk-core.tgz",
     "patch-package": "^8.0.1",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
diff --git a/package.json b/package.json
@@ -57,7 +57,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.6",
     "@types/node": "^20.0.0",
-    "@types/three": "^0.177.0",
+    "@types/three": "^0.181.0",
     "@types/webxr": "^0.5.8",
     "@typescript-eslint/eslint-plugin": "^5.55.0",
     "@typescript-eslint/parser": "^5.62.0",
@@ -80,7 +80,8 @@
   },
   "pnpm": {
     "overrides": {
-      "three": "npm:super-three@0.177.0",
+      "three": "npm:super-three@0.181.0",
+      "@types/three": "0.181.0",
       "three-mesh-bvh": "^0.9.1",
       "axios": "^1.12.0"
     }
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -41,7 +41,7 @@
     "@pmndrs/uikitml": "^0.1.12",
     "@preact/signals-core": "^1.11.0",
     "elics": "^3.3.0",
-    "three": "npm:super-three@0.177.0",
+    "three": "*",
     "three-mesh-bvh": "^0.9.1"
   },
   "engines": {
diff --git a/packages/core/src/asset/loaders/hdr-texture-loader.ts b/packages/core/src/asset/loaders/hdr-texture-loader.ts
@@ -6,7 +6,7 @@
  */
 
 import { EXRLoader } from 'three/examples/jsm/loaders/EXRLoader.js';
-import { RGBELoader } from 'three/examples/jsm/loaders/RGBELoader.js';
+import { HDRLoader } from 'three/examples/jsm/loaders/HDRLoader.js';
 import {
   EquirectangularReflectionMapping,
   LoadingManager,
@@ -18,11 +18,11 @@ import { CacheManager } from '../cache-manager.js';
  * @category Assets
  */
 export class HDRTextureAssetLoader {
-  private static rgbeLoader: RGBELoader;
+  private static hdrLoader: HDRLoader;
   private static exrLoader: EXRLoader;
 
   static init(loadingManager: LoadingManager): void {
-    this.rgbeLoader = new RGBELoader(loadingManager);
+    this.hdrLoader = new HDRLoader(loadingManager);
     this.exrLoader = new EXRLoader(loadingManager);
   }
 
@@ -68,7 +68,7 @@ export class HDRTextureAssetLoader {
       if (isEXR) {
         this.exrLoader.load(url, onLoad, undefined, onError);
       } else {
-        this.rgbeLoader.load(url, onLoad, undefined, onError);
+        this.hdrLoader.load(url, onLoad, undefined, onError);
       }
     });
 
diff --git a/packages/starter-assets/starter-template/package.json b/packages/starter-assets/starter-template/package.json
@@ -10,14 +10,14 @@
   },
   "dependencies": {
     "@iwsdk/core": "file:../packages/core/iwsdk-core.tgz",
-    "three": "npm:super-three@0.177.0"
+    "three": "npm:super-three@0.181.0"
   },
   "devDependencies": {
     "@iwsdk/vite-plugin-gltf-optimizer": "file:../packages/vite-plugin-gltf-optimizer/iwsdk-vite-plugin-gltf-optimizer.tgz",
     "@iwsdk/vite-plugin-iwer": "file:../packages/vite-plugin-iwer/iwsdk-vite-plugin-iwer.tgz",
     "@iwsdk/vite-plugin-metaspatial": "file:../packages/vite-plugin-metaspatial/iwsdk-vite-plugin-metaspatial.tgz",
     "@iwsdk/vite-plugin-uikitml": "file:../packages/vite-plugin-uikitml/iwsdk-vite-plugin-uikitml.tgz",
-    "@types/three": "^0.178.1",
+    "@types/three": "*",
     "typescript": "^5.5.0",
     "vite": "^7.1.4",
     "vite-plugin-mkcert": "^1.17.0"
diff --git a/packages/vite-plugin-uikitml/package.json b/packages/vite-plugin-uikitml/package.json
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "three": "npm:super-three@0.177.0"
+    "three": "*"
   },
   "peerDependencies": {
     "vite": "^7.0.0"
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/scripts/check-three-version.mjs b/scripts/check-three-version.mjs
