@aura3d/assets 1.3.2 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/assets",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "type": "module",
   "exports": {
     ".": {
@@ -15,9 +15,9 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/animation": "1.3.2",
-    "@aura3d/rendering": "1.3.2",
-    "@aura3d/scene": "1.3.2"
+    "@aura3d/animation": "1.4.0",
+    "@aura3d/rendering": "1.4.0",
+    "@aura3d/scene": "1.4.0"
   },
   "sideEffects": false
 }

package/src/GLTFLoader.ts

@@ -4022,6 +4022,7 @@ function serializeGLTFAsset(
       joints: mesh.joints.map((joint) => [...joint] as const),
       weights: mesh.weights.map((weight) => [...weight] as const),
       morphTargets: mesh.morphTargets.map((target) => ({
+        ...(target.name ? { name: target.name } : {}),
         positions: target.positions.map((position) => [...position] as const),
         normals: target.normals.map((normal) => [...normal] as const),
         tangents: target.tangents.map((tangent) => [...tangent] as const)

package/src/GLTFRenderResources.ts

@@ -417,6 +417,7 @@ export async function createGLTFRenderResources(
       geometryLibrary.set(mesh.name, createGeometry(mesh, materialForMesh(asset, mesh, options.materialVariant)));
       if (mesh.morphTargets.length > 0) {
         morphTargetLibrary.set(mesh.name, mesh.morphTargets.map((target) => ({
+          ...(target.name ? { name: target.name } : {}),
           positions: target.positions,
           normals: target.normals,
           tangents: target.tangents
@@ -1383,21 +1384,65 @@ async function createMaterial(
 ): Promise<Material> {
   const renderState = renderStateForGLTFMaterial(material, renderStateOverrides);
   if (options.skinned && !material.unlit) {
-    const baseColorTexture = material.baseColorTexture
-      ? await createTextureBinding(asset, material.baseColorTexture, "srgb", getTexture, "u_baseColorTexture")
-      : undefined;
-    const normalTexture = material.normalTexture
-      ? await createTextureBinding(asset, material.normalTexture, "linear", getTexture, "u_normalTexture", createNormalSampler(asset, material))
-      : undefined;
-    const metallicRoughnessTexture = material.metallicRoughnessTexture
-      ? await createTextureBinding(asset, material.metallicRoughnessTexture, "linear", getTexture, "u_metallicRoughnessTexture")
-      : undefined;
-    const occlusionTexture = material.occlusionTexture
-      ? await createTextureBinding(asset, material.occlusionTexture, "linear", getTexture, "u_occlusionTexture")
-      : undefined;
-    const emissiveTexture = material.emissiveTexture
-      ? await createTextureBinding(asset, material.emissiveTexture, "srgb", getTexture, "u_emissiveTexture")
-      : undefined;
+    const [
+      baseColorTexture,
+      normalTexture,
+      metallicRoughnessTexture,
+      occlusionTexture,
+      emissiveTexture,
+      clearcoatTexture,
+      clearcoatNormalTexture,
+      sheenColorTexture,
+      sheenRoughnessTexture,
+      transmissionTexture,
+      iridescenceTexture,
+      iridescenceThicknessTexture,
+      anisotropyTexture,
+      volumeThicknessTexture
+    ] = await Promise.all([
+      material.baseColorTexture
+        ? createTextureBinding(asset, material.baseColorTexture, "srgb", getTexture, "u_baseColorTexture")
+        : Promise.resolve(undefined),
+      material.normalTexture
+        ? createTextureBinding(asset, material.normalTexture, "linear", getTexture, "u_normalTexture", createNormalSampler(asset, material))
+        : Promise.resolve(undefined),
+      material.metallicRoughnessTexture
+        ? createTextureBinding(asset, material.metallicRoughnessTexture, "linear", getTexture, "u_metallicRoughnessTexture")
+        : Promise.resolve(undefined),
+      material.occlusionTexture
+        ? createTextureBinding(asset, material.occlusionTexture, "linear", getTexture, "u_occlusionTexture")
+        : Promise.resolve(undefined),
+      material.emissiveTexture
+        ? createTextureBinding(asset, material.emissiveTexture, "srgb", getTexture, "u_emissiveTexture")
+        : Promise.resolve(undefined),
+      material.clearcoat?.texture
+        ? createTextureBinding(asset, material.clearcoat.texture, "linear", getTexture, "u_clearcoatTexture")
+        : Promise.resolve(undefined),
+      material.clearcoat?.normalTexture
+        ? createTextureBinding(asset, material.clearcoat.normalTexture, "linear", getTexture, "u_clearcoatNormalTexture", createNormalSamplerForInfo(asset, material.clearcoat.normalTexture))
+        : Promise.resolve(undefined),
+      material.sheen?.colorTexture
+        ? createTextureBinding(asset, material.sheen.colorTexture, "srgb", getTexture, "u_sheenColorTexture")
+        : Promise.resolve(undefined),
+      material.sheen?.roughnessTexture
+        ? createTextureBinding(asset, material.sheen.roughnessTexture, "linear", getTexture, "u_sheenRoughnessTexture")
+        : Promise.resolve(undefined),
+      material.transmission?.texture
+        ? createTextureBinding(asset, material.transmission.texture, "linear", getTexture, "u_transmissionTexture")
+        : Promise.resolve(undefined),
+      material.iridescence?.texture
+        ? createTextureBinding(asset, material.iridescence.texture, "linear", getTexture, "u_iridescenceTexture")
+        : Promise.resolve(undefined),
+      material.iridescence?.thicknessTexture
+        ? createTextureBinding(asset, material.iridescence.thicknessTexture, "linear", getTexture, "u_iridescenceThicknessTexture")
+        : Promise.resolve(undefined),
+      material.anisotropy?.texture
+        ? createTextureBinding(asset, material.anisotropy.texture, "linear", getTexture, "u_anisotropyTexture")
+        : Promise.resolve(undefined),
+      material.volume?.thicknessTexture
+        ? createTextureBinding(asset, material.volume.thicknessTexture, "linear", getTexture, "u_volumeThicknessTexture")
+        : Promise.resolve(undefined)
+    ]);
     const runtimeMaterial = new SkinnedLitMaterial({
       name: material.name,
       renderState,
@@ -1416,6 +1461,15 @@ async function createMaterial(
       roughness: material.roughnessFactor,
       emissiveColor: material.emissiveFactor,
       emissiveStrength: material.emissiveStrength,
+      clearcoatTexture,
+      clearcoatNormalTexture,
+      sheenColorTexture,
+      sheenRoughnessTexture,
+      transmissionTexture,
+      iridescenceTexture,
+      iridescenceThicknessTexture,
+      anisotropyTexture,
+      volumeThicknessTexture,
       ...pbrExtensionScalarOptions(material)
     });
     applyAlphaCutoff(runtimeMaterial, material);
@@ -1540,7 +1594,15 @@ async function createMaterial(
 }
 
 function createDefaultGLTFMaterial(mesh: GLTFMeshAsset, options: { readonly instanced?: boolean; readonly skinned?: boolean } = {}): Material {
-  const defaults = { name: mesh.material, metallic: 0, roughness: 1, environmentIntensity: DEFAULT_PBR_ENVIRONMENT_INTENSITY } as const;
+  // Use a neutral light-gray base color instead of glTF-spec white ([1,1,1,1])
+  // so missing-material fallbacks do not blow out as bright white artifacts.
+  const defaults = {
+    name: mesh.material,
+    baseColor: [0.76, 0.74, 0.72, 1] as const,
+    metallic: 0,
+    roughness: 0.85,
+    environmentIntensity: DEFAULT_PBR_ENVIRONMENT_INTENSITY
+  } as const;
   if (options.skinned) {
     return new SkinnedLitMaterial(defaults);
   }
@@ -1603,6 +1665,10 @@ function requiresTransparentRenderState(material: GLTFMaterialAsset): boolean {
 function isEffectivelyOpaqueBlendMaterial(material: GLTFMaterialAsset): boolean {
   if (material.alphaMode !== "BLEND") return false;
   if (material.baseColorFactor[3] < BLEND_OPAQUE_ALPHA_THRESHOLD) return false;
+  // Conservative: if a baseColorTexture is present, retain blending — the texture may
+  // carry per-texel alpha that we cannot inspect here. Flattening would depth-sort it
+  // as opaque and cause ghosting / overlay artifacts.
+  if (material.baseColorTexture) return false;
   if (materialHasTransmissionOrVolume(material)) return false;
   return true;
 }

package/src/KTX2BasisTextureTranscoder.ts

@@ -76,6 +76,7 @@ async function parseTextureLevels(
   await installNodeLoadersGLFileHooks();
   const { parse, BasisLoader } = await loadLoadersGLModules();
   const parsed = await parse(source.slice(0), BasisLoader, {
+    // worker:false is required: worker mode resolves transcoder module URLs to dev-only /node_modules paths and the Node file hooks on globalThis.loaders only exist on the main thread.
     worker: false,
     CDN: defaultLoadersGLCdn(),
     modules: defaultLoadersGLModules(),