@ttsc/wasm 0.11.0-dev.20260517

package/lib/src/MemFS.js

@@ -0,0 +1,384 @@
+// MemFS implements just enough of the wasm_exec.js fs interface for an
+// in-browser ttsc wasm to run.
+//
+// Why this exists: wasm_exec.js routes Go's syscalls (open / stat / read /
+// write / readdir / mkdir / ...) to `globalThis.fs`. In Node, that maps to the
+// real fs module. In browsers we have to supply our own. The set we implement
+// here is the smallest subset typescript-go actually exercises for a project
+// compile of a tiny in-memory project.
+//
+// All callbacks follow the Node "errback" convention: callback(err, result).
+// Errors carry a `code` (e.g. ENOENT, EBADF) so Go's os package sees them as
+// proper os.PathError values.
+//
+// Files are stored as Uint8Array. Text files written via writeFile are
+// encoded by the caller; reads return the raw bytes.
+/** Mode bits exposed by stat. We only differentiate file vs directory. */
+const S_IFDIR = 0o040000;
+const S_IFREG = 0o100000;
+const DEFAULT_FILE_MODE = S_IFREG | 0o644;
+const DEFAULT_DIR_MODE = S_IFDIR | 0o755;
+export class MemFSError extends Error {
+    code;
+    errno;
+    path;
+    syscall;
+    constructor(code, syscall, path) {
+        super(`${code}: ${syscall} ${path ?? ""}`.trim());
+        this.code = code;
+        this.errno = errnoForCode(code);
+        this.path = path;
+        this.syscall = syscall;
+    }
+}
+function errnoForCode(code) {
+    switch (code) {
+        case "ENOENT":
+            return -2;
+        case "EBADF":
+            return -9;
+        case "EEXIST":
+            return -17;
+        case "ENOTDIR":
+            return -20;
+        case "EISDIR":
+            return -21;
+        default:
+            return -1;
+    }
+}
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+function normalize(p) {
+    if (!p)
+        return "/";
+    const parts = p.replace(/\\/g, "/").split("/").filter(Boolean);
+    const stack = [];
+    for (const part of parts) {
+        if (part === ".")
+            continue;
+        if (part === "..") {
+            stack.pop();
+            continue;
+        }
+        stack.push(part);
+    }
+    return "/" + stack.join("/");
+}
+export function createMemFS() {
+    const nodes = new Map();
+    nodes.set("/", { kind: "dir", data: new Uint8Array(), mtimeMs: Date.now() });
+    const stdout = { buffer: "" };
+    const stderr = { buffer: "" };
+    const fdTable = new Map();
+    let nextFd = 100;
+    // Reserve 1/2 for stdout/stderr writeSync routing.
+    fdTable.set(1, { path: "/dev/stdout", position: 0, isStdout: true });
+    fdTable.set(2, { path: "/dev/stderr", position: 0, isStderr: true });
+    function ensureParentDirs(p) {
+        const segments = normalize(p).split("/").filter(Boolean);
+        segments.pop();
+        let cursor = "";
+        for (const seg of segments) {
+            cursor += "/" + seg;
+            if (!nodes.has(cursor)) {
+                nodes.set(cursor, {
+                    kind: "dir",
+                    data: new Uint8Array(),
+                    mtimeMs: Date.now(),
+                });
+            }
+        }
+    }
+    function mkdirp(p) {
+        const segments = normalize(p).split("/").filter(Boolean);
+        let cursor = "";
+        for (const seg of segments) {
+            cursor += "/" + seg;
+            const existing = nodes.get(cursor);
+            if (!existing) {
+                nodes.set(cursor, {
+                    kind: "dir",
+                    data: new Uint8Array(),
+                    mtimeMs: Date.now(),
+                });
+            }
+            else if (existing.kind !== "dir") {
+                throw new MemFSError("ENOTDIR", "mkdir", cursor);
+            }
+        }
+    }
+    function writeFile(p, data) {
+        const norm = normalize(p);
+        ensureParentDirs(norm);
+        const bytes = typeof data === "string" ? encoder.encode(data) : data;
+        nodes.set(norm, { kind: "file", data: bytes, mtimeMs: Date.now() });
+    }
+    function readFile(p) {
+        const node = nodes.get(normalize(p));
+        if (!node || node.kind !== "file")
+            return null;
+        return node.data;
+    }
+    function readFileText(p) {
+        const bytes = readFile(p);
+        return bytes === null ? null : decoder.decode(bytes);
+    }
+    function exists(p) {
+        return nodes.has(normalize(p));
+    }
+    function statSync(p) {
+        const norm = normalize(p);
+        const node = nodes.get(norm);
+        if (!node)
+            throw new MemFSError("ENOENT", "stat", norm);
+        return makeStats(node);
+    }
+    function makeStats(node) {
+        const isDir = node.kind === "dir";
+        return {
+            isDirectory: () => isDir,
+            isFile: () => !isDir,
+            size: node.data.byteLength,
+            mode: isDir ? DEFAULT_DIR_MODE : DEFAULT_FILE_MODE,
+            mtimeMs: node.mtimeMs,
+            atimeMs: node.mtimeMs,
+            ctimeMs: node.mtimeMs,
+            dev: 0,
+            ino: 0,
+            nlink: 1,
+            uid: 0,
+            gid: 0,
+            rdev: 0,
+            blksize: 4096,
+            blocks: Math.ceil(node.data.byteLength / 512),
+        };
+    }
+    function readdirSync(p) {
+        const norm = normalize(p);
+        const node = nodes.get(norm);
+        if (!node)
+            throw new MemFSError("ENOENT", "readdir", norm);
+        if (node.kind !== "dir")
+            throw new MemFSError("ENOTDIR", "readdir", norm);
+        const prefix = norm === "/" ? "/" : norm + "/";
+        const direct = new Set();
+        for (const key of nodes.keys()) {
+            if (!key.startsWith(prefix) || key === norm)
+                continue;
+            const rest = key.slice(prefix.length);
+            const cut = rest.indexOf("/");
+            direct.add(cut === -1 ? rest : rest.slice(0, cut));
+        }
+        return [...direct].sort();
+    }
+    const fs = {
+        constants: {
+            O_WRONLY: 1,
+            O_RDWR: 2,
+            O_CREAT: 64,
+            O_TRUNC: 512,
+            O_APPEND: 1024,
+            O_EXCL: 128,
+            O_DIRECTORY: 65536,
+        },
+        writeSync(fd, buf) {
+            const text = decoder.decode(buf);
+            if (fd === 1) {
+                stdout.buffer += text;
+            }
+            else if (fd === 2) {
+                stderr.buffer += text;
+            }
+            else {
+                stderr.buffer += text;
+            }
+            return buf.length;
+        },
+        write(fd, buf, offset, length, position, callback) {
+            try {
+                if (position !== null && position !== 0) {
+                    callback(new MemFSError("ESPIPE", "write"), 0);
+                    return;
+                }
+                const view = buf.subarray(offset, offset + length);
+                const written = this.writeSync(fd, view);
+                callback(null, written);
+            }
+            catch (err) {
+                callback(err, 0);
+            }
+        },
+        open(p, flags, _mode, callback) {
+            const norm = normalize(p);
+            const node = nodes.get(norm);
+            const creating = (flags & (this.constants.O_CREAT ?? 0)) !== 0;
+            if (!node) {
+                if (!creating) {
+                    callback(new MemFSError("ENOENT", "open", norm), -1);
+                    return;
+                }
+                ensureParentDirs(norm);
+                nodes.set(norm, {
+                    kind: "file",
+                    data: new Uint8Array(),
+                    mtimeMs: Date.now(),
+                });
+            }
+            const fd = nextFd++;
+            fdTable.set(fd, { path: norm, position: 0 });
+            if ((flags & (this.constants.O_TRUNC ?? 0)) !== 0) {
+                nodes.set(norm, {
+                    kind: "file",
+                    data: new Uint8Array(),
+                    mtimeMs: Date.now(),
+                });
+            }
+            callback(null, fd);
+        },
+        close(fd, callback) {
+            if (!fdTable.has(fd)) {
+                callback(new MemFSError("EBADF", "close"));
+                return;
+            }
+            if (fd > 2)
+                fdTable.delete(fd);
+            callback(null);
+        },
+        read(fd, buffer, offset, length, position, callback) {
+            const entry = fdTable.get(fd);
+            if (!entry) {
+                callback(new MemFSError("EBADF", "read"), 0);
+                return;
+            }
+            const node = nodes.get(entry.path);
+            if (!node || node.kind !== "file") {
+                callback(new MemFSError("ENOENT", "read", entry.path), 0);
+                return;
+            }
+            const start = position ?? entry.position;
+            const end = Math.min(start + length, node.data.byteLength);
+            const slice = node.data.subarray(start, end);
+            buffer.set(slice, offset);
+            if (position === null)
+                entry.position = end;
+            callback(null, slice.byteLength);
+        },
+        readdir(p, callback) {
+            try {
+                callback(null, readdirSync(p));
+            }
+            catch (err) {
+                callback(err, []);
+            }
+        },
+        mkdir(p, _perm, callback) {
+            try {
+                mkdirp(p);
+                callback(null);
+            }
+            catch (err) {
+                callback(err);
+            }
+        },
+        stat(p, callback) {
+            try {
+                callback(null, statSync(p));
+            }
+            catch (err) {
+                callback(err, undefined);
+            }
+        },
+        lstat(p, callback) {
+            this.stat(p, callback);
+        },
+        fstat(fd, callback) {
+            const entry = fdTable.get(fd);
+            if (!entry) {
+                callback(new MemFSError("EBADF", "fstat"), undefined);
+                return;
+            }
+            try {
+                callback(null, statSync(entry.path));
+            }
+            catch (err) {
+                callback(err, undefined);
+            }
+        },
+        fsync(_fd, callback) {
+            callback(null);
+        },
+        unlink(p, callback) {
+            const norm = normalize(p);
+            if (!nodes.has(norm)) {
+                callback(new MemFSError("ENOENT", "unlink", norm));
+                return;
+            }
+            nodes.delete(norm);
+            callback(null);
+        },
+        rename(from, to, callback) {
+            const src = normalize(from);
+            const node = nodes.get(src);
+            if (!node) {
+                callback(new MemFSError("ENOENT", "rename", src));
+                return;
+            }
+            const dest = normalize(to);
+            nodes.delete(src);
+            nodes.set(dest, node);
+            callback(null);
+        },
+        rmdir(p, callback) {
+            this.unlink(p, callback);
+        },
+        chmod(_p, _mode, callback) {
+            callback(null);
+        },
+        fchmod(_fd, _mode, callback) {
+            callback(null);
+        },
+        chown(_p, _uid, _gid, callback) {
+            callback(null);
+        },
+        fchown(_fd, _uid, _gid, callback) {
+            callback(null);
+        },
+        lchown(_p, _uid, _gid, callback) {
+            callback(null);
+        },
+        utimes(_p, _atime, _mtime, callback) {
+            callback(null);
+        },
+        link(_p, _link, callback) {
+            callback(new MemFSError("EPERM", "link"));
+        },
+        symlink(_p, _link, callback) {
+            callback(new MemFSError("EPERM", "symlink"));
+        },
+        readlink(_p, callback) {
+            callback(new MemFSError("EINVAL", "readlink"), "");
+        },
+        truncate(_p, _length, callback) {
+            callback(null);
+        },
+        ftruncate(_fd, _length, callback) {
+            callback(null);
+        },
+    };
+    return {
+        fs,
+        writeFile,
+        readFile,
+        readFileText,
+        exists,
+        mkdirp,
+        stdout,
+        stderr,
+        resetStdio() {
+            stdout.buffer = "";
+            stderr.buffer = "";
+        },
+    };
+}
+//# sourceMappingURL=MemFS.js.map

