@needle-tools/usd 0.0.2-next.d90870e → 1.0.0-next.d536d99

package/CHANGELOG.md

@@ -4,5 +4,16 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-next.0] - 2026-06-25
+- Modernized the wasm runtime to upstream OpenUSD 26.05 with Hydra imaging enabled for the three.js render delegate.
+- Added the Adobe glTF file-format plugin, MaterialX support through Hydra material documents, and OpenSubdiv-enabled builds.
+- Added generated TypeScript declarations and usdview-style inspection/change APIs for programmatic stage interaction.
+- Switched the client MaterialX shader path to `@needle-tools/materialx@1.7.0`.
+- Added explicit package entrypoints for `@needle-tools/usd/three`, `@needle-tools/usd/plugins`, and `@needle-tools/usd/vite`.
+- Added a Needle Engine browser matrix that validates the USD package through Engine `dist` and package-module runtime shapes.
+- Added a technical demo render-host switch for viewing the same USD samples through plain three.js or a Needle Engine `Context`.
+- Read stage metadata from the live `UsdStage` API so up-axis state remains stable across referenced asset reloads.
+- Changed the license to PolyForm Noncommercial 1.0.0.
+
 ## [0.0.1-alpha] - 2025-05-14
-- initial release
+- initial release

package/README.md

@@ -1,13 +1,45 @@
 # Needle USD
 
-USD wasm runtime and three.js hydra delegate.   
-Developed & maintained by [Needle](https://needle.tools)  
-For commercial use please contact hi@needle.tools
+USD wasm runtime and three.js Hydra delegate.   
+Developed & maintained by [Needle](https://needle.tools).  
+
+For commercial use, please contact [hi@needle.tools](mailto:hi@needle.tools).  
 
 ## Install
-`npm install @needle-tools/usd`
 
+```sh
+npm install @needle-tools/usd@next three @needle-tools/materialx@1.7.0
+```
+
+This major prerelease uses upstream OpenUSD 26.05 and ships a Hydra imaging
+bridge for three.js. The wasm bundle includes Adobe `usdGltf`, MaterialX, and
+OpenSubdiv support.
+
+## Runtime Requirements
+
+This package ships a threaded Emscripten/OpenUSD wasm build. Browser pages that
+use it must be served in a cross-origin isolated context so `SharedArrayBuffer`
+and pthread workers are available:
+
+```js
+res.setHeader("Cross-Origin-Embedder-Policy", "require-corp");
+res.setHeader("Cross-Origin-Opener-Policy", "same-origin");
+```
+
+For Vite projects, use the package plugin to set these headers during local
+development:
+
+```js
+import { needleUSD } from "@needle-tools/usd/vite";
+
+export default {
+  plugins: [needleUSD()],
+};
+```
 
+The modern Emscripten output contains `emHdBindings.js` and
+`emHdBindings.wasm`. It does not ship a separate `emHdBindings.worker.js`; the
+pthread workers load the main generated JavaScript entrypoint directly.
 
 ## Use with Needle Engine
 
@@ -26,12 +58,15 @@ export function addUsdPlugin() {
 ```
 
 
-### Use with other three.js based viewers
+### Use with three.js
 
 
-See full example in [examples](./examples/src/main.ts)
+See full example in [examples](/usd-wasm/examples/src/main.ts)
 
 ```js
+import { getUsdModule } from "@needle-tools/usd";
+import { createThreeHydra } from "@needle-tools/usd/three";
+
 // Load the USD module
 const usd = await getUsdModule();
 // Load a USD file to be rendered by threejs
@@ -43,9 +78,18 @@ const handle = await createThreeHydra({
 // Call handle.update(dt) in your threejs update loop 
 ```
 
+Public package entrypoints:
+
+```js
+import { getUsdModule, loadOpenUsdBuildInfo } from "@needle-tools/usd";
+import { createThreeHydra } from "@needle-tools/usd/three";
+import { addPluginForNeedleEngine } from "@needle-tools/usd/plugins";
+import { needleUSD } from "@needle-tools/usd/vite";
+```
+
 
 
-## Low Level
+## Low Level Usage
 
 ### Import
 ```js
@@ -85,7 +129,7 @@ driver.Draw();
 
 ## Useful References
 
-Uses Asyncify to handle async calls in emscripten.
+Uses `Asyncify` to handle async calls in emscripten.  
 > A synchronous call in C that waits for an asynchronous operation in JS to complete.
 https://emscripten.org/docs/porting/asyncify.html
 
@@ -97,4 +141,3 @@ https://emscripten.org/docs/porting/asyncify.html
 [Discord](https://discord.needle.tools) • 
 [Forum](https://forum.needle.tools) • 
 [Youtube](https://www.youtube.com/@needle-tools)
-

package/package.json

@@ -1,20 +1,32 @@
 {
   "name": "@needle-tools/usd",
-  "version": "0.0.2-next.d90870e",
+  "version": "1.0.0-next.d536d99",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "type": "module",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "require": "./src/index.cjs"
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./three": {
+      "types": "./src/types/create.three.d.ts",
+      "import": "./src/create.three.js"
     },
     "./plugins": {
-      "import": "./src/plugins/index.js",
-      "require": "./src/plugins/index.cjs",
-      "types": "./src/types/plugins.d.ts"
+      "types": "./src/types/plugins.d.ts",
+      "import": "./src/plugins/index.js"
+    },
+    "./vite": {
+      "types": "./src/types/vite.d.ts",
+      "import": "./src/vite/index.js"
     }
   },
+  "files": [
+    "src",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "keywords": [
     "needle",
     "usd",
@@ -23,6 +35,7 @@
     "webgl"
   ],
   "homepage": "https://needle.tools",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "author": {
     "name": "Needle",
     "email": "hi@needle.tools",
@@ -36,15 +49,34 @@
     "url": "https://github.com/needle-tools/usd-viewer/issues"
   },
   "peerDependencies": {
-    "three": "^0.164.1",
-    "@needle-tools/engine": "4.x || ^4.6.0-0"
+    "@needle-tools/engine": ">=5.0.0",
+    "three": ">=0.160.0"
+  },
+  "peerDependenciesMeta": {
+    "@needle-tools/engine": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "needle-engine-matrix:cache": "node scripts/cache-needle-engine-matrix.mjs",
+    "three-matrix:cache": "node scripts/cache-three-matrix.mjs",
+    "test:bindings": "node --test tests/bindings/*.test.mjs",
+    "test:needle-engine-matrix": "npm run needle-engine-matrix:cache && playwright test -c tests/needle-engine-matrix/playwright.config.ts",
+    "test:three-matrix": "node scripts/run-three-matrix.mjs",
+    "test:viewer-visual": "playwright test -c tests/viewer-visual/playwright.config.ts"
   },
   "devDependencies": {
-    "vite": "^5.2.13",
-    "@types/three": "^0.164.1"
+    "@needle-tools/engine": "^5.1.2",
+    "@needle-tools/three-test-matrix": "^0.1.0",
+    "@playwright/test": "^1.60.0",
+    "@types/three": "^0.164.1",
+    "vite": "^8.1.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@needle-tools/materialx": "1.7.0-next.57183d6"
   }
 }