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

package/src/lib/options.d.ts

@@ -1,85 +1,180 @@
-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';
-declare module 'nitro/types' {
-    interface NitroRouteConfig {
-        ssr?: boolean;
-    }
-    interface NitroRouteRules {
-        ssr?: boolean;
-    }
+import type { PrerenderRoute } from "nitro/types";
+import type { SitemapConfig, SitemapEntry, SitemapExcludeRule, SitemapPriority, SitemapRouteDefinition, SitemapRouteInput, SitemapRouteSource, SitemapTransform, PrerenderContentDir, PrerenderContentFile, PrerenderSitemapConfig, PrerenderRouteConfig } from "./nitro/types.js";
+import type { ContentPluginOptions } from "./content-plugin.js";
+import type { DebugOption } from "./utils/debug.js";
+import type { StylePipelineOptions } from "./style-pipeline.js";
+declare module "nitro/types" {
+	interface NitroRouteConfig {
+		ssr?: boolean;
+		/**
+		* Disable progressive streaming SSR for matching routes (falls back to a
+		* buffered render). Only meaningful when `experimental.streaming` is on.
+		*/
+		streaming?: boolean;
+	}
+	interface NitroRouteRules {
+		ssr?: boolean;
+		streaming?: boolean;
+	}
 }
 export interface PrerenderOptions {
-    /**
-     * Add additional routes to prerender through crawling page links.
-     */
-    discover?: boolean;
-    /**
-     * List of routes to prerender resolved statically or dynamically.
-     */
-    routes?: (string | PrerenderContentDir | PrerenderRouteConfig)[] | (() => Promise<(string | PrerenderContentDir | PrerenderRouteConfig | undefined)[]>);
-    sitemap?: SitemapConfig;
-    /** List of functions that run for each route after pre-rendering is complete. */
-    postRenderingHooks?: ((routes: PrerenderRoute) => Promise<void>)[];
+	/**
+	* Add additional routes to prerender through crawling page links.
+	*/
+	discover?: boolean;
+	/**
+	* List of routes to prerender resolved statically or dynamically.
+	*/
+	routes?: (string | PrerenderContentDir | PrerenderRouteConfig)[] | (() => Promise<(string | PrerenderContentDir | PrerenderRouteConfig | undefined)[]>);
+	sitemap?: SitemapConfig;
+	/** List of functions that run for each route after pre-rendering is complete. */
+	postRenderingHooks?: ((routes: PrerenderRoute) => Promise<void>)[];
+}
+export interface I18nOptions {
+	/**
+	* The default/source locale for the application.
+	*/
+	defaultLocale: string;
+	/**
+	* List of supported locale identifiers (e.g. ['en', 'fr', 'de']).
+	*/
+	locales: string[];
+	/**
+	* Extract i18n messages from the build output.
+	* When enabled, writes a translation source file after the client build.
+	*/
+	extract?: {
+		/**
+		* Output format for extracted messages.
+		* @default 'json'
+		*/
+		format?: "json" | "xliff" | "xliff2" | "xmb";
+		/**
+		* Output file path for extracted messages, relative to project root.
+		* @default 'src/i18n/messages.{format extension}'
+		*/
+		outFile?: string;
+	};
 }
 export interface Options {
-    ssr?: boolean;
-    ssrBuildDir?: string;
-    /**
-     * Prerender the static pages without producing the server output.
-     */
-    static?: boolean;
-    prerender?: PrerenderOptions;
-    entryServer?: string;
-    /**
-     * Pass configuration options to the internal `@analogjs/vite-plugin-angular`
-     * plugin. Set to false to disable the internal vite plugin.
-     */
-    vite?: PluginOptions | false;
-    nitro?: NitroConfig;
-    apiPrefix?: string;
-    jit?: boolean;
-    index?: string;
-    workspaceRoot?: string;
-    content?: ContentPluginOptions;
-    /**
-     * Extension applied for inline styles
-     */
-    inlineStylesExtension?: string;
-    /**
-     * Enables Angular's HMR during development
-     */
-    liveReload?: boolean;
-    /**
-     * Additional page paths to include
-     */
-    additionalPagesDirs?: string[];
-    /**
-     * Additional page paths to include
-     */
-    additionalContentDirs?: string[];
-    /**
-     * Additional API paths to include
-     */
-    additionalAPIDirs?: string[];
-    /**
-     * Additional files to include in compilation
-     */
-    include?: string[];
-    /**
-     * Toggles internal API middleware.
-     * If disabled, a proxy request is used to route /api
-     * requests to / in the production server build.
-     */
-    useAPIMiddleware?: boolean;
-    /**
-     * Disable type checking diagnostics by the Angular compiler
-     */
-    disableTypeChecking?: boolean;
-    /**
-     * File replacements
-     */
-    fileReplacements?: PluginOptions['fileReplacements'];
+	ssr?: boolean;
+	/**
+	* Prerender the static pages without producing the server output.
+	*/
+	static?: boolean;
+	prerender?: PrerenderOptions;
+	entryServer?: string;
+	apiPrefix?: string;
+	index?: string;
+	workspaceRoot?: string;
+	content?: ContentPluginOptions;
+	/**
+	* Enable debug logging for the `analog:platform:*` and `analog:nitro:*`
+	* scopes.
+	*
+	* - `true` → enables all platform + nitro scopes
+	* - `string[]` → enables listed namespaces
+	* - `{ scopes?, mode? }` → object form with optional `mode: 'build' | 'dev'`
+	*   to restrict output to a specific Vite command (omit for both)
+	*
+	* Angular scopes (`analog:angular:*`) are owned by
+	* `@analogjs/vite-plugin-angular` — pass `debug` to `angular()` directly
+	* to enable them.
+	*
+	* Also responds to the `DEBUG` env var (Node.js) or `localStorage.debug`
+	* (browser), using the `obug` convention.
+	*/
+	debug?: DebugOption;
+	/**
+	* Additional page paths to include
+	*/
+	additionalPagesDirs?: string[];
+	/**
+	* Additional page paths to include
+	*/
+	additionalContentDirs?: string[];
+	/**
+	* Additional API paths to include
+	*/
+	additionalAPIDirs?: string[];
+	/**
+	* Generate routes from the app's route directories.
+	*
+	* Workspace library route directories are opt-in. Use
+	* `discoverLibraryRoutes()` and pass its result to `additionalPagesDirs`,
+	* `additionalContentDirs`, and `additionalAPIDirs` when an app should
+	* include routes from shared libraries.
+	*
+	* @default false
+	*/
+	discoverRoutes?: boolean;
+	/**
+	* Configuration for runtime i18n support.
+	* When set, enables locale detection on SSR and provides
+	* the LOCALE injection token.
+	*/
+	i18n?: I18nOptions;
+	/**
+	* 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?: {
+		/**
+		* 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;
+		/**
+		* Experimental slot for community-maintained style-pipeline integrations.
+		*
+		* This keeps Analog's core surface intentionally narrow: community
+		* packages can register Vite plugins through an Analog-first config shape
+		* without requiring Analog itself to own design-token engines, library
+		* target contracts, or framework-specific theming semantics.
+		*/
+		stylePipeline?: StylePipelineOptions | false;
+	};
+}
+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.d.ts