package/lib/src/MemFS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemFS.js","sourceRoot":"","sources":["../../src/MemFS.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+BAA+B;AAC/B,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,uCAAuC;AACvC,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,8BAA8B;AAC9B,EAAE;AACF,uEAAuE;AACvE,qDAAqD;AAErD,0EAA0E;AAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC;AACzB,MAAM,OAAO,GAAG,QAAQ,CAAC;AACzB,MAAM,iBAAiB,GAAG,OAAO,GAAG,KAAK,CAAC;AAC1C,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,CAAC;AAmJzC,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC5B,IAAI,CAAS;IACb,KAAK,CAAS;IACd,IAAI,CAAU;IACd,OAAO,CAAU;IACxB,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa;QACtD,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,CAAC,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,CAAC;QACb;YACE,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAcD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,SAAS,SAAS,CAAC,CAAS;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACnB,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,KAAK,CAAC,GAAG,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IACvC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAE7E,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAGpB,CAAC;IACJ,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAErE,SAAS,gBAAgB,CAAC,CAAS;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,QAAQ,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;oBAChB,IAAI,EAAE,KAAK;oBACX,IAAI,EAAE,IAAI,UAAU,EAAE;oBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,MAAM,CAAC,CAAS;QACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC;YACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;oBAChB,IAAI,EAAE,KAAK;oBACX,IAAI,EAAE,IAAI,UAAU,EAAE;oBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnC,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,SAAS,CAAC,CAAS,EAAE,IAAyB;QACrD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,SAAS,QAAQ,CAAC,CAAS;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,SAAS,YAAY,CAAC,CAAS;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,MAAM,CAAC,CAAS;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,QAAQ,CAAC,CAAS;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,SAAS,SAAS,CAAC,IAAW;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;QAClC,OAAO;YACL,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;YACxB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAC1B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB;YAClD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;YACN,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED,SAAS,WAAW,CAAC,CAAS;QAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YACtD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,EAAE,GAAgB;QACtB,SAAS,EAAE;YACT,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,KAAK;SACnB;QAED,SAAS,CAAC,EAAE,EAAE,GAAG;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;YACxB,CAAC;iBAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;YACxB,CAAC;YACD,OAAO,GAAG,CAAC,MAAM,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC/C,IAAI,CAAC;gBACH,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACxC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC/C,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;gBACnD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACzC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,GAA4B,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ;YAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBACD,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACvB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;oBACd,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,UAAU,EAAE;oBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;oBACd,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,UAAU,EAAE;oBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,EAAE,EAAE,QAAQ;YAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC3C,OAAO;YACT,CAAC;YACD,IAAI,EAAE,GAAG,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1B,IAAI,QAAQ,KAAK,IAAI;gBAAE,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC;YAC5C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,CAAC,CAAC,EAAE,QAAQ;YACjB,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,GAA4B,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ;YACtB,IAAI,CAAC;gBACH,MAAM,CAAC,CAAC,CAAC,CAAC;gBACV,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,GAA4B,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,CAAC,EAAE,QAAQ;YACd,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,GAA4B,EAAE,SAAkC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAED,KAAK,CAAC,CAAC,EAAE,QAAQ;YACf,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,EAAE,EAAE,QAAQ;YAChB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CACN,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAChC,SAAkC,CACnC,CAAC;gBACF,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CACN,GAA4B,EAC5B,SAAkC,CACnC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,GAAG,EAAE,QAAQ;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,CAAC,CAAC,EAAE,QAAQ;YAChB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ;YACvB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,CAAC,EAAE,QAAQ;YACf,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ;YACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ;YACzB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ;YAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ;YAC7B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;YACjC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ;YACtB,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ;YACzB,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,QAAQ,CAAC,EAAE,EAAE,QAAQ;YACnB,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ;YAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,OAAO;QACL,EAAE;QACF,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,UAAU;YACR,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/src/api.d.ts

