@plasius/gpu-renderer 0.2.55 → 0.2.56

package/CHANGELOG.md

@@ -23,6 +23,20 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.2.56] - 2026-10-24
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - Reject referenced canonical unlit workflows and declared unlit extension markers until an explicit unlit shading path exists, with a bounded diagnostic that preserves the caller's previous supported rendering path.
+
+- **Security**
+  - (placeholder)
+
 ## [0.2.55] - 2026-10-24
 
 - **Added**
@@ -1315,3 +1329,4 @@ All notable changes to this project will be documented in this file.
 [0.2.53]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.53
 [0.2.54]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.54
 [0.2.55]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.55
+[0.2.56]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.56

package/README.md

@@ -78,6 +78,9 @@ Canonical blend materials multiply authored factor alpha by texture alpha once;
 opaque materials ignore both alpha channels. Direct `WavefrontMeshInput` callers
 can select `alphaMode: "opaque" | "blend"`; omitting it preserves legacy opacity
 composition. Alpha masks remain unsupported by the canonical adapter.
+Referenced canonical unlit workflows and declared `KHR_materials_unlit`/`unlit`
+extension markers are unsupported and fail explicitly. Keep those assets on an
+unlit-capable rendering path; do not drop their markers or reinterpret them as lit.
 For an interactive model viewer with loading, integrity checks, camera gestures
 and quality controls, use the shared package's `model-inspection` entry.
 

package/dist/index.cjs

@@ -1654,14 +1654,6 @@ function textureSample(binding, textures, label, extra = {}) {
 }
 function cloneMaterialExtensions(material, textures) {
   const extensions = { ...material.extensions ?? {} };
-  if (material.workflow === "unlit") {
-    const unlitKey = "KHR_materials_unlit";
-    const unlitValue = extensions[unlitKey] ?? extensions.unlit ?? {};
-    if (typeof unlitValue !== "object" || unlitValue === null || Array.isArray(unlitValue)) {
-      throw new TypeError(`Canonical material extension ${unlitKey} must be an object.`);
-    }
-    extensions[unlitKey] = { ...unlitValue, enabled: true };
-  }
   for (const [bindingName, extensionName, textureKey] of EXTENSION_TEXTURE_BINDINGS) {
     const binding = material.textures?.[bindingName];
     if (!binding) {
@@ -1686,7 +1678,10 @@ function mapMaterial(material, materialRefId, textures) {
   if (material.alphaMode === "mask") {
     throw new Error("Canonical alphaMode mask is unsupported by WavefrontMeshInput.");
   }
-  if (material.workflow !== "metallic-roughness" && material.workflow !== "unlit") {
+  if (material.workflow === "unlit" || Object.hasOwn(material.extensions ?? {}, "KHR_materials_unlit") || Object.hasOwn(material.extensions ?? {}, "unlit")) {
+    throw new Error("Canonical unlit materials are unsupported by WavefrontMeshInput; retain an unlit-capable rendering path.");
+  }
+  if (material.workflow !== "metallic-roughness") {
     throw new Error(`Unsupported canonical material workflow: ${material.workflow}.`);
   }
   const mapped = {