@woosh/meep-engine 3.45.0 → 3.46.0

package/src/shade/device/graph/TextureResourceDescriptor.js

@@ -1,174 +1,179 @@
-import { assert } from "../../../core/assert.js";
-import { array_copy } from "../../../core/collection/array/array_copy.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
-import { isArrayEqualStrict } from "../../../core/collection/array/isArrayEqualStrict.js";
-import { computeHashFloatArray } from "../../../core/math/hash/computeHashFloatArray.js";
-import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
-import {
-    ResourceDescriptor
-} from "../../../engine/graphics/render/frame_graph/resource/ResourceDescriptor.js";
-import { texture_mip_level_count } from "../../util/texture_mip_extent.js";
-import { decode_bitmask_enum } from "../decode_bitmask_enum.js";
-import { GPUTextureUsage } from "../../descriptor/GPUTextureUsage.js";
-
-/**
- * **Vestigial.** Nothing branches on it — see {@link TextureResourceDescriptor.resolution_domain}.
- *
- * @enum {number}
- */
-export const TextureResolutionDomain = {
-    Absolute: 0,
-    PresentationRelative: 1
-}
-
-export class TextureResourceDescriptor extends ResourceDescriptor {
-    /**
-     * **Vestigial. Do not read this to decide how to interpret {@link resolution}.**
-     *
-     * No code branches on it; only {@link hash} folds it in. {@link from} stores whatever
-     * resolution it is given without touching this field, and every caller gives it pixels — so a
-     * descriptor's resolution is absolute pixels whatever this says, including on the default
-     * `PresentationRelative` that {@link from} leaves in place.
-     *
-     * @type {TextureResolutionDomain|number}
-     */
-    resolution_domain = TextureResolutionDomain.PresentationRelative;
-
-    // TODO use Uint32 instead
-    resolution = new Float64Array([1, 1, 1]);
-    sampleCount = 1;
-
-    mipLevelCount = 1;
-
-    /**
-     *
-     * @type {GPUTextureDimension|string}
-     */
-    dimension = "2d"
-
-    /**
-     * @type {string|GPUTextureFormat}
-     */
-    format = "rgba8unorm";
-
-    /**
-     * @type {number|GPUTextureUsageFlags}
-     */
-    usage = GPUTextureUsage.TEXTURE_BINDING;
-
-    /**
-     *
-     * @param {Object} options
-     * @param {number[]} options.resolution
-     * @param {GPUTextureDimension|string} [options.dimension]
-     * @param {GPUTextureFormat|string} options.format
-     * @param {GPUTextureUsageFlags|number} [options.usage]
-     * @param {boolean} [options.enableMips]
-     * @returns {TextureResourceDescriptor}
-     */
-    static from({
-                    resolution,
-                    dimension = "2d",
-                    format,
-                    usage = GPUTextureUsage.TEXTURE_BINDING,
-                    enableMips = false
-                }) {
-
-        assert.isString(format, 'format');
-        assert.defined(resolution, 'resolution');
-        assert.isArrayLike(resolution, 'resolution');
-        assert.isBoolean(enableMips, 'enableMips');
-
-        const r = new TextureResourceDescriptor();
-
-        array_copy(resolution, 0, r.resolution, 0, Math.min(r.resolution.length, resolution.length));
-        r.dimension = dimension;
-        r.format = format;
-        r.usage = usage;
-
-        if (enableMips === true) {
-
-            // `r.resolution` rather than the argument: it has already been padded to three, so a
-            // caller that gave two axes reads as depth 1 instead of `undefined`
-            r.mipLevelCount = texture_mip_level_count(
-                r.resolution[0], r.resolution[1], r.resolution[2], r.dimension
-            );
-
-        }
-
-        return r;
-
-    }
-
-    /**
-     *
-     * @param {GPUTexture} texture
-     * @returns {TextureResourceDescriptor}
-     */
-    static fromTexture(texture) {
-        const r = new TextureResourceDescriptor();
-
-        r.format = texture.format;
-        r.dimension = texture.dimension;
-
-        r.usage = texture.usage;
-        r.sampleCount = texture.sampleCount;
-        r.resolution_domain = TextureResolutionDomain.Absolute;
-
-        r.resolution[0] = texture.width;
-        r.resolution[1] = texture.height;
-        r.resolution[2] = texture.depthOrArrayLayers;
-
-
-        r.mipLevelCount = texture.mipLevelCount;
-
-        return r;
-    }
-
-    get type() {
-        return "texture";
-    }
-
-    hash() {
-        return combine_hash(
-            this.resolution_domain,
-            this.mipLevelCount,
-            computeHashFloatArray(this.resolution),
-            this.sampleCount,
-            this.usage,
-            computeStringHash(this.format)
-        );
-    }
-
-    /**
-     *
-     * @param {TextureResourceDescriptor} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        if (this === other) {
-            return true;
-        }
-
-        // A texture and a buffer descriptor share one `ImmutableObjectPool` in
-        // `RenderResourceManager`, so a hash collision puts a buffer in front of this method. The
-        // type check has to come first: without it the very next line reads `other.resolution.length`
-        // on undefined and the probe throws instead of missing the cache.
-        if (!super.equals(other)) {
-            return false;
-        }
-
-        return isArrayEqualStrict(this.resolution, other.resolution)
-            && this.mipLevelCount === other.mipLevelCount
-            && this.resolution_domain === other.resolution_domain
-            && this.sampleCount === other.sampleCount
-            && this.dimension === other.dimension
-            && this.format === other.format
-            && this.usage === other.usage
-            ;
-    }
-
-    toString() {
-        return `Texture{ resolution = [${this.resolution.join(",")}], mipLevelCount = ${this.mipLevelCount}, dimension = ${this.dimension}, format = ${this.format}, usage = ${decode_bitmask_enum(this.usage, GPUTextureUsage).join(' | ')}, sampleCount = ${this.sampleCount} }`;
-    }
+import { assert } from "../../../core/assert.js";
+import { array_copy } from "../../../core/collection/array/array_copy.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../core/math/hash/hash_mix3.js";
+import { isArrayEqualStrict } from "../../../core/collection/array/isArrayEqualStrict.js";
+import { computeHashFloatArray } from "../../../core/math/hash/computeHashFloatArray.js";
+import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+import {
+    ResourceDescriptor
+} from "../../../engine/graphics/render/frame_graph/resource/ResourceDescriptor.js";
+import { texture_mip_level_count } from "../../util/texture_mip_extent.js";
+import { decode_bitmask_enum } from "../decode_bitmask_enum.js";
+import { GPUTextureUsage } from "../../descriptor/GPUTextureUsage.js";
+
+/**
+ * **Vestigial.** Nothing branches on it — see {@link TextureResourceDescriptor.resolution_domain}.
+ *
+ * @enum {number}
+ */
+export const TextureResolutionDomain = {
+    Absolute: 0,
+    PresentationRelative: 1
+}
+
+export class TextureResourceDescriptor extends ResourceDescriptor {
+    /**
+     * **Vestigial. Do not read this to decide how to interpret {@link resolution}.**
+     *
+     * No code branches on it; only {@link hash} folds it in. {@link from} stores whatever
+     * resolution it is given without touching this field, and every caller gives it pixels — so a
+     * descriptor's resolution is absolute pixels whatever this says, including on the default
+     * `PresentationRelative` that {@link from} leaves in place.
+     *
+     * @type {TextureResolutionDomain|number}
+     */
+    resolution_domain = TextureResolutionDomain.PresentationRelative;
+
+    // TODO use Uint32 instead
+    resolution = new Float64Array([1, 1, 1]);
+    sampleCount = 1;
+
+    mipLevelCount = 1;
+
+    /**
+     *
+     * @type {GPUTextureDimension|string}
+     */
+    dimension = "2d"
+
+    /**
+     * @type {string|GPUTextureFormat}
+     */
+    format = "rgba8unorm";
+
+    /**
+     * @type {number|GPUTextureUsageFlags}
+     */
+    usage = GPUTextureUsage.TEXTURE_BINDING;
+
+    /**
+     *
+     * @param {Object} options
+     * @param {number[]} options.resolution
+     * @param {GPUTextureDimension|string} [options.dimension]
+     * @param {GPUTextureFormat|string} options.format
+     * @param {GPUTextureUsageFlags|number} [options.usage]
+     * @param {boolean} [options.enableMips]
+     * @returns {TextureResourceDescriptor}
+     */
+    static from({
+                    resolution,
+                    dimension = "2d",
+                    format,
+                    usage = GPUTextureUsage.TEXTURE_BINDING,
+                    enableMips = false
+                }) {
+
+        assert.isString(format, 'format');
+        assert.defined(resolution, 'resolution');
+        assert.isArrayLike(resolution, 'resolution');
+        assert.isBoolean(enableMips, 'enableMips');
+
+        const r = new TextureResourceDescriptor();
+
+        array_copy(resolution, 0, r.resolution, 0, Math.min(r.resolution.length, resolution.length));
+        r.dimension = dimension;
+        r.format = format;
+        r.usage = usage;
+
+        if (enableMips === true) {
+
+            // `r.resolution` rather than the argument: it has already been padded to three, so a
+            // caller that gave two axes reads as depth 1 instead of `undefined`
+            r.mipLevelCount = texture_mip_level_count(
+                r.resolution[0], r.resolution[1], r.resolution[2], r.dimension
+            );
+
+        }
+
+        return r;
+
+    }
+
+    /**
+     *
+     * @param {GPUTexture} texture
+     * @returns {TextureResourceDescriptor}
+     */
+    static fromTexture(texture) {
+        const r = new TextureResourceDescriptor();
+
+        r.format = texture.format;
+        r.dimension = texture.dimension;
+
+        r.usage = texture.usage;
+        r.sampleCount = texture.sampleCount;
+        r.resolution_domain = TextureResolutionDomain.Absolute;
+
+        r.resolution[0] = texture.width;
+        r.resolution[1] = texture.height;
+        r.resolution[2] = texture.depthOrArrayLayers;
+
+
+        r.mipLevelCount = texture.mipLevelCount;
+
+        return r;
+    }
+
+    get type() {
+        return "texture";
+    }
+
+    hash() {
+        return hash_mix2(
+            hash_mix3(
+                hash_mix3(
+                    this.resolution_domain,
+                    this.mipLevelCount,
+                    computeHashFloatArray(this.resolution)
+                ),
+                this.sampleCount,
+                this.usage
+            ),
+            computeStringHash(this.format)
+        );
+    }
+
+    /**
+     *
+     * @param {TextureResourceDescriptor} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        if (this === other) {
+            return true;
+        }
+
+        // A texture and a buffer descriptor share one `ImmutableObjectPool` in
+        // `RenderResourceManager`, so a hash collision puts a buffer in front of this method. The
+        // type check has to come first: without it the very next line reads `other.resolution.length`
+        // on undefined and the probe throws instead of missing the cache.
+        if (!super.equals(other)) {
+            return false;
+        }
+
+        return isArrayEqualStrict(this.resolution, other.resolution)
+            && this.mipLevelCount === other.mipLevelCount
+            && this.resolution_domain === other.resolution_domain
+            && this.sampleCount === other.sampleCount
+            && this.dimension === other.dimension
+            && this.format === other.format
+            && this.usage === other.usage
+            ;
+    }
+
+    toString() {
+        return `Texture{ resolution = [${this.resolution.join(",")}], mipLevelCount = ${this.mipLevelCount}, dimension = ${this.dimension}, format = ${this.format}, usage = ${decode_bitmask_enum(this.usage, GPUTextureUsage).join(' | ')}, sampleCount = ${this.sampleCount} }`;
+    }
 }

package/src/shade/device/timing/profile/sgpt_read_header.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { crc32 } from "../../../../core/binary/hash/crc32.js";
+import { crc32 } from "../../../../core/math/hash/crc32.js";
 import { SGPT_DEFECT } from "./SGPT_DEFECT.js";
 import { SGPTDefect } from "./SGPTDefect.js";
 import { SGPT_FORMAT_VERSION } from "./SGPT_FORMAT_VERSION.js";

package/src/shade/device/timing/profile/sgpt_read_records.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { crc32 } from "../../../../core/binary/hash/crc32.js";
+import { crc32 } from "../../../../core/math/hash/crc32.js";
 import { SGPT_DEFECT } from "./SGPT_DEFECT.js";
 import { SGPTDefect } from "./SGPTDefect.js";
 import { SGPT_HEADER_SIZE } from "./SGPT_HEADER_SIZE.js";

package/src/shade/device/timing/profile/sgpt_write_header.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { crc32 } from "../../../../core/binary/hash/crc32.js";
+import { crc32 } from "../../../../core/math/hash/crc32.js";
 import { SGPT_FORMAT_VERSION } from "./SGPT_FORMAT_VERSION.js";
 import { SGPT_HEADER_CHECKSUM_COVERAGE } from "./SGPT_HEADER_CHECKSUM_COVERAGE.js";
 import { SGPT_HEADER_OFFSET } from "./SGPT_HEADER_OFFSET.js";

package/src/shade/device/timing/profile/sgpt_write_record.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { crc32 } from "../../../../core/binary/hash/crc32.js";
+import { crc32 } from "../../../../core/math/hash/crc32.js";
 import { SGPT_RECORD_HEADER_SIZE } from "./SGPT_RECORD_HEADER_SIZE.js";
 import { SGPT_RECORD_SYNC } from "./SGPT_RECORD_SYNC.js";
 

package/src/shade/renderer/binding/BufferBinding.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 { BindingResource } from "./BindingResource.js";
 
 /**
@@ -35,7 +35,7 @@ export class BufferBinding extends BindingResource {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
+        return hash_mix3(
             this.offset,
             this.actual_size,
             this.buffer.id

package/src/shade/renderer/camera/Camera.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 { m4_allocate } from "../../../core/geom/3d/mat4/m4_allocate.js";
 import { m4_multiply } from "../../../core/geom/3d/mat4/m4_multiply.js";
 import { plane3_normalize } from "../../../core/geom/3d/plane/plane3_normalize.js";
@@ -189,7 +189,7 @@ export class Camera {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeHashFloat(this.#near),
             computeHashFloat(this.#far),
             computeHashFloat(this.#aspect),

package/src/shade/renderer/geometry/Attribute.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 {
     compute_binary_data_type_from_typed_array
 } from "../../../core/collection/array/typed/compute_binary_data_type_from_typed_array.js";
@@ -89,7 +89,7 @@ export class Attribute {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             this.spec.hash(),
             this.count,
             sparse_typed_array_hash(this.data, 0, this.data.length)

package/src/shade/renderer/geometry/Geometry.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 { aabb3_from_v3_array } from "../../../core/geom/3d/aabb/aabb3_from_v3_array.js";
@@ -178,7 +178,7 @@ export class Geometry {
 
     hash() {
 
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.name),
             optional_hash(this.index),
             computeHashArray(this.attributes, invokeObjectHash)

package/src/shade/renderer/geometry/geometry_deduplicate_vertices.js

@@ -1,5 +1,5 @@
 import { reinterpret_float32_as_int32 } from "../../../core/binary/reinterpret_float32_as_int32.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import { Attribute } from "./Attribute.js";
 import { Geometry } from "./Geometry.js";
 import { StandardAttributes } from "./StandardAttributes.js";
@@ -125,7 +125,7 @@ function vertex_hash(datas, strides, num_attrs, vertex_index) {
             // canonicalize -0 to +0: they compare `===` in vertices_equal but have
             // different bit patterns, which would scatter equal vertices across buckets
             const value = data[base + s];
-            h = combine_hash(h, reinterpret_float32_as_int32(value === 0 ? 0 : value));
+            h = hash_mix2(h, reinterpret_float32_as_int32(value === 0 ? 0 : value));
         }
     }
     return h | 0;

package/src/shade/renderer/geometry/meshlet/MeshletBatch.js

@@ -2,7 +2,7 @@ import { assert } from "../../../../core/assert.js";
 import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
 import { platform_compute_endianness } from "../../../../core/binary/platform_compute_endianness.js";
 import { BinaryDataType } from "../../../../core/binary/type/BinaryDataType.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
 import { array_buffer_hash } from "../../../../core/collection/array/typed/array_buffer_hash.js";
 import { is_array_buffer_equals } from "../../../../core/collection/array/typed/is_array_buffer_equals.js";
 import { RowFirstTable } from "../../../../core/collection/table/RowFirstTable.js";
@@ -119,7 +119,7 @@ export class MeshletBatch {
     hash() {
         const meta = this.#metadata;
 
-        return combine_hash(
+        return hash_mix2(
             this.#count,
             array_buffer_hash(meta, 0, meta.byteLength)
         );

package/src/shade/renderer/geometry/virtual/format/checksum/vgeo_compute_asset_id.js

@@ -1,13 +1,13 @@
-import { xxh3_128 } from "../../../../../../core/binary/hash/xxh3_128.js";
-import { vgeo_asset_id_preimage } from "./vgeo_asset_id_preimage.js";
-
-/**
- * @param {BinaryBuffer} buffer whole file
- * @returns {XXH128Hash} the asset's identity
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export function vgeo_compute_asset_id(buffer) {
-    return xxh3_128(vgeo_asset_id_preimage(buffer).raw_bytes);
-}
+import { xxh3_128 } from "../../../../../../core/math/hash/xxh3_128.js";
+import { vgeo_asset_id_preimage } from "./vgeo_asset_id_preimage.js";
+
+/**
+ * @param {BinaryBuffer} buffer whole file
+ * @returns {XXH128Hash} the asset's identity
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_compute_asset_id(buffer) {
+    return xxh3_128(vgeo_asset_id_preimage(buffer).raw_bytes);
+}

package/src/shade/renderer/geometry/virtual/format/checksum/vgeo_compute_directory_block_checksum.js

@@ -1,41 +1,41 @@
-import { xxh3_64 } from "../../../../../../core/binary/hash/xxh3_64.js";
-import { VGEO_DIRECTORY_BLOCK_RECORDS } from "../directory/VGEO_DIRECTORY_BLOCK_RECORDS.js";
-import { VGEO_DIRECTORY_RECORD_SIZE } from "../directory/VGEO_DIRECTORY_RECORD_SIZE.js";
-
-/**
- * The checksum of one 4 KB directory block. The final block is short whenever the record count is
- * not a multiple of {@link VGEO_DIRECTORY_BLOCK_RECORDS}, and covers only the records that exist.
- *
- * The seed is taken from `asset_id`, which is why {@link vgeo_asset_id_preimage} zeroes this region
- * before hashing: the two would otherwise be defined in terms of each other.
- *
- * @param {BinaryBuffer} buffer whole file
- * @param {number} directory_offset
- * @param {number} total_pages
- * @param {number} block_index
- * @param {bigint} asset_id_high64
- * @returns {bigint}
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export function vgeo_compute_directory_block_checksum(
-    buffer,
-    directory_offset,
-    total_pages,
-    block_index,
-    asset_id_high64
-) {
-    const first_record = block_index * VGEO_DIRECTORY_BLOCK_RECORDS;
-
-    const record_count = Math.min(VGEO_DIRECTORY_BLOCK_RECORDS, total_pages - first_record);
-
-    const start = directory_offset + first_record * VGEO_DIRECTORY_RECORD_SIZE;
-
-    const seed = asset_id_high64 ^ BigInt(block_index);
-
-    return xxh3_64(
-        buffer.raw_bytes.subarray(start, start + record_count * VGEO_DIRECTORY_RECORD_SIZE),
-        seed
-    );
-}
+import { xxh3_64 } from "../../../../../../core/math/hash/xxh3_64.js";
+import { VGEO_DIRECTORY_BLOCK_RECORDS } from "../directory/VGEO_DIRECTORY_BLOCK_RECORDS.js";
+import { VGEO_DIRECTORY_RECORD_SIZE } from "../directory/VGEO_DIRECTORY_RECORD_SIZE.js";
+
+/**
+ * The checksum of one 4 KB directory block. The final block is short whenever the record count is
+ * not a multiple of {@link VGEO_DIRECTORY_BLOCK_RECORDS}, and covers only the records that exist.
+ *
+ * The seed is taken from `asset_id`, which is why {@link vgeo_asset_id_preimage} zeroes this region
+ * before hashing: the two would otherwise be defined in terms of each other.
+ *
+ * @param {BinaryBuffer} buffer whole file
+ * @param {number} directory_offset
+ * @param {number} total_pages
+ * @param {number} block_index
+ * @param {bigint} asset_id_high64
+ * @returns {bigint}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_compute_directory_block_checksum(
+    buffer,
+    directory_offset,
+    total_pages,
+    block_index,
+    asset_id_high64
+) {
+    const first_record = block_index * VGEO_DIRECTORY_BLOCK_RECORDS;
+
+    const record_count = Math.min(VGEO_DIRECTORY_BLOCK_RECORDS, total_pages - first_record);
+
+    const start = directory_offset + first_record * VGEO_DIRECTORY_RECORD_SIZE;
+
+    const seed = asset_id_high64 ^ BigInt(block_index);
+
+    return xxh3_64(
+        buffer.raw_bytes.subarray(start, start + record_count * VGEO_DIRECTORY_RECORD_SIZE),
+        seed
+    );
+}