@analogjs/vite-plugin-nitro 3.0.0-alpha.4 → 3.0.0-alpha.41

package/src/lib/utils/get-page-handlers.d.ts

@@ -1,62 +1,62 @@
-import type { NitroEventHandler } from 'nitro/types';
+import type { NitroEventHandler } from "nitro/types";
 type GetHandlersArgs = {
-    workspaceRoot: string;
-    sourceRoot: string;
-    rootDir: string;
-    additionalPagesDirs?: string[];
-    hasAPIDir?: boolean;
+	workspaceRoot: string;
+	sourceRoot: string;
+	rootDir: string;
+	additionalPagesDirs?: string[];
+	hasAPIDir?: boolean;
 };
 /**
- * Discovers and generates Nitro event handlers for server-side page routes.
- *
- * This function:
- * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
- * 2. Converts file paths to route patterns using Angular-style route syntax
- * 3. Generates Nitro event handlers with proper route mapping and lazy loading
- * 4. Handles dynamic route parameters and catch-all routes
- *
- * @param workspaceRoot The workspace root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param rootDir The project root directory relative to workspace
- * @param additionalPagesDirs Optional array of additional pages directories to scan
- * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
- * @returns Array of NitroEventHandler objects with handler paths and route patterns
- *
- * Example usage:
- * const handlers = getPageHandlers({
- *   workspaceRoot: '/workspace',
- *   sourceRoot: 'src',
- *   rootDir: 'apps/my-app',
- *   additionalPagesDirs: ['/libs/shared/pages'],
- *   hasAPIDir: true
- * });
- *
- * Sample discovered file paths:
- * - /workspace/apps/my-app/src/app/pages/index.server.ts
- * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
- * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
- * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
- *
- * Route transformation examples:
- * - index.server.ts → /_analog/pages/index
- * - users/[id].server.ts → /_analog/pages/users/:id
- * - products/[...slug].server.ts → /_analog/pages/products/**:slug
- * - (auth)/login.server.ts → /_analog/pages/-auth-/login
- *
- * tinyglobby vs fast-glob comparison:
- * - Both support the same glob patterns for file discovery
- * - Both are efficient for finding server-side page files
- * - tinyglobby is now used instead of fast-glob
- * - tinyglobby provides similar functionality with smaller bundle size
- * - tinyglobby's globSync returns absolute paths when absolute: true is set
- *
- * Route transformation rules:
- * 1. Removes .server.ts extension
- * 2. Converts [param] to :param for dynamic routes
- * 3. Converts [...param] to **:param for catch-all routes
- * 4. Converts (group) to -group- for route groups
- * 5. Converts dots to forward slashes
- * 6. Prefixes with /_analog/pages and optionally /api
- */
-export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }: GetHandlersArgs): NitroEventHandler[];
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* This function:
+* 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+* 2. Converts file paths to route patterns using Angular-style route syntax
+* 3. Generates Nitro event handlers with proper route mapping and lazy loading
+* 4. Handles dynamic route parameters and catch-all routes
+*
+* @param workspaceRoot The workspace root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param rootDir The project root directory relative to workspace
+* @param additionalPagesDirs Optional array of additional pages directories to scan
+* @param hasAPIDir Whether the project has an API directory (affects route prefixing)
+* @returns Array of NitroEventHandler objects with handler paths and route patterns
+*
+* Example usage:
+* const handlers = getPageHandlers({
+*   workspaceRoot: '/workspace',
+*   sourceRoot: 'src',
+*   rootDir: 'apps/my-app',
+*   additionalPagesDirs: ['/libs/shared/pages'],
+*   hasAPIDir: true
+* });
+*
+* Sample discovered file paths:
+* - /workspace/apps/my-app/src/app/pages/index.server.ts
+* - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+* - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+* - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+*
+* Route transformation examples:
+* - index.server.ts → /_analog/pages/index
+* - users/[id].server.ts → /_analog/pages/users/:id
+* - products/[...slug].server.ts → /_analog/pages/products/**:slug
+* - (auth)/login.server.ts → /_analog/pages/-auth-/login
+*
+* tinyglobby vs fast-glob comparison:
+* - Both support the same glob patterns for file discovery
+* - Both are efficient for finding server-side page files
+* - tinyglobby is now used instead of fast-glob
+* - tinyglobby provides similar functionality with smaller bundle size
+* - tinyglobby's globSync returns absolute paths when absolute: true is set
+*
+* Route transformation rules:
+* 1. Removes .server.ts extension
+* 2. Converts [param] to :param for dynamic routes
+* 3. Converts [...param] to **:param for catch-all routes
+* 4. Converts (group) to -group- for route groups
+* 5. Converts dots to forward slashes
+* 6. Prefixes with /_analog/pages and optionally /api
+*/
+export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir }: GetHandlersArgs): NitroEventHandler[];
 export {};

package/src/lib/utils/get-page-handlers.js

