@asciiz/atoolkit 0.1.0

package/dist/awgpu/sequence.js

@@ -0,0 +1,273 @@
+// ================================================================
+//  Awgpu - Level 5: Command Sequencing (RenderPassNode, ComputePassNode, PassSequence)
+// ================================================================
+import { resolveDevice, resolveQueue } from "./device.js";
+import { resolveBuffer } from "./memory.js";
+function resolveGpuBindGroup(bg) {
+    if (!bg)
+        return null;
+    return "native" in bg ? bg.native : bg;
+}
+function resolveSlotOffsets(offsets, slot) {
+    if (!offsets)
+        return undefined;
+    const item = Array.isArray(offsets)
+        ? offsets[slot]
+        : offsets[slot];
+    if (!item)
+        return undefined;
+    // Skip Array.from copy when item is already a number[].
+    return Array.isArray(item) ? item : Array.from(item);
+}
+/**
+ * Encapsulates a self-contained render pass with redundant driver state filtering.
+ */
+export class RenderPassNode {
+    label;
+    target;
+    draws = [];
+    _customRecorder;
+    _activeBindGroups = new Array(8).fill(null);
+    _activeHasDynamicOffsets = new Array(8).fill(false);
+    _activeVbos = [];
+    _activeVboOffsets = [];
+    _scratchResolved = { buffer: null, offset: 0, size: 0 };
+    constructor(target, label = "RenderPassNode") {
+        this.target = target;
+        this.label = label;
+    }
+    addDraw(batch) {
+        this.draws.push(batch);
+        return this;
+    }
+    /**
+     * Registers custom imperative hardware recording callback, bypassing queued batch list.
+     */
+    record(recorder) {
+        this._customRecorder = recorder;
+        return this;
+    }
+    clear() {
+        this.draws.length = 0;
+        this._customRecorder = undefined;
+    }
+    execute(encoder) {
+        const desc = this.target.getDescriptor();
+        const pass = encoder.beginRenderPass(desc);
+        if (this._customRecorder) {
+            this._customRecorder(pass);
+            pass.end();
+            return;
+        }
+        // Redundant state filtering cache
+        let activePipeline = null;
+        let activeIbo = null;
+        let activeIboFormat = null;
+        let activeIboOffset = -1;
+        const activeBindGroups = this._activeBindGroups;
+        for (let s = 0; s < activeBindGroups.length; s++) {
+            activeBindGroups[s] = null;
+        }
+        const activeHasDynamicOffsets = this._activeHasDynamicOffsets;
+        for (let s = 0; s < activeHasDynamicOffsets.length; s++) {
+            activeHasDynamicOffsets[s] = false;
+        }
+        const activeVbos = this._activeVbos;
+        activeVbos.length = 0;
+        const activeVboOffsets = this._activeVboOffsets;
+        activeVboOffsets.length = 0;
+        const scratch = this._scratchResolved;
+        for (let i = 0; i < this.draws.length; i++) {
+            const batch = this.draws[i];
+            // 1. Pipeline state
+            if (activePipeline !== batch.pipeline.native) {
+                pass.setPipeline(batch.pipeline.native);
+                activePipeline = batch.pipeline.native;
+            }
+            // 2. Bind Tables
+            if (batch.bindTables) {
+                for (let slot = 0; slot < batch.bindTables.length; slot++) {
+                    const bg = resolveGpuBindGroup(batch.bindTables[slot]);
+                    if (bg) {
+                        while (slot >= activeBindGroups.length) {
+                            activeBindGroups.push(null);
+                            activeHasDynamicOffsets.push(false);
+                        }
+                        const offsets = resolveSlotOffsets(batch.dynamicOffsets, slot);
+                        if (offsets !== undefined && offsets.length > 0) {
+                            pass.setBindGroup(slot, bg, offsets);
+                            activeBindGroups[slot] = bg;
+                            activeHasDynamicOffsets[slot] = true;
+                        }
+                        else if (activeBindGroups[slot] !== bg || activeHasDynamicOffsets[slot]) {
+                            pass.setBindGroup(slot, bg);
+                            activeBindGroups[slot] = bg;
+                            activeHasDynamicOffsets[slot] = false;
+                        }
+                    }
+                }
+            }
+            // 3. StreamSet (Vertex & Index Buffers)
+            const streams = batch.streamSet;
+            if (streams) {
+                for (let s = 0; s < streams.streams.length; s++) {
+                    const vStream = streams.streams[s];
+                    resolveBuffer(vStream.source, scratch);
+                    if (activeVbos[vStream.slot] !== scratch.buffer || activeVboOffsets[vStream.slot] !== scratch.offset) {
+                        pass.setVertexBuffer(vStream.slot, scratch.buffer, scratch.offset);
+                        activeVbos[vStream.slot] = scratch.buffer;
+                        activeVboOffsets[vStream.slot] = scratch.offset;
+                    }
+                }
+                if (streams.indexStream) {
+                    const iStream = streams.indexStream;
+                    resolveBuffer(iStream.source, scratch);
+                    if (activeIbo !== scratch.buffer || activeIboFormat !== iStream.format || activeIboOffset !== scratch.offset) {
+                        pass.setIndexBuffer(scratch.buffer, iStream.format, scratch.offset);
+                        activeIbo = scratch.buffer;
+                        activeIboFormat = iStream.format;
+                        activeIboOffset = scratch.offset;
+                    }
+                }
+            }
+            // 4. Issue Draw (Indirect or Direct)
+            if (batch.indirect) {
+                resolveBuffer(batch.indirect.buffer, scratch);
+                const indirectOffset = scratch.offset + (batch.indirect.offset ?? 0);
+                if (streams?.indexStream) {
+                    pass.drawIndexedIndirect(scratch.buffer, indirectOffset);
+                }
+                else {
+                    pass.drawIndirect(scratch.buffer, indirectOffset);
+                }
+            }
+            else if (streams) {
+                if (streams.indexStream) {
+                    const count = batch.indexCount ?? streams.indexStream.count;
+                    if (count > 0) {
+                        const firstIndex = batch.firstIndex ?? streams.indexStream.firstIndex ?? 0;
+                        const baseVertex = batch.baseVertex ?? streams.indexStream.baseVertex ?? 0;
+                        pass.drawIndexed(count, batch.instanceCount ?? streams.instanceCount, firstIndex, baseVertex, batch.firstInstance ?? streams.firstInstance);
+                    }
+                }
+                else {
+                    const count = batch.vertexCount ?? streams.vertexCount;
+                    if (count && count > 0) {
+                        pass.draw(count, batch.instanceCount ?? streams.instanceCount, batch.firstVertex ?? streams.firstVertex, batch.firstInstance ?? streams.firstInstance);
+                    }
+                }
+            }
+            else if (batch.vertexCount && batch.vertexCount > 0) {
+                pass.draw(batch.vertexCount, batch.instanceCount ?? 1, batch.firstVertex ?? 0, batch.firstInstance ?? 0);
+            }
+        }
+        pass.end();
+    }
+}
+/**
+ * Encapsulates a compute pass dispatching compute batches.
+ */
+export class ComputePassNode {
+    label;
+    dispatches = [];
+    _customRecorder;
+    _activeBindGroups = new Array(8).fill(null);
+    _activeHasDynamicOffsets = new Array(8).fill(false);
+    _scratchResolved = { buffer: null, offset: 0, size: 0 };
+    constructor(label = "ComputePassNode") {
+        this.label = label;
+    }
+    addDispatch(batch) {
+        this.dispatches.push(batch);
+        return this;
+    }
+    record(recorder) {
+        this._customRecorder = recorder;
+        return this;
+    }
+    clear() {
+        this.dispatches.length = 0;
+        this._customRecorder = undefined;
+    }
+    execute(encoder) {
+        const pass = encoder.beginComputePass({ label: `${this.label}_ComputePass` });
+        if (this._customRecorder) {
+            this._customRecorder(pass);
+            pass.end();
+            return;
+        }
+        let activePipeline = null;
+        const activeBindGroups = this._activeBindGroups;
+        for (let s = 0; s < activeBindGroups.length; s++) {
+            activeBindGroups[s] = null;
+        }
+        const activeHasDynamicOffsets = this._activeHasDynamicOffsets;
+        for (let s = 0; s < activeHasDynamicOffsets.length; s++) {
+            activeHasDynamicOffsets[s] = false;
+        }
+        const scratch = this._scratchResolved;
+        for (let i = 0; i < this.dispatches.length; i++) {
+            const batch = this.dispatches[i];
+            if (activePipeline !== batch.pipeline.native) {
+                pass.setPipeline(batch.pipeline.native);
+                activePipeline = batch.pipeline.native;
+            }
+            if (batch.bindTables) {
+                for (let slot = 0; slot < batch.bindTables.length; slot++) {
+                    const bg = resolveGpuBindGroup(batch.bindTables[slot]);
+                    if (bg) {
+                        while (slot >= activeBindGroups.length) {
+                            activeBindGroups.push(null);
+                            activeHasDynamicOffsets.push(false);
+                        }
+                        const offsets = resolveSlotOffsets(batch.dynamicOffsets, slot);
+                        if (offsets !== undefined && offsets.length > 0) {
+                            pass.setBindGroup(slot, bg, offsets);
+                            activeBindGroups[slot] = bg;
+                            activeHasDynamicOffsets[slot] = true;
+                        }
+                        else if (activeBindGroups[slot] !== bg || activeHasDynamicOffsets[slot]) {
+                            pass.setBindGroup(slot, bg);
+                            activeBindGroups[slot] = bg;
+                            activeHasDynamicOffsets[slot] = false;
+                        }
+                    }
+                }
+            }
+            if (batch.indirect) {
+                resolveBuffer(batch.indirect.buffer, scratch);
+                const indirectOffset = scratch.offset + (batch.indirect.offset ?? 0);
+                pass.dispatchWorkgroupsIndirect(scratch.buffer, indirectOffset);
+            }
+            else if (batch.workgroups) {
+                pass.dispatchWorkgroups(batch.workgroups[0], batch.workgroups[1], batch.workgroups[2]);
+            }
+        }
+        pass.end();
+    }
+}
+/**
+ * Linear pass execution orchestrator.
+ * Records passes into a single GPUCommandEncoder and submits to queue in one command buffer.
+ */
+export class PassSequence {
+    passes = [];
+    add(pass) {
+        this.passes.push(pass);
+        return this;
+    }
+    clear() {
+        this.passes.length = 0;
+    }
+    execute(device, label = "PassSequence") {
+        const gpu = resolveDevice(device);
+        const queue = resolveQueue(device);
+        const encoder = gpu.createCommandEncoder({ label: `${label}_Encoder` });
+        for (let i = 0; i < this.passes.length; i++) {
+            this.passes[i].execute(encoder);
+        }
+        const commandBuffer = encoder.finish({ label: `${label}_CommandBuffer` });
+        queue.submit([commandBuffer]);
+    }
+}
+//# sourceMappingURL=sequence.js.map

