@incajs/cli 0.0.21 → 0.0.23

package/dist/config/defaults.d.mts

@@ -1,45 +0,0 @@
-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" | "sourcemap" | "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; `"app"` for a name that holds
- * none of those characters
- */
-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

@@ -1,18 +0,0 @@
-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.
- *
- * @example
- * ```ts
- * import { defineConfig } from "@incajs/cli/config";
- *
- * export default defineConfig({
- *   productName: "Click Counter",
- *   identifier: "com.example.click-counter",
- * });
- * ```
- */
-export declare const defineConfig: (config: IncaConfig) => IncaConfig;

package/dist/config/loader.d.mts

@@ -1,82 +0,0 @@
-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. */
-    entry?: string;
-    /** Absolute path. */
-    outDir: string;
-    /** Whether `build`/`package` write `bundle.js.map`. */
-    sourcemap: boolean;
-}
-/** 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;
-    /** 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;
-}
-/**
- * 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`.
- *
- * @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, holds malformed JSON, has neither a `name` nor a
- * `productName`, an `icon` doesn't resolve to a real file, or `outDir`
- * would hold the app's own files
- */
-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
- * @throws if `package.json` exists and holds malformed JSON
- */
-export declare function resolveRuntimeConfig(cwd: string): Promise<RuntimeConfig | undefined>;

package/dist/config/types.d.mts

@@ -1,73 +0,0 @@
-/**
- * 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 from the app's root 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`,
-     * `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped in a
-     * synthesized one
-     */
-    entry?: string;
-    /**
-     * Where a build's output is written.
-     * @default "dist"
-     */
-    outDir?: string;
-    /**
-     * Whether `inca build` and `inca package` write `bundle.js.map` beside
-     * the bundle. `inca dev` always writes it.
-     * @default false
-     */
-    sourcemap?: boolean;
-    /** 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/defaultBundler.d.mts

@@ -1,7 +0,0 @@
-import { Bundler } from './types.mts';
-/**
- * `vite/` wired in as the one adapter `dev` and `build` share by
- * default: a single place to swap bundlers. Compiled `.vue` templates import
- * their helpers from `incajs/vue/runtime`.
- */
-export declare const defaultBundler: Bundler;

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

