@woosh/meep-engine 3.32.0 → 3.33.0

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.32.0",
+  "version": "3.33.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/core/collection/table/RowFirstTable.d.ts

@@ -70,7 +70,14 @@ export class RowFirstTable {
      */
     trim(): void;
     /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count: number): void;
@@ -178,6 +185,7 @@ export class RowFirstTable {
      * @returns {boolean}
      */
     equals(other: RowFirstTable): boolean;
+    #private;
 }
 export type RowFirstTableSpec = import("./RowFirstTableSpec.js").RowFirstTableSpec;
 import Signal from "../../events/signal/Signal.js";

package/src/core/collection/table/RowFirstTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;CACJ;gCAhnBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}
+{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAiDA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAaD;;;;;;;;;;OAUG;IACH,kBAFW,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;;CACJ;gCA7oBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}

package/src/core/collection/table/RowFirstTable.js

@@ -28,11 +28,25 @@ const ALLOCATION_GROW_FACTOR = 1.5;
 const ALLOCATION_GROW_MINIMUM_STEP = 32;
 
 /**
- * Must be less than 1 and greater than 0
+ * Must be less than 1 and greater than 0.
+ * A table shrinks once this fraction of its capacity would still exceed what a grow picks for the current row count,
+ * see {@link RowFirstTable#resize}
  * @type {number}
  */
 const ALLOCATION_SHRINK_FACTOR = 0.5;
 
