@incajs/cli 0.0.4 → 0.0.5

package/README.md

@@ -57,11 +57,13 @@ once it is packaged.
 
 ## Requirements
 
-`inca`'s host binary is pulled in automatically as a platform-specific
-optional dependency (Linux and macOS on x64/arm64; Windows isn't
-supported yet) — neither Cargo nor Rust are needed. Set `INCA_HOST_BIN`
-to use a specific binary instead, e.g. on a platform with no published
-one yet, or a custom build.
+A prebuilt binary is pulled in automatically as a platform-specific
+optional dependency — neither Cargo nor Rust are needed. See
+[Host binary](https://tom96da.github.io/incajs/guide/#host-binary) for
+per-platform support.
+
+Set `INCA_HOST_BIN` to use a specific binary instead, e.g. on a
+platform with no published one yet, or a custom build.
 
 ## How it works
 

package/dist/adapter/types.d.mts

@@ -3,38 +3,6 @@ export interface Watcher {
     /** Stops watching and releases the underlying build process. */
     close(): Promise<void>;
 }
-/** Options for {@link Bundler.watch}. */
-export interface BundlerOptions {
-    /** The app's own entry point — may import `.vue` files. */
-    entry: string;
-    /** Where the build's output is written. */
-    outDir: string;
-    /**
-     * Values the built app carries for `inca-host` to read — its name, id
-     * and window. Any JSON-serializable object.
-     */
-    runtimeConfig?: unknown;
-    /** `"development"` keeps a framework's own warnings; `"production"` strips them. */
-    mode: "development" | "production";
-    /** Called after each successful (re)build, with what it wrote. */
-    onBuild: (output: BuildOutput) => void;
-    /** Called instead of `onBuild` when a (re)build fails. */
-    onError: (error: {
-        message: string;
-        stack: string | null;
-        code?: string | null;
-    }) => void;
-    /** Where the bundler's own output goes. Defaults to `process.stdout`. */
-    stdout?: NodeJS.WritableStream;
-    /** Where the bundler's warnings and errors go. Defaults to `process.stderr`. */
-    stderr?: NodeJS.WritableStream;
-    /**
-     * Drops the bundler's progress output and size report, leaving the
-     * per-build summary. Set it when the build has to stay silent: part of
-     * that output goes to the process's own stdout, not to `stdout` above.
-     */
-    quiet?: boolean;
-}
 /** Options for {@link Bundler.build}. */
 export interface BuildOptions {
     /** The app's own entry point — may import `.vue` files. */
@@ -57,6 +25,19 @@ export interface BuildOptions {
      */
     quiet?: boolean;
 }
+/** Options for {@link Bundler.watch}. */
+export interface BundlerOptions extends BuildOptions {
+    /** `"development"` keeps a framework's own warnings; `"production"` strips them. */
+    mode: "development" | "production";
+    /** Called after each successful (re)build, with what it wrote. */
+    onBuild: (output: BuildOutput) => void;
+    /** Called instead of `onBuild` when a (re)build fails. */
+    onError: (error: {
+        message: string;
+        stack: string | null;
+        code?: string | null;
+    }) => void;
+}
 /** What a build wrote — the result of {@link Bundler.build}, and every {@link BundlerOptions.onBuild} call. */
 export interface BuildOutput {
     /** Directory holding every file this build emitted. */

package/dist/adapter/vite/build.d.mts

@@ -1,5 +1,4 @@
 import { BuildOptions, BuildOutput } from '../types.mts';
-export type { BuildOptions, BuildOutput } from '../types.mts';
 /**
  * Builds `entry` into a minified, production build under `outDir` once, and
  * rejects on failure rather than reporting it through a callback. Never

package/dist/adapter/vite/captureOutput.d.mts

@@ -1,4 +1,5 @@
 import { Plugin } from 'vite';
+import { BuildOutput } from '../types.mts';
 /** What one (re)build actually wrote, relative to its own `outDir`. */
 export interface CapturedOutput {
     /** The emitted chunk marked as this build's entry. */
@@ -6,6 +7,8 @@ export interface CapturedOutput {
     /** Every emitted file, as the bundler reported it. */
     files: readonly string[];
 }
+/** Resolves `captured`'s paths against `outDir` into a {@link BuildOutput}. */
+export declare function toBuildOutput(outDir: string, captured: CapturedOutput, changed?: BuildOutput["changed"]): BuildOutput;
 /**
  * A Vite plugin reporting `sink` the files a build wrote once they land on
  * disk, via `writeBundle` — the one hook that fires uniformly for a

package/dist/adapter/vite/watch.d.mts

@@ -1,5 +1,4 @@
 import { BundlerOptions, Watcher } from '../types.mts';
-export type { Watcher } from '../types.mts';
 /**
  * Builds `entry` into a build under `outDir` and rebuilds it on every
  * change, calling `onBuild` with what each rebuild wrote. Never starts,

package/dist/cli.js

@@ -9,57 +9,57 @@ import { createRequire as v } from "node:module";
 import { spawn as y } from "node:child_process";
 import { once as b } from "node:events";
 import x from "node:readline";
-import { setTimeout as ee } from "node:timers/promises";
+import { setTimeout as S } from "node:timers/promises";
 //#region src/error.mts
-var S = class extends Error {
+var C = class extends Error {
 	code;
 	name = "IncaError";
 	constructor(e, t) {
 		super(t), this.code = e;
 	}
-}, te = {
+}, ee = {
 	name: "inca",
 	packageJson: "inca",
 	rcFile: !1,
 	globalRc: !1,
 	giget: !1,
 	extend: !1
-}, ne = /[/\\:*?"<>|\0]/;
-function re(e) {
-	return e === e.trim() && e !== "" && e !== "." && e !== ".." && !ne.test(e);
+}, te = /[/\\:*?"<>|\0]/;
+function ne(e) {
+	return e === e.trim() && e !== "" && e !== "." && e !== ".." && !te.test(e);
 }
-function C(e) {
-	if (!(typeof e == "string" && re(e))) throw new S("ERR_INCA_PRODUCT_NAME_INVALID", `${JSON.stringify(e)} can't name a directory — set a "productName" in inca.config.ts with no leading or trailing space, and none of \`/\\:*?"<>|\``);
+function w(e) {
+	if (!(typeof e == "string" && ne(e))) throw new C("ERR_INCA_PRODUCT_NAME_INVALID", `${JSON.stringify(e)} can't name a directory — set a "productName" in inca.config.ts with no leading or trailing space, and none of \`/\\:*?"<>|\``);
 }
-async function w(e) {
+async function T(e) {
 	let { config: t, layers: r } = await n({
 		cwd: e,
-		...te
+		...ee
 	}), i = r?.find((e) => e.configFile === "package.json");
 	return {
 		config: t,
 		usedPackageJsonKey: Object.keys(i?.config ?? {}).length > 0
 	};
 }
-async function T(e) {
-	let { config: t } = await w(e);
+async function E(e) {
+	let { config: t } = await T(e);
 	return {
 		entry: t.entry ? a.resolve(e, t.entry) : void 0,
 		outDir: a.resolve(e, t.outDir ?? i.outDir)
 	};
 }
-async function E(e) {
+async function D(e) {
 	let n = a.join(e, "package.json"), s;
 	try {
 		s = await d(n, "utf8");
 	} catch {
-		throw new S("ERR_INCA_PACKAGE_JSON_NOT_FOUND", `no package.json found at ${n}`);
+		throw new C("ERR_INCA_PACKAGE_JSON_NOT_FOUND", `no package.json found at ${n}`);
 	}
-	let c = JSON.parse(s), { config: l, usedPackageJsonKey: u } = await w(e), f = l.productName ?? r(c.name);
-	if (!f) throw new S("ERR_INCA_PRODUCT_NAME_MISSING", `${n} needs a "name", or "productName" in inca.config.ts`);
-	C(f);
+	let c = JSON.parse(s), { config: l, usedPackageJsonKey: u } = await T(e), f = l.productName ?? r(c.name);
+	if (!f) throw new C("ERR_INCA_PRODUCT_NAME_MISSING", `${n} needs a "name", or "productName" in inca.config.ts`);
+	w(f);
 	let p = l.version ?? c.version ?? i.version, m = l.identifier ?? t(f), h;
-	if (l.icon && (h = a.resolve(e, l.icon), !o(h))) throw new S("ERR_INCA_ICON_NOT_FOUND", `"icon" points to ${h}, which doesn't exist`);
+	if (l.icon && (h = a.resolve(e, l.icon), !o(h))) throw new C("ERR_INCA_ICON_NOT_FOUND", `"icon" points to ${h}, which doesn't exist`);
 	let g = l.entry ? a.resolve(e, l.entry) : void 0, _ = a.resolve(e, l.outDir ?? i.outDir);
 	return {
 		productName: f,
@@ -73,20 +73,20 @@ async function E(e) {
 		usedPackageJsonKey: u
 	};
 }
-function D(e) {
+function O(e) {
 	return {
 		name: e.productName,
 		identifier: e.identifier,
 		window: e.window
 	};
 }
-async function O(e) {
-	let { config: n } = await w(e), i = {};
+async function k(e) {
+	let { config: n } = await T(e), i = {};
 	try {
 		i = JSON.parse(await d(a.join(e, "package.json"), "utf8"));
 	} catch {}
 	let o = n.productName ?? r(i.name);
-	o && C(o);
+	o && w(o);
 	let s = {
 		name: o,
 		identifier: n.identifier ?? (o ? t(o) : void 0),
@@ -96,12 +96,20 @@ async function O(e) {
 }
 //#endregion
 //#region src/adapter/vite/captureOutput.mts
-function ie(e) {
+function A(e, t, n) {
+	return {
+		outDir: e,
+		entryFile: a.join(e, t.entryFile),
+		files: t.files,
+		changed: n
+	};
+}
+function re(e) {
 	return {
 		name: "inca:capture-output",
 		writeBundle(t, n) {
 			let r = Object.keys(n), i = Object.values(n).find((e) => e.type === "chunk" && e.isEntry);
-			if (!i) throw new S("ERR_INCA_BUILD_NO_ENTRY_CHUNK", "build produced no entry chunk");
+			if (!i) throw new C("ERR_INCA_BUILD_NO_ENTRY_CHUNK", "build produced no entry chunk");
 			e({
 				entryFile: i.fileName,
 				files: r
@@ -111,15 +119,15 @@ function ie(e) {
 }
 //#endregion
 //#region src/adapter/vite/emitConfig.mts
-var ae = "inca.json";
-function oe(e) {
+var ie = "inca.json";
+function ae(e) {
 	let t = JSON.stringify(e, void 0, 2), n = t === void 0 || t === "{}";
 	return {
 		name: "inca:emit-config",
 		generateBundle() {
 			n || this.emitFile({
 				type: "asset",
-				fileName: ae,
+				fileName: ie,
 				source: `${t}\n`
 			});
 		}
@@ -127,8 +135,8 @@ function oe(e) {
 }
 //#endregion
 //#region src/adapter/vite/logger.mts
-var se = "Build failed with ";
-function k(e, t) {
+var oe = "Build failed with ";
+function se(e, t) {
 	let n = /* @__PURE__ */ new WeakSet(), r = /* @__PURE__ */ new Set(), i = {
 		hasWarned: !1,
 		info(t) {
@@ -141,7 +149,7 @@ function k(e, t) {
 			r.has(e) || (r.add(e), i.warn(e));
 		},
 		error(e, r) {
-			i.hasWarned = !0, r?.error && n.add(r.error), !e.includes(se) && t.write(`${e.replace(/\n\s+at .*/g, "")}\n`);
+			i.hasWarned = !0, r?.error && n.add(r.error), !e.includes(oe) && t.write(`${e.replace(/\n\s+at .*/g, "")}\n`);
 		},
 		clearScreen() {},
 		hasErrorLogged(e) {
@@ -171,27 +179,27 @@ function ue(e = le) {
 			let r = e.find((e) => e.matches(n));
 			if (!r) return null;
 			let i = a.relative(process.cwd(), n.split("?")[0] ?? n);
-			throw new S(r.code, `${r.code}: ${i} uses ${r.name}, unsupported for now: ${r.hint}`);
+			throw new C(r.code, `${r.code}: ${i} uses ${r.name}, unsupported for now: ${r.hint}`);
 		}
 	};
 }
 //#endregion
 //#region src/adapter/vite/config.mts
 var de = "bundle.js";
-function A({ entry: e, outDir: t, mode: n, watch: r, onOutput: i, stdout: o, stderr: s, quiet: c, runtimeConfig: l }) {
+function j({ entry: e, outDir: t, mode: n, watch: r, onOutput: i, stdout: o, stderr: s, quiet: c, runtimeConfig: l }) {
 	return {
 		configFile: !1,
 		root: a.dirname(e),
 		mode: n,
 		clearScreen: !1,
 		logLevel: c ? "silent" : "info",
-		customLogger: k(o, s),
+		customLogger: se(o, s),
 		define: { "process.env.NODE_ENV": JSON.stringify(n) },
 		plugins: [
 			_({ template: { compilerOptions: { runtimeModuleName: "@vue/runtime-core" } } }),
 			ue(),
-			oe(l),
-			ie(i)
+			ae(l),
+			re(i)
 		],
 		build: {
 			lib: {
@@ -212,9 +220,9 @@ function A({ entry: e, outDir: t, mode: n, watch: r, onOutput: i, stdout: o, std
 }
 //#endregion
 //#region src/adapter/vite/build.mts
-async function fe({ entry: e, outDir: t, runtimeConfig: n, stdout: r = process.stdout, stderr: i = process.stderr, quiet: o = !1 }) {
-	let s;
-	if (await g(A({
+async function fe({ entry: e, outDir: t, runtimeConfig: n, stdout: r = process.stdout, stderr: i = process.stderr, quiet: a = !1 }) {
+	let o;
+	if (await g(j({
 		entry: e,
 		outDir: t,
 		runtimeConfig: n,
@@ -222,50 +230,46 @@ async function fe({ entry: e, outDir: t, runtimeConfig: n, stdout: r = process.s
 		watch: !1,
 		stdout: r,
 		stderr: i,
-		quiet: o,
+		quiet: a,
 		onOutput: (e) => {
-			s = {
-				outDir: t,
-				entryFile: a.join(t, e.entryFile),
-				files: e.files
-			};
+			o = A(t, e);
 		}
-	})), !s) throw new S("ERR_INCA_BUILD_NO_OUTPUT", "build produced no output");
-	return s;
+	})), !o) throw new C("ERR_INCA_BUILD_NO_OUTPUT", "build produced no output");
+	return o;
 }
 //#endregion
 //#region src/dev-client/hostBin.mts
-var j = "INCA_HOST_BIN";
-function M() {
+var M = "INCA_HOST_BIN";
+function N() {
 	let e = process.platform === "darwin" || process.platform === "linux" ? process.platform : void 0, t = process.arch === "arm64" || process.arch === "x64" ? process.arch : void 0;
 	return e && t ? `@incajs/host-${e}-${t}` : void 0;
 }
 function pe() {
-	let e = M();
+	let e = N();
 	if (e) try {
 		return v(import.meta.url).resolve(`${e}/bin/inca-host`);
 	} catch {
 		return;
 	}
 }
-function N() {
-	let e = process.env[j];
+function P() {
+	let e = process.env[M];
 	if (e) return e;
 	let t = pe();
 	if (t) return t;
-	let n = M();
-	throw new S("ERR_INCA_HOST_BIN_UNRESOLVED", `no inca-host binary found — ${n ? `no ${n} package is installed for it` : `this platform (${process.platform}/${process.arch}) has no published package`}, and ${j} isn't set to one`);
+	let n = N();
+	throw new C("ERR_INCA_HOST_BIN_UNRESOLVED", `no inca-host binary found — ${n ? `no ${n} package is installed for it` : `this platform (${process.platform}/${process.arch}) has no published package`}, and ${M} isn't set to one`);
 }
 //#endregion
 //#region src/dev-client/hostError.mts
-var P = class extends Error {
+var F = class extends Error {
 	code;
 	hostStack;
 	constructor(e, t, n = null) {
 		super(e), this.code = t, this.hostStack = n, this.name = "HostError";
 	}
 };
-function F(e) {
+function me(e) {
 	return typeof e == "object" && !!e && e.jsonrpc === "2.0";
 }
 //#endregion
@@ -282,7 +286,7 @@ var I = (e) => {
 		this.#e = e;
 	}
 	async start() {
-		let e = this.#e.hostBin ?? N(), t = y(e, ["--dev", this.#e.entryFile], { stdio: [
+		let e = this.#e.hostBin ?? P(), t = y(e, ["--dev", this.#e.entryFile], { stdio: [
 			"pipe",
 			"pipe",
 			"pipe"
@@ -307,7 +311,7 @@ var I = (e) => {
 			t(`[stray stdout] ${e}`);
 			return;
 		}
-		if (!F(n)) {
+		if (!me(n)) {
 			t(`[stray stdout] ${e}`);
 			return;
 		}
@@ -316,7 +320,7 @@ var I = (e) => {
 			return;
 		}
 		let r = this.#r.get(n.id);
-		r && (this.#r.delete(n.id), "error" in n ? r.reject(new P(n.error.message, n.error.code, n.error.data?.stack ?? null)) : r.resolve(n.result));
+		r && (this.#r.delete(n.id), "error" in n ? r.reject(new F(n.error.message, n.error.code, n.error.data?.stack ?? null)) : r.resolve(n.result));
 	}
 	#o(e, t, n) {
 		switch (e) {
@@ -343,21 +347,28 @@ var I = (e) => {
 		let t = b(e, "exit");
 		e.kill(), await t;
 	}
-	async call(e, t) {
-		let n = this.#t;
-		if (!n) throw Error("HostClient.start() has not been called");
-		let r = this.#n++, i = JSON.stringify({
+	async call(e, t, n) {
+		let r = this.#t;
+		if (!r) throw Error("HostClient.start() has not been called");
+		let i = this.#n++, a = JSON.stringify({
 			jsonrpc: "2.0",
-			id: r,
+			id: i,
 			method: e,
 			params: t
 		});
-		return new Promise((e, t) => {
-			this.#r.set(r, {
-				resolve: e,
-				reject: t
-			}), n.stdin.write(`${i}\n`, (e) => {
-				e && (this.#r.delete(r), t(e));
+		return new Promise((t, o) => {
+			let s = n === void 0 ? void 0 : setTimeout(() => {
+				this.#r.delete(i), o(/* @__PURE__ */ Error(`${e} timed out after ${String(n)}ms`));
+			}, n);
+			this.#r.set(i, {
+				resolve: (e) => {
+					clearTimeout(s), t(e);
+				},
+				reject: (e) => {
+					clearTimeout(s), o(e);
+				}
+			}), r.stdin.write(`${a}\n`, (e) => {
+				e && (clearTimeout(s), this.#r.delete(i), o(e));
 			});
 		});
 	}
@@ -366,7 +377,7 @@ var I = (e) => {
 		if (!t || t.exitCode !== null || t.signalCode !== null) return;
 		this.#i = !0;
 		let n = b(t, "exit");
-		this.call("shutdown").catch(() => {}), await Promise.race([n.then(() => "exited"), ee(e).then(() => "timeout")]) === "timeout" && (t.kill(), await n);
+		this.call("shutdown").catch(() => {}), await Promise.race([n.then(() => "exited"), S(e).then(() => "timeout")]) === "timeout" && (t.kill(), await n);
 	}
 }, R = "[inca]", z = new Intl.DateTimeFormat(void 0, {
 	hour: "numeric",
@@ -384,16 +395,16 @@ function H(e) {
 	let t = e.code;
 	return typeof t == "string" ? t : null;
 }
-function me(e) {
+function he(e) {
 	return /\bERR_INCA_[A-Z0-9_]+/.exec(e)?.[0] ?? null;
 }
-function he(e) {
+function ge(e) {
 	let t = e.stack;
 	if (!t) return null;
 	for (let n of [`${e.name}: ${e.message}`, e.message]) if (t.startsWith(n)) return t.slice(n.length).replace(/^\r?\n/, "") || null;
 	return t;
 }
-function ge(e) {
+function _e(e) {
 	let t = /^(?:\w*Error: )?(ERR_INCA_[A-Z0-9_]+): /.exec(e);
 	return t ? {
 		message: e.slice(t[0].length),
@@ -406,14 +417,14 @@ function ge(e) {
 	};
 }
 function U(e) {
-	return e instanceof P ? {
+	return e instanceof F ? {
 		message: e.message,
 		stack: e.hostStack,
 		code: H(e)
 	} : e instanceof Error ? {
 		message: e.message,
-		stack: he(e),
-		code: H(e) ?? me(e.message)
+		stack: ge(e),
+		code: H(e) ?? he(e.message)
 	} : {
 		message: String(e),
 		stack: null,
@@ -426,38 +437,33 @@ function W(e, t, n, r = {}) {
 }
 //#endregion
 //#region src/adapter/vite/watch.mts
-async function _e({ onBuild: e, onError: t, stdout: n = process.stdout, stderr: r = process.stderr, quiet: i = !1, ...o }) {
-	let { outDir: s } = o, c, l = await g(A({
-		...o,
+async function ve({ onBuild: e, onError: t, stdout: n = process.stdout, stderr: r = process.stderr, quiet: i = !1, ...a }) {
+	let { outDir: o } = a, s, c = await g(j({
+		...a,
 		watch: !0,
 		stdout: n,
 		stderr: r,
 		quiet: i,
 		onOutput: (t) => {
-			e({
-				outDir: s,
-				entryFile: a.join(s, t.entryFile),
-				files: t.files,
-				changed: c
-			}), c = void 0;
+			e(A(o, t, s)), s = void 0;
 		}
 	}));
-	return l.on("change", (e) => {
-		c ??= {
+	return c.on("change", (e) => {
+		s ??= {
 			file: e,
 			at: Date.now()
 		};
-	}), l.on("event", (e) => {
+	}), c.on("event", (e) => {
 		if (e.code !== "ERROR") return;
-		c = void 0;
+		s = void 0;
 		let { errors: n } = e.error;
-		t(ge(n?.[0]?.message ?? e.error.message));
-	}), { close: () => l.close() };
+		t(_e(n?.[0]?.message ?? e.error.message));
+	}), { close: () => c.close() };
 }
 //#endregion
 //#region src/defaultBundler.mts
 var G = {
-	watch: _e,
+	watch: ve,
 	build: fe
 };
 //#endregion
@@ -466,10 +472,10 @@ async function K(e) {
 	let t = a.join(e, "src/main.mts");
 	if (o(t)) return t;
 	let n = a.join(e, "src/App.vue");
-	if (o(n)) return ve(n, e);
-	throw new S("ERR_INCA_ENTRY_NOT_FOUND", `no app entry found — expected ${t} or ${n}`);
+	if (o(n)) return ye(n, e);
+	throw new C("ERR_INCA_ENTRY_NOT_FOUND", `no app entry found — expected ${t} or ${n}`);
 }
-async function ve(e, t) {
+async function ye(e, t) {
 	let n = a.join(t, "node_modules/.inca");
 	await u(n, { recursive: !0 });
 	let r = a.join(n, "entry.mts"), i = JSON.stringify(e.split(a.sep).join("/"));
@@ -478,7 +484,7 @@ async function ve(e, t) {
 //#endregion
 //#region src/build.mts
 async function q(e = {}) {
-	let t = e.cwd ?? process.cwd(), n = e.config ?? await T(t), r = n.outDir, i = e.bundler ?? G, a = e.entry ?? n.entry ?? await K(t), o = e.runtimeConfig ?? await O(t);
+	let t = e.cwd ?? process.cwd(), n = e.config ?? await E(t), r = n.outDir, i = e.bundler ?? G, a = e.entry ?? n.entry ?? await K(t), o = e.runtimeConfig ?? await k(t);
 	return i.build({
 		entry: a,
 		outDir: r,
@@ -489,41 +495,41 @@ async function q(e = {}) {
 }
 //#endregion
 //#region src/dev-lock.mts
-function J(e) {
+function be(e) {
 	return a.join(e, "node_modules/.inca/dev.pid");
 }
-function ye(e) {
+function xe(e) {
 	try {
 		return process.kill(e, 0), !0;
 	} catch (e) {
 		return e.code === "EPERM";
 	}
 }
-async function be(e) {
-	let t = J(e), n = Number.parseInt(await d(t, "utf8").catch(() => ""), 10);
-	if (Number.isInteger(n) && ye(n)) throw new S("ERR_INCA_DEV_RUNNING", `inca dev is already running for this app (pid ${String(n)})`);
+async function Se(e) {
+	let t = be(e), n = Number.parseInt(await d(t, "utf8").catch(() => ""), 10);
+	if (Number.isInteger(n) && xe(n)) throw new C("ERR_INCA_DEV_RUNNING", `inca dev is already running for this app (pid ${String(n)})`);
 	return await u(a.dirname(t), { recursive: !0 }), await m(t, String(process.pid)), () => p(t, { force: !0 });
 }
 //#endregion
 //#region src/plist.mts
-function Y(e) {
+function J(e) {
 	return e.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
-function xe(e) {
-	return typeof e == "boolean" ? e ? "<true/>" : "<false/>" : `<string>${Y(e)}</string>`;
+function Ce(e) {
+	return typeof e == "boolean" ? e ? "<true/>" : "<false/>" : `<string>${J(e)}</string>`;
 }
-function Se(e) {
+function we(e) {
 	return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-${Object.entries(e).map(([e, t]) => `\t<key>${Y(e)}</key>\n\t${xe(t)}`).join("\n")}\n</dict>
+${Object.entries(e).map(([e, t]) => `\t<key>${J(e)}</key>\n\t${Ce(t)}`).join("\n")}\n</dict>
 </plist>
 `;
 }
 //#endregion
 //#region src/macos-app.mts
-async function X(e) {
+async function Y(e) {
 	let { appPath: t, metadata: n, hostBin: r } = e;
 	await p(t, {
 		recursive: !0,
@@ -548,7 +554,7 @@ async function X(e) {
 		let e = a.basename(n.icon);
 		await c(n.icon, a.join(d, e)), h.CFBundleIconFile = e;
 	}
-	return await m(a.join(i, "Info.plist"), Se(h)), await m(a.join(i, "PkgInfo"), "APPL????"), {
+	return await m(a.join(i, "Info.plist"), we(h)), await m(a.join(i, "PkgInfo"), "APPL????"), {
 		appPath: t,
 		executablePath: f,
 		resourcesDir: d
@@ -556,30 +562,30 @@ async function X(e) {
 }
 //#endregion
 //#region src/dev.mts
-var Z = { timestamp: !0 }, Ce = ["ERR_INCA_PACKAGE_JSON_NOT_FOUND", "ERR_INCA_PRODUCT_NAME_MISSING"];
-async function we(e, t) {
+var X = { timestamp: !0 }, Te = 1e4, Ee = ["ERR_INCA_PACKAGE_JSON_NOT_FOUND", "ERR_INCA_PRODUCT_NAME_MISSING"];
+async function De(e, t) {
 	try {
-		return await E(e);
+		return await D(e);
 	} catch (e) {
-		if (!(e instanceof S) || !Ce.includes(e.code)) throw e;
-		V(t, `running unnamed — ${e.message}`, Z);
+		if (!(e instanceof C) || !Ee.includes(e.code)) throw e;
+		V(t, `running unnamed — ${e.message}`, X);
 		return;
 	}
 }
-async function Te(e, t, n, r) {
+async function Oe(e, t, n, r) {
 	if (process.platform === "darwin" && t) try {
-		return (await X({
+		return (await Y({
 			appPath: a.join(e, "node_modules/.inca", `${t.productName}.app`),
 			metadata: t,
-			hostBin: n ?? N(),
+			hostBin: n ?? P(),
 			link: !0
 		})).executablePath;
 	} catch (e) {
-		V(r, `running unbundled — ${U(e).message}`, Z);
+		V(r, `running unbundled — ${U(e).message}`, X);
 		return;
 	}
 }
-async function Ee(e, t) {
+async function ke(e, t) {
 	let n = new Set(t), r;
 	try {
 		r = await f(e, {
@@ -591,40 +597,43 @@ async function Ee(e, t) {
 	}
 	await Promise.all(r.filter((e) => e.isFile()).map((t) => a.relative(e, a.join(t.parentPath, t.name))).filter((e) => !n.has(e)).map((t) => p(a.join(e, t), { force: !0 })));
 }
-async function De(e) {
-	let t = e.cwd ?? process.cwd(), n = await T(t), r = await be(t);
+async function Z(e) {
+	let t = e.cwd ?? process.cwd(), n = await E(t), r = await Se(t);
 	try {
-		let r = n.outDir, i = e.bundler ?? G, o = e.stdout ?? process.stdout, s = e.stderr ?? process.stderr, c = e.entry ?? n.entry ?? await K(t), l = await we(t, o), u = l ? D(l) : await O(t), d = await Te(t, l, e.hostBin, o) ?? e.hostBin, f, p = !1, m = !1, g = Promise.resolve(), _ = () => {}, v = new Promise((e) => {
+		let r = n.outDir, i = e.bundler ?? G, o = e.stdout ?? process.stdout, s = e.stderr ?? process.stderr, c = e.entry ?? n.entry ?? await K(t), l = await De(t, o), u = l ? O(l) : await k(t), d = await Oe(t, l, e.hostBin, o) ?? e.hostBin, f, p = !1, m = !1, g = Promise.resolve(), _ = () => {}, v = new Promise((e) => {
 			_ = e;
 		});
 		async function y() {
 			try {
-				return await f?.call("reload"), !0;
+				return await f?.call("reload", void 0, Te), !0;
 			} catch (e) {
-				return W(s, "reload failed", U(e), Z), !1;
+				return W(s, "reload failed", U(e), X), !1;
 			}
 		}
 		async function b(e) {
-			if (await Ee(e.outDir, e.files), !f) {
-				let t = new L({
-					entryFile: e.entryFile,
-					hostBin: d,
-					onStderr: (e) => s.write(e),
-					onReady: () => {
-						p = !0, V(o, "ready", Z), m && (m = !1, y());
-					},
-					onAppError: (e) => W(s, "app error", e, Z),
-					onExit: () => {
-						V(o, "host exited — stopping", Z), _();
-					}
-				});
-				try {
-					await t.start();
-				} catch (e) {
-					W(s, "failed to start inca-host", U(e), Z);
-					return;
+			let t = new L({
+				entryFile: e,
+				hostBin: d,
+				onStderr: (e) => s.write(e),
+				onReady: () => {
+					p = !0, V(o, "ready", X), m && (m = !1, y());
+				},
+				onAppError: (e) => W(s, "app error", e, X),
+				onExit: () => {
+					V(o, "host exited — stopping", X), _();
 				}
-				f = t;
+			});
+			try {
+				await t.start();
+			} catch (e) {
+				W(s, "failed to start inca-host", U(e), X);
+				return;
+			}
+			f = t;
+		}
+		async function x(e) {
+			if (await ke(e.outDir, e.files), !f) {
+				await b(e.entryFile);
 				return;
 			}
 			if (!p) {
@@ -633,10 +642,10 @@ async function De(e) {
 			}
 			if (await y() && e.changed) {
 				let n = h("dim", a.relative(t, e.changed.file), { stream: o }), r = Date.now() - e.changed.at;
-				V(o, `${h("green", "reload")} ${n} (${r}ms)`, Z);
+				V(o, `${h("green", "reload")} ${n} (${r}ms)`, X);
 			}
 		}
-		let x = await i.watch({
+		let S = await i.watch({
 			entry: c,
 			outDir: r,
 			runtimeConfig: u,
@@ -644,23 +653,23 @@ async function De(e) {
 			stdout: o,
 			stderr: s,
 			onBuild: (e) => {
-				g = g.then(() => b(e));
+				g = g.then(() => x(e));
 			},
 			onError: (e) => {
-				W(s, "build failed", e, Z);
+				W(s, "build failed", e, X);
 			}
 		});
-		e.signal.aborted ? _() : e.signal.addEventListener("abort", () => _(), { once: !0 }), await v, await g, await f?.stop(), await x.close();
+		e.signal.aborted ? _() : e.signal.addEventListener("abort", () => _(), { once: !0 }), await v, await g, await f?.stop(), await S.close();
 	} finally {
 		await r();
 	}
 }
 //#endregion
 //#region src/package.mts
-function Oe() {
+function Ae() {
 	if (process.platform === "darwin") return "macos";
 	if (process.platform === "linux") return "linux";
-	throw new S("ERR_INCA_PLATFORM_UNSUPPORTED", `inca package doesn't support ${process.platform} yet`);
+	throw new C("ERR_INCA_PLATFORM_UNSUPPORTED", `inca package doesn't support ${process.platform} yet`);
 }
 async function Q(e, t) {
 	await Promise.all(e.files.map(async (n) => {
@@ -668,15 +677,15 @@ async function Q(e, t) {
 		await u(a.dirname(r), { recursive: !0 }), await c(a.join(e.outDir, n), r);
 	}));
 }
-async function ke({ metadata: e, output: t, hostBin: n }) {
-	let { appPath: r, resourcesDir: i } = await X({
+async function je({ metadata: e, output: t, hostBin: n }) {
+	let { appPath: r, resourcesDir: i } = await Y({
 		appPath: a.join(t.outDir, `${e.productName}.app`),
 		metadata: e,
 		hostBin: n
 	});
 	return await Q(t, i), r;
 }
-async function Ae({ metadata: t, output: n, hostBin: r }) {
+async function Me({ metadata: t, output: n, hostBin: r }) {
 	let i = e(t.productName), o = a.join(n.outDir, i);
 	await p(o, {
 		recursive: !0,
@@ -685,33 +694,33 @@ async function Ae({ metadata: t, output: n, hostBin: r }) {
 	let l = a.join(o, i);
 	return await c(r, l), await s(l, 493), await Q(n, o), o;
 }
-async function je(e = {}) {
-	let t = e.cwd ?? process.cwd(), n = e.stdout ?? process.stdout, r = e.target ?? Oe(), i = await E(t);
+async function Ne(e = {}) {
+	let t = e.cwd ?? process.cwd(), n = e.stdout ?? process.stdout, r = e.target ?? Ae(), i = await D(t);
 	i.usedPackageJsonKey && V(n, "the \"inca\" key in package.json is deprecated — move these settings to inca.config.ts"), i.identifierIsDefault && V(n, `no "identifier" set in inca.config.ts — using generated identifier ${i.identifier}`);
 	let a = await q({
 		cwd: t,
 		entry: e.entry,
 		config: i,
-		runtimeConfig: D(i),
+		runtimeConfig: O(i),
 		bundler: e.bundler,
 		stdout: n,
 		stderr: e.stderr
-	}), s = e.hostBin ?? N();
-	if (!o(s)) throw new S("ERR_INCA_HOST_BIN_NOT_FOUND", `no host binary at ${s} — check that it was built and is executable`);
+	}), s = e.hostBin ?? P();
+	if (!o(s)) throw new C("ERR_INCA_HOST_BIN_NOT_FOUND", `no host binary at ${s} — check that it was built and is executable`);
 	let c = {
 		metadata: i,
 		output: a,
 		hostBin: s
 	};
-	return { appPath: r === "macos" ? await ke(c) : await Ae(c) };
+	return { appPath: r === "macos" ? await je(c) : await Me(c) };
 }
 //#endregion
 //#region src/cli.mts
-var Me = "Usage: inca <dev|build|package>";
+var Pe = "Usage: inca <dev|build|package>";
 function $(e) {
 	return a.relative(process.cwd(), e);
 }
-async function Ne(e = process.argv) {
+async function Fe(e = process.argv) {
 	let t = e[2];
 	if (t === "build") {
 		try {
@@ -724,7 +733,7 @@ async function Ne(e = process.argv) {
 	}
 	if (t === "package") {
 		try {
-			let { appPath: e } = await je();
+			let { appPath: e } = await Ne();
 			V(process.stdout, `packaged ${$(e)}`);
 		} catch (e) {
 			W(process.stderr, "package failed", U(e)), process.exitCode = 1;
@@ -732,7 +741,7 @@ async function Ne(e = process.argv) {
 		return;
 	}
 	if (t !== "dev") {
-		process.stderr.write(`${Me}\n`), process.exitCode = 1;
+		process.stderr.write(`${Pe}\n`), process.exitCode = 1;
 		return;
 	}
 	let n = new AbortController(), r = () => {
@@ -740,10 +749,10 @@ async function Ne(e = process.argv) {
 	};
 	process.on("SIGINT", r), process.on("SIGTERM", r);
 	try {
-		await De({ signal: n.signal });
+		await Z({ signal: n.signal });
 	} catch (e) {
 		W(process.stderr, "dev failed", U(e), { timestamp: !0 }), process.exitCode = 1;
 	}
 }
 //#endregion
-export { Ne as run };
+export { Fe as run };

package/dist/dev-client/hostClient.d.mts

@@ -44,8 +44,14 @@ export declare class HostClient {
      * binary doesn't exist).
      */
     start(): Promise<void>;
-    /** Sends a request and resolves with its result once the host answers. */
-    call(method: string, params?: unknown): Promise<unknown>;
+    /**
+     * Sends a request and resolves with its result once the host answers.
+     * With `timeoutMs`, rejects once that much time passes with no answer —
+     * the host answers on the same thread that runs the app's JS, so a
+     * wedged app leaves a call pending forever otherwise (PROTOCOL.md:
+     * "every response a client waits for needs a deadline").
+     */
+    call(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;
     /**
      * Asks the host to `shutdown` and waits for the child to actually exit —
      * that exit is the real acknowledgement, not the response. Kills it once

package/dist/index.d.mts

@@ -1,2 +1 @@
-export type { BuildOptions, BuildOutput, Bundler, BundlerOptions, Watcher, } from './adapter/types.mts';
 export type { ResolvedAppConfig } from './config/loader.mts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Dev server, bundler, and packager for Incarnative.js apps.",
   "keywords": [
     "bundler",
@@ -68,9 +68,9 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.4",
-    "@incajs/host-linux-arm64": "0.0.4",
-    "@incajs/host-linux-x64": "0.0.4"
+    "@incajs/host-darwin-arm64": "0.0.5",
+    "@incajs/host-linux-arm64": "0.0.5",
+    "@incajs/host-linux-x64": "0.0.5"
   },
   "engines": {
     "node": ">=22.18"