@incajs/cli 0.0.3 → 0.0.4

package/README.md

@@ -43,7 +43,7 @@ export default defineConfig({
   productName: "Click Counter",
   // macOS's CFBundleIdentifier or equivalent
   identifier: "com.example.click-counter",
-  // the packaged app's icon file
+  // the app's icon file
   icon: "assets/icon.icns",
 });
 ```
@@ -51,6 +51,10 @@ export default defineConfig({
 An `identifier` should be world-unique, so `inca package` prints a note
 when it falls back to the generated one rather than using it silently.
 
+On macOS, `inca dev` launches the app under its `productName`, `icon` and
+`identifier`, so the Dock and the menu bar show the same app they will
+once it is packaged.
+
 ## Requirements
 
 `inca`'s host binary is pulled in automatically as a platform-specific

package/dist/adapter/types.d.mts

@@ -9,6 +9,11 @@ export interface BundlerOptions {
     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. */
@@ -36,6 +41,11 @@ export interface BuildOptions {
     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;
     /** 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`. */

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

@@ -5,4 +5,4 @@ export type { BuildOptions, BuildOutput } from '../types.mts';
  * rejects on failure rather than reporting it through a callback. Never
  * starts or talks to `inca-host` — that's `dev.mts`'s job.
  */
-export declare function build({ entry, outDir, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;
+export declare function build({ entry, outDir, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;

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

@@ -18,6 +18,8 @@ export interface ResolveConfigOptions {
     stderr: NodeJS.WritableStream;
     /** Silences the bundler's progress output — see the `quiet` option in `../types.mts`. */
     quiet: boolean;
+    /** Written beside the entry — see the `runtimeConfig` option in `../types.mts`. */
+    runtimeConfig?: unknown;
 }
 /**
  * Builds the Vite config shared by `watch` and `build`, compiling `.vue`
@@ -29,4 +31,4 @@ export interface ResolveConfigOptions {
  * the entry, named by `chunkFileNames`/`assetFileNames` below, rather than
  * failing the build.
  */
-export declare function resolveViteConfig({ entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, }: ResolveConfigOptions): InlineConfig;
+export declare function resolveViteConfig({ entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;

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

@@ -0,0 +1,11 @@
+import { Plugin } from 'vite';
+/** The file a build writes its app's config to, beside the entry. */
+export declare const CONFIG_FILE_NAME = "inca.json";
+/**
+ * Writes `config` to `inca.json` beside the entry, for `inca-host` to read
+ * when it starts the app.
+ *
+ * @param config - any JSON-serializable value; no file is written for
+ * `undefined` or an object with no keys
+ */
+export declare function emitConfig(config: unknown): Plugin;

package/dist/build.d.mts

@@ -1,5 +1,5 @@
 import { Bundler, BuildOutput } from './adapter/types.mts';
-import { ResolvedBuildConfig } from './config/loader.mts';
+import { ResolvedBuildConfig, RuntimeConfig } from './config/loader.mts';
 export interface BuildAppOptions {
     /** The app's root directory. Defaults to `process.cwd()`. */
     cwd?: string;
@@ -12,6 +12,8 @@ export interface BuildAppOptions {
     bundler?: Bundler;
     /** An already-resolved config — lets `packageApp` avoid loading it twice. */
     config?: ResolvedBuildConfig;
+    /** What the build carries for `inca-host` to read. Resolved from the app's config when absent. */
+    runtimeConfig?: RuntimeConfig;
     /** 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`. */

package/dist/chunks/{defaults-D_1rymg4.js → defaults-DNvHueCI.js}

@@ -1002,7 +1002,7 @@ async function Wt(e) {
 			name: e.rcFile,
 			dir: e.cwd
 		})), e.globalRc) {
-			let { findWorkspaceDir: t } = await import("./dist-DZ5asakr.js"), r = await t(e.cwd).catch(() => {});
+			let { findWorkspaceDir: t } = await import("./dist-BvTGFq3F.js"), r = await t(e.cwd).catch(() => {});
 			r && n.push(Z({
 				name: e.rcFile,
 				dir: r
@@ -1014,7 +1014,7 @@ async function Wt(e) {
 		r.rc = t({}, ...n);
 	}
 	if (e.packageJson) {
-		let n = (Array.isArray(e.packageJson) ? e.packageJson : [typeof e.packageJson == "string" ? e.packageJson : e.name]).filter((e) => e && typeof e == "string"), { readPackageJSON: i } = await import("./dist-DZ5asakr.js"), a = await i(e.cwd).catch(() => {});
+		let n = (Array.isArray(e.packageJson) ? e.packageJson : [typeof e.packageJson == "string" ? e.packageJson : e.name]).filter((e) => e && typeof e == "string"), { readPackageJSON: i } = await import("./dist-BvTGFq3F.js"), a = await i(e.cwd).catch(() => {});
 		r.packageJson = t({}, ...n.map((e) => a?.[e]));
 	}
 	let a = {};
@@ -1171,14 +1171,16 @@ function Qt(e) {
 	let t = e.indexOf("/");
 	return e.startsWith("@") && t !== -1 ? e.slice(t + 1) : e;
 }
-function $t(e) {
-	return e.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
+var $t = "app";
 function en(e) {
-	return e ? Qt(e) : void 0;
+	let t = e.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	return t === "" ? $t : t;
 }
 function tn(e) {
-	return `org.inca.${$t(e)}`;
+	return e ? Qt(e) : void 0;
+}
+function nn(e) {
+	return `org.inca.${en(e)}`;
 }
 //#endregion
-export { Xt as a, T as c, x as d, C as f, $t as i, w as l, tn as n, Wt as o, en as r, at as s, Zt as t, S as u };
+export { Xt as a, T as c, x as d, C as f, en as i, w as l, nn as n, Wt as o, tn as r, at as s, Zt as t, S as u };

package/dist/chunks/{dist-DZ5asakr.js → dist-BvTGFq3F.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./jsonc-BdzClvC8.js";
-import { c as t, d as n, f as r, l as i, s as a, u as o } from "./defaults-D_1rymg4.js";
+import { c as t, d as n, f as r, l as i, s as a, u as o } from "./defaults-DNvHueCI.js";
 import { n as s, t as c } from "./_format-BKs7bsc4.js";
 import { promises as l, statSync as u } from "node:fs";
 import "node:fs/promises";

package/dist/cli.js

@@ -1,15 +1,15 @@
-import { i as e, n as t, o as n, r, t as i } from "./chunks/defaults-D_1rymg4.js";
+import { i as e, n as t, o as n, r, t as i } from "./chunks/defaults-DNvHueCI.js";
 import a from "node:path";
 import { existsSync as o } from "node:fs";
-import { chmod as s, cp as c, mkdir as l, readFile as u, readdir as d, rm as f, writeFile as p } from "node:fs/promises";
-import { styleText as m } from "node:util";
-import { build as h } from "vite";
-import g from "@vitejs/plugin-vue";
-import { createRequire as _ } from "node:module";
-import { spawn as v } from "node:child_process";
-import { once as y } from "node:events";
-import b from "node:readline";
-import { setTimeout as x } from "node:timers/promises";
+import { chmod as s, cp as c, link as l, mkdir as u, readFile as d, readdir as f, rm as p, writeFile as m } from "node:fs/promises";
+import { styleText as h } from "node:util";
+import { build as g } from "vite";
+import _ from "@vitejs/plugin-vue";
+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";
 //#region src/error.mts
 var S = class extends Error {
 	code;
@@ -17,58 +17,86 @@ var S = class extends Error {
 	constructor(e, t) {
 		super(t), this.code = e;
 	}
-};
-//#endregion
-//#region src/config/loader.mts
-async function C(e) {
-	let { config: t } = await n({
+}, te = {
+	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);
+}
+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 \`/\\:*?"<>|\``);
+}
+async function w(e) {
+	let { config: t, layers: r } = await n({
 		cwd: e,
-		name: "inca",
-		packageJson: "inca",
-		rcFile: !1,
-		globalRc: !1,
-		giget: !1,
-		extend: !1
-	});
+		...te
+	}), 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);
 	return {
 		entry: t.entry ? a.resolve(e, t.entry) : void 0,
 		outDir: a.resolve(e, t.outDir ?? i.outDir)
 	};
 }
-async function ee(e) {
-	let s = a.join(e, "package.json"), c;
+async function E(e) {
+	let n = a.join(e, "package.json"), s;
 	try {
-		c = await u(s, "utf8");
+		s = await d(n, "utf8");
 	} catch {
-		throw new S("ERR_INCA_PACKAGE_JSON_NOT_FOUND", `no package.json found at ${s}`);
+		throw new S("ERR_INCA_PACKAGE_JSON_NOT_FOUND", `no package.json found at ${n}`);
 	}
-	let l = JSON.parse(c), { config: d, layers: f } = await n({
-		cwd: e,
-		name: "inca",
-		packageJson: "inca",
-		rcFile: !1,
-		globalRc: !1,
-		giget: !1,
-		extend: !1
-	}), p = f?.find((e) => e.configFile === "package.json"), m = Object.keys(p?.config ?? {}).length > 0, h = d.productName ?? r(l.name);
-	if (!h) throw new S("ERR_INCA_PRODUCT_NAME_MISSING", `${s} needs a "name", or "productName" in inca.config.ts`);
-	let g = d.version ?? l.version ?? i.version, _ = d.identifier ?? t(h), v;
-	if (d.icon && (v = a.resolve(e, d.icon), !o(v))) throw new S("ERR_INCA_ICON_NOT_FOUND", `"icon" points to ${v}, which doesn't exist`);
-	let y = d.entry ? a.resolve(e, d.entry) : void 0, b = a.resolve(e, d.outDir ?? i.outDir);
+	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 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`);
+	let g = l.entry ? a.resolve(e, l.entry) : void 0, _ = a.resolve(e, l.outDir ?? i.outDir);
 	return {
-		productName: h,
-		identifier: _,
-		identifierIsDefault: d.identifier === void 0,
-		version: g,
-		icon: v,
-		entry: y,
-		outDir: b,
-		usedPackageJsonKey: m
+		productName: f,
+		identifier: m,
+		identifierIsDefault: l.identifier === void 0,
+		version: p,
+		icon: h,
+		window: l.window,
+		entry: g,
+		outDir: _,
+		usedPackageJsonKey: u
 	};
 }
+function D(e) {
+	return {
+		name: e.productName,
+		identifier: e.identifier,
+		window: e.window
+	};
+}
+async function O(e) {
+	let { config: n } = await w(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);
+	let s = {
+		name: o,
+		identifier: n.identifier ?? (o ? t(o) : void 0),
+		window: n.window
+	};
+	return Object.values(s).some((e) => e !== void 0) ? s : void 0;
+}
 //#endregion
 //#region src/adapter/vite/captureOutput.mts
-function te(e) {
+function ie(e) {
 	return {
 		name: "inca:capture-output",
 		writeBundle(t, n) {
@@ -82,9 +110,25 @@ function te(e) {
 	};
 }
 //#endregion
+//#region src/adapter/vite/emitConfig.mts
+var ae = "inca.json";
+function oe(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,
+				source: `${t}\n`
+			});
+		}
+	};
+}
+//#endregion
 //#region src/adapter/vite/logger.mts
-var ne = "Build failed with ";
-function re(e, t) {
+var se = "Build failed with ";
+function k(e, t) {
 	let n = /* @__PURE__ */ new WeakSet(), r = /* @__PURE__ */ new Set(), i = {
 		hasWarned: !1,
 		info(t) {
@@ -97,7 +141,7 @@ function re(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(ne) && t.write(`${e.replace(/\n\s+at .*/g, "")}\n`);
+			i.hasWarned = !0, r?.error && n.add(r.error), !e.includes(se) && t.write(`${e.replace(/\n\s+at .*/g, "")}\n`);
 		},
 		clearScreen() {},
 		hasErrorLogged(e) {
@@ -108,7 +152,7 @@ function re(e, t) {
 }
 //#endregion
 //#region src/adapter/vite/unsupported.mts
-var w = /\.(?:css|pcss|postcss|sass|scss|less|styl|stylus)(?:\?|$)/, T = [{
+var ce = /\.(?:css|pcss|postcss|sass|scss|less|styl|stylus)(?:\?|$)/, le = [{
 	code: "ERR_INCA_UNSUPPORTED_STYLE",
 	name: "a <style> block",
 	matches: (e) => e.includes("vue&type=style"),
@@ -116,10 +160,10 @@ var w = /\.(?:css|pcss|postcss|sass|scss|less|styl|stylus)(?:\?|$)/, T = [{
 }, {
 	code: "ERR_INCA_UNSUPPORTED_STYLESHEET",
 	name: "a stylesheet import",
-	matches: (e) => w.test(e),
+	matches: (e) => ce.test(e),
 	hint: "the renderer applies no stylesheet — use a :style binding instead"
 }];
-function E(e = T) {
+function ue(e = le) {
 	return {
 		name: "inca:reject-unsupported",
 		enforce: "pre",
@@ -133,26 +177,27 @@ function E(e = T) {
 }
 //#endregion
 //#region src/adapter/vite/config.mts
-var D = "bundle.js";
-function O({ entry: e, outDir: t, mode: n, watch: r, onOutput: i, stdout: o, stderr: s, quiet: c }) {
+var de = "bundle.js";
+function A({ 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: re(o, s),
+		customLogger: k(o, s),
 		define: { "process.env.NODE_ENV": JSON.stringify(n) },
 		plugins: [
-			g({ template: { compilerOptions: { runtimeModuleName: "@vue/runtime-core" } } }),
-			E(),
-			te(i)
+			_({ template: { compilerOptions: { runtimeModuleName: "@vue/runtime-core" } } }),
+			ue(),
+			oe(l),
+			ie(i)
 		],
 		build: {
 			lib: {
 				entry: e,
 				formats: ["es"],
-				fileName: () => D
+				fileName: () => de
 			},
 			outDir: t,
 			emptyOutDir: n === "production",
@@ -167,48 +212,49 @@ function O({ entry: e, outDir: t, mode: n, watch: r, onOutput: i, stdout: o, std
 }
 //#endregion
 //#region src/adapter/vite/build.mts
-async function k({ entry: e, outDir: t, stdout: n = process.stdout, stderr: r = process.stderr, quiet: i = !1 }) {
-	let o;
-	if (await h(O({
+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({
 		entry: e,
 		outDir: t,
+		runtimeConfig: n,
 		mode: "production",
 		watch: !1,
-		stdout: n,
-		stderr: r,
-		quiet: i,
+		stdout: r,
+		stderr: i,
+		quiet: o,
 		onOutput: (e) => {
-			o = {
+			s = {
 				outDir: t,
 				entryFile: a.join(t, e.entryFile),
 				files: e.files
 			};
 		}
-	})), !o) throw new S("ERR_INCA_BUILD_NO_OUTPUT", "build produced no output");
-	return o;
+	})), !s) throw new S("ERR_INCA_BUILD_NO_OUTPUT", "build produced no output");
+	return s;
 }
 //#endregion
 //#region src/dev-client/hostBin.mts
-var A = "INCA_HOST_BIN";
-function j() {
+var j = "INCA_HOST_BIN";
+function M() {
 	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 M() {
-	let e = j();
+function pe() {
+	let e = M();
 	if (e) try {
-		return _(import.meta.url).resolve(`${e}/bin/inca-host`);
+		return v(import.meta.url).resolve(`${e}/bin/inca-host`);
 	} catch {
 		return;
 	}
 }
 function N() {
-	let e = process.env[A];
+	let e = process.env[j];
 	if (e) return e;
-	let t = M();
+	let t = pe();
 	if (t) return t;
-	let n = j();
-	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 ${A} isn't set to one`);
+	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`);
 }
 //#endregion
 //#region src/dev-client/hostError.mts
@@ -219,14 +265,14 @@ var P = class extends Error {
 		super(e), this.code = t, this.hostStack = n, this.name = "HostError";
 	}
 };
-function ie(e) {
+function F(e) {
 	return typeof e == "object" && !!e && e.jsonrpc === "2.0";
 }
 //#endregion
 //#region src/dev-client/hostClient.mts
-var ae = (e) => {
+var I = (e) => {
 	process.stderr.write(e.endsWith("\n") ? e : `${e}\n`);
-}, oe = class {
+}, L = class {
 	#e;
 	#t;
 	#n = 1;
@@ -236,22 +282,22 @@ var ae = (e) => {
 		this.#e = e;
 	}
 	async start() {
-		let e = this.#e.hostBin ?? N(), t = v(e, ["--dev", this.#e.entryFile], { stdio: [
+		let e = this.#e.hostBin ?? N(), t = y(e, ["--dev", this.#e.entryFile], { stdio: [
 			"pipe",
 			"pipe",
 			"pipe"
 		] });
 		this.#t = t;
-		let n = this.#e.onStderr ?? ae;
+		let n = this.#e.onStderr ?? I;
 		t.stderr.setEncoding("utf8"), t.stderr.on("data", (e) => n(e)), t.stdin.on("error", (e) => {
 			e.code !== "EPIPE" && n(`inca-host stdin: ${e.message}\n`);
-		}), b.createInterface({ input: t.stdout }).on("line", (e) => {
+		}), x.createInterface({ input: t.stdout }).on("line", (e) => {
 			this.#a(e, n);
 		}), t.on("exit", (e, t) => {
 			let n = /* @__PURE__ */ Error(`inca-host exited (code=${String(e)}, signal=${String(t)}) before answering`);
 			for (let { reject: e } of this.#r.values()) e(n);
 			this.#r.clear(), this.#i || this.#e.onExit?.(e, t);
-		}), await y(t, "spawn");
+		}), await b(t, "spawn");
 	}
 	#a(e, t) {
 		let n;
@@ -261,7 +307,7 @@ var ae = (e) => {
 			t(`[stray stdout] ${e}`);
 			return;
 		}
-		if (!ie(n)) {
+		if (!F(n)) {
 			t(`[stray stdout] ${e}`);
 			return;
 		}
@@ -294,7 +340,7 @@ var ae = (e) => {
 	}
 	async #s(e) {
 		this.#i = !0;
-		let t = y(e, "exit");
+		let t = b(e, "exit");
 		e.kill(), await t;
 	}
 	async call(e, t) {
@@ -319,35 +365,35 @@ var ae = (e) => {
 		let t = this.#t;
 		if (!t || t.exitCode !== null || t.signalCode !== null) return;
 		this.#i = !0;
-		let n = y(t, "exit");
-		this.call("shutdown").catch(() => {}), await Promise.race([n.then(() => "exited"), x(e).then(() => "timeout")]) === "timeout" && (t.kill(), await n);
+		let n = b(t, "exit");
+		this.call("shutdown").catch(() => {}), await Promise.race([n.then(() => "exited"), ee(e).then(() => "timeout")]) === "timeout" && (t.kill(), await n);
 	}
-}, F = "[inca]", I = new Intl.DateTimeFormat(void 0, {
+}, R = "[inca]", z = new Intl.DateTimeFormat(void 0, {
 	hour: "numeric",
 	minute: "numeric",
 	second: "numeric"
 });
-function L(e, t, n) {
-	let r = m(["bold", n], F, { stream: e });
-	return t.timestamp ? `${m("dim", I.format(/* @__PURE__ */ new Date()), { stream: e })} ${r}` : r;
+function B(e, t, n) {
+	let r = h(["bold", n], R, { stream: e });
+	return t.timestamp ? `${h("dim", z.format(/* @__PURE__ */ new Date()), { stream: e })} ${r}` : r;
 }
-function R(e, t, n = {}) {
-	e.write(`${L(e, n, "cyan")} ${t}\n`);
+function V(e, t, n = {}) {
+	e.write(`${B(e, n, "cyan")} ${t}\n`);
 }
-function z(e) {
+function H(e) {
 	let t = e.code;
 	return typeof t == "string" ? t : null;
 }
-function B(e) {
+function me(e) {
 	return /\bERR_INCA_[A-Z0-9_]+/.exec(e)?.[0] ?? null;
 }
-function V(e) {
+function he(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 H(e) {
+function ge(e) {
 	let t = /^(?:\w*Error: )?(ERR_INCA_[A-Z0-9_]+): /.exec(e);
 	return t ? {
 		message: e.slice(t[0].length),
@@ -363,11 +409,11 @@ function U(e) {
 	return e instanceof P ? {
 		message: e.message,
 		stack: e.hostStack,
-		code: z(e)
+		code: H(e)
 	} : e instanceof Error ? {
 		message: e.message,
-		stack: V(e),
-		code: z(e) ?? B(e.message)
+		stack: he(e),
+		code: H(e) ?? me(e.message)
 	} : {
 		message: String(e),
 		stack: null,
@@ -375,13 +421,13 @@ function U(e) {
 	};
 }
 function W(e, t, n, r = {}) {
-	let i = n.code ? ` (${m("bold", n.code, { stream: e })})` : "";
-	e.write(`${L(e, r, "red")} ${t}${i}: ${n.message}\n`), n.stack && e.write(`${n.stack}\n`);
+	let i = n.code ? ` (${h("bold", n.code, { stream: e })})` : "";
+	e.write(`${B(e, r, "red")} ${t}${i}: ${n.message}\n`), n.stack && e.write(`${n.stack}\n`);
 }
 //#endregion
 //#region src/adapter/vite/watch.mts
-async function G({ onBuild: e, onError: t, stdout: n = process.stdout, stderr: r = process.stderr, quiet: i = !1, ...o }) {
-	let { outDir: s } = o, c, l = await h(O({
+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,
 		watch: !0,
 		stdout: n,
@@ -405,204 +451,248 @@ async function G({ onBuild: e, onError: t, stdout: n = process.stdout, stderr: r
 		if (e.code !== "ERROR") return;
 		c = void 0;
 		let { errors: n } = e.error;
-		t(H(n?.[0]?.message ?? e.error.message));
+		t(ge(n?.[0]?.message ?? e.error.message));
 	}), { close: () => l.close() };
 }
 //#endregion
 //#region src/defaultBundler.mts
-var K = {
-	watch: G,
-	build: k
+var G = {
+	watch: _e,
+	build: fe
 };
 //#endregion
 //#region src/entry.mts
-async function q(e) {
+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 se(n, e);
+	if (o(n)) return ve(n, e);
 	throw new S("ERR_INCA_ENTRY_NOT_FOUND", `no app entry found — expected ${t} or ${n}`);
 }
-async function se(e, t) {
+async function ve(e, t) {
 	let n = a.join(t, "node_modules/.inca");
-	await l(n, { recursive: !0 });
+	await u(n, { recursive: !0 });
 	let r = a.join(n, "entry.mts"), i = JSON.stringify(e.split(a.sep).join("/"));
-	return await p(r, `import { createIncaApp } from "incajs/vue";\nimport App from ${i};\ncreateIncaApp(App).mount();\n`), r;
+	return await m(r, `import { createIncaApp } from "incajs/vue";\nimport App from ${i};\ncreateIncaApp(App).mount();\n`), r;
 }
 //#endregion
 //#region src/build.mts
-async function J(e = {}) {
-	let t = e.cwd ?? process.cwd(), n = e.config ?? await C(t), r = n.outDir, i = e.bundler ?? K, a = e.entry ?? n.entry ?? await q(t);
+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);
 	return i.build({
 		entry: a,
 		outDir: r,
+		runtimeConfig: o,
 		stdout: e.stdout,
 		stderr: e.stderr
 	});
 }
 //#endregion
 //#region src/dev-lock.mts
-function ce(e) {
+function J(e) {
 	return a.join(e, "node_modules/.inca/dev.pid");
 }
-function le(e) {
+function ye(e) {
 	try {
 		return process.kill(e, 0), !0;
 	} catch (e) {
 		return e.code === "EPERM";
 	}
 }
-async function ue(e) {
-	let t = ce(e), n = Number.parseInt(await u(t, "utf8").catch(() => ""), 10);
-	if (Number.isInteger(n) && le(n)) throw new S("ERR_INCA_DEV_RUNNING", `inca dev is already running for this app (pid ${String(n)})`);
-	return await l(a.dirname(t), { recursive: !0 }), await p(t, String(process.pid)), () => f(t, { force: !0 });
+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)})`);
+	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) {
+	return e.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function xe(e) {
+	return typeof e == "boolean" ? e ? "<true/>" : "<false/>" : `<string>${Y(e)}</string>`;
+}
+function Se(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>
+</plist>
+`;
+}
+//#endregion
+//#region src/macos-app.mts
+async function X(e) {
+	let { appPath: t, metadata: n, hostBin: r } = e;
+	await p(t, {
+		recursive: !0,
+		force: !0
+	});
+	let i = a.join(t, "Contents"), o = a.join(i, "MacOS"), d = a.join(i, "Resources");
+	await u(o, { recursive: !0 }), await u(d, { recursive: !0 });
+	let f = a.join(o, n.productName);
+	e.link ? await l(r, f).catch(() => c(r, f)) : await c(r, f), await s(f, 493);
+	let h = {
+		CFBundleName: n.productName,
+		CFBundleDisplayName: n.productName,
+		CFBundleExecutable: n.productName,
+		CFBundleIdentifier: n.identifier,
+		CFBundleVersion: n.version,
+		CFBundleShortVersionString: n.version,
+		CFBundlePackageType: "APPL",
+		CFBundleInfoDictionaryVersion: "6.0",
+		NSHighResolutionCapable: !0
+	};
+	if (n.icon) {
+		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????"), {
+		appPath: t,
+		executablePath: f,
+		resourcesDir: d
+	};
 }
 //#endregion
 //#region src/dev.mts
-var Y = { timestamp: !0 };
-async function de(e, t) {
+var Z = { timestamp: !0 }, Ce = ["ERR_INCA_PACKAGE_JSON_NOT_FOUND", "ERR_INCA_PRODUCT_NAME_MISSING"];
+async function we(e, t) {
+	try {
+		return await E(e);
+	} catch (e) {
+		if (!(e instanceof S) || !Ce.includes(e.code)) throw e;
+		V(t, `running unnamed — ${e.message}`, Z);
+		return;
+	}
+}
+async function Te(e, t, n, r) {
+	if (process.platform === "darwin" && t) try {
+		return (await X({
+			appPath: a.join(e, "node_modules/.inca", `${t.productName}.app`),
+			metadata: t,
+			hostBin: n ?? N(),
+			link: !0
+		})).executablePath;
+	} catch (e) {
+		V(r, `running unbundled — ${U(e).message}`, Z);
+		return;
+	}
+}
+async function Ee(e, t) {
 	let n = new Set(t), r;
 	try {
-		r = await d(e, {
+		r = await f(e, {
 			recursive: !0,
 			withFileTypes: !0
 		});
 	} catch {
 		return;
 	}
-	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) => f(a.join(e, t), { force: !0 })));
+	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 fe(e) {
-	let t = e.cwd ?? process.cwd(), n = await C(t), r = await ue(t), i = n.outDir, o = e.bundler ?? K, s = e.stdout ?? process.stdout, c = e.stderr ?? process.stderr, l = e.entry ?? n.entry ?? await q(t), u, d = !1, f = !1, p = Promise.resolve(), h = () => {}, g = new Promise((e) => {
-		h = e;
-	});
-	async function _() {
-		try {
-			return await u?.call("reload"), !0;
-		} catch (e) {
-			return W(c, "reload failed", U(e), Y), !1;
-		}
-	}
-	async function v(n) {
-		if (await de(n.outDir, n.files), !u) {
-			let t = new oe({
-				entryFile: n.entryFile,
-				hostBin: e.hostBin,
-				onStderr: (e) => c.write(e),
-				onReady: () => {
-					d = !0, R(s, "ready", Y), f && (f = !1, _());
-				},
-				onAppError: (e) => W(c, "app error", e, Y),
-				onExit: () => {
-					R(s, "host exited — stopping", Y), h();
-				}
-			});
+async function De(e) {
+	let t = e.cwd ?? process.cwd(), n = await T(t), r = await be(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) => {
+			_ = e;
+		});
+		async function y() {
 			try {
-				await t.start();
+				return await f?.call("reload"), !0;
 			} catch (e) {
-				W(c, "failed to start inca-host", U(e), Y);
-				return;
+				return W(s, "reload failed", U(e), Z), !1;
 			}
-			u = t;
-			return;
 		}
-		if (!d) {
-			f = !0;
-			return;
-		}
-		if (await _() && n.changed) {
-			let e = m("dim", a.relative(t, n.changed.file), { stream: s }), r = Date.now() - n.changed.at;
-			R(s, `${m("green", "reload")} ${e} (${r}ms)`, Y);
+		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;
+				}
+				f = t;
+				return;
+			}
+			if (!p) {
+				m = !0;
+				return;
+			}
+			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);
+			}
 		}
+		let x = await i.watch({
+			entry: c,
+			outDir: r,
+			runtimeConfig: u,
+			mode: "development",
+			stdout: o,
+			stderr: s,
+			onBuild: (e) => {
+				g = g.then(() => b(e));
+			},
+			onError: (e) => {
+				W(s, "build failed", e, Z);
+			}
+		});
+		e.signal.aborted ? _() : e.signal.addEventListener("abort", () => _(), { once: !0 }), await v, await g, await f?.stop(), await x.close();
+	} finally {
+		await r();
 	}
-	let y = await o.watch({
-		entry: l,
-		outDir: i,
-		mode: "development",
-		stdout: s,
-		stderr: c,
-		onBuild: (e) => {
-			p = p.then(() => v(e));
-		},
-		onError: (e) => {
-			W(c, "build failed", e, Y);
-		}
-	});
-	e.signal.aborted ? h() : e.signal.addEventListener("abort", () => h(), { once: !0 }), await g, await p, await u?.stop(), await y.close(), await r();
-}
-//#endregion
-//#region src/plist.mts
-function X(e) {
-	return e.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-}
-function pe(e) {
-	return typeof e == "boolean" ? e ? "<true/>" : "<false/>" : `<string>${X(e)}</string>`;
-}
-function me(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>${X(e)}</key>\n\t${pe(t)}`).join("\n")}\n</dict>
-</plist>
-`;
 }
 //#endregion
 //#region src/package.mts
-function he() {
+function Oe() {
 	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`);
 }
-async function Z(e, t) {
+async function Q(e, t) {
 	await Promise.all(e.files.map(async (n) => {
 		let r = a.join(t, n);
-		await l(a.dirname(r), { recursive: !0 }), await c(a.join(e.outDir, n), r);
+		await u(a.dirname(r), { recursive: !0 }), await c(a.join(e.outDir, n), r);
 	}));
 }
-async function Q({ metadata: e, output: t, hostBin: n }) {
-	let r = a.join(t.outDir, `${e.productName}.app`);
-	await f(r, {
-		recursive: !0,
-		force: !0
+async function ke({ metadata: e, output: t, hostBin: n }) {
+	let { appPath: r, resourcesDir: i } = await X({
+		appPath: a.join(t.outDir, `${e.productName}.app`),
+		metadata: e,
+		hostBin: n
 	});
-	let i = a.join(r, "Contents"), o = a.join(i, "MacOS"), u = a.join(i, "Resources");
-	await l(o, { recursive: !0 }), await l(u, { recursive: !0 });
-	let d = a.join(o, e.productName);
-	await c(n, d), await s(d, 493), await Z(t, u);
-	let m = {
-		CFBundleName: e.productName,
-		CFBundleDisplayName: e.productName,
-		CFBundleExecutable: e.productName,
-		CFBundleIdentifier: e.identifier,
-		CFBundleVersion: e.version,
-		CFBundleShortVersionString: e.version,
-		CFBundlePackageType: "APPL",
-		CFBundleInfoDictionaryVersion: "6.0",
-		NSHighResolutionCapable: !0
-	};
-	if (e.icon) {
-		let t = a.basename(e.icon);
-		await c(e.icon, a.join(u, t)), m.CFBundleIconFile = t;
-	}
-	return await p(a.join(i, "Info.plist"), me(m)), await p(a.join(i, "PkgInfo"), "APPL????"), r;
+	return await Q(t, i), r;
 }
-async function ge({ metadata: t, output: n, hostBin: r }) {
+async function Ae({ metadata: t, output: n, hostBin: r }) {
 	let i = e(t.productName), o = a.join(n.outDir, i);
-	await f(o, {
+	await p(o, {
 		recursive: !0,
 		force: !0
-	}), await l(o, { recursive: !0 });
-	let u = a.join(o, i);
-	return await c(r, u), await s(u, 493), await Z(n, o), o;
-}
-async function _e(e = {}) {
-	let t = e.cwd ?? process.cwd(), n = e.stdout ?? process.stdout, r = e.target ?? he(), i = await ee(t);
-	i.usedPackageJsonKey && R(n, "the \"inca\" key in package.json is deprecated — move these settings to inca.config.ts"), i.identifierIsDefault && R(n, `no "identifier" set in inca.config.ts — using generated identifier ${i.identifier}`);
-	let a = await J({
+	}), await u(o, { recursive: !0 });
+	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);
+	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),
 		bundler: e.bundler,
 		stdout: n,
 		stderr: e.stderr
@@ -613,20 +703,20 @@ async function _e(e = {}) {
 		output: a,
 		hostBin: s
 	};
-	return { appPath: r === "macos" ? await Q(c) : await ge(c) };
+	return { appPath: r === "macos" ? await ke(c) : await Ae(c) };
 }
 //#endregion
 //#region src/cli.mts
-var ve = "Usage: inca <dev|build|package>";
+var Me = "Usage: inca <dev|build|package>";
 function $(e) {
 	return a.relative(process.cwd(), e);
 }
-async function ye(e = process.argv) {
+async function Ne(e = process.argv) {
 	let t = e[2];
 	if (t === "build") {
 		try {
-			let e = await J();
-			R(process.stdout, `built ${$(e.entryFile)}`);
+			let e = await q();
+			V(process.stdout, `built ${$(e.entryFile)}`);
 		} catch (e) {
 			W(process.stderr, "build failed", U(e)), process.exitCode = 1;
 		}
@@ -634,26 +724,26 @@ async function ye(e = process.argv) {
 	}
 	if (t === "package") {
 		try {
-			let { appPath: e } = await _e();
-			R(process.stdout, `packaged ${$(e)}`);
+			let { appPath: e } = await je();
+			V(process.stdout, `packaged ${$(e)}`);
 		} catch (e) {
 			W(process.stderr, "package failed", U(e)), process.exitCode = 1;
 		}
 		return;
 	}
 	if (t !== "dev") {
-		process.stderr.write(`${ve}\n`), process.exitCode = 1;
+		process.stderr.write(`${Me}\n`), process.exitCode = 1;
 		return;
 	}
 	let n = new AbortController(), r = () => {
-		n.signal.aborted || (R(process.stderr, "shutting down", { timestamp: !0 }), n.abort());
+		n.signal.aborted || (V(process.stderr, "shutting down", { timestamp: !0 }), n.abort());
 	};
 	process.on("SIGINT", r), process.on("SIGTERM", r);
 	try {
-		await fe({ signal: n.signal });
+		await De({ signal: n.signal });
 	} catch (e) {
 		W(process.stderr, "dev failed", U(e), { timestamp: !0 }), process.exitCode = 1;
 	}
 }
 //#endregion
-export { ye as run };
+export { Ne as run };

package/dist/config/defaults.d.mts

@@ -28,7 +28,8 @@ export declare function unscopedName(name: string): string;
  *
  * @param name - e.g. a `productName`
  * @returns `name` lowercased, with runs of non-`[a-z0-9]` collapsed to a
- * single `-` and trimmed from both ends
+ * single `-` and trimmed from both ends; `"app"` for a name that holds
+ * none of those characters
  */
 export declare function slugify(name: string): string;
 /**

package/dist/config/loader.d.mts

@@ -1,3 +1,4 @@
+import { WindowConfig } from './types.mts';
 /** `entry`/`outDir` only — what `build()`/`dev()` need, with no `package.json` requirement. */
 export interface ResolvedBuildConfig {
     /** Absolute path, if `inca.config.ts` set one. */
@@ -14,9 +15,21 @@ export interface ResolvedAppConfig extends ResolvedBuildConfig {
     version: string;
     /** Absolute path, if the app declared one. */
     icon?: string;
+    /** What the app declared about its window, if anything. */
+    window?: WindowConfig;
     /** package.json's `"inca"` key is deprecated; callers warn when this is true. */
     usedPackageJsonKey: boolean;
 }
+/**
+ * What a built app carries for its host to read: the name the platform
+ * shows it under, the id it is known by, and its window. Each field is
+ * absent unless the app's config sets it.
+ */
+export interface RuntimeConfig {
+    name?: string;
+    identifier?: string;
+    window?: WindowConfig;
+}
 /**
  * Loads just `entry`/`outDir` from `inca.config.ts`, with derived defaults.
  * Never touches `package.json`.
@@ -35,3 +48,19 @@ export declare function resolveBuildConfig(cwd: string): Promise<ResolvedBuildCo
  * `productName`, or an `icon` doesn't resolve to a real file
  */
 export declare function resolveAppConfig(cwd: string): Promise<ResolvedAppConfig>;
+/**
+ * Narrows a full config down to what a build carries for the host.
+ *
+ * @param config - a config {@link resolveAppConfig} returned
+ * @returns its name, id and window
+ */
+export declare function runtimeConfigOf(config: ResolvedAppConfig): RuntimeConfig;
+/**
+ * Loads {@link RuntimeConfig} for an app that may name itself nowhere.
+ * An app with no `package.json`, or none that gives it a name, still gets
+ * whatever window settings it declared.
+ *
+ * @param cwd - the app's root directory
+ * @returns the config, or `undefined` when the app declares none of it
+ */
+export declare function resolveRuntimeConfig(cwd: string): Promise<RuntimeConfig | undefined>;

package/dist/config/types.d.mts

@@ -32,4 +32,35 @@ export interface IncaConfig {
      * @default "dist"
      */
     outDir?: string;
+    /** The window the app opens in. */
+    window?: WindowConfig;
+}
+/** What an app declares about its window — see {@link IncaConfig.window}. */
+export interface WindowConfig {
+    /**
+     * Initial width, in pixels. Falls back to the width the app's root
+     * element declares, then to this default.
+     * @default 800
+     */
+    width?: number;
+    /**
+     * Initial height, in pixels. Falls back to the height the app's root
+     * element declares, then to this default.
+     * @default 600
+     */
+    height?: number;
+    /**
+     * The window's title.
+     * @default the app's productName
+     */
+    title?: string;
+    /**
+     * Whether a user can resize the window.
+     * @default false
+     */
+    resizable?: boolean;
+    /** Smallest width the window can be, in pixels. It opens at least this wide. */
+    minWidth?: number;
+    /** Smallest height the window can be, in pixels. It opens at least this tall. */
+    minHeight?: number;
 }

package/dist/config.js

@@ -1,4 +1,4 @@
-import { a as e, t } from "./chunks/defaults-D_1rymg4.js";
+import { a as e, t } from "./chunks/defaults-DNvHueCI.js";
 //#region src/config/index.mts
 var n = e();
 //#endregion

package/dist/dev.d.mts

@@ -9,7 +9,10 @@ export interface DevOptions {
     entry?: string;
     /** Overrides the bundler — see {@link defaultBundler} for what's wired in by default. */
     bundler?: Bundler;
-    /** Overrides host binary resolution — passed straight through to `HostClient`. */
+    /**
+     * Overrides host binary resolution. On macOS this is the binary the
+     * app bundle wraps; elsewhere it is launched directly.
+     */
     hostBin?: string;
     /** Defaults to `process.stdout`. */
     stdout?: NodeJS.WritableStream;

package/dist/macos-app.d.mts

@@ -0,0 +1,47 @@
+/** The app metadata a `.app` bundle's `Info.plist` carries. */
+export interface MacosAppMetadata {
+    /** The name macOS shows in the Dock, the menu bar and the Finder. */
+    productName: string;
+    /** A reverse-DNS-style unique id, written as `CFBundleIdentifier`. */
+    identifier: string;
+    /** The app's version, written as both `CFBundleVersion` and `CFBundleShortVersionString`. */
+    version: string;
+    /** Absolute path to an icon file, copied into `Contents/Resources`. */
+    icon?: string;
+}
+/** Options for {@link writeMacosApp}. */
+export interface WriteMacosAppOptions {
+    /** Where the `.app` directory is written. An existing one there is replaced. */
+    appPath: string;
+    /** What the bundle's `Info.plist` describes. */
+    metadata: MacosAppMetadata;
+    /** The `inca-host` binary the bundle's executable is made from. */
+    hostBin: string;
+    /**
+     * Hard-links the executable to `hostBin` rather than copying it, and
+     * copies when the two paths are on different filesystems. Set it where
+     * the bundle is rebuilt often and holds no files of its own.
+     */
+    link?: boolean;
+}
+/** The paths {@link writeMacosApp} created. */
+export interface MacosApp {
+    /** The `.app` directory itself. */
+    appPath: string;
+    /** The bundle's executable, at `Contents/MacOS/<productName>`. */
+    executablePath: string;
+    /** `Contents/Resources`, where an app's own files belong. */
+    resourcesDir: string;
+}
+/**
+ * Writes a macOS `.app` bundle around the `inca-host` binary:
+ * `Contents/MacOS` holding the executable, `Contents/Resources` left empty
+ * apart from the icon, and `Info.plist`/`PkgInfo` beside them. macOS reads
+ * the app's name, icon and identifier from the bundle, so an executable
+ * launched from one carries them wherever the platform shows an app.
+ *
+ * @param options - where to write, what to describe, and which binary to use
+ * @returns the bundle's own path, its executable, and its resources directory
+ * @throws if any part of the bundle can't be written
+ */
+export declare function writeMacosApp(options: WriteMacosAppOptions): Promise<MacosApp>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.3",
-  "description": "The inca CLI: watches an app's entry point through a bundler adapter, starts inca-host once the first bundle lands, and reloads it on every rebuild.",
+  "version": "0.0.4",
+  "description": "Dev server, bundler, and packager for Incarnative.js apps.",
   "keywords": [
     "bundler",
     "cli",
@@ -68,9 +68,9 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.3",
-    "@incajs/host-linux-arm64": "0.0.3",
-    "@incajs/host-linux-x64": "0.0.3"
+    "@incajs/host-darwin-arm64": "0.0.4",
+    "@incajs/host-linux-arm64": "0.0.4",
+    "@incajs/host-linux-x64": "0.0.4"
   },
   "engines": {
     "node": ">=22.18"