wave-gpu 0.1.1

package/README.md

@@ -0,0 +1,33 @@
+# WAVE TypeScript/JavaScript SDK
+
+Write GPU kernels in TypeScript, run on any GPU.
+
+## Install
+
+```bash
+npm install wave-gpu
+```
+
+## Usage
+
+```typescript
+import { device, kernel, array, zeros } from 'wave-gpu';
+
+const dev = await device();
+const vectorAdd = kernel(`
+    function vector_add(a: f32[], b: f32[], out: f32[], n: u32) {
+        const gid = thread_id();
+        if (gid < n) { out[gid] = a[gid] + b[gid]; }
+    }
+`, 'typescript');
+
+const a = array([1, 2, 3, 4]);
+const b = array([5, 6, 7, 8]);
+const out = zeros(4);
+await vectorAdd.launch(dev, [a, b, out], [4], [1,1,1], [256,1,1]);
+console.log(out.toArray());
+```
+
+## License
+
+Apache 2.0 - see [LICENSE](../../LICENSE)

package/dist/array.d.ts

@@ -0,0 +1,22 @@
+/** Supported element data types. */
+export type DType = "f32" | "u32" | "i32" | "f16" | "f64";
+/** CPU-side array that can be passed to WAVE GPU kernels. */
+export declare class WaveArray {
+    data: number[];
+    dtype: DType;
+    constructor(data: number[], dtype?: DType);
+    /** Return the array contents as a plain JavaScript array. */
+    toArray(): number[];
+    /** Number of elements. */
+    get length(): number;
+    /** Convert array data to a binary Buffer (little-endian f32). */
+    toBuffer(): Buffer;
+    /** Read data from a binary Buffer (little-endian f32). */
+    static fromBuffer(buf: Buffer, count: number, dtype?: DType): WaveArray;
+}
+/** Create a WaveArray from a JavaScript array. */
+export declare function array(data: number[], dtype?: DType): WaveArray;
+/** Create a zero-filled WaveArray. */
+export declare function zeros(n: number, dtype?: DType): WaveArray;
+/** Create a WaveArray filled with ones. */
+export declare function ones(n: number, dtype?: DType): WaveArray;

package/dist/array.js

@@ -0,0 +1,53 @@
+"use strict";
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaveArray = void 0;
+exports.array = array;
+exports.zeros = zeros;
+exports.ones = ones;
+/** CPU-side array that can be passed to WAVE GPU kernels. */
+class WaveArray {
+    constructor(data, dtype = "f32") {
+        this.data = [...data];
+        this.dtype = dtype;
+    }
+    /** Return the array contents as a plain JavaScript array. */
+    toArray() {
+        return [...this.data];
+    }
+    /** Number of elements. */
+    get length() {
+        return this.data.length;
+    }
+    /** Convert array data to a binary Buffer (little-endian f32). */
+    toBuffer() {
+        const buf = Buffer.alloc(this.data.length * 4);
+        for (let i = 0; i < this.data.length; i++) {
+            buf.writeFloatLE(this.data[i], i * 4);
+        }
+        return buf;
+    }
+    /** Read data from a binary Buffer (little-endian f32). */
+    static fromBuffer(buf, count, dtype = "f32") {
+        const data = [];
+        for (let i = 0; i < count; i++) {
+            data.push(buf.readFloatLE(i * 4));
+        }
+        return new WaveArray(data, dtype);
+    }
+}
+exports.WaveArray = WaveArray;
+/** Create a WaveArray from a JavaScript array. */
+function array(data, dtype = "f32") {
+    return new WaveArray(data, dtype);
+}
+/** Create a zero-filled WaveArray. */
+function zeros(n, dtype = "f32") {
+    return new WaveArray(new Array(n).fill(0), dtype);
+}
+/** Create a WaveArray filled with ones. */
+function ones(n, dtype = "f32") {
+    return new WaveArray(new Array(n).fill(1), dtype);
+}
+//# sourceMappingURL=array.js.map

