@tanstack/cli 0.64.0 → 0.64.1

package/dist/cli.js

@@ -147,7 +147,7 @@ function getResolvedCreateTelemetryProperties(finalOptions, cliOptions) {
 function formatErrorMessage(error) {
     return error instanceof Error ? error.message : 'An unknown error occurred';
 }
-export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaultFramework, frameworkDefinitionInitializers, showDeploymentOptions = false, legacyAutoCreate = false, defaultRouterOnly = false, }) {
+export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaultFramework, frameworkDefinitionInitializers, showDeploymentOptions = true, legacyAutoCreate = false, defaultRouterOnly = false, }) {
     let currentTelemetry;
     const environment = createUIEnvironment(appName, false, () => currentTelemetry);
     const program = new Command();
@@ -459,38 +459,49 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
                     cliOptions.template.toLowerCase() !== 'file-router') {
                     cliOptions.routerOnly = true;
                 }
-                cliOptions.framework = getFrameworkByName(options.framework || defaultFramework || 'React').id;
+                if (options.framework) {
+                    cliOptions.framework = getFrameworkByName(options.framework).id;
+                }
+                else if (defaultFramework) {
+                    cliOptions.framework = getFrameworkByName(defaultFramework).id;
+                }
                 const nonInteractive = !!cliOptions.nonInteractive || !!cliOptions.yes;
                 if (cliOptions.interactive && nonInteractive) {
                     throw new Error('Cannot combine --interactive with --non-interactive/--yes.');
                 }
-                const addOnsFlagPassed = process.argv.includes('--add-ons');
+                const hasInteractiveTerminal = !!process.stdin.isTTY && !!process.stdout.isTTY && !process.env.CI;
                 const wantsInteractiveMode = !nonInteractive &&
-                    (cliOptions.interactive ||
-                        (cliOptions.addOns === true && addOnsFlagPassed));
+                    (cliOptions.interactive || hasInteractiveTerminal);
                 let finalOptions;
                 if (wantsInteractiveMode) {
-                    cliOptions.addOns = true;
+                    if (cliOptions.addOns === undefined) {
+                        cliOptions.addOns = true;
+                    }
                 }
                 else {
+                    if (!cliOptions.framework) {
+                        cliOptions.framework = getFrameworkByName(defaultFramework || 'React').id;
+                    }
                     finalOptions = await normalizeOptions(cliOptions, forcedAddOns, { forcedDeployment });
                 }
-                if (nonInteractive) {
-                    if (cliOptions.addOns === true) {
-                        throw new Error('When using --non-interactive/--yes, pass explicit add-ons via --add-ons <ids>.');
-                    }
+                if (!wantsInteractiveMode && cliOptions.addOns === true) {
+                    throw new Error('When running non-interactively, pass explicit add-ons via --add-ons <ids>.');
                 }
                 if (finalOptions) {
                     intro(`Creating a new ${appName} app in ${projectName}...`);
                 }
                 else {
-                    if (nonInteractive) {
+                    if (!wantsInteractiveMode) {
                         throw new Error('Project name is required in non-interactive mode. Pass [project-name] or --target-dir.');
                     }
                     intro(`Let's configure your ${appName} application`);
                     finalOptions = await promptForCreateOptions(cliOptions, {
                         forcedAddOns,
+                        forcedDeployment,
                         showDeploymentOptions,
+                        defaultFrameworkId: defaultFramework
+                            ? getFrameworkByName(defaultFramework)?.id
+                            : undefined,
                     });
                 }
                 if (!finalOptions) {
@@ -533,7 +544,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
                     throw new InvalidArgumentError(`Invalid framework: ${value}. Only the following are allowed: ${availableFrameworks.join(', ')}`);
                 }
                 return value;
-            }, defaultFramework || 'React');
+            });
         }
         cmd
             .option('--starter [url-or-id]', 'DEPRECATED: use --template. Initializes from a template URL or built-in id', false)

package/dist/options.js

@@ -1,11 +1,22 @@
 import { intro } from '@clack/prompts';