package/dist/awgpu/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../awgpu/sequence.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,uFAAuF;AACvF,mEAAmE;AAEnE,OAAO,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAoC,MAAM,aAAa,CAAC;AAuC9E,SAAS,mBAAmB,CAAC,EAA+C;IACxE,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,OAAO,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,kBAAkB,CACvB,OAAwC,EACxC,IAAY;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACf,CAAC,CAAE,OAA4C,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,wDAAwD;IACxD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,cAAc;IACd,KAAK,CAAS;IACvB,MAAM,CAAS;IACN,KAAK,GAAgB,EAAE,CAAC;IAEzB,eAAe,CAAwC;IACvD,iBAAiB,GAA4B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,wBAAwB,GAAc,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,WAAW,GAAyB,EAAE,CAAC;IACvC,iBAAiB,GAAa,EAAE,CAAC;IACjC,gBAAgB,GAAmB,EAAE,MAAM,EAAE,IAA4B,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAExG,YAAY,MAAc,EAAE,KAAK,GAAG,gBAAgB;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,KAAgB;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAA8C;QACjD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,OAA0B;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QAED,kCAAkC;QAClC,IAAI,cAAc,GAA6B,IAAI,CAAC;QACpD,IAAI,SAAS,GAAqB,IAAI,CAAC;QACvC,IAAI,eAAe,GAA0B,IAAI,CAAC;QAClD,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC;QAEzB,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,MAAM,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,CAAC;QAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,uBAAuB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAE5B,oBAAoB;YACpB,IAAI,cAAc,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACxC,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3C,CAAC;YAED,iBAAiB;YACjB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;oBACxD,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;oBACvD,IAAI,EAAE,EAAE,CAAC;wBACL,OAAO,IAAI,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;4BACrC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACxC,CAAC;wBACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;wBAC/D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;4BACrC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;wBACzC,CAAC;6BAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;4BACxE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC5B,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;wBAC1C,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,wCAAwC;YACxC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;YAChC,IAAI,OAAO,EAAE,CAAC;gBACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACnC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBACvC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;wBACnG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;wBACnE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;wBAC1C,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;oBACpD,CAAC;gBACL,CAAC;gBAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;oBACpC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBACvC,IAAI,SAAS,KAAK,OAAO,CAAC,MAAM,IAAI,eAAe,KAAK,OAAO,CAAC,MAAM,IAAI,eAAe,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;wBAC3G,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;wBACpE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;wBAC3B,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;wBACjC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;oBACrC,CAAC;gBACL,CAAC;YACL,CAAC;YAED,qCAAqC;YACrC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjB,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;gBACrE,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;oBACvB,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBAC7D,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBACtD,CAAC;YACL,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACjB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;oBAC5D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;wBACZ,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC;wBAC3E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC;wBAC3E,IAAI,CAAC,WAAW,CACZ,KAAK,EACL,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,EAC5C,UAAU,EACV,UAAU,EACV,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAC/C,CAAC;oBACN,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;oBACvD,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;wBACrB,IAAI,CAAC,IAAI,CACL,KAAK,EACL,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,EAC5C,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,EACxC,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAC/C,CAAC;oBACN,CAAC;gBACL,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,IAAI,CACL,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,aAAa,IAAI,CAAC,EACxB,KAAK,CAAC,WAAW,IAAI,CAAC,EACtB,KAAK,CAAC,aAAa,IAAI,CAAC,CAC3B,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IACf,KAAK,CAAS;IACd,UAAU,GAAmB,EAAE,CAAC;IAEjC,eAAe,CAAyC;IACxD,iBAAiB,GAA4B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,wBAAwB,GAAc,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,gBAAgB,GAAmB,EAAE,MAAM,EAAE,IAA4B,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAExG,YAAY,KAAK,GAAG,iBAAiB;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAmB;QAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,QAA+C;QAClD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,OAA0B;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC,CAAC;QAE9E,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QAED,IAAI,cAAc,GAA8B,IAAI,CAAC;QACrD,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,MAAM,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,CAAC;QAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,uBAAuB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACvC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAEjC,IAAI,cAAc,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACxC,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3C,CAAC;YAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;oBACxD,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;oBACvD,IAAI,EAAE,EAAE,CAAC;wBACL,OAAO,IAAI,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;4BACrC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACxC,CAAC;wBACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;wBAC/D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;4BACrC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;wBACzC,CAAC;6BAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;4BACxE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC5B,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;4BAC5B,uBAAuB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;wBAC1C,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjB,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;gBACrE,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACpE,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC1B,IAAI,CAAC,kBAAkB,CACnB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EACnB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EACnB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CACtB,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IACZ,MAAM,GAAyC,EAAE,CAAC;IAE3D,GAAG,CAAC,IAAsC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,MAA0B,EAAE,KAAK,GAAG,cAAc;QACtD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC,CAAC;QACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,gBAAgB,EAAE,CAAC,CAAC;QAC1E,KAAK,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAClC,CAAC;CACJ"}

