@atolljs/core 0.1.13 → 0.1.15

package/dist/pool/workerPool.js

@@ -1,11 +1,11 @@
-import { devtoolsEnabled as e, emitDevtools as t, estimateCloneBytes as n, nextDevtoolsId as r } from "../devtools.js";
-import { fmtBytes as i, scoped as a } from "../log.js";
-import { PoolQueueFullError as o, TaskAbortedError as s, TaskTimeoutError as c, WorkerCrashedError as l } from "./errors.js";
-import { measureTaskCall as u } from "../userTiming.js";
-import { forwardWorkerDevtools as d, sendInit as f, setupChannelMemory as p } from "./workerChannel.js";
+import { PoolQueueFullError as e, TaskAbortedError as t, TaskTimeoutError as n, WorkerCrashedError as r } from "./errors.js";
+import { devtoolsEnabled as i, emitDevtools as a, estimateCloneBytes as o, nextDevtoolsId as s } from "../devtools.js";
+import { measureTaskCall as c } from "../userTiming.js";
+import { forwardWorkerDevtools as l, sendInit as u, setupChannelMemory as d } from "./workerChannel.js";
+import { fmtBytes as f, scoped as p } from "../log.js";
 import { CHAOS_FAILURE as m, KILL_MESSAGE as h, applyChaos as g, registerDevtoolsRunner as _ } from "./devtoolsCommands.js";
