create-payload-app 4.0.0-internal.fa345ef → 4.0.0-internal.fec2230

package/dist/lib/tanstack/detect.spec.js

@@ -0,0 +1,227 @@
+import fse from 'fs-extra';
+import * as os from 'node:os';
+import path from 'path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { getTanStackAppDetails } from './detect.js';
+describe('getTanStackAppDetails', ()=>{
+    let projectDir;
+    beforeEach(()=>{
+        projectDir = fse.mkdtempSync(path.join(os.tmpdir(), 'create-payload-app-tanstack-'));
+    });
+    afterEach(()=>{
+        fse.removeSync(projectDir);
+    });
+    function writeFixture({ additionalFiles, dependencies, devDependencies, hasRootRoute = true, hasRouter = true, router = 'export function getRouter() {}', vite }) {
+        fse.writeJsonSync(path.join(projectDir, 'package.json'), {
+            dependencies,
+            devDependencies,
+            name: 'tanstack-fixture'
+        });
+        fse.ensureDirSync(path.join(projectDir, 'src/routes'));
+        if (hasRouter) {
+            fse.writeFileSync(path.join(projectDir, 'src/router.tsx'), router);
+        }
+        if (hasRootRoute) {
+            fse.writeFileSync(path.join(projectDir, 'src/routes/__root.tsx'), 'export {}');
+        }
+        if (vite) {
+            fse.writeFileSync(path.join(projectDir, 'vite.config.ts'), vite);
+        }
+        for (const [relativePath, content] of Object.entries(additionalFiles ?? {})){
+            fse.outputFileSync(path.join(projectDir, relativePath), content);
+        }
+    }
+    it('should detect a conventional TanStack Start project', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest',
+                '@tanstack/react-start': 'latest'
+            },
+            vite: `const config = defineConfig({ plugins: [tanstackStart(), viteReact()] })\nexport default config`
+        });
+        const result = await getTanStackAppDetails({
+            projectDir
+        });
+        expect(result).toMatchObject({
+            compatible: true,
+            detected: true,
+            details: {
+                isPayloadInstalled: false,
+                kind: 'start',
+                projectDir,
+                rootRoutePath: path.join(projectDir, 'src/routes/__root.tsx'),
+                routerPath: path.join(projectDir, 'src/router.tsx'),
+                routesDir: path.join(projectDir, 'src/routes'),
+                sourceDir: path.join(projectDir, 'src'),
+                viteConfigPath: path.join(projectDir, 'vite.config.ts')
+            }
+        });
+    });
+    it('should detect a conventional Router-only project', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest',
+                payload: 'latest'
+            },
+            devDependencies: {
+                '@tanstack/router-plugin': 'latest'
+            },
+            vite: `const config = defineConfig({ plugins: [tanstackRouter({ target: 'react' }), viteReact()] })\nexport default config`
+        });
+        expect(await getTanStackAppDetails({
+            projectDir
+        })).toMatchObject({
+            compatible: true,
+            detected: true,
+            details: {
+                isPayloadInstalled: true,
+                kind: 'router-only'
+            }
+        });
+    });
+    it('should detect a Router-only project that also depends on Next.js', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest',
+                next: 'latest'
+            },
+            devDependencies: {
+                '@tanstack/router-plugin': 'latest'
+            },
+            vite: `const config = defineConfig({ plugins: [tanstackRouter({ target: 'react' }), viteReact()] })\nexport default config`
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toMatchObject({
+            compatible: true,
+            detected: true,
+            details: {
+                kind: 'router-only'
+            }
+        });
+    });
+    it('should ignore projects that only use TanStack Query', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-query': 'latest'
+            }
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toEqual({
+            detected: false
+        });
+    });
+    it('should report a missing root route in a recognized host', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest'
+            },
+            devDependencies: {
+                '@tanstack/router-plugin': 'latest'
+            },
+            hasRootRoute: false,
+            vite: 'export default defineConfig({ plugins: [tanstackRouter()] })'
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toMatchObject({
+            compatible: false,
+            detected: true,
+            reason: expect.stringContaining('src/routes/__root')
+        });
+    });
+    it('should report a router without getRouter in a recognized host', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest'
+            },
+            devDependencies: {
+                '@tanstack/router-plugin': 'latest'
+            },
+            router: 'export const router = createRouter({})',
+            vite: 'export default defineConfig({ plugins: [tanstackRouter()] })'
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toMatchObject({
+            compatible: false,
+            detected: true,
+            reason: expect.stringContaining('getRouter')
+        });
+    });
+    it('should report unsupported Solid hosts', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/solid-router': 'latest',
+                '@tanstack/solid-start': 'latest'
+            },
+            vite: 'export default defineConfig({ plugins: [tanstackStart()] })'
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toMatchObject({
+            compatible: false,
+            detected: true,
+            reason: expect.stringContaining('Solid')
+        });
+    });
+    it('should report ambiguous TanStack Start and Next.js markers', async ()=>{
+        writeFixture({
+            dependencies: {
+                '@tanstack/react-router': 'latest',
+                '@tanstack/react-start': 'latest',
+                next: 'latest'
+            },
+            vite: 'export default defineConfig({ plugins: [tanstackStart()] })'
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toMatchObject({
+            compatible: false,
+            detected: true,
+            reason: expect.stringContaining('Next.js')
+        });
+    });
+    it.each([
+        {
+            additionalFiles: {
+                'vite.config.mts': 'export default defineConfig({ plugins: [tanstackStart(), viteReact()] })'
+            },
+            reason: 'Found multiple supported Vite config files: vite.config.mts, vite.config.ts.',
+            role: 'Vite config'
+        },
+        {
+            additionalFiles: {
+                'src/router.ts': 'export function getRouter() {}'
+            },
+            reason: 'Found multiple supported router files: src/router.ts, src/router.tsx.',
+            role: 'router'
+        },
+        {
+            additionalFiles: {
+                'src/routes/__root.ts': 'export {}'
+            },
+            reason: 'Found multiple supported root route files: src/routes/__root.ts, src/routes/__root.tsx.',
+            role: 'root route'
+        }
+    ])('should reject multiple supported $role candidates', async ({ additionalFiles, reason })=>{
+        writeFixture({
+            additionalFiles,
+            dependencies: {
+                '@tanstack/react-router': 'latest',
+                '@tanstack/react-start': 'latest'
+            },
+            vite: 'export default defineConfig({ plugins: [tanstackStart(), viteReact()] })'
+        });
+        await expect(getTanStackAppDetails({
+            projectDir
+        })).resolves.toEqual({
+            compatible: false,
+            detected: true,
+            reason
+        });
+    });
+});
+
+//# sourceMappingURL=detect.spec.js.map

