@asciiz/atoolkit 0.1.0

package/dist/awgpu_old/buffer.js

@@ -0,0 +1,220 @@
+/**
+ * GPU buffer wrapper supporting uniform, storage, vertex, and index operations.
+ */
+export class Buffer {
+    gpuBuffer;
+    size;
+    usage;
+    label;
+    gpuOwned;
+    constructor(gpuBuffer, size, usage, options = {}) {
+        this.gpuBuffer = gpuBuffer;
+        this.size = size;
+        this.usage = usage;
+        this.label = options.label ?? gpuBuffer.label ?? "Buffer";
+        this.gpuOwned = options.gpuOwned ?? true;
+    }
+    /**
+     * Uploads fresh data to GPU buffer using queue.writeBuffer.
+     */
+    write(device, data, bufferOffset = 0) {
+        const view = data;
+        const byteLength = view.byteLength ?? data.byteLength;
+        const buffer = view.buffer ?? data;
+        const byteOffset = view.byteOffset ?? 0;
+        device.queue.writeBuffer(this.gpuBuffer, bufferOffset, buffer, byteOffset, byteLength);
+    }
+    destroy() {
+        if (this.gpuOwned) {
+            this.gpuBuffer.destroy();
+        }
+    }
+    /**
+     * Creates raw GPU buffer with optional initial data upload.
+     */
+    static create(device, options) {
+        // Enforce 4-byte alignment
+        const alignedSize = Math.max(4, Math.ceil(options.size / 4) * 4);
+        const usage = options.usage | (options.data ? GPUBufferUsage.COPY_DST : 0);
+        const label = options.label ?? "Buffer";
+        const gpuBuffer = device.createBuffer({
+            label,
+            size: alignedSize,
+            usage,
+        });
+        const buf = new Buffer(gpuBuffer, alignedSize, usage, { label });
+        if (options.data) {
+            buf.write(device, options.data);
+        }
+        return buf;
+    }
+    /**
+     * Creates uniform buffer with automatic 16-byte minimum alignment.
+     */
+    static createUniform(device, sizeOrData, label = "UniformBuffer") {
+        const isData = typeof sizeOrData !== "number";
+        const rawSize = isData ? sizeOrData.byteLength ?? sizeOrData.byteLength : sizeOrData;
+        // Minimum uniform size is 16 bytes, aligned to 16
+        const size = Math.max(16, Math.ceil(rawSize / 16) * 16);
+        return Buffer.create(device, {
+            size,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            data: isData ? sizeOrData : undefined,
+            label,
+        });
+    }
+    /**
+     * Creates storage buffer with read-only or read-write usage.
+     */
+    static createStorage(device, sizeOrData, options = {}) {
+        const isData = typeof sizeOrData !== "number";
+        const rawSize = isData ? sizeOrData.byteLength ?? sizeOrData.byteLength : sizeOrData;
+        const size = Math.max(16, Math.ceil(rawSize / 4) * 4);
+        const label = options.label ?? "StorageBuffer";
+        return Buffer.create(device, {
+            size,
+            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+            data: isData ? sizeOrData : undefined,
+            label,
+        });
+    }
+    /**
+     * Creates vertex buffer with uploaded vertex data.
+     */
+    static createVertex(device, dataOrSize, label = "VertexBuffer") {
+        const isData = typeof dataOrSize !== "number";
+        const rawSize = isData ? dataOrSize.byteLength ?? dataOrSize.byteLength : dataOrSize;
+        const size = Math.max(4, Math.ceil(rawSize / 4) * 4);
+        return Buffer.create(device, {
+            size,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+            data: isData ? dataOrSize : undefined,
+            label,
+        });
+    }
+    /**
+     * Creates index buffer with uploaded index data.
+     */
+    static createIndex(device, dataOrSize, label = "IndexBuffer") {
+        const isData = typeof dataOrSize !== "number";
+        const rawSize = isData ? dataOrSize.byteLength ?? dataOrSize.byteLength : dataOrSize;
+        const size = Math.max(4, Math.ceil(rawSize / 4) * 4);
+        return Buffer.create(device, {
+            size,
+            usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+            data: isData ? dataOrSize : undefined,
+            label,
+        });
+    }
+}
+/**
+ * Reusable GPU buffer pool for dynamic per-frame allocation without destruction thrashing.
+ */
+export class BufferPool {
+    _buckets = new Map();
+    _inUse = [];
+    _availableCount = 0;
+    usage;
+    label;
+    constructor(usage, label = "BufferPool") {
+        this.usage = usage;
+        this.label = label;
+    }
+    /** Total number of allocated buffers currently managed by pool. */
+    get totalBuffers() {
+        return this._availableCount + this._inUse.length;
+    }
+    /** Number of buffers currently acquired and active in frame. */
+    get inUseCount() {
+        return this._inUse.length;
+    }
+    _addToBucket(buf) {
+        let bucket = this._buckets.get(buf.size);
+        if (!bucket) {
+            bucket = [];
+            this._buckets.set(buf.size, bucket);
+        }
+        bucket.push(buf);
+        this._availableCount++;
+    }
+    /**
+     * Resets active allocations at start of frame, returning all buffers to available pool.
+     */
+    reset() {
+        const inUse = this._inUse;
+        for (let i = 0; i < inUse.length; i++) {
+            this._addToBucket(inUse[i]);
+        }
+        inUse.length = 0;
+    }
+    /**
+     * Acquires buffer with at least requested byte size using bucketed matching from available pool.
+     */
+    acquire(device, requiredSize) {
+        const alignedSize = Math.max(16, Math.ceil(requiredSize / 16) * 16);
+        // 1. Fast O(1) exact size lookup
+        const exactBucket = this._buckets.get(alignedSize);
+        if (exactBucket && exactBucket.length > 0) {
+            const buf = exactBucket.pop();
+            this._availableCount--;
+            this._inUse.push(buf);
+            return buf;
+        }
+        // 2. Best-fit scan over distinct bucket sizes
+        let bestSize = -1;
+        let bestDiff = Number.POSITIVE_INFINITY;
+        for (const [size, bucket] of this._buckets) {
+            if (bucket.length > 0 && size >= alignedSize) {
+                const diff = size - alignedSize;
+                if (diff < bestDiff) {
+                    bestDiff = diff;
+                    bestSize = size;
+                }
+            }
+        }
+        if (bestSize >= 0) {
+            const bucket = this._buckets.get(bestSize);
+            const buf = bucket.pop();
+            this._availableCount--;
+            this._inUse.push(buf);
+            return buf;
+        }
+        // 3. Allocate new buffer
+        const id = this.totalBuffers;
+        const newBuf = Buffer.create(device, {
+            size: alignedSize,
+            usage: this.usage,
+            label: `${this.label}_${id}`,
+        });
+        this._inUse.push(newBuf);
+        return newBuf;
+    }
+    /**
+     * Releases an individual buffer back to available pool ahead of frame reset.
+     */
+    release(buffer) {
+        const idx = this._inUse.indexOf(buffer);
+        if (idx === -1)
+            return false;
+        const lastIdx = this._inUse.length - 1;
+        this._inUse[idx] = this._inUse[lastIdx];
+        this._inUse.pop();
+        this._addToBucket(buffer);
+        return true;
+    }
+    destroy() {
+        for (const bucket of this._buckets.values()) {
+            for (const b of bucket) {
+                b.destroy();
+            }
+            bucket.length = 0;
+        }
+        this._buckets.clear();
+        this._availableCount = 0;
+        for (const b of this._inUse) {
+            b.destroy();
+        }
+        this._inUse.length = 0;
+    }
+}
+//# sourceMappingURL=buffer.js.map

