@incajs/cli 0.0.9 → 0.0.10

package/dist/config/types.d.mts

@@ -4,7 +4,7 @@
  * deprecated — this file wins where both are present.
  */
 export interface IncaConfig {
-    /** Path to an icon file, resolved relative to this config file's own directory. */
+    /** 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`.

package/dist/config.js

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

package/dist/dev.d.mts

@@ -31,9 +31,15 @@ export interface DevOptions {
  * reloads it on every rebuild — until `options.signal` aborts or the host
  * exits on its own.
  *
- * @throws if another `inca dev` is already running for this app, or if the
- * host binary can't be resolved or isn't a file. Both stop it before any build.
- * Also throws if the host exits before it is ready, or exits non-zero or by
- * a signal other than SIGINT/SIGTERM afterwards.
+ * A config or entry that can't be used before the first build is printed as
+ * `build failed`. `dev` then retries after the next edit to the config or the
+ * entry.
+ *
+ * @throws if another `inca dev` is already running for this app.
+ * @throws if the host binary can't be resolved or isn't a file.
+ * @throws if `experimentalHmr` is set and the bundler has no HMR support.
+ * @throws if the operating system refuses a file watcher.
+ * @throws if the host exits before it is ready, or exits non-zero or by a
+ * signal other than SIGINT/SIGTERM afterwards.
  */
 export declare function dev(options: DevOptions): Promise<void>;

package/dist/error.d.mts

@@ -6,6 +6,10 @@
  */
 export declare class IncaError extends Error {
     readonly code: string;
+    /** A file whose creation or change may resolve the error. */
+    readonly path?: string | undefined;
     readonly name = "IncaError";
-    constructor(code: string, message: string);
+    constructor(code: string, message: string, 
+    /** A file whose creation or change may resolve the error. */
+    path?: string | undefined);
 }

package/dist/log.d.mts

@@ -3,6 +3,10 @@ export interface LogOptions {
     /** Prefixes the line with `HH:MM:SS`, the way Vite's dev server stamps its own. */
     timestamp?: boolean;
 }
+/** `inca dev` stamps its lines the way Vite's dev server does. */
+export declare const STAMPED: {
+    readonly timestamp: true;
+};
 /** Writes one `[inca] <message>` line to `stream`. */
 export declare function log(stream: NodeJS.WritableStream, message: string, options?: LogOptions): void;
 /** A failure reduced to the message and stack worth printing. */

package/dist/retryOnEdit.d.mts

@@ -0,0 +1,32 @@
+import { EditWatch } from './watchForEdit.mts';
+/** Options for {@link retryOnEdit}. */
+export interface RetryOnEditOptions<T> {
+    /** The app's root directory. */
+    cwd: string;
+    /** Aborting ends the wait. */
+    signal: AbortSignal;
+    /** Receives the progress lines. */
+    stdout: NodeJS.WritableStream;
+    /** Receives each failure. */
+    stderr: NodeJS.WritableStream;
+    /** How long edits must stay quiet before the next attempt. Defaults to 100. */
+    debounceMs?: number;
+    /**
+     * One try. A thrown value is printed and the attempt repeats after the
+     * next relevant edit. `watch` is live for the whole try.
+     */
+    attempt(watch: EditWatch): Promise<T>;
+}
+/**
+ * Runs `attempt` until it succeeds. A failure is printed as `build failed`,
+ * then the call waits for an edit to a file that may fix it and tries again.
+ * An `IncaError` that names a `path` adds that file to the watch. When that
+ * file already exists, the call retries once at once and prints nothing. A
+ * second failure in a row is printed and waits for an edit.
+ *
+ * @param options - the attempt and where to report
+ * @returns the value of the first attempt that succeeds, or `undefined` when `signal` aborts first
+ * @throws if the operating system refuses a watcher. The failure that led to
+ * a refused `add` is printed first.
+ */
+export declare function retryOnEdit<T>(options: RetryOnEditOptions<T>): Promise<T | undefined>;

package/dist/watchForEdit.d.mts

@@ -0,0 +1,27 @@
+/** A watch that resolves once, when a file that could fix a failed start is saved. */
+export interface EditWatch {
+    /** Resolves once, after a relevant change has been quiet for the debounce. */
+    readonly edited: Promise<void>;
+    /** Also watches `file`, which may be missing. A change to that file counts. */
+    add(file: string): void;
+    /** Stops every watcher and timer. Safe to call more than once. */
+    close(): void;
+}
+/**
+ * Watches the files that decide whether an app can start: `inca.config.*`
+ * and `package.json` in `cwd`, `src/main.mts` and `src/App.vue`, and every
+ * file passed to {@link EditWatch.add}. Creating, deleting, changing or
+ * renaming one of them counts as an edit. Edits to other files are ignored.
+ *
+ * The watchers are live when this returns, so a save made while the caller
+ * is working counts. An edit made before the caller awaits
+ * `edited` keeps it resolved.
+ *
+ * @param cwd - the app's root directory
+ * @param options.debounceMs - how long changes must stay quiet before `edited` resolves. Defaults to 100.
+ * @returns the watch. Call `close()` when done with it.
+ * @throws if the operating system refuses a watcher, for example when it is out of file handles
+ */
+export declare function watchForEdit(cwd: string, options?: {
+    debounceMs?: number;
+}): EditWatch;

package/package.json

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

package/dist/chunks/jsonc-BdzClvC8.js

@@ -1,46 +0,0 @@
-import { n as e, t } from "./_format-BKs7bsc4.js";
-//#region \0rolldown/runtime.js
-var n = Object.defineProperty, r = (e, t) => {
-	let r = {};
-	for (var i in e) n(r, i, {
-		get: e[i],
-		enumerable: !0
-	});
-	return t || n(r, Symbol.toStringTag, { value: "Module" }), r;
-}, i = Symbol("singleComment"), a = Symbol("multiComment"), o = () => "", s = (e, t, n) => e.slice(t, n).replace(/[^ \t\r\n]/g, " "), c = (e, t) => {
-	let n = t - 1, r = 0;
-	for (; e[n] === "\\";) --n, r += 1;
-	return !!(r % 2);
-};
-function l(e, { whitespace: t = !0, trailingCommas: n = !1 } = {}) {
-	if (typeof e != "string") throw TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof e}\``);
-	let r = t ? s : o, l = !1, u = !1, d = 0, f = "", p = "", m = -1;
-	for (let t = 0; t < e.length; t++) {
-		let o = e[t], s = e[t + 1];
-		if (!u && o === "\"" && (c(e, t) || (l = !l)), !l) {
-			if (!u && o + s === "//") f += e.slice(d, t), d = t, u = i, t++;
-			else if (u === i && o + s === "\r\n") {
-				t++, u = !1, f += r(e, d, t), d = t;
-				continue;
-			} else if (u === i && o === "\n") u = !1, f += r(e, d, t), d = t;
-			else if (!u && o + s === "/*") {
-				f += e.slice(d, t), d = t, u = a, t++;
-				continue;
-			} else if (u === a && o + s === "*/") {
-				t++, u = !1, f += r(e, d, t + 1), d = t + 1;
-				continue;
-			} else n && !u && (m === -1 ? o === "," && (p += f + e.slice(d, t), f = "", d = t, m = t) : o === "}" || o === "]" ? (f += e.slice(d, t), p += r(f, 0, 1) + f.slice(1), f = "", d = t, m = -1) : o !== " " && o !== "	" && o !== "\r" && o !== "\n" && (f += e.slice(d, t), d = t, m = -1));
-		}
-	}
-	let h = u === i ? r(e, d) : e.slice(d);
-	return p + f + h;
-}
-//#endregion
-//#region ../../node_modules/.pnpm/confbox@0.3.1/node_modules/confbox/dist/jsonc.mjs
-var u = /* @__PURE__ */ r({ parseJSONC: () => d });
-function d(n, r) {
-	let i = JSON.parse(l(t(n), { trailingCommas: r?.allowTrailingComma }));
-	return e(n, i, r), i;
-}
-//#endregion
-export { u as n, d as t };