@tanstack/cta-engine 0.10.0-alpha.6 → 0.11.0

package/src/mcp.ts

@@ -8,10 +8,7 @@ import { createApp } from './create-app.js'
 import { finalizeAddOns } from './add-ons.js'
 import { createDefaultEnvironment } from './environment.js'
 
-const server = new McpServer({
-  name: 'Demo',
-  version: '1.0.0',
-})
+import type { TemplateOptions } from './types.js'
 
 const tanStackReactAddOns = [
   {
@@ -57,78 +54,6 @@ const tanStackReactAddOns = [
   },
 ]
 
-server.tool('listTanStackReactAddOns', {}, () => {
-  return {
-    content: [{ type: 'text', text: JSON.stringify(tanStackReactAddOns) }],
-  }
-})
-
-server.tool(
-  'createTanStackReactApplication',
-  {
-    projectName: z
-      .string()
-      .describe(
-        'The package.json module name of the application (will also be the directory name)',
-      ),
-    cwd: z.string().describe('The directory to create the application in'),
-    addOns: z
-      .array(
-        z.enum([
-          'clerk',
-          'convex',
-          'form',
-          'netlify',
-          'sentry',
-          'shadcn',
-          'start',
-          'store',
-          'tanstack-query',
-          'tanchat',
-        ]),
-      )
-      .describe('The IDs of the add-ons to install'),
-  },
-  async ({ projectName, addOns, cwd }) => {
-    try {
-      process.chdir(cwd)
-      const chosenAddOns = await finalizeAddOns(
-        'react',
-        'file-router',
-        addOns as unknown as Array<string>,
-      )
-      await createApp(
-        {
-          projectName: projectName.replace(/^\//, './'),
-          framework: 'react',
-          typescript: true,
-          tailwind: true,
-          packageManager: 'pnpm',
-          toolchain: 'none',
-          mode: 'file-router',
-          addOns: true,
-          chosenAddOns,
-          git: true,
-          variableValues: {},
-        },
-        {
-          silent: true,
-          environment: createDefaultEnvironment(),
-        },
-      )
-      return {
-        content: [{ type: 'text', text: 'Application created successfully' }],
-      }
-    } catch (error) {
-      return {
-        content: [
-          { type: 'text', text: `Error creating application: ${error}` },
-        ],
-      }
-    }
-  },
-)
-
 const tanStackSolidAddOns = [
   {
     id: 'solid-ui',
@@ -146,6 +71,11 @@ const tanStackSolidAddOns = [
     id: 'store',
     description: 'Enable the TanStack Store state management library',
   },
+  {
+    id: 'start',
+    description:
+      'Set this if you want a TanStack Start application that supports server functions or APIs',
+  },
   {
     id: 'tanstack-query',
     description: 'Enable TanStack Query for data fetching',
@@ -156,80 +86,200 @@ const tanStackSolidAddOns = [
   },
 ]
 
-server.tool('listTanStackSolidAddOns', {}, () => {
-  return {
-    content: [{ type: 'text', text: JSON.stringify(tanStackSolidAddOns) }],
-  }
-})
+function createServer({
+  appName,
+  forcedAddOns = [],
+  name,
+}: {
+  appName?: string
+  forcedAddOns?: Array<string>
+  name?: string
+}) {
+  const server = new McpServer({
+    name: `${appName} Application Builder`,
+    version: '1.0.0',
+  })
 
-server.tool(
-  'createTanStackSolidApplication',
-  {
-    projectName: z
-      .string()
-      .describe(
-        'The package.json module name of the application (will also be the directory name)',
-      ),
-    cwd: z.string().describe('The directory to create the application in'),
-    addOns: z
-      .array(
-        z.enum([
-          'solid-ui',
-          'form',
-          'sentry',
-          'store',
-          'tanstack-query',
-          'tanchat',
-        ]),
-      )
-      .describe('The IDs of the add-ons to install'),
-  },
-  async ({ projectName, addOns, cwd }) => {
-    try {
-      process.chdir(cwd)
-      const chosenAddOns = await finalizeAddOns(
-        'solid',
-        'file-router',
-        addOns as unknown as Array<string>,
-      )
-      await createApp(
-        {
-          projectName: projectName.replace(/^\//, './'),
-          framework: 'solid',
-          typescript: true,
-          tailwind: true,
-          packageManager: 'pnpm',
-          toolchain: 'none',
-          mode: 'file-router',
-          addOns: true,
-          chosenAddOns,
-          git: true,
-          variableValues: {},
-        },
-        {
-          silent: true,
-          environment: createDefaultEnvironment(),
-        },
-      )
-      return {
-        content: [{ type: 'text', text: 'Application created successfully' }],
-      }
-    } catch (error) {
-      return {
-        content: [
-          { type: 'text', text: `Error creating application: ${error}` },
-        ],
+  server.tool('listTanStackReactAddOns', {}, () => {
+    return {
+      content: [{ type: 'text', text: JSON.stringify(tanStackReactAddOns) }],
+    }
+  })
+
+  server.tool(
+    'createTanStackReactApplication',
+    {
+      projectName: z
+        .string()
+        .describe(
+          'The package.json module name of the application (will also be the directory name)',
+        ),
+      cwd: z.string().describe('The directory to create the application in'),
+      addOns: z
+        .array(
+          z.enum([
+            'clerk',
+            'convex',
+            'form',
+            'netlify',
+            'sentry',
+            'shadcn',
+            'start',
+            'store',
+            'tanstack-query',
+            'tanchat',
+          ]),
+        )
+        .describe('The IDs of the add-ons to install'),
+      targetDir: z
+        .string()
+        .describe(
+          'The directory to create the application in. Use the absolute path of the directory you want the application to be created in',
+        ),
+    },
+    async ({ projectName, addOns, cwd, targetDir }) => {
+      try {
+        process.chdir(cwd)
+        const chosenAddOns = await finalizeAddOns(
+          'react',
+          'file-router',
+          Array.from(
+            new Set([...(addOns as unknown as Array<string>), ...forcedAddOns]),
+          ),
+        )
+        await createApp(
+          {
+            projectName: projectName.replace(/^\//, './'),
+            framework: 'react',
+            typescript: true,
+            tailwind: true,
+            packageManager: 'pnpm',
+            toolchain: 'none',
+            mode: 'file-router',
+            addOns: true,
+            chosenAddOns,
+            git: true,
+            variableValues: {},
+          },
+          {
+            silent: true,
+            environment: createDefaultEnvironment(),
+            name,
+            cwd: targetDir,
+          },
+        )
+        return {
+          content: [{ type: 'text', text: 'Application created successfully' }],
+        }
+      } catch (error) {
+        return {
+          content: [
+            { type: 'text', text: `Error creating application: ${error}` },
+          ],
+        }
       }
+    },
+  )
+
+  server.tool('listTanStackSolidAddOns', {}, () => {
+    return {
+      content: [{ type: 'text', text: JSON.stringify(tanStackSolidAddOns) }],
     }
+  })
+
+  server.tool(
+    'createTanStackSolidApplication',
+    {
+      projectName: z
+        .string()
+        .describe(
+          'The package.json module name of the application (will also be the directory name)',
+        ),
+      cwd: z.string().describe('The directory to create the application in'),
+      addOns: z
+        .array(
+          z.enum([
+            'solid-ui',
+            'form',
+            'sentry',
+            'store',
+            'tanstack-query',
+            'tanchat',
+          ]),
+        )
+        .describe('The IDs of the add-ons to install'),
+      targetDir: z
+        .string()
+        .describe(
+          'The directory to create the application in. Use the absolute path of the directory you want the application to be created in',
+        ),
+    },
+    async ({ projectName, addOns, cwd, targetDir }) => {
+      try {
+        process.chdir(cwd)
+        const chosenAddOns = await finalizeAddOns(
+          'solid',
+          'file-router',
+          Array.from(
+            new Set([...(addOns as unknown as Array<string>), ...forcedAddOns]),
+          ),
+        )
+        await createApp(
+          {
+            projectName: projectName.replace(/^\//, './'),
+            framework: 'solid',
+            typescript: true,
+            tailwind: true,
+            packageManager: 'pnpm',
+            toolchain: 'none',
+            mode: 'file-router',
+            addOns: true,
+            chosenAddOns,
+            git: true,
+            variableValues: {},
+          },
+          {
+            silent: true,
+            environment: createDefaultEnvironment(),
+            name,
+            cwd: targetDir,
+          },
+        )
+        return {
+          content: [{ type: 'text', text: 'Application created successfully' }],
+        }
+      } catch (error) {
+        return {
+          content: [
+            { type: 'text', text: `Error creating application: ${error}` },
+          ],
+        }
+      }
+    },
+  )
+
+  return server
+}
+
+export default async function runServer(
+  sse: boolean,
+  {
+    forcedAddOns,
+    appName,
+    name,
+  }: {
+    forcedMode?: TemplateOptions
+    forcedAddOns?: Array<string>
+    appName?: string
+    name?: string
   },
-)
+) {
+  let transport: SSEServerTransport | null = null
 
-export default async function runServer(sse: boolean) {
+  const server = createServer({ appName, forcedAddOns, name })
   if (sse) {
     const app = express()
 
-    let transport: SSEServerTransport | null = null
-
     app.get('/sse', (req, res) => {
       transport = new SSEServerTransport('/messages', res)
       server.connect(transport)

package/src/options.ts

@@ -21,6 +21,7 @@ import type { AddOn, CliOptions, Options, Overlay, Variable } from './types.js'
 // If all CLI options are provided, use them directly
 export async function normalizeOptions(
   cliOptions: CliOptions,
+  forcedAddOns?: Array<string>,
 ): Promise<Options | undefined> {
   // in some cases, if you use windows/powershell, the argument for addons
   // if sepparated by comma is not really passed as an array, but as a string
@@ -31,6 +32,7 @@ export async function normalizeOptions(
       cliOptions.addOns = parseSeparatedArgs
     }
   }
+
   if (cliOptions.projectName) {
     let typescript =
       cliOptions.template === 'typescript' ||
@@ -58,11 +60,23 @@ export async function normalizeOptions(
 
     let addOns = false
     let chosenAddOns: Array<AddOn> = []
-    if (Array.isArray(cliOptions.addOns) || overlay?.dependsOn) {
+    if (
+      Array.isArray(cliOptions.addOns) ||
+      overlay?.dependsOn ||
+      forcedAddOns
+    ) {
       addOns = true
-      let finalAddOns = [...(overlay?.dependsOn || [])]
+      let finalAddOns = Array.from(
+        new Set([...(overlay?.dependsOn || []), ...(forcedAddOns || [])]),
+      )
       if (cliOptions.addOns && Array.isArray(cliOptions.addOns)) {
-        finalAddOns = [...finalAddOns, ...cliOptions.addOns]
+        finalAddOns = Array.from(
+          new Set([
+            ...(forcedAddOns || []),
+            ...finalAddOns,
+            ...cliOptions.addOns,
+          ]),
+        )
       }
       chosenAddOns = await finalizeAddOns(
         cliOptions.framework || DEFAULT_FRAMEWORK,
@@ -135,6 +149,13 @@ async function collectVariables(
 
 export async function promptForOptions(
   cliOptions: CliOptions,
+  {
+    forcedAddOns = [],
+    forcedMode,
+  }: {
+    forcedAddOns?: Array<string>
+    forcedMode?: 'typescript' | 'javascript' | 'file-router'
+  },
 ): Promise<Required<Options>> {
   const options = {} as Required<Options>
 
@@ -166,7 +187,7 @@ export async function promptForOptions(
   }
 
   // Router type selection
-  if (!cliOptions.template) {
+  if (!cliOptions.template && !forcedMode) {
     const routerType = await select({
       message: 'Select the router type:',
       options: [
@@ -186,6 +207,9 @@ export async function promptForOptions(
       process.exit(0)
     }
     options.mode = routerType as typeof CODE_ROUTER | typeof FILE_ROUTER
+  } else if (forcedMode) {
+    options.mode = forcedMode === 'file-router' ? FILE_ROUTER : CODE_ROUTER
+    options.typescript = options.mode === FILE_ROUTER
   } else {
     options.mode =
       cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER
@@ -274,7 +298,7 @@ export async function promptForOptions(
     options.chosenAddOns = await finalizeAddOns(
       options.framework,
       options.mode,
-      cliOptions.addOns,
+      Array.from(new Set([...cliOptions.addOns, ...forcedAddOns])),
     )
     options.tailwind = true
   } else if (cliOptions.addOns) {
@@ -285,11 +309,13 @@ export async function promptForOptions(
     if (options.typescript && addOns.length > 0) {
       const value = await multiselect({
         message: 'What add-ons would you like for your project:',
-        options: addOns.map((addOn) => ({
-          value: addOn.id,
-          label: addOn.name,
-          hint: addOn.description,
-        })),
+        options: addOns
+          .filter((addOn) => !forcedAddOns.includes(addOn.id))
+          .map((addOn) => ({
+            value: addOn.id,
+            label: addOn.name,
+            hint: addOn.description,
+          })),
         required: false,
       })
 
@@ -306,11 +332,13 @@ export async function promptForOptions(
     if (options.typescript && examples.length > 0) {
       const value = await multiselect({
         message: 'Would you like any examples?',
-        options: examples.map((addOn) => ({
-          value: addOn.id,
-          label: addOn.name,
-          hint: addOn.description,
-        })),
+        options: examples
+          .filter((addOn) => !forcedAddOns.includes(addOn.id))
+          .map((addOn) => ({
+            value: addOn.id,
+            label: addOn.name,
+            hint: addOn.description,
+          })),
         required: false,
       })
 
@@ -321,14 +349,26 @@ export async function promptForOptions(
       selectedExamples = value
     }
 
-    if (selectedAddOns.length > 0 || selectedExamples.length > 0) {
+    if (
+      selectedAddOns.length > 0 ||
+      selectedExamples.length > 0 ||
+      forcedAddOns.length > 0
+    ) {
       options.chosenAddOns = await finalizeAddOns(
         options.framework,
         options.mode,
-        [...selectedAddOns, ...selectedExamples],
+        Array.from(
+          new Set([...selectedAddOns, ...selectedExamples, ...forcedAddOns]),
+        ),
       )
       options.tailwind = true
     }
+  } else if (forcedAddOns.length > 0) {
+    options.chosenAddOns = await finalizeAddOns(
+      options.framework,
+      options.mode,
+      forcedAddOns,
+    )
   }
 
   // Collect variables

package/src/types.ts

@@ -4,6 +4,8 @@ import type { ToolChain } from './toolchain.js'
 
 export type Framework = 'solid' | 'react'
 
+export type TemplateOptions = 'typescript' | 'javascript' | 'file-router'
+
 export interface Options {
   framework: Framework
   projectName: string
@@ -20,7 +22,7 @@ export interface Options {
 }
 
 export interface CliOptions {
-  template?: 'typescript' | 'javascript' | 'file-router'
+  template?: TemplateOptions
   framework?: Framework
   tailwind?: boolean
   packageManager?: PackageManager

package/tsconfig.json

@@ -1,8 +1,14 @@
 {
-  "extends": "../../tsconfig.json",
   "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
     "outDir": "./dist",
     "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
     "declaration": true,
     "declarationDir": "./dist/types"
   },