@incajs/cli 0.0.9 → 0.0.11

package/README.md

@@ -17,7 +17,7 @@ npm i -D @incajs/cli
 ## App entry
 
 No entry point is required. Drop a `src/App.vue` and that's a whole
-app. Commit a `src/main.mts` instead for full control over
+app. Commit a `src/main.mts`, `src/main.ts` or `src/main.js` instead for full control over
 bootstrapping; it wins outright when both exist.
 
 ## Commands

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, runtimeModuleName: string, { 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,11 @@
 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 — may import `.vue` files. */
     entry: string;
     /** Where the build's output is written. */
@@ -23,12 +27,12 @@ export interface ResolveConfigOptions {
 }
 /**
  * Builds the Vite config shared by `watch` and `build`, compiling `.vue`
- * files via `@vitejs/plugin-vue` targeted at `@vue/runtime-core` rather than
- * the `vue` meta-package it requires to run.
+ * 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, 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, runtimeModuleName, entry, outDir, mode, watch, onOutput, stdout, stderr, quiet, runtimeConfig, }: ResolveConfigOptions): InlineConfig;

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

@@ -0,0 +1,8 @@
+import { AdapterCore } from '../../adapterCore.mts';
+import { Bundler } from '../types.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/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, runtimeModuleName: string, { 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, runtimeModuleName: string, { 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');

package/dist/build.d.mts

@@ -5,7 +5,7 @@ export interface BuildAppOptions {
     cwd?: string;
     /**
      * The app's entry point. Defaults to resolving it automatically: a
-     * committed `src/main.mts`, or `src/App.vue` wrapped in a synthesized one.
+     * 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. */

package/dist/chunks/defaults-TOBTBbDy.js

@@ -0,0 +1,22 @@
+//#region src/config/defaults.mts
+var e = {
+	outDir: "dist",
+	version: "0.0.0"
+};
+function t(e) {
+	let t = e.indexOf("/");
+	return e.startsWith("@") && t !== -1 ? e.slice(t + 1) : e;
+}
+var n = "app";
+function r(e) {
+	let t = e.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	return t === "" ? n : t;
+}
+function i(e) {
+	return e ? t(e) : void 0;
+}
+function a(e) {
+	return `org.inca.${r(e)}`;
+}
+//#endregion
+export { r as i, a as n, i as r, e as t };