@@ -1,15 +0,0 @@
-/**
- * Where `inca-host` itself lives: `INCA_HOST_BIN` if set, otherwise the
- * per-platform npm package for this OS/arch (`@incajs/host-<os>-<arch>`, an
- * `optionalDependency` of this package).
- * @throws if neither resolves: no override is set, and either this
- * platform has no published binary, or the optional dependency carrying
- * 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

@@ -1,70 +0,0 @@
-import { AppErrorParams } from './protocol.mts';
-export interface HostClientOptions {
-    /** The entry module passed to the host as `--dev <entryFile>`. */
-    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
-     * to this process's own stderr.
-     */
-    onStderr?: (line: string) => void;
-    /**
-     * The window is open and the first bundle's evaluation has ended: its
-     * top-level `await` settled, or 2 seconds passed with it pending. A failed
-     * load the app reported keeps the window closed. The host speaks the
-     * protocol revision this package was built for.
-     */
-    onReady?: () => void;
-    /** An app's event listener threw, or the app threw or rejected while the host loaded it. */
-    onAppError?: (error: AppErrorParams) => void;
-    /**
-     * The host exited on its own, or was stopped over a protocol mismatch.
-     * 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.
-     * `params` are forwarded untouched.
-     */
-    integrations?: Record<string, (params: unknown) => void>;
-}
-/**
- * Spawns `inca-host --dev <entryFile>` and speaks newline-delimited
- * JSON-RPC 2.0 on its stdin/stdout. One instance owns exactly one child
- * process for its whole lifetime. A reload is a `reload` call on that child.
- */
-export declare class HostClient {
-    #private;
-    constructor(options: HostClientOptions);
-    /**
-     * Starts the child and wires up its streams. Resolves once the process
-     * 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>;
-    /**
-     * 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 never answers.
-     */
-    call(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;
-    /**
-     * Sends a fire-and-forget notification: no `id`, so no reply is ever
-     * awaited. Used for traffic a bundler integration owns (e.g. Vite's HMR
-     * payloads).
-     */
-    notify(method: string, params?: unknown): void;
-    /**
-     * Asks the host to `shutdown` and waits for the child to actually exit.
-     * That exit is the acknowledgement. Kills it once `timeoutMs` passes without
-     * that, so a wedged app can't block teardown.
-     */
-    stop(timeoutMs?: number): Promise<void>;
-}

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

@@ -1,6 +0,0 @@
-/** A fault the host answered a request with, carrying its JSON-RPC code. */
-export declare class HostError extends Error {
-    readonly code: number;
-    readonly hostStack: string | null;
-    constructor(message: string, code: number, hostStack?: string | null);
-}

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

@@ -1,4 +0,0 @@
-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-client/protocol.d.mts

@@ -1,39 +0,0 @@
-export declare const JSONRPC = "2.0";
-/**
- * The host method-set revision this package expects, checked against
- * `ready`'s `params.protocol`: a mismatch means an incompatible host
- * build.
- */
-export declare const HOST_PROTOCOL_VERSION = 0;
-/** `ready`'s notification params. */
-export interface ReadyParams {
-    protocol: number;
-}
-/** `appError`'s notification params. */
-export interface AppErrorParams {
-    message: string;
-    stack: string | null;
-}
-export interface RpcResult {
-    jsonrpc: typeof JSONRPC;
-    id: number;
-    result: unknown;
-}
-export interface RpcFailure {
-    jsonrpc: typeof JSONRPC;
-    /** `null` when the host fails before any call could be answered. */
-    id: number | null;
-    error: {
-        code: number;
-        message: string;
-        data?: {
-            stack: string | null;
-        };
-    };
-}
-export interface RpcNotification {
-    jsonrpc: typeof JSONRPC;
-    method: string;
-    params: unknown;
-}
-export declare function isRpcMessage(value: unknown): value is RpcResult | RpcFailure | RpcNotification;

package/dist/dev.d.mts

@@ -1,45 +0,0 @@
-import { Bundler } from './types.mts';
-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.
-     */
-    entry?: string;
-    /** Overrides the bundler. See {@link defaultBundler} for what's wired in by default. */
-    bundler?: Bundler;
-    /**
-     * Delivers module-granular updates instead of a full reload on every
-     * change, over `bundler.hmr`. See `--experimental-hmr`.
-     */
-    experimentalHmr?: boolean;
-    /**
-     * 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;
-    /** Defaults to `process.stderr`. */
-    stderr?: NodeJS.WritableStream;
-    /** Aborting tears the host and the bundler watcher down and resolves `dev()`. */
-    signal: AbortSignal;
-}
-/**
- * Builds the app, starts the host once the first build lands (at once under
- * `experimentalHmr`), and reloads it on every rebuild until `options.signal`
- * aborts or the host exits on its own.
- *
- * A config or entry that can't be used before the first build is printed as
- * `build failed`. `dev` then retries after the next edit to the config or the
- * entry.
- *
- * @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.
- * @throws if the operating system refuses a file watcher.
- * @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>;

package/dist/devLock.d.mts

@@ -1,11 +0,0 @@
-/**
- * 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, or that an earlier run of this process left behind, is taken over.
- *
- * @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/entry.d.mts

@@ -1,23 +0,0 @@
-export declare const MAIN_FILES: string[];
-/**
- * The directory Vite takes as the app's root: `src` for the entry
- * {@link resolveEntry} writes for `src/App.vue`, and the entry's own
- * directory for any other entry.
- * @param cwd - the app's root directory
- * @param entry - the app's entry file
- * @returns the directory
- */
-export declare function entryRoot(cwd: string, entry: string): string;
-/**
- * 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
- * used verbatim for full control over bootstrapping. Otherwise
- * `src/App.vue` is wrapped in a synthesized entry equivalent to
- * `createIncaApp(App).mount()`, so a plain `.vue` file is a whole app
- * with no configuration at all.
- *
- * @param cwd - the app's root directory
- * @returns the path of the entry file
- * @throws if none of the main files and no `src/App.vue` exists
- */
-export declare function resolveEntry(cwd: string): Promise<string>;

package/dist/error.d.mts

@@ -1,15 +0,0 @@
-/**
- * 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;
-    /** A file whose creation or change may resolve the error. */
-    readonly path?: string | undefined;
-    readonly name = "IncaError";
-    constructor(code: string, message: string, 
-    /** A file whose creation or change may resolve the error. */
-    path?: string | undefined);
-}

package/dist/index.d.mts

@@ -1 +0,0 @@
-export type { ResolvedAppConfig } from './config/loader.mts';