@@ -1,87 +1,73 @@
-import { resolve } from 'node:path';
-import { globSync } from 'tinyglobby';
-import { normalizePath } from 'vite';
+import { normalizePath } from "vite";
+import { resolve } from "node:path";
+import { globSync } from "tinyglobby";
+//#region packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts
 /**
- * Discovers and generates Nitro event handlers for server-side page routes.
- *
- * This function:
- * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
- * 2. Converts file paths to route patterns using Angular-style route syntax
- * 3. Generates Nitro event handlers with proper route mapping and lazy loading
- * 4. Handles dynamic route parameters and catch-all routes
- *
- * @param workspaceRoot The workspace root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param rootDir The project root directory relative to workspace
- * @param additionalPagesDirs Optional array of additional pages directories to scan
- * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
- * @returns Array of NitroEventHandler objects with handler paths and route patterns
- *
- * Example usage:
- * const handlers = getPageHandlers({
- *   workspaceRoot: '/workspace',
- *   sourceRoot: 'src',
- *   rootDir: 'apps/my-app',
- *   additionalPagesDirs: ['/libs/shared/pages'],
- *   hasAPIDir: true
- * });
- *
- * Sample discovered file paths:
- * - /workspace/apps/my-app/src/app/pages/index.server.ts
- * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
- * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
- * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
- *
- * Route transformation examples:
- * - index.server.ts → /_analog/pages/index
- * - users/[id].server.ts → /_analog/pages/users/:id
- * - products/[...slug].server.ts → /_analog/pages/products/**:slug
- * - (auth)/login.server.ts → /_analog/pages/-auth-/login
- *
- * tinyglobby vs fast-glob comparison:
- * - Both support the same glob patterns for file discovery
- * - Both are efficient for finding server-side page files
- * - tinyglobby is now used instead of fast-glob
- * - tinyglobby provides similar functionality with smaller bundle size
- * - tinyglobby's globSync returns absolute paths when absolute: true is set
- *
- * Route transformation rules:
- * 1. Removes .server.ts extension
- * 2. Converts [param] to :param for dynamic routes
- * 3. Converts [...param] to **:param for catch-all routes
- * 4. Converts (group) to -group- for route groups
- * 5. Converts dots to forward slashes
- * 6. Prefixes with /_analog/pages and optionally /api
- */
-export function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }) {
-    // Normalize the project root path for consistent path handling
-    const root = normalizePath(resolve(workspaceRoot, rootDir));
-    // Discover all .server.ts files in the app/pages directory and additional pages directories
-    // Pattern: looks for any .server.ts files in app/pages/**/*.server.ts and additional directories
-    const endpointFiles = globSync([
-        `${root}/${sourceRoot}/app/pages/**/*.server.ts`,
-        ...(additionalPagesDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`),
-    ], { dot: true, absolute: true });
-    // Transform each discovered file into a Nitro event handler
-    const handlers = endpointFiles.map((endpointFile) => {
-        // Normalize the endpoint file path for consistent path handling
-        const normalized = normalizePath(endpointFile);
-        // Transform the normalized path into a route pattern
-        const route = normalized
-            .replace(/^(.*?)\/pages/, '/pages')
-            .replace(/\.server\.ts$/, '') // Remove .server.ts extension
-            .replace(/\[\.{3}(.+)\]/g, '**:$1') // Convert [...param] to **:param (catch-all routes)
-            .replace(/\[\.{3}(\w+)\]/g, '**:$1') // Alternative catch-all pattern
-            .replace(/\/\((.*?)\)$/, '/-$1-') // Convert (group) to -group- (route groups)
-            .replace(/\[(\w+)\]/g, ':$1') // Convert [param] to :param (dynamic routes)
-            .replace(/\./g, '/'); // Convert dots to forward slashes
-        // Return Nitro event handler with absolute handler path and transformed route
-        return {
-            handler: endpointFile,
-            route: `${hasAPIDir ? '/api' : ''}/_analog${route}`,
-            lazy: true,
-        };
-    });
-    return handlers;
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* This function:
+* 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+* 2. Converts file paths to route patterns using Angular-style route syntax
+* 3. Generates Nitro event handlers with proper route mapping and lazy loading
+* 4. Handles dynamic route parameters and catch-all routes
+*
+* @param workspaceRoot The workspace root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param rootDir The project root directory relative to workspace
+* @param additionalPagesDirs Optional array of additional pages directories to scan
+* @param hasAPIDir Whether the project has an API directory (affects route prefixing)
+* @returns Array of NitroEventHandler objects with handler paths and route patterns
+*
+* Example usage:
+* const handlers = getPageHandlers({
+*   workspaceRoot: '/workspace',
+*   sourceRoot: 'src',
+*   rootDir: 'apps/my-app',
+*   additionalPagesDirs: ['/libs/shared/pages'],
+*   hasAPIDir: true
+* });
+*
+* Sample discovered file paths:
+* - /workspace/apps/my-app/src/app/pages/index.server.ts
+* - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+* - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+* - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+*
+* Route transformation examples:
+* - index.server.ts → /_analog/pages/index
+* - users/[id].server.ts → /_analog/pages/users/:id
+* - products/[...slug].server.ts → /_analog/pages/products/**:slug
+* - (auth)/login.server.ts → /_analog/pages/-auth-/login
+*
+* tinyglobby vs fast-glob comparison:
+* - Both support the same glob patterns for file discovery
+* - Both are efficient for finding server-side page files
+* - tinyglobby is now used instead of fast-glob
+* - tinyglobby provides similar functionality with smaller bundle size
+* - tinyglobby's globSync returns absolute paths when absolute: true is set
+*
+* Route transformation rules:
+* 1. Removes .server.ts extension
+* 2. Converts [param] to :param for dynamic routes
+* 3. Converts [...param] to **:param for catch-all routes
+* 4. Converts (group) to -group- for route groups
+* 5. Converts dots to forward slashes
+* 6. Prefixes with /_analog/pages and optionally /api
+*/
+function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir }) {
+	return globSync([`${normalizePath(resolve(workspaceRoot, rootDir))}/${sourceRoot}/app/pages/**/*.server.ts`, ...(additionalPagesDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`)], {
+		dot: true,
+		absolute: true
+	}).map((endpointFile) => {
+		const route = normalizePath(endpointFile).replace(/^(.*?)\/pages/, "/pages").replace(/\.server\.ts$/, "").replace(/\[\.{3}(.+)\]/g, "**:$1").replace(/\[\.{3}(\w+)\]/g, "**:$1").replace(/\/\((.*?)\)$/, "/-$1-").replace(/\[(\w+)\]/g, ":$1").replace(/\./g, "/");
+		return {
+			handler: endpointFile,
+			route: `${hasAPIDir ? "/api" : ""}/_analog${route}`,
+			lazy: true
+		};
+	});
 }
