@analogjs/platform 3.0.0-alpha.7 → 3.0.0-alpha.71

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"}

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

@@ -0,0 +1,33 @@
+/**
+* Code snippet emitted into virtual modules to create a request-scoped
+* fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.
+*
+* Shared between the SSR renderer and page-endpoint virtual modules so
+* the fetch-wiring logic stays in sync.
+*
+* The emitted variable is named `serverFetch` — callers should reference it
+* by that name.
+*/
+export declare const SERVER_FETCH_FACTORY_SNIPPET = "\n  const serverFetch = createFetch({\n    fetch: (resource, init) => {\n      const url = resource instanceof Request ? resource.url : resource.toString();\n      return fetchWithEvent(event, url, init);\n    }\n  });";
+/**
+* SSR renderer virtual module content.
+*
+* This code runs inside Nitro's server runtime (Node.js context) where
+* event.node is always populated. In h3 v2, event.node is typed as optional,
+* so we use h3's first-class event properties (event.path, event.method) where
+* possible and apply optional chaining when accessing the Node.js context for
+* the Angular renderer which requires raw req/res objects.
+*
+* h3 v2 idiomatic APIs used:
+* - defineHandler (replaces defineEventHandler / eventHandler)
+* - event.path (replaces event.node.req.url)
+* - getResponseHeader compat shim (still available in h3 v2)
+*/
+export declare function ssrRenderer(): string;
+/**
+* Client-only renderer virtual module content.
+*
+* Used when SSR is disabled — simply serves the static index.html template
+* for every route, letting the client-side Angular router handle navigation.
+*/
+export declare function clientRenderer(): string;

package/src/lib/nitro/renderers.js

@@ -0,0 +1,22 @@
+//#region packages/platform/src/lib/nitro/renderers.ts
+/**
+* Code snippet emitted into virtual modules to create a request-scoped
+* fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.
+*
+* Shared between the SSR renderer and page-endpoint virtual modules so
+* the fetch-wiring logic stays in sync.
+*
+* The emitted variable is named `serverFetch` — callers should reference it
+* by that name.
+*/
+var SERVER_FETCH_FACTORY_SNIPPET = `
+  const serverFetch = createFetch({
+    fetch: (resource, init) => {
+      const url = resource instanceof Request ? resource.url : resource.toString();
+      return fetchWithEvent(event, url, init);
+    }
+  });`;
+//#endregion
+export { SERVER_FETCH_FACTORY_SNIPPET };
+
+//# sourceMappingURL=renderers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.js","names":[],"sources":["../../../../src/lib/nitro/renderers.ts"],"sourcesContent":["/**\n * Code snippet emitted into virtual modules to create a request-scoped\n * fetch using ofetch's `createFetch` + h3's `fetchWithEvent`.\n *\n * Shared between the SSR renderer and page-endpoint virtual modules so\n * the fetch-wiring logic stays in sync.\n *\n * The emitted variable is named `serverFetch` — callers should reference it\n * by that name.\n */\nexport const SERVER_FETCH_FACTORY_SNIPPET = `\n  const serverFetch = createFetch({\n    fetch: (resource, init) => {\n      const url = resource instanceof Request ? resource.url : resource.toString();\n      return fetchWithEvent(event, url, init);\n    }\n  });`;\n\n/**\n * SSR renderer virtual module content.\n *\n * This code runs inside Nitro's server runtime (Node.js context) where\n * event.node is always populated. In h3 v2, event.node is typed as optional,\n * so we use h3's first-class event properties (event.path, event.method) where\n * possible and apply optional chaining when accessing the Node.js context for\n * the Angular renderer which requires raw req/res objects.\n *\n * h3 v2 idiomatic APIs used:\n * - defineHandler (replaces defineEventHandler / eventHandler)\n * - event.path (replaces event.node.req.url)\n * - getResponseHeader compat shim (still available in h3 v2)\n */\nexport function ssrRenderer() {\n  return `\nimport { createFetch } from 'ofetch';\nimport { defineHandler, fetchWithEvent } from 'nitro/h3';\n// @ts-ignore\nimport renderer from '#analog/ssr';\nimport template from '#analog/index';\n\nconst normalizeHtmlRequestUrl = (url) =>\n  url.replace(/\\\\/index\\\\.html(?=$|[?#])/, '/');\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  const noSSR = event.res.headers.get('x-analog-no-ssr');\n  const requestPath = normalizeHtmlRequestUrl(event.path);\n\n  if (noSSR === 'true') {\n    return template;\n  }\n\n  // event.path is the canonical h3 v2 way to access the request URL.\n  // event.node?.req and event.node?.res are needed by the Angular SSR renderer\n  // which operates on raw Node.js request/response objects.\n  // During prerendering (Nitro v3 fetch-based pipeline), event.node is undefined.\n  // The Angular renderer requires a req object with at least { headers, url },\n  // so we provide a minimal stub to avoid runtime errors in prerender context.\n  const req = event.node?.req\n    ? {\n        ...event.node.req,\n        url: requestPath,\n        originalUrl: requestPath,\n      }\n    : {\n    headers: { host: 'localhost' },\n    url: requestPath,\n    originalUrl: requestPath,\n    connection: {},\n  };\n  const res = event.node?.res;\n${SERVER_FETCH_FACTORY_SNIPPET}\n\n  const html = await renderer(requestPath, template, { req, res, fetch: serverFetch });\n\n  return html;\n});`;\n}\n\n/**\n * Client-only renderer virtual module content.\n *\n * Used when SSR is disabled — simply serves the static index.html template\n * for every route, letting the client-side Angular router handle navigation.\n */\nexport function clientRenderer() {\n  return `\nimport { defineHandler } from 'nitro/h3';\nimport template from '#analog/index';\n\nexport default defineHandler(async (event) => {\n  event.res.headers.set('content-type', 'text/html; charset=utf-8');\n  return template;\n});\n`;\n}\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,+BAA+B"}

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