-//#region src/pool/workerPool.ts
-var v = a("pool"), y = a("task"), b = () => ({
+// src/pool/workerPool.ts
+var v = p("pool"), y = p("task"), b = () => ({
 	count: 0,
 	mean: 0,
 	max: 0,
@@ -25,6 +25,7 @@ var v = a("pool"), y = a("task"), b = () => ({
 	concurrency;
 	maxQueue;
 	respawn;
+	onLifecycle;
 	taskTimeout;
 	closed = !1;
 	chaos = null;
@@ -42,21 +43,21 @@ var v = a("pool"), y = a("task"), b = () => ({
 	nextCallId = 0;
 	sharedMemory;
 	persistence;
-	constructor(n) {
-		let a = p(n, "WorkerPool");
-		if (!n.workerUrl && !n.createWorker) throw Error("WorkerPool requires either `workerUrl` or `createWorker` in its config.");
-		this.workerUrl = n.workerUrl, this.spawn = n.createWorker ?? (() => new Worker(this.workerUrl, { type: "module" })), this.concurrency = n.concurrency ?? 1, this.maxQueue = n.maxQueue ?? Infinity, this.respawn = n.respawn ?? !0, this.taskTimeout = n.taskTimeout, this.label = n.name, this.poolId = r("pool", n.name), this.mem = a, this.sharedMemory = a.sharedMemory, this.memoryManager = a.memoryManager, this.injectedBuffer = a.injectedBuffer, this.persistence = a.persistence;
-		let o = n.poolSize ?? "auto", s = o === "auto" ? typeof navigator < "u" ? navigator.hardwareConcurrency ?? 4 : 4 : o;
-		v.info(this.sharedMemory ? `spawning ${s} worker(s) with ${i(this.sharedMemory.totalBytes)} shared buffer` : this.injectedBuffer ? `spawning ${s} worker(s) with ${i(this.injectedBuffer.byteLength)} inherited buffer` : `spawning ${s} worker(s), message-only`, { workerUrl: n.workerUrl ? String(n.workerUrl) : "createWorker()" }), v.debug("tip: setLogLevel('trace') for per-task detail"), t({
+	constructor(e) {
+		let t = d(e, "WorkerPool");
+		if (!e.workerUrl && !e.createWorker) throw Error("WorkerPool requires either `workerUrl` or `createWorker` in its config.");
+		this.workerUrl = e.workerUrl, this.spawn = e.createWorker ?? (() => new Worker(this.workerUrl, { type: "module" })), this.concurrency = e.concurrency ?? 1, this.maxQueue = e.maxQueue ?? Infinity, this.respawn = e.respawn ?? !0, this.onLifecycle = e.onLifecycle, this.taskTimeout = e.taskTimeout, this.label = e.name, this.poolId = s("pool", e.name), this.mem = t, this.sharedMemory = t.sharedMemory, this.memoryManager = t.memoryManager, this.injectedBuffer = t.injectedBuffer, this.persistence = t.persistence;
+		let n = e.poolSize ?? "auto", r = n === "auto" ? typeof navigator < "u" ? navigator.hardwareConcurrency ?? 4 : 4 : n;
+		v.info(this.sharedMemory ? `spawning ${r} worker(s) with ${f(this.sharedMemory.totalBytes)} shared buffer` : this.injectedBuffer ? `spawning ${r} worker(s) with ${f(this.injectedBuffer.byteLength)} inherited buffer` : `spawning ${r} worker(s), message-only`, { workerUrl: e.workerUrl ? String(e.workerUrl) : "createWorker()" }), v.debug("tip: setLogLevel('trace') for per-task detail"), a({
 			type: "pool:init",
 			poolId: this.poolId,
 			label: this.label,
-			poolSize: s,
+			poolSize: r,
 			concurrency: this.concurrency,
 			memoryBytes: this.sharedMemory?.totalBytes ?? this.injectedBuffer?.byteLength
 		});
-		for (let e = 0; e < s; e++) this.addWorker(this.spawn());
-		e() && (this.devtoolsOff = _({
+		for (let e = 0; e < r; e++) this.addWorker(this.spawn());
+		i() && (this.devtoolsOff = _({
 			poolId: this.poolId,
 			label: this.label,
 			dedicated: !1,
@@ -72,100 +73,98 @@ var v = a("pool"), y = a("task"), b = () => ({
 				this.chaos = e;
 			}
 		}));
-		let c = n.tasks ?? {};
-		for (let [e, t] of Object.entries(c)) {
-			if (e in this) {
-				v.warn(`task "${e}" collides with a WorkerPool member — not installed`);
-				continue;
-			}
-			this[e] = (...e) => this.runTask(t, ...e);
-		}
-		Object.keys(c).length > 0 && v.info(`task methods: ${Object.keys(c).join(", ")}`);
+		let o = e.tasks ?? {};
+		for (let [e, t] of Object.entries(o)) e in this ? v.warn(`task "${e}" collides with a WorkerPool member — not installed`) : this[e] = (...e) => this.runTask(t, ...e);
+		Object.keys(o).length > 0 && v.info(`task methods: ${Object.keys(o).join(", ")}`);
 	}
 	addWorker(e) {
-		let n = {
+		let t = {
 			worker: e,
 			inFlight: 0
 		};
 		e.addEventListener("message", (e) => {
-			let t = e.data;
-			if (t.type === "ATOLL_DEVTOOLS" && t.event) {
-				d(this.poolId, this.slots.indexOf(n), t.event);
-				return;
-			}
-			this.handleReply(n, t);
+			let n = e.data;
+			n.type === "ATOLL_DEVTOOLS" && n.event ? l(this.poolId, this.slots.indexOf(t), n.event) : this.handleReply(t, n);
 		}), e.addEventListener("error", (e) => {
-			this.handleWorkerError(n, e);
+			this.handleWorkerError(t, e);
 		});
-		let r = f(e, this.mem);
-		return this.slots.push(n), v.debug(`worker spawned, ${r} sent`), t({
+		let n = u(e, this.mem);
+		return this.slots.push(t), v.debug(`worker spawned, ${n} sent`), a({
 			type: "worker:spawn",
 			poolId: this.poolId,
-			slot: this.slots.indexOf(n)
-		}), n;
+			slot: this.slots.indexOf(t)
+		}), t;
 	}
-	handleReply(r, i) {
-		let a = i.messageId === void 0 ? void 0 : this.pending.get(i.messageId);
-		if (a) {
-			if (this.pending.delete(i.messageId), r.inFlight--, this.detach(a), !a.done) {
-				a.done = !0;
-				let o = a.sentAt ?? a.enqueuedAt, s = performance.now() - o;
-				this.statsAgg.runMs.add(s), i.success ? (this.statsAgg.completed++, y.debug(`← ${a.contract.taskId} ok`), e() && (t({
+	handleReply(e, t) {
+		let n = t.messageId === void 0 ? void 0 : this.pending.get(t.messageId);
+		if (n) {
+			if (this.pending.delete(t.messageId), e.inFlight--, this.detach(n), !n.done) {
+				n.done = !0;
+				let r = n.sentAt ?? n.enqueuedAt, s = performance.now() - r;
+				this.statsAgg.runMs.add(s), t.success ? (this.statsAgg.completed++, y.debug(`← ${n.contract.taskId} ok`), i() && (a({
 					type: "task:settle",
 					poolId: this.poolId,
-					callId: a.callId,
-					taskId: a.contract.taskId,
+					callId: n.callId,
+					taskId: n.contract.taskId,
 					outcome: "ok",
 					runMs: s,
-					resultBytes: n(i.result)
-				}), u(this.poolId, a.contract.taskId, a.callId, this.slots.indexOf(r), o, o + s, !0)), a.resolve(i.result)) : (this.statsAgg.failed++, y.warn(`← ${a.contract.taskId} failed: ${i.error}`), e() && (t({
+					resultBytes: o(t.result)
+				}), c(this.poolId, n.contract.taskId, n.callId, this.slots.indexOf(e), r, r + s, !0)), n.resolve(t.result)) : (this.statsAgg.failed++, y.warn(`← ${n.contract.taskId} failed: ${t.error}`), i() && (a({
 					type: "task:settle",
 					poolId: this.poolId,
-					callId: a.callId,
-					taskId: a.contract.taskId,
+					callId: n.callId,
+					taskId: n.contract.taskId,
 					outcome: "error",
 					runMs: s,
-					error: i.error
-				}), u(this.poolId, a.contract.taskId, a.callId, this.slots.indexOf(r), o, o + s, !1)), a.reject(Error(i.error)));
+					error: t.error
+				}), c(this.poolId, n.contract.taskId, n.callId, this.slots.indexOf(e), r, r + s, !1)), n.reject(Error(t.error)));
 			}
 			this.drainQueue(), this.checkDrained();
 		}
 	}
-	handleWorkerError(e, n) {
+	lifecycle(e, t, n) {
+		this.onLifecycle?.({
+			type: e,
+			poolId: this.poolId,
+			slot: t,
+			message: n
+		});
+	}
+	handleWorkerError(e, t) {
 		if (this.closed) return;
-		let r = n, i = r?.message ?? (r?.error ? String(r.error) : "worker error");
+		let n = t, i = n?.message ?? (n?.error ? String(n.error) : "worker error");
 		v.warn(`worker error: ${i}`);
-		let a = this.slots.indexOf(e);
-		t({
+		let o = this.slots.indexOf(e);
+		a({
 			type: "worker:error",
 			poolId: this.poolId,
-			slot: a,
+			slot: o,
 			message: i
-		});
-		for (let [n, r] of [...this.pending]) if (r.slot === e) {
-			if (this.pending.delete(n), this.detach(r), r.done) continue;
-			r.done = !0, this.statsAgg.failed++, t({
+		}), this.lifecycle("error", o >= 0 ? o : void 0, i);
+		for (let [t, n] of [...this.pending]) if (n.slot === e) {
+			if (this.pending.delete(t), this.detach(n), n.done) continue;
+			n.done = !0, this.statsAgg.failed++, a({
 				type: "task:settle",
 				poolId: this.poolId,
-				callId: r.callId,
-				taskId: r.contract.taskId,
+				callId: n.callId,
+				taskId: n.contract.taskId,
 				outcome: "crashed",
 				error: i
-			}), r.reject(new l(i));
+			}), n.reject(new r(i));
 		}
-		if (a >= 0 && this.slots.splice(a, 1), e.worker.terminate(), this.respawn) v.info("respawning crashed worker"), this.addWorker(this.spawn()), t({
+		if (o >= 0 && this.slots.splice(o, 1), e.worker.terminate(), this.respawn) v.info("respawning crashed worker"), this.addWorker(this.spawn()), a({
 			type: "worker:respawn",
 			poolId: this.poolId,
 			slot: this.slots.length - 1
-		});
-		else if (this.slots.length === 0) for (let e of this.queue.splice(0)) e.done = !0, this.detach(e), this.statsAgg.failed++, t({
+		}), this.lifecycle("respawn", this.slots.length - 1);
+		else if (this.slots.length === 0) for (let e of this.queue.splice(0)) e.done = !0, this.detach(e), this.statsAgg.failed++, a({
 			type: "task:settle",
 			poolId: this.poolId,
 			callId: e.callId,
 			taskId: e.contract.taskId,
 			outcome: "crashed",
 			error: i
-		}), e.reject(new l(i));
+		}), e.reject(new r(i));
 		this.drainQueue(), this.checkDrained();
 	}
 	pickWorker() {
@@ -180,55 +179,55 @@ var v = a("pool"), y = a("task"), b = () => ({
 			t.done || this.send(e, t);
 		}
 	}
-	send(r, i) {
-		let a = this.nextMessageId++;
-		i.messageId = a, i.slot = r, i.sentAt = performance.now();
-		let o = i.sentAt - i.enqueuedAt;
-		this.statsAgg.waitMs.add(o), r.inFlight++, this.pending.set(a, i);
-		let s = this.slots.indexOf(r);
-		y.debug(`→ ${i.contract.taskId}`, {
-			worker: s,
-			args: i.args
-		}), e() && t({
+	send(e, t) {
+		let r = this.nextMessageId++;
+		t.messageId = r, t.slot = e, t.sentAt = performance.now();
+		let s = t.sentAt - t.enqueuedAt;
+		this.statsAgg.waitMs.add(s), e.inFlight++, this.pending.set(r, t);
+		let c = this.slots.indexOf(e);
+		y.debug(`→ ${t.contract.taskId}`, {
+			worker: c,
+			args: t.args
+		}), i() && a({
 			type: "task:dispatch",
 			poolId: this.poolId,
-			callId: i.callId,
-			taskId: i.contract.taskId,
-			slot: s,
-			waitMs: o,
-			argBytes: n(i.args)
+			callId: t.callId,
+			taskId: t.contract.taskId,
+			slot: c,
+			waitMs: s,
+			argBytes: o(t.args)
 		});
 		let l = {
 			type: "EXECUTE_TASK",
-			messageId: a,
-			taskId: i.contract.taskId,
-			args: i.args
+			messageId: r,
+			taskId: t.contract.taskId,
+			args: t.args
 		};
 		this.chaos ? g(this.chaos, {
-			live: () => this.pending.get(a) === i,
-			fail: () => this.handleReply(r, {
-				messageId: a,
+			live: () => this.pending.get(r) === t,
+			fail: () => this.handleReply(e, {
+				messageId: r,
 				taskId: l.taskId,
 				success: !1,
 				error: m
 			}),
-			timeout: () => this.cancel(i, new c()),
-			post: () => r.worker.postMessage(l)
-		}) : r.worker.postMessage(l);
+			timeout: () => this.cancel(t, new n()),
+			post: () => e.worker.postMessage(l)
+		}) : e.worker.postMessage(l);
 	}
 	detach(e) {
 		e.timer && clearTimeout(e.timer), e.signal && e.onSignalAbort && e.signal.removeEventListener("abort", e.onSignalAbort);
 	}
-	cancel(e, n) {
+	cancel(e, t) {
 		if (e.done) return;
 		let r = this.queue.indexOf(e);
-		r >= 0 && this.queue.splice(r, 1), e.done = !0, this.detach(e), this.statsAgg.aborted++, t({
+		r >= 0 && this.queue.splice(r, 1), e.done = !0, this.detach(e), this.statsAgg.aborted++, a({
 			type: "task:settle",
 			poolId: this.poolId,
 			callId: e.callId,
 			taskId: e.contract.taskId,
-			outcome: n instanceof c ? "timeout" : "aborted"
-		}), e.reject(n), this.drainQueue(), this.checkDrained();
+			outcome: t instanceof n ? "timeout" : "aborted"
+		}), e.reject(t), this.drainQueue(), this.checkDrained();
 	}
 	checkDrained() {
 		if (this.queue.length === 0 && this.pending.size === 0) {
@@ -236,36 +235,36 @@ var v = a("pool"), y = a("task"), b = () => ({
 			for (let t of e) t();
 		}
 	}
-	dispatch(e, n, r) {
-		return this.closed || this.slots.length === 0 ? Promise.reject(new l("WorkerPool has been terminated — no workers available.")) : r?.signal?.aborted ? Promise.reject(new s()) : new Promise((i, a) => {
+	dispatch(i, o, s) {
+		return this.closed || this.slots.length === 0 ? Promise.reject(new r("WorkerPool has been terminated — no workers available.")) : s?.signal?.aborted ? Promise.reject(new t()) : new Promise((r, c) => {
 			let l = {
-				contract: e,
-				args: n,
+				contract: i,
+				args: o,
 				callId: ++this.nextCallId,
 				enqueuedAt: performance.now(),
-				resolve: i,
-				reject: a,
+				resolve: r,
+				reject: c,
 				done: !1,
-				signal: r?.signal
+				signal: s?.signal
 			};
-			r?.signal && (l.onSignalAbort = () => this.cancel(l, new s()), r.signal.addEventListener("abort", l.onSignalAbort, { once: !0 }));
-			let u = r?.timeout ?? this.taskTimeout;
-			u !== void 0 && (l.timer = setTimeout(() => this.cancel(l, new c()), u)), t({
+			s?.signal && (l.onSignalAbort = () => this.cancel(l, new t()), s.signal.addEventListener("abort", l.onSignalAbort, { once: !0 }));
+			let u = s?.timeout ?? this.taskTimeout;
+			u !== void 0 && (l.timer = setTimeout(() => this.cancel(l, new n()), u)), a({
 				type: "task:enqueue",
 				poolId: this.poolId,
 				callId: l.callId,
-				taskId: e.taskId
+				taskId: i.taskId
 			});
 			let d = this.pickWorker();
 			if (d) this.send(d, l);
 			else if (this.queue.length >= this.maxQueue) {
-				l.done = !0, this.detach(l), t({
+				l.done = !0, this.detach(l), a({
 					type: "task:settle",
 					poolId: this.poolId,
 					callId: l.callId,
-					taskId: e.taskId,
+					taskId: i.taskId,
 					outcome: "queue-full"
-				}), a(new o());
+				}), c(new e());
 				return;
 			} else this.queue.push(l);
 		});
@@ -308,31 +307,30 @@ var v = a("pool"), y = a("task"), b = () => ({
 		});
 	}
 	terminate() {
-		this.closed = !0, this.devtoolsOff?.(), this.persistence?.stop()?.catch?.((e) => v.warn("memory persistence stop failed", e)), v.info(`terminating ${this.slots.length} worker(s)`), t({
+		this.closed = !0, this.lifecycle("terminate"), this.devtoolsOff?.(), this.persistence?.stop()?.catch?.((e) => v.warn("memory persistence stop failed", e)), v.info(`terminating ${this.slots.length} worker(s)`), a({
 			type: "pool:terminate",
 			poolId: this.poolId
 		});
-		let e = new l("pool terminated");
-		for (let [, n] of this.pending) this.detach(n), !n.done && (n.done = !0, this.statsAgg.failed++, t({
+		let e = new r("pool terminated");
+		for (let [, t] of this.pending) this.detach(t), t.done || (t.done = !0, this.statsAgg.failed++, a({
 			type: "task:settle",
 			poolId: this.poolId,
-			callId: n.callId,
-			taskId: n.contract.taskId,
+			callId: t.callId,
+			taskId: t.contract.taskId,
 			outcome: "crashed",
 			error: "pool terminated"
-		}), n.reject(e));
+		}), t.reject(e));
 		this.pending.clear();
-		for (let n of this.queue.splice(0)) n.done = !0, this.detach(n), this.statsAgg.failed++, t({
+		for (let t of this.queue.splice(0)) t.done = !0, this.detach(t), this.statsAgg.failed++, a({
 			type: "task:settle",
 			poolId: this.poolId,
-			callId: n.callId,
-			taskId: n.contract.taskId,
+			callId: t.callId,
+			taskId: t.contract.taskId,
 			outcome: "crashed",
 			error: "pool terminated"
-		}), n.reject(e);
+		}), t.reject(e);
 		for (let e of this.slots) e.worker.terminate();
 		this.slots = [], this.checkDrained();
 	}
 };
-//#endregion
 export { x as WorkerPool };

package/dist/reactive.js

@@ -1,7 +1,7 @@
 import { scoped as e } from "./log.js";
 import { disposeNodes as t, graphNode as n, graphSource as r } from "./reactiveGraph.js";
 import { createEffect as i, createMemo as a, createRenderEffect as o, createRoot as s, createSignal as c } from "solid-js";
-//#region src/reactive.ts
+// src/reactive.ts
 var l = e("reactive");
 function u(e, t) {
 	if (e === t) return !0;
@@ -109,5 +109,4 @@ function v(e, r, o, u, f) {
 		}
 	};
 }
-//#endregion
 export { g as reactive, u as shallowEqual, _ as watch, v as watchNodes };

package/dist/reactiveGraph.js

@@ -1,5 +1,5 @@
 import { devtoolsEnabled as e, emitDevtools as t, registerDevtoolsCommand as n } from "./devtools.js";
-//#region src/reactiveGraph.ts
+// src/reactiveGraph.ts
 var r = typeof WorkerGlobalScope < "u" && self instanceof WorkerGlobalScope ? "worker" : "main", i = 0, a = /* @__PURE__ */ new Map(), o = !1, s = (e, n) => {
 	t({
 		type: "reactive:node",
@@ -42,5 +42,4 @@ var r = typeof WorkerGlobalScope < "u" && self instanceof WorkerGlobalScope ? "w
 		t && (a.delete(n), e() && s(t, !0));
 	}
 };
-//#endregion
 export { f as disposeNodes, u as graphNode, l as graphSource, d as relabelNode };

package/dist/service.js

@@ -1,6 +1,6 @@
 import { scoped as e } from "./log.js";
 import { TaskRegistry as t } from "./worker/registry.js";
-//#region src/service.ts
+// src/service.ts
 var n = e("service");
 function r(e = {}) {
 	return e;
@@ -44,5 +44,4 @@ function s(e, t) {
 	for (let [r, i] of Object.entries(e.tasks)) n[r] = (...e) => t.runTask(i, ...e);
 	return n;
 }
-//#endregion
 export { s as createClient, a as defineService, o as implementService, r as rpc, i as serviceMethod };

package/dist/shared/sharedWorkerClient.js

@@ -1,5 +1,5 @@
 import { scoped as e } from "../log.js";
-//#region src/shared/sharedWorkerClient.ts
+// src/shared/sharedWorkerClient.ts
 var t = e("shared-client"), n = e("task"), r = class {
 	clientIndex;
 	sharedMemory;
@@ -7,13 +7,7 @@ var t = e("shared-client"), n = e("task"), r = class {
 	constructor(e, n, r) {
 		this.clientIndex = n, this.port = e, this.sharedMemory = r.sharedMemory;
 		let i = r.tasks ?? {};
-		for (let [e, n] of Object.entries(i)) {
-			if (e in this) {
-				t.warn(`task "${e}" collides with a SharedWorkerClient member — not installed`);
-				continue;
-			}
-			this[e] = (...e) => this.runTask(n, ...e);
-		}
+		for (let [e, n] of Object.entries(i)) e in this ? t.warn(`task "${e}" collides with a SharedWorkerClient member — not installed`) : this[e] = (...e) => this.runTask(n, ...e);
 		Object.keys(i).length > 0 && t.info(`task methods: ${Object.keys(i).join(", ")}`);
 	}
 	runTask(e, ...t) {
@@ -60,5 +54,4 @@ async function i(e) {
 		});
 	});
 }
-//#endregion
 export { i as connectSharedWorker };

package/dist/shared/sharedWorkerHost.js

@@ -1,32 +1,30 @@
-import { fmtBytes as e, scoped as t } from "../log.js";
-import { bindSharedMemories as n } from "../contract/sharedMemory.js";
-import { MemoryManager as r } from "../pool/memory.js";
-import { TaskRegistry as i } from "../worker/registry.js";
-//#region src/shared/sharedWorkerHost.ts
-var a = t("shared-worker"), o = null, s = 0;
-function c(t, i) {
-	if (o) return o.buffer.byteLength < t && a.warn(`client requested ${e(t)} but buffer is ${e(o.buffer.byteLength)} — first client's capacity wins`), o;
-	let s = new r(i);
-	return s.ensureCapacity(t), o = s.memory, n(s.getBuffer()), a.info(`shared buffer allocated (${e(o.buffer.byteLength)})`), o;
+import { bindSharedMemories as e } from "../contract/sharedMemory.js";
+import { MemoryManager as t } from "../pool/memory.js";
+import { TaskRegistry as n } from "../worker/registry.js";
+import { fmtBytes as r, scoped as i } from "../log.js";
+// src/shared/sharedWorkerHost.ts
+var a = i("shared-worker"), o = null, s = 0;
+function c(n, i) {
+	if (o) return o.buffer.byteLength < n && a.warn(`client requested ${r(n)} but buffer is ${r(o.buffer.byteLength)} — first client's capacity wins`), o;
+	let s = new t(i);
+	return s.ensureCapacity(n), o = s.memory, e(s.getBuffer()), a.info(`shared buffer allocated (${r(o.buffer.byteLength)})`), o;
 }
 function l(e) {
 	let t = ++s;
-	a.info(`client #${t} connected`), e.onmessage = async (n) => {
-		let r = n.data;
-		if (r?.type === "SHARED_CONNECT") {
-			let n = c(r.memoryBytes ?? 0, r.memory);
+	a.info(`client #${t} connected`), e.onmessage = async (r) => {
+		let i = r.data;
+		if (i?.type === "SHARED_CONNECT") {
+			let n = c(i.memoryBytes ?? 0, i.memory);
 			e.postMessage({
 				type: "SHARED_MEMORY",
 				buffer: n.buffer,
 				clientIndex: t
 			});
-			return;
-		}
-		if (r?.type === "EXECUTE_TASK") {
-			let { messageId: n, taskId: s, args: c } = r;
+		} else if (i?.type === "EXECUTE_TASK") {
+			let { messageId: r, taskId: s, args: c } = i;
 			if (!o) {
 				e.postMessage({
-					messageId: n,
+					messageId: r,
 					success: !1,
 					error: "Shared memory not initialized in worker."
 				});
@@ -34,22 +32,20 @@ function l(e) {
 			}
 			let l = performance.now();
 			try {
-				let r = await i.execute(s, ...c || []);
+				let i = await n.execute(s, ...c || []);
 				a.debug(`task ${s} → ${(performance.now() - l).toFixed(1)}ms (client #${t})`), e.postMessage({
-					messageId: n,
+					messageId: r,
 					success: !0,
-					result: r
+					result: i
 				});
 			} catch (t) {
 				a.warn(`task ${s} failed: ${t.message || String(t)}`), e.postMessage({
-					messageId: n,
+					messageId: r,
 					success: !1,
 					error: t.message || String(t)
 				});
 			}
-			return;
-		}
-		r?.type === "SHARED_DISCONNECT" && (e.close(), a.info(`client #${t} disconnected`));
+		} else i?.type === "SHARED_DISCONNECT" && (e.close(), a.info(`client #${t} disconnected`));
 	}, e.start();
 }
 function u() {
@@ -57,5 +53,4 @@ function u() {
 		l(e.ports[0]);
 	};
 }
-//#endregion
 export { l as attachSharedPort, u as sharedWorkerHost };

package/dist/task.js

@@ -1,5 +1,5 @@
 import { scoped as e } from "./log.js";
-//#region src/task.ts
+// src/task.ts
 var t = e("task");
 function n(e) {
 	let n = 0, r = {
@@ -53,5 +53,4 @@ function r(e) {
 function i(e) {
 	return r(e) ? e : n(e);
 }
-//#endregion
 export { n as defineTask, r as isAsyncTask, i as toTask };

package/dist/testing/inProcessWorker.js

@@ -1,6 +1,6 @@
 import { bindSharedMemories as e } from "../contract/sharedMemory.js";
 import { TaskRegistry as t } from "../worker/registry.js";
-//#region src/testing/inProcessWorker.ts
+// src/testing/inProcessWorker.ts
 var n = class n {
 	url;
 	options;
@@ -46,9 +46,7 @@ var n = class n {
 			} catch (e) {
 				this.crashOnBoot(e);
 			}
-			return;
-		}
-		if (n.type === "INIT_MEMORY") {
+		} else if (n.type === "INIT_MEMORY") {
 			let t = n.memory?.buffer ?? n.buffer;
 			this.ready ??= this.boot().then(() => {
 				t && e(t);
@@ -58,9 +56,7 @@ var n = class n {
 			} catch (e) {
 				this.crashOnBoot(e);
 			}
-			return;
-		}
-		if (n.type === "EXECUTE_TASK") {
+		} else if (n.type === "EXECUTE_TASK") {
 			if (this.dead) return;
 			try {
 				await this.ready;
@@ -106,5 +102,4 @@ var n = class n {
 		this.terminated = !0;
 	}
 }, r = () => new Promise((e) => setTimeout(e, 5));
-//#endregion
 export { n as InProcessWorker, r as flushObservers };

package/dist/userTiming.js

@@ -1,4 +1,4 @@
-//#region src/userTiming.ts
+// src/userTiming.ts
 var e = (e, t, n, r) => {
 	let i = globalThis.performance;
 	if (typeof i?.measure == "function") try {
@@ -26,5 +26,4 @@ var e = (e, t, n, r) => {
 	],
 	tooltipText: `${n} on ${t}#${i}: ${(o - a).toFixed(1)}ms`
 });
-//#endregion
 export { e as measureAtoll, t as measureTaskCall };

package/dist/worker/defineWorker.js

@@ -1,8 +1,8 @@
-import { scoped as e } from "../log.js";
+import { installWorkerListener as e } from "./workerBootstrap.js";
 import { TaskRegistry as t } from "./registry.js";
-import { installWorkerListener as n } from "./workerBootstrap.js";
-//#region src/worker/defineWorker.ts
-var r = e("worker"), i = [
+import { scoped as n } from "../log.js";
+// src/worker/defineWorker.ts
+var r = n("worker"), i = [
 	"start",
 	"terminate",
 	"pool",
@@ -10,9 +10,9 @@ var r = e("worker"), i = [
 	"then",
 	"with"
 ], a = (e) => typeof e == "object" && !!e && "run" in e, o = new Set(i);
-function s(e) {
-	n();
-	let i = e.methods ?? {}, s = e.services ?? {}, c = 0, l = (e, n, r, i) => {
+function s(n) {
+	e();
+	let i = n.methods ?? {}, s = n.services ?? {}, c = 0, l = (e, n, r, i) => {
 		if (o.has(n)) throw Error(`defineWorker: "${n}" is reserved for the client API — rename the method`);
 		if (a(r)) {
 			let { def: n } = r;
@@ -35,7 +35,6 @@ function s(e) {
 		methods: i,
 		services: s
 	};
-	return e.sharedMemory && (u.sharedMemory = e.sharedMemory), u;
+	return n.sharedMemory && (u.sharedMemory = n.sharedMemory), u;
 }
-//#endregion
 export { i as RESERVED_CLIENT_KEYS, s as defineWorker };

package/dist/worker/registry.js

@@ -1,5 +1,5 @@
 import { scoped as e } from "../log.js";
-//#region src/worker/registry.ts
+// src/worker/registry.ts
 var t = e("registry"), n = class {
 	static tasks = /* @__PURE__ */ new Map();
 	static register(e, n) {
@@ -21,5 +21,4 @@ var t = e("registry"), n = class {
 		return r.resultSchema ? r.resultSchema.parse(a) : a;
 	}
 };
-//#endregion
 export { n as TaskRegistry };