@woosh/meep-engine 3.11.1 → 3.11.3

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.d.ts

@@ -1,5 +1,3 @@
-export const PUSH_CONSTANTS: WebGPUStruct;
 export const shader_read_out_bucket: ComputeShader;
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 //# sourceMappingURL=shader_read_out_bucket.d.ts.map

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_read_out_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js"],"names":[],"mappings":"AAcA,0CAEG;AAoCH,mDAKE;6BAxD2B,mCAAmC;8BAIlC,+BAA+B"}
+{"version":3,"file":"shader_read_out_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js"],"names":[],"mappings":"AAqDA,mDAKE;8BArD4B,+BAA+B"}

package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js

@@ -1,58 +1,59 @@
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import {
-    RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ
-} from "../expand/bucket/RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ.js";
-
-
-const resources = new ShaderResourceSetDescriptor();
-
-export const PUSH_CONSTANTS = WebGPUStruct.from({
-    bucket_id: u32,
-});
-
-resources.createGroup()
-    .addUniform("settings", PUSH_CONSTANTS);
-
-resources.createGroup()
-    .addStorageBuffer("input", RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ)
-    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
-fn main(@builtin(global_invocation_id) global_id : vec3<u32>){
-
-    let input_index = global_id.x;
-    
-    let bucket_header = input.headers[settings.bucket_id];
-    let bucket_size = bucket_header.count;
-    
-    if(input_index == 0){
-        output.count = bucket_size;
-    }
-    
-    if(input_index >= bucket_size){
-        return;
-    }
-    
-    // just copy
-    let mesh_index = input.elements[input_index + bucket_header.offset];
-    
-    output.elements[input_index] = mesh_index;
-}
-    `
-);
-
-export const shader_read_out_bucket = ComputeShader.from({
-    label: 'Read out bucket',
-    resources,
-    body,
-    group_size: [COMPUTE_SHADER_DEFAULT_GROUP_SIZE]
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import {
+    RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ
+} from "../expand/bucket/RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ.js";
+
+
+const resources = new ShaderResourceSetDescriptor();
+
+const PUSH_CONSTANTS = WebGPUStruct.from({
+    bucket_id: u32,
+});
+
+// per-dispatch, four bytes, read-only: immediate data rather than a pooled buffer, a staging copy
+// and a bind group of its own
+resources.setImmediate("settings", PUSH_CONSTANTS);
+
+resources.createGroup()
+    .addStorageBuffer("input", RASTERIZATION_BUCKET_SORT_OUTPUT_STRUCT_READ)
+    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
+fn main(@builtin(global_invocation_id) global_id : vec3<u32>){
+
+    let input_index = global_id.x;
+    
+    let bucket_header = input.headers[settings.bucket_id];
+    let bucket_size = bucket_header.count;
+    
+    if(input_index == 0){
+        output.count = bucket_size;
+    }
+    
+    if(input_index >= bucket_size){
+        return;
+    }
+    
+    // just copy
+    let mesh_index = input.elements[input_index + bucket_header.offset];
+    
+    output.elements[input_index] = mesh_index;
+}
+    `
+);
+
+export const shader_read_out_bucket = ComputeShader.from({
+    label: 'Read out bucket',
+    resources,
+    body,
+    group_size: [COMPUTE_SHADER_DEFAULT_GROUP_SIZE]
 })

package/src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_expand_meshes_to_meshlets.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,gJA2IC"}
+{"version":3,"file":"graph_expand_meshes_to_meshlets.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,gJA+IC"}

package/src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js

@@ -1,12 +1,12 @@
 import { assert } from "../../../../../core/assert.js";
 import { BufferResourceDescriptor } from "../../../../device/graph/BufferResourceDescriptor.js";
-import { graph_prefix_scan_csdldf } from "../../../gpu_primitive/prefix_sum/v1/graph_prefix_scan_csdldf.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { graph_compute_pass } from "../../../shader/graph/compute/graph_compute_pass.js";
 import {
     graph_build_indirect_dispatch_command,
     INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
 } from "../../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import { graph_prefix_scan_csdldf } from "../../../gpu_primitive/prefix_sum/v1/graph_prefix_scan_csdldf.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import { graph_compute_pass } from "../../../shader/graph/compute/graph_compute_pass.js";
 
 import { RasterizationCollectionType } from "../RasterizationCollectionType.js";
 import { shader_increment_count_by_prefix_sum } from "./shader_increment_count_by_prefix_sum.js";
