create-apexjs 0.5.3 → 0.6.0

package/dist/index.js

@@ -4,9 +4,15 @@
 import { spawnSync } from "child_process";
 import { cpSync, existsSync, readdirSync, readFileSync, renameSync, writeFileSync } from "fs";
 import { basename, join, resolve } from "path";
+import { createInterface } from "readline";
 import { fileURLToPath } from "url";
 import { defineCommand, runMain } from "citty";
 var TEMPLATE_DIR = fileURLToPath(new URL("../templates/default", import.meta.url));
+var FEATURES = [
+  { key: "data", title: "Data & models" },
+  { key: "auth", title: "Auth" },
+  { key: "i18n", title: "i18n" }
+];
 function substituteName(dir, name) {
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
     const p = join(dir, entry.name);
@@ -28,11 +34,21 @@ function run(cmd, cmdArgs, cwd, quiet = false) {
   const res = spawnSync(cmd, cmdArgs, {
     cwd,
     stdio: quiet ? "ignore" : "inherit",
-    // On Windows, npm/pnpm/yarn are .cmd shims that need a shell.
+    // On Windows, npm/pnpm/yarn/npx are .cmd shims that need a shell.
     shell: process.platform === "win32"
   });
   return res.status === 0;
 }
+function promptYesNo(question, def = false) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((res) => {
+    rl.question(`${question} ${c.dim(def ? "(Y/n)" : "(y/N)")} `, (ans) => {
+      rl.close();
+      const a = ans.trim().toLowerCase();
+      res(a === "" ? def : a === "y" || a === "yes");
+    });
+  });
+}
 var c = {
   cyan: (s) => `\x1B[36m${s}\x1B[0m`,
   dim: (s) => `\x1B[2m${s}\x1B[0m`,
@@ -60,9 +76,21 @@ var main = defineCommand({
       type: "boolean",
       default: true,
       description: "Initialize a git repository (use --no-git to skip)"
+    },
+    data: {
+      type: "boolean",
+      description: "Include the data/models feature (skips the prompt)"
+    },
+    auth: {
+      type: "boolean",
+      description: "Include the auth feature (skips the prompt)"
+    },
+    i18n: {
+      type: "boolean",
+      description: "Include the i18n feature (skips the prompt)"
     }
   },
-  run({ args }) {
+  async run({ args }) {
     const target = resolve(process.cwd(), args.dir);
     const name = basename(target);
     if (existsSync(target) && readdirSync(target).length > 0) {
@@ -78,14 +106,24 @@ var main = defineCommand({
     console.log(`
   ${c.cyan("Apex JS")} app created in ${args.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);
-        gitOk = true;
+    const selected = [];
+    let headerShown = false;
+    for (const f of FEATURES) {
+      const flag = args[f.key];
+      let want = false;
+      if (flag !== void 0) {
+        want = flag;
+      } else if (process.stdin.isTTY) {
+        if (!headerShown) {
+          console.log(
+            `
+  ${c.cyan("Optional features")} ${c.dim("(add later anytime with 'apex extend <name>')")}`
+          );
+          headerShown = true;
+        }
+        want = await promptYesNo(`  Add ${f.title}?`, false);
       }
+      if (want) selected.push(f.key);
     }
     let installed = false;
     if (args.install) {
@@ -104,16 +142,52 @@ var main = defineCommand({
         );
       }
     }
+    const applied = [];
+    if (selected.length) {
+      if (installed) {
+        console.log(`
+  Adding features: ${c.cyan(selected.join(", "))}\u2026
+`);
+        for (const key of selected) {
+          if (run("npx", ["apex", "extend", key], target)) applied.push(key);
+          else
+            console.log(
+              `
+  ${c.yellow("\u26A0")}  Could not add ${key} \u2014 run ${c.cyan(`npx apex extend ${key}`)} yourself.
+`
+            );
+        }
+      } else {
+        console.log(
+          `
+  ${c.yellow("\u26A0")}  Features ${selected.join(", ")} need dependencies \u2014 after installing, run: ${c.cyan(
+            selected.map((k) => `apex extend ${k}`).join(" && ")
+          )}
+`
+        );
+      }
+    }
+    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);
+        gitOk = true;
+      }
+    }
     const runPrefix = pm === "npm" ? "npm run" : pm;
     const steps = [`cd ${args.dir}`];
     if (!installed) steps.push(pm === "yarn" ? "yarn" : `${pm} install`);
     steps.push(
       `${runPrefix} dev          ${c.dim("# start the dev server \u2192 http://localhost:3000")}`
     );
+    const featuresNote = applied.length ? `
+  ${c.green("Features added:")} ${c.cyan(applied.join(", "))} ${c.dim("(add more with 'apex extend <name>')")}` : "";
     console.log(`
   ${installed ? c.green("Ready.") : "Next steps:"}
 ${steps.map((s) => `    ${s}`).join("\n")}
-
+${featuresNote}
   ${c.yellow("Run the CLI with:")} ${c.cyan(`${runPrefix} dev`)}   ${c.dim("(or npx apex dev)")}
         A bare ${c.cyan("apex")} won't resolve \u2014 it's a local dependency, like ${c.cyan("next")} or ${c.cyan("vite")}.
         ${c.dim("Prefer a global command? ")}${c.cyan("npm i -g @apex-stack/core")}${c.dim(" \u2192 then `apex dev` works anywhere.")}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-apexjs",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Scaffold a new Apex JS app",
   "type": "module",
   "license": "MIT",

package/templates/default/AGENTS.md

@@ -11,7 +11,8 @@ an MCP tool**. This file tells you (the agent) how to work here effectively.
 2. **Everything has one place.** Follow the structure below; don't invent folders.
 3. **Security is the framework's job, not yours.** Use `auth`/`can`/`scope` — never
    hand-roll auth. Defaults are fail-closed.
-4. **Verify your work.** Add tests with `createTestApp` and run `apex test`.
+4. **Verify your work.** After changing code, run `apex check` (type gate) then
+   `apex test`. Add tests with `createTestApp`. Fix type errors before moving on.
 5. **TypeScript is strict.** If it compiles, it's probably right; lean on the types.
 
 ## Do things with the CLI (this is the fast path)
@@ -26,6 +27,7 @@ apex extend data                  # add a DB-backed model + /guestbook demo (Sup
 apex extend i18n                  # add locales/*.json + /fr routing
 apex add button card modal        # copy themeable UI components in
 apex migrate                      # apply DB migrations
+apex check                        # type-check (tsc --noEmit; fast with the native compiler)
 apex build --preset vercel        # build + Vercel config (also: netlify, docker); then deploy
 apex test                         # run Vitest
 ```
@@ -79,7 +81,8 @@ The full stability contract of public APIs is in the framework's `API.md` —
 
 ## Drive Apex as MCP tools (optional, powerful)
 Apex ships an MCP server for its own CLI — run `apex mcp-server` (stdio). Point your
-agent host at it to get `apex_make`, `apex_extend`, `apex_add`, `apex_build`, and
-`apex_list` as structured tools, so you scaffold by calling tools instead of shelling out.
+agent host at it to get `apex_make`, `apex_extend`, `apex_add`, `apex_build`, `apex_list`,
+`apex_project_info`, `apex_check`, and `apex_test` as structured tools, so you scaffold,
+type-check, and test by calling tools instead of shelling out.
 
 Docs: https://apexjs.site/docs/