@incajs/cli 0.0.1 → 0.0.3

package/dist/config/defaults.d.mts

@@ -0,0 +1,44 @@
+import { IncaConfig } from './types.mts';
+/**
+ * The `IncaConfig` fields whose default is a fixed value rather than one
+ * derived from `package.json` or the filesystem — importable alongside
+ * `defineConfig` for an app that wants to inherit or reference them.
+ *
+ * @example
+ * ```ts
+ * import { defaultConfig, defineConfig } from "@incajs/cli/config";
+ *
+ * export default defineConfig({
+ *   ...defaultConfig,
+ *   outDir: "build",
+ * });
+ * ```
+ */
+export declare const defaultConfig: Required<Pick<IncaConfig, "outDir" | "version">>;
+/**
+ * Strips an npm scope off a package name.
+ *
+ * @param name - a `package.json` `"name"`, e.g. `@incajs/cli` or `incajs`
+ * @returns the name with its scope removed, e.g. `cli`; an unscoped name
+ * passes through unchanged
+ */
+export declare function unscopedName(name: string): string;
+/**
+ * Turns a display name into a filesystem/URL-safe slug.
+ *
+ * @param name - e.g. a `productName`
+ * @returns `name` lowercased, with runs of non-`[a-z0-9]` collapsed to a
+ * single `-` and trimmed from both ends
+ */
+export declare function slugify(name: string): string;
+/**
+ * @param pkgName - `package.json`'s own `"name"`, if it has one
+ * @returns the `productName` a plain `package.json` implies — its name with
+ * any scope stripped — or `undefined` if it has none
+ */
+export declare function defaultProductName(pkgName: string | undefined): string | undefined;
+/**
+ * @param productName - the app's resolved display name
+ * @returns a generated `identifier`, e.g. `org.inca.click-counter`
+ */
+export declare function defaultIdentifier(productName: string): string;

package/dist/config/index.d.mts

@@ -0,0 +1,18 @@
+import { IncaConfig } from './types.mts';
+export { defaultConfig } from './defaults.mts';
+export type { IncaConfig } from './types.mts';
+/**
+ * Type-completion helper for `inca.config.ts` — an identity function at
+ * runtime, the same way `defineConfig` from `vite` or `vitest/config` works.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@incajs/cli/config";
+ *
+ * export default defineConfig({
+ *   productName: "Click Counter",
+ *   identifier: "com.example.click-counter",
+ * });
+ * ```
+ */
+export declare const defineConfig: import('c12').DefineConfig<IncaConfig, import('c12').ConfigLayerMeta>;

package/dist/config/loader.d.mts

@@ -0,0 +1,37 @@
+/** `entry`/`outDir` only — what `build()`/`dev()` need, with no `package.json` requirement. */
+export interface ResolvedBuildConfig {
+    /** Absolute path, if `inca.config.ts` set one. */
+    entry?: string;
+    /** Absolute path. */
+    outDir: string;
+}
+/** An app's full config, as `inca package` needs it. */
+export interface ResolvedAppConfig extends ResolvedBuildConfig {
+    productName: string;
+    identifier: string;
+    /** True when `identifier` was generated rather than set explicitly. */
+    identifierIsDefault: boolean;
+    version: string;
+    /** Absolute path, if the app declared one. */
+    icon?: string;
+    /** package.json's `"inca"` key is deprecated; callers warn when this is true. */
+    usedPackageJsonKey: boolean;
+}
+/**
+ * Loads just `entry`/`outDir` from `inca.config.ts`, with derived defaults.
+ * Never touches `package.json`.
+ *
+ * @param cwd - the app's root directory
+ * @returns `entry`/`outDir`, resolved to absolute paths
+ */
+export declare function resolveBuildConfig(cwd: string): Promise<ResolvedBuildConfig>;
+/**
+ * Loads an app's full config for `inca package`: `inca.config.ts` over
+ * `package.json`'s `"inca"` key over derived defaults.
+ *
+ * @param cwd - the app's root directory
+ * @returns the resolved config
+ * @throws if `package.json` is missing, has neither a `name` nor a
+ * `productName`, or an `icon` doesn't resolve to a real file
+ */
+export declare function resolveAppConfig(cwd: string): Promise<ResolvedAppConfig>;

package/dist/config/types.d.mts

