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

package/dist/lib/tanstack/detect.js

@@ -0,0 +1,131 @@
+import fse from 'fs-extra';
+import globby from 'globby';
+import path from 'path';
+const FILE_EXTENSIONS = 'js|jsx|ts|tsx|cjs|cts|mjs|mts';
+export async function getTanStackAppDetails({ projectDir }) {
+    const absoluteProjectDir = path.resolve(projectDir);
+    const packageJson = await getPackageJson({
+        projectDir: absoluteProjectDir
+    });
+    const packages = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+    };
+    const isSolidHost = Boolean(packages['@tanstack/solid-router'] || packages['@tanstack/solid-start']);
+    const hasReactRouter = Boolean(packages['@tanstack/react-router']);
+    const hasReactStart = Boolean(packages['@tanstack/react-start']);
+    const hasRouterPlugin = Boolean(packages['@tanstack/router-plugin']);
+    if (!isSolidHost && !hasReactRouter && !hasReactStart && !hasRouterPlugin) {
+        return {
+            detected: false
+        };
+    }
+    if (isSolidHost) {
+        return incompatible('TanStack Solid projects are not supported.');
+    }
+    if (hasReactStart && packages.next) {
+        return incompatible('TanStack Start and Next.js markers are both present.');
+    }
+    if (!hasReactRouter) {
+        return incompatible('Could not find @tanstack/react-router.');
+    }
+    const kind = hasReactStart ? 'start' : 'router-only';
+    const viteConfigPaths = await findFiles({
+        cwd: absoluteProjectDir,
+        pattern: `vite.config.@(${FILE_EXTENSIONS})`
+    });
+    if (viteConfigPaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: viteConfigPaths,
+            projectDir: absoluteProjectDir,
+            role: 'Vite config'
+        }));
+    }
+    const viteConfigPath = viteConfigPaths[0];
+    if (!viteConfigPath) {
+        return incompatible('Could not find a Vite config file.');
+    }
+    const viteConfig = await fse.readFile(viteConfigPath, 'utf8');
+    const pluginName = kind === 'start' ? 'tanstackStart' : 'tanstackRouter';
+    if (!new RegExp(`\\b${pluginName}\\s*\\(`).test(viteConfig)) {
+        return incompatible(`Could not find ${pluginName}() in ${viteConfigPath}.`);
+    }
+    const sourceDir = path.join(absoluteProjectDir, 'src');
+    const routesDir = path.join(sourceDir, 'routes');
+    const routerPaths = await findFiles({
+        cwd: sourceDir,
+        pattern: `router.@(${FILE_EXTENSIONS})`
+    });
+    if (routerPaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: routerPaths,
+            projectDir: absoluteProjectDir,
+            role: 'router'
+        }));
+    }
+    const routerPath = routerPaths[0];
+    if (!routerPath) {
+        return incompatible(`Could not find src/router.* in ${absoluteProjectDir}.`);
+    }
+    const router = await fse.readFile(routerPath, 'utf8');
+    if (!/\bgetRouter\b/.test(router)) {
+        return incompatible(`Could not find getRouter in ${routerPath}.`);
+    }
+    const rootRoutePaths = await findFiles({
+        cwd: routesDir,
+        pattern: `__root.@(${FILE_EXTENSIONS})`
+    });
+    if (rootRoutePaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: rootRoutePaths,
+            projectDir: absoluteProjectDir,
+            role: 'root route'
+        }));
+    }
+    const rootRoutePath = rootRoutePaths[0];
+    if (!rootRoutePath) {
+        return incompatible(`Could not find src/routes/__root.* in ${absoluteProjectDir}.`);
+    }
+    const details = {
+        isPayloadInstalled: Boolean(packages.payload),
+        kind,
+        projectDir: absoluteProjectDir,
+        rootRoutePath,
+        routerPath,
+        routesDir,
+        sourceDir,
+        viteConfigPath
+    };
+    return {
+        compatible: true,
+        details,
+        detected: true
+    };
+}
+function incompatible(reason) {
+    return {
+        compatible: false,
+        detected: true,
+        reason
+    };
+}
+function getAmbiguousFilesReason({ filePaths, projectDir, role }) {
+    const relativePaths = filePaths.map((filePath)=>path.relative(projectDir, filePath)).sort();
+    return `Found multiple supported ${role} files: ${relativePaths.join(', ')}.`;
+}
+async function findFiles({ cwd, pattern }) {
+    return globby(pattern, {
+        absolute: true,
+        cwd,
+        onlyFiles: true
+    });
+}
+async function getPackageJson({ projectDir }) {
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    if (!await fse.pathExists(packageJsonPath)) {
+        return {};
+    }
+    return fse.readJson(packageJsonPath);
+}
+
+//# sourceMappingURL=detect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/tanstack/detect.ts"],"sourcesContent":["import fse from 'fs-extra'\nimport globby from 'globby'\nimport path from 'path'\n\nimport type { TanStackAppDetails, TanStackAppKind, TanStackDetectionResult } from '../../types.js'\n\ntype PackageJson = {\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n}\n\nconst FILE_EXTENSIONS = 'js|jsx|ts|tsx|cjs|cts|mjs|mts'\n\nexport async function getTanStackAppDetails({\n  projectDir,\n}: {\n  projectDir: string\n}): Promise<TanStackDetectionResult> {\n  const absoluteProjectDir = path.resolve(projectDir)\n  const packageJson = await getPackageJson({ projectDir: absoluteProjectDir })\n  const packages = { ...packageJson.dependencies, ...packageJson.devDependencies }\n  const isSolidHost = Boolean(\n    packages['@tanstack/solid-router'] || packages['@tanstack/solid-start'],\n  )\n  const hasReactRouter = Boolean(packages['@tanstack/react-router'])\n  const hasReactStart = Boolean(packages['@tanstack/react-start'])\n  const hasRouterPlugin = Boolean(packages['@tanstack/router-plugin'])\n\n  if (!isSolidHost && !hasReactRouter && !hasReactStart && !hasRouterPlugin) {\n    return { detected: false }\n  }\n\n  if (isSolidHost) {\n    return incompatible('TanStack Solid projects are not supported.')\n  }\n\n  if (hasReactStart && packages.next) {\n    return incompatible('TanStack Start and Next.js markers are both present.')\n  }\n\n  if (!hasReactRouter) {\n    return incompatible('Could not find @tanstack/react-router.')\n  }\n\n  const kind: TanStackAppKind = hasReactStart ? 'start' : 'router-only'\n  const viteConfigPaths = await findFiles({\n    cwd: absoluteProjectDir,\n    pattern: `vite.config.@(${FILE_EXTENSIONS})`,\n  })\n  if (viteConfigPaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: viteConfigPaths,\n        projectDir: absoluteProjectDir,\n        role: 'Vite config',\n      }),\n    )\n  }\n\n  const viteConfigPath = viteConfigPaths[0]\n  if (!viteConfigPath) {\n    return incompatible('Could not find a Vite config file.')\n  }\n\n  const viteConfig = await fse.readFile(viteConfigPath, 'utf8')\n  const pluginName = kind === 'start' ? 'tanstackStart' : 'tanstackRouter'\n  if (!new RegExp(`\\\\b${pluginName}\\\\s*\\\\(`).test(viteConfig)) {\n    return incompatible(`Could not find ${pluginName}() in ${viteConfigPath}.`)\n  }\n\n  const sourceDir = path.join(absoluteProjectDir, 'src')\n  const routesDir = path.join(sourceDir, 'routes')\n  const routerPaths = await findFiles({\n    cwd: sourceDir,\n    pattern: `router.@(${FILE_EXTENSIONS})`,\n  })\n  if (routerPaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: routerPaths,\n        projectDir: absoluteProjectDir,\n        role: 'router',\n      }),\n    )\n  }\n\n  const routerPath = routerPaths[0]\n  if (!routerPath) {\n    return incompatible(`Could not find src/router.* in ${absoluteProjectDir}.`)\n  }\n\n  const router = await fse.readFile(routerPath, 'utf8')\n  if (!/\\bgetRouter\\b/.test(router)) {\n    return incompatible(`Could not find getRouter in ${routerPath}.`)\n  }\n\n  const rootRoutePaths = await findFiles({\n    cwd: routesDir,\n    pattern: `__root.@(${FILE_EXTENSIONS})`,\n  })\n  if (rootRoutePaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: rootRoutePaths,\n        projectDir: absoluteProjectDir,\n        role: 'root route',\n      }),\n    )\n  }\n\n  const rootRoutePath = rootRoutePaths[0]\n  if (!rootRoutePath) {\n    return incompatible(`Could not find src/routes/__root.* in ${absoluteProjectDir}.`)\n  }\n\n  const details: TanStackAppDetails = {\n    isPayloadInstalled: Boolean(packages.payload),\n    kind,\n    projectDir: absoluteProjectDir,\n    rootRoutePath,\n    routerPath,\n    routesDir,\n    sourceDir,\n    viteConfigPath,\n  }\n\n  return { compatible: true, details, detected: true }\n}\n\nfunction incompatible(reason: string): TanStackDetectionResult {\n  return { compatible: false, detected: true, reason }\n}\n\nfunction getAmbiguousFilesReason({\n  filePaths,\n  projectDir,\n  role,\n}: {\n  filePaths: string[]\n  projectDir: string\n  role: string\n}): string {\n  const relativePaths = filePaths.map((filePath) => path.relative(projectDir, filePath)).sort()\n\n  return `Found multiple supported ${role} files: ${relativePaths.join(', ')}.`\n}\n\nasync function findFiles({ cwd, pattern }: { cwd: string; pattern: string }): Promise<string[]> {\n  return globby(pattern, {\n    absolute: true,\n    cwd,\n    onlyFiles: true,\n  })\n}\n\nasync function getPackageJson({ projectDir }: { projectDir: string }): Promise<PackageJson> {\n  const packageJsonPath = path.join(projectDir, 'package.json')\n\n  if (!(await fse.pathExists(packageJsonPath))) {\n    return {}\n  }\n\n  return fse.readJson(packageJsonPath) as Promise<PackageJson>\n}\n"],"names":["fse","globby","path","FILE_EXTENSIONS","getTanStackAppDetails","projectDir","absoluteProjectDir","resolve","packageJson","getPackageJson","packages","dependencies","devDependencies","isSolidHost","Boolean","hasReactRouter","hasReactStart","hasRouterPlugin","detected","incompatible","next","kind","viteConfigPaths","findFiles","cwd","pattern","length","getAmbiguousFilesReason","filePaths","role","viteConfigPath","viteConfig","readFile","pluginName","RegExp","test","sourceDir","join","routesDir","routerPaths","routerPath","router","rootRoutePaths","rootRoutePath","details","isPayloadInstalled","payload","compatible","reason","relativePaths","map","filePath","relative","sort","absolute","onlyFiles","packageJsonPath","pathExists","readJson"],"mappings":"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"}

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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"}