@analogjs/platform 3.0.0-alpha.2 → 3.0.0-alpha.20

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":["../../../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 === 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) 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":["../../../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 === 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    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,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,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,118 @@
+/**
+* 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.
+*
+* 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[];