@tanstack/start-plugin-core 1.121.0-alpha.8 → 1.121.0

package/dist/esm/plugin.js

@@ -1,31 +1,33 @@
 import path from "node:path";
 import { createNitro } from "nitropack";
-import { tanstackRouter } from "@tanstack/router-plugin/vite";
+import { trimPathRight } from "@tanstack/router-core";
+import { VIRTUAL_MODULES } from "@tanstack/start-server-core";
 import { TanStackServerFnPluginEnv } from "@tanstack/server-functions-plugin";
 import * as vite from "vite";
-import { createTanStackStartOptionsSchema, createTanStackConfig } from "./schema.js";
-import { nitroPlugin } from "./nitro/nitro-plugin.js";
-import { startManifestPlugin } from "./routesManifestPlugin.js";
-import { TanStackStartCompilerPlugin } from "./start-compiler-plugin.js";
-import { VITE_ENVIRONMENT_NAMES } from "./constants.js";
-import { TanStackStartServerRoutesVite } from "./start-server-routes-plugin/plugin.js";
-createTanStackStartOptionsSchema();
+import { createTanStackConfig } from "./schema.js";
+import { nitroPlugin } from "./nitro-plugin/plugin.js";
+import { startManifestPlugin } from "./start-manifest-plugin/plugin.js";
+import { startCompilerPlugin } from "./start-compiler-plugin.js";
+import { SSR_ENTRY_FILE, VITE_ENVIRONMENT_NAMES, CLIENT_DIST_DIR } from "./constants.js";
+import { tanStackStartRouter } from "./start-router-plugin/plugin.js";
+import { loadEnvPlugin } from "./load-env-plugin/plugin.js";
+import { devServerPlugin } from "./dev-server-plugin/plugin.js";
+import { resolveVirtualEntriesPlugin } from "./resolve-virtual-entries-plugin/plugin.js";
 createTanStackConfig();