@@ -0,0 +1,87 @@
+export interface ITtscApi {
+    /** Build metadata reported by the wasm. Useful for diagnostics. */
+    version(): ITtscVersion;
+    /** Compile a project: typecheck + emit. `result` is JSON; `parseResult<ITtscCompileResult>` deserializes it. */
+    build(opts: ITtscBuildOpts): Promise<ITtscResult>;
+    /** Typecheck without emit. `result` is JSON; `parseResult<ITtscCompileResult>` deserializes it. */
+    check(opts: ITtscBuildOpts): Promise<ITtscResult>;
+    /**
+     * Return every source file the program saw, keyed by project-relative
+     * path. Used by playgrounds that want to render the TypeScript view after
+     * a source rewriter (e.g. paths) has run. `result` is JSON; use
+     * `parseResult<ITtscTransformResult>` to deserialize.
+     */
+    transform(opts: ITtscBuildOpts): Promise<ITtscResult>;
+    /**
+     * Dispatch a registered plugin's subcommand. Returns the captured stdout /
+     * stderr (the same streams the native sidecar binary would write to)
+     * together with the exit code.
+     */
+    plugin(opts: ITtscPluginOpts): Promise<ITtscResult>;
+    /** Names of the plugins this wasm was built with. */
+    plugins(): string[];
+}
+export interface ITtscVersion {
+    version: string;
+    commit: string;
+    date: string;
+    go: string;
+    goos: string;
+    goarch: string;
+}
+export interface ITtscBuildOpts {
+    /** Absolute virtual path the project lives at inside the MemFS. */
+    cwd: string;
+    /** tsconfig path, relative to `cwd`. Defaults to `tsconfig.json`. */
+    tsconfig?: string;
+}
+export interface ITtscPluginOpts {
+    /** Plugin id registered with `host.Expose` (e.g. `@ttsc/banner`). */
+    name: string;
+    /** Subcommand the plugin's Run will receive (e.g. `build`). */
+    command: string;
+    /** Forwarded as `--cwd=<value>`. */
+    cwd?: string;
+    /** Forwarded as `--tsconfig=<value>`. Defaults to `tsconfig.json`. */
+    tsconfig?: string;
+    /** Any extra key/value pairs map to `--key=value` argv entries. */
+    [key: string]: string | boolean | number | undefined;
+}
+export interface ITtscResult {
+    /** Exit code. 0 = success, 2 = usage error, 3 = runtime error. */
+    code: number;
+    /** Anything the wasm wrote to its stdout stream. */
+    stdout: string;
+    /** Anything the wasm wrote to its stderr stream. */
+    stderr: string;
+    /**
+     * For the base endpoints, the JSON-encoded compile/transform result. For
+     * the plugin endpoint, this is empty — the plugin's own output sits in
+     * stdout/stderr. Use `parseResult<T>` to deserialize.
+     */
+    result: string;
+}
+export interface ITtscCompileResult {
+    diagnostics?: ITtscDiagnostic[];
+    output: Record<string, string>;
+}
+export interface ITtscTransformResult {
+    diagnostics?: ITtscDiagnostic[];
+    typescript: Record<string, string>;
+}
+export interface ITtscDiagnostic {
+    file: string | null;
+    category: "error" | "warning";
+    code: number;
+    start?: number;
+    length?: number;
+    line?: number;
+    character?: number;
+    messageText: string;
+}
+/**
+ * Parse the `result` field of an ITtscResult into the structured payload.
+ * The wasm returns JSON as a string because js.ValueOf does not handle large
+ * nested maps efficiently. Callers JSON.parse exactly once at the boundary.
+ */
+export declare function parseResult<T>(result: ITtscResult): T | null;