@@ -36,6 +36,8 @@ export function graph_expand_meshes_to_meshlets({
     assert.defined(limits, 'limits');
     assert.defined(scene, 'scene');
 
+    graph.push_scope("expand meshes to meshlets");
+
     const stage_1_command = graph_build_indirect_dispatch_command(graph, input_meshes, COMPUTE_SHADER_DEFAULT_GROUP_SIZE);
 
     const count_meshlets_data = {};
@@ -162,5 +164,7 @@ export function graph_expand_meshes_to_meshlets({
         }
     });
 
+    graph.pop_scope();
+
     return output;
 }

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,sGAFa,MAAM,CA+DlB"}
+{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,sGAFa,MAAM,CA2DlB"}

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js

@@ -1,82 +1,78 @@
-import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import {
-    build_indirect_compute_dispatch_command,
-    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
-} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
-import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
-import { PUSH_CONSTANTS, shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
-
-/**
- * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
- * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
- *
- * @param {FrameGraph} graph
- * @param {number} buckets bucket-sorted meshes resource ID
- * @param {number} bucket_id
- * @param {GPUCollectionLimits} limits
- * @returns {number} resource ID of extracted mesh list
- */
-export function graph_extract_meshes_from_bucket({
-                                                     graph,
-                                                     buckets,
-                                                     bucket_id,
-                                                     limits,
-                                                 }) {
-
-    /**
-     *
-     * @param data
-     * @param {FramePassResources} resources
-     * @param {GraphicsExecutionContext} context
-     */
-    function execute(data, resources, context) {
-        const encoder = context.encoder;
-
-        const buckets = resources.get(data.buckets);
-        const output = resources.get(data.output);
-        const command = resources.get(data.command);
-
-        const bucket_id = data.bucket_id;
-
-        build_indirect_compute_dispatch_command(
-            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
-            encoder,
-            buckets,
-            // the bucketed buffer header consists of pairs of u32 values (count,offset)
-            bucket_id * (u32.size * 2),
-            command,
-            0
-        );
-
-        const settings = encoder.allocateTransientValueBuffer(PUSH_CONSTANTS, {
-            bucket_id,
-        });
-
-        shader_read_out_bucket.dispatchIndirect({
-            encoder,
-            command,
-            bindings: {
-                settings,
-                input: buckets,
-                output,
-            }
-        });
-    }
-
-    const data = {};
-
-    const pass = graph.add("extract meshes from bucket", data, execute);
-
-    data.buckets = pass.read(buckets);
-    data.bucket_id = bucket_id;
-    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
-    data.output = pass.create("output", BufferResourceDescriptor.from(
-        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
-        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
-        0, 16 // clear count
-    ));
-
-    return data.output;
+import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import {
+    build_indirect_compute_dispatch_command,
+    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
+} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
+import { shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
+
+/**
+ * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
+ * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
+ *
+ * @param {FrameGraph} graph
+ * @param {number} buckets bucket-sorted meshes resource ID
+ * @param {number} bucket_id
+ * @param {GPUCollectionLimits} limits
+ * @returns {number} resource ID of extracted mesh list
+ */
+export function graph_extract_meshes_from_bucket({
+                                                     graph,
+                                                     buckets,
+                                                     bucket_id,
+                                                     limits,
+                                                 }) {
+
+    /**
+     *
+     * @param data
+     * @param {FramePassResources} resources
+     * @param {GraphicsExecutionContext} context
+     */
+    function execute(data, resources, context) {
+        const encoder = context.encoder;
+
+        const buckets = resources.get(data.buckets);
+        const output = resources.get(data.output);
+        const command = resources.get(data.command);
+
+        const bucket_id = data.bucket_id;
+
+        build_indirect_compute_dispatch_command(
+            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
+            encoder,
+            buckets,
+            // the bucketed buffer header consists of pairs of u32 values (count,offset)
+            bucket_id * (u32.size * 2),
+            command,
+            0
+        );
+
+        shader_read_out_bucket.dispatchIndirect({
+            encoder,
+            command,
+            bindings: {
+                settings: { bucket_id },
+                input: buckets,
+                output,
+            }
+        });
+    }
+
+    const data = {};
+
+    const pass = graph.add("extract meshes from bucket", data, execute);
+
+    data.buckets = pass.read(buckets);
+    data.bucket_id = bucket_id;
+    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
+    data.output = pass.create("output", BufferResourceDescriptor.from(
+        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
+        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
+        0, 16 // clear count
+    ));
+
+    return data.output;
 }

package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_scene.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_scene.js"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,4EAFa,MAAM,CAwLlB"}
+{"version":3,"file":"graph_rasterize_scene.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_scene.js"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,4EAFa,MAAM,CA4LlB"}

package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.js

@@ -4,10 +4,10 @@ import { ShadeDrawSide } from "../../material/ShadeDrawSide.js";
 import { graph_import_buffer } from "../../shader/graph/graph_import_buffer.js";
 import { graph_import_texture } from "../../shader/graph/graph_import_texture.js";
 import { graph_record_stat } from "../../util/graph_record_stat.js";
+import { graph_mesh_frustum_cull } from "../compute/graph_mesh_frustum_cull.js";
 import { rasterization_material_bucket } from "../expand/bucket/chunk_rasterization_material_bucket.js";
 import { graph_meshes_classify_buckets } from "../expand/bucket/mesh/graph_meshes_classify_buckets.js";
 import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
-import { graph_mesh_frustum_cull } from "../compute/graph_mesh_frustum_cull.js";
 import { graph_rasterize_meshes_alpha_tested } from "../native/graph_rasterize_meshes_alpha_tested.js";
 import { graph_rasterize_partial_opaque } from "./graph_rasterize_partial_opaque.js";
 import { graph_rasterize_remaining_opaque } from "./graph_rasterize_remaining_opaque.js";
@@ -32,6 +32,8 @@ export function graph_rasterize_scene({
 
     assert.defined(limits, 'limits');
 
+    graph.push_scope("rasterize scene");
+
     const view_ctx = job.view_ctx;
     const viewport = job.viewport;
 
@@ -203,5 +205,7 @@ export function graph_rasterize_scene({
         }
     }
 
+    graph.pop_scope();
+
     return gr_render_buckets;
 }

package/src/shade/renderer/shader/ComputeShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComputeShader.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ComputeShader.js"],"names":[],"mappings":"AAMA;IA0EI;;;;;;;OAOG;IACH,sDANW,MAAM,GAIJ,aAAa,CAiCzB;IAtDD;;;OAGG;IACH,wBAFW,gBAAgB,EAW1B;IA5DD;;;OAGG;IACH,0CAEC;IASD;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,mCAEC;IA0DD;;;;;OAKG;IACH,oFAoBC;IAED;;;;;;;;;OASG;IACH,mFA4BC;IAED;;;;;;;OAOG;IACH,4GAyCC;IAED;;;;;;OAMG;IACH,+FAsCC;IAGL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;;CANtC;0CA7RyC,gEAAgE;iCACzE,uBAAuB"}
+{"version":3,"file":"ComputeShader.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ComputeShader.js"],"names":[],"mappings":"AAMA;IA2EI;;;;;;;OAOG;IACH,sDANW,MAAM,GAIJ,aAAa,CAiCzB;IAvDD;;;OAGG;IACH,wBAFW,gBAAgB,EAY1B;IA7DD;;;OAGG;IACH,0CAEC;IASD;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,mCAEC;IA2DD;;;;;OAKG;IACH,oFAuBC;IAED;;;;;;;;;OASG;IACH,mFA4BC;IAED;;;;;;;OAOG;IACH,4GAyCC;IAED;;;;;;OAMG;IACH,+FAsCC;IAGL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;;CANtC;0CAjSyC,gEAAgE;iCACzE,uBAAuB"}

package/src/shade/renderer/shader/ComputeShader.js

@@ -73,7 +73,8 @@ export class ComputeShader {
         this.#pipeline = ComputePipelineDescriptor.simplified({
             label: descriptor.label,
             code: descriptor.compile(),
-            bindings: descriptor.resources.generateBindingsArray()
+            bindings: descriptor.resources.generateBindingsArray(),
+            immediate_size: descriptor.resources.immediateSize
         });
 
     }
@@ -141,9 +142,12 @@ export class ComputeShader {
 
         const gpu_bindings = resources.generateBindings(bindings, encoder);
 
+        const immediate = encoder.writeImmediate(resources, bindings);
+
         return encoder.constructComputePass({
             pipeline: this.#pipeline,
-            bindings: gpu_bindings
+            bindings: gpu_bindings,
+            immediate
         });
     }
 

package/src/shade/renderer/shader/ImageShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageShader.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ImageShader.js"],"names":[],"mappings":"AAQA;;GAEG;AACH;IAyGI;;;;;;OAMG;IACH,uEAFa,WAAW,CAavB;IAlFD;;;;;OAKG;IACH,sEAuDC;IAhGD;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH,cAFU,MAAM,EAAE,EAAE,CAEF;IAOlB;;;OAGG;IACH,yCAEC;IAED;;;OAGG;IACH,6BAEC;IAsFD;;;;;;;;;OASG;IACH,6HAmEC;;CACJ"}
+{"version":3,"file":"ImageShader.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ImageShader.js"],"names":[],"mappings":"AAQA;;GAEG;AACH;IAyGI;;;;;;OAMG;IACH,uEAFa,WAAW,CAavB;IAlFD;;;;;OAKG;IACH,sEAuDC;IAhGD;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH,cAFU,MAAM,EAAE,EAAE,CAEF;IAOlB;;;OAGG;IACH,yCAEC;IAED;;;OAGG;IACH,6BAEC;IAsFD;;;;;;;;;OASG;IACH,6HAsEC;;CACJ"}

package/src/shade/renderer/shader/ImageShader.js

@@ -165,6 +165,8 @@ export class ImageShader {
 
         const resolved_bindings = shader_descriptor.resources.generateBindings(bindings, encoder);
 
+        const immediate = encoder.writeImmediate(shader_descriptor.resources, bindings);
+
         encoder.pushDebugGroup(shader_descriptor.label);
 
         let pipeline = this.#pipeline;
@@ -179,7 +181,8 @@ export class ImageShader {
             pipeline,
             bindings: resolved_bindings,
             colorAttachments,
-            depthStencilAttachment
+            depthStencilAttachment,
+            immediate
         });
 
         if (viewport !== undefined) {

package/src/shade/renderer/shader/ShaderDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ShaderDescriptor.js"],"names":[],"mappings":"AAIA;IAiHI;;;;;OAKG;IACH,yCAJW,MAAM,oBAwBhB;IApID;;;OAGG;IACH,oBAEC;IAOD;;;OAGG;IACH,6CAEC;IAaD;;;OAGG;IACH,0CAEC;IAED;;;OAGG;IACH,WAFY,MAAM,CAyBjB;IAED;;;OAGG;IACH,iDAWC;IAED;;;;;OAKG;IACH,0CAHa,OAAO,CAenB;;CA6BJ;4CA9I2C,2CAA2C"}
+{"version":3,"file":"ShaderDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/shader/ShaderDescriptor.js"],"names":[],"mappings":"AAIA;IA2II;;;;;OAKG;IACH,yCAJW,MAAM,oBAwBhB;IA9JD;;;OAGG;IACH,oBAEC;IAOD;;;OAGG;IACH,6CAEC;IAaD;;;OAGG;IACH,0CAEC;IAED;;;OAGG;IACH,WAFY,MAAM,CAiCjB;IAED;;;OAGG;IACH,iDA6BC;IAED;;;;;OAKG;IACH,0CAHa,OAAO,CAenB;;CA6BJ;4CAxK2C,2CAA2C"}

package/src/shade/renderer/shader/ShaderDescriptor.js

@@ -70,6 +70,14 @@ export class ShaderDescriptor {
         for (const extension of extensions) {
             result_parts.unshift(`enable ${extension};`);
         }
+
+        // Language extensions take `requires`, not `enable`, and are not GPUFeatureNames — so they
+        // are not folded into `#features`, which `validate_gpu_features` checks against
+        // `device.features`. Looking `immediate_address_space` up there would never find it.
+        for (const language_extension of compiled.language_extensions) {
+            result_parts.unshift(`requires ${language_extension};`);
+        }
+
         result_parts.push(compiled.text);
 
         this.#features = Object.freeze(extensions);
@@ -92,6 +100,24 @@ export class ShaderDescriptor {
             }
         }
 
+        {
+            // immediate data budget. Not a device floor — a browser without immediates still starts
+            // and still renders; it just cannot run *this* shader. Saying so by name beats the
+            // shader-creation error a device would otherwise raise, which names neither the shader
+            // nor the feature.
+            const required = this.resources.immediateSize;
+
+            if (required > 0) {
+                const limit = device.limits.maxImmediateSize ?? 0;
+
+                if (limit < required) {
+                    throw new Error(
+                        `Shader '${this.label}' needs ${required} bytes of immediate data and this device offers ${limit}. Immediate data is an optional capability — check immediate_data_supported() and pick a shader variant that uses a uniform buffer instead.`
+                    );
+                }
+            }
+        }
+
         this.validate_gpu_features(device);
     }
 

