@tanstack/start-plugin-core 1.121.0-alpha.2 → 1.121.0-alpha.21

package/dist/esm/plugin.js

@@ -1,18 +1,19 @@
 import path from "node:path";
 import { createNitro } from "nitropack";
+import { trimPathRight } from "@tanstack/router-core";
 import { tanstackRouter } from "@tanstack/router-plugin/vite";
 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 { createTanStackConfig } from "./schema.js";
+import { nitroPlugin } from "./nitro-plugin/plugin.js";
+import { startRoutesManifestPlugin } from "./start-routes-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 { TanStackStartServerRoutesVite } from "./start-server-routes-plugin/plugin.js";
-createTanStackStartOptionsSchema();
+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 [
@@ -23,9 +24,12 @@ function TanStackStartVitePluginCore(opts, startConfig) {
       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 +43,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 +62,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 +79,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,33 +108,36 @@ function TanStackStartVitePluginCore(opts, startConfig) {
               "@tanstack/start-router-manifest",
               "@tanstack/start-config",
               "@tanstack/server-functions-plugin",
-              "tanstack:start-manifest",
-              "tanstack:server-fn-manifest",
+              "tanstack-start-router-manifest:v",
+              "tanstack-start-server-fn-manifest:v",
               "nitropack",
               "@tanstack/**"
             ]
           },
           /* 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:server-fn-manifest",
+      manifestVirtualImportId: "tanstack-start-server-fn-manifest:v",
+      manifestOutputFilename: ".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}')`,
@@ -145,7 +156,9 @@ function TanStackStartVitePluginCore(opts, startConfig) {
         return serverEnv.runner.import(fn.extractedFilename);
       }
     }),
-    startManifestPlugin(startConfig),
+    loadEnvPlugin(startConfig),
+    startRoutesManifestPlugin(startConfig),
+    devServerPlugin(),
     nitroPlugin(startConfig, () => ssrBundle),
     TanStackStartServerRoutesVite({
       ...startConfig.tsr,
@@ -153,15 +166,13 @@ function TanStackStartVitePluginCore(opts, startConfig) {
     })
   ];
 }
-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-manifest',\n              'tanstack:server-fn-manifest',\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:server-fn-manifest',\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,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 { tanstackRouter } from '@tanstack/router-plugin/vite'\nimport { TanStackServerFnPluginEnv } from '@tanstack/server-functions-plugin'\nimport * as vite from 'vite'\nimport { createTanStackConfig } from './schema'\nimport { nitroPlugin } from './nitro-plugin/plugin'\nimport { startRoutesManifestPlugin } from './start-routes-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 { TanStackStartServerRoutesVite } from './start-server-routes-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\ndeclare global {\n  // eslint-disable-next-line no-var\n  var TSS_APP_BASE: string\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    tanstackRouter({\n      verboseFileRoutes: false,\n      ...startConfig.tsr,\n      target: opts.framework,\n      enableRouteGeneration: true,\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              'tanstack-start-router-manifest:v',\n              'tanstack-start-server-fn-manifest:v',\n              'nitropack',\n              '@tanstack/**',\n            ],\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: '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    loadEnvPlugin(startConfig),\n    startRoutesManifestPlugin(startConfig),\n    devServerPlugin(),\n    nitroPlugin(startConfig, () => ssrBundle),\n    TanStackStartServerRoutesVite({\n      ...startConfig.tsr,\n      target: opts.framework,\n    }),\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;"}