@plasius/gpu-renderer 0.2.52 → 0.2.54

package/CHANGELOG.md

@@ -23,6 +23,34 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.2.54] - 2026-10-21
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - Explain direct WebGPU control in the public README and keep dependency admission guidance in the development guide.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.2.53] - 2026-10-20
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - Map six additional canonical material texture channels, align canonical types with core 0.5.0, and reject unsupported UV selections or texture transforms before they can be silently ignored.
+
+- **Security**
+  - (placeholder)
+
 ## [0.2.52] - 2026-10-20
 
 - Restore consumer-first rendering examples and API guides; correct unsupported shared-helper imports and separate implementation/release notes.
@@ -1270,3 +1298,5 @@ All notable changes to this project will be documented in this file.
 [0.2.50]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.50
 [0.2.51]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.51
 [0.2.52]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.52
+[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

package/README.md

@@ -12,6 +12,10 @@ Framework-independent WebGPU rendering for browser applications. Render triangle
 meshes with the wavefront path tracer, draw native raster surfaces, or use the
 frame lifecycle and XR integration APIs in your own rendering pipeline.
 
+The APIs expose GPU resource ownership, render passes and sample accumulation
+directly. Use them from JavaScript or TypeScript when you want explicit control
+over your application's WebGPU pipeline.
+
 Apache-2.0 · ESM and CommonJS · TypeScript declarations included.
 
 ## Install
@@ -66,6 +70,10 @@ Supply decoded triangle geometry and material/texture data through `meshes`.
 The renderer does not fetch glTF files: use a loader such as
 [`@plasius/gpu-shared`](https://www.npmjs.com/package/@plasius/gpu-shared), or adapt
 canonical decoded assets with `createCanonicalWavefrontMeshInputs`.
+The canonical adapter maps the core 0.5 material texture slots; it currently
+accepts UV0 and identity texture transforms. Other selections/transforms fail
+explicitly so authored appearance is not silently changed. See the
+[canonical integration contract](docs/guides/integration.md#canonical-model-ingestion).
 For an interactive model viewer with loading, integrity checks, camera gestures
 and quality controls, use the shared package's `model-inspection` entry.
 
@@ -141,29 +149,14 @@ route capabilities and rollout policy before mounting a scene.
 
 ## Development
 
-From a checkout, using the repository's Node.js version:
-
-```sh
-npm ci --legacy-peer-deps
-npm run lint
-npm run typecheck
-npm run test:coverage
-npm run build
-npm run pack:check
-npm run zero-three
-```
+For checkout setup and required validation, start with the
+[development guide](https://github.com/Plasius-LTD/gpu-renderer/blob/main/docs/guides/development.md).
 
 `npm run demo` requires Python 3 and serves the parent workspace. With the checkout
 named `gpu-renderer`, visit `http://localhost:8000/gpu-renderer/demo/`.
-See the [development guide](https://github.com/Plasius-LTD/gpu-renderer/blob/main/docs/guides/development.md)
-for sibling-package requirements and source layout, and
+The development guide also describes the source layout. See
 [CONTRIBUTING.md](https://github.com/Plasius-LTD/gpu-renderer/blob/main/CONTRIBUTING.md).
 
-Three.js and dependency paths reaching it are prohibited across runtime,
-development tooling and published artifacts. `npm run zero-three:source` checks
-source admission before installation; `npm run zero-three` validates the installed
-and built package evidence.
-
 <!-- BEGIN PLASIUS RELEASE INTEGRITY -->
 ## Release integrity
 

package/dist/index.cjs

@@ -1595,7 +1595,13 @@ var EXTENSION_TEXTURE_BINDINGS = Object.freeze([
   ["clearcoatNormal", "clearcoat", "clearcoatNormalTexture"],
   ["transmission", "transmission", "transmissionTexture"],
   ["sheenColor", "sheen", "sheenColorTexture"],
-  ["sheenRoughness", "sheen", "sheenRoughnessTexture"]
+  ["sheenRoughness", "sheen", "sheenRoughnessTexture"],
+  ["thickness", "volume", "thicknessTexture"],
+  ["specular", "specular", "specularTexture"],
+  ["specularColor", "specular", "specularColorTexture"],
+  ["iridescence", "iridescence", "iridescenceTexture"],
+  ["iridescenceThickness", "iridescence", "iridescenceThicknessTexture"],
+  ["anisotropy", "anisotropy", "anisotropyTexture"]
 ]);
 function requireArray(value, label) {
   if (!Array.isArray(value)) {
@@ -1617,6 +1623,16 @@ function textureSample(binding, textures, label, extra = {}) {
   if (!sample) {
     throw new Error(`Missing decoded texture sample ${binding.textureId} for ${label}.`);
   }
+  if (binding.texCoordSet !== void 0 && binding.texCoordSet !== 0 || sample.texCoord !== void 0 && sample.texCoord !== 0) {
+    throw new Error("Canonical texture sampling supports only UV set 0.");
+  }
+  const transform = binding.transform;
+  if (transform !== void 0) {
+    const identityPair = (value, expected) => value === void 0 || Array.isArray(value) && value.length === 2 && value[0] === expected && value[1] === expected;
+    if (!transform || typeof transform !== "object" || Array.isArray(transform) || Object.keys(transform).some((key) => !["offset", "scale", "rotationRadians"].includes(key)) || !identityPair(transform.offset, 0) || !identityPair(transform.scale, 1) || transform.rotationRadians !== void 0 && transform.rotationRadians !== 0) {
+      throw new Error("Canonical texture transforms require upstream application and identity bindings.");
+    }
+  }
   const width = Number(sample.width);
   const height = Number(sample.height);
   const data = sample.data;