@incajs/cli 0.0.14 → 0.0.16

package/dist/config.js

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

package/dist/hmr-runtime.js

@@ -1109,11 +1109,12 @@ function bt(e, t) {
 }
 //#endregion
 //#region src/adapter/vite/runtime/createIncaDevTransport.mts
-function xt(e) {
+var xt = "this code needs a host that serves the development protocol. start the app with `inca dev`.";
+function St(e) {
 	return {
 		connect({ onMessage: t }) {
 			let n = globalThis.__inca_dev__;
-			if (!n) throw Error("__inca_dev__ is not installed — this build is not a dev build");
+			if (!n) throw Error(xt);
 			n.receive = (n, r) => {
 				if (n !== "vite") return;
 				let i = JSON.parse(r);
@@ -1122,18 +1123,18 @@ function xt(e) {
 		},
 		send(e) {
 			let t = globalThis.__inca_dev__;
-			if (!t) throw Error("__inca_dev__ is not installed — this build is not a dev build");
+			if (!t) throw Error(xt);
 			t.send("vite", JSON.stringify(e));
 		}
 	};
 }
 //#endregion
 //#region src/adapter/vite/runtime/createIncaEvaluator.mts
-var St = class extends H {
+var Ct = class extends H {
 	startOffset = 1;
 	async runInlinedModule(e, t, n) {
 		let r = globalThis.__inca_dev__;
-		if (!r?.compile) throw Error("__inca_dev__.compile is not installed");
+		if (!r?.compile) throw Error("this code needs a host that compiles modules for the development protocol. start the app with `inca dev`.");
 		let i = [
 			F,
 			B,
@@ -1145,18 +1146,18 @@ var St = class extends H {
 		await r.compile(i, t.replaceAll("\0", "\\u0000"), n.id.replaceAll("\0", "\\u0000"))(...i.map((t) => e[t])), Object.seal(e[F]);
 	}
 };
-function Ct() {
-	return new St();
+function wt() {
+	return new Ct();
 }
 //#endregion
 //#region src/adapter/vite/runtime/start.mts
-function wt(e) {
+function Tt(e) {
 	return typeof e == "object" && !!e && "runnerError" in e;
 }
-async function Tt(e) {
+async function Et(e) {
 	let t = () => {}, n = new yt({
 		transport: {
-			...xt(() => t()),
+			...St(() => t()),
 			timeout: 0
 		},
 		hmr: { logger: {
@@ -1164,7 +1165,7 @@ async function Tt(e) {
 			error: () => {}
 		} },
 		sourcemapInterceptor: !1
-	}, Ct());
+	}, wt());
 	for (;;) {
 		let r = new Promise((e) => {
 			t = e;
@@ -1172,10 +1173,10 @@ async function Tt(e) {
 		try {
 			return await n.import(e);
 		} catch (e) {
-			wt(e) || Promise.reject(e), globalThis.__inca_dev__?.setLoadFailed?.(!0);
+			Tt(e) || Promise.reject(e), globalThis.__inca_dev__?.setLoadFailed?.(!0);
 		}
 		await r, n.clearCache(), globalThis.__inca_dev__?.setLoadFailed?.(!1);
 	}
 }
 //#endregion
-export { Tt as start };
+export { Et as start };

package/dist/{adapter → src/adapter}/types.d.mts

@@ -1,16 +1,18 @@
-/** A running build watch — the value {@link Bundler.watch} resolves to. */
+/** A running build watch. {@link Bundler.watch} resolves to this value. */
 export interface Watcher {
     /** Stops watching and releases the underlying build process. */
     close(): Promise<void>;
 }
 /** Options for {@link Bundler.build}. */
 export interface BuildOptions {
-    /** The app's own entry point — may import `.vue` files. */
+    /** The app's own entry point. It may import `.vue` files. */
     entry: string;
     /** Where the build's output is written. */
     outDir: string;
+    /** Writes `bundle.js.map` beside the bundle. Defaults to `false`. */
+    sourcemap?: boolean;
     /**
-     * Values the built app carries for `inca-host` to read — its name, id
+     * Values the built app carries for `inca-host` to read: its name, id
      * and window. Any JSON-serializable object.
      */
     runtimeConfig?: unknown;
@@ -42,13 +44,19 @@ export interface BuildFailure {
     /** An `ERR_INCA_*` identifier, when the failure has one to look up. */
     code?: string | null;
 }
-/** What a build wrote — the result of {@link Bundler.build}, and every {@link BundlerOptions.onBuild} call. */
+/**
+ * What a build wrote. It is the result of {@link Bundler.build} and of every
+ * {@link BundlerOptions.onBuild} call.
+ */
 export interface BuildOutput {
     /** Directory holding every file this build emitted. */
     outDir: string;
     /** Absolute path to the entry module `inca-host` evaluates. */
     entryFile: string;
-    /** Every file this build emitted, relative to `outDir` — may include chunks and assets besides the entry itself. */
+    /**
+     * Every file this build emitted, relative to `outDir`. It may include chunks and assets besides
+     * the entry itself.
+     */
     files: readonly string[];
     /** The change that triggered this rebuild. Absent from a one-shot build and a watch's first build. */
     changed?: {
@@ -58,12 +66,12 @@ export interface BuildOutput {
 }
 /** Options for {@link Bundler.hmr}. */
 export interface HmrOptions {
-    /** The app's own entry point — may import `.vue` files. */
+    /** The app's own entry point. It may import `.vue` files. */
     entry: string;
-    /** The app's root directory — where its dev-only scratch files are written. */
+    /** The app's root directory, where its dev-only scratch files are written. */
     cwd: string;
     /**
-     * Values the built app carries for `inca-host` to read — its name, id
+     * Values the built app carries for `inca-host` to read: its name, id
      * and window. Any JSON-serializable object.
      */
     runtimeConfig?: unknown;
@@ -87,7 +95,7 @@ export interface HmrOptions {
         took: number;
     }) => void;
 }
-/** A running HMR session — the value {@link Bundler.hmr} resolves to. */
+/** A running HMR session. {@link Bundler.hmr} resolves to this value. */
 export interface HmrChannel extends Watcher {
     /** The synthesized entry `inca-host` evaluates for this session. */
     entryFile: string;
@@ -96,16 +104,15 @@ export interface HmrChannel extends Watcher {
 }
 /**
  * The contract a bundler adapter satisfies. Supporting another bundler
- * means adding a sibling adapter module and injecting its `Bundler` here —
- * never editing this package's own types.
+ * means adding a sibling adapter module and injecting its `Bundler` here.
  */
 export interface Bundler {
     watch(options: BundlerOptions): Promise<Watcher>;
-    /** One-shot production build, used by `inca build` — rejects on failure. */
+    /** One-shot production build, used by `inca build`. Rejects on failure. */
     build(options: BuildOptions): Promise<BuildOutput>;
     /**
      * Module-granular dev updates, used by `inca dev --experimental-hmr`.
-     * Optional — a bundler adapter with no HMR support simply omits it.
+     * Optional: omit it when the adapter has no HMR support.
      */
     hmr?(options: HmrOptions): Promise<HmrChannel>;
 }

package/dist/{adapter → src/adapter}/vite/build.d.mts

@@ -2,7 +2,6 @@ import { AdapterCore } from '../../adapterCore.mts';
 import { 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
- * starts or talks to `inca-host` — that's `dev.mts`'s job.
+ * rejects on failure. Never starts or talks to `inca-host`.
  */
-export declare function build(core: AdapterCore, runtimeModuleName: string, { entry, outDir, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;
+export declare function build(core: AdapterCore, runtimeModuleName: string, { entry, outDir, sourcemap, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;

package/dist/{adapter → src/adapter}/vite/captureOutput.d.mts

@@ -12,8 +12,7 @@ export interface CapturedOutput {
 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
- * one-shot build and every watch rebuild, so both read the bundler's real
- * output instead of assuming a file name or layout.
+ * disk, via `writeBundle`, the one hook that fires uniformly for a
+ * one-shot build and every watch rebuild.
  */
 export declare function captureOutput(core: AdapterCore, sink: (output: CapturedOutput) => void): Plugin;

package/dist/{adapter → src/adapter}/vite/config.d.mts

@@ -6,12 +6,14 @@ export interface ResolveConfigOptions {
     core: AdapterCore;
     /** The module compiled `.vue` templates import their helpers from. */
     runtimeModuleName: string;
-    /** The app's own entry point — may import `.vue` files. */
+    /** The app's own entry point. It may import `.vue` files. */
     entry: string;
     /** Where the build's output is written. */
     outDir: string;
     /** `"development"` keeps `@vue/runtime-core`'s own warnings; `"production"` strips them. */
     mode: "development" | "production";
+    /** Writes the map in a production build too. Development always writes it. */
+    sourcemap?: boolean;
     /** Whether Vite should keep rebuilding on file changes. */
     watch: boolean;
     /** Called with what each successful (re)build wrote. */
@@ -20,9 +22,9 @@ export interface ResolveConfigOptions {
     stdout: NodeJS.WritableStream;
     /** Where Vite's warnings and errors go. */
     stderr: NodeJS.WritableStream;
-    /** Silences the bundler's progress output — see the `quiet` option in `../types.mts`. */
+    /** 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`. */
+    /** Written beside the entry. See the `runtimeConfig` option in `../types.mts`. */
     runtimeConfig?: unknown;
 }
 /**
@@ -30,9 +32,8 @@ export interface ResolveConfigOptions {
  * files via `@vitejs/plugin-vue`. Compiled templates import their helpers
  * from `runtimeModuleName`.
  *
- * An import the entry doesn't inline — a dynamic `import()`, or a `.vue`
- * file's own `<style>` block — lands as its own chunk or asset alongside
- * the entry, named by `chunkFileNames`/`assetFileNames` below, rather than
- * failing the build.
+ * An import the entry doesn't inline (a dynamic `import()`, or a `.vue`
+ * file's own `<style>` block) lands as its own chunk or asset alongside
+ * the entry, named by `chunkFileNames`/`assetFileNames` below.
  */
-export declare function resolveViteConfig({ core, runtimeModuleName, entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;
+export declare function resolveViteConfig({ core, runtimeModuleName, entry, outDir, mode, sourcemap, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;

package/dist/{adapter → src/adapter}/vite/emitConfig.d.mts

@@ -3,7 +3,7 @@ import { Plugin } from 'vite';
 export declare const CONFIG_FILE_NAME = "inca.json";
 /**
  * Serializes `config` the way `inca.json` is written: `undefined` for
- * anything that shouldn't produce a file — `undefined` itself, or an
+ * anything that shouldn't produce a file: `undefined` itself, or an
  * object with no keys.
  */
 export declare function serializeConfig(config: unknown): string | undefined;

package/dist/{adapter → src/adapter}/vite/hmr.d.mts

@@ -1,7 +1,7 @@
 import { AdapterCore } from '../../adapterCore.mts';
 import { BuildFailure, HmrChannel, HmrOptions } from '../types.mts';
 /**
- * A failed update's detail — the same fields a Rollup/Vite plugin
+ * A failed update's detail: the same fields a Rollup/Vite plugin
  * error carries beyond `message`/`stack`, when it has them.
  */
 interface UpdateError {

package/dist/{adapter → src/adapter}/vite/logger.d.mts

@@ -1,7 +1,7 @@
 import { Logger } from 'vite';
 /**
  * A Vite {@link Logger} writing to the given streams: `info` to `stdout`,
- * `warn`/`error` to `stderr`, all unfiltered by Vite's own `LogOptions` — a
+ * `warn`/`error` to `stderr`, all unfiltered by Vite's own `LogOptions`. A
  * custom logger bypasses those. `quiet` drops `info` only; `warn`/`error`
  * still write, since they report something broken, not just what changed.
  */

package/dist/{adapter → src/adapter}/vite/unsupported.d.mts

@@ -8,7 +8,7 @@ export interface UnsupportedFeature {
     name: string;
     /** Whether a module id is a use of the feature. */
     matches: (id: string) => boolean;
-    /** What happens instead, and what to reach for — appended to the error. */
+    /** What happens instead, and what to reach for. Appended to the error. */
     hint: string;
 }
 /**

package/dist/{adapter → src/adapter}/vite/watch.d.mts

@@ -3,6 +3,6 @@ import { BundlerOptions, 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,
- * reloads, or talks to `inca-host` — that's `dev.mts`'s job.
+ * reloads, or talks to `inca-host`.
  */
 export declare function watch(core: AdapterCore, runtimeModuleName: string, { onBuild, onError, stdout, stderr, quiet, ...buildOptions }: BundlerOptions): Promise<Watcher>;

package/dist/{build.d.mts → src/build.d.mts}

@@ -8,10 +8,12 @@ export interface BuildAppOptions {
      * committed `src/main.mts`, `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a synthesized one.
      */
     entry?: string;
-    /** Overrides the bundler — see {@link defaultBundler} for what's wired in by default. */
+    /** Overrides the bundler. See {@link defaultBundler} for what's wired in by default. */
     bundler?: Bundler;
-    /** An already-resolved config — lets `packageApp` avoid loading it twice. */
+    /** An already-resolved config. It lets `packageApp` avoid loading it twice. */
     config?: ResolvedBuildConfig;
+    /** Writes `bundle.js.map` beside the bundle. Overrides the config's `sourcemap` when set. */
+    sourcemap?: boolean;
     /** 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`. */
@@ -21,7 +23,6 @@ export interface BuildAppOptions {
 }
 /**
  * Builds the app once through the same bundler `dev` uses, and returns what
- * it wrote. Rejects on failure — deciding what that means for the process
- * is `cli.mts`'s job.
+ * it wrote. Rejects on failure.
  */
 export declare function build(options?: BuildAppOptions): Promise<BuildOutput>;

package/dist/{config → src/config}/defaults.d.mts

@@ -1,7 +1,7 @@
 import { IncaConfig } from './types.mts';
 /**
  * The `IncaConfig` fields whose default is a fixed value rather than one
- * derived from `package.json` or the filesystem — importable alongside
+ * derived from `package.json` or the filesystem. Importable alongside
  * `defineConfig` for an app that wants to inherit or reference them.
  *
  * @example
@@ -14,7 +14,7 @@ import { IncaConfig } from './types.mts';
  * });
  * ```
  */
-export declare const defaultConfig: Required<Pick<IncaConfig, "outDir" | "version">>;
+export declare const defaultConfig: Required<Pick<IncaConfig, "outDir" | "sourcemap" | "version">>;
 /**
  * Strips an npm scope off a package name.
  *
@@ -34,8 +34,8 @@ export declare function unscopedName(name: string): string;
 export declare function slugify(name: string): string;
 /**
  * @param pkgName - `package.json`'s own `"name"`, if it has one
- * @returns the `productName` a plain `package.json` implies — its name with
- * any scope stripped — or `undefined` if it has none
+ * @returns the `productName` a plain `package.json` implies: its name with
+ * any scope stripped, or `undefined` if it has none
  */
 export declare function defaultProductName(pkgName: string | undefined): string | undefined;
 /**

package/dist/{config → src/config}/index.d.mts

@@ -2,8 +2,8 @@ import { IncaConfig } from './types.mts';
 export { defaultConfig } from './defaults.mts';
 export type { IncaConfig } from './types.mts';
 /**
- * Type-completion helper for `inca.config.ts` — an identity function at
- * runtime, the same way `defineConfig` from `vite` or `vitest/config` works.
+ * Type-completion helper for `inca.config.ts`. An identity function at
+ * runtime.
  *
  * @example
  * ```ts

package/dist/{config → src/config}/loader.d.mts

@@ -1,10 +1,12 @@
 import { WindowConfig } from './types.mts';
-/** `entry`/`outDir` only — what `build()`/`dev()` need, with no `package.json` requirement. */
+/** `entry`/`outDir` only: what `build()`/`dev()` need, with no `package.json` requirement. */
 export interface ResolvedBuildConfig {
     /** Absolute path, if `inca.config.ts` set one. */
     entry?: string;
     /** Absolute path. */
     outDir: string;
+    /** Whether `build`/`package` write `bundle.js.map`. */
+    sourcemap: boolean;
 }
 /** An app's full config, as `inca package` needs it. */
 export interface ResolvedAppConfig extends ResolvedBuildConfig {

package/dist/{config → src/config}/types.d.mts

@@ -1,13 +1,13 @@
 /**
  * An app's own `inca.config.ts` (or `.js`/`.json`), loaded by `@incajs/cli`.
  * `package.json`'s `"inca"` key still works as a fallback, but is
- * deprecated — this file wins where both are present.
+ * deprecated. This file wins where both are present.
  */
 export interface IncaConfig {
     /** Path to an icon file, resolved from the app's root directory. */
     icon?: string;
     /**
-     * A reverse-DNS-style unique id — e.g. macOS's `CFBundleIdentifier`.
+     * A reverse-DNS-style unique id, e.g. macOS's `CFBundleIdentifier`.
      * @default a generated `org.inca.<slug>`
      */
     identifier?: string;
@@ -23,7 +23,7 @@ export interface IncaConfig {
     version?: string;
     /**
      * The app's entry point.
-     * @default resolved automatically — a committed `src/main.mts`,
+     * @default resolved automatically: a committed `src/main.mts`,
      * `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a
      * synthesized one
      */
@@ -33,10 +33,16 @@ export interface IncaConfig {
      * @default "dist"
      */
     outDir?: string;
+    /**
+     * Whether `inca build` and `inca package` write `bundle.js.map` beside
+     * the bundle. `inca dev` always writes it.
+     * @default false
+     */
+    sourcemap?: boolean;
     /** The window the app opens in. */
     window?: WindowConfig;
 }
-/** What an app declares about its window — see {@link IncaConfig.window}. */
+/** 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

package/dist/src/defaultBundler.d.mts

@@ -0,0 +1,7 @@
+import { Bundler } from './adapter/types.mts';
+/**
+ * `adapter/vite` wired in as the one adapter `dev` and `build` share by
+ * default: a single place to swap bundlers. Compiled `.vue` templates import
+ * their helpers from `incajs/vue/runtime`.
+ */
+export declare const defaultBundler: Bundler;

package/dist/{dev-client → src/dev-client}/hostBin.d.mts

@@ -2,7 +2,7 @@
  * Where `inca-host` itself lives: `INCA_HOST_BIN` if set, otherwise the
  * per-platform npm package for this OS/arch (`@incajs/host-<os>-<arch>`, an
  * `optionalDependency` of this package).
- * @throws if neither resolves — no override is set, and either this
+ * @throws if neither resolves: no override is set, and either this
  * platform has no published binary, or the optional dependency carrying
  * it failed to install.
  */

package/dist/{dev-client → src/dev-client}/hostClient.d.mts

@@ -28,16 +28,15 @@ export interface HostClientOptions {
     onExit?: (code: number | null, signal: NodeJS.Signals | null) => void;
     /**
      * Handlers for notification `method`s this package doesn't implement
-     * itself (e.g. a future Vite integration), keyed by method name —
-     * `params` forwarded untouched.
+     * itself (e.g. a future Vite integration), keyed by method name.
+     * `params` are forwarded untouched.
      */
     integrations?: Record<string, (params: unknown) => void>;
 }
 /**
  * Spawns `inca-host --dev <entryFile>` and speaks newline-delimited
  * JSON-RPC 2.0 on its stdin/stdout. One instance owns exactly one child
- * process for its whole lifetime — a reload is a `reload` call on the same
- * child, never a respawn.
+ * process for its whole lifetime. A reload is a `reload` call on that child.
  */
 export declare class HostClient {
     #private;
@@ -51,22 +50,21 @@ export declare class HostClient {
     start(): Promise<void>;
     /**
      * 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.
+     * 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 never answers.
      */
     call(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;
     /**
-     * Sends a fire-and-forget notification — no `id`, so no reply is ever
+     * Sends a fire-and-forget notification: no `id`, so no reply is ever
      * awaited. Used for traffic a bundler integration owns (e.g. Vite's HMR
-     * payloads), which answers itself over the same named channel rather than
-     * through this client's request/reply bookkeeping.
+     * payloads).
      */
     notify(method: string, params?: unknown): void;
     /**
-     * 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
-     * `timeoutMs` passes without that, so a wedged app can't block teardown.
+     * Asks the host to `shutdown` and waits for the child to actually exit.
+     * That exit is the acknowledgement. Kills it once `timeoutMs` passes without
+     * that, so a wedged app can't block teardown.
      */
     stop(timeoutMs?: number): Promise<void>;
 }

package/dist/{dev-client → src/dev-client}/protocol.d.mts

@@ -1,7 +1,7 @@
 export declare const JSONRPC = "2.0";
 /**
  * The host method-set revision this package expects, checked against
- * `ready`'s `params.protocol` — a mismatch means an incompatible host
+ * `ready`'s `params.protocol`: a mismatch means an incompatible host
  * build.
  */
 export declare const HOST_PROTOCOL_VERSION = 0;

package/dist/{dev.d.mts → src/dev.d.mts}

@@ -7,11 +7,11 @@ export interface DevOptions {
      * committed `src/main.mts`, `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a synthesized one.
      */
     entry?: string;
-    /** Overrides the bundler — see {@link defaultBundler} for what's wired in by default. */
+    /** Overrides the bundler. See {@link defaultBundler} for what's wired in by default. */
     bundler?: Bundler;
     /**
      * Delivers module-granular updates instead of a full reload on every
-     * change, over `bundler.hmr` — see `--experimental-hmr`.
+     * change, over `bundler.hmr`. See `--experimental-hmr`.
      */
     experimentalHmr?: boolean;
     /**

package/dist/{log.d.mts → src/log.d.mts}

@@ -9,6 +9,8 @@ export declare const STAMPED: {
 };
 /** Writes one `[inca] <message>` line to `stream`. */
 export declare function log(stream: NodeJS.WritableStream, message: string, options?: LogOptions): void;
+/** Writes one `[inca] <message>` line to `stream`, with the tag in yellow. */
+export declare function warn(stream: NodeJS.WritableStream, message: string, options?: LogOptions): void;
 /** A failure reduced to the message and stack worth printing. */
 export interface Fault {
     message: string;
@@ -17,8 +19,8 @@ export interface Fault {
     code?: string | null;
 }
 /**
- * Reduces an error a bundler re-wrapped: its text is kept whole — the
- * excerpt a compiler points at is the useful part — while the error class
+ * Reduces an error a bundler re-wrapped: its text is kept whole. The
+ * excerpt a compiler points at is the useful part, while the error class
  * and any `ERR_INCA_*` marker are lifted off the first line, the latter
  * into the fault's code.
  */
@@ -27,7 +29,7 @@ export declare function bundlerFault(message: string): Fault;
 export declare function toFault(error: unknown): Fault;
 /**
  * Writes the stack (when there is one) followed by `[inca] <label>
- * (<code>): <message>` to `stream` — the code only when the failure
+ * (<code>): <message>` to `stream`. The code appears only when the failure
  * carries one. The tagged line goes last so it stays the thing visible
  * without scrolling back through the stack above it.
  */

package/dist/{package.d.mts → src/package.d.mts}

@@ -11,14 +11,16 @@ export interface PackageAppOptions {
      * in a synthesized one.
      */
     entry?: string;
-    /** Overrides the bundler — see {@link build}'s default. */
+    /** Overrides the bundler. See {@link build}'s default. */
     bundler?: Bundler;
     /**
      * Overrides which `inca-host` binary gets embedded in the packaged
      * app, in place of automatic resolution (`INCA_HOST_BIN`, then the
-     * per-platform `@incajs/host-*` package — see {@link resolveHostBin}).
+     * per-platform `@incajs/host-*` package. See {@link resolveHostBin}).
      */
     hostBin?: string;
+    /** Writes `bundle.js.map` beside the bundle. Overrides the config's `sourcemap` when set. */
+    sourcemap?: boolean;
     /**
      * The platform to package for. Defaults to whichever one the current
      * process is running on.
@@ -31,13 +33,13 @@ export interface PackageAppOptions {
 }
 /** The result of a successful {@link packageApp} call. */
 export interface PackageResult {
-    /** The packaged app's path — a `.app` directory on macOS, a plain directory on Linux. */
+    /** The packaged app's path: a `.app` directory on macOS, a plain directory on Linux. */
     appPath: string;
 }
 /**
  * Builds the app and pairs it with the prebuilt `inca-host` into a
- * distributable, platform-native application — a `.app` on macOS, a plain
- * directory on Linux — written alongside the build output, under the
+ * distributable, platform-native application: a `.app` on macOS, a plain
+ * directory on Linux, written alongside the build output, under the
  * app's own `dist/`. The app launches with no arguments and no terminal,
  * since `inca-host` finds its own bundle beside its executable.
  *

package/dist/{plist.d.mts → src/plist.d.mts}

@@ -1,4 +1,4 @@
-/** A macOS `Info.plist`'s value types — the only ones `inca package` writes. */
+/** A macOS `Info.plist`'s value types. These are the only ones `inca package` writes. */
 export type PlistValue = string | boolean;
 /** Encodes a flat key/value dict as an `Info.plist` XML document. */
 export declare function encodePlist(dict: Record<string, PlistValue>): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.14",
-  "description": "Dev server, bundler, and packager for Incarnative.js apps.",
+  "version": "0.0.16",
+  "description": "Commands to develop, bundle, and package Incarnative.js apps.",
   "keywords": [
     "bundler",
     "cli",
@@ -56,6 +56,7 @@
     "@types/node": "^26.6.4",
     "@vue/runtime-core": "^3.5.43",
     "c12": "4.0.0-rc.2",
+    "citty": "0.2.2",
     "oxfmt": "^0.72.0",
     "oxlint": "^1.87.0",
     "rolldown": "~1.2.13",
@@ -70,10 +71,10 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.14",
-    "@incajs/host-darwin-x64": "0.0.14",
-    "@incajs/host-linux-arm64": "0.0.14",
-    "@incajs/host-linux-x64": "0.0.14"
+    "@incajs/host-darwin-arm64": "0.0.16",
+    "@incajs/host-darwin-x64": "0.0.16",
+    "@incajs/host-linux-arm64": "0.0.16",
+    "@incajs/host-linux-x64": "0.0.16"
   },
   "engines": {
     "node": ">=22.18"

package/dist/defaultBundler.d.mts

@@ -1,8 +0,0 @@
-import { Bundler } from './adapter/types.mts';
-/**
- * `adapter/vite` wired in as the one adapter `dev` and `build` share by
- * default — a single place to swap bundlers, and the reason they can't
- * drift onto different ones. Compiled `.vue` templates import their helpers
- * from `incajs/vue/runtime`.
- */
-export declare const defaultBundler: Bundler;