@incajs/cli 0.0.7 → 0.0.9

package/dist/config/loader.d.mts

@@ -30,6 +30,18 @@ export interface RuntimeConfig {
     identifier?: string;
     window?: WindowConfig;
 }
+/**
+ * Refuses an `outDir` that would hold the app's own sources. `inca dev` and
+ * `inca build` delete whatever a build didn't write under `outDir`. Symlinks
+ * are followed on both sides of the comparison.
+ *
+ * @param cwd - the app's root directory
+ * @param outDir - the `outDir`, absolute or relative to `cwd`
+ * @param entry - the resolved entry, if any
+ * @throws if it is, or contains, the app's root, `src/`, `node_modules/`, or
+ * the entry, or if a symlink on the way can't be resolved
+ */
+export declare function assertOutDir(cwd: string, outDir: string, entry?: string): void;
 /**
  * Loads just `entry`/`outDir` from `inca.config.ts`, with derived defaults.
  * Never touches `package.json`.

package/dist/config.js

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

package/dist/dev-client/hostBin.d.mts

@@ -7,3 +7,9 @@
  * it failed to install.
  */
 export declare function resolveHostBin(): string;
+/**
+ * Checks that a host binary is a file.
+ * @param bin - the path to check
+ * @throws if nothing is a file at `bin`
+ */
+export declare function assertHostBin(bin: string): void;

package/dist/dev-client/hostClient.d.mts

@@ -4,6 +4,8 @@ export interface HostClientOptions {
     entryFile: string;
     /** Overrides which `inca-host` binary gets spawned, in place of automatic resolution. */
     hostBin?: string;
+    /** The environment the host starts with. Defaults to this process's own. */
+    env?: NodeJS.ProcessEnv;
     /**
      * Every diagnostic line the transport itself produces: the host's real
      * stderr, a stray stdout line, and a `ready` protocol mismatch. Defaults
@@ -40,8 +42,9 @@ export declare class HostClient {
     constructor(options: HostClientOptions);
     /**
      * Starts the child and wires up its streams. Resolves once the process
-     * has actually spawned; rejects if it never does (e.g. the resolved
-     * binary doesn't exist).
+     * has spawned. Rejects with `ERR_INCA_HOST_BIN_NOT_FOUND` if no file
+     * exists at the host binary's path, or with the spawn error if the
+     * process can't start.
      */
     start(): Promise<void>;
     /**

package/dist/dev-client/index.d.mts

@@ -1,4 +1,4 @@
-export { resolveHostBin } from './hostBin.mts';
+export { assertHostBin, resolveHostBin } from './hostBin.mts';
 export { HostError } from './hostError.mts';
 export { HostClient } from './hostClient.mts';
 export type { HostClientOptions } from './hostClient.mts';

package/dist/dev-lock.d.mts

@@ -2,9 +2,10 @@
  * Claims `cwd` for this process. Two `inca dev`s on one app watch the same
  * files and interleave their output on one terminal, and an orphan left by
  * an earlier run stays invisible until this says so. A lock whose pid is
- * gone is taken over.
+ * gone, or that an earlier run of this process left behind, is taken over.
  *
- * @returns a function releasing the lock.
+ * @param cwd - the app directory to claim
+ * @returns a function releasing the lock, safe to call more than once.
  * @throws if another live `inca dev` holds `cwd`.
  */
 export declare function acquireDevLock(cwd: string): Promise<() => Promise<void>>;

package/dist/dev.d.mts

@@ -31,6 +31,9 @@ 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.
+ * @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.
  */
 export declare function dev(options: DevOptions): Promise<void>;