@apex-stack/core 0.1.9 → 0.1.11

package/dist/cli.js

@@ -1,428 +1,19 @@
 #!/usr/bin/env node
 import {
-  createApiHandler,
-  createMcpHandler,
-  expandApiModule,
-  hasMcpRoutes,
-  loadComponents,
-  matchRoute,
-  renderIslandsPage,
-  renderPage,
-  scanPages,
-  startDevServer
-} from "./chunk-IEXQ7E5C.js";
+  banner,
+  color,
+  spinner
+} from "./chunk-2L2T47AH.js";
 
 // src/cli.ts
-import { resolve as resolve6 } from "path";
-import { defineCommand as defineCommand7, runMain } from "citty";
-
-// src/commands/build.ts
-import { cpSync, existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, rmSync, writeFileSync } from "fs";
-import { dirname, join as join3, resolve } from "path";
-import { apex as apex3 } from "@apex-stack/vite";
-import { defineCommand } from "citty";
-import { createServer as createViteServer } from "vite";
-
-// src/build/buildClient.ts
-import { readFileSync } from "fs";
-import { join } from "path";
-import { apex } from "@apex-stack/vite";
-import { build } from "vite";
-var VIRT = "virtual:apex-client:";
-function entryName(pageId) {
-  return pageId.replace(/^\/pages\//, "").replace(/\.alpine$/, "").replace(/[^a-zA-Z0-9]+/g, "_");
-}
-async function buildClient(root, routes, outDir) {
-  const input = {};
-  for (const r of routes) input[entryName(r.pageId)] = `${VIRT}${r.pageId}`;
-  const entryPlugin = {
-    name: "apex:client-entries",
-    resolveId(id) {
-      if (id.startsWith(VIRT)) return `\0${id}`;
-    },
-    load(id) {
-      if (id.startsWith(`\0${VIRT}`)) {
-        const pageId = id.slice(`\0${VIRT}`.length);
-        return [
-          `import Alpine from 'alpinejs'`,
-          `import ${JSON.stringify(pageId)}`,
-          `window.Alpine = Alpine`,
-          `Alpine.start()`
-        ].join("\n");
-      }
-    }
-  };
-  await build({
-    root,
-    logLevel: "warn",
-    plugins: [apex({ clientRuntime: "@apex-stack/core/client" }), entryPlugin],
-    build: {
-      outDir,
-      emptyOutDir: false,
-      manifest: true,
-      rollupOptions: { input }
-    }
-  });
-  const manifest = JSON.parse(readFileSync(join(outDir, ".vite", "manifest.json"), "utf8"));
-  const hrefs = /* @__PURE__ */ new Map();
-  for (const r of routes) {
-    const virt = `${VIRT}${r.pageId}`;
-    const entry = Object.values(manifest).find(
-      (m) => m.isEntry && (m.src === virt || m.src === `\0${virt}`)
-    );
-    if (entry) hrefs.set(r.pageId, `/${entry.file}`);
-  }
-  return hrefs;
-}
-
-// src/build/buildServer.ts
-import { existsSync, readdirSync } from "fs";
-import { isAbsolute, join as join2 } from "path";
-import { apex as apex2 } from "@apex-stack/vite";
-import { build as build2 } from "vite";
-async function buildServer(root, routes, outDir) {
-  const ids = routes.map((r) => r.pageId);
-  const compDir = join2(root, "components");
-  if (existsSync(compDir)) {
-    for (const f of readdirSync(compDir).filter((f2) => f2.endsWith(".alpine"))) {
-      ids.push(`/components/${f}`);
-    }
-  }
-  const apiDir = join2(root, "server", "api");
-  if (existsSync(apiDir)) {
-    for (const f of readdirSync(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
-      ids.push(`/server/api/${f}`);
-    }
-  }
-  const input = {};
-  for (const id of ids) input[entryName2(id)] = join2(root, id.slice(1));
-  const result = await build2({
-    root,
-    logLevel: "warn",
-    plugins: [apex2({ clientRuntime: "@apex-stack/core/client" })],
-    build: {
-      ssr: true,
-      target: "esnext",
-      // Node target — allow top-level await in server modules
-      outDir: join2(outDir, "server"),
-      emptyOutDir: false,
-      rollupOptions: {
-        input,
-        // Externalize every package import (bare specifier) — deps are resolved at
-        // runtime from node_modules. Only the app's own relative/absolute files are
-        // bundled. This keeps native/workspace deps (@libsql/client, drizzle, …) out.
-        external: (id) => !id.startsWith(".") && !isAbsolute(id),
-        output: { format: "esm", entryFileNames: "[name].mjs" }
-      }
-    }
-  });
-  const byFacade = /* @__PURE__ */ new Map();
-  for (const chunk of result.output) {
-    if (chunk.type === "chunk" && chunk.isEntry && chunk.facadeModuleId) {
-      byFacade.set(chunk.facadeModuleId, chunk.fileName);
-    }
-  }
-  const modules = {};
-  for (const id of ids) {
-    const abs = join2(root, id.slice(1));
-    const file = byFacade.get(abs);
-    if (file) modules[id] = file;
-  }
-  return { modules };
-}
-function entryName2(id) {
-  return id.replace(/^\//, "").replace(/\.(alpine|ts|js|mjs)$/, "").replace(/[^a-zA-Z0-9]+/g, "_");
-}
-
-// src/commands/build.ts
-function outFile(pattern) {
-  const clean = pattern.replace(/^\//, "");
-  return clean === "" ? "index.html" : `${clean}/index.html`;
-}
-var buildCommand = defineCommand({
-  meta: { name: "build", description: "Prerender pages to deployable HTML + client bundles" },
-  args: {
-    root: { type: "positional", required: false, description: "Project root", default: "." },
-    outDir: { type: "string", description: "Output directory", default: "dist" },
-    islands: { type: "boolean", description: "Static-first islands mode (zero-JS static)", default: false },
-    server: { type: "boolean", description: "Build a Node server (dynamic routes + API/MCP)", default: false }
-  },
-  async run({ args }) {
-    const root = resolve(process.cwd(), args.root);
-    const outDir = resolve(root, args.outDir);
-    rmSync(outDir, { recursive: true, force: true });
-    const routes = scanPages(root);
-    const staticRoutes = routes.filter((r) => !r.isDynamic);
-    const dynamic = routes.filter((r) => r.isDynamic);
-    if (args.server) {
-      return buildServerTarget(root, outDir, args.outDir, routes);
-    }
-    const hrefs = args.islands ? /* @__PURE__ */ new Map() : await buildClient(root, staticRoutes, outDir);
-    const vite = await createViteServer({
-      root,
-      appType: "custom",
-      server: { middlewareMode: true },
-      plugins: [apex3({ clientRuntime: "@apex-stack/core/client" })]
-    });
-    try {
-      const { registry, css: componentCss } = await loadComponents(
-        root,
-        (id) => vite.ssrLoadModule(id)
-      );
-      for (const route of staticRoutes) {
-        const common = {
-          loadModule: (id) => vite.ssrLoadModule(id),
-          pageId: route.pageId,
-          url: route.pattern,
-          registry,
-          componentCss
-        };
-        const html = args.islands ? await renderIslandsPage(common) : await renderPage({ ...common, clientHref: hrefs.get(route.pageId) });
-        const dest = join3(outDir, outFile(route.pattern));
-        mkdirSync(dirname(dest), { recursive: true });
-        writeFileSync(dest, html);
-        console.log(`  \u2713 ${route.pattern}  \u2192  ${outFile(route.pattern)}`);
-      }
-      const pub = join3(root, "public");
-      if (existsSync2(pub)) cpSync(pub, outDir, { recursive: true });
-      console.log(
-        `
-  Built ${staticRoutes.length} page(s) \u2192 ${args.outDir}/` + (args.islands ? " (islands / static-first)" : " (prerendered + hydrated)")
-      );
-      if (dynamic.length) {
-        console.log(
-          `  Skipped ${dynamic.length} dynamic route(s): ${dynamic.map((r) => r.pattern).join(", ")} (server target on the roadmap).`
-        );
-      }
-      console.log();
-    } finally {
-      await vite.close();
-    }
-  }
-});
-async function buildServerTarget(root, outDir, outLabel, routes) {
-  const clientHrefs = await buildClient(root, routes, outDir);
-  const server = await buildServer(root, routes, outDir);
-  const components = {};
-  const compDir = join3(root, "components");
-  if (existsSync2(compDir)) {
-    for (const f of readdirSync2(compDir).filter((f2) => f2.endsWith(".alpine"))) {
-      const sf = server.modules[`/components/${f}`];
-      if (sf) components[f.replace(/\.alpine$/, "")] = sf;
-    }
-  }
-  const api = [];
-  const apiDir = join3(root, "server", "api");
-  if (existsSync2(apiDir)) {
-    for (const f of readdirSync2(apiDir).filter((f2) => /\.(ts|js|mjs)$/.test(f2))) {
-      const sf = server.modules[`/server/api/${f}`];
-      if (sf) api.push({ name: f.replace(/\.(ts|js|mjs)$/, ""), serverFile: sf });
-    }
-  }
-  const manifest = {
-    islands: false,
-    routes: routes.map((r) => ({
-      ...r,
-      serverFile: server.modules[r.pageId],
-      clientHref: clientHrefs.get(r.pageId)
-    })),
-    components,
-    api
-  };
-  writeFileSync(join3(outDir, "apex-manifest.json"), JSON.stringify(manifest, null, 2));
-  const pub = join3(root, "public");
-  if (existsSync2(pub)) cpSync(pub, outDir, { recursive: true });
-  console.log(
-    `
-  Built server target \u2192 ${outLabel}/  (${routes.length} route(s), ${api.length} API module(s))
-  Run it:  apex start
-`
-  );
-}
-
-// src/commands/make.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, join as join4, resolve as resolve2 } from "path";
-import { defineCommand as defineCommand2 } from "citty";
-function pageTemplate(name) {
-  return `<script server lang="ts">
-  export function loader() {
-    return { title: '${name}' }
-  }
-</script>
-
-<template x-data>
-  <main>
-    <h1 x-text="title"></h1>
-  </main>
-</template>
-
-<style scoped>
-  main { max-width: 40rem; margin: 3rem auto; font-family: system-ui, sans-serif; }
-</style>
-`;
-}
-function componentTemplate() {
-  return `<template x-data="{ count: 0 }">
-  <button @click="count++" x-text="count"></button>
-</template>
-
-<style scoped>
-  button { cursor: pointer; }
-</style>
-`;
-}
-function apiTemplate(name) {
-  return `import { defineApexRoute } from '@apex-stack/core'
-import { z } from 'zod'
-
-// GET /api/${name}  \xB7  MCP tool "${name}"
-export default defineApexRoute({
-  method: 'GET',
-  description: 'Describe what ${name} does',
-  input: { name: z.string() },
-  mcp: true,
-  handler: ({ input }) => ({ message: \`Hello, \${input.name}!\` }),
-})
-`;
-}
-function plan(kind, name, root) {
-  switch (kind) {
-    case "page":
-      return { path: join4(root, "pages", `${name}.alpine`), contents: pageTemplate(name) };
-    case "component":
-      return { path: join4(root, "components", `${name}.alpine`), contents: componentTemplate() };
-    case "api":
-      return { path: join4(root, "server", "api", `${name}.ts`), contents: apiTemplate(name) };
-  }
-}
-var makeCommand = defineCommand2({
-  meta: { name: "make", description: "Generate a page, component, or API route" },
-  args: {
-    kind: { type: "positional", required: true, description: "page | component | api" },
-    name: { type: "positional", required: true, description: "Name (about, Counter, todos, \u2026)" },
-    root: { type: "string", description: "Project root", default: "." }
-  },
-  run({ args }) {
-    const kind = args.kind;
-    if (kind !== "page" && kind !== "component" && kind !== "api") {
-      console.error(`
-  Unknown type "${args.kind}". Use: page | component | api
-`);
-      process.exit(1);
-    }
-    const root = resolve2(process.cwd(), args.root);
-    const { path, contents } = plan(kind, args.name, root);
-    if (existsSync3(path)) {
-      console.error(`
-  \u2717 Already exists: ${path}
-`);
-      process.exit(1);
-    }
-    mkdirSync2(dirname2(path), { recursive: true });
-    writeFileSync2(path, contents);
-    console.log(`
-  \u2713 Created ${path.replace(`${root}/`, "")}
-`);
-  }
-});
-
-// src/commands/mcp.ts
-import { defineCommand as defineCommand3 } from "citty";
-var mcpCommand = defineCommand3({
-  meta: { name: "mcp", description: "Inspect the local MCP server (list or call tools)" },
-  args: {
-    url: { type: "string", description: "MCP endpoint URL", default: "http://localhost:3000/mcp" },
-    call: { type: "string", description: "Name of a tool to call" },
-    args: { type: "string", description: "JSON arguments for --call", default: "{}" }
-  },
-  async run({ args }) {
-    const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
-    const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
-    const client = new Client({ name: "apex-mcp-cli", version: "0.0.0" });
-    try {
-      await client.connect(new StreamableHTTPClientTransport(new URL(args.url)));
-    } catch (err) {
-      console.error(
-        `
-  Could not reach an MCP server at ${args.url}
-  Is \`apex dev\` running? ${err.message}
-`
-      );
-      process.exit(1);
-    }
-    if (args.call) {
-      const result = await client.callTool({
-        name: args.call,
-        arguments: JSON.parse(args.args)
-      });
-      console.log(`
-  \x1B[36m${args.call}\x1B[0m(${args.args}) \u2192`);
-      for (const part of result.content) {
-        console.log("  " + (part.text ?? JSON.stringify(part)));
-      }
-      console.log();
-    } else {
-      const { tools } = await client.listTools();
-      console.log(`
-  \x1B[36mMCP tools\x1B[0m at ${args.url} (${tools.length})
-`);
-      for (const t of tools) {
-        const props = t.inputSchema?.properties;
-        const sig = props ? Object.entries(props).map(([k, v]) => `${k}: ${v.type ?? "any"}`).join(", ") : "";
-        console.log(`  \u2022 \x1B[1m${t.name}\x1B[0m(${sig})`);
-        if (t.description) console.log(`    ${t.description}`);
-      }
-      console.log(`
-  Call one:  apex mcp --call <name> --args '{...}'
-`);
-    }
-    await client.close();
-  }
-});
-
-// src/commands/migrate.ts
-import { createRequire } from "module";
-import { join as join5, resolve as resolve3 } from "path";
-import { pathToFileURL } from "url";
-import { defineCommand as defineCommand4 } from "citty";
-var migrateCommand = defineCommand4({
-  meta: { name: "migrate", description: "Apply pending SQL migrations (db/migrations/*.sql)" },
-  args: {
-    db: { type: "string", description: "SQLite file path (libSQL)", default: "data.db" },
-    driver: { type: "string", description: "sqlite | postgres | pglite", default: "sqlite" },
-    url: { type: "string", description: "Connection URL (postgres) \u2014 overrides --db" },
-    dir: { type: "string", description: "Migrations directory", default: "db/migrations" },
-    root: { type: "string", description: "Project root", default: "." }
-  },
-  async run({ args }) {
-    const root = resolve3(process.cwd(), args.root);
-    let data;
-    try {
-      const require2 = createRequire(join5(root, "package.json"));
-      data = await import(pathToFileURL(require2.resolve("@apex-stack/data")).href);
-    } catch {
-      console.error("\n  @apex-stack/data is not installed in this project. Run: npm i @apex-stack/data\n");
-      process.exit(1);
-    }
-    const config = args.driver === "postgres" ? { driver: "postgres", url: args.url } : args.driver === "pglite" ? { driver: "pglite", dir: args.url } : resolve3(root, args.db);
-    const handle = await data.createDb(config);
-    const applied = await data.applyMigrations(handle, resolve3(root, args.dir));
-    await handle.close();
-    console.log(
-      applied.length ? `
-  \u2713 Applied ${applied.length} migration(s): ${applied.join(", ")}
-` : "\n  \u2713 Up to date \u2014 no pending migrations.\n"
-    );
-  }
-});
+import { defineCommand as defineCommand2, runMain } from "citty";
 
 // src/commands/new.ts
-import { spawnSync } from "child_process";
-import { cpSync as cpSync2, existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync3 } from "fs";
-import { basename, join as join6, resolve as resolve4 } from "path";
+import { spawn, spawnSync } from "child_process";
+import { cpSync, existsSync, readdirSync, readFileSync, renameSync, writeFileSync } from "fs";
+import { basename, join, resolve } from "path";
 import { fileURLToPath } from "url";
-import { defineCommand as defineCommand5 } from "citty";
+import { defineCommand } from "citty";
 var TEMPLATE_DIR = fileURLToPath(new URL("../templates/default", import.meta.url));
 function detectPackageManager() {
   const ua = process.env.npm_config_user_agent || "";
@@ -431,232 +22,112 @@ function detectPackageManager() {
   if (ua.startsWith("bun")) return "bun";
   return "npm";
 }
-function run(cmd, cmdArgs, cwd, quiet = false) {
-  const res = spawnSync(cmd, cmdArgs, {
-    cwd,
-    stdio: quiet ? "ignore" : "inherit",
-    shell: process.platform === "win32"
-    // npm/pnpm/yarn are .cmd shims on Windows
+function runSync(cmd, args, cwd) {
+  return spawnSync(cmd, args, { cwd, stdio: "ignore", shell: process.platform === "win32" }).status === 0;
+}
+function installAsync(pm, cwd) {
+  const args = pm === "npm" ? ["install", "--no-audit", "--no-fund"] : ["install"];
+  return new Promise((res) => {
+    const child = spawn(pm, args, { cwd, stdio: "ignore", shell: process.platform === "win32" });
+    child.on("close", (code) => res(code === 0));
+    child.on("error", () => res(false));
   });
-  return res.status === 0;
 }
-var c = {
-  cyan: (s) => `\x1B[36m${s}\x1B[0m`,
-  dim: (s) => `\x1B[2m${s}\x1B[0m`,
-  green: (s) => `\x1B[32m${s}\x1B[0m`,
-  yellow: (s) => `\x1B[33m${s}\x1B[0m`
-};
-var newCommand = defineCommand5({
+var newCommand = defineCommand({
   meta: { name: "new", description: "Scaffold a new Apex JS app" },
   args: {
     dir: { type: "positional", required: false, description: "Target directory", default: "apex-app" },
     install: { type: "boolean", default: true, description: "Install dependencies (use --no-install to skip)" },
     git: { type: "boolean", default: true, description: "Initialize a git repository (use --no-git to skip)" }
   },
-  run({ args }) {
-    const target = resolve4(process.cwd(), String(args.dir));
+  async run({ args }) {
+    const dir = String(args.dir);
+    const target = resolve(process.cwd(), dir);
     const name = basename(target);
-    if (existsSync4(target) && readdirSync3(target).length > 0) {
-      console.error(`
-  \u2717 Target directory is not empty: ${target}
+    process.stdout.write(banner());
+    const log = console.log;
+    if (existsSync(target) && readdirSync(target).length > 0) {
+      console.error(`  ${color.red("\u2717")} Target directory is not empty: ${target}
 `);
       process.exit(1);
     }
-    cpSync2(TEMPLATE_DIR, target, { recursive: true });
-    const gitignore = join6(target, "_gitignore");
-    if (existsSync4(gitignore)) renameSync(gitignore, join6(target, ".gitignore"));
+    cpSync(TEMPLATE_DIR, target, { recursive: true });
+    const gitignore = join(target, "_gitignore");
+    if (existsSync(gitignore)) renameSync(gitignore, join(target, ".gitignore"));
     for (const rel of ["package.json", "README.md"]) {
-      const file = join6(target, rel);
-      if (existsSync4(file)) writeFileSync3(file, readFileSync2(file, "utf8").replaceAll("{{name}}", name));
+      const file = join(target, rel);
+      if (existsSync(file)) writeFileSync(file, readFileSync(file, "utf8").replaceAll("{{name}}", name));
     }
-    const log = console.log;
-    log(`
-  ${c.cyan("Apex JS")} app created in ${args.dir}`);
+    log(`  ${color.green("\u2713")} Created ${color.bold(dir)}`);
     const pm = detectPackageManager();
     let gitOk = false;
     if (args.git) {
       const hasGit = spawnSync("git", ["--version"], { stdio: "ignore", shell: process.platform === "win32" }).status === 0;
-      if (hasGit && run("git", ["init", "-q"], target, true)) {
-        run("git", ["add", "-A"], target, true);
-        run("git", ["commit", "-m", "Initial commit from Apex JS", "--no-gpg-sign"], target, true);
+      if (hasGit && runSync("git", ["init", "-q"], target)) {
+        runSync("git", ["add", "-A"], target);
+        runSync("git", ["commit", "-m", "Initial commit from Apex JS", "--no-gpg-sign"], target);
         gitOk = true;
       }
     }
+    if (gitOk) log(`  ${color.green("\u2713")} Initialized a git repository`);
     let installed = false;
     if (args.install) {
-      log(`
-  Installing dependencies with ${c.cyan(pm)}\u2026 ${c.dim("(first install can take a minute)")}
-`);
-      const installArgs = pm === "npm" ? ["install", "--no-audit", "--no-fund"] : ["install"];
-      installed = run(pm, installArgs, target);
-      if (!installed) log(`
-  ${c.yellow("\u26A0")}  Dependency install failed \u2014 run it yourself after cd'ing in.
-`);
+      const sp = spinner(`Installing dependencies with ${pm}\u2026  ${color.dim("(first run can take a minute)")}`);
+      installed = await installAsync(pm, target);
+      if (installed) sp.succeed(`Dependencies installed with ${pm}`);
+      else sp.fail(`Install failed \u2014 run ${color.cyan(`${pm} install`)} inside ${dir}`);
     }
     const runPrefix = pm === "npm" ? "npm run" : pm;
-    const steps = [`cd ${args.dir}`];
-    if (!installed) steps.push(pm === "yarn" ? "yarn" : `${pm} install`);
-    steps.push(`apex dev          ${c.dim("# start the dev server \u2192 http://localhost:3000")}`);
     log(`
-  ${installed ? c.green("Ready.") : "Next steps:"}
-${steps.map((s) => `    ${s}`).join("\n")}
-
-  ${c.dim("Not global? Run")} ${c.cyan(runPrefix + " dev")}${c.dim(" instead of ")}${c.cyan("apex dev")}${c.dim(".")}
-  ${c.dim("Islands mode:")} apex dev --islands
-  ${gitOk ? c.dim("Git repository initialized. ") : ""}Your server/api/*.ts routes are also MCP tools at /mcp.
-`);
-  }
-});
-
-// src/commands/start.ts
-import { existsSync as existsSync6 } from "fs";
-import { join as join8, resolve as resolve5 } from "path";
-import { defineCommand as defineCommand6 } from "citty";
-
-// src/prod/server.ts
-import { createServer as createHttpServer } from "http";
-import { existsSync as existsSync5, readFileSync as readFileSync3, statSync } from "fs";
-import { join as join7 } from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
-import {
-  createApp,
-  defineEventHandler,
-  getRequestURL,
-  setResponseHeader,
-  setResponseStatus,
-  toNodeListener
-} from "h3";
-var MIME = {
-  ".js": "text/javascript",
-  ".mjs": "text/javascript",
-  ".css": "text/css",
-  ".html": "text/html",
-  ".json": "application/json",
-  ".svg": "image/svg+xml",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".ico": "image/x-icon",
-  ".woff2": "font/woff2"
-};
-async function startProdServer(options) {
-  const dir = options.dir;
-  const port = options.port ?? 3e3;
-  const manifest = JSON.parse(readFileSync3(join7(dir, "apex-manifest.json"), "utf8"));
-  const importServer = (relFile) => import(pathToFileURL2(join7(dir, "server", relFile)).href);
-  const registry = {};
-  let componentCss = "";
-  for (const [name, file] of Object.entries(manifest.components)) {
-    const mod = await importServer(file);
-    registry[name] = { template: mod.template, rootXData: mod.rootXData, scopeId: mod.scopeId };
-    if (mod.css) componentCss += `${mod.css}
-`;
-  }
-  const apiEntries = [];
-  for (const { name, serverFile } of manifest.api) {
-    const mod = await importServer(serverFile);
-    apiEntries.push(...expandApiModule(name, mod.default));
-  }
-  const serverFileFor = new Map(manifest.routes.map((r) => [r.pageId, r.serverFile]));
-  const loadModule = (id) => importServer(serverFileFor.get(id));
-  const app = createApp();
-  app.use(
-    defineEventHandler((event) => {
-      if (event.method !== "GET") return;
-      const path = decodeURIComponent(getRequestURL(event).pathname);
-      if (path === "/" || path.startsWith("/api") || path === "/mcp") return;
-      const file = join7(dir, path);
-      if (!file.startsWith(dir) || !existsSync5(file) || !statSync(file).isFile()) return;
-      const ext = path.slice(path.lastIndexOf("."));
-      setResponseHeader(event, "Content-Type", MIME[ext] ?? "application/octet-stream");
-      if (path.startsWith("/assets/")) setResponseHeader(event, "Cache-Control", "public, max-age=31536000, immutable");
-      return readFileSync3(file);
-    })
-  );
-  if (apiEntries.length) app.use("/api", createApiHandler(apiEntries));
-  if (hasMcpRoutes(apiEntries)) app.use("/mcp", createMcpHandler(apiEntries));
-  app.use(
-    defineEventHandler(async (event) => {
-      const url = getRequestURL(event).pathname;
-      const matched = matchRoute(manifest.routes, url);
-      if (!matched) {
-        setResponseStatus(event, 404);
-        setResponseHeader(event, "Content-Type", "text/html");
-        return `<!DOCTYPE html><h1>404 \u2014 ${url}</h1>`;
-      }
-      const route = manifest.routes.find((r) => r.pageId === matched.pageId);
-      const render = manifest.islands ? renderIslandsPage : renderPage;
-      const html = await render({
-        loadModule,
-        pageId: matched.pageId,
-        params: matched.params,
-        url,
-        registry,
-        componentCss,
-        clientHref: route?.clientHref
-      });
-      setResponseHeader(event, "Content-Type", "text/html");
-      return html;
-    })
-  );
-  const server = createHttpServer(toNodeListener(app));
-  await new Promise((resolve7) => server.listen(port, resolve7));
-  return { server, port };
-}
-
-// src/commands/start.ts
-var startCommand = defineCommand6({
-  meta: { name: "start", description: "Run a production build (from `apex build --server`)" },
-  args: {
-    dir: { type: "positional", required: false, description: "Build directory", default: "dist" },
-    port: { type: "string", description: "Port to listen on", default: "3000" }
-  },
-  async run({ args }) {
-    const dir = resolve5(process.cwd(), args.dir);
-    if (!existsSync6(join8(dir, "apex-manifest.json"))) {
-      console.error(`
-  No build found in ${args.dir}/. Run \`apex build --server\` first.
-`);
-      process.exit(1);
-    }
-    const { port } = await startProdServer({ dir, port: Number(args.port) });
-    console.log(`
-  \x1B[36mApex JS\x1B[0m production server
-  \u2192 http://localhost:${port}
+  ${color.bold("Next steps")}`);
+    log(`    ${color.cyan(`cd ${dir}`)}`);
+    if (!installed) log(`    ${color.cyan(pm === "yarn" ? "yarn" : `${pm} install`)}`);
+    log(`    ${color.cyan("apex dev")}          ${color.gray("# \u2192 http://localhost:3000")}`);
+    log(`
+  ${color.gray("Not installed globally? Use")} ${color.cyan(`${runPrefix} dev`)}${color.gray(".")}`);
+    log(`  ${color.gray("Islands mode:")} ${color.cyan("apex dev --islands")}${color.gray("  \xB7  API routes are also MCP tools at /mcp.")}
 `);
   }
 });
 
 // src/cli.ts
-var dev = defineCommand7({
-  meta: { name: "dev", description: "Start the Apex JS development server" },
-  args: {
-    root: { type: "positional", required: false, description: "Project root", default: "." },
-    port: { type: "string", description: "Port to listen on", default: "3000" },
-    islands: { type: "boolean", description: "Render in islands mode (static-first)", default: false }
-  },
-  async run({ args }) {
-    const root = resolve6(process.cwd(), args.root);
-    const port = Number(args.port);
-    const { port: actual } = await startDevServer({ root, port, islands: args.islands });
-    console.log(`
-  \x1B[36mApex JS\x1B[0m dev server ready
-  \u2192 http://localhost:${actual}
-`);
-  }
-});
-var main = defineCommand7({
+var COMMANDS = [
+  ["new", "Scaffold a new app"],
+  ["dev", "Start the dev server (SSR + hydrate, API + MCP)"],
+  ["build", "Build for production (static, islands, or server)"],
+  ["start", "Run a production server build"],
+  ["make", "Generate a page, component, or API route"],
+  ["migrate", "Apply pending database migrations"],
+  ["mcp", "Inspect the MCP server \u2014 list or call tools"]
+];
+var main = defineCommand2({
   meta: {
     name: "apex",
     description: "The full-stack meta-framework for Alpine.js"
   },
   subCommands: {
     new: newCommand,
-    dev,
-    build: buildCommand,
-    start: startCommand,
-    make: makeCommand,
-    migrate: migrateCommand,
-    mcp: mcpCommand
+    dev: () => import("./dev-HDRJEPPN.js").then((m) => m.devCommand),
+    build: () => import("./build-QRHQUUZC.js").then((m) => m.buildCommand),
+    start: () => import("./start-VJJXI4W3.js").then((m) => m.startCommand),
+    make: () => import("./make-4LINTKZH.js").then((m) => m.makeCommand),
+    migrate: () => import("./migrate-NOGFOFV2.js").then((m) => m.migrateCommand),
+    mcp: () => import("./mcp-DL4J6JFJ.js").then((m) => m.mcpCommand)
+  },
+  // Shown for a bare `apex` (no subcommand): the brand banner + a command menu.
+  run({ rawArgs }) {
+    if (rawArgs.length > 0) return;
+    process.stdout.write(banner());
+    const log = console.log;
+    log(`  ${color.bold("Usage")}  ${color.gray("apex")} ${color.cyan("<command>")} ${color.gray("[options]")}
+`);
+    log(`  ${color.bold("Commands")}`);
+    for (const [name, desc] of COMMANDS) {
+      log(`    ${color.cyan(`apex ${name}`.padEnd(13))} ${color.gray(desc)}`);
+    }
+    log(`
+  ${color.gray("Run")} ${color.cyan("apex <command> --help")} ${color.gray("for details.")}
+`);
   }
 });
 runMain(main);