@analogjs/platform 3.0.0-alpha.3 → 3.0.0-alpha.31

package/src/lib/route-file-discovery.js

@@ -0,0 +1,114 @@
+import { resolve } from "node:path";
+import { normalizePath } from "vite";
+import { globSync } from "tinyglobby";
+//#region packages/platform/src/lib/route-file-discovery.ts
+function createRouteFileDiscovery(options) {
+	const { root, workspaceRoot, additionalPagesDirs, additionalContentDirs } = options;
+	let routeFilesCache = /* @__PURE__ */ new Set();
+	let contentFilesCache = /* @__PURE__ */ new Set();
+	let appLocalFilesCache = /* @__PURE__ */ new Set();
+	let initialized = false;
+	const joinDir = (dir) => dir.startsWith(workspaceRoot) ? normalizePath(dir) : dir.startsWith("/") ? normalizePath(`${workspaceRoot}${dir}`) : normalizePath(resolve(workspaceRoot, dir));
+	const additionalPagesRoots = additionalPagesDirs.map(joinDir);
+	const additionalContentRoots = additionalContentDirs.map(joinDir);
+	function normalizePath_(absolutePath) {
+		const normalized = normalizePath(absolutePath);
+		if (normalized.startsWith(root)) return normalized.slice(root.length);
+		if (normalized.startsWith(workspaceRoot)) return normalized.slice(workspaceRoot.length);
+		return normalized;
+	}
+	function isWithinDir(path, dir) {
+		return path === dir || path.startsWith(`${dir}/`);
+	}
+	function getDiscoveredFileKind(path) {
+		const normalized = normalizePath(path);
+		if (normalized.endsWith(".md") && (normalized.includes("/src/app/routes/") || normalized.includes("/src/app/pages/") || normalized.includes("/src/content/") || additionalContentRoots.some((dir) => isWithinDir(normalized, dir)))) return "content";
+		if ((normalized.includes("/app/routes/") || normalized.includes("/src/app/routes/")) && normalized.endsWith(".ts")) return "route";
+		if (normalized.endsWith(".page.ts") && (normalized.includes("/src/app/pages/") || additionalPagesRoots.some((dir) => isWithinDir(normalized, dir)))) return "route";
+		return null;
+	}
+	function scanRouteFiles() {
+		const appLocalGlobs = [
+			`${root}/app/routes/**/*.ts`,
+			`${root}/src/app/routes/**/*.ts`,
+			`${root}/src/app/pages/**/*.page.ts`
+		];
+		const additionalGlobs = additionalPagesDirs.map((dir) => `${joinDir(dir)}/**/*.page.ts`);
+		const appLocal = globSync(appLocalGlobs, {
+			dot: true,
+			absolute: true
+		}).map(normalizePath_);
+		const additional = globSync(additionalGlobs, {
+			dot: true,
+			absolute: true
+		}).map(normalizePath_);
+		for (const f of appLocal) appLocalFilesCache.add(f);
+		return [...appLocal, ...additional];
+	}
+	function scanContentFiles() {
+		const appLocalGlobs = [
+			`${root}/src/app/routes/**/*.md`,
+			`${root}/src/app/pages/**/*.md`,
+			`${root}/src/content/**/*.md`
+		];
+		const additionalGlobs = additionalContentDirs.map((dir) => `${joinDir(dir)}/**/*.md`);
+		const appLocal = globSync(appLocalGlobs, {
+			dot: true,
+			absolute: true
+		}).map(normalizePath_);
+		const additional = globSync(additionalGlobs, {
+			dot: true,
+			absolute: true
+		}).map(normalizePath_);
+		for (const f of appLocal) appLocalFilesCache.add(f);
+		return [...appLocal, ...additional];
+	}
+	function isAppLocalByPath(absolutePath) {
+		return normalizePath(absolutePath).startsWith(root);
+	}
+	function ensureInitialized() {
+		if (initialized) return;
+		routeFilesCache = new Set(scanRouteFiles());
+		contentFilesCache = new Set(scanContentFiles());
+		initialized = true;
+	}
+	return {
+		getRouteFiles() {
+			ensureInitialized();
+			return [...routeFilesCache].sort();
+		},
+		getContentFiles() {
+			ensureInitialized();
+			return [...contentFilesCache].sort();
+		},
+		getDiscoveredFileKind(path) {
+			return getDiscoveredFileKind(path);
+		},
+		updateDiscoveredFile(path, event) {
+			ensureInitialized();
+			const kind = getDiscoveredFileKind(path);
+			if (!kind) return;
+			const normalizedPath = normalizePath_(path);
+			const targetCache = kind === "content" ? contentFilesCache : routeFilesCache;
+			if (event === "unlink") {
+				targetCache.delete(normalizedPath);
+				appLocalFilesCache.delete(normalizedPath);
+				return;
+			}
+			targetCache.add(normalizedPath);
+			if (isAppLocalByPath(path)) appLocalFilesCache.add(normalizedPath);
+		},
+		isAppLocal(normalizedFilename) {
+			ensureInitialized();
+			return appLocalFilesCache.has(normalizedFilename);
+		},
+		reset() {
+			initialized = false;
+			appLocalFilesCache = /* @__PURE__ */ new Set();
+		}
+	};
+}
+//#endregion
+export { createRouteFileDiscovery };
+
+//# sourceMappingURL=route-file-discovery.js.map