-import { finalizeAddOns, getFrameworkById, getPackageManager, loadStarter, populateAddOnOptionsDefaults, readConfigFile, } from '@tanstack/create';
-import { getProjectName, promptForAddOnOptions, promptForEnvVars, selectAddOns, selectDeployment, selectExamples, selectGit, selectPackageManager, selectTemplate, selectToolchain, } from './ui-prompts.js';
+import { finalizeAddOns, getFrameworkById, getFrameworks, getPackageManager, loadStarter, populateAddOnOptionsDefaults, readConfigFile, } from '@tanstack/create';
+import { getProjectName, promptForAddOnOptions, promptForEnvVars, selectAddOns, selectDeployment, selectExamples, selectFramework, selectGit, selectInstall, selectPackageManager, selectTemplate, selectToolchain, } from './ui-prompts.js';
 import { listTemplateChoices, resolveStarterSpecifier, } from './command-line.js';
 import { getCurrentDirectoryName, sanitizePackageName, validateProjectName, } from './utils.js';
-export async function promptForCreateOptions(cliOptions, { forcedAddOns = [], showDeploymentOptions = false, }) {
+export async function promptForCreateOptions(cliOptions, { forcedAddOns = [], forcedDeployment, showDeploymentOptions = true, defaultFrameworkId, }) {
     const options = {};
-    options.framework = getFrameworkById(cliOptions.framework || 'react');
+    if (cliOptions.framework) {
+        options.framework = getFrameworkById(cliOptions.framework);
+    }
+    else {
+        const availableFrameworks = getFrameworks();
+        if (defaultFrameworkId || availableFrameworks.length <= 1) {
+            options.framework = getFrameworkById(defaultFrameworkId || 'react');
+        }
+        else {
+            options.framework = await selectFramework(availableFrameworks, defaultFrameworkId);
+        }
+    }
     // Validate project name
     if (cliOptions.projectName) {
         // Handle "." as project name - use sanitized current directory name
@@ -71,11 +82,19 @@ export async function promptForCreateOptions(cliOptions, { forcedAddOns = [], sh
     // Toolchain selection
     const toolchain = await selectToolchain(options.framework, cliOptions.toolchain);
     // Deployment selection
-    const deployment = showDeploymentOptions
-        ? routerOnly
-            ? undefined
-            : await selectDeployment(options.framework, cliOptions.deployment)
-        : undefined;
+    let deployment;
+    if (routerOnly) {
+        deployment = undefined;
+    }
+    else if (cliOptions.deployment) {
+        deployment = cliOptions.deployment;
+    }
+    else if (showDeploymentOptions) {
+        deployment = await selectDeployment(options.framework, cliOptions.deployment, forcedDeployment);
+    }
+    else {
+        deployment = forcedDeployment;
+    }
     // Add-ons selection
     const addOns = new Set();
     // Examples/demo pages are enabled by default
@@ -139,9 +158,7 @@ export async function promptForCreateOptions(cliOptions, { forcedAddOns = [], sh
     options.envVarValues =
         envVarValues;
     options.git = cliOptions.git ?? (await selectGit());
-    if (cliOptions.install === false) {
-        options.install = false;
-    }
+    options.install = cliOptions.install ?? (await selectInstall());
     if (starter) {
         options.starter = starter;
     }

package/dist/types/options.d.ts

@@ -1,7 +1,9 @@
 import type { Options } from '@tanstack/create';
 import type { CliOptions } from './types.js';
-export declare function promptForCreateOptions(cliOptions: CliOptions, { forcedAddOns, showDeploymentOptions, }: {
+export declare function promptForCreateOptions(cliOptions: CliOptions, { forcedAddOns, forcedDeployment, showDeploymentOptions, defaultFrameworkId, }: {
     forcedAddOns?: Array<string>;
+    forcedDeployment?: string;
     showDeploymentOptions?: boolean;
+    defaultFrameworkId?: string;
 }): Promise<Required<Options> | undefined>;
 export declare function promptForAddOns(): Promise<Array<string>>;

package/dist/types/ui-prompts.d.ts

@@ -1,5 +1,7 @@
 import type { AddOn, PackageManager } from '@tanstack/create';
 import type { Framework } from '@tanstack/create/dist/types/types.js';
+export declare function selectFramework(frameworks: Array<Framework>, defaultFrameworkId?: string): Promise<Framework>;
+export declare function selectInstall(): Promise<boolean>;
 export declare function getProjectName(): Promise<string>;
 export declare function selectPackageManager(): Promise<PackageManager>;
 export declare function selectTemplate(templates: Array<{
@@ -13,4 +15,4 @@ export declare function selectExamples(): Promise<boolean>;
 export declare function selectToolchain(framework: Framework, toolchain?: string | false): Promise<string | undefined>;
 export declare function promptForAddOnOptions(addOnIds: Array<string>, framework: Framework): Promise<Record<string, Record<string, any>>>;
 export declare function promptForEnvVars(addOns: Array<AddOn>): Promise<Record<string, string>>;
-export declare function selectDeployment(framework: Framework, deployment?: string): Promise<string | undefined>;
+export declare function selectDeployment(framework: Framework, deployment?: string, forcedDeployment?: string): Promise<string | undefined>;

package/dist/ui-prompts.js

@@ -1,6 +1,36 @@
 import { cancel, confirm, isCancel, multiselect, note, password, select, text, } from '@clack/prompts';
 import { DEFAULT_PACKAGE_MANAGER, SUPPORTED_PACKAGE_MANAGERS, getAllAddOns, } from '@tanstack/create';
 import { validateProjectName } from './utils.js';
+export async function selectFramework(frameworks, defaultFrameworkId) {
+    const initialValue = (defaultFrameworkId &&
+        frameworks.find((f) => f.id.toLowerCase() === defaultFrameworkId.toLowerCase())?.id) ||
+        frameworks[0].id;
+    const selected = await select({
+        message: 'Select framework:',
+        options: frameworks.map((f) => ({ value: f.id, label: f.name })),
+        initialValue,
+    });
+    if (isCancel(selected)) {
+        cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    const framework = frameworks.find((f) => f.id === selected);
+    if (!framework) {
+        throw new Error(`Unknown framework: ${selected}`);
+    }
+    return framework;
+}
+export async function selectInstall() {
+    const install = await confirm({
+        message: 'Would you like to install dependencies now?',
+        initialValue: true,
+    });
+    if (isCancel(install)) {
+        cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    return install;
+}
 export async function getProjectName() {
     const value = await text({
         message: 'What would you like to name your project?',
@@ -249,7 +279,7 @@ export async function promptForEnvVars(addOns) {
     }
     return result;
 }
-export async function selectDeployment(framework, deployment) {
+export async function selectDeployment(framework, deployment, forcedDeployment) {
     const deployments = new Set();
     let initialValue = undefined;
     for (const addOn of framework
@@ -260,20 +290,27 @@ export async function selectDeployment(framework, deployment) {
             if (deployment && addOn.id === deployment) {
                 return deployment;
             }
-            if (addOn.default) {
+            if (forcedDeployment && addOn.id === forcedDeployment) {
+                initialValue = addOn.id;
+            }
+            else if (!initialValue && addOn.default) {
                 initialValue = addOn.id;
             }
         }
     }
+    if (deployments.size === 0) {
+        return undefined;
+    }
     const dp = await select({
-        message: 'Select deployment adapter',
+        message: 'Select deployment adapter:',
         options: [
+            { value: undefined, label: 'None' },
             ...Array.from(deployments).map((d) => ({
                 value: d.id,
                 label: d.name,
             })),
         ],
-        initialValue: initialValue,
+        initialValue,
     });
     if (isCancel(dp)) {
         cancel('Operation cancelled.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cli",
-  "version": "0.64.0",
+  "version": "0.64.1",
   "description": "TanStack CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -41,7 +41,7 @@
     "tempy": "^3.1.0",
     "validate-npm-package-name": "^7.0.0",
     "zod": "^3.24.2",
-    "@tanstack/create": "0.63.4"
+    "@tanstack/create": "0.63.5"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",