@@ -0,0 +1,122 @@
+import type { PrerenderRoute } from "nitro/types";
+export interface I18nPrerenderOptions {
+	/**
+	* The default/source locale for the application.
+	*/
+	defaultLocale: string;
+	/**
+	* List of supported locale identifiers.
+	* Each route will be prerendered once per locale with a locale prefix.
+	*/
+	locales: string[];
+}
+export interface PrerenderOptions {
+	/**
+	* Add additional routes to prerender through crawling page links.
+	*/
+	discover?: boolean;
+	/**
+	* List of routes to prerender resolved statically or dynamically.
+	*/
+	routes?: (string | PrerenderContentDir | PrerenderRouteConfig)[] | (() => Promise<(string | PrerenderContentDir | PrerenderRouteConfig | undefined)[]>);
+	sitemap?: SitemapConfig;
+	/** List of functions that run for each route after pre-rendering is complete. */
+	postRenderingHooks?: ((routes: PrerenderRoute) => Promise<void>)[];
+}
+export type SitemapPriority = number | `${number}`;
+export interface SitemapRouteDefinition {
+	route: string;
+	lastmod?: string;
+	changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+	priority?: SitemapPriority;
+}
+export interface SitemapEntry extends SitemapRouteDefinition {
+	loc: string;
+}
+export type SitemapRouteInput = string | SitemapRouteDefinition | undefined;
+export type SitemapRouteSource = SitemapRouteInput[] | (() => Promise<SitemapRouteInput[]>);
+export type SitemapExcludeRule = string | RegExp | ((entry: SitemapEntry) => boolean | Promise<boolean>);
+export type SitemapTransform = (entry: SitemapEntry) => SitemapRouteDefinition | false | Promise<SitemapRouteDefinition | false>;
+export interface SitemapConfig {
+	host: string;
+	include?: SitemapRouteSource;
+	exclude?: SitemapExcludeRule[];
+	defaults?: PrerenderSitemapConfig;
+	transform?: SitemapTransform;
+}
+export interface PrerenderContentDir {
+	/**
+	* The directory where files should be grabbed from.
+	* @example `/src/contents/blog`
+	*/
+	contentDir: string;
+	/**
+	* Transform the matching content files path into a route.
+	* The function is called for each matching content file within the specified contentDir.
+	* @param file information of the matching file (`path`, `name`, `extension`, `attributes`, `content`)
+	* @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
+	*/
+	transform: (file: PrerenderContentFile) => string | false;
+	/**
+	* Customize the sitemap definition for the prerendered route
+	*
+	* https://www.sitemaps.org/protocol.html#xmlTagDefinitions
+	*/
+	sitemap?: PrerenderSitemapConfig | ((file: PrerenderContentFile) => PrerenderSitemapConfig);
+	/**
+	* Output the source markdown content alongside the prerendered route.
+	* The source file will be accessible at the route path with a .md extension.
+	* @param file information of the matching file including its content
+	* @returns the markdown content string to output, or `false` to skip outputting for this file
+	*/
+	outputSourceFile?: (file: PrerenderContentFile) => string | false;
+	/**
+	* Recurse into subdirectories of `contentDir` when discovering files.
+	* When enabled, the matching file's directory relative to `contentDir`
+	* is exposed via `PrerenderContentFile.relativePath` so transforms can
+	* disambiguate identically-named files across subdirectories.
+	* @default false
+	*/
+	recursive?: boolean;
+}
+/**
+* @param path the path to the content file
+* @param name the basename of the matching content file without the file extension
+* @param extension the file extension
+* @param attributes the frontmatter attributes extracted from the frontmatter section of the file
+* @param content the raw file content including frontmatter
+* @param relativePath when `recursive` is enabled, the directory of the file relative to `contentDir` (empty string for files at the top level)
+* @returns a string with the route should be returned (e. g. `/blog/<slug>`) or the value `false`, when the route should not be prerendered.
+*/
+export interface PrerenderContentFile {
+	path: string;
+	attributes: Record<string, any>;
+	name: string;
+	extension: string;
+	content: string;
+	relativePath?: string;
+}
+export interface PrerenderSitemapConfig {
+	lastmod?: string;
+	changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+	priority?: SitemapPriority;
+}
+export interface PrerenderRouteConfig {
+	route: string;
+	/**
+	* Customize the sitemap definition for the prerendered route
+	*
+	* https://www.sitemaps.org/protocol.html#xmlTagDefinitions
+	*/
+	sitemap?: PrerenderSitemapConfig | (() => PrerenderSitemapConfig);
+	/**
+	* Prerender static data for the prerendered route
+	*/
+	staticData?: boolean;
+	/**
+	* Path to the source markdown file to output alongside the prerendered route.
+	* The source file will be accessible at the route path with a .md extension.
+	* @example 'src/content/overview.md'
+	*/
+	outputSourceFile?: string;
+}

