@incajs/cli 0.0.3 → 0.0.5

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,13 +51,19 @@ 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
-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,39 +3,17 @@ 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;
-    /** `"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. */
     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`. */
@@ -47,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,8 +1,7 @@
 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
  * 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/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/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/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/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";