create-react-on-rails-app 16.6.0-rc.0 → 16.6.0

package/lib/index.d.ts

@@ -1,2 +1,3 @@
-export {};
+import { Command } from 'commander';
+export declare const ready: Promise<Command>;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -3,15 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ready = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const validators_js_1 = require("./validators.js");
 const create_app_js_1 = require("./create-app.js");
 const utils_js_1 = require("./utils.js");
+const prompt_js_1 = require("./prompt.js");
 // Use require() for CJS compatibility - avoids __dirname + fs.readFileSync
 // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
 const packageJson = require('../package.json');
-function run(appName, rawOpts) {
+async function run(appName, rawOpts) {
     const { template } = rawOpts;
     if (typeof template !== 'string' || (template !== 'javascript' && template !== 'typescript')) {
         (0, utils_js_1.logError)(`Invalid template "${String(template)}". Must be "javascript" or "typescript".`);
@@ -27,13 +29,8 @@ function run(appName, rawOpts) {
     else {
         packageManager = (0, utils_js_1.detectPackageManager)() ?? 'npm';
     }
-    const options = {
-        template,
-        packageManager: packageManager,
-        rspack: Boolean(rawOpts.rspack),
-        pro: Boolean(rawOpts.pro),
-        rsc: Boolean(rawOpts.rsc),
-    };
+    let pro = Boolean(rawOpts.pro);
+    let rsc = Boolean(rawOpts.rsc);
     console.log('');
     console.log(`${chalk_1.default.bold('create-react-on-rails-app')} v${packageJson.version}`);
     console.log('');
@@ -42,6 +39,26 @@ function run(appName, rawOpts) {
         (0, utils_js_1.logError)(nameValidation.error ?? 'Invalid app name');
         process.exit(1);
     }
+    // When no mode flag is explicitly passed, prompt interactively (TTY only).
+    // Non-interactive environments (CI, pipes) fall back to standard mode.
+    const modeExplicit = rawOpts.pro !== undefined || rawOpts.rsc !== undefined || rawOpts.standard !== undefined;
+    if (!modeExplicit) {
+        if (process.stdin.isTTY && process.stdout.isTTY) {
+            const choice = await (0, prompt_js_1.promptForMode)();
+            pro = choice.pro;
+            rsc = choice.rsc;
+        }
+        else {
+            (0, utils_js_1.logInfo)('No mode flag specified and not running interactively (stdin/stdout is not a TTY); using standard mode.');
+        }
+    }
+    const options = {
+        template,
+        packageManager: packageManager,
+        rspack: Boolean(rawOpts.rspack),
+        pro,
+        rsc,
+    };
     if (options.rsc && options.pro) {
         (0, utils_js_1.logInfo)('Note: --rsc takes precedence over --pro; --pro will be ignored.');
     }
@@ -93,22 +110,28 @@ program
     .option('-t, --template <type>', 'javascript or typescript', 'typescript')
     .option('-p, --package-manager <pm>', 'npm or pnpm (auto-detected if not specified)')
     .option('--rspack', 'Use Rspack instead of Webpack (~20x faster builds)', false)
-    .option('--pro', 'Generate React on Rails Pro setup (installs react_on_rails_pro)', false)
-    .option('--rsc', 'Generate React Server Components setup (installs react_on_rails_pro)', false)
+    .option('--standard', 'Generate open-source React on Rails setup (skip prompt)')
+    .option('--pro', 'Generate React on Rails Pro setup (installs react_on_rails_pro)')
+    .option('--rsc', 'Generate React Server Components setup (installs react_on_rails_pro)')
     .addHelpText('after', `
 Examples:
-  $ npx create-react-on-rails-app my-app
+  $ npx create-react-on-rails-app my-app                        # prompts for mode
+  $ npx create-react-on-rails-app my-app --rsc                  # skip prompt, use RSC
+  $ npx create-react-on-rails-app my-app --pro                  # skip prompt, use Pro
+  $ npx create-react-on-rails-app my-app --standard             # skip prompt, use Standard
   $ npx create-react-on-rails-app my-app --template javascript
   $ npx create-react-on-rails-app my-app --rspack
-  $ npx create-react-on-rails-app my-app --pro
-  $ npx create-react-on-rails-app my-app --rsc
-  $ npx create-react-on-rails-app my-app --rspack --pro
   $ npx create-react-on-rails-app my-app --rspack --rsc
   $ npx create-react-on-rails-app my-app --package-manager pnpm
 
+When no mode flag (--standard, --pro, or --rsc) is given, an interactive prompt
+lets you choose between Standard, Pro, and RSC modes (default: RSC). When stdin
+or stdout is not a TTY (for example in CI, piped input, or redirected output),
+standard mode is used automatically.
+
 What it does:
   1. Creates a new Rails app with PostgreSQL
-  2. Adds required gem(s) (react_on_rails, plus react_on_rails_pro for --pro/--rsc)
+  2. Adds required gem(s) (react_on_rails, plus react_on_rails_pro for Pro/RSC)
   3. Runs the React on Rails generator (Shakapacker, components, webpack config)
   4. Creates educational git commits for each major scaffold step
 
@@ -125,14 +148,22 @@ The generated app includes one git commit per logical setup step.`)
 --pro and --rsc support both JavaScript and TypeScript templates.
 
 Documentation: https://reactonrails.com/docs/`)
-    .action((appName, opts) => {
+    .action(async (appName, opts) => {
     try {
-        run(appName, opts);
+        await run(appName, opts);
     }
     catch (error) {
+        if (error instanceof Error && error.message === prompt_js_1.PROMPT_CANCELLED) {
+            console.log('');
+            process.exit(0);
+        }
         (0, utils_js_1.logError)(error instanceof Error ? error.message : String(error));
         process.exit(1);
     }
 });
-program.parse();
+// eslint-disable-next-line import/prefer-default-export -- named export for test clarity
+exports.ready = program.parseAsync().catch((error) => {
+    (0, utils_js_1.logError)(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/lib/prompt.d.ts

@@ -0,0 +1,7 @@
+export interface ModeChoice {
+    pro: boolean;
+    rsc: boolean;
+}
+export declare const PROMPT_CANCELLED = "Prompt cancelled by user";
+export declare function promptForMode(): Promise<ModeChoice>;
+//# sourceMappingURL=prompt.d.ts.map

package/lib/prompt.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_CANCELLED = void 0;
+exports.promptForMode = promptForMode;
+const readline_1 = __importDefault(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+exports.PROMPT_CANCELLED = 'Prompt cancelled by user';
+const MODES = [
+    {
+        key: '1',
+        label: 'Standard',
+        desc: 'Open-source React on Rails with SSR',
+        pro: false,
+        rsc: false,
+    },
+    {
+        key: '2',
+        label: 'Pro',
+        desc: 'Adds Node.js server rendering (requires react_on_rails_pro)',
+        pro: true,
+        rsc: false,
+    },
+    {
+        key: '3',
+        label: 'RSC',
+        desc: 'React Server Components (requires react_on_rails_pro)',
+        pro: false,
+        rsc: true,
+    },
+];
+const DEFAULT_KEY = '3';
+function promptForMode() {
+    return new Promise((resolve, reject) => {
+        const rl = readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        let answered = false;
+        rl.on('SIGINT', () => {
+            answered = true;
+            rl.close();
+            reject(new Error(exports.PROMPT_CANCELLED));
+        });
+        rl.once('close', () => {
+            if (!answered) {
+                reject(new Error(exports.PROMPT_CANCELLED));
+            }
+        });
+        console.log(chalk_1.default.bold('Select a setup mode:\n'));
+        for (const mode of MODES) {
+            const recommended = mode.key === DEFAULT_KEY ? chalk_1.default.cyan(' (recommended)') : '';
+            console.log(`  ${mode.key}. ${chalk_1.default.bold(mode.label.padEnd(10))} ${mode.desc}${recommended}`);
+        }
+        console.log('');
+        rl.question(`Choice (1-3) [${DEFAULT_KEY}]: `, (answer) => {
+            answered = true;
+            rl.close();
+            const key = answer.trim() || DEFAULT_KEY;
+            const selected = MODES.find((m) => m.key === key);
+            if (!selected) {
+                console.log(chalk_1.default.yellow(`Invalid choice "${key}", defaulting to RSC.`));
+                resolve({ pro: false, rsc: true });
+                return;
+            }
+            resolve({ pro: selected.pro, rsc: selected.rsc });
+        });
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-react-on-rails-app",
-  "version": "16.6.0-rc.0",
+  "version": "16.6.0",
   "description": "Create React on Rails applications with a single command",
   "bin": {
     "create-react-on-rails-app": "./bin/create-react-on-rails-app.js"