package/src/lib/route-file-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-file-discovery.js","names":[],"sources":["../../../src/lib/route-file-discovery.ts"],"sourcesContent":["import { normalizePath } from 'vite';\nimport { resolve } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nexport interface RouteFileDiscoveryOptions {\n  root: string;\n  workspaceRoot: string;\n  additionalPagesDirs: string[];\n  additionalContentDirs: string[];\n}\n\nexport interface RouteFileDiscovery {\n  getRouteFiles(): string[];\n  getContentFiles(): string[];\n  getDiscoveredFileKind(path: string): 'route' | 'content' | null;\n  updateDiscoveredFile(path: string, event: 'add' | 'change' | 'unlink'): void;\n  /**\n   * Returns true if the normalized filename was discovered from an app-local\n   * glob (under the configured root) rather than from an additional directory.\n   *\n   * Used by collision priority to prefer app-local routes over shared/external\n   * routes based on actual configured roots instead of hard-coded path\n   * substrings.\n   */\n  isAppLocal(normalizedFilename: string): boolean;\n  reset(): void;\n}\n\nexport function createRouteFileDiscovery(\n  options: RouteFileDiscoveryOptions,\n): RouteFileDiscovery {\n  const { root, workspaceRoot, additionalPagesDirs, additionalContentDirs } =\n    options;\n\n  let routeFilesCache = new Set<string>();\n  let contentFilesCache = new Set<string>();\n  let appLocalFilesCache = new Set<string>();\n  let initialized = false;\n  const joinDir = (dir: string) =>\n    dir.startsWith(workspaceRoot)\n      ? normalizePath(dir)\n      : dir.startsWith('/')\n        ? normalizePath(`${workspaceRoot}${dir}`)\n        : normalizePath(resolve(workspaceRoot, dir));\n  const additionalPagesRoots = additionalPagesDirs.map(joinDir);\n  const additionalContentRoots = additionalContentDirs.map(joinDir);\n\n  function normalizePath_(absolutePath: string): string {\n    const normalized = normalizePath(absolutePath);\n    if (normalized.startsWith(root)) {\n      return normalized.slice(root.length);\n    }\n    if (normalized.startsWith(workspaceRoot)) {\n      return normalized.slice(workspaceRoot.length);\n    }\n    return normalized;\n  }\n\n  function isWithinDir(path: string, dir: string): boolean {\n    return path === dir || path.startsWith(`${dir}/`);\n  }\n\n  function getDiscoveredFileKind(path: string): 'route' | 'content' | null {\n    const normalized = normalizePath(path);\n\n    if (\n      normalized.endsWith('.md') &&\n      (normalized.includes('/src/app/routes/') ||\n        normalized.includes('/src/app/pages/') ||\n        normalized.includes('/src/content/') ||\n        additionalContentRoots.some((dir) => isWithinDir(normalized, dir)))\n    ) {\n      return 'content';\n    }\n\n    if (\n      (normalized.includes('/app/routes/') ||\n        normalized.includes('/src/app/routes/')) &&\n      normalized.endsWith('.ts')\n    ) {\n      return 'route';\n    }\n\n    // Keep the dev watcher aligned with the build-time route scan. In\n    // particular, `src/server/routes/**` must stay out of typed route codegen\n    // because Nitro API handlers are not client-navigable pages.\n    if (\n      normalized.endsWith('.page.ts') &&\n      (normalized.includes('/src/app/pages/') ||\n        additionalPagesRoots.some((dir) => isWithinDir(normalized, dir)))\n    ) {\n      return 'route';\n    }\n\n    return null;\n  }\n\n  function scanRouteFiles(): string[] {\n    const appLocalGlobs = [\n      `${root}/app/routes/**/*.ts`,\n      `${root}/src/app/routes/**/*.ts`,\n      `${root}/src/app/pages/**/*.page.ts`,\n    ];\n    const additionalGlobs = additionalPagesDirs.map(\n      (dir) => `${joinDir(dir)}/**/*.page.ts`,\n    );\n\n    const appLocal = globSync(appLocalGlobs, {\n      dot: true,\n      absolute: true,\n    }).map(normalizePath_);\n\n    const additional = globSync(additionalGlobs, {\n      dot: true,\n      absolute: true,\n    }).map(normalizePath_);\n\n    for (const f of appLocal) {\n      appLocalFilesCache.add(f);\n    }\n\n    return [...appLocal, ...additional];\n  }\n\n  function scanContentFiles(): string[] {\n    const appLocalGlobs = [\n      `${root}/src/app/routes/**/*.md`,\n      `${root}/src/app/pages/**/*.md`,\n      `${root}/src/content/**/*.md`,\n    ];\n    const additionalGlobs = additionalContentDirs.map(\n      (dir) => `${joinDir(dir)}/**/*.md`,\n    );\n\n    const appLocal = globSync(appLocalGlobs, {\n      dot: true,\n      absolute: true,\n    }).map(normalizePath_);\n\n    const additional = globSync(additionalGlobs, {\n      dot: true,\n      absolute: true,\n    }).map(normalizePath_);\n\n    for (const f of appLocal) {\n      appLocalFilesCache.add(f);\n    }\n\n    return [...appLocal, ...additional];\n  }\n\n  function isAppLocalByPath(absolutePath: string): boolean {\n    const normalized = normalizePath(absolutePath);\n    return normalized.startsWith(root);\n  }\n\n  function ensureInitialized(): void {\n    if (initialized) {\n      return;\n    }\n\n    routeFilesCache = new Set(scanRouteFiles());\n    contentFilesCache = new Set(scanContentFiles());\n    initialized = true;\n  }\n\n  return {\n    getRouteFiles(): string[] {\n      ensureInitialized();\n      return [...routeFilesCache].sort();\n    },\n\n    getContentFiles(): string[] {\n      ensureInitialized();\n      return [...contentFilesCache].sort();\n    },\n\n    getDiscoveredFileKind(path: string): 'route' | 'content' | null {\n      return getDiscoveredFileKind(path);\n    },\n\n    updateDiscoveredFile(\n      path: string,\n      event: 'add' | 'change' | 'unlink',\n    ): void {\n      ensureInitialized();\n      const kind = getDiscoveredFileKind(path);\n      if (!kind) {\n        return;\n      }\n\n      const normalizedPath = normalizePath_(path);\n      const targetCache =\n        kind === 'content' ? contentFilesCache : routeFilesCache;\n\n      if (event === 'unlink') {\n        targetCache.delete(normalizedPath);\n        appLocalFilesCache.delete(normalizedPath);\n        return;\n      }\n\n      targetCache.add(normalizedPath);\n      if (isAppLocalByPath(path)) {\n        appLocalFilesCache.add(normalizedPath);\n      }\n    },\n\n    isAppLocal(normalizedFilename: string): boolean {\n      ensureInitialized();\n      return appLocalFilesCache.has(normalizedFilename);\n    },\n\n    reset(): void {\n      initialized = false;\n      appLocalFilesCache = new Set<string>();\n    },\n  };\n}\n"],"mappings":"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"}

package/src/lib/route-generation-plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "vite";
+import type { Options } from "./options.js";
+export declare function routeGenerationPlugin(options?: Options): Plugin;

package/src/lib/route-generation-plugin.js

@@ -0,0 +1,45 @@
+import { debugTypedRouter } from "./utils/debug.js";
+import { typedRoutes } from "./typed-routes-plugin.js";
+//#region packages/platform/src/lib/route-generation-plugin.ts
+function resolveTypedRouterOptions(experimental) {
+	const typedRouter = experimental?.typedRouter;
+	if (typedRouter === false) return {
+		enabled: false,
+		options: {}
+	};
+	if (!typedRouter || typedRouter === true) return {
+		enabled: true,
+		options: { jsonLdManifest: true }
+	};
+	return {
+		enabled: true,
+		options: {
+			...typedRouter,
+			jsonLdManifest: typedRouter.jsonLdManifest ?? true
+		}
+	};
+}
+function routeGenerationPlugin(options) {
+	const { enabled, options: typedRouterOptions } = resolveTypedRouterOptions(options?.experimental);
+	if (!enabled) {
+		debugTypedRouter("disabled by experimental.typedRouter === false");
+		return { name: "analog-route-generation-disabled" };
+	}
+	const pluginOptions = {
+		...typedRouterOptions,
+		workspaceRoot: options?.workspaceRoot,
+		additionalPagesDirs: options?.additionalPagesDirs,
+		additionalContentDirs: options?.additionalContentDirs
+	};
+	debugTypedRouter("enabled", {
+		outFile: pluginOptions.outFile,
+		jsonLdManifest: pluginOptions.jsonLdManifest,
+		additionalPagesDirs: pluginOptions.additionalPagesDirs,
+		additionalContentDirs: pluginOptions.additionalContentDirs
+	});
+	return typedRoutes(pluginOptions);
+}
+//#endregion
+export { routeGenerationPlugin };
+
+//# sourceMappingURL=route-generation-plugin.js.map

package/src/lib/route-generation-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-generation-plugin.js","names":[],"sources":["../../../src/lib/route-generation-plugin.ts"],"sourcesContent":["import type { Plugin } from 'vite';\n\nimport type { Options, TypedRouterOptions } from './options.js';\nimport {\n  typedRoutes,\n  type TypedRoutesPluginOptions,\n} from './typed-routes-plugin.js';\nimport { debugTypedRouter } from './utils/debug.js';\n\nfunction resolveTypedRouterOptions(experimental: Options['experimental']): {\n  enabled: boolean;\n  options: TypedRouterOptions;\n} {\n  const typedRouter = experimental?.typedRouter;\n  if (typedRouter === false) {\n    return { enabled: false, options: {} };\n  }\n  if (!typedRouter || typedRouter === true) {\n    return { enabled: true, options: { jsonLdManifest: true } };\n  }\n  return {\n    enabled: true,\n    options: {\n      ...typedRouter,\n      jsonLdManifest: typedRouter.jsonLdManifest ?? true,\n    },\n  };\n}\n\nexport function routeGenerationPlugin(options?: Options): Plugin {\n  const { enabled, options: typedRouterOptions } = resolveTypedRouterOptions(\n    options?.experimental,\n  );\n\n  if (!enabled) {\n    debugTypedRouter('disabled by experimental.typedRouter === false');\n    return {\n      name: 'analog-route-generation-disabled',\n    };\n  }\n\n  const pluginOptions: TypedRoutesPluginOptions = {\n    ...typedRouterOptions,\n    workspaceRoot: options?.workspaceRoot,\n    additionalPagesDirs: options?.additionalPagesDirs,\n    additionalContentDirs: options?.additionalContentDirs,\n  };\n  debugTypedRouter('enabled', {\n    outFile: pluginOptions.outFile,\n    jsonLdManifest: pluginOptions.jsonLdManifest,\n    additionalPagesDirs: pluginOptions.additionalPagesDirs,\n    additionalContentDirs: pluginOptions.additionalContentDirs,\n  });\n\n  return typedRoutes(pluginOptions);\n}\n"],"mappings":";;;AASA,SAAS,0BAA0B,cAGjC;CACA,MAAM,cAAc,cAAc;AAClC,KAAI,gBAAgB,MAClB,QAAO;EAAE,SAAS;EAAO,SAAS,EAAE;EAAE;AAExC,KAAI,CAAC,eAAe,gBAAgB,KAClC,QAAO;EAAE,SAAS;EAAM,SAAS,EAAE,gBAAgB,MAAM;EAAE;AAE7D,QAAO;EACL,SAAS;EACT,SAAS;GACP,GAAG;GACH,gBAAgB,YAAY,kBAAkB;GAC/C;EACF;;AAGH,SAAgB,sBAAsB,SAA2B;CAC/D,MAAM,EAAE,SAAS,SAAS,uBAAuB,0BAC/C,SAAS,aACV;AAED,KAAI,CAAC,SAAS;AACZ,mBAAiB,iDAAiD;AAClE,SAAO,EACL,MAAM,oCACP;;CAGH,MAAM,gBAA0C;EAC9C,GAAG;EACH,eAAe,SAAS;EACxB,qBAAqB,SAAS;EAC9B,uBAAuB,SAAS;EACjC;AACD,kBAAiB,WAAW;EAC1B,SAAS,cAAc;EACvB,gBAAgB,cAAc;EAC9B,qBAAqB,cAAc;EACnC,uBAAuB,cAAc;EACtC,CAAC;AAEF,QAAO,YAAY,cAAc"}

package/src/lib/route-idiom-diagnostics.d.ts

@@ -0,0 +1,13 @@
+export interface AnalogRouteIdiomDiagnostic {
+	code: string;
+	severity: "error" | "warning";
+	message: string;
+	details?: string;
+}
+export interface AnalyzeAnalogRouteFileOptions {
+	filename: string;
+	code: string;
+	routeFiles?: string[];
+}
+export declare function analyzeAnalogRouteFile(options: AnalyzeAnalogRouteFileOptions): AnalogRouteIdiomDiagnostic[];
+export declare function formatAnalogRouteIdiomDiagnostic(diagnostic: AnalogRouteIdiomDiagnostic, filename: string, workspaceRoot: string): string;

package/src/lib/route-idiom-diagnostics.js

@@ -0,0 +1,160 @@
+import { relative } from "node:path";
+import { normalizePath } from "vite";
+import { parseSync } from "oxc-parser";
+//#region packages/platform/src/lib/route-idiom-diagnostics.ts
+var PAGE_FILE_RE = /\.page\.ts$/;
+var ROUTER_OUTLET_RE = /\bRouterOutlet\b|<router-outlet(?:\s|>)/;
+function analyzeAnalogRouteFile(options) {
+	const { filename, code, routeFiles = [] } = options;
+	const parseResult = parseSync(filename, code, {
+		lang: "ts",
+		sourceType: "module",
+		range: true,
+		showSemanticErrors: true
+	});
+	const parseDiagnostics = parseResult.errors.map((error) => toParseDiagnostic(error));
+	if (parseDiagnostics.some((diagnostic) => diagnostic.severity === "error")) return parseDiagnostics;
+	const program = parseResult.program;
+	const exportedBindings = collectExportedBindings(program);
+	const routeMetaBindingName = exportedBindings.routeMeta;
+	const routeJsonLdBindingName = exportedBindings.routeJsonLd;
+	const diagnostics = [...parseDiagnostics];
+	const routeMetaInfo = routeMetaBindingName ? getRouteMetaInfo(program, routeMetaBindingName) : null;
+	if (!exportedBindings.hasDefaultExport && !routeMetaInfo?.hasRedirect) diagnostics.push({
+		code: "missing-default-export",
+		severity: "warning",
+		message: "Route files should default-export the page component, unless they are redirect-only routes.",
+		details: "Add `export default class ...` or define `routeMeta.redirectTo` for a redirect route."
+	});
+	if (exportedBindings.hasDefaultExport && routeMetaInfo?.hasRedirect) diagnostics.push({
+		code: "redirect-with-component",
+		severity: "warning",
+		message: "Redirect routes should not also export a page component.",
+		details: "Analog ignores the default export when `routeMeta.redirectTo` is present. Remove the component export or remove the redirect."
+	});
+	if (routeMetaInfo?.hasRedirect && routeMetaInfo.redirectTo && !routeMetaInfo.redirectTo.startsWith("/")) diagnostics.push({
+		code: "relative-redirect",
+		severity: "warning",
+		message: "`routeMeta.redirectTo` should use an absolute path.",
+		details: "Nested redirects are documented to use absolute targets such as `/cities/new-york`."
+	});
+	if (routeJsonLdBindingName) diagnostics.push({
+		code: "legacy-route-jsonld-export",
+		severity: "warning",
+		message: "Prefer `routeMeta.jsonLd` over the legacy top-level `routeJsonLd` export.",
+		details: "Keeping JSON-LD inside `routeMeta` makes the route module easier to read and matches the current docs."
+	});
+	if (isLikelyLayoutRoute(filename, routeFiles) && !ROUTER_OUTLET_RE.test(code)) diagnostics.push({
+		code: "layout-without-router-outlet",
+		severity: "warning",
+		message: "This route file looks like a layout shell, but it does not reference `RouterOutlet` or `<router-outlet>`.",
+		details: "Parent layout pages usually import `RouterOutlet` and render an outlet so child routes have somewhere to mount."
+	});
+	return diagnostics;
+}
+function formatAnalogRouteIdiomDiagnostic(diagnostic, filename, workspaceRoot) {
+	const header = `[Analog] ${toDisplayPath(filename, workspaceRoot)} (${diagnostic.code})`;
+	const severity = diagnostic.severity.toUpperCase();
+	if (diagnostic.details) return `${header}\n${severity}: ${diagnostic.message}\n${diagnostic.details}`;
+	return `${header}\n${severity}: ${diagnostic.message}`;
+}
+function toDisplayPath(filename, workspaceRoot) {
+	const normalizedFilename = normalizePath(filename);
+	const relativePath = normalizePath(relative(normalizePath(workspaceRoot), normalizedFilename));
+	if (relativePath && !relativePath.startsWith("..")) return `/${relativePath}`;
+	return normalizedFilename;
+}
+function toParseDiagnostic(error) {
+	return {
+		code: "oxc-parse",
+		severity: error.severity === severityError ? "error" : "warning",
+		message: error.message,
+		details: error.codeframe ?? error.helpMessage ?? void 0
+	};
+}
+var severityError = "Error";
+function isLikelyLayoutRoute(filename, routeFiles) {
+	if (!PAGE_FILE_RE.test(filename)) return false;
+	const routeStem = filename.replace(PAGE_FILE_RE, "");
+	return routeFiles.some((routeFile) => routeFile !== filename && routeFile.startsWith(`${routeStem}/`));
+}
+function getRouteMetaInfo(program, bindingName) {
+	const routeMetaNode = unwrapRouteMetaObject(getExportedBindingInitializer(program, bindingName));
+	if (!routeMetaNode) return null;
+	let redirectTo;
+	for (const property of routeMetaNode.properties ?? []) {
+		if (property?.type !== "Property") continue;
+		if (getPropertyName(property.key) !== "redirectTo") continue;
+		redirectTo = getStringValue(property.value);
+	}
+	return {
+		hasRedirect: typeof redirectTo === "string" && redirectTo.length > 0,
+		redirectTo
+	};
+}
+function unwrapRouteMetaObject(initializer) {
+	if (!initializer) return null;
+	if (initializer.type === "ObjectExpression") return initializer;
+	if (initializer.type === "CallExpression" && initializer.callee?.type === "Identifier" && initializer.callee.name === "defineRouteMeta") {
+		const firstArgument = initializer.arguments?.[0];
+		return firstArgument?.type === "ObjectExpression" ? firstArgument : null;
+	}
+	return null;
+}
+function getExportedBindingInitializer(program, bindingName) {
+	for (const statement of program.body ?? []) {
+		if (statement?.type === "VariableDeclaration") {
+			const initializer = getVariableInitializer(statement, bindingName);
+			if (initializer) return initializer;
+			continue;
+		}
+		if (statement?.type === "ExportNamedDeclaration" && statement.declaration?.type === "VariableDeclaration") {
+			const initializer = getVariableInitializer(statement.declaration, bindingName);
+			if (initializer) return initializer;
+		}
+	}
+}
+function getVariableInitializer(declaration, bindingName) {
+	for (const declarator of declaration.declarations ?? []) if (declarator.id?.type === "Identifier" && declarator.id.name === bindingName) return declarator.init;
+}
+function collectExportedBindings(program) {
+	let hasDefaultExport = false;
+	let routeMeta;
+	let routeJsonLd;
+	for (const statement of program.body ?? []) {
+		if (statement?.type === "ExportDefaultDeclaration") {
+			hasDefaultExport = true;
+			continue;
+		}
+		if (statement?.type !== "ExportNamedDeclaration") continue;
+		const declaration = statement.declaration;
+		if (declaration?.type === "VariableDeclaration") for (const declarator of declaration.declarations ?? []) {
+			if (declarator.id?.type !== "Identifier") continue;
+			if (declarator.id.name === "routeMeta") routeMeta = "routeMeta";
+			if (declarator.id.name === "routeJsonLd") routeJsonLd = "routeJsonLd";
+		}
+		for (const specifier of statement.specifiers ?? []) {
+			if (specifier?.type !== "ExportSpecifier" || specifier.local?.type !== "Identifier") continue;
+			if (specifier.exported?.type !== "Identifier") continue;
+			if (specifier.exported.name === "routeMeta") routeMeta = specifier.local.name;
+			if (specifier.exported.name === "routeJsonLd") routeJsonLd = specifier.local.name;
+		}
+	}
+	return {
+		hasDefaultExport,
+		routeMeta,
+		routeJsonLd
+	};
+}
+function getPropertyName(node) {
+	if (node?.type === "Identifier") return node.name;
+	if ((node?.type === "Literal" || node?.type === "StringLiteral") && typeof node.value === "string") return node.value;
+}
+function getStringValue(node) {
+	if ((node?.type === "Literal" || node?.type === "StringLiteral") && typeof node.value === "string") return node.value;
+	if (node?.type === "TemplateLiteral" && node.expressions?.length === 0 && node.quasis?.length === 1) return node.quasis[0].value.cooked ?? node.quasis[0].value.raw;
+}
+//#endregion
+export { analyzeAnalogRouteFile, formatAnalogRouteIdiomDiagnostic };
+
+//# sourceMappingURL=route-idiom-diagnostics.js.map

package/src/lib/route-idiom-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-idiom-diagnostics.js","names":[],"sources":["../../../src/lib/route-idiom-diagnostics.ts"],"sourcesContent":["import { parseSync, type OxcError, type Severity } from 'oxc-parser';\nimport { relative } from 'node:path';\nimport { normalizePath } from 'vite';\n\nexport interface AnalogRouteIdiomDiagnostic {\n  code: string;\n  severity: 'error' | 'warning';\n  message: string;\n  details?: string;\n}\n\nexport interface AnalyzeAnalogRouteFileOptions {\n  filename: string;\n  code: string;\n  routeFiles?: string[];\n}\n\nconst PAGE_FILE_RE = /\\.page\\.ts$/;\nconst ROUTER_OUTLET_RE = /\\bRouterOutlet\\b|<router-outlet(?:\\s|>)/;\n\nexport function analyzeAnalogRouteFile(\n  options: AnalyzeAnalogRouteFileOptions,\n): AnalogRouteIdiomDiagnostic[] {\n  const { filename, code, routeFiles = [] } = options;\n  const parseResult = parseSync(filename, code, {\n    lang: 'ts',\n    sourceType: 'module',\n    range: true,\n    showSemanticErrors: true,\n  });\n\n  const parseDiagnostics = parseResult.errors.map((error) =>\n    toParseDiagnostic(error),\n  );\n\n  if (parseDiagnostics.some((diagnostic) => diagnostic.severity === 'error')) {\n    return parseDiagnostics;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const program: any = parseResult.program;\n  const exportedBindings = collectExportedBindings(program);\n  const routeMetaBindingName = exportedBindings.routeMeta;\n  const routeJsonLdBindingName = exportedBindings.routeJsonLd;\n  const diagnostics = [...parseDiagnostics];\n\n  const routeMetaInfo = routeMetaBindingName\n    ? getRouteMetaInfo(program, routeMetaBindingName)\n    : null;\n\n  if (!exportedBindings.hasDefaultExport && !routeMetaInfo?.hasRedirect) {\n    diagnostics.push({\n      code: 'missing-default-export',\n      severity: 'warning',\n      message:\n        'Route files should default-export the page component, unless they are redirect-only routes.',\n      details:\n        'Add `export default class ...` or define `routeMeta.redirectTo` for a redirect route.',\n    });\n  }\n\n  if (exportedBindings.hasDefaultExport && routeMetaInfo?.hasRedirect) {\n    diagnostics.push({\n      code: 'redirect-with-component',\n      severity: 'warning',\n      message: 'Redirect routes should not also export a page component.',\n      details:\n        'Analog ignores the default export when `routeMeta.redirectTo` is present. Remove the component export or remove the redirect.',\n    });\n  }\n\n  if (\n    routeMetaInfo?.hasRedirect &&\n    routeMetaInfo.redirectTo &&\n    !routeMetaInfo.redirectTo.startsWith('/')\n  ) {\n    diagnostics.push({\n      code: 'relative-redirect',\n      severity: 'warning',\n      message: '`routeMeta.redirectTo` should use an absolute path.',\n      details:\n        'Nested redirects are documented to use absolute targets such as `/cities/new-york`.',\n    });\n  }\n\n  if (routeJsonLdBindingName) {\n    diagnostics.push({\n      code: 'legacy-route-jsonld-export',\n      severity: 'warning',\n      message:\n        'Prefer `routeMeta.jsonLd` over the legacy top-level `routeJsonLd` export.',\n      details:\n        'Keeping JSON-LD inside `routeMeta` makes the route module easier to read and matches the current docs.',\n    });\n  }\n\n  if (\n    isLikelyLayoutRoute(filename, routeFiles) &&\n    !ROUTER_OUTLET_RE.test(code)\n  ) {\n    diagnostics.push({\n      code: 'layout-without-router-outlet',\n      severity: 'warning',\n      message:\n        'This route file looks like a layout shell, but it does not reference `RouterOutlet` or `<router-outlet>`.',\n      details:\n        'Parent layout pages usually import `RouterOutlet` and render an outlet so child routes have somewhere to mount.',\n    });\n  }\n\n  return diagnostics;\n}\n\nexport function formatAnalogRouteIdiomDiagnostic(\n  diagnostic: AnalogRouteIdiomDiagnostic,\n  filename: string,\n  workspaceRoot: string,\n): string {\n  const displayName = toDisplayPath(filename, workspaceRoot);\n  const header = `[Analog] ${displayName} (${diagnostic.code})`;\n  const severity = diagnostic.severity.toUpperCase();\n\n  if (diagnostic.details) {\n    return `${header}\\n${severity}: ${diagnostic.message}\\n${diagnostic.details}`;\n  }\n\n  return `${header}\\n${severity}: ${diagnostic.message}`;\n}\n\nfunction toDisplayPath(filename: string, workspaceRoot: string): string {\n  const normalizedFilename = normalizePath(filename);\n  const normalizedRoot = normalizePath(workspaceRoot);\n  const relativePath = normalizePath(\n    relative(normalizedRoot, normalizedFilename),\n  );\n\n  if (relativePath && !relativePath.startsWith('..')) {\n    return `/${relativePath}`;\n  }\n\n  return normalizedFilename;\n}\n\nfunction toParseDiagnostic(error: OxcError): AnalogRouteIdiomDiagnostic {\n  return {\n    code: 'oxc-parse',\n    severity: error.severity === severityError ? 'error' : 'warning',\n    message: error.message,\n    details: error.codeframe ?? error.helpMessage ?? undefined,\n  };\n}\n\nconst severityError: Severity = 'Error';\n\nfunction isLikelyLayoutRoute(filename: string, routeFiles: string[]): boolean {\n  if (!PAGE_FILE_RE.test(filename)) {\n    return false;\n  }\n\n  const routeStem = filename.replace(PAGE_FILE_RE, '');\n  return routeFiles.some(\n    (routeFile) =>\n      routeFile !== filename && routeFile.startsWith(`${routeStem}/`),\n  );\n}\n\nfunction getRouteMetaInfo(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  program: any,\n  bindingName: string,\n): {\n  hasRedirect: boolean;\n  redirectTo?: string;\n} | null {\n  const initializer = getExportedBindingInitializer(program, bindingName);\n  const routeMetaNode = unwrapRouteMetaObject(initializer);\n\n  if (!routeMetaNode) {\n    return null;\n  }\n\n  let redirectTo: string | undefined;\n\n  for (const property of routeMetaNode.properties ?? []) {\n    if (property?.type !== 'Property') {\n      continue;\n    }\n\n    const keyName = getPropertyName(property.key);\n    if (keyName !== 'redirectTo') {\n      continue;\n    }\n\n    redirectTo = getStringValue(property.value);\n  }\n\n  return {\n    hasRedirect: typeof redirectTo === 'string' && redirectTo.length > 0,\n    redirectTo,\n  };\n}\n\nfunction unwrapRouteMetaObject(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  initializer: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any | null {\n  if (!initializer) {\n    return null;\n  }\n\n  if (initializer.type === 'ObjectExpression') {\n    return initializer;\n  }\n\n  if (\n    initializer.type === 'CallExpression' &&\n    initializer.callee?.type === 'Identifier' &&\n    initializer.callee.name === 'defineRouteMeta'\n  ) {\n    const firstArgument = initializer.arguments?.[0];\n    return firstArgument?.type === 'ObjectExpression' ? firstArgument : null;\n  }\n\n  return null;\n}\n\nfunction getExportedBindingInitializer(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  program: any,\n  bindingName: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any | undefined {\n  for (const statement of program.body ?? []) {\n    if (statement?.type === 'VariableDeclaration') {\n      const initializer = getVariableInitializer(statement, bindingName);\n      if (initializer) {\n        return initializer;\n      }\n      continue;\n    }\n\n    if (\n      statement?.type === 'ExportNamedDeclaration' &&\n      statement.declaration?.type === 'VariableDeclaration'\n    ) {\n      const initializer = getVariableInitializer(\n        statement.declaration,\n        bindingName,\n      );\n      if (initializer) {\n        return initializer;\n      }\n    }\n  }\n\n  return undefined;\n}\n\nfunction getVariableInitializer(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  declaration: any,\n  bindingName: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any | undefined {\n  for (const declarator of declaration.declarations ?? []) {\n    if (\n      declarator.id?.type === 'Identifier' &&\n      declarator.id.name === bindingName\n    ) {\n      return declarator.init;\n    }\n  }\n\n  return undefined;\n}\n\nfunction collectExportedBindings(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  program: any,\n): {\n  hasDefaultExport: boolean;\n  routeMeta?: string;\n  routeJsonLd?: string;\n} {\n  let hasDefaultExport = false;\n  let routeMeta: string | undefined;\n  let routeJsonLd: string | undefined;\n\n  for (const statement of program.body ?? []) {\n    if (statement?.type === 'ExportDefaultDeclaration') {\n      hasDefaultExport = true;\n      continue;\n    }\n\n    if (statement?.type !== 'ExportNamedDeclaration') {\n      continue;\n    }\n\n    const declaration = statement.declaration;\n    if (declaration?.type === 'VariableDeclaration') {\n      for (const declarator of declaration.declarations ?? []) {\n        if (declarator.id?.type !== 'Identifier') {\n          continue;\n        }\n\n        if (declarator.id.name === 'routeMeta') {\n          routeMeta = 'routeMeta';\n        }\n\n        if (declarator.id.name === 'routeJsonLd') {\n          routeJsonLd = 'routeJsonLd';\n        }\n      }\n    }\n\n    for (const specifier of statement.specifiers ?? []) {\n      if (\n        specifier?.type !== 'ExportSpecifier' ||\n        specifier.local?.type !== 'Identifier'\n      ) {\n        continue;\n      }\n\n      if (specifier.exported?.type !== 'Identifier') {\n        continue;\n      }\n\n      if (specifier.exported.name === 'routeMeta') {\n        routeMeta = specifier.local.name;\n      }\n\n      if (specifier.exported.name === 'routeJsonLd') {\n        routeJsonLd = specifier.local.name;\n      }\n    }\n  }\n\n  return {\n    hasDefaultExport,\n    routeMeta,\n    routeJsonLd,\n  };\n}\n\nfunction getPropertyName(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  node: any,\n): string | undefined {\n  if (node?.type === 'Identifier') {\n    return node.name;\n  }\n\n  if (\n    (node?.type === 'Literal' || node?.type === 'StringLiteral') &&\n    typeof node.value === 'string'\n  ) {\n    return node.value;\n  }\n\n  return undefined;\n}\n\nfunction getStringValue(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  node: any,\n): string | undefined {\n  if (\n    (node?.type === 'Literal' || node?.type === 'StringLiteral') &&\n    typeof node.value === 'string'\n  ) {\n    return node.value;\n  }\n\n  if (\n    node?.type === 'TemplateLiteral' &&\n    node.expressions?.length === 0 &&\n    node.quasis?.length === 1\n  ) {\n    return node.quasis[0].value.cooked ?? node.quasis[0].value.raw;\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}

package/src/lib/route-manifest.d.ts

@@ -0,0 +1,122 @@
+export interface RouteParamInfo {
+	name: string;
+	type: "dynamic" | "catchAll" | "optionalCatchAll";
+}
+export interface RouteSchemaInfo {
+	hasParamsSchema: boolean;
+	hasQuerySchema: boolean;
+}
+export interface GenerateRouteTreeDeclarationOptions {
+	jsonLdFiles?: Iterable<string>;
+}
+export interface RouteEntry {
+	/** Stable structural route id derived from the source filename */
+	id: string;
+	/** The route path segment relative to the nearest existing parent route */
+	path: string;
+	/** The fully resolved navigation path pattern (e.g., '/users/[id]') */
+	fullPath: string;
+	/** Extracted parameter information */
+	params: RouteParamInfo[];
+	/** Original filename that produced this route */
+	filename: string;
+	/** Schema export info (detected from file content) */
+	schemas: RouteSchemaInfo;
+	/** Type of source that produced this route */
+	kind: "page" | "content";
+	/** Parent route id, or null for top-level routes */
+	parentId: string | null;
+	/** Child route ids */
+	children: string[];
+	/** Whether the source filename represents an index route */
+	isIndex: boolean;
+	/** Whether the source filename includes route-group/pathless segments */
+	isGroup: boolean;
+	/** Whether the route contains a required catch-all parameter */
+	isCatchAll: boolean;
+	/** Whether the route contains an optional catch-all parameter */
+	isOptionalCatchAll: boolean;
+}
+export interface RouteCollision {
+	fullPath: string;
+	keptFile: string;
+	droppedFile: string;
+	/** True when both files have the same collision priority (hard error). */
+	samePriority: boolean;
+}
+export interface RouteManifest {
+	routes: RouteEntry[];
+	collisions: RouteCollision[];
+	/** Canonical route per fullPath — precomputed once to avoid redundant work. */
+	canonicalByFullPath: Map<string, RouteEntry>;
+}
+/**
+* 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'
+*/
+export declare function filenameToRoutePath(filename: string): string;
+/**
+* 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.
+*/
+export declare function filenameToRouteId(filename: string): string;
+/**
+* Extracts parameter information from a route path pattern.
+*/
+export declare function extractRouteParams(routePath: string): RouteParamInfo[];
+/**
+* Detects whether a route file exports schema constants.
+*/
+export declare function detectSchemaExports(fileContent: string): RouteSchemaInfo;
+/**
+* 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.
+*/
+export declare function generateRouteManifest(filenames: string[], schemaDetector?: (filename: string) => RouteSchemaInfo, collisionPriority?: (filename: string) => number): RouteManifest;
+/**
+* Produces a human-readable summary of the generated route manifest.
+*/
+export declare function formatManifestSummary(manifest: RouteManifest): string;
+/**
+* Generates the route-table section for the combined generated route module.
+*/
+export declare function generateRouteTableDeclaration(manifest: RouteManifest): string;
+/**
+* Generates the route-tree section for the combined generated route module.
+*/
+export declare function generateRouteTreeDeclaration(manifest: RouteManifest, options?: GenerateRouteTreeDeclarationOptions): string;
+export type JsonLdObject = Record<string, unknown>;
+export declare function isJsonLdObject(value: unknown): value is JsonLdObject;
+export declare function normalizeJsonLd(value: unknown): JsonLdObject[];