@woosh/meep-engine 3.44.0 → 3.46.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/build/level/vgeo_build_group_step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_build_group_step.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_build_group_step.js"],"names":[],"mappings":"AAsEA;;;;;;;;;;;;;;GAcG;AACH,8EAXW,MAAM,EAAE,iBACR,UAAU,eACV,MAAM,SACN,MAAM,8BAEJ,aAAa,GAAC,SAAS,CA0dnC;8BA9gB6B,oBAAoB"}
+{"version":3,"file":"vgeo_build_group_step.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_build_group_step.js"],"names":[],"mappings":"AAuEA;;;;;;;;;;;;;;GAcG;AACH,8EAXW,MAAM,EAAE,iBACR,UAAU,eACV,MAAM,SACN,MAAM,8BAEJ,aAAa,GAAC,SAAS,CA0dnC;8BA/gB6B,oBAAoB"}

package/src/shade/renderer/geometry/virtual/build/level/vgeo_build_group_step.js

@@ -26,6 +26,7 @@ import { vgeo_extract_submesh } from "../submesh/vgeo_extract_submesh.js";
 import { vgeo_build_cluster } from "./vgeo_build_cluster.js";
 import { vgeo_compute_group_boundary } from "./vgeo_compute_group_boundary.js";
 import { VGeoGroupStep } from "./VGeoGroupStep.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * The defects a simplified group carries, as one line, or `''` when it carries none.
@@ -103,7 +104,7 @@ export function vgeo_build_group_step(
         }
     }
 
-    face_ids.sort((a, b) => a - b);
+    face_ids.sort(number_compare_ascending);
 
     const child_clusters = group_clusters.map((cluster) => frontier.clusters[cluster]);
 
