@tanstack/start-plugin-core 1.120.4-alpha.14 → 1.120.4-alpha.15

package/dist/esm/schema.js

@@ -77,7 +77,8 @@ function createTanStackStartOptionsSchema(frameworkPlugin = {}) {
       concurrency: z.number().optional(),
       filter: z.function().args(pageSchema).returns(z.any()).optional(),
       failOnError: z.boolean().optional()
-    }).and(pagePrerenderOptionsSchema.optional()).optional()
+    }).and(pagePrerenderOptionsSchema.optional()).optional(),
+    shell: shellSchema.optional()
   }).optional().default({});
 }
 const pageSitemapOptionsSchema = z.object({
@@ -114,6 +115,7 @@ const pageBaseSchema = z.object({
 });
 const pagePrerenderOptionsSchema = z.object({
   enabled: z.boolean().optional(),
+  outputPath: z.string().optional(),
   autoSubfolderIndex: z.boolean().optional(),
   crawlLinks: z.boolean().optional(),
   retryCount: z.number().optional(),
@@ -125,6 +127,18 @@ const pagePrerenderOptionsSchema = z.object({
     })
   ).returns(z.any()).optional()
 });
+const shellSchema = z.object({
+  enabled: z.boolean().optional().default(true),
+  maskPath: z.string().optional().default("/"),
+  autoRedirect: z.boolean().optional().default(true),
+  prerender: pagePrerenderOptionsSchema.optional().default({}).transform((opts) => ({
+    outputPath: opts.outputPath ?? "/_shell",
+    crawlLinks: false,
+    retryCount: 0,
+    ...opts,
+    enabled: true
+  }))
+});
 const pageSchema = pageBaseSchema.extend({
   prerender: pagePrerenderOptionsSchema.optional()
 });

package/dist/esm/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sources":["../../src/schema.ts"],"sourcesContent":["import path from 'node:path'\nimport { existsSync } from 'node:fs'\nimport { z } from 'zod'\nimport { configSchema, getConfig } from '@tanstack/router-generator'\nimport type { NitroConfig } from 'nitropack'\n\nconst tsrConfig = configSchema.partial().extend({\n  srcDirectory: z.string().optional().default('src'),\n})\n\nexport function createTanStackConfig<\n  TFrameworkPlugin extends Record<string, unknown>,\n>(frameworkPlugin?: TFrameworkPlugin) {\n  const schema = createTanStackStartOptionsSchema(frameworkPlugin)\n\n  return {\n    schema,\n    parse: (opts?: z.input<typeof schema>) => {\n      const options = schema.parse(opts)\n\n      const srcDirectory = options.tsr.srcDirectory\n\n      const routesDirectory =\n        options.tsr.routesDirectory ?? path.join(srcDirectory, 'routes')\n\n      const generatedRouteTree =\n        options.tsr.generatedRouteTree ??\n        path.join(srcDirectory, 'routeTree.gen.ts')\n\n      const clientEntryPath = (() => {\n        if (options.client.entry) {\n          return path.join(srcDirectory, options.client.entry)\n        }\n\n        if (existsSync(path.join(srcDirectory, 'client.tsx'))) {\n          return path.join(srcDirectory, 'client.tsx')\n        }\n\n        return '/~start/default-client-entry'\n      })()\n\n      const serverEntryPath = (() => {\n        if (options.server.entry) {\n          return path.join(srcDirectory, options.server.entry)\n        }\n\n        if (existsSync(path.join(srcDirectory, 'server.tsx'))) {\n          return path.join(srcDirectory, 'server.tsx')\n        }\n\n        return '/~start/default-server-entry'\n      })()\n\n      return {\n        ...options,\n        tsr: {\n          ...options.tsr,\n          ...getConfig({\n            ...options.tsr,\n            routesDirectory,\n            generatedRouteTree,\n          }),\n        },\n        clientEntryPath,\n        serverEntryPath,\n      }\n    },\n  }\n}\n\nexport function createTanStackStartOptionsSchema(\n  frameworkPlugin: Record<string, unknown> = {},\n) {\n  return z\n    .object({\n      root: z.string().optional().default(process.cwd()),\n      target: z.custom<NitroConfig['preset']>().optional(),\n      ...frameworkPlugin,\n      tsr: tsrConfig.optional().default({}),\n      client: z\n        .object({\n          entry: z.string().optional(),\n          base: z.string().optional().default('/_build'),\n        })\n        .optional()\n        .default({}),\n      server: z\n        .object({\n          entry: z.string().optional(),\n        })\n        .optional()\n        .default({}),\n      serverFns: z\n        .object({\n          base: z.string().optional().default('/_server'),\n        })\n        .optional()\n        .default({}),\n      public: z\n        .object({\n          dir: z.string().optional().default('public'),\n          base: z.string().optional().default('/'),\n        })\n        .optional()\n        .default({}),\n      pages: z\n        .array(z.union([z.string(), pageSchema]))\n        .optional()\n        .default([]),\n      sitemap: pagePrerenderOptionsSchema\n        .extend({\n          host: z.string().optional(),\n        })\n        .optional(),\n      prerender: z\n        .object({\n          enabled: z.boolean().optional(),\n          concurrency: z.number().optional(),\n          filter: z.function().args(pageSchema).returns(z.any()).optional(),\n          failOnError: z.boolean().optional(),\n        })\n        .and(pagePrerenderOptionsSchema.optional())\n        .optional(),\n    })\n    .optional()\n    .default({})\n}\n\nconst pageSitemapOptionsSchema = z.object({\n  exclude: z.boolean().optional(),\n  priority: z.number().min(0).max(1).optional(),\n  changefreq: z\n    .enum(['always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never'])\n    .optional(),\n  lastmod: z.union([z.string(), z.date()]).optional(),\n  alternateRefs: z\n    .array(\n      z.object({\n        href: z.string(),\n        hreflang: z.string(),\n      }),\n    )\n    .optional(),\n  images: z\n    .array(\n      z.object({\n        loc: z.string(),\n        caption: z.string().optional(),\n        title: z.string().optional(),\n      }),\n    )\n    .optional(),\n  news: z\n    .object({\n      publication: z.object({\n        name: z.string(),\n        language: z.string(),\n      }),\n      publicationDate: z.union([z.string(), z.date()]),\n      title: z.string(),\n    })\n    .optional(),\n})\n\nconst pageBaseSchema = z.object({\n  path: z.string(),\n  sitemap: pageSitemapOptionsSchema.optional(),\n  fromCrawl: z.boolean().optional(),\n})\n\nconst pagePrerenderOptionsSchema = z.object({\n  enabled: z.boolean().optional(),\n  autoSubfolderIndex: z.boolean().optional(),\n  crawlLinks: z.boolean().optional(),\n  retryCount: z.number().optional(),\n  retryDelay: z.number().optional(),\n  onSuccess: z\n    .function()\n    .args(\n      z.object({\n        page: pageBaseSchema,\n        html: z.string(),\n      }),\n    )\n    .returns(z.any())\n    .optional(),\n})\n\nexport const pageSchema = pageBaseSchema.extend({\n  prerender: pagePrerenderOptionsSchema.optional(),\n})\n\nexport type Page = z.infer<typeof pageSchema>\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sources":["../../src/schema.ts"],"sourcesContent":["import path from 'node:path'\nimport { existsSync } from 'node:fs'\nimport { z } from 'zod'\nimport { configSchema, getConfig } from '@tanstack/router-generator'\nimport type { NitroConfig } from 'nitropack'\n\nconst tsrConfig = configSchema.partial().extend({\n  srcDirectory: z.string().optional().default('src'),\n})\n\nexport function createTanStackConfig<\n  TFrameworkPlugin extends Record<string, unknown>,\n>(frameworkPlugin?: TFrameworkPlugin) {\n  const schema = createTanStackStartOptionsSchema(frameworkPlugin)\n\n  return {\n    schema,\n    parse: (opts?: z.input<typeof schema>) => {\n      const options = schema.parse(opts)\n\n      const srcDirectory = options.tsr.srcDirectory\n\n      const routesDirectory =\n        options.tsr.routesDirectory ?? path.join(srcDirectory, 'routes')\n\n      const generatedRouteTree =\n        options.tsr.generatedRouteTree ??\n        path.join(srcDirectory, 'routeTree.gen.ts')\n\n      const clientEntryPath = (() => {\n        if (options.client.entry) {\n          return path.join(srcDirectory, options.client.entry)\n        }\n\n        if (existsSync(path.join(srcDirectory, 'client.tsx'))) {\n          return path.join(srcDirectory, 'client.tsx')\n        }\n\n        return '/~start/default-client-entry'\n      })()\n\n      const serverEntryPath = (() => {\n        if (options.server.entry) {\n          return path.join(srcDirectory, options.server.entry)\n        }\n\n        if (existsSync(path.join(srcDirectory, 'server.tsx'))) {\n          return path.join(srcDirectory, 'server.tsx')\n        }\n\n        return '/~start/default-server-entry'\n      })()\n\n      return {\n        ...options,\n        tsr: {\n          ...options.tsr,\n          ...getConfig({\n            ...options.tsr,\n            routesDirectory,\n            generatedRouteTree,\n          }),\n        },\n        clientEntryPath,\n        serverEntryPath,\n      }\n    },\n  }\n}\n\nexport function createTanStackStartOptionsSchema(\n  frameworkPlugin: Record<string, unknown> = {},\n) {\n  return z\n    .object({\n      root: z.string().optional().default(process.cwd()),\n      target: z.custom<NitroConfig['preset']>().optional(),\n      ...frameworkPlugin,\n      tsr: tsrConfig.optional().default({}),\n      client: z\n        .object({\n          entry: z.string().optional(),\n          base: z.string().optional().default('/_build'),\n        })\n        .optional()\n        .default({}),\n      server: z\n        .object({\n          entry: z.string().optional(),\n        })\n        .optional()\n        .default({}),\n      serverFns: z\n        .object({\n          base: z.string().optional().default('/_server'),\n        })\n        .optional()\n        .default({}),\n      public: z\n        .object({\n          dir: z.string().optional().default('public'),\n          base: z.string().optional().default('/'),\n        })\n        .optional()\n        .default({}),\n      pages: z\n        .array(z.union([z.string(), pageSchema]))\n        .optional()\n        .default([]),\n      sitemap: pagePrerenderOptionsSchema\n        .extend({\n          host: z.string().optional(),\n        })\n        .optional(),\n      prerender: z\n        .object({\n          enabled: z.boolean().optional(),\n          concurrency: z.number().optional(),\n          filter: z.function().args(pageSchema).returns(z.any()).optional(),\n          failOnError: z.boolean().optional(),\n        })\n        .and(pagePrerenderOptionsSchema.optional())\n        .optional(),\n      shell: shellSchema.optional(),\n    })\n    .optional()\n    .default({})\n}\n\nconst pageSitemapOptionsSchema = z.object({\n  exclude: z.boolean().optional(),\n  priority: z.number().min(0).max(1).optional(),\n  changefreq: z\n    .enum(['always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never'])\n    .optional(),\n  lastmod: z.union([z.string(), z.date()]).optional(),\n  alternateRefs: z\n    .array(\n      z.object({\n        href: z.string(),\n        hreflang: z.string(),\n      }),\n    )\n    .optional(),\n  images: z\n    .array(\n      z.object({\n        loc: z.string(),\n        caption: z.string().optional(),\n        title: z.string().optional(),\n      }),\n    )\n    .optional(),\n  news: z\n    .object({\n      publication: z.object({\n        name: z.string(),\n        language: z.string(),\n      }),\n      publicationDate: z.union([z.string(), z.date()]),\n      title: z.string(),\n    })\n    .optional(),\n})\n\nconst pageBaseSchema = z.object({\n  path: z.string(),\n  sitemap: pageSitemapOptionsSchema.optional(),\n  fromCrawl: z.boolean().optional(),\n})\n\nconst pagePrerenderOptionsSchema = z.object({\n  enabled: z.boolean().optional(),\n  outputPath: z.string().optional(),\n  autoSubfolderIndex: z.boolean().optional(),\n  crawlLinks: z.boolean().optional(),\n  retryCount: z.number().optional(),\n  retryDelay: z.number().optional(),\n  onSuccess: z\n    .function()\n    .args(\n      z.object({\n        page: pageBaseSchema,\n        html: z.string(),\n      }),\n    )\n    .returns(z.any())\n    .optional(),\n})\n\nconst shellSchema = z.object({\n  enabled: z.boolean().optional().default(true),\n  maskPath: z.string().optional().default('/'),\n  autoRedirect: z.boolean().optional().default(true),\n  prerender: pagePrerenderOptionsSchema\n    .optional()\n    .default({})\n    .transform((opts) => ({\n      outputPath: opts.outputPath ?? '/_shell',\n      crawlLinks: false,\n      retryCount: 0,\n      ...opts,\n      enabled: true,\n    })),\n})\n\nexport const pageSchema = pageBaseSchema.extend({\n  prerender: pagePrerenderOptionsSchema.optional(),\n})\n\nexport type Page = z.infer<typeof pageSchema>\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-plugin-core",
-  "version": "1.120.4-alpha.14",
+  "version": "1.120.4-alpha.15",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -63,9 +63,9 @@
     "ufo": "^1.5.4",
     "xmlbuilder2": "^3.1.1",
     "zod": "^3.24.2",
-    "@tanstack/router-generator": "^1.120.4-alpha.13",
-    "@tanstack/router-core": "^1.120.4-alpha.13",
-    "@tanstack/router-utils": "^1.120.4-alpha.1"
+    "@tanstack/router-core": "^1.120.4-alpha.15",
+    "@tanstack/router-utils": "^1.120.4-alpha.1",
+    "@tanstack/router-generator": "^1.120.4-alpha.15"
   },
   "devDependencies": {
     "vite": "^6.0.0"

package/src/nitro/nitro-plugin.ts

@@ -80,12 +80,52 @@ export function nitroPlugin(
                 rollupConfig: {
                   plugins: [virtualBundlePlugin(getSsrBundle())],
                 },
+                routeRules: {
+                  // TODO: We need to expose *some* kind of routeRules configuration
+                  // and it needs to translate to this for now. But we should
+                  // be cognizant of the probability that we will not use Nitro's
+                  // routeRules configuration in the future.
+                  ...(options.shell?.enabled && options.shell.autoRedirect
+                    ? {
+                        '/**': {
+                          // @ts-expect-error We are using this as a marker
+                          __TSS_SHELL: true,
+                          redirect: {
+                            to: `${options.shell.prerender.outputPath.replace(/[/]{1,}$/, '')}`,
+                            statusCode: 200,
+                          },
+                        },
+                      }
+                    : {}),
+                },
               }
 
               const nitro = await createNitro(nitroConfig)
 
               await buildNitroEnvironment(nitro, () => build(nitro))
 
+              if (options.shell?.enabled) {
+                options.prerender = {
+                  ...options.prerender,
+                  enabled: true,
+                }
+
+                const maskUrl = new URL(
+                  options.shell.maskPath,
+                  'http://localhost',
+                )
+
+                maskUrl.searchParams.set('__TSS_SHELL', 'true')
+
+                options.pages.push({
+                  path: maskUrl.toString().replace('http://localhost', ''),
+                  prerender: options.shell.prerender,
+                  sitemap: {
+                    exclude: true,
+                  },
+                })
+              }
+
               if (options.prerender?.enabled) {
                 await prerender({
                   options,

package/src/prerender.ts

@@ -20,7 +20,7 @@ export async function prerender({
   nitro: Nitro
   builder: ViteBuilder
 }) {
-  nitro.logger.info('Prendering pages...')
+  console.info('Prendering pages...')
 
   // If prerender is enabled but no pages are provided, default to prerendering the root page
   if (options.prerender?.enabled && !options.pages.length) {
@@ -44,6 +44,14 @@ export async function prerender({
 
   const nodeNitro = await createNitro({
     ...nitro.options._config,
+    routeRules: {
+      // Filter out our shell redirect rule if it exists
+      ...Object.fromEntries(
+        Object.entries(nitro.options._config.routeRules ?? {}).filter(
+          ([_, value]) => !(value as any).__TSS_SHELL,
+        ),
+      ),
+    },
     preset: 'nitro-prerender',
     logLevel: 0,
     output: {
@@ -90,14 +98,14 @@ export async function prerender({
     // Crawl all pages
     const pages = await prerenderPages()
 
-    nitro.logger.info(`Prerendered ${pages.length} pages:`)
+    console.info(`Prerendered ${pages.length} pages:`)
     pages.forEach((page) => {
-      nitro.logger.info(`- ${page}`)
+      console.info(`- ${page}`)
     })
 
     // TODO: Write the prerendered pages to the output directory
   } catch (error) {
-    nitro.logger.error(error)
+    console.error(error)
   } finally {
     // Ensure server is always closed
     // server.process.kill()
@@ -123,7 +131,7 @@ export async function prerender({
     const seen = new Set<string>()
     const retriesByPath = new Map<string, number>()
     const concurrency = options.prerender?.concurrency ?? os.cpus().length
-    nitro.logger.info(`Concurrency: ${concurrency}`)
+    console.info(`Concurrency: ${concurrency}`)
     const queue = new Queue({ concurrency })
 
     options.pages.forEach((_page) => {
@@ -165,7 +173,7 @@ export async function prerender({
 
       // Add the task
       queue.add(async () => {
-        nitro.logger.info(`Crawling: ${page.path}`)
+        console.info(`Crawling: ${page.path}`)
         const retries = retriesByPath.get(page.path) || 0
         try {
           // Fetch the route
@@ -179,23 +187,29 @@ export async function prerender({
           )
 
           if (!res.ok) {
-            throw new Error(`Failed to fetch ${page.path}: ${res.statusText}`)
+            throw new Error(`Failed to fetch ${page.path}: ${res.statusText}`, {
+              cause: res,
+            })
           }
 
+          const cleanPagePath = (
+            prerenderOptions.outputPath || page.path
+          ).split(/[?#]/)[0]!
+
           // Guess route type and populate fileName
           const contentType = res.headers.get('content-type') || ''
           const isImplicitHTML =
-            !page.path.endsWith('.html') && contentType.includes('html')
+            !cleanPagePath.endsWith('.html') && contentType.includes('html')
           // &&
           // !JsonSigRx.test(dataBuff.subarray(0, 32).toString('utf8'))
-          const routeWithIndex = page.path.endsWith('/')
-            ? page.path + 'index'
-            : page.path
+          const routeWithIndex = cleanPagePath.endsWith('/')
+            ? cleanPagePath + 'index'
+            : cleanPagePath
 
           const htmlPath =
-            page.path.endsWith('/') || prerenderOptions.autoSubfolderIndex
-              ? joinURL(page.path, 'index.html')
-              : page.path + '.html'
+            cleanPagePath.endsWith('/') || prerenderOptions.autoSubfolderIndex
+              ? joinURL(cleanPagePath, 'index.html')
+              : cleanPagePath + '.html'
 
           const filename = withoutBase(
             isImplicitHTML ? htmlPath : routeWithIndex,
@@ -227,9 +241,7 @@ export async function prerender({
           }
         } catch (error) {
           if (retries < (prerenderOptions.retryCount ?? 0)) {
-            nitro.logger.warn(
-              `Encountered error, retrying: ${page.path} in 500ms`,
-            )
+            console.warn(`Encountered error, retrying: ${page.path} in 500ms`)
             await new Promise((resolve) =>
               setTimeout(resolve, prerenderOptions.retryDelay),
             )

package/src/schema.ts

@@ -121,6 +121,7 @@ export function createTanStackStartOptionsSchema(
         })
         .and(pagePrerenderOptionsSchema.optional())
         .optional(),
+      shell: shellSchema.optional(),
     })
     .optional()
     .default({})
@@ -170,6 +171,7 @@ const pageBaseSchema = z.object({
 
 const pagePrerenderOptionsSchema = z.object({
   enabled: z.boolean().optional(),
+  outputPath: z.string().optional(),
   autoSubfolderIndex: z.boolean().optional(),
   crawlLinks: z.boolean().optional(),
   retryCount: z.number().optional(),
@@ -186,6 +188,22 @@ const pagePrerenderOptionsSchema = z.object({
     .optional(),
 })
 
+const shellSchema = z.object({
+  enabled: z.boolean().optional().default(true),
+  maskPath: z.string().optional().default('/'),
+  autoRedirect: z.boolean().optional().default(true),
+  prerender: pagePrerenderOptionsSchema
+    .optional()
+    .default({})
+    .transform((opts) => ({
+      outputPath: opts.outputPath ?? '/_shell',
+      crawlLinks: false,
+      retryCount: 0,
+      ...opts,
+      enabled: true,
+    })),
+})
+
 export const pageSchema = pageBaseSchema.extend({
   prerender: pagePrerenderOptionsSchema.optional(),
 })