@@ -0,0 +1,35 @@
+/**
+ * An app's own `inca.config.ts` (or `.js`/`.json`), loaded by `@incajs/cli`.
+ * `package.json`'s `"inca"` key still works as a fallback, but is
+ * 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. */
+    icon?: string;
+    /**
+     * A reverse-DNS-style unique id — e.g. macOS's `CFBundleIdentifier`.
+     * @default a generated `org.inca.<slug>`
+     */
+    identifier?: string;
+    /**
+     * The app's display name.
+     * @default package.json's "name", with any npm scope stripped
+     */
+    productName?: string;
+    /**
+     * The packaged app's version.
+     * @default package.json's own "version"
+     */
+    version?: string;
+    /**
+     * The app's entry point.
+     * @default resolved automatically — a committed `src/main.mts`, or
+     * `src/App.vue` wrapped in a synthesized one
+     */
+    entry?: string;
+    /**
+     * Where a build's output is written.
+     * @default "dist"
+     */
+    outDir?: string;
+}

package/dist/config.js

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

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

@@ -1 +1,2 @@
 export type { BuildOptions, BuildOutput, Bundler, BundlerOptions, Watcher, } from './adapter/types.mts';
+export type { ResolvedAppConfig } from './config/loader.mts';

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.1",
+  "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",
@@ -15,6 +15,7 @@
     "quickjs",
     "vite"
   ],
+  "homepage": "https://tom96da.github.io/incajs/",
   "license": "(MIT OR Apache-2.0)",
   "repository": {
     "type": "git",
@@ -36,25 +37,30 @@
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.mts",
+      "import": "./dist/config.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@vitejs/plugin-vue": "^6.0.8",
-    "vite": "^8.2.2"
+    "@vitejs/plugin-vue": "^6.0.9",
+    "vite": "^8.3.0"
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
-    "@vue/runtime-core": "^3.5.42",
-    "oxfmt": "^0.66.0",
-    "oxlint": "^1.81.0",
-    "rolldown": "~1.2.4",
-    "vue": "^3.5.42"
+    "@types/node": "^26.6.2",
+    "@vue/runtime-core": "^3.5.43",
+    "c12": "4.0.0-rc.1",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
+    "rolldown": "~1.2.9",
+    "vue": "^3.5.43"
   },
   "peerDependencies": {
-    "vue": "^3.5.42"
+    "vue": "^3.5.43"
   },
   "peerDependenciesMeta": {
     "vue": {
@@ -62,12 +68,12 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.1",
-    "@incajs/host-linux-arm64": "0.0.1",
-    "@incajs/host-linux-x64": "0.0.1"
+    "@incajs/host-darwin-arm64": "0.0.3",
+    "@incajs/host-linux-arm64": "0.0.3",
+    "@incajs/host-linux-x64": "0.0.3"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.18"
   },
   "scripts": {
     "build": "vite build",

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;

package/dist/metadata.d.mts

@@ -1,30 +0,0 @@
-/** An app's identity and version, for `inca package` to stamp onto the application it emits. */
-export interface AppMetadata {
-    /** Shown to the user — the app's display name. */
-    productName: string;
-    /** A reverse-DNS-style unique id — e.g. macOS's `CFBundleIdentifier`. */
-    identifier: string;
-    /** True when `identifier` was derived rather than set by the app. */
-    identifierIsDefault: boolean;
-    /** The packaged app's version. */
-    version: string;
-    /** Absolute path to an icon file, if the app declared one. */
-    icon?: string;
-}
-/**
- * Turns a display name into a filesystem/URL-safe slug — lowercased, with
- * anything outside `[a-z0-9]` collapsed into a single `-`. Used for the
- * default `identifier` and for the Linux packaged-app directory name.
- */
-export declare function slugify(name: string): string;
-/**
- * Reads an app's package metadata for `inca package`: `productName`,
- * `identifier`, `version`, and an optional `icon`. Everything is derived
- * from the app's own `package.json` — its `name`/`version` fields, and an
- * optional `"inca"` key overriding any of them:
- * `{ "inca": { "productName", "identifier", "icon" } }`.
- *
- * @throws if `package.json` is missing, has neither a `name` nor a
- * `"inca".productName`, or `"inca".icon` doesn't resolve to a real file.
- */
-export declare function readAppMetadata(cwd: string): Promise<AppMetadata>;