@incajs/cli 0.0.3 → 0.0.5

package/dist/config/defaults.d.mts

@@ -28,7 +28,8 @@ export declare function unscopedName(name: string): string;
  *
  * @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
+ * single `-` and trimmed from both ends; `"app"` for a name that holds
+ * none of those characters
  */
 export declare function slugify(name: string): string;
 /**

package/dist/config/loader.d.mts

@@ -1,3 +1,4 @@
+import { WindowConfig } from './types.mts';
 /** `entry`/`outDir` only — what `build()`/`dev()` need, with no `package.json` requirement. */
 export interface ResolvedBuildConfig {
     /** Absolute path, if `inca.config.ts` set one. */
@@ -14,9 +15,21 @@ export interface ResolvedAppConfig extends ResolvedBuildConfig {
     version: string;
     /** Absolute path, if the app declared one. */
     icon?: string;
+    /** What the app declared about its window, if anything. */
+    window?: WindowConfig;
     /** package.json's `"inca"` key is deprecated; callers warn when this is true. */
     usedPackageJsonKey: boolean;
 }
+/**
+ * What a built app carries for its host to read: the name the platform
+ * shows it under, the id it is known by, and its window. Each field is
+ * absent unless the app's config sets it.
+ */
+export interface RuntimeConfig {
+    name?: string;
+    identifier?: string;
+    window?: WindowConfig;
+}
 /**
  * Loads just `entry`/`outDir` from `inca.config.ts`, with derived defaults.
  * Never touches `package.json`.
@@ -35,3 +48,19 @@ export declare function resolveBuildConfig(cwd: string): Promise<ResolvedBuildCo
  * `productName`, or an `icon` doesn't resolve to a real file
  */
 export declare function resolveAppConfig(cwd: string): Promise<ResolvedAppConfig>;
+/**
+ * Narrows a full config down to what a build carries for the host.
+ *
+ * @param config - a config {@link resolveAppConfig} returned
+ * @returns its name, id and window
+ */
+export declare function runtimeConfigOf(config: ResolvedAppConfig): RuntimeConfig;
+/**
+ * Loads {@link RuntimeConfig} for an app that may name itself nowhere.
+ * An app with no `package.json`, or none that gives it a name, still gets
+ * whatever window settings it declared.
+ *
+ * @param cwd - the app's root directory
+ * @returns the config, or `undefined` when the app declares none of it
+ */
+export declare function resolveRuntimeConfig(cwd: string): Promise<RuntimeConfig | undefined>;

package/dist/config/types.d.mts

@@ -32,4 +32,35 @@ export interface IncaConfig {
      * @default "dist"
      */
     outDir?: string;
+    /** The window the app opens in. */
+    window?: WindowConfig;
+}
+/** What an app declares about its window — see {@link IncaConfig.window}. */
+export interface WindowConfig {
+    /**
+     * Initial width, in pixels. Falls back to the width the app's root
+     * element declares, then to this default.
+     * @default 800
+     */
+    width?: number;
+    /**
+     * Initial height, in pixels. Falls back to the height the app's root
+     * element declares, then to this default.
+     * @default 600
+     */
+    height?: number;
+    /**
+     * The window's title.
+     * @default the app's productName
+     */
+    title?: string;
+    /**
+     * Whether a user can resize the window.
+     * @default false
+     */
+    resizable?: boolean;
+    /** Smallest width the window can be, in pixels. It opens at least this wide. */
+    minWidth?: number;
+    /** Smallest height the window can be, in pixels. It opens at least this tall. */
+    minHeight?: number;
 }

package/dist/config.js

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

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

@@ -44,8 +44,14 @@ export declare class HostClient {
      * binary doesn't exist).
      */
     start(): Promise<void>;
-    /** Sends a request and resolves with its result once the host answers. */
-    call(method: string, params?: unknown): Promise<unknown>;
+    /**
+     * Sends a request and resolves with its result once the host answers.
+     * With `timeoutMs`, rejects once that much time passes with no answer —
+     * the host answers on the same thread that runs the app's JS, so a
+     * wedged app leaves a call pending forever otherwise (PROTOCOL.md:
+     * "every response a client waits for needs a deadline").
+     */
+    call(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;
     /**
      * Asks the host to `shutdown` and waits for the child to actually exit —
      * that exit is the real acknowledgement, not the response. Kills it once

package/dist/dev.d.mts

@@ -9,7 +9,10 @@ export interface DevOptions {
     entry?: string;
     /** Overrides the bundler — see {@link defaultBundler} for what's wired in by default. */
     bundler?: Bundler;
-    /** Overrides host binary resolution — passed straight through to `HostClient`. */
+    /**
+     * Overrides host binary resolution. On macOS this is the binary the
+     * app bundle wraps; elsewhere it is launched directly.
+     */
     hostBin?: string;
     /** Defaults to `process.stdout`. */
     stdout?: NodeJS.WritableStream;

package/dist/index.d.mts

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

package/dist/macos-app.d.mts

@@ -0,0 +1,47 @@
+/** The app metadata a `.app` bundle's `Info.plist` carries. */
+export interface MacosAppMetadata {
+    /** The name macOS shows in the Dock, the menu bar and the Finder. */
+    productName: string;
+    /** A reverse-DNS-style unique id, written as `CFBundleIdentifier`. */
+    identifier: string;
+    /** The app's version, written as both `CFBundleVersion` and `CFBundleShortVersionString`. */
+    version: string;
+    /** Absolute path to an icon file, copied into `Contents/Resources`. */
+    icon?: string;
+}
+/** Options for {@link writeMacosApp}. */
+export interface WriteMacosAppOptions {
+    /** Where the `.app` directory is written. An existing one there is replaced. */
+    appPath: string;
+    /** What the bundle's `Info.plist` describes. */
+    metadata: MacosAppMetadata;
+    /** The `inca-host` binary the bundle's executable is made from. */
+    hostBin: string;
+    /**
+     * Hard-links the executable to `hostBin` rather than copying it, and
+     * copies when the two paths are on different filesystems. Set it where
+     * the bundle is rebuilt often and holds no files of its own.
+     */
+    link?: boolean;
+}
+/** The paths {@link writeMacosApp} created. */
+export interface MacosApp {
+    /** The `.app` directory itself. */
+    appPath: string;
+    /** The bundle's executable, at `Contents/MacOS/<productName>`. */
+    executablePath: string;
+    /** `Contents/Resources`, where an app's own files belong. */
+    resourcesDir: string;
+}
+/**
+ * Writes a macOS `.app` bundle around the `inca-host` binary:
+ * `Contents/MacOS` holding the executable, `Contents/Resources` left empty
+ * apart from the icon, and `Info.plist`/`PkgInfo` beside them. macOS reads
+ * the app's name, icon and identifier from the bundle, so an executable
+ * launched from one carries them wherever the platform shows an app.
+ *
+ * @param options - where to write, what to describe, and which binary to use
+ * @returns the bundle's own path, its executable, and its resources directory
+ * @throws if any part of the bundle can't be written
+ */
+export declare function writeMacosApp(options: WriteMacosAppOptions): Promise<MacosApp>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@incajs/cli",
-  "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.",
+  "version": "0.0.5",
+  "description": "Dev server, bundler, and packager for Incarnative.js apps.",
   "keywords": [
     "bundler",
     "cli",
@@ -68,9 +68,9 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.3",
-    "@incajs/host-linux-arm64": "0.0.3",
-    "@incajs/host-linux-x64": "0.0.3"
+    "@incajs/host-darwin-arm64": "0.0.5",
+    "@incajs/host-linux-arm64": "0.0.5",
+    "@incajs/host-linux-x64": "0.0.5"
   },
   "engines": {
     "node": ">=22.18"