package/dist/awgpu_old/buffer.js.map

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

package/dist/awgpu_old/device.d.ts

@@ -0,0 +1,69 @@
+import { RenderTarget } from "./target.js";
+export interface DeviceOptions {
+    /** Target canvas element or selector string. If omitted, device initializes in headless mode. */
+    canvas?: string | HTMLCanvasElement | null;
+    /** Preferred texture format for canvas presentation; defaults to navigator.gpu.getPreferredCanvasFormat() */
+    format?: GPUTextureFormat;
+    /** Power preference for adapter selection; defaults to "high-performance" */
+    powerPreference?: GPUPowerPreference;
+    /** Optional required WebGPU features */
+    requiredFeatures?: GPUFeatureName[];
+    /** Optional required WebGPU limits */
+    requiredLimits?: Record<string, GPUSize64>;
+    /** Canvas presentation alpha mode; defaults to "premultiplied" */
+    alphaMode?: GPUCanvasAlphaMode;
+    /** Label for diagnostic and debugging identification */
+    label?: string;
+}
+/**
+ * Hardware WebGPU device wrapper managing adapter negotiation, device lifetime,
+ * command submission queue, and canvas presentation context.
+ */
+export declare class Device {
+    readonly adapter: GPUAdapter;
+    readonly device: GPUDevice;
+    readonly queue: GPUQueue;
+    readonly canvas: HTMLCanvasElement | null;
+    readonly canvasContext: GPUCanvasContext | null;
+    readonly format: GPUTextureFormat;
+    readonly label: string;
+    constructor(adapter: GPUAdapter, device: GPUDevice, format: GPUTextureFormat, options?: {
+        canvas?: HTMLCanvasElement | null;
+        canvasContext?: GPUCanvasContext | null;
+        label?: string;
+    });
+    /**
+     * Initializes WebGPU device connected to HTML canvas for graphics rendering.
+     */
+    static create(options?: DeviceOptions): Promise<Device>;
+    /**
+     * Initializes headless WebGPU device without canvas (for compute passes, tests, or offscreen workers).
+     */
+    static createHeadless(options?: Omit<DeviceOptions, "canvas">): Promise<Device>;
+    /**
+     * Creates screen render target bound to device canvas swapchain.
+     */
+    createScreenTarget(options?: {
+        depthFormat?: GPUTextureFormat;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        label?: string;
+    }): RenderTarget;
+    /**
+     * Creates fresh GPUCommandEncoder on device.
+     */
+    createCommandEncoder(label?: string): GPUCommandEncoder;
+    /**
+     * Submits command buffers or command encoders to device queue.
+     */
+    submit(commands: (GPUCommandBuffer | GPUCommandEncoder)[] | GPUCommandBuffer | GPUCommandEncoder): void;
+    /**
+     * Destroys device resources and unconfigures canvas context.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/awgpu_old/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../awgpu_old/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC1B,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAC3C,6GAA6G;IAC7G,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,kEAAkE;IAClE,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;GAGG;AACH,qBAAa,MAAM;IACf,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGnB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE;QACL,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAClC,aAAa,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC;KACb;IAWV;;OAEG;WACU,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCjE;;OAEG;WACU,cAAc,CAAC,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzF;;OAEG;IACH,kBAAkB,CACd,OAAO,GAAE;QACL,WAAW,CAAC,EAAE,gBAAgB,CAAC;QAC/B,UAAU,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;KACb,GACP,YAAY;IAOf;;OAEG;IACH,oBAAoB,CAAC,KAAK,SAAmB,GAAG,iBAAiB;IAIjE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,gBAAgB,GAAG,iBAAiB,CAAC,EAAE,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,IAAI;IAWvG;;OAEG;IACH,OAAO,IAAI,IAAI;CAUlB"}

package/dist/awgpu_old/device.js

@@ -0,0 +1,121 @@
+import { RenderTarget } from "./target.js";
+function resolveCanvas(canvasRef) {
+    if (!canvasRef)
+        return null;
+    if (typeof HTMLCanvasElement !== "undefined" && canvasRef instanceof HTMLCanvasElement)
+        return canvasRef;
+    if (typeof canvasRef === "string" && typeof document !== "undefined") {
+        const found = document.querySelector(canvasRef);
+        if (typeof HTMLCanvasElement !== "undefined" && found instanceof HTMLCanvasElement)
+            return found;
+    }
+    return null;
+}
+/**
+ * Hardware WebGPU device wrapper managing adapter negotiation, device lifetime,
+ * command submission queue, and canvas presentation context.
+ */
+export class Device {
+    adapter;
+    device;
+    queue;
+    canvas;
+    canvasContext;
+    format;
+    label;
+    constructor(adapter, device, format, options = {}) {
+        this.adapter = adapter;
+        this.device = device;
+        this.queue = device.queue;
+        this.format = format;
+        this.canvas = options.canvas ?? null;
+        this.canvasContext = options.canvasContext ?? null;
+        this.label = options.label ?? "Device";
+    }
+    /**
+     * Initializes WebGPU device connected to HTML canvas for graphics rendering.
+     */
+    static async create(options = {}) {
+        if (typeof navigator === "undefined" || !navigator.gpu) {
+            throw new Error("[Device] WebGPU is not supported or not available in this environment.");
+        }
+        const canvas = resolveCanvas(options.canvas);
+        const powerPreference = options.powerPreference ?? "high-performance";
+        const adapter = await navigator.gpu.requestAdapter({ powerPreference });
+        if (!adapter) {
+            throw new Error("[Device] Failed to acquire WebGPU GPUAdapter.");
+        }
+        const device = await adapter.requestDevice({
+            label: options.label ?? "Device_GPUDevice",
+            requiredFeatures: options.requiredFeatures,
+            requiredLimits: options.requiredLimits,
+        });
+        const format = options.format ?? (canvas ? navigator.gpu.getPreferredCanvasFormat() : "rgba8unorm");
+        let canvasContext = null;
+        if (canvas) {
+            canvasContext = canvas.getContext("webgpu");
+            if (!canvasContext) {
+                throw new Error("[Device] Failed to get WebGPU context from canvas element.");
+            }
+            canvasContext.configure({
+                device,
+                format,
+                alphaMode: options.alphaMode ?? "premultiplied",
+            });
+        }
+        return new Device(adapter, device, format, {
+            canvas,
+            canvasContext,
+            label: options.label ?? "Device",
+        });
+    }
+    /**
+     * Initializes headless WebGPU device without canvas (for compute passes, tests, or offscreen workers).
+     */
+    static async createHeadless(options = {}) {
+        return Device.create({ ...options, canvas: null });
+    }
+    /**
+     * Creates screen render target bound to device canvas swapchain.
+     */
+    createScreenTarget(options = {}) {
+        if (!this.canvas || !this.canvasContext) {
+            throw new Error("[Device.createScreenTarget] Cannot create screen target on headless device.");
+        }
+        return RenderTarget.createScreen(this, options);
+    }
+    /**
+     * Creates fresh GPUCommandEncoder on device.
+     */
+    createCommandEncoder(label = "CommandEncoder") {
+        return this.device.createCommandEncoder({ label });
+    }
+    /**
+     * Submits command buffers or command encoders to device queue.
+     */
+    submit(commands) {
+        const list = Array.isArray(commands) ? commands : [commands];
+        const buffers = list.map((c) => {
+            if ("finish" in c && typeof c.finish === "function") {
+                return c.finish();
+            }
+            return c;
+        });
+        this.queue.submit(buffers);
+    }
+    /**
+     * Destroys device resources and unconfigures canvas context.
+     */
+    destroy() {
+        if (this.canvasContext) {
+            try {
+                this.canvasContext.unconfigure?.();
+            }
+            catch {
+                // Ignore if unconfigure is unsupported in current browser
+            }
+        }
+        this.device.destroy();
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/awgpu_old/device.js.map

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

package/dist/awgpu_old/frame.d.ts

@@ -0,0 +1,17 @@
+import type { Pass, ComputePass } from "./pass.js";
+import type { Device } from "./device.js";
+/**
+ * Top-level multi-pass frame orchestrator.
+ * Sequences render and compute passes and submits recorded GPU commands to hardware queue.
+ */
+export declare class Frame {
+    readonly passes: (Pass | ComputePass)[];
+    addPass(pass: Pass | ComputePass): this;
+    clear(): void;
+    /**
+     * Executes recorded passes in order and submits command buffer to device queue.
+     * Accepts either raw GPUDevice or Device instance.
+     */
+    execute(deviceOrGfx: GPUDevice | Device, label?: string): void;
+}
+//# sourceMappingURL=frame.d.ts.map

package/dist/awgpu_old/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../awgpu_old/frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,qBAAa,KAAK;IACd,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG,WAAW,CAAC,EAAE,CAAM;IAE7C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,IAAI;IAKvC,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,EAAE,KAAK,SAAU,GAAG,IAAI;CAalE"}

package/dist/awgpu_old/frame.js

@@ -0,0 +1,29 @@
+/**
+ * Top-level multi-pass frame orchestrator.
+ * Sequences render and compute passes and submits recorded GPU commands to hardware queue.
+ */
+export class Frame {
+    passes = [];
+    addPass(pass) {
+        this.passes.push(pass);
+        return this;
+    }
+    clear() {
+        this.passes.length = 0;
+    }
+    /**
+     * Executes recorded passes in order and submits command buffer to device queue.
+     * Accepts either raw GPUDevice or Device instance.
+     */
+    execute(deviceOrGfx, label = "Frame") {
+        const device = "device" in deviceOrGfx ? deviceOrGfx.device : deviceOrGfx;
+        const queue = "queue" in deviceOrGfx ? deviceOrGfx.queue : device.queue;
+        const encoder = device.createCommandEncoder({ label: `${label}_CommandEncoder` });
+        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=frame.js.map

package/dist/awgpu_old/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../awgpu_old/frame.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,KAAK;IACL,MAAM,GAA2B,EAAE,CAAC;IAE7C,OAAO,CAAC,IAAwB;QAC5B,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;;;OAGG;IACH,OAAO,CAAC,WAA+B,EAAE,KAAK,GAAG,OAAO;QACpD,MAAM,MAAM,GAAG,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;QAC1E,MAAM,KAAK,GAAG,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAExE,MAAM,OAAO,GAAG,MAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,iBAAiB,EAAE,CAAC,CAAC;QAElF,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_old/index.d.ts

@@ -0,0 +1,8 @@
+export { Device, type DeviceOptions, } from "./device.js";
+export { Texture, Sampler, RenderTarget, type ColorAttachmentConfig, type DepthAttachmentConfig, } from "./target.js";
+export { Buffer, BufferPool, type BufferData, } from "./buffer.js";
+export { BindSlot, BindGroupLayoutBuilder, BindGroup, type BindingEntry, type ResourceBinding, } from "./layout.js";
+export { createVertexLayout, RenderPipeline, ComputePipeline, type VertexAttributeDesc, type RenderPipelineDescriptor, type ShaderMessage, } from "./pipeline.js";
+export { Pass, ComputePass, type DrawCommand, type ComputeCommand, type DynamicOffsets, } from "./pass.js";
+export { Frame, } from "./frame.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/awgpu_old/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../awgpu_old/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,MAAM,EACN,KAAK,aAAa,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,OAAO,EACP,OAAO,EACP,YAAY,EACZ,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,MAAM,EACN,UAAU,EACV,KAAK,UAAU,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,QAAQ,EACR,sBAAsB,EACtB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,eAAe,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACH,IAAI,EACJ,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACH,KAAK,GACR,MAAM,YAAY,CAAC"}

package/dist/awgpu_old/index.js

@@ -0,0 +1,18 @@
+// ================================================================
+//  Awgpu - Domain-Agnostic WebGPU Hardware Execution Engine
+// ================================================================
+// 1. Hardware Device & Canvas Presentation
+export { Device, } from "./device.js";
+// 2. Targets, Textures & Samplers
+export { Texture, Sampler, RenderTarget, } from "./target.js";
+// 3. Buffers & Memory Pools
+export { Buffer, BufferPool, } from "./buffer.js";
+// 4. Layouts & Bind Group Frequency Slots
+export { BindSlot, BindGroupLayoutBuilder, BindGroup, } from "./layout.js";
+// 5. Pipelines & Shader Modules
+export { createVertexLayout, RenderPipeline, ComputePipeline, } from "./pipeline.js";
+// 6. Passes & Command Batches
+export { Pass, ComputePass, } from "./pass.js";
+// 7. Frame Orchestration
+export { Frame, } from "./frame.js";
+//# sourceMappingURL=index.js.map

package/dist/awgpu_old/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../awgpu_old/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,4DAA4D;AAC5D,mEAAmE;AAEnE,2CAA2C;AAC3C,OAAO,EACH,MAAM,GAET,MAAM,aAAa,CAAC;AAErB,kCAAkC;AAClC,OAAO,EACH,OAAO,EACP,OAAO,EACP,YAAY,GAGf,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACH,MAAM,EACN,UAAU,GAEb,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,OAAO,EACH,QAAQ,EACR,sBAAsB,EACtB,SAAS,GAGZ,MAAM,aAAa,CAAC;AAErB,gCAAgC;AAChC,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,eAAe,GAIlB,MAAM,eAAe,CAAC;AAEvB,8BAA8B;AAC9B,OAAO,EACH,IAAI,EACJ,WAAW,GAId,MAAM,WAAW,CAAC;AAEnB,yBAAyB;AACzB,OAAO,EACH,KAAK,GACR,MAAM,YAAY,CAAC"}

package/dist/awgpu_old/layout.d.ts

@@ -0,0 +1,70 @@
+import type { Buffer } from "./buffer.js";
+import type { Texture, Sampler } from "./target.js";
+/**
+ * Standardized 4-tier WebGPU bind group frequency slots.
+ */
+export declare enum BindSlot {
+    Pass = 0,// Updated once per pass (ViewProj, Viewport, Time, Globals)
+    Phase = 1,// Updated once per phase (Environment maps, global phase buffers, phase textures)
+    Material = 2,// Updated per material switch (Material parameters, Color/Normal textures, Standard samplers)
+    Instance = 3
+}
+/**
+ * Fluent builder for creating GPUBindGroupLayout descriptors.
+ */
+export declare class BindGroupLayoutBuilder {
+    private entries;
+    addUniform(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        hasDynamicOffset?: boolean;
+        minBindingSize?: number;
+    }): this;
+    addStorage(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        readOnly?: boolean;
+        hasDynamicOffset?: boolean;
+        minBindingSize?: number;
+    }): this;
+    addTexture(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        sampleType?: GPUTextureSampleType;
+        viewDimension?: GPUTextureViewDimension;
+        multisampled?: boolean;
+    }): this;
+    addStorageTexture(binding: number, format: GPUTextureFormat, visibility?: GPUShaderStageFlags, options?: {
+        access?: GPUStorageTextureAccess;
+        viewDimension?: GPUTextureViewDimension;
+    }): this;
+    addDepthTexture(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        viewDimension?: GPUTextureViewDimension;
+        multisampled?: boolean;
+    }): this;
+    addSampler(binding: number, visibility?: GPUShaderStageFlags, optionsOrType?: GPUSamplerBindingType | {
+        comparison?: boolean;
+    }): this;
+    build(device: GPUDevice, label?: string): GPUBindGroupLayout;
+}
+export type ResourceBinding = GPUBufferBinding | GPUTextureView | GPUSampler | Buffer | Texture | Sampler;
+export interface BindingEntry {
+    binding: number;
+    resource: ResourceBinding;
+}
+/**
+ * GPU bind group wrapper tracking slot index and layout.
+ */
+export declare class BindGroup {
+    readonly gpuBindGroup: GPUBindGroup;
+    readonly layout: GPUBindGroupLayout;
+    readonly slot: number;
+    readonly label: string;
+    constructor(gpuBindGroup: GPUBindGroup, layout: GPUBindGroupLayout, slot?: number, label?: string);
+    /**
+     * Resolves resource wrappers into native GPUBindingResource descriptors.
+     */
+    static resolveResource(res: ResourceBinding): GPUBindingResource;
+    /**
+     * Factory: Creates GPUBindGroup from typed entries.
+     */
+    static create(device: GPUDevice, layout: GPUBindGroupLayout, entries: BindingEntry[], options?: {
+        slot?: number;
+        label?: string;
+    }): BindGroup;
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/awgpu_old/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../awgpu_old/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,oBAAY,QAAQ;IAChB,IAAI,IAAI,CAAQ,4DAA4D;IAC5E,KAAK,IAAI,CAAO,kFAAkF;IAClG,QAAQ,IAAI,CAAI,8FAA8F;IAC9G,QAAQ,IAAI;CACf;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,OAAO,CAAiC;IAEhD,UAAU,CACN,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,mBAAqE,EACjF,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GACtE,IAAI;IAaP,UAAU,CACN,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,mBAAoE,EAChF,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1F,IAAI;IAcP,UAAU,CACN,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,mBAA6C,EACzD,OAAO,GAAE;QACL,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,aAAa,CAAC,EAAE,uBAAuB,CAAC;QACxC,YAAY,CAAC,EAAE,OAAO,CAAC;KACrB,GACP,IAAI;IAaP,iBAAiB,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,EACxB,UAAU,GAAE,mBAA4C,EACxD,OAAO,GAAE;QACL,MAAM,CAAC,EAAE,uBAAuB,CAAC;QACjC,aAAa,CAAC,EAAE,uBAAuB,CAAC;KACtC,GACP,IAAI;IAaP,eAAe,CACX,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,mBAA6C,EACzD,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,uBAAuB,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAClF,IAAI;IAQP,UAAU,CACN,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,mBAA6C,EACzD,aAAa,GAAE,qBAAqB,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAgB,GAC9E,IAAI;IAaP,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAoB,GAAG,kBAAkB;CAM1E;AAED,MAAM,MAAM,eAAe,GACrB,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEd,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGnB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE,MAAsB,EAC5B,KAAK,SAAc;IAQvB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB;IAahE;;OAEG;IACH,MAAM,CAAC,MAAM,CACT,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,SAAS;CAiBf"}