+//#endregion
+export { getPageHandlers };
+
 //# sourceMappingURL=get-page-handlers.js.map

package/src/lib/utils/get-page-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-page-handlers.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAUrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,SAAS,GACO;IAChB,+DAA+D;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,4FAA4F;IAC5F,iGAAiG;IACjG,MAAM,aAAa,GAAa,QAAQ,CACtC;QACE,GAAG,IAAI,IAAI,UAAU,2BAA2B;QAChD,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,GAAG,iBAAiB,CACjD;KACF,EACD,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC9B,CAAC;IAEF,4DAA4D;IAC5D,MAAM,QAAQ,GAAwB,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACvE,gEAAgE;QAChE,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QAC/C,qDAAqD;QACrD,MAAM,KAAK,GAAG,UAAU;aACrB,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC;aAClC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,8BAA8B;aAC3D,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,oDAAoD;aACvF,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,gCAAgC;aACpE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,4CAA4C;aAC7E,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,6CAA6C;aAC1E,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,kCAAkC;QAE1D,8EAA8E;QAC9E,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,EAAE;YACnD,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"get-page-handlers.js","names":[],"sources":["../../../../src/lib/utils/get-page-handlers.ts"],"sourcesContent":["import { resolve, relative } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nimport type { NitroEventHandler } from 'nitro/types';\nimport { normalizePath } from 'vite';\n\ntype GetHandlersArgs = {\n  workspaceRoot: string;\n  sourceRoot: string;\n  rootDir: string;\n  additionalPagesDirs?: string[];\n  hasAPIDir?: boolean;\n};\n\n/**\n * Discovers and generates Nitro event handlers for server-side page routes.\n *\n * This function:\n * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories\n * 2. Converts file paths to route patterns using Angular-style route syntax\n * 3. Generates Nitro event handlers with proper route mapping and lazy loading\n * 4. Handles dynamic route parameters and catch-all routes\n *\n * @param workspaceRoot The workspace root directory path\n * @param sourceRoot The source directory path (e.g., 'src')\n * @param rootDir The project root directory relative to workspace\n * @param additionalPagesDirs Optional array of additional pages directories to scan\n * @param hasAPIDir Whether the project has an API directory (affects route prefixing)\n * @returns Array of NitroEventHandler objects with handler paths and route patterns\n *\n * Example usage:\n * const handlers = getPageHandlers({\n *   workspaceRoot: '/workspace',\n *   sourceRoot: 'src',\n *   rootDir: 'apps/my-app',\n *   additionalPagesDirs: ['/libs/shared/pages'],\n *   hasAPIDir: true\n * });\n *\n * Sample discovered file paths:\n * - /workspace/apps/my-app/src/app/pages/index.server.ts\n * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts\n * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts\n * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts\n *\n * Route transformation examples:\n * - index.server.ts → /_analog/pages/index\n * - users/[id].server.ts → /_analog/pages/users/:id\n * - products/[...slug].server.ts → /_analog/pages/products/**:slug\n * - (auth)/login.server.ts → /_analog/pages/-auth-/login\n *\n * tinyglobby vs fast-glob comparison:\n * - Both support the same glob patterns for file discovery\n * - Both are efficient for finding server-side page files\n * - tinyglobby is now used instead of fast-glob\n * - tinyglobby provides similar functionality with smaller bundle size\n * - tinyglobby's globSync returns absolute paths when absolute: true is set\n *\n * Route transformation rules:\n * 1. Removes .server.ts extension\n * 2. Converts [param] to :param for dynamic routes\n * 3. Converts [...param] to **:param for catch-all routes\n * 4. Converts (group) to -group- for route groups\n * 5. Converts dots to forward slashes\n * 6. Prefixes with /_analog/pages and optionally /api\n */\nexport function getPageHandlers({\n  workspaceRoot,\n  sourceRoot,\n  rootDir,\n  additionalPagesDirs,\n  hasAPIDir,\n}: GetHandlersArgs): NitroEventHandler[] {\n  // Normalize the project root path for consistent path handling\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n\n  // Discover all .server.ts files in the app/pages directory and additional pages directories\n  // Pattern: looks for any .server.ts files in app/pages/**/*.server.ts and additional directories\n  const endpointFiles: string[] = globSync(\n    [\n      `${root}/${sourceRoot}/app/pages/**/*.server.ts`,\n      ...(additionalPagesDirs || []).map(\n        (dir) => `${workspaceRoot}${dir}/**/*.server.ts`,\n      ),\n    ],\n    { dot: true, absolute: true },\n  );\n\n  // Transform each discovered file into a Nitro event handler\n  const handlers: NitroEventHandler[] = endpointFiles.map((endpointFile) => {\n    // Normalize the endpoint file path for consistent path handling\n    const normalized = normalizePath(endpointFile);\n    // Transform the normalized path into a route pattern\n    const route = normalized\n      .replace(/^(.*?)\\/pages/, '/pages')\n      .replace(/\\.server\\.ts$/, '') // Remove .server.ts extension\n      .replace(/\\[\\.{3}(.+)\\]/g, '**:$1') // Convert [...param] to **:param (catch-all routes)\n      .replace(/\\[\\.{3}(\\w+)\\]/g, '**:$1') // Alternative catch-all pattern\n      .replace(/\\/\\((.*?)\\)$/, '/-$1-') // Convert (group) to -group- (route groups)\n      .replace(/\\[(\\w+)\\]/g, ':$1') // Convert [param] to :param (dynamic routes)\n      .replace(/\\./g, '/'); // Convert dots to forward slashes\n\n    // Return Nitro event handler with absolute handler path and transformed route\n    return {\n      handler: endpointFile,\n      route: `${hasAPIDir ? '/api' : ''}/_analog${route}`,\n      lazy: true,\n    };\n  });\n\n  return handlers;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,SAAgB,gBAAgB,EAC9B,eACA,YACA,SACA,qBACA,aACuC;AAsCvC,QAhCgC,SAC9B,CACE,GANS,cAAc,QAAQ,eAAe,QAAQ,CAAC,CAM/C,GAAG,WAAW,4BACtB,IAAI,uBAAuB,EAAE,EAAE,KAC5B,QAAQ,GAAG,gBAAgB,IAAI,iBACjC,CACF,EACD;EAAE,KAAK;EAAM,UAAU;EAAM,CAC9B,CAGmD,KAAK,iBAAiB;EAIxE,MAAM,QAFa,cAAc,aAAa,CAG3C,QAAQ,iBAAiB,SAAS,CAClC,QAAQ,iBAAiB,GAAG,CAC5B,QAAQ,kBAAkB,QAAQ,CAClC,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,gBAAgB,QAAQ,CAChC,QAAQ,cAAc,MAAM,CAC5B,QAAQ,OAAO,IAAI;AAGtB,SAAO;GACL,SAAS;GACT,OAAO,GAAG,YAAY,SAAS,GAAG,UAAU;GAC5C,MAAM;GACP;GACD"}