package/src/shade/renderer/shader/chunk/atmosphere/ATMOSPHERE_RADII_DECLARATION.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The two sphere radii the atmosphere is bounded by, as f32.
+ *
+ * `PLANET_RADIUS` and `ATMOSPHERE_HEIGHT` carry no type suffix, so they are AbstractInt.
+ * That converts silently wherever it is used directly in an f32 expression, but binding one
+ * to an un-annotated `let` materialises it to i32 — which then neither mixes with f32 nor
+ * holds the square of a planetary radius, since 6478000^2 is four orders of magnitude past
+ * what an i32 can represent. Anything that needs a radius as a value rather than as a term
+ * takes it from here.
+ *
+ * The squares are what the ray/sphere quadratics actually want, and as module-scope consts
+ * they are folded once rather than recomputed per invocation.
+ *
+ * @type {CodeChunk}
+ */
+export const ATMOSPHERE_RADII_DECLARATION: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=ATMOSPHERE_RADII_DECLARATION.d.ts.map

package/src/shade/renderer/shader/chunk/atmosphere/ATMOSPHERE_RADII_DECLARATION.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ATMOSPHERE_RADII_DECLARATION.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/atmosphere/ATMOSPHERE_RADII_DECLARATION.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,2CAFU,SAAS,CAcjB;0BA/BwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/atmosphere/ATMOSPHERE_RADII_DECLARATION.js