package/dist/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,sCAAsC;;;AAmDtC,sBAEC;AAGD,sBAEC;AAGD,oBAEC;AAxDD,6DAA6D;AAC7D,MAAa,SAAS;IAIpB,YAAY,IAAc,EAAE,QAAe,KAAK;QAC9C,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,6DAA6D;IAC7D,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,iEAAiE;IACjE,QAAQ;QACN,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,UAAU,CACf,GAAW,EACX,KAAa,EACb,QAAe,KAAK;QAEpB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;CACF;AAxCD,8BAwCC;AAED,kDAAkD;AAClD,SAAgB,KAAK,CAAC,IAAc,EAAE,QAAe,KAAK;IACxD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,sCAAsC;AACtC,SAAgB,KAAK,CAAC,CAAS,EAAE,QAAe,KAAK;IACnD,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,2CAA2C;AAC3C,SAAgB,IAAI,CAAC,CAAS,EAAE,QAAe,KAAK;IAClD,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/device.d.ts

@@ -0,0 +1,9 @@
+/** GPU vendor classification. */
+export type GpuVendor = "apple" | "nvidia" | "amd" | "intel" | "emulator";
+/** Detected GPU device information. */
+export interface DeviceInfo {
+    vendor: GpuVendor;
+    name: string;
+}
+/** Detect the best available GPU device. */
+export declare function device(): Promise<DeviceInfo>;

package/dist/device.js

