create-cascade 0.1.4 → 0.1.5

package/README.md

@@ -13,7 +13,7 @@ bun create cascade
 - Create in a new folder or directly in the current folder
 - Interactive framework selection (`core`, `react`, `solid`)
 - Multiple built-in starter code presets per framework
-- Optional direct install and immediate app start
+- Scaffold only by default (no install, no auto-run)
 
 ## Frameworks
 
@@ -48,8 +48,8 @@ Options:
   -f, --framework <name>  Framework: core, react, solid
   -s, --starter <name>    Starter preset for selected framework
   --here                  Use current directory
-  --no-install            Skip bun install
-  --no-start              Skip bun run dev after install
+  --install               Run bun install after scaffolding
+  --start                 Run bun install, then bun run dev
   -h, --help              Show help
 ```
 
@@ -65,14 +65,15 @@ bun create cascade --here
 # Create React app with counter starter
 bun create cascade my-app -f react -s counter
 
-# Scaffold only, no install
-bun create cascade my-app --no-install
+# Scaffold then install
+bun create cascade my-app --install
 ```
 
 ## Behavior
 
-- If installation is enabled, the CLI runs `bun install` in the target directory.
-- If installation is enabled and `--no-start` is not set, the CLI starts the app with `bun run dev`.
+- By default, the CLI only scaffolds files.
+- With `--install`, it runs `bun install` in the target directory.
+- With `--start`, it runs `bun install` then `bun run dev`.
 
 ## Package
 

package/index.js

@@ -5,6 +5,12 @@ import { basename, resolve } from "node:path"
 import process from "node:process"
 import { spawnSync } from "node:child_process"
 import { createInterface } from "node:readline/promises"
