@incajs/cli 0.0.9 → 0.0.11

package/dist/config/index.d.mts

@@ -15,4 +15,4 @@ export type { IncaConfig } from './types.mts';
  * });
  * ```
  */
-export declare const defineConfig: import('c12').DefineConfig<IncaConfig, import('c12').ConfigLayerMeta>;
+export declare const defineConfig: (config: IncaConfig) => IncaConfig;

package/dist/config/loader.d.mts

@@ -56,7 +56,7 @@ export declare function resolveBuildConfig(cwd: string): Promise<ResolvedBuildCo
  *
  * @param cwd - the app's root directory
  * @returns the resolved config
- * @throws if `package.json` is missing, has neither a `name` nor a
+ * @throws if `package.json` is missing, holds malformed JSON, has neither a `name` nor a
  * `productName`, an `icon` doesn't resolve to a real file, or `outDir`
  * would hold the app's own files
  */
@@ -75,5 +75,6 @@ export declare function runtimeConfigOf(config: ResolvedAppConfig): RuntimeConfi
  *
  * @param cwd - the app's root directory
  * @returns the config, or `undefined` when the app declares none of it
+ * @throws if `package.json` exists and holds malformed JSON
  */
 export declare function resolveRuntimeConfig(cwd: string): Promise<RuntimeConfig | undefined>;

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`.
@@ -23,8 +23,9 @@ export interface IncaConfig {
     version?: string;
     /**
      * The app's entry point.
-     * @default resolved automatically — a committed `src/main.mts`, or
-     * `src/App.vue` wrapped in a synthesized one
+     * @default resolved automatically — a committed `src/main.mts`,
+     * `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a
+     * synthesized one
      */
     entry?: string;
     /**

package/dist/config.js

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

package/dist/defaultBundler.d.mts

@@ -2,6 +2,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, and the reason they can't
- * drift onto different ones.
+ * drift onto different ones. Compiled `.vue` templates import their helpers
+ * from `incajs/vue/runtime`.
  */
 export declare const defaultBundler: Bundler;

package/dist/dev.d.mts

@@ -4,7 +4,7 @@ export interface DevOptions {
     cwd?: string;
     /**
      * The app's entry point. Defaults to resolving it automatically: a
-     * committed `src/main.mts`, or `src/App.vue` wrapped in a synthesized one.
+     * 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. */
@@ -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/entry.d.mts

@@ -1,8 +1,14 @@
+export declare const MAIN_FILES: string[];
 /**
- * Resolves an app's entry point. `src/main.mts`, committed by the app,
- * wins outright and is used verbatim — full control over bootstrapping.
- * Otherwise `src/App.vue` is wrapped in a synthesized entry equivalent to
+ * Resolves an app's entry point. A `src/main.mts`, `src/main.ts` or
+ * `src/main.js` committed by the app wins outright, in that order, and is
+ * used verbatim for full control over bootstrapping. Otherwise
+ * `src/App.vue` is wrapped in a synthesized entry equivalent to
  * `createIncaApp(App).mount()`, so a plain `.vue` file is a whole app
  * with no configuration at all.
+ *
+ * @param cwd - the app's root directory
+ * @returns the path of the entry file
+ * @throws if none of the main files and no `src/App.vue` exists
  */
 export declare function resolveEntry(cwd: string): Promise<string>;

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/package.d.mts

@@ -7,7 +7,7 @@ export interface PackageAppOptions {
     cwd?: string;
     /**
      * The app's entry point. Defaults to resolving it the same way `inca
-     * dev`/`build` do: a committed `src/main.mts`, or `src/App.vue` wrapped
+     * dev`/`build` do: a committed `src/main.mts`, `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped
      * in a synthesized one.
      */
     entry?: string;

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`, `src/main.ts`, `src/main.js` 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.11",
   "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.11",
+    "@incajs/host-darwin-x64": "0.0.11",
+    "@incajs/host-linux-arm64": "0.0.11",
+    "@incajs/host-linux-x64": "0.0.11"
   },
   "engines": {
     "node": ">=22.18"