@needle-tools/materialx 1.7.0-next.8333b4d → 1.7.0

package/CHANGELOG.md

@@ -4,18 +4,22 @@ 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.7.0] - 2026-05-21
+## [1.7.0] - 2026-06-30
 
 ### Added
 - Runtime environment radiance modes for fast Three.js PMREM sampling, MaterialX prefiltered latlong sampling, and MaterialX filtered importance sampling.
 - MaterialX viewer examples for material library inspection, PMREM comparison, shaderball previews, configurable environments, and graph-driven material loading.
+- Missing tangents are now automatically generated for MaterialX materials that require them. Set `generateTangents: false` to disable this.
 
 ### Changed
 - Rebuilt the bundled MaterialX runtime to 1.39.5.
 - Improved texture sampling, alpha-mode render state, environment rotation, and PMREM handling for Three.js integration.
 
 ### Fixed
-- Removed browser-hostile runtime imports of `three/src`, `UniformsLib`, and WebGL-only Three.js exports so the package can share the host application's Three.js import map in WebGL and WebGPU contexts.
+- Removed runtime imports of `three/src`, `UniformsLib` so the package can share the host application's Three.js import map.
+- Added the JSON module import attribute for `package.json` so raw browser ESM imports can read the package version without MIME errors.
+- Made Node ESM imports browser-global safe and load the bundled MaterialX WASM/data files from the installed package when `ready()` runs under Node.
+- Switched bundled MaterialX Emscripten loaders to `node:module` builtin imports for Deno compatibility, and added runtime smoke scripts for Node, Deno, and Bun.
 - Corrected material parameter editing for color values, environment controls, and graph-loaded materials in the viewer examples.
 - Kept viewer debug panels and camera controls consistent across the material library, graph, shadows, and complex scenes.
 

package/README.md

@@ -2,10 +2,11 @@
 
 Web runtime for [MaterialX](https://materialx.org/) materials in [Needle Engine](https://needle.tools) and [three.js](https://threejs.org/). Renders physically based MaterialX shaders in the browser using WebAssembly — load `.mtlx` files or glTF assets with the `NEEDLE_materials_mtlx` extension (created with Needle Engine's Unity integration and ShaderGraph).
 
-- MaterialX to WebGL/WebGPU shader generation via WASM
+- MaterialX to WebGL shader generation via WASM
 - Vertex displacement support (procedural noise, texture-based, animatable)
 - Material-level ambient occlusion (per glTF specification)
 - UV coordinate convention handling (glTF ↔ OpenGL)
+- Automatic MikkTSpace tangent generation when MaterialX shaders need tangents
 - Three.js shadow support (directional, spot, point lights)
 - Alpha mask and blend transparency modes
 - glTF extension for embedding MaterialX materials in `.glb`/`.gltf` files
@@ -76,6 +77,29 @@ const material = await Experimental_API.createMaterialXMaterial(
 );
 ```
 
+### Tangents
+
+Some MaterialX shaders need tangent-space data for correct normal, anisotropy, or texture-space lighting. If a geometry is missing tangents, MaterialX materials generate MikkTSpace tangents lazily at render time using Three.js' bundled MikkTSpace utilities.
+
+Automatic tangent generation is enabled by default. To keep the previous warning-only behavior, disable it in the same options object used for other MaterialX settings:
+
+```ts
+useNeedleMaterialX(gltfLoader, {
+    generateTangents: false,
+});
+```
+
+For raw MaterialX materials:
+
+```ts
+const material = await Experimental_API.createMaterialXMaterial(
+    mtlxSource,
+    0,
+    undefined,
+    { generateTangents: false },
+);
+```
+
 ## WASM
 
 ### Default (CDN)