+import { emitKeypressEvents } from "node:readline"
+
+const ANSI_RESET = "\x1b[0m"
+const ANSI_BOLD = "\x1b[1m"
+const ANSI_DIM = "\x1b[2m"
+const ANSI_CYAN = "\x1b[36m"
 
 const FRAMEWORKS = [
   { id: "core", label: "Core", description: "Vanilla Cascade API with renderables" },
@@ -33,8 +39,8 @@ const STARTERS = {
 function parseArgs(argv) {
   const args = argv.slice(2)
   const options = {
-    noInstall: false,
-    noStart: false,
+    install: false,
+    start: false,
     here: false,
     framework: undefined,
     starter: undefined,
@@ -45,12 +51,21 @@ function parseArgs(argv) {
   for (let i = 0; i < args.length; i += 1) {
     const arg = args[i]
 
+    if (arg === "--install") {
+      options.install = true
+      continue
+    }
+    if (arg === "--start") {
+      options.start = true
+      options.install = true
+      continue
+    }
     if (arg === "--no-install") {
-      options.noInstall = true
+      options.install = false
       continue
     }
     if (arg === "--no-start") {
-      options.noStart = true
+      options.start = false
       continue
     }
     if (arg === "--here") {
@@ -84,8 +99,8 @@ function printHelp() {
   console.log("  -f, --framework <name>  Framework: core, react, solid")
   console.log("  -s, --starter <name>    Starter preset for selected framework")
   console.log("  --here                  Use current directory")
-  console.log("  --no-install            Skip bun install")
-  console.log("  --no-start              Skip bun run dev after install")
+  console.log("  --install               Run bun install after scaffolding")
+  console.log("  --start                 Run bun install, then bun run dev")
   console.log("  -h, --help              Show help")
   console.log("")
   console.log("Examples:")
@@ -118,47 +133,83 @@ function promptLine(rl, label) {
 }
 
 async function selectOption(rl, label, options) {
-  console.log("")
-  console.log(label)
-  for (let i = 0; i < options.length; i += 1) {
-    const option = options[i]
-    console.log(`  ${i + 1}. ${option.label} (${option.id}) - ${option.description}`)
+  if (!process.stdin.isTTY) {
+    return options[0].id
   }
 
-  while (true) {
-    const raw = (await promptLine(rl, "Select a number: ")).trim()
-    const index = Number(raw)
-    if (Number.isInteger(index) && index >= 1 && index <= options.length) {
-      return options[index - 1].id
+  const stdin = process.stdin
+  const stdout = process.stdout
+  let selectedIndex = 0
+  const totalLines = options.length + 2
+  let renderedOnce = false
+
+  const render = () => {
+    if (renderedOnce) {
+      stdout.write(`\x1b[${totalLines}F`)
+    } else {
+      stdout.write("\n")
     }
-    console.log("Invalid choice. Try again.")
-  }
-}
 
-async function resolveProjectName(rl, options, positionals) {
-  if (options.here) {
-    return "."
-  }
+    stdout.write(`${ANSI_BOLD}${label}${ANSI_RESET}\n`)
 
-  if (positionals[0]) {
-    return positionals[0]
-  }
+    for (let i = 0; i < options.length; i += 1) {
+      const option = options[i]
+      const isSelected = i === selectedIndex
+      const prefix = isSelected ? `${ANSI_BOLD}${ANSI_CYAN}>${ANSI_RESET}` : " "
+      const styleStart = isSelected ? `${ANSI_BOLD}${ANSI_CYAN}` : ""
+      const styleEnd = isSelected ? ANSI_RESET : ""
+      stdout.write(`${prefix} ${styleStart}${option.label}${styleEnd} ${ANSI_DIM}(${option.id}) - ${option.description}${ANSI_RESET}\n`)
+    }
 
-  if (!process.stdin.isTTY) {
-    return "cascade-app"
+    stdout.write(`${ANSI_DIM}Use Up/Down arrows and Enter${ANSI_RESET}\n`)
+    renderedOnce = true
   }
 
-  const locationChoice = await selectOption(rl, "Where should the project be created?", [
-    { id: "new", label: "New folder", description: "Create and use a new project directory" },
-    { id: "here", label: "Current folder", description: "Use the current directory directly" },
-  ])
+  return new Promise((resolve, reject) => {
+    const cleanup = () => {
+      stdin.off("keypress", onKeyPress)
+      if (stdin.isTTY) {
+        stdin.setRawMode(false)
+      }
+      stdout.write("\n")
+    }
 
-  if (locationChoice === "here") {
-    return "."
-  }
+    const onKeyPress = (_, key) => {
+      if (!key) {
+        return
+      }
+
+      if (key.ctrl && key.name === "c") {
+        cleanup()
+        reject(new Error("Operation cancelled"))
+        return
+      }
+
+      if (key.name === "up") {
+        selectedIndex = selectedIndex === 0 ? options.length - 1 : selectedIndex - 1
+        render()
+        return
+      }
+
+      if (key.name === "down") {
+        selectedIndex = selectedIndex === options.length - 1 ? 0 : selectedIndex + 1
+        render()
+        return
+      }
+
+      if (key.name === "return") {
+        const selected = options[selectedIndex]
+        cleanup()
+        resolve(selected.id)
+      }
+    }
 
-  const input = (await promptLine(rl, "Project name (default: cascade-app): ")).trim()
-  return input || "cascade-app"
+    emitKeypressEvents(stdin)
+    stdin.setRawMode(true)
+    stdin.resume()
+    stdin.on("keypress", onKeyPress)
+    render()
+  })
 }
 
 async function resolveFramework(rl, frameworkArg) {
@@ -196,6 +247,46 @@ async function resolveStarter(rl, framework, starterArg) {
   return selectOption(rl, `Choose a starter for ${framework}:`, choices)
 }
 
+async function resolveLocation(rl, options, positionals) {
+  if (options.here) {
+    return "here"
+  }
+
+  if (positionals[0]) {
+    return "new"
+  }
+
+  if (!process.stdin.isTTY) {
+    return "new"
+  }
+
+  return selectOption(rl, "Where should the project be created?", [
+    { id: "new", label: "New folder", description: "Create and use a new project directory" },
+    { id: "here", label: "Current folder", description: "Use the current directory directly" },
+  ])
+}
+
+async function resolveProjectName(rl, positionals, defaultName = "cascade-app") {
+  if (positionals[0]) {
+    return positionals[0]
+  }
+
+  if (!process.stdin.isTTY) {
+    return defaultName
+  }
+
+  const input = (await promptLine(rl, `Project name (default: ${defaultName}): `)).trim()
+  return input || defaultName
+}
+
+function shouldRunInteractiveWizard(options, positionals) {
+  if (!process.stdin.isTTY) {
+    return false
+  }
+
+  return !positionals[0] && !options.here && !options.framework && !options.starter
+}
+
 function getPackageJson(projectName, framework) {
   const dependencies = {
     "@cascadetui/core": "latest",
@@ -502,13 +593,27 @@ async function main() {
   })
 
   try {
-    const rawProjectName = await resolveProjectName(rl, options, positionals)
-    const framework = await resolveFramework(rl, options.framework)
-    const starter = await resolveStarter(rl, framework, options.starter)
+    let framework
+    let projectName
+    let location
+    let starter
+
+    if (shouldRunInteractiveWizard(options, positionals)) {
+      framework = await resolveFramework(rl, undefined)
+      projectName = await resolveProjectName(rl, [], "cascade-app")
+      location = await resolveLocation(rl, { ...options, here: false }, [])
+      starter = await resolveStarter(rl, framework, undefined)
+    } else {
+      framework = await resolveFramework(rl, options.framework)
+      location = await resolveLocation(rl, options, positionals)
+      const defaultName = location === "here" ? basename(process.cwd()) : "cascade-app"
+      projectName = await resolveProjectName(rl, positionals, defaultName)
+      starter = await resolveStarter(rl, framework, options.starter)
+    }
 
-    const usingCurrentDirectory = rawProjectName === "."
-    const targetDir = usingCurrentDirectory ? process.cwd() : resolve(process.cwd(), rawProjectName)
-    const packageNameSeed = usingCurrentDirectory ? basename(targetDir) : rawProjectName
+    const usingCurrentDirectory = location === "here"
+    const targetDir = usingCurrentDirectory ? process.cwd() : resolve(process.cwd(), projectName)
+    const packageNameSeed = projectName
 
     writeProject(targetDir, packageNameSeed, framework, starter)
 
@@ -517,13 +622,13 @@ async function main() {
     console.log(`Framework: ${framework}`)
     console.log(`Starter: ${starter}`)
 
-    if (!options.noInstall) {
+    if (options.install) {
       console.log("")
       console.log("Installing dependencies with bun...")
       runCommand("bun", ["install"], targetDir)
     }
 
-    if (!options.noInstall && !options.noStart) {
+    if (options.start) {
       console.log("")
       console.log("Starting the project...")
       runCommand("bun", ["run", "dev"], targetDir)
@@ -533,11 +638,9 @@ async function main() {
     console.log("")
     console.log("Next steps:")
     if (!usingCurrentDirectory) {
-      console.log(`  cd ${rawProjectName}`)
-    }
-    if (options.noInstall) {
-      console.log("  bun install")
+      console.log(`  cd ${projectName}`)
     }
+    console.log("  bun install")
     console.log("  bun run dev")
   } finally {
     rl.close()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-cascade",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Create a new Cascade TUI project",
   "type": "module",
   "license": "MIT",