@incajs/cli 0.0.2 → 0.0.3

package/dist/config.js

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

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

@@ -17,6 +17,11 @@ export interface HostClientOptions {
     onReady?: () => void;
     /** An app's own event listener threw; the host caught it and kept rendering. */
     onAppError?: (error: AppErrorParams) => void;
+    /**
+     * The host exited on its own — its window was closed, or it crashed.
+     * Not called for the exit `stop()` asks for.
+     */
+    onExit?: (code: number | null, signal: NodeJS.Signals | null) => void;
     /**
      * Handlers for notification `method`s this package doesn't implement
      * itself (e.g. a future Vite integration), keyed by method name —

package/dist/dev-lock.d.mts

@@ -0,0 +1,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.
+ *
+ * @returns a function releasing the lock.
+ * @throws if another live `inca dev` holds `cwd`.
+ */
+export declare function acquireDevLock(cwd: string): Promise<() => Promise<void>>;

package/dist/dev.d.mts

@@ -20,6 +20,9 @@ export interface DevOptions {
 }
 /**
  * Builds the app, starts `inca-host` once the first build lands, and
- * reloads it on every rebuild — until `options.signal` aborts.
+ * 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.
  */
 export declare function dev(options: DevOptions): Promise<void>;

package/dist/error.d.mts

@@ -0,0 +1,11 @@
+/**
+ * A failure the CLI raises itself, identified by an `ERR_INCA_*` code the
+ * way Node's own errors carry one. The code is what a user searches for
+ * and what `printFault` names alongside the message, so every distinct
+ * cause gets its own.
+ */
+export declare class IncaError extends Error {
+    readonly code: string;
+    readonly name = "IncaError";
+    constructor(code: string, message: string);
+}

package/dist/log.d.mts

@@ -0,0 +1,28 @@
+/** Shared by {@link log} and {@link printFault}. */
+export interface LogOptions {
+    /** Prefixes the line with `HH:MM:SS`, the way Vite's dev server stamps its own. */
+    timestamp?: boolean;
+}
+/** 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. */
+export interface Fault {
+    message: string;
+    stack: string | null;
+    /** An `ERR_INCA_*` identifier, when the failure has one to look up. */
+    code?: string | null;
+}
+/**
+ * Reduces an error a bundler re-wrapped: its text is kept whole — the
+ * excerpt a compiler points at is the useful part — while the error class
+ * and any `ERR_INCA_*` marker are lifted off the first line, the latter
+ * into the fault's code.
+ */
+export declare function bundlerFault(message: string): Fault;
+/** Reduces a thrown value to a {@link Fault}. A `HostError` carries the host process's stack. */
+export declare function toFault(error: unknown): Fault;
+/**
+ * Writes `[inca] <label> (<code>): <message>` to `stream` — the code only
+ * when the failure carries one — followed by the stack when there is one.
+ */
+export declare function printFault(stream: NodeJS.WritableStream, label: string, fault: Fault, options?: LogOptions): void;

package/dist/package.d.mts

@@ -24,8 +24,10 @@ export interface PackageAppOptions {
      * process is running on.
      */
     target?: PackageTarget;
-    /** Where progress notes go. Defaults to `process.stdout`. */
+    /** Where progress notes and the bundler's own output go. Defaults to `process.stdout`. */
     stdout?: NodeJS.WritableStream;
+    /** Where the bundler's warnings and errors go. Defaults to `process.stderr`. */
+    stderr?: NodeJS.WritableStream;
 }
 /** The result of a successful {@link packageApp} call. */
 export interface PackageResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "The inca CLI: watches an app's entry point through a bundler adapter, starts inca-host once the first bundle lands, and reloads it on every rebuild.",
   "keywords": [
     "bundler",
@@ -68,9 +68,9 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.2",
-    "@incajs/host-linux-arm64": "0.0.2",
-    "@incajs/host-linux-x64": "0.0.2"
+    "@incajs/host-darwin-arm64": "0.0.3",
+    "@incajs/host-linux-arm64": "0.0.3",
+    "@incajs/host-linux-x64": "0.0.3"
   },
   "engines": {
     "node": ">=22.18"

package/dist/fault.d.mts

@@ -1,6 +0,0 @@
-export interface Fault {
-    message: string;
-    stack: string | null;
-}
-export declare function toFault(error: unknown): Fault;
-export declare function printFault(stream: NodeJS.WritableStream, label: string, fault: Fault): void;