@godexture/js 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 godexture
+
+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/dist/generated/go-main.d.ts

@@ -0,0 +1,55 @@
+export declare class GoMain {
+    private worker;
+    private requestId;
+    private pending;
+    private nextCallbackId;
+    private callbacks;
+    private constructor();
+    static init(workerUrl: string): Promise<GoMain>;
+    terminate(): void;
+    private call;
+    private registerCallback;
+    /**
+     * Catalog returns the available demuxers, decoders, filters, encoders, and
+     * muxers, and which codecs each output format supports, as JSON.
+     */
+    catalog(): Promise<string>;
+    /**
+     * DescribeFilter resolves a filter's editable configuration and port topology
+     * for the given structural parameters.
+     */
+    describeFilter(name: string, parameters: {
+        [key: string]: string;
+    }): Promise<string>;
+    /**
+     * Resolve negotiates a pipeline for inputs against the JSON-encoded spec
+     * without building or running it, returning the resolved node/edge topology
+     * as JSON. Used to preview a pipeline before starting a conversion.
+     */
+    resolve(mainInput: Uint8Array, auxInputs: {
+        [key: string]: Uint8Array;
+    }, specJSON: string): Promise<string>;
+    /**
+     * Start negotiates, builds, and begins a conversion in the background under
+     * jobID (chosen by the caller, since Start's own return value only reaches
+     * JS once the conversion is done -- see reportProgress). onProgress is
+     * invoked with a JSON-encoded Progress a few times a second until the job
+     * finishes, and once more with the final outcome.
+     */
+    start(jobID: string, mainInput: Uint8Array, auxInputs: {
+        [key: string]: Uint8Array;
+    }, specJSON: string, onProgress: (arg0: string) => void): Promise<string>;
+    /**
+     * Snapshot reports a job's current progress and outcome as JSON.
+     */
+    snapshot(jobID: string): Promise<string>;
+    /**
+     * Cancel requests that a running job stop.
+     */
+    cancel(jobID: string): Promise<void>;
+    /**
+     * Result waits for a job to finish and returns its output bytes, releasing
+     * the job's resources. Call it at most once per job.
+     */
+    result(jobID: string): Promise<Uint8Array>;
+}

package/dist/generated/go-main.js