@@ -503,7 +504,7 @@ export function vgeo_build_group_step(
     for (const part of parts) {
         const part_face_ids = part.map((dense) => submesh_face_graph.vertex_face_ids[dense]);
 
-        part_face_ids.sort((a, b) => a - b);
+        part_face_ids.sort(number_compare_ascending);
 
         const built = vgeo_build_cluster(submesh.mesh, part_face_ids, level, submesh.wedges);
 

package/src/shade/renderer/geometry/virtual/build/level/vgeo_build_leaf_frontier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_build_leaf_frontier.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_build_leaf_frontier.js"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;GAYG;AACH,wFATW,YAAY,GAIV,YAAY,CAoFxB;6BA9F4B,mBAAmB"}
+{"version":3,"file":"vgeo_build_leaf_frontier.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_build_leaf_frontier.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;GAYG;AACH,wFATW,YAAY,GAIV,YAAY,CAoFxB;6BA/F4B,mBAAmB"}

package/src/shade/renderer/geometry/virtual/build/level/vgeo_build_leaf_frontier.js

@@ -18,6 +18,7 @@ import { VGeoFaceGraph } from "../partition/VGeoFaceGraph.js";
 import { vgeo_split_face_set } from "../partition/vgeo_split_face_set.js";
 import { vgeo_build_cluster } from "./vgeo_build_cluster.js";
 import { VGeoFrontier } from "./VGeoFrontier.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * Cut a mesh into leaf clusters — the frontier every round starts from.
@@ -98,7 +99,7 @@ export function vgeo_build_leaf_frontier(
     for (const part of parts) {
         const face_ids = part.map((dense) => face_graph.vertex_face_ids[dense]);
 
-        face_ids.sort((a, b) => a - b);
+        face_ids.sort(number_compare_ascending);
 
         const built = vgeo_build_cluster(mesh, face_ids, 0, frontier.wedges);
 

package/src/shade/renderer/geometry/virtual/build/level/vgeo_partition_into_groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_partition_into_groups.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_partition_into_groups.js"],"names":[],"mappings":"AA0MA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,yEARW,MAAM,EAAE,iBACR,MAAM,cACN,MAAM,GACJ,MAAM,EAAE,EAAE,CAqHtB"}
+{"version":3,"file":"vgeo_partition_into_groups.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_partition_into_groups.js"],"names":[],"mappings":"AA2MA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,yEARW,MAAM,EAAE,iBACR,MAAM,cACN,MAAM,GACJ,MAAM,EAAE,EAAE,CAqHtB"}

package/src/shade/renderer/geometry/virtual/build/level/vgeo_partition_into_groups.js

@@ -6,6 +6,7 @@ import { VGEO_MAX_CLUSTER_VERTEX_COUNT } from "../../format/cluster/VGEO_MAX_CLU
 import { VGEO_MAX_GROUP_CLUSTER_COUNT } from "../../format/page/VGEO_MAX_GROUP_CLUSTER_COUNT.js";
 import { vgeo_graph_components } from "../partition/vgeo_graph_components.js";
 import { vgeo_partition_subgraph } from "../partition/vgeo_partition_subgraph.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * Fixed so that the same frontier always groups the same way.
@@ -190,7 +191,7 @@ function absorb_singleton_pieces(pieces, cluster_graph) {
         );
 
         alive[best].push(cluster);
-        alive[best].sort((a, b) => a - b);
+        alive[best].sort(number_compare_ascending);
 
         piece_of.set(cluster, best);
 

package/src/shade/renderer/geometry/virtual/build/level/vgeo_run_round.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_run_round.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_run_round.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8DATW,MAAM,8BAEJ;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,IAAI,MAAM,CAAC,CAAA;CAAC,GAAC,SAAS,CAyG/F"}
+{"version":3,"file":"vgeo_run_round.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_run_round.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8DATW,MAAM,8BAEJ;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,IAAI,MAAM,CAAC,CAAA;CAAC,GAAC,SAAS,CAyG/F"}

package/src/shade/renderer/geometry/virtual/build/level/vgeo_run_round.js

@@ -5,6 +5,7 @@ import { vgeo_build_group_step } from "./vgeo_build_group_step.js";
 import { vgeo_error_bands } from "./vgeo_error_bands.js";
 import { vgeo_partition_into_groups } from "./vgeo_partition_into_groups.js";
 import { vgeo_try_repack } from "./vgeo_try_repack.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * The frontier's clusters ordered by error, which is what a band is a slice of.
@@ -65,7 +66,7 @@ export function vgeo_run_round(frontier, level, options) {
         for (const range of bands) {
             const band = ordered.order.slice(range.start, range.end);
 
-            band.sort((a, b) => a - b);
+            band.sort(number_compare_ascending);
 
             const groups = vgeo_partition_into_groups(frontier, band, cluster_graph, group_size);
 

package/src/shade/renderer/geometry/virtual/build/level/vgeo_try_repack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_try_repack.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_try_repack.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wEAPW,MAAM,EAAE,iBACR,MAAM,GACJ,eAAe,GAAC,SAAS,CAsFrC;gCA7G+B,sBAAsB"}
+{"version":3,"file":"vgeo_try_repack.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/level/vgeo_try_repack.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wEAPW,MAAM,EAAE,iBACR,MAAM,GACJ,eAAe,GAAC,SAAS,CAsFrC;gCA9G+B,sBAAsB"}

package/src/shade/renderer/geometry/virtual/build/level/vgeo_try_repack.js

@@ -6,6 +6,7 @@ import { vgeo_split_face_set_packed } from "../partition/vgeo_split_face_set_pac
 import { vgeo_extract_submesh } from "../submesh/vgeo_extract_submesh.js";
 import { vgeo_build_cluster } from "./vgeo_build_cluster.js";
 import { VGeoGroupRepack } from "./VGeoGroupRepack.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * Leaves with room to spare between them, re-cut into fewer and fuller leaves.
@@ -53,7 +54,7 @@ export function vgeo_try_repack(frontier, group_clusters, parent_target) {
         return undefined;
     }
 
-    face_ids.sort((a, b) => a - b);
+    face_ids.sort(number_compare_ascending);
 
     const submesh = vgeo_extract_submesh(frontier.mesh, face_ids, frontier.wedges);
 
@@ -88,7 +89,7 @@ export function vgeo_try_repack(frontier, group_clusters, parent_target) {
     for (const part of parts) {
         const part_face_ids = part.map((dense) => face_graph.vertex_face_ids[dense]);
 
-        part_face_ids.sort((a, b) => a - b);
+        part_face_ids.sort(number_compare_ascending);
 
         const built = vgeo_build_cluster(submesh.mesh, part_face_ids, 0, submesh.wedges);
 

package/src/shade/renderer/geometry/virtual/build/partition/vgeo_graph_components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_graph_components.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/partition/vgeo_graph_components.js"],"names":[],"mappings":"AA6CA;;;;;;;;;;;GAWG;AACH,sDARW,WAAW,aACX,WAAW,WACX,MAAM,EAAE,cACR,UAAU,SAEV,MAAM,GACJ,MAAM,EAAE,EAAE,CAmEtB"}
+{"version":3,"file":"vgeo_graph_components.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/partition/vgeo_graph_components.js"],"names":[],"mappings":"AA8CA;;;;;;;;;;;GAWG;AACH,sDARW,WAAW,aACX,WAAW,WACX,MAAM,EAAE,cACR,UAAU,SAEV,MAAM,GACJ,MAAM,EAAE,EAAE,CAmEtB"}

package/src/shade/renderer/geometry/virtual/build/partition/vgeo_graph_components.js

@@ -1,3 +1,4 @@
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 /**
  * Connected components of the subgraph a CSR induces on a member set.
  *
@@ -112,7 +113,7 @@ export function vgeo_graph_components(
             }
         }
 
-        component.sort((a, b) => a - b);
+        component.sort(number_compare_ascending);
 
         result.push(component);
     }

package/src/shade/renderer/geometry/virtual/build/partition/vgeo_split_face_set_packed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_split_face_set_packed.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/partition/vgeo_split_face_set_packed.js"],"names":[],"mappings":"AAmVA;;;;;;;;;;;;GAYG;AACH,+EALW,MAAM,EAAE,aACR,MAAM,gBACN,MAAM,GACJ,MAAM,EAAE,EAAE,CAoBtB"}
+{"version":3,"file":"vgeo_split_face_set_packed.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/build/partition/vgeo_split_face_set_packed.js"],"names":[],"mappings":"AAoVA;;;;;;;;;;;;GAYG;AACH,+EALW,MAAM,EAAE,aACR,MAAM,gBACN,MAAM,GACJ,MAAM,EAAE,EAAE,CAoBtB"}

package/src/shade/renderer/geometry/virtual/build/partition/vgeo_split_face_set_packed.js

@@ -4,6 +4,7 @@ import {
     bt_face_read_triangle_vertices
 } from "../../../../../../core/geom/3d/topology/struct/binary/query/bt_face_read_triangle.js";
 import { vgeo_split_face_set } from "./vgeo_split_face_set.js";
+import { number_compare_ascending } from "../../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * {@link vgeo_split_face_set}, then merge the under-filled pieces it left behind.
@@ -331,7 +332,7 @@ function pack_pieces(face_graph, pieces, max_faces, max_vertices, floor) {
             }
         }
 
-        packed.sort((a, b) => a - b);
+        packed.sort(number_compare_ascending);
 
         return packed;
     });

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
+    );
+}

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

@@ -1,41 +1,41 @@
-import { xxh3_64 } from "../../../../../../core/binary/hash/xxh3_64.js";
-import { VGEO_FRAME_HEADER_SIZE } from "../frame/VGEO_FRAME_HEADER_SIZE.js";
-import { VGEO_FRAME_OFFSET } from "../frame/VGEO_FRAME_OFFSET.js";
-
-/**
- * The identity-seeded checksum of one frame: xxh3-64 over the frame's bytes with its own `checksum`
- * field cut out, seeded so that a well-formed frame of the wrong page or the wrong asset fails to
- * verify rather than installing silently.
- *
- * The seed is taken from `asset_id`, which is why {@link vgeo_asset_id_preimage} zeroes this field
- * before hashing: the two would otherwise be defined in terms of each other.
- *
- * @param {BinaryBuffer} buffer whole file
- * @param {VGeoFrameExtent} frame
- * @param {bigint} asset_id_low64
- * @returns {bigint}
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export function vgeo_compute_frame_checksum(buffer, frame, asset_id_low64) {
-    const seed = asset_id_low64 ^ BigInt(frame.page_index);
-
-    const bytes = buffer.raw_bytes;
-
-    const covered = new Uint8Array(frame.extent - 8);
-
-    // frame bytes [0, 16)
-    covered.set(
-        bytes.subarray(frame.frame_offset, frame.frame_offset + VGEO_FRAME_OFFSET.CHECKSUM),
-        0
-    );
-
-    // frame bytes [24, extent)
-    covered.set(
-        bytes.subarray(frame.frame_offset + VGEO_FRAME_HEADER_SIZE, frame.frame_offset + frame.extent),
-        VGEO_FRAME_OFFSET.CHECKSUM
-    );
-
-    return xxh3_64(covered, seed);
-}
+import { xxh3_64 } from "../../../../../../core/math/hash/xxh3_64.js";
+import { VGEO_FRAME_HEADER_SIZE } from "../frame/VGEO_FRAME_HEADER_SIZE.js";
+import { VGEO_FRAME_OFFSET } from "../frame/VGEO_FRAME_OFFSET.js";
+
+/**
+ * The identity-seeded checksum of one frame: xxh3-64 over the frame's bytes with its own `checksum`
+ * field cut out, seeded so that a well-formed frame of the wrong page or the wrong asset fails to
+ * verify rather than installing silently.
+ *
+ * The seed is taken from `asset_id`, which is why {@link vgeo_asset_id_preimage} zeroes this field
+ * before hashing: the two would otherwise be defined in terms of each other.
+ *
+ * @param {BinaryBuffer} buffer whole file
+ * @param {VGeoFrameExtent} frame
+ * @param {bigint} asset_id_low64
+ * @returns {bigint}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_compute_frame_checksum(buffer, frame, asset_id_low64) {
+    const seed = asset_id_low64 ^ BigInt(frame.page_index);
+
+    const bytes = buffer.raw_bytes;
+
+    const covered = new Uint8Array(frame.extent - 8);
+
+    // frame bytes [0, 16)
+    covered.set(
+        bytes.subarray(frame.frame_offset, frame.frame_offset + VGEO_FRAME_OFFSET.CHECKSUM),
+        0
+    );
+
+    // frame bytes [24, extent)
+    covered.set(
+        bytes.subarray(frame.frame_offset + VGEO_FRAME_HEADER_SIZE, frame.frame_offset + frame.extent),
+        VGEO_FRAME_OFFSET.CHECKSUM
+    );
+
+    return xxh3_64(covered, seed);
+}

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

@@ -1,25 +1,25 @@
-import { BinaryBuffer } from "../../../../../../core/binary/BinaryBuffer.js";
-import { xxh3_64 } from "../../../../../../core/binary/hash/xxh3_64.js";
-import { VGEO_HEADER_OFFSET } from "../header/VGEO_HEADER_OFFSET.js";
-import { VGEO_HEADER_SIZE } from "../header/VGEO_HEADER_SIZE.js";
-
-/**
- * xxh3-64 of the header with `header_checksum` zeroed. `asset_id` must already be final: the
- * ordering is what keeps the two non-circular.
- *
- * @param {BinaryBuffer} buffer whole file
- * @returns {bigint}
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export function vgeo_compute_header_checksum(buffer) {
-    const header = new BinaryBuffer();
-
-    header.fromArrayBuffer(buffer.raw_bytes.slice(0, VGEO_HEADER_SIZE).buffer);
-
-    header.position = VGEO_HEADER_OFFSET.HEADER_CHECKSUM;
-    header.writeUint64(0n);
-
-    return xxh3_64(header.raw_bytes);
-}
+import { BinaryBuffer } from "../../../../../../core/binary/BinaryBuffer.js";
+import { xxh3_64 } from "../../../../../../core/math/hash/xxh3_64.js";
+import { VGEO_HEADER_OFFSET } from "../header/VGEO_HEADER_OFFSET.js";
+import { VGEO_HEADER_SIZE } from "../header/VGEO_HEADER_SIZE.js";
+
+/**
+ * xxh3-64 of the header with `header_checksum` zeroed. `asset_id` must already be final: the
+ * ordering is what keeps the two non-circular.
+ *
+ * @param {BinaryBuffer} buffer whole file
+ * @returns {bigint}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function vgeo_compute_header_checksum(buffer) {
+    const header = new BinaryBuffer();
+
+    header.fromArrayBuffer(buffer.raw_bytes.slice(0, VGEO_HEADER_SIZE).buffer);
+
+    header.position = VGEO_HEADER_OFFSET.HEADER_CHECKSUM;
+    header.writeUint64(0n);
+
+    return xxh3_64(header.raw_bytes);
+}

package/src/shade/renderer/geometry/virtual/format/vgeo_write_container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgeo_write_container.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/format/vgeo_write_container.js"],"names":[],"mappings":"AAkfA;;;;;;;;GAQG;AACH,4CANW,qBAAqB,8BAGnB,QAAQ,YAAY,CAAC,CAmOjC;6BA1tB4B,4CAA4C"}
+{"version":3,"file":"vgeo_write_container.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/geometry/virtual/format/vgeo_write_container.js"],"names":[],"mappings":"AAmfA;;;;;;;;GAQG;AACH,4CANW,qBAAqB,8BAGnB,QAAQ,YAAY,CAAC,CAmOjC;6BA3tB4B,4CAA4C"}

package/src/shade/renderer/geometry/virtual/format/vgeo_write_container.js

@@ -41,6 +41,7 @@ import { VGEO_PARENT_PAGE_ENTRY_SIZE } from "./page/VGEO_PARENT_PAGE_ENTRY_SIZE.
 import { VGEO_PAYLOAD_ENCODING_SHADE_MESHLET_V1 } from "./header/VGEO_PAYLOAD_ENCODING_SHADE_MESHLET_V1.js";
 import { VGEO_SAME_PAGE } from "./cluster/VGEO_SAME_PAGE.js";
 import { vgeo_scan_frames } from "./frame/vgeo_scan_frames.js";
+import { number_compare_ascending } from "../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * Serialize an assembled page list into `.vgeo` bytes.
@@ -182,7 +183,7 @@ function collect_parent_pages(page, parents) {
         }
     }
 
-    return Array.from(seen).sort((a, b) => a - b);
+    return Array.from(seen).sort(number_compare_ascending);
 }
 
 /**
@@ -206,7 +207,7 @@ function collect_child_pages(page) {
         }
     }
 
-    return Array.from(seen).sort((a, b) => a - b);
+    return Array.from(seen).sort(number_compare_ascending);
 }
 
 /**

package/src/shade/renderer/material/StandardShadeMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardShadeMaterial.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/StandardShadeMaterial.js"],"names":[],"mappings":"AAOA;;;;GAIG;AAEH;IACI;;;OAGG;IACH,gBAFU,YAAY,CAEP;IAEf;;;OAGG;IACH,eAFU,KAAK,CAEsB;IAErC;;OAEG;IACH,gBAFU,YAAY,CAEP;IAEf;;;;;;OAMG;IACH,aAFU,YAAY,CAEV;IAEZ;;OAEG;IACH,kBAFU,YAAY,CAEL;IAEjB;;;;;;;;OAQG;IACH,UAFU,mBAAmB,GAAC,SAAS,CAE9B;IAET;;;OAGG;IACH,kBAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;;;;;;OAQG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;;;;OAMG;IACH,YAFU,MAAM,CAEC;IAEjB;;;;;;;;;;;OAWG;IACH,QAFU,mBAAmB,GAAC,IAAI,CAEpB;IAEd;;;OAGG;IACH,iBAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,iBAFU,cAAc,CAEmB;IAW3C;;;;;OAKG;IACH,YAFW,qBAAqB,QAoB/B;IAED;;;OAGG;IACH,SAFa,qBAAqB,CAQjC;IAaD;;;;OAIG;IACH,cAHW,qBAAqB,GACnB,OAAO,CA+BnB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;2BAvMY,OAAO,4BAA4B,EAAE,YAAY;kCACjD,OAAO,2CAA2C,EAAE,mBAAmB;kCACvE,OAAO,kCAAkC,EAAE,mBAAmB;8BAL7C,oBAAoB;sBAJ5B,8BAA8B;2BACzB,4CAA4C"}
+{"version":3,"file":"StandardShadeMaterial.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/StandardShadeMaterial.js"],"names":[],"mappings":"AAQA;;;;GAIG;AAEH;IACI;;;OAGG;IACH,gBAFU,YAAY,CAEP;IAEf;;;OAGG;IACH,eAFU,KAAK,CAEsB;IAErC;;OAEG;IACH,gBAFU,YAAY,CAEP;IAEf;;;;;;OAMG;IACH,aAFU,YAAY,CAEV;IAEZ;;OAEG;IACH,kBAFU,YAAY,CAEL;IAEjB;;;;;;;;OAQG;IACH,UAFU,mBAAmB,GAAC,SAAS,CAE9B;IAET;;;OAGG;IACH,kBAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;;;;;;OAQG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;;;;OAMG;IACH,YAFU,MAAM,CAEC;IAEjB;;;;;;;;;;;OAWG;IACH,QAFU,mBAAmB,GAAC,IAAI,CAEpB;IAEd;;;OAGG;IACH,iBAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,iBAFU,cAAc,CAEmB;IAW3C;;;;;OAKG;IACH,YAFW,qBAAqB,QAoB/B;IAED;;;OAGG;IACH,SAFa,qBAAqB,CAQjC;IAiBD;;;;OAIG;IACH,cAHW,qBAAqB,GACnB,OAAO,CA+BnB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;2BA3MY,OAAO,4BAA4B,EAAE,YAAY;kCACjD,OAAO,2CAA2C,EAAE,mBAAmB;kCACvE,OAAO,kCAAkC,EAAE,mBAAmB;8BAL7C,oBAAoB;sBAJ5B,8BAA8B;2BACzB,4CAA4C"}

package/src/shade/renderer/material/StandardShadeMaterial.js

@@ -1,4 +1,5 @@
-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 { Color } from "../../../core/color/Color.js";
 import LinearModifier from "../../../core/model/stat/LinearModifier.js";
 import { optional_equality } from "../../../core/model/object/optional_equality.js";
@@ -160,13 +161,17 @@ export class StandardShadeMaterial extends ShadeMaterial {
     }
 
     hash() {
-        return combine_hash(
-            super.hash(),
-            this.diffuse_color.hash(),
-            optional_hash(this.texture_albedo),
-            optional_hash(this.texture_normal),
-            optional_hash(this.texture_orm),
-            optional_hash(this.texture_emissive),
+        return hash_mix2(
+            hash_mix3(
+                hash_mix3(
+                    super.hash(),
+                    this.diffuse_color.hash(),
+                    optional_hash(this.texture_albedo)
+                ),
+                optional_hash(this.texture_normal),
+                optional_hash(this.texture_orm)
+            ),
+            optional_hash(this.texture_emissive)
         );
     }
 

package/src/shade/renderer/particles/optimizer/dag/particle_vector_extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particle_vector_extract.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/particles/optimizer/dag/particle_vector_extract.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;;GAOG;AACH,gDAHW,OAAO,4BAA4B,EAAE,kBAAkB,GACrD,MAAM,CAIlB;AAED;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,+CATW,OAAO,4BAA4B,EAAE,mBAAmB,SACxD,MAAM,EAAE;IAE4E,SAAS,UAApF,OAAO,4BAA4B,EAAE,kBAAkB,KAAG,MAAM;IACxD,UAAU,GAA3B,MAAM;IACW,eAAe,GAAhC,MAAM;IAEJ,uBAAuB,CA0DnC;;;;;YAvEa,IAAI,MAAM,EAAE,MAAM,CAAC;;;;WACnB,MAAM,EAAE;;;;UACR,MAAM"}
+{"version":3,"file":"particle_vector_extract.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/particles/optimizer/dag/particle_vector_extract.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;;GAOG;AACH,gDAHW,OAAO,4BAA4B,EAAE,kBAAkB,GACrD,MAAM,CAIlB;AAED;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,+CATW,OAAO,4BAA4B,EAAE,mBAAmB,SACxD,MAAM,EAAE;IAE4E,SAAS,UAApF,OAAO,4BAA4B,EAAE,kBAAkB,KAAG,MAAM;IACxD,UAAU,GAA3B,MAAM;IACW,eAAe,GAAhC,MAAM;IAEJ,uBAAuB,CA0DnC;;;;;YAvEa,IAAI,MAAM,EAAE,MAAM,CAAC;;;;WACnB,MAAM,EAAE;;;;UACR,MAAM"}

package/src/shade/renderer/particles/optimizer/dag/particle_vector_extract.js

@@ -1,5 +1,6 @@
 import { assert } from "../../../../../core/assert.js";
 import { PV } from "./particle_vector_graph.js";
+import { number_compare_ascending } from "../../../../../core/primitives/numbers/number_compare_ascending.js";
 
 /**
  * Choose one node per class — the instruction-count half of the optimizer.
@@ -86,7 +87,7 @@ export function extract_particle_values(graph, roots, {
 
         // Only the classes that are both reachable and hold more than one node are a decision; with
         // one alternative-generating rule that is a handful of products per program.
-        for (const id of [...reached].sort((a, b) => a - b)) {
+        for (const id of [...reached].sort(number_compare_ascending)) {
             const members = graph.members(id);
 
             if (members.length < 2 || evaluations >= max_evaluations) {
@@ -247,7 +248,7 @@ function topological(graph, reached, choice) {
     const order = [];
     const done = new Set();
 
-    for (const root of [...reached].sort((a, b) => a - b)) {
+    for (const root of [...reached].sort(number_compare_ascending)) {
         if (done.has(root)) {
             continue;
         }

package/src/shade/renderer/scene/optimization/geometry/internal/triangle_fingerprint_stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"triangle_fingerprint_stream.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/scene/optimization/geometry/internal/triangle_fingerprint_stream.js"],"names":[],"mappings":"AA6DA;;;;;;;;;;;;;;GAcG;AACH,iEAFa,WAAW,CA2EvB"}
+{"version":3,"file":"triangle_fingerprint_stream.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/scene/optimization/geometry/internal/triangle_fingerprint_stream.js"],"names":[],"mappings":"AA8DA;;;;;;;;;;;;;;GAcG;AACH,iEAFa,WAAW,CAmFvB"}

package/src/shade/renderer/scene/optimization/geometry/internal/triangle_fingerprint_stream.js

@@ -1,5 +1,6 @@
 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 { hash_mix3 } from "../../../../../../core/math/hash/hash_mix3.js";
 import { v3_distance } from "../../../../../../core/geom/vec3/v3_distance.js";
 import { StandardAttributes } from "../../../../geometry/StandardAttributes.js";
 
@@ -15,7 +16,7 @@ function fold_strided(h, data, stride, vertex_index) {
     if (data === null) return h;
     const base = vertex_index * stride;
     for (let i = 0; i < stride; i++) {
-        h = combine_hash(h, reinterpret_float32_as_int32(data[base + i]));
+        h = hash_mix2(h, reinterpret_float32_as_int32(data[base + i]));
     }
     return h;
 }
@@ -140,9 +141,17 @@ export function triangle_fingerprint_stream(geometry) {
 
         sort_three(keys_scratch, attrs_scratch);
 
-        result[t] = combine_hash(
-            keys_scratch[0], keys_scratch[1], keys_scratch[2],
-            attrs_scratch[0], attrs_scratch[1], attrs_scratch[2]
+        result[t] = hash_mix2(
+            hash_mix3(
+                hash_mix3(
+                    keys_scratch[0],
+                    keys_scratch[1],
+                    keys_scratch[2]
+                ),
+                attrs_scratch[0],
+                attrs_scratch[1]
+            ),
+            attrs_scratch[2]
         ) | 0;
     }
 

package/src/shade/renderer/scene/optimization/sampler2d_from_image_bitmap.js

@@ -8,7 +8,7 @@ import html_canvas_to_sampler2d from "../../../../engine/graphics/texture/html_c
 export function sampler2d_from_image_bitmap(bitmap) {
     // 1. Draw the bitmap to a canvas
     const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
-    const ctx = canvas.getContext('2d');
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
     ctx.drawImage(bitmap, 0, 0);
 
     return html_canvas_to_sampler2d(canvas);

package/src/shade/renderer/shader/type/WGSLStructField.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 { isArrayEqual } from "../../../../core/collection/array/isArrayEqual.js";
 import { isPowerOfTwo } from "../../../../core/math/isPowerOfTwo.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
@@ -181,7 +181,7 @@ export class WGSLStructField {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix3(
             computeStringHash(this.name),
             this.offset,
             this.type.hash()