@ttsc/wasm 0.22.0 → 0.23.0

package/README.md

@@ -100,9 +100,12 @@ The `version`, `commit`, and `date` variables in `host/host.go` are all overrida
 ```ts
 import { bootTtsc } from "@ttsc/wasm";
 
+const controller = new AbortController();
 const { api, host } = await bootTtsc({
   wasmUrl: "/your.wasm",
   apiName: "yourApi",
+  signal: controller.signal,
+  timeoutMs: 60_000,
 });
 
 host.writeFile("/work/tsconfig.json", '{"compilerOptions":{"strict":true}}');
@@ -112,6 +115,10 @@ const result = await api.build({ cwd: "/work" });
 console.log(result.result); // JSON: { diagnostics, output }
 ```
 
+`timeoutMs` defaults to 60 seconds and covers serialization behind an earlier boot, fetch, instantiation, and the Go readiness signal. A caller abort or deadline cancels the shared in-flight boot. Failures before `go.run` clear cache and callback state so a later call can retry. `importScripts` is synchronous, so cancellation is observed immediately before and after that call but cannot interrupt the script while it evaluates.
+
+Once `go.run` starts, JavaScript cannot terminate the Go wasm runtime. A boot failure from that point throws `BootTtscWorkerTerminationError` with code `TTSC_WASM_WORKER_TERMINATION_REQUIRED`, and later boots for the same `apiName` reject without installing another readiness bridge. Terminate and replace that Worker before retrying.
+
 Booting two wasms with the same `apiName` overwrites the previous global binding; pick a unique `apiName` per binary. `bootTtsc` also installs shared `fs` and `process` globals in its Worker, so use separate Workers when binaries need independent filesystems.
 
 ## Fountain API (snapshot, AST, type checker)

package/dist/.ttsc-wasm-build.json

