@tanstack/cta-cli 0.15.12 → 0.16.1

package/dist/cli.js

@@ -1,8 +1,10 @@
+import fs from 'node:fs';
 import { resolve } from 'node:path';
 import { Command, InvalidArgumentError } from 'commander';
 import { intro, log } from '@clack/prompts';
 import chalk from 'chalk';
-import { SUPPORTED_PACKAGE_MANAGERS, addToApp, compileAddOn, compileStarter, createApp, createSerializedOptions, getAllAddOns, getFrameworkById, getFrameworkByName, getFrameworks, initAddOn, initStarter, } from '@tanstack/cta-engine';
+import semver from 'semver';
+import { SUPPORTED_PACKAGE_MANAGERS, addToApp, compileAddOn, compileStarter, createApp, createSerializedOptions, getAllAddOns, getFrameworkById, getFrameworks, initAddOn, initStarter, } from '@tanstack/cta-engine';
 import { launchUI } from '@tanstack/cta-ui';
 import { runMCPServer } from './mcp.js';
 import { promptForAddOns, promptForCreateOptions } from './options.js';
@@ -36,6 +38,66 @@ export function cli({ name, appName, forcedMode, forcedAddOns = [], defaultTempl
         defaultMode = Array.from(supportedModes)[0];
     }
     program.name(name).description(`CLI to create a new ${appName} application`);
+    program
+        .command('pin-versions')
+        .description('Pin versions of the TanStack libraries')
+        .action(async () => {
+        if (!fs.existsSync('package.json')) {
+            console.error('package.json not found');
+            return;
+        }
+        const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+        const packages = {
+            '@tanstack/react-router': '',
+            '@tanstack/router-generator': '',
+            '@tanstack/react-router-devtools': '',
+            '@tanstack/react-start': '',
+            '@tanstack/react-start-config': '',
+            '@tanstack/router-plugin': '',
+            '@tanstack/react-start-client': '',
+            '@tanstack/react-start-plugin': '1.115.0',
+            '@tanstack/react-start-server': '',
+            '@tanstack/start-server-core': '1.115.0',
+        };
+        function sortObject(obj) {
+            return Object.keys(obj)
+                .sort()
+                .reduce((acc, key) => {
+                acc[key] = obj[key];
+                return acc;
+            }, {});
+        }
+        if (!packageJson.dependencies['@tanstack/react-start']) {
+            console.error('@tanstack/react-start not found in dependencies');
+            return;
+        }
+        let changed = 0;
+        const startVersion = packageJson.dependencies['@tanstack/react-start'].replace(/^\^/, '');
+        for (const pkg of Object.keys(packages)) {
+            if (!packageJson.dependencies[pkg]) {
+                packageJson.dependencies[pkg] = packages[pkg].length
+                    ? semver.maxSatisfying([startVersion, packages[pkg]], `^${packages[pkg]}`)
+                    : startVersion;
+                changed++;
+            }
+            else {
+                if (packageJson.dependencies[pkg].startsWith('^')) {
+                    packageJson.dependencies[pkg] = packageJson.dependencies[pkg].replace(/^\^/, '');
+                    changed++;
+                }
+            }
+        }
+        packageJson.dependencies = sortObject(packageJson.dependencies);
+        if (changed > 0) {
+            fs.writeFileSync('package.json', JSON.stringify(packageJson, null, 2));
+            console.log(`${changed} packages updated.
+
+Remove your node_modules directory and package lock file and re-install.`);
+        }
+        else {
+            console.log('No changes needed. The relevant TanStack packages are already pinned.');
+        }
+    });
     program
         .command('add')
         .argument('[add-on...]', 'Name of the add-ons (or add-ons separated by spaces or commas)')
@@ -119,7 +181,7 @@ export function cli({ name, appName, forcedMode, forcedAddOns = [], defaultTempl
                 throw new InvalidArgumentError(`Invalid framework: ${value}. Only the following are allowed: ${availableFrameworks.join(', ')}`);
             }
             return value;
-        }, defaultFramework || 'React');
+        }, defaultFramework || 'react-cra');
     }
     program
         .option('--starter [url]', 'initialize this project from a starter URL', false)
