@tanstack/create 0.49.1 → 0.49.3

package/tests/copy-assets.test.ts

@@ -0,0 +1,53 @@
+import { existsSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const distDir = resolve(__dirname, '../dist')
+
+describe('copy-assets', () => {
+  it('should copy .ts asset files to dist', () => {
+    // Regression test: .ts files in assets directories must be copied
+    // See: https://github.com/TanStack/cli/issues/XXX
+    const tsAssetFiles = [
+      'frameworks/react/add-ons/t3env/assets/src/env.ts',
+      'frameworks/react/add-ons/tRPC/assets/src/integrations/trpc/init.ts',
+      'frameworks/solid/add-ons/convex/assets/convex/schema.ts',
+    ]
+
+    for (const file of tsAssetFiles) {
+      const fullPath = resolve(distDir, file)
+      expect(existsSync(fullPath), `Expected ${file} to exist in dist`).toBe(
+        true,
+      )
+    }
+  })
+
+  it('should copy .tsx asset files to dist', () => {
+    const tsxAssetFiles = [
+      'frameworks/react/add-ons/tRPC/assets/src/routes/demo/trpc-todo.tsx',
+      'frameworks/solid/add-ons/convex/assets/src/routes/demo/convex.tsx',
+    ]
+
+    for (const file of tsxAssetFiles) {
+      const fullPath = resolve(distDir, file)
+      expect(existsSync(fullPath), `Expected ${file} to exist in dist`).toBe(
+        true,
+      )
+    }
+  })
+
+  it('should copy .d.ts files to dist', () => {
+    const dtsFiles = [
+      'frameworks/react/add-ons/convex/assets/convex/_generated/api.d.ts',
+    ]
+
+    for (const file of dtsFiles) {
+      const fullPath = resolve(distDir, file)
+      expect(existsSync(fullPath), `Expected ${file} to exist in dist`).toBe(
+        true,
+      )
+    }
+  })
+})

package/tests/file-helper.test.ts

@@ -6,6 +6,7 @@ import {
   isDirectory,
   readFileHelper,
   relativePath,
+  toCleanPath,
 } from '../src/file-helpers.js'
 
 vi.mock('node:fs', () => fs)
@@ -15,6 +16,24 @@ beforeEach(() => {
   vol.reset()
 })
 
+describe('toCleanPath', () => {
+  it('should strip Unix-style leading slash', () => {
+    expect(toCleanPath('/projects/my-app/src/file.ts', '/projects/my-app')).toBe(
+      'src/file.ts',
+    )
+  })
+
+  it('should strip Windows-style leading backslash', () => {
+    expect(
+      toCleanPath('C:\\Projects\\my-app\\src\\file.ts', 'C:\\Projects\\my-app'),
+    ).toBe('src\\file.ts')
+  })
+
+  it('should handle paths without leading separator', () => {
+    expect(toCleanPath('/projects/my-app', '/projects/my-app')).toBe('')
+  })
+})
+
 describe('relativePath', () => {
   it('relative path with the same directory and strip extension', () => {
     expect(relativePath('src/utils.ts', 'src/index.ts', true)).toBe('./index')

package/tests/special-steps.test.ts

@@ -34,10 +34,10 @@ describe('Special Steps', () => {
   })
 
   describe('postInitScript', () => {
-    it('should run post-cta-init script when it exists', async () => {
+    it('should run post-create-init script when it exists', async () => {
       const mockPackageJson = {
         scripts: {
-          'post-cta-init': 'echo "Running post-cta-init"',
+          'post-create-init': 'echo "Running post-create-init"',
         },
       }
 
@@ -51,12 +51,12 @@ describe('Special Steps', () => {
       expect(mockEnvironment.startStep).toHaveBeenCalledWith({
         id: 'post-init-script',
         type: 'command',
-        message: 'Running post-cta-init script...',
+        message: 'Running post-create-init script...',
       })
 
       expect(mockEnvironment.execute).toHaveBeenCalledWith(
         'npm',
-        ['run', 'post-cta-init'],
+        ['run', 'post-create-init'],
         '/test/project',
         { inherit: true },
       )
@@ -74,12 +74,12 @@ describe('Special Steps', () => {
 
       expect(mockEnvironment.warn).toHaveBeenCalledWith(
         'Warning',
-        'No package.json found, skipping post-cta-init script',
+        'No package.json found, skipping post-create-init script',
       )
       expect(mockEnvironment.execute).not.toHaveBeenCalled()
     })
 
-    it('should skip when post-cta-init script does not exist', async () => {
+    it('should skip when post-create-init script does not exist', async () => {
       const mockPackageJson = {
         scripts: {
           build: 'echo "Building"',
@@ -100,10 +100,10 @@ describe('Special Steps', () => {
     it('should handle different package managers', async () => {
       const packageManagers = ['yarn', 'pnpm', 'bun', 'deno'] as const
       const expectedCommands = {
-        yarn: { command: 'yarn', args: ['run', 'post-cta-init'] },
-        pnpm: { command: 'pnpm', args: ['post-cta-init'] },
-        bun: { command: 'bun', args: ['--bun', 'run', 'post-cta-init'] },
-        deno: { command: 'deno', args: ['task', 'post-cta-init'] },
+        yarn: { command: 'yarn', args: ['run', 'post-create-init'] },
+        pnpm: { command: 'pnpm', args: ['post-create-init'] },
+        bun: { command: 'bun', args: ['--bun', 'run', 'post-create-init'] },
+        deno: { command: 'deno', args: ['task', 'post-create-init'] },
       }
 
       for (const pm of packageManagers) {
@@ -111,7 +111,7 @@ describe('Special Steps', () => {
         vi.clearAllMocks()
         vi.spyOn(mockEnvironment, 'exists').mockReturnValue(true)
         vi.mocked(fs.readFileSync).mockReturnValue(
-          JSON.stringify({ scripts: { 'post-cta-init': 'test' } }),
+          JSON.stringify({ scripts: { 'post-create-init': 'test' } }),
         )
 
         await postInitScript(mockEnvironment, mockOptions)
@@ -133,7 +133,7 @@ describe('Special Steps', () => {
 
       vi.spyOn(mockEnvironment, 'exists').mockReturnValue(true)
       vi.mocked(fs.readFileSync).mockReturnValue(
-        JSON.stringify({ scripts: { 'post-cta-init': 'test' } }),
+        JSON.stringify({ scripts: { 'post-create-init': 'test' } }),
       )
 
       await runSpecialSteps(mockEnvironment, mockOptions, specialSteps)

package/dist/frameworks/react/add-ons/ai/assets/src/data/demo-guitars.js

@@ -1,67 +0,0 @@
-const guitars = [
-    {
-        id: 1,
-        name: 'TanStack Ukelele',
-        image: '/example-ukelele-tanstack.jpg',
-        description: "Introducing the TanStack Signature Ukulele—a beautifully handcrafted concert ukulele that combines exceptional sound quality with distinctive style. Featuring a warm, resonant koa-wood body with natural grain patterns, this instrument delivers the rich, mellow tones Hawaii is famous for. The exclusive TanStack palm tree inlay on the soundhole adds a unique touch of island flair, while the matching branded headstock makes this a true collector's piece for developers and musicians alike. Whether you're a beginner looking for a quality starter instrument or an experienced player wanting something special, the TanStack Ukulele brings together craftsmanship, character, and that unmistakable tropical spirit.",
-        shortDescription: 'Premium koa-wood ukulele featuring exclusive TanStack branding, perfect for beach vibes and island-inspired melodies.',
-        price: 299,
-    },
-    {
-        id: 2,
-        name: 'Video Game Guitar',
-        image: '/example-guitar-video-games.jpg',
-        description: "The Video Game Guitar is a unique acoustic guitar that features a design inspired by video games. It has a sleek, high-gloss finish and a comfortable playability. The guitar's ergonomic body and fast neck profile ensure comfortable playability for hours on end.",
-        shortDescription: 'A unique electric guitar with a video game design, high-gloss finish, and comfortable playability.',
-        price: 699,
-    },
-    {
-        id: 3,
-        name: 'Superhero Guitar',
-        image: '/example-guitar-superhero.jpg',
-        description: "The Superhero Guitar is a bold black electric guitar that stands out with its unique superhero logo design. Its sleek, high-gloss finish and powerful pickups make it perfect for high-energy performances. The guitar's ergonomic body and fast neck profile ensure comfortable playability for hours on end.",
-        shortDescription: 'A bold black electric guitar with a unique superhero logo, high-gloss finish, and powerful pickups.',
-        price: 699,
-    },
-    {
-        id: 4,
-        name: 'Motherboard Guitar',
-        image: '/example-guitar-motherboard.jpg',
-        description: "This guitar is a tribute to the motherboard of a computer. It's a unique and stylish instrument that will make you feel like a hacker. The intricate circuit-inspired design features actual LED lights that pulse with your playing intensity, while the neck is inlaid with binary code patterns that glow under stage lights. Each pickup has been custom-wound to produce tones ranging from clean digital precision to glitched-out distortion, perfect for electronic music fusion. The Motherboard Guitar seamlessly bridges the gap between traditional craftsmanship and cutting-edge technology, making it the ultimate instrument for the digital age musician.",
-        shortDescription: 'A tech-inspired electric guitar featuring LED lights and binary code inlays that glow under stage lights.',
-        price: 649,
-    },
-    {
-        id: 5,
-        name: 'Racing Guitar',
-        image: '/example-guitar-racing.jpg',
-        description: "Engineered for speed and precision, the Racing Guitar embodies the spirit of motorsport in every curve and contour. Its aerodynamic body, painted in classic racing stripes and high-gloss finish, is crafted from lightweight materials that allow for effortless play during extended performances. The custom low-action setup and streamlined neck profile enable lightning-fast fretwork, while specially designed pickups deliver a high-octane tone that cuts through any mix. Built with performance-grade hardware including racing-inspired control knobs and checkered flag inlays, this guitar isn't just played—it's driven to the limits of musical possibility.",
-        shortDescription: 'A lightweight, aerodynamic guitar with racing stripes and a low-action setup designed for speed and precision.',
-        price: 679,
-    },
-    {
-        id: 6,
-        name: 'Steamer Trunk Guitar',
-        image: '/example-guitar-steamer-trunk.jpg',
-        description: 'The Steamer Trunk Guitar is a semi-hollow body instrument that exudes vintage charm and character. Crafted from reclaimed antique luggage wood, it features brass hardware that adds a touch of elegance and durability. The fretboard is adorned with a world map inlay, making it a unique piece that tells a story of travel and adventure.',
-        shortDescription: 'A semi-hollow body guitar with brass hardware and a world map inlay, crafted from reclaimed antique luggage wood.',
-        price: 629,
-    },
-    {
-        id: 7,
-        name: "Travelin' Man Guitar",
-        image: '/example-guitar-traveling.jpg',
-        description: "The Travelin' Man Guitar is an acoustic masterpiece adorned with vintage postcards from around the world. Each postcard tells a story of adventure and wanderlust, making this guitar a unique piece of art. Its rich, resonant tones and comfortable playability make it perfect for musicians who love to travel and perform.",
-        shortDescription: 'An acoustic guitar with vintage postcards, rich tones, and comfortable playability.',
-        price: 499,
-    },
-    {
-        id: 8,
-        name: 'Flowerly Love Guitar',
-        image: '/example-guitar-flowers.jpg',
-        description: "The Flowerly Love Guitar is an acoustic masterpiece adorned with intricate floral designs on its body. Each flower is hand-painted, adding a touch of nature's beauty to the instrument. Its warm, resonant tones make it perfect for both intimate performances and larger gatherings.",
-        shortDescription: 'An acoustic guitar with hand-painted floral designs and warm, resonant tones.',
-        price: 599,
-    },
-];
-export default guitars;

package/dist/frameworks/react/add-ons/ai/assets/src/hooks/demo-useAudioRecorder.js

@@ -1,70 +0,0 @@
-import { useCallback, useRef, useState } from 'react';
-/**
- * Hook for recording audio and transcribing it via the transcription API.
- */
-export function useAudioRecorder() {
-    const [isRecording, setIsRecording] = useState(false);
-    const [isTranscribing, setIsTranscribing] = useState(false);
-    const mediaRecorderRef = useRef(null);
-    const chunksRef = useRef([]);
-    const startRecording = useCallback(async () => {
-        try {
-            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-            const mediaRecorder = new MediaRecorder(stream, {
-                mimeType: 'audio/webm;codecs=opus',
-            });
-            mediaRecorderRef.current = mediaRecorder;
-            chunksRef.current = [];
-            mediaRecorder.ondataavailable = (e) => {
-                if (e.data.size > 0) {
-                    chunksRef.current.push(e.data);
-                }
-            };
-            mediaRecorder.start();
-            setIsRecording(true);
-        }
-        catch (error) {
-            console.error('Failed to start recording:', error);
-            alert('Could not access microphone. Please check permissions.');
-        }
-    }, []);
-    const stopRecording = useCallback(async () => {
-        return new Promise((resolve) => {
-            const mediaRecorder = mediaRecorderRef.current;
-            if (!mediaRecorder) {
-                resolve(null);
-                return;
-            }
-            mediaRecorder.onstop = async () => {
-                setIsRecording(false);
-                setIsTranscribing(true);
-                const audioBlob = new Blob(chunksRef.current, { type: 'audio/webm' });
-                // Stop all tracks
-                mediaRecorder.stream.getTracks().forEach((track) => track.stop());
-                try {
-                    const formData = new FormData();
-                    formData.append('audio', new File([audioBlob], 'recording.webm', { type: 'audio/webm' }));
-                    formData.append('model', 'whisper-1');
-                    const response = await fetch('/demo/api/transcription', {
-                        method: 'POST',
-                        body: formData,
-                    });
-                    if (!response.ok) {
-                        const errorData = await response.json();
-                        throw new Error(errorData.error || 'Transcription failed');
-                    }
-                    const result = await response.json();
-                    setIsTranscribing(false);
-                    resolve(result.text || null);
-                }
-                catch (error) {
-                    console.error('Transcription error:', error);
-                    setIsTranscribing(false);
-                    resolve(null);
-                }
-            };
-            mediaRecorder.stop();
-        });
-    }, []);
-    return { isRecording, isTranscribing, startRecording, stopRecording };
-}

package/dist/frameworks/react/add-ons/ai/assets/src/hooks/demo-useTTS.js

@@ -1,66 +0,0 @@
-import { useCallback, useRef, useState } from 'react';
-/**
- * Hook for text-to-speech playback via the TTS API.
- */
-export function useTTS() {
-    const [playingId, setPlayingId] = useState(null);
-    const audioRef = useRef(null);
-    const speak = useCallback(async (text, id) => {
-        // Stop any currently playing audio
-        if (audioRef.current) {
-            audioRef.current.pause();
-            audioRef.current = null;
-        }
-        setPlayingId(id);
-        try {
-            const response = await fetch('/demo/api/tts', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    text,
-                    voice: 'nova',
-                    model: 'tts-1',
-                    format: 'mp3',
-                }),
-            });
-            if (!response.ok) {
-                const errorData = await response.json();
-                throw new Error(errorData.error || 'TTS failed');
-            }
-            const result = await response.json();
-            // Convert base64 to audio and play
-            const audioData = atob(result.audio);
-            const bytes = new Uint8Array(audioData.length);
-            for (let i = 0; i < audioData.length; i++) {
-                bytes[i] = audioData.charCodeAt(i);
-            }
-            const blob = new Blob([bytes], { type: result.contentType });
-            const url = URL.createObjectURL(blob);
-            const audio = new Audio(url);
-            audioRef.current = audio;
-            audio.onended = () => {
-                URL.revokeObjectURL(url);
-                setPlayingId(null);
-                audioRef.current = null;
-            };
-            audio.onerror = () => {
-                URL.revokeObjectURL(url);
-                setPlayingId(null);
-                audioRef.current = null;
-            };
-            await audio.play();
-        }
-        catch (error) {
-            console.error('TTS error:', error);
-            setPlayingId(null);
-        }
-    }, []);
-    const stop = useCallback(() => {
-        if (audioRef.current) {
-            audioRef.current.pause();
-            audioRef.current = null;
-        }
-        setPlayingId(null);
-    }, []);
-    return { playingId, speak, stop };
-}

package/dist/frameworks/react/add-ons/ai/assets/src/lib/demo-ai-hook.js

@@ -1,11 +0,0 @@
-import { fetchServerSentEvents, useChat, createChatClientOptions, } from '@tanstack/ai-react';
-import { clientTools } from '@tanstack/ai-client';
-import { recommendGuitarToolDef } from '@/lib/demo-guitar-tools';
-const recommendGuitarToolClient = recommendGuitarToolDef.client(({ id }) => ({
-    id: +id,
-}));
-const chatOptions = createChatClientOptions({
-    connection: fetchServerSentEvents('/demo/api/ai/chat'),
-    tools: clientTools(recommendGuitarToolClient),
-});
-export const useGuitarRecommendationChat = () => useChat(chatOptions);

package/dist/frameworks/react/add-ons/ai/assets/src/lib/demo-guitar-tools.js

@@ -1,32 +0,0 @@
-import { toolDefinition } from '@tanstack/ai';
-import { z } from 'zod';
-import guitars from '@/data/demo-guitars';
-// Tool definition for getting guitars
-export const getGuitarsToolDef = toolDefinition({
-    name: 'getGuitars',
-    description: 'Get all products from the database',
-    inputSchema: z.object({}),
-    outputSchema: z.array(z.object({
-        id: z.number(),
-        name: z.string(),
-        image: z.string(),
-        description: z.string(),
-        shortDescription: z.string(),
-        price: z.number(),
-    })),
-});
-// Server implementation
-export const getGuitars = getGuitarsToolDef.server(() => guitars);
-// Tool definition for guitar recommendation
-export const recommendGuitarToolDef = toolDefinition({
-    name: 'recommendGuitar',
-    description: 'REQUIRED tool to display a guitar recommendation to the user. This tool MUST be used whenever recommending a guitar - do NOT write recommendations yourself. This displays the guitar in a special appealing format with a buy button.',
-    inputSchema: z.object({
-        id: z
-            .union([z.string(), z.number()])
-            .describe('The ID of the guitar to recommend (from the getGuitars results)'),
-    }),
-    outputSchema: z.object({
-        id: z.number(),
-    }),
-});

package/dist/frameworks/react/add-ons/ai/assets/src/routes/demo/api.ai.chat.js

@@ -1,87 +0,0 @@
-import { createFileRoute } from '@tanstack/react-router';
-import { chat, maxIterations, toServerSentEventsResponse } from '@tanstack/ai';
-import { anthropicText } from '@tanstack/ai-anthropic';
-import { openaiText } from '@tanstack/ai-openai';
-import { geminiText } from '@tanstack/ai-gemini';
-import { ollamaText } from '@tanstack/ai-ollama';
-import { getGuitars, recommendGuitarToolDef } from '@/lib/demo-guitar-tools';
-const SYSTEM_PROMPT = `You are a helpful assistant for a store that sells guitars.
-
-CRITICAL INSTRUCTIONS - YOU MUST FOLLOW THIS EXACT WORKFLOW:
-
-When a user asks for a guitar recommendation:
-1. FIRST: Use the getGuitars tool (no parameters needed)
-2. SECOND: Use the recommendGuitar tool with the ID of the guitar you want to recommend
-3. NEVER write a recommendation directly - ALWAYS use the recommendGuitar tool
-
-IMPORTANT:
-- The recommendGuitar tool will display the guitar in a special, appealing format
-- You MUST use recommendGuitar for ANY guitar recommendation
-- ONLY recommend guitars from our inventory (use getGuitars first)
-- The recommendGuitar tool has a buy button - this is how customers purchase
-- Do NOT describe the guitar yourself - let the recommendGuitar tool do it
-`;
-export const Route = createFileRoute('/demo/api/ai/chat')({
-    server: {
-        handlers: {
-            POST: async ({ request }) => {
-                // Capture request signal before reading body (it may be aborted after body is consumed)
-                const requestSignal = request.signal;
-                // If request is already aborted, return early
-                if (requestSignal.aborted) {
-                    return new Response(null, { status: 499 }); // 499 = Client Closed Request
-                }
-                const abortController = new AbortController();
-                try {
-                    const body = await request.json();
-                    const { messages } = body;
-                    // Determine the best available provider
-                    let provider = 'ollama';
-                    let model = 'mistral:7b';
-                    if (process.env.ANTHROPIC_API_KEY) {
-                        provider = 'anthropic';
-                        model = 'claude-haiku-4-5';
-                    }
-                    else if (process.env.OPENAI_API_KEY) {
-                        provider = 'openai';
-                        model = 'gpt-4o';
-                    }
-                    else if (process.env.GEMINI_API_KEY) {
-                        provider = 'gemini';
-                        model = 'gemini-2.0-flash-exp';
-                    }
-                    // Adapter factory pattern for multi-vendor support
-                    const adapterConfig = {
-                        anthropic: () => anthropicText((model || 'claude-haiku-4-5')),
-                        openai: () => openaiText((model || 'gpt-4o')),
-                        gemini: () => geminiText((model || 'gemini-2.0-flash-exp')),
-                        ollama: () => ollamaText((model || 'mistral:7b')),
-                    };
-                    const adapter = adapterConfig[provider]();
-                    const stream = chat({
-                        adapter,
-                        tools: [
-                            getGuitars, // Server tool
-                            recommendGuitarToolDef, // No server execute - client will handle
-                        ],
-                        systemPrompts: [SYSTEM_PROMPT],
-                        agentLoopStrategy: maxIterations(5),
-                        messages,
-                        abortController,
-                    });
-                    return toServerSentEventsResponse(stream, { abortController });
-                }
-                catch (error) {
-                    // If request was aborted, return early (don't send error response)
-                    if (error.name === 'AbortError' || abortController.signal.aborted) {
-                        return new Response(null, { status: 499 }); // 499 = Client Closed Request
-                    }
-                    return new Response(JSON.stringify({ error: 'Failed to process chat request' }), {
-                        status: 500,
-                        headers: { 'Content-Type': 'application/json' },
-                    });
-                }
-            },
-        },
-    },
-});

package/dist/frameworks/react/add-ons/ai/assets/src/routes/demo/api.ai.image.js

@@ -1,55 +0,0 @@
-import { createFileRoute } from '@tanstack/react-router';
-import { generateImage, createImageOptions } from '@tanstack/ai';
-import { openaiImage } from '@tanstack/ai-openai';
-export const Route = createFileRoute('/demo/api/ai/image')({
-    server: {
-        handlers: {
-            POST: async ({ request }) => {
-                const body = await request.json();
-                const { prompt, numberOfImages = 1, size = '1024x1024' } = body;
-                if (!prompt || prompt.trim().length === 0) {
-                    return new Response(JSON.stringify({
-                        error: 'Prompt is required',
-                    }), {
-                        status: 400,
-                        headers: { 'Content-Type': 'application/json' },
-                    });
-                }
-                if (!process.env.OPENAI_API_KEY) {
-                    return new Response(JSON.stringify({
-                        error: 'OPENAI_API_KEY is not configured',
-                    }), {
-                        status: 500,
-                        headers: { 'Content-Type': 'application/json' },
-                    });
-                }
-                try {
-                    const options = createImageOptions({
-                        adapter: openaiImage('gpt-image-1'),
-                    });
-                    const result = await generateImage({
-                        ...options,
-                        prompt,
-                        numberOfImages,
-                        size,
-                    });
-                    return new Response(JSON.stringify({
-                        images: result.images,
-                        model: 'gpt-image-1',
-                    }), {
-                        status: 200,
-                        headers: { 'Content-Type': 'application/json' },
-                    });
-                }
-                catch (error) {
-                    return new Response(JSON.stringify({
-                        error: error.message || 'An error occurred',
-                    }), {
-                        status: 500,
-                        headers: { 'Content-Type': 'application/json' },
-                    });
-                }
-            },
-        },
-    },
-});