package/src/lib/utils/i18n-prerender.d.ts

@@ -0,0 +1,36 @@
+import { PrerenderRoute } from "nitropack";
+import { I18nPrerenderOptions } from "../options.js";
+/**
+* Expands a list of routes to include locale-prefixed variants.
+*
+* For each route and each locale, generates a prefixed route:
+*   '/' + locale + route
+*
+* The default locale's routes are included both with and without the prefix
+* so that `/about` and `/en/about` both render.
+*
+* @param routes - The original routes to expand
+* @param i18n - The i18n prerender configuration
+* @returns Expanded routes with locale prefixes
+*/
+export declare function expandRoutesWithLocales(routes: string[], i18n: I18nPrerenderOptions): string[];
+/**
+* Creates a post-rendering hook that injects the `lang` attribute
+* into the `<html>` tag of prerendered pages based on the route's
+* locale prefix.
+*
+* @param i18n - The i18n prerender configuration
+* @returns A post-rendering hook function
+*/
+export declare function createI18nPostRenderingHook(i18n: I18nPrerenderOptions): (route: PrerenderRoute) => Promise<void>;
+/**
+* Detects the locale from a prerendered route path by checking
+* the first path segment against the configured locales.
+*/
+export declare function detectLocaleFromRoute(route: string, i18n: I18nPrerenderOptions): string;
+/**
+* Sets the `lang` attribute on the `<html>` tag in an HTML string.
+* If a `lang` attribute already exists, it is replaced.
+* If no `lang` attribute exists, it is added.
+*/
+export declare function setHtmlLang(html: string, locale: string): string;

