@incajs/cli 0.0.21 → 0.0.22

package/dist/dev.d.mts

@@ -3,8 +3,10 @@ export interface DevOptions {
     /** The app's root directory. Defaults to `process.cwd()`. */
     cwd?: string;
     /**
-     * The app's entry point. Defaults to resolving it automatically: a
-     * committed `src/main.mts`, `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a synthesized one.
+     * The app's entry point. Defaults to the first of `src/main.mts`, `src/main.ts` and
+     * `src/main.js` that exists, otherwise `src/App.vue` wrapped in a synthesized entry. An entry
+     * selected this way is selected again while the app runs, and the host reloads when the
+     * selection changes.
      */
     entry?: string;
     /** Overrides the bundler. See {@link defaultBundler} for what's wired in by default. */
@@ -35,6 +37,10 @@ export interface DevOptions {
  * `build failed`. `dev` then retries after the next edit to the config or the
  * entry.
  *
+ * When the entry is selected automatically, `dev` selects it again after every change to a main
+ * file or `src/App.vue` and reloads the development window if the selection changed. A missing
+ * entry prints `build failed` and keeps the running host until one exists.
+ *
  * @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.

package/dist/entry.d.mts

@@ -8,6 +8,12 @@ export declare const MAIN_FILES: string[];
  * @returns the directory
  */
 export declare function entryRoot(cwd: string, entry: string): string;
+/**
+ * The path {@link resolveEntry} would return, without writing the synthesized entry.
+ * @param cwd - the app's root directory
+ * @returns the path of the entry file, or `undefined` when no entry exists
+ */
+export declare function selectEntry(cwd: string): string | undefined;
 /**
  * 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

package/dist/watchForEdit.d.mts

@@ -1,4 +1,4 @@
-/** A watch that resolves once, when a file that could fix a failed start is saved. */
+/** A watch that resolves once, when a file that decides the app's config or entry changes. */
 export interface EditWatch {
     /** Resolves once, after a relevant change has been quiet for the debounce. */
     readonly edited: Promise<void>;
@@ -8,10 +8,10 @@ export interface EditWatch {
     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.
+ * Watches the files that decide how an app starts: `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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "Commands to develop, bundle, and package Incarnative.js apps.",
   "keywords": [
     "bundler",
@@ -72,10 +72,10 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.21",
-    "@incajs/host-darwin-x64": "0.0.21",
-    "@incajs/host-linux-arm64": "0.0.21",
-    "@incajs/host-linux-x64": "0.0.21"
+    "@incajs/host-darwin-arm64": "0.0.22",
+    "@incajs/host-darwin-x64": "0.0.22",
+    "@incajs/host-linux-arm64": "0.0.22",
+    "@incajs/host-linux-x64": "0.0.22"
   },
   "engines": {
     "node": ">=22.18"