@vgpu/core 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @vgpu/core
+
+> 0.0.1 — early preview
+
+`@vgpu/core` is the runtime foundation for vgpu. It gives you a small wrapper layer around WebGPU devices, queues, buffers, textures, and shader modules, plus an `App.create()` entry point that asks an adapter for a device and returns a compact app instance. In 0.0.1 the goal is portability and a minimal public surface, not a fully opinionated engine.
+
+## Install
+
+```bash
+pnpm add @vgpu/core
+```
+
+## Exports
+
+### Classes
+- `App`
+- `Buffer`
+- `Device`
+- `Queue`
+- `Shader`
+- `Texture`
+- `VGPUError`
+- `ValidationError`
+
+### Functions
+- `createMockGPUDevice`
+
+### Types
+- `AppCreateOptions`
+- `AppInstance`
+- `VGPUAdapter`
+- `BufferOptions`
+- `BufferUsageName`
+- `BufferWriteData`
+- `TextureOptions`
+- `TextureUsageName`
+- `CreateDeviceOptions`
+- `ShaderInput`
+
+## Usage
+
+```ts
+import { App } from "@vgpu/core";
+import { createMockAdapter } from "@vgpu/adapter-mock";
+
+const { device } = await App.create({ adapter: createMockAdapter() });
+const data = new Float32Array([1, 2, 3, 4]);
+const buffer = device.createBuffer({
+  size: data.byteLength,
+  usage: ["copy_dst", "copy_src", "storage"],
+});
+
+buffer.write(data);
+const copy = new Float32Array(await buffer.read(data.byteLength));
+device.destroy();
+```
+
+## License
+
+MIT.

package/dist/app-types.d.ts

@@ -0,0 +1,13 @@
+import type { Device } from "./device.ts";
+import type { CreateDeviceOptions } from "./types.ts";
+export interface AppCreateOptions extends CreateDeviceOptions {
+    readonly adapter: VGPUAdapter;
+}
+export interface AppInstance {
+    readonly device: Device;
+    readonly queue: Device["queue"];
+}
+export interface VGPUAdapter {
+    requestDevice(opts?: CreateDeviceOptions): Promise<Device>;
+}
+//# sourceMappingURL=app-types.d.ts.map

package/dist/app-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-types.d.ts","sourceRoot":"","sources":["../src/app-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D"}

package/dist/app-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-types.js.map

package/dist/app-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-types.js","sourceRoot":"","sources":["../src/app-types.ts"],"names":[],"mappings":""}

package/dist/app.d.ts

