@woosh/meep-engine 3.45.0 → 3.47.0

package/src/format/image/png/crc32.d.ts

@@ -1,2 +1,2 @@
-export { crc32 } from "../../../core/binary/hash/crc32.js";
+export { crc32 } from "../../../core/math/hash/crc32.js";
 //# sourceMappingURL=crc32.d.ts.map

package/src/format/image/png/crc32.js

@@ -1,8 +1,7 @@
-/**
- * @deprecated Moved to `core/binary/hash/crc32.js`. CRC-32/ISO-3309 is not a PNG algorithm — PNG
- * merely happens to be the first thing in the tree that needed it.
- *
- * Kept as a re-export rather than removed: this is a library, and an import path is as much a
- * published interface as a function signature.
- */
-export { crc32 } from "../../../core/binary/hash/crc32.js";
+// CRC-32/ISO-3309 is not a PNG algorithm — PNG merely happens to be the first thing in the tree that
+// needed it. Kept as a re-export rather than removed: this is a library, and an import path is as much
+// a published interface as a function signature.
+export {
+    /** @deprecated moved to core/math/hash/crc32.js; import it from there */
+    crc32
+} from "../../../core/math/hash/crc32.js";

package/src/shade/RENDERER_CONTRACT.md

@@ -56,12 +56,15 @@ beyond it and no branch that produces a lesser frame.
 
 **Required limits:**
 
-- `maxStorageBuffersPerShaderStage` ≥ **10** (checked against the adapter before the device is
-  requested, so the failure names the number the adapter offered)
+- `maxStorageBuffersPerShaderStage` ≥ **10**
 - `maxColorAttachmentBytesPerSample` ≥ **32** — the G-buffer is wide
 - `maxBufferSize` and `maxStorageBufferBindingSize` are requested at whatever the adapter offers,
   because the defaults are far too small
 
+The required features and the two fixed limits are one definition, `device/SHADE_DEVICE_FLOOR.js`.
+All of it is checked against the adapter before a device is requested, so a refusal names every
+feature and limit the adapter lacks, with the value it offers, rather than the first one found.
+
 **Taken when offered, never required:** `timestamp-query`, `subgroups`, `texture-formats-tier1`.
 `timestamp-query` drives GPU timers and nothing else, and some browsers withhold it on hardware that
 is otherwise fine — so the timers go quiet when it is absent rather than the renderer refusing to
@@ -76,7 +79,7 @@ person rather than logged. It distinguishes:
 |---|---|
 | `webgpu_unavailable` | no `navigator.gpu` — WebGPU disabled or unsupported |
 | `adapter_unavailable` | no adapter at all |
-| `below_floor` | an adapter that does not meet §2, with the detail |
+| `below_floor` | an adapter that does not meet §2; the message lists every unmet feature and limit |
 | `device_request_failed` | the adapter refused the device |
 | `device_lost` | a working device went away while running |
 

package/src/shade/descriptor/binding/BindGroupLayoutDescriptor.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import { computeHashArray } from "../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../core/model/object/invokeObjectHash.js";
@@ -120,7 +120,7 @@ export class BindGroupLayoutDescriptor extends ObjectDescriptorBase {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             super.hash(),
             computeHashArray(this.entries, invokeObjectHash),
         );

