@apex-stack/core 0.1.9 → 0.1.10

package/dist/cli.js

@@ -418,11 +418,100 @@ var migrateCommand = defineCommand4({
 });
 
 // src/commands/new.ts
-import { spawnSync } from "child_process";
+import { spawn, 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 { fileURLToPath } from "url";
 import { defineCommand as defineCommand5 } from "citty";
+
+// src/ui.ts
+var TTY = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.TERM !== "dumb";
+var RESET = "\x1B[0m";
+function truecolor(r, g, b, s) {
+  return TTY ? `\x1B[38;2;${r};${g};${b}m${s}${RESET}` : s;
+}
+function style(code, s) {
+  return TTY ? `\x1B[${code}m${s}${RESET}` : s;
+}
+var color = {
+  cyan: (s) => truecolor(34, 211, 238, s),
+  indigo: (s) => truecolor(129, 140, 248, s),
+  green: (s) => truecolor(52, 211, 153, s),
+  red: (s) => truecolor(248, 113, 113, s),
+  gray: (s) => truecolor(154, 166, 196, s),
+  bold: (s) => style("1", s),
+  dim: (s) => style("2", s)
+};
+var LOGO = [
+  " \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D",
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557   \u255A\u2588\u2588\u2588\u2554\u255D ",
+  "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u255D   \u2588\u2588\u2554\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2554\u255D \u2588\u2588\u2557",
+  "\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D"
+];
+var FROM = [99, 102, 241];
+var TO = [34, 211, 238];
+function banner(subtitle = "The full-stack, AI-native meta-framework for Alpine.js") {
+  const width = LOGO[0].length;
+  const rows = LOGO.map((line) => {
+    if (!TTY) return `  ${line}`;
+    let out = "  ";
+    for (let i = 0; i < line.length; i++) {
+      const t = width > 1 ? i / (width - 1) : 0;
+      const r = Math.round(FROM[0] + (TO[0] - FROM[0]) * t);
+      const g = Math.round(FROM[1] + (TO[1] - FROM[1]) * t);
+      const b = Math.round(FROM[2] + (TO[2] - FROM[2]) * t);
+      out += `\x1B[38;2;${r};${g};${b}m${line[i]}`;
+    }
+    return out + RESET;
+  });
+  return `
+${rows.join("\n")}
+  ${color.gray(subtitle)}
+`;
+}
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function spinner(text) {
+  if (!TTY) {
+    process.stdout.write(`  ${text}
+`);
+    return {
+      succeed: (t) => console.log(`  ${color.green("\u2713")} ${t || text}`),
+      fail: (t) => console.log(`  ${color.red("\u2717")} ${t || text}`),
+      stop: () => {
+      }
+    };
+  }
+  let i = 0;
+  process.stdout.write("\x1B[?25l");
+  const id = setInterval(() => {
+    process.stdout.write(`\r\x1B[2K  ${color.cyan(FRAMES[i++ % FRAMES.length])} ${text}`);
+  }, 80);
+  const end = (symbol, t) => {
+    clearInterval(id);
+    process.stdout.write(`\r\x1B[2K  ${symbol} ${t || text}
+\x1B[?25h`);
+  };
+  return {
+    succeed: (t) => end(color.green("\u2713"), t),
+    fail: (t) => end(color.red("\u2717"), t),
+    stop: () => {
+      clearInterval(id);
+      process.stdout.write("\r\x1B[2K\x1B[?25h");
+    }
+  };
+}
+function ready(rows) {
+  const w = Math.max(...rows.map(([l]) => l.length));
+  console.log();
+  for (const [label, value] of rows) {
+    console.log(`  ${color.cyan("\u279C")}  ${color.bold(label.padEnd(w))}   ${color.cyan(value)}`);
+  }
+  console.log();
+}
+
+// src/commands/new.ts
 var TEMPLATE_DIR = fileURLToPath(new URL("../templates/default", import.meta.url));
 function detectPackageManager() {
   const ua = process.env.npm_config_user_agent || "";
@@ -431,21 +520,17 @@ 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({
   meta: { name: "new", description: "Scaffold a new Apex JS app" },
   args: {
@@ -453,12 +538,14 @@ var newCommand = defineCommand5({
     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 = resolve4(process.cwd(), dir);
     const name = basename(target);
+    process.stdout.write(banner());
+    const log = console.log;
     if (existsSync4(target) && readdirSync3(target).length > 0) {
-      console.error(`
-  \u2717 Target directory is not empty: ${target}
+      console.error(`  ${color.red("\u2717")} Target directory is not empty: ${target}
 `);
       process.exit(1);
     }
@@ -469,41 +556,34 @@ var newCommand = defineCommand5({
       const file = join6(target, rel);
       if (existsSync4(file)) writeFileSync3(file, readFileSync2(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.
+  ${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.")}
 `);
   }
 });
@@ -637,13 +717,30 @@ var dev = defineCommand7({
   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}
-`);
+    process.stdout.write(banner());
+    const sp = spinner(`Starting dev server${args.islands ? " (islands mode)" : ""}\u2026`);
+    try {
+      const { port: actual } = await startDevServer({ root, port, islands: args.islands });
+      sp.succeed("Dev server ready");
+      ready([
+        ["Local", `http://localhost:${actual}/`],
+        ["MCP", `http://localhost:${actual}/mcp`]
+      ]);
+    } catch (err) {
+      sp.fail("Failed to start the dev server");
+      throw err;
+    }
   }
 });
+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 = defineCommand7({
   meta: {
     name: "apex",
@@ -657,6 +754,21 @@ var main = defineCommand7({
     make: makeCommand,
     migrate: migrateCommand,
     mcp: 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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apex-stack/core",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "The full-stack meta-framework for Alpine.js — CLI and runtime",
   "type": "module",
   "license": "MIT",