@@ -1,11 +1,11 @@
 {
   "schema": 1,
-  "identity": "6f7894fab98969ad707bca087ef102735838475dab17f07554d00a2c9772b9c7",
+  "identity": "15c3bdce6daf77fd832027479abe7265e38699a6764b718d30a441bed7cb9266",
   "artifacts": [
     {
       "path": "/home/runner/work/ttsc/ttsc/packages/wasm/dist/ttsc.wasm",
       "type": "file",
-      "sha256": "db5fb453c335d95e128c3c94f0255549c998aa3999332bb910e07016f8204ad5"
+      "sha256": "fe7a63d35504171ee8e7183bdf1581a9fe13ca619639c48121a239275c91abb7"
     },
     {
       "path": "/home/runner/work/ttsc/ttsc/packages/wasm/dist/wasm_exec.js",

package/lib/src/BootTtscWorkerTerminationError.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A boot failure that requires replacing the current Web Worker.
+ *
+ * Once `go.run` starts, JavaScript cannot stop that Go runtime. Retrying the
+ * same API name in the same Worker would install a new readiness bridge that
+ * the stale runtime could invoke, so `bootTtsc` terminally rejects later boots
+ * until the caller terminates the Worker.
+ */
+export declare class BootTtscWorkerTerminationError extends Error {
+    static readonly CODE = "TTSC_WASM_WORKER_TERMINATION_REQUIRED";
+    readonly apiName: string;
+    readonly code = "TTSC_WASM_WORKER_TERMINATION_REQUIRED";
+    readonly cause: unknown;
+    constructor(apiName: string, cause: unknown);
+}

package/lib/src/BootTtscWorkerTerminationError.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BootTtscWorkerTerminationError = void 0;
+/**
+ * A boot failure that requires replacing the current Web Worker.
+ *
+ * Once `go.run` starts, JavaScript cannot stop that Go runtime. Retrying the
+ * same API name in the same Worker would install a new readiness bridge that
+ * the stale runtime could invoke, so `bootTtsc` terminally rejects later boots
+ * until the caller terminates the Worker.
+ */
+class BootTtscWorkerTerminationError extends Error {
+    static CODE = "TTSC_WASM_WORKER_TERMINATION_REQUIRED";
+    apiName;
+    code = BootTtscWorkerTerminationError.CODE;
+    cause;
+    constructor(apiName, cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? "boot failed");
+        super(`[${BootTtscWorkerTerminationError.CODE}] ${causeMessage} bootTtsc: the ${apiName} Go runtime already started; terminate and replace this Worker before retrying.`);
+        this.name = "BootTtscWorkerTerminationError";
+        this.apiName = apiName;
+        this.cause = cause;
+    }
+}
+exports.BootTtscWorkerTerminationError = BootTtscWorkerTerminationError;
+//# sourceMappingURL=BootTtscWorkerTerminationError.js.map

package/lib/src/BootTtscWorkerTerminationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BootTtscWorkerTerminationError.js","sourceRoot":"","sources":["../../src/BootTtscWorkerTerminationError.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,oCAA4C,SAAQ,KAAK;IAChD,MAAM,CAAU,IAAI,GAAG,uCAAuC,CAAC;IAEtD,OAAO,CAAS;IAChB,IAAI,GAAG,8BAA8B,CAAC,IAAI,CAAC;IAClC,KAAK,CAAU;IAExC,YAAmB,OAAe,EAAE,KAAc;QAChD,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QAC1E,KAAK,CACH,IAAI,8BAA8B,CAAC,IAAI,KAAK,YAAY,kBAAkB,OAAO,iFAAiF,CACnK,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/lib/src/bootTtsc.d.ts

@@ -1,13 +1,17 @@
 import type { IBootResult } from "./structures/IBootResult";
 import type { IBootTtscOptions } from "./structures/IBootTtscOptions";
+/** Finite default for queueing, fetch, instantiation, and Go readiness. */
+export declare const DEFAULT_BOOT_TIMEOUT_MS = 60000;
 /**
  * Boot a host-built wasm. Re-entrant only if you reuse the same `host`.
  *
  * Concurrent calls with the same `(apiName, wasmUrl)` pair share the same
  * in-flight boot. Calls with the same `apiName` but different `wasmUrl` are
  * serialized via `bootChainByApiName` so they don't race on the shared
- * `globalThis[apiName+"Ready"]` resolver slot. On rejection the cache entries
- * are cleared so the next call retries from scratch.
+ * `globalThis[apiName+"Ready"]` resolver slot. A rejection before `go.run`
+ * clears the cache entries so the next call can retry from scratch. A rejection
+ * after `go.run` terminally poisons that API name because JavaScript cannot
+ * stop the old runtime; replace the Worker before retrying.
  *
  * **Single-Worker caveat.** Even with the chain, a second boot loaded into the
  * SAME Worker after a first boot completes will overlay its Go runtime on top

package/lib/src/bootTtsc.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BOOT_TIMEOUT_MS = void 0;
 exports.bootTtsc = bootTtsc;
 // Boots a host-built wasm and returns the JS-side handle.
 //
@@ -10,16 +11,15 @@ exports.bootTtsc = bootTtsc;
 // 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").
+const BootTtscWorkerTerminationError_1 = require("./BootTtscWorkerTerminationError");
 const createMemFS_1 = require("./createMemFS");
+const bootsInFlight = new Map();
 /**
- * Per-(apiName, wasmUrl) single-flight cache for boots. Keying on apiName alone
- * would let a second call with the same apiName but a different wasmUrl
- * silently return the cached IBootResult of the first wasm — the caller would
- * think they booted a fresh binary while the cached one stayed in place. The
- * composite key lets HMR / cache-busting query strings get a fresh boot while
- * still single-flighting genuine concurrent duplicate calls.
+ * Terminal failures keyed by the global API bridge they own. A failed runtime
+ * cannot be stopped after `go.run` starts, so no later boot may install another
+ * readiness bridge for that API name inside the same Worker.
  */
-const bootsInFlight = new Map();
+const terminalBootFailuresByApiName = new Map();
 /**
  * Per-apiName serialization chain. Two concurrent boots with the same apiName
  * but different wasmUrls each install their own `globalThis[apiName
@@ -29,6 +29,8 @@ const bootsInFlight = new Map();
  *   Go-side`Ready.Invoke()` always lands on the resolver that boot installed.
  */
 const bootChainByApiName = new Map();
+/** Finite default for queueing, fetch, instantiation, and Go readiness. */
+exports.DEFAULT_BOOT_TIMEOUT_MS = 60_000;
 function bootKey(apiName, wasmUrl) {
     return `${apiName}|${resolveWasmUrl(wasmUrl)}`;
 }
@@ -54,8 +56,10 @@ function resolveWasmUrl(wasmUrl) {
  * Concurrent calls with the same `(apiName, wasmUrl)` pair share the same
  * in-flight boot. Calls with the same `apiName` but different `wasmUrl` are
  * serialized via `bootChainByApiName` so they don't race on the shared
- * `globalThis[apiName+"Ready"]` resolver slot. On rejection the cache entries
- * are cleared so the next call retries from scratch.
+ * `globalThis[apiName+"Ready"]` resolver slot. A rejection before `go.run`
+ * clears the cache entries so the next call can retry from scratch. A rejection
+ * after `go.run` terminally poisons that API name because JavaScript cannot
+ * stop the old runtime; replace the Worker before retrying.
  *
  * **Single-Worker caveat.** Even with the chain, a second boot loaded into the
  * SAME Worker after a first boot completes will overlay its Go runtime on top
@@ -69,30 +73,54 @@ function resolveWasmUrl(wasmUrl) {
 function bootTtsc(options) {
     const apiName = options.apiName ?? "ttsc";
     const key = bootKey(apiName, options.wasmUrl);
+    const timeoutMs = resolveBootTimeout(options.timeoutMs);
+    const terminalFailure = terminalBootFailuresByApiName.get(apiName);
+    if (terminalFailure)
+        return Promise.reject(terminalFailure);
     const inflight = bootsInFlight.get(key);
-    if (inflight)
-        return inflight;
+    if (inflight) {
+        attachBootCancellation(inflight, options.signal, timeoutMs);
+        return inflight.promise;
+    }
+    const controller = new AbortController();
     const prior = bootChainByApiName.get(apiName) ?? Promise.resolve();
-    const promise = prior
+    const queuedCancellation = createBootCancellationPromise(controller.signal, apiName, () => "waiting for an earlier boot");
+    const queued = prior
         .catch(() => {
         /* don't propagate a prior boot's rejection — let this one run */
     })
-        .then(() => bootTtscOnce(options, apiName))
+        .then(() => {
+        throwIfBootWorkerTerminated(apiName);
+        throwIfBootCanceled(controller.signal, apiName, "waiting for an earlier boot");
+        queuedCancellation.dispose();
+        return bootTtscOnce(options, apiName, controller.signal);
+    });
+    let entry;
+    const promise = Promise.race([queued, queuedCancellation.promise])
         .catch((err) => {
-        bootsInFlight.delete(key);
+        if (bootsInFlight.get(key) === entry)
+            bootsInFlight.delete(key);
         throw err;
-    });
-    bootsInFlight.set(key, promise);
+    })
+        .finally(queuedCancellation.dispose);
+    entry = { controller, promise };
+    bootsInFlight.set(key, entry);
+    attachBootCancellation(entry, options.signal, timeoutMs);
     // Track the chain head for this apiName so the next boot waits on it.
     // Swallow on the chain head specifically: we already throw to the
     // immediate caller; surfacing it through the chain would reject every
     // subsequent boot just because this one failed.
-    bootChainByApiName.set(apiName, promise.catch(() => { }));
+    bootChainByApiName.set(apiName, queued.catch(() => { }));
     return promise;
 }
-async function bootTtscOnce(options, apiName) {
+async function bootTtscOnce(options, apiName, signal) {
     const wasmUrl = options.wasmUrl;
     const wasmExecUrl = options.wasmExecUrl ?? defaultWasmExecUrl(wasmUrl);
+    let phase = "preparing the wasm host";
+    const cancellation = createBootCancellationPromise(signal, apiName, () => phase);
+    let readyCb;
+    let failedCb;
+    let runtimeStarted = false;
     const host = options.host ?? (0, createMemFS_1.createMemFS)();
     const globalAny = globalThis;
     // Install fs / process only if they aren't already in place, and remember
@@ -123,14 +151,18 @@ async function bootTtscOnce(options, apiName) {
             delete globalAny.process;
     };
     try {
+        throwIfBootCanceled(signal, apiName, phase);
         // wasm_exec.js installs `globalThis.Go`. It also reads globalThis.fs at
         // module-eval time, so this import must follow the assignment above.
+        phase = `loading ${wasmExecUrl}`;
         importScripts(wasmExecUrl);
+        // importScripts is synchronous and therefore cannot be interrupted while
+        // the script evaluates. Observe a cancellation that arrived around that
+        // boundary before starting any asynchronous work.
+        throwIfBootCanceled(signal, apiName, phase);
         // Race the Ready resolver against a Failed signal so a wasm-side fault
         // (e.g. `host.Expose` refusing a duplicate call) surfaces here instead of
         // hanging on `await ready` forever.
-        let readyCb;
-        let failedCb;
         const ready = new Promise((resolve, reject) => {
             readyCb = () => {
                 delete globalAny[apiName + "Failed"];
@@ -148,11 +180,13 @@ async function bootTtscOnce(options, apiName) {
             throw new Error(`bootTtsc: globalThis.Go was not installed by ${wasmExecUrl} — the file may not have loaded (CSP block, wrong content type, 404), or it is not the wasm_exec.js shipped with the Go toolchain.`);
         }
         const go = new goCtor();
-        const response = await fetch(wasmUrl);
+        phase = `fetching ${wasmUrl}`;
+        const response = await raceBootCancellation(fetch(wasmUrl, { signal }), cancellation.promise, signal, apiName, () => phase);
         if (!response.ok) {
             throw new Error(`bootTtsc: failed to fetch ${wasmUrl}: ${response.status}`);
         }
-        const wasm = await WebAssembly.instantiateStreaming(response, go.importObject);
+        phase = `instantiating ${wasmUrl}`;
+        const wasm = await raceBootCancellation(WebAssembly.instantiateStreaming(response, go.importObject), cancellation.promise, signal, apiName, () => phase);
         // A normal host keeps `go.run` pending forever after signaling Ready, so a
         // settlement (fulfil OR reject) BEFORE Ready means the Go runtime exited or
         // panicked before it could register — e.g. an early `host.Expose` panic
@@ -161,6 +195,7 @@ async function bootTtscOnce(options, apiName) {
         // The standard Go runner discards the exit code, so an unknown early exit
         // can only synthesize a generic message; known host validation failures
         // reject through Failed above and keep their original cause.
+        runtimeStarted = true;
         const runPromise = Promise.resolve(go.run(wasm.instance));
         const earlyExit = runPromise.then(() => {
             throw new Error(`bootTtsc: the ${apiName} wasm runtime exited before signaling readiness (the host may have panicked; check the wasm stderr).`);
@@ -171,17 +206,8 @@ async function bootTtscOnce(options, apiName) {
         // must not surface as an unhandled rejection. Attach a terminal handler to
         // the losing branch.
         earlyExit.catch(() => { });
-        try {
-            await Promise.race([ready, earlyExit]);
-        }
-        finally {
-            // Drop this attempt's readiness bridge so a later boot for the same
-            // apiName installs a clean pair and no stale resolver survives.
-            if (globalAny[apiName + "Ready"] === readyCb)
-                delete globalAny[apiName + "Ready"];
-            if (globalAny[apiName + "Failed"] === failedCb)
-                delete globalAny[apiName + "Failed"];
-        }
+        phase = `waiting for ${apiName} readiness`;
+        await raceBootCancellation(Promise.race([ready, earlyExit]), cancellation.promise, signal, apiName, () => phase);
         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)}, ...)?`);
@@ -189,8 +215,111 @@ async function bootTtscOnce(options, apiName) {
     }
     catch (err) {
         restoreGlobals();
+        if (runtimeStarted)
+            throw poisonBootWorker(apiName, err);
         throw err;
     }
+    finally {
+        cancellation.dispose();
+        // Drop this attempt's readiness bridge on every path so failed fetches,
+        // instantiation failures, and cancellations cannot poison the next boot.
+        if (globalAny[apiName + "Ready"] === readyCb)
+            delete globalAny[apiName + "Ready"];
+        if (globalAny[apiName + "Failed"] === failedCb)
+            delete globalAny[apiName + "Failed"];
+    }
+}
+function throwIfBootWorkerTerminated(apiName) {
+    const failure = terminalBootFailuresByApiName.get(apiName);
+    if (failure)
+        throw failure;
+}
+function poisonBootWorker(apiName, cause) {
+    const existing = terminalBootFailuresByApiName.get(apiName);
+    if (existing)
+        return existing;
+    const failure = new BootTtscWorkerTerminationError_1.BootTtscWorkerTerminationError(apiName, cause);
+    terminalBootFailuresByApiName.set(apiName, failure);
+    return failure;
+}
+function resolveBootTimeout(timeoutMs) {
+    const value = timeoutMs ?? exports.DEFAULT_BOOT_TIMEOUT_MS;
+    if (!Number.isSafeInteger(value) || value <= 0 || value > 2_147_483_647)
+        throw new RangeError("bootTtsc: timeoutMs must be a positive integer no greater than 2147483647.");
+    return value;
+}
+/**
+ * Couple every caller's cancellation policy to the shared single-flight. A
+ * duplicate caller is joining the same mutable boot, so its cancellation
+ * cancels that shared attempt rather than pretending only one waiter left.
+ */
+function attachBootCancellation(entry, callerSignal, timeoutMs) {
+    const abortFromCaller = () => {
+        if (!entry.controller.signal.aborted)
+            entry.controller.abort({
+                kind: "abort",
+                reason: callerSignal?.reason,
+            });
+    };
+    if (callerSignal?.aborted)
+        abortFromCaller();
+    else
+        callerSignal?.addEventListener("abort", abortFromCaller, { once: true });
+    const timer = setTimeout(() => {
+        if (!entry.controller.signal.aborted)
+            entry.controller.abort({
+                kind: "timeout",
+                timeoutMs,
+            });
+    }, timeoutMs);
+    const cleanup = () => {
+        clearTimeout(timer);
+        callerSignal?.removeEventListener("abort", abortFromCaller);
+    };
+    void entry.promise.then(cleanup, cleanup);
+}
+function createBootCancellationPromise(signal, apiName, getPhase) {
+    let rejectCancellation;
+    const promise = new Promise((_resolve, reject) => {
+        rejectCancellation = reject;
+    });
+    // Some synchronous boundaries observe cancellation with throwIfBootCanceled
+    // before a Promise.race consumes this branch. Keep that rejection owned.
+    void promise.catch(() => { });
+    const onAbort = () => {
+        rejectCancellation(bootCancellationError(signal, apiName, getPhase()));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    if (signal.aborted)
+        onAbort();
+    return {
+        promise,
+        dispose: () => signal.removeEventListener("abort", onAbort),
+    };
+}
+async function raceBootCancellation(work, cancellation, signal, apiName, getPhase) {
+    try {
+        return await Promise.race([work, cancellation]);
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw bootCancellationError(signal, apiName, getPhase());
+        throw error;
+    }
+}
+function throwIfBootCanceled(signal, apiName, phase) {
+    if (signal.aborted)
+        throw bootCancellationError(signal, apiName, phase);
+}
+function bootCancellationError(signal, apiName, phase) {
+    const reason = signal.reason;
+    if (reason?.kind === "timeout")
+        return new Error(`bootTtsc: timed out after ${reason.timeoutMs}ms while ${phase} for ${apiName}.`);
+    const error = new Error(`bootTtsc: aborted while ${phase} for ${apiName}.`);
+    const cause = reason?.kind === "abort" ? reason.reason : signal.reason;
+    if (cause !== undefined)
+        error.cause = cause;
+    return error;
 }
 /**
  * Derive the `wasm_exec.js` URL from the wasm URL by replacing the filename.

package/lib/src/bootTtsc.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootTtsc.js","sourceRoot":"","sources":["../../src/bootTtsc.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,uCAAuC;AACvC,EAAE;AACF,uEAAuE;AACvE,4EAA4E;AAC5E,4EAA4E;AAC5E,+CAA4C;AAO5C;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA4B,CAAC;AAE/D,SAAS,OAAO,CAAC,OAAe,EAAE,OAAe;IAC/C,OAAO,GAAG,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,GACR,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;QACpE,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,kBAAyB,OAAyB;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACnE,MAAM,OAAO,GAAG,KAAK;SAClB,KAAK,CAAC,GAAG,EAAE;QACV,iEAAiE;IACnE,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;SAC1C,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACL,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChC,sEAAsE;IACtE,kEAAkE;IAClE,sEAAsE;IACtE,gDAAgD;IAChD,kBAAkB,CAAC,GAAG,CACpB,OAAO,EACP,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CACxB,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAyB,EACzB,OAAe;IAEf,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAA,yBAAW,GAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,UAAqC,CAAC;IACxD,0EAA0E;IAC1E,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;IAClC,MAAM,gBAAgB,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;IAC5C,IAAI,WAAoB,CAAC;IACzB,IAAI,WAAW;QAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACxC,IAAI,gBAAgB,EAAE,CAAC;QACrB,WAAW,GAAG,iBAAiB,EAAE,CAAC;QAClC,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC;IAClC,CAAC;IAED,uEAAuE;IACvE,8EAA8E;IAC9E,qEAAqE;IACrE,8EAA8E;IAC9E,iDAAiD;IACjD,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,IAAI,WAAW,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC,EAAE,CAAC;QACjE,IAAI,gBAAgB,IAAI,SAAS,CAAC,OAAO,KAAK,WAAW;YACvD,OAAO,SAAS,CAAC,OAAO,CAAC;IAC7B,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,wEAAwE;QACxE,qEAAqE;QACrE,aAAa,CAAC,WAAW,CAAC,CAAC;QAE3B,uEAAuE;QACvE,0EAA0E;QAC1E,oCAAoC;QACpC,IAAI,OAAoB,CAAC;QACzB,IAAI,QAAiC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,OAAO,GAAG,GAAG,EAAE;gBACb,OAAO,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;gBACrC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,QAAQ,GAAG,CAAC,GAAY,EAAE,EAAE;gBAC1B,OAAO,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;gBACpC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC,CAAC;YACF,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;YACvC,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAI,SAA4C,CAAC,EAAE,CAAC;QAChE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,gDAAgD,WAAW,oIAAoI,CAChM,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,KAAK,QAAQ,CAAC,MAAM,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,oBAAoB,CACjD,QAAQ,EACR,EAAE,CAAC,YAAY,CAChB,CAAC;QAEF,2EAA2E;QAC3E,4EAA4E;QAC5E,wEAAwE;QACxE,qEAAqE;QACrE,6EAA6E;QAC7E,0EAA0E;QAC1E,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAC/B,GAAG,EAAE;YACH,MAAM,IAAI,KAAK,CACb,iBAAiB,OAAO,sGAAsG,CAC/H,CAAC;QACJ,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;YACf,MAAM,IAAI,KAAK,CACb,iBAAiB,OAAO,oDACtB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;QACJ,CAAC,CACF,CAAC;QACF,2EAA2E;QAC3E,2EAA2E;QAC3E,qBAAqB;QACrB,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QACzC,CAAC;gBAAS,CAAC;YACT,oEAAoE;YACpE,gEAAgE;YAChE,IAAI,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,OAAO;gBAC1C,OAAO,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;YACtC,IAAI,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,QAAQ;gBAC5C,OAAO,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,GAAG,GAAI,SAAkD,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG;YACN,MAAM,IAAI,KAAK,CACb,aAAa,OAAO,6DAA6D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAClH,CAAC;QACJ,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,cAAc,EAAE,CAAC;QACjB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC;IACrC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC;AACtD,CAAC;AAWD;;;;;;;GAOG;AACH,SAAS,iBAAiB;IACxB,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACjB,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,EAAE,CAAC,CAAC;QACP,IAAI,EAAE,CAAC,CAAC;QACR,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG;QACd,KAAK,EAAE,GAAG,EAAE;YACV,iDAAiD;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"bootTtsc.js","sourceRoot":"","sources":["../../src/bootTtsc.ts"],"names":[],"mappings":"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"}

package/lib/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./bootTtsc";
+export * from "./BootTtscWorkerTerminationError";
 export * from "./createMemFS";
 export * from "./MemFSError";
 export * from "./parseResult";

package/lib/src/index.js

@@ -21,6 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./bootTtsc"), exports);
+__exportStar(require("./BootTtscWorkerTerminationError"), exports);
 __exportStar(require("./createMemFS"), exports);
 __exportStar(require("./MemFSError"), exports);
 __exportStar(require("./parseResult"), exports);

package/lib/src/index.js.map

@@ -1 +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,6CAA2B;AAC3B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,qDAAmC"}
+{"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,6CAA2B;AAC3B,mEAAiD;AACjD,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,qDAAmC"}

package/lib/src/structures/IBootTtscOptions.d.ts

@@ -3,6 +3,17 @@ import type { IMemFSHost } from "./IMemFSHost";
 export interface IBootTtscOptions {
     /** URL of the .wasm to fetch. */
     wasmUrl: string;
+    /** Cancel this boot attempt, including a shared in-flight attempt. */
+    signal?: AbortSignal;
+    /**
+     * Maximum initialization time in milliseconds. Defaults to 60 seconds.
+     *
+     * The deadline covers queued, fetch, instantiate, and readiness phases.
+     * `importScripts` is synchronous and can only observe cancellation before or
+     * after it returns. A failure after `go.run` starts requires terminating the
+     * Worker; later boots of the same API name reject terminally.
+     */
+    timeoutMs?: number;
     /** URL of wasm_exec.js. Defaults to the same directory as wasmUrl. */
     wasmExecUrl?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/wasm",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Build in-browser ttsc playgrounds. Compose ttsc + typescript-go with your own plugins via the Go host helper.",
   "main": "lib/src/index.js",
   "types": "lib/src/index.d.ts",

package/src/BootTtscWorkerTerminationError.ts

@@ -0,0 +1,26 @@
+/**
+ * A boot failure that requires replacing the current Web Worker.
+ *
+ * Once `go.run` starts, JavaScript cannot stop that Go runtime. Retrying the
+ * same API name in the same Worker would install a new readiness bridge that
+ * the stale runtime could invoke, so `bootTtsc` terminally rejects later boots
+ * until the caller terminates the Worker.
+ */
+export class BootTtscWorkerTerminationError extends Error {
+  public static readonly CODE = "TTSC_WASM_WORKER_TERMINATION_REQUIRED";
+
+  public readonly apiName: string;
+  public readonly code = BootTtscWorkerTerminationError.CODE;
+  public override readonly cause: unknown;
+
+  public constructor(apiName: string, cause: unknown) {
+    const causeMessage =
+      cause instanceof Error ? cause.message : String(cause ?? "boot failed");
+    super(
+      `[${BootTtscWorkerTerminationError.CODE}] ${causeMessage} bootTtsc: the ${apiName} Go runtime already started; terminate and replace this Worker before retrying.`,
+    );
+    this.name = "BootTtscWorkerTerminationError";
+    this.apiName = apiName;
+    this.cause = cause;
+  }
+}

package/src/bootTtsc.ts

@@ -7,6 +7,7 @@
 // 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 { BootTtscWorkerTerminationError } from "./BootTtscWorkerTerminationError";
 import { createMemFS } from "./createMemFS";
 import type { IBootResult } from "./structures/IBootResult";
 import type { IBootTtscOptions } from "./structures/IBootTtscOptions";
@@ -22,7 +23,28 @@ declare const importScripts: (...urls: string[]) => void;
  * composite key lets HMR / cache-busting query strings get a fresh boot while
  * still single-flighting genuine concurrent duplicate calls.
  */
-const bootsInFlight = new Map<string, Promise<IBootResult>>();
+interface BootInFlight {
+  controller: AbortController;
+  promise: Promise<IBootResult>;
+}
+
+interface BootCancellationReason {
+  kind: "abort" | "timeout";
+  reason?: unknown;
+  timeoutMs?: number;
+}
+
+const bootsInFlight = new Map<string, BootInFlight>();
+
+/**
+ * Terminal failures keyed by the global API bridge they own. A failed runtime
+ * cannot be stopped after `go.run` starts, so no later boot may install another
+ * readiness bridge for that API name inside the same Worker.
+ */
+const terminalBootFailuresByApiName = new Map<
+  string,
+  BootTtscWorkerTerminationError
+>();
 
 /**
  * Per-apiName serialization chain. Two concurrent boots with the same apiName
@@ -34,6 +56,9 @@ const bootsInFlight = new Map<string, Promise<IBootResult>>();
  */
 const bootChainByApiName = new Map<string, Promise<unknown>>();
 
+/** Finite default for queueing, fetch, instantiation, and Go readiness. */
+export const DEFAULT_BOOT_TIMEOUT_MS = 60_000;
+
 function bootKey(apiName: string, wasmUrl: string): string {
   return `${apiName}|${resolveWasmUrl(wasmUrl)}`;
 }
@@ -61,8 +86,10 @@ function resolveWasmUrl(wasmUrl: string): string {
  * Concurrent calls with the same `(apiName, wasmUrl)` pair share the same
  * in-flight boot. Calls with the same `apiName` but different `wasmUrl` are
  * serialized via `bootChainByApiName` so they don't race on the shared
- * `globalThis[apiName+"Ready"]` resolver slot. On rejection the cache entries
- * are cleared so the next call retries from scratch.
+ * `globalThis[apiName+"Ready"]` resolver slot. A rejection before `go.run`
+ * clears the cache entries so the next call can retry from scratch. A rejection
+ * after `go.run` terminally poisons that API name because JavaScript cannot
+ * stop the old runtime; replace the Worker before retrying.
  *
  * **Single-Worker caveat.** Even with the chain, a second boot loaded into the
  * SAME Worker after a first boot completes will overlay its Go runtime on top
@@ -76,26 +103,52 @@ function resolveWasmUrl(wasmUrl: string): string {
 export function bootTtsc(options: IBootTtscOptions): Promise<IBootResult> {
   const apiName = options.apiName ?? "ttsc";
   const key = bootKey(apiName, options.wasmUrl);
+  const timeoutMs = resolveBootTimeout(options.timeoutMs);
+  const terminalFailure = terminalBootFailuresByApiName.get(apiName);
+  if (terminalFailure) return Promise.reject(terminalFailure);
   const inflight = bootsInFlight.get(key);
-  if (inflight) return inflight;
+  if (inflight) {
+    attachBootCancellation(inflight, options.signal, timeoutMs);
+    return inflight.promise;
+  }
+  const controller = new AbortController();
   const prior = bootChainByApiName.get(apiName) ?? Promise.resolve();
-  const promise = prior
+  const queuedCancellation = createBootCancellationPromise(
+    controller.signal,
+    apiName,
+    () => "waiting for an earlier boot",
+  );
+  const queued = prior
     .catch(() => {
       /* don't propagate a prior boot's rejection — let this one run */
     })
-    .then(() => bootTtscOnce(options, apiName))
+    .then(() => {
+      throwIfBootWorkerTerminated(apiName);
+      throwIfBootCanceled(
+        controller.signal,
+        apiName,
+        "waiting for an earlier boot",
+      );
+      queuedCancellation.dispose();
+      return bootTtscOnce(options, apiName, controller.signal);
+    });
+  let entry!: BootInFlight;
+  const promise = Promise.race([queued, queuedCancellation.promise])
     .catch((err) => {
-      bootsInFlight.delete(key);
+      if (bootsInFlight.get(key) === entry) bootsInFlight.delete(key);
       throw err;
-    });
-  bootsInFlight.set(key, promise);
+    })
+    .finally(queuedCancellation.dispose);
+  entry = { controller, promise };
+  bootsInFlight.set(key, entry);
+  attachBootCancellation(entry, options.signal, timeoutMs);
   // Track the chain head for this apiName so the next boot waits on it.
   // Swallow on the chain head specifically: we already throw to the
   // immediate caller; surfacing it through the chain would reject every
   // subsequent boot just because this one failed.
   bootChainByApiName.set(
     apiName,
-    promise.catch(() => {}),
+    queued.catch(() => {}),
   );
   return promise;
 }
@@ -103,9 +156,19 @@ export function bootTtsc(options: IBootTtscOptions): Promise<IBootResult> {
 async function bootTtscOnce(
   options: IBootTtscOptions,
   apiName: string,
+  signal: AbortSignal,
 ): Promise<IBootResult> {
   const wasmUrl = options.wasmUrl;
   const wasmExecUrl = options.wasmExecUrl ?? defaultWasmExecUrl(wasmUrl);
+  let phase = "preparing the wasm host";
+  const cancellation = createBootCancellationPromise(
+    signal,
+    apiName,
+    () => phase,
+  );
+  let readyCb: (() => void) | undefined;
+  let failedCb: ((err: unknown) => void) | undefined;
+  let runtimeStarted = false;
 
   const host = options.host ?? createMemFS();
   const globalAny = globalThis as Record<string, unknown>;
@@ -137,15 +200,19 @@ async function bootTtscOnce(
   };
 
   try {
+    throwIfBootCanceled(signal, apiName, phase);
     // wasm_exec.js installs `globalThis.Go`. It also reads globalThis.fs at
     // module-eval time, so this import must follow the assignment above.
+    phase = `loading ${wasmExecUrl}`;
     importScripts(wasmExecUrl);
+    // importScripts is synchronous and therefore cannot be interrupted while
+    // the script evaluates. Observe a cancellation that arrived around that
+    // boundary before starting any asynchronous work.
+    throwIfBootCanceled(signal, apiName, phase);
 
     // Race the Ready resolver against a Failed signal so a wasm-side fault
     // (e.g. `host.Expose` refusing a duplicate call) surfaces here instead of
     // hanging on `await ready` forever.
-    let readyCb!: () => void;
-    let failedCb!: (err: unknown) => void;
     const ready = new Promise<void>((resolve, reject) => {
       readyCb = () => {
         delete globalAny[apiName + "Failed"];
@@ -167,15 +234,26 @@ async function bootTtscOnce(
     }
     const go = new goCtor();
 
-    const response = await fetch(wasmUrl);
+    phase = `fetching ${wasmUrl}`;
+    const response = await raceBootCancellation(
+      fetch(wasmUrl, { signal }),
+      cancellation.promise,
+      signal,
+      apiName,
+      () => phase,
+    );
     if (!response.ok) {
       throw new Error(
         `bootTtsc: failed to fetch ${wasmUrl}: ${response.status}`,
       );
     }
-    const wasm = await WebAssembly.instantiateStreaming(
-      response,
-      go.importObject,
+    phase = `instantiating ${wasmUrl}`;
+    const wasm = await raceBootCancellation(
+      WebAssembly.instantiateStreaming(response, go.importObject),
+      cancellation.promise,
+      signal,
+      apiName,
+      () => phase,
     );
 
     // A normal host keeps `go.run` pending forever after signaling Ready, so a
@@ -186,6 +264,7 @@ async function bootTtscOnce(
     // The standard Go runner discards the exit code, so an unknown early exit
     // can only synthesize a generic message; known host validation failures
     // reject through Failed above and keep their original cause.
+    runtimeStarted = true;
     const runPromise = Promise.resolve(go.run(wasm.instance));
     const earlyExit = runPromise.then(
       () => {
@@ -206,16 +285,14 @@ async function bootTtscOnce(
     // the losing branch.
     earlyExit.catch(() => {});
 
-    try {
-      await Promise.race([ready, earlyExit]);
-    } finally {
-      // Drop this attempt's readiness bridge so a later boot for the same
-      // apiName installs a clean pair and no stale resolver survives.
-      if (globalAny[apiName + "Ready"] === readyCb)
-        delete globalAny[apiName + "Ready"];
-      if (globalAny[apiName + "Failed"] === failedCb)
-        delete globalAny[apiName + "Failed"];
-    }
+    phase = `waiting for ${apiName} readiness`;
+    await raceBootCancellation(
+      Promise.race([ready, earlyExit]),
+      cancellation.promise,
+      signal,
+      apiName,
+      () => phase,
+    );
 
     const api = (globalAny as Record<string, ITtscApi | undefined>)[apiName];
     if (!api)
@@ -225,10 +302,147 @@ async function bootTtscOnce(
     return { api, host };
   } catch (err) {
     restoreGlobals();
+    if (runtimeStarted) throw poisonBootWorker(apiName, err);
     throw err;
+  } finally {
+    cancellation.dispose();
+    // Drop this attempt's readiness bridge on every path so failed fetches,
+    // instantiation failures, and cancellations cannot poison the next boot.
+    if (globalAny[apiName + "Ready"] === readyCb)
+      delete globalAny[apiName + "Ready"];
+    if (globalAny[apiName + "Failed"] === failedCb)
+      delete globalAny[apiName + "Failed"];
+  }
+}
+
+function throwIfBootWorkerTerminated(apiName: string): void {
+  const failure = terminalBootFailuresByApiName.get(apiName);
+  if (failure) throw failure;
+}
+
+function poisonBootWorker(
+  apiName: string,
+  cause: unknown,
+): BootTtscWorkerTerminationError {
+  const existing = terminalBootFailuresByApiName.get(apiName);
+  if (existing) return existing;
+  const failure = new BootTtscWorkerTerminationError(apiName, cause);
+  terminalBootFailuresByApiName.set(apiName, failure);
+  return failure;
+}
+
+interface BootCancellation {
+  promise: Promise<never>;
+  dispose: () => void;
+}
+
+function resolveBootTimeout(timeoutMs: number | undefined): number {
+  const value = timeoutMs ?? DEFAULT_BOOT_TIMEOUT_MS;
+  if (!Number.isSafeInteger(value) || value <= 0 || value > 2_147_483_647)
+    throw new RangeError(
+      "bootTtsc: timeoutMs must be a positive integer no greater than 2147483647.",
+    );
+  return value;
+}
+
+/**
+ * Couple every caller's cancellation policy to the shared single-flight. A
+ * duplicate caller is joining the same mutable boot, so its cancellation
+ * cancels that shared attempt rather than pretending only one waiter left.
+ */
+function attachBootCancellation(
+  entry: BootInFlight,
+  callerSignal: AbortSignal | undefined,
+  timeoutMs: number,
+): void {
+  const abortFromCaller = (): void => {
+    if (!entry.controller.signal.aborted)
+      entry.controller.abort({
+        kind: "abort",
+        reason: callerSignal?.reason,
+      } satisfies BootCancellationReason);
+  };
+  if (callerSignal?.aborted) abortFromCaller();
+  else callerSignal?.addEventListener("abort", abortFromCaller, { once: true });
+
+  const timer = setTimeout(() => {
+    if (!entry.controller.signal.aborted)
+      entry.controller.abort({
+        kind: "timeout",
+        timeoutMs,
+      } satisfies BootCancellationReason);
+  }, timeoutMs);
+  const cleanup = (): void => {
+    clearTimeout(timer);
+    callerSignal?.removeEventListener("abort", abortFromCaller);
+  };
+  void entry.promise.then(cleanup, cleanup);
+}
+
+function createBootCancellationPromise(
+  signal: AbortSignal,
+  apiName: string,
+  getPhase: () => string,
+): BootCancellation {
+  let rejectCancellation!: (error: Error) => void;
+  const promise = new Promise<never>((_resolve, reject) => {
+    rejectCancellation = reject;
+  });
+  // Some synchronous boundaries observe cancellation with throwIfBootCanceled
+  // before a Promise.race consumes this branch. Keep that rejection owned.
+  void promise.catch(() => {});
+  const onAbort = (): void => {
+    rejectCancellation(bootCancellationError(signal, apiName, getPhase()));
+  };
+  signal.addEventListener("abort", onAbort, { once: true });
+  if (signal.aborted) onAbort();
+  return {
+    promise,
+    dispose: () => signal.removeEventListener("abort", onAbort),
+  };
+}
+
+async function raceBootCancellation<T>(
+  work: Promise<T>,
+  cancellation: Promise<never>,
+  signal: AbortSignal,
+  apiName: string,
+  getPhase: () => string,
+): Promise<T> {
+  try {
+    return await Promise.race([work, cancellation]);
+  } catch (error) {
+    if (signal.aborted)
+      throw bootCancellationError(signal, apiName, getPhase());
+    throw error;
   }
 }
 
+function throwIfBootCanceled(
+  signal: AbortSignal,
+  apiName: string,
+  phase: string,
+): void {
+  if (signal.aborted) throw bootCancellationError(signal, apiName, phase);
+}
+
+function bootCancellationError(
+  signal: AbortSignal,
+  apiName: string,
+  phase: string,
+): Error {
+  const reason = signal.reason as BootCancellationReason | undefined;
+  if (reason?.kind === "timeout")
+    return new Error(
+      `bootTtsc: timed out after ${reason.timeoutMs}ms while ${phase} for ${apiName}.`,
+    );
+
+  const error = new Error(`bootTtsc: aborted while ${phase} for ${apiName}.`);
+  const cause = reason?.kind === "abort" ? reason.reason : signal.reason;
+  if (cause !== undefined) (error as Error & { cause?: unknown }).cause = cause;
+  return error;
+}
+
 /**
  * Derive the `wasm_exec.js` URL from the wasm URL by replacing the filename.
  *

package/src/index.ts

@@ -6,6 +6,7 @@
 // imported from JS.
 
 export * from "./bootTtsc";
+export * from "./BootTtscWorkerTerminationError";
 export * from "./createMemFS";
 export * from "./MemFSError";
 export * from "./parseResult";

package/src/structures/IBootTtscOptions.ts

@@ -4,6 +4,17 @@ import type { IMemFSHost } from "./IMemFSHost";
 export interface IBootTtscOptions {
   /** URL of the .wasm to fetch. */
   wasmUrl: string;
+  /** Cancel this boot attempt, including a shared in-flight attempt. */
+  signal?: AbortSignal;
+  /**
+   * Maximum initialization time in milliseconds. Defaults to 60 seconds.
+   *
+   * The deadline covers queued, fetch, instantiate, and readiness phases.
+   * `importScripts` is synchronous and can only observe cancellation before or
+   * after it returns. A failure after `go.run` starts requires terminating the
+   * Worker; later boots of the same API name reject terminally.
+   */
+  timeoutMs?: number;
   /** URL of wasm_exec.js. Defaults to the same directory as wasmUrl. */
   wasmExecUrl?: string;
   /**