@analogjs/platform 3.0.0-alpha.13 → 3.0.0-alpha.14

package/src/lib/options.d.ts

@@ -1,7 +1,7 @@
 import type { PluginOptions } from "@analogjs/vite-plugin-angular";
 import type { NitroConfig, PrerenderRoute } from "nitro/types";
-import type { SitemapConfig, PrerenderContentDir, PrerenderContentFile, PrerenderRouteConfig } from "@analogjs/vite-plugin-nitro";
-import { ContentPluginOptions } from "./content-plugin.js";
+import type { SitemapConfig, SitemapEntry, SitemapExcludeRule, SitemapPriority, SitemapRouteDefinition, SitemapRouteInput, SitemapRouteSource, SitemapTransform, PrerenderContentDir, PrerenderContentFile, PrerenderSitemapConfig, PrerenderRouteConfig } from "@analogjs/vite-plugin-nitro";
+import type { ContentPluginOptions } from "./content-plugin.js";
 declare module "nitro/types" {
 	interface NitroRouteConfig {
 		ssr?: boolean;
@@ -34,11 +34,20 @@ export interface Options {
 	entryServer?: string;
 	/**
 	* Pass configuration options to the internal `@analogjs/vite-plugin-angular`
-	* plugin. Set to false to disable the internal vite plugin.
+	* plugin. Set to `false` to disable the internal vite plugin (e.g. when
+	* using an alternative compiler like `@oxc-angular/vite`).
 	*
 	* `vite.build` uses Vite's native config shape and is forwarded to the
 	* internal Nitro/Vite build pipeline, while the remaining fields are passed
 	* to `@analogjs/vite-plugin-angular`.
+	*
+	* When `false`, the following top-level options are ignored because they
+	* are only forwarded to the internal Angular plugin: `jit`,
+	* `disableTypeChecking`, `liveReload`, `inlineStylesExtension`,
+	* `fileReplacements`, and `include`.
+	*
+	* Use this to configure the embedded Angular integration itself, not as the
+	* primary home for Analog-owned experimental features.
 	*/
 	vite?: PluginOptions | false;
 	nitro?: NitroConfig;
@@ -85,5 +94,70 @@ export interface Options {
 	* File replacements
 	*/
 	fileReplacements?: PluginOptions["fileReplacements"];
+	/**
+	* Experimental features. These APIs are subject to change.
+	*
+	* `@analogjs/platform` is the default rollout and orchestration surface for
+	* Analog-owned experiments. These flags may delegate to dedicated feature
+	* plugins or forward options into lower-level integrations while preserving
+	* a single Analog-first authoring surface.
+	*/
+	experimental?: {
+		/**
+		* Use Angular's experimental compilation API.
+		*
+		* This is forwarded to `@analogjs/vite-plugin-angular`'s
+		* `experimental.useAngularCompilationAPI`.
+		*
+		* Also accepted at `vite.experimental.useAngularCompilationAPI`
+		* for backwards compatibility.
+		*
+		* Has no effect when `vite` is set to `false`.
+		*/
+		useAngularCompilationAPI?: boolean;
+		/**
+		* Enable typed route table generation for type-safe navigation.
+		*
+		* When enabled, `@analogjs/platform` generates a single route module
+		* that augments `AnalogRouteTable` with typed params and query for each
+		* file-based route. JSON-LD manifest generation is configured on the same
+		* object so both codegen features share one generated file.
+		*
+		* - `true` — generates `src/routeTree.gen.ts` with `routeJsonLdManifest`
+		* - `TypedRouterOptions` — customize output path or disable just the
+		*   JSON-LD manifest piece
+		*
+		* Unlocks type-safe usage of:
+		* - `routePath()` — build route link objects for `[routerLink]`
+		* - `injectNavigate()` — typed navigation
+		* - `injectParams(from)` — typed params signal
+		* - `injectQuery(from)` — typed query signal
+		*
+		* Inspired by TanStack Router's `routeTree.gen.ts` codegen.
+		*/
+		typedRouter?: boolean | TypedRouterOptions;
+	};
+}
+export interface TypedRouterOptions {
+	/**
+	* Output path for the single generated route module,
+	* relative to the app root.
+	*
+	* @default 'src/routeTree.gen.ts'
+	*/
+	outFile?: string;
+	/**
+	* Include generated `routeJsonLdManifest` data in the generated route file.
+	*
+	* @default true
+	*/
+	jsonLdManifest?: boolean;
+	/**
+	* Fail production builds after regenerating a stale checked-in route file.
+	* Development and watch mode continue to update the file automatically.
+	*
+	* @default true
+	*/
+	verifyOnBuild?: boolean;
 }
-export { PrerenderContentDir, PrerenderContentFile };
+export type { PrerenderContentDir, PrerenderContentFile, PrerenderSitemapConfig, SitemapConfig, SitemapEntry, SitemapExcludeRule, SitemapPriority, SitemapRouteDefinition, SitemapRouteInput, SitemapRouteSource, SitemapTransform };

package/src/lib/platform-plugin.js

@@ -5,6 +5,7 @@ import { clearClientPageEndpointsPlugin } from "./clear-client-page-endpoint.js"
 import { depsPlugin } from "./deps-plugin.js";
 import { injectHTMLPlugin } from "./ssr/inject-html-plugin.js";
 import { serverModePlugin } from "../server-mode-plugin.js";
+import { routeGenerationPlugin } from "./route-generation-plugin.js";
 import viteNitroPlugin from "@analogjs/vite-plugin-nitro";
 import angular from "@analogjs/vite-plugin-angular";
 //#region packages/platform/src/lib/platform-plugin.ts
@@ -13,10 +14,12 @@ function externalPlugins(plugins) {
 }
 function platformPlugin(opts = {}) {
 	const isTest = process.env.NODE_ENV === "test" || !!process.env["VITEST"];
+	const viteOptions = opts?.vite === false ? void 0 : opts?.vite;
 	const { ...platformOptions } = {
 		ssr: true,
 		...opts
 	};
+	const useAngularCompilationAPI = platformOptions.experimental?.useAngularCompilationAPI ?? viteOptions?.experimental?.useAngularCompilationAPI;
 	let nitroOptions = platformOptions?.nitro;
 	if (nitroOptions?.routeRules) nitroOptions = {
 		...nitroOptions,
@@ -38,17 +41,22 @@ function platformPlugin(opts = {}) {
 		...platformOptions.ssr ? [...ssrBuildPlugin(), ...injectHTMLPlugin()] : [],
 		...!isTest ? depsPlugin(platformOptions) : [],
 		...routerPlugin(platformOptions),
+		routeGenerationPlugin(platformOptions),
 		...contentPlugin(platformOptions?.content, platformOptions),
 		...opts?.vite === false ? [] : externalPlugins(angular({
 			jit: platformOptions.jit,
 			workspaceRoot: platformOptions.workspaceRoot,
-			disableTypeChecking: platformOptions.disableTypeChecking ?? false,
+			disableTypeChecking: platformOptions.disableTypeChecking,
 			include: [...platformOptions.include ?? [], ...(platformOptions.additionalPagesDirs ?? []).map((pageDir) => `${pageDir}/**/*.page.ts`)],
 			additionalContentDirs: platformOptions.additionalContentDirs,
 			liveReload: platformOptions.liveReload,
 			inlineStylesExtension: platformOptions.inlineStylesExtension,
 			fileReplacements: platformOptions.fileReplacements,
-			...opts?.vite ?? {}
+			...viteOptions ?? {},
+			experimental: {
+				...viteOptions?.experimental ?? {},
+				useAngularCompilationAPI
+			}
 		})),
 		...serverModePlugin(),
 		...clearClientPageEndpointsPlugin()

package/src/lib/platform-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-plugin.js","names":[],"sources":["../../../../../packages/platform/src/lib/platform-plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\nimport viteNitroPlugin from '@analogjs/vite-plugin-nitro';\nimport angular from '@analogjs/vite-plugin-angular';\n\nimport { Options } from './options.js';\nimport { routerPlugin } from './router-plugin.js';\nimport { ssrBuildPlugin } from './ssr/ssr-build-plugin.js';\nimport { contentPlugin } from './content-plugin.js';\nimport { clearClientPageEndpointsPlugin } from './clear-client-page-endpoint.js';\nimport { depsPlugin } from './deps-plugin.js';\nimport { injectHTMLPlugin } from './ssr/inject-html-plugin.js';\nimport { serverModePlugin } from '../server-mode-plugin.js';\n\n// Bridge Plugin types from external @analogjs packages that resolve a different vite instance\nfunction externalPlugins(plugins: unknown): Plugin[] {\n  return plugins as Plugin[];\n}\n\nexport function platformPlugin(opts: Options = {}): Plugin[] {\n  const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];\n  const { ...platformOptions } = {\n    ssr: true,\n    ...opts,\n  };\n  let nitroOptions = platformOptions?.nitro;\n\n  if (nitroOptions?.routeRules) {\n    nitroOptions = {\n      ...nitroOptions,\n      routeRules: Object.keys(nitroOptions.routeRules).reduce(\n        (config, curr) => {\n          return {\n            ...config,\n            [curr]: {\n              ...config[curr],\n              headers: {\n                ...config[curr].headers,\n                'x-analog-no-ssr':\n                  config[curr]?.ssr === false ? 'true' : undefined,\n              } as any,\n            },\n          };\n        },\n        nitroOptions.routeRules,\n      ),\n    };\n  }\n\n  return [\n    ...externalPlugins(viteNitroPlugin(platformOptions as any, nitroOptions)),\n    ...(platformOptions.ssr\n      ? [...ssrBuildPlugin(), ...injectHTMLPlugin()]\n      : []),\n    ...(!isTest ? depsPlugin(platformOptions) : []),\n    ...routerPlugin(platformOptions),\n    ...contentPlugin(platformOptions?.content, platformOptions),\n    ...(opts?.vite === false\n      ? []\n      : externalPlugins(\n          angular({\n            jit: platformOptions.jit,\n            workspaceRoot: platformOptions.workspaceRoot,\n            disableTypeChecking: platformOptions.disableTypeChecking ?? false,\n            include: [\n              ...(platformOptions.include ?? []),\n              ...(platformOptions.additionalPagesDirs ?? []).map(\n                (pageDir) => `${pageDir}/**/*.page.ts`,\n              ),\n            ],\n            additionalContentDirs: platformOptions.additionalContentDirs,\n            liveReload: platformOptions.liveReload,\n            inlineStylesExtension: platformOptions.inlineStylesExtension,\n            fileReplacements: platformOptions.fileReplacements,\n            ...(opts?.vite ?? {}),\n          }),\n        )),\n    ...serverModePlugin(),\n    ...clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAS,gBAAgB,SAA4B;AACnD,QAAO;;AAGT,SAAgB,eAAe,OAAgB,EAAE,EAAY;CAC3D,MAAM,SAAA,QAAA,IAAA,aAAqC,UAAU,CAAC,CAAC,QAAQ,IAAI;CACnE,MAAM,EAAE,GAAG,oBAAoB;EAC7B,KAAK;EACL,GAAG;EACJ;CACD,IAAI,eAAe,iBAAiB;AAEpC,KAAI,cAAc,WAChB,gBAAe;EACb,GAAG;EACH,YAAY,OAAO,KAAK,aAAa,WAAW,CAAC,QAC9C,QAAQ,SAAS;AAChB,UAAO;IACL,GAAG;KACF,OAAO;KACN,GAAG,OAAO;KACV,SAAS;MACP,GAAG,OAAO,MAAM;MAChB,mBACE,OAAO,OAAO,QAAQ,QAAQ,SAAS,KAAA;MAC1C;KACF;IACF;KAEH,aAAa,WACd;EACF;AAGH,QAAO;EACL,GAAG,gBAAgB,gBAAgB,iBAAwB,aAAa,CAAC;EACzE,GAAI,gBAAgB,MAChB,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,GAC5C,EAAE;EACN,GAAI,CAAC,SAAS,WAAW,gBAAgB,GAAG,EAAE;EAC9C,GAAG,aAAa,gBAAgB;EAChC,GAAG,cAAc,iBAAiB,SAAS,gBAAgB;EAC3D,GAAI,MAAM,SAAS,QACf,EAAE,GACF,gBACE,QAAQ;GACN,KAAK,gBAAgB;GACrB,eAAe,gBAAgB;GAC/B,qBAAqB,gBAAgB,uBAAuB;GAC5D,SAAS,CACP,GAAI,gBAAgB,WAAW,EAAE,EACjC,IAAI,gBAAgB,uBAAuB,EAAE,EAAE,KAC5C,YAAY,GAAG,QAAQ,eACzB,CACF;GACD,uBAAuB,gBAAgB;GACvC,YAAY,gBAAgB;GAC5B,uBAAuB,gBAAgB;GACvC,kBAAkB,gBAAgB;GAClC,GAAI,MAAM,QAAQ,EAAE;GACrB,CAAC,CACH;EACL,GAAG,kBAAkB;EACrB,GAAG,gCAAgC;EACpC"}
+{"version":3,"file":"platform-plugin.js","names":[],"sources":["../../../../../packages/platform/src/lib/platform-plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\nimport viteNitroPlugin from '@analogjs/vite-plugin-nitro';\nimport angular from '@analogjs/vite-plugin-angular';\n\nimport { Options } from './options.js';\nimport { routerPlugin } from './router-plugin.js';\nimport { ssrBuildPlugin } from './ssr/ssr-build-plugin.js';\nimport { contentPlugin } from './content-plugin.js';\nimport { clearClientPageEndpointsPlugin } from './clear-client-page-endpoint.js';\nimport { depsPlugin } from './deps-plugin.js';\nimport { injectHTMLPlugin } from './ssr/inject-html-plugin.js';\nimport { serverModePlugin } from '../server-mode-plugin.js';\nimport { routeGenerationPlugin } from './route-generation-plugin.js';\n\n// Bridge Plugin types from external @analogjs packages that resolve a different vite instance\nfunction externalPlugins(plugins: unknown): Plugin[] {\n  return plugins as Plugin[];\n}\n\nexport function platformPlugin(opts: Options = {}): Plugin[] {\n  const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];\n  const viteOptions = opts?.vite === false ? undefined : opts?.vite;\n  const { ...platformOptions } = {\n    ssr: true,\n    ...opts,\n  };\n  const useAngularCompilationAPI =\n    platformOptions.experimental?.useAngularCompilationAPI ??\n    viteOptions?.experimental?.useAngularCompilationAPI;\n  let nitroOptions = platformOptions?.nitro;\n\n  if (nitroOptions?.routeRules) {\n    nitroOptions = {\n      ...nitroOptions,\n      routeRules: Object.keys(nitroOptions.routeRules).reduce(\n        (config, curr) => {\n          return {\n            ...config,\n            [curr]: {\n              ...config[curr],\n              headers: {\n                ...config[curr].headers,\n                'x-analog-no-ssr':\n                  config[curr]?.ssr === false ? 'true' : undefined,\n              } as any,\n            },\n          };\n        },\n        nitroOptions.routeRules,\n      ),\n    };\n  }\n\n  return [\n    ...externalPlugins(viteNitroPlugin(platformOptions as any, nitroOptions)),\n    ...(platformOptions.ssr\n      ? [...ssrBuildPlugin(), ...injectHTMLPlugin()]\n      : []),\n    ...(!isTest ? depsPlugin(platformOptions) : []),\n    ...routerPlugin(platformOptions),\n    routeGenerationPlugin(platformOptions),\n    ...contentPlugin(platformOptions?.content, platformOptions),\n    ...(opts?.vite === false\n      ? []\n      : externalPlugins(\n          angular({\n            jit: platformOptions.jit,\n            workspaceRoot: platformOptions.workspaceRoot,\n            // Let the Angular plugin keep its own dev-friendly default unless the\n            // app explicitly opts into stricter serve-time diagnostics.\n            disableTypeChecking: platformOptions.disableTypeChecking,\n            include: [\n              ...(platformOptions.include ?? []),\n              ...(platformOptions.additionalPagesDirs ?? []).map(\n                (pageDir) => `${pageDir}/**/*.page.ts`,\n              ),\n            ],\n            additionalContentDirs: platformOptions.additionalContentDirs,\n            liveReload: platformOptions.liveReload,\n            inlineStylesExtension: platformOptions.inlineStylesExtension,\n            fileReplacements: platformOptions.fileReplacements,\n            ...(viteOptions ?? {}),\n            experimental: {\n              ...(viteOptions?.experimental ?? {}),\n              useAngularCompilationAPI,\n            },\n          }),\n        )),\n    ...serverModePlugin(),\n    ...clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAS,gBAAgB,SAA4B;AACnD,QAAO;;AAGT,SAAgB,eAAe,OAAgB,EAAE,EAAY;CAC3D,MAAM,SAAA,QAAA,IAAA,aAAqC,UAAU,CAAC,CAAC,QAAQ,IAAI;CACnE,MAAM,cAAc,MAAM,SAAS,QAAQ,KAAA,IAAY,MAAM;CAC7D,MAAM,EAAE,GAAG,oBAAoB;EAC7B,KAAK;EACL,GAAG;EACJ;CACD,MAAM,2BACJ,gBAAgB,cAAc,4BAC9B,aAAa,cAAc;CAC7B,IAAI,eAAe,iBAAiB;AAEpC,KAAI,cAAc,WAChB,gBAAe;EACb,GAAG;EACH,YAAY,OAAO,KAAK,aAAa,WAAW,CAAC,QAC9C,QAAQ,SAAS;AAChB,UAAO;IACL,GAAG;KACF,OAAO;KACN,GAAG,OAAO;KACV,SAAS;MACP,GAAG,OAAO,MAAM;MAChB,mBACE,OAAO,OAAO,QAAQ,QAAQ,SAAS,KAAA;MAC1C;KACF;IACF;KAEH,aAAa,WACd;EACF;AAGH,QAAO;EACL,GAAG,gBAAgB,gBAAgB,iBAAwB,aAAa,CAAC;EACzE,GAAI,gBAAgB,MAChB,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,GAC5C,EAAE;EACN,GAAI,CAAC,SAAS,WAAW,gBAAgB,GAAG,EAAE;EAC9C,GAAG,aAAa,gBAAgB;EAChC,sBAAsB,gBAAgB;EACtC,GAAG,cAAc,iBAAiB,SAAS,gBAAgB;EAC3D,GAAI,MAAM,SAAS,QACf,EAAE,GACF,gBACE,QAAQ;GACN,KAAK,gBAAgB;GACrB,eAAe,gBAAgB;GAG/B,qBAAqB,gBAAgB;GACrC,SAAS,CACP,GAAI,gBAAgB,WAAW,EAAE,EACjC,IAAI,gBAAgB,uBAAuB,EAAE,EAAE,KAC5C,YAAY,GAAG,QAAQ,eACzB,CACF;GACD,uBAAuB,gBAAgB;GACvC,YAAY,gBAAgB;GAC5B,uBAAuB,gBAAgB;GACvC,kBAAkB,gBAAgB;GAClC,GAAI,eAAe,EAAE;GACrB,cAAc;IACZ,GAAI,aAAa,gBAAgB,EAAE;IACnC;IACD;GACF,CAAC,CACH;EACL,GAAG,kBAAkB;EACrB,GAAG,gCAAgC;EACpC"}

package/src/lib/route-file-discovery.d.ts

@@ -0,0 +1,23 @@
+export interface RouteFileDiscoveryOptions {
+	root: string;
+	workspaceRoot: string;
+	additionalPagesDirs: string[];
+	additionalContentDirs: string[];
+}
+export interface RouteFileDiscovery {
+	getRouteFiles(): string[];
+	getContentFiles(): string[];
+	getDiscoveredFileKind(path: string): "route" | "content" | null;
+	updateDiscoveredFile(path: string, event: "add" | "change" | "unlink"): void;
+	/**
+	* Returns true if the normalized filename was discovered from an app-local
+	* glob (under the configured root) rather than from an additional directory.
+	*
+	* Used by collision priority to prefer app-local routes over shared/external
+	* routes based on actual configured roots instead of hard-coded path
+	* substrings.
+	*/
+	isAppLocal(normalizedFilename: string): boolean;
+	reset(): void;
+}
+export declare function createRouteFileDiscovery(options: RouteFileDiscoveryOptions): RouteFileDiscovery;

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

@@ -0,0 +1,114 @@
+import { normalizePath } from "vite";
+import { globSync } from "tinyglobby";
+import { resolve } from "node:path";
+//#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":["../../../../../packages/platform/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,34 @@
+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) return {
+		enabled: false,
+		options: {}
+	};
+	if (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) return { name: "analog-route-generation-disabled" };
+	return typedRoutes({
+		...typedRouterOptions,
+		workspaceRoot: options?.workspaceRoot,
+		additionalPagesDirs: options?.additionalPagesDirs,
+		additionalContentDirs: options?.additionalContentDirs
+	});
+}
+//#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":["../../../../../packages/platform/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';\n\nfunction resolveTypedRouterOptions(experimental: Options['experimental']): {\n  enabled: boolean;\n  options: TypedRouterOptions;\n} {\n  const typedRouter = experimental?.typedRouter;\n  if (!typedRouter) {\n    return { enabled: false, options: {} };\n  }\n  if (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    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\n  return typedRoutes(pluginOptions);\n}\n"],"mappings":";;AAQA,SAAS,0BAA0B,cAGjC;CACA,MAAM,cAAc,cAAc;AAClC,KAAI,CAAC,YACH,QAAO;EAAE,SAAS;EAAO,SAAS,EAAE;EAAE;AAExC,KAAI,gBAAgB,KAClB,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,QACH,QAAO,EACL,MAAM,oCACP;AAUH,QAAO,YAPyC;EAC9C,GAAG;EACH,eAAe,SAAS;EACxB,qBAAqB,SAAS;EAC9B,uBAAuB,SAAS;EACjC,CAEgC"}

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

@@ -0,0 +1,104 @@
+/**
+* Route-manifest engine for typed file routes.
+*
+* Pure functions (no Angular dependencies) for converting discovered
+* filenames into typed route manifests and generated declarations.
+*/
+export interface RouteParamInfo {
+	name: string;
+	type: "dynamic" | "catchAll" | "optionalCatchAll";
+}
+export interface RouteSchemaInfo {
+	hasParamsSchema: boolean;
+	hasQuerySchema: boolean;
+}
+export interface GenerateRouteTreeDeclarationOptions {
+	jsonLdPaths?: 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 RouteManifest {
+	routes: 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.
+*
+* 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]]'
+*/
+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.
+*/
+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[];