package/dist/awgpu/state.d.ts

@@ -0,0 +1,27 @@
+import type { Buffer, Texture } from "./memory.js";
+/**
+ * Double-buffer state container for multi-pass compute iterations and feedback operations.
+ * Provides O(1) handle swapping without GPU memory copying.
+ */
+export declare class SwapBuffer<T extends Buffer | Texture | GPUBuffer | GPUTexture> {
+    private _current;
+    private _next;
+    constructor(initial: T, secondary: T);
+    /**
+     * Active state resource for reading.
+     */
+    get read(): T;
+    /**
+     * Target state resource for writing.
+     */
+    get write(): T;
+    /**
+     * Flips active read and write handles.
+     */
+    swap(): void;
+    /**
+     * Re-assigns internal buffers.
+     */
+    set(initial: T, secondary: T): void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/awgpu/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../awgpu/state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU;IACvE,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,KAAK,CAAI;gBAEL,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;IAKpC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC,CAEZ;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,CAAC,CAEb;IAED;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;CAItC"}

package/dist/awgpu/state.js

@@ -0,0 +1,43 @@
+// ================================================================
+//  Awgpu - Level 2: Composable State (SwapBuffer)
+// ================================================================
+/**
+ * Double-buffer state container for multi-pass compute iterations and feedback operations.
+ * Provides O(1) handle swapping without GPU memory copying.
+ */
+export class SwapBuffer {
+    _current;
+    _next;
+    constructor(initial, secondary) {
+        this._current = initial;
+        this._next = secondary;
+    }
+    /**
+     * Active state resource for reading.
+     */
+    get read() {
+        return this._current;
+    }
+    /**
+     * Target state resource for writing.
+     */
+    get write() {
+        return this._next;
+    }
+    /**
+     * Flips active read and write handles.
+     */
+    swap() {
+        const temp = this._current;
+        this._current = this._next;
+        this._next = temp;
+    }
+    /**
+     * Re-assigns internal buffers.
+     */
+    set(initial, secondary) {
+        this._current = initial;
+        this._next = secondary;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/awgpu/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../awgpu/state.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kDAAkD;AAClD,mEAAmE;AAInE;;;GAGG;AACH,MAAM,OAAO,UAAU;IACX,QAAQ,CAAI;IACZ,KAAK,CAAI;IAEjB,YAAY,OAAU,EAAE,SAAY;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI;QACA,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAU,EAAE,SAAY;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;CACJ"}

package/dist/awgpu/stream.d.ts

@@ -0,0 +1,57 @@
+import type { Buffer, BufferSlice } from "./memory.js";
+export declare const VERTEX_FORMAT_SIZES: Record<string, number>;
+export interface VertexStream {
+    slot: number;
+    shaderLocation?: number;
+    source: GPUBuffer | Buffer | BufferSlice;
+    format: GPUVertexFormat;
+    offset?: number;
+    stepMode?: GPUVertexStepMode;
+}
+export interface IndexStream {
+    source: GPUBuffer | Buffer | BufferSlice;
+    format: GPUIndexFormat;
+    count: number;
+    offset?: number;
+    firstIndex?: number;
+    baseVertex?: number;
+}
+/**
+ * Domain-agnostic compound data stream descriptor.
+ * Groups 1-N VertexStream definitions (slot, shaderLocation, buffer source, format) and an
+ * optional IndexStream. Call deriveVertexLayouts() to produce (GPUVertexBufferLayout | null)[] for
+ * pipeline compilation.
+ */
+export declare class StreamSet {
+    readonly streams: VertexStream[];
+    readonly slotStrides: Map<number, number>;
+    indexStream?: IndexStream;
+    vertexCount?: number;
+    instanceCount: number;
+    firstVertex: number;
+    firstInstance: number;
+    /**
+     * Appends vertex buffer stream to the set.
+     * - slot: GPU buffer binding slot (setVertexBuffer index).
+     * - shaderLocation: WGSL @location attribute index. Defaults to slot for planar layouts.
+     *   Must be set explicitly for interleaved streams sharing the same slot.
+     */
+    addStream(slot: number, source: GPUBuffer | Buffer | BufferSlice, format: GPUVertexFormat, offset?: number, stepMode?: GPUVertexStepMode, shaderLocation?: number): this;
+    /**
+     * Configures explicit byte stride for a specific buffer slot.
+     * Overrides automatic stride calculation from attribute offsets.
+     */
+    setSlotStride(slot: number, stride: number): this;
+    /**
+     * Configures the index buffer stream.
+     */
+    setIndices(source: GPUBuffer | Buffer | BufferSlice, format: GPUIndexFormat, count: number, offset?: number, firstIndex?: number, baseVertex?: number): this;
+    /**
+     * Produces (GPUVertexBufferLayout | null)[] for pipeline compilation.
+     * Groups streams by slot, maps them to exact slot indices, computes cumulative byte
+     * offsets per attribute, and aligns arrayStride to a 4-byte boundary. Unused intermediate
+     * slots are populated with null to preserve slot-to-index alignment required by WebGPU.
+     */
+    deriveVertexLayouts(): (GPUVertexBufferLayout | null)[];
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/awgpu/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../awgpu/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyBtD,CAAC;AAEF,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAClB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAM;IACtC,QAAQ,CAAC,WAAW,sBAA6B;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,SAAK;IAClB,WAAW,SAAK;IAChB,aAAa,SAAK;IAElB;;;;;OAKG;IACH,SAAS,CACL,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,EACxC,MAAM,EAAE,eAAe,EACvB,MAAM,SAAI,EACV,QAAQ,GAAE,iBAA4B,EACtC,cAAc,CAAC,EAAE,MAAM,GACxB,IAAI;IAYP;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjD;;OAEG;IACH,UAAU,CACN,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,EACxC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,SAAI,EACV,UAAU,SAAI,EACd,UAAU,SAAI,GACf,IAAI;IAYP;;;;;OAKG;IACH,mBAAmB,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE;CAqD1D"}

package/dist/awgpu/stream.js

@@ -0,0 +1,139 @@
+// ================================================================
+//  Awgpu - Level 2: Composable Data Streams (StreamSet)
+// ================================================================
+export const VERTEX_FORMAT_SIZES = {
+    float32: 4,
+    float32x2: 8,
+    float32x3: 12,
+    float32x4: 16,
+    uint32: 4,
+    uint32x2: 8,
+    uint32x4: 16,
+    sint32: 4,
+    sint32x2: 8,
+    sint32x4: 16,
+    unorm8x4: 4,
+    snorm8x4: 4,
+    uint8x4: 4,
+    sint8x4: 4,
+    unorm16x2: 4,
+    snorm16x2: 4,
+    uint16x2: 4,
+    sint16x2: 4,
+    unorm16x4: 8,
+    snorm16x4: 8,
+    uint16x4: 8,
+    sint16x4: 8,
+    float16x2: 4,
+    float16x4: 8,
+};
+/**
+ * Domain-agnostic compound data stream descriptor.
+ * Groups 1-N VertexStream definitions (slot, shaderLocation, buffer source, format) and an
+ * optional IndexStream. Call deriveVertexLayouts() to produce (GPUVertexBufferLayout | null)[] for
+ * pipeline compilation.
+ */
+export class StreamSet {
+    streams = [];
+    slotStrides = new Map();
+    indexStream;
+    vertexCount;
+    instanceCount = 1;
+    firstVertex = 0;
+    firstInstance = 0;
+    /**
+     * Appends vertex buffer stream to the set.
+     * - slot: GPU buffer binding slot (setVertexBuffer index).
+     * - shaderLocation: WGSL @location attribute index. Defaults to slot for planar layouts.
+     *   Must be set explicitly for interleaved streams sharing the same slot.
+     */
+    addStream(slot, source, format, offset = 0, stepMode = "vertex", shaderLocation) {
+        this.streams.push({
+            slot,
+            shaderLocation,
+            source,
+            format,
+            offset,
+            stepMode,
+        });
+        return this;
+    }
+    /**
+     * Configures explicit byte stride for a specific buffer slot.
+     * Overrides automatic stride calculation from attribute offsets.
+     */
+    setSlotStride(slot, stride) {
+        this.slotStrides.set(slot, stride);
+        return this;
+    }
+    /**
+     * Configures the index buffer stream.
+     */
+    setIndices(source, format, count, offset = 0, firstIndex = 0, baseVertex = 0) {
+        this.indexStream = {
+            source,
+            format,
+            count,
+            offset,
+            firstIndex,
+            baseVertex,
+        };
+        return this;
+    }
+    /**
+     * Produces (GPUVertexBufferLayout | null)[] for pipeline compilation.
+     * Groups streams by slot, maps them to exact slot indices, computes cumulative byte
+     * offsets per attribute, and aligns arrayStride to a 4-byte boundary. Unused intermediate
+     * slots are populated with null to preserve slot-to-index alignment required by WebGPU.
+     */
+    deriveVertexLayouts() {
+        if (this.streams.length === 0)
+            return [];
+        // Group streams by buffer binding slot
+        const slotMap = new Map();
+        let maxSlot = 0;
+        for (const s of this.streams) {
+            let list = slotMap.get(s.slot);
+            if (!list) {
+                list = [];
+                slotMap.set(s.slot, list);
+            }
+            list.push(s);
+            if (s.slot > maxSlot)
+                maxSlot = s.slot;
+        }
+        const layouts = new Array(maxSlot + 1).fill(null);
+        for (const [slot, streamList] of slotMap.entries()) {
+            let currentOffset = 0;
+            const attributes = [];
+            let stepMode = "vertex";
+            for (let i = 0; i < streamList.length; i++) {
+                const stream = streamList[i];
+                stepMode = stream.stepMode ?? "vertex";
+                const offset = stream.offset ?? currentOffset;
+                // shaderLocation is the WGSL @location index and is independent of slot.
+                // For planar layouts (one attribute per slot), slot == shaderLocation by convention.
+                // For interleaved layouts, each attribute inside the slot gets a unique location.
+                const shaderLocation = stream.shaderLocation ?? (slot + i);
+                attributes.push({
+                    shaderLocation,
+                    format: stream.format,
+                    offset,
+                });
+                const size = VERTEX_FORMAT_SIZES[stream.format] ?? 4;
+                currentOffset = offset + size;
+            }
+            const explicitStride = this.slotStrides.get(slot);
+            const arrayStride = explicitStride !== undefined
+                ? Math.max(4, Math.ceil(explicitStride / 4) * 4)
+                : Math.max(4, Math.ceil(currentOffset / 4) * 4);
+            layouts[slot] = {
+                arrayStride,
+                stepMode,
+                attributes,
+            };
+        }
+        return layouts;
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/awgpu/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../awgpu/stream.ts"],"names":[],"mappings":"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"}