create-nexora-next 0.3.7 → 0.4.7

package/src/utils/args.js

@@ -0,0 +1,119 @@
+const VALID_PMS = ['npm', 'pnpm', 'bun', 'yarn']
+
+const FLAGS = {
+  '--all':            { key: 'all' },
+  '--i18n':           { key: 'i18n' },
+  '--query':          { key: 'query' },
+  '--theming':        { key: 'theming' },
+  '--animations':     { key: 'animations' },
+  '--auth':           { key: 'auth' },
+  '--axios':          { key: 'axios' },
+  '--husky':          { key: 'husky' },
+  '--rc':             { key: 'reactCompiler' },
+  '--react-compiler': { key: 'reactCompiler' },
+  '--no-theming':     { key: 'theming',       value: false },
+  '--no-husky':       { key: 'husky',         value: false },
+  '--no-rc':          { key: 'reactCompiler', value: false },
+  '--pm':             { key: 'pm',            takesValue: true },
+  '-y':               { key: 'yes' },
+  '--yes':            { key: 'yes' },
+  '--help':           { key: 'help' },
+  '-h':               { key: 'help' },
+  '--version':        { key: 'version' },
+  '-v':               { key: 'version' },
+}
+
+export function parseArgs(argv) {
+  const args = argv.slice(2)
+  const result = {
+    name:          null,
+    pm:            null,
+    yes:           false,
+    help:          false,
+    version:       false,
+    all:           false,
+    i18n:          null,
+    query:         null,
+    theming:       null,
+    animations:    null,
+    auth:          null,
+    axios:         null,
+    husky:         null,
+    reactCompiler: null,
+  }
+
+  let i = 0
+  while (i < args.length) {
+    const arg = args[i]
+    const def = FLAGS[arg]
+
+    if (def) {
+      if (def.takesValue) {
+        result[def.key] = args[++i] ?? null
+      } else if (def.value === false) {
+        result[def.key] = false
+      } else {
+        result[def.key] = true
+      }
+    } else if (!arg.startsWith('-') && !result.name) {
+      result.name = arg
+    }
+    i++
+  }
+
+  if (result.all) {
+    for (const key of ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']) {
+      if (result[key] === null) result[key] = true
+    }
+  }
+
+  if (result.pm && !VALID_PMS.includes(result.pm)) {
+    result.pm = null
+  }
+
+  return result
+}
+
+export function hasAnyFlag(parsed) {
+  return (
+    parsed.yes ||
+    parsed.all ||
+    parsed.name !== null ||
+    parsed.pm !== null ||
+    ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']
+      .some(k => parsed[k] !== null)
+  )
+}
+
+export function printHelp(version) {
+  console.log(`
+  create-nexora-next v${version}
+
+  Usage:
+    npx create-nexora-next [name] [flags]
+
+  Flags:
+    --pm <npm|pnpm|bun|yarn>   Package manager (default: prompt)
+    --all                      Enable every feature
+    --i18n                     Localization via next-intl
+    --query                    TanStack Query + persistence
+    --theming                  Theming via next-themes
+    --animations               Motion + GSAP
+    --auth                     Auth proxy + validators
+    --axios                    Axios client/server instances
+    --husky                    Husky pre-commit hooks
+    --rc / --react-compiler    React Compiler
+    --no-theming               Skip theming
+    --no-husky                 Skip Husky
+    --no-rc                    Skip React Compiler
+    -y / --yes                 Accept all defaults (no prompts)
+    -v / --version             Print version
+    -h / --help                Show this help
+
+  Examples:
+    npx create-nexora-next my-app --pm pnpm --all
+    npx create-nexora-next my-app --pm bun --i18n --query --theming
+    npx create-nexora-next my-app --pm bun --all --no-animations --no-auth
+    npx create-nexora-next my-app -y
+`)
+}

package/src/utils/runner.js