@@ -0,0 +1,51 @@
+"use strict";
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.device = device;
+/// GPU detection for the WAVE JavaScript/TypeScript SDK.
+const child_process_1 = require("child_process");
+const os_1 = require("os");
+/** Detect the best available GPU device. */
+async function device() {
+    if ((0, os_1.platform)() === "darwin") {
+        return { vendor: "apple", name: "Apple GPU (Metal)" };
+    }
+    try {
+        const out = (0, child_process_1.execSync)("nvidia-smi --query-gpu=name --format=csv,noheader", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const name = out.trim().split("\n")[0];
+        return { vendor: "nvidia", name: `${name} (CUDA)` };
+    }
+    catch {
+        // nvidia-smi not available
+    }
+    try {
+        const out = (0, child_process_1.execSync)("rocminfo", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (out.includes("gfx")) {
+            return { vendor: "amd", name: "AMD GPU (ROCm)" };
+        }
+    }
+    catch {
+        // rocminfo not available
+    }
+    try {
+        const out = (0, child_process_1.execSync)("sycl-ls", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (out.includes("level_zero:gpu") || out.includes("opencl:gpu")) {
+            return { vendor: "intel", name: "Intel GPU (SYCL)" };
+        }
+    }
+    catch {
+        // sycl-ls not available
+    }
+    return { vendor: "emulator", name: "WAVE Emulator (no GPU)" };
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,sCAAsC;;AAiBtC,wBAyCC;AAxDD,yDAAyD;AAEzD,iDAAyC;AACzC,2BAA8B;AAW9B,4CAA4C;AACrC,KAAK,UAAU,MAAM;IAC1B,IAAI,IAAA,aAAQ,GAAE,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,wBAAQ,EAAC,mDAAmD,EAAE;YACxE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,wBAAQ,EAAC,UAAU,EAAE;YAC/B,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,wBAAQ,EAAC,SAAS,EAAE;YAC9B,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { device, DeviceInfo, GpuVendor } from "./device";
+export { WaveArray, array, zeros, ones, DType } from "./array";
+export { kernel, CompiledKernel, Language } from "./kernel";

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompiledKernel = exports.kernel = exports.ones = exports.zeros = exports.array = exports.WaveArray = exports.device = void 0;
+/// WAVE GPU SDK for JavaScript/TypeScript.
+///
+/// Write GPU kernels in TypeScript, run on any GPU. Supports Apple Metal,
+/// NVIDIA CUDA, AMD ROCm, Intel SYCL, and a built-in emulator.
+var device_1 = require("./device");
+Object.defineProperty(exports, "device", { enumerable: true, get: function () { return device_1.device; } });
+var array_1 = require("./array");
+Object.defineProperty(exports, "WaveArray", { enumerable: true, get: function () { return array_1.WaveArray; } });
+Object.defineProperty(exports, "array", { enumerable: true, get: function () { return array_1.array; } });
+Object.defineProperty(exports, "zeros", { enumerable: true, get: function () { return array_1.zeros; } });
+Object.defineProperty(exports, "ones", { enumerable: true, get: function () { return array_1.ones; } });
+var kernel_1 = require("./kernel");
+Object.defineProperty(exports, "kernel", { enumerable: true, get: function () { return kernel_1.kernel; } });
+Object.defineProperty(exports, "CompiledKernel", { enumerable: true, get: function () { return kernel_1.CompiledKernel; } });
+//# 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,+BAA+B;AAC/B,sCAAsC;;;AAEtC,2CAA2C;AAC3C,GAAG;AACH,0EAA0E;AAC1E,+DAA+D;AAE/D,mCAAyD;AAAhD,gGAAA,MAAM,OAAA;AACf,iCAA+D;AAAtD,kGAAA,SAAS,OAAA;AAAE,8FAAA,KAAK,OAAA;AAAE,8FAAA,KAAK,OAAA;AAAE,6FAAA,IAAI,OAAA;AACtC,mCAA4D;AAAnD,gGAAA,MAAM,OAAA;AAAE,wGAAA,cAAc,OAAA"}

package/dist/kernel.d.ts

@@ -0,0 +1,16 @@
+import { DeviceInfo } from "./device";
+import { WaveArray } from "./array";
+/** Supported source languages. */
+export type Language = "python" | "rust" | "cpp" | "typescript";
+/** A compiled WAVE kernel ready for launch. */
+export declare class CompiledKernel {
+    private source;
+    private language;
+    private wbin;
+    constructor(source: string, language?: Language);
+    private ensureCompiled;
+    /** Launch the kernel on the given device. */
+    launch(dev: DeviceInfo, buffers: WaveArray[], scalars: number[], grid?: [number, number, number], workgroup?: [number, number, number]): Promise<void>;
+}
+/** Create a compiled kernel from source code. */
+export declare function kernel(source: string, language?: Language): CompiledKernel;

package/dist/kernel.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompiledKernel = void 0;
+exports.kernel = kernel;
+const runtime_1 = require("./runtime");
+/** A compiled WAVE kernel ready for launch. */
+class CompiledKernel {
+    constructor(source, language = "typescript") {
+        this.wbin = null;
+        this.source = source;
+        this.language = language;
+    }
+    async ensureCompiled() {
+        if (this.wbin === null) {
+            this.wbin = await (0, runtime_1.compileKernel)(this.source, this.language);
+        }
+        return this.wbin;
+    }
+    /** Launch the kernel on the given device. */
+    async launch(dev, buffers, scalars, grid = [1, 1, 1], workgroup = [256, 1, 1]) {
+        const wbin = await this.ensureCompiled();
+        if (dev.vendor === "emulator") {
+            await (0, runtime_1.launchEmulator)(wbin, buffers, scalars, grid, workgroup);
+        }
+        else {
+            throw new Error(`Direct ${dev.vendor} launch not yet implemented in JS SDK. ` +
+                "Use the emulator or the Rust SDK.");
+        }
+    }
+}
+exports.CompiledKernel = CompiledKernel;
+/** Create a compiled kernel from source code. */
+function kernel(source, language = "typescript") {
+    return new CompiledKernel(source, language);
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":";AAAA,+BAA+B;AAC/B,sCAAsC;;;AAmDtC,wBAKC;AAlDD,uCAA0D;AAK1D,+CAA+C;AAC/C,MAAa,cAAc;IAKzB,YAAY,MAAc,EAAE,WAAqB,YAAY;QAFrD,SAAI,GAAkB,IAAI,CAAC;QAGjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,MAAM,IAAA,uBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,MAAM,CACV,GAAe,EACf,OAAoB,EACpB,OAAiB,EACjB,OAAiC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1C,YAAsC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAEzC,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAA,wBAAc,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,UAAU,GAAG,CAAC,MAAM,yCAAyC;gBAC3D,mCAAmC,CACtC,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApCD,wCAoCC;AAED,iDAAiD;AACjD,SAAgB,MAAM,CACpB,MAAc,EACd,WAAqB,YAAY;IAEjC,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,5 @@
+import { WaveArray } from "./array";
+/** Compile kernel source to WAVE binary (.wbin) bytes. */
+export declare function compileKernel(source: string, language: string): Promise<Buffer>;
+/** Launch a kernel on the WAVE emulator via subprocess. */
+export declare function launchEmulator(wbin: Buffer, buffers: WaveArray[], scalars: number[], grid: [number, number, number], workgroup: [number, number, number]): Promise<void>;

package/dist/runtime.js

@@ -0,0 +1,115 @@
+"use strict";
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileKernel = compileKernel;
+exports.launchEmulator = launchEmulator;
+/// Full pipeline orchestration for the WAVE JavaScript/TypeScript SDK.
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const EXT_MAP = {
+    python: ".py",
+    rust: ".rs",
+    cpp: ".cpp",
+    typescript: ".ts",
+};
+/** Find a WAVE tool binary, checking target/ directories first, then PATH. */
+function findTool(name) {
+    const repoRoot = (0, path_1.resolve)(__dirname, "..", "..", "..", "..");
+    const candidates = [
+        (0, path_1.join)(repoRoot, "target", "release", name),
+        (0, path_1.join)(repoRoot, "target", "debug", name),
+    ];
+    for (const path of candidates) {
+        if ((0, fs_1.existsSync)(path)) {
+            return path;
+        }
+    }
+    return name;
+}
+/** Compile kernel source to WAVE binary (.wbin) bytes. */
+async function compileKernel(source, language) {
+    const compiler = findTool("wave-compiler");
+    const ext = EXT_MAP[language] || ".py";
+    const dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), "wave-"));
+    const srcPath = (0, path_1.join)(dir, `kernel${ext}`);
+    const wbinPath = (0, path_1.join)(dir, "kernel.wbin");
+    (0, fs_1.writeFileSync)(srcPath, source);
+    try {
+        (0, child_process_1.execSync)(`${compiler} ${srcPath} -o ${wbinPath} -l ${language}`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`Compilation failed: ${msg}`);
+    }
+    const wbin = (0, fs_1.readFileSync)(wbinPath);
+    try {
+        (0, fs_1.unlinkSync)(srcPath);
+        (0, fs_1.unlinkSync)(wbinPath);
+    }
+    catch {
+        // cleanup best-effort
+    }
+    return wbin;
+}
+/** Launch a kernel on the WAVE emulator via subprocess. */
+async function launchEmulator(wbin, buffers, scalars, grid, workgroup) {
+    const emulator = findTool("wave-emu");
+    const dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), "wave-emu-"));
+    const wbinPath = (0, path_1.join)(dir, "kernel.wbin");
+    const memPath = (0, path_1.join)(dir, "memory.bin");
+    (0, fs_1.writeFileSync)(wbinPath, wbin);
+    const offsets = [];
+    const memParts = [];
+    let offset = 0;
+    for (const buf of buffers) {
+        offsets.push(offset);
+        const binBuf = buf.toBuffer();
+        memParts.push(binBuf);
+        offset += binBuf.length;
+    }
+    (0, fs_1.writeFileSync)(memPath, Buffer.concat(memParts));
+    let cmd = `${emulator} ${wbinPath}`;
+    cmd += ` --memory-file ${memPath}`;
+    cmd += ` --grid ${grid[0]},${grid[1]},${grid[2]}`;
+    cmd += ` --workgroup ${workgroup[0]},${workgroup[1]},${workgroup[2]}`;
+    for (let i = 0; i < offsets.length; i++) {
+        cmd += ` --reg ${i}=${offsets[i]}`;
+    }
+    for (let i = 0; i < scalars.length; i++) {
+        cmd += ` --reg ${buffers.length + i}=${scalars[i]}`;
+    }
+    try {
+        (0, child_process_1.execSync)(cmd, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`Emulator execution failed: ${msg}`);
+    }
+    const resultMem = (0, fs_1.readFileSync)(memPath);
+    let readOffset = 0;
+    for (const buf of buffers) {
+        const size = buf.length * 4;
+        const chunk = resultMem.subarray(readOffset, readOffset + size);
+        for (let i = 0; i < buf.length; i++) {
+            buf.data[i] = chunk.readFloatLE(i * 4);
+        }
+        readOffset += size;
+    }
+    try {
+        (0, fs_1.unlinkSync)(wbinPath);
+        (0, fs_1.unlinkSync)(memPath);
+    }
+    catch {
+        // cleanup best-effort
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "wave-gpu",
+  "version": "0.1.1",
+  "description": "Write GPU kernels in TypeScript, run on any GPU",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "Apache-2.0",
+  "author": "Ojima Abraham",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Oabraham1/wave"
+  },
+  "homepage": "https://wave.ojima.me",
+  "keywords": ["gpu", "cuda", "metal", "hip", "sycl", "compute", "kernel"],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules tests/test_vector_add.js"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/array.ts

