@evjs/cli 0.0.3 → 0.0.4

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/config.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Server configuration.
+ *
+ * Controls server backend, entry, plugins, and dev options.
+ */
+export interface ServerConfig {
+    /** Explicit server entry file. If provided, overrides auto-generated entry. */
+    entry?: string;
+    /** Server backend command. Default: "node". */
+    backend?: string;
+    /** Server function configuration. */
+    functions?: {
+        /** Server function endpoint path. Default: "/api/fn". */
+        endpoint?: string;
+    };
+    /** Build plugins for the server bundle. */
+    plugins?: EvPlugin[];
+    /** Dev server options. */
+    dev?: {
+        /** API server port (dev mode). Default: 3001. */
+        port?: number;
+        /** Enable HTTPS. */
+        https?: boolean;
+    };
+}
+/**
+ * Client configuration.
+ *
+ * Controls entry point, HTML template, dev server, and transport.
+ */
+export interface ClientConfig {
+    /** Client entry point. Default: "./src/main.tsx". */
+    entry?: string;
+    /** HTML template path. Default: "./index.html". */
+    html?: string;
+    /** Build plugins for the client bundle. */
+    plugins?: EvPlugin[];
+    /** Dev server options. */
+    dev?: {
+        /** Dev server port. Default: 3000. */
+        port?: number;
+        /** Enable HTTPS. */
+        https?: boolean;
+    };
+}
+/**
+ * A single loader entry.
+ *
+ * Can be a plain package name or an object with per-loader options.
+ *
+ * @example
+ * ```ts
+ * "css-loader"
+ * { loader: "css-loader", options: { modules: true } }
+ * ```
+ */
+export type EvLoaderEntry = string | {
+    loader: string;
+    options?: Record<string, unknown>;
+};
+/** A loader rule declared by a plugin. */
+export interface EvPluginLoader {
+    /** File matching pattern (e.g. /\.css$/, /\.svg$/). */
+    test: RegExp;
+    /** Pattern to exclude (e.g. /node_modules/). */
+    exclude?: RegExp;
+    /** Loader(s) to apply. */
+    use: EvLoaderEntry | EvLoaderEntry[];
+}
+/** An evjs build plugin. */
+export interface EvPlugin {
+    /** Plugin name for debugging and logging. */
+    name: string;
+    /** Loaders to add to the build pipeline. */
+    loaders?: EvPluginLoader[];
+}
+/**
+ * evjs framework configuration.
+ */
+export interface EvConfig {
+    server?: ServerConfig;
+    client?: ClientConfig;
+}
+/**
+ * Default configuration values.
+ *
+ * Single source of truth for all defaults across the framework.
+ */
+export declare const CONFIG_DEFAULTS: {
+    readonly entry: "./src/main.tsx";
+    readonly html: "./index.html";
+    readonly clientPort: 3000;
+    readonly serverPort: 3001;
+    readonly endpoint: "/api/fn";
+};
+/**
+ * Define configuration for the evjs framework.
+ *
+ * @example
+ * ```ts
+ * // ev.config.ts
+ * import { defineConfig } from "@evjs/cli";
+ *
+ * export default defineConfig({
+ *   client: {
+ *     entry: "./src/main.tsx",
+ *     dev: { port: 3000 },
+ *   },
+ *   server: {
+ *     functions: { endpoint: "/api/fn" },
+ *     dev: { port: 3001 },
+ *   },
+ * });
+ * ```
+ */
+export declare function defineConfig(config: EvConfig): EvConfig;

package/dist/create-webpack-config.d.ts

@@ -0,0 +1,8 @@
+import { type EvConfig } from "./config.js";
+/**
+ * Create a webpack configuration object from EvfConfig.
+ *
+ * Returns a plain object that can be passed directly to the webpack Node API.
+ * No temp files are generated.
+ */
+export declare function createWebpackConfig(config: EvConfig | undefined, cwd: string): Record<string, unknown>;

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { EvConfig } from "./config.js";
+export type { ClientConfig, EvConfig, EvLoaderEntry, EvPlugin, EvPluginLoader, ServerConfig, } from "./config.js";
+export { CONFIG_DEFAULTS, defineConfig } from "./config.js";
+export interface DevOptions {
+    cwd?: string;
+}
+/**
+ * Start the development server programmatically.
+ *
+ * @param config - evjs configuration object (from `defineConfig`)
+ * @param options - additional options like `cwd`
+ */
+export declare function dev(config?: EvConfig, options?: DevOptions): Promise<void>;
+export interface BuildOptions {
+    cwd?: string;
+}
+/**
+ * Run a production build programmatically.
+ *
+ * @param config - evjs configuration object (from `defineConfig`)
+ * @param options - additional options like `cwd`
+ */
+export declare function build(config?: EvConfig, options?: BuildOptions): Promise<void>;

package/dist/load-config.d.ts

@@ -0,0 +1,8 @@
+import type { EvConfig } from "./config.js";
+/**
+ * Load evjs config from the project root.
+ *
+ * Looks for `ev.config.ts`, `.js`, or `.mjs` in the given directory.
+ * Returns undefined if no config file is found.
+ */
+export declare function loadConfig(cwd: string): Promise<EvConfig | undefined>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evjs/cli",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "CLI and configuration layer for the evjs framework",
   "type": "module",
   "main": "./dist/index.js",