@analogjs/platform 3.0.0-alpha.55 → 3.0.0-alpha.57

package/src/lib/nitro/angular-linker-plugin.js

@@ -0,0 +1,51 @@
+//#region packages/platform/src/lib/nitro/angular-linker-plugin.ts
+/**
+* Rolldown plugin that runs the Angular Linker against partially-compiled
+* Angular npm packages.
+*
+* Wired into `ssr.optimizeDeps.rolldownOptions.plugins` so the SSR /
+* `nitro` environment's dep optimizer turns `ɵɵngDeclare*` partial
+* declarations into fully-compiled definitions. Without this, the
+* server bundle would need JIT (eval) at runtime — forbidden on
+* `workerd` / edge runtimes and unnecessary anywhere else.
+*
+* Loaded lazily so apps that never trigger the SSR optimizer don't
+* incur the babel + compiler-cli/linker cost.
+*/
+function angularLinkerPlugin() {
+	let linkerBabelPlugin;
+	let needsLinkingFn;
+	let transformAsyncFn;
+	async function ensureLoaded() {
+		if (linkerBabelPlugin && needsLinkingFn && transformAsyncFn) return;
+		needsLinkingFn = (await import("@angular/compiler-cli/linker")).needsLinking;
+		const linkerBabel = await import("@angular/compiler-cli/linker/babel");
+		linkerBabelPlugin = linkerBabel.default ?? linkerBabel;
+		transformAsyncFn = (await import("@babel/core")).transformAsync;
+	}
+	return {
+		name: "analogjs-platform-angular-linker",
+		async transform(code, id) {
+			if (!id.endsWith(".mjs") && !id.endsWith(".js")) return;
+			if (!code.includes("ɵɵngDeclare")) return;
+			await ensureLoaded();
+			if (!needsLinkingFn(id, code)) return;
+			const result = await transformAsyncFn(code, {
+				filename: id,
+				plugins: [linkerBabelPlugin],
+				sourceMaps: true,
+				compact: false,
+				configFile: false,
+				babelrc: false
+			});
+			if (result?.code) return {
+				code: result.code,
+				map: result.map ?? null
+			};
+		}
+	};
+}
+//#endregion
+export { angularLinkerPlugin };
+
+//# sourceMappingURL=angular-linker-plugin.js.map

