@analogjs/platform 3.0.0-alpha.9 → 3.0.0-alpha.91

package/src/lib/route-manifest.js

@@ -0,0 +1,300 @@
+//#region packages/platform/src/lib/route-manifest.ts
+/**
+* Converts a discovered filename to a route path pattern.
+*
+* Uses the same stripping rules as the existing route system
+* but preserves bracket param syntax instead of converting to
+* Angular's `:param` syntax.
+*
+* The regex applies four alternations (left to right, all replaced with ''):
+*   1. `^(.*?)[\\/](?:routes|pages|content)[\\/]` — anchored, strips everything
+*      up to and including the first /routes/, /pages/, or /content/ segment.
+*      Handles app-local paths (`/src/app/pages/`) AND additional dirs
+*      (`/libs/shared/feature/src/content/`) uniformly.
+*   2. `[\\/](?:app[\\/](?:routes|pages)|src[\\/]content)[\\/]` — non-anchored
+*      fallback for legacy paths where the directory marker appears mid-string.
+*   3. `\.page\.(js|ts|analog|ag)$` — strips page file extensions.
+*   4. `\.(ts|md|analog|ag)$` — strips remaining file extensions.
+*
+* Examples:
+* - '/app/routes/index.ts' -> '/'
+* - '/app/routes/about.ts' -> '/about'
+* - '/src/app/pages/users/[id].page.ts' -> '/users/[id]'
+* - '/app/routes/blog.[slug].ts' -> '/blog/[slug]'
+* - '/src/app/pages/(auth)/login.page.ts' -> '/login'
+* - '/src/app/pages/docs/[...slug].page.ts' -> '/docs/[...slug]'
+* - '/src/app/pages/shop/[[...category]].page.ts' -> '/shop/[[...category]]'
+* - '/libs/shared/feature/src/content/test.md' -> '/test'
+*/
+function filenameToRoutePath(filename) {
+	let path = filename.replace(/^(?:[a-zA-Z]:[\\/])?(.*?)[\\/](?:routes|pages|content)[\\/]|(?:[\\/](?:app[\\/](?:routes|pages)|src[\\/]content)[\\/])|(\.page\.(js|ts|analog|ag)$)|(\.(ts|md|analog|ag)$)/g, "");
+	const brackets = [];
+	path = path.replace(/\[\[?\.{0,3}[^\]]*\]?\]/g, (match) => {
+		brackets.push(match);
+		return `\0B${brackets.length - 1}\0`;
+	});
+	path = path.replace(/\(.*?\)/g, "").replace(/(^|[./])index(?=[./]|$)/g, "$1").replace(/\./g, "/");
+	path = path.replace(/\0B(\d+)\0/g, (_, idx) => brackets[Number(idx)]);
+	return "/" + path.split("/").filter(Boolean).join("/");
+}
+/**
+* Converts a discovered filename to a stable structural route id.
+*
+* Unlike `filenameToRoutePath`, this preserves route groups and `index`
+* segments so that multiple files resolving to the same URL shape can still
+* have distinct structural identities in the generated route tree metadata.
+*
+* Uses the same directory-stripping regex as `filenameToRoutePath` —
+* changes to the regex must be kept in sync between both functions.
+*/
+function filenameToRouteId(filename) {
+	let path = filename.replace(/^(?:[a-zA-Z]:[\\/])?(.*?)[\\/](?:routes|pages|content)[\\/]|(?:[\\/](?:app[\\/](?:routes|pages)|src[\\/]content)[\\/])|(\.page\.(js|ts|analog|ag)$)|(\.(ts|md|analog|ag)$)/g, "");
+	const brackets = [];
+	path = path.replace(/\(.*?\)|\[\[?\.{0,3}[^\]]*\]?\]/g, (match) => {
+		brackets.push(match);
+		return `\0B${brackets.length - 1}\0`;
+	});
+	path = path.replace(/\./g, "/");
+	path = path.replace(/\0B(\d+)\0/g, (_, idx) => brackets[Number(idx)]);
+	return "/" + path.split("/").filter(Boolean).join("/");
+}
+/**
+* Extracts parameter information from a route path pattern.
+*/
+function extractRouteParams(routePath) {
+	const params = [];
+	for (const match of routePath.matchAll(/\[\[\.\.\.([^\]]+)\]\]/g)) params.push({
+		name: match[1],
+		type: "optionalCatchAll"
+	});
+	for (const match of routePath.matchAll(/(?<!\[)\[\.\.\.([^\]]+)\](?!\])/g)) params.push({
+		name: match[1],
+		type: "catchAll"
+	});
+	for (const match of routePath.matchAll(/(?<!\[)\[(?!\.)([^\]]+)\](?!\])/g)) params.push({
+		name: match[1],
+		type: "dynamic"
+	});
+	return params;
+}
+/**
+* Generates a route manifest from a list of discovered filenames.
+*
+* @param collisionPriority - Optional callback that returns a numeric priority
+*   for each filename (lower wins). When provided, this replaces the default
+*   hard-coded path-substring heuristic with config-derived precedence.
+*/
+function generateRouteManifest(filenames, collisionPriority) {
+	const routes = [];
+	const collisions = [];
+	const sharedFullPaths = /* @__PURE__ */ new Set();
+	const seenByFullPath = /* @__PURE__ */ new Map();
+	const getPriority = collisionPriority ?? getCollisionPriority;
+	const prioritizedFilenames = [...filenames].sort((a, b) => {
+		const aPriority = getPriority(a);
+		const bPriority = getPriority(b);
+		if (aPriority !== bPriority) return aPriority - bPriority;
+		return a.localeCompare(b);
+	});
+	const layoutByKey = /* @__PURE__ */ new Map();
+	for (const filename of prioritizedFilenames) {
+		const key = toRouteFileKey(filename);
+		if (!filename.endsWith(".md") && !layoutByKey.has(key)) layoutByKey.set(key, filename);
+	}
+	for (const filename of prioritizedFilenames) {
+		const fullPath = filenameToRoutePath(filename);
+		const params = extractRouteParams(fullPath);
+		const id = filenameToRouteId(filename);
+		const isPathlessLayout = isPathlessLayoutId(id);
+		const groupScope = id.slice(0, id.lastIndexOf(")") + 1);
+		const collisionKey = JSON.stringify([fullPath, groupScope]);
+		const currentPriority = getPriority(filename);
+		if (!isPathlessLayout) {
+			if (seenByFullPath.has(collisionKey)) {
+				const winner = seenByFullPath.get(collisionKey);
+				if (winner.filename === filename) continue;
+				const isLayoutIndexPair = (a, b) => {
+					const indexRe = /\/index\.(page\.)?(ts|js|md|analog|ag)$/;
+					const layoutRe = /\.(page\.)?(ts|js|analog|ag)$/;
+					if (indexRe.test(a) && layoutRe.test(b)) return a.replace(indexRe, "") === b.replace(layoutRe, "");
+					return false;
+				};
+				if (isLayoutIndexPair(winner.filename, filename) || isLayoutIndexPair(filename, winner.filename)) {
+					sharedFullPaths.add(fullPath);
+					continue;
+				}
+				collisions.push({
+					fullPath,
+					keptFile: winner.filename,
+					droppedFile: filename,
+					samePriority: winner.priority === currentPriority
+				});
+				console.warn(`[Analog] Route collision: '${fullPath}' is defined by both '${winner.filename}' and '${filename}'. Keeping '${winner.filename}' based on route source precedence and skipping duplicate.`);
+				continue;
+			}
+			seenByFullPath.set(collisionKey, {
+				filename,
+				priority: currentPriority
+			});
+		}
+		const segments = toRouteFileKey(filename).split("/");
+		const layouts = [];
+		for (let i = 1; i < segments.length; i++) {
+			const layout = layoutByKey.get(segments.slice(0, i).join("/"));
+			if (layout) layouts.push(layout);
+		}
+		routes.push({
+			id,
+			path: fullPath,
+			fullPath,
+			params,
+			filename,
+			kind: filename.endsWith(".md") ? "content" : "page",
+			parentId: null,
+			children: [],
+			isIndex: id === "/index" || id.endsWith("/index"),
+			isGroup: isPathlessLayout,
+			isCatchAll: params.some((param) => param.type === "catchAll"),
+			isOptionalCatchAll: params.some((param) => param.type === "optionalCatchAll"),
+			layouts
+		});
+	}
+	routes.sort((a, b) => {
+		const aW = getRouteWeight(a.fullPath);
+		const bW = getRouteWeight(b.fullPath);
+		if (aW !== bW) return aW - bW;
+		return a.fullPath.localeCompare(b.fullPath);
+	});
+	const routeByFullPath = canonicalRoutesByFullPath(routes);
+	const routeById = new Map(routes.map((route) => [route.id, route]));
+	for (const route of routes) {
+		const structuralParent = route.id.includes("/(") ? findNearestParentById(route.id, routeById) : void 0;
+		const fullPathParent = findNearestParentRoute(route.fullPath, routeByFullPath);
+		const parent = structuralParent ?? fullPathParent;
+		route.parentId = parent?.id ?? null;
+		route.path = computeLocalPath(route.fullPath, parent?.fullPath ?? null);
+	}
+	for (const route of routes) {
+		if (route.parentId) routeById.get(route.parentId)?.children.push(route.id);
+		if (routeByFullPath.get(route.fullPath) !== route) sharedFullPaths.add(route.fullPath);
+	}
+	return {
+		routes,
+		collisions,
+		canonicalByFullPath: routeByFullPath,
+		sharedFullPaths
+	};
+}
+function canonicalRoutesByFullPath(routes) {
+	const map = /* @__PURE__ */ new Map();
+	for (const route of routes) {
+		const existing = map.get(route.fullPath);
+		if (!existing) map.set(route.fullPath, route);
+		else if (existing.isGroup && !route.isGroup) map.set(route.fullPath, route);
+		else if (existing.isGroup && route.isGroup) {
+			if (route.id.localeCompare(existing.id) < 0) map.set(route.fullPath, route);
+		}
+	}
+	return map;
+}
+/** A route file's path within its pages directory, e.g. `users/[id]`. */
+function toRouteFileKey(filename) {
+	return filename.replace(/^.*?[\\/](?:routes|pages|content)[\\/]|\.page\.(?:js|ts|analog|ag)$|\.(?:ts|md|analog|ag)$/g, "");
+}
+function isPathlessLayoutId(id) {
+	const segments = id.split("/").filter(Boolean);
+	if (segments.length === 0) return false;
+	return /^\([^)]*\)$/.test(segments[segments.length - 1]);
+}
+function getRouteWeight(path) {
+	if (path.includes("[[...")) return 3;
+	if (path.includes("[...")) return 2;
+	if (path.includes("[")) return 1;
+	return 0;
+}
+function getCollisionPriority(filename) {
+	if (filename.includes("/src/app/pages/") || filename.includes("/src/app/routes/") || filename.includes("/app/pages/") || filename.includes("/app/routes/") || filename.includes("/src/content/")) return 0;
+	return 1;
+}
+/**
+* Generates the route-table section for the combined generated route module.
+*
+* `resolveModuleImports` adds `routeMeta` and `load` types for pages whose
+* URL is defined by a single file, along with the `routeMeta` of the layouts
+* that wrap them. URLs shared by several files, such as a layout and its
+* index page, are ambiguous and only get params and query types.
+*/
+function generateRouteTableDeclaration(manifest, resolveModuleImports) {
+	const lines = [];
+	lines.push("/** @noprettier */");
+	lines.push("// This file is auto-generated by @analogjs/platform");
+	lines.push("import type {} from '@analogjs/router';");
+	lines.push("declare module '@analogjs/router' {");
+	lines.push("  interface AnalogRouteTable {");
+	const importType = (specifier, name) => `typeof import(${JSON.stringify(specifier)}).${name}`;
+	for (const route of manifest.canonicalByFullPath.values()) {
+		const paramsType = generateParamsType(route.params);
+		const queryType = "Record<string, string | string[] | undefined>";
+		lines.push(`    ${JSON.stringify(route.fullPath)}: {`);
+		lines.push(`      params: ${paramsType};`);
+		lines.push(`      query: ${queryType};`);
+		if (resolveModuleImports && route.kind === "page" && !manifest.sharedFullPaths.has(route.fullPath)) {
+			const layoutRouteMeta = route.layouts.flatMap((layout) => {
+				const specifier = resolveModuleImports(layout)?.routeMeta;
+				return specifier ? [importType(specifier, "routeMeta")] : [];
+			});
+			const imports = resolveModuleImports(route.filename);
+			if (layoutRouteMeta.length) lines.push(`      layoutRouteMeta: [${layoutRouteMeta.join(", ")}];`);
+			if (imports?.routeMeta) lines.push(`      routeMeta: ${importType(imports.routeMeta, "routeMeta")};`);
+			if (imports?.load) lines.push(`      load: ${importType(imports.load, "load")};`);
+		}
+		lines.push(`    };`);
+	}
+	lines.push("  }");
+	lines.push("}");
+	lines.push("");
+	lines.push("export {};");
+	lines.push("");
+	return lines.join("\n");
+}
+function generateParamsType(params) {
+	if (params.length === 0) return "Record<string, never>";
+	return `{ ${params.map((p) => {
+		const key = isValidIdentifier(p.name) ? p.name : JSON.stringify(p.name);
+		switch (p.type) {
+			case "dynamic": return `${key}: string`;
+			case "catchAll": return `${key}: string[]`;
+			case "optionalCatchAll": return `${key}?: string[]`;
+		}
+	}).join("; ")} }`;
+}
+function isValidIdentifier(name) {
+	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+}
+function findNearestParentById(id, routesById) {
+	if (id === "/") return;
+	const segments = id.split("/").filter(Boolean);
+	for (let index = segments.length - 1; index > 0; index--) {
+		const candidate = "/" + segments.slice(0, index).join("/");
+		const route = routesById.get(candidate);
+		if (route) return route;
+	}
+}
+function findNearestParentRoute(fullPath, routesByFullPath) {
+	if (fullPath === "/") return;
+	const segments = fullPath.slice(1).split("/");
+	for (let index = segments.length - 1; index > 0; index--) {
+		const candidate = "/" + segments.slice(0, index).join("/");
+		const route = routesByFullPath.get(candidate);
+		if (route) return route;
+	}
+}
+function computeLocalPath(fullPath, parentFullPath) {
+	if (fullPath === "/") return "/";
+	if (!parentFullPath) return fullPath.slice(1);
+	return fullPath.slice(parentFullPath.length).replace(/^\/+/, "") || "/";
+}
+//#endregion
+export { generateRouteManifest, generateRouteTableDeclaration };
+
+//# sourceMappingURL=route-manifest.js.map