package/dist/log.d.mts

@@ -1,36 +0,0 @@
-/** 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;
-}
-/** `inca dev` stamps its lines the way Vite's dev server does. */
-export declare const STAMPED: {
-    readonly timestamp: true;
-};
-/** Writes one `[inca] <message>` line to `stream`. */
-export declare function log(stream: NodeJS.WritableStream, message: string, options?: LogOptions): void;
-/** Writes one `[inca] <message>` line to `stream`, with the tag in yellow. */
-export declare function warn(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 the stack (when there is one) followed by `[inca] <label>
- * (<code>): <message>` to `stream`. The code appears only when the failure
- * carries one. The tagged line goes last so it stays the thing visible
- * without scrolling back through the stack above it.
- */
-export declare function printFault(stream: NodeJS.WritableStream, label: string, fault: Fault, options?: LogOptions): void;

package/dist/macosApp.d.mts

@@ -1,47 +0,0 @@
-/** 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/dist/package.d.mts

@@ -1,50 +0,0 @@
-import { Bundler } from './types.mts';
-/** A platform `inca package` can emit a distributable application for. */
-export type PackageTarget = "macos" | "linux";
-/** Options for {@link packageApp}. */
-export interface PackageAppOptions {
-    /** The app's root directory. Defaults to `process.cwd()`. */
-    cwd?: string;
-    /**
-     * The app's entry point. Defaults to resolving it the same way `inca
-     * dev`/`build` do: a committed `src/main.mts`, `src/main.ts` or `src/main.js`, or `src/App.vue` wrapped
-     * in a synthesized one.
-     */
-    entry?: string;
-    /** Overrides the bundler. See {@link build}'s default. */
-    bundler?: Bundler;
-    /**
-     * Overrides which `inca-host` binary gets embedded in the packaged
-     * app, in place of automatic resolution (`INCA_HOST_BIN`, then the
-     * per-platform `@incajs/host-*` package. See {@link resolveHostBin}).
-     */
-    hostBin?: string;
-    /** Writes `bundle.js.map` beside the bundle. Overrides the config's `sourcemap` when set. */
-    sourcemap?: boolean;
-    /**
-     * The platform to package for. Defaults to whichever one the current
-     * process is running on.
-     */
-    target?: PackageTarget;
-    /** 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 {
-    /** The packaged app's path: a `.app` directory on macOS, a plain directory on Linux. */
-    appPath: string;
-}
-/**
- * Builds the app and pairs it with the prebuilt `inca-host` into a
- * distributable, platform-native application: a `.app` on macOS, a plain
- * directory on Linux, written alongside the build output, under the
- * app's own `dist/`. The app launches with no arguments and no terminal,
- * since `inca-host` finds its own bundle beside its executable.
- *
- * @throws if the app's metadata can't be read, the build fails, no
- * `inca-host` binary can be resolved for the target platform, or no file
- * exists at the resolved path.
- */
-export declare function packageApp(options?: PackageAppOptions): Promise<PackageResult>;

package/dist/plist.d.mts

@@ -1,4 +0,0 @@
-/** A macOS `Info.plist`'s value types. These are the only ones `inca package` writes. */
-export type PlistValue = string | boolean;
-/** Encodes a flat key/value dict as an `Info.plist` XML document. */
-export declare function encodePlist(dict: Record<string, PlistValue>): string;

package/dist/printConfig.d.mts

@@ -1,20 +0,0 @@
-export interface PrintConfigOptions {
-    /** The app's root directory. Defaults to `process.cwd()`. */
-    cwd?: string;
-    /** Overrides host binary resolution. */
-    hostBin?: string;
-    /** Receives the settings. Defaults to `process.stdout`. */
-    stdout?: NodeJS.WritableStream;
-    /** Receives the host's own report when it names no setting. Defaults to `process.stderr`. */
-    stderr?: NodeJS.WritableStream;
-}
-/**
- * Prints the settings the host applies to the app as JSON. The host reads the app's config from
- * `node_modules/.inca/config/inca.json`, written as a build writes it beside the bundle.
- *
- * @returns the host's exit code: 0 after printing, non-zero when the host refused the config
- * with a report that names no setting, written to `stderr`
- * @throws if the config can't be loaded, a setting holds a value the host can't use, or the
- * host binary can't be resolved, isn't a file or can't be started
- */
-export declare function printConfig(options?: PrintConfigOptions): Promise<number>;