package/src/lib/nx-plugin/_virtual/_rolldown/runtime.js

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/src/lib/nx-plugin/builders.json

@@ -0,0 +1,15 @@
+{
+  "builders": {
+    "vite-dev-server": {
+      "implementation": "./src/builders/vite-dev-server/dev-server.js",
+      "schema": "./src/builders/vite-dev-server/schema.json",
+      "description": "Vite dev server."
+    },
+    "vite": {
+      "implementation": "./src/builders/vite/vite-build.js",
+      "schema": "./src/builders/vite/schema.json",
+      "description": "Build with Vite."
+    },
+    "vitest": "@analogjs/vitest-angular:test"
+  }
+}

package/src/lib/nx-plugin/executors.json

@@ -1,15 +1,23 @@
 {
-  "executors": {
+  "builders": {
     "vite-dev-server": {
-      "implementation": "./src/executors/vite-dev-server/vite-dev-server.impl",
-      "schema": "./src/executors/vite-dev-server/schema.json",
+      "implementation": "./src/builders/vite-dev-server/dev-server.js",
+      "schema": "./src/builders/vite-dev-server/schema.json",
       "description": "Vite dev server."
     },
     "vite": {
-      "implementation": "./src/executors/vite/vite.impl",
-      "schema": "./src/executors/vite/schema.json",
+      "implementation": "./src/builders/vite/vite-build.js",
+      "schema": "./src/builders/vite/schema.json",
       "description": "Build with Vite."
     },
+    "vitest": "@analogjs/vitest-angular:test"
+  },
+  "executors": {
+    "vite-dev-server": {
+      "implementation": "./src/executors/vite-dev-server/vite-dev-server.impl",
+      "schema": "./src/executors/vite-dev-server/schema.json",
+      "description": "Vite dev server."
+    },
     "vitest": {
       "implementation": "./src/executors/vitest/vitest.impl",
       "schema": "./src/executors/vitest/schema.json",

package/src/lib/nx-plugin/generators.json

@@ -33,5 +33,30 @@
       "description": "Migrate and configure an Angular SPA to use Analog.",
       "aliases": ["migrate"]
     }
+  },
+  "schematics": {
+    "application": {
+      "factory": "./src/generators/app/compat#applicationSchematic",
+      "schema": "./src/generators/app/schema.json",
+      "description": "Generates an Analog application",
+      "aliases": ["app"]
+    },
+    "page": {
+      "factory": "./src/generators/page/compat#pageSchematic",
+      "schema": "./src/generators/page/schema.json",
+      "description": "Creates a new Analog page in the given or default project.",
+      "aliases": ["p"]
+    },
+    "setup-vitest": {
+      "factory": "./src/generators/setup-vitest/compat#setupVitestSchematic",
+      "schema": "./src/generators/setup-vitest/schema.json",
+      "description": "Setup the Vitest configuration."
+    },
+    "init": {
+      "factory": "./src/generators/init/compat#initSchematic",
+      "schema": "./src/generators/init/schema.json",
+      "description": "Migrate and configure an Angular SPA to use Analog.",
+      "aliases": ["migrate"]
+    }
   }
 }

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/camelCase.js

@@ -0,0 +1,13 @@
+const require_capitalize = require("./capitalize.js");
+const require_words = require("./words.js");
+//#region node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/camelCase.mjs
+function camelCase(str) {
+	const words$1 = require_words.words(str);
+	if (words$1.length === 0) return "";
+	const [first, ...rest] = words$1;
+	return `${first.toLowerCase()}${rest.map((word) => require_capitalize.capitalize(word)).join("")}`;
+}
+//#endregion
+exports.camelCase = camelCase;
+
+//# sourceMappingURL=camelCase.js.map

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/camelCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelCase.js","names":["words","capitalize"],"sources":["../../../../../../../../../../../../../node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/camelCase.mjs"],"sourcesContent":["import { capitalize } from './capitalize.mjs';\nimport { words } from './words.mjs';\n\nfunction camelCase(str) {\n    const words$1 = words(str);\n    if (words$1.length === 0) {\n        return '';\n    }\n    const [first, ...rest] = words$1;\n    return `${first.toLowerCase()}${rest.map(word => capitalize(word)).join('')}`;\n}\n\nexport { camelCase };\n"],"x_google_ignoreList":[0],"mappings":";;;AAGA,SAAS,UAAU,KAAK;CACpB,MAAM,UAAUA,cAAAA,MAAM,IAAI;AAC1B,KAAI,QAAQ,WAAW,EACnB,QAAO;CAEX,MAAM,CAAC,OAAO,GAAG,QAAQ;AACzB,QAAO,GAAG,MAAM,aAAa,GAAG,KAAK,KAAI,SAAQC,mBAAAA,WAAW,KAAK,CAAC,CAAC,KAAK,GAAG"}

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/capitalize.js

@@ -0,0 +1,8 @@
+//#region node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/capitalize.mjs
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+//#endregion
+exports.capitalize = capitalize;
+
+//# sourceMappingURL=capitalize.js.map

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","names":[],"sources":["../../../../../../../../../../../../../node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/capitalize.mjs"],"sourcesContent":["function capitalize(str) {\n    return (str.charAt(0).toUpperCase() + str.slice(1).toLowerCase());\n}\n\nexport { capitalize };\n"],"x_google_ignoreList":[0],"mappings":";AAAA,SAAS,WAAW,KAAK;AACrB,QAAQ,IAAI,OAAO,EAAE,CAAC,aAAa,GAAG,IAAI,MAAM,EAAE,CAAC,aAAa"}

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/words.js

@@ -0,0 +1,9 @@
+//#region node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/words.mjs
+var CASE_SPLIT_PATTERN = /\p{Lu}?\p{Ll}+|[0-9]+|\p{Lu}+(?!\p{Ll})|\p{Emoji_Presentation}|\p{Extended_Pictographic}|\p{L}+/gu;
+function words(str) {
+	return Array.from(str.match(CASE_SPLIT_PATTERN) ?? []);
+}
+//#endregion
+exports.words = words;
+
+//# sourceMappingURL=words.js.map

package/src/lib/nx-plugin/node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","names":[],"sources":["../../../../../../../../../../../../../node_modules/.pnpm/es-toolkit@1.45.1/node_modules/es-toolkit/dist/string/words.mjs"],"sourcesContent":["const CASE_SPLIT_PATTERN = /\\p{Lu}?\\p{Ll}+|[0-9]+|\\p{Lu}+(?!\\p{Ll})|\\p{Emoji_Presentation}|\\p{Extended_Pictographic}|\\p{L}+/gu;\nfunction words(str) {\n    return Array.from(str.match(CASE_SPLIT_PATTERN) ?? []);\n}\n\nexport { CASE_SPLIT_PATTERN, words };\n"],"x_google_ignoreList":[0],"mappings":";AAAA,IAAM,qBAAqB;AAC3B,SAAS,MAAM,KAAK;AAChB,QAAO,MAAM,KAAK,IAAI,MAAM,mBAAmB,IAAI,EAAE,CAAC"}

package/src/lib/nx-plugin/package.json

@@ -1,7 +1,3 @@
 {
-  "name": "@analogjs/nx",
-  "version": "0.0.1",
-  "main": "src/index.js",
-  "types": "./src/index.d.ts",
   "type": "commonjs"
-}
+}