+/**
+ * Capacity a grow picks for `row_count` rows, and the capacity a shrink lands on
+ * @param {number} row_count
+ * @returns {number}
+ */
+function capacity_for_row_count(row_count) {
+    return Math.max(
+        Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
+        row_count + ALLOCATION_GROW_MINIMUM_STEP
+    );
+}
+
 /**
  * Compact binary table storage.
  * Very efficient in terms of memory usage and allocation.
@@ -225,26 +239,41 @@ export class RowFirstTable {
     }
 
     /**
+     * Grow capacity to fit `row_count` rows if it does not already, never shrinks.
+     * What every operation that adds rows uses, so an append cannot undo a {@link setCapacity} reservation.
+     * @param {number} row_count
+     */
+    #grow_to_fit(row_count) {
+        if (this.capacity < row_count) {
+            this.setCapacity(capacity_for_row_count(row_count));
+        }
+    }
+
+    /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count) {
         assert.isNonNegativeInteger(row_count, 'row_count');
 
+        const fitted_capacity = capacity_for_row_count(row_count);
+
         if (this.capacity < row_count) {
 
             //grow
-            const new_size = Math.max(
-                Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
-                row_count + ALLOCATION_GROW_MINIMUM_STEP
-            );
-
-            this.setCapacity(new_size);
+            this.setCapacity(fitted_capacity);
 
-        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > row_count) {
+        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > fitted_capacity) {
 
             //shrink
-            this.setCapacity(row_count);
+            this.setCapacity(fitted_capacity);
 
         }
 
@@ -343,7 +372,7 @@ export class RowFirstTable {
 
         const future_length = this.length + row_count;
 
-        this.resize(future_length);
+        this.#grow_to_fit(future_length);
 
         const data = this.data;
 
@@ -370,7 +399,7 @@ export class RowFirstTable {
     createEmptyRow() {
         const newRowCount = this.length + 1;
 
-        this.resize(newRowCount);
+        this.#grow_to_fit(newRowCount);
 
         const rowIndex = this.length;
 

package/src/engine/graphics/ecs/sprite/Sprite.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @deprecated
+ */
 export class Sprite {
     size: number;
     url: string;

package/src/engine/graphics/ecs/sprite/Sprite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/Sprite.js"],"names":[],"mappings":"AAGA;IACI,aAAS;IACT,YAAS;IACT,iBAAyB;IACzB,aAA2B;CAC9B;;;;oBARmB,kCAAkC;sBAChC,iCAAiC"}
+{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/Sprite.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IACI,aAAS;IACT,YAAS;IACT,iBAAyB;IACzB,aAA2B;CAC9B;;;;oBAXmB,kCAAkC;sBAChC,iCAAiC"}

package/src/engine/graphics/ecs/sprite/Sprite.js

@@ -1,6 +1,9 @@
 import Vector1 from "../../../../core/geom/Vector1.js";
 import { Color } from "../../../../core/color/Color.js";
 
+/**
+ * @deprecated
+ */
 export class Sprite {
     size = 1;
     url = "";

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @deprecated
+ */
 export class SpriteSystemPE extends AbstractContextSystem<any> {
     constructor();
     dependencies: (typeof Transform64 | typeof Sprite)[];

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCAzIqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}
+{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;;GAEG;AACH;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCA5IqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.js

@@ -132,6 +132,9 @@ class Context extends SystemEntityContext {
     }
 }
 
+/**
+ * @deprecated
+ */
 export class SpriteSystemPE extends AbstractContextSystem {
     dependencies = [Sprite, Transform64];
 

package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts

@@ -64,11 +64,11 @@ export class FluidObstacleSystem extends System<any> {
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#416@#refresh_masks"(fluid: FluidComponent): void;
+    static "__#418@#refresh_masks"(fluid: FluidComponent): void;
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#416@#clear_field"(fluid: FluidComponent): void;
+    static "__#418@#clear_field"(fluid: FluidComponent): void;
     /**
      * Mark every cell of `fluid` whose centre lies within `inflation` of the
      * posed shape as solid. Iteration is clipped to the shape's world AABB
@@ -80,7 +80,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} inflation       world-units SDF threshold
      * @param {Float64Array} point     length-3 scratch
      */
-    static "__#416@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
+    static "__#418@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
     /**
      * Write the obstacle's translation velocity onto every face of every cell
      * it voxelized — the moving-wall boundary condition. Runs AFTER the mask
@@ -100,7 +100,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} wvy
      * @param {number} wvz
      */
-    static "__#416@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
+    static "__#418@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
     constructor();
     dependencies: (typeof FluidObstacle)[];
     components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof RigidBody> | ResourceAccessSpecification<typeof Collider> | ResourceAccessSpecification<typeof FluidComponent> | ResourceAccessSpecification<typeof FluidObstacle>)[];

package/src/shade/device/mock/SoftwareGPURenderPassEncoder.d.ts

@@ -27,7 +27,11 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase implemen
      * `-1` rather than a number read out of a buffer nobody filled — the same admission
      * {@link SoftwareGPUComputePassEncoder#dispatchWorkgroupsIndirect} makes.
      *
-     * @type {{pipeline: GPURenderPipeline|null, bind_groups: GPUBindGroup[], dynamic_offsets: number[][], vertex_buffers: object[], index_buffer: object|null, viewport: object|null, scissor: object|null, vertex_count: number, instance_count: number, indexed: boolean, indirect: boolean}[]}
+     * A direct draw also records where it starts — `first_vertex` and `first_instance`, or for an
+     * indexed one `first_index`, `base_vertex` and `first_instance` — with WebGPU's defaults of 0
+     * where they were left out. An indirect one records none of them: they are in the buffer too.
+     *
+     * @type {{pipeline: GPURenderPipeline|null, bind_groups: GPUBindGroup[], dynamic_offsets: number[][], vertex_buffers: object[], index_buffer: object|null, viewport: object|null, scissor: object|null, vertex_count: number, instance_count: number, first_vertex?: number, first_index?: number, base_vertex?: number, first_instance?: number, indexed: boolean, indirect: boolean}[]}
      */
     draws: {
         pipeline: GPURenderPipeline | null;
@@ -39,6 +43,10 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase implemen
         scissor: object | null;
         vertex_count: number;
         instance_count: number;
+        first_vertex?: number;
+        first_index?: number;
+        base_vertex?: number;
+        first_instance?: number;
         indexed: boolean;
         indirect: boolean;
     }[];
@@ -118,15 +126,24 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase implemen
     setStencilReference(reference: number): void;
     stencil_reference: number;
     /**
+     * Where the draw starts is recorded with its counts: a direct draw's `instance_index` counts from
+     * `first_instance`, and a draw that picks its row of a table through it names that row nowhere
+     * else.
+     *
      * @param {number} vertex_count
      * @param {number} [instance_count]
+     * @param {number} [first_vertex]
+     * @param {number} [first_instance]
      */
-    draw(vertex_count: number, instance_count?: number): void;
+    draw(vertex_count: number, instance_count?: number, first_vertex?: number, first_instance?: number): void;
     /**
      * @param {number} index_count
      * @param {number} [instance_count]
+     * @param {number} [first_index]
+     * @param {number} [base_vertex]
+     * @param {number} [first_instance]
      */
-    drawIndexed(index_count: number, instance_count?: number): void;
+    drawIndexed(index_count: number, instance_count?: number, first_index?: number, base_vertex?: number, first_instance?: number): void;
     /**
      * @param {GPUBuffer} indirect_buffer
      * @param {number} indirect_offset

package/src/shade/device/mock/SoftwareGPURenderPassEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoftwareGPURenderPassEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/shade/device/mock/SoftwareGPURenderPassEncoder.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,mFAFgB,oBAAoB;IAmFhC;;;OAGG;IACH,sFAQC;IA5FD;;;;;;;;;OASG;IACH,OAFU;QAAC,QAAQ,EAAE,oBAAkB,IAAI,CAAC;QAAC,WAAW,EAAE,cAAc,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAC,EAAE,CAElR;IAEX;;;;;;OAMG;IACH,oCAAW;IAoDX;;;;OAIG;IACH,uBAEC;IAsBD;;OAEG;IACH,+CAIC;IAED;;;;;;;;OAQG;IACH,oBANW,MAAM,8CAEN,MAAM,EAAE,GAAC,WAAW,0BACpB,MAAM,2BACN,MAAM,QA0BhB;IAED;;;;;OAKG;IACH,4BALW,MAAM,QACN,WAAW,GAAC,eAAe,gBAC3B,MAAM,cACN,MAAM,QAUhB;IAED;;;;;OAKG;IACH,sBALW,MAAM,8BAEN,MAAM,SACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,yEAHW,MAAM,SACN,MAAM,QAQhB;IAED;;;;;;;OAOG;IACH,eAPW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,aACN,MAAM,aACN,MAAM,QAMhB;IAED;;;;;OAKG;IACH,kBALW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,QAMhB;IAED;;OAEG;IACH,wCAIC;IADG,yBAA2B;IAG/B;;OAEG;IACH,+BAFW,MAAM,QAMhB;IADG,0BAAkC;IAwCtC;;;OAGG;IACH,mBAHW,MAAM,mBACN,MAAM,QAahB;IAED;;;OAGG;IACH,yBAHW,MAAM,mBACN,MAAM,QAahB;IAED;;;OAGG;IACH,0DAFW,MAAM,QAkBhB;IAED;;;OAGG;IACH,iEAFW,MAAM,QAiBhB;IAED;;OAEG;IACH,sBAFW,MAAM,QAIhB;IAED,sBAEC;IAED;;OAEG;IACH,yBAFW,MAAM,QAIhB;IAED,YAQC;IAGL;;;OAGG;IACH,yCAFU,OAAO,CAEoD;;CANpE;sCAzYqC,4BAA4B"}
+{"version":3,"file":"SoftwareGPURenderPassEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/shade/device/mock/SoftwareGPURenderPassEncoder.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,mFAFgB,oBAAoB;IAuFhC;;;OAGG;IACH,sFAQC;IAhGD;;;;;;;;;;;;;OAaG;IACH,OAFU;QAAC,QAAQ,EAAE,oBAAkB,IAAI,CAAC;QAAC,WAAW,EAAE,cAAc,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAC,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAC,EAAE,CAE9W;IAEX;;;;;;OAMG;IACH,oCAAW;IAoDX;;;;OAIG;IACH,uBAEC;IAsBD;;OAEG;IACH,+CAIC;IAED;;;;;;;;OAQG;IACH,oBANW,MAAM,8CAEN,MAAM,EAAE,GAAC,WAAW,0BACpB,MAAM,2BACN,MAAM,QA0BhB;IAED;;;;;OAKG;IACH,4BALW,MAAM,QACN,WAAW,GAAC,eAAe,gBAC3B,MAAM,cACN,MAAM,QAUhB;IAED;;;;;OAKG;IACH,sBALW,MAAM,8BAEN,MAAM,SACN,MAAM,QAShB;IAED;;;;;OAKG;IACH,yEAHW,MAAM,SACN,MAAM,QAQhB;IAED;;;;;;;OAOG;IACH,eAPW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,aACN,MAAM,aACN,MAAM,QAMhB;IAED;;;;;OAKG;IACH,kBALW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,QAMhB;IAED;;OAEG;IACH,wCAIC;IADG,yBAA2B;IAG/B;;OAEG;IACH,+BAFW,MAAM,QAMhB;IADG,0BAAkC;IAwCtC;;;;;;;;;OASG;IACH,mBALW,MAAM,mBACN,MAAM,iBACN,MAAM,mBACN,MAAM,QAehB;IAED;;;;;;OAMG;IACH,yBANW,MAAM,mBACN,MAAM,gBACN,MAAM,gBACN,MAAM,mBACN,MAAM,QAgBhB;IAED;;;OAGG;IACH,0DAFW,MAAM,QAkBhB;IAED;;;OAGG;IACH,iEAFW,MAAM,QAiBhB;IAED;;OAEG;IACH,sBAFW,MAAM,QAIhB;IAED,sBAEC;IAED;;OAEG;IACH,yBAFW,MAAM,QAIhB;IAED,YAQC;IAGL;;;OAGG;IACH,yCAFU,OAAO,CAEoD;;CANpE;sCA3ZqC,4BAA4B"}

package/src/shade/device/mock/SoftwareGPURenderPassEncoder.js

@@ -28,7 +28,11 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase {
      * `-1` rather than a number read out of a buffer nobody filled — the same admission
      * {@link SoftwareGPUComputePassEncoder#dispatchWorkgroupsIndirect} makes.
      *
-     * @type {{pipeline: GPURenderPipeline|null, bind_groups: GPUBindGroup[], dynamic_offsets: number[][], vertex_buffers: object[], index_buffer: object|null, viewport: object|null, scissor: object|null, vertex_count: number, instance_count: number, indexed: boolean, indirect: boolean}[]}
+     * A direct draw also records where it starts — `first_vertex` and `first_instance`, or for an
+     * indexed one `first_index`, `base_vertex` and `first_instance` — with WebGPU's defaults of 0
+     * where they were left out. An indirect one records none of them: they are in the buffer too.
+     *
+     * @type {{pipeline: GPURenderPipeline|null, bind_groups: GPUBindGroup[], dynamic_offsets: number[][], vertex_buffers: object[], index_buffer: object|null, viewport: object|null, scissor: object|null, vertex_count: number, instance_count: number, first_vertex?: number, first_index?: number, base_vertex?: number, first_instance?: number, indexed: boolean, indirect: boolean}[]}
      */
     draws = [];
 
@@ -291,10 +295,16 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase {
     }
 
     /**
+     * Where the draw starts is recorded with its counts: a direct draw's `instance_index` counts from
+     * `first_instance`, and a draw that picks its row of a table through it names that row nowhere
+     * else.
+     *
      * @param {number} vertex_count
      * @param {number} [instance_count]
+     * @param {number} [first_vertex]
+     * @param {number} [first_instance]
      */
-    draw(vertex_count, instance_count = 1) {
+    draw(vertex_count, instance_count = 1, first_vertex = 0, first_instance = 0) {
         this.#assert_encoding();
         this.#validate_immediates();
 
@@ -302,6 +312,8 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase {
             ...this.#snapshot(),
             vertex_count,
             instance_count,
+            first_vertex,
+            first_instance,
             indexed: false,
             indirect: false,
         });
@@ -310,8 +322,11 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase {
     /**
      * @param {number} index_count
      * @param {number} [instance_count]
+     * @param {number} [first_index]
+     * @param {number} [base_vertex]
+     * @param {number} [first_instance]
      */
-    drawIndexed(index_count, instance_count = 1) {
+    drawIndexed(index_count, instance_count = 1, first_index = 0, base_vertex = 0, first_instance = 0) {
         this.#assert_encoding();
         this.#validate_immediates();
 
@@ -319,6 +334,9 @@ export class SoftwareGPURenderPassEncoder extends SoftwareGPUObjectBase {
             ...this.#snapshot(),
             vertex_count: index_count,
             instance_count,
+            first_index,
+            base_vertex,
+            first_instance,
             indexed: true,
             indirect: false,
         });

package/src/shade/renderer/GraphicsContext.d.ts

@@ -111,6 +111,17 @@ export class GraphicsContext {
         offset: number;
         size: number;
     }): void;
+    /**
+     * Set one bind group of `pipeline`'s layout, leaving the others as they are — for a pass whose
+     * groups change at different rates, where {@link setPipelineBindings} would set every group up
+     * to the last one on each change.
+     *
+     * @param {GPUBindingCommandsMixin} pass
+     * @param {PipelineDescriptorBase} pipeline
+     * @param {number} index the group's index in the pipeline's layout
+     * @param {GPUBindingResource[]} resources the group's entries, in binding order
+     */
+    setPipelineBindGroup(pass: GPUBindingCommandsMixin, pipeline: PipelineDescriptorBase, index: number, resources: GPUBindingResource[]): void;
     /**
      *
      * @param {BufferDescriptor} buffer_descriptor

package/src/shade/renderer/GraphicsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicsContext.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/GraphicsContext.js"],"names":[],"mappings":"AAmCA;IAoKI,yBAiCC;IApMD;;OAEG;IACH,YAFU,kBAAkB,CAEjB;IAEX;;OAEG;IACH,WAFU,kBAAkB,CAElB;IAOV;;OAEG;IACH,UAFU,iBAAiB,CAElB;IAET;;;OAGG;IACH,qDAOC;IAOD;;;OAGG;IACH,6CAEC;IAED;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,mBAFU,sBAAsB,CAEd;IAGlB;;OAEG;IACH,gBAFU,oBAAoB,CAEf;IAEf;;OAEG;IACH,UAFU,cAAc,CAEf;IAET;;;;OAIG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,aAFU,gBAAgB,CAEd;IAQZ;;;OAGG;IACH,uBAFU,kBAAkB,CAEN;IAEtB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;;OAIG;IACH,0BAFU,yBAAyB,CAEV;IAEzB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;;OAIG;IACH,2BAFU,0BAA0B,CAEV;IAE1B;;;OAGG;IACH,oBAFU,mBAAmB,CAEV;IAUnB;;;OAGG;IACH,8BAEC;IAED,uBAOC;IAED;;;OAGG;IACH,wBAEC;IAqCD;;;;;;;;OAQG;IACH,6DANW,sBAAsB,aACtB,oBAAoB,EAAE,cACtB;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,QAmE9D;IAED;;;;OAIG;IACH,gCAHW,gBAAgB,GACd,gBAAgB,CAI5B;IAED;;OAEG;IACH,+BAgBC;IAED,4BAEC;IAED,eAmDC;IAED,gBAoBC;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;;CAN1C;+BAvYY,OAAO,0CAA0C,EAAE,gBAAgB;qCACnE,OAAO,kDAAkD,EAAE,sBAAsB;2BAKjF,OAAO,mCAAmC,EAAE,YAAY;mCAjBlC,kCAAkC;mCAGlC,kCAAkC;kCADnC,wBAAwB;2CAEf,mDAAmD;oCAH1D,2CAA2C;sCAbzC,6CAA6C;sCAC7C,6CAA6C;uCAF5C,8CAA8C;qCAIhD,0CAA0C;+BAgBhD,6BAA6B;sCACtB,4CAA4C;iCAfjD,+BAA+B;mCAC7B,gCAAgC;yCAC1B,sCAAsC;0CAGrC,uCAAuC;yCACxC,sCAAsC;2CAFpC,wCAAwC;oCAS/C,kCAAkC;iCAVtB,8BAA8B"}
+{"version":3,"file":"GraphicsContext.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/GraphicsContext.js"],"names":[],"mappings":"AAmCA;IAqKI,yBAiCC;IArMD;;OAEG;IACH,YAFU,kBAAkB,CAEjB;IAEX;;OAEG;IACH,WAFU,kBAAkB,CAElB;IAOV;;OAEG;IACH,UAFU,iBAAiB,CAElB;IAET;;;OAGG;IACH,qDAOC;IAOD;;;OAGG;IACH,6CAEC;IAED;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,mBAFU,sBAAsB,CAEd;IAGlB;;OAEG;IACH,gBAFU,oBAAoB,CAEf;IAEf;;OAEG;IACH,UAFU,cAAc,CAEf;IAET;;;;OAIG;IACH,kBAFU,qBAAqB,CAEd;IAEjB;;OAEG;IACH,aAFU,gBAAgB,CAEd;IAQZ;;;OAGG;IACH,uBAFU,kBAAkB,CAEN;IAEtB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;;OAIG;IACH,0BAFU,yBAAyB,CAEV;IAEzB;;;;OAIG;IACH,yBAFU,wBAAwB,CAEV;IAExB;;;;OAIG;IACH,2BAFU,0BAA0B,CAEV;IAE1B;;;OAGG;IACH,oBAFU,mBAAmB,CAEV;IAUnB;;;OAGG;IACH,8BAEC;IAED,uBAQC;IAED;;;OAGG;IACH,wBAEC;IAqCD;;;;;;;;OAQG;IACH,6DANW,sBAAsB,aACtB,oBAAoB,EAAE,cACtB;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,QA2B9D;IAED;;;;;;;;;OASG;IACH,8DAJW,sBAAsB,SACtB,MAAM,aACN,oBAAoB,QA0C9B;IAED;;;;OAIG;IACH,gCAHW,gBAAgB,GACd,gBAAgB,CAI5B;IAED;;OAEG;IACH,+BAgBC;IAED,4BAEC;IAED,eAoDC;IAED,gBAoBC;IAGL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;;CAN1C;+BArZY,OAAO,0CAA0C,EAAE,gBAAgB;qCACnE,OAAO,kDAAkD,EAAE,sBAAsB;2BAKjF,OAAO,mCAAmC,EAAE,YAAY;mCAjBlC,kCAAkC;mCAGlC,kCAAkC;kCADnC,wBAAwB;2CAEf,mDAAmD;oCAH1D,2CAA2C;sCAbzC,6CAA6C;sCAC7C,6CAA6C;uCAF5C,8CAA8C;qCAIhD,0CAA0C;+BAgBhD,6BAA6B;sCACtB,4CAA4C;iCAfjD,+BAA+B;mCAC7B,gCAAgC;yCAC1B,sCAAsC;0CAGrC,uCAAuC;yCACxC,sCAAsC;2CAFpC,wCAAwC;oCAS/C,kCAAkC;iCAVtB,8BAA8B"}

package/src/shade/renderer/GraphicsContext.js

@@ -183,8 +183,9 @@ export class GraphicsContext {
     increment_time() {
         this.#timer_increment++;
 
-        // advance the single frame clock for the substitutable pools in lockstep
+        // advance the single frame clock for the pools in lockstep
         this.buffer_allocator_main.increment_time();
+        this.buffer_allocator_staging.increment_time();
         this.buffer_allocator_upload.increment_time();
         this.allocator_textures.increment_time();
     }
@@ -257,53 +258,65 @@ export class GraphicsContext {
             pass.setImmediates(0, immediate.buffer.raw_bytes, immediate.offset, immediate.size);
         }
 
-        const bind_group_descriptors = pipeline.layout.bindGroupLayouts;
-
         const bind_group_count = bindings.length;
 
-        assert.lessThanOrEqual(bind_group_count, bind_group_descriptors.length, 'too many bind groups (more than in descriptor)');
-
-        const bind_group_manager = this.bind_groups;
+        assert.lessThanOrEqual(bind_group_count, pipeline.layout.bindGroupLayouts.length, 'too many bind groups (more than in descriptor)');
 
         for (let i = 0; i < bind_group_count; i++) {
-            const group_resource_set = bindings[i];
-
-            assert.isArray(group_resource_set, `bindings[${i}]`);
-
-            const bind_group_layout_descriptor = bind_group_descriptors[i];
-
-            const descriptor = BindGroupDescriptor.from(
-                bind_group_layout_descriptor,
-                group_resource_set
-            );
-
-            const bind_group = bind_group_manager.obtain(descriptor);
+            this.setPipelineBindGroup(pass, pipeline, i, bindings[i]);
+        }
+    }
 
-            if (DEBUG_LOGGING) {
-                // debug
-                const descriptor_rev = bind_group_manager.reverse_lookup(bind_group);
+    /**
+     * Set one bind group of `pipeline`'s layout, leaving the others as they are — for a pass whose
+     * groups change at different rates, where {@link setPipelineBindings} would set every group up
+     * to the last one on each change.
+     *
+     * @param {GPUBindingCommandsMixin} pass
+     * @param {PipelineDescriptorBase} pipeline
+     * @param {number} index the group's index in the pipeline's layout
+     * @param {GPUBindingResource[]} resources the group's entries, in binding order
+     */
+    setPipelineBindGroup(pass, pipeline, index, resources) {
+        assert.isArray(resources, `bindings[${index}]`);
 
-                const entries = descriptor_rev.entries
-                    .map(e => {
-                        if (e.buffer !== undefined) {
-                            return `buffer:"${e.buffer.label}"`;
-                        } else if (e instanceof GPUTextureView) {
-                            return "texture_view"
-                        } else if (e instanceof GPUSampler) {
-                            return "sampler"
-                        } else {
-                            // something else
-                            return "unknown";
-                        }
+        const bind_group_descriptors = pipeline.layout.bindGroupLayouts;
 
-                    })
-                    .filter(e => e !== undefined);
+        assert.lessThan(index, bind_group_descriptors.length, 'index is past the last group in the descriptor');
 
-                console.log(`pass.setBindGrpup(${i}, [ ${entries.join(', ')} ])`);
-            }
+        const bind_group_manager = this.bind_groups;
 
-            pass.setBindGroup(i, bind_group);
+        const descriptor = BindGroupDescriptor.from(
+            bind_group_descriptors[index],
+            resources
+        );
+
+        const bind_group = bind_group_manager.obtain(descriptor);
+
+        if (DEBUG_LOGGING) {
+            // debug
+            const descriptor_rev = bind_group_manager.reverse_lookup(bind_group);
+
+            const entries = descriptor_rev.entries
+                .map(e => {
+                    if (e.buffer !== undefined) {
+                        return `buffer:"${e.buffer.label}"`;
+                    } else if (e instanceof GPUTextureView) {
+                        return "texture_view"
+                    } else if (e instanceof GPUSampler) {
+                        return "sampler"
+                    } else {
+                        // something else
+                        return "unknown";
+                    }
+
+                })
+                .filter(e => e !== undefined);
+
+            console.log(`pass.setBindGrpup(${index}, [ ${entries.join(', ')} ])`);
         }
+
+        pass.setBindGroup(index, bind_group);
     }
 
     /**
@@ -390,6 +403,7 @@ export class GraphicsContext {
         }
 
         this.buffer_allocator_main.update();
+        this.buffer_allocator_staging.update();
         this.buffer_allocator_upload.update();
     }
 

package/src/shade/renderer/buffer/GPUBufferReadbackAllocator.d.ts

@@ -2,11 +2,12 @@
  * Persistent `MAP_READ | COPY_DST` buffers for reading GPU data back — {@link GPUBufferStagingAllocator}
  * run the other way.
  *
- * The same shape on purpose: a size-sorted free list, `get(min_size)` serving the smallest buffer
- * that fits and creating one when none does, `release(buffer)` putting it back. Where the staging
- * pool re-maps a buffer on release because the next writer needs it mapped, this one *unmaps*,
- * because the next copy into it needs it unmapped; the mapping is the holder's, taken after the
- * copy has landed and read at the holder's own apply point.
+ * The same shape: a size-sorted free list, `get(min_size)` serving the smallest buffer that fits
+ * and creating one when none does, `release(buffer)` putting it back. Where the staging pool re-maps
+ * a buffer on release because the next writer needs it mapped, this one *unmaps*, because the next
+ * copy into it needs it unmapped; the mapping is the holder's, taken after the copy has landed and
+ * read at the holder's own apply point. Unlike the staging pool, this one has no bound on how much
+ * larger than the request a buffer it serves may be, no size classes and no reclaim.
  *
  * Why not `buffer_allocator_main`: `TransientResourcePool`'s reuse safety rests on transients being
  * GPU-only, and a readback buffer is held by the CPU across frames.

package/src/shade/renderer/buffer/GPUBufferReadbackAllocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUBufferReadbackAllocator.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/buffer/GPUBufferReadbackAllocator.js"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IA4BI;;;;OAIG;IACH;QAF4B,YAAY,GAA7B,MAAM;OAQhB;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,8BAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;OAGG;IACH,0BAEC;IAED;;;;;;OAMG;IACH,oBAHW,MAAM,aAkChB;IAED;;;;;OAKG;IACH,iCAsBC;IAED;;;;;OAKG;IACH,iCAMC;IAkBD,gBAUC;;CACJ"}
+{"version":3,"file":"GPUBufferReadbackAllocator.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/buffer/GPUBufferReadbackAllocator.js"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IA4BI;;;;OAIG;IACH;QAF4B,YAAY,GAA7B,MAAM;OAQhB;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,8BAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;OAGG;IACH,0BAEC;IAED;;;;;;OAMG;IACH,oBAHW,MAAM,aAkChB;IAED;;;;;OAKG;IACH,iCAsBC;IAED;;;;;OAKG;IACH,iCAMC;IAkBD,gBAUC;;CACJ"}