@@ -155,6 +217,7 @@ export function cli({ name, appName, forcedMode, forcedAddOns = [], defaultTempl
         .option('--ui', 'Add with the UI');
     program.action(async (projectName, options) => {
         if (options.listAddOns) {
+            console.log(options.framework || defaultFramework || 'react-cra');
             const addOns = await getAllAddOns(getFrameworkById(options.framework || defaultFramework || 'react-cra'), defaultMode ||
                 convertTemplateToMode(options.template || defaultTemplate));
             for (const addOn of addOns.filter((a) => !forcedAddOns.includes(a.id))) {
@@ -174,7 +237,7 @@ export function cli({ name, appName, forcedMode, forcedAddOns = [], defaultTempl
                     projectName,
                     ...options,
                 };
-                cliOptions.framework = getFrameworkByName(options.framework || defaultFramework || 'React').id;
+                cliOptions.framework = getFrameworkById(options.framework || defaultFramework || 'react-cra').id;
                 if (defaultMode) {
                     cliOptions.template = defaultMode;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cta-cli",
-  "version": "0.15.12",
+  "version": "0.16.1",
   "description": "Tanstack Application Builder CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,14 +28,16 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "express": "^4.21.2",
+    "semver": "^7.7.2",
     "zod": "^3.24.2",
-    "@tanstack/cta-engine": "0.15.12",
-    "@tanstack/cta-ui": "0.15.12"
+    "@tanstack/cta-engine": "0.16.1",
+    "@tanstack/cta-ui": "0.16.1"
   },
   "devDependencies": {
     "@tanstack/config": "^0.16.2",
     "@types/express": "^5.0.1",
     "@types/node": "^22.13.4",
+    "@types/semver": "^7.7.0",
     "@vitest/coverage-v8": "3.1.1",
     "eslint": "^9.20.0",
     "typescript": "^5.6.3",

package/src/cli.ts

@@ -1,7 +1,9 @@
+import fs from 'node:fs'
 import { resolve } from 'node:path'
 import { Command, InvalidArgumentError } from 'commander'
 import { intro, log } from '@clack/prompts'
 import chalk from 'chalk'
+import semver from 'semver'
 
 import {
   SUPPORTED_PACKAGE_MANAGERS,
@@ -87,6 +89,79 @@ export function cli({
 
   program.name(name).description(`CLI to create a new ${appName} application`)
 
+  program
+    .command('pin-versions')
+    .description('Pin versions of the TanStack libraries')
+    .action(async () => {
+      if (!fs.existsSync('package.json')) {
+        console.error('package.json not found')
+        return
+      }
+      const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'))
+
+      const packages: Record<string, string> = {
+        '@tanstack/react-router': '',
+        '@tanstack/router-generator': '',
+        '@tanstack/react-router-devtools': '',
+        '@tanstack/react-start': '',
+        '@tanstack/react-start-config': '',
+        '@tanstack/router-plugin': '',
+        '@tanstack/react-start-client': '',
+        '@tanstack/react-start-plugin': '1.115.0',
+        '@tanstack/react-start-server': '',
+        '@tanstack/start-server-core': '1.115.0',
+      }
+
+      function sortObject(obj: Record<string, string>): Record<string, string> {
+        return Object.keys(obj)
+          .sort()
+          .reduce<Record<string, string>>((acc, key) => {
+            acc[key] = obj[key]
+            return acc
+          }, {})
+      }
+
+      if (!packageJson.dependencies['@tanstack/react-start']) {
+        console.error('@tanstack/react-start not found in dependencies')
+        return
+      }
+      let changed = 0
+      const startVersion = packageJson.dependencies[
+        '@tanstack/react-start'
+      ].replace(/^\^/, '')
+      for (const pkg of Object.keys(packages)) {
+        if (!packageJson.dependencies[pkg]) {
+          packageJson.dependencies[pkg] = packages[pkg].length
+            ? semver.maxSatisfying(
+                [startVersion, packages[pkg]],
+                `^${packages[pkg]}`,
+              )!
+            : startVersion
+          changed++
+        } else {
+          if (packageJson.dependencies[pkg].startsWith('^')) {
+            packageJson.dependencies[pkg] = packageJson.dependencies[
+              pkg
+            ].replace(/^\^/, '')
+            changed++
+          }
+        }
+      }
+      packageJson.dependencies = sortObject(packageJson.dependencies)
+      if (changed > 0) {
+        fs.writeFileSync('package.json', JSON.stringify(packageJson, null, 2))
+        console.log(
+          `${changed} packages updated.
+
+Remove your node_modules directory and package lock file and re-install.`,
+        )
+      } else {
+        console.log(
+          'No changes needed. The relevant TanStack packages are already pinned.',
+        )
+      }
+    })
+
   program
     .command('add')
     .argument(
@@ -191,7 +266,7 @@ export function cli({
         }
         return value
       },
-      defaultFramework || 'React',
+      defaultFramework || 'react-cra',
     )
   }
 
@@ -259,6 +334,7 @@ export function cli({
 
   program.action(async (projectName: string, options: CliOptions) => {
     if (options.listAddOns) {
+      console.log(options.framework || defaultFramework || 'react-cra')
       const addOns = await getAllAddOns(
         getFrameworkById(options.framework || defaultFramework || 'react-cra')!,
         defaultMode ||
@@ -280,8 +356,8 @@ export function cli({
           ...options,
         } as CliOptions
 
-        cliOptions.framework = getFrameworkByName(
-          options.framework || defaultFramework || 'React',
+        cliOptions.framework = getFrameworkById(
+          options.framework || defaultFramework || 'react-cra',
         )!.id
 
         if (defaultMode) {