package/lib/src/api.js

@@ -0,0 +1,20 @@
+// Type-safe wrapper around the `globalThis[apiName]` object a host-built wasm
+// installs. Every consumer wasm (the base `ttsc.wasm`, the website's
+// `playground.wasm`, typia's `ttsc-typia.wasm`) exposes the same surface, so
+// one set of types covers them all.
+/**
+ * Parse the `result` field of an ITtscResult into the structured payload.
+ * The wasm returns JSON as a string because js.ValueOf does not handle large
+ * nested maps efficiently. Callers JSON.parse exactly once at the boundary.
+ */
+export function parseResult(result) {
+    if (!result.result)
+        return null;
+    try {
+        return JSON.parse(result.result);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=api.js.map

package/lib/src/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,oCAAoC;AAgGpC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAI,MAAmB;IAChD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAM,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/src/index.d.ts

@@ -0,0 +1,6 @@
+export { bootTtsc } from "./instantiate";
+export type { IBootTtscOptions, IBootResult } from "./instantiate";
+export { createMemFS, MemFSError } from "./MemFS";
+export type { IMemFSHost, IWasmExecFS, IFileStats, } from "./MemFS";
+export type { ITtscApi, ITtscVersion, ITtscBuildOpts, ITtscPluginOpts, ITtscResult, ITtscCompileResult, ITtscTransformResult, ITtscDiagnostic, } from "./api";
+export { parseResult } from "./api";

package/lib/src/index.js

@@ -0,0 +1,10 @@
+// Public entry point for `@ttsc/wasm`.
+//
+// Re-exports the boot helper, MemFS bridge, and typed API surface. Plugin
+// authors and playground builders consume these. The Go-side scaffolding
+// (`host/`) is shipped alongside on disk but loaded via `go build`, not
+// imported from JS.
+export { bootTtsc } from "./instantiate";
+export { createMemFS, MemFSError } from "./MemFS";
+export { parseResult } from "./api";
+//# sourceMappingURL=index.js.map

package/lib/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,oBAAoB;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBlD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/lib/src/instantiate.d.ts

@@ -0,0 +1,27 @@
+import { type IMemFSHost } from "./MemFS";
+import type { ITtscApi } from "./api";
+export interface IBootTtscOptions {
+    /** URL of the .wasm to fetch. */
+    wasmUrl: string;
+    /** URL of wasm_exec.js. Defaults to the same directory as wasmUrl. */
+    wasmExecUrl?: string;
+    /**
+     * globalThis property name the wasm binds. Must match the value the wasm
+     * was built with (the `apiName` passed to `host.Expose`). Defaults to
+     * "ttsc".
+     */
+    apiName?: string;
+    /**
+     * Optional pre-existing MemFS host. When omitted, a fresh one is created
+     * and stored on the returned BootResult. Pass an existing host when you
+     * want to boot multiple wasms over the same filesystem (e.g. base ttsc +
+     * a typia wasm) so they share project sources.
+     */
+    host?: IMemFSHost;
+}
+export interface IBootResult {
+    api: ITtscApi;
+    host: IMemFSHost;
+}
+/** Boot a host-built wasm. Re-entrant only if you reuse the same `host`. */
+export declare function bootTtsc(options: IBootTtscOptions): Promise<IBootResult>;

package/lib/src/instantiate.js

@@ -0,0 +1,71 @@
+// Boots a host-built wasm and returns the JS-side handle.
+//
+// Order of operations matters: wasm_exec.js installs default no-op fs/process
+// shims if `globalThis.fs` is missing at load time, so we must install our
+// MemFS BEFORE importing wasm_exec.js.
+//
+// The boot helper is parameterized by `apiName` so any wasm built with
+// `host.Expose(...)` can be loaded the same way. The base wasm uses "ttsc";
+// downstream consumers pick their own (e.g. "ttscPlayground", "ttscTypia").
+import { createMemFS } from "./MemFS";
+/** Boot a host-built wasm. Re-entrant only if you reuse the same `host`. */
+export async function bootTtsc(options) {
+    const wasmUrl = options.wasmUrl;
+    const wasmExecUrl = options.wasmExecUrl ?? defaultWasmExecUrl(wasmUrl);
+    const apiName = options.apiName ?? "ttsc";
+    const host = options.host ?? createMemFS();
+    const globalAny = globalThis;
+    // Only install fs / process if they aren't already in place. A caller
+    // booting a second wasm over the same MemFS reuses the same shims.
+    if (!globalAny.fs)
+        globalAny.fs = host.fs;
+    if (!globalAny.process)
+        globalAny.process = createProcessShim();
+    // wasm_exec.js installs `globalThis.Go`. It also reads globalThis.fs at
+    // module-eval time, so this import must follow the assignment above.
+    importScripts(wasmExecUrl);
+    const ready = new Promise((resolve) => {
+        globalAny[apiName + "Ready"] = resolve;
+    });
+    const goCtor = globalAny.Go;
+    const go = new goCtor();
+    const response = await fetch(wasmUrl);
+    if (!response.ok) {
+        throw new Error(`bootTtsc: failed to fetch ${wasmUrl}: ${response.status}`);
+    }
+    const wasm = await WebAssembly.instantiateStreaming(response, go.importObject);
+    // go.run never resolves until the wasm exits; we don't await it.
+    void go.run(wasm.instance);
+    await ready;
+    const api = globalAny[apiName];
+    if (!api)
+        throw new Error(`bootTtsc: ${apiName} global was not set — was the wasm built with host.Expose(${JSON.stringify(apiName)}, ...)?`);
+    return { api, host };
+}
+function defaultWasmExecUrl(wasmUrl) {
+    const slash = wasmUrl.lastIndexOf("/");
+    if (slash < 0)
+        return "wasm_exec.js";
+    return wasmUrl.slice(0, slash + 1) + "wasm_exec.js";
+}
+function createProcessShim() {
+    return {
+        getuid: () => -1,
+        getgid: () => -1,
+        geteuid: () => -1,
+        getegid: () => -1,
+        getgroups: () => {
+            throw new Error("not implemented");
+        },
+        pid: -1,
+        ppid: -1,
+        umask: () => {
+            throw new Error("not implemented");
+        },
+        cwd: () => "/",
+        chdir: () => {
+            /* no-op; the workspace lives inside the MemFS */
+        },
+    };
+}
+//# sourceMappingURL=instantiate.js.map

package/lib/src/instantiate.js.map

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