package/src/lib/nx-plugin/src/builders/vite/schema.json

@@ -0,0 +1,39 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "title": "Vite Prod Builder",
+  "cli": "nx",
+  "description": "Builds a Vite.js application for production.",
+  "type": "object",
+  "properties": {
+    "outputPath": {
+      "type": "string",
+      "description": "The output path of the generated files.",
+      "x-completion-type": "directory",
+      "x-priority": "important"
+    },
+    "configFile": {
+      "type": "string",
+      "description": "The name of the Vite.js configuration file.",
+      "x-completion-type": "file",
+      "x-completion-glob": "vite.config.@(js|ts)"
+    },
+    "sourcemap": {
+      "description": "Output sourcemaps. Use 'hidden' for use with error reporting tools without generating sourcemap comment.",
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string"
+        }
+      ]
+    },
+    "mode": {
+      "type": "string",
+      "description": "Mode to run the build in."
+    }
+  },
+  "definitions": {},
+  "required": ["outputPath"]
+}

package/src/lib/nx-plugin/src/builders/vite/vite-build.d.ts

@@ -0,0 +1,11 @@
+/**
+* Thin shim that re-exports the Angular Devkit Architect build builder
+* shipped by `@analogjs/vite-plugin-angular`. Architect resolves the
+* implementation from the local `builders.json` entry without traversing a
+* cross-package string redirect, so the user-facing `@analogjs/platform:vite`
+* identifier stays stable while the real implementation continues to live in
+* `@analogjs/vite-plugin-angular`. Mirrors `@analogjs/storybook-angular`'s
+* pattern for surfacing `@storybook/angular`'s builders.
+*/
+import viteBuilder from "@analogjs/vite-plugin-angular/builders/vite";
+export default viteBuilder;

