@needle-tools/materialx 1.2.1-next.343c31f → 1.2.1-next.bc1fa29

package/CHANGELOG.md

@@ -4,6 +4,9 @@ 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.2.1] - 2025-07-23
+- Fix: error caused by scene.environment being null 
+
 ## [1.2.0] - 2025-07-23
 - Add: Support to load raw MaterialX materials (from mtlx as XML)
 - Fix: Warn if tangents are missing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/materialx",
-  "version": "1.2.1-next.343c31f",
+  "version": "1.2.1-next.bc1fa29",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/src/index.d.ts

@@ -9,3 +9,6 @@ declare const Experimental_API: {
 };
 
 export { Experimental_API };
+
+
+export function preloadWasm(trigger: "immediately" | "network_idle"): Promise<void>;

package/src/index.js

@@ -1,11 +1,38 @@
+import { createMaterialXMaterial } from "./loader/loader.three.js";
+import { ready } from "./materialx.js";
+import { waitForNetworkIdle } from "./utils.js";
+
+
 export { ready } from "./materialx.js";
 export { MaterialXMaterial } from "./materialx.material.js";
 export { MaterialXLoader } from "./loader/loader.three.js";
 
-import { createMaterialXMaterial } from "./loader/loader.three.js";
 
+/**
+ * Preloads the MaterialX WebAssembly module.
+ * @type {import("./index.js").preloadWasm}
+ */
+export async function preloadWasm(trigger) {
+    if (trigger === "immediately") {
+        // Load the WASM module immediately
+        await ready();
+    } else if (trigger === "network_idle") {
+        // Wait for network to be idle before loading
+        await waitForNetworkIdle();
+        await ready();
+    }
+}
+
+
+
+
+/**
+ * Experimental API for creating MaterialX materials.
+ */
 const Experimental_API = {
     createMaterialXMaterial
 }
 
 export { Experimental_API }
+
+

package/src/materialx.material.js

@@ -91,6 +91,7 @@ export class MaterialXMaterial extends ShaderMaterial {
         // Patch fragmentShader
         const precision = init.parameters?.precision || "highp";
         vertexShader = vertexShader.replace(/precision mediump float;/g, `precision ${precision} float;`);
+        vertexShader = vertexShader.replace(/#define M_FLOAT_EPS 1e-8/g, precision === "highp" ? `#define M_FLOAT_EPS 1e-8` : `#define M_FLOAT_EPS 1e-3`);
         fragmentShader = fragmentShader.replace(/precision mediump float;/g, `precision ${precision} float;`);
         fragmentShader = fragmentShader.replace(/#define M_FLOAT_EPS 1e-8/g, precision === "highp" ? `#define M_FLOAT_EPS 1e-8` : `#define M_FLOAT_EPS 1e-3`);
 

package/src/utils.d.ts

@@ -15,3 +15,6 @@ export function getTime(): number;
  * Get current frame number
  */
 export function getFrame(): number;
+
+
+export function waitForNetworkIdle(): Promise<void>;

package/src/utils.js

@@ -44,3 +44,16 @@ function updateTime() {
 }
 
 window.requestAnimationFrame(updateTime);
+
+
+
+
+export async function waitForNetworkIdle() {
+    if (typeof requestIdleCallback !== "undefined") {
+        return new Promise(res => requestIdleCallback(res));
+    }
+    else {
+        console.debug("[MaterialX] Can not wait for network idle, using fallback");
+        return new Promise(res => setTimeout(res, 100)); // Fallback to a short delay
+    }
+}

package/src/utils.texture.d.ts

@@ -1,5 +1,7 @@
 import { WebGLRenderer, WebGLRenderTarget, Texture } from 'three';
 
+export const whiteTexture: Texture;
+
 /**
  * Renders a PMREM environment map to an equirectangular texture with specified roughness
  */