package/src/shade/descriptor/binding/BindGroupLayoutEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BindGroupLayoutEntry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/binding/BindGroupLayoutEntry.js"],"names":[],"mappings":"AAWA;;GAEG;AACH,6CAFgB,uBAAuB;IA8CnC;;;;;OAKG;IACH,2BAJW,oBAAoB,KACpB,oBAAoB,GAClB,MAAM,CAIlB;IAED,iDAMC;IA3DD;;;OAGG;IACH,SAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,YAFU,MAAM,sBAAoB,CAEtB;IAEd;;;OAGG;IACH,QAFU,mBAAmB,CAEvB;IAEN;;;OAGG;IACH,SAFU,oBAAoB,CAEvB;IAEP;;;OAGG;IACH,SAFU,oBAAoB,CAEvB;IAEP;;;OAGG;IACH,gBAFU,2BAA2B,CAEvB;IAGd;;;OAGG;IACH,iBAFU,4BAA4B,CAEvB;IAoBf;;;OAGG;IACH,oBAFW,mBAAmB,GAAC,oBAAoB,GAAC,oBAAoB,GAAC,2BAA2B,GAAC,4BAA4B,QAmBhI;IAGD;;;;;;;;aA6CC;IAED,eAUC;IAED;;;;OAIG;IACH,cAHW,oBAAoB,GAClB,OAAO,CAanB;IAED;;;OAGG;IACH,YAFW,oBAAoB,QAU9B;IAED;;;OAGG;IACH,SAFY,oBAAoB,CAQ/B;CACJ;oCArMmC,0BAA0B;qCAEzB,2BAA2B;qCAE3B,2BAA2B;4CADpB,kCAAkC;6CAFjC,mCAAmC"}
+{"version":3,"file":"BindGroupLayoutEntry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/binding/BindGroupLayoutEntry.js"],"names":[],"mappings":"AAWA;;GAEG;AACH,6CAFgB,uBAAuB;IA8CnC;;;;;OAKG;IACH,2BAJW,oBAAoB,KACpB,oBAAoB,GAClB,MAAM,CAIlB;IAED,iDAMC;IA3DD;;;OAGG;IACH,SAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,YAFU,MAAM,sBAAoB,CAEtB;IAEd;;;OAGG;IACH,QAFU,mBAAmB,CAEvB;IAEN;;;OAGG;IACH,SAFU,oBAAoB,CAEvB;IAEP;;;OAGG;IACH,SAFU,oBAAoB,CAEvB;IAEP;;;OAGG;IACH,gBAFU,2BAA2B,CAEvB;IAGd;;;OAGG;IACH,iBAFU,4BAA4B,CAEvB;IAoBf;;;OAGG;IACH,oBAFW,mBAAmB,GAAC,oBAAoB,GAAC,oBAAoB,GAAC,2BAA2B,GAAC,4BAA4B,QAmBhI;IAGD;;;;;;;;aA6CC;IAED,eAcC;IAED;;;;OAIG;IACH,cAHW,oBAAoB,GAClB,OAAO,CAanB;IAED;;;OAGG;IACH,YAFW,oBAAoB,QAU9B;IAED;;;OAGG;IACH,SAFY,oBAAoB,CAQ/B;CACJ;oCAzMmC,0BAA0B;qCAEzB,2BAA2B;qCAE3B,2BAA2B;4CADpB,kCAAkC;6CAFjC,mCAAmC"}

package/src/shade/descriptor/binding/BindGroupLayoutEntry.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { optional_clone } from "../../../core/model/object/optional_clone.js";
 import { optional_equality } from "../../../core/model/object/optional_equality.js";
 import { optional_hash } from "../../../core/model/object/optional_hash.js";