package/dist/lib/tanstack/detect.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/tanstack/detect.spec.ts"],"sourcesContent":["import fse from 'fs-extra'\nimport * as os from 'node:os'\nimport path from 'path'\nimport { afterEach, beforeEach, describe, expect, it } from 'vitest'\n\nimport { getTanStackAppDetails } from './detect.js'\n\ntype Fixture = {\n  additionalFiles?: Record<string, string>\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  hasRootRoute?: boolean\n  hasRouter?: boolean\n  router?: string\n  vite?: string\n}\n\ndescribe('getTanStackAppDetails', () => {\n  let projectDir: string\n\n  beforeEach(() => {\n    projectDir = fse.mkdtempSync(path.join(os.tmpdir(), 'create-payload-app-tanstack-'))\n  })\n\n  afterEach(() => {\n    fse.removeSync(projectDir)\n  })\n\n  function writeFixture({\n    additionalFiles,\n    dependencies,\n    devDependencies,\n    hasRootRoute = true,\n    hasRouter = true,\n    router = 'export function getRouter() {}',\n    vite,\n  }: Fixture) {\n    fse.writeJsonSync(path.join(projectDir, 'package.json'), {\n      dependencies,\n      devDependencies,\n      name: 'tanstack-fixture',\n    })\n    fse.ensureDirSync(path.join(projectDir, 'src/routes'))\n\n    if (hasRouter) {\n      fse.writeFileSync(path.join(projectDir, 'src/router.tsx'), router)\n    }\n    if (hasRootRoute) {\n      fse.writeFileSync(path.join(projectDir, 'src/routes/__root.tsx'), 'export {}')\n    }\n    if (vite) {\n      fse.writeFileSync(path.join(projectDir, 'vite.config.ts'), vite)\n    }\n    for (const [relativePath, content] of Object.entries(additionalFiles ?? {})) {\n      fse.outputFileSync(path.join(projectDir, relativePath), content)\n    }\n  }\n\n  it('should detect a conventional TanStack Start project', async () => {\n    writeFixture({\n      dependencies: { '@tanstack/react-router': 'latest', '@tanstack/react-start': 'latest' },\n      vite: `const config = defineConfig({ plugins: [tanstackStart(), viteReact()] })\\nexport default config`,\n    })\n\n    const result = await getTanStackAppDetails({ projectDir })\n\n    expect(result).toMatchObject({\n      compatible: true,\n      detected: true,\n      details: {\n        isPayloadInstalled: false,\n        kind: 'start',\n        projectDir,\n        rootRoutePath: path.join(projectDir, 'src/routes/__root.tsx'),\n        routerPath: path.join(projectDir, 'src/router.tsx'),\n        routesDir: path.join(projectDir, 'src/routes'),\n        sourceDir: path.join(projectDir, 'src'),\n        viteConfigPath: path.join(projectDir, 'vite.config.ts'),\n      },\n    })\n  })\n\n  it('should detect a conventional Router-only project', async () => {\n    writeFixture({\n      dependencies: { '@tanstack/react-router': 'latest', payload: 'latest' },\n      devDependencies: { '@tanstack/router-plugin': 'latest' },\n      vite: `const config = defineConfig({ plugins: [tanstackRouter({ target: 'react' }), viteReact()] })\\nexport default config`,\n    })\n\n    expect(await getTanStackAppDetails({ projectDir })).toMatchObject({\n      compatible: true,\n      detected: true,\n      details: { isPayloadInstalled: true, kind: 'router-only' },\n    })\n  })\n\n  it('should detect a Router-only project that also depends on Next.js', async () => {\n    writeFixture({\n      dependencies: {\n        '@tanstack/react-router': 'latest',\n        next: 'latest',\n      },\n      devDependencies: { '@tanstack/router-plugin': 'latest' },\n      vite: `const config = defineConfig({ plugins: [tanstackRouter({ target: 'react' }), viteReact()] })\\nexport default config`,\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toMatchObject({\n      compatible: true,\n      detected: true,\n      details: { kind: 'router-only' },\n    })\n  })\n\n  it('should ignore projects that only use TanStack Query', async () => {\n    writeFixture({ dependencies: { '@tanstack/react-query': 'latest' } })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toEqual({ detected: false })\n  })\n\n  it('should report a missing root route in a recognized host', async () => {\n    writeFixture({\n      dependencies: { '@tanstack/react-router': 'latest' },\n      devDependencies: { '@tanstack/router-plugin': 'latest' },\n      hasRootRoute: false,\n      vite: 'export default defineConfig({ plugins: [tanstackRouter()] })',\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toMatchObject({\n      compatible: false,\n      detected: true,\n      reason: expect.stringContaining('src/routes/__root'),\n    })\n  })\n\n  it('should report a router without getRouter in a recognized host', async () => {\n    writeFixture({\n      dependencies: { '@tanstack/react-router': 'latest' },\n      devDependencies: { '@tanstack/router-plugin': 'latest' },\n      router: 'export const router = createRouter({})',\n      vite: 'export default defineConfig({ plugins: [tanstackRouter()] })',\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toMatchObject({\n      compatible: false,\n      detected: true,\n      reason: expect.stringContaining('getRouter'),\n    })\n  })\n\n  it('should report unsupported Solid hosts', async () => {\n    writeFixture({\n      dependencies: { '@tanstack/solid-router': 'latest', '@tanstack/solid-start': 'latest' },\n      vite: 'export default defineConfig({ plugins: [tanstackStart()] })',\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toMatchObject({\n      compatible: false,\n      detected: true,\n      reason: expect.stringContaining('Solid'),\n    })\n  })\n\n  it('should report ambiguous TanStack Start and Next.js markers', async () => {\n    writeFixture({\n      dependencies: {\n        '@tanstack/react-router': 'latest',\n        '@tanstack/react-start': 'latest',\n        next: 'latest',\n      },\n      vite: 'export default defineConfig({ plugins: [tanstackStart()] })',\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toMatchObject({\n      compatible: false,\n      detected: true,\n      reason: expect.stringContaining('Next.js'),\n    })\n  })\n\n  it.each([\n    {\n      additionalFiles: {\n        'vite.config.mts':\n          'export default defineConfig({ plugins: [tanstackStart(), viteReact()] })',\n      },\n      reason: 'Found multiple supported Vite config files: vite.config.mts, vite.config.ts.',\n      role: 'Vite config',\n    },\n    {\n      additionalFiles: { 'src/router.ts': 'export function getRouter() {}' },\n      reason: 'Found multiple supported router files: src/router.ts, src/router.tsx.',\n      role: 'router',\n    },\n    {\n      additionalFiles: { 'src/routes/__root.ts': 'export {}' },\n      reason:\n        'Found multiple supported root route files: src/routes/__root.ts, src/routes/__root.tsx.',\n      role: 'root route',\n    },\n  ])('should reject multiple supported $role candidates', async ({ additionalFiles, reason }) => {\n    writeFixture({\n      additionalFiles,\n      dependencies: {\n        '@tanstack/react-router': 'latest',\n        '@tanstack/react-start': 'latest',\n      },\n      vite: 'export default defineConfig({ plugins: [tanstackStart(), viteReact()] })',\n    })\n\n    await expect(getTanStackAppDetails({ projectDir })).resolves.toEqual({\n      compatible: false,\n      detected: true,\n      reason,\n    })\n  })\n})\n"],"names":["fse","os","path","afterEach","beforeEach","describe","expect","it","getTanStackAppDetails","projectDir","mkdtempSync","join","tmpdir","removeSync","writeFixture","additionalFiles","dependencies","devDependencies","hasRootRoute","hasRouter","router","vite","writeJsonSync","name","ensureDirSync","writeFileSync","relativePath","content","Object","entries","outputFileSync","result","toMatchObject","compatible","detected","details","isPayloadInstalled","kind","rootRoutePath","routerPath","routesDir","sourceDir","viteConfigPath","payload","next","resolves","toEqual","reason","stringContaining","each","role"],"mappings":"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"}

package/dist/lib/tanstack/prepare.d.ts

@@ -0,0 +1,23 @@
+import type { TanStackAppDetails } from '../../types.js';
+export type PreparedWrite = {
+    /** Exact content to write after every preparation check succeeds. */
+    content: string;
+    /** Absolute destination path in the detected host project. */
+    filePath: string;
+};
+type PrepareResult = {
+    reason: string;
+    success: false;
+} | {
+    success: true;
+    writes: PreparedWrite[];
+};
+export declare function prepareTanStackInit({ appDetails, templateRoot, }: {
+    appDetails: TanStackAppDetails;
+    templateRoot: string;
+}): Promise<PrepareResult>;
+export declare function applyPreparedWrites({ writes }: {
+    writes: PreparedWrite[];
+}): Promise<void>;
+export {};
+//# sourceMappingURL=prepare.d.ts.map

package/dist/lib/tanstack/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/lib/tanstack/prepare.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAQxD,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAOpG,wBAAsB,mBAAmB,CAAC,EACxC,UAAU,EACV,YAAY,GACb,EAAE;IACD,UAAU,EAAE,kBAAkB,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoEzB;AAED,wBAAsB,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhG"}

package/dist/lib/tanstack/prepare.js

@@ -0,0 +1,114 @@
+import fse from 'fs-extra';
+import path from 'node:path';
+import { TANSTACK_TEMPLATE_FILES } from './template-files.js';
+import { transformTanStackRootRoute } from './transform-root-route.js';
+import { transformTanStackRouter } from './transform-router.js';
+import { transformTanStackViteConfig } from './transform-vite-config.js';
+export async function prepareTanStackInit({ appDetails, templateRoot }) {
+    try {
+        const templateFilesResult = await getTemplateFiles({
+            appDetails,
+            templateRoot
+        });
+        if (!templateFilesResult.success) {
+            return templateFilesResult;
+        }
+        const [viteConfigContent, routerContent, rootRouteContent, ...templateContents] = await Promise.all([
+            fse.readFile(appDetails.viteConfigPath, 'utf8'),
+            fse.readFile(appDetails.routerPath, 'utf8'),
+            fse.readFile(appDetails.rootRoutePath, 'utf8'),
+            ...templateFilesResult.files.map(({ templatePath })=>fse.readFile(templatePath, 'utf8'))
+        ]);
+        const transformedFiles = [
+            {
+                filePath: appDetails.viteConfigPath,
+                result: transformTanStackViteConfig({
+                    appDetails,
+                    content: viteConfigContent
+                })
+            },
+            {
+                filePath: appDetails.routerPath,
+                result: transformTanStackRouter({
+                    content: routerContent
+                })
+            },
+            {
+                filePath: appDetails.rootRoutePath,
+                result: transformTanStackRootRoute({
+                    content: rootRouteContent,
+                    kind: appDetails.kind
+                })
+            }
+        ];
+        const failedTransform = transformedFiles.find(({ result })=>!result.success);
+        if (failedTransform && !failedTransform.result.success) {
+            return {
+                reason: `Could not transform ${failedTransform.filePath}: ${failedTransform.result.reason}`,
+                success: false
+            };
+        }
+        const writes = transformedFiles.flatMap(({ filePath, result })=>result.success && result.modified ? [
+                {
+                    content: result.content,
+                    filePath
+                }
+            ] : []);
+        for (const [index, templateFile] of templateFilesResult.files.entries()){
+            const content = templateContents[index];
+            const { filePath } = templateFile;
+            if (await fse.pathExists(filePath)) {
+                const existingContent = await fse.readFile(filePath, 'utf8');
+                if (existingContent !== content) {
+                    return {
+                        reason: `A different file already exists at ${filePath}.`,
+                        success: false
+                    };
+                }
+                continue;
+            }
+            writes.push({
+                content,
+                filePath
+            });
+        }
+        return {
+            success: true,
+            writes
+        };
+    } catch (error) {
+        return {
+            reason: error instanceof Error ? error.message : 'Could not prepare TanStack files.',
+            success: false
+        };
+    }
+}
+export async function applyPreparedWrites({ writes }) {
+    for (const { content, filePath } of writes){
+        await fse.ensureDir(path.dirname(filePath));
+        await fse.writeFile(filePath, content);
+    }
+}
+async function getTemplateFiles({ appDetails, templateRoot }) {
+    const files = [];
+    const hasPackedTemplateLayout = await fse.pathExists(path.join(templateRoot, 'routes'));
+    for (const { destination, relativePath, sourcePath } of TANSTACK_TEMPLATE_FILES){
+        const templatePath = hasPackedTemplateLayout ? path.join(templateRoot, destination, relativePath) : path.join(templateRoot, sourcePath);
+        if (!await fse.pathExists(templatePath)) {
+            return {
+                reason: `Required TanStack template file is missing: ${templatePath}.`,
+                success: false
+            };
+        }
+        files.push({
+            filePath: path.join(destination === 'src' ? appDetails.sourceDir : appDetails.routesDir, relativePath),
+            templatePath
+        });
+    }
+    return {
+        files,
+        success: true
+    };
+}
+
+//# sourceMappingURL=prepare.js.map

package/dist/lib/tanstack/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/tanstack/prepare.ts"],"sourcesContent":["import fse from 'fs-extra'\nimport path from 'node:path'\n\nimport type { TanStackAppDetails } from '../../types.js'\nimport type { TextTransformResult } from './transform-vite-config.js'\n\nimport { TANSTACK_TEMPLATE_FILES } from './template-files.js'\nimport { transformTanStackRootRoute } from './transform-root-route.js'\nimport { transformTanStackRouter } from './transform-router.js'\nimport { transformTanStackViteConfig } from './transform-vite-config.js'\n\nexport type PreparedWrite = {\n  /** Exact content to write after every preparation check succeeds. */\n  content: string\n  /** Absolute destination path in the detected host project. */\n  filePath: string\n}\n\ntype PrepareResult = { reason: string; success: false } | { success: true; writes: PreparedWrite[] }\n\ntype TemplateFile = {\n  filePath: string\n  templatePath: string\n}\n\nexport async function prepareTanStackInit({\n  appDetails,\n  templateRoot,\n}: {\n  appDetails: TanStackAppDetails\n  templateRoot: string\n}): Promise<PrepareResult> {\n  try {\n    const templateFilesResult = await getTemplateFiles({ appDetails, templateRoot })\n    if (!templateFilesResult.success) {\n      return templateFilesResult\n    }\n\n    const [viteConfigContent, routerContent, rootRouteContent, ...templateContents] =\n      await Promise.all([\n        fse.readFile(appDetails.viteConfigPath, 'utf8'),\n        fse.readFile(appDetails.routerPath, 'utf8'),\n        fse.readFile(appDetails.rootRoutePath, 'utf8'),\n        ...templateFilesResult.files.map(({ templatePath }) => fse.readFile(templatePath, 'utf8')),\n      ])\n\n    const transformedFiles: Array<{\n      filePath: string\n      result: TextTransformResult\n    }> = [\n      {\n        filePath: appDetails.viteConfigPath,\n        result: transformTanStackViteConfig({ appDetails, content: viteConfigContent }),\n      },\n      {\n        filePath: appDetails.routerPath,\n        result: transformTanStackRouter({ content: routerContent }),\n      },\n      {\n        filePath: appDetails.rootRoutePath,\n        result: transformTanStackRootRoute({ content: rootRouteContent, kind: appDetails.kind }),\n      },\n    ]\n\n    const failedTransform = transformedFiles.find(({ result }) => !result.success)\n    if (failedTransform && !failedTransform.result.success) {\n      return {\n        reason: `Could not transform ${failedTransform.filePath}: ${failedTransform.result.reason}`,\n        success: false,\n      }\n    }\n\n    const writes: PreparedWrite[] = transformedFiles.flatMap(({ filePath, result }) =>\n      result.success && result.modified ? [{ content: result.content, filePath }] : [],\n    )\n\n    for (const [index, templateFile] of templateFilesResult.files.entries()) {\n      const content = templateContents[index]!\n      const { filePath } = templateFile\n\n      if (await fse.pathExists(filePath)) {\n        const existingContent = await fse.readFile(filePath, 'utf8')\n        if (existingContent !== content) {\n          return { reason: `A different file already exists at ${filePath}.`, success: false }\n        }\n\n        continue\n      }\n\n      writes.push({ content, filePath })\n    }\n\n    return { success: true, writes }\n  } catch (error) {\n    return {\n      reason: error instanceof Error ? error.message : 'Could not prepare TanStack files.',\n      success: false,\n    }\n  }\n}\n\nexport async function applyPreparedWrites({ writes }: { writes: PreparedWrite[] }): Promise<void> {\n  for (const { content, filePath } of writes) {\n    await fse.ensureDir(path.dirname(filePath))\n    await fse.writeFile(filePath, content)\n  }\n}\n\nasync function getTemplateFiles({\n  appDetails,\n  templateRoot,\n}: {\n  appDetails: TanStackAppDetails\n  templateRoot: string\n}): Promise<{ files: TemplateFile[]; success: true } | { reason: string; success: false }> {\n  const files: TemplateFile[] = []\n  const hasPackedTemplateLayout = await fse.pathExists(path.join(templateRoot, 'routes'))\n\n  for (const { destination, relativePath, sourcePath } of TANSTACK_TEMPLATE_FILES) {\n    const templatePath = hasPackedTemplateLayout\n      ? path.join(templateRoot, destination, relativePath)\n      : path.join(templateRoot, sourcePath)\n    if (!(await fse.pathExists(templatePath))) {\n      return {\n        reason: `Required TanStack template file is missing: ${templatePath}.`,\n        success: false,\n      }\n    }\n\n    files.push({\n      filePath: path.join(\n        destination === 'src' ? appDetails.sourceDir : appDetails.routesDir,\n        relativePath,\n      ),\n      templatePath,\n    })\n  }\n\n  return { files, success: true }\n}\n"],"names":["fse","path","TANSTACK_TEMPLATE_FILES","transformTanStackRootRoute","transformTanStackRouter","transformTanStackViteConfig","prepareTanStackInit","appDetails","templateRoot","templateFilesResult","getTemplateFiles","success","viteConfigContent","routerContent","rootRouteContent","templateContents","Promise","all","readFile","viteConfigPath","routerPath","rootRoutePath","files","map","templatePath","transformedFiles","filePath","result","content","kind","failedTransform","find","reason","writes","flatMap","modified","index","templateFile","entries","pathExists","existingContent","push","error","Error","message","applyPreparedWrites","ensureDir","dirname","writeFile","hasPackedTemplateLayout","join","destination","relativePath","sourcePath","sourceDir","routesDir"],"mappings":"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"}