@@ -0,0 +1,65 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// Array types for the WAVE JavaScript/TypeScript SDK.
+
+/** Supported element data types. */
+export type DType = "f32" | "u32" | "i32" | "f16" | "f64";
+
+/** CPU-side array that can be passed to WAVE GPU kernels. */
+export class WaveArray {
+  data: number[];
+  dtype: DType;
+
+  constructor(data: number[], dtype: DType = "f32") {
+    this.data = [...data];
+    this.dtype = dtype;
+  }
+
+  /** Return the array contents as a plain JavaScript array. */
+  toArray(): number[] {
+    return [...this.data];
+  }
+
+  /** Number of elements. */
+  get length(): number {
+    return this.data.length;
+  }
+
+  /** Convert array data to a binary Buffer (little-endian f32). */
+  toBuffer(): Buffer {
+    const buf = Buffer.alloc(this.data.length * 4);
+    for (let i = 0; i < this.data.length; i++) {
+      buf.writeFloatLE(this.data[i], i * 4);
+    }
+    return buf;
+  }
+
+  /** Read data from a binary Buffer (little-endian f32). */
+  static fromBuffer(
+    buf: Buffer,
+    count: number,
+    dtype: DType = "f32",
+  ): WaveArray {
+    const data: number[] = [];
+    for (let i = 0; i < count; i++) {
+      data.push(buf.readFloatLE(i * 4));
+    }
+    return new WaveArray(data, dtype);
+  }
+}
+
+/** Create a WaveArray from a JavaScript array. */
+export function array(data: number[], dtype: DType = "f32"): WaveArray {
+  return new WaveArray(data, dtype);
+}
+
+/** Create a zero-filled WaveArray. */
+export function zeros(n: number, dtype: DType = "f32"): WaveArray {
+  return new WaveArray(new Array(n).fill(0), dtype);
+}
+
+/** Create a WaveArray filled with ones. */
+export function ones(n: number, dtype: DType = "f32"): WaveArray {
+  return new WaveArray(new Array(n).fill(1), dtype);
+}