-const clientDistDir = ".tanstack-start/build/client-dist";
-const ssrEntryFile = "ssr.mjs";
 let ssrBundle;
 function TanStackStartVitePluginCore(opts, startConfig) {
   return [
-    tanstackRouter({
-      verboseFileRoutes: false,
+    tanStackStartRouter({
       ...startConfig.tsr,
       target: opts.framework,
-      enableRouteGeneration: true,
       autoCodeSplitting: true
     }),
+    resolveVirtualEntriesPlugin(opts, startConfig),
     {
       name: "tanstack-start-core:config-client",
-      async config() {
+      async config(viteConfig) {
+        const viteAppBase = trimPathRight(viteConfig.base || "/");
+        globalThis.TSS_APP_BASE = viteAppBase;
         const nitroOutputPublicDir = await (async () => {
           const dummyNitroApp = await createNitro({
             preset: startConfig.target,
@@ -39,11 +41,15 @@ function TanStackStartVitePluginCore(opts, startConfig) {
           const entry = startConfig2.clientEntryPath.startsWith(
             "/~start/default-client-entry"
           ) ? startConfig2.clientEntryPath : vite.normalizePath(
-            path.resolve(startConfig2.root, startConfig2.clientEntryPath)
+            path.join(
+              "/@fs",
+              path.resolve(startConfig2.root, startConfig2.clientEntryPath)
+            )
           );
           return entry;
         };
         return {
+          base: viteAppBase,
           environments: {
             [VITE_ENVIRONMENT_NAMES.client]: {
               consumer: "client",
@@ -54,9 +60,9 @@ function TanStackStartVitePluginCore(opts, startConfig) {
                     main: getClientEntryPath(startConfig)
                   },
                   output: {
-                    dir: path.resolve(startConfig.root, clientDistDir)
+                    dir: path.resolve(startConfig.root, CLIENT_DIST_DIR)
                   },
-                  // TODO this should be removed
+                  // TODO: this should be removed
                   external: ["node:fs", "node:path", "node:os", "node:crypto"]
                 }
               }
@@ -71,12 +77,12 @@ function TanStackStartVitePluginCore(opts, startConfig) {
                 copyPublicDir: false,
                 rollupOptions: {
                   output: {
-                    entryFileNames: ssrEntryFile
+                    entryFileNames: SSR_ENTRY_FILE
                   },
                   plugins: [
                     {
                       name: "capture-output",
-                      generateBundle(options, bundle) {
+                      generateBundle(_options, bundle) {
                         ssrBundle = bundle;
                       }
                     }
@@ -100,34 +106,44 @@ function TanStackStartVitePluginCore(opts, startConfig) {
               "@tanstack/start-router-manifest",
               "@tanstack/start-config",
               "@tanstack/server-functions-plugin",
-              "tanstack-start-router-manifest:v",
-              "tanstack-start-server-fn-manifest:v",
               "nitropack",
-              "@tanstack/**"
+              "@tanstack/**start**",
+              ...Object.values(VIRTUAL_MODULES)
             ]
           },
+          optimizeDeps: {
+            exclude: [...Object.values(VIRTUAL_MODULES)]
+          },
           /* prettier-ignore */
           define: {
-            ...injectDefineEnv("TSS_PUBLIC_BASE", startConfig.public.base),
-            ...injectDefineEnv("TSS_CLIENT_BASE", startConfig.client.base),
-            ...injectDefineEnv("TSS_CLIENT_ENTRY", getClientEntryPath(startConfig)),
+            // define is an esbuild function that replaces the any instances of given keys with the given values
+            // i.e: __FRAMEWORK_NAME__ can be replaced with JSON.stringify("TanStack Start")
+            // This is not the same as injecting environment variables.
+            ...defineReplaceEnv("TSS_CLIENT_ENTRY", getClientEntryPath(startConfig)),
             // This is consumed by the router-manifest, where the entry point is imported after the dev refresh runtime is resolved
-            ...injectDefineEnv("TSS_SERVER_FN_BASE", startConfig.serverFns.base),
-            ...injectDefineEnv("TSS_OUTPUT_PUBLIC_DIR", nitroOutputPublicDir)
+            ...defineReplaceEnv("TSS_SERVER_FN_BASE", startConfig.serverFns.base),
+            ...defineReplaceEnv("TSS_OUTPUT_PUBLIC_DIR", nitroOutputPublicDir),
+            ...defineReplaceEnv("TSS_APP_BASE", viteAppBase)
           }
         };
       }
     },
     // N.B. TanStackStartCompilerPlugin must be before the TanStackServerFnPluginEnv
-    TanStackStartCompilerPlugin(opts.framework, {
+    startCompilerPlugin(opts.framework, {
       client: { envName: VITE_ENVIRONMENT_NAMES.client },
       server: { envName: VITE_ENVIRONMENT_NAMES.server }
     }),
     TanStackServerFnPluginEnv({
       // This is the ID that will be available to look up and import
       // our server function manifest and resolve its module
-      manifestVirtualImportId: "tanstack-start-server-fn-manifest:v",
-      manifestOutputFilename: ".tanstack-start/build/server/server-functions-manifest.json",
+      manifestVirtualImportId: VIRTUAL_MODULES.serverFnManifest,
+      manifestOutputFilename: path.join(
+        ".tanstack",
+        "start",
+        "build",
+        "server",
+        "server-functions-manifest.json"
+      ),
       client: {
         getRuntimeCode: () => `import { createClientRpc } from '@tanstack/${opts.framework}-start/server-functions-client'`,
         replacer: (d) => `createClientRpc('${d.functionId}', '${startConfig.serverFns.base}')`,
@@ -146,23 +162,19 @@ function TanStackStartVitePluginCore(opts, startConfig) {
         return serverEnv.runner.import(fn.extractedFilename);
       }
     }),
+    loadEnvPlugin(startConfig),
     startManifestPlugin(startConfig),
-    nitroPlugin(startConfig, () => ssrBundle),
-    TanStackStartServerRoutesVite({
-      ...startConfig.tsr,
-      target: opts.framework
-    })
+    devServerPlugin(),
+    nitroPlugin(startConfig, () => ssrBundle)
   ];
 }
-function injectDefineEnv(key, value) {
+function defineReplaceEnv(key, value) {
   return {
     [`process.env.${key}`]: JSON.stringify(value),
     [`import.meta.env.${key}`]: JSON.stringify(value)
   };
 }
 export {
-  TanStackStartVitePluginCore,
-  clientDistDir,
-  ssrEntryFile
+  TanStackStartVitePluginCore
 };
 //# sourceMappingURL=plugin.js.map

package/dist/esm/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["../../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { createNitro } from 'nitropack'\nimport { tanstackRouter } from '@tanstack/router-plugin/vite'\nimport { TanStackServerFnPluginEnv } from '@tanstack/server-functions-plugin'\nimport * as vite from 'vite'\nimport {\n  createTanStackConfig,\n  createTanStackStartOptionsSchema,\n} from './schema'\nimport { nitroPlugin } from './nitro/nitro-plugin'\nimport { startManifestPlugin } from './routesManifestPlugin'\nimport { TanStackStartCompilerPlugin } from './start-compiler-plugin'\nimport { VITE_ENVIRONMENT_NAMES } from './constants'\nimport { TanStackStartServerRoutesVite } from './start-server-routes-plugin/plugin'\nimport type { PluginOption, Rollup } from 'vite'\nimport type { z } from 'zod'\nimport type { CompileStartFrameworkOptions } from './compilers'\n\nconst TanStackStartOptionsSchema = createTanStackStartOptionsSchema()\nexport type TanStackStartInputConfig = z.input<\n  typeof TanStackStartOptionsSchema\n>\n\nconst defaultConfig = createTanStackConfig()\nexport function getTanStackStartOptions(opts?: TanStackStartInputConfig) {\n  return defaultConfig.parse(opts)\n}\n\nexport type TanStackStartOutputConfig = ReturnType<\n  typeof getTanStackStartOptions\n>\n\nexport const clientDistDir = '.tanstack-start/build/client-dist'\nexport const ssrEntryFile = 'ssr.mjs'\n\nexport interface TanStackStartVitePluginCoreOptions {\n  framework: CompileStartFrameworkOptions\n}\n// this needs to live outside of the TanStackStartVitePluginCore since it will be invoked multiple times by vite\nlet ssrBundle: Rollup.OutputBundle\n\nexport function TanStackStartVitePluginCore(\n  opts: TanStackStartVitePluginCoreOptions,\n  startConfig: TanStackStartOutputConfig,\n): Array<PluginOption> {\n  return [\n    tanstackRouter({\n      verboseFileRoutes: false,\n      ...startConfig.tsr,\n      target: opts.framework,\n      enableRouteGeneration: true,\n      autoCodeSplitting: true,\n    }),\n    {\n      name: 'tanstack-start-core:config-client',\n      async config() {\n        const nitroOutputPublicDir = await (async () => {\n          // Create a dummy nitro app to get the resolved public output path\n          const dummyNitroApp = await createNitro({\n            preset: startConfig.target,\n            compatibilityDate: '2024-12-01',\n          })\n\n          const nitroOutputPublicDir = dummyNitroApp.options.output.publicDir\n          await dummyNitroApp.close()\n\n          return nitroOutputPublicDir\n        })()\n\n        const getClientEntryPath = (startConfig: TanStackStartOutputConfig) => {\n          // when the user specifies a custom client entry path, we need to resolve it\n          // relative to the root of the project, keeping in mind that if not specified\n          // it will be /~start/default-client-entry which is a virtual path\n          // that is resolved by vite to the actual client entry path\n          const entry = startConfig.clientEntryPath.startsWith(\n            '/~start/default-client-entry',\n          )\n            ? startConfig.clientEntryPath\n            : vite.normalizePath(\n                path.resolve(startConfig.root, startConfig.clientEntryPath),\n              )\n\n          return entry\n        }\n\n        return {\n          environments: {\n            [VITE_ENVIRONMENT_NAMES.client]: {\n              consumer: 'client',\n              build: {\n                manifest: true,\n                rollupOptions: {\n                  input: {\n                    main: getClientEntryPath(startConfig),\n                  },\n                  output: {\n                    dir: path.resolve(startConfig.root, clientDistDir),\n                  },\n                  // TODO this should be removed\n                  external: ['node:fs', 'node:path', 'node:os', 'node:crypto'],\n                },\n              },\n            },\n            [VITE_ENVIRONMENT_NAMES.server]: {\n              consumer: 'server',\n              build: {\n                ssr: true,\n                // we don't write to the file system as the below 'capture-output' plugin will\n                // capture the output and write it to the virtual file system\n                write: false,\n                copyPublicDir: false,\n                rollupOptions: {\n                  output: {\n                    entryFileNames: ssrEntryFile,\n                  },\n                  plugins: [\n                    {\n                      name: 'capture-output',\n                      generateBundle(options, bundle) {\n                        // TODO can this hook be called more than once?\n                        ssrBundle = bundle\n                      },\n                    },\n                  ],\n                },\n                commonjsOptions: {\n                  include: [/node_modules/],\n                },\n              },\n            },\n          },\n          resolve: {\n            noExternal: [\n              '@tanstack/start-client',\n              '@tanstack/start-client-core',\n              '@tanstack/start-server',\n              '@tanstack/start-server-core',\n              '@tanstack/start-server-functions-fetcher',\n              '@tanstack/start-server-functions-client',\n              '@tanstack/start-server-functions-server',\n              '@tanstack/start-router-manifest',\n              '@tanstack/start-config',\n              '@tanstack/server-functions-plugin',\n              'tanstack-start-router-manifest:v',\n              'tanstack-start-server-fn-manifest:v',\n              'nitropack',\n              '@tanstack/**',\n            ],\n          },\n          /* prettier-ignore */\n          define: {\n            ...injectDefineEnv('TSS_PUBLIC_BASE', startConfig.public.base),\n            ...injectDefineEnv('TSS_CLIENT_BASE', startConfig.client.base),\n            ...injectDefineEnv('TSS_CLIENT_ENTRY', getClientEntryPath(startConfig)), // This is consumed by the router-manifest, where the entry point is imported after the dev refresh runtime is resolved\n            ...injectDefineEnv('TSS_SERVER_FN_BASE', startConfig.serverFns.base),\n            ...injectDefineEnv('TSS_OUTPUT_PUBLIC_DIR', nitroOutputPublicDir),\n          },\n        }\n      },\n    },\n    // N.B. TanStackStartCompilerPlugin must be before the TanStackServerFnPluginEnv\n    TanStackStartCompilerPlugin(opts.framework, {\n      client: { envName: VITE_ENVIRONMENT_NAMES.client },\n      server: { envName: VITE_ENVIRONMENT_NAMES.server },\n    }),\n    TanStackServerFnPluginEnv({\n      // This is the ID that will be available to look up and import\n      // our server function manifest and resolve its module\n      manifestVirtualImportId: 'tanstack-start-server-fn-manifest:v',\n      manifestOutputFilename:\n        '.tanstack-start/build/server/server-functions-manifest.json',\n      client: {\n        getRuntimeCode: () =>\n          `import { createClientRpc } from '@tanstack/${opts.framework}-start/server-functions-client'`,\n        replacer: (d) =>\n          `createClientRpc('${d.functionId}', '${startConfig.serverFns.base}')`,\n        envName: VITE_ENVIRONMENT_NAMES.client,\n      },\n      server: {\n        getRuntimeCode: () =>\n          `import { createServerRpc } from '@tanstack/${opts.framework}-start/server-functions-server'`,\n        replacer: (d) =>\n          `createServerRpc('${d.functionId}', '${startConfig.serverFns.base}', ${d.fn})`,\n        envName: VITE_ENVIRONMENT_NAMES.server,\n      },\n      importer: (fn) => {\n        const serverEnv = (globalThis as any).viteDevServer.environments[\n          VITE_ENVIRONMENT_NAMES.server\n        ]\n        if (!serverEnv) {\n          throw new Error(`'ssr' vite dev environment not found`)\n        }\n        return serverEnv.runner.import(fn.extractedFilename)\n      },\n    }),\n    startManifestPlugin(startConfig),\n    nitroPlugin(startConfig, () => ssrBundle),\n    TanStackStartServerRoutesVite({\n      ...startConfig.tsr,\n      target: opts.framework,\n    }),\n  ]\n}\n\nfunction injectDefineEnv<TKey extends string, TValue extends string>(\n  key: TKey,\n  value: TValue,\n): { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } {\n  return {\n    [`process.env.${key}`]: JSON.stringify(value),\n    [`import.meta.env.${key}`]: JSON.stringify(value),\n  } as { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue }\n}\n"],"names":["nitroOutputPublicDir","startConfig"],"mappings":";;;;;;;;;;;AAkBmC,iCAAiC;AAK9C,qBAAqB;AASpC,MAAM,gBAAgB;AACtB,MAAM,eAAe;AAM5B,IAAI;AAEY,SAAA,4BACd,MACA,aACqB;AACd,SAAA;AAAA,IACL,eAAe;AAAA,MACb,mBAAmB;AAAA,MACnB,GAAG,YAAY;AAAA,MACf,QAAQ,KAAK;AAAA,MACb,uBAAuB;AAAA,MACvB,mBAAmB;AAAA,IAAA,CACpB;AAAA,IACD;AAAA,MACE,MAAM;AAAA,MACN,MAAM,SAAS;AACP,cAAA,uBAAuB,OAAO,YAAY;AAExC,gBAAA,gBAAgB,MAAM,YAAY;AAAA,YACtC,QAAQ,YAAY;AAAA,YACpB,mBAAmB;AAAA,UAAA,CACpB;AAEKA,gBAAAA,wBAAuB,cAAc,QAAQ,OAAO;AAC1D,gBAAM,cAAc,MAAM;AAEnBA,iBAAAA;AAAAA,QAAAA,GACN;AAEG,cAAA,qBAAqB,CAACC,iBAA2C;AAK/D,gBAAA,QAAQA,aAAY,gBAAgB;AAAA,YACxC;AAAA,UAAA,IAEEA,aAAY,kBACZ,KAAK;AAAA,YACH,KAAK,QAAQA,aAAY,MAAMA,aAAY,eAAe;AAAA,UAC5D;AAEG,iBAAA;AAAA,QACT;AAEO,eAAA;AAAA,UACL,cAAc;AAAA,YACZ,CAAC,uBAAuB,MAAM,GAAG;AAAA,cAC/B,UAAU;AAAA,cACV,OAAO;AAAA,gBACL,UAAU;AAAA,gBACV,eAAe;AAAA,kBACb,OAAO;AAAA,oBACL,MAAM,mBAAmB,WAAW;AAAA,kBACtC;AAAA,kBACA,QAAQ;AAAA,oBACN,KAAK,KAAK,QAAQ,YAAY,MAAM,aAAa;AAAA,kBACnD;AAAA;AAAA,kBAEA,UAAU,CAAC,WAAW,aAAa,WAAW,aAAa;AAAA,gBAAA;AAAA,cAC7D;AAAA,YAEJ;AAAA,YACA,CAAC,uBAAuB,MAAM,GAAG;AAAA,cAC/B,UAAU;AAAA,cACV,OAAO;AAAA,gBACL,KAAK;AAAA;AAAA;AAAA,gBAGL,OAAO;AAAA,gBACP,eAAe;AAAA,gBACf,eAAe;AAAA,kBACb,QAAQ;AAAA,oBACN,gBAAgB;AAAA,kBAClB;AAAA,kBACA,SAAS;AAAA,oBACP;AAAA,sBACE,MAAM;AAAA,sBACN,eAAe,SAAS,QAAQ;AAElB,oCAAA;AAAA,sBAAA;AAAA,oBACd;AAAA,kBACF;AAAA,gBAEJ;AAAA,gBACA,iBAAiB;AAAA,kBACf,SAAS,CAAC,cAAc;AAAA,gBAAA;AAAA,cAC1B;AAAA,YACF;AAAA,UAEJ;AAAA,UACA,SAAS;AAAA,YACP,YAAY;AAAA,cACV;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,YAAA;AAAA,UAEJ;AAAA;AAAA,UAEA,QAAQ;AAAA,YACN,GAAG,gBAAgB,mBAAmB,YAAY,OAAO,IAAI;AAAA,YAC7D,GAAG,gBAAgB,mBAAmB,YAAY,OAAO,IAAI;AAAA,YAC7D,GAAG,gBAAgB,oBAAoB,mBAAmB,WAAW,CAAC;AAAA;AAAA,YACtE,GAAG,gBAAgB,sBAAsB,YAAY,UAAU,IAAI;AAAA,YACnE,GAAG,gBAAgB,yBAAyB,oBAAoB;AAAA,UAAA;AAAA,QAEpE;AAAA,MAAA;AAAA,IAEJ;AAAA;AAAA,IAEA,4BAA4B,KAAK,WAAW;AAAA,MAC1C,QAAQ,EAAE,SAAS,uBAAuB,OAAO;AAAA,MACjD,QAAQ,EAAE,SAAS,uBAAuB,OAAO;AAAA,IAAA,CAClD;AAAA,IACD,0BAA0B;AAAA;AAAA;AAAA,MAGxB,yBAAyB;AAAA,MACzB,wBACE;AAAA,MACF,QAAQ;AAAA,QACN,gBAAgB,MACd,8CAA8C,KAAK,SAAS;AAAA,QAC9D,UAAU,CAAC,MACT,oBAAoB,EAAE,UAAU,OAAO,YAAY,UAAU,IAAI;AAAA,QACnE,SAAS,uBAAuB;AAAA,MAClC;AAAA,MACA,QAAQ;AAAA,QACN,gBAAgB,MACd,8CAA8C,KAAK,SAAS;AAAA,QAC9D,UAAU,CAAC,MACT,oBAAoB,EAAE,UAAU,OAAO,YAAY,UAAU,IAAI,MAAM,EAAE,EAAE;AAAA,QAC7E,SAAS,uBAAuB;AAAA,MAClC;AAAA,MACA,UAAU,CAAC,OAAO;AAChB,cAAM,YAAa,WAAmB,cAAc,aAClD,uBAAuB,MACzB;AACA,YAAI,CAAC,WAAW;AACR,gBAAA,IAAI,MAAM,sCAAsC;AAAA,QAAA;AAExD,eAAO,UAAU,OAAO,OAAO,GAAG,iBAAiB;AAAA,MAAA;AAAA,IACrD,CACD;AAAA,IACD,oBAAoB,WAAW;AAAA,IAC/B,YAAY,aAAa,MAAM,SAAS;AAAA,IACxC,8BAA8B;AAAA,MAC5B,GAAG,YAAY;AAAA,MACf,QAAQ,KAAK;AAAA,IACd,CAAA;AAAA,EACH;AACF;AAEA,SAAS,gBACP,KACA,OACsE;AAC/D,SAAA;AAAA,IACL,CAAC,eAAe,GAAG,EAAE,GAAG,KAAK,UAAU,KAAK;AAAA,IAC5C,CAAC,mBAAmB,GAAG,EAAE,GAAG,KAAK,UAAU,KAAK;AAAA,EAClD;AACF;"}
+{"version":3,"file":"plugin.js","sources":["../../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { createNitro } from 'nitropack'\nimport { trimPathRight } from '@tanstack/router-core'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { TanStackServerFnPluginEnv } from '@tanstack/server-functions-plugin'\nimport * as vite from 'vite'\nimport { createTanStackConfig } from './schema'\nimport { nitroPlugin } from './nitro-plugin/plugin'\nimport { startManifestPlugin } from './start-manifest-plugin/plugin'\nimport { startCompilerPlugin } from './start-compiler-plugin'\nimport {\n  CLIENT_DIST_DIR,\n  SSR_ENTRY_FILE,\n  VITE_ENVIRONMENT_NAMES,\n} from './constants'\nimport { tanStackStartRouter } from './start-router-plugin/plugin'\nimport { loadEnvPlugin } from './load-env-plugin/plugin'\nimport { devServerPlugin } from './dev-server-plugin/plugin'\nimport { resolveVirtualEntriesPlugin } from './resolve-virtual-entries-plugin/plugin'\nimport type { createTanStackStartOptionsSchema } from './schema'\nimport type { PluginOption, Rollup } from 'vite'\nimport type { z } from 'zod'\nimport type { CompileStartFrameworkOptions } from './compilers'\n\nexport type TanStackStartInputConfig = z.input<\n  ReturnType<typeof createTanStackStartOptionsSchema>\n>\n\nconst defaultConfig = createTanStackConfig()\nexport function getTanStackStartOptions(opts?: TanStackStartInputConfig) {\n  return defaultConfig.parse(opts)\n}\n\nexport type TanStackStartOutputConfig = ReturnType<\n  typeof getTanStackStartOptions\n>\n\nexport interface TanStackStartVitePluginCoreOptions {\n  framework: CompileStartFrameworkOptions\n  getVirtualServerRootHandler: (ctx: {\n    routerFilepath: string\n    serverEntryFilepath: string\n  }) => string\n  getVirtualServerEntry: (ctx: { routerFilepath: string }) => string\n  getVirtualClientEntry: (ctx: { routerFilepath: string }) => string\n}\n// this needs to live outside of the TanStackStartVitePluginCore since it will be invoked multiple times by vite\nlet ssrBundle: Rollup.OutputBundle\n\nexport function TanStackStartVitePluginCore(\n  opts: TanStackStartVitePluginCoreOptions,\n  startConfig: TanStackStartOutputConfig,\n): Array<PluginOption> {\n  return [\n    tanStackStartRouter({\n      ...startConfig.tsr,\n      target: opts.framework,\n      autoCodeSplitting: true,\n    }),\n    resolveVirtualEntriesPlugin(opts, startConfig),\n    {\n      name: 'tanstack-start-core:config-client',\n      async config(viteConfig) {\n        const viteAppBase = trimPathRight(viteConfig.base || '/')\n        globalThis.TSS_APP_BASE = viteAppBase\n\n        const nitroOutputPublicDir = await (async () => {\n          // Create a dummy nitro app to get the resolved public output path\n          const dummyNitroApp = await createNitro({\n            preset: startConfig.target,\n            compatibilityDate: '2024-12-01',\n          })\n\n          const nitroOutputPublicDir = dummyNitroApp.options.output.publicDir\n          await dummyNitroApp.close()\n\n          return nitroOutputPublicDir\n        })()\n\n        const getClientEntryPath = (startConfig: TanStackStartOutputConfig) => {\n          // when the user specifies a custom client entry path, we need to resolve it\n          // relative to the root of the project, keeping in mind that if not specified\n          // it will be /~start/default-client-entry which is a virtual path\n          // that is resolved by vite to the actual client entry path\n          const entry = startConfig.clientEntryPath.startsWith(\n            '/~start/default-client-entry',\n          )\n            ? startConfig.clientEntryPath\n            : vite.normalizePath(\n                path.join(\n                  '/@fs',\n                  path.resolve(startConfig.root, startConfig.clientEntryPath),\n                ),\n              )\n\n          return entry\n        }\n\n        return {\n          base: viteAppBase,\n          environments: {\n            [VITE_ENVIRONMENT_NAMES.client]: {\n              consumer: 'client',\n              build: {\n                manifest: true,\n                rollupOptions: {\n                  input: {\n                    main: getClientEntryPath(startConfig),\n                  },\n                  output: {\n                    dir: path.resolve(startConfig.root, CLIENT_DIST_DIR),\n                  },\n                  // TODO: this should be removed\n                  external: ['node:fs', 'node:path', 'node:os', 'node:crypto'],\n                },\n              },\n            },\n            [VITE_ENVIRONMENT_NAMES.server]: {\n              consumer: 'server',\n              build: {\n                ssr: true,\n                // we don't write to the file system as the below 'capture-output' plugin will\n                // capture the output and write it to the virtual file system\n                write: false,\n                copyPublicDir: false,\n                rollupOptions: {\n                  output: {\n                    entryFileNames: SSR_ENTRY_FILE,\n                  },\n                  plugins: [\n                    {\n                      name: 'capture-output',\n                      generateBundle(_options, bundle) {\n                        // TODO: can this hook be called more than once?\n                        ssrBundle = bundle\n                      },\n                    },\n                  ],\n                },\n                commonjsOptions: {\n                  include: [/node_modules/],\n                },\n              },\n            },\n          },\n          resolve: {\n            noExternal: [\n              '@tanstack/start-client',\n              '@tanstack/start-client-core',\n              '@tanstack/start-server',\n              '@tanstack/start-server-core',\n              '@tanstack/start-server-functions-fetcher',\n              '@tanstack/start-server-functions-client',\n              '@tanstack/start-server-functions-server',\n              '@tanstack/start-router-manifest',\n              '@tanstack/start-config',\n              '@tanstack/server-functions-plugin',\n              'nitropack',\n              '@tanstack/**start**',\n              ...Object.values(VIRTUAL_MODULES),\n            ],\n          },\n          optimizeDeps: {\n            exclude: [...Object.values(VIRTUAL_MODULES)],\n          },\n          /* prettier-ignore */\n          define: {\n            // define is an esbuild function that replaces the any instances of given keys with the given values\n            // i.e: __FRAMEWORK_NAME__ can be replaced with JSON.stringify(\"TanStack Start\")\n            // This is not the same as injecting environment variables.\n\n            ...defineReplaceEnv('TSS_CLIENT_ENTRY', getClientEntryPath(startConfig)), // This is consumed by the router-manifest, where the entry point is imported after the dev refresh runtime is resolved\n            ...defineReplaceEnv('TSS_SERVER_FN_BASE', startConfig.serverFns.base),\n            ...defineReplaceEnv('TSS_OUTPUT_PUBLIC_DIR', nitroOutputPublicDir),\n            ...defineReplaceEnv('TSS_APP_BASE', viteAppBase)\n          },\n        }\n      },\n    },\n    // N.B. TanStackStartCompilerPlugin must be before the TanStackServerFnPluginEnv\n    startCompilerPlugin(opts.framework, {\n      client: { envName: VITE_ENVIRONMENT_NAMES.client },\n      server: { envName: VITE_ENVIRONMENT_NAMES.server },\n    }),\n    TanStackServerFnPluginEnv({\n      // This is the ID that will be available to look up and import\n      // our server function manifest and resolve its module\n      manifestVirtualImportId: VIRTUAL_MODULES.serverFnManifest,\n      manifestOutputFilename: path.join(\n        '.tanstack',\n        'start',\n        'build',\n        'server',\n        'server-functions-manifest.json',\n      ),\n      client: {\n        getRuntimeCode: () =>\n          `import { createClientRpc } from '@tanstack/${opts.framework}-start/server-functions-client'`,\n        replacer: (d) =>\n          `createClientRpc('${d.functionId}', '${startConfig.serverFns.base}')`,\n        envName: VITE_ENVIRONMENT_NAMES.client,\n      },\n      server: {\n        getRuntimeCode: () =>\n          `import { createServerRpc } from '@tanstack/${opts.framework}-start/server-functions-server'`,\n        replacer: (d) =>\n          `createServerRpc('${d.functionId}', '${startConfig.serverFns.base}', ${d.fn})`,\n        envName: VITE_ENVIRONMENT_NAMES.server,\n      },\n      importer: (fn) => {\n        const serverEnv = (globalThis as any).viteDevServer.environments[\n          VITE_ENVIRONMENT_NAMES.server\n        ]\n        if (!serverEnv) {\n          throw new Error(`'ssr' vite dev environment not found`)\n        }\n        return serverEnv.runner.import(fn.extractedFilename)\n      },\n    }),\n    loadEnvPlugin(startConfig),\n    startManifestPlugin(startConfig),\n    devServerPlugin(),\n    nitroPlugin(startConfig, () => ssrBundle),\n  ]\n}\n\nfunction defineReplaceEnv<TKey extends string, TValue extends string>(\n  key: TKey,\n  value: TValue,\n): { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } {\n  return {\n    [`process.env.${key}`]: JSON.stringify(value),\n    [`import.meta.env.${key}`]: JSON.stringify(value),\n  } as { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue }\n}\n"],"names":["nitroOutputPublicDir","startConfig"],"mappings":"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"}

package/dist/esm/resolve-virtual-entries-plugin/plugin.d.ts

@@ -0,0 +1,3 @@
+import { TanStackStartOutputConfig, TanStackStartVitePluginCoreOptions } from '../plugin.js';
+import * as vite from 'vite';
+export declare function resolveVirtualEntriesPlugin(opts: TanStackStartVitePluginCoreOptions, startConfig: TanStackStartOutputConfig): vite.Plugin;

package/dist/esm/resolve-virtual-entries-plugin/plugin.js

@@ -0,0 +1,49 @@
+import path from "node:path";
+import * as vite from "vite";
+function resolveVirtualEntriesPlugin(opts, startConfig) {
+  let resolvedConfig;
+  const modules = /* @__PURE__ */ new Set([
+    "/~start/server-entry",
+    "/~start/default-server-entry",
+    "/~start/default-client-entry"
+  ]);
+  return {
+    name: "tanstack-start-core:resolve-virtual-entries",
+    configResolved(config) {
+      resolvedConfig = config;
+    },
+    resolveId(id) {
+      if (modules.has(id)) {
+        return `${id}.tsx`;
+      }
+      return void 0;
+    },
+    load(id) {
+      const routerFilepath = vite.normalizePath(
+        path.resolve(startConfig.root, startConfig.tsr.srcDirectory, "router")
+      );
+      if (id === "/~start/server-entry.tsx") {
+        const ssrEntryFilepath = startConfig.serverEntryPath.startsWith(
+          "/~start/default-server-entry"
+        ) ? startConfig.serverEntryPath : vite.normalizePath(
+          path.resolve(resolvedConfig.root, startConfig.serverEntryPath)
+        );
+        return opts.getVirtualServerRootHandler({
+          routerFilepath,
+          serverEntryFilepath: ssrEntryFilepath
+        });
+      }
+      if (id === "/~start/default-client-entry.tsx") {
+        return opts.getVirtualClientEntry({ routerFilepath });
+      }
+      if (id === "/~start/default-server-entry.tsx") {
+        return opts.getVirtualServerEntry({ routerFilepath });
+      }
+      return void 0;
+    }
+  };
+}
+export {
+  resolveVirtualEntriesPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/esm/resolve-virtual-entries-plugin/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["../../../src/resolve-virtual-entries-plugin/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport * as vite from 'vite'\nimport type {\n  TanStackStartOutputConfig,\n  TanStackStartVitePluginCoreOptions,\n} from '../plugin'\n\nexport function resolveVirtualEntriesPlugin(\n  opts: TanStackStartVitePluginCoreOptions,\n  startConfig: TanStackStartOutputConfig,\n): vite.Plugin {\n  let resolvedConfig: vite.ResolvedConfig\n\n  const modules = new Set<string>([\n    '/~start/server-entry',\n    '/~start/default-server-entry',\n    '/~start/default-client-entry',\n  ])\n\n  return {\n    name: 'tanstack-start-core:resolve-virtual-entries',\n    configResolved(config) {\n      resolvedConfig = config\n    },\n    resolveId(id) {\n      if (modules.has(id)) {\n        return `${id}.tsx`\n      }\n\n      return undefined\n    },\n    load(id) {\n      const routerFilepath = vite.normalizePath(\n        path.resolve(startConfig.root, startConfig.tsr.srcDirectory, 'router'),\n      )\n\n      if (id === '/~start/server-entry.tsx') {\n        const ssrEntryFilepath = startConfig.serverEntryPath.startsWith(\n          '/~start/default-server-entry',\n        )\n          ? startConfig.serverEntryPath\n          : vite.normalizePath(\n              path.resolve(resolvedConfig.root, startConfig.serverEntryPath),\n            )\n\n        return opts.getVirtualServerRootHandler({\n          routerFilepath,\n          serverEntryFilepath: ssrEntryFilepath,\n        })\n      }\n\n      if (id === '/~start/default-client-entry.tsx') {\n        return opts.getVirtualClientEntry({ routerFilepath })\n      }\n\n      if (id === '/~start/default-server-entry.tsx') {\n        return opts.getVirtualServerEntry({ routerFilepath })\n      }\n\n      return undefined\n    },\n  }\n}\n"],"names":[],"mappings":";;AAOgB,SAAA,4BACd,MACA,aACa;AACT,MAAA;AAEE,QAAA,8BAAc,IAAY;AAAA,IAC9B;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AAEM,SAAA;AAAA,IACL,MAAM;AAAA,IACN,eAAe,QAAQ;AACJ,uBAAA;AAAA,IACnB;AAAA,IACA,UAAU,IAAI;AACR,UAAA,QAAQ,IAAI,EAAE,GAAG;AACnB,eAAO,GAAG,EAAE;AAAA,MAAA;AAGP,aAAA;AAAA,IACT;AAAA,IACA,KAAK,IAAI;AACP,YAAM,iBAAiB,KAAK;AAAA,QAC1B,KAAK,QAAQ,YAAY,MAAM,YAAY,IAAI,cAAc,QAAQ;AAAA,MACvE;AAEA,UAAI,OAAO,4BAA4B;AAC/B,cAAA,mBAAmB,YAAY,gBAAgB;AAAA,UACnD;AAAA,QAAA,IAEE,YAAY,kBACZ,KAAK;AAAA,UACH,KAAK,QAAQ,eAAe,MAAM,YAAY,eAAe;AAAA,QAC/D;AAEJ,eAAO,KAAK,4BAA4B;AAAA,UACtC;AAAA,UACA,qBAAqB;AAAA,QAAA,CACtB;AAAA,MAAA;AAGH,UAAI,OAAO,oCAAoC;AAC7C,eAAO,KAAK,sBAAsB,EAAE,gBAAgB;AAAA,MAAA;AAGtD,UAAI,OAAO,oCAAoC;AAC7C,eAAO,KAAK,sBAAsB,EAAE,gBAAgB;AAAA,MAAA;AAG/C,aAAA;AAAA,IAAA;AAAA,EAEX;AACF;"}

package/dist/esm/schema.d.ts

@@ -19,7 +19,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             verboseFileRoutes: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             addExtensions: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-            disableManifestGeneration: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             enableRouteTreeFormatting: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             routeTreeFileFooter: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>>;
             customScaffolding: z.ZodOptional<z.ZodOptional<z.ZodObject<{
@@ -39,6 +38,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             }, {
                 enableCodeSplitting?: boolean | undefined;
             }>>>;
+            plugins: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodType<import('@tanstack/router-generator').GeneratorPlugin, z.ZodTypeDef, import('@tanstack/router-generator').GeneratorPlugin>, "many">>>;
+            tmpDir: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodString>>>;
         }, {
             srcDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }>, "strip", z.ZodTypeAny, {
@@ -60,7 +61,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -70,6 +70,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
         }, {
             target?: "react" | "solid" | undefined;
             virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -88,7 +90,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -98,6 +99,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
             srcDirectory?: string | undefined;
         }>>>;
         client: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -2140,7 +2143,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -2150,6 +2152,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
         };
         client: {
             base: string;
@@ -2513,7 +2517,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -2523,6 +2526,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
             srcDirectory?: string | undefined;
         } | undefined;
         client?: {
@@ -2671,7 +2676,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             verboseFileRoutes: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
             addExtensions: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-            disableManifestGeneration: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             enableRouteTreeFormatting: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             routeTreeFileFooter: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>>;
             customScaffolding: z.ZodOptional<z.ZodOptional<z.ZodObject<{
@@ -2691,6 +2695,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             }, {
                 enableCodeSplitting?: boolean | undefined;
             }>>>;
+            plugins: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodType<import('@tanstack/router-generator').GeneratorPlugin, z.ZodTypeDef, import('@tanstack/router-generator').GeneratorPlugin>, "many">>>;
+            tmpDir: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodString>>>;
         }, {
             srcDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }>, "strip", z.ZodTypeAny, {
@@ -2712,7 +2718,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -2722,6 +2727,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
         }, {
             target?: "react" | "solid" | undefined;
             virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -2740,7 +2747,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -2750,6 +2756,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
             srcDirectory?: string | undefined;
         }>>>;
         client: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -4792,7 +4800,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -4802,6 +4809,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
         };
         client: {
             base: string;
@@ -5165,7 +5174,6 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             disableTypes?: boolean | undefined;
             verboseFileRoutes?: boolean | undefined;
             addExtensions?: boolean | undefined;
-            disableManifestGeneration?: boolean | undefined;
             enableRouteTreeFormatting?: boolean | undefined;
             routeTreeFileFooter?: string[] | undefined;
             customScaffolding?: {
@@ -5175,6 +5183,8 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+            tmpDir?: string | undefined;
             srcDirectory?: string | undefined;
         } | undefined;
         client?: {
@@ -5317,9 +5327,9 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             generatedRouteTree: string;
             disableTypes: boolean;
             addExtensions: boolean;
-            disableManifestGeneration: boolean;
             enableRouteTreeFormatting: boolean;
             routeTreeFileFooter: string[];
+            tmpDir: string;
             virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
             routeFilePrefix?: string | undefined;
             routeFileIgnorePattern?: string | undefined;
@@ -5333,6 +5343,7 @@ export declare function createTanStackConfig<TFrameworkPlugin extends Record<str
             experimental?: {
                 enableCodeSplitting?: boolean | undefined;
             } | undefined;
+            plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
             srcDirectory: string;
         };
         clientEntryPath: string;
@@ -5593,7 +5604,6 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         disableTypes: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         verboseFileRoutes: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         addExtensions: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-        disableManifestGeneration: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         enableRouteTreeFormatting: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         routeTreeFileFooter: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>>;
         customScaffolding: z.ZodOptional<z.ZodOptional<z.ZodObject<{
@@ -5613,6 +5623,8 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         }, {
             enableCodeSplitting?: boolean | undefined;
         }>>>;
+        plugins: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodType<import('@tanstack/router-generator').GeneratorPlugin, z.ZodTypeDef, import('@tanstack/router-generator').GeneratorPlugin>, "many">>>;
+        tmpDir: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodString>>>;
     }, {
         srcDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     }>, "strip", z.ZodTypeAny, {
@@ -5634,7 +5646,6 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         disableTypes?: boolean | undefined;
         verboseFileRoutes?: boolean | undefined;
         addExtensions?: boolean | undefined;
-        disableManifestGeneration?: boolean | undefined;
         enableRouteTreeFormatting?: boolean | undefined;
         routeTreeFileFooter?: string[] | undefined;
         customScaffolding?: {
@@ -5644,6 +5655,8 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         experimental?: {
             enableCodeSplitting?: boolean | undefined;
         } | undefined;
+        plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+        tmpDir?: string | undefined;
     }, {
         target?: "react" | "solid" | undefined;
         virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -5662,7 +5675,6 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         disableTypes?: boolean | undefined;
         verboseFileRoutes?: boolean | undefined;
         addExtensions?: boolean | undefined;
-        disableManifestGeneration?: boolean | undefined;
         enableRouteTreeFormatting?: boolean | undefined;
         routeTreeFileFooter?: string[] | undefined;
         customScaffolding?: {
@@ -5672,6 +5684,8 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         experimental?: {
             enableCodeSplitting?: boolean | undefined;
         } | undefined;
+        plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+        tmpDir?: string | undefined;
         srcDirectory?: string | undefined;
     }>>>;
     client: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -7714,7 +7728,6 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         disableTypes?: boolean | undefined;
         verboseFileRoutes?: boolean | undefined;
         addExtensions?: boolean | undefined;
-        disableManifestGeneration?: boolean | undefined;
         enableRouteTreeFormatting?: boolean | undefined;
         routeTreeFileFooter?: string[] | undefined;
         customScaffolding?: {
@@ -7724,6 +7737,8 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         experimental?: {
             enableCodeSplitting?: boolean | undefined;
         } | undefined;
+        plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+        tmpDir?: string | undefined;
     };
     client: {
         base: string;
@@ -8087,7 +8102,6 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         disableTypes?: boolean | undefined;
         verboseFileRoutes?: boolean | undefined;
         addExtensions?: boolean | undefined;
-        disableManifestGeneration?: boolean | undefined;
         enableRouteTreeFormatting?: boolean | undefined;
         routeTreeFileFooter?: string[] | undefined;
         customScaffolding?: {
@@ -8097,6 +8111,8 @@ export declare function createTanStackStartOptionsSchema(frameworkPlugin?: Recor
         experimental?: {
             enableCodeSplitting?: boolean | undefined;
         } | undefined;
+        plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
+        tmpDir?: string | undefined;
         srcDirectory?: string | undefined;
     } | undefined;
     client?: {

package/dist/esm/start-compiler-plugin.d.ts

@@ -3,7 +3,7 @@ import { CompileStartFrameworkOptions } from './compilers.js';
 export type TanStackStartViteOptions = {
     globalMiddlewareEntry: string;
 };
-export declare function TanStackStartCompilerPlugin(framework: CompileStartFrameworkOptions, inputOpts?: {
+export declare function startCompilerPlugin(framework: CompileStartFrameworkOptions, inputOpts?: {
     client?: {
         envName?: string;
     };

package/dist/esm/start-compiler-plugin.js

@@ -8,10 +8,11 @@ const transformFuncs = [
   "serverOnly",
   "clientOnly",
   "createIsomorphicFn",
-  "createServerFileRoute"
+  "createServerFileRoute",
+  "createServerRootRoute"
 ];
 const tokenRegex = new RegExp(transformFuncs.join("|"));
-function TanStackStartCompilerPlugin(framework, inputOpts) {
+function startCompilerPlugin(framework, inputOpts) {
   const opts = {
     client: {
       envName: "client",
@@ -28,18 +29,23 @@ function TanStackStartCompilerPlugin(framework, inputOpts) {
     applyToEnvironment(env) {
       return [opts.client.envName, opts.server.envName].includes(env.name);
     },
-    transform(code, id) {
-      const env = this.environment.name === opts.client.envName ? "client" : this.environment.name === opts.server.envName ? "server" : (() => {
-        throw new Error(
-          `Environment ${this.environment.name} not configured`
-        );
-      })();
-      return transformCode({
-        code,
-        id,
-        env,
-        framework
-      });
+    transform: {
+      filter: {
+        code: tokenRegex
+      },
+      handler(code, id) {
+        const env = this.environment.name === opts.client.envName ? "client" : this.environment.name === opts.server.envName ? "server" : (() => {
+          throw new Error(
+            `Environment ${this.environment.name} not configured`
+          );
+        })();
+        return transformCode({
+          code,
+          id,
+          env,
+          framework
+        });
+      }
     }
   };
 }
@@ -49,10 +55,6 @@ function transformCode(opts) {
   const url = pathToFileURL(id);
   url.searchParams.delete("v");
   id = fileURLToPath(url).replace(/\\/g, "/");
-  const includesToken = tokenRegex.test(code);
-  if (!includesToken) {
-    return null;
-  }
   if (debug) console.info(`${env} Compiling Start: `, id);
   const compileStartOutput = compileStartOutputFactory(framework);
   const compiled = compileStartOutput({
@@ -67,6 +69,6 @@ function transformCode(opts) {
   return compiled;
 }
 export {
-  TanStackStartCompilerPlugin
+  startCompilerPlugin
 };
 //# sourceMappingURL=start-compiler-plugin.js.map