@incajs/cli 0.0.8 → 0.0.10

package/README.md

@@ -26,7 +26,7 @@ bootstrapping; it wins outright when both exist.
   reloading on every change. `--experimental-hmr` (or
   `INCA_EXPERIMENTAL_HMR=1`) opts into experimental, module-granular
   hot reloading instead — see the
-  [HMR guide](https://tom96da.github.io/incajs/guide/hmr).
+  [HMR guide](https://incajs.tom96da.com/guide/hmr).
 - **`inca build`** — bundles your app for production, once, with no
   window opened.
 - **`inca package`** — builds your app, then packages it with a
@@ -62,7 +62,7 @@ once it is packaged.
 
 A prebuilt binary is pulled in automatically as a platform-specific
 optional dependency — neither Cargo nor Rust are needed. See
-[Host binary](https://tom96da.github.io/incajs/guide/#host-binary) for
+[Host binary](https://incajs.tom96da.com/guide/#host-binary) for
 per-platform support.
 
 Set `INCA_HOST_BIN` to use a specific binary instead, e.g. on a

package/dist/adapter/types.d.mts

@@ -32,11 +32,15 @@ export interface BundlerOptions extends BuildOptions {
     /** 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: {
-        message: string;
-        stack: string | null;
-        code?: string | null;
-    }) => void;
+    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 — the result of {@link Bundler.build}, and every {@link BundlerOptions.onBuild} call. */
 export interface BuildOutput {
@@ -52,21 +56,6 @@ export interface BuildOutput {
         at: number;
     };
 }
-/**
- * A failed HMR update's detail — the same fields a Rollup/Vite plugin
- * error carries beyond `message`/`stack`, when it has them.
- */
-export interface UpdateError {
-    message: string;
-    stack?: string | null;
-    plugin?: string | null;
-    id?: string | null;
-    frame?: string | null;
-    loc?: {
-        line: number;
-        column: number;
-    } | null;
-}
 /** Options for {@link Bundler.hmr}. */
 export interface HmrOptions {
     /** The app's own entry point — may import `.vue` files. */
@@ -91,7 +80,7 @@ export interface HmrOptions {
     /** Called in place of forwarding a whole-app reload payload to the app. */
     reload: () => void;
     /** Called when an update the app fetched failed to compile. */
-    onError: (error: UpdateError) => void;
+    onError: (error: BuildFailure) => void;
     /** Called after a successful update, with the file that changed and how long it took. */
     onUpdate?: (info: {
         file: string;

package/dist/adapter/vite/build.d.mts

@@ -1,7 +1,8 @@
+import { AdapterCore } from '../../adapterCore.mts';
 import { BuildOptions, BuildOutput } from '../types.mts';
 /**
  * Builds `entry` into a minified, production build under `outDir` once, and
  * rejects on failure rather than reporting it through a callback. Never
  * starts or talks to `inca-host` — that's `dev.mts`'s job.
  */
-export declare function build({ entry, outDir, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;
+export declare function build(core: AdapterCore, { entry, outDir, runtimeConfig, stdout, stderr, quiet, }: BuildOptions): Promise<BuildOutput>;

package/dist/adapter/vite/captureOutput.d.mts

@@ -1,4 +1,5 @@
 import { Plugin } from 'vite';
+import { AdapterCore } from '../../adapterCore.mts';
 import { BuildOutput } from '../types.mts';
 /** What one (re)build actually wrote, relative to its own `outDir`. */
 export interface CapturedOutput {
@@ -15,4 +16,4 @@ export declare function toBuildOutput(outDir: string, captured: CapturedOutput,
  * one-shot build and every watch rebuild, so both read the bundler's real
  * output instead of assuming a file name or layout.
  */
-export declare function captureOutput(sink: (output: CapturedOutput) => void): Plugin;
+export declare function captureOutput(core: AdapterCore, sink: (output: CapturedOutput) => void): Plugin;

package/dist/adapter/vite/config.d.mts

@@ -1,7 +1,9 @@
 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 app's own entry point — may import `.vue` files. */
     entry: string;
     /** Where the build's output is written. */
@@ -31,4 +33,4 @@ export interface ResolveConfigOptions {
  * the entry, named by `chunkFileNames`/`assetFileNames` below, rather than
  * failing the build.
  */
-export declare function resolveViteConfig({ entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;
+export declare function resolveViteConfig({ core, entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;

package/dist/adapter/vite/createBundler.d.mts

@@ -0,0 +1,4 @@
+import { AdapterCore } from '../../adapterCore.mts';
+import { Bundler } from '../types.mts';
+/** The Vite adapter. */
+export declare function createViteBundler(core: AdapterCore): Bundler;

package/dist/adapter/vite/hmr.d.mts

@@ -1,7 +1,30 @@
-import { HmrChannel, HmrOptions } from '../types.mts';
+import { AdapterCore } from '../../adapterCore.mts';
+import { BuildFailure, HmrChannel, HmrOptions } from '../types.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;
 /**
  * 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({ entry, cwd, runtimeConfig, runtimePath, stdout, stderr, quiet, notify, reload, onError, onUpdate, }: HmrOptions): Promise<HmrChannel>;
+export declare function hmr(core: AdapterCore, { entry, cwd, runtimeConfig, runtimePath, stdout, stderr, quiet, notify, reload, onError, onUpdate, }: HmrOptions): Promise<HmrChannel>;
+export {};

package/dist/adapter/vite/index.d.mts

@@ -1,3 +1 @@
-export { build } from './build.mts';
-export { hmr } from './hmr.mts';
-export { watch } from './watch.mts';
+export { createViteBundler } from './createBundler.mts';

package/dist/adapter/vite/unsupported.d.mts

@@ -1,4 +1,5 @@
 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. */
@@ -20,4 +21,4 @@ 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(features?: readonly UnsupportedFeature[]): Plugin;
+export declare function rejectUnsupported(core: AdapterCore, features?: readonly UnsupportedFeature[]): Plugin;

package/dist/adapter/vite/watch.d.mts

@@ -1,7 +1,8 @@
+import { AdapterCore } from '../../adapterCore.mts';
 import { BundlerOptions, Watcher } from '../types.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` — that's `dev.mts`'s job.
  */
-export declare function watch({ onBuild, onError, stdout, stderr, quiet, ...buildOptions }: BundlerOptions): Promise<Watcher>;
+export declare function watch(core: AdapterCore, { onBuild, onError, stdout, stderr, quiet, ...buildOptions }: BundlerOptions): Promise<Watcher>;

package/dist/adapterCore.d.mts

@@ -0,0 +1,10 @@
+export { IncaError } from './error.mts';
+export { bundlerFault } from './log.mts';
+/**
+ * The CLI logic the CLI injects into a bundler adapter: the `IncaError`
+ * class and `bundlerFault`, which reduces a bundler's error to a printable
+ * fault.
+ *
+ * Also the seam an adapter's own tests pass the real module through.
+ */
+export type AdapterCore = typeof import('./adapterCore.mts');