package/src/lib/nitro/angular-linker-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-linker-plugin.js","names":[],"sources":["../../../../src/lib/nitro/angular-linker-plugin.ts"],"sourcesContent":["/**\n * Rolldown plugin that runs the Angular Linker against partially-compiled\n * Angular npm packages.\n *\n * Wired into `ssr.optimizeDeps.rolldownOptions.plugins` so the SSR /\n * `nitro` environment's dep optimizer turns `ɵɵngDeclare*` partial\n * declarations into fully-compiled definitions. Without this, the\n * server bundle would need JIT (eval) at runtime — forbidden on\n * `workerd` / edge runtimes and unnecessary anywhere else.\n *\n * Loaded lazily so apps that never trigger the SSR optimizer don't\n * incur the babel + compiler-cli/linker cost.\n */\nexport function angularLinkerPlugin() {\n  let linkerBabelPlugin: unknown;\n  let needsLinkingFn: ((id: string, code: string) => boolean) | undefined;\n  let transformAsyncFn:\n    | ((\n        code: string,\n        options: Record<string, unknown>,\n      ) => Promise<{ code?: string; map?: unknown } | null>)\n    | undefined;\n\n  async function ensureLoaded() {\n    if (linkerBabelPlugin && needsLinkingFn && transformAsyncFn) return;\n\n    const linker = await import('@angular/compiler-cli/linker');\n    needsLinkingFn = linker.needsLinking;\n\n    const linkerBabel = await import('@angular/compiler-cli/linker/babel');\n    linkerBabelPlugin =\n      (linkerBabel as { default?: unknown }).default ?? linkerBabel;\n\n    // @ts-expect-error — @babel/core ships without bundled type declarations\n    const babel = await import('@babel/core');\n    transformAsyncFn = babel.transformAsync;\n  }\n\n  return {\n    name: 'analogjs-platform-angular-linker',\n    async transform(code: string, id: string) {\n      if (!id.endsWith('.mjs') && !id.endsWith('.js')) return;\n\n      // Cheap pre-check before pulling babel/compiler-cli into memory.\n      if (!code.includes('ɵɵngDeclare')) return;\n\n      await ensureLoaded();\n      if (!needsLinkingFn!(id, code)) return;\n\n      const result = await transformAsyncFn!(code, {\n        filename: id,\n        plugins: [linkerBabelPlugin],\n        sourceMaps: true,\n        compact: false,\n        configFile: false,\n        babelrc: false,\n      });\n\n      if (result?.code) {\n        return { code: result.code, map: result.map ?? null };\n      }\n      return;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,sBAAsB;CACpC,IAAI;CACJ,IAAI;CACJ,IAAI;CAOJ,eAAe,eAAe;AAC5B,MAAI,qBAAqB,kBAAkB,iBAAkB;AAG7D,oBADe,MAAM,OAAO,iCACJ;EAExB,MAAM,cAAc,MAAM,OAAO;AACjC,sBACG,YAAsC,WAAW;AAIpD,sBADc,MAAM,OAAO,gBACF;;AAG3B,QAAO;EACL,MAAM;EACN,MAAM,UAAU,MAAc,IAAY;AACxC,OAAI,CAAC,GAAG,SAAS,OAAO,IAAI,CAAC,GAAG,SAAS,MAAM,CAAE;AAGjD,OAAI,CAAC,KAAK,SAAS,cAAc,CAAE;AAEnC,SAAM,cAAc;AACpB,OAAI,CAAC,eAAgB,IAAI,KAAK,CAAE;GAEhC,MAAM,SAAS,MAAM,iBAAkB,MAAM;IAC3C,UAAU;IACV,SAAS,CAAC,kBAAkB;IAC5B,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,SAAS;IACV,CAAC;AAEF,OAAI,QAAQ,KACV,QAAO;IAAE,MAAM,OAAO;IAAM,KAAK,OAAO,OAAO;IAAM;;EAI1D"}

package/src/lib/nitro/build-sitemap.d.ts

@@ -0,0 +1,23 @@
+import { UserConfig } from "vite";
+import type { I18nPrerenderOptions, PrerenderSitemapConfig, SitemapConfig, SitemapEntry } from "./types.js";
+type RouteSitemapConfig = PrerenderSitemapConfig | (() => PrerenderSitemapConfig) | undefined;
+export type PagesJson = SitemapEntry;
+export interface BuildSitemapOptions {
+	apiPrefix?: string;
+}
+export declare function buildSitemap(_config: UserConfig, sitemapConfig: SitemapConfig, routes: (string | undefined)[] | (() => Promise<(string | undefined)[]>), outputDir: string, routeSitemaps: Record<string, RouteSitemapConfig>, buildOptions?: BuildSitemapOptions): Promise<void>;
+/**
+* Generates hreflang alternate URLs for a given page URL.
+* For a URL like `https://example.com/fr/about`, it produces alternates
+* for all configured locales.
+*/
+export declare function getHreflangAlternates(pageUrl: string, host: string, i18n: I18nPrerenderOptions): {
+	locale: string;
+	href: string;
+}[];
+/**
+* Strips a locale prefix from a URL path.
+* E.g., '/fr/about' -> '/about', '/en' -> '/'
+*/
+export declare function stripLocalePrefix(path: string, locales: string[]): string;
+export {};

package/src/lib/nitro/build-sitemap.js

@@ -0,0 +1,137 @@
+import { resolve } from "node:path";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { create } from "xmlbuilder2";
+//#region packages/platform/src/lib/nitro/build-sitemap.ts
+async function buildSitemap(_config, sitemapConfig, routes, outputDir, routeSitemaps, buildOptions = {}) {
+	const host = normalizeSitemapHost(sitemapConfig.host);
+	const sitemapData = await resolveSitemapEntries(await collectSitemapRoutes(routes, sitemapConfig.include), host, routeSitemaps, sitemapConfig, buildOptions);
+	if (!sitemapData.length) return;
+	const sitemap = createXml("urlset");
+	for (const item of sitemapData) {
+		const page = sitemap.ele("url");
+		page.ele("loc").txt(item.loc);
+		if (item.lastmod) page.ele("lastmod").txt(item.lastmod);
+		if (item.changefreq) page.ele("changefreq").txt(item.changefreq);
+		if (item.priority !== void 0) page.ele("priority").txt(String(item.priority));
+	}
+	const resolvedOutputDir = resolve(outputDir);
+	const mapPath = resolve(resolvedOutputDir, "sitemap.xml");
+	try {
+		if (!resolvedOutputDir || resolvedOutputDir === resolve()) throw new Error("Refusing to write the sitemap to the current working directory. Expected the Nitro public output directory instead.");
+		if (!existsSync(resolvedOutputDir)) mkdirSync(resolvedOutputDir, { recursive: true });
+		console.log(`Writing sitemap at ${mapPath}`);
+		writeFileSync(mapPath, sitemap.end({ prettyPrint: true }));
+	} catch (e) {
+		console.error(`Unable to write file at ${mapPath}`, e);
+	}
+}
+async function resolveSitemapEntries(routes, host, routeSitemaps, sitemapConfig, buildOptions) {
+	const defaults = sitemapConfig.defaults ?? {};
+	const seen = /* @__PURE__ */ new Set();
+	const entries = [];
+	for (const route of routes) {
+		const entry = await toSitemapEntry(route, host, routeSitemaps, defaults, sitemapConfig.transform);
+		if (!entry) continue;
+		if (isInternalSitemapRoute(entry.route, buildOptions.apiPrefix) || await isExcludedSitemapRoute(entry, sitemapConfig.exclude)) continue;
+		if (seen.has(entry.loc)) continue;
+		seen.add(entry.loc);
+		entries.push(entry);
+	}
+	return entries;
+}
+async function toSitemapEntry(route, host, routeSitemaps, defaults, transform) {
+	const normalizedRoute = normalizeSitemapRoute(typeof route === "string" ? route : route?.route);
+	if (!normalizedRoute) return;
+	const baseEntry = createSitemapEntry({
+		...defaults,
+		...resolveRouteSitemapConfig(routeSitemaps[normalizedRoute]),
+		...typeof route === "object" ? route : {},
+		route: normalizedRoute
+	}, host);
+	if (!transform) return baseEntry;
+	const transformed = await transform(baseEntry);
+	if (!transformed) return;
+	return createSitemapEntry({
+		...baseEntry,
+		...transformed
+	}, host);
+}
+function createSitemapEntry(routeDefinition, host) {
+	const route = normalizeSitemapRoute(routeDefinition.route) ?? "/";
+	return {
+		route,
+		loc: new URL(route, ensureTrailingSlash(host)).toString(),
+		lastmod: routeDefinition.lastmod,
+		changefreq: routeDefinition.changefreq,
+		priority: routeDefinition.priority
+	};
+}
+function resolveRouteSitemapConfig(config) {
+	if (!config) return {};
+	return typeof config === "function" ? config() : config;
+}
+function normalizeSitemapHost(host) {
+	const resolvedHost = new URL(host);
+	resolvedHost.hash = "";
+	return resolvedHost.toString();
+}
+function ensureTrailingSlash(host) {
+	return host.endsWith("/") ? host : `${host}/`;
+}
+function normalizeSitemapRoute(route) {
+	if (!route) return;
+	const trimmedRoute = route.trim();
+	if (!trimmedRoute) return;
+	const [pathname, search] = (trimmedRoute.split("#", 1)[0] ?? "").split("?", 2);
+	const normalizedPathname = pathname ? `/${pathname.replace(/^\/+/, "").replace(/\/{2,}/g, "/")}` : "/";
+	return search ? `${normalizedPathname}?${search}` : normalizedPathname;
+}
+function isInternalSitemapRoute(route, apiPrefix = "api") {
+	const normalizedApiPrefix = normalizeSitemapRoute(`/${apiPrefix}`) ?? "/api";
+	return route === `${normalizedApiPrefix}/_analog/pages` || route.startsWith(`${normalizedApiPrefix}/_analog/pages/`);
+}
+async function isExcludedSitemapRoute(entry, excludeRules) {
+	if (!excludeRules?.length) return false;
+	for (const rule of excludeRules) {
+		if (typeof rule === "function") {
+			if (await rule(entry)) return true;
+			continue;
+		}
+		if (rule instanceof RegExp) {
+			if (rule.test(entry.route)) return true;
+			continue;
+		}
+		if (toGlobRegExp(rule).test(entry.route)) return true;
+	}
+	return false;
+}
+function toGlobRegExp(pattern) {
+	const doubleStarToken = "__ANALOG_DOUBLE_STAR__";
+	const singleStarToken = "__ANALOG_SINGLE_STAR__";
+	const regexPattern = pattern.replace(/\*\*/g, doubleStarToken).replace(/\*/g, singleStarToken).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(new RegExp(doubleStarToken, "g"), ".*").replace(new RegExp(singleStarToken, "g"), "[^/]*");
+	return new RegExp(`^${regexPattern}$`);
+}
+async function collectSitemapRoutes(routes, include) {
+	const routeList = await resolveRouteInputs(routes);
+	const includedRoutes = include ? await resolveRouteInputs(include) : [];
+	return [...routeList, ...includedRoutes];
+}
+async function resolveRouteInputs(routes) {
+	let routeList;
+	if (typeof routes === "function") routeList = await routes();
+	else if (Array.isArray(routes)) routeList = routes;
+	else routeList = [];
+	return routeList.filter(Boolean);
+}
+function createXml(elementName, includeXhtml = false) {
+	const attrs = { xmlns: "https://www.sitemaps.org/schemas/sitemap/0.9" };
+	if (includeXhtml) attrs["xmlns:xhtml"] = "https://www.w3.org/1999/xhtml";
+	return create({
+		version: "1.0",
+		encoding: "UTF-8"
+	}).ele(elementName, attrs).com(`This file was automatically generated by Analog.`);
+}
+//#endregion
+export { buildSitemap };
+
+//# sourceMappingURL=build-sitemap.js.map

package/src/lib/nitro/build-sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-sitemap.js","names":[],"sources":["../../../../src/lib/nitro/build-sitemap.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { create } from 'xmlbuilder2';\nimport type { XMLBuilder } from 'xmlbuilder2/lib/interfaces';\nimport { UserConfig } from 'vite';\nimport type {\n  I18nPrerenderOptions,\n  PrerenderSitemapConfig,\n  SitemapConfig,\n  SitemapEntry,\n  SitemapExcludeRule,\n  SitemapRouteDefinition,\n  SitemapRouteInput,\n  SitemapRouteSource,\n} from './types.js';\n\ntype RouteSitemapConfig =\n  | PrerenderSitemapConfig\n  | (() => PrerenderSitemapConfig)\n  | undefined;\n\nexport type PagesJson = SitemapEntry;\n\nexport interface BuildSitemapOptions {\n  apiPrefix?: string;\n}\n\nexport async function buildSitemap(\n  _config: UserConfig,\n  sitemapConfig: SitemapConfig,\n  routes: (string | undefined)[] | (() => Promise<(string | undefined)[]>),\n  outputDir: string,\n  routeSitemaps: Record<string, RouteSitemapConfig>,\n  buildOptions: BuildSitemapOptions = {},\n): Promise<void> {\n  const host = normalizeSitemapHost(sitemapConfig.host);\n  const routeList = await collectSitemapRoutes(routes, sitemapConfig.include);\n  const sitemapData = await resolveSitemapEntries(\n    routeList,\n    host,\n    routeSitemaps,\n    sitemapConfig,\n    buildOptions,\n  );\n\n  if (!sitemapData.length) {\n    return;\n  }\n\n  const sitemap = createXml('urlset');\n\n  for (const item of sitemapData) {\n    const page = sitemap.ele('url');\n    page.ele('loc').txt(item.loc);\n\n    if (item.lastmod) {\n      page.ele('lastmod').txt(item.lastmod);\n    }\n\n    if (item.changefreq) {\n      page.ele('changefreq').txt(item.changefreq);\n    }\n\n    if (item.priority !== undefined) {\n      page.ele('priority').txt(String(item.priority));\n    }\n  }\n\n  const resolvedOutputDir = resolve(outputDir);\n  const mapPath = resolve(resolvedOutputDir, 'sitemap.xml');\n  try {\n    if (!resolvedOutputDir || resolvedOutputDir === resolve()) {\n      throw new Error(\n        'Refusing to write the sitemap to the current working directory. Expected the Nitro public output directory instead.',\n      );\n    }\n\n    if (!existsSync(resolvedOutputDir)) {\n      mkdirSync(resolvedOutputDir, { recursive: true });\n    }\n    console.log(`Writing sitemap at ${mapPath}`);\n    writeFileSync(mapPath, sitemap.end({ prettyPrint: true }));\n  } catch (e) {\n    console.error(`Unable to write file at ${mapPath}`, e);\n  }\n}\n\nasync function resolveSitemapEntries(\n  routes: SitemapRouteInput[],\n  host: string,\n  routeSitemaps: Record<string, RouteSitemapConfig>,\n  sitemapConfig: SitemapConfig,\n  buildOptions: BuildSitemapOptions,\n): Promise<SitemapEntry[]> {\n  const defaults = sitemapConfig.defaults ?? {};\n  const seen = new Set<string>();\n  const entries: SitemapEntry[] = [];\n\n  for (const route of routes) {\n    const entry = await toSitemapEntry(\n      route,\n      host,\n      routeSitemaps,\n      defaults,\n      sitemapConfig.transform,\n    );\n\n    if (!entry) {\n      continue;\n    }\n\n    if (\n      isInternalSitemapRoute(entry.route, buildOptions.apiPrefix) ||\n      (await isExcludedSitemapRoute(entry, sitemapConfig.exclude))\n    ) {\n      continue;\n    }\n\n    if (seen.has(entry.loc)) {\n      continue;\n    }\n\n    seen.add(entry.loc);\n    entries.push(entry);\n  }\n\n  return entries;\n}\n\nasync function toSitemapEntry(\n  route: SitemapRouteInput,\n  host: string,\n  routeSitemaps: Record<string, RouteSitemapConfig>,\n  defaults: PrerenderSitemapConfig,\n  transform: SitemapConfig['transform'],\n): Promise<SitemapEntry | undefined> {\n  const normalizedRoute = normalizeSitemapRoute(\n    typeof route === 'string' ? route : route?.route,\n  );\n  if (!normalizedRoute) {\n    return undefined;\n  }\n\n  const baseEntry = createSitemapEntry(\n    {\n      ...defaults,\n      ...resolveRouteSitemapConfig(routeSitemaps[normalizedRoute]),\n      ...(typeof route === 'object' ? route : {}),\n      route: normalizedRoute,\n    },\n    host,\n  );\n\n  if (!transform) {\n    return baseEntry;\n  }\n\n  const transformed = await transform(baseEntry);\n  if (!transformed) {\n    return undefined;\n  }\n\n  return createSitemapEntry(\n    {\n      ...baseEntry,\n      ...transformed,\n    },\n    host,\n  );\n}\n\nfunction createSitemapEntry(\n  routeDefinition: SitemapRouteDefinition,\n  host: string,\n): SitemapEntry {\n  const route = normalizeSitemapRoute(routeDefinition.route) ?? '/';\n\n  return {\n    route,\n    loc: new URL(route, ensureTrailingSlash(host)).toString(),\n    lastmod: routeDefinition.lastmod,\n    changefreq: routeDefinition.changefreq,\n    priority: routeDefinition.priority,\n  };\n}\n\nfunction resolveRouteSitemapConfig(\n  config: RouteSitemapConfig,\n): PrerenderSitemapConfig {\n  if (!config) {\n    return {};\n  }\n\n  return typeof config === 'function' ? config() : config;\n}\n\nfunction normalizeSitemapHost(host: string): string {\n  const resolvedHost = new URL(host);\n  resolvedHost.hash = '';\n  return resolvedHost.toString();\n}\n\nfunction ensureTrailingSlash(host: string): string {\n  return host.endsWith('/') ? host : `${host}/`;\n}\n\nfunction normalizeSitemapRoute(route: string | undefined): string | undefined {\n  if (!route) {\n    return undefined;\n  }\n\n  const trimmedRoute = route.trim();\n  if (!trimmedRoute) {\n    return undefined;\n  }\n\n  const pathWithQuery = trimmedRoute.split('#', 1)[0] ?? '';\n  const [pathname, search] = pathWithQuery.split('?', 2);\n  const normalizedPathname = pathname\n    ? `/${pathname.replace(/^\\/+/, '').replace(/\\/{2,}/g, '/')}`\n    : '/';\n\n  return search ? `${normalizedPathname}?${search}` : normalizedPathname;\n}\n\nfunction isInternalSitemapRoute(route: string, apiPrefix = 'api'): boolean {\n  const normalizedApiPrefix = normalizeSitemapRoute(`/${apiPrefix}`) ?? '/api';\n  return (\n    route === `${normalizedApiPrefix}/_analog/pages` ||\n    route.startsWith(`${normalizedApiPrefix}/_analog/pages/`)\n  );\n}\n\nasync function isExcludedSitemapRoute(\n  entry: SitemapEntry,\n  excludeRules: SitemapExcludeRule[] | undefined,\n): Promise<boolean> {\n  if (!excludeRules?.length) {\n    return false;\n  }\n\n  for (const rule of excludeRules) {\n    if (typeof rule === 'function') {\n      if (await rule(entry)) {\n        return true;\n      }\n      continue;\n    }\n\n    if (rule instanceof RegExp) {\n      if (rule.test(entry.route)) {\n        return true;\n      }\n      continue;\n    }\n\n    if (toGlobRegExp(rule).test(entry.route)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction toGlobRegExp(pattern: string): RegExp {\n  const doubleStarToken = '__ANALOG_DOUBLE_STAR__';\n  const singleStarToken = '__ANALOG_SINGLE_STAR__';\n  const escapedPattern = pattern\n    .replace(/\\*\\*/g, doubleStarToken)\n    .replace(/\\*/g, singleStarToken)\n    .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&');\n  const regexPattern = escapedPattern\n    .replace(new RegExp(doubleStarToken, 'g'), '.*')\n    .replace(new RegExp(singleStarToken, 'g'), '[^/]*');\n  return new RegExp(`^${regexPattern}$`);\n}\n\nasync function collectSitemapRoutes(\n  routes: (string | undefined)[] | (() => Promise<(string | undefined)[]>),\n  include?: SitemapRouteSource,\n): Promise<SitemapRouteInput[]> {\n  const routeList = await resolveRouteInputs(routes);\n  const includedRoutes = include ? await resolveRouteInputs(include) : [];\n  return [...routeList, ...includedRoutes];\n}\n\nasync function resolveRouteInputs(\n  routes:\n    | SitemapRouteSource\n    | (string | undefined)[]\n    | (() => Promise<(string | undefined)[]>),\n): Promise<SitemapRouteInput[]> {\n  let routeList: SitemapRouteInput[];\n\n  if (typeof routes === 'function') {\n    routeList = await routes();\n  } else if (Array.isArray(routes)) {\n    routeList = routes;\n  } else {\n    routeList = [];\n  }\n\n  return routeList.filter(Boolean);\n}\n\n/**\n * Generates hreflang alternate URLs for a given page URL.\n * For a URL like `https://example.com/fr/about`, it produces alternates\n * for all configured locales.\n */\nexport function getHreflangAlternates(\n  pageUrl: string,\n  host: string,\n  i18n: I18nPrerenderOptions,\n): { locale: string; href: string }[] {\n  const alternates: { locale: string; href: string }[] = [];\n  const normalizedHost = host.replace(/\\/+$/, '');\n\n  const path = pageUrl.replace(normalizedHost, '');\n  const basePath = stripLocalePrefix(path, i18n.locales);\n\n  for (const locale of i18n.locales) {\n    const localizedPath =\n      basePath === '/' || basePath === ''\n        ? `/${locale}`\n        : `/${locale}${basePath}`;\n    alternates.push({\n      locale,\n      href: `${normalizedHost}${localizedPath}`,\n    });\n  }\n\n  const defaultPath =\n    basePath === '/' || basePath === ''\n      ? `/${i18n.defaultLocale}`\n      : `/${i18n.defaultLocale}${basePath}`;\n  alternates.push({\n    locale: 'x-default',\n    href: `${normalizedHost}${defaultPath}`,\n  });\n\n  return alternates;\n}\n\n/**\n * Strips a locale prefix from a URL path.\n * E.g., '/fr/about' -> '/about', '/en' -> '/'\n */\nexport function stripLocalePrefix(path: string, locales: string[]): string {\n  const segments = path.split('/').filter(Boolean);\n  if (segments.length > 0 && locales.includes(segments[0])) {\n    const rest = segments.slice(1).join('/');\n    return rest ? `/${rest}` : '/';\n  }\n  return path || '/';\n}\n\nfunction createXml(\n  elementName: 'urlset' | 'sitemapindex',\n  includeXhtml = false,\n): XMLBuilder {\n  const attrs: Record<string, string> = {\n    xmlns: 'https://www.sitemaps.org/schemas/sitemap/0.9',\n  };\n  if (includeXhtml) {\n    attrs['xmlns:xhtml'] = 'https://www.w3.org/1999/xhtml';\n  }\n\n  return create({ version: '1.0', encoding: 'UTF-8' })\n    .ele(elementName, attrs)\n    .com(`This file was automatically generated by Analog.`);\n}\n"],"mappings":"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"}

package/src/lib/nitro/debug.d.ts

@@ -0,0 +1,5 @@
+export declare const debugNitro: unknown;
+export declare const debugSsr: unknown;
+export declare const debugPrerender: unknown;
+/** All Nitro-related debug instances, for external wrapping (e.g. file logging). */
+export declare const nitroDebugInstances: unknown;

package/src/lib/nitro/debug.js

@@ -0,0 +1,11 @@
+import { createDebug } from "obug";
+/** All Nitro-related debug instances, for external wrapping (e.g. file logging). */
+var nitroDebugInstances = [
+	createDebug("analog:nitro"),
+	createDebug("analog:nitro:ssr"),
+	createDebug("analog:nitro:prerender")
+];
+//#endregion
+export { nitroDebugInstances };
+
+//# sourceMappingURL=debug.js.map

package/src/lib/nitro/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/nitro/debug.ts"],"sourcesContent":["import { createDebug } from 'obug';\n\nexport const debugNitro = createDebug('analog:nitro');\nexport const debugSsr = createDebug('analog:nitro:ssr');\nexport const debugPrerender = createDebug('analog:nitro:prerender');\n\n/** All Nitro-related debug instances, for external wrapping (e.g. file logging). */\nexport const nitroDebugInstances = [debugNitro, debugSsr, debugPrerender];\n"],"mappings":";;AAOA,IAAa,sBAAsB;CALT,YAAY,eAAe;CAC7B,YAAY,mBAAmB;CACzB,YAAY,yBAAyB;CAGM"}

package/src/lib/nitro/get-content-files.d.ts

@@ -0,0 +1,13 @@
+import type { PrerenderContentFile } from "./types.js";
+/**
+* Discovers content files with front matter and extracts metadata for prerendering.
+*
+* Globs the resolved content directory, reads each match, parses YAML/TOML
+* front matter via `front-matter`, and returns `PrerenderContentFile`
+* entries used by `PrerenderContentDir.transform()` to map files to routes.
+*
+* When `recursive` is enabled, `relativePath` on each result captures the
+* file's directory relative to `contentDir` so transforms can disambiguate
+* identically-named files across subdirectories.
+*/
+export declare function getMatchingContentFilesWithFrontMatter(workspaceRoot: string, rootDir: string, glob: string, recursive?: boolean): PrerenderContentFile[];

package/src/lib/nitro/get-content-files.js

@@ -0,0 +1,52 @@
+import { basename, join, relative, resolve } from "node:path";
+import { readFileSync } from "node:fs";
+import { normalizePath } from "vite";
+import { globSync } from "tinyglobby";
+import { createRequire } from "node:module";
+//#region packages/platform/src/lib/nitro/get-content-files.ts
+var require = createRequire(import.meta.url);
+/**
+* Discovers content files with front matter and extracts metadata for prerendering.
+*
+* Globs the resolved content directory, reads each match, parses YAML/TOML
+* front matter via `front-matter`, and returns `PrerenderContentFile`
+* entries used by `PrerenderContentDir.transform()` to map files to routes.
+*
+* When `recursive` is enabled, `relativePath` on each result captures the
+* file's directory relative to `contentDir` so transforms can disambiguate
+* identically-named files across subdirectories.
+*/
+function getMatchingContentFilesWithFrontMatter(workspaceRoot, rootDir, glob, recursive = false) {
+	const fm = require("front-matter");
+	const root = normalizePath(resolve(workspaceRoot, rootDir));
+	const resolvedDir = normalizePath(relative(root, join(root, glob)));
+	const contentFiles = globSync([recursive ? `${root}/${resolvedDir}/**/*` : `${root}/${resolvedDir}/*`], {
+		dot: true,
+		absolute: true,
+		onlyFiles: true
+	});
+	const dirPrefix = `${root}/${resolvedDir}`;
+	return contentFiles.map((f) => {
+		const fileContents = readFileSync(f, "utf8");
+		const raw = fm(fileContents);
+		const filename = basename(normalizePath(f));
+		const dot = filename.lastIndexOf(".");
+		const name = dot === -1 ? filename : filename.slice(0, dot);
+		const extension = dot === -1 ? "" : filename.slice(dot + 1);
+		const relativeDir = normalizePath(relative(dirPrefix, f));
+		const lastSlash = relativeDir.lastIndexOf("/");
+		const relativePath = lastSlash === -1 ? "" : relativeDir.slice(0, lastSlash);
+		return {
+			name,
+			extension,
+			path: resolvedDir,
+			attributes: raw.attributes,
+			content: fileContents,
+			relativePath
+		};
+	});
+}
+//#endregion
+export { getMatchingContentFilesWithFrontMatter };
+
+//# sourceMappingURL=get-content-files.js.map

package/src/lib/nitro/get-content-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-content-files.js","names":[],"sources":["../../../../src/lib/nitro/get-content-files.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { basename, join, relative, resolve } from 'node:path';\nimport { normalizePath } from 'vite';\nimport { createRequire } from 'node:module';\nimport { globSync } from 'tinyglobby';\n\nimport type { PrerenderContentFile } from './types.js';\n\nconst require = createRequire(import.meta.url);\n\n/**\n * Discovers content files with front matter and extracts metadata for prerendering.\n *\n * Globs the resolved content directory, reads each match, parses YAML/TOML\n * front matter via `front-matter`, and returns `PrerenderContentFile`\n * entries used by `PrerenderContentDir.transform()` to map files to routes.\n *\n * When `recursive` is enabled, `relativePath` on each result captures the\n * file's directory relative to `contentDir` so transforms can disambiguate\n * identically-named files across subdirectories.\n */\nexport function getMatchingContentFilesWithFrontMatter(\n  workspaceRoot: string,\n  rootDir: string,\n  glob: string,\n  recursive = false,\n): PrerenderContentFile[] {\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const fm = require('front-matter');\n\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n  const resolvedDir = normalizePath(relative(root, join(root, glob)));\n\n  const pattern = recursive\n    ? `${root}/${resolvedDir}/**/*`\n    : `${root}/${resolvedDir}/*`;\n  const contentFiles: string[] = globSync([pattern], {\n    dot: true,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const dirPrefix = `${root}/${resolvedDir}`;\n\n  const mappedFilesWithFm: PrerenderContentFile[] = contentFiles.map((f) => {\n    const fileContents = readFileSync(f, 'utf8');\n    const raw = fm(fileContents);\n\n    // Split the basename on the LAST dot so file names that contain\n    // additional dots (e.g. locale suffixes like `post.en.md`) keep the\n    // inner dots in `name` and only the trailing segment becomes the\n    // extension. The previous regex stopped at the first dot and\n    // discarded everything between it and the extension.\n    const filename = basename(normalizePath(f));\n    const dot = filename.lastIndexOf('.');\n    const name = dot === -1 ? filename : filename.slice(0, dot);\n    const extension = dot === -1 ? '' : filename.slice(dot + 1);\n\n    const relativeDir = normalizePath(relative(dirPrefix, f));\n    const lastSlash = relativeDir.lastIndexOf('/');\n    const relativePath =\n      lastSlash === -1 ? '' : relativeDir.slice(0, lastSlash);\n\n    return {\n      name,\n      extension,\n      path: resolvedDir,\n      attributes: raw.attributes as { attributes: Record<string, any> },\n      content: fileContents,\n      relativePath,\n    };\n  });\n\n  return mappedFilesWithFm;\n}\n"],"mappings":";;;;;;AAQA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;;;;;;;;;;;;AAa9C,SAAgB,uCACd,eACA,SACA,MACA,YAAY,OACY;CAExB,MAAM,KAAK,QAAQ,eAAe;CAElC,MAAM,OAAO,cAAc,QAAQ,eAAe,QAAQ,CAAC;CAC3D,MAAM,cAAc,cAAc,SAAS,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC;CAKnE,MAAM,eAAyB,SAAS,CAHxB,YACZ,GAAG,KAAK,GAAG,YAAY,SACvB,GAAG,KAAK,GAAG,YAAY,IACsB,EAAE;EACjD,KAAK;EACL,UAAU;EACV,WAAW;EACZ,CAAC;CAEF,MAAM,YAAY,GAAG,KAAK,GAAG;AA+B7B,QA7BkD,aAAa,KAAK,MAAM;EACxE,MAAM,eAAe,aAAa,GAAG,OAAO;EAC5C,MAAM,MAAM,GAAG,aAAa;EAO5B,MAAM,WAAW,SAAS,cAAc,EAAE,CAAC;EAC3C,MAAM,MAAM,SAAS,YAAY,IAAI;EACrC,MAAM,OAAO,QAAQ,KAAK,WAAW,SAAS,MAAM,GAAG,IAAI;EAC3D,MAAM,YAAY,QAAQ,KAAK,KAAK,SAAS,MAAM,MAAM,EAAE;EAE3D,MAAM,cAAc,cAAc,SAAS,WAAW,EAAE,CAAC;EACzD,MAAM,YAAY,YAAY,YAAY,IAAI;EAC9C,MAAM,eACJ,cAAc,KAAK,KAAK,YAAY,MAAM,GAAG,UAAU;AAEzD,SAAO;GACL;GACA;GACA,MAAM;GACN,YAAY,IAAI;GAChB,SAAS;GACT;GACD;GACD"}

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

@@ -0,0 +1,23 @@
+import type { NitroEventHandler } from "nitro/types";
+type GetHandlersArgs = {
+	workspaceRoot: string;
+	sourceRoot: string;
+	rootDir: string;
+	additionalPagesDirs?: string[];
+	hasAPIDir?: boolean;
+};
+/**
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* Discovers all `.server.ts` files under `app/pages/**` and any additional
+* pages directories, then maps each file to a Nitro route pattern under
+* `/_analog/pages/...` (prefixed with `/api` when the project has an API dir).
+*
+* 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
+*/
+export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir }: GetHandlersArgs): NitroEventHandler[];
+export {};

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

@@ -0,0 +1,34 @@
+import { resolve } from "node:path";
+import { normalizePath } from "vite";
+import { globSync } from "tinyglobby";
+//#region packages/platform/src/lib/nitro/get-page-handlers.ts
+/**
+* Discovers and generates Nitro event handlers for server-side page routes.
+*
+* Discovers all `.server.ts` files under `app/pages/**` and any additional
+* pages directories, then maps each file to a Nitro route pattern under
+* `/_analog/pages/...` (prefixed with `/api` when the project has an API dir).
+*
+* 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
+*/
+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(/\/\(([^/]+)\)/g, "/-$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/nitro/get-page-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-page-handlers.js","names":[],"sources":["../../../../src/lib/nitro/get-page-handlers.ts"],"sourcesContent":["import { resolve } 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 * Discovers all `.server.ts` files under `app/pages/**` and any additional\n * pages directories, then maps each file to a Nitro route pattern under\n * `/_analog/pages/...` (prefixed with `/api` when the project has an API dir).\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 */\nexport function getPageHandlers({\n  workspaceRoot,\n  sourceRoot,\n  rootDir,\n  additionalPagesDirs,\n  hasAPIDir,\n}: GetHandlersArgs): NitroEventHandler[] {\n  const root = normalizePath(resolve(workspaceRoot, rootDir));\n\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  const handlers: NitroEventHandler[] = endpointFiles.map((endpointFile) => {\n    const normalized = normalizePath(endpointFile);\n    const route = normalized\n      .replace(/^(.*?)\\/pages/, '/pages')\n      .replace(/\\.server\\.ts$/, '')\n      .replace(/\\[\\.{3}(.+)\\]/g, '**:$1')\n      .replace(/\\[\\.{3}(\\w+)\\]/g, '**:$1')\n      // Strip Angular Router group syntax `(group)` from any segment, not\n      // just trailing ones. Routes like `(auth)/login.server.ts` need to\n      // become `/-auth-/login`, otherwise the literal parens leak through\n      // and the handler is mounted under an invalid Nitro path.\n      .replace(/\\/\\(([^/]+)\\)/g, '/-$1-')\n      .replace(/\\[(\\w+)\\]/g, ':$1')\n      .replace(/\\./g, '/');\n\n    return {\n      handler: endpointFile,\n      route: `${hasAPIDir ? '/api' : ''}/_analog${route}`,\n      lazy: true,\n    };\n  });\n\n  return handlers;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,SAAgB,gBAAgB,EAC9B,eACA,YACA,SACA,qBACA,aACuC;AAmCvC,QAhCgC,SAC9B,CACE,GAJS,cAAc,QAAQ,eAAe,QAAQ,CAAC,CAI/C,GAAG,WAAW,4BACtB,IAAI,uBAAuB,EAAE,EAAE,KAC5B,QAAQ,GAAG,gBAAgB,IAAI,iBACjC,CACF,EACD;EAAE,KAAK;EAAM,UAAU;EAAM,CAC9B,CAEmD,KAAK,iBAAiB;EAExE,MAAM,QADa,cAAc,aAAa,CAE3C,QAAQ,iBAAiB,SAAS,CAClC,QAAQ,iBAAiB,GAAG,CAC5B,QAAQ,kBAAkB,QAAQ,CAClC,QAAQ,mBAAmB,QAAQ,CAKnC,QAAQ,kBAAkB,QAAQ,CAClC,QAAQ,cAAc,MAAM,CAC5B,QAAQ,OAAO,IAAI;AAEtB,SAAO;GACL,SAAS;GACT,OAAO,GAAG,YAAY,SAAS,GAAG,UAAU;GAC5C,MAAM;GACP;GACD"}

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

@@ -0,0 +1,29 @@
+import type { PrerenderRoute } from "nitro/types";
+import type { I18nPrerenderOptions } from "./types.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.
+*/
+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.
+*/
+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/nitro/i18n-prerender.js

@@ -0,0 +1,61 @@
+//#region packages/platform/src/lib/nitro/i18n-prerender.ts
+/**
+* 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.
+*/
+function expandRoutesWithLocales(routes, i18n) {
+	const expanded = [];
+	for (const route of routes) {
+		if (route.includes("/_analog/") || route === "/api" || route.startsWith("/api/")) {
+			expanded.push(route);
+			continue;
+		}
+		for (const locale of i18n.locales) {
+			const prefix = `/${locale}`;
+			const localizedRoute = route === "/" ? prefix : `${prefix}${route}`;
+			expanded.push(localizedRoute);
+		}
+		if (!expanded.includes(route)) expanded.push(route);
+	}
+	return expanded;
+}
+/**
+* Creates a post-rendering hook that injects the `lang` attribute
+* into the `<html>` tag of prerendered pages based on the route's
+* locale prefix.
+*/
+function createI18nPostRenderingHook(i18n) {
+	return async (route) => {
+		if (!route.contents || typeof route.contents !== "string") return;
+		const locale = detectLocaleFromRoute(route.route, i18n);
+		if (!locale) return;
+		route.contents = setHtmlLang(route.contents, locale);
+	};
+}
+/**
+* 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 { createI18nPostRenderingHook, expandRoutesWithLocales };
+
+//# sourceMappingURL=i18n-prerender.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-prerender.js","names":[],"sources":["../../../../src/lib/nitro/i18n-prerender.ts"],"sourcesContent":["import type { PrerenderRoute } from 'nitro/types';\nimport type { I18nPrerenderOptions } from './types.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 */\nexport function expandRoutesWithLocales(\n  routes: string[],\n  i18n: I18nPrerenderOptions,\n): string[] {\n  const expanded: string[] = [];\n\n  for (const route of routes) {\n    // Skip locale expansion for internal analog endpoints and API routes.\n    // `startsWith('/api/')` alone misses the bare `/api` path, which\n    // would otherwise get locale-prefixed and produce phantom routes like\n    // `/en/api`.\n    if (\n      route.includes('/_analog/') ||\n      route === '/api' ||\n      route.startsWith('/api/')\n    ) {\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    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 */\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    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  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  return html.replace(/<html/i, `<html lang=\"${locale}\"`);\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,wBACd,QACA,MACU;CACV,MAAM,WAAqB,EAAE;AAE7B,MAAK,MAAM,SAAS,QAAQ;AAK1B,MACE,MAAM,SAAS,YAAY,IAC3B,UAAU,UACV,MAAM,WAAW,QAAQ,EACzB;AACA,YAAS,KAAK,MAAM;AACpB;;AAGF,OAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,SAAS,IAAI;GACnB,MAAM,iBAAiB,UAAU,MAAM,SAAS,GAAG,SAAS;AAC5D,YAAS,KAAK,eAAe;;AAG/B,MAAI,CAAC,SAAS,SAAS,MAAM,CAC3B,UAAS,KAAK,MAAM;;AAIxB,QAAO;;;;;;;AAQT,SAAgB,4BACd,MAC0C;AAC1C,QAAO,OAAO,UAA0B;AACtC,MAAI,CAAC,MAAM,YAAY,OAAO,MAAM,aAAa,SAC/C;EAGF,MAAM,SAAS,sBAAsB,MAAM,OAAO,KAAK;AACvD,MAAI,CAAC,OACH;AAGF,QAAM,WAAW,YAAY,MAAM,UAAU,OAAO;;;;;;;AAQxD,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;AAChE,KAAI,yCAAyC,KAAK,KAAK,CACrD,QAAO,KAAK,QACV,4CACA,WAAW,OAAO,GACnB;AAGH,QAAO,KAAK,QAAQ,UAAU,eAAe,OAAO,GAAG"}

package/src/lib/nitro/page-endpoints-plugin.d.ts

@@ -0,0 +1,7 @@
+export declare function pageEndpointsPlugin(): {
+	name: string;
+	transform(_code: string, id: string): Promise<{
+		code: string;
+		map: null;
+	} | undefined>;
+};

package/src/lib/nitro/page-endpoints-plugin.js

@@ -0,0 +1,72 @@
+import { SERVER_FETCH_FACTORY_SNIPPET } from "./renderers.js";
+import { normalizePath } from "vite";
+import { parseSync } from "oxc-parser";
+//#region packages/platform/src/lib/nitro/page-endpoints-plugin.ts
+function pageEndpointsPlugin() {
+	return {
+		name: "analogjs-platform-rollup-page-endpoint",
+		async transform(_code, id) {
+			if (normalizePath(id).includes("/pages/") && id.endsWith(".server.ts")) {
+				const fileExports = parseSync(id, _code, {
+					sourceType: "module",
+					lang: "ts"
+				}).module.staticExports.flatMap((e) => e.entries.filter((entry) => entry.exportName.name !== null).map((entry) => entry.exportName.name));
+				return {
+					code: `
+            import { defineHandler, fetchWithEvent } from 'nitro/h3';
+            import { createFetch } from 'ofetch';
+
+            ${fileExports.includes("load") ? _code : `
+                ${_code}
+                export const load = () => {
+                  return {};
+                }`}
+
+            ${fileExports.includes("action") ? "" : `
+                export const action = () => {
+                  return {};
+                }
+              `}
+
+            export default defineHandler(async(event) => {
+              ${SERVER_FETCH_FACTORY_SNIPPET}
+
+              if (event.method === 'GET') {
+                try {
+                  return await load({
+                    params: event.context?.params,
+                    req: event.node?.req,
+                    res: event.node?.res,
+                    fetch: serverFetch,
+                    event
+                  });
+                } catch(e) {
+                  console.error(\` An error occurred: \${e}\`)
+                  throw e;
+                }
+              } else {
+                try {
+                  return await action({
+                    params: event.context?.params,
+                    req: event.node?.req,
+                    res: event.node?.res,
+                    fetch: serverFetch,
+                    event
+                  });
+                } catch(e) {
+                  console.error(\` An error occurred: \${e}\`)
+                  throw e;
+                }
+              }
+            });
+          `,
+					map: null
+				};
+			}
+		}
+	};
+}
+//#endregion
+export { pageEndpointsPlugin };
+
+//# sourceMappingURL=page-endpoints-plugin.js.map

package/src/lib/nitro/page-endpoints-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-endpoints-plugin.js","names":[],"sources":["../../../../src/lib/nitro/page-endpoints-plugin.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\nimport { normalizePath } from 'vite';\nimport { SERVER_FETCH_FACTORY_SNIPPET } from './renderers.js';\n\nexport function pageEndpointsPlugin() {\n  return {\n    name: 'analogjs-platform-rollup-page-endpoint',\n    async transform(\n      _code: string,\n      id: string,\n    ): Promise<{ code: string; map: null } | undefined> {\n      if (normalizePath(id).includes('/pages/') && id.endsWith('.server.ts')) {\n        const result = parseSync(id, _code, {\n          sourceType: 'module',\n          lang: 'ts',\n        });\n\n        const fileExports: string[] = result.module.staticExports.flatMap((e) =>\n          e.entries\n            .filter((entry) => entry.exportName.name !== null)\n            .map((entry) => entry.exportName.name as string),\n        );\n\n        // In h3 v2 / Nitro v3, event.node is undefined during prerendering\n        // (which uses the fetch-based pipeline, not Node.js http), and\n        // event.context is undefined for sub-handler dispatches that\n        // didn't go through the router params layer. We use optional\n        // chaining on both so page endpoints work in Node.js server,\n        // fetch-based prerender, and internal `fetchWithEvent` paths.\n        //\n        // Page loaders expect Nitro-style `$fetch` semantics (parsed data plus\n        // internal relative-route support), so we construct a request-local\n        // fetch using `createFetch` from ofetch + `fetchWithEvent` from h3.\n        const code = `\n            import { defineHandler, fetchWithEvent } from 'nitro/h3';\n            import { createFetch } from 'ofetch';\n\n            ${\n              fileExports.includes('load')\n                ? _code\n                : `\n                ${_code}\n                export const load = () => {\n                  return {};\n                }`\n            }\n\n            ${\n              fileExports.includes('action')\n                ? ''\n                : `\n                export const action = () => {\n                  return {};\n                }\n              `\n            }\n\n            export default defineHandler(async(event) => {\n              ${SERVER_FETCH_FACTORY_SNIPPET}\n\n              if (event.method === 'GET') {\n                try {\n                  return await load({\n                    params: event.context?.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              } else {\n                try {\n                  return await action({\n                    params: event.context?.params,\n                    req: event.node?.req,\n                    res: event.node?.res,\n                    fetch: serverFetch,\n                    event\n                  });\n                } catch(e) {\n                  console.error(\\` An error occurred: \\${e}\\`)\n                  throw e;\n                }\n              }\n            });\n          `;\n\n        return {\n          code,\n          map: null,\n        };\n      }\n\n      return;\n    },\n  };\n}\n"],"mappings":";;;;AAIA,SAAgB,sBAAsB;AACpC,QAAO;EACL,MAAM;EACN,MAAM,UACJ,OACA,IACkD;AAClD,OAAI,cAAc,GAAG,CAAC,SAAS,UAAU,IAAI,GAAG,SAAS,aAAa,EAAE;IAMtE,MAAM,cALS,UAAU,IAAI,OAAO;KAClC,YAAY;KACZ,MAAM;KACP,CAAC,CAEmC,OAAO,cAAc,SAAS,MACjE,EAAE,QACC,QAAQ,UAAU,MAAM,WAAW,SAAS,KAAK,CACjD,KAAK,UAAU,MAAM,WAAW,KAAe,CACnD;AAqED,WAAO;KACL,MA1DW;;;;cAKP,YAAY,SAAS,OAAO,GACxB,QACA;kBACA,MAAM;;;mBAIX;;cAGC,YAAY,SAAS,SAAS,GAC1B,KACA;;;;gBAKL;;;gBAGG,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkCnC,KAAK;KACN;;;EAKN"}

package/src/lib/nitro/post-rendering-hook.d.ts

@@ -0,0 +1,2 @@
+import type { Nitro, PrerenderRoute } from "nitro/types";
+export declare function addPostRenderingHooks(nitro: Nitro, hooks: ((pr: PrerenderRoute) => Promise<void> | void)[]): void;

package/src/lib/nitro/post-rendering-hook.js

@@ -0,0 +1,10 @@
+//#region packages/platform/src/lib/nitro/post-rendering-hook.ts
+function addPostRenderingHooks(nitro, hooks) {
+	for (const hook of hooks) nitro.hooks.hook("prerender:generate", async (route) => {
+		await hook(route);
+	});
+}
+//#endregion
+export { addPostRenderingHooks };
+
+//# sourceMappingURL=post-rendering-hook.js.map

package/src/lib/nitro/post-rendering-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-rendering-hook.js","names":[],"sources":["../../../../src/lib/nitro/post-rendering-hook.ts"],"sourcesContent":["import type { Nitro, PrerenderRoute } from 'nitro/types';\n\nexport function addPostRenderingHooks(\n  nitro: Nitro,\n  hooks: ((pr: PrerenderRoute) => Promise<void> | void)[],\n): void {\n  for (const hook of hooks) {\n    nitro.hooks.hook('prerender:generate', async (route: PrerenderRoute) => {\n      await hook(route);\n    });\n  }\n}\n"],"mappings":";AAEA,SAAgB,sBACd,OACA,OACM;AACN,MAAK,MAAM,QAAQ,MACjB,OAAM,MAAM,KAAK,sBAAsB,OAAO,UAA0B;AACtE,QAAM,KAAK,MAAM;GACjB"}