@incajs/cli 0.0.22 → 0.0.23

package/dist/retryOnEdit.d.mts

@@ -1,32 +0,0 @@
-import { EditWatch } from './watchForEdit.mts';
-/** Options for {@link retryOnEdit}. */
-export interface RetryOnEditOptions<T> {
-    /** The app's root directory. */
-    cwd: string;
-    /** Aborting ends the wait. */
-    signal: AbortSignal;
-    /** Receives the progress lines. */
-    stdout: NodeJS.WritableStream;
-    /** Receives each failure. */
-    stderr: NodeJS.WritableStream;
-    /** How long edits must stay quiet before the next attempt. Defaults to 100. */
-    debounceMs?: number;
-    /**
-     * One try. A thrown value is printed and the attempt repeats after the
-     * next relevant edit. `watch` is live for the whole try.
-     */
-    attempt(watch: EditWatch): Promise<T>;
-}
-/**
- * Runs `attempt` until it succeeds. A failure is printed as `build failed`,
- * then the call waits for an edit to a file that may fix it and tries again.
- * An `IncaError` that names a `path` adds that file to the watch. When that
- * file already exists, the call retries once at once and prints nothing. A
- * second failure in a row is printed and waits for an edit.
- *
- * @param options - the attempt and where to report
- * @returns the value of the first attempt that succeeds, or `undefined` when `signal` aborts first
- * @throws if the operating system refuses a watcher. The failure that led to
- * a refused `add` is printed first.
- */
-export declare function retryOnEdit<T>(options: RetryOnEditOptions<T>): Promise<T | undefined>;

package/dist/types.d.mts