package/src/lib/nx-plugin/src/builders/vite/vite-build.js

@@ -0,0 +1,18 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.js");
+let _analogjs_vite_plugin_angular_builders_vite = require("@analogjs/vite-plugin-angular/builders/vite");
+_analogjs_vite_plugin_angular_builders_vite = require_runtime.__toESM(_analogjs_vite_plugin_angular_builders_vite);
+//#region packages/nx-plugin/src/builders/vite/vite-build.ts
+/**
+* Thin shim that re-exports the Angular Devkit Architect build builder
+* shipped by `@analogjs/vite-plugin-angular`. Architect resolves the
+* implementation from the local `builders.json` entry without traversing a
+* cross-package string redirect, so the user-facing `@analogjs/platform:vite`
+* identifier stays stable while the real implementation continues to live in
+* `@analogjs/vite-plugin-angular`. Mirrors `@analogjs/storybook-angular`'s
+* pattern for surfacing `@storybook/angular`'s builders.
+*/
+var vite_build_default = _analogjs_vite_plugin_angular_builders_vite.default;
+//#endregion
+module.exports = vite_build_default;
+
+//# sourceMappingURL=vite-build.js.map

package/src/lib/nx-plugin/src/builders/vite/vite-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-build.js","names":[],"sources":["../../../../../../../../nx-plugin/src/builders/vite/vite-build.ts"],"sourcesContent":["/**\n * Thin shim that re-exports the Angular Devkit Architect build builder\n * shipped by `@analogjs/vite-plugin-angular`. Architect resolves the\n * implementation from the local `builders.json` entry without traversing a\n * cross-package string redirect, so the user-facing `@analogjs/platform:vite`\n * identifier stays stable while the real implementation continues to live in\n * `@analogjs/vite-plugin-angular`. Mirrors `@analogjs/storybook-angular`'s\n * pattern for surfacing `@storybook/angular`'s builders.\n */\nimport viteBuilder from '@analogjs/vite-plugin-angular/builders/vite';\n\nexport default viteBuilder;\n"],"mappings":";;;;;;;;;;;;;AAWA,IAAA,qBAAe,4CAAA"}