package/src/device.ts

@@ -0,0 +1,60 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// GPU detection for the WAVE JavaScript/TypeScript SDK.
+
+import { execSync } from "child_process";
+import { platform } from "os";
+
+/** GPU vendor classification. */
+export type GpuVendor = "apple" | "nvidia" | "amd" | "intel" | "emulator";
+
+/** Detected GPU device information. */
+export interface DeviceInfo {
+  vendor: GpuVendor;
+  name: string;
+}
+
+/** Detect the best available GPU device. */
+export async function device(): Promise<DeviceInfo> {
+  if (platform() === "darwin") {
+    return { vendor: "apple", name: "Apple GPU (Metal)" };
+  }
+
+  try {
+    const out = execSync("nvidia-smi --query-gpu=name --format=csv,noheader", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    const name = out.trim().split("\n")[0];
+    return { vendor: "nvidia", name: `${name} (CUDA)` };
+  } catch {
+    // nvidia-smi not available
+  }
+
+  try {
+    const out = execSync("rocminfo", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    if (out.includes("gfx")) {
+      return { vendor: "amd", name: "AMD GPU (ROCm)" };
+    }
+  } catch {
+    // rocminfo not available
+  }
+
+  try {
+    const out = execSync("sycl-ls", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    if (out.includes("level_zero:gpu") || out.includes("opencl:gpu")) {
+      return { vendor: "intel", name: "Intel GPU (SYCL)" };
+    }
+  } catch {
+    // sycl-ls not available
+  }
+
+  return { vendor: "emulator", name: "WAVE Emulator (no GPU)" };
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// WAVE GPU SDK for JavaScript/TypeScript.
+///
+/// Write GPU kernels in TypeScript, run on any GPU. Supports Apple Metal,
+/// NVIDIA CUDA, AMD ROCm, Intel SYCL, and a built-in emulator.
+
+export { device, DeviceInfo, GpuVendor } from "./device";
+export { WaveArray, array, zeros, ones, DType } from "./array";
+export { kernel, CompiledKernel, Language } from "./kernel";

package/src/kernel.ts

@@ -0,0 +1,58 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// Kernel compilation and launch for the WAVE JavaScript/TypeScript SDK.
+
+import { DeviceInfo } from "./device";
+import { WaveArray } from "./array";
+import { compileKernel, launchEmulator } from "./runtime";
+
+/** Supported source languages. */
+export type Language = "python" | "rust" | "cpp" | "typescript";
+
+/** A compiled WAVE kernel ready for launch. */
+export class CompiledKernel {
+  private source: string;
+  private language: Language;
+  private wbin: Buffer | null = null;
+
+  constructor(source: string, language: Language = "typescript") {
+    this.source = source;
+    this.language = language;
+  }
+
+  private async ensureCompiled(): Promise<Buffer> {
+    if (this.wbin === null) {
+      this.wbin = await compileKernel(this.source, this.language);
+    }
+    return this.wbin;
+  }
+
+  /** Launch the kernel on the given device. */
+  async launch(
+    dev: DeviceInfo,
+    buffers: WaveArray[],
+    scalars: number[],
+    grid: [number, number, number] = [1, 1, 1],
+    workgroup: [number, number, number] = [256, 1, 1],
+  ): Promise<void> {
+    const wbin = await this.ensureCompiled();
+
+    if (dev.vendor === "emulator") {
+      await launchEmulator(wbin, buffers, scalars, grid, workgroup);
+    } else {
+      throw new Error(
+        `Direct ${dev.vendor} launch not yet implemented in JS SDK. ` +
+          "Use the emulator or the Rust SDK.",
+      );
+    }
+  }
+}
+
+/** Create a compiled kernel from source code. */
+export function kernel(
+  source: string,
+  language: Language = "typescript",
+): CompiledKernel {
+  return new CompiledKernel(source, language);
+}

package/src/runtime.ts

@@ -0,0 +1,146 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// Full pipeline orchestration for the WAVE JavaScript/TypeScript SDK.
+
+import { execSync } from "child_process";
+import {
+  existsSync,
+  mkdtempSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from "fs";
+import { tmpdir } from "os";
+import { join, resolve } from "path";
+import { WaveArray } from "./array";
+
+const EXT_MAP: Record<string, string> = {
+  python: ".py",
+  rust: ".rs",
+  cpp: ".cpp",
+  typescript: ".ts",
+};
+
+/** Find a WAVE tool binary, checking target/ directories first, then PATH. */
+function findTool(name: string): string {
+  const repoRoot = resolve(__dirname, "..", "..", "..", "..");
+  const candidates = [
+    join(repoRoot, "target", "release", name),
+    join(repoRoot, "target", "debug", name),
+  ];
+
+  for (const path of candidates) {
+    if (existsSync(path)) {
+      return path;
+    }
+  }
+
+  return name;
+}
+
+/** Compile kernel source to WAVE binary (.wbin) bytes. */
+export async function compileKernel(
+  source: string,
+  language: string,
+): Promise<Buffer> {
+  const compiler = findTool("wave-compiler");
+  const ext = EXT_MAP[language] || ".py";
+
+  const dir = mkdtempSync(join(tmpdir(), "wave-"));
+  const srcPath = join(dir, `kernel${ext}`);
+  const wbinPath = join(dir, "kernel.wbin");
+
+  writeFileSync(srcPath, source);
+
+  try {
+    execSync(`${compiler} ${srcPath} -o ${wbinPath} -l ${language}`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+  } catch (e: unknown) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`Compilation failed: ${msg}`);
+  }
+
+  const wbin = readFileSync(wbinPath);
+
+  try {
+    unlinkSync(srcPath);
+    unlinkSync(wbinPath);
+  } catch {
+    // cleanup best-effort
+  }
+
+  return wbin;
+}
+
+/** Launch a kernel on the WAVE emulator via subprocess. */
+export async function launchEmulator(
+  wbin: Buffer,
+  buffers: WaveArray[],
+  scalars: number[],
+  grid: [number, number, number],
+  workgroup: [number, number, number],
+): Promise<void> {
+  const emulator = findTool("wave-emu");
+  const dir = mkdtempSync(join(tmpdir(), "wave-emu-"));
+  const wbinPath = join(dir, "kernel.wbin");
+  const memPath = join(dir, "memory.bin");
+
+  writeFileSync(wbinPath, wbin);
+
+  const offsets: number[] = [];
+  const memParts: Buffer[] = [];
+  let offset = 0;
+
+  for (const buf of buffers) {
+    offsets.push(offset);
+    const binBuf = buf.toBuffer();
+    memParts.push(binBuf);
+    offset += binBuf.length;
+  }
+
+  writeFileSync(memPath, Buffer.concat(memParts));
+
+  let cmd = `${emulator} ${wbinPath}`;
+  cmd += ` --memory-file ${memPath}`;
+  cmd += ` --grid ${grid[0]},${grid[1]},${grid[2]}`;
+  cmd += ` --workgroup ${workgroup[0]},${workgroup[1]},${workgroup[2]}`;
+
+  for (let i = 0; i < offsets.length; i++) {
+    cmd += ` --reg ${i}=${offsets[i]}`;
+  }
+  for (let i = 0; i < scalars.length; i++) {
+    cmd += ` --reg ${buffers.length + i}=${scalars[i]}`;
+  }
+
+  try {
+    execSync(cmd, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+  } catch (e: unknown) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`Emulator execution failed: ${msg}`);
+  }
+
+  const resultMem = readFileSync(memPath);
+
+  let readOffset = 0;
+  for (const buf of buffers) {
+    const size = buf.length * 4;
+    const chunk = resultMem.subarray(readOffset, readOffset + size);
+    for (let i = 0; i < buf.length; i++) {
+      buf.data[i] = chunk.readFloatLE(i * 4);
+    }
+    readOffset += size;
+  }
+
+  try {
+    unlinkSync(wbinPath);
+    unlinkSync(memPath);
+  } catch {
+    // cleanup best-effort
+  }
+}

package/tests/test_vector_add.ts

@@ -0,0 +1,60 @@
+// Copyright 2026 Ojima Abraham
+// SPDX-License-Identifier: Apache-2.0
+
+/// End-to-end test for the WAVE JavaScript/TypeScript SDK.
+
+import { device, array, zeros, WaveArray } from "../src/index";
+
+async function testDevice(): Promise<void> {
+  const dev = await device();
+  console.assert(dev.vendor !== undefined, "vendor should be defined");
+  console.assert(dev.name.length > 0, "name should be non-empty");
+  console.log(`  Device: ${dev.name}`);
+}
+
+function testArray(): void {
+  const a = array([1, 2, 3, 4]);
+  console.assert(a.length === 4, "length should be 4");
+  console.assert(
+    JSON.stringify(a.toArray()) === JSON.stringify([1, 2, 3, 4]),
+    "toArray should match",
+  );
+
+  const z = zeros(5);
+  console.assert(z.length === 5, "zeros length should be 5");
+  console.assert(
+    z.toArray().every((v) => v === 0),
+    "zeros should all be 0",
+  );
+}
+
+function testBufferRoundtrip(): void {
+  const a = array([1.5, 2.5, 3.5]);
+  const buf = a.toBuffer();
+  const b = WaveArray.fromBuffer(buf, 3);
+  const diff = a
+    .toArray()
+    .map((v, i) => Math.abs(v - b.toArray()[i]))
+    .reduce((s, d) => s + d, 0);
+  console.assert(diff < 0.001, "buffer roundtrip should preserve values");
+}
+
+async function main(): Promise<void> {
+  console.log("Running WAVE JS/TS SDK tests...");
+
+  await testDevice();
+  console.log("  [PASS] device detection");
+
+  testArray();
+  console.log("  [PASS] array creation");
+
+  testBufferRoundtrip();
+  console.log("  [PASS] buffer roundtrip");
+
+  console.log("All JS/TS SDK tests passed!");
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"]
+}