@@ -1,136 +0,0 @@
-/** A running build watch. {@link Bundler.watch} resolves to this value. */
-export interface Watcher {
-    /** Stops watching and releases the underlying build process. */
-    close(): Promise<void>;
-}
-/** Options for {@link Bundler.build}. */
-export interface BuildOptions {
-    /** The app's own entry point. It may import `.vue` files. */
-    entry: string;
-    /** The app's root directory for Vite. `envDir` and `publicDir` default to locations under it. Defaults to the entry's directory. */
-    root?: string;
-    /** The directory Vite reads `.env*` files from. Defaults to `root`. */
-    envDir?: string;
-    /** The directory of static files Vite serves and copies. Defaults to `public` under `root`. */
-    publicDir?: string;
-    /** Where the build's output is written. */
-    outDir: string;
-    /** Writes `bundle.js.map` beside the bundle. Defaults to `false`. */
-    sourcemap?: boolean;
-    /**
-     * Values the built app carries for `inca-host` to read: its name, id
-     * and window. Any JSON-serializable object.
-     */
-    runtimeConfig?: unknown;
-    /** Where the bundler's own output goes. Defaults to `process.stdout`. */
-    stdout?: NodeJS.WritableStream;
-    /** Where the bundler's warnings and errors go. Defaults to `process.stderr`. */
-    stderr?: NodeJS.WritableStream;
-    /**
-     * Drops the bundler's progress output and size report, leaving the
-     * per-build summary. Set it when the build has to stay silent: part of
-     * that output goes to the process's own stdout, not to `stdout` above.
-     */
-    quiet?: boolean;
-}
-/** Options for {@link Bundler.watch}. */
-export interface BundlerOptions extends BuildOptions {
-    /** `"development"` keeps a framework's own warnings; `"production"` strips them. */
-    mode: "development" | "production";
-    /** Called after each successful (re)build, with what it wrote. */
-    onBuild: (output: BuildOutput) => void;
-    /** Called instead of `onBuild` when a (re)build fails. */
-    onError: (error: BuildFailure) => void;
-}
-/** A failed build or HMR update, in the one shape every bundler adapter reports. */
-export interface BuildFailure {
-    message: string;
-    /** The stack, plus any further detail worth printing under it. */
-    stack: string | null;
-    /** An `ERR_INCA_*` identifier, when the failure has one to look up. */
-    code?: string | null;
-}
-/**
- * What a build wrote. It is the result of {@link Bundler.build} and of every
- * {@link BundlerOptions.onBuild} call.
- */
-export interface BuildOutput {
-    /** Directory holding every file this build emitted. */
-    outDir: string;
-    /** Absolute path to the entry module `inca-host` evaluates. */
-    entryFile: string;
-    /**
-     * Every file this build emitted, relative to `outDir`. It may include chunks and assets besides
-     * the entry itself.
-     */
-    files: readonly string[];
-    /** The change that triggered this rebuild. Absent from a one-shot build and a watch's first build. */
-    changed?: {
-        file: string;
-        at: number;
-    };
-}
-/** Options for {@link Bundler.hmr}. */
-export interface HmrOptions {
-    /** The app's own entry point. It may import `.vue` files. */
-    entry: string;
-    /** The directory the app's module urls are relative to. Defaults to the entry's directory. */
-    root?: string;
-    /** The directory Vite reads `.env*` files from. Defaults to `root`. */
-    envDir?: string;
-    /** The directory of static files Vite serves. Defaults to `public` under `root`. */
-    publicDir?: string;
-    /** The app's root directory, where its dev-only scratch files are written. */
-    cwd: string;
-    /**
-     * Values the built app carries for `inca-host` to read: its name, id
-     * and window. Any JSON-serializable object.
-     */
-    runtimeConfig?: unknown;
-    /** Overrides where the synthesized entry imports `vite-runtime.js` from. Test-only. */
-    runtimePath?: string;
-    /** Where the bundler's own output goes. Defaults to `process.stdout`. */
-    stdout?: NodeJS.WritableStream;
-    /** Where the bundler's warnings and errors go. Defaults to `process.stderr`. */
-    stderr?: NodeJS.WritableStream;
-    /** Drops per-update/reload logging; warnings and errors still surface. */
-    quiet?: boolean;
-    /** Delivers a bundler payload to the running app over the dev channel. */
-    notify: (payload: unknown) => void;
-    /**
-     * Called in place of forwarding a whole-app reload payload to the app, with
-     * the edit that caused it when one was waiting.
-     */
-    reload: (changed?: {
-        file: string;
-        at: number;
-    }) => void;
-    /** Called when an update the app fetched failed to compile. */
-    onError: (error: BuildFailure) => void;
-    /** Called after a successful update, with the file that changed and how long it took. */
-    onUpdate?: (info: {
-        file: string;
-        took: number;
-    }) => void;
-}
-/** A running HMR session. {@link Bundler.hmr} resolves to this value. */
-export interface HmrChannel extends Watcher {
-    /** The synthesized entry `inca-host` evaluates for this session. */
-    entryFile: string;
-    /** Feeds a payload the running app sent back into the bundler's dev server. */
-    dispatch: (payload: unknown) => void;
-}
-/**
- * The contract a bundler adapter satisfies. Supporting another bundler
- * means adding a sibling adapter module and injecting its `Bundler` here.
- */
-export interface Bundler {
-    watch(options: BundlerOptions): Promise<Watcher>;
-    /** One-shot production build, used by `inca build`. Rejects on failure. */
-    build(options: BuildOptions): Promise<BuildOutput>;
-    /**
-     * Module-granular dev updates, used by `inca dev --experimental-hmr`.
-     * Optional: omit it when the adapter has no HMR support.
-     */
-    hmr?(options: HmrOptions): Promise<HmrChannel>;
-}

package/dist/vite/build.d.mts