@@ -146,14 +146,18 @@ export class BindGroupLayoutEntry {
     }
 
     hash() {
-        return combine_hash(
-            this.binding,
-            this.visibility,
-            optional_hash(this.buffer),
-            optional_hash(this.sampler),
-            optional_hash(this.texture),
+        return hash_mix3(
+            hash_mix3(
+                hash_mix3(
+                    this.binding,
+                    this.visibility,
+                    optional_hash(this.buffer)
+                ),
+                optional_hash(this.sampler),
+                optional_hash(this.texture)
+            ),
             optional_hash(this.storageTexture),
-            optional_hash(this.externalTexture),
+            optional_hash(this.externalTexture)
         )
     }
 

package/src/shade/descriptor/binding/StorageTextureBindingLayout.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 
 export class StorageTextureBindingLayout {
@@ -45,7 +45,7 @@ export class StorageTextureBindingLayout {
 
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.access),
             computeStringHash(this.format),
             computeStringHash(this.viewDimension),

package/src/shade/descriptor/binding/TextureBindingLayout.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 
 export class TextureBindingLayout {
@@ -47,7 +47,7 @@ export class TextureBindingLayout {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.sampleType),
             computeStringHash(this.viewDimension),
             this.multisampled ? 1 : 0

package/src/shade/descriptor/blend/BlendComponent.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 
 /**
@@ -41,7 +41,7 @@ export class BlendComponent {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.operation),
             computeStringHash(this.srcFactor),
             computeStringHash(this.dstFactor),

package/src/shade/descriptor/pipeline/PipelineDescriptorBase.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import { optional_clone } from "../../../core/model/object/optional_clone.js";
 import { ObjectDescriptorBase } from "../ObjectDescriptorBase.js";
 import { PipelineLayoutDescriptor } from "./PipelineLayoutDescriptor.js";
@@ -30,7 +30,7 @@ export class PipelineDescriptorBase extends ObjectDescriptorBase {
 
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             super.hash(),
             this.layout.hash()
         );

package/src/shade/descriptor/pipeline/PipelineLayoutDescriptor.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeHashArray } from "../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../core/model/object/invokeObjectHash.js";
@@ -128,7 +128,7 @@ export class PipelineLayoutDescriptor extends ObjectDescriptorBase {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             super.hash(),
             computeHashArray(this.bindGroupLayouts, invokeObjectHash),
             // two layouts that differ only in immediate size are different layouts; leaving this out

package/src/shade/descriptor/pipeline/ProgrammableStage.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import { isArrayEqualStrict } from "../../../core/collection/array/isArrayEqualStrict.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 import { ShaderModuleDescriptor } from "./ShaderModuleDescriptor.js";
@@ -55,7 +55,7 @@ export class ProgrammableStage {
 
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             this.module.hash(),
             computeStringHash(this.entryPoint)
         );

package/src/shade/descriptor/pipeline/compute/ComputePipelineDescriptor.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
 import {
     compute_infer_workgroup_size_from_source
 } from "../../../renderer/shader/util/compute_infer_workgroup_size_from_source.js";
@@ -175,7 +175,7 @@ export class ComputePipelineDescriptor extends PipelineDescriptorBase {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             super.hash(),
             this.compute.hash()
         );

package/src/shade/descriptor/pipeline/render/ColorTargetState.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 import { optional_clone } from "../../../../core/model/object/optional_clone.js";
 import { optional_equality } from "../../../../core/model/object/optional_equality.js";
@@ -96,7 +96,7 @@ export class ColorTargetState {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.format),
             this.writeMask,
             optional_hash(this.blend)

package/src/shade/descriptor/pipeline/render/FragmentState.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
 import { computeHashArray } from "../../../../core/collection/array/computeHashArray.js";
 import { isArrayEqual } from "../../../../core/collection/array/isArrayEqual.js";
 import { invokeObjectHash } from "../../../../core/model/object/invokeObjectHash.js";
@@ -78,7 +78,7 @@ export class FragmentState extends ProgrammableStage {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             super.hash(),
             computeHashArray(this.targets, invokeObjectHash)
         );

package/src/shade/descriptor/pipeline/render/PrimitiveState.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 
 const DEFAULT_TOPOLOGY = "triangle-list";
@@ -101,7 +101,7 @@ export class PrimitiveState {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.topology),
             computeStringHash(this.frontFace),
             computeStringHash(this.cullMode),

package/src/shade/descriptor/pipeline/render/RenderPipelineDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderPipelineDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/descriptor/pipeline/render/RenderPipelineDescriptor.js"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH;IA6BI;;;OAGG;IACH,iDAMC;IAtCD;;;OAGG;IACH,QAFU,WAAW,CAEM;IAE3B;;OAEG;IACH,WAFU,cAAc,CAES;IAEjC;;OAEG;IACH,cAFU,iBAAiB,GAAC,SAAS,CAExB;IAEb;;OAEG;IACH,aAFU,gBAAgB,CAEW;IAErC;;;OAGG;IACH,UAFU,aAAa,GAAC,SAAS,CAExB;IAeT;;;OAGG;IACH,kDA4BC;IAED;;;;OAIG;IACH,cAHW,wBAAwB,GACvB,OAAO,CA4BlB;IAeD;;;OAGG;IACH,YAFW,wBAAwB,QAUlC;IAED;;;OAGG;IACH,SAFY,wBAAwB,CAQnC;IAGL,oCAA6D;CAF5D;uCAjKsC,8BAA8B;4BAKzC,kBAAkB;+BADf,qBAAqB;kCAHlB,wBAAwB;iCAEzB,uBAAuB;8BAD1B,oBAAoB"}
+{"version":3,"file":"RenderPipelineDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/descriptor/pipeline/render/RenderPipelineDescriptor.js"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH;IA6BI;;;OAGG;IACH,iDAMC;IAtCD;;;OAGG;IACH,QAFU,WAAW,CAEM;IAE3B;;OAEG;IACH,WAFU,cAAc,CAES;IAEjC;;OAEG;IACH,cAFU,iBAAiB,GAAC,SAAS,CAExB;IAEb;;OAEG;IACH,aAFU,gBAAgB,CAEW;IAErC;;;OAGG;IACH,UAFU,aAAa,GAAC,SAAS,CAExB;IAeT;;;OAGG;IACH,kDA4BC;IAED;;;;OAIG;IACH,cAHW,wBAAwB,GACvB,OAAO,CA4BlB;IAiBD;;;OAGG;IACH,YAFW,wBAAwB,QAUlC;IAED;;;OAGG;IACH,SAFY,wBAAwB,CAQnC;IAGL,oCAA6D;CAF5D;uCAnKsC,8BAA8B;4BAKzC,kBAAkB;+BADf,qBAAqB;kCAHlB,wBAAwB;iCAEzB,uBAAuB;8BAD1B,oBAAoB"}

package/src/shade/descriptor/pipeline/render/RenderPipelineDescriptor.js

@@ -1,5 +1,6 @@
 import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
 import { optional_clone } from "../../../../core/model/object/optional_clone.js";
 import { optional_equality } from "../../../../core/model/object/optional_equality.js";
 import { optional_hash } from "../../../../core/model/object/optional_hash.js";
@@ -131,10 +132,12 @@ export class RenderPipelineDescriptor extends PipelineDescriptorBase {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
-            super.hash(),
-            this.vertex.hash(),
-            this.primitive.hash(),
+        return hash_mix2(
+            hash_mix3(
+                super.hash(),
+                this.vertex.hash(),
+                this.primitive.hash()
+            ),
             optional_hash(this.fragment)
         );
     }

package/src/shade/descriptor/pipeline/render/VertexAttribute.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 
 /**
@@ -50,7 +50,7 @@ export class VertexAttribute {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.format),
             this.offset,
             this.shaderLocation

package/src/shade/descriptor/texture/SamplerDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SamplerDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/texture/SamplerDescriptor.js"],"names":[],"mappings":"AAIA;;GAEG;AACH,uEAFe,oBAAoB;IAyE/B;;;OAGG;IACH,wDAOC;IAjFD;;OAEG;IACH,6BAA8B;IAC9B;;OAEG;IACH,6BAA8B;IAC9B;;OAEG;IACH,6BAA8B;IAE9B;;OAEG;IACH,yBAAqB;IACrB;;OAEG;IACH,yBAAqB;IACrB;;OAEG;IACH,kCAAwB;IAExB,oBAAgB;IAChB,oBAAiB;IAEjB,sBAAiB;IAEjB;;;OAGG;IACH,4BAAQ;IAIR;;;;;;;;;;;;aA6BC;IAeD,4BAgBC;IAmCL;;;OAGG;IACH,8BAFU,OAAO,CAE8B;;CAN9C;qCA1IoC,4BAA4B"}
+{"version":3,"file":"SamplerDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/texture/SamplerDescriptor.js"],"names":[],"mappings":"AAIA;;GAEG;AACH,uEAFe,oBAAoB;IAyE/B;;;OAGG;IACH,wDAOC;IAjFD;;OAEG;IACH,6BAA8B;IAC9B;;OAEG;IACH,6BAA8B;IAC9B;;OAEG;IACH,6BAA8B;IAE9B;;OAEG;IACH,yBAAqB;IACrB;;OAEG;IACH,yBAAqB;IACrB;;OAEG;IACH,kCAAwB;IAExB,oBAAgB;IAChB,oBAAiB;IAEjB,sBAAiB;IAEjB;;;OAGG;IACH,4BAAQ;IAIR;;;;;;;;;;;;aA6BC;IAeD,4BAgBC;IA2CL;;;OAGG;IACH,8BAFU,OAAO,CAE8B;;CAN9C;qCAlJoC,4BAA4B"}

package/src/shade/descriptor/texture/SamplerDescriptor.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 import { ObjectDescriptorBase } from "../ObjectDescriptorBase.js";
 
@@ -108,18 +108,26 @@ export class SamplerDescriptor extends ObjectDescriptorBase {
     }
 
     #compute_hash(){
-        let h = combine_hash(
-            super.hash(),
-            computeStringHash(this.addressModeU),
-            computeStringHash(this.addressModeV),
-            computeStringHash(this.addressModeW),
-            computeStringHash(this.magFilter),
-            computeStringHash(this.minFilter),
-            computeStringHash(this.mipmapFilter),
-            this.lodMinClamp,
-            this.lodMaxClamp,
+        let h = hash_mix3(
+            hash_mix3(
+                hash_mix3(
+                    hash_mix3(
+                        hash_mix3(
+                            super.hash(),
+                            computeStringHash(this.addressModeU),
+                            computeStringHash(this.addressModeV)
+                        ),
+                        computeStringHash(this.addressModeW),
+                        computeStringHash(this.magFilter)
+                    ),
+                    computeStringHash(this.minFilter),
+                    computeStringHash(this.mipmapFilter)
+                ),
+                this.lodMinClamp,
+                this.lodMaxClamp
+            ),
             this.maxAnisotropy,
-            computeStringHash(this.compare),
+            computeStringHash(this.compare)
         );
 
         if(h === -1){

package/src/shade/descriptor/texture/TextureDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/texture/TextureDescriptor.js"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,uEAFe,oBAAoB;IA6J/B;;;;OAIG;IACH,yCAFY,iBAAiB,CAQ5B;IA9JD,sBAAkB;IAClB,oBAAgB;IAEhB;;;OAGG;IACH,+BAAiB;IAEjB;;OAEG;IACH,yBAAsB;IAEtB;;OAEG;IACH,OAFU,MAAM,uBAAqB,CAEG;IAExC;;;OAGG;IACH,aAFU,kBAAkB,CAEX;IAEjB;;;OAGG;IACH,eAAyB;IAEzB;;;OAGG;IACH;eAU4B,MAAM;gBAAS,MAAM;4BAAqB,MAAM;OAJ3E;IAED;;;OAGG;IACH;eAF4B,MAAM;gBAAS,MAAM;4BAAqB,MAAM;MAI3E;IAGD;;;;;OAKG;IACH,+BAuBC;IAED;;;;OAIG;IACH,cAHW,iBAAiB,GAChB,OAAO,CAelB;IAED;;;OAGG;IACH,YAFW,iBAAiB,QAa3B;IAcD;;;OAGG;IACH,uCASC;IAeD;;;OAGG;IACH,2CAwCC;IAIL;;;OAGG;IACH,8BAFU,OAAO,CAE8B;;CAP9C;qCAjPoC,4BAA4B"}
+{"version":3,"file":"TextureDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/descriptor/texture/TextureDescriptor.js"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,uEAFe,oBAAoB;IAiK/B;;;;OAIG;IACH,yCAFY,iBAAiB,CAQ5B;IAlKD,sBAAkB;IAClB,oBAAgB;IAEhB;;;OAGG;IACH,+BAAiB;IAEjB;;OAEG;IACH,yBAAsB;IAEtB;;OAEG;IACH,OAFU,MAAM,uBAAqB,CAEG;IAExC;;;OAGG;IACH,aAFU,kBAAkB,CAEX;IAEjB;;;OAGG;IACH,eAAyB;IAEzB;;;OAGG;IACH;eAU4B,MAAM;gBAAS,MAAM;4BAAqB,MAAM;OAJ3E;IAED;;;OAGG;IACH;eAF4B,MAAM;gBAAS,MAAM;4BAAqB,MAAM;MAI3E;IAGD;;;;;OAKG;IACH,+BAuBC;IAED;;;;OAIG;IACH,cAHW,iBAAiB,GAChB,OAAO,CAelB;IAED;;;OAGG;IACH,YAFW,iBAAiB,QAa3B;IAkBD;;;OAGG;IACH,uCASC;IAeD;;;OAGG;IACH,2CAwCC;IAIL;;;OAGG;IACH,8BAFU,OAAO,CAE8B;;CAP9C;qCArPoC,4BAA4B"}

package/src/shade/descriptor/texture/TextureDescriptor.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
 import { computeIntegerArrayHash } from "../../../core/collection/array/computeIntegerArrayHash.js";
 import { isArrayEqualStrict } from "../../../core/collection/array/isArrayEqualStrict.js";
 import Signal from "../../../core/events/signal/Signal.js";
@@ -163,12 +163,16 @@ export class TextureDescriptor extends ObjectDescriptorBase {
     }
 
     hash() {
-        return combine_hash(
-            computeIntegerArrayHash(this.#size, 0, this.#size.length),
-            this.mipLevelCount,
-            this.sampleCount,
-            computeStringHash(this.dimension),
-            computeStringHash(this.format),
+        return hash_mix3(
+            hash_mix3(
+                hash_mix3(
+                    computeIntegerArrayHash(this.#size, 0, this.#size.length),
+                    this.mipLevelCount,
+                    this.sampleCount
+                ),
+                computeStringHash(this.dimension),
+                computeStringHash(this.format)
+            ),
             this.usage,
             super.hash()
         )

package/src/shade/device/SHADE_DEVICE_FLOOR.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What an adapter must offer for Shade to run at all — `RENDERER_CONTRACT.md` §2.
+ *
+ * Fixed, with no tiers below it: `Renderer.initialize()` checks an adapter against this before it
+ * asks for a device, refuses one that falls short with every gap named (see
+ * {@link shade_device_floor_unmet}), and requests exactly this from one that does not.
+ *
+ * Every limit here is `maximum`-class — an adapter meets it by offering at least the value. An
+ * `alignment`-class limit is met by offering at most, and would need its own comparison.
+ *
+ * @readonly
+ */
+export const SHADE_DEVICE_FLOOR: Readonly<{
+    /**
+     * @type {ReadonlyArray<WebGPUExtensionType>}
+     */
+    features: ReadonlyArray<WebGPUExtensionType>;
+    /**
+     * @type {Readonly<Record<string, number>>}
+     */
+    limits: Readonly<Record<string, number>>;
+}>;
+import { WebGPUExtensionType } from "../descriptor/WebGPUExtensionType.js";
+//# sourceMappingURL=SHADE_DEVICE_FLOOR.d.ts.map

package/src/shade/device/SHADE_DEVICE_FLOOR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SHADE_DEVICE_FLOOR.d.ts","sourceRoot":"","sources":["../../../../src/shade/device/SHADE_DEVICE_FLOOR.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH;IACI;;OAEG;cADO,cAAc,mBAAmB,CAAC;IAS5C;;OAEG;YADO,SAAS,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;GAO3C;oCAjCiC,sCAAsC"}

package/src/shade/device/SHADE_DEVICE_FLOOR.js

@@ -0,0 +1,34 @@
+import { WebGPUExtensionType } from "../descriptor/WebGPUExtensionType.js";
+
+/**
+ * What an adapter must offer for Shade to run at all — `RENDERER_CONTRACT.md` §2.
+ *
+ * Fixed, with no tiers below it: `Renderer.initialize()` checks an adapter against this before it
+ * asks for a device, refuses one that falls short with every gap named (see
+ * {@link shade_device_floor_unmet}), and requests exactly this from one that does not.
+ *
+ * Every limit here is `maximum`-class — an adapter meets it by offering at least the value. An
+ * `alignment`-class limit is met by offering at most, and would need its own comparison.
+ *
+ * @readonly
+ */
+export const SHADE_DEVICE_FLOOR = Object.freeze({
+    /**
+     * @type {ReadonlyArray<WebGPUExtensionType>}
+     */
+    features: Object.freeze([
+        // indirect draw is used throughout
+        WebGPUExtensionType.IndirectFirstInstance,
+        // the MBOIT transparency mode blends into 32-bit float targets; stays while MBOIT is selectable
+        WebGPUExtensionType.Float32Blendable,
+    ]),
+
+    /**
+     * @type {Readonly<Record<string, number>>}
+     */
+    limits: Object.freeze({
+        maxStorageBuffersPerShaderStage: 10,
+        // the G-buffer is wide
+        maxColorAttachmentBytesPerSample: 32,
+    }),
+});

package/src/shade/device/ShadeDeviceFailure.d.ts

@@ -2,12 +2,18 @@
  * Why there is no usable device, in a form a host can act on.
  *
  * It is an `Error` because that is what the failure paths already throw and callers already
- * `catch`, and it carries a {@link ShadeDeviceFailureReason} because a host showing this to a player
+ * `catch`, and it carries a {@link ShadeDeviceFailureReason} because a host showing this to a person
  * needs to distinguish "your browser cannot do this at all" from "your GPU is below what this needs"
  * from "the GPU went away" — three different things to tell somebody, and none of them a stack
  * trace.
  *
- * `detail` holds the specific thing that was missing, for the log rather than the player.
+ * The `message` is written to be shown as it is. Where the specifics are something a person can act
+ * on — which features and limits the hardware lacks, what the browser refused — it names them, so
+ * that what reaches a support thread is the answer rather than a request for logs. `detail` holds
+ * the specifics alone, for a host that phrases its own message.
+ *
+ * Nothing here assumes what the application is: the same engine runs games, CAD tools and product
+ * visualizers, and they all show these messages.
  */
 export class ShadeDeviceFailure extends Error {
     /**
@@ -19,12 +25,13 @@ export class ShadeDeviceFailure extends Error {
      */
     static adapter_unavailable(): ShadeDeviceFailure;
     /**
-     * @param {string} detail what was missing
+     * @param {string[]} unmet every requirement the adapter falls short of, as
+     * {@link shade_device_floor_unmet} phrases them
      * @returns {ShadeDeviceFailure}
      */
-    static below_floor(detail: string): ShadeDeviceFailure;
+    static below_floor(unmet: string[]): ShadeDeviceFailure;
     /**
-     * @param {string} detail
+     * @param {string} detail what the browser said when it refused
      * @returns {ShadeDeviceFailure}
      */
     static device_request_failed(detail: string): ShadeDeviceFailure;

package/src/shade/device/ShadeDeviceFailure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShadeDeviceFailure.d.ts","sourceRoot":"","sources":["../../../../src/shade/device/ShadeDeviceFailure.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH;IA2BI;;OAEG;IACH,6BAFa,kBAAkB,CAQ9B;IAED;;OAEG;IACH,8BAFa,kBAAkB,CAQ9B;IAED;;;OAGG;IACH,2BAHW,MAAM,GACJ,kBAAkB,CAQ9B;IAED;;;OAGG;IACH,qCAHW,MAAM,GACJ,kBAAkB,CAQ9B;IAED;;;OAGG;IACH,2BAHW,MAAM,GACJ,kBAAkB,CAQ9B;IArED;;;;OAIG;IACH,oBAJW,wBAAwB,WACxB,MAAM,WACN,MAAM,EAQhB;IAxBD;;OAEG;IACH,QAFU,wBAAwB,CAEkB;IAEpD;;;;;OAKG;IACH,QAFU,MAAM,CAEJ;IA0EhB;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CANhD;yCAjGwC,+BAA+B"}
+{"version":3,"file":"ShadeDeviceFailure.d.ts","sourceRoot":"","sources":["../../../../src/shade/device/ShadeDeviceFailure.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH;IA2BI;;OAEG;IACH,6BAFa,kBAAkB,CAQ9B;IAED;;OAEG;IACH,8BAFa,kBAAkB,CAQ9B;IAED;;;;OAIG;IACH,0BAJW,MAAM,EAAE,GAEN,kBAAkB,CAU9B;IAED;;;OAGG;IACH,qCAHW,MAAM,GACJ,kBAAkB,CAQ9B;IAED;;;OAGG;IACH,2BAHW,MAAM,GACJ,kBAAkB,CAQ9B;IAxED;;;;OAIG;IACH,oBAJW,wBAAwB,WACxB,MAAM,WACN,MAAM,EAQhB;IAxBD;;OAEG;IACH,QAFU,wBAAwB,CAEkB;IAEpD;;;;;OAKG;IACH,QAFU,MAAM,CAEJ;IA6EhB;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CANhD;yCA1GwC,+BAA+B"}

package/src/shade/device/ShadeDeviceFailure.js

@@ -4,12 +4,18 @@ import { ShadeDeviceFailureReason } from "./ShadeDeviceFailureReason.js";
  * Why there is no usable device, in a form a host can act on.
  *
  * It is an `Error` because that is what the failure paths already throw and callers already
- * `catch`, and it carries a {@link ShadeDeviceFailureReason} because a host showing this to a player
+ * `catch`, and it carries a {@link ShadeDeviceFailureReason} because a host showing this to a person
  * needs to distinguish "your browser cannot do this at all" from "your GPU is below what this needs"
  * from "the GPU went away" — three different things to tell somebody, and none of them a stack
  * trace.
  *
- * `detail` holds the specific thing that was missing, for the log rather than the player.
+ * The `message` is written to be shown as it is. Where the specifics are something a person can act
+ * on — which features and limits the hardware lacks, what the browser refused — it names them, so
+ * that what reaches a support thread is the answer rather than a request for logs. `detail` holds
+ * the specifics alone, for a host that phrases its own message.
+ *
+ * Nothing here assumes what the application is: the same engine runs games, CAD tools and product
+ * visualizers, and they all show these messages.
  */
 export class ShadeDeviceFailure extends Error {
     /**
@@ -44,7 +50,7 @@ export class ShadeDeviceFailure extends Error {
     static webgpu_unavailable() {
         return new ShadeDeviceFailure(
             ShadeDeviceFailureReason.WebGPUUnavailable,
-            "This browser does not support WebGPU, which this game requires.",
+            "This browser does not support WebGPU, which this application requires.",
             "navigator.gpu is undefined"
         );
     }
@@ -61,25 +67,28 @@ export class ShadeDeviceFailure extends Error {
     }
 
     /**
-     * @param {string} detail what was missing
+     * @param {string[]} unmet every requirement the adapter falls short of, as
+     * {@link shade_device_floor_unmet} phrases them
      * @returns {ShadeDeviceFailure}
      */
-    static below_floor(detail) {
+    static below_floor(unmet) {
+        const detail = unmet.join('; ');
+
         return new ShadeDeviceFailure(
             ShadeDeviceFailureReason.BelowFloor,
-            "This graphics hardware is below the minimum this game requires.",
+            `This graphics hardware does not meet this application's minimum requirements: ${detail}.`,
             detail
         );
     }
 
     /**
-     * @param {string} detail
+     * @param {string} detail what the browser said when it refused
      * @returns {ShadeDeviceFailure}
      */
     static device_request_failed(detail) {
         return new ShadeDeviceFailure(
             ShadeDeviceFailureReason.DeviceRequestFailed,
-            "The graphics device could not be created.",
+            `The graphics device could not be created: ${detail}`,
             detail
         );
     }

package/src/shade/device/ShadeDeviceFailureReason.d.ts

@@ -4,7 +4,7 @@
  * The device floor is deliberate and fixed (D6/I-8): there are no degradation tiers, no WebGL
  * fallback and no feature-detection branches. Hardware below the floor is not accommodated — it is
  * told, clearly, that it cannot run this. That makes the *message* the entire below-floor
- * behaviour the engine owes, and a reason code is what lets a host phrase it for a player rather
+ * behaviour the engine owes, and a reason code is what lets a host phrase it for a person rather
  * than showing them a stack trace.
  */
 export type ShadeDeviceFailureReason = number;

package/src/shade/device/ShadeDeviceFailureReason.js

@@ -4,7 +4,7 @@
  * The device floor is deliberate and fixed (D6/I-8): there are no degradation tiers, no WebGL
  * fallback and no feature-detection branches. Hardware below the floor is not accommodated — it is
  * told, clearly, that it cannot run this. That makes the *message* the entire below-floor
- * behaviour the engine owes, and a reason code is what lets a host phrase it for a player rather
+ * behaviour the engine owes, and a reason code is what lets a host phrase it for a person rather
  * than showing them a stack trace.
  *
  * @enum {number}
@@ -23,7 +23,7 @@ export const ShadeDeviceFailureReason = {
 
     /**
      * An adapter exists and is below the floor — a required feature or limit is missing. The
-     * failure names which one.
+     * failure names every one.
      */
     BelowFloor: 2,
 

package/src/shade/device/graph/BufferResourceDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BufferResourceDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/device/graph/BufferResourceDescriptor.js"],"names":[],"mappings":"AAUA;IAkGI;;;;OAIG;IACH,0CAFa,wBAAwB,CAWpC;IAED;;;;;;;;OAQG;IACH,mBAJW,MAAM,SACN,iBAAe,MAAM,GACnB,wBAAwB,CASpC;IAED;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,iBAAe,MAAM,iBACrB,MAAM,eACN,MAAM,GACJ,wBAAwB,CAsCpC;IA/KD;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;;;;OAMG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,4BAAoC;IAUpC;;;OAGG;IACH,YAFW,wBAAwB,QAOlC;IAED;;;OAGG;IACH,SAFY,wBAAwB,CAQnC;IAcD,4BAMC;IAED;;;;OAIG;IACH,eAHW,wBAAwB,GACvB,MAAM,CAoBjB;IAmFL;;;OAGG;IACH,4BAFU,OAAO,CAE4C;CAN5D;mCArLM,4EAA4E"}
+{"version":3,"file":"BufferResourceDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/device/graph/BufferResourceDescriptor.js"],"names":[],"mappings":"AAWA;IAoGI;;;;OAIG;IACH,0CAFa,wBAAwB,CAWpC;IAED;;;;;;;;OAQG;IACH,mBAJW,MAAM,SACN,iBAAe,MAAM,GACnB,wBAAwB,CASpC;IAED;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,iBAAe,MAAM,iBACrB,MAAM,eACN,MAAM,GACJ,wBAAwB,CAsCpC;IAjLD;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;;;;OAMG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,4BAAoC;IAUpC;;;OAGG;IACH,YAFW,wBAAwB,QAOlC;IAED;;;OAGG;IACH,SAFY,wBAAwB,CAQnC;IAgBD,4BAMC;IAED;;;;OAIG;IACH,eAHW,wBAAwB,GACvB,MAAM,CAoBjB;IAmFL;;;OAGG;IACH,4BAFU,OAAO,CAE4C;CAN5D;mCAvLM,4EAA4E"}