create-rsc-kit 0.6.0 → 0.7.0

package/dist/index.js

@@ -13,7 +13,18 @@ import { argv, exit, stdout } from 'node:process';
 import { DEFAULT_COMPILER, HELP, HOSTS, publishedCore, assertInsideCwd, assertUsableName, defaultCore, parseArgs, } from './options.js';
 import { Prompter, bold, cyan, dim } from './prompt.js';
 import * as t from './templates.js';
-const flags = parseArgs(argv.slice(2));
+// Same treatment as a refusal from write(): a bad flag is a decision this tool
+// made, and it happens before the try/catch below because the flags are what
+// everything else is built from.
+const flags = (() => {
+    try {
+        return parseArgs(argv.slice(2));
+    }
+    catch (error) {
+        stdout.write(`\n${bold('Cannot scaffold here.')}\n  ${error.message}\n\n`);
+        exit(1);
+    }
+})();
 if (flags.help) {
     stdout.write(HELP);
     exit(0);
@@ -81,7 +92,7 @@ async function collect() {
     const p = new Prompter();
     try {
         const dir = flags.dir ?? (await p.text('Directory', 'my-app'));
-        const host = await p.select('Server', HOSTS);
+        const host = await p.select('Where will it run', HOSTS);
         // Yes/no, not which: see DEFAULT_COMPILER.
         const compiler = flags.compiler ?? ((await p.confirm('React Compiler', true)) ? DEFAULT_COMPILER : 'none');
         const tailwind = flags.tailwind ?? (await p.confirm('Tailwind CSS', true));
@@ -165,6 +176,8 @@ function report(o) {
     const steps = [
         `cd ${relativeish(o.dir)}`,
         ...(o.install ? [] : [o.host === 'node' ? 'npm install' : 'bun install']),
+        // dev first: it is what someone wants next, and it needs no build.
+        `${pm} dev`,
         `${pm} build`,
         // A Worker has no start: wrangler runs it on workerd, or deploys it.
         ...(o.host === 'worker' ? [`${pm} preview`, `${pm} deploy`] : [`${pm} start`]),
@@ -172,7 +185,7 @@ function report(o) {
     stdout.write(`\n${bold('Done.')} ${dim(o.dir)}\n\n`);
     for (const step of steps)
         stdout.write(`  ${cyan(step)}\n`);
-    stdout.write(`\n${dim('The route tree is read at build time — rebuild after adding a page under src/app.')}\n\n`);
+    stdout.write(`\n${dim('Pages live in src/app. Where it deploys is the Nitro preset in vite.config.ts.')}\n\n`);
 }
 /** A path the user can paste, when it is under where they are. */
 function relativeish(dir) {

package/dist/options.d.ts

@@ -93,4 +93,4 @@ export declare function assertUsableName(name: string): void;
  * generator nobody can run without reading it first.
  */
 export declare function assertInsideCwd(dir: string, cwd: string): void;
-export declare const HELP = "\n  create-rsc-kit \u2014 scaffold an RSC app\n\n  Usage\n    create-rsc-kit <dir> [options]\n    bun create rsc-kit <dir> [options]   (once published)\n\n  Options\n    --host=bun|hono|elysia|node   which server to generate\n    --compiler=none|oxc|babel     React Compiler (prompt offers oxc; babel by flag)\n    --tailwind / --no-tailwind    include Tailwind\n    --lint / --no-lint            include oxlint\n    --source-dir <dir>            where app/ lives (default: src)\n    --init                        add to the project here, rather than scaffold\n    --core=<spec>                 engine dependency, e.g. file:../rsc-kit/packages/core\n    --no-install                  skip installing dependencies\n    --no-git                      skip git init\n    -y, --yes                     accept every default, ask nothing\n    -h, --help                    this\n";
+export declare const HELP = "\n  create-rsc-kit \u2014 scaffold an RSC app\n\n  Usage\n    create-rsc-kit <dir> [options]\n    bun create rsc-kit <dir> [options]   (once published)\n\n  Options\n    --host=bun|node|worker        where it runs \u2014 picks the Nitro preset\n    --compiler=none|oxc|babel     React Compiler (prompt offers oxc; babel by flag)\n    --tailwind / --no-tailwind    include Tailwind\n    --lint / --no-lint            include oxlint\n    --source-dir <dir>            where app/ lives (default: src)\n    --init                        add to the project here, rather than scaffold\n    --core=<spec>                 engine dependency, e.g. file:../rsc-kit/packages/core\n    --no-install                  skip installing dependencies\n    --no-git                      skip git init\n    -y, --yes                     accept every default, ask nothing\n    -h, --help                    this\n";

package/dist/options.js

@@ -12,8 +12,20 @@ import { fileURLToPath } from 'node:url';
 export const HOSTS = [
     { value: 'bun', label: 'Bun', hint: 'and compiles to a single binary' },
     { value: 'node', label: 'Node', hint: 'the default everywhere else' },
-    { value: 'worker', label: 'Cloudflare Workers', hint: 'no filesystem — assets from a binding' },
+    { value: 'worker', label: 'Cloudflare Workers', hint: 'deployed with wrangler, not started' },
 ];
+/**
+ * `--host` reaches `preset()`, which has a fallback branch — so an unknown
+ * value would not fail, it would quietly scaffold a Bun app. The names that
+ * used to be valid here (`hono`, `elysia`) are exactly the ones someone still
+ * has in a script, so being told is the point.
+ */
+function assertHost(value) {
+    if (value === 'laravel' || HOSTS.some((host) => host.value === value))
+        return value;
+    throw new Error(`Unknown --host=${value}. Pick one of: ${HOSTS.map((host) => host.value).join(', ')}. ` +
+        'Anywhere else is a Nitro preset in vite.config.ts, not a flag here.');
+}
 /**
  * Not asked as a three-way.
  *
@@ -117,7 +129,7 @@ export function parseArgs(argv) {
         else if (arg === '--no-tailwind')
             out.tailwind = false;
         else if (arg.startsWith('--host='))
-            out.host = arg.slice(7);
+            out.host = assertHost(arg.slice(7));
         else if (arg.startsWith('--compiler='))
             out.compiler = arg.slice(11);
         else if (arg.startsWith('--core='))
@@ -167,7 +179,7 @@ export const HELP = `
     bun create rsc-kit <dir> [options]   (once published)
 
   Options
-    --host=bun|hono|elysia|node   which server to generate
+    --host=bun|node|worker        where it runs — picks the Nitro preset
     --compiler=none|oxc|babel     React Compiler (prompt offers oxc; babel by flag)
     --tailwind / --no-tailwind    include Tailwind
     --lint / --no-lint            include oxlint

package/dist/templates.js

@@ -175,9 +175,11 @@ export function viteConfig(o) {
     // and rscKit tells plugin-rsc not to install a handler competing for that
     // role. serveStatic: 'inline' embeds the built assets, without which a
     // compiled binary serves pages and 404s every asset.
+    //
+    // Not optional, and not a flag on rscKit() either — the plugin builds for
+    // Nitro and nothing else, so a config without this line has no server.
     plugins.push(`nitro({ preset: ${JSON.stringify(preset(o.host))}, serveStatic: 'inline' })`);
     plugins.push(`rscKit({
-      nitro: true,
       ${options.join(',\n      ')},
     })`);
     plugins.push(o.compiler === 'oxc' ? 'react({ compiler: true })' : 'react()');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-rsc-kit",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Scaffold an RSC app on Bun, Hono, Elysia or Node.",
   "bin": {