@@ -0,0 +1,122 @@
+// go-main.ts - Generated by gowasm-bindgen
+// Package: main
+export class GoMain {
+    worker;
+    requestId = 0;
+    pending = new Map();
+    nextCallbackId = 0;
+    callbacks = new Map();
+    constructor(worker) {
+        this.worker = worker;
+    }
+    static async init(workerUrl) {
+        const worker = new Worker(workerUrl);
+        const instance = new GoMain(worker);
+        await new Promise((resolve, reject) => {
+            worker.onmessage = (event) => {
+                const { type, id, result, error, callbackId, args } = event.data;
+                if (type === 'ready') {
+                    resolve();
+                    return;
+                }
+                // Handle callback invocations from Go
+                if (type === 'invokeCallback') {
+                    const callback = instance.callbacks.get(callbackId);
+                    if (callback) {
+                        try {
+                            callback(...args);
+                        }
+                        catch (e) {
+                            console.error('Callback error:', e);
+                        }
+                    }
+                    return;
+                }
+                const handler = instance.pending.get(id);
+                if (handler) {
+                    instance.pending.delete(id);
+                    if (error) {
+                        handler.reject(new Error(error));
+                    }
+                    else if (result && typeof result === 'object' && '__error' in result) {
+                        handler.reject(new Error(result.__error));
+                    }
+                    else {
+                        handler.resolve(result);
+                    }
+                }
+            };
+            worker.onerror = (e) => reject(new Error(e.message || 'Worker failed to load'));
+        });
+        return instance;
+    }
+    terminate() {
+        this.worker.terminate();
+    }
+    call(fn, args) {
+        return new Promise((resolve, reject) => {
+            const id = ++this.requestId;
+            this.pending.set(id, { resolve: resolve, reject });
+            this.worker.postMessage({ id, fn, args });
+        });
+    }
+    registerCallback(fn) {
+        const id = ++this.nextCallbackId;
+        this.callbacks.set(id, fn);
+        return id;
+    }
+    /**
+     * Catalog returns the available demuxers, decoders, filters, encoders, and
+     * muxers, and which codecs each output format supports, as JSON.
+     */
+    catalog() {
+        return this.call("catalog", []);
+    }
+    /**
+     * DescribeFilter resolves a filter's editable configuration and port topology
+     * for the given structural parameters.
+     */
+    describeFilter(name, parameters) {
+        return this.call("describeFilter", [name, parameters]);
+    }
+    /**
+     * Resolve negotiates a pipeline for inputs against the JSON-encoded spec
+     * without building or running it, returning the resolved node/edge topology
+     * as JSON. Used to preview a pipeline before starting a conversion.
+     */
+    resolve(mainInput, auxInputs, specJSON) {
+        return this.call("resolve", [mainInput, auxInputs, specJSON]);
+    }
+    /**
+     * Start negotiates, builds, and begins a conversion in the background under
+     * jobID (chosen by the caller, since Start's own return value only reaches
+     * JS once the conversion is done -- see reportProgress). onProgress is
+     * invoked with a JSON-encoded Progress a few times a second until the job
+     * finishes, and once more with the final outcome.
+     */
+    start(jobID, mainInput, auxInputs, specJSON, onProgress) {
+        const onProgressId = this.registerCallback(onProgress);
+        return this.call("start", [jobID, mainInput, auxInputs, specJSON, onProgressId]).finally(() => {
+            this.callbacks.delete(onProgressId);
+        });
+    }
+    /**
+     * Snapshot reports a job's current progress and outcome as JSON.
+     */
+    snapshot(jobID) {
+        return this.call("snapshot", [jobID]);
+    }
+    /**
+     * Cancel requests that a running job stop.
+     */
+    cancel(jobID) {
+        return this.call("cancel", [jobID]);
+    }
+    /**
+     * Result waits for a job to finish and returns its output bytes, releasing
+     * the job's resources. Call it at most once per job.
+     */
+    result(jobID) {
+        return this.call("result", [jobID]);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import type { Catalog, ConversionSpec, FilterEntry, InputSet, PipelineDescription, Progress } from "./types";
+export type { AuxInputSpec, Catalog, ConversionSpec, FilterEntry, FilterSpec, InputSet, JobStatus, NodeStatus, OutputFormat, PipelineDescription, PipelineEdge, PipelineNode, PluginEntry, PluginField, PluginSpec, PortRef, Progress, StreamInfo, } from "./types";
+export declare class Godexture {
+    private goMain?;
+    init(workerUrl: string): Promise<void>;
+    terminate(): void;
+    private main;
+    getCatalog(): Promise<Catalog>;
+    describeFilter(name: string, parameters?: Record<string, string>): Promise<FilterEntry>;
+    resolvePipeline(inputs: InputSet, spec: ConversionSpec): Promise<PipelineDescription>;
+    start(jobId: string, inputs: InputSet, spec: ConversionSpec, onProgress: (progress: Progress) => void): Promise<string>;
+    snapshot(jobId: string): Promise<Progress>;
+    cancel(jobId: string): Promise<void>;
+    result(jobId: string): Promise<Uint8Array>;
+}

package/dist/index.js

@@ -0,0 +1,42 @@
+import { GoMain } from "./generated/go-main";
+export class Godexture {
+    goMain;
+    async init(workerUrl) {
+        if (this.goMain)
+            return;
+        this.goMain = await GoMain.init(workerUrl);
+    }
+    terminate() {
+        this.goMain?.terminate();
+        this.goMain = undefined;
+    }
+    main() {
+        if (!this.goMain) {
+            throw new Error("Godexture not initialized. Call init() first.");
+        }
+        return this.goMain;
+    }
+    async getCatalog() {
+        return JSON.parse(await this.main().catalog());
+    }
+    async describeFilter(name, parameters = {}) {
+        return JSON.parse(await this.main().describeFilter(name, parameters));
+    }
+    async resolvePipeline(inputs, spec) {
+        return JSON.parse(await this.main().resolve(inputs.main, inputs.aux ?? {}, JSON.stringify(spec)));
+    }
+    async start(jobId, inputs, spec, onProgress) {
+        return this.main().start(jobId, inputs.main, inputs.aux ?? {}, JSON.stringify(spec), (data) => {
+            onProgress(JSON.parse(data));
+        });
+    }
+    async snapshot(jobId) {
+        return JSON.parse(await this.main().snapshot(jobId));
+    }
+    async cancel(jobId) {
+        await this.main().cancel(jobId);
+    }
+    async result(jobId) {
+        return this.main().result(jobId);
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,113 @@
+export interface PluginField {
+    name: string;
+    type: string;
+    help: string;
+    default: string;
+    choices?: string[];
+    dependsOn?: {
+        field: string;
+        values: string[];
+    };
+}
+export interface PluginEntry {
+    role: string;
+    name: string;
+    description: string;
+    fields: PluginField[];
+}
+export interface FilterEntry extends PluginEntry {
+    parameters: PluginField[];
+    inputs: string[];
+    outputs: string[];
+}
+export interface OutputFormat {
+    muxer: string;
+    extensions: string[];
+    codecs: string[];
+    defaultCodec: string;
+}
+export interface Catalog {
+    demuxers: PluginEntry[];
+    decoders: PluginEntry[];
+    filters: FilterEntry[];
+    encoders: PluginEntry[];
+    muxers: PluginEntry[];
+    outputs: OutputFormat[];
+}
+export interface PluginSpec {
+    name: string;
+    values?: Record<string, string>;
+}
+export interface PortRef {
+    alias: string;
+    port?: string;
+}
+export interface FilterSpec extends PluginSpec {
+    alias?: string;
+    inputs?: Record<string, PortRef>;
+    parameters?: Record<string, string>;
+}
+export interface AuxInputSpec {
+    demuxer?: PluginSpec;
+    decoder?: PluginSpec;
+}
+export interface ConversionSpec {
+    demuxer?: PluginSpec;
+    decoder?: PluginSpec;
+    filters?: FilterSpec[];
+    auxInputs?: Record<string, AuxInputSpec>;
+    sink?: PortRef;
+    codec?: string;
+    encoder?: PluginSpec;
+    muxer: PluginSpec;
+    parallelism?: number;
+}
+export interface NodeStatus {
+    id: string;
+    role: string;
+    plugin: string;
+    autoInserted: boolean;
+    state: string;
+    elapsedMs: number;
+    error?: string;
+}
+export type JobStatus = "running" | "completed" | "failed" | "canceled";
+export interface Progress {
+    status?: JobStatus;
+    error?: string;
+    percent: number;
+    processedMs: number;
+    totalMs: number;
+    processedItems: number;
+    speedRatio: number;
+    elapsedMs: number;
+    etaMs: number;
+    nodes: NodeStatus[];
+}
+export interface StreamInfo {
+    [key: string]: unknown;
+}
+export interface PipelineNode {
+    ID: string;
+    Role: string;
+    Plugin: string;
+    AutoInserted: boolean;
+    Inputs: StreamInfo[];
+    Outputs: StreamInfo[];
+}
+export interface PipelineEdge {
+    FromNode: string;
+    FromPort: string;
+    ToNode: string;
+    ToPort: string;
+    Stream: StreamInfo;
+    ProgressSource: boolean;
+}
+export interface PipelineDescription {
+    Nodes: PipelineNode[];
+    Edges: PipelineEdge[];
+}
+export interface InputSet {
+    main: Uint8Array;
+    aux?: Record<string, Uint8Array>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/wasm_exec.js

@@ -0,0 +1,559 @@
+// Copyright 2018 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+//
+// This file has been modified for use by the TinyGo compiler.
+
+(() => {
+	// Map multiple JavaScript environments to a single common API,
+	// preferring web standards over Node.js API.
+	//
+	// Environments considered:
+	// - Browsers
+	// - Node.js
+	// - Electron
+	// - Parcel
+
+	if (typeof global !== "undefined") {
+		// global already exists
+	} else if (typeof window !== "undefined") {
+		window.global = window;
+	} else if (typeof self !== "undefined") {
+		self.global = self;
+	} else {
+		throw new Error("cannot export Go (neither global, window nor self is defined)");
+	}
+
+	if (!global.require && typeof require !== "undefined") {
+		global.require = require;
+	}
+
+	if (!global.fs && global.require) {
+		global.fs = require("node:fs");
+	}
+
+	const enosys = () => {
+		const err = new Error("not implemented");
+		err.code = "ENOSYS";
+		return err;
+	};
+
+	if (!global.fs) {
+		let outputBuf = "";
+		global.fs = {
+			constants: { O_WRONLY: -1, O_RDWR: -1, O_CREAT: -1, O_TRUNC: -1, O_APPEND: -1, O_EXCL: -1 }, // unused
+			writeSync(fd, buf) {
+				outputBuf += decoder.decode(buf);
+				const nl = outputBuf.lastIndexOf("\n");
+				if (nl != -1) {
+					console.log(outputBuf.substr(0, nl));
+					outputBuf = outputBuf.substr(nl + 1);
+				}
+				return buf.length;
+			},
+			write(fd, buf, offset, length, position, callback) {
+				if (offset !== 0 || length !== buf.length || position !== null) {
+					callback(enosys());
+					return;
+				}
+				const n = this.writeSync(fd, buf);
+				callback(null, n);
+			},
+			chmod(path, mode, callback) { callback(enosys()); },
+			chown(path, uid, gid, callback) { callback(enosys()); },
+			close(fd, callback) { callback(enosys()); },
+			fchmod(fd, mode, callback) { callback(enosys()); },
+			fchown(fd, uid, gid, callback) { callback(enosys()); },
+			fstat(fd, callback) { callback(enosys()); },
+			fsync(fd, callback) { callback(null); },
+			ftruncate(fd, length, callback) { callback(enosys()); },
+			lchown(path, uid, gid, callback) { callback(enosys()); },
+			link(path, link, callback) { callback(enosys()); },
+			lstat(path, callback) { callback(enosys()); },
+			mkdir(path, perm, callback) { callback(enosys()); },
+			open(path, flags, mode, callback) { callback(enosys()); },
+			read(fd, buffer, offset, length, position, callback) { callback(enosys()); },
+			readdir(path, callback) { callback(enosys()); },
+			readlink(path, callback) { callback(enosys()); },
+			rename(from, to, callback) { callback(enosys()); },
+			rmdir(path, callback) { callback(enosys()); },
+			stat(path, callback) { callback(enosys()); },
+			symlink(path, link, callback) { callback(enosys()); },
+			truncate(path, length, callback) { callback(enosys()); },
+			unlink(path, callback) { callback(enosys()); },
+			utimes(path, atime, mtime, callback) { callback(enosys()); },
+		};
+	}
+
+	if (!global.process) {
+		global.process = {
+			getuid() { return -1; },
+			getgid() { return -1; },
+			geteuid() { return -1; },
+			getegid() { return -1; },
+			getgroups() { throw enosys(); },
+			pid: -1,
+			ppid: -1,
+			umask() { throw enosys(); },
+			cwd() { throw enosys(); },
+			chdir() { throw enosys(); },
+		}
+	}
+
+	if (!global.crypto) {
+		const nodeCrypto = require("node:crypto");
+		global.crypto = {
+			getRandomValues(b) {
+				nodeCrypto.randomFillSync(b);
+			},
+		};
+	}
+
+	if (!global.performance) {
+		global.performance = {
+			now() {
+				const [sec, nsec] = process.hrtime();
+				return sec * 1000 + nsec / 1000000;
+			},
+		};
+	}
+
+	if (!global.TextEncoder) {
+		global.TextEncoder = require("node:util").TextEncoder;
+	}
+
+	if (!global.TextDecoder) {
+		global.TextDecoder = require("node:util").TextDecoder;
+	}
+
+	// End of polyfills for common API.
+
+	const encoder = new TextEncoder("utf-8");
+	const decoder = new TextDecoder("utf-8");
+	let reinterpretBuf = new DataView(new ArrayBuffer(8));
+	var logLine = [];
+	const wasmExit = {}; // thrown to exit via proc_exit (not an error)
+
+	global.Go = class {
+		constructor() {
+			this._callbackTimeouts = new Map();
+			this._nextCallbackTimeoutID = 1;
+
+			const mem = () => {
+				// The buffer may change when requesting more memory.
+				return new DataView(this._inst.exports.memory.buffer);
+			}
+
+			const unboxValue = (v_ref) => {
+				reinterpretBuf.setBigInt64(0, v_ref, true);
+				const f = reinterpretBuf.getFloat64(0, true);
+				if (f === 0) {
+					return undefined;
+				}
+				if (!isNaN(f)) {
+					return f;
+				}
+
+				const id = v_ref & 0xffffffffn;
+				return this._values[id];
+			}
+
+
+			const loadValue = (addr) => {
+				let v_ref = mem().getBigUint64(addr, true);
+				return unboxValue(v_ref);
+			}
+
+			const boxValue = (v) => {
+				const nanHead = 0x7FF80000n;
+
+				if (typeof v === "number") {
+					if (isNaN(v)) {
+						return nanHead << 32n;
+					}
+					if (v === 0) {
+						return (nanHead << 32n) | 1n;
+					}
+					reinterpretBuf.setFloat64(0, v, true);
+					return reinterpretBuf.getBigInt64(0, true);
+				}
+
+				switch (v) {
+					case undefined:
+						return 0n;
+					case null:
+						return (nanHead << 32n) | 2n;
+					case true:
+						return (nanHead << 32n) | 3n;
+					case false:
+						return (nanHead << 32n) | 4n;
+				}
+
+				let id = this._ids.get(v);
+				if (id === undefined) {
+					id = this._idPool.pop();
+					if (id === undefined) {
+						id = BigInt(this._values.length);
+					}
+					this._values[id] = v;
+					this._goRefCounts[id] = 0;
+					this._ids.set(v, id);
+				}
+				this._goRefCounts[id]++;
+				let typeFlag = 1n;
+				switch (typeof v) {
+					case "string":
+						typeFlag = 2n;
+						break;
+					case "symbol":
+						typeFlag = 3n;
+						break;
+					case "function":
+						typeFlag = 4n;
+						break;
+				}
+				return id | ((nanHead | typeFlag) << 32n);
+			}
+
+			const storeValue = (addr, v) => {
+				let v_ref = boxValue(v);
+				mem().setBigUint64(addr, v_ref, true);
+			}
+
+			const loadSlice = (array, len, cap) => {
+				return new Uint8Array(this._inst.exports.memory.buffer, array, len);
+			}
+
+			const loadSliceOfValues = (array, len, cap) => {
+				const a = new Array(len);
+				for (let i = 0; i < len; i++) {
+					a[i] = loadValue(array + i * 8);
+				}
+				return a;
+			}
+
+			const loadString = (ptr, len) => {
+				return decoder.decode(new DataView(this._inst.exports.memory.buffer, ptr, len));
+			}
+
+			const timeOrigin = Date.now() - performance.now();
+			const wasi_EBADF = 8;
+			const wasi_ENOSYS = 52;
+			this.importObject = {
+				wasi_snapshot_preview1: {
+					// https://github.com/WebAssembly/WASI/blob/snapshot-01/phases/snapshot/docs.md
+					fd_write: function(fd, iovs_ptr, iovs_len, nwritten_ptr) {
+						let nwritten = 0;
+						if (fd == 1) {
+							for (let iovs_i=0; iovs_i<iovs_len;iovs_i++) {
+								let iov_ptr = iovs_ptr+iovs_i*8; // assuming wasm32
+								let ptr = mem().getUint32(iov_ptr + 0, true);
+								let len = mem().getUint32(iov_ptr + 4, true);
+								nwritten += len;
+								for (let i=0; i<len; i++) {
+									let c = mem().getUint8(ptr+i);
+									if (c == 13) { // CR
+										// ignore
+									} else if (c == 10) { // LF
+										// write line
+										let line = decoder.decode(new Uint8Array(logLine));
+										logLine = [];
+										console.log(line);
+									} else {
+										logLine.push(c);
+									}
+								}
+							}
+						} else {
+							console.error('invalid file descriptor:', fd);
+						}
+						mem().setUint32(nwritten_ptr, nwritten, true);
+						return 0;
+					},
+					fd_read: () => wasi_ENOSYS,
+					fd_close: () => wasi_ENOSYS,
+					fd_fdstat_get: () => wasi_ENOSYS,
+					fd_prestat_get: () => wasi_EBADF, // wasi-libc relies on this errno value
+					fd_prestat_dir_name: () => wasi_ENOSYS,
+					fd_seek: () => wasi_ENOSYS,
+					path_open: () => wasi_ENOSYS,
+					proc_exit: (code) => {
+						this.exited = true;
+						this.exitCode = code;
+						this._resolveExitPromise();
+						throw wasmExit;
+					},
+					random_get: (bufPtr, bufLen) => {
+						crypto.getRandomValues(loadSlice(bufPtr, bufLen));
+						return 0;
+					},
+				},
+				gojs: {
+					// func ticks() int64
+					"runtime.ticks": () => {
+						return BigInt((timeOrigin + performance.now()) * 1e6);
+					},
+
+					// func sleepTicks(timeout int64)
+					"runtime.sleepTicks": (timeout) => {
+						// Do not sleep, only reactivate scheduler after the given timeout.
+						setTimeout(() => {
+							if (this.exited) return;
+							try {
+								this._inst.exports.go_scheduler();
+							} catch (e) {
+								if (e !== wasmExit) throw e;
+							}
+						}, Number(timeout)/1e6);
+					},
+
+					// func finalizeRef(v ref)
+					"syscall/js.finalizeRef": (v_ref) => {
+						// Note: TinyGo does not support finalizers so this is only called
+						// for one specific case, by js.go:jsString. and can/might leak memory.
+						const id = v_ref & 0xffffffffn;
+						if (this._goRefCounts?.[id] !== undefined) {
+							this._goRefCounts[id]--;
+							if (this._goRefCounts[id] === 0) {
+								const v = this._values[id];
+								this._values[id] = null;
+								this._ids.delete(v);
+								this._idPool.push(id);
+							}
+						} else {
+							console.error("syscall/js.finalizeRef: unknown id", id);
+						}
+					},
+
+					// func stringVal(value string) ref
+					"syscall/js.stringVal": (value_ptr, value_len) => {
+						value_ptr >>>= 0;
+						const s = loadString(value_ptr, value_len);
+						return boxValue(s);
+					},
+
+					// func valueGet(v ref, p string) ref
+					"syscall/js.valueGet": (v_ref, p_ptr, p_len) => {
+						let prop = loadString(p_ptr, p_len);
+						let v = unboxValue(v_ref);
+						let result = Reflect.get(v, prop);
+						return boxValue(result);
+					},
+
+					// func valueSet(v ref, p string, x ref)
+					"syscall/js.valueSet": (v_ref, p_ptr, p_len, x_ref) => {
+						const v = unboxValue(v_ref);
+						const p = loadString(p_ptr, p_len);
+						const x = unboxValue(x_ref);
+						Reflect.set(v, p, x);
+					},
+
+					// func valueDelete(v ref, p string)
+					"syscall/js.valueDelete": (v_ref, p_ptr, p_len) => {
+						const v = unboxValue(v_ref);
+						const p = loadString(p_ptr, p_len);
+						Reflect.deleteProperty(v, p);
+					},
+
+					// func valueIndex(v ref, i int) ref
+					"syscall/js.valueIndex": (v_ref, i) => {
+						return boxValue(Reflect.get(unboxValue(v_ref), i));
+					},
+
+					// valueSetIndex(v ref, i int, x ref)
+					"syscall/js.valueSetIndex": (v_ref, i, x_ref) => {
+						Reflect.set(unboxValue(v_ref), i, unboxValue(x_ref));
+					},
+
+					// func valueCall(v ref, m string, args []ref) (ref, bool)
+					"syscall/js.valueCall": (ret_addr, v_ref, m_ptr, m_len, args_ptr, args_len, args_cap) => {
+						const v = unboxValue(v_ref);
+						const name = loadString(m_ptr, m_len);
+						const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+						try {
+							const m = Reflect.get(v, name);
+							storeValue(ret_addr, Reflect.apply(m, v, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr + 8, 0);
+						}
+					},
+
+					// func valueInvoke(v ref, args []ref) (ref, bool)
+					"syscall/js.valueInvoke": (ret_addr, v_ref, args_ptr, args_len, args_cap) => {
+						try {
+							const v = unboxValue(v_ref);
+							const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+							storeValue(ret_addr, Reflect.apply(v, undefined, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr + 8, 0);
+						}
+					},
+
+					// func valueNew(v ref, args []ref) (ref, bool)
+					"syscall/js.valueNew": (ret_addr, v_ref, args_ptr, args_len, args_cap) => {
+						const v = unboxValue(v_ref);
+						const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+						try {
+							storeValue(ret_addr, Reflect.construct(v, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr+ 8, 0);
+						}
+					},
+
+					// func valueLength(v ref) int
+					"syscall/js.valueLength": (v_ref) => {
+						return unboxValue(v_ref).length;
+					},
+
+					// valuePrepareString(v ref) (ref, int)
+					"syscall/js.valuePrepareString": (ret_addr, v_ref) => {
+						const s = String(unboxValue(v_ref));
+						const str = encoder.encode(s);
+						storeValue(ret_addr, str);
+						mem().setInt32(ret_addr + 8, str.length, true);
+					},
+
+					// valueLoadString(v ref, b []byte)
+					"syscall/js.valueLoadString": (v_ref, slice_ptr, slice_len, slice_cap) => {
+						const str = unboxValue(v_ref);
+						loadSlice(slice_ptr, slice_len, slice_cap).set(str);
+					},
+
+					// func valueInstanceOf(v ref, t ref) bool
+					"syscall/js.valueInstanceOf": (v_ref, t_ref) => {
+ 						return unboxValue(v_ref) instanceof unboxValue(t_ref);
+					},
+
+					// func copyBytesToGo(dst []byte, src ref) (int, bool)
+					"syscall/js.copyBytesToGo": (ret_addr, dest_addr, dest_len, dest_cap, src_ref) => {
+						let num_bytes_copied_addr = ret_addr;
+						let returned_status_addr = ret_addr + 4; // Address of returned boolean status variable
+
+						const dst = loadSlice(dest_addr, dest_len);
+						const src = unboxValue(src_ref);
+						if (!(src instanceof Uint8Array || src instanceof Uint8ClampedArray)) {
+							mem().setUint8(returned_status_addr, 0); // Return "not ok" status
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						mem().setUint32(num_bytes_copied_addr, toCopy.length, true);
+						mem().setUint8(returned_status_addr, 1); // Return "ok" status
+					},
+
+					// copyBytesToJS(dst ref, src []byte) (int, bool)
+					// Originally copied from upstream Go project, then modified:
+					//   https://github.com/golang/go/blob/3f995c3f3b43033013013e6c7ccc93a9b1411ca9/misc/wasm/wasm_exec.js#L404-L416
+					"syscall/js.copyBytesToJS": (ret_addr, dst_ref, src_addr, src_len, src_cap) => {
+						let num_bytes_copied_addr = ret_addr;
+						let returned_status_addr = ret_addr + 4; // Address of returned boolean status variable
+
+						const dst = unboxValue(dst_ref);
+						const src = loadSlice(src_addr, src_len);
+						if (!(dst instanceof Uint8Array || dst instanceof Uint8ClampedArray)) {
+							mem().setUint8(returned_status_addr, 0); // Return "not ok" status
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						mem().setUint32(num_bytes_copied_addr, toCopy.length, true);
+						mem().setUint8(returned_status_addr, 1); // Return "ok" status
+					},
+				}
+			};
+
+			// Go 1.20 uses 'env'. Go 1.21 uses 'gojs'.
+			// For compatibility, we use both as long as Go 1.20 is supported.
+			this.importObject.env = this.importObject.gojs;
+		}
+
+		async run(instance) {
+			this._inst = instance;
+			this._values = [ // JS values that Go currently has references to, indexed by reference id
+				NaN,
+				0,
+				null,
+				true,
+				false,
+				global,
+				this,
+			];
+			this._goRefCounts = []; // number of references that Go has to a JS value, indexed by reference id
+			this._ids = new Map();  // mapping from JS values to reference ids
+			this._idPool = [];      // unused ids that have been garbage collected
+			this.exited = false;    // whether the Go program has exited
+			this.exitCode = 0;
+
+			if (this._inst.exports._start) {
+				let exitPromise = new Promise((resolve, reject) => {
+					this._resolveExitPromise = resolve;
+				});
+
+				// Run program, but catch the wasmExit exception that's thrown
+				// to return back here.
+				try {
+					this._inst.exports._start();
+				} catch (e) {
+					if (e !== wasmExit) throw e;
+				}
+
+				await exitPromise;
+				return this.exitCode;
+			} else {
+				this._inst.exports._initialize();
+			}
+		}
+
+		_resume() {
+			if (this.exited) {
+				throw new Error("Go program has already exited");
+			}
+			try {
+				this._inst.exports.resume();
+			} catch (e) {
+				if (e !== wasmExit) throw e;
+			}
+			if (this.exited) {
+				this._resolveExitPromise();
+			}
+		}
+
+		_makeFuncWrapper(id) {
+			const go = this;
+			return function () {
+				const event = { id: id, this: this, args: arguments };
+				go._pendingEvent = event;
+				go._resume();
+				return event.result;
+			};
+		}
+	}
+
+	if (
+		global.require &&
+		global.require.main === module &&
+		global.process &&
+		global.process.versions &&
+		!global.process.versions.electron
+	) {
+		if (process.argv.length != 3) {
+			console.error("usage: go_js_wasm_exec [wasm binary] [arguments]");
+			process.exit(1);
+		}
+
+		const go = new Go();
+		WebAssembly.instantiate(fs.readFileSync(process.argv[2]), go.importObject).then(async (result) => {
+			let exitCode = await go.run(result.instance);
+			process.exit(exitCode);
+		}).catch((err) => {
+			console.error(err);
+			process.exit(1);
+		});
+	}
+})();

package/dist/worker.js

@@ -0,0 +1,48 @@
+/**
+ * Go WASM Web Worker
+ * Generated by gowasm-bindgen
+ *
+ * This worker loads the Go WASM module and handles function calls
+ * from the main thread via postMessage.
+ */
+
+// Load Go WASM runtime
+importScripts('wasm_exec.js');
+
+const go = new Go();
+let wasmReady = false;
+
+// Global for Go to invoke callbacks (fire-and-forget)
+// Go calls this to relay callback invocations to the main thread
+self.invokeCallback = function(callbackId, args) {
+  self.postMessage({ type: 'invokeCallback', callbackId: callbackId, args: args });
+};
+
+// Initialize WASM
+fetch('main.wasm')
+  .then(response => WebAssembly.instantiateStreaming(response, go.importObject))
+  .then(result => {
+    go.run(result.instance);
+    wasmReady = true;
+    self.postMessage({ type: 'ready' });
+  })
+  .catch(error => {
+    self.postMessage({ type: 'error', error: error.message });
+  });
+
+// Handle function calls from main thread
+self.onmessage = (event) => {
+  const { id, fn, args } = event.data;
+
+  if (!wasmReady) {
+    self.postMessage({ id, error: 'WASM not ready' });
+    return;
+  }
+
+  try {
+    const result = self[fn](...args);
+    self.postMessage({ id, result });
+  } catch (error) {
+    self.postMessage({ id, error: error.message });
+  }
+};

package/licenses/go.txt

@@ -0,0 +1,27 @@
+Copyright 2009 The Go Authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * Neither the name of Google LLC nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "@godexture/js",
+    "version": "0.0.1",
+    "description": "JavaScript/TypeScript bindings for godexture",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/godexture/bindings.git",
+        "directory": "js"
+    },
+    "license": "MIT",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "licenses",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "bun build:wasm && bun build:ts",
+        "build:ts": "tsc -p tsconfig.app.json",
+        "build:wasm": "bun run scripts/build.ts",
+        "test": "bun run ./test"
+    },
+    "devDependencies": {
+        "@types/bun": "1.3.14",
+        "@types/node": "26.1.1",
+        "typescript": "7.0.2"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}