@@ -1,3 +1,3 @@
-import { Plugin } from 'vite';
-import { Options } from './options.js';
+import { Plugin } from "vite";
+import { Options } from "./options.js";
 export declare function platformPlugin(opts?: Options): Plugin[];

package/src/lib/platform-plugin.js

@@ -1,63 +1,49 @@
-// eslint-disable-next-line @nx/enforce-module-boundaries -- spec uses dynamic import() for vi.mock(), not lazy-loading
-import viteNitroPlugin from '@analogjs/vite-plugin-nitro';
-import angular from '@analogjs/vite-plugin-angular';
-import { routerPlugin } from './router-plugin.js';
-import { ssrBuildPlugin } from './ssr/ssr-build-plugin.js';
-import { contentPlugin } from './content-plugin.js';
-import { clearClientPageEndpointsPlugin } from './clear-client-page-endpoint.js';
-import { ssrXhrBuildPlugin } from './ssr/ssr-xhr-plugin.js';
-import { depsPlugin } from './deps-plugin.js';
-import { injectHTMLPlugin } from './ssr/inject-html-plugin.js';
-import { serverModePlugin } from '../server-mode-plugin.js';
-export function platformPlugin(opts = {}) {
-    const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];
-    const { ...platformOptions } = {
-        ssr: true,
-        ...opts,
-    };
-    let nitroOptions = platformOptions?.nitro;
-    if (nitroOptions?.routeRules) {
-        nitroOptions = {
-            ...nitroOptions,
-            routeRules: Object.keys(nitroOptions.routeRules).reduce((config, curr) => {
-                return {
-                    ...config,
-                    [curr]: {
-                        ...config[curr],
-                        headers: {
-                            ...config[curr].headers,
-                            'x-analog-no-ssr': config[curr]?.ssr === false ? 'true' : undefined,
-                        },
-                    },
-                };
-            }, nitroOptions.routeRules),
-        };
-    }
-    return [
-        ...viteNitroPlugin(platformOptions, nitroOptions),
-        ...(platformOptions.ssr ? [ssrBuildPlugin(), ...injectHTMLPlugin()] : []),
-        ...(!isTest ? depsPlugin(platformOptions) : []),
-        ...routerPlugin(platformOptions),
-        ...contentPlugin(platformOptions?.content, platformOptions),
-        ...(opts?.vite === false
-            ? []
-            : angular({
-                jit: platformOptions.jit,
-                workspaceRoot: platformOptions.workspaceRoot,
-                disableTypeChecking: platformOptions.disableTypeChecking ?? false,
-                include: [
-                    ...(platformOptions.include ?? []),
-                    ...(platformOptions.additionalPagesDirs ?? []).map((pageDir) => `${pageDir}/**/*.page.ts`),
-                ],
-                additionalContentDirs: platformOptions.additionalContentDirs,
-                liveReload: platformOptions.liveReload,
-                inlineStylesExtension: platformOptions.inlineStylesExtension,
-                fileReplacements: platformOptions.fileReplacements,
-                ...(opts?.vite ?? {}),
-            })),
-        serverModePlugin(),
-        ssrXhrBuildPlugin(),
-        clearClientPageEndpointsPlugin(),
-    ];
+import { activateDeferredDebug, applyDebugOption, debugPlatform } from "./utils/debug.js";
+import { routerPlugin } from "./router-plugin.js";
+import { ssrBuildPlugin } from "./ssr/ssr-build-plugin.js";
+import { contentPlugin } from "./content-plugin.js";
+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 { resolveStylePipelinePlugins } from "./style-pipeline.js";
+import { i18nComponentRegistryPlugin } from "./i18n-component-registry-plugin.js";
+import { analogNitroPlugin } from "./nitro/analog-nitro-plugin.js";
+import "node:module";
+import "node:path";
+//#region packages/platform/src/lib/platform-plugin.ts
+function platformPlugin(opts = {}) {
+	applyDebugOption(opts.debug, opts.workspaceRoot);
+	const isTest = process.env.NODE_ENV === "test" || !!process.env["VITEST"];
+	const { ...platformOptions } = {
+		ssr: true,
+		...opts
+	};
+	debugPlatform("experimental options resolved", {
+		typedRouter: platformOptions.experimental?.typedRouter,
+		stylePipeline: !!platformOptions.experimental?.stylePipeline
+	});
+	return [
+		{
+			name: "analogjs-debug-activate",
+			config(_, { command }) {
+				activateDeferredDebug(command);
+			}
+		},
+		analogNitroPlugin(platformOptions),
+		...platformOptions.ssr ? [...ssrBuildPlugin(), ...injectHTMLPlugin()] : [],
+		...!isTest ? depsPlugin(platformOptions) : [],
+		...resolveStylePipelinePlugins(platformOptions.experimental?.stylePipeline, platformOptions.workspaceRoot),
+		...routerPlugin(platformOptions),
+		routeGenerationPlugin(platformOptions),
+		...contentPlugin(platformOptions?.content, platformOptions),
+		...platformOptions.i18n ? [i18nComponentRegistryPlugin()] : [],
+		...serverModePlugin(),
+		clearClientPageEndpointsPlugin()
+	];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGxhdGZvcm0tcGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvcGxhdGZvcm0vc3JjL2xpYi9wbGF0Zm9ybS1wbHVnaW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsdUhBQXVIO0FBQ3ZILE9BQU8sZUFBZSxNQUFNLDZCQUE2QixDQUFDO0FBQzFELE9BQU8sT0FBTyxNQUFNLCtCQUErQixDQUFDO0FBR3BELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNsRCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDM0QsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3BELE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pGLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzVELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUU1RCxNQUFNLFVBQVUsY0FBYyxDQUFDLE9BQWdCLEVBQUU7SUFDL0MsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsS0FBSyxNQUFNLElBQUksQ0FBQyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDN0UsTUFBTSxFQUFFLEdBQUcsZUFBZSxFQUFFLEdBQUc7UUFDN0IsR0FBRyxFQUFFLElBQUk7UUFDVCxHQUFHLElBQUk7S0FDUixDQUFDO0lBRUYsSUFBSSxZQUFZLEdBQUcsZUFBZSxFQUFFLEtBQUssQ0FBQztJQUUxQyxJQUFJLFlBQVksRUFBRSxVQUFVLEVBQUUsQ0FBQztRQUM3QixZQUFZLEdBQUc7WUFDYixHQUFHLFlBQVk7WUFDZixVQUFVLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsVUFBVSxDQUFDLENBQUMsTUFBTSxDQUNyRCxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsRUFBRTtnQkFDZixPQUFPO29CQUNMLEdBQUcsTUFBTTtvQkFDVCxDQUFDLElBQUksQ0FBQyxFQUFFO3dCQUNOLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQzt3QkFDZixPQUFPLEVBQUU7NEJBQ1AsR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTzs0QkFDdkIsaUJBQWlCLEVBQ2YsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsS0FBSyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsU0FBUzt5QkFDNUM7cUJBQ1Q7aUJBQ0YsQ0FBQztZQUNKLENBQUMsRUFDRCxZQUFZLENBQUMsVUFBVSxDQUN4QjtTQUNGLENBQUM7SUFDSixDQUFDO0lBRUQsT0FBTztRQUNMLEdBQUcsZUFBZSxDQUFDLGVBQWUsRUFBRSxZQUFZLENBQUM7UUFDakQsR0FBRyxDQUFDLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsY0FBYyxFQUFFLEVBQUUsR0FBRyxnQkFBZ0IsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUN6RSxHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxlQUFlLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQy9DLEdBQUcsWUFBWSxDQUFDLGVBQWUsQ0FBQztRQUNoQyxHQUFHLGFBQWEsQ0FBQyxlQUFlLEVBQUUsT0FBTyxFQUFFLGVBQWUsQ0FBQztRQUMzRCxHQUFJLENBQUMsSUFBSSxFQUFFLElBQUksS0FBSyxLQUFLO1lBQ3ZCLENBQUMsQ0FBQyxFQUFFO1lBQ0osQ0FBQyxDQUFDLE9BQU8sQ0FBQztnQkFDTixHQUFHLEVBQUUsZUFBZSxDQUFDLEdBQUc7Z0JBQ3hCLGFBQWEsRUFBRSxlQUFlLENBQUMsYUFBYTtnQkFDNUMsbUJBQW1CLEVBQUUsZUFBZSxDQUFDLG1CQUFtQixJQUFJLEtBQUs7Z0JBQ2pFLE9BQU8sRUFBRTtvQkFDUCxHQUFHLENBQUMsZUFBZSxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUM7b0JBQ2xDLEdBQUcsQ0FBQyxlQUFlLENBQUMsbUJBQW1CLElBQUksRUFBRSxDQUFDLENBQUMsR0FBRyxDQUNoRCxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsR0FBRyxPQUFPLGVBQWUsQ0FDdkM7aUJBQ0Y7Z0JBQ0QscUJBQXFCLEVBQUUsZUFBZSxDQUFDLHFCQUFxQjtnQkFDNUQsVUFBVSxFQUFFLGVBQWUsQ0FBQyxVQUFVO2dCQUN0QyxxQkFBcUIsRUFBRSxlQUFlLENBQUMscUJBQXFCO2dCQUM1RCxnQkFBZ0IsRUFBRSxlQUFlLENBQUMsZ0JBQWdCO2dCQUNsRCxHQUFHLENBQUMsSUFBSSxFQUFFLElBQUksSUFBSSxFQUFFLENBQUM7YUFDdEIsQ0FBQyxDQUFTO1FBQ2YsZ0JBQWdCLEVBQUU7UUFDbEIsaUJBQWlCLEVBQVk7UUFDN0IsOEJBQThCLEVBQVk7S0FDM0MsQ0FBQztBQUNKLENBQUMifQ==
+//#endregion
+export { platformPlugin };
+
+//# sourceMappingURL=platform-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-plugin.js","names":[],"sources":["../../../src/lib/platform-plugin.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport { Plugin } from 'vite';\n\nimport { Options } from './options.js';\nimport {\n  activateDeferredDebug,\n  applyDebugOption,\n  debugPlatform,\n} from './utils/debug.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';\nimport { resolveStylePipelinePlugins } from './style-pipeline.js';\nimport { i18nComponentRegistryPlugin } from './i18n-component-registry-plugin.js';\nimport { analogNitroPlugin } from './nitro/analog-nitro-plugin.js';\n\n/**\n * The installed `@angular/core` major version, resolved from the workspace root\n * (where the app's Angular is installed). Returns `null` when it cannot be\n * detected, in which case streaming is not blocked and the build-time\n * anchor-drift detection is relied on instead.\n */\nfunction getAngularCoreMajor(workspaceRoot: string): number | null {\n  try {\n    const req = createRequire(join(workspaceRoot, 'noop.js'));\n    const { version } = req('@angular/core/package.json') as {\n      version: string;\n    };\n    const major = Number.parseInt(version.split('.')[0], 10);\n    return Number.isNaN(major) ? null : major;\n  } catch {\n    return null;\n  }\n}\n\nexport function platformPlugin(opts: Options = {}): Plugin[] {\n  applyDebugOption(opts.debug, opts.workspaceRoot);\n\n  const isTest = process.env['NODE_ENV'] === 'test' || !!process.env['VITEST'];\n  const { ...platformOptions } = {\n    ssr: true,\n    ...opts,\n  };\n\n  debugPlatform('experimental options resolved', {\n    typedRouter: platformOptions.experimental?.typedRouter,\n    stylePipeline: !!platformOptions.experimental?.stylePipeline,\n  });\n\n  return [\n    {\n      name: 'analogjs-debug-activate',\n      config(_, { command }) {\n        activateDeferredDebug(command);\n      },\n    },\n    analogNitroPlugin(platformOptions),\n    ...(platformOptions.ssr\n      ? [...ssrBuildPlugin(), ...injectHTMLPlugin()]\n      : []),\n    ...(!isTest ? depsPlugin(platformOptions) : []),\n    ...resolveStylePipelinePlugins(\n      platformOptions.experimental?.stylePipeline,\n      platformOptions.workspaceRoot,\n    ),\n    ...routerPlugin(platformOptions),\n    routeGenerationPlugin(platformOptions),\n    ...contentPlugin(platformOptions?.content, platformOptions),\n    ...(platformOptions.i18n ? [i18nComponentRegistryPlugin()] : []),\n    ...serverModePlugin(),\n    clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyCA,SAAgB,eAAe,OAAgB,EAAE,EAAY;AAC3D,kBAAiB,KAAK,OAAO,KAAK,cAAc;CAEhD,MAAM,SAAA,QAAA,IAAA,aAAqC,UAAU,CAAC,CAAC,QAAQ,IAAI;CACnE,MAAM,EAAE,GAAG,oBAAoB;EAC7B,KAAK;EACL,GAAG;EACJ;AAED,eAAc,iCAAiC;EAC7C,aAAa,gBAAgB,cAAc;EAC3C,eAAe,CAAC,CAAC,gBAAgB,cAAc;EAChD,CAAC;AAEF,QAAO;EACL;GACE,MAAM;GACN,OAAO,GAAG,EAAE,WAAW;AACrB,0BAAsB,QAAQ;;GAEjC;EACD,kBAAkB,gBAAgB;EAClC,GAAI,gBAAgB,MAChB,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,GAC5C,EAAE;EACN,GAAI,CAAC,SAAS,WAAW,gBAAgB,GAAG,EAAE;EAC9C,GAAG,4BACD,gBAAgB,cAAc,eAC9B,gBAAgB,cACjB;EACD,GAAG,aAAa,gBAAgB;EAChC,sBAAsB,gBAAgB;EACtC,GAAG,cAAc,iBAAiB,SAAS,gBAAgB;EAC3D,GAAI,gBAAgB,OAAO,CAAC,6BAA6B,CAAC,GAAG,EAAE;EAC/D,GAAG,kBAAkB;EACrB,gCAAgC;EACjC"}

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 { 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) 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) {
+		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) {\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    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,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,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;