@@ -1,6 +0,0 @@
-import { AdapterCore, BuildOptions, BuildOutput } from '../adapterCore.mts';
-/**
- * Builds `entry` into a minified, production build under `outDir` once, and
- * rejects on failure. Never starts or talks to `inca-host`.
- */
-export declare function build(core: AdapterCore, runtimeModuleName: string, { entry, root, envDir, publicDir, outDir, sourcemap, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;

package/dist/vite/captureOutput.d.mts

@@ -1,17 +0,0 @@
-import { Plugin } from 'vite';
-import { AdapterCore, BuildOutput } from '../adapterCore.mts';
-/** What one (re)build actually wrote, relative to its own `outDir`. */
-export interface CapturedOutput {
-    /** The emitted chunk marked as this build's entry. */
-    entryFile: string;
-    /** Every emitted file, as the bundler reported it. */
-    files: readonly string[];
-}
-/** Resolves `captured`'s paths against `outDir` into a {@link BuildOutput}. */
-export declare function toBuildOutput(outDir: string, captured: CapturedOutput, changed?: BuildOutput["changed"]): BuildOutput;
-/**
- * A Vite plugin reporting `sink` the files a build wrote once they land on
- * disk, via `writeBundle`, the one hook that fires uniformly for a
- * one-shot build and every watch rebuild.
- */
-export declare function captureOutput(core: AdapterCore, sink: (output: CapturedOutput) => void): Plugin;

package/dist/vite/config.d.mts

@@ -1,45 +0,0 @@
-import { InlineConfig } from 'vite';
-import { AdapterCore } from '../adapterCore.mts';
-import { CapturedOutput } from './captureOutput.mts';
-export declare const BUNDLE_FILE_NAME = "bundle.js";
-export interface ResolveConfigOptions {
-    core: AdapterCore;
-    /** The module compiled `.vue` templates import their helpers from. */
-    runtimeModuleName: string;
-    /** The app's own entry point. It may import `.vue` files. */
-    entry: string;
-    /** See the `root` option in `../types.mts`. Defaults to the entry's directory. */
-    root?: string;
-    /** See the `envDir` option in `../types.mts`. Defaults to `root`. */
-    envDir?: string;
-    /** See the `publicDir` option in `../types.mts`. Defaults to `public` under `root`. */
-    publicDir?: string;
-    /** Where the build's output is written. */
-    outDir: string;
-    /** `"development"` keeps `@vue/runtime-core`'s own warnings; `"production"` strips them. */
-    mode: "development" | "production";
-    /** Writes the map in a production build too. Development always writes it. */
-    sourcemap?: boolean;
-    /** Whether Vite should keep rebuilding on file changes. */
-    watch: boolean;
-    /** Called with what each successful (re)build wrote. */
-    onOutput: (output: CapturedOutput) => void;
-    /** Where Vite's own build output goes. */
-    stdout: NodeJS.WritableStream;
-    /** Where Vite's warnings and errors go. */
-    stderr: NodeJS.WritableStream;
-    /** Silences the bundler's progress output. See the `quiet` option in `../types.mts`. */
-    quiet: boolean;
-    /** Written beside the entry. See the `runtimeConfig` option in `../types.mts`. */
-    runtimeConfig?: unknown;
-}
-/**
- * Builds the Vite config shared by `watch` and `build`, compiling `.vue`
- * files via `@vitejs/plugin-vue`. Compiled templates import their helpers
- * from `runtimeModuleName`.
- *
- * An import the entry doesn't inline (a dynamic `import()`, or a `.vue`
- * file's own `<style>` block) lands as its own chunk or asset alongside
- * the entry, named by `chunkFileNames`/`assetFileNames` below.
- */
-export declare function resolveViteConfig({ core, runtimeModuleName, entry, root, envDir, publicDir, outDir, mode, sourcemap, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;

package/dist/vite/createBundler.d.mts

@@ -1,7 +0,0 @@
-import { AdapterCore, Bundler } from '../adapterCore.mts';
-/**
- * The Vite adapter.
- * @param core - the CLI logic the adapter uses
- * @param runtimeModuleName - the module compiled `.vue` templates import their helpers from
- */
-export declare function createViteBundler(core: AdapterCore, runtimeModuleName: string): Bundler;

package/dist/vite/emitConfig.d.mts

@@ -1,17 +0,0 @@
-import { Plugin } from 'vite';
-/** The file a build writes its app's config to, beside the entry. */
-export declare const CONFIG_FILE_NAME = "inca.json";
-/**
- * Serializes `config` the way `inca.json` is written: `undefined` for
- * anything that shouldn't produce a file: `undefined` itself, or an
- * object with no keys.
- */
-export declare function serializeConfig(config: unknown): string | undefined;
-/**
- * Writes `config` to `inca.json` beside the entry, for `inca-host` to read
- * when it starts the app.
- *
- * @param config - any JSON-serializable value; no file is written for
- * `undefined` or an object with no keys
- */
-export declare function emitConfig(config: unknown): Plugin;

package/dist/vite/hmr.d.mts

@@ -1,37 +0,0 @@
-import { AdapterCore, BuildFailure, HmrChannel, HmrOptions } from '../adapterCore.mts';
-/**
- * A failed update's detail: the same fields a Rollup/Vite plugin
- * error carries beyond `message`/`stack`, when it has them.
- */
-interface UpdateError {
-    message: string;
-    stack?: string | null;
-    plugin?: string | null;
-    id?: string | null;
-    frame?: string | null;
-    loc?: {
-        line: number;
-        column: number;
-    } | null;
-}
-/**
- * Reduces a failed update to a {@link BuildFailure}, with the message and
- * `code` a failed rebuild reports. Plugin, file and frame detail from Vite's
- * `buildErrorMessage` follows the stack.
- */
-export declare function faultOfUpdate(core: AdapterCore, error: UpdateError): BuildFailure;
-/**
- * The `define` entries set on `globalThis` in the development window, as values: those whose
- * key is a plain identifier and whose code is a JSON literal. A string value is code, and any
- * other value is read as its JSON form.
- * @param define - the development server's resolved `define`
- * @returns the values by key
- */
-export declare function globalsOfDefine(define: Record<string, unknown> | undefined): Record<string, unknown>;
-/**
- * Starts a Vite dev server driving the app over its dev channel instead of
- * a browser: a `"client"` environment with a custom {@link HotChannel}
- * standing in for the WebSocket server `server.ws: false` disables.
- */
-export declare function hmr(core: AdapterCore, runtimeModuleName: string, { entry, root, envDir, publicDir, cwd, runtimeConfig, runtimePath, stdout, stderr, quiet, notify, reload, onError, onUpdate, }: HmrOptions): Promise<HmrChannel>;
-export {};

package/dist/vite/index.d.mts

@@ -1 +0,0 @@
-export { createViteBundler } from './createBundler.mts';

package/dist/vite/logger.d.mts

@@ -1,8 +0,0 @@
-import { Logger } from 'vite';
-/**
- * A Vite {@link Logger} writing to the given streams: `info` to `stdout`,
- * `warn`/`error` to `stderr`, all unfiltered by Vite's own `LogOptions`. A
- * custom logger bypasses those. `quiet` drops `info` only; `warn`/`error`
- * still write, since they report something broken, not just what changed.
- */
-export declare function streamLogger(stdout: NodeJS.WritableStream, stderr: NodeJS.WritableStream, quiet?: boolean): Logger;

package/dist/vite/unsupported.d.mts

@@ -1,24 +0,0 @@
-import { Plugin } from 'vite';
-import { AdapterCore } from '../adapterCore.mts';
-/** Something an app can write that the engine can't run yet. */
-export interface UnsupportedFeature {
-    /** The `ERR_INCA_*` identifier this failure is looked up by. */
-    code: string;
-    /** The feature, named as the app's author would recognise it. */
-    name: string;
-    /** Whether a module id is a use of the feature. */
-    matches: (id: string) => boolean;
-    /** What happens instead, and what to reach for. Appended to the error. */
-    hint: string;
-}
-/**
- * Every feature a build refuses. Add an entry when the engine is found to
- * ignore something standard, so an app hits a build error instead of a
- * silent no-op at runtime; drop it again once the engine handles it.
- */
-export declare const UNSUPPORTED: readonly UnsupportedFeature[];
-/**
- * Fails the build on the first module that uses an unsupported feature,
- * naming the file that used it.
- */
-export declare function rejectUnsupported(core: AdapterCore, features?: readonly UnsupportedFeature[]): Plugin;

package/dist/vite/watch.d.mts

@@ -1,7 +0,0 @@
-import { AdapterCore, BundlerOptions, Watcher } from '../adapterCore.mts';
-/**
- * Builds `entry` into a build under `outDir` and rebuilds it on every
- * change, calling `onBuild` with what each rebuild wrote. Never starts,
- * reloads, or talks to `inca-host`.
- */
-export declare function watch(core: AdapterCore, runtimeModuleName: string, { onBuild, onError, stdout, stderr, quiet, ...buildOptions }: BundlerOptions): Promise<Watcher>;

package/dist/watchForEdit.d.mts

@@ -1,27 +0,0 @@
-/** A watch that resolves once, when a file that decides the app's config or entry changes. */
-export interface EditWatch {
-    /** Resolves once, after a relevant change has been quiet for the debounce. */
-    readonly edited: Promise<void>;
-    /** Also watches `file`, which may be missing. A change to that file counts. */
-    add(file: string): void;
-    /** Stops every watcher and timer. Safe to call more than once. */
-    close(): void;
-}
-/**
- * Watches the files that decide how an app starts: `inca.config.*` and `package.json` in `cwd`,
- * `src/main.mts`, `src/main.ts`, `src/main.js` and `src/App.vue`, and every file passed to
- * {@link EditWatch.add}. Creating, deleting, changing or renaming one of them counts as an edit.
- * Edits to other files are ignored.
- *
- * The watchers are live when this returns, so a save made while the caller
- * is working counts. An edit made before the caller awaits
- * `edited` keeps it resolved.
- *
- * @param cwd - the app's root directory
- * @param options.debounceMs - how long changes must stay quiet before `edited` resolves. Defaults to 100.
- * @returns the watch. Call `close()` when done with it.
- * @throws if the operating system refuses a watcher, for example when it is out of file handles
- */
-export declare function watchForEdit(cwd: string, options?: {
-    debounceMs?: number;
-}): EditWatch;