@analogjs/platform 3.0.0-alpha.9 → 3.0.0-alpha.91

package/src/lib/typed-routes-plugin.js

@@ -0,0 +1,119 @@
+import { createRouteFileDiscovery } from "./route-file-discovery.js";
+import { generateRouteManifest, generateRouteTableDeclaration } from "./route-manifest.js";
+import { dirname, join, relative, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { normalizePath } from "vite";
+import { parseSync } from "oxc-parser";
+import { readConfiguration } from "@angular/compiler-cli";
+//#region packages/platform/src/lib/typed-routes-plugin.ts
+function typedRoutes(options = {}) {
+	const workspaceRoot = normalizePath(options.workspaceRoot ?? process.cwd());
+	const outFile = options.outFile ?? "src/routeTree.gen.d.ts";
+	if (!outFile.endsWith(".d.ts")) throw new Error("[analog] Typed routing outFile must end in .d.ts. Include this declaration in your application tsconfig.");
+	let root;
+	let command;
+	let discovery;
+	let getTsConfigPath;
+	function verifyTypeInclusion() {
+		if (!getTsConfigPath) return;
+		const tsconfig = getTsConfigPath();
+		const { rootNames, errors } = readConfiguration(tsconfig);
+		if (errors.length) throw new Error(`[analog] Cannot verify typed routing: unable to read ${tsconfig}.`);
+		const outputPath = normalizePath(resolve(root, outFile));
+		if (!rootNames.some((file) => normalizePath(resolve(file)) === outputPath)) {
+			const declaration = normalizePath(relative(dirname(tsconfig), outputPath));
+			throw new Error(`[analog] Typed route declaration is not included in ${tsconfig}. Add "${declaration}" to its "files" or "include" list so typed routing is available to the compiler and editor.`);
+		}
+	}
+	function generate() {
+		const manifest = generateRouteManifest([...discovery.getRouteFiles(), ...discovery.getContentFiles()], (filename) => discovery.isAppLocal(filename) ? 0 : 1);
+		const collisions = manifest.collisions.filter((collision) => collision.samePriority);
+		if (command === "build" && collisions.length) throw new Error(`[analog] Route collisions detected: ${collisions.map((c) => `${c.fullPath}: ${c.keptFile}, ${c.droppedFile}`).join("; ")}`);
+		const outputPath = join(root, outFile);
+		const output = generateRouteTableDeclaration(manifest, (filename) => {
+			const pageFile = [
+				join(root, filename),
+				join(workspaceRoot, filename),
+				filename
+			].find((file) => existsSync(file));
+			if (!pageFile) return void 0;
+			const serverFile = pageFile.replace(/\.page\.ts$/, ".server.ts");
+			return {
+				routeMeta: hasNamedExport(pageFile, "routeMeta") ? toImportSpecifier(dirname(outputPath), pageFile) : void 0,
+				load: serverFile !== pageFile && existsSync(serverFile) && hasNamedExport(serverFile, "load") ? toImportSpecifier(dirname(outputPath), serverFile) : void 0
+			};
+		});
+		const exists = existsSync(outputPath);
+		const current = exists ? readFileSync(outputPath, "utf8") : "";
+		if (current !== output && !sameDeclarations(current, output)) {
+			if (exists && command === "build" && (options.verifyOnBuild ?? true)) throw new Error(`[analog] Stale route file: ${outFile}. Run the dev server to regenerate it before building.`);
+			mkdirSync(dirname(outputPath), { recursive: true });
+			writeFileSync(outputPath, output);
+		}
+	}
+	return {
+		name: "analog-typed-routes",
+		config(config, env) {
+			command = env.command;
+			root = normalizePath(resolve(workspaceRoot, config.root ?? "."));
+			discovery = createRouteFileDiscovery({
+				root,
+				workspaceRoot,
+				additionalPagesDirs: options.additionalPagesDirs ?? [],
+				additionalContentDirs: options.additionalContentDirs ?? []
+			});
+			generate();
+		},
+		configResolved(config) {
+			const compiler = config.plugins.find((plugin) => plugin.name === "@analogjs/vite-plugin-angular" || plugin.name === "@analogjs/vite-plugin-angular-fast-compile" || plugin.name === "@analogjs/vite-plugin-angular-compilation-api");
+			getTsConfigPath = compiler?.api?.getTsConfigPath;
+			if (compiler && !getTsConfigPath) throw new Error("[analog] Typed routing requires a matching @analogjs/vite-plugin-angular version to verify the application tsconfig.");
+			verifyTypeInclusion();
+		},
+		buildStart() {
+			discovery.reset();
+			generate();
+			verifyTypeInclusion();
+		},
+		configureServer(server) {
+			server.watcher.add(join(root, outFile));
+			for (const event of [
+				"add",
+				"change",
+				"unlink"
+			]) server.watcher.on(event, (path) => {
+				if (!discovery.getDiscoveredFileKind(path)) return;
+				discovery.updateDiscoveredFile(path, event);
+				generate();
+			});
+		}
+	};
+}
+function toImportSpecifier(fromDir, file) {
+	const specifier = normalizePath(relative(fromDir, file)).replace(/\.ts$/, "");
+	return specifier.startsWith(".") ? specifier : `./${specifier}`;
+}
+function hasNamedExport(file, name) {
+	const source = readFileSync(file, "utf8");
+	if (!source.includes(name)) return false;
+	const { program, errors } = parseSync(file, source);
+	if (errors.length) return false;
+	return program.body.some((statement) => {
+		if (statement.type !== "ExportNamedDeclaration" || statement.exportKind === "type") return false;
+		const declaration = statement.declaration;
+		if (declaration?.type === "VariableDeclaration") return declaration.declarations.some((item) => item.id.type === "Identifier" && item.id.name === name);
+		if (declaration?.type === "FunctionDeclaration") return declaration.id?.name === name;
+		return statement.specifiers.some((specifier) => specifier.exportKind !== "type" && (specifier.exported.type === "Identifier" ? specifier.exported.name : specifier.exported.value) === name);
+	});
+}
+function sameDeclarations(current, output) {
+	const left = parseSync("routeTree.gen.d.ts", current);
+	const right = parseSync("routeTree.gen.d.ts", output);
+	if (left.errors.length || right.errors.length) return false;
+	const withoutFormatting = (key, value) => key === "start" || key === "end" || key === "raw" ? void 0 : value;
+	return JSON.stringify(left.program, withoutFormatting) === JSON.stringify(right.program, withoutFormatting);
+}
+//#endregion
+export { typedRoutes };
+
+//# sourceMappingURL=typed-routes-plugin.js.map

package/src/lib/typed-routes-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-routes-plugin.js","names":[],"sources":["../../../src/lib/typed-routes-plugin.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { readConfiguration } from '@angular/compiler-cli';\nimport { parseSync } from 'oxc-parser';\nimport { normalizePath, type Plugin } from 'vite';\n\nimport {\n  createRouteFileDiscovery,\n  type RouteFileDiscovery,\n} from './route-file-discovery.js';\nimport {\n  generateRouteManifest,\n  generateRouteTableDeclaration,\n} from './route-manifest.js';\n\nexport interface TypedRoutingOptions {\n  /** Generated declaration path (.d.ts), relative to the app root. */\n  outFile?: string;\n  /** Fail builds when a checked-in route table is stale. Defaults to true. */\n  verifyOnBuild?: boolean;\n}\n\nexport interface TypedRoutesPluginOptions extends TypedRoutingOptions {\n  workspaceRoot?: string;\n  additionalPagesDirs?: string[];\n  additionalContentDirs?: string[];\n}\n\nexport function typedRoutes(options: TypedRoutesPluginOptions = {}): Plugin {\n  const workspaceRoot = normalizePath(options.workspaceRoot ?? process.cwd());\n  const outFile = options.outFile ?? 'src/routeTree.gen.d.ts';\n  if (!outFile.endsWith('.d.ts')) {\n    throw new Error(\n      '[analog] Typed routing outFile must end in .d.ts. Include this declaration in your application tsconfig.',\n    );\n  }\n  let root: string;\n  let command: 'build' | 'serve';\n  let discovery: RouteFileDiscovery;\n\n  let getTsConfigPath: (() => string) | undefined;\n\n  function verifyTypeInclusion(): void {\n    if (!getTsConfigPath) return;\n    const tsconfig = getTsConfigPath();\n    const { rootNames, errors } = readConfiguration(tsconfig);\n    if (errors.length) {\n      throw new Error(\n        `[analog] Cannot verify typed routing: unable to read ${tsconfig}.`,\n      );\n    }\n    const outputPath = normalizePath(resolve(root, outFile));\n    if (\n      !rootNames.some((file) => normalizePath(resolve(file)) === outputPath)\n    ) {\n      const declaration = normalizePath(\n        relative(dirname(tsconfig), outputPath),\n      );\n      throw new Error(\n        `[analog] Typed route declaration is not included in ${tsconfig}. Add \"${declaration}\" to its \"files\" or \"include\" list so typed routing is available to the compiler and editor.`,\n      );\n    }\n  }\n\n  function generate(): void {\n    const manifest = generateRouteManifest(\n      [...discovery.getRouteFiles(), ...discovery.getContentFiles()],\n      (filename) => (discovery.isAppLocal(filename) ? 0 : 1),\n    );\n    const collisions = manifest.collisions.filter(\n      (collision) => collision.samePriority,\n    );\n    if (command === 'build' && collisions.length) {\n      throw new Error(\n        `[analog] Route collisions detected: ${collisions.map((c) => `${c.fullPath}: ${c.keptFile}, ${c.droppedFile}`).join('; ')}`,\n      );\n    }\n    const outputPath = join(root, outFile);\n    const output = generateRouteTableDeclaration(manifest, (filename) => {\n      const pageFile = [\n        join(root, filename),\n        join(workspaceRoot, filename),\n        filename,\n      ].find((file) => existsSync(file));\n      if (!pageFile) return undefined;\n      const serverFile = pageFile.replace(/\\.page\\.ts$/, '.server.ts');\n      return {\n        routeMeta: hasNamedExport(pageFile, 'routeMeta')\n          ? toImportSpecifier(dirname(outputPath), pageFile)\n          : undefined,\n        load:\n          serverFile !== pageFile &&\n          existsSync(serverFile) &&\n          hasNamedExport(serverFile, 'load')\n            ? toImportSpecifier(dirname(outputPath), serverFile)\n            : undefined,\n      };\n    });\n    const exists = existsSync(outputPath);\n    const current = exists ? readFileSync(outputPath, 'utf8') : '';\n    if (current !== output && !sameDeclarations(current, output)) {\n      if (exists && command === 'build' && (options.verifyOnBuild ?? true)) {\n        throw new Error(\n          `[analog] Stale route file: ${outFile}. Run the dev server to regenerate it before building.`,\n        );\n      }\n      mkdirSync(dirname(outputPath), { recursive: true });\n      writeFileSync(outputPath, output);\n    }\n  }\n\n  return {\n    name: 'analog-typed-routes',\n    config(config, env) {\n      command = env.command;\n      root = normalizePath(resolve(workspaceRoot, config.root ?? '.'));\n      discovery = createRouteFileDiscovery({\n        root,\n        workspaceRoot,\n        additionalPagesDirs: options.additionalPagesDirs ?? [],\n        additionalContentDirs: options.additionalContentDirs ?? [],\n      });\n      // Generate before Angular reads the application tsconfig.\n      generate();\n    },\n    configResolved(config) {\n      const compiler = config.plugins.find(\n        (plugin) =>\n          plugin.name === '@analogjs/vite-plugin-angular' ||\n          plugin.name === '@analogjs/vite-plugin-angular-fast-compile' ||\n          plugin.name === '@analogjs/vite-plugin-angular-compilation-api',\n      );\n      getTsConfigPath = compiler?.api?.getTsConfigPath;\n      if (compiler && !getTsConfigPath) {\n        throw new Error(\n          '[analog] Typed routing requires a matching @analogjs/vite-plugin-angular version to verify the application tsconfig.',\n        );\n      }\n      verifyTypeInclusion();\n    },\n    buildStart() {\n      discovery.reset();\n      generate();\n      verifyTypeInclusion();\n    },\n    configureServer(server) {\n      server.watcher.add(join(root, outFile));\n      for (const event of ['add', 'change', 'unlink'] as const) {\n        server.watcher.on(event, (path) => {\n          if (!discovery.getDiscoveredFileKind(path)) return;\n          discovery.updateDiscoveredFile(path, event);\n          generate();\n        });\n      }\n    },\n  };\n}\n\nfunction toImportSpecifier(fromDir: string, file: string): string {\n  const specifier = normalizePath(relative(fromDir, file)).replace(/\\.ts$/, '');\n  return specifier.startsWith('.') ? specifier : `./${specifier}`;\n}\n\nfunction hasNamedExport(file: string, name: string): boolean {\n  const source = readFileSync(file, 'utf8');\n  if (!source.includes(name)) return false;\n  const { program, errors } = parseSync(file, source);\n  if (errors.length) return false;\n  return program.body.some((statement) => {\n    if (\n      statement.type !== 'ExportNamedDeclaration' ||\n      statement.exportKind === 'type'\n    ) {\n      return false;\n    }\n    const declaration = statement.declaration;\n    if (declaration?.type === 'VariableDeclaration') {\n      return declaration.declarations.some(\n        (item) => item.id.type === 'Identifier' && item.id.name === name,\n      );\n    }\n    if (declaration?.type === 'FunctionDeclaration') {\n      return declaration.id?.name === name;\n    }\n    return statement.specifiers.some(\n      (specifier) =>\n        specifier.exportKind !== 'type' &&\n        (specifier.exported.type === 'Identifier'\n          ? specifier.exported.name\n          : specifier.exported.value) === name,\n    );\n  });\n}\n\nfunction sameDeclarations(current: string, output: string): boolean {\n  const left = parseSync('routeTree.gen.d.ts', current);\n  const right = parseSync('routeTree.gen.d.ts', output);\n  if (left.errors.length || right.errors.length) return false;\n  const withoutFormatting = (key: string, value: unknown) =>\n    key === 'start' || key === 'end' || key === 'raw' ? undefined : value;\n  return (\n    JSON.stringify(left.program, withoutFormatting) ===\n    JSON.stringify(right.program, withoutFormatting)\n  );\n}\n"],"mappings":"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"}

package/src/lib/utils/debug-harness.d.ts

@@ -0,0 +1,23 @@
+import type { Debugger } from "obug";
+export type DebugMode = "build" | "dev";
+export interface DebugModeOptions<S extends string = string> {
+	scopes?: boolean | S[];
+	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
+}
+export type DebugOption<S extends string = string> = boolean | S[] | DebugModeOptions<S> | DebugModeOptions<S>[];
+export interface DebugHarness<S extends string = string> {
+	applyDebugOption(debug: DebugOption<S> | undefined, workspaceRoot?: string): void;
+	activateDeferredDebug(command: "build" | "serve"): void;
+	/** @internal test-only reset */
+	_resetDeferredDebug(): void;
+}
+export declare function createDebugHarness<S extends string = string>(config: {
+	fallbackNamespace: string;
+	instanceGroups: Debugger[][];
+}): DebugHarness<S>;

package/src/lib/utils/debug-harness.js

@@ -0,0 +1,88 @@
+import { DEBUG_LOG_DIR, DEBUG_LOG_FILENAME, wrapInstancesForFileLog, wrapInstancesForScopedFileLog } from "./debug-log-file.js";
+import { join } from "node:path";
+import { enable } from "obug";
+//#region packages/platform/src/lib/utils/debug-harness.ts
+/**
+* Duplicates of this file (keep in sync):
+*   packages/platform/src/lib/utils/debug-harness.ts
+*   packages/vite-plugin-angular/src/lib/utils/debug-harness.ts
+*/
+function resolveNamespaces(scopes, fallback) {
+	if (scopes === true || scopes === void 0) return fallback;
+	if (Array.isArray(scopes) && scopes.length) return scopes.join(",");
+	return null;
+}
+function extractLogFile(debug) {
+	if (typeof debug === "boolean") return false;
+	if (Array.isArray(debug)) {
+		if (debug.length === 0 || typeof debug[0] === "string") return false;
+		return debug.find((e) => !!e.logFile)?.logFile ?? false;
+	}
+	return debug.logFile ?? false;
+}
+function createDebugHarness(config) {
+	let pendingDebug = [];
+	function installFileWrappers(logFile, root) {
+		if (logFile === "scoped") {
+			const dirPath = join(root, DEBUG_LOG_DIR);
+			for (const group of config.instanceGroups) wrapInstancesForScopedFileLog(group, dirPath);
+		} else {
+			const filePath = join(root, DEBUG_LOG_DIR, DEBUG_LOG_FILENAME);
+			for (const group of config.instanceGroups) wrapInstancesForFileLog(group, filePath);
+		}
+	}
+	function applyEntry(entry, fallback, logFile, root) {
+		if (!entry.mode) {
+			const ns = resolveNamespaces(entry.scopes ?? true, fallback);
+			if (ns) enable(ns);
+			if (logFile) installFileWrappers(logFile, root);
+		} else pendingDebug.push({
+			entry,
+			logFile,
+			root
+		});
+	}
+	return {
+		applyDebugOption(debug, workspaceRoot) {
+			if (debug == null || debug === false) return;
+			const logFile = extractLogFile(debug);
+			const root = workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd();
+			if (typeof debug === "boolean") {
+				const ns = resolveNamespaces(debug, config.fallbackNamespace);
+				if (ns) enable(ns);
+				return;
+			}
+			if (Array.isArray(debug)) {
+				if (debug.length === 0) return;
+				if (typeof debug[0] === "string") {
+					const ns = debug.join(",");
+					if (ns) enable(ns);
+					return;
+				}
+				for (const entry of debug) {
+					const entryLogFile = entry.logFile ?? false;
+					applyEntry(entry, config.fallbackNamespace, entryLogFile || logFile, root);
+				}
+				return;
+			}
+			applyEntry(debug, config.fallbackNamespace, logFile, root);
+		},
+		activateDeferredDebug(command) {
+			if (pendingDebug.length === 0) return;
+			const currentMode = command === "serve" ? "dev" : "build";
+			for (const { entry, logFile, root } of pendingDebug) if (entry.mode === currentMode) {
+				const ns = resolveNamespaces(entry.scopes ?? true, config.fallbackNamespace);
+				if (ns) enable(ns);
+				if (logFile) installFileWrappers(logFile, root);
+			}
+			pendingDebug = [];
+		},
+		_resetDeferredDebug() {
+			pendingDebug = [];
+		}
+	};
+}
+//#endregion
+export { createDebugHarness };
+
+//# sourceMappingURL=debug-harness.js.map

package/src/lib/utils/debug-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-harness.js","names":[],"sources":["../../../../src/lib/utils/debug-harness.ts"],"sourcesContent":["/**\n * Duplicates of this file (keep in sync):\n *   packages/platform/src/lib/utils/debug-harness.ts\n *   packages/vite-plugin-angular/src/lib/utils/debug-harness.ts\n */\nimport { join } from 'node:path';\nimport { enable } from 'obug';\nimport type { Debugger } from 'obug';\n\nimport {\n  DEBUG_LOG_DIR,\n  DEBUG_LOG_FILENAME,\n  wrapInstancesForFileLog,\n  wrapInstancesForScopedFileLog,\n} from './debug-log-file.js';\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions<S extends string = string> {\n  scopes?: boolean | S[];\n  mode?: DebugMode;\n  /**\n   * Write debug output to log files under `tmp/debug/` in the workspace root.\n   * - `true` or `'single'` — all output to `tmp/debug/analog.log`\n   * - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`\n   */\n  logFile?: boolean | 'single' | 'scoped';\n}\n\nexport type DebugOption<S extends string = string> =\n  | boolean\n  | S[]\n  | DebugModeOptions<S>\n  | DebugModeOptions<S>[];\n\nexport interface DebugHarness<S extends string = string> {\n  applyDebugOption(\n    debug: DebugOption<S> | undefined,\n    workspaceRoot?: string,\n  ): void;\n  activateDeferredDebug(command: 'build' | 'serve'): void;\n  /** @internal test-only reset */\n  _resetDeferredDebug(): void;\n}\n\nfunction resolveNamespaces(\n  scopes: boolean | string[] | undefined,\n  fallback: string,\n): string | null {\n  if (scopes === true || scopes === undefined) return fallback;\n  if (Array.isArray(scopes) && scopes.length) return scopes.join(',');\n  return null;\n}\n\nfunction extractLogFile(\n  debug: DebugOption,\n): true | 'single' | 'scoped' | false {\n  if (typeof debug === 'boolean') return false;\n  if (Array.isArray(debug)) {\n    if (debug.length === 0 || typeof debug[0] === 'string') return false;\n    const entry = (debug as DebugModeOptions[]).find((e) => !!e.logFile);\n    return entry?.logFile ?? false;\n  }\n  return (debug as DebugModeOptions).logFile ?? false;\n}\n\nexport function createDebugHarness<S extends string = string>(config: {\n  fallbackNamespace: string;\n  instanceGroups: Debugger[][];\n}): DebugHarness<S> {\n  interface PendingEntry {\n    entry: DebugModeOptions<S>;\n    logFile: true | 'single' | 'scoped' | false;\n    root: string;\n  }\n\n  let pendingDebug: PendingEntry[] = [];\n\n  function installFileWrappers(\n    logFile: true | 'single' | 'scoped',\n    root: string,\n  ): void {\n    if (logFile === 'scoped') {\n      const dirPath = join(root, DEBUG_LOG_DIR);\n      for (const group of config.instanceGroups) {\n        wrapInstancesForScopedFileLog(group, dirPath);\n      }\n    } else {\n      const filePath = join(root, DEBUG_LOG_DIR, DEBUG_LOG_FILENAME);\n      for (const group of config.instanceGroups) {\n        wrapInstancesForFileLog(group, filePath);\n      }\n    }\n  }\n\n  function applyEntry(\n    entry: DebugModeOptions<S>,\n    fallback: string,\n    logFile: true | 'single' | 'scoped' | false,\n    root: string,\n  ): void {\n    if (!entry.mode) {\n      const ns = resolveNamespaces(entry.scopes ?? true, fallback);\n      if (ns) enable(ns);\n      if (logFile) installFileWrappers(logFile, root);\n    } else {\n      pendingDebug.push({ entry, logFile, root });\n    }\n  }\n\n  return {\n    applyDebugOption(\n      debug: DebugOption<S> | undefined,\n      workspaceRoot?: string,\n    ): void {\n      if (debug == null || debug === false) return;\n\n      const logFile = extractLogFile(debug);\n      const root =\n        workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd();\n\n      if (typeof debug === 'boolean') {\n        const ns = resolveNamespaces(debug, config.fallbackNamespace);\n        if (ns) enable(ns);\n        return;\n      }\n\n      if (Array.isArray(debug)) {\n        if (debug.length === 0) return;\n\n        if (typeof debug[0] === 'string') {\n          const ns = (debug as string[]).join(',');\n          if (ns) enable(ns);\n          return;\n        }\n\n        for (const entry of debug as DebugModeOptions<S>[]) {\n          const entryLogFile = entry.logFile ?? false;\n          applyEntry(\n            entry,\n            config.fallbackNamespace,\n            entryLogFile || logFile,\n            root,\n          );\n        }\n        return;\n      }\n\n      applyEntry(debug, config.fallbackNamespace, logFile, root);\n    },\n\n    activateDeferredDebug(command: 'build' | 'serve'): void {\n      if (pendingDebug.length === 0) return;\n\n      const currentMode = command === 'serve' ? 'dev' : 'build';\n\n      for (const { entry, logFile, root } of pendingDebug) {\n        if (entry.mode === currentMode) {\n          const ns = resolveNamespaces(\n            entry.scopes ?? true,\n            config.fallbackNamespace,\n          );\n          if (ns) enable(ns);\n          if (logFile) installFileWrappers(logFile, root);\n        }\n      }\n\n      pendingDebug = [];\n    },\n\n    _resetDeferredDebug(): void {\n      pendingDebug = [];\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA6CA,SAAS,kBACP,QACA,UACe;AACf,KAAI,WAAW,QAAQ,WAAW,KAAA,EAAW,QAAO;AACpD,KAAI,MAAM,QAAQ,OAAO,IAAI,OAAO,OAAQ,QAAO,OAAO,KAAK,IAAI;AACnE,QAAO;;AAGT,SAAS,eACP,OACoC;AACpC,KAAI,OAAO,UAAU,UAAW,QAAO;AACvC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,KAAK,OAAO,MAAM,OAAO,SAAU,QAAO;AAE/D,SADe,MAA6B,MAAM,MAAM,CAAC,CAAC,EAAE,QAAQ,EACtD,WAAW;;AAE3B,QAAQ,MAA2B,WAAW;;AAGhD,SAAgB,mBAA8C,QAG1C;CAOlB,IAAI,eAA+B,EAAE;CAErC,SAAS,oBACP,SACA,MACM;AACN,MAAI,YAAY,UAAU;GACxB,MAAM,UAAU,KAAK,MAAM,cAAc;AACzC,QAAK,MAAM,SAAS,OAAO,eACzB,+BAA8B,OAAO,QAAQ;SAE1C;GACL,MAAM,WAAW,KAAK,MAAM,eAAe,mBAAmB;AAC9D,QAAK,MAAM,SAAS,OAAO,eACzB,yBAAwB,OAAO,SAAS;;;CAK9C,SAAS,WACP,OACA,UACA,SACA,MACM;AACN,MAAI,CAAC,MAAM,MAAM;GACf,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,SAAS;AAC5D,OAAI,GAAI,QAAO,GAAG;AAClB,OAAI,QAAS,qBAAoB,SAAS,KAAK;QAE/C,cAAa,KAAK;GAAE;GAAO;GAAS;GAAM,CAAC;;AAI/C,QAAO;EACL,iBACE,OACA,eACM;AACN,OAAI,SAAS,QAAQ,UAAU,MAAO;GAEtC,MAAM,UAAU,eAAe,MAAM;GACrC,MAAM,OACJ,iBAAiB,QAAQ,IAAI,wBAAwB,QAAQ,KAAK;AAEpE,OAAI,OAAO,UAAU,WAAW;IAC9B,MAAM,KAAK,kBAAkB,OAAO,OAAO,kBAAkB;AAC7D,QAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,OAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAI,MAAM,WAAW,EAAG;AAExB,QAAI,OAAO,MAAM,OAAO,UAAU;KAChC,MAAM,KAAM,MAAmB,KAAK,IAAI;AACxC,SAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,SAAK,MAAM,SAAS,OAAgC;KAClD,MAAM,eAAe,MAAM,WAAW;AACtC,gBACE,OACA,OAAO,mBACP,gBAAgB,SAChB,KACD;;AAEH;;AAGF,cAAW,OAAO,OAAO,mBAAmB,SAAS,KAAK;;EAG5D,sBAAsB,SAAkC;AACtD,OAAI,aAAa,WAAW,EAAG;GAE/B,MAAM,cAAc,YAAY,UAAU,QAAQ;AAElD,QAAK,MAAM,EAAE,OAAO,SAAS,UAAU,aACrC,KAAI,MAAM,SAAS,aAAa;IAC9B,MAAM,KAAK,kBACT,MAAM,UAAU,MAChB,OAAO,kBACR;AACD,QAAI,GAAI,QAAO,GAAG;AAClB,QAAI,QAAS,qBAAoB,SAAS,KAAK;;AAInD,kBAAe,EAAE;;EAGnB,sBAA4B;AAC1B,kBAAe,EAAE;;EAEpB"}

package/src/lib/utils/debug-log-file.d.ts

@@ -0,0 +1,5 @@
+import type { Debugger } from "obug";
+export declare const DEBUG_LOG_DIR = "tmp/debug";
+export declare const DEBUG_LOG_FILENAME = "analog.log";
+export declare function wrapInstancesForFileLog(instances: Debugger[], filePath: string): void;
+export declare function wrapInstancesForScopedFileLog(instances: Debugger[], dirPath: string): void;

package/src/lib/utils/debug-log-file.js

@@ -0,0 +1,56 @@
+import { dirname, join } from "node:path";
+import { appendFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { format } from "node:util";
+//#region packages/platform/src/lib/utils/debug-log-file.ts
+/**
+* Duplicates of this file (keep in sync):
+*   packages/platform/src/lib/utils/debug-log-file.ts
+*   packages/vite-plugin-angular/src/lib/utils/debug-log-file.ts
+*/
+var TRUNCATED_KEY = "__analogDebugLogTruncated";
+var WRAPPED_KEY = "__analogFileLogWrapped";
+var ANSI_RE = /\x1B\[[0-9;]*[A-Za-z]|\x1B\].*?\x07/g;
+var DEBUG_LOG_DIR = "tmp/debug";
+var DEBUG_LOG_FILENAME = "analog.log";
+function ensureTruncated(filePath) {
+	const g = globalThis;
+	const truncated = g[TRUNCATED_KEY] ?? /* @__PURE__ */ new Set();
+	g[TRUNCATED_KEY] = truncated;
+	if (truncated.has(filePath)) return;
+	try {
+		mkdirSync(dirname(filePath), { recursive: true });
+		writeFileSync(filePath, "", "utf-8");
+	} catch {}
+	truncated.add(filePath);
+}
+function wrapLog(dbg, filePath) {
+	const rec = dbg;
+	if (rec[WRAPPED_KEY] === filePath) return;
+	const originalLog = rec[WRAPPED_KEY] && rec["__analogOriginalLog"] ? rec["__analogOriginalLog"] : dbg.log;
+	rec["__analogOriginalLog"] = originalLog;
+	dbg.log = function(...args) {
+		originalLog.apply(this, args);
+		try {
+			appendFileSync(filePath, format(...args).replace(ANSI_RE, "") + "\n", "utf-8");
+		} catch {}
+	};
+	rec[WRAPPED_KEY] = filePath;
+}
+function wrapInstancesForFileLog(instances, filePath) {
+	ensureTruncated(filePath);
+	for (const dbg of instances) wrapLog(dbg, filePath);
+}
+function scopeToFilename(namespace) {
+	return namespace.replace(/:/g, ".") + ".log";
+}
+function wrapInstancesForScopedFileLog(instances, dirPath) {
+	for (const dbg of instances) {
+		const scopedPath = join(dirPath, scopeToFilename(dbg.namespace));
+		ensureTruncated(scopedPath);
+		wrapLog(dbg, scopedPath);
+	}
+}
+//#endregion
+export { DEBUG_LOG_DIR, DEBUG_LOG_FILENAME, wrapInstancesForFileLog, wrapInstancesForScopedFileLog };
+
+//# sourceMappingURL=debug-log-file.js.map

package/src/lib/utils/debug-log-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log-file.js","names":[],"sources":["../../../../src/lib/utils/debug-log-file.ts"],"sourcesContent":["/**\n * Duplicates of this file (keep in sync):\n *   packages/platform/src/lib/utils/debug-log-file.ts\n *   packages/vite-plugin-angular/src/lib/utils/debug-log-file.ts\n */\nimport { mkdirSync, writeFileSync, appendFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { format } from 'node:util';\nimport type { Debugger } from 'obug';\n\nconst TRUNCATED_KEY = '__analogDebugLogTruncated';\nconst WRAPPED_KEY = '__analogFileLogWrapped';\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\x1B\\[[0-9;]*[A-Za-z]|\\x1B\\].*?\\x07/g;\n\nexport const DEBUG_LOG_DIR = 'tmp/debug';\nexport const DEBUG_LOG_FILENAME = 'analog.log';\n\nfunction ensureTruncated(filePath: string): void {\n  const g = globalThis as Record<string, unknown>;\n  const truncated = (g[TRUNCATED_KEY] as Set<string>) ?? new Set<string>();\n  g[TRUNCATED_KEY] = truncated;\n  if (truncated.has(filePath)) return;\n  try {\n    mkdirSync(dirname(filePath), { recursive: true });\n    writeFileSync(filePath, '', 'utf-8');\n  } catch {\n    // best-effort: fall through to append mode if truncation fails\n  }\n  truncated.add(filePath);\n}\n\nfunction wrapLog(dbg: Debugger, filePath: string): void {\n  const rec = dbg as Record<string, unknown>;\n  if (rec[WRAPPED_KEY] === filePath) return;\n\n  const originalLog =\n    rec[WRAPPED_KEY] && rec['__analogOriginalLog']\n      ? (rec['__analogOriginalLog'] as Debugger['log'])\n      : dbg.log;\n\n  rec['__analogOriginalLog'] = originalLog;\n  dbg.log = function (this: Debugger, ...args: unknown[]) {\n    originalLog.apply(this, args);\n    try {\n      const line = format(...args).replace(ANSI_RE, '') + '\\n';\n      appendFileSync(filePath, line, 'utf-8');\n    } catch {\n      // debug logging must never crash the build\n    }\n  };\n  rec[WRAPPED_KEY] = filePath;\n}\n\nexport function wrapInstancesForFileLog(\n  instances: Debugger[],\n  filePath: string,\n): void {\n  ensureTruncated(filePath);\n  for (const dbg of instances) {\n    wrapLog(dbg, filePath);\n  }\n}\n\nfunction scopeToFilename(namespace: string): string {\n  return namespace.replace(/:/g, '.') + '.log';\n}\n\nexport function wrapInstancesForScopedFileLog(\n  instances: Debugger[],\n  dirPath: string,\n): void {\n  for (const dbg of instances) {\n    const scopedPath = join(dirPath, scopeToFilename(dbg.namespace));\n    ensureTruncated(scopedPath);\n    wrapLog(dbg, scopedPath);\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAM,gBAAgB;AACtB,IAAM,cAAc;AAEpB,IAAM,UAAU;AAEhB,IAAa,gBAAgB;AAC7B,IAAa,qBAAqB;AAElC,SAAS,gBAAgB,UAAwB;CAC/C,MAAM,IAAI;CACV,MAAM,YAAa,EAAE,kCAAkC,IAAI,KAAa;AACxE,GAAE,iBAAiB;AACnB,KAAI,UAAU,IAAI,SAAS,CAAE;AAC7B,KAAI;AACF,YAAU,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,gBAAc,UAAU,IAAI,QAAQ;SAC9B;AAGR,WAAU,IAAI,SAAS;;AAGzB,SAAS,QAAQ,KAAe,UAAwB;CACtD,MAAM,MAAM;AACZ,KAAI,IAAI,iBAAiB,SAAU;CAEnC,MAAM,cACJ,IAAI,gBAAgB,IAAI,yBACnB,IAAI,yBACL,IAAI;AAEV,KAAI,yBAAyB;AAC7B,KAAI,MAAM,SAA0B,GAAG,MAAiB;AACtD,cAAY,MAAM,MAAM,KAAK;AAC7B,MAAI;AAEF,kBAAe,UADF,OAAO,GAAG,KAAK,CAAC,QAAQ,SAAS,GAAG,GAAG,MACrB,QAAQ;UACjC;;AAIV,KAAI,eAAe;;AAGrB,SAAgB,wBACd,WACA,UACM;AACN,iBAAgB,SAAS;AACzB,MAAK,MAAM,OAAO,UAChB,SAAQ,KAAK,SAAS;;AAI1B,SAAS,gBAAgB,WAA2B;AAClD,QAAO,UAAU,QAAQ,MAAM,IAAI,GAAG;;AAGxC,SAAgB,8BACd,WACA,SACM;AACN,MAAK,MAAM,OAAO,WAAW;EAC3B,MAAM,aAAa,KAAK,SAAS,gBAAgB,IAAI,UAAU,CAAC;AAChE,kBAAgB,WAAW;AAC3B,UAAQ,KAAK,WAAW"}

package/src/lib/utils/debug.d.ts

@@ -0,0 +1,20 @@
+export declare const debugPlatform: unknown;
+export declare const debugRoutes: unknown;
+export declare const debugContent: unknown;
+export declare const debugTypedRouter: unknown;
+export type DebugScope = "analog:*" | "analog:platform" | "analog:platform:*" | "analog:platform:routes" | "analog:platform:content" | "analog:platform:typed-router" | "analog:angular:*" | "analog:angular:hmr" | "analog:angular:styles" | "analog:angular:compiler" | "analog:angular:compilation-api" | "analog:angular:style-pipeline" | "analog:nitro" | "analog:nitro:*" | "analog:nitro:ssr" | "analog:nitro:prerender" | (string & {});
+export type DebugMode = "build" | "dev";
+export interface DebugModeOptions {
+	scopes?: boolean | DebugScope[];
+	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
+}
+export type DebugOption = boolean | DebugScope[] | DebugModeOptions | DebugModeOptions[];
+export declare const applyDebugOption: (debug: DebugOption | undefined, workspaceRoot?: string) => void;
+export declare const activateDeferredDebug: (command: "build" | "serve") => void;
+export declare const _resetDeferredDebug: () => void;

package/src/lib/utils/debug.js

@@ -0,0 +1,21 @@
+import { nitroDebugInstances } from "../nitro/debug.js";
+import { createDebugHarness } from "./debug-harness.js";
+import { createDebug } from "obug";
+//#region packages/platform/src/lib/utils/debug.ts
+var debugPlatform = createDebug("analog:platform");
+var harness = createDebugHarness({
+	fallbackNamespace: "analog:*",
+	instanceGroups: [[
+		debugPlatform,
+		createDebug("analog:platform:routes"),
+		createDebug("analog:platform:content"),
+		createDebug("analog:platform:typed-router")
+	], nitroDebugInstances]
+});
+var applyDebugOption = harness.applyDebugOption;
+var activateDeferredDebug = harness.activateDeferredDebug;
+harness._resetDeferredDebug;
+//#endregion
+export { activateDeferredDebug, applyDebugOption, debugPlatform };
+
+//# sourceMappingURL=debug.js.map

package/src/lib/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug } from 'obug';\nimport { nitroDebugInstances } from '../nitro/debug.js';\nimport { createDebugHarness } from './debug-harness.js';\n\nexport const debugPlatform = createDebug('analog:platform');\nexport const debugRoutes = createDebug('analog:platform:routes');\nexport const debugContent = createDebug('analog:platform:content');\nexport const debugTypedRouter = createDebug('analog:platform:typed-router');\n\nconst platformDebugInstances = [\n  debugPlatform,\n  debugRoutes,\n  debugContent,\n  debugTypedRouter,\n];\n\nexport type DebugScope =\n  | 'analog:*'\n  | 'analog:platform'\n  | 'analog:platform:*'\n  | 'analog:platform:routes'\n  | 'analog:platform:content'\n  | 'analog:platform:typed-router'\n  | 'analog:angular:*'\n  | 'analog:angular:hmr'\n  | 'analog:angular:styles'\n  | 'analog:angular:compiler'\n  | 'analog:angular:compilation-api'\n  | 'analog:angular:style-pipeline'\n  | 'analog:nitro'\n  | 'analog:nitro:*'\n  | 'analog:nitro:ssr'\n  | 'analog:nitro:prerender'\n  | (string & {});\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions {\n  scopes?: boolean | DebugScope[];\n  mode?: DebugMode;\n  /**\n   * Write debug output to log files under `tmp/debug/` in the workspace root.\n   * - `true` or `'single'` — all output to `tmp/debug/analog.log`\n   * - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`\n   */\n  logFile?: boolean | 'single' | 'scoped';\n}\n\nexport type DebugOption =\n  | boolean\n  | DebugScope[]\n  | DebugModeOptions\n  | DebugModeOptions[];\n\nconst harness = createDebugHarness({\n  fallbackNamespace: 'analog:*',\n  instanceGroups: [platformDebugInstances, nitroDebugInstances],\n});\n\nexport const applyDebugOption: (\n  debug: DebugOption | undefined,\n  workspaceRoot?: string,\n) => void = harness.applyDebugOption;\nexport const activateDeferredDebug: (command: 'build' | 'serve') => void =\n  harness.activateDeferredDebug;\nexport const _resetDeferredDebug: () => void = harness._resetDeferredDebug;\n"],"mappings":";;;;AAIA,IAAa,gBAAgB,YAAY,kBAAkB;AAkD3D,IAAM,UAAU,mBAAmB;CACjC,mBAAmB;CACnB,gBAAgB,CA/Ca;EAC7B;EALyB,YAAY,yBAAyB;EACpC,YAAY,0BAA0B;EAClC,YAAY,+BAA+B;EAO1E,EA0C0C,oBAAoB;CAC9D,CAAC;AAEF,IAAa,mBAGD,QAAQ;AACpB,IAAa,wBACX,QAAQ;AACqC,QAAQ"}

package/src/lib/utils/rolldown.d.ts

@@ -1,3 +1,3 @@
 export declare function isRolldown(): boolean;
-export declare function getJsTransformConfigKey(): 'oxc' | 'esbuild';
-export declare function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions';
+export declare function getJsTransformConfigKey(): "oxc" | "esbuild";
+export declare function getBundleOptionsKey(): "rolldownOptions" | "rollupOptions";

package/src/lib/utils/rolldown.js.map

@@ -1 +1 @@
-{"version":3,"file":"rolldown.js","names":[],"sources":["../../../../../../packages/platform/src/lib/utils/rolldown.ts"],"sourcesContent":["import * as vite from 'vite';\n\nexport function isRolldown(): boolean {\n  return !!vite.rolldownVersion;\n}\n\nexport function getJsTransformConfigKey(): 'oxc' | 'esbuild' {\n  return isRolldown() ? 'oxc' : 'esbuild';\n}\n\nexport function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions' {\n  return isRolldown() ? 'rolldownOptions' : 'rollupOptions';\n}\n"],"mappings":";;AAEA,SAAgB,aAAsB;AACpC,QAAO,CAAC,CAAC,KAAK;;AAGhB,SAAgB,0BAA6C;AAC3D,QAAO,YAAY,GAAG,QAAQ;;AAGhC,SAAgB,sBAA2D;AACzE,QAAO,YAAY,GAAG,oBAAoB"}
+{"version":3,"file":"rolldown.js","names":[],"sources":["../../../../src/lib/utils/rolldown.ts"],"sourcesContent":["import * as vite from 'vite';\n\nexport function isRolldown(): boolean {\n  return !!vite.rolldownVersion;\n}\n\nexport function getJsTransformConfigKey(): 'oxc' | 'esbuild' {\n  return isRolldown() ? 'oxc' : 'esbuild';\n}\n\nexport function getBundleOptionsKey(): 'rolldownOptions' | 'rollupOptions' {\n  return isRolldown() ? 'rolldownOptions' : 'rollupOptions';\n}\n"],"mappings":";;AAEA,SAAgB,aAAsB;AACpC,QAAO,CAAC,CAAC,KAAK;;AAGhB,SAAgB,0BAA6C;AAC3D,QAAO,YAAY,GAAG,QAAQ;;AAGhC,SAAgB,sBAA2D;AACzE,QAAO,YAAY,GAAG,oBAAoB"}

package/src/server-mode-plugin.d.ts

@@ -1,7 +1,13 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
+export declare const SERVER_MODE_ID = "virtual:@analogjs/platform/server-mode";
 /**
- * This plugin ensures the ngServerMode flag is set
- * during SSR. This should be revisited when Vite 6 lands
- * with the new Environment API.
- */
+* Serves a module that sets `globalThis.ngServerMode = true`.
+*
+* Angular decides at provider-creation time whether browser-only features
+* such as event replay apply, and `provideClientHydration()` runs while the
+* app config module evaluates, before `platformServer()` or
+* `provideServerRendering()` set the flag. The SSR entry imports this module
+* first so the flag is set before any application module evaluates. A text
+* replacement cannot do this because Angular is pre-bundled for SSR.
+*/
 export declare function serverModePlugin(): Plugin[];

package/src/server-mode-plugin.js

@@ -1,18 +1,28 @@
 //#region packages/platform/src/server-mode-plugin.ts
+var SERVER_MODE_ID = "virtual:@analogjs/platform/server-mode";
+var RESOLVED_SERVER_MODE_ID = `\0${SERVER_MODE_ID}`;
 /**
-* This plugin ensures the ngServerMode flag is set
-* during SSR. This should be revisited when Vite 6 lands
-* with the new Environment API.
+* Serves a module that sets `globalThis.ngServerMode = true`.
+*
+* Angular decides at provider-creation time whether browser-only features
+* such as event replay apply, and `provideClientHydration()` runs while the
+* app config module evaluates, before `platformServer()` or
+* `provideServerRendering()` set the flag. The SSR entry imports this module
+* first so the flag is set before any application module evaluates. A text
+* replacement cannot do this because Angular is pre-bundled for SSR.
 */
 function serverModePlugin() {
 	return [{
 		name: "analogjs-server-mode-plugin",
-		transform(code, id, options) {
-			if (options?.ssr && (id.endsWith("platform-server.mjs") || id.endsWith("core.mjs"))) return { code: code.replaceAll("ngServerMode", "true") };
+		resolveId(id) {
+			return id === "virtual:@analogjs/platform/server-mode" ? RESOLVED_SERVER_MODE_ID : void 0;
+		},
+		load(id) {
+			return id === RESOLVED_SERVER_MODE_ID ? "globalThis.ngServerMode = true;\nexport {};\n" : void 0;
 		}
 	}];
 }
 //#endregion
-export { serverModePlugin };
+export { SERVER_MODE_ID, serverModePlugin };
 
 //# sourceMappingURL=server-mode-plugin.js.map

package/src/server-mode-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-mode-plugin.js","names":[],"sources":["../../../../packages/platform/src/server-mode-plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\n\n/**\n * This plugin ensures the ngServerMode flag is set\n * during SSR. This should be revisited when Vite 6 lands\n * with the new Environment API.\n */\nexport function serverModePlugin(): Plugin[] {\n  return [\n    {\n      name: 'analogjs-server-mode-plugin',\n      transform(code, id, options) {\n        if (\n          options?.ssr &&\n          (id.endsWith('platform-server.mjs') || id.endsWith('core.mjs'))\n        ) {\n          return {\n            code: code.replaceAll('ngServerMode', 'true'),\n          };\n        }\n\n        return;\n      },\n    },\n  ];\n}\n"],"mappings":";;;;;;AAOA,SAAgB,mBAA6B;AAC3C,QAAO,CACL;EACE,MAAM;EACN,UAAU,MAAM,IAAI,SAAS;AAC3B,OACE,SAAS,QACR,GAAG,SAAS,sBAAsB,IAAI,GAAG,SAAS,WAAW,EAE9D,QAAO,EACL,MAAM,KAAK,WAAW,gBAAgB,OAAO,EAC9C;;EAKN,CACF"}
+{"version":3,"file":"server-mode-plugin.js","names":[],"sources":["../../src/server-mode-plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\n\nexport const SERVER_MODE_ID = 'virtual:@analogjs/platform/server-mode';\nconst RESOLVED_SERVER_MODE_ID = `\\0${SERVER_MODE_ID}`;\n\n/**\n * Serves a module that sets `globalThis.ngServerMode = true`.\n *\n * Angular decides at provider-creation time whether browser-only features\n * such as event replay apply, and `provideClientHydration()` runs while the\n * app config module evaluates, before `platformServer()` or\n * `provideServerRendering()` set the flag. The SSR entry imports this module\n * first so the flag is set before any application module evaluates. A text\n * replacement cannot do this because Angular is pre-bundled for SSR.\n */\nexport function serverModePlugin(): Plugin[] {\n  return [\n    {\n      name: 'analogjs-server-mode-plugin',\n      resolveId(id) {\n        return id === SERVER_MODE_ID ? RESOLVED_SERVER_MODE_ID : undefined;\n      },\n      load(id) {\n        return id === RESOLVED_SERVER_MODE_ID\n          ? 'globalThis.ngServerMode = true;\\nexport {};\\n'\n          : undefined;\n      },\n    },\n  ];\n}\n"],"mappings":";AAEA,IAAa,iBAAiB;AAC9B,IAAM,0BAA0B,KAAK;;;;;;;;;;;AAYrC,SAAgB,mBAA6B;AAC3C,QAAO,CACL;EACE,MAAM;EACN,UAAU,IAAI;AACZ,UAAO,OAAA,2CAAwB,0BAA0B,KAAA;;EAE3D,KAAK,IAAI;AACP,UAAO,OAAO,0BACV,kDACA,KAAA;;EAEP,CACF"}

package/src/lib/nx-plugin/src/executors/vite/compat.d.ts

@@ -1,3 +0,0 @@
-import { convertNxExecutor } from '@nx/devkit';
-declare const compat: ReturnType<typeof convertNxExecutor>;
-export default compat;

package/src/lib/nx-plugin/src/executors/vite/compat.js

@@ -1,8 +0,0 @@
-import vite_impl_default from "./vite.impl.js";
-import { convertNxExecutor } from "@nx/devkit";
-//#region packages/nx-plugin/src/executors/vite/compat.ts
-var compat = convertNxExecutor(vite_impl_default);
-//#endregion
-export { compat as default };
-
-//# sourceMappingURL=compat.js.map

package/src/lib/nx-plugin/src/executors/vite/compat.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compat.js","names":[],"sources":["../../../../../../../../../packages/nx-plugin/src/executors/vite/compat.ts"],"sourcesContent":["import { convertNxExecutor } from '@nx/devkit';\n\nimport viteBuildExecutor from './vite.impl';\n\nconst compat: ReturnType<typeof convertNxExecutor> =\n  convertNxExecutor(viteBuildExecutor);\nexport default compat;\n"],"mappings":";;;AAIA,IAAM,SACJ,kBAAkB,kBAAkB"}

package/src/lib/nx-plugin/src/executors/vite/schema.d.ts

@@ -1,2 +0,0 @@
-import type { FileReplacement } from '@nx/vite/plugins/rollup-replace-files.plugin';
-export type { ViteBuildExecutorOptions } from '@nx/vite/executors';