@woosh/meep-engine 3.21.0 → 3.22.0

package/src/shade/renderer/geometry/GPUGeometryMetadata.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("./MeshletGeometry.js").MeshletGeometry} MeshletGeometry
+ */
 export class GPUGeometryMetadata {
     /**
      * @type {MeshletGeometry}
@@ -23,4 +26,5 @@ export class GPUGeometryMetadata {
     references: number;
     allocated: boolean;
 }
+export type MeshletGeometry = import("./MeshletGeometry.js").MeshletGeometry;
 //# sourceMappingURL=GPUGeometryMetadata.d.ts.map

package/src/shade/renderer/geometry/GPUGeometryMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUGeometryMetadata.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/GPUGeometryMetadata.js"],"names":[],"mappings":"AAAA;IACI;;OAEG;IACH,0BAAQ;IAER;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;OAEG;IACH,uCAAS;IAET;;;;;;;OAOG;IACH,YAFU,MAAM,CAED;IAEf,mBAAkB;CACrB"}
+{"version":3,"file":"GPUGeometryMetadata.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/GPUGeometryMetadata.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;IACI;;OAEG;IACH,UAFU,eAAe,CAEjB;IAER;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;OAEG;IACH,uCAAS;IAET;;;;;;;OAOG;IACH,YAFU,MAAM,CAED;IAEf,mBAAkB;CACrB;8BA/BY,OAAO,sBAAsB,EAAE,eAAe"}

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

@@ -1,3 +1,7 @@
+/**
+ * @typedef {import("./MeshletGeometry.js").MeshletGeometry} MeshletGeometry
+ */
+
 export class GPUGeometryMetadata {
     /**
      * @type {MeshletGeometry}

package/src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.d.ts

@@ -47,11 +47,15 @@ export class GPUBLASRefitBatch {
      * Record this frame's refit of every listed tree that is resident.
      *
      * @param {ShadeGPUCommandContext} cmd
-     * @param {GPUGeometryBVHManager} blas tree residency — arenas for nodes, parents and leaf lists
-     * @param {GPUGeometryManager} geometries geometry metadata table the leaf boxes read vertices through
+     * @param {Object} options
+     * @param {GPUGeometryBVHManager} options.blas tree residency — arenas for nodes, parents and leaf lists
+     * @param {GPUGeometryManager} options.geometries geometry metadata table the leaf boxes read vertices through
      * @returns {boolean} whether anything was recorded
      */
-    record(cmd: ShadeGPUCommandContext, { blas, geometries }: GPUGeometryBVHManager): boolean;
+    record(cmd: ShadeGPUCommandContext, { blas, geometries }: {
+        blas: GPUGeometryBVHManager;
+        geometries: GPUGeometryManager;
+    }): boolean;
     destroy(): void;
     #private;
 }

package/src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUBLASRefitBatch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IA4DI;;OAEG;IACH,+BAIC;IAED;;;;;;;OAOG;IACH,qBAFW;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAC,EAAE,QAkBnD;IAED;;;;;;;OAOG;IACH,kFAFa,OAAO,CAqDnB;IA8ID,gBAgBC;;CACJ"}
+{"version":3,"file":"GPUBLASRefitBatch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IA4DI;;OAEG;IACH,+BAIC;IAED;;;;;;;OAOG;IACH,qBAFW;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAC,EAAE,QAkBnD;IAED;;;;;;;;OAQG;IACH;QAJ0C,IAAI;QACP,UAAU;QACpC,OAAO,CAqDnB;IA8ID,gBAgBC;;CACJ"}

package/src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.js

@@ -145,8 +145,9 @@ export class GPUBLASRefitBatch {
      * Record this frame's refit of every listed tree that is resident.
      *
      * @param {ShadeGPUCommandContext} cmd
-     * @param {GPUGeometryBVHManager} blas tree residency — arenas for nodes, parents and leaf lists
-     * @param {GPUGeometryManager} geometries geometry metadata table the leaf boxes read vertices through
+     * @param {Object} options
+     * @param {GPUGeometryBVHManager} options.blas tree residency — arenas for nodes, parents and leaf lists
+     * @param {GPUGeometryManager} options.geometries geometry metadata table the leaf boxes read vertices through
      * @returns {boolean} whether anything was recorded
      */
     record(cmd, { blas, geometries }) {

package/src/shade/renderer/geometry/bvh/GPUGeometryBVHManager.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../MeshletGeometry.js").MeshletGeometry} MeshletGeometry
+ */
 /**
  * One row of the lookup table the traversal shaders read as `blas_lookup`.
  *
@@ -144,6 +147,7 @@ export class GPUGeometryBVHManager {
     update(): void;
     #private;
 }
+export type MeshletGeometry = import("../MeshletGeometry.js").MeshletGeometry;
 import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 import { GPUGeometryMeshletsBVH } from "./GPUGeometryMeshletsBVH.js";
 //# sourceMappingURL=GPUGeometryBVHManager.d.ts.map

package/src/shade/renderer/geometry/bvh/GPUGeometryBVHManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUGeometryBVHManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/GPUGeometryBVHManager.js"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,gDAGG;AAEH;;;;;;;;;;;GAWG;AACH,sCAFU,MAAM,CAEyB;AAUzC;;;;;;;;;;;;;;GAcG;AACH;IAwHI;;;OAGG;IACH,+BAwCC;IA5JD;;;OAGG;IACH,iCAEC;IAOD;;;OAGG;IACH,6BAEC;IAqBD;;OAEG;IACH,gCAEC;IAOD;;OAEG;IACH,mCAEC;IA+BD;;OAEG;IACH,gCAEC;IAiED;;;;OAIG;IACH,iCAEC;IAED,+BAoBC;IAED;;;;;;;;;;;;;;OAcG;IACH,cALW,MAAM,4BAGJ,sBAAsB,CAalC;IA8DD;;;;;;;;;;;;OAYG;IACH,wBAHW,MAAM,GACJ;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAC,GAAC,SAAS,CAqB3I;IAED;;;;;;OAMG;IACH,mBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAU5B;IAED;;;;;;;;;OASG;IACH,0BAFW,WAAW,QAQrB;IAED;;;;;;;;OAQG;IACH,cAHW,MAAM,GACJ,OAAO,CAqBnB;IA8ID;;;;;;;OAOG;IACH,eAOC;;CA6HJ;6BAntB4B,mCAAmC;uCASzB,6BAA6B"}
+{"version":3,"file":"GPUGeometryBVHManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/GPUGeometryBVHManager.js"],"names":[],"mappings":"AAkBA;;GAEG;AAEH;;;;;GAKG;AACH,gDAGG;AAEH;;;;;;;;;;;GAWG;AACH,sCAFU,MAAM,CAEyB;AAUzC;;;;;;;;;;;;;;GAcG;AACH;IAwHI;;;OAGG;IACH,+BAwCC;IA5JD;;;OAGG;IACH,iCAEC;IAOD;;;OAGG;IACH,6BAEC;IAqBD;;OAEG;IACH,gCAEC;IAOD;;OAEG;IACH,mCAEC;IA+BD;;OAEG;IACH,gCAEC;IAiED;;;;OAIG;IACH,iCAEC;IAED,+BAoBC;IAED;;;;;;;;;;;;;;OAcG;IACH,cALW,MAAM,UACN,eAAe,GAEb,sBAAsB,CAalC;IA8DD;;;;;;;;;;;;OAYG;IACH,wBAHW,MAAM,GACJ;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAC,GAAC,SAAS,CAqB3I;IAED;;;;;;OAMG;IACH,mBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAU5B;IAED;;;;;;;;;OASG;IACH,0BAFW,WAAW,QAQrB;IAED;;;;;;;;OAQG;IACH,cAHW,MAAM,GACJ,OAAO,CAqBnB;IA8ID;;;;;;;OAOG;IACH,eAOC;;CA6HJ;8BA3sBY,OAAO,uBAAuB,EAAE,eAAe;6BAZ/B,mCAAmC;uCASzB,6BAA6B"}

package/src/shade/renderer/geometry/bvh/GPUGeometryBVHManager.js

@@ -16,6 +16,10 @@ import { ensure_buffer_capacity } from "../make_temp_gpu_buffer.js";
 import { bvh2_derive_topology } from "./bvh2_derive_topology.js";
 import { GPUGeometryMeshletsBVH } from "./GPUGeometryMeshletsBVH.js";
 
+/**
+ * @typedef {import("../MeshletGeometry.js").MeshletGeometry} MeshletGeometry
+ */
+
 /**
  * One row of the lookup table the traversal shaders read as `blas_lookup`.
  *

package/src/shade/renderer/geometry/bvh/bvh_to_gpu_buffer.d.ts

@@ -1,9 +1,15 @@
 /**
  * Writes ROOT node as u32 at the start, followed by node array
- * @param {GPUDevice} device
- * @param {BVH} bvh
- * @param {number|GPUBufferUsage} usage
- * @param {string} [label]
+ * @param {Object} options
+ * @param {GPUDevice} options.device
+ * @param {BVH} options.bvh
+ * @param {number|GPUBufferUsage} options.usage
+ * @param {string} [options.label]
  */
-export function bvh_to_gpu_buffer({ device, bvh, usage, label, }: GPUDevice): any;
+export function bvh_to_gpu_buffer({ device, bvh, usage, label, }: {
+    device: GPUDevice;
+    bvh: BVH;
+    usage: number | GPUBufferUsage;
+    label?: string;
+}): any;
 //# sourceMappingURL=bvh_to_gpu_buffer.d.ts.map

package/src/shade/renderer/geometry/bvh/bvh_to_gpu_buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bvh_to_gpu_buffer.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/bvh_to_gpu_buffer.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,kFAkCC"}
+{"version":3,"file":"bvh_to_gpu_buffer.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/bvh_to_gpu_buffer.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH;IAL8B,MAAM;IACZ,GAAG;IACe,KAAK,EAApC,MAAM,iBAAe;IACJ,KAAK,GAAtB,MAAM;QAoChB"}

package/src/shade/renderer/geometry/bvh/bvh_to_gpu_buffer.js

@@ -4,10 +4,11 @@ import { BVH2_NODE_STRUCT } from "../../shader/chunk/bvh/BVH2_NODE_STRUCT.js";
 
 /**
  * Writes ROOT node as u32 at the start, followed by node array
- * @param {GPUDevice} device
- * @param {BVH} bvh
- * @param {number|GPUBufferUsage} usage
- * @param {string} [label]
+ * @param {Object} options
+ * @param {GPUDevice} options.device
+ * @param {BVH} options.bvh
+ * @param {number|GPUBufferUsage} options.usage
+ * @param {string} [options.label]
  */
 export function bvh_to_gpu_buffer({
                                       device,

package/src/shade/renderer/geometry/meshlet/GPUMeshletManager.d.ts

@@ -1,11 +1,16 @@
 export class GPUMeshletManager {
     /**
      *
-     * @param {GPUDevice} device
-     * @param {number} [initial_data_capacity] in bytes
-     * @param {number} [initial_metadata_capacity] in meshlets
+     * @param {Object} options
+     * @param {GPUDevice} options.device
+     * @param {number} [options.initial_data_capacity] in bytes
+     * @param {number} [options.initial_metadata_capacity] in meshlets
      */
-    constructor({ device, initial_data_capacity, initial_metadata_capacity, }: GPUDevice);
+    constructor({ device, initial_data_capacity, initial_metadata_capacity, }: {
+        device: GPUDevice;
+        initial_data_capacity?: number;
+        initial_metadata_capacity?: number;
+    });
     get buffer_data(): GPUBuffer;
     get buffer_metadata(): GPUBuffer;
     compact(): void;
@@ -80,6 +85,9 @@ export class GPUMeshletManager {
     get gpu_memory_usage(): number;
     #private;
 }
+export type Allocation = import("../../../../core/binary/allocator/OffsetAllocator.js").Allocation;
+export type ShadeGPUCommandContext = import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext;
+export type MeshletBatch = import("./MeshletBatch.js").MeshletBatch;
 declare class MeshletBatchAllocationRecord {
     /**
      * @type {Allocation}

package/src/shade/renderer/geometry/meshlet/GPUMeshletManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUMeshletManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/meshlet/GPUMeshletManager.js"],"names":[],"mappings":"AA+DA;IAoEI;;;;;OAKG;IACH,sFAiCC;IAxFD,6BAEC;IAOD,iCAEC;IA+ED,gBAKC;IAED;;;;OAIG;IACH,sBAHW,MAAM,uBACN,MAAM,QAiDhB;IA+PD;;;;;;;;;;;OAWG;IACH,qBAJW,4BAA4B,GAE1B,OAAO,CAiBnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,+BAHW,4BAA4B,GAC1B,4BAA4B,CA8BxC;IAED;;;;;;;;;;;;OAYG;IACH,8CA4GC;IAED,gBAGC;IAED;;;;OAIG;IACH,gCAFa,4BAA4B,CA6BxC;IAED,mCASC;IAED,wCAQC;IAED,+BAYC;;CACJ;AAluBD;IACI;;OAEG;IACH,qBAAQ;IACR;;OAEG;IACH,iBAAI;IAEJ;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,0BAFU,WAAW,CAEI;IAEzB;;;OAGG;IACH,aAAsB;CACzB"}
+{"version":3,"file":"GPUMeshletManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/meshlet/GPUMeshletManager.js"],"names":[],"mappings":"AAqEA;IAoEI;;;;;;OAMG;IACH;QAJ8B,MAAM;QACR,qBAAqB,GAAtC,MAAM;QACW,yBAAyB,GAA1C,MAAM;OAmChB;IAzFD,6BAEC;IAOD,iCAEC;IAgFD,gBAKC;IAED;;;;OAIG;IACH,sBAHW,MAAM,uBACN,MAAM,QAiDhB;IA+PD;;;;;;;;;;;OAWG;IACH,qBAJW,4BAA4B,GAE1B,OAAO,CAiBnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,+BAHW,4BAA4B,GAC1B,4BAA4B,CA8BxC;IAED;;;;;;;;;;;;OAYG;IACH,gBAFW,sBAAsB,QA8GhC;IAED,gBAGC;IAED;;;;OAIG;IACH,iBAHW,YAAY,GACV,4BAA4B,CA6BxC;IAED,mCASC;IAED,wCAQC;IAED,+BAYC;;CACJ;yBApvBY,OAAO,sDAAsD,EAAE,UAAU;qCACzE,OAAO,2CAA2C,EAAE,sBAAsB;2BAC1E,OAAO,mBAAmB,EAAE,YAAY;AAerD;IACI;;OAEG;IACH,UAFU,UAAU,CAEZ;IACR;;OAEG;IACH,MAFU,UAAU,CAEhB;IAEJ;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,0BAFU,WAAW,CAEI;IAEzB;;;OAGG;IACH,aAAsB;CACzB"}

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

@@ -14,6 +14,12 @@ import {
 import { MESHLET_METADATA_STRUCT } from "./encoding/MESHLET_METADATA_STRUCT.js";
 import { shader_meshlet_metadata_address_patch } from "./shader_meshlet_metadata_address_patch.js";
 
+/**
+ * @typedef {import("../../../../core/binary/allocator/OffsetAllocator.js").Allocation} Allocation
+ * @typedef {import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext} ShadeGPUCommandContext
+ * @typedef {import("./MeshletBatch.js").MeshletBatch} MeshletBatch
+ */
+
 /**
  * In meshlets
  * @type {number}
@@ -131,9 +137,10 @@ export class GPUMeshletManager {
 
     /**
      *
-     * @param {GPUDevice} device
-     * @param {number} [initial_data_capacity] in bytes
-     * @param {number} [initial_metadata_capacity] in meshlets
+     * @param {Object} options
+     * @param {GPUDevice} options.device
+     * @param {number} [options.initial_data_capacity] in bytes
+     * @param {number} [options.initial_metadata_capacity] in meshlets
      */
     constructor({
                     device,

package/src/shade/renderer/geometry/meshlet/MeshletBatch.d.ts

@@ -78,4 +78,5 @@ export class MeshletBatch {
     readonly isMeshletBatch: boolean;
     #private;
 }
+export type Geometry = import("../Geometry.js").Geometry;
 //# sourceMappingURL=MeshletBatch.d.ts.map

package/src/shade/renderer/geometry/meshlet/MeshletBatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeshletBatch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/meshlet/MeshletBatch.js"],"names":[],"mappings":"AA8DA;;GAEG;AACH;IAiBI;;;OAGG;IACH,oCAGC;IAXD,+BAEC;IA6BD;;;OAGG;IACH,wCAGC;IAfD;;;OAGG;IACH,mCAEC;IAqBD;;;OAGG;IACH,yBAEC;IAdD;;;OAGG;IACH,oBAEC;IAUD;;;OAGG;IACH,QAFa,MAAM,CASlB;IAED;;;OAGG;IACH,cAFW,YAAY,WAQtB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAoFlB;IAED;;;OAGG;IACH,iBAEC;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACL,EAAE,CAeb;IAED;;;OAGG;IACH,yBAFW,MAAM;;;;MAgChB;IA4LD,qBA+BC;IAED;;;OAGG;IACH,gCAOC;IAIL;;;;OAIG;IACH,yBAFU,OAAO,CAEoB;;CAPpC"}
+{"version":3,"file":"MeshletBatch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/meshlet/MeshletBatch.js"],"names":[],"mappings":"AAkEA;;GAEG;AACH;IAiBI;;;OAGG;IACH,oCAGC;IAXD,+BAEC;IA6BD;;;OAGG;IACH,wCAGC;IAfD;;;OAGG;IACH,mCAEC;IAqBD;;;OAGG;IACH,yBAEC;IAdD;;;OAGG;IACH,oBAEC;IAUD;;;OAGG;IACH,QAFa,MAAM,CASlB;IAED;;;OAGG;IACH,cAFW,YAAY,WAQtB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAoFlB;IAED;;;OAGG;IACH,iBAEC;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACL,EAAE,CAeb;IAED;;;OAGG;IACH,yBAFW,MAAM;;;;MAgChB;IA4LD,qBA+BC;IAED;;;OAGG;IACH,gBAFW,QAAQ,QASlB;IAIL;;;;OAIG;IACH,yBAFU,OAAO,CAEoB;;CAPpC;uBA1gBY,OAAO,gBAAgB,EAAE,QAAQ"}

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

@@ -25,6 +25,10 @@ import { meshlet_data_index_section_size } from "./meshlet_data_index_section_si
 import { meshlet_encode_attribute } from "./meshlet_encode_attribute.js";
 import { meshlet_get_attribute_offset } from "./meshlet_get_attribute_offset.js";
 
+/**
+ * @typedef {import("../Geometry.js").Geometry} Geometry
+ */
+
 
 const ENCODED_ATTRIBUTE_DEFAULT_VALUES = {
     [StandardAttributes.Color]: 0xFFFFFFFF,

package/src/shade/renderer/geometry/meshlet_batch_to_bvh.d.ts

@@ -1,10 +1,17 @@
 /**
  *
- * @param {BVH} bvh
- * @param {MeshletBatch} meshlets
- * @param {Float32Array} bounding_box
- * @param {number} primitive_count
- * @param {number} [optimization]
+ * @param {Object} options
+ * @param {BVH} options.bvh
+ * @param {MeshletBatch} options.meshlets
+ * @param {Float32Array} options.bounding_box
+ * @param {number} options.primitive_count
+ * @param {number} [options.optimization]
  */
-export function meshlet_batch_to_bvh({ bvh, meshlets, bounding_box, primitive_count, optimization }: BVH): void;
+export function meshlet_batch_to_bvh({ bvh, meshlets, bounding_box, primitive_count, optimization }: {
+    bvh: BVH;
+    meshlets: MeshletBatch;
+    bounding_box: Float32Array;
+    primitive_count: number;
+    optimization?: number;
+}): void;
 //# sourceMappingURL=meshlet_batch_to_bvh.d.ts.map

package/src/shade/renderer/geometry/meshlet_batch_to_bvh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meshlet_batch_to_bvh.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/meshlet_batch_to_bvh.js"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,gHA0NC"}
+{"version":3,"file":"meshlet_batch_to_bvh.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/meshlet_batch_to_bvh.js"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH;IANwB,GAAG;IACM,QAAQ;IACR,YAAY,EAAlC,YAAY;IACI,eAAe,EAA/B,MAAM;IACW,YAAY,GAA7B,MAAM;SA4NhB"}

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

@@ -10,11 +10,12 @@ import { GEOMETRY_MESHLET_TRIANGLE_LIMIT } from "./meshlet/GEOMETRY_MESHLET_TRIA
 
 /**
  *
- * @param {BVH} bvh
- * @param {MeshletBatch} meshlets
- * @param {Float32Array} bounding_box
- * @param {number} primitive_count
- * @param {number} [optimization]
+ * @param {Object} options
+ * @param {BVH} options.bvh
+ * @param {MeshletBatch} options.meshlets
+ * @param {Float32Array} options.bounding_box
+ * @param {number} options.primitive_count
+ * @param {number} [options.optimization]
  */
 export function meshlet_batch_to_bvh({
                                          bvh,

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.d.ts

@@ -59,5 +59,7 @@ export class GPUGeometrySDFManager {
     download_slot(slot: number): Promise<Float32Array>;
     #private;
 }
+export type ShadeGPUCommandContext = import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext;
+export type GPUGeometryManager = import("../GPUGeometryManager.js").GPUGeometryManager;
 import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
 //# sourceMappingURL=GPUGeometrySDFManager.d.ts.map

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUGeometrySDFManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js"],"names":[],"mappings":"AAmBA;IAoKI;;;OAGG;IACH,+BAqBC;IAhLD;;;OAGG;IACH,iCAEC;IAQD;;;OAGG;IACH,8BAEC;IAQD,0CAEC;IAED;;;OAGG;IACH,+BAFY,MAAM,CAMjB;IAED;;;OAGG;IACH,sBAFY,MAAM,CA6BjB;IAED;;;OAGG;IACH,6BAFW,MAAM,QAoChB;IAED,uBAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,QA4BhB;IA6BD,gBAEC;IAGD;;;;;OAKG;IACH,+DAHW,MAAM,EAAE,wCAwDlB;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACL,MAAM,EAAE,CAgBnB;IAED;;;;;OAKG;IACH,oBAHW,MAAM,GACL,QAAQ,YAAY,CAAC,CAiBhC;;CACJ;kCA5TiC,oCAAoC"}
+{"version":3,"file":"GPUGeometrySDFManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js"],"names":[],"mappings":"AAwBA;IAoKI;;;OAGG;IACH,+BAqBC;IAhLD;;;OAGG;IACH,iCAEC;IAQD;;;OAGG;IACH,8BAEC;IAQD,0CAEC;IAED;;;OAGG;IACH,+BAFY,MAAM,CAMjB;IAED;;;OAGG;IACH,sBAFY,MAAM,CA6BjB;IAED;;;OAGG;IACH,6BAFW,MAAM,QAoChB;IAED,uBAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,QA4BhB;IA6BD,gBAEC;IAGD;;;;;OAKG;IACH,yBAJW,sBAAsB,gBACtB,MAAM,EAAE,cACR,kBAAkB,QAuD5B;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACL,MAAM,EAAE,CAgBnB;IAED;;;;;OAKG;IACH,oBAHW,MAAM,GACL,QAAQ,YAAY,CAAC,CAiBhC;;CACJ;qCA5TY,OAAO,2CAA2C,EAAE,sBAAsB;iCAC1E,OAAO,0BAA0B,EAAE,kBAAkB;kCANhC,oCAAoC"}

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js

@@ -5,6 +5,11 @@ import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
 import { SFD_BUILD_WORKGROUP_SIZE } from "./SFD_BUILD_WORKGROUP_SIZE.js";
 import { shader_build_sdf } from "./shader_build_sdf.js";
 
+/**
+ * @typedef {import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext} ShadeGPUCommandContext
+ * @typedef {import("../GPUGeometryManager.js").GPUGeometryManager} GPUGeometryManager
+ */
+
 
 const INITIAL_CAPACITY = 16;
 

package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.d.ts

@@ -1,12 +1,19 @@
 /**
  *
- * @param {FrameGraph} graph
- * @param {GPUViewContext} view
- * @param {number} input_depth
- * @param {number} input_normals
- * @param {number} input_viz_mesh
+ * @param {Object} options
+ * @param {FrameGraph} options.graph
+ * @param {GPUViewContext} options.view
+ * @param {number} options.input_depth
+ * @param {number} options.input_normals
+ * @param {number} options.input_viz_mesh
  * @param settings
  * @returns {number} texture with shadows
  */
-export function graph_draw_sdf_normals({ graph, view, input_depth, input_normals, input_viz_mesh, }: FrameGraph): number;
+export function graph_draw_sdf_normals({ graph, view, input_depth, input_normals, input_viz_mesh, }: {
+    graph: FrameGraph;
+    view: GPUViewContext;
+    input_depth: number;
+    input_normals: number;
+    input_viz_mesh: number;
+}): number;
 //# sourceMappingURL=shader_sdf_visualize.d.ts.map

package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_sdf_visualize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_sdf_visualize.js"],"names":[],"mappings":"AAmKA;;;;;;;;;GASG;AACH,kHAFa,MAAM,CAsGlB"}
+{"version":3,"file":"shader_sdf_visualize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_sdf_visualize.js"],"names":[],"mappings":"AAmKA;;;;;;;;;;GAUG;AACH;IAR+B,KAAK;IACD,IAAI;IACZ,WAAW,EAA3B,MAAM;IACU,aAAa,EAA7B,MAAM;IACU,cAAc,EAA9B,MAAM;IAEJ,MAAM,CAsGlB"}

package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.js

@@ -163,11 +163,12 @@ const shader_sdf_visualize = new ImageShader({
 
 /**
  *
- * @param {FrameGraph} graph
- * @param {GPUViewContext} view
- * @param {number} input_depth
- * @param {number} input_normals
- * @param {number} input_viz_mesh
+ * @param {Object} options
+ * @param {FrameGraph} options.graph
+ * @param {GPUViewContext} options.view
+ * @param {number} options.input_depth
+ * @param {number} options.input_normals
+ * @param {number} options.input_viz_mesh
  * @param settings
  * @returns {number} texture with shadows
  */

package/src/shade/renderer/geometry/virtual/format/read/VGeoContainerReader.d.ts

@@ -16,6 +16,13 @@
  * more, {@link evict} drops one, and a {@link VGeoPage} owns its own bytes and tables so that
  * dropping it drops everything it cost.
  *
+ * **Selectability is the other half of it, and it is not the same question.** {@link is_selectable}
+ * answers §10's activation invariant — whether a group's *entire ancestor cone* is here, not merely
+ * its own bytes — held as one counter per resident group. A traversal that clamps on residency
+ * instead refines into a group through the parents that arrived while a coarse cluster still stands
+ * in for one that did not, and draws both over the same surface. That is what activation is for, and
+ * it is why installing a page does bookkeeping rather than only filling a map.
+ *
  * **Validation is not on this path.** The mandatory reject rules of §4 and §10 are applied
  * unconditionally by {@link vgeo_read_header} and {@link vgeo_read_page} — a file whose magic,
  * versions, encoding or codec this build does not understand is refused rather than misread. The
@@ -98,6 +105,30 @@ export class VGeoContainerReader {
      * @returns {boolean}
      */
     is_resident(page_index: number): boolean;
+    /**
+     * Whether a group may be selected from — §10's activation invariant, and **not** the same
+     * question as {@link is_resident}.
+     *
+     * A group is selectable iff every one of its `parent_cluster_count` references is live: the
+     * referencing cluster's page is installed and that cluster's own group is selectable. Groups
+     * with no parents at all — exactly the root page's topmost level — are selectable the moment
+     * their page is.
+     *
+     * The distinction is load-bearing and it is invisible until an asset is big enough to put one
+     * group's parents in two pages. Refining into a group whose page merely *arrived* draws it
+     * underneath the coarse cluster still standing in for the parent that did not, and the two
+     * surfaces fight over the same pixels. Residency says the bytes are here; selectability says
+     * nothing above them is missing, which is what "no holes and no double-draw, in any arrival
+     * order" actually rests on.
+     *
+     * Synchronous and total, like {@link page}: the traversal asks it per cluster and acts on a
+     * `false` by clamping.
+     *
+     * @param {number} page_index
+     * @param {number} group index within that page
+     * @returns {boolean}
+     */
+    is_selectable(page_index: number, group: number): boolean;
     /**
      * Fetch and install one page, from the exact range something already resident named.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"VGeoContainerReader.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/format/read/VGeoContainerReader.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAqHI;;;;;;;;OAQG;IACH,8CALW,eAAe,GACb,QAAQ,mBAAmB,CAAC,CAUxC;IA/ED;;;OAGG;IACH,8CAFW,eAAe,EAOzB;IA7DD;;OAEG;IACH,4BAAmB;IAEnB;;;;OAIG;IACH,WAFU,gBAAc,SAAS,CAEX;IAqDtB;;OAEG;IACH,6BAEC;IAED;;OAEG;IACH,+BAEC;IAED;;OAEG;IACH,kCAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;OAEG;IACH,iCAEC;IAED;;;;OAIG;IACH,qBAEC;IAED;;;OAGG;IACH,wBAEC;IAyFD;;;;;;;;OAQG;IACH,iBAHW,MAAM,GACJ,WAAS,SAAS,CAI9B;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;OAUG;IACH,oBALW,MAAM,gBACN,MAAM,cACN,MAAM,GACJ,iBAAiB,CAqB7B;IA+BD;;;;;OAKG;IACH,kCAFa,iBAAiB,CAI7B;IAED;;;;;;;;;;;OAWG;IACH,qBALW,cAAc,UACd,MAAM,GAEJ,QAAQ,UAAU,CAAC,CA8B/B;IAED;;;;;;;;;OASG;IACH,kBAHW,MAAM,GACJ,OAAO,CAcnB;IAED;;;;OAIG;IACH,aAFa,MAAM,CAYlB;IAED;;;;;;;;OAQG;IACH,kBAFa,sBAAsB,CAkBlC;IAED;;;;;;;;;OASG;IACH,uCAHoB,MAAM,QAAE,MAAM,KAAG,IAAI,GAC5B,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;;;;;;;OASG;IACH,YAFa,QAAQ,YAAY,CAAC,CAUjC;;CA6EJ;gCArjB+B,sBAAsB"}
+{"version":3,"file":"VGeoContainerReader.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/format/read/VGeoContainerReader.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH;IAwJI;;;;;;;;OAQG;IACH,8CALW,eAAe,GACb,QAAQ,mBAAmB,CAAC,CAUxC;IA/ED;;;OAGG;IACH,8CAFW,eAAe,EAOzB;IAhGD;;OAEG;IACH,4BAAmB;IAEnB;;;;OAIG;IACH,WAFU,gBAAc,SAAS,CAEX;IAwFtB;;OAEG;IACH,6BAEC;IAED;;OAEG;IACH,+BAEC;IAED;;OAEG;IACH,kCAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;OAEG;IACH,iCAEC;IAED;;;;OAIG;IACH,qBAEC;IAED;;;OAGG;IACH,wBAEC;IAyFD;;;;;;;;OAQG;IACH,iBAHW,MAAM,GACJ,WAAS,SAAS,CAI9B;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,0BAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAUnB;IAoOD;;;;;;;;;;OAUG;IACH,oBALW,MAAM,gBACN,MAAM,cACN,MAAM,GACJ,iBAAiB,CAqB7B;IAmCD;;;;;OAKG;IACH,kCAFa,iBAAiB,CAI7B;IAED;;;;;;;;;;;OAWG;IACH,qBALW,cAAc,UACd,MAAM,GAEJ,QAAQ,UAAU,CAAC,CA8B/B;IAED;;;;;;;;;OASG;IACH,kBAHW,MAAM,GACJ,OAAO,CAoDnB;IAED;;;;OAIG;IACH,aAFa,MAAM,CAYlB;IAED;;;;;;;;OAQG;IACH,kBAFa,sBAAsB,CAkBlC;IAED;;;;;;;;;OASG;IACH,uCAHoB,MAAM,QAAE,MAAM,KAAG,IAAI,GAC5B,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;;;;;;;OASG;IACH,YAFa,QAAQ,YAAY,CAAC,CAUjC;;CA6EJ;gCA54B+B,sBAAsB"}