@tanstack/start-plugin-core 1.160.2 → 1.161.1

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

@@ -1,6 +1,6 @@
 import { tanstackRouterGenerator, tanStackRouterCodeSplitter, tanstackRouterAutoImport } from "@tanstack/router-plugin/vite";
 import { normalizePath } from "vite";
-import path from "pathe";
+import path__default from "pathe";
 import { VITE_ENVIRONMENT_NAMES } from "../constants.js";
 import { routesManifestPlugin } from "./generator-plugins/routes-manifest-plugin.js";
 import { prerenderRoutesPlugin } from "./generator-plugins/prerender-routes-plugin.js";
@@ -19,14 +19,14 @@ function moduleDeclaration({
   generatedRouteTreePath
 }) {
   function getImportPath(absolutePath) {
-    let relativePath = path.relative(
-      path.dirname(generatedRouteTreePath),
+    let relativePath = path__default.relative(
+      path__default.dirname(generatedRouteTreePath),
       absolutePath
     );
     if (!relativePath.startsWith(".")) {
       relativePath = "./" + relativePath;
     }
-    relativePath = relativePath.split(path.sep).join("/");
+    relativePath = relativePath.split(path__default.sep).join("/");
     return relativePath;
   }
   const result = [
@@ -59,7 +59,7 @@ function moduleDeclaration({
 function tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts) {
   const getGeneratedRouteTreePath = () => {
     const { startConfig } = getConfig();
-    return path.resolve(startConfig.router.generatedRouteTree);
+    return path__default.resolve(startConfig.router.generatedRouteTree);
   };
   let clientEnvironment = null;
   function invalidate() {

package/dist/esm/start-router-plugin/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["../../../src/start-router-plugin/plugin.ts"],"sourcesContent":["import {\n  tanStackRouterCodeSplitter,\n  tanstackRouterAutoImport,\n  tanstackRouterGenerator,\n} from '@tanstack/router-plugin/vite'\nimport { normalizePath } from 'vite'\nimport path from 'pathe'\nimport { VITE_ENVIRONMENT_NAMES } from '../constants'\nimport { routesManifestPlugin } from './generator-plugins/routes-manifest-plugin'\nimport { prerenderRoutesPlugin } from './generator-plugins/prerender-routes-plugin'\nimport { pruneServerOnlySubtrees } from './pruneServerOnlySubtrees'\nimport { SERVER_PROP } from './constants'\nimport type { GetConfigFn, TanStackStartVitePluginCoreOptions } from '../types'\nimport type {\n  Generator,\n  GeneratorPlugin,\n  RouteNode,\n} from '@tanstack/router-generator'\nimport type { DevEnvironment, Plugin, PluginOption } from 'vite'\nimport type { TanStackStartInputConfig } from '../schema'\n\nfunction isServerOnlyNode(node: RouteNode | undefined) {\n  if (!node?.createFileRouteProps) {\n    return false\n  }\n  return (\n    node.createFileRouteProps.has(SERVER_PROP) &&\n    node.createFileRouteProps.size === 1\n  )\n}\n\nfunction moduleDeclaration({\n  startFilePath,\n  routerFilePath,\n  corePluginOpts,\n  generatedRouteTreePath,\n}: {\n  startFilePath: string | undefined\n  routerFilePath: string\n  corePluginOpts: TanStackStartVitePluginCoreOptions\n  generatedRouteTreePath: string\n}): string {\n  function getImportPath(absolutePath: string) {\n    let relativePath = path.relative(\n      path.dirname(generatedRouteTreePath),\n      absolutePath,\n    )\n\n    if (!relativePath.startsWith('.')) {\n      relativePath = './' + relativePath\n    }\n\n    // convert to POSIX-style for ESM imports (important on Windows)\n    relativePath = relativePath.split(path.sep).join('/')\n    return relativePath\n  }\n\n  const result: Array<string> = [\n    `import type { getRouter } from '${getImportPath(routerFilePath)}'`,\n  ]\n  if (startFilePath) {\n    result.push(\n      `import type { startInstance } from '${getImportPath(startFilePath)}'`,\n    )\n  }\n  // make sure we import something from start to get the server route declaration merge\n  else {\n    result.push(\n      `import type { createStart } from '@tanstack/${corePluginOpts.framework}-start'`,\n    )\n  }\n  result.push(\n    `declare module '@tanstack/${corePluginOpts.framework}-start' {\n  interface Register {\n    ssr: true\n    router: Awaited<ReturnType<typeof getRouter>>`,\n  )\n  if (startFilePath) {\n    result.push(\n      `    config: Awaited<ReturnType<typeof startInstance.getOptions>>`,\n    )\n  }\n  result.push(`  }\n}`)\n\n  return result.join('\\n')\n}\n\nexport function tanStackStartRouter(\n  startPluginOpts: TanStackStartInputConfig,\n  getConfig: GetConfigFn,\n  corePluginOpts: TanStackStartVitePluginCoreOptions,\n): Array<PluginOption> {\n  const getGeneratedRouteTreePath = () => {\n    const { startConfig } = getConfig()\n    return path.resolve(startConfig.router.generatedRouteTree)\n  }\n\n  let clientEnvironment: DevEnvironment | null = null\n  function invalidate() {\n    if (!clientEnvironment) {\n      return\n    }\n\n    const mod = clientEnvironment.moduleGraph.getModuleById(\n      getGeneratedRouteTreePath(),\n    )\n    if (mod) {\n      clientEnvironment.moduleGraph.invalidateModule(mod)\n    }\n    clientEnvironment.hot.send({ type: 'full-reload', path: '*' })\n  }\n\n  let generatorInstance: Generator | null = null\n\n  const clientTreeGeneratorPlugin: GeneratorPlugin = {\n    name: 'start-client-tree-plugin',\n    init({ generator }) {\n      generatorInstance = generator\n    },\n    afterTransform({ node, prevNode }) {\n      if (isServerOnlyNode(node) !== isServerOnlyNode(prevNode)) {\n        invalidate()\n      }\n    },\n  }\n\n  let routeTreeFileFooter: Array<string> | null = null\n\n  function getRouteTreeFileFooter() {\n    if (routeTreeFileFooter) {\n      return routeTreeFileFooter\n    }\n    const { startConfig, resolvedStartConfig } = getConfig()\n    const ogRouteTreeFileFooter = startConfig.router.routeTreeFileFooter\n    if (ogRouteTreeFileFooter) {\n      if (Array.isArray(ogRouteTreeFileFooter)) {\n        routeTreeFileFooter = ogRouteTreeFileFooter\n      } else {\n        routeTreeFileFooter = ogRouteTreeFileFooter()\n      }\n    }\n    routeTreeFileFooter = [\n      moduleDeclaration({\n        generatedRouteTreePath: getGeneratedRouteTreePath(),\n        corePluginOpts,\n        startFilePath: resolvedStartConfig.startFilePath,\n        routerFilePath: resolvedStartConfig.routerFilePath,\n      }),\n      ...(routeTreeFileFooter ?? []),\n    ]\n    return routeTreeFileFooter\n  }\n\n  let resolvedGeneratedRouteTreePath: string | null = null\n  const clientTreePlugin: Plugin = {\n    name: 'tanstack-start:route-tree-client-plugin',\n    enforce: 'pre',\n    applyToEnvironment: (env) => env.name === VITE_ENVIRONMENT_NAMES.client,\n    configureServer(server) {\n      clientEnvironment = server.environments[VITE_ENVIRONMENT_NAMES.client]\n    },\n    config() {\n      type LoadObjectHook = Extract<\n        typeof clientTreePlugin.load,\n        { filter?: unknown }\n      >\n      resolvedGeneratedRouteTreePath = normalizePath(\n        getGeneratedRouteTreePath(),\n      )\n      ;(clientTreePlugin.load as LoadObjectHook).filter = {\n        id: { include: new RegExp(resolvedGeneratedRouteTreePath) },\n      }\n    },\n\n    load: {\n      filter: {\n        // this will be set in the config hook above since it relies on `config` hook being called first\n      },\n      async handler() {\n        if (!generatorInstance) {\n          throw new Error('Generator instance not initialized')\n        }\n        const crawlingResult = await generatorInstance.getCrawlingResult()\n        if (!crawlingResult) {\n          throw new Error('Crawling result not available')\n        }\n        const prunedAcc = pruneServerOnlySubtrees(crawlingResult)\n        const acc = {\n          ...crawlingResult.acc,\n          ...prunedAcc,\n        }\n        const buildResult = generatorInstance.buildRouteTree({\n          ...crawlingResult,\n          acc,\n          config: {\n            // importRoutesUsingAbsolutePaths: true,\n            // addExtensions: true,\n            disableTypes: true,\n            enableRouteTreeFormatting: false,\n            routeTreeFileHeader: [],\n            routeTreeFileFooter: [],\n          },\n        })\n        return { code: buildResult.routeTreeContent, map: null }\n      },\n    },\n  }\n  return [\n    clientTreePlugin,\n    tanstackRouterGenerator(() => {\n      const routerConfig = getConfig().startConfig.router\n      const plugins = [clientTreeGeneratorPlugin, routesManifestPlugin()]\n      if (startPluginOpts?.prerender?.enabled === true) {\n        plugins.push(prerenderRoutesPlugin())\n      }\n      return {\n        ...routerConfig,\n        target: corePluginOpts.framework,\n        routeTreeFileFooter: getRouteTreeFileFooter,\n        plugins,\n      }\n    }),\n    tanStackRouterCodeSplitter(() => {\n      const routerConfig = getConfig().startConfig.router\n      return {\n        ...routerConfig,\n        codeSplittingOptions: {\n          ...routerConfig.codeSplittingOptions,\n          deleteNodes: ['ssr', 'server', 'headers'],\n          addHmr: true,\n        },\n        plugin: {\n          vite: { environmentName: VITE_ENVIRONMENT_NAMES.client },\n        },\n      }\n    }),\n    tanStackRouterCodeSplitter(() => {\n      const routerConfig = getConfig().startConfig.router\n      return {\n        ...routerConfig,\n        codeSplittingOptions: {\n          ...routerConfig.codeSplittingOptions,\n          addHmr: false,\n        },\n        plugin: {\n          vite: { environmentName: VITE_ENVIRONMENT_NAMES.server },\n        },\n      }\n    }),\n    tanstackRouterAutoImport(startPluginOpts?.router),\n  ]\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.js","sources":["../../../src/start-router-plugin/plugin.ts"],"sourcesContent":["import {\n  tanStackRouterCodeSplitter,\n  tanstackRouterAutoImport,\n  tanstackRouterGenerator,\n} from '@tanstack/router-plugin/vite'\nimport { normalizePath } from 'vite'\nimport path from 'pathe'\nimport { VITE_ENVIRONMENT_NAMES } from '../constants'\nimport { routesManifestPlugin } from './generator-plugins/routes-manifest-plugin'\nimport { prerenderRoutesPlugin } from './generator-plugins/prerender-routes-plugin'\nimport { pruneServerOnlySubtrees } from './pruneServerOnlySubtrees'\nimport { SERVER_PROP } from './constants'\nimport type { GetConfigFn, TanStackStartVitePluginCoreOptions } from '../types'\nimport type {\n  Generator,\n  GeneratorPlugin,\n  RouteNode,\n} from '@tanstack/router-generator'\nimport type { DevEnvironment, Plugin, PluginOption } from 'vite'\nimport type { TanStackStartInputConfig } from '../schema'\n\nfunction isServerOnlyNode(node: RouteNode | undefined) {\n  if (!node?.createFileRouteProps) {\n    return false\n  }\n  return (\n    node.createFileRouteProps.has(SERVER_PROP) &&\n    node.createFileRouteProps.size === 1\n  )\n}\n\nfunction moduleDeclaration({\n  startFilePath,\n  routerFilePath,\n  corePluginOpts,\n  generatedRouteTreePath,\n}: {\n  startFilePath: string | undefined\n  routerFilePath: string\n  corePluginOpts: TanStackStartVitePluginCoreOptions\n  generatedRouteTreePath: string\n}): string {\n  function getImportPath(absolutePath: string) {\n    let relativePath = path.relative(\n      path.dirname(generatedRouteTreePath),\n      absolutePath,\n    )\n\n    if (!relativePath.startsWith('.')) {\n      relativePath = './' + relativePath\n    }\n\n    // convert to POSIX-style for ESM imports (important on Windows)\n    relativePath = relativePath.split(path.sep).join('/')\n    return relativePath\n  }\n\n  const result: Array<string> = [\n    `import type { getRouter } from '${getImportPath(routerFilePath)}'`,\n  ]\n  if (startFilePath) {\n    result.push(\n      `import type { startInstance } from '${getImportPath(startFilePath)}'`,\n    )\n  }\n  // make sure we import something from start to get the server route declaration merge\n  else {\n    result.push(\n      `import type { createStart } from '@tanstack/${corePluginOpts.framework}-start'`,\n    )\n  }\n  result.push(\n    `declare module '@tanstack/${corePluginOpts.framework}-start' {\n  interface Register {\n    ssr: true\n    router: Awaited<ReturnType<typeof getRouter>>`,\n  )\n  if (startFilePath) {\n    result.push(\n      `    config: Awaited<ReturnType<typeof startInstance.getOptions>>`,\n    )\n  }\n  result.push(`  }\n}`)\n\n  return result.join('\\n')\n}\n\nexport function tanStackStartRouter(\n  startPluginOpts: TanStackStartInputConfig,\n  getConfig: GetConfigFn,\n  corePluginOpts: TanStackStartVitePluginCoreOptions,\n): Array<PluginOption> {\n  const getGeneratedRouteTreePath = () => {\n    const { startConfig } = getConfig()\n    return path.resolve(startConfig.router.generatedRouteTree)\n  }\n\n  let clientEnvironment: DevEnvironment | null = null\n  function invalidate() {\n    if (!clientEnvironment) {\n      return\n    }\n\n    const mod = clientEnvironment.moduleGraph.getModuleById(\n      getGeneratedRouteTreePath(),\n    )\n    if (mod) {\n      clientEnvironment.moduleGraph.invalidateModule(mod)\n    }\n    clientEnvironment.hot.send({ type: 'full-reload', path: '*' })\n  }\n\n  let generatorInstance: Generator | null = null\n\n  const clientTreeGeneratorPlugin: GeneratorPlugin = {\n    name: 'start-client-tree-plugin',\n    init({ generator }) {\n      generatorInstance = generator\n    },\n    afterTransform({ node, prevNode }) {\n      if (isServerOnlyNode(node) !== isServerOnlyNode(prevNode)) {\n        invalidate()\n      }\n    },\n  }\n\n  let routeTreeFileFooter: Array<string> | null = null\n\n  function getRouteTreeFileFooter() {\n    if (routeTreeFileFooter) {\n      return routeTreeFileFooter\n    }\n    const { startConfig, resolvedStartConfig } = getConfig()\n    const ogRouteTreeFileFooter = startConfig.router.routeTreeFileFooter\n    if (ogRouteTreeFileFooter) {\n      if (Array.isArray(ogRouteTreeFileFooter)) {\n        routeTreeFileFooter = ogRouteTreeFileFooter\n      } else {\n        routeTreeFileFooter = ogRouteTreeFileFooter()\n      }\n    }\n    routeTreeFileFooter = [\n      moduleDeclaration({\n        generatedRouteTreePath: getGeneratedRouteTreePath(),\n        corePluginOpts,\n        startFilePath: resolvedStartConfig.startFilePath,\n        routerFilePath: resolvedStartConfig.routerFilePath,\n      }),\n      ...(routeTreeFileFooter ?? []),\n    ]\n    return routeTreeFileFooter\n  }\n\n  let resolvedGeneratedRouteTreePath: string | null = null\n  const clientTreePlugin: Plugin = {\n    name: 'tanstack-start:route-tree-client-plugin',\n    enforce: 'pre',\n    applyToEnvironment: (env) => env.name === VITE_ENVIRONMENT_NAMES.client,\n    configureServer(server) {\n      clientEnvironment = server.environments[VITE_ENVIRONMENT_NAMES.client]\n    },\n    config() {\n      type LoadObjectHook = Extract<\n        typeof clientTreePlugin.load,\n        { filter?: unknown }\n      >\n      resolvedGeneratedRouteTreePath = normalizePath(\n        getGeneratedRouteTreePath(),\n      )\n      ;(clientTreePlugin.load as LoadObjectHook).filter = {\n        id: { include: new RegExp(resolvedGeneratedRouteTreePath) },\n      }\n    },\n\n    load: {\n      filter: {\n        // this will be set in the config hook above since it relies on `config` hook being called first\n      },\n      async handler() {\n        if (!generatorInstance) {\n          throw new Error('Generator instance not initialized')\n        }\n        const crawlingResult = await generatorInstance.getCrawlingResult()\n        if (!crawlingResult) {\n          throw new Error('Crawling result not available')\n        }\n        const prunedAcc = pruneServerOnlySubtrees(crawlingResult)\n        const acc = {\n          ...crawlingResult.acc,\n          ...prunedAcc,\n        }\n        const buildResult = generatorInstance.buildRouteTree({\n          ...crawlingResult,\n          acc,\n          config: {\n            // importRoutesUsingAbsolutePaths: true,\n            // addExtensions: true,\n            disableTypes: true,\n            enableRouteTreeFormatting: false,\n            routeTreeFileHeader: [],\n            routeTreeFileFooter: [],\n          },\n        })\n        return { code: buildResult.routeTreeContent, map: null }\n      },\n    },\n  }\n  return [\n    clientTreePlugin,\n    tanstackRouterGenerator(() => {\n      const routerConfig = getConfig().startConfig.router\n      const plugins = [clientTreeGeneratorPlugin, routesManifestPlugin()]\n      if (startPluginOpts?.prerender?.enabled === true) {\n        plugins.push(prerenderRoutesPlugin())\n      }\n      return {\n        ...routerConfig,\n        target: corePluginOpts.framework,\n        routeTreeFileFooter: getRouteTreeFileFooter,\n        plugins,\n      }\n    }),\n    tanStackRouterCodeSplitter(() => {\n      const routerConfig = getConfig().startConfig.router\n      return {\n        ...routerConfig,\n        codeSplittingOptions: {\n          ...routerConfig.codeSplittingOptions,\n          deleteNodes: ['ssr', 'server', 'headers'],\n          addHmr: true,\n        },\n        plugin: {\n          vite: { environmentName: VITE_ENVIRONMENT_NAMES.client },\n        },\n      }\n    }),\n    tanStackRouterCodeSplitter(() => {\n      const routerConfig = getConfig().startConfig.router\n      return {\n        ...routerConfig,\n        codeSplittingOptions: {\n          ...routerConfig.codeSplittingOptions,\n          addHmr: false,\n        },\n        plugin: {\n          vite: { environmentName: VITE_ENVIRONMENT_NAMES.server },\n        },\n      }\n    }),\n    tanstackRouterAutoImport(startPluginOpts?.router),\n  ]\n}\n"],"names":["path"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-plugin-core",
-  "version": "1.160.2",
+  "version": "1.161.1",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -52,22 +52,25 @@
     "cheerio": "^1.0.0",
     "exsolve": "^1.0.7",
     "pathe": "^2.0.3",
+    "picomatch": "^4.0.3",
     "srvx": "^0.11.2",
+    "source-map": "^0.7.6",
     "tinyglobby": "^0.2.15",
     "ufo": "^1.5.4",
     "vitefu": "^1.1.1",
     "xmlbuilder2": "^4.0.3",
     "zod": "^3.24.2",
-    "@tanstack/router-core": "1.160.0",
-    "@tanstack/router-plugin": "1.160.2",
-    "@tanstack/router-generator": "1.160.1",
+    "@tanstack/router-core": "1.161.1",
+    "@tanstack/router-plugin": "1.161.1",
     "@tanstack/router-utils": "1.158.0",
-    "@tanstack/start-client-core": "1.160.0",
-    "@tanstack/start-server-core": "1.160.0"
+    "@tanstack/router-generator": "1.161.1",
+    "@tanstack/start-client-core": "1.161.1",
+    "@tanstack/start-server-core": "1.161.1"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.0.6",
     "@types/babel__core": "^7.20.5",
+    "@types/picomatch": "^4.0.2",
     "vite": "^7.3.1"
   },
   "peerDependencies": {

package/src/dev-server-plugin/plugin.ts

@@ -181,7 +181,7 @@ export function devServerPlugin({
               console.error(e)
               try {
                 viteDevServer.ssrFixStacktrace(e as Error)
-              } catch (_e) {}
+              } catch {}
 
               if (
                 webReq.headers.get('content-type')?.includes('application/json')

package/src/import-protection-plugin/defaults.ts

@@ -0,0 +1,56 @@
+import type { CompileStartFrameworkOptions } from '../types'
+import type { ImportProtectionEnvRules } from '../schema'
+import type { Pattern } from './utils'
+
+export interface DefaultImportProtectionRules {
+  client: Required<ImportProtectionEnvRules>
+  server: Required<ImportProtectionEnvRules>
+}
+
+/**
+ * Returns the default import protection rules for a given framework.
+ */
+export function getDefaultImportProtectionRules(
+  _framework: CompileStartFrameworkOptions,
+): DefaultImportProtectionRules {
+  const frameworks: Array<CompileStartFrameworkOptions> = [
+    'react',
+    'solid',
+    'vue',
+  ]
+
+  // Deny client importing server-specific entrypoints
+  const clientSpecifiers: Array<Pattern> = frameworks.map(
+    (fw) => `@tanstack/${fw}-start/server`,
+  )
+
+  return {
+    client: {
+      specifiers: clientSpecifiers,
+      files: ['**/*.server.*'],
+    },
+    server: {
+      specifiers: [],
+      files: ['**/*.client.*'],
+    },
+  }
+}
+
+/**
+ * Marker module specifiers that restrict a file to a specific environment.
+ */
+export function getMarkerSpecifiers(_framework: CompileStartFrameworkOptions): {
+  serverOnly: Array<string>
+  clientOnly: Array<string>
+} {
+  const frameworks: Array<CompileStartFrameworkOptions> = [
+    'react',
+    'solid',
+    'vue',
+  ]
+
+  return {
+    serverOnly: frameworks.map((fw) => `@tanstack/${fw}-start/server-only`),
+    clientOnly: frameworks.map((fw) => `@tanstack/${fw}-start/client-only`),
+  }
+}

package/src/import-protection-plugin/matchers.ts

@@ -0,0 +1,48 @@
+import picomatch from 'picomatch'
+
+import type { Pattern } from './utils'
+
+export interface CompiledMatcher {
+  pattern: Pattern
+  test: (value: string) => boolean
+}
+
+/**
+ * Compile a Pattern (string glob or RegExp) into a fast test function.
+ * String patterns use picomatch for full glob support (**, *, ?, braces, etc.).
+ * RegExp patterns are used as-is.
+ */
+export function compileMatcher(pattern: Pattern): CompiledMatcher {
+  if (pattern instanceof RegExp) {
+    // RegExp with `g` or `y` flags are stateful because `.test()` mutates
+    // `lastIndex`. Reset it to keep matcher evaluation deterministic.
+    return {
+      pattern,
+      test: (value: string) => {
+        pattern.lastIndex = 0
+        return pattern.test(value)
+      },
+    }
+  }
+
+  const isMatch = picomatch(pattern, { dot: true })
+  return { pattern, test: isMatch }
+}
+
+export function compileMatchers(
+  patterns: Array<Pattern>,
+): Array<CompiledMatcher> {
+  return patterns.map(compileMatcher)
+}
+
+export function matchesAny(
+  value: string,
+  matchers: Array<CompiledMatcher>,
+): CompiledMatcher | undefined {
+  for (const matcher of matchers) {
+    if (matcher.test(value)) {
+      return matcher
+    }
+  }
+  return undefined
+}