package/src/lib/nx-plugin/src/builders/vite-dev-server/dev-server.d.ts

@@ -0,0 +1,7 @@
+/**
+* Thin shim that re-exports the Angular Devkit Architect dev-server builder
+* shipped by `@analogjs/vite-plugin-angular`. See `../vite/vite-build.ts` for
+* the rationale; mirrors `@analogjs/storybook-angular`'s pattern.
+*/
+import devServerBuilder from "@analogjs/vite-plugin-angular/builders/vite-dev-server";
+export default devServerBuilder;

package/src/lib/nx-plugin/src/builders/vite-dev-server/dev-server.js

@@ -0,0 +1,14 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.js");
+let _analogjs_vite_plugin_angular_builders_vite_dev_server = require("@analogjs/vite-plugin-angular/builders/vite-dev-server");
+_analogjs_vite_plugin_angular_builders_vite_dev_server = require_runtime.__toESM(_analogjs_vite_plugin_angular_builders_vite_dev_server);
+//#region packages/nx-plugin/src/builders/vite-dev-server/dev-server.ts
+/**
+* Thin shim that re-exports the Angular Devkit Architect dev-server builder
+* shipped by `@analogjs/vite-plugin-angular`. See `../vite/vite-build.ts` for
+* the rationale; mirrors `@analogjs/storybook-angular`'s pattern.
+*/
+var dev_server_default = _analogjs_vite_plugin_angular_builders_vite_dev_server.default;
+//#endregion
+module.exports = dev_server_default;
+
+//# sourceMappingURL=dev-server.js.map

package/src/lib/nx-plugin/src/builders/vite-dev-server/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","names":[],"sources":["../../../../../../../../nx-plugin/src/builders/vite-dev-server/dev-server.ts"],"sourcesContent":["/**\n * Thin shim that re-exports the Angular Devkit Architect dev-server builder\n * shipped by `@analogjs/vite-plugin-angular`. See `../vite/vite-build.ts` for\n * the rationale; mirrors `@analogjs/storybook-angular`'s pattern.\n */\nimport devServerBuilder from '@analogjs/vite-plugin-angular/builders/vite-dev-server';\n\nexport default devServerBuilder;\n"],"mappings":";;;;;;;;;AAOA,IAAA,qBAAe,uDAAA"}