package/src/lib/route-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-manifest.js","names":[],"sources":["../../../src/lib/route-manifest.ts"],"sourcesContent":["/**\n * Route-manifest engine for typed file routes.\n *\n * Pure functions (no Angular dependencies) for converting discovered\n * filenames into typed route manifests and generated declarations.\n */\n\nexport interface RouteParamInfo {\n  name: string;\n  type: 'dynamic' | 'catchAll' | 'optionalCatchAll';\n}\n\nexport interface RouteEntry {\n  /** Stable structural route id derived from the source filename */\n  id: string;\n  /** The route path segment relative to the nearest existing parent route */\n  path: string;\n  /** The fully resolved navigation path pattern (e.g., '/users/[id]') */\n  fullPath: string;\n  /** Extracted parameter information */\n  params: RouteParamInfo[];\n  /** Original filename that produced this route */\n  filename: string;\n  /** Type of source that produced this route */\n  kind: 'page' | 'content';\n  /** Parent route id, or null for top-level routes */\n  parentId: string | null;\n  /** Child route ids */\n  children: string[];\n  /** Whether the source filename represents an index route */\n  isIndex: boolean;\n  /** Whether the source filename includes route-group/pathless segments */\n  isGroup: boolean;\n  /** Whether the route contains a required catch-all parameter */\n  isCatchAll: boolean;\n  /** Whether the route contains an optional catch-all parameter */\n  isOptionalCatchAll: boolean;\n  /** Layout files that wrap this route, outermost first */\n  layouts: string[];\n}\n\nexport interface RouteCollision {\n  fullPath: string;\n  keptFile: string;\n  droppedFile: string;\n  /** True when both files have the same collision priority (hard error). */\n  samePriority: boolean;\n}\n\nexport interface RouteManifest {\n  routes: RouteEntry[];\n  collisions: RouteCollision[];\n  /** Canonical route per fullPath — precomputed once to avoid redundant work. */\n  canonicalByFullPath: Map<string, RouteEntry>;\n  /** Full paths defined by more than one file, such as a layout and its index page. */\n  sharedFullPaths: Set<string>;\n}\n\n/**\n * Converts a discovered filename to a route path pattern.\n *\n * Uses the same stripping rules as the existing route system\n * but preserves bracket param syntax instead of converting to\n * Angular's `:param` syntax.\n *\n * The regex applies four alternations (left to right, all replaced with ''):\n *   1. `^(.*?)[\\\\/](?:routes|pages|content)[\\\\/]` — anchored, strips everything\n *      up to and including the first /routes/, /pages/, or /content/ segment.\n *      Handles app-local paths (`/src/app/pages/`) AND additional dirs\n *      (`/libs/shared/feature/src/content/`) uniformly.\n *   2. `[\\\\/](?:app[\\\\/](?:routes|pages)|src[\\\\/]content)[\\\\/]` — non-anchored\n *      fallback for legacy paths where the directory marker appears mid-string.\n *   3. `\\.page\\.(js|ts|analog|ag)$` — strips page file extensions.\n *   4. `\\.(ts|md|analog|ag)$` — strips remaining file extensions.\n *\n * Examples:\n * - '/app/routes/index.ts' -> '/'\n * - '/app/routes/about.ts' -> '/about'\n * - '/src/app/pages/users/[id].page.ts' -> '/users/[id]'\n * - '/app/routes/blog.[slug].ts' -> '/blog/[slug]'\n * - '/src/app/pages/(auth)/login.page.ts' -> '/login'\n * - '/src/app/pages/docs/[...slug].page.ts' -> '/docs/[...slug]'\n * - '/src/app/pages/shop/[[...category]].page.ts' -> '/shop/[[...category]]'\n * - '/libs/shared/feature/src/content/test.md' -> '/test'\n */\nexport function filenameToRoutePath(filename: string): string {\n  let path = filename.replace(\n    /^(?:[a-zA-Z]:[\\\\/])?(.*?)[\\\\/](?:routes|pages|content)[\\\\/]|(?:[\\\\/](?:app[\\\\/](?:routes|pages)|src[\\\\/]content)[\\\\/])|(\\.page\\.(js|ts|analog|ag)$)|(\\.(ts|md|analog|ag)$)/g,\n    '',\n  );\n\n  const brackets: string[] = [];\n  path = path.replace(/\\[\\[?\\.{0,3}[^\\]]*\\]?\\]/g, (match) => {\n    brackets.push(match);\n    // eslint-disable-next-line no-control-regex\n    return `\\0B${brackets.length - 1}\\0`;\n  });\n  // Match the runtime router: strip index segments and groups before dots.\n  path = path\n    .replace(/\\(.*?\\)/g, '')\n    .replace(/(^|[./])index(?=[./]|$)/g, '$1')\n    .replace(/\\./g, '/');\n  // eslint-disable-next-line no-control-regex\n  path = path.replace(/\\0B(\\d+)\\0/g, (_, idx) => brackets[Number(idx)]);\n  return '/' + path.split('/').filter(Boolean).join('/');\n}\n\n/**\n * Converts a discovered filename to a stable structural route id.\n *\n * Unlike `filenameToRoutePath`, this preserves route groups and `index`\n * segments so that multiple files resolving to the same URL shape can still\n * have distinct structural identities in the generated route tree metadata.\n *\n * Uses the same directory-stripping regex as `filenameToRoutePath` —\n * changes to the regex must be kept in sync between both functions.\n */\nexport function filenameToRouteId(filename: string): string {\n  let path = filename.replace(\n    /^(?:[a-zA-Z]:[\\\\/])?(.*?)[\\\\/](?:routes|pages|content)[\\\\/]|(?:[\\\\/](?:app[\\\\/](?:routes|pages)|src[\\\\/]content)[\\\\/])|(\\.page\\.(js|ts|analog|ag)$)|(\\.(ts|md|analog|ag)$)/g,\n    '',\n  );\n\n  const brackets: string[] = [];\n  path = path.replace(/\\(.*?\\)|\\[\\[?\\.{0,3}[^\\]]*\\]?\\]/g, (match) => {\n    brackets.push(match);\n    // eslint-disable-next-line no-control-regex\n    return `\\0B${brackets.length - 1}\\0`;\n  });\n  path = path.replace(/\\./g, '/');\n  // eslint-disable-next-line no-control-regex\n  path = path.replace(/\\0B(\\d+)\\0/g, (_, idx) => brackets[Number(idx)]);\n\n  const segments = path.split('/').filter(Boolean);\n\n  return '/' + segments.join('/');\n}\n\n/**\n * Extracts parameter information from a route path pattern.\n */\nexport function extractRouteParams(routePath: string): RouteParamInfo[] {\n  const params: RouteParamInfo[] = [];\n\n  for (const match of routePath.matchAll(/\\[\\[\\.\\.\\.([^\\]]+)\\]\\]/g)) {\n    params.push({ name: match[1], type: 'optionalCatchAll' });\n  }\n  for (const match of routePath.matchAll(/(?<!\\[)\\[\\.\\.\\.([^\\]]+)\\](?!\\])/g)) {\n    params.push({ name: match[1], type: 'catchAll' });\n  }\n  for (const match of routePath.matchAll(/(?<!\\[)\\[(?!\\.)([^\\]]+)\\](?!\\])/g)) {\n    params.push({ name: match[1], type: 'dynamic' });\n  }\n\n  return params;\n}\n\n/**\n * Generates a route manifest from a list of discovered filenames.\n *\n * @param collisionPriority - Optional callback that returns a numeric priority\n *   for each filename (lower wins). When provided, this replaces the default\n *   hard-coded path-substring heuristic with config-derived precedence.\n */\nexport function generateRouteManifest(\n  filenames: string[],\n  collisionPriority?: (filename: string) => number,\n): RouteManifest {\n  const routes: RouteEntry[] = [];\n  const collisions: RouteCollision[] = [];\n  const sharedFullPaths = new Set<string>();\n  const seenByFullPath = new Map<\n    string,\n    { filename: string; priority: number }\n  >();\n  const getPriority = collisionPriority ?? getCollisionPriority;\n\n  // Prefer app-local route files over shared/external sources when two files\n  // resolve to the same URL. This keeps `additionalPagesDirs` additive instead\n  // of unexpectedly overriding the route that lives inside the app itself.\n  const prioritizedFilenames = [...filenames].sort((a, b) => {\n    const aPriority = getPriority(a);\n    const bPriority = getPriority(b);\n    if (aPriority !== bPriority) {\n      return aPriority - bPriority;\n    }\n    return a.localeCompare(b);\n  });\n\n  // Layout routes are a file and a folder with the same name, so users.page.ts\n  // wraps users/[id].page.ts but not users.[id].page.ts. Folders from all\n  // pages dirs share one tree.\n  const layoutByKey = new Map<string, string>();\n  for (const filename of prioritizedFilenames) {\n    const key = toRouteFileKey(filename);\n    if (!filename.endsWith('.md') && !layoutByKey.has(key)) {\n      layoutByKey.set(key, filename);\n    }\n  }\n\n  for (const filename of prioritizedFilenames) {\n    const fullPath = filenameToRoutePath(filename);\n    const params = extractRouteParams(fullPath);\n    const id = filenameToRouteId(filename);\n    const isPathlessLayout = isPathlessLayoutId(id);\n    // Different pathless branches can select the same URL with canMatch guards.\n    const groupScope = id.slice(0, id.lastIndexOf(')') + 1);\n    const collisionKey = JSON.stringify([fullPath, groupScope]);\n\n    const currentPriority = getPriority(filename);\n\n    // Pathless layouts (e.g. (auth).page.ts) are structural wrappers that\n    // render a <router-outlet> — they coexist with index.page.ts at the same\n    // fullPath without collision. The Angular router handles them as nested\n    // layout routes, not competing page components.\n    if (!isPathlessLayout) {\n      if (seenByFullPath.has(collisionKey)) {\n        const winner = seenByFullPath.get(collisionKey)!;\n        if (winner.filename === filename) {\n          continue;\n        }\n        // A layout file (e.g., docs.page.ts) and its index child\n        // (e.g., docs/index.page.ts) intentionally share the same route\n        // path — the layout wraps the index as a parent-child pair.\n        const isLayoutIndexPair = (a: string, b: string) => {\n          const indexRe = /\\/index\\.(page\\.)?(ts|js|md|analog|ag)$/;\n          const layoutRe = /\\.(page\\.)?(ts|js|analog|ag)$/;\n          if (indexRe.test(a) && layoutRe.test(b)) {\n            const dir = a.replace(indexRe, '');\n            const layout = b.replace(layoutRe, '');\n            return dir === layout;\n          }\n          return false;\n        };\n        if (\n          isLayoutIndexPair(winner.filename, filename) ||\n          isLayoutIndexPair(filename, winner.filename)\n        ) {\n          sharedFullPaths.add(fullPath);\n          continue;\n        }\n        collisions.push({\n          fullPath,\n          keptFile: winner.filename,\n          droppedFile: filename,\n          samePriority: winner.priority === currentPriority,\n        });\n        console.warn(\n          `[Analog] Route collision: '${fullPath}' is defined by both ` +\n            `'${winner.filename}' and '${filename}'. ` +\n            `Keeping '${winner.filename}' based on route source precedence and skipping duplicate.`,\n        );\n        continue;\n      }\n      seenByFullPath.set(collisionKey, { filename, priority: currentPriority });\n    }\n\n    const segments = toRouteFileKey(filename).split('/');\n    const layouts: string[] = [];\n    for (let i = 1; i < segments.length; i++) {\n      const layout = layoutByKey.get(segments.slice(0, i).join('/'));\n      if (layout) layouts.push(layout);\n    }\n\n    routes.push({\n      id,\n      path: fullPath,\n      fullPath,\n      params,\n      filename,\n      kind: filename.endsWith('.md') ? 'content' : 'page',\n      parentId: null,\n      children: [],\n      isIndex: id === '/index' || id.endsWith('/index'),\n      isGroup: isPathlessLayout,\n      isCatchAll: params.some((param) => param.type === 'catchAll'),\n      isOptionalCatchAll: params.some(\n        (param) => param.type === 'optionalCatchAll',\n      ),\n      layouts,\n    });\n  }\n\n  routes.sort((a, b) => {\n    const aW = getRouteWeight(a.fullPath);\n    const bW = getRouteWeight(b.fullPath);\n    if (aW !== bW) return aW - bW;\n    return a.fullPath.localeCompare(b.fullPath);\n  });\n\n  const routeByFullPath = canonicalRoutesByFullPath(routes);\n\n  const routeById = new Map(routes.map((route) => [route.id, route]));\n\n  for (const route of routes) {\n    // Use structural id-based parent lookup for any route whose id\n    // contains a group segment — this wires group children (e.g.\n    // /(auth)/sign-up) to their pathless layout parent (/(auth)).\n    // This also correctly handles nested groups like\n    // /dashboard/(settings)/profile: findNearestParentById walks up\n    // id segments and finds /(settings) if it exists, otherwise falls\n    // through to fullPathParent which resolves to /dashboard.\n    // Non-group routes always use the canonical fullPath-based lookup.\n    const hasGroupSegment = route.id.includes('/(');\n    const structuralParent = hasGroupSegment\n      ? findNearestParentById(route.id, routeById)\n      : undefined;\n    const fullPathParent = findNearestParentRoute(\n      route.fullPath,\n      routeByFullPath,\n    );\n    const parent = structuralParent ?? fullPathParent;\n    route.parentId = parent?.id ?? null;\n    route.path = computeLocalPath(route.fullPath, parent?.fullPath ?? null);\n  }\n\n  for (const route of routes) {\n    if (route.parentId) {\n      routeById.get(route.parentId)?.children.push(route.id);\n    }\n    if (routeByFullPath.get(route.fullPath) !== route) {\n      sharedFullPaths.add(route.fullPath);\n    }\n  }\n\n  return {\n    routes,\n    collisions,\n    canonicalByFullPath: routeByFullPath,\n    sharedFullPaths,\n  };\n}\n\nfunction canonicalRoutesByFullPath(\n  routes: RouteEntry[],\n): Map<string, RouteEntry> {\n  const map = new Map<string, RouteEntry>();\n  for (const route of routes) {\n    const existing = map.get(route.fullPath);\n    if (!existing) {\n      map.set(route.fullPath, route);\n    } else if (existing.isGroup && !route.isGroup) {\n      // Non-group routes always take precedence over group layouts.\n      map.set(route.fullPath, route);\n    } else if (existing.isGroup && route.isGroup) {\n      // Both are group layouts — tiebreak by id to ensure stable selection\n      // regardless of filesystem or glob ordering across platforms.\n      if (route.id.localeCompare(existing.id) < 0) {\n        map.set(route.fullPath, route);\n      }\n    }\n  }\n  return map;\n}\n\n/** A route file's path within its pages directory, e.g. `users/[id]`. */\nfunction toRouteFileKey(filename: string): string {\n  return filename.replace(\n    /^.*?[\\\\/](?:routes|pages|content)[\\\\/]|\\.page\\.(?:js|ts|analog|ag)$|\\.(?:ts|md|analog|ag)$/g,\n    '',\n  );\n}\n\nfunction isPathlessLayoutId(id: string): boolean {\n  const segments = id.split('/').filter(Boolean);\n  if (segments.length === 0) return false;\n  return /^\\([^)]*\\)$/.test(segments[segments.length - 1]);\n}\n\nfunction getRouteWeight(path: string): number {\n  if (path.includes('[[...')) return 3;\n  if (path.includes('[...')) return 2;\n  if (path.includes('[')) return 1;\n  return 0;\n}\n\nfunction getCollisionPriority(filename: string): number {\n  if (\n    filename.includes('/src/app/pages/') ||\n    filename.includes('/src/app/routes/') ||\n    filename.includes('/app/pages/') ||\n    filename.includes('/app/routes/') ||\n    filename.includes('/src/content/')\n  ) {\n    return 0;\n  }\n\n  return 1;\n}\n\n/** Import specifiers for a page module's typed exports. */\nexport interface RouteModuleImports {\n  routeMeta?: string;\n  load?: string;\n}\n\n/**\n * Generates the route-table section for the combined generated route module.\n *\n * `resolveModuleImports` adds `routeMeta` and `load` types for pages whose\n * URL is defined by a single file, along with the `routeMeta` of the layouts\n * that wrap them. URLs shared by several files, such as a layout and its\n * index page, are ambiguous and only get params and query types.\n */\nexport function generateRouteTableDeclaration(\n  manifest: RouteManifest,\n  resolveModuleImports?: (filename: string) => RouteModuleImports | undefined,\n): string {\n  const lines: string[] = [];\n  lines.push('/** @noprettier */');\n  lines.push('// This file is auto-generated by @analogjs/platform');\n  lines.push(\"import type {} from '@analogjs/router';\");\n  lines.push(\"declare module '@analogjs/router' {\");\n  lines.push('  interface AnalogRouteTable {');\n\n  const importType = (specifier: string, name: string) =>\n    `typeof import(${JSON.stringify(specifier)}).${name}`;\n\n  for (const route of manifest.canonicalByFullPath.values()) {\n    const paramsType = generateParamsType(route.params);\n    const queryType = 'Record<string, string | string[] | undefined>';\n\n    lines.push(`    ${JSON.stringify(route.fullPath)}: {`);\n    lines.push(`      params: ${paramsType};`);\n    lines.push(`      query: ${queryType};`);\n    if (\n      resolveModuleImports &&\n      route.kind === 'page' &&\n      !manifest.sharedFullPaths.has(route.fullPath)\n    ) {\n      const layoutRouteMeta = route.layouts.flatMap((layout) => {\n        const specifier = resolveModuleImports(layout)?.routeMeta;\n        return specifier ? [importType(specifier, 'routeMeta')] : [];\n      });\n      const imports = resolveModuleImports(route.filename);\n      if (layoutRouteMeta.length) {\n        lines.push(`      layoutRouteMeta: [${layoutRouteMeta.join(', ')}];`);\n      }\n      if (imports?.routeMeta) {\n        lines.push(\n          `      routeMeta: ${importType(imports.routeMeta, 'routeMeta')};`,\n        );\n      }\n      if (imports?.load) {\n        lines.push(`      load: ${importType(imports.load, 'load')};`);\n      }\n    }\n    lines.push(`    };`);\n  }\n\n  lines.push('  }');\n  lines.push('}');\n  lines.push('');\n  lines.push('export {};');\n  lines.push('');\n\n  return lines.join('\\n');\n}\n\nfunction generateParamsType(params: RouteParamInfo[]): string {\n  if (params.length === 0) return 'Record<string, never>';\n\n  const entries = params.map((p) => {\n    const key = isValidIdentifier(p.name) ? p.name : JSON.stringify(p.name);\n    switch (p.type) {\n      case 'dynamic':\n        return `${key}: string`;\n      case 'catchAll':\n        return `${key}: string[]`;\n      case 'optionalCatchAll':\n        return `${key}?: string[]`;\n    }\n  });\n\n  return `{ ${entries.join('; ')} }`;\n}\n\nfunction isValidIdentifier(name: string): boolean {\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);\n}\n\nfunction findNearestParentById(\n  id: string,\n  routesById: Map<string, RouteEntry>,\n): RouteEntry | undefined {\n  if (id === '/') {\n    return undefined;\n  }\n\n  const segments = id.split('/').filter(Boolean);\n  for (let index = segments.length - 1; index > 0; index--) {\n    const candidate = '/' + segments.slice(0, index).join('/');\n    const route = routesById.get(candidate);\n    if (route) {\n      return route;\n    }\n  }\n\n  return undefined;\n}\n\nfunction findNearestParentRoute(\n  fullPath: string,\n  routesByFullPath: Map<string, RouteEntry>,\n): RouteEntry | undefined {\n  if (fullPath === '/') {\n    return undefined;\n  }\n\n  const segments = fullPath.slice(1).split('/');\n  for (let index = segments.length - 1; index > 0; index--) {\n    const candidate = '/' + segments.slice(0, index).join('/');\n    const route = routesByFullPath.get(candidate);\n    if (route) {\n      return route;\n    }\n  }\n\n  return undefined;\n}\n\nfunction computeLocalPath(\n  fullPath: string,\n  parentFullPath: string | null,\n): string {\n  if (fullPath === '/') {\n    return '/';\n  }\n\n  if (!parentFullPath) {\n    return fullPath.slice(1);\n  }\n\n  const suffix = fullPath.slice(parentFullPath.length).replace(/^\\/+/, '');\n  return suffix || '/';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFA,SAAgB,oBAAoB,UAA0B;CAC5D,IAAI,OAAO,SAAS,QAClB,+KACA,GACD;CAED,MAAM,WAAqB,EAAE;AAC7B,QAAO,KAAK,QAAQ,6BAA6B,UAAU;AACzD,WAAS,KAAK,MAAM;AAEpB,SAAO,MAAM,SAAS,SAAS,EAAE;GACjC;AAEF,QAAO,KACJ,QAAQ,YAAY,GAAG,CACvB,QAAQ,4BAA4B,KAAK,CACzC,QAAQ,OAAO,IAAI;AAEtB,QAAO,KAAK,QAAQ,gBAAgB,GAAG,QAAQ,SAAS,OAAO,IAAI,EAAE;AACrE,QAAO,MAAM,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI;;;;;;;;;;;;AAaxD,SAAgB,kBAAkB,UAA0B;CAC1D,IAAI,OAAO,SAAS,QAClB,+KACA,GACD;CAED,MAAM,WAAqB,EAAE;AAC7B,QAAO,KAAK,QAAQ,qCAAqC,UAAU;AACjE,WAAS,KAAK,MAAM;AAEpB,SAAO,MAAM,SAAS,SAAS,EAAE;GACjC;AACF,QAAO,KAAK,QAAQ,OAAO,IAAI;AAE/B,QAAO,KAAK,QAAQ,gBAAgB,GAAG,QAAQ,SAAS,OAAO,IAAI,EAAE;AAIrE,QAAO,MAFU,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAE1B,KAAK,IAAI;;;;;AAMjC,SAAgB,mBAAmB,WAAqC;CACtE,MAAM,SAA2B,EAAE;AAEnC,MAAK,MAAM,SAAS,UAAU,SAAS,0BAA0B,CAC/D,QAAO,KAAK;EAAE,MAAM,MAAM;EAAI,MAAM;EAAoB,CAAC;AAE3D,MAAK,MAAM,SAAS,UAAU,SAAS,mCAAmC,CACxE,QAAO,KAAK;EAAE,MAAM,MAAM;EAAI,MAAM;EAAY,CAAC;AAEnD,MAAK,MAAM,SAAS,UAAU,SAAS,mCAAmC,CACxE,QAAO,KAAK;EAAE,MAAM,MAAM;EAAI,MAAM;EAAW,CAAC;AAGlD,QAAO;;;;;;;;;AAUT,SAAgB,sBACd,WACA,mBACe;CACf,MAAM,SAAuB,EAAE;CAC/B,MAAM,aAA+B,EAAE;CACvC,MAAM,kCAAkB,IAAI,KAAa;CACzC,MAAM,iCAAiB,IAAI,KAGxB;CACH,MAAM,cAAc,qBAAqB;CAKzC,MAAM,uBAAuB,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM;EACzD,MAAM,YAAY,YAAY,EAAE;EAChC,MAAM,YAAY,YAAY,EAAE;AAChC,MAAI,cAAc,UAChB,QAAO,YAAY;AAErB,SAAO,EAAE,cAAc,EAAE;GACzB;CAKF,MAAM,8BAAc,IAAI,KAAqB;AAC7C,MAAK,MAAM,YAAY,sBAAsB;EAC3C,MAAM,MAAM,eAAe,SAAS;AACpC,MAAI,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC,YAAY,IAAI,IAAI,CACpD,aAAY,IAAI,KAAK,SAAS;;AAIlC,MAAK,MAAM,YAAY,sBAAsB;EAC3C,MAAM,WAAW,oBAAoB,SAAS;EAC9C,MAAM,SAAS,mBAAmB,SAAS;EAC3C,MAAM,KAAK,kBAAkB,SAAS;EACtC,MAAM,mBAAmB,mBAAmB,GAAG;EAE/C,MAAM,aAAa,GAAG,MAAM,GAAG,GAAG,YAAY,IAAI,GAAG,EAAE;EACvD,MAAM,eAAe,KAAK,UAAU,CAAC,UAAU,WAAW,CAAC;EAE3D,MAAM,kBAAkB,YAAY,SAAS;AAM7C,MAAI,CAAC,kBAAkB;AACrB,OAAI,eAAe,IAAI,aAAa,EAAE;IACpC,MAAM,SAAS,eAAe,IAAI,aAAa;AAC/C,QAAI,OAAO,aAAa,SACtB;IAKF,MAAM,qBAAqB,GAAW,MAAc;KAClD,MAAM,UAAU;KAChB,MAAM,WAAW;AACjB,SAAI,QAAQ,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,CAGrC,QAFY,EAAE,QAAQ,SAAS,GAAG,KACnB,EAAE,QAAQ,UAAU,GAAG;AAGxC,YAAO;;AAET,QACE,kBAAkB,OAAO,UAAU,SAAS,IAC5C,kBAAkB,UAAU,OAAO,SAAS,EAC5C;AACA,qBAAgB,IAAI,SAAS;AAC7B;;AAEF,eAAW,KAAK;KACd;KACA,UAAU,OAAO;KACjB,aAAa;KACb,cAAc,OAAO,aAAa;KACnC,CAAC;AACF,YAAQ,KACN,8BAA8B,SAAS,wBACjC,OAAO,SAAS,SAAS,SAAS,cAC1B,OAAO,SAAS,4DAC/B;AACD;;AAEF,kBAAe,IAAI,cAAc;IAAE;IAAU,UAAU;IAAiB,CAAC;;EAG3E,MAAM,WAAW,eAAe,SAAS,CAAC,MAAM,IAAI;EACpD,MAAM,UAAoB,EAAE;AAC5B,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;GACxC,MAAM,SAAS,YAAY,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;AAC9D,OAAI,OAAQ,SAAQ,KAAK,OAAO;;AAGlC,SAAO,KAAK;GACV;GACA,MAAM;GACN;GACA;GACA;GACA,MAAM,SAAS,SAAS,MAAM,GAAG,YAAY;GAC7C,UAAU;GACV,UAAU,EAAE;GACZ,SAAS,OAAO,YAAY,GAAG,SAAS,SAAS;GACjD,SAAS;GACT,YAAY,OAAO,MAAM,UAAU,MAAM,SAAS,WAAW;GAC7D,oBAAoB,OAAO,MACxB,UAAU,MAAM,SAAS,mBAC3B;GACD;GACD,CAAC;;AAGJ,QAAO,MAAM,GAAG,MAAM;EACpB,MAAM,KAAK,eAAe,EAAE,SAAS;EACrC,MAAM,KAAK,eAAe,EAAE,SAAS;AACrC,MAAI,OAAO,GAAI,QAAO,KAAK;AAC3B,SAAO,EAAE,SAAS,cAAc,EAAE,SAAS;GAC3C;CAEF,MAAM,kBAAkB,0BAA0B,OAAO;CAEzD,MAAM,YAAY,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;AAEnE,MAAK,MAAM,SAAS,QAAQ;EAU1B,MAAM,mBADkB,MAAM,GAAG,SAAS,KAAK,GAE3C,sBAAsB,MAAM,IAAI,UAAU,GAC1C,KAAA;EACJ,MAAM,iBAAiB,uBACrB,MAAM,UACN,gBACD;EACD,MAAM,SAAS,oBAAoB;AACnC,QAAM,WAAW,QAAQ,MAAM;AAC/B,QAAM,OAAO,iBAAiB,MAAM,UAAU,QAAQ,YAAY,KAAK;;AAGzE,MAAK,MAAM,SAAS,QAAQ;AAC1B,MAAI,MAAM,SACR,WAAU,IAAI,MAAM,SAAS,EAAE,SAAS,KAAK,MAAM,GAAG;AAExD,MAAI,gBAAgB,IAAI,MAAM,SAAS,KAAK,MAC1C,iBAAgB,IAAI,MAAM,SAAS;;AAIvC,QAAO;EACL;EACA;EACA,qBAAqB;EACrB;EACD;;AAGH,SAAS,0BACP,QACyB;CACzB,MAAM,sBAAM,IAAI,KAAyB;AACzC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,WAAW,IAAI,IAAI,MAAM,SAAS;AACxC,MAAI,CAAC,SACH,KAAI,IAAI,MAAM,UAAU,MAAM;WACrB,SAAS,WAAW,CAAC,MAAM,QAEpC,KAAI,IAAI,MAAM,UAAU,MAAM;WACrB,SAAS,WAAW,MAAM;OAG/B,MAAM,GAAG,cAAc,SAAS,GAAG,GAAG,EACxC,KAAI,IAAI,MAAM,UAAU,MAAM;;;AAIpC,QAAO;;;AAIT,SAAS,eAAe,UAA0B;AAChD,QAAO,SAAS,QACd,+FACA,GACD;;AAGH,SAAS,mBAAmB,IAAqB;CAC/C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,QAAQ;AAC9C,KAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAO,cAAc,KAAK,SAAS,SAAS,SAAS,GAAG;;AAG1D,SAAS,eAAe,MAAsB;AAC5C,KAAI,KAAK,SAAS,QAAQ,CAAE,QAAO;AACnC,KAAI,KAAK,SAAS,OAAO,CAAE,QAAO;AAClC,KAAI,KAAK,SAAS,IAAI,CAAE,QAAO;AAC/B,QAAO;;AAGT,SAAS,qBAAqB,UAA0B;AACtD,KACE,SAAS,SAAS,kBAAkB,IACpC,SAAS,SAAS,mBAAmB,IACrC,SAAS,SAAS,cAAc,IAChC,SAAS,SAAS,eAAe,IACjC,SAAS,SAAS,gBAAgB,CAElC,QAAO;AAGT,QAAO;;;;;;;;;;AAiBT,SAAgB,8BACd,UACA,sBACQ;CACR,MAAM,QAAkB,EAAE;AAC1B,OAAM,KAAK,qBAAqB;AAChC,OAAM,KAAK,uDAAuD;AAClE,OAAM,KAAK,0CAA0C;AACrD,OAAM,KAAK,sCAAsC;AACjD,OAAM,KAAK,iCAAiC;CAE5C,MAAM,cAAc,WAAmB,SACrC,iBAAiB,KAAK,UAAU,UAAU,CAAC,IAAI;AAEjD,MAAK,MAAM,SAAS,SAAS,oBAAoB,QAAQ,EAAE;EACzD,MAAM,aAAa,mBAAmB,MAAM,OAAO;EACnD,MAAM,YAAY;AAElB,QAAM,KAAK,OAAO,KAAK,UAAU,MAAM,SAAS,CAAC,KAAK;AACtD,QAAM,KAAK,iBAAiB,WAAW,GAAG;AAC1C,QAAM,KAAK,gBAAgB,UAAU,GAAG;AACxC,MACE,wBACA,MAAM,SAAS,UACf,CAAC,SAAS,gBAAgB,IAAI,MAAM,SAAS,EAC7C;GACA,MAAM,kBAAkB,MAAM,QAAQ,SAAS,WAAW;IACxD,MAAM,YAAY,qBAAqB,OAAO,EAAE;AAChD,WAAO,YAAY,CAAC,WAAW,WAAW,YAAY,CAAC,GAAG,EAAE;KAC5D;GACF,MAAM,UAAU,qBAAqB,MAAM,SAAS;AACpD,OAAI,gBAAgB,OAClB,OAAM,KAAK,2BAA2B,gBAAgB,KAAK,KAAK,CAAC,IAAI;AAEvE,OAAI,SAAS,UACX,OAAM,KACJ,oBAAoB,WAAW,QAAQ,WAAW,YAAY,CAAC,GAChE;AAEH,OAAI,SAAS,KACX,OAAM,KAAK,eAAe,WAAW,QAAQ,MAAM,OAAO,CAAC,GAAG;;AAGlE,QAAM,KAAK,SAAS;;AAGtB,OAAM,KAAK,MAAM;AACjB,OAAM,KAAK,IAAI;AACf,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,aAAa;AACxB,OAAM,KAAK,GAAG;AAEd,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,mBAAmB,QAAkC;AAC5D,KAAI,OAAO,WAAW,EAAG,QAAO;AAchC,QAAO,KAZS,OAAO,KAAK,MAAM;EAChC,MAAM,MAAM,kBAAkB,EAAE,KAAK,GAAG,EAAE,OAAO,KAAK,UAAU,EAAE,KAAK;AACvE,UAAQ,EAAE,MAAV;GACE,KAAK,UACH,QAAO,GAAG,IAAI;GAChB,KAAK,WACH,QAAO,GAAG,IAAI;GAChB,KAAK,mBACH,QAAO,GAAG,IAAI;;GAElB,CAEkB,KAAK,KAAK,CAAC;;AAGjC,SAAS,kBAAkB,MAAuB;AAChD,QAAO,6BAA6B,KAAK,KAAK;;AAGhD,SAAS,sBACP,IACA,YACwB;AACxB,KAAI,OAAO,IACT;CAGF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,QAAQ;AAC9C,MAAK,IAAI,QAAQ,SAAS,SAAS,GAAG,QAAQ,GAAG,SAAS;EACxD,MAAM,YAAY,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI;EAC1D,MAAM,QAAQ,WAAW,IAAI,UAAU;AACvC,MAAI,MACF,QAAO;;;AAOb,SAAS,uBACP,UACA,kBACwB;AACxB,KAAI,aAAa,IACf;CAGF,MAAM,WAAW,SAAS,MAAM,EAAE,CAAC,MAAM,IAAI;AAC7C,MAAK,IAAI,QAAQ,SAAS,SAAS,GAAG,QAAQ,GAAG,SAAS;EACxD,MAAM,YAAY,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI;EAC1D,MAAM,QAAQ,iBAAiB,IAAI,UAAU;AAC7C,MAAI,MACF,QAAO;;;AAOb,SAAS,iBACP,UACA,gBACQ;AACR,KAAI,aAAa,IACf,QAAO;AAGT,KAAI,CAAC,eACH,QAAO,SAAS,MAAM,EAAE;AAI1B,QADe,SAAS,MAAM,eAAe,OAAO,CAAC,QAAQ,QAAQ,GAAG,IACvD"}

package/src/lib/router-plugin.d.ts

@@ -1,21 +1,21 @@
-import { Plugin } from 'vite';
-import { Options } from './options.js';
+import { Plugin } from "vite";
+import { Options } from "./options.js";
 /**
- * Router plugin that handles route file discovery and hot module replacement.
- *
- * This plugin provides three main functionalities:
- * 1. Route invalidation when files are added/deleted (HMR workaround)
- * 2. Dynamic route file discovery and import generation
- * 3. Content route file discovery for markdown and Analog content
- *
- * @param options Configuration options for the router plugin
- * @returns Array of Vite plugins for route handling
- *
- * IMPORTANT: This plugin uses tinyglobby for file discovery.
- * Key behavior with { dot: true, absolute: true }:
- * - Returns absolute paths for ALL discovered files
- * - Path normalization is required to match expected output format
- * - Files within project root must use relative paths in object keys
- * - Files outside project root keep absolute paths in object keys
- */
+* Router plugin that handles route file discovery and hot module replacement.
+*
+* This plugin provides three main functionalities:
+* 1. Route invalidation when files are added/deleted (HMR workaround)
+* 2. Dynamic route file discovery and import generation
+* 3. Content route file discovery for markdown and Analog content
+*
+* @param options Configuration options for the router plugin
+* @returns Array of Vite plugins for route handling
+*
+* IMPORTANT: This plugin uses tinyglobby for file discovery.
+* Key behavior with { dot: true, absolute: true }:
+* - Returns absolute paths for ALL discovered files
+* - Path normalization is required to match expected output format
+* - Files within project root must use relative paths in object keys
+* - Files outside project root keep absolute paths in object keys
+*/
 export declare function routerPlugin(options?: Options): Plugin[];

package/src/lib/router-plugin.js

@@ -1,6 +1,8 @@
+import { analyzeAnalogRouteFile, formatAnalogRouteIdiomDiagnostic } from "./route-idiom-diagnostics.js";
+import { isAbsolute, relative, resolve } from "node:path";
+import { readFileSync } from "node:fs";
 import { normalizePath } from "vite";
 import { globSync } from "tinyglobby";
-import { resolve } from "node:path";
 //#region packages/platform/src/lib/router-plugin.ts
 /**
 * Router plugin that handles route file discovery and hot module replacement.
@@ -21,10 +23,105 @@ import { resolve } from "node:path";
 * - Files outside project root keep absolute paths in object keys
 */
 function routerPlugin(options) {
-	const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.cwd());
+	const workspaceRoot = normalizePath(options?.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd());
 	let config;
 	let root;
-	const isRouteLikeFile = (path) => path.includes(`routes`) || path.includes(`pages`) || path.includes("content");
+	const normalizeWatchedDir = (dir) => {
+		const normalizedDir = normalizePath(dir.startsWith(`${workspaceRoot}/`) || dir === workspaceRoot ? dir : dir.startsWith("/") ? `${workspaceRoot}${dir}` : resolve(workspaceRoot, dir));
+		return normalizedDir.endsWith("/") ? normalizedDir.slice(0, -1) : normalizedDir;
+	};
+	const additionalPagesDirs = (options?.additionalPagesDirs || []).map((dir) => normalizeWatchedDir(dir));
+	const additionalContentDirs = (options?.additionalContentDirs || []).map((dir) => normalizeWatchedDir(dir));
+	const getRouteLikeDirs = () => [
+		...root ? [
+			normalizeWatchedDir(`${root}/app/routes`),
+			normalizeWatchedDir(`${root}/src/app/routes`),
+			normalizeWatchedDir(`${root}/src/app/pages`),
+			normalizeWatchedDir(`${root}/src/content`)
+		] : [],
+		"/app/routes",
+		"/src/app/routes",
+		"/src/app/pages",
+		"/src/content",
+		...additionalPagesDirs,
+		...additionalContentDirs
+	];
+	let routeFilesCache;
+	let pageRouteFilesCache;
+	let contentRouteFilesCache;
+	let endpointFilesCache;
+	const routeDiagnosticCache = /* @__PURE__ */ new Map();
+	const isRouteLikeFile = (path) => {
+		const normalizedPath = normalizePath(path);
+		return getRouteLikeDirs().some((dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`));
+	};
+	const discoverRouteFiles = () => {
+		routeFilesCache ??= globSync([
+			`${root}/app/routes/**/*.ts`,
+			`${root}/src/app/routes/**/*.ts`,
+			`${root}/src/app/pages/**/*.page.ts`,
+			...additionalPagesDirs.map((dir) => `${dir}/**/*.page.ts`)
+		], {
+			dot: true,
+			absolute: true
+		});
+		return routeFilesCache;
+	};
+	const discoverContentRouteFiles = () => {
+		contentRouteFilesCache ??= globSync([
+			`${root}/src/app/routes/**/*.md`,
+			`${root}/src/app/pages/**/*.md`,
+			`${root}/src/content/**/*.md`,
+			...additionalContentDirs.map((dir) => `${dir}/**/*.md`)
+		], {
+			dot: true,
+			absolute: true
+		});
+		return contentRouteFilesCache;
+	};
+	const discoverEndpointFiles = () => {
+		endpointFilesCache ??= globSync([`${root}/src/app/pages/**/*.server.ts`, ...additionalPagesDirs.map((dir) => `${dir}/**/*.server.ts`)], {
+			dot: true,
+			absolute: true
+		});
+		return endpointFilesCache;
+	};
+	const discoverPageRouteFiles = () => {
+		pageRouteFilesCache ??= discoverRouteFiles().filter((file) => file.endsWith(".page.ts"));
+		return pageRouteFilesCache;
+	};
+	const invalidateDiscoveryCaches = () => {
+		routeFilesCache = void 0;
+		pageRouteFilesCache = void 0;
+		contentRouteFilesCache = void 0;
+		endpointFilesCache = void 0;
+	};
+	const reportRouteDiagnostics = (path) => {
+		if (!path.endsWith(".page.ts")) return;
+		try {
+			const rendered = analyzeAnalogRouteFile({
+				filename: path,
+				code: readFileSync(path, "utf-8"),
+				routeFiles: discoverPageRouteFiles()
+			}).map((diagnostic) => formatAnalogRouteIdiomDiagnostic(diagnostic, path, workspaceRoot));
+			const fingerprint = rendered.join("\n\n");
+			if (!fingerprint) {
+				routeDiagnosticCache.delete(path);
+				return;
+			}
+			if (routeDiagnosticCache.get(path) === fingerprint) return;
+			routeDiagnosticCache.set(path, fingerprint);
+			rendered.forEach((message) => console.warn(message));
+		} catch {
+			routeDiagnosticCache.delete(path);
+		}
+	};
+	const getModuleKey = (module) => {
+		if (!root) return `/${normalizePath(relative(workspaceRoot, module))}`;
+		const relToRoot = normalizePath(relative(root, module));
+		if (!relToRoot.startsWith("..") && !isAbsolute(relToRoot)) return `/${relToRoot}`;
+		return `/${normalizePath(relative(workspaceRoot, module))}`;
+	};
 	const invalidateFileModules = (server, path) => {
 		const normalizedPath = normalizePath(path);
 		(server.moduleGraph.getModulesByFile?.(normalizedPath) ?? server.moduleGraph.fileToModulesMap.get(normalizedPath))?.forEach((mod) => {
@@ -44,9 +141,16 @@ function routerPlugin(options) {
 				*
 				* @param path The file path that was added or deleted
 				*/
-				function invalidateRoutes(path) {
+				function invalidateRoutes(path, event) {
 					if (!isRouteLikeFile(path)) return;
+					if (event !== "change") invalidateDiscoveryCaches();
+					if (event === "change") reportRouteDiagnostics(path);
+					else if (event === "unlink") {
+						routeDiagnosticCache.delete(path);
+						discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
+					} else discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
 					invalidateFileModules(server, path);
+					if (event === "change") return;
 					server.moduleGraph.fileToModulesMap.forEach((mods) => {
 						mods.forEach((mod) => {
 							if (mod.id?.includes("analogjs") && mod.id?.includes("fesm")) {
@@ -57,11 +161,19 @@ function routerPlugin(options) {
 							}
 						});
 					});
+					server.ws.send("analog:debug-full-reload", {
+						plugin: "platform:router-plugin",
+						reason: "route-graph-shape-changed",
+						event,
+						path
+					});
 					server.ws.send({ type: "full-reload" });
 				}
-				server.watcher.on("add", invalidateRoutes);
-				server.watcher.on("change", invalidateRoutes);
-				server.watcher.on("unlink", invalidateRoutes);
+				server.watcher.on("add", (path) => invalidateRoutes(path, "add"));
+				server.watcher.on("change", (path) => invalidateRoutes(path, "change"));
+				server.watcher.on("unlink", (path) => invalidateRoutes(path, "unlink"));
+				for (const dir of [...additionalPagesDirs, ...additionalContentDirs]) server.watcher.add(dir);
+				discoverPageRouteFiles().forEach((file) => reportRouteDiagnostics(file));
 			}
 		},
 		{
@@ -72,37 +184,22 @@ function routerPlugin(options) {
 				root = normalizePath(resolve(workspaceRoot, config.root || ".") || ".");
 			},
 			transform: {
-				filter: { code: "ANALOG_ROUTE_FILES" },
+				filter: { code: "_ROUTE_FILES" },
 				handler(code) {
 					if (code.includes("ANALOG_ROUTE_FILES") || code.includes("ANALOG_CONTENT_ROUTE_FILES")) {
-						const routeFiles = globSync([
-							`${root}/app/routes/**/*.ts`,
-							`${root}/src/app/routes/**/*.ts`,
-							`${root}/src/app/pages/**/*.page.ts`,
-							...(options?.additionalPagesDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.page.ts`)
-						], {
-							dot: true,
-							absolute: true
-						});
-						const contentRouteFiles = globSync([
-							`${root}/src/app/routes/**/*.md`,
-							`${root}/src/app/pages/**/*.md`,
-							`${root}/src/content/**/*.md`,
-							...(options?.additionalContentDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.md`)
-						], {
-							dot: true,
-							absolute: true
-						});
+						const routeFiles = discoverRouteFiles();
+						const contentRouteFiles = discoverContentRouteFiles();
 						let result = code.replace("ANALOG_ROUTE_FILES = {};", `
               ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {
-							return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}')`;
+							return `"${getModuleKey(module)}": () => import('${module}')`;
 						})}};
             `);
 						result = result.replace("ANALOG_CONTENT_ROUTE_FILES = {};", `
             ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {
-							return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
+							return `"${getModuleKey(module)}": () => import('${module}?analog-content-file=true').then(m => m.default)`;
 						})}};
             `);
+						result = result.replace("ANALOG_CONTENT_FILE_COUNT = 0", `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`);
 						return {
 							code: result,
 							map: { mappings: "" }
@@ -118,14 +215,11 @@ function routerPlugin(options) {
 				filter: { code: "ANALOG_PAGE_ENDPOINTS" },
 				handler(code) {
 					if (code.includes("ANALOG_PAGE_ENDPOINTS")) {
-						const endpointFiles = globSync([`${root}/src/app/pages/**/*.server.ts`, ...(options?.additionalPagesDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.server.ts`)], {
-							dot: true,
-							absolute: true
-						});
+						const endpointFiles = discoverEndpointFiles();
 						return {
 							code: code.replace("ANALOG_PAGE_ENDPOINTS = {};", `
               ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {
-								return `"${module.startsWith(root) ? module.replace(root, "") : module}": () => import('${module}')`;
+								return `"${getModuleKey(module)}": () => import('${module}')`;
 							})}};
             `),
 							map: { mappings: "" }