@@ -0,0 +1,32 @@
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { ATMOSPHERE_HEIGHT_DECLARATION } from "./ATMOSPHERE_HEIGHT_DECLARATION.js";
+import { PLANET_RADIUS_DECLARATION } from "./PLANET_RADIUS_DECLARATION.js";
+
+/**
+ * The two sphere radii the atmosphere is bounded by, as f32.
+ *
+ * `PLANET_RADIUS` and `ATMOSPHERE_HEIGHT` carry no type suffix, so they are AbstractInt.
+ * That converts silently wherever it is used directly in an f32 expression, but binding one
+ * to an un-annotated `let` materialises it to i32 — which then neither mixes with f32 nor
+ * holds the square of a planetary radius, since 6478000^2 is four orders of magnitude past
+ * what an i32 can represent. Anything that needs a radius as a value rather than as a term
+ * takes it from here.
+ *
+ * The squares are what the ray/sphere quadratics actually want, and as module-scope consts
+ * they are folded once rather than recomputed per invocation.
+ *
+ * @type {CodeChunk}
+ */
+export const ATMOSPHERE_RADII_DECLARATION = CodeChunk.from(
+    //language=WGSL
+    `
+const ATMOSPHERE_GROUND_RADIUS = f32(PLANET_RADIUS);
+const ATMOSPHERE_TOP_RADIUS = f32(PLANET_RADIUS) + f32(ATMOSPHERE_HEIGHT);
+
+const ATMOSPHERE_GROUND_RADIUS_SQUARED = ATMOSPHERE_GROUND_RADIUS * ATMOSPHERE_GROUND_RADIUS;
+const ATMOSPHERE_TOP_RADIUS_SQUARED = ATMOSPHERE_TOP_RADIUS * ATMOSPHERE_TOP_RADIUS;
+    `, [
+        PLANET_RADIUS_DECLARATION,
+        ATMOSPHERE_HEIGHT_DECLARATION,
+    ]
+);