@@ -1,50 +1,50 @@
-import { execSync } from 'child_process'
-
-/**
- * Run a shell command with live output, throwing on failure.
- * @param {string} cmd
- * @param {string} cwd
- */
-export function run(cmd, cwd) {
-  execSync(cmd, { cwd, stdio: 'inherit' })
-}
-
-/**
- * Run silently, capturing output. Returns stdout string.
- * @param {string} cmd
- * @param {string} cwd
- */
-export function runSilent(cmd, cwd) {
-  return execSync(cmd, { cwd, stdio: 'pipe' }).toString().trim()
-}
-
-/**
- * Returns the install command for the given package manager.
- * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
- * @param {string[]} deps
- * @param {boolean} dev
- */
-export function installCmd(pm, deps, dev = false) {
-  const flag = dev
-    ? pm === 'npm' ? '--save-dev' : '-D'
-    : ''
-  const pkgs = deps.join(' ')
-  switch (pm) {
-    case 'yarn': return `yarn add ${flag} ${pkgs}`.trim()
-    case 'pnpm': return `pnpm add ${flag} ${pkgs}`.trim()
-    case 'bun':  return `bun add ${flag} ${pkgs}`.trim()
-    default:     return `npm install ${flag} ${pkgs}`.trim()
-  }
-}
-
-/**
- * Returns the exec command (npx / pnpx / bunx).
- * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
- */
-export function execCmd(pm) {
-  switch (pm) {
-    case 'pnpm': return 'pnpx'
-    case 'bun':  return 'bunx'
-    default:     return 'npx'
-  }
+import { execSync } from 'child_process'
+
+/**
+ * Run a shell command with live output, throwing on failure.
+ * @param {string} cmd
+ * @param {string} cwd
+ */
+export function run(cmd, cwd) {
+  execSync(cmd, { cwd, stdio: 'inherit' })
+}
+
+/**
+ * Run silently, capturing output. Returns stdout string.
+ * @param {string} cmd
+ * @param {string} cwd
+ */
+export function runSilent(cmd, cwd) {
+  return execSync(cmd, { cwd, stdio: 'pipe' }).toString().trim()
+}
+
+/**
+ * Returns the install command for the given package manager.
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ * @param {string[]} deps
+ * @param {boolean} dev
+ */
+export function installCmd(pm, deps, dev = false) {
+  const flag = dev
+    ? pm === 'npm' ? '--save-dev' : '-D'
+    : ''
+  const pkgs = deps.join(' ')
+  switch (pm) {
+    case 'yarn': return `yarn add ${flag} ${pkgs}`.trim()
+    case 'pnpm': return `pnpm add ${flag} ${pkgs}`.trim()
+    case 'bun':  return `bun add ${flag} ${pkgs}`.trim()
+    default:     return `npm install ${flag} ${pkgs}`.trim()
+  }
+}
+
+/**
+ * Returns the exec command (npx / pnpx / bunx).
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ */
+export function execCmd(pm) {
+  switch (pm) {
+    case 'pnpm': return 'pnpx'
+    case 'bun':  return 'bunx'
+    default:     return 'npx'
+  }
 }

package/src/utils/safe-step.js

@@ -1,43 +1,43 @@
-import * as p from '@clack/prompts'
-import pc from 'picocolors'
-
-/**
- * Wraps a step function with automatic retry-on-failure UX.
- * If the step throws, shows the error, prompts "Fix it and press Enter to retry",
- * and loops until success or the user cancels.
- *
- * @param {string}   label   Human-readable step name (shown in spinner)
- * @param {()=>Promise<void>|void} fn  The step to execute
- */
-export async function safeStep(label, fn) {
-  while (true) {
-    const spinner = p.spinner()
-    spinner.start(label)
-    try {
-      await fn()
-      spinner.stop(pc.green(`✓ ${label}`))
-      return
-    } catch (err) {
-      spinner.stop(pc.red(`✗ ${label} failed`))
-
-      const message = err?.message || String(err)
-      p.log.error(pc.red(message))
-      p.log.warn(
-        pc.yellow(
-          `Fix the issue above, then press ${pc.bold('Enter')} to retry — or Ctrl+C to abort.`,
-        ),
-      )
-
-      const retry = await p.confirm({
-        message: 'Ready to retry?',
-        initialValue: true,
-      })
-
-      if (p.isCancel(retry) || !retry) {
-        p.cancel('Setup aborted.')
-        process.exit(1)
-      }
-      // loop again
-    }
-  }
+import * as p from '@clack/prompts'
+import pc from 'picocolors'
+
+/**
+ * Wraps a step function with automatic retry-on-failure UX.
+ * If the step throws, shows the error, prompts "Fix it and press Enter to retry",
+ * and loops until success or the user cancels.
+ *
+ * @param {string}   label   Human-readable step name (shown in spinner)
+ * @param {()=>Promise<void>|void} fn  The step to execute
+ */
+export async function safeStep(label, fn) {
+  while (true) {
+    const spinner = p.spinner()
+    spinner.start(label)
+    try {
+      await fn()
+      spinner.stop(pc.green(`✓ ${label}`))
+      return
+    } catch (err) {
+      spinner.stop(pc.red(`✗ ${label} failed`))
+
+      const message = err?.message || String(err)
+      p.log.error(pc.red(message))
+      p.log.warn(
+        pc.yellow(
+          `Fix the issue above, then press ${pc.bold('Enter')} to retry — or Ctrl+C to abort.`,
+        ),
+      )
+
+      const retry = await p.confirm({
+        message: 'Ready to retry?',
+        initialValue: true,
+      })
+
+      if (p.isCancel(retry) || !retry) {
+        p.cancel('Setup aborted.')
+        process.exit(1)
+      }
+      // loop again
+    }
+  }
 }

package/src/utils/writer.js

@@ -1,38 +1,38 @@
-import fs from 'fs'
-import path from 'path'
-
-/**
- * Write content to a file, creating parent directories as needed.
- * @param {string} filePath  Absolute path
- * @param {string} content
- */
-export function writeFile(filePath, content) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true })
-  fs.writeFileSync(filePath, content, 'utf8')
-}
-
-/**
- * Append content to an existing file.
- * @param {string} filePath  Absolute path
- * @param {string} content
- */
-export function appendFile(filePath, content) {
-  fs.appendFileSync(filePath, content, 'utf8')
-}
-
-/**
- * Create a directory (and all parents) if it doesn't exist.
- * @param {string} dirPath  Absolute path
- */
-export function mkdir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true })
-}
-
-/**
- * Check whether a path exists.
- * @param {string} p
- * @returns {boolean}
- */
-export function exists(p) {
-  return fs.existsSync(p)
+import fs from 'fs'
+import path from 'path'
+
+/**
+ * Write content to a file, creating parent directories as needed.
+ * @param {string} filePath  Absolute path
+ * @param {string} content
+ */
+export function writeFile(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true })
+  fs.writeFileSync(filePath, content, 'utf8')
+}
+
+/**
+ * Append content to an existing file.
+ * @param {string} filePath  Absolute path
+ * @param {string} content
+ */
+export function appendFile(filePath, content) {
+  fs.appendFileSync(filePath, content, 'utf8')
+}
+
+/**
+ * Create a directory (and all parents) if it doesn't exist.
+ * @param {string} dirPath  Absolute path
+ */
+export function mkdir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true })
+}
+
+/**
+ * Check whether a path exists.
+ * @param {string} p
+ * @returns {boolean}
+ */
+export function exists(p) {
+  return fs.existsSync(p)
 }