@needle-tools/materialx 1.4.3 → 1.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/materialx",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/src/constants.js

@@ -0,0 +1,3 @@
+import pkg from '../package.json' with { type: 'json' };
+
+export const VERSION = pkg.version;

package/src/loader/loader.three.js

@@ -3,6 +3,7 @@ import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
 import { ready, state } from "../materialx.js";
 import { debug } from "../utils.js";
 import { MaterialXMaterial } from "../materialx.material.js";
+import { VERSION } from "../constants.js";
 
 /**
  * @import { MaterialX_root_extension, MaterialX_material_extension, MaterialXLoaderOptions } from "./loader.three.d.ts"
@@ -92,7 +93,6 @@ export class MaterialXLoader {
 
         /** @type {MaterialDefinition} */
         const materialDef = this.parser.json.materials?.[materialIndex];
-        if (debug) console.debug("[MaterialX] extension found in material:", materialDef.extensions?.[this.name]);
 
         // Handle different types of MaterialX data
         /** @type {MaterialX_material_extension} */
@@ -101,6 +101,8 @@ export class MaterialXLoader {
         const materialX_root_data = this.materialX_root_data?.[documentIndex];
         const mtlx = materialX_root_data.mtlx || null;
 
+        if (debug) console.debug(`[MaterialX] extension found in material[${materialIndex}]:`, materialDef.extensions?.[this.name], "\n→ MTLX root data:", materialX_root_data);
+
         if (ext && mtlx) {
 
             /** @type {MaterialXMaterialOptions} */
@@ -336,7 +338,7 @@ export async function createMaterialXMaterial(mtlx, materialNodeNameOrIndex, loa
 
     } catch (error) {
         // This is a wasm error (an int) that we need to resolve
-        console.error(`[MaterialX] Error creating MaterialX material (${materialNodeNameOrIndex}):`, error);
+        console.error(`[MaterialX v${VERSION}] Error creating MaterialX material (${materialNodeNameOrIndex}):`, typeof error === "number" ? `CODE ${error}` : error, `\n→ This may be caused by invalid MaterialX XML data or a problem in the shader generation process. Please provide the MaterialX code below when reporting an issue:\n`, mtlx);
         // Return a fallback material with stored MaterialX data
         const fallbackMaterial = new MeshStandardMaterial();
         fallbackMaterial.color.set(0xff00ff);

package/src/materialx.js

@@ -4,6 +4,7 @@ import { renderPMREMToEquirect } from "./utils.texture.js";
 import { Light, Mesh, MeshBasicMaterial, Object3D, PlaneGeometry, PMREMGenerator, Scene, Texture, WebGLRenderer } from "three";
 import { registerLights, getLightData } from "./materialx.helper.js";
 import { whiteTexture } from "./utils.texture.js";
+import { VERSION } from "./constants.js";
 
 
 /**
@@ -45,7 +46,7 @@ export async function ready() {
     }
     return state.materialXInitPromise = (async () => {
         if (state.materialXModule) return; // Already initialized
-        if (debug) console.log("[MaterialX] Initializing WASM module...");
+        if (debug) console.log(`[MaterialX v${VERSION}] Initializing WASM module...`);
         try {
 
             // NOTE: This must be a plain string literal (not a template) so that the
@@ -61,11 +62,11 @@ export async function ready() {
                 // Use local files from the @needle-tools/materialx npm package.
                 // Vite's ?url suffix copies these files to the output directory
                 // and returns their URL automatically — no CDN download needed.
-                urls = await Promise.all([
+                urls = /** @type {string[]} */ (await Promise.all([
                     import('../bin/JsMaterialXCore.wasm?url').then(m => m.default || m),
                     import('../bin/JsMaterialXGenShader.wasm?url').then(m => m.default || m),
                     import('../bin/JsMaterialXGenShader.data.txt?url').then(m => m.default || m),
-                ]);
+                ]));
             }
             else if (location) {
                 // Custom path: use as base URL for CDN or self-hosted files
@@ -143,9 +144,9 @@ export async function ready() {
             // This prewarms the shader generation context to have all light types
             await registerLights(state.materialXModule, state.materialXGenContext);
 
-            if (debug) console.log("[MaterialX] Generator initialized successfully");
+            if (debug) console.log(`[MaterialX v${VERSION}] Generator initialized successfully`);
         } catch (error) {
-            console.error("[MaterialX] Failed to load MaterialX module:", error);
+            console.error(`[MaterialX v${VERSION}] Failed to load MaterialX module:`, error);
             throw error;
         }
     })();