package/src/shade/renderer/shader/chunk/atmosphere/PLANET_CENTER_DECLARATION.d.ts

@@ -1,3 +1,10 @@
+/**
+ * The dependency is load-bearing rather than tidiness: without it the emitted module's
+ * ordering was whatever else happened to pull PLANET_RADIUS_DECLARATION in first, and a
+ * closure where nothing did put this line above the constant it reads.
+ *
+ * @type {CodeChunk}
+ */
 export const PLANET_CENTER_DECLARATION: CodeChunk;
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 //# sourceMappingURL=PLANET_CENTER_DECLARATION.d.ts.map

package/src/shade/renderer/shader/chunk/atmosphere/PLANET_CENTER_DECLARATION.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PLANET_CENTER_DECLARATION.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/atmosphere/PLANET_CENTER_DECLARATION.js"],"names":[],"mappings":"AAEA,kDAGE;0BALwB,6BAA6B"}
+{"version":3,"file":"PLANET_CENTER_DECLARATION.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/atmosphere/PLANET_CENTER_DECLARATION.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wCAFU,SAAS,CAQjB;0BAhBwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/atmosphere/PLANET_CENTER_DECLARATION.js

@@ -1,6 +1,17 @@
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-
-export const PLANET_CENTER_DECLARATION = CodeChunk.from(
-//language=WGSL
-    `const PLANET_CENTER = vec3(0.0, -PLANET_RADIUS, 0.0);`
-);
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { PLANET_RADIUS_DECLARATION } from "./PLANET_RADIUS_DECLARATION.js";
+
+/**
+ * The dependency is load-bearing rather than tidiness: without it the emitted module's
+ * ordering was whatever else happened to pull PLANET_RADIUS_DECLARATION in first, and a
+ * closure where nothing did put this line above the constant it reads.
+ *
+ * @type {CodeChunk}
+ */
+export const PLANET_CENTER_DECLARATION = CodeChunk.from(
+//language=WGSL
+    `const PLANET_CENTER = vec3(0.0, -PLANET_RADIUS, 0.0);`,
+    [
+        PLANET_RADIUS_DECLARATION
+    ]
+);

package/src/shade/renderer/shader/chunk/atmosphere/chunk_atmosphere_ray_bounds.d.ts

@@ -0,0 +1,21 @@
+/**
+ * How far a ray inside the atmosphere may be marched, and whether it ends on the surface.
+ *
+ * The ground and the atmosphere shell are concentric on the planet and the ray is shared, so
+ * one quadratic setup serves both intersections — only the radius term differs. Calling a
+ * general sphere-intersection routine twice instead recomputes the ray-origin offset and all
+ * three dot products for the second sphere, and re-derives a leading coefficient that is 1
+ * for a unit direction.
+ *
+ * `origin_rel` is relative to the planet centre and assumed to be inside the atmosphere and
+ * at or above the surface, which is what makes the shell's far root the exit point.
+ * `ray_direction` must be normalised.
+ *
+ * `ground_distance` is negative when the ray never meets the surface, which includes looking
+ * up from above it: both roots are behind the origin there.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_atmosphere_ray_bounds: CodeChunk;
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_atmosphere_ray_bounds.d.ts.map

package/src/shade/renderer/shader/chunk/atmosphere/chunk_atmosphere_ray_bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_atmosphere_ray_bounds.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/atmosphere/chunk_atmosphere_ray_bounds.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,0CAFU,SAAS,CAiDjB;0BApEwB,6BAA6B"}