@@ -0,0 +1,5 @@
+import type { AppCreateOptions, AppInstance } from "./app-types.ts";
+export declare class App {
+    static create(opts: AppCreateOptions): Promise<AppInstance>;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpE,qBAAa,GAAG;WACD,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAIlE"}

package/dist/app.js

@@ -0,0 +1,7 @@
+export class App {
+    static async create(opts) {
+        const device = await opts.adapter.requestDevice(opts);
+        return { device, queue: device.queue };
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG;IACd,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAsB;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/buffer.d.ts

@@ -0,0 +1,15 @@
+import type { Device } from "./device.ts";
+import type { BufferOptions, BufferWriteData } from "./types.ts";
+export declare class Buffer {
+    private readonly device;
+    readonly gpu: GPUBuffer;
+    readonly options: BufferOptions;
+    private destroyed;
+    constructor(device: Device, gpu: GPUBuffer, options: BufferOptions);
+    write(data: BufferWriteData, offset?: number): void;
+    read(byteLength: number, offset?: number): Promise<ArrayBuffer>;
+    destroy(): void;
+    dispose(): void;
+    private assertAlive;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,MAAM;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,GAAG,EAAE,SAAS;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa;IALjC,OAAO,CAAC,SAAS,CAAS;gBAGP,MAAM,EAAE,MAAM,EACtB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,aAAa;IAGjC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,SAAI,GAAG,IAAI;IAKxC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAKhE,OAAO,IAAI,IAAI;IAMf,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,WAAW;CAGpB"}

package/dist/buffer.js

@@ -0,0 +1,35 @@
+import { isMockGPUBuffer } from "./mock-gpu-storage.js";
+export class Buffer {
+    device;
+    gpu;
+    options;
+    destroyed = false;
+    constructor(device, gpu, options) {
+        this.device = device;
+        this.gpu = gpu;
+        this.options = options;
+    }
+    write(data, offset = 0) {
+        this.assertAlive();
+        this.device.queue.writeBuffer(this.gpu, offset, data);
+    }
+    async read(byteLength, offset = 0) {
+        this.assertAlive();
+        return this.device.readback.read(this.gpu, byteLength, offset);
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        if (!isMockGPUBuffer(this.gpu))
+            this.gpu.destroy();
+    }
+    dispose() {
+        this.destroy();
+    }
+    assertAlive() {
+        if (this.destroyed)
+            throw new Error("Buffer is destroyed");
+    }
+}
+//# sourceMappingURL=buffer.js.map

package/dist/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,MAAM,OAAO,MAAM;IAIE;IACR;IACA;IALH,SAAS,GAAG,KAAK,CAAC;IAE1B,YACmB,MAAc,EACtB,GAAc,EACd,OAAsB;QAFd,WAAM,GAAN,MAAM,CAAQ;QACtB,QAAG,GAAH,GAAG,CAAW;QACd,YAAO,GAAP,OAAO,CAAe;IAC9B,CAAC;IAEJ,KAAK,CAAC,IAAqB,EAAE,MAAM,GAAG,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,MAAM,GAAG,CAAC;QACvC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/device.d.ts

@@ -0,0 +1,26 @@
+import { Buffer } from "./buffer.ts";
+import { Queue } from "./queue.ts";
+import { Shader, type ShaderInput } from "./shader.ts";
+import { Texture } from "./texture.ts";
+import { Readback } from "./readback.ts";
+import { type VGPUError } from "./errors.ts";
+import type { BufferOptions, TextureOptions } from "./types.ts";
+export declare class Device {
+    readonly gpu: GPUDevice;
+    readonly adapterInfo: GPUAdapterInfo | null;
+    readonly queue: Queue;
+    /** @internal — use Buffer.read() and Texture.read() instead */
+    readonly readback: Readback;
+    private readonly scopes;
+    private destroyed;
+    constructor(gpu: GPUDevice, adapterInfo?: GPUAdapterInfo | null);
+    createShader(input: ShaderInput): Shader;
+    createTexture(opts: TextureOptions): Texture;
+    createBuffer(opts: BufferOptions): Buffer;
+    pushErrorScope(filter: GPUErrorFilter): void;
+    popErrorScope(): Promise<VGPUError | null>;
+    destroy(): void;
+    dispose(): void;
+    private captureError;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,EAA0B,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,MAAM;IAOL,QAAQ,CAAC,GAAG,EAAE,SAAS;IAAE,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI;IANhF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,SAAS,CAAS;gBAEL,GAAG,EAAE,SAAS,EAAW,WAAW,GAAE,cAAc,GAAG,IAAW;IAKvF,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAKxC,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAI5C,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAOzC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKtC,aAAa,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAMhD,OAAO,IAAI,IAAI;IAOf,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;CAKrB"}

package/dist/device.js

@@ -0,0 +1,84 @@
+import { compile } from "@vgpu/wgsl";
+import { Buffer } from "./buffer.js";
+import { bufferUsageFlags } from "./gpuConstants.js";
+import { mockBufferDescriptor } from "./mockGpu.js";
+import { Queue } from "./queue.js";
+import { Shader } from "./shader.js";
+import { Texture, toGPUTextureDescriptor } from "./texture.js";
+import { Readback } from "./readback.js";
+import { ValidationError } from "./errors.js";
+export class Device {
+    gpu;
+    adapterInfo;
+    queue;
+    /** @internal — use Buffer.read() and Texture.read() instead */
+    readback;
+    scopes = [];
+    destroyed = false;
+    constructor(gpu, adapterInfo = null) {
+        this.gpu = gpu;
+        this.adapterInfo = adapterInfo;
+        this.queue = new Queue(gpu.queue);
+        this.readback = new Readback(gpu);
+    }
+    createShader(input) {
+        const resolved = typeof input === "string" ? compile(input) : input;
+        return new Shader(this.gpu.createShaderModule({ code: resolved.wgsl }), resolved);
+    }
+    createTexture(opts) {
+        return new Texture(this, this.gpu.createTexture(toGPUTextureDescriptor(opts)), opts);
+    }
+    createBuffer(opts) {
+        const error = validateBufferOptions(opts);
+        if (error)
+            this.captureError(error);
+        const desc = error ? mockBufferDescriptor(Math.max(4, opts.size || 4)) : toGPUBufferDescriptor(opts);
+        return new Buffer(this, this.gpu.createBuffer(desc), opts);
+    }
+    pushErrorScope(filter) {
+        this.scopes.push([]);
+        this.gpu.pushErrorScope?.(filter);
+    }
+    async popErrorScope() {
+        const scope = this.scopes.pop();
+        const nativeError = await this.gpu.popErrorScope?.();
+        return scope?.[0] ?? nativeErrorToVGPUError(nativeError) ?? null;
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.readback.destroy();
+        this.gpu.destroy();
+    }
+    dispose() {
+        this.destroy();
+    }
+    captureError(error) {
+        const scope = this.scopes.at(-1);
+        if (scope)
+            scope.push(error);
+        else
+            throw error;
+    }
+}
+function validateBufferOptions(opts) {
+    if (!Number.isFinite(opts.size) || opts.size <= 0) {
+        return invalidUsage("Buffer size must be greater than zero.");
+    }
+    if (opts.usage.length === 0)
+        return invalidUsage("Buffer usage must not be empty.");
+    return null;
+}
+function invalidUsage(message) {
+    return new ValidationError({ code: "VGPU-CORE-INVALID-USAGE", message, where: "Device.createBuffer" });
+}
+function toGPUBufferDescriptor(opts) {
+    return { label: opts.label, size: opts.size, usage: bufferUsageFlags(opts.usage) };
+}
+function nativeErrorToVGPUError(error) {
+    if (!error)
+        return null;
+    return new ValidationError({ code: "VGPU-CORE-VALIDATION", message: error.message, where: "GPUDevice.popErrorScope", cause: error });
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export type VGPUErrorSeverity = "error" | "warning" | "info";
+export interface VGPUErrorData {
+    readonly code: string;
+    readonly message: string;
+    readonly severity?: VGPUErrorSeverity;
+    readonly fix?: string;
+    readonly where?: string;
+    readonly cause?: unknown;
+}
+export declare class VGPUError extends Error {
+    readonly code: string;
+    readonly severity: VGPUErrorSeverity;
+    readonly fix?: string;
+    readonly where?: string;
+    readonly cause?: unknown;
+    constructor(data: VGPUErrorData);
+}
+export declare class ValidationError extends VGPUError {
+    constructor(data: Omit<VGPUErrorData, "severity">);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,IAAI,EAAE,aAAa;CAShC;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;CAIlD"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+export class VGPUError extends Error {
+    code;
+    severity;
+    fix;
+    where;
+    cause;
+    constructor(data) {
+        super(data.message, { cause: data.cause });
+        this.name = "VGPUError";
+        this.code = data.code;
+        this.severity = data.severity ?? "error";
+        this.fix = data.fix;
+        this.where = data.where;
+        this.cause = data.cause;
+    }
+}
+export class ValidationError extends VGPUError {
+    constructor(data) {
+        super({ ...data, severity: "error" });
+        this.name = "ValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IACb,QAAQ,CAAoB;IAC5B,GAAG,CAAU;IACb,KAAK,CAAU;IACN,KAAK,CAAW;IAElC,YAAY,IAAmB;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,YAAY,IAAqC;QAC/C,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/gpuConstants.d.ts

@@ -0,0 +1,5 @@
+import type { BufferUsageName, TextureUsageName } from "./types.ts";
+export declare function bufferUsageFlags(usages: readonly BufferUsageName[]): GPUBufferUsageFlags;
+export declare function mapReadMode(): GPUMapModeFlags;
+export declare function textureUsageFlags(usages: readonly TextureUsageName[]): GPUTextureUsageFlags;
+//# sourceMappingURL=gpuConstants.d.ts.map

package/dist/gpuConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpuConstants.d.ts","sourceRoot":"","sources":["../src/gpuConstants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAepE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,mBAAmB,CAIxF;AAOD,wBAAgB,WAAW,IAAI,eAAe,CAE7C;AAUD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,oBAAoB,CAI3F"}

package/dist/gpuConstants.js

@@ -0,0 +1,41 @@
+const fallbackUsage = {
+    map_read: 1,
+    map_write: 2,
+    copy_src: 4,
+    copy_dst: 8,
+    index: 16,
+    vertex: 32,
+    uniform: 64,
+    storage: 128,
+    indirect: 256,
+    query_resolve: 512,
+};
+export function bufferUsageFlags(usages) {
+    // WebGPU constants are numeric dictionaries when present; fallback values cover headless/mock runtimes.
+    const constants = globalThis.GPUBufferUsage;
+    return usages.reduce((flags, usage) => flags | usageFlag(usage, constants), 0);
+}
+function usageFlag(usage, constants) {
+    const key = usage.toUpperCase();
+    return constants?.[key] ?? fallbackUsage[usage];
+}
+export function mapReadMode() {
+    return (globalThis.GPUMapMode?.READ ?? 1);
+}
+const fallbackTextureUsage = {
+    copy_src: 1,
+    copy_dst: 2,
+    texture_binding: 4,
+    storage_binding: 8,
+    render_attachment: 16,
+};
+export function textureUsageFlags(usages) {
+    // WebGPU constants are numeric dictionaries when present; fallback values cover headless/mock runtimes.
+    const constants = globalThis.GPUTextureUsage;
+    return usages.reduce((flags, usage) => flags | textureUsageFlag(usage, constants), 0);
+}
+function textureUsageFlag(usage, constants) {
+    const key = usage.toUpperCase();
+    return constants?.[key] ?? fallbackTextureUsage[usage];
+}
+//# sourceMappingURL=gpuConstants.js.map

package/dist/gpuConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpuConstants.js","sourceRoot":"","sources":["../src/gpuConstants.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAoC;IACrD,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,aAAa,EAAE,GAAG;CACnB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAkC;IACjE,wGAAwG;IACxG,MAAM,SAAS,GAAG,UAAU,CAAC,cAA+D,CAAC;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAwB,CAAC;AACxG,CAAC;AAED,SAAS,SAAS,CAAC,KAAsB,EAAE,SAAkC;IAC3E,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,IAAI,CAAC,CAAoB,CAAC;AAC/D,CAAC;AAED,MAAM,oBAAoB,GAAqC;IAC7D,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAmC;IACnE,wGAAwG;IACxG,MAAM,SAAS,GAAG,UAAU,CAAC,eAAgE,CAAC;IAC9F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAyB,CAAC;AAChH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAuB,EAAE,SAAkC;IACnF,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { App } from "./app.ts";
+export { Buffer } from "./buffer.ts";
+export { Device } from "./device.ts";
+export { Queue } from "./queue.ts";
+export { Shader } from "./shader.ts";
+export { Texture } from "./texture.ts";
+export { VGPUError, ValidationError } from "./errors.ts";
+export { createMockGPUDevice } from "./mockGpu.ts";
+export type { AppCreateOptions, AppInstance, VGPUAdapter } from "./app-types.ts";
+export type { BufferOptions, BufferUsageName, BufferWriteData, TextureOptions, TextureUsageName, CreateDeviceOptions, } from "./types.ts";
+export type { ShaderInput } from "./shader.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { App } from "./app.js";
+export { Buffer } from "./buffer.js";
+export { Device } from "./device.js";
+export { Queue } from "./queue.js";
+export { Shader } from "./shader.js";
+export { Texture } from "./texture.js";
+export { VGPUError, ValidationError } from "./errors.js";
+export { createMockGPUDevice } from "./mockGpu.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/mock-gpu-storage.d.ts

@@ -0,0 +1,9 @@
+export interface MockGPUBuffer extends GPUBuffer {
+    readonly __vgpuMockBytes: Uint8Array;
+}
+export interface MockGPUTexture extends GPUTexture {
+    readonly __vgpuMockBytes: Uint8Array;
+}
+export declare function isMockGPUBuffer(buffer: GPUBuffer): buffer is MockGPUBuffer;
+export declare function isMockGPUTexture(texture: GPUTexture): texture is MockGPUTexture;
+//# sourceMappingURL=mock-gpu-storage.d.ts.map

package/dist/mock-gpu-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-gpu-storage.d.ts","sourceRoot":"","sources":["../src/mock-gpu-storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;CACtC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,aAAa,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,cAAc,CAE/E"}

package/dist/mock-gpu-storage.js

@@ -0,0 +1,7 @@
+export function isMockGPUBuffer(buffer) {
+    return "__vgpuMockBytes" in buffer;
+}
+export function isMockGPUTexture(texture) {
+    return "__vgpuMockBytes" in texture;
+}
+//# sourceMappingURL=mock-gpu-storage.js.map

package/dist/mock-gpu-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-gpu-storage.js","sourceRoot":"","sources":["../src/mock-gpu-storage.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,iBAAiB,IAAI,MAAM,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,OAAO,iBAAiB,IAAI,OAAO,CAAC;AACtC,CAAC"}

package/dist/mockGpu.d.ts

@@ -0,0 +1,3 @@
+export declare function createMockGPUDevice(): GPUDevice;
+export declare function mockBufferDescriptor(size: number): GPUBufferDescriptor;
+//# sourceMappingURL=mockGpu.d.ts.map

package/dist/mockGpu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockGpu.d.ts","sourceRoot":"","sources":["../src/mockGpu.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,SAAS,CAgD/C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAEtE"}

package/dist/mockGpu.js

@@ -0,0 +1,82 @@
+import { bufferUsageFlags } from "./gpuConstants.js";
+import { isMockGPUBuffer } from "./mock-gpu-storage.js";
+export function createMockGPUDevice() {
+    return {
+        createBuffer: createMockBuffer,
+        createTexture(desc) {
+            const size = textureSize(desc.size);
+            const bytes = new Uint8Array(size.width * size.height * 4);
+            return {
+                __vgpuMockBytes: bytes,
+                label: desc.label ?? "",
+                width: size.width,
+                height: size.height,
+                depthOrArrayLayers: size.depthOrArrayLayers,
+                mipLevelCount: 1,
+                sampleCount: desc.sampleCount ?? 1,
+                dimension: "2d",
+                format: desc.format,
+                usage: desc.usage,
+                createView: () => ({}),
+                destroy() { },
+                // Mock WebGPU texture: only fields touched by core/render tests are implemented.
+            };
+        },
+        createShaderModule: () => ({}),
+        createBindGroupLayout: () => ({}),
+        createPipelineLayout: () => ({}),
+        createBindGroup: () => ({}),
+        createSampler: () => ({}),
+        createRenderPipeline: () => ({}),
+        createCommandEncoder() {
+            return {
+                copyBufferToBuffer() { },
+                copyTextureToBuffer() { },
+                // Mock render pass encoder: only binding/pipeline/draw/end methods used by tests are implemented.
+                beginRenderPass: () => ({ setBindGroup() { }, setVertexBuffer() { }, setPipeline() { }, draw() { }, end() { } }),
+                finish: () => ({}),
+                // Mock command encoder: only copy/render/finish methods used by core are implemented.
+            };
+        },
+        destroy() { },
+        queue: {
+            submit() { },
+            writeBuffer(buffer, offset, data, dataOffset = 0, size) {
+                if (isMockGPUBuffer(buffer))
+                    buffer.__vgpuMockBytes.set(bytesFrom(data).subarray(dataOffset, size ? dataOffset + size : undefined), offset);
+            },
+            onSubmittedWorkDone: async () => undefined,
+        },
+        // Mock device: shape is intentionally partial but covers every member used by adapters/tests.
+    };
+}
+export function mockBufferDescriptor(size) {
+    return { size, usage: bufferUsageFlags(["copy_src", "copy_dst"]) };
+}
+function createMockBuffer(desc) {
+    const bytes = new Uint8Array(Number(desc.size));
+    return {
+        __vgpuMockBytes: bytes,
+        label: desc.label ?? "",
+        size: desc.size,
+        usage: desc.usage,
+        mapState: "unmapped",
+        destroy() { },
+        getMappedRange: () => bytes.buffer,
+        mapAsync: async () => undefined,
+        unmap() { },
+        // Mock WebGPU buffer: byte storage plus map/destroy methods are enough for read/write tests.
+    };
+}
+function textureSize(size) {
+    if (Array.isArray(size))
+        return { width: size[0], height: size[1] ?? 1, depthOrArrayLayers: size[2] ?? 1 };
+    const dict = size;
+    return { width: dict.width, height: dict.height ?? 1, depthOrArrayLayers: dict.depthOrArrayLayers ?? 1 };
+}
+function bytesFrom(data) {
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+//# sourceMappingURL=mockGpu.js.map

package/dist/mockGpu.js.map

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

package/dist/queue.d.ts

@@ -0,0 +1,8 @@
+import type { BufferWriteData } from "./types.ts";
+export declare class Queue {
+    readonly gpu: GPUQueue;
+    constructor(gpu: GPUQueue);
+    writeBuffer(buffer: GPUBuffer, offset: number, data: BufferWriteData): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,KAAK;IACJ,QAAQ,CAAC,GAAG,EAAE,QAAQ;gBAAb,GAAG,EAAE,QAAQ;IAElC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI;IAIrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/queue.js

@@ -0,0 +1,13 @@
+export class Queue {
+    gpu;
+    constructor(gpu) {
+        this.gpu = gpu;
+    }
+    writeBuffer(buffer, offset, data) {
+        this.gpu.writeBuffer(buffer, offset, data);
+    }
+    async flush() {
+        await this.gpu.onSubmittedWorkDone?.();
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,KAAK;IACK;IAArB,YAAqB,GAAa;QAAb,QAAG,GAAH,GAAG,CAAU;IAAG,CAAC;IAEtC,WAAW,CAAC,MAAiB,EAAE,MAAc,EAAE,IAAqB;QAClE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/readback.d.ts

@@ -0,0 +1,8 @@
+export declare class Readback {
+    private readonly device;
+    constructor(device: GPUDevice);
+    read(source: GPUBuffer, byteLength: number, offset: number): Promise<ArrayBuffer>;
+    readTexture(texture: GPUTexture, size: readonly [number, number, number?], format: GPUTextureFormat): Promise<Uint8Array>;
+    destroy(): void;
+}
+//# sourceMappingURL=readback.d.ts.map

package/dist/readback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readback.d.ts","sourceRoot":"","sources":["../src/readback.ts"],"names":[],"mappings":"AAMA,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAExC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBjF,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsB/H,OAAO,IAAI,IAAI;CAChB"}