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

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.js

@@ -1,24 +1,38 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NX_X_LATEST_VITEST = exports.NX_X_LATEST_VITE = exports.V19_X_VITE = exports.V19_X_VITEST = exports.V19_X_VITE_TSCONFIG_PATHS = exports.V19_X_JSDOM = exports.V19_X_NX_VITE = exports.V19_X_NX_ANGULAR = exports.V19_X_ANALOG_JS_VITEST_ANGULAR = exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = exports.V19_X_ANALOG_JS_PLATFORM = exports.V19_X_PRISMJS = exports.V19_X_MARKED_MANGLE = exports.V19_X_MARKED_HIGHLIGHT = exports.V19_X_MARKED_GFM_HEADING_ID = exports.V19_X_MARKED = exports.V19_X_ANALOG_JS_CONTENT = exports.V19_X_ANALOG_JS_ROUTER = void 0;
-// V19_X
-exports.V19_X_ANALOG_JS_ROUTER = '^3.0.0-alpha.3';
-exports.V19_X_ANALOG_JS_CONTENT = '^3.0.0-alpha.3';
-exports.V19_X_MARKED = '^15.0.7';
-exports.V19_X_MARKED_GFM_HEADING_ID = '^4.1.1';
-exports.V19_X_MARKED_HIGHLIGHT = '^2.2.1';
-exports.V19_X_MARKED_MANGLE = '^1.1.10';
-exports.V19_X_PRISMJS = '^1.29.0';
-// devDependencies
-exports.V19_X_ANALOG_JS_PLATFORM = '^3.0.0-alpha.3';
-exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.3';
-exports.V19_X_ANALOG_JS_VITEST_ANGULAR = '^3.0.0-alpha.3';
-exports.V19_X_NX_ANGULAR = '^22.0.0';
-exports.V19_X_NX_VITE = '^22.0.0';
-exports.V19_X_JSDOM = '^22.0.0';
-exports.V19_X_VITE_TSCONFIG_PATHS = '^4.2.0';
-exports.V19_X_VITEST = '^3.0.0';
-exports.V19_X_VITE = '^5.0.0';
-exports.NX_X_LATEST_VITE = '^7.0.0';
-exports.NX_X_LATEST_VITEST = '^4.0.0';
+//#region packages/nx-plugin/src/utils/versions/ng_19_X/versions.ts
+var V19_X_ANALOG_JS_ROUTER = "^3.0.0-alpha.31";
+var V19_X_ANALOG_JS_CONTENT = "^3.0.0-alpha.31";
+var V19_X_MARKED = "^18.0.0";
+var V19_X_MARKED_GFM_HEADING_ID = "^4.1.1";
+var V19_X_MARKED_HIGHLIGHT = "^2.2.1";
+var V19_X_MARKED_MANGLE = "^1.1.10";
+var V19_X_PRISMJS = "^1.29.0";
+var V19_X_ANALOG_JS_PLATFORM = "^3.0.0-alpha.31";
+var V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.31";
+var V19_X_ANALOG_JS_VITEST_ANGULAR = "^3.0.0-alpha.31";
+var V19_X_NX_VITE = "^22.0.0";
+var V19_X_JSDOM = "^22.0.0";
+var V19_X_VITE_TSCONFIG_PATHS = "^4.2.0";
+var V19_X_VITEST = "^3.0.0";
+var V19_X_VITE = "^6.0.0";
+var NX_X_LATEST_VITE = "^8.0.0";
+var NX_X_LATEST_VITEST = "^4.0.0";
+//#endregion
+exports.NX_X_LATEST_VITE = NX_X_LATEST_VITE;
+exports.NX_X_LATEST_VITEST = NX_X_LATEST_VITEST;
+exports.V19_X_ANALOG_JS_CONTENT = V19_X_ANALOG_JS_CONTENT;
+exports.V19_X_ANALOG_JS_PLATFORM = V19_X_ANALOG_JS_PLATFORM;
+exports.V19_X_ANALOG_JS_ROUTER = V19_X_ANALOG_JS_ROUTER;
+exports.V19_X_ANALOG_JS_VITEST_ANGULAR = V19_X_ANALOG_JS_VITEST_ANGULAR;
+exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR;
+exports.V19_X_JSDOM = V19_X_JSDOM;
+exports.V19_X_MARKED = V19_X_MARKED;
+exports.V19_X_MARKED_GFM_HEADING_ID = V19_X_MARKED_GFM_HEADING_ID;
+exports.V19_X_MARKED_HIGHLIGHT = V19_X_MARKED_HIGHLIGHT;
+exports.V19_X_MARKED_MANGLE = V19_X_MARKED_MANGLE;
+exports.V19_X_NX_VITE = V19_X_NX_VITE;
+exports.V19_X_PRISMJS = V19_X_PRISMJS;
+exports.V19_X_VITE = V19_X_VITE;
+exports.V19_X_VITEST = V19_X_VITEST;
+exports.V19_X_VITE_TSCONFIG_PATHS = V19_X_VITE_TSCONFIG_PATHS;
+
 //# sourceMappingURL=versions.js.map

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../../../../../../../../packages/nx-plugin/src/utils/versions/ng_19_X/versions.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACK,QAAA,sBAAsB,GAAG,gBAAgB,CAAC;AAC1C,QAAA,uBAAuB,GAAG,gBAAgB,CAAC;AAC3C,QAAA,YAAY,GAAG,SAAS,CAAC;AACzB,QAAA,2BAA2B,GAAG,QAAQ,CAAC;AACvC,QAAA,sBAAsB,GAAG,QAAQ,CAAC;AAClC,QAAA,mBAAmB,GAAG,SAAS,CAAC;AAChC,QAAA,aAAa,GAAG,SAAS,CAAC;AAEvC,kBAAkB;AACL,QAAA,wBAAwB,GAAG,gBAAgB,CAAC;AAC5C,QAAA,mCAAmC,GAAG,gBAAgB,CAAC;AACvD,QAAA,8BAA8B,GAAG,gBAAgB,CAAC;AAClD,QAAA,gBAAgB,GAAG,SAAS,CAAC;AAC7B,QAAA,aAAa,GAAG,SAAS,CAAC;AAC1B,QAAA,WAAW,GAAG,SAAS,CAAC;AACxB,QAAA,yBAAyB,GAAG,QAAQ,CAAC;AACrC,QAAA,YAAY,GAAG,QAAQ,CAAC;AACxB,QAAA,UAAU,GAAG,QAAQ,CAAC;AACtB,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAC5B,QAAA,kBAAkB,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"versions.js","names":[],"sources":["../../../../../../../../../nx-plugin/src/utils/versions/ng_19_X/versions.ts"],"sourcesContent":["// V19_X\nexport const V19_X_ANALOG_JS_ROUTER = '^3.0.0-alpha.31';\nexport const V19_X_ANALOG_JS_CONTENT = '^3.0.0-alpha.31';\nexport const V19_X_MARKED = '^18.0.0';\nexport const V19_X_MARKED_GFM_HEADING_ID = '^4.1.1';\nexport const V19_X_MARKED_HIGHLIGHT = '^2.2.1';\nexport const V19_X_MARKED_MANGLE = '^1.1.10';\nexport const V19_X_PRISMJS = '^1.29.0';\n\n// devDependencies\nexport const V19_X_ANALOG_JS_PLATFORM = '^3.0.0-alpha.31';\nexport const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.31';\nexport const V19_X_ANALOG_JS_VITEST_ANGULAR = '^3.0.0-alpha.31';\nexport const V19_X_NX_ANGULAR = '^22.0.0';\nexport const V19_X_NX_VITE = '^22.0.0';\nexport const V19_X_JSDOM = '^22.0.0';\nexport const V19_X_VITE_TSCONFIG_PATHS = '^4.2.0';\nexport const V19_X_VITEST = '^3.0.0';\nexport const V19_X_VITE = '^6.0.0';\nexport const NX_X_LATEST_VITE = '^8.0.0';\nexport const NX_X_LATEST_VITEST = '^4.0.0';\n"],"mappings":";AACA,IAAa,yBAAyB;AACtC,IAAa,0BAA0B;AACvC,IAAa,eAAe;AAC5B,IAAa,8BAA8B;AAC3C,IAAa,yBAAyB;AACtC,IAAa,sBAAsB;AACnC,IAAa,gBAAgB;AAG7B,IAAa,2BAA2B;AACxC,IAAa,sCAAsC;AACnD,IAAa,iCAAiC;AAE9C,IAAa,gBAAgB;AAC7B,IAAa,cAAc;AAC3B,IAAa,4BAA4B;AACzC,IAAa,eAAe;AAC5B,IAAa,aAAa;AAC1B,IAAa,mBAAmB;AAChC,IAAa,qBAAqB"}