package/src/lib/utils/i18n-prerender.js

@@ -0,0 +1,23 @@
+//#region packages/vite-plugin-nitro/src/lib/utils/i18n-prerender.ts
+/**
+* Detects the locale from a prerendered route path by checking
+* the first path segment against the configured locales.
+*/
+function detectLocaleFromRoute(route, i18n) {
+	const firstSegment = route.split("/").filter(Boolean)[0];
+	if (firstSegment && i18n.locales.includes(firstSegment)) return firstSegment;
+	return i18n.defaultLocale;
+}
+/**
+* Sets the `lang` attribute on the `<html>` tag in an HTML string.
+* If a `lang` attribute already exists, it is replaced.
+* If no `lang` attribute exists, it is added.
+*/
+function setHtmlLang(html, locale) {
+	if (/<html[^>]*\slang\s*=\s*["'][^"']*["']/i.test(html)) return html.replace(/(<html[^>]*\s)lang\s*=\s*["'][^"']*["']/i, `$1lang="${locale}"`);
+	return html.replace(/<html/i, `<html lang="${locale}"`);
+}
+//#endregion
+export { detectLocaleFromRoute, setHtmlLang };
+
+//# sourceMappingURL=i18n-prerender.js.map

package/src/lib/utils/i18n-prerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-prerender.js","names":[],"sources":["../../../../src/lib/utils/i18n-prerender.ts"],"sourcesContent":["import { PrerenderRoute } from 'nitropack';\nimport { I18nPrerenderOptions } from '../options.js';\n\n/**\n * Expands a list of routes to include locale-prefixed variants.\n *\n * For each route and each locale, generates a prefixed route:\n *   '/' + locale + route\n *\n * The default locale's routes are included both with and without the prefix\n * so that `/about` and `/en/about` both render.\n *\n * @param routes - The original routes to expand\n * @param i18n - The i18n prerender configuration\n * @returns Expanded routes with locale prefixes\n */\nexport function expandRoutesWithLocales(\n  routes: string[],\n  i18n: I18nPrerenderOptions,\n): string[] {\n  const expanded: string[] = [];\n\n  for (const route of routes) {\n    // Skip API routes — they don't need locale prefixes\n    if (route.includes('/_analog/') || route.startsWith('/api/')) {\n      expanded.push(route);\n      continue;\n    }\n\n    for (const locale of i18n.locales) {\n      const prefix = `/${locale}`;\n      const localizedRoute = route === '/' ? prefix : `${prefix}${route}`;\n      expanded.push(localizedRoute);\n    }\n\n    // Keep the unprefixed route for the default locale\n    if (!expanded.includes(route)) {\n      expanded.push(route);\n    }\n  }\n\n  return expanded;\n}\n\n/**\n * Creates a post-rendering hook that injects the `lang` attribute\n * into the `<html>` tag of prerendered pages based on the route's\n * locale prefix.\n *\n * @param i18n - The i18n prerender configuration\n * @returns A post-rendering hook function\n */\nexport function createI18nPostRenderingHook(\n  i18n: I18nPrerenderOptions,\n): (route: PrerenderRoute) => Promise<void> {\n  return async (route: PrerenderRoute) => {\n    if (!route.contents || typeof route.contents !== 'string') {\n      return;\n    }\n\n    const locale = detectLocaleFromRoute(route.route, i18n);\n    if (!locale) {\n      return;\n    }\n\n    // Inject or replace the lang attribute on <html>\n    route.contents = setHtmlLang(route.contents, locale);\n  };\n}\n\n/**\n * Detects the locale from a prerendered route path by checking\n * the first path segment against the configured locales.\n */\nexport function detectLocaleFromRoute(\n  route: string,\n  i18n: I18nPrerenderOptions,\n): string {\n  const segments = route.split('/').filter(Boolean);\n  const firstSegment = segments[0];\n\n  if (firstSegment && i18n.locales.includes(firstSegment)) {\n    return firstSegment;\n  }\n\n  return i18n.defaultLocale;\n}\n\n/**\n * Sets the `lang` attribute on the `<html>` tag in an HTML string.\n * If a `lang` attribute already exists, it is replaced.\n * If no `lang` attribute exists, it is added.\n */\nexport function setHtmlLang(html: string, locale: string): string {\n  // Replace existing lang attribute\n  if (/<html[^>]*\\slang\\s*=\\s*[\"'][^\"']*[\"']/i.test(html)) {\n    return html.replace(\n      /(<html[^>]*\\s)lang\\s*=\\s*[\"'][^\"']*[\"']/i,\n      `$1lang=\"${locale}\"`,\n    );\n  }\n\n  // Add lang attribute to <html> tag\n  return html.replace(/<html/i, `<html lang=\"${locale}\"`);\n}\n"],"mappings":";;;;;AA0EA,SAAgB,sBACd,OACA,MACQ;CAER,MAAM,eADW,MAAM,MAAM,IAAI,CAAC,OAAO,QAAQ,CACnB;AAE9B,KAAI,gBAAgB,KAAK,QAAQ,SAAS,aAAa,CACrD,QAAO;AAGT,QAAO,KAAK;;;;;;;AAQd,SAAgB,YAAY,MAAc,QAAwB;AAEhE,KAAI,yCAAyC,KAAK,KAAK,CACrD,QAAO,KAAK,QACV,4CACA,WAAW,OAAO,GACnB;AAIH,QAAO,KAAK,QAAQ,UAAU,eAAe,OAAO,GAAG"}

package/src/lib/utils/load-esm.d.ts

@@ -1,21 +1,21 @@
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { URL } from 'node:url';
+* @license
+* Copyright Google LLC All Rights Reserved.
+*
+* Use of this source code is governed by an MIT-style license that can be
+* found in the LICENSE file at https://angular.dev/license
+*/
+import { URL } from "node:url";
 /**
- * This uses a dynamic import to load a module which may be ESM.
- * CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
- * will currently, unconditionally downlevel dynamic import into a require call.
- * require calls cannot load ESM code and will result in a runtime error. To workaround
- * this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
- * Once TypeScript provides support for keeping the dynamic import this workaround can
- * be dropped.
- *
- * @param modulePath The path of the module to load.
- * @returns A Promise that resolves to the dynamically imported module.
- */
+* This uses a dynamic import to load a module which may be ESM.
+* CommonJS code can load ESM code via a dynamic import. Unfortunately, TypeScript
+* will currently, unconditionally downlevel dynamic import into a require call.
+* require calls cannot load ESM code and will result in a runtime error. To workaround
+* this, a Function constructor is used to prevent TypeScript from changing the dynamic import.
+* Once TypeScript provides support for keeping the dynamic import this workaround can
+* be dropped.
+*
+* @param modulePath The path of the module to load.
+* @returns A Promise that resolves to the dynamically imported module.
+*/
 export declare function loadEsmModule<T>(modulePath: string | URL): Promise<T>;

package/src/lib/utils/node-web-bridge.d.ts

@@ -1,3 +1,3 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { IncomingMessage, ServerResponse } from "node:http";
 export declare function toWebRequest(req: IncomingMessage): Request;
 export declare function writeWebResponseToNode(res: ServerResponse, response: Response): Promise<void>;

package/src/lib/utils/node-web-bridge.js

@@ -1,50 +1,55 @@
-import { Readable } from 'node:stream';
-import { pipeline } from 'node:stream/promises';
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+//#region packages/vite-plugin-nitro/src/lib/utils/node-web-bridge.ts
 function toWebHeaders(headers) {
-    return Object.entries(headers).reduce((acc, [key, value]) => {
-        if (value) {
-            acc.set(key, Array.isArray(value) ? value.join(', ') : value);
-        }
-        return acc;
-    }, new Headers());
+	return Object.entries(headers).reduce((acc, [key, value]) => {
+		if (value && !key.startsWith(":")) acc.set(key, Array.isArray(value) ? value.join(", ") : value);
+		return acc;
+	}, new Headers());
 }
-export function toWebRequest(req) {
-    const protocol = 'http';
-    const host = req.headers.host || 'localhost';
-    const url = new URL(req.url || '/', `${protocol}://${host}`);
-    const body = req.method && !['GET', 'HEAD'].includes(req.method)
-        ? Readable.toWeb(req)
-        : undefined;
-    return new Request(url, {
-        method: req.method,
-        headers: toWebHeaders(req.headers),
-        body,
-        // @ts-expect-error duplex is required for streaming request bodies in Node.js
-        duplex: body ? 'half' : undefined,
-    });
+function toWebRequest(req) {
+	const protocol = "http";
+	const host = req.headers.host || "localhost";
+	const url = new URL(req.url || "/", `${protocol}://${host}`);
+	const body = req.method && !["GET", "HEAD"].includes(req.method) ? Readable.toWeb(req) : void 0;
+	return new Request(url, {
+		method: req.method,
+		headers: toWebHeaders(req.headers),
+		body,
+		duplex: body ? "half" : void 0
+	});
 }
-export async function writeWebResponseToNode(res, response) {
-    res.statusCode = response.status;
-    res.statusMessage = response.statusText;
-    const setCookies = 'getSetCookie' in response.headers &&
-        typeof response.headers.getSetCookie === 'function'
-        ? response.headers.getSetCookie()
-        : [];
-    if (setCookies.length > 0) {
-        res.setHeader('set-cookie', setCookies);
-    }
-    response.headers.forEach((value, key) => {
-        if (key !== 'set-cookie') {
-            res.setHeader(key, value);
-        }
-    });
-    if (!response.body) {
-        res.end();
-        return;
-    }
-    // The Web ReadableStream and Node.js stream/web ReadableStream types
-    // are structurally identical at runtime but TypeScript treats them as
-    // distinct nominal types. The double-cast bridges this gap safely.
-    await pipeline(Readable.fromWeb(response.body), res);
+function isClientDisconnectError(error, res) {
+	if (!(error instanceof Error)) return false;
+	const hasDisconnectCode = "code" in error && typeof error.code === "string" && [
+		"ERR_STREAM_PREMATURE_CLOSE",
+		"ERR_INVALID_STATE",
+		"ECONNRESET",
+		"EPIPE"
+	].includes(error.code);
+	const hasDisconnectMessage = /closed or destroyed stream/i.test(error.message);
+	return (res.destroyed || res.writableEnded) && (hasDisconnectCode || hasDisconnectMessage);
 }
+async function writeWebResponseToNode(res, response) {
+	res.statusCode = response.status;
+	res.statusMessage = response.statusText;
+	const setCookies = "getSetCookie" in response.headers && typeof response.headers.getSetCookie === "function" ? response.headers.getSetCookie() : [];
+	if (setCookies.length > 0) res.setHeader("set-cookie", setCookies);
+	response.headers.forEach((value, key) => {
+		if (key !== "set-cookie") res.setHeader(key, value);
+	});
+	if (!response.body) {
+		res.end();
+		return;
+	}
+	try {
+		await pipeline(Readable.fromWeb(response.body), res);
+	} catch (error) {
+		if (isClientDisconnectError(error, res)) return;
+		throw error;
+	}
+}
+//#endregion
+export { toWebRequest, writeWebResponseToNode };
+
 //# sourceMappingURL=node-web-bridge.js.map

package/src/lib/utils/node-web-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-web-bridge.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/node-web-bridge.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,SAAS,YAAY,CAAC,OAA4B;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1D,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAoB;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,QAAQ,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GACR,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;QACjD,CAAC,CAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAgC;QACrD,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;QAClC,IAAI;QACJ,8EAA8E;QAC9E,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAmB,EACnB,QAAkB;IAElB,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjC,GAAG,CAAC,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC;IAExC,MAAM,UAAU,GACd,cAAc,IAAI,QAAQ,CAAC,OAAO;QAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,KAAK,UAAU;QACjD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;QACjC,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtC,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,GAAG,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,QAAQ,CACZ,QAAQ,CAAC,OAAO,CACd,QAAQ,CAAC,IAA2D,CACrE,EACD,GAAG,CACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"node-web-bridge.js","names":[],"sources":["../../../../src/lib/utils/node-web-bridge.ts"],"sourcesContent":["import type {\n  IncomingHttpHeaders,\n  IncomingMessage,\n  ServerResponse,\n} from 'node:http';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nfunction toWebHeaders(headers: IncomingHttpHeaders) {\n  return Object.entries(headers).reduce((acc, [key, value]) => {\n    if (value && !key.startsWith(':')) {\n      acc.set(key, Array.isArray(value) ? value.join(', ') : value);\n    }\n\n    return acc;\n  }, new Headers());\n}\n\nexport function toWebRequest(req: IncomingMessage): Request {\n  const protocol = 'http';\n  const host = req.headers.host || 'localhost';\n  const url = new URL(req.url || '/', `${protocol}://${host}`);\n  const body =\n    req.method && !['GET', 'HEAD'].includes(req.method)\n      ? (Readable.toWeb(req) as ReadableStream<Uint8Array>)\n      : undefined;\n\n  return new Request(url, {\n    method: req.method,\n    headers: toWebHeaders(req.headers),\n    body,\n    // @ts-expect-error duplex is required for streaming request bodies in Node.js\n    duplex: body ? 'half' : undefined,\n  });\n}\n\nfunction isClientDisconnectError(error: unknown, res: ServerResponse): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  const hasDisconnectCode =\n    'code' in error &&\n    typeof error.code === 'string' &&\n    [\n      'ERR_STREAM_PREMATURE_CLOSE',\n      'ERR_INVALID_STATE',\n      'ECONNRESET',\n      'EPIPE',\n    ].includes(error.code);\n\n  const hasDisconnectMessage = /closed or destroyed stream/i.test(\n    error.message,\n  );\n\n  return (\n    (res.destroyed || res.writableEnded) &&\n    (hasDisconnectCode || hasDisconnectMessage)\n  );\n}\n\nexport async function writeWebResponseToNode(\n  res: ServerResponse,\n  response: Response,\n): Promise<void> {\n  res.statusCode = response.status;\n  res.statusMessage = response.statusText;\n\n  const setCookies =\n    'getSetCookie' in response.headers &&\n    typeof response.headers.getSetCookie === 'function'\n      ? response.headers.getSetCookie()\n      : [];\n\n  if (setCookies.length > 0) {\n    res.setHeader('set-cookie', setCookies);\n  }\n\n  response.headers.forEach((value, key) => {\n    if (key !== 'set-cookie') {\n      res.setHeader(key, value);\n    }\n  });\n\n  if (!response.body) {\n    res.end();\n    return;\n  }\n\n  // The Web ReadableStream and Node.js stream/web ReadableStream types\n  // are structurally identical at runtime but TypeScript treats them as\n  // distinct nominal types. The double-cast bridges this gap safely.\n  try {\n    await pipeline(\n      Readable.fromWeb(\n        response.body as unknown as import('node:stream/web').ReadableStream,\n      ),\n      res,\n    );\n  } catch (error) {\n    // Long-lived dev responses such as SSE can be interrupted by a browser\n    // refresh or HMR-triggered reconnect. Those closed-stream cases are\n    // expected and should not surface as noisy server errors.\n    if (isClientDisconnectError(error, res)) {\n      return;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":";;;AAQA,SAAS,aAAa,SAA8B;AAClD,QAAO,OAAO,QAAQ,QAAQ,CAAC,QAAQ,KAAK,CAAC,KAAK,WAAW;AAC3D,MAAI,SAAS,CAAC,IAAI,WAAW,IAAI,CAC/B,KAAI,IAAI,KAAK,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM;AAG/D,SAAO;IACN,IAAI,SAAS,CAAC;;AAGnB,SAAgB,aAAa,KAA+B;CAC1D,MAAM,WAAW;CACjB,MAAM,OAAO,IAAI,QAAQ,QAAQ;CACjC,MAAM,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG,SAAS,KAAK,OAAO;CAC5D,MAAM,OACJ,IAAI,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,GAC9C,SAAS,MAAM,IAAI,GACpB,KAAA;AAEN,QAAO,IAAI,QAAQ,KAAK;EACtB,QAAQ,IAAI;EACZ,SAAS,aAAa,IAAI,QAAQ;EAClC;EAEA,QAAQ,OAAO,SAAS,KAAA;EACzB,CAAC;;AAGJ,SAAS,wBAAwB,OAAgB,KAA8B;AAC7E,KAAI,EAAE,iBAAiB,OACrB,QAAO;CAGT,MAAM,oBACJ,UAAU,SACV,OAAO,MAAM,SAAS,YACtB;EACE;EACA;EACA;EACA;EACD,CAAC,SAAS,MAAM,KAAK;CAExB,MAAM,uBAAuB,8BAA8B,KACzD,MAAM,QACP;AAED,SACG,IAAI,aAAa,IAAI,mBACrB,qBAAqB;;AAI1B,eAAsB,uBACpB,KACA,UACe;AACf,KAAI,aAAa,SAAS;AAC1B,KAAI,gBAAgB,SAAS;CAE7B,MAAM,aACJ,kBAAkB,SAAS,WAC3B,OAAO,SAAS,QAAQ,iBAAiB,aACrC,SAAS,QAAQ,cAAc,GAC/B,EAAE;AAER,KAAI,WAAW,SAAS,EACtB,KAAI,UAAU,cAAc,WAAW;AAGzC,UAAS,QAAQ,SAAS,OAAO,QAAQ;AACvC,MAAI,QAAQ,aACV,KAAI,UAAU,KAAK,MAAM;GAE3B;AAEF,KAAI,CAAC,SAAS,MAAM;AAClB,MAAI,KAAK;AACT;;AAMF,KAAI;AACF,QAAM,SACJ,SAAS,QACP,SAAS,KACV,EACD,IACD;UACM,OAAO;AAId,MAAI,wBAAwB,OAAO,IAAI,CACrC;AAGF,QAAM"}

package/src/lib/utils/register-dev-middleware.d.ts

@@ -1,14 +1,14 @@
-import { ViteDevServer } from 'vite';
+import { ViteDevServer } from "vite";
 /**
- * Registers development server middleware by discovering and loading middleware files.
- *
- * Each discovered h3 middleware module is loaded through Vite's SSR loader,
- * wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.
- * If the middleware does not write a response, control falls through to the
- * next Vite middleware.
- *
- * @param root The project root directory path
- * @param sourceRoot The source directory path (e.g., 'src')
- * @param viteServer The Vite development server instance
- */
+* Registers development server middleware by discovering and loading middleware files.
+*
+* Each discovered h3 middleware module is loaded through Vite's SSR loader,
+* wrapped in a temporary H3 app, then bridged back into Vite's Connect stack.
+* If the middleware does not write a response, control falls through to the
+* next Vite middleware.
+*
+* @param root The project root directory path
+* @param sourceRoot The source directory path (e.g., 'src')
+* @param viteServer The Vite development server instance
+*/
 export declare function registerDevServerMiddleware(root: string, sourceRoot: string, viteServer: ViteDevServer): Promise<void>;