alepha 0.19.0 → 0.19.2

package/dist/cli/core/index.d.ts

@@ -1,21 +1,22 @@
-import * as alepha from "alepha";
+import * as _$alepha from "alepha";
 import { Alepha, Static } from "alepha";
-import * as alepha_command0 from "alepha/command";
+import * as _$alepha_command0 from "alepha/command";
 import { CliProvider, EnvUtils, Runner, RunnerMethod } from "alepha/command";
-import * as alepha_logger0 from "alepha/logger";
+import * as _$alepha_logger0 from "alepha/logger";
 import { ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
 import { BrotliOptions, ZlibOptions, brotliCompress, gzip } from "node:zlib";
-import * as typebox from "typebox";
-import * as vite from "vite";
+import { spawn } from "node:child_process";
+import * as _$typebox from "typebox";
+import * as _$vite from "vite";
 import { Logger, Plugin, ViteDevServer } from "vite";
 import { DatabaseProvider } from "alepha/orm";
 
 //#region ../../src/cli/core/atoms/appEntryOptions.d.ts
-declare const appEntryOptions: alepha.Atom<alepha.TObject<{
-  server: alepha.TOptional<alepha.TString>;
-  browser: alepha.TOptional<alepha.TString>;
-  style: alepha.TOptional<alepha.TString>;
+declare const appEntryOptions: _$alepha.Atom<_$alepha.TObject<{
+  server: _$alepha.TOptional<_$alepha.TString>;
+  browser: _$alepha.TOptional<_$alepha.TString>;
+  style: _$alepha.TOptional<_$alepha.TString>;
 }>, "alepha.cli.appEntry.options">;
 type AppEntryOptions = Static<typeof appEntryOptions.schema>;
 //#endregion
@@ -42,14 +43,14 @@ type BuildRuntime = "node" | "bun" | "workerd";
  * Defines the available build configuration options with their defaults.
  * Options can be overridden via alepha.config.ts or CLI flags.
  */
-declare const buildOptions: alepha.Atom<alepha.TObject<{
+declare const buildOptions: _$alepha.Atom<_$alepha.TObject<{
   /**
    * Generate build stats report.
    *
    * - `true` - Generate a static HTML report
    * - `"json"` - Generate a JSON report
    */
-  stats: alepha.TOptional<alepha.TUnion<[alepha.TBoolean, alepha.TUnsafe<"json">]>>;
+  stats: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TBoolean, _$alepha.TUnsafe<"json">]>>;
   /**
    * Deployment target for the build output.
    *
@@ -57,7 +58,7 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    * - `vercel` - Generate Vercel deployment configuration (forces node runtime)
    * - `cloudflare` - Generate Cloudflare Workers configuration (forces workerd runtime)
    */
-  target: alepha.TOptional<alepha.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
+  target: _$alepha.TOptional<_$alepha.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
   /**
    * JavaScript runtime for the build output.
    *
@@ -69,23 +70,23 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    * - `cloudflare` always uses `workerd`
    * - `vercel` always uses `node`
    */
-  runtime: alepha.TOptional<alepha.TUnsafe<"node" | "bun" | "workerd">>;
+  runtime: _$alepha.TOptional<_$alepha.TUnsafe<"node" | "bun" | "workerd">>;
   /**
    * Output directory configuration.
    */
-  output: alepha.TOptional<alepha.TObject<{
+  output: _$alepha.TOptional<_$alepha.TObject<{
     /**
      * Root dist directory.
      *
      * @default "dist"
      */
-    dist: alepha.TOptional<alepha.TString>;
+    dist: _$alepha.TOptional<_$alepha.TString>;
     /**
      * Public/client subdirectory.
      *
      * @default "public"
      */
-    public: alepha.TOptional<alepha.TString>;
+    public: _$alepha.TOptional<_$alepha.TString>;
   }>>;
   /**
    * Vercel-specific deployment configuration.
@@ -93,14 +94,14 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    * Note: Set `target: "vercel"` to enable Vercel deployment.
    * This object is only for additional configuration.
    */
-  vercel: alepha.TOptional<alepha.TObject<{
-    projectName: alepha.TOptional<alepha.TString>;
-    orgId: alepha.TOptional<alepha.TString>;
-    projectId: alepha.TOptional<alepha.TString>;
-    config: alepha.TOptional<alepha.TObject<{
-      crons: alepha.TOptional<alepha.TArray<alepha.TObject<{
-        path: alepha.TString;
-        schedule: alepha.TString;
+  vercel: _$alepha.TOptional<_$alepha.TObject<{
+    projectName: _$alepha.TOptional<_$alepha.TString>;
+    orgId: _$alepha.TOptional<_$alepha.TString>;
+    projectId: _$alepha.TOptional<_$alepha.TString>;
+    config: _$alepha.TOptional<_$alepha.TObject<{
+      crons: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
+        path: _$alepha.TString;
+        schedule: _$alepha.TString;
       }>>>;
     }>>;
   }>>;
@@ -110,8 +111,8 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    * Note: Set `target: "cloudflare"` to enable Cloudflare deployment.
    * This object is only for additional configuration.
    */
-  cloudflare: alepha.TOptional<alepha.TObject<{
-    config: alepha.TOptional<alepha.TRecord<string, alepha.TAny>>;
+  cloudflare: _$alepha.TOptional<_$alepha.TObject<{
+    config: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
   }>>;
   /**
    * Docker-specific deployment configuration.
@@ -119,25 +120,25 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    * Note: Set `target: "docker"` to enable Docker deployment.
    * This object is only for additional configuration.
    */
-  docker: alepha.TOptional<alepha.TObject<{
+  docker: _$alepha.TOptional<_$alepha.TObject<{
     /**
      * Base image for the Dockerfile (FROM instruction).
      *
      * @default "node:24-alpine" for node runtime
      * @default "oven/bun:alpine" for bun runtime
      */
-    from: alepha.TOptional<alepha.TString>;
+    from: _$alepha.TOptional<_$alepha.TString>;
     /**
      * Command to run in the Docker container.
      *
      * @default "node" for node runtime
      * @default "bun" for bun runtime
      */
-    command: alepha.TOptional<alepha.TString>;
+    command: _$alepha.TOptional<_$alepha.TString>;
     /**
      * Docker build options (used when --image flag is passed).
      */
-    image: alepha.TOptional<alepha.TObject<{
+    image: _$alepha.TOptional<_$alepha.TObject<{
       /**
        * Default image tag (name without version).
        *
@@ -149,13 +150,13 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
        * @example "myproject/myapp"
        * @example "ghcr.io/myorg/myapp"
        */
-      tag: alepha.TString;
+      tag: _$alepha.TString;
       /**
        * Additional arguments to pass to `docker build`.
        *
        * @example '--platform linux/amd64 --no-cache'
        */
-      args: alepha.TOptional<alepha.TString>;
+      args: _$alepha.TOptional<_$alepha.TString>;
       /**
        * Auto-add OCI standard labels (revision, created, version).
        *
@@ -164,7 +165,7 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
        * - org.opencontainers.image.created (build timestamp)
        * - org.opencontainers.image.version (from image tag)
        */
-      oci: alepha.TOptional<alepha.TBoolean>;
+      oci: _$alepha.TOptional<_$alepha.TBoolean>;
     }>>;
   }>>;
   /**
@@ -172,7 +173,7 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
    *
    * Note: Set `target: "static"` to enable static site generation.
    */
-  static: alepha.TOptional<alepha.TObject<{
+  static: _$alepha.TOptional<_$alepha.TObject<{
     /**
      * Surge domain for deployment.
      *
@@ -182,16 +183,16 @@ declare const buildOptions: alepha.Atom<alepha.TObject<{
      * @example "my-app.surge.sh"
      * @example "my-custom-domain.com"
      */
-    domain: alepha.TOptional<alepha.TString>;
+    domain: _$alepha.TOptional<_$alepha.TString>;
   }>>;
   /**
    * Sitemap generation configuration.
    */
-  sitemap: alepha.TOptional<alepha.TObject<{
+  sitemap: _$alepha.TOptional<_$alepha.TObject<{
     /**
      * Base URL for sitemap entries.
      */
-    hostname: alepha.TString;
+    hostname: _$alepha.TString;
   }>>;
 }>, "alepha.cli.build.options">;
 /**
@@ -217,12 +218,12 @@ declare const DEFAULT_IGNORE: string[];
  * });
  * ```
  */
-declare const changelogOptions: alepha.Atom<alepha.TObject<{
+declare const changelogOptions: _$alepha.Atom<_$alepha.TObject<{
   /**
    * Scopes to ignore (e.g., "project", "release", "chore").
    * Commits like `feat(chore): ...` will be excluded from changelog.
    */
-  ignore: alepha.TOptional<alepha.TArray<alepha.TString>>;
+  ignore: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
 }>, "alepha.cli.changelog.options">;
 type ChangelogOptions = Static<typeof changelogOptions.schema>;
 //#endregion
@@ -233,15 +234,11 @@ type ChangelogOptions = Static<typeof changelogOptions.schema>;
  * Defines the available dev configuration options with their defaults.
  * Options can be overridden via alepha.config.ts or CLI flags.
  */
-declare const devOptions: alepha.Atom<alepha.TObject<{
-  /**
-   * Disable devtools.
-   */
-  noDevtools: alepha.TOptional<alepha.TBoolean>;
+declare const devOptions: _$alepha.Atom<_$alepha.TObject<{
   /**
    * Disable Vite React plugin.
    */
-  noViteReactPlugin: alepha.TOptional<alepha.TBoolean>;
+  noViteReactPlugin: _$alepha.TOptional<_$alepha.TBoolean>;
 }>, "alepha.cli.dev.options">;
 /**
  * Type for dev options.
@@ -322,7 +319,7 @@ declare class ViteUtils {
   /**
    * Lazy-load Vite (with rolldown-vite fallback).
    */
-  importVite(): Promise<typeof vite>;
+  importVite(): Promise<typeof _$vite>;
   /**
    * Lazy-load @vitejs/plugin-react (optional).
    */
@@ -350,8 +347,8 @@ declare class ViteUtils {
   /**
    * We need to close the Vite dev server after build is done.
    */
-  protected onReady: alepha.HookPrimitive<"ready">;
-  protected onStop: alepha.HookPrimitive<"stop">;
+  protected onReady: _$alepha.HookPrimitive<"ready">;
+  protected onStop: _$alepha.HookPrimitive<"stop">;
   runAlepha(opts: {
     entry: AppEntry;
     mode: "production" | "development";
@@ -380,7 +377,7 @@ declare class ViteBuildProvider {
  * - Environment loading
  */
 declare class AlephaCliUtils {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly envUtils: EnvUtils;
   protected readonly boot: AppEntryProvider;
@@ -467,7 +464,7 @@ interface WorkspaceContext {
  * - Bun
  */
 declare class PackageManagerUtils {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly alepha: Alepha;
   /**
@@ -567,7 +564,7 @@ type AgentMdType = "claude" | "agents";
  * - Example code (HelloController, Home component)
  */
 declare class ProjectScaffolder {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly colors: ConsoleColorProvider;
   protected readonly fs: FileSystemProvider;
   protected readonly pm: PackageManagerUtils;
@@ -683,8 +680,7 @@ declare class ProjectScaffolder {
       api?: boolean;
       react?: boolean;
       ui?: boolean;
-      auth?: boolean;
-      admin?: boolean;
+      saas?: boolean;
       tailwind?: boolean;
       test?: boolean;
       force?: boolean;
@@ -905,11 +901,12 @@ declare class BuildPrerenderTask extends BuildTask {
  */
 declare class BuildServerTask extends BuildTask {
   protected readonly alepha: Alepha;
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly viteUtils: ViteUtils;
   run(ctx: BuildTaskContext): Promise<void>;
   protected buildServer(opts: {
+    root: string;
     entry: string;
     distDir: string;
     clientDir?: string;
@@ -926,7 +923,7 @@ declare class BuildServerTask extends BuildTask {
   protected generateExternals(distDir: string, externals: string[]): Promise<void>;
   protected loadJsonFile(path: string): Promise<any>;
   protected stripClientManifest(manifest: Record<string, any> | undefined): Record<string, any> | undefined;
-  protected extractEntryFromBundle(entry: string, result: vite.Rollup.RollupOutput | vite.Rollup.RollupOutput[] | vite.Rollup.RollupWatcher): string;
+  protected extractEntryFromBundle(root: string, entry: string, result: _$vite.Rollup.RollupOutput | _$vite.Rollup.RollupOutput[] | _$vite.Rollup.RollupWatcher): string;
 }
 //#endregion
 //#region ../../src/cli/core/tasks/BuildSitemapTask.d.ts
@@ -1011,13 +1008,15 @@ declare class BuildVercelTask extends BuildTask {
 //#region ../../src/cli/core/commands/build.d.ts
 declare class BuildCommand {
   protected readonly alepha: Alepha;
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
   protected readonly scaffolder: ProjectScaffolder;
   protected readonly boot: AppEntryProvider;
   protected readonly viteBuildProvider: ViteBuildProvider;
   protected readonly options: Readonly<{
+    stats?: boolean | "json" | undefined;
+    target?: "bare" | "docker" | "vercel" | "cloudflare" | "static" | undefined;
     docker?: {
       from?: string | undefined;
       command?: string | undefined;
@@ -1039,15 +1038,13 @@ declare class BuildCommand {
       } | undefined;
     } | undefined;
     cloudflare?: {
-      config?: typebox.StaticRecord<[], "Decode", {}, {
-        config: alepha.TOptional<alepha.TRecord<string, alepha.TAny>>;
-      }, string, alepha.TAny> | undefined;
+      config?: _$typebox.StaticRecord<[], "Decode", {}, {
+        config: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      }, string, _$alepha.TAny> | undefined;
     } | undefined;
     static?: {
       domain?: string | undefined;
     } | undefined;
-    stats?: boolean | "json" | undefined;
-    target?: "bare" | "docker" | "vercel" | "cloudflare" | "static" | undefined;
     runtime?: "node" | "bun" | "workerd" | undefined;
     output?: {
       dist?: string | undefined;
@@ -1074,13 +1071,13 @@ declare class BuildCommand {
    * @throws {AlephaError} If an incompatible runtime is specified for a target
    */
   protected resolveRuntime(target: BuildTarget | undefined, runtime: BuildRuntime | undefined): BuildRuntime;
-  readonly build: alepha_command0.CommandPrimitive<alepha.TObject<{
-    stats: alepha.TOptional<alepha.TUnion<[alepha.TBoolean, alepha.TUnsafe<"json">]>>;
-    target: alepha.TOptional<alepha.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
-    runtime: alepha.TOptional<alepha.TUnsafe<"node" | "bun" | "workerd">>;
-    image: alepha.TOptional<alepha.TUnion<[alepha.TBoolean, alepha.TString]>>;
-    sitemap: alepha.TOptional<alepha.TString>;
-  }>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly build: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    stats: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TBoolean, _$alepha.TUnsafe<"json">]>>;
+    target: _$alepha.TOptional<_$alepha.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
+    runtime: _$alepha.TOptional<_$alepha.TUnsafe<"node" | "bun" | "workerd">>;
+    image: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TBoolean, _$alepha.TString]>>;
+    sitemap: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/clean.d.ts
@@ -1088,12 +1085,12 @@ declare class CleanCommand {
   /**
    * Clean the project, removing the "dist" directory
    */
-  readonly clean: alepha_command0.CommandPrimitive<typebox.TObject<typebox.TProperties>, typebox.TSchema, typebox.TObject<typebox.TProperties>>;
+  readonly clean: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/db.d.ts
 declare class DbCommand {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
@@ -1103,44 +1100,44 @@ declare class DbCommand {
   /**
    * Check if database migrations are up to date.
    */
-  protected readonly check: alepha_command0.CommandPrimitive<alepha.TObject<{
-    provider: alepha.TOptional<alepha.TString>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  protected readonly check: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    provider: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Generate database migration files
    */
-  protected readonly create: alepha_command0.CommandPrimitive<alepha.TObject<{
-    provider: alepha.TOptional<alepha.TString>;
-    custom: alepha.TOptional<alepha.TBoolean>;
-    name: alepha.TOptional<alepha.TString>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  protected readonly create: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    provider: _$alepha.TOptional<_$alepha.TString>;
+    custom: _$alepha.TOptional<_$alepha.TBoolean>;
+    name: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Push database schema changes directly to the database
    */
-  protected readonly push: alepha_command0.CommandPrimitive<alepha.TObject<{
-    provider: alepha.TOptional<alepha.TString>;
-    dryRun: alepha.TOptional<alepha.TBoolean>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  protected readonly push: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    provider: _$alepha.TOptional<_$alepha.TString>;
+    dryRun: _$alepha.TOptional<_$alepha.TBoolean>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Apply pending database migrations
    */
-  protected readonly apply: alepha_command0.CommandPrimitive<alepha.TObject<{
-    provider: alepha.TOptional<alepha.TString>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  protected readonly apply: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    provider: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Launch Drizzle Studio database browser
    */
-  protected readonly studio: alepha_command0.CommandPrimitive<alepha.TObject<{
-    provider: alepha.TOptional<alepha.TString>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  protected readonly studio: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    provider: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Parent command for migration operations.
    */
-  protected readonly migrations: alepha_command0.CommandPrimitive<alepha.TObject<alepha.TProperties>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  protected readonly migrations: _$alepha_command0.CommandPrimitive<_$alepha.TObject<_$alepha.TProperties>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Parent command for database operations.
    */
-  readonly db: alepha_command0.CommandPrimitive<alepha.TObject<alepha.TProperties>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly db: _$alepha_command0.CommandPrimitive<_$alepha.TObject<_$alepha.TProperties>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
   /**
    * Run a drizzle-kit command for all database providers in an Alepha instance.
    */
@@ -1192,15 +1189,15 @@ interface DevServerOptions {
    * Path to the server entry file.
    */
   entry: AppEntry;
-  /**
-   * Disable devtools.
-   */
-  noDevtools?: boolean;
   /**
    * Disable Vite React plugin.
    */
   noViteReactPlugin?: boolean;
 }
+/**
+ * Hook called after Alepha is loaded during dev server init/reload.
+ */
+type OnAlephaLoadedHook = (alepha: Alepha, server: ViteDevServer) => Promise<void>;
 /**
  * Vite development server with Alepha integration.
  *
@@ -1215,7 +1212,7 @@ interface DevServerOptions {
  * - Shared changes → Reload Alepha → Let HMR propagate
  */
 declare class ViteDevServerProvider {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly colors: ConsoleColorProvider;
   protected readonly viteUtils: ViteUtils;
@@ -1230,6 +1227,21 @@ declare class ViteDevServerProvider {
   protected isReloading: boolean;
   protected needsBrowserReload: boolean;
   protected currentReloadPromise: Promise<void> | null;
+  protected extraVitePlugins: Plugin[];
+  protected alephaLoadedHooks: OnAlephaLoadedHook[];
+  /**
+   * Register an additional Vite plugin.
+   * Must be called before init().
+   */
+  addVitePlugin(plugin: Plugin): void;
+  /**
+   * Register a hook called after Alepha is loaded/reloaded.
+   */
+  onAlephaLoaded(hook: OnAlephaLoadedHook): void;
+  /**
+   * Trigger a full Alepha reload programmatically.
+   */
+  reload(): void;
   /**
    * Initialize the dev server and load Alepha.
    */
@@ -1345,7 +1357,7 @@ declare class ViteDevServerProvider {
   /**
    * Log a formatted error with stack trace.
    */
-  protected logError(title: string, _err: unknown): void;
+  protected logError(title: string, err: unknown): void;
   /**
    * Log error message and stack, recursively logging cause if present.
    */
@@ -1354,7 +1366,7 @@ declare class ViteDevServerProvider {
 //#endregion
 //#region ../../src/cli/core/commands/dev.d.ts
 declare class DevCommand {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
@@ -1363,16 +1375,49 @@ declare class DevCommand {
   protected readonly viteDevServer: ViteDevServerProvider;
   protected readonly boot: AppEntryProvider;
   protected readonly options: Readonly<{
-    noDevtools?: boolean | undefined;
     noViteReactPlugin?: boolean | undefined;
   }>;
   /**
    * Will run the project in watch mode.
+   *
+   * When run from a workspace root (with apps/ directory), spawns all apps in parallel.
+   * When run from an app directory, starts a single Vite dev server.
+   */
+  readonly dev: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    only: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
+  /**
+   * Discover apps in the workspace root.
+   *
+   * Looks for directories under apps/ that contain a package.json.
+   * Supports scoped directories (e.g., apps/@passeo/api).
+   * Returns empty array if not in a workspace root.
+   */
+  protected discoverApps(root: string): Promise<Array<{
+    name: string;
+    path: string;
+  }>>;
+  /**
+   * Run a single app (existing behavior).
+   */
+  protected runSingle(root: string): Promise<void>;
+  /**
+   * Run multiple apps in parallel with colored prefixed output.
+   */
+  protected runMultiple(_root: string, apps: Array<{
+    name: string;
+    path: string;
+  }>, flags: Record<string, unknown>): Promise<void>;
+  /**
+   * Spawn a single app process with inherited stdio.
+   *
+   * Each child process gets APP_NAME set, so the Alepha logger
+   * handles prefixing automatically.
    */
-  readonly dev: alepha_command0.CommandPrimitive<alepha.TObject<{
-    "no-devtools": alepha.TOptional<alepha.TBoolean>;
-    "no-vite-react-plugin": alepha.TOptional<alepha.TBoolean>;
-  }>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  protected spawnApp(app: {
+    name: string;
+    path: string;
+  }, port: number): ReturnType<typeof spawn>;
 }
 //#endregion
 //#region ../../src/cli/core/services/GitMessageParser.d.ts
@@ -1391,7 +1436,7 @@ declare class DevCommand {
  * - `feat(cli): add command` → included
  */
 declare class GitMessageParser {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   /**
    * Parse a git commit line into a structured Commit object.
    *
@@ -1435,7 +1480,7 @@ interface ChangelogEntry {
  * - `alepha gen changelog | tee -a CHANGELOG.md` - Append to file
  */
 declare class ChangelogCommand {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly git: GitProvider;
   protected readonly parser: GitMessageParser;
   protected readonly config: Readonly<{
@@ -1463,30 +1508,30 @@ declare class ChangelogCommand {
    * Get the latest version tag.
    */
   protected getLatestTag(git: (cmd: string) => Promise<string>): Promise<string | null>;
-  readonly command: alepha_command0.CommandPrimitive<alepha.TObject<{
+  readonly command: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
     /**
      * Show changes from this ref (tag, commit, branch).
      * Defaults to the latest version tag.
      * Example: --from=1.0.0
      */
-    from: alepha.TOptional<alepha.TString>;
+    from: _$alepha.TOptional<_$alepha.TString>;
     /**
      * Show changes up to this ref (tag, commit, branch).
      * Defaults to HEAD.
      * Example: --to=main
      */
-    to: alepha.TOptional<alepha.TString>;
-  }>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+    to: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/gen/openapi.d.ts
 declare class OpenApiCommand {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly utils: AlephaCliUtils;
   protected readonly fs: FileSystemProvider;
-  readonly command: alepha_command0.CommandPrimitive<alepha.TObject<{
-    out: alepha.TOptional<alepha.TString>;
-  }>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly command: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    out: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/init.d.ts
@@ -1496,17 +1541,16 @@ declare class InitCommand {
    * Ensure the project has the necessary Alepha configuration files.
    * Add the correct dependencies to package.json and install them.
    */
-  readonly init: alepha_command0.CommandPrimitive<alepha.TObject<{
-    pm: alepha.TOptional<alepha.TUnsafe<"bun" | "yarn" | "npm" | "pnpm">>;
-    api: alepha.TOptional<alepha.TBoolean>;
-    react: alepha.TOptional<alepha.TBoolean>;
-    ui: alepha.TOptional<alepha.TBoolean>;
-    auth: alepha.TOptional<alepha.TBoolean>;
-    admin: alepha.TOptional<alepha.TBoolean>;
-    tailwind: alepha.TOptional<alepha.TBoolean>;
-    test: alepha.TOptional<alepha.TBoolean>;
-    force: alepha.TOptional<alepha.TBoolean>;
-  }>, alepha.TOptional<alepha.TString>, alepha.TObject<alepha.TProperties>>;
+  readonly init: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    pm: _$alepha.TOptional<_$alepha.TUnsafe<"bun" | "yarn" | "npm" | "pnpm">>;
+    api: _$alepha.TOptional<_$alepha.TBoolean>;
+    react: _$alepha.TOptional<_$alepha.TBoolean>;
+    ui: _$alepha.TOptional<_$alepha.TBoolean>;
+    saas: _$alepha.TOptional<_$alepha.TBoolean>;
+    tailwind: _$alepha.TOptional<_$alepha.TBoolean>;
+    test: _$alepha.TOptional<_$alepha.TBoolean>;
+    force: _$alepha.TOptional<_$alepha.TBoolean>;
+  }>, _$alepha.TOptional<_$alepha.TString>, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/lint.d.ts
@@ -1514,21 +1558,21 @@ declare class LintCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  readonly lint: alepha_command0.CommandPrimitive<alepha.TObject<alepha.TProperties>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly lint: _$alepha_command0.CommandPrimitive<_$alepha.TObject<_$alepha.TProperties>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/root.d.ts
 declare class RootCommand {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly cli: CliProvider;
   protected readonly alepha: Alepha;
   protected readonly color: ConsoleColorProvider;
   /**
    * Called when no command is provided
    */
-  readonly root: alepha_command0.CommandPrimitive<alepha.TObject<{
-    version: alepha.TOptional<alepha.TBoolean>;
-  }>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly root: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    version: _$alepha.TOptional<_$alepha.TBoolean>;
+  }>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/test.d.ts
@@ -1536,10 +1580,10 @@ declare class TestCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  readonly test: alepha_command0.CommandPrimitive<alepha.TObject<{
-    config: alepha.TOptional<alepha.TString>;
-  }>, alepha.TSchema, alepha.TObject<{
-    VITEST_ARGS: alepha.TOptional<alepha.TString>;
+  readonly test: _$alepha_command0.CommandPrimitive<_$alepha.TObject<{
+    config: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha.TSchema, _$alepha.TObject<{
+    VITEST_ARGS: _$alepha.TOptional<_$alepha.TString>;
   }>>;
 }
 //#endregion
@@ -1547,12 +1591,12 @@ declare class TestCommand {
 declare class TypecheckCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly scaffolder: ProjectScaffolder;
   /**
    * Run TypeScript type checking across the codebase with no emit.
    */
-  readonly typecheck: alepha_command0.CommandPrimitive<alepha.TObject<alepha.TProperties>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly typecheck: _$alepha_command0.CommandPrimitive<_$alepha.TObject<_$alepha.TProperties>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/verify.d.ts
@@ -1572,14 +1616,14 @@ declare class VerifyCommand {
    * - Build the project
    * - Clean the project again
    */
-  readonly verify: alepha_command0.CommandPrimitive<alepha.TObject<alepha.TProperties>, alepha.TSchema, alepha.TObject<alepha.TProperties>>;
+  readonly verify: _$alepha_command0.CommandPrimitive<_$alepha.TObject<_$alepha.TProperties>, _$alepha.TSchema, _$alepha.TObject<_$alepha.TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/providers/AlephaCliExtensionProvider.d.ts
 declare class AlephaCliExtensionProvider {
   protected readonly alepha: Alepha;
   protected readonly fs: FileSystemProvider;
-  protected readonly onConfigure: alepha.HookPrimitive<"configure">;
+  protected readonly onConfigure: _$alepha.HookPrimitive<"configure">;
 }
 //#endregion
 //#region ../../src/cli/core/version.d.ts
@@ -1590,11 +1634,11 @@ declare const version: any;
  * Services, providers, and build tasks — no commands.
  * Use this module when you need CLI utilities without registering commands.
  */
-declare const AlephaCliServices: alepha.Service<alepha.Module>;
+declare const AlephaCliServices: _$alepha.Service<_$alepha.Module>;
 /**
  * Full CLI module — all services and commands.
  */
-declare const AlephaCli: alepha.Service<alepha.Module>;
+declare const AlephaCli: _$alepha.Service<_$alepha.Module>;
 //#endregion
-export { AlephaCli, AlephaCliExtensionProvider, AlephaCliServices, AlephaCliUtils, AppEntry, AppEntryOptions, AppEntryProvider, BufferedLogger, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildOptions, BuildPrerenderTask, BuildRuntime, BuildServerTask, BuildSitemapTask, BuildStaticTask, BuildTarget, BuildTask, BuildTaskContext, BuildVercelTask, ChangelogCommand, type ChangelogOptions, CleanCommand, Commit, CompressOptions, DEFAULT_IGNORE, DbCommand, DependencyModes, DevCommand, DevOptions, DevServerOptions, GitMessageParser, GitProvider, InitCommand, LintCommand, OpenApiCommand, PackageManagerUtils, PreloadManifest, ProjectScaffolder, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, WorkspaceContext, appEntryOptions, buildOptions, changelogOptions, devOptions, version };
+export { AlephaCli, AlephaCliExtensionProvider, AlephaCliServices, AlephaCliUtils, AppEntry, AppEntryOptions, AppEntryProvider, BufferedLogger, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildOptions, BuildPrerenderTask, BuildRuntime, BuildServerTask, BuildSitemapTask, BuildStaticTask, BuildTarget, BuildTask, BuildTaskContext, BuildVercelTask, ChangelogCommand, type ChangelogOptions, CleanCommand, Commit, CompressOptions, DEFAULT_IGNORE, DbCommand, DependencyModes, DevCommand, DevOptions, DevServerOptions, GitMessageParser, GitProvider, InitCommand, LintCommand, OnAlephaLoadedHook, OpenApiCommand, PackageManagerUtils, PreloadManifest, ProjectScaffolder, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, WorkspaceContext, appEntryOptions, buildOptions, changelogOptions, devOptions, version };
 //# sourceMappingURL=index.d.ts.map