package/src/lib/options.d.ts

@@ -1,85 +1,229 @@
-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 { PluginOptions } from "@analogjs/vite-plugin-angular";
+import type { NitroConfig, PrerenderRoute } from "nitro/types";
+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";
+import type { DebugOption } from "./utils/debug.js";
+import type { StylePipelineOptions } from "./style-pipeline.js";
+declare module "nitro/types" {
+	interface NitroRouteConfig {
+		ssr?: boolean;
+	}
+	interface NitroRouteRules {
+		ssr?: 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;
+	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 (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`, `hmr`, `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;
+	apiPrefix?: string;
+	jit?: boolean;
+	index?: string;
+	workspaceRoot?: string;
+	content?: ContentPluginOptions;
+	/**
+	* Extension applied for inline styles
+	*/
+	inlineStylesExtension?: string;
+	/**
+	* Enables Angular's HMR during development/watch mode.
+	*
+	* Defaults to `true` for watch mode.
+	*/
+	hmr?: boolean;
+	/**
+	* @deprecated Use `hmr` instead. Kept as a compatibility alias.
+	*/
+	liveReload?: boolean;
+	/**
+	* Enable debug logging for specific scopes.
+	*
+	* - `true` → enables all `analog:*` scopes (platform + angular + nitro)
+	* - `string[]` → enables listed namespaces
+	* - `{ scopes?, mode? }` → object form with optional `mode: 'build' | 'dev'`
+	*   to restrict output to a specific Vite command (omit for both)
+	*
+	* 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[];
+	/**
+	* Automatically discover route directories (pages, content, API) in
+	* workspace libraries by scanning `libs/**` directories directly.
+	*
+	* Discovered directories are merged with any explicit
+	* `additionalPagesDirs`, `additionalContentDirs`, and
+	* `additionalAPIDirs` values.
+	*
+	* @default false
+	*/
+	discoverRoutes?: boolean;
+	/**
+	* 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"];
+	/**
+	* 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;
+		/**
+		* 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,89 @@
-// 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 { discoverLibraryRoutes } from "./discover-library-routes.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 viteNitroPlugin from "@analogjs/vite-plugin-nitro";
+import angular from "@analogjs/vite-plugin-angular";
+import { mapValues, union } from "es-toolkit";
+//#region packages/platform/src/lib/platform-plugin.ts
+function externalPlugins(plugins) {
+	return plugins;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGxhdGZvcm0tcGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvcGxhdGZvcm0vc3JjL2xpYi9wbGF0Zm9ybS1wbHVnaW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsdUhBQXVIO0FBQ3ZILE9BQU8sZUFBZSxNQUFNLDZCQUE2QixDQUFDO0FBQzFELE9BQU8sT0FBTyxNQUFNLCtCQUErQixDQUFDO0FBR3BELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNsRCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDM0QsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3BELE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pGLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzVELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUU1RCxNQUFNLFVBQVUsY0FBYyxDQUFDLE9BQWdCLEVBQUU7SUFDL0MsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsS0FBSyxNQUFNLElBQUksQ0FBQyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDN0UsTUFBTSxFQUFFLEdBQUcsZUFBZSxFQUFFLEdBQUc7UUFDN0IsR0FBRyxFQUFFLElBQUk7UUFDVCxHQUFHLElBQUk7S0FDUixDQUFDO0lBRUYsSUFBSSxZQUFZLEdBQUcsZUFBZSxFQUFFLEtBQUssQ0FBQztJQUUxQyxJQUFJLFlBQVksRUFBRSxVQUFVLEVBQUUsQ0FBQztRQUM3QixZQUFZLEdBQUc7WUFDYixHQUFHLFlBQVk7WUFDZixVQUFVLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsVUFBVSxDQUFDLENBQUMsTUFBTSxDQUNyRCxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsRUFBRTtnQkFDZixPQUFPO29CQUNMLEdBQUcsTUFBTTtvQkFDVCxDQUFDLElBQUksQ0FBQyxFQUFFO3dCQUNOLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQzt3QkFDZixPQUFPLEVBQUU7NEJBQ1AsR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTzs0QkFDdkIsaUJBQWlCLEVBQ2YsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsS0FBSyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsU0FBUzt5QkFDNUM7cUJBQ1Q7aUJBQ0YsQ0FBQztZQUNKLENBQUMsRUFDRCxZQUFZLENBQUMsVUFBVSxDQUN4QjtTQUNGLENBQUM7SUFDSixDQUFDO0lBRUQsT0FBTztRQUNMLEdBQUcsZUFBZSxDQUFDLGVBQWUsRUFBRSxZQUFZLENBQUM7UUFDakQsR0FBRyxDQUFDLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsY0FBYyxFQUFFLEVBQUUsR0FBRyxnQkFBZ0IsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUN6RSxHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxlQUFlLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQy9DLEdBQUcsWUFBWSxDQUFDLGVBQWUsQ0FBQztRQUNoQyxHQUFHLGFBQWEsQ0FBQyxlQUFlLEVBQUUsT0FBTyxFQUFFLGVBQWUsQ0FBQztRQUMzRCxHQUFHLENBQUMsSUFBSSxFQUFFLElBQUksS0FBSyxLQUFLO1lBQ3RCLENBQUMsQ0FBQyxFQUFFO1lBQ0osQ0FBQyxDQUFDLE9BQU8sQ0FBQztnQkFDTixHQUFHLEVBQUUsZUFBZSxDQUFDLEdBQUc7Z0JBQ3hCLGFBQWEsRUFBRSxlQUFlLENBQUMsYUFBYTtnQkFDNUMsbUJBQW1CLEVBQUUsZUFBZSxDQUFDLG1CQUFtQixJQUFJLEtBQUs7Z0JBQ2pFLE9BQU8sRUFBRTtvQkFDUCxHQUFHLENBQUMsZUFBZSxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUM7b0JBQ2xDLEdBQUcsQ0FBQyxlQUFlLENBQUMsbUJBQW1CLElBQUksRUFBRSxDQUFDLENBQUMsR0FBRyxDQUNoRCxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsR0FBRyxPQUFPLGVBQWUsQ0FDdkM7aUJBQ0Y7Z0JBQ0QscUJBQXFCLEVBQUUsZUFBZSxDQUFDLHFCQUFxQjtnQkFDNUQsVUFBVSxFQUFFLGVBQWUsQ0FBQyxVQUFVO2dCQUN0QyxxQkFBcUIsRUFBRSxlQUFlLENBQUMscUJBQXFCO2dCQUM1RCxnQkFBZ0IsRUFBRSxlQUFlLENBQUMsZ0JBQWdCO2dCQUNsRCxHQUFHLENBQUMsSUFBSSxFQUFFLElBQUksSUFBSSxFQUFFLENBQUM7YUFDdEIsQ0FBQyxDQUFDO1FBQ1AsZ0JBQWdCLEVBQUU7UUFDbEIsaUJBQWlCLEVBQUU7UUFDbkIsOEJBQThCLEVBQUU7S0FDakMsQ0FBQztBQUNKLENBQUMifQ==
+function platformPlugin(opts = {}) {
+	applyDebugOption(opts.debug, opts.workspaceRoot);
+	const isTest = process.env.NODE_ENV === "test" || !!process.env["VITEST"];
+	const viteOptions = opts?.vite === false ? void 0 : opts?.vite;
+	const { ...platformOptions } = {
+		ssr: true,
+		...opts
+	};
+	if (platformOptions.discoverRoutes) {
+		const discovered = discoverLibraryRoutes(platformOptions.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd());
+		platformOptions.additionalPagesDirs = union(platformOptions.additionalPagesDirs ?? [], discovered.additionalPagesDirs);
+		platformOptions.additionalContentDirs = union(platformOptions.additionalContentDirs ?? [], discovered.additionalContentDirs);
+		platformOptions.additionalAPIDirs = union(platformOptions.additionalAPIDirs ?? [], discovered.additionalAPIDirs);
+	}
+	const useAngularCompilationAPI = platformOptions.experimental?.useAngularCompilationAPI ?? viteOptions?.experimental?.useAngularCompilationAPI;
+	debugPlatform("experimental options resolved", {
+		useAngularCompilationAPI: !!useAngularCompilationAPI,
+		typedRouter: platformOptions.experimental?.typedRouter,
+		stylePipeline: !!platformOptions.experimental?.stylePipeline
+	});
+	let nitroOptions = platformOptions?.nitro;
+	if (nitroOptions?.routeRules) nitroOptions = {
+		...nitroOptions,
+		routeRules: mapValues(nitroOptions.routeRules, (rule) => ({
+			...rule,
+			headers: {
+				...rule.headers,
+				"x-analog-no-ssr": rule?.ssr === false ? "true" : void 0
+			}
+		}))
+	};
+	return [
+		{
+			name: "analogjs-debug-activate",
+			config(_, { command }) {
+				activateDeferredDebug(command);
+			}
+		},
+		...externalPlugins(viteNitroPlugin(platformOptions, nitroOptions)),
+		...platformOptions.ssr ? [...ssrBuildPlugin(), ...injectHTMLPlugin()] : [],
+		...!isTest ? depsPlugin(platformOptions) : [],
+		...resolveStylePipelinePlugins(platformOptions.experimental?.stylePipeline, platformOptions.workspaceRoot),
+		...routerPlugin(platformOptions),
+		routeGenerationPlugin(platformOptions),
+		...contentPlugin(platformOptions?.content, platformOptions),
+		...opts?.vite === false ? [] : externalPlugins(angular({
+			jit: platformOptions.jit,
+			workspaceRoot: platformOptions.workspaceRoot,
+			disableTypeChecking: platformOptions.disableTypeChecking,
+			include: [...platformOptions.include ?? [], ...(platformOptions.additionalPagesDirs ?? []).map((pageDir) => `${pageDir}/**/*.page.ts`)],
+			additionalContentDirs: platformOptions.additionalContentDirs,
+			hmr: platformOptions.hmr,
+			liveReload: platformOptions.liveReload,
+			inlineStylesExtension: platformOptions.inlineStylesExtension,
+			fileReplacements: platformOptions.fileReplacements,
+			debug: platformOptions.debug,
+			stylePipeline: platformOptions.experimental?.stylePipeline?.angularPlugins?.length ? { plugins: platformOptions.experimental.stylePipeline.angularPlugins } : void 0,
+			...viteOptions ?? {},
+			experimental: {
+				...viteOptions?.experimental ?? {},
+				useAngularCompilationAPI
+			}
+		})),
+		...serverModePlugin(),
+		...clearClientPageEndpointsPlugin()
+	];
+}
+//#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 { Plugin } from 'vite';\nimport viteNitroPlugin from '@analogjs/vite-plugin-nitro';\nimport angular from '@analogjs/vite-plugin-angular';\nimport { mapValues, union } from 'es-toolkit';\n\nimport { Options } from './options.js';\nimport {\n  activateDeferredDebug,\n  applyDebugOption,\n  debugPlatform,\n} from './utils/debug.js';\nimport { discoverLibraryRoutes } from './discover-library-routes.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';\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  applyDebugOption(opts.debug, opts.workspaceRoot);\n\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  if (platformOptions.discoverRoutes) {\n    const workspaceRoot =\n      platformOptions.workspaceRoot ??\n      process.env['NX_WORKSPACE_ROOT'] ??\n      process.cwd();\n    const discovered = discoverLibraryRoutes(workspaceRoot);\n    platformOptions.additionalPagesDirs = union(\n      platformOptions.additionalPagesDirs ?? [],\n      discovered.additionalPagesDirs,\n    );\n    platformOptions.additionalContentDirs = union(\n      platformOptions.additionalContentDirs ?? [],\n      discovered.additionalContentDirs,\n    );\n    platformOptions.additionalAPIDirs = union(\n      platformOptions.additionalAPIDirs ?? [],\n      discovered.additionalAPIDirs,\n    );\n  }\n\n  const useAngularCompilationAPI =\n    platformOptions.experimental?.useAngularCompilationAPI ??\n    viteOptions?.experimental?.useAngularCompilationAPI;\n  debugPlatform('experimental options resolved', {\n    useAngularCompilationAPI: !!useAngularCompilationAPI,\n    typedRouter: platformOptions.experimental?.typedRouter,\n    stylePipeline: !!platformOptions.experimental?.stylePipeline,\n  });\n  let nitroOptions = platformOptions?.nitro;\n\n  if (nitroOptions?.routeRules) {\n    nitroOptions = {\n      ...nitroOptions,\n      routeRules: mapValues(nitroOptions.routeRules, (rule) => ({\n        ...rule,\n        headers: {\n          ...rule.headers,\n          'x-analog-no-ssr': rule?.ssr === false ? 'true' : undefined,\n        } as any,\n      })),\n    };\n  }\n\n  return [\n    {\n      name: 'analogjs-debug-activate',\n      config(_, { command }) {\n        activateDeferredDebug(command);\n      },\n    },\n    ...externalPlugins(viteNitroPlugin(platformOptions as any, nitroOptions)),\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    ...(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            hmr: platformOptions.hmr,\n            liveReload: platformOptions.liveReload,\n            inlineStylesExtension: platformOptions.inlineStylesExtension,\n            fileReplacements: platformOptions.fileReplacements,\n            debug: platformOptions.debug,\n            stylePipeline: platformOptions.experimental?.stylePipeline\n              ?.angularPlugins?.length\n              ? {\n                  plugins:\n                    platformOptions.experimental.stylePipeline.angularPlugins,\n                }\n              : undefined,\n            ...(viteOptions ?? {}),\n            experimental: {\n              ...(viteOptions?.experimental ?? {}),\n              useAngularCompilationAPI,\n            },\n          }),\n        )),\n    ...serverModePlugin(),\n    ...clearClientPageEndpointsPlugin(),\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,SAAS,gBAAgB,SAA4B;AACnD,QAAO;;AAGT,SAAgB,eAAe,OAAgB,EAAE,EAAY;AAC3D,kBAAiB,KAAK,OAAO,KAAK,cAAc;CAEhD,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;AACD,KAAI,gBAAgB,gBAAgB;EAKlC,MAAM,aAAa,sBAHjB,gBAAgB,iBAChB,QAAQ,IAAI,wBACZ,QAAQ,KAAK,CACwC;AACvD,kBAAgB,sBAAsB,MACpC,gBAAgB,uBAAuB,EAAE,EACzC,WAAW,oBACZ;AACD,kBAAgB,wBAAwB,MACtC,gBAAgB,yBAAyB,EAAE,EAC3C,WAAW,sBACZ;AACD,kBAAgB,oBAAoB,MAClC,gBAAgB,qBAAqB,EAAE,EACvC,WAAW,kBACZ;;CAGH,MAAM,2BACJ,gBAAgB,cAAc,4BAC9B,aAAa,cAAc;AAC7B,eAAc,iCAAiC;EAC7C,0BAA0B,CAAC,CAAC;EAC5B,aAAa,gBAAgB,cAAc;EAC3C,eAAe,CAAC,CAAC,gBAAgB,cAAc;EAChD,CAAC;CACF,IAAI,eAAe,iBAAiB;AAEpC,KAAI,cAAc,WAChB,gBAAe;EACb,GAAG;EACH,YAAY,UAAU,aAAa,aAAa,UAAU;GACxD,GAAG;GACH,SAAS;IACP,GAAG,KAAK;IACR,mBAAmB,MAAM,QAAQ,QAAQ,SAAS,KAAA;IACnD;GACF,EAAE;EACJ;AAGH,QAAO;EACL;GACE,MAAM;GACN,OAAO,GAAG,EAAE,WAAW;AACrB,0BAAsB,QAAQ;;GAEjC;EACD,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,4BACD,gBAAgB,cAAc,eAC9B,gBAAgB,cACjB;EACD,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,KAAK,gBAAgB;GACrB,YAAY,gBAAgB;GAC5B,uBAAuB,gBAAgB;GACvC,kBAAkB,gBAAgB;GAClC,OAAO,gBAAgB;GACvB,eAAe,gBAAgB,cAAc,eACzC,gBAAgB,SAChB,EACE,SACE,gBAAgB,aAAa,cAAc,gBAC9C,GACD,KAAA;GACJ,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;