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

package/src/lib/tailwind-preprocessor.js

@@ -0,0 +1,153 @@
+import { debugTailwind } from "./utils/debug.js";
+import path from "node:path";
+import { readFileSync } from "node:fs";
+//#region packages/platform/src/lib/tailwind-preprocessor.ts
+var PLATFORM_TAILWIND_PREFIX = "[@analogjs/platform]";
+var CSS_REFERENCE_DIRECTIVE_REGEX = /(^|[;}\n\r])\s*@reference\b/m;
+var CSS_TAILWIND_IMPORT_REGEX = /(^|[;}\n\r])\s*@import\s+["']tailwindcss["']/m;
+function stripCssBlockComments(code) {
+	let result = "";
+	let quote = null;
+	for (let index = 0; index < code.length; index++) {
+		const character = code[index];
+		const nextCharacter = code[index + 1];
+		if (quote) {
+			if (character === "\\" && nextCharacter) {
+				result += character;
+				result += nextCharacter;
+				index++;
+				continue;
+			}
+			if (character === quote) quote = null;
+			result += character;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") {
+			quote = character;
+			result += character;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "*") {
+			result += "  ";
+			index += 2;
+			while (index < code.length) {
+				const commentCharacter = code[index];
+				const commentNextCharacter = code[index + 1];
+				if (commentCharacter === "*" && commentNextCharacter === "/") {
+					result += "  ";
+					index++;
+					break;
+				}
+				result += commentCharacter === "\n" || commentCharacter === "\r" ? commentCharacter : " ";
+				index++;
+			}
+			continue;
+		}
+		result += character;
+	}
+	return result;
+}
+function hasReferenceTextInComments(code) {
+	let quote = null;
+	for (let index = 0; index < code.length; index++) {
+		const character = code[index];
+		const nextCharacter = code[index + 1];
+		if (quote) {
+			if (character === "\\" && nextCharacter) {
+				index++;
+				continue;
+			}
+			if (character === quote) quote = null;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") {
+			quote = character;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "*") {
+			const commentStart = index + 2;
+			index += 2;
+			while (index < code.length) {
+				const commentCharacter = code[index];
+				const commentNextCharacter = code[index + 1];
+				if (commentCharacter === "*" && commentNextCharacter === "/") break;
+				index++;
+			}
+			if (code.slice(commentStart, index).includes("@reference")) return true;
+		}
+	}
+	return false;
+}
+function inspectCssTailwindDirectives(code) {
+	const commentlessCode = stripCssBlockComments(code);
+	return {
+		commentlessCode,
+		hasReferenceDirective: CSS_REFERENCE_DIRECTIVE_REGEX.test(commentlessCode),
+		hasReferenceText: hasReferenceTextInComments(code),
+		hasTailwindImportDirective: CSS_TAILWIND_IMPORT_REGEX.test(commentlessCode)
+	};
+}
+function toReferenceSpecifier(filename, tailwindRootCss) {
+	const fromDir = path.posix.dirname(filename.replace(/\\/g, "/"));
+	const toFile = tailwindRootCss.replace(/\\/g, "/");
+	const relativePath = path.posix.relative(fromDir, toFile);
+	return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+}
+function throwTailwindReferenceTextError(filename, referenceSpecifier) {
+	throw new Error(`${PLATFORM_TAILWIND_PREFIX} Tailwind @reference auto-injection was blocked for "${filename}" because the stylesheet contains the text "@reference" but does not contain a real @reference directive.\n\nThis is usually caused by a CSS comment such as "/* ... @reference ... */".\n\nFix one of:\n  - Reword the comment so it does not contain "@reference"\n  - Add a real @reference "${referenceSpecifier}"; directive\n`);
+}
+/**
+* Creates a stylesheet preprocessor that injects Tailwind v4 `@reference`
+* directives into Angular component styles when needed. The Tailwind prefix is
+* detected from the configured root CSS file.
+*/
+function tailwindPreprocessor(options) {
+	const { tailwindRootCss, mode: modeOption = "auto", shouldInject } = options;
+	let rootPrefix;
+	debugTailwind("configured", {
+		tailwindRootCss,
+		mode: modeOption
+	});
+	return (code, filename) => {
+		const directiveState = inspectCssTailwindDirectives(code);
+		if (directiveState.hasReferenceDirective) {
+			debugTailwind("skip (already has @reference)", { filename });
+			return code;
+		}
+		const resolvedMode = typeof modeOption === "function" ? modeOption(filename) : modeOption;
+		if (resolvedMode === "disabled") {
+			debugTailwind("skip (mode disabled)", { filename });
+			return code;
+		}
+		const resolvedPrefix = typeof resolvedMode === "object" ? resolvedMode.prefix : getRootPrefix();
+		const isRootFile = path.resolve(filename) === path.resolve(tailwindRootCss) || directiveState.hasTailwindImportDirective;
+		const hasTailwindUsage = resolvedPrefix ? directiveState.commentlessCode.includes(`${resolvedPrefix}:`) : false;
+		if (!(shouldInject ? shouldInject(code, filename, resolvedPrefix) : hasTailwindUsage && !isRootFile) || !resolvedPrefix) {
+			debugTailwind("skip (no injection needed)", {
+				filename,
+				resolvedPrefix,
+				isRootFile,
+				hasTailwindUsage
+			});
+			return code;
+		}
+		const refPath = toReferenceSpecifier(filename, tailwindRootCss);
+		if (directiveState.hasReferenceText) throwTailwindReferenceTextError(filename, refPath);
+		debugTailwind("injected @reference", {
+			filename,
+			refPath
+		});
+		return `@reference "${refPath}";\n${code}`;
+	};
+	function getRootPrefix() {
+		if (rootPrefix === void 0) rootPrefix = extractTailwindPrefix(readFileSync(tailwindRootCss, "utf-8"));
+		return rootPrefix;
+	}
+}
+function extractTailwindPrefix(code) {
+	return code.match(/@import\s+["']tailwindcss["']\s+prefix\(\s*([^)\s;]+)\s*\)/i)?.[1]?.trim() ?? null;
+}
+//#endregion
+export { tailwindPreprocessor };
+
+//# sourceMappingURL=tailwind-preprocessor.js.map

package/src/lib/tailwind-preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-preprocessor.js","names":[],"sources":["../../../src/lib/tailwind-preprocessor.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport path from 'node:path';\n\nimport type { StylePreprocessor } from './style-preprocessor.js';\nimport { debugTailwind } from './utils/debug.js';\n\nexport type TailwindPreprocessorMode = 'auto' | 'disabled' | { prefix: string };\nconst PLATFORM_TAILWIND_PREFIX = '[@analogjs/platform]';\nconst CSS_REFERENCE_DIRECTIVE_REGEX = /(^|[;}\\n\\r])\\s*@reference\\b/m;\nconst CSS_TAILWIND_IMPORT_REGEX =\n  /(^|[;}\\n\\r])\\s*@import\\s+[\"']tailwindcss[\"']/m;\n\ninterface CssTailwindDirectiveState {\n  commentlessCode: string;\n  hasReferenceDirective: boolean;\n  hasReferenceText: boolean;\n  hasTailwindImportDirective: boolean;\n}\n\n// Mask real block comments while preserving quoted CSS content. This keeps\n// prose like `/* add @reference here */` from disabling injection without\n// mistaking `/* ... */` sequences inside strings for real comments.\nfunction stripCssBlockComments(code: string): string {\n  let result = '';\n  let quote: '\"' | \"'\" | '`' | null = null;\n\n  for (let index = 0; index < code.length; index++) {\n    const character = code[index];\n    const nextCharacter = code[index + 1];\n\n    if (quote) {\n      if (character === '\\\\' && nextCharacter) {\n        result += character;\n        result += nextCharacter;\n        index++;\n        continue;\n      }\n      if (character === quote) {\n        quote = null;\n      }\n      result += character;\n      continue;\n    }\n\n    if (character === '\"' || character === \"'\" || character === '`') {\n      quote = character;\n      result += character;\n      continue;\n    }\n\n    if (character === '/' && nextCharacter === '*') {\n      result += '  ';\n      index += 2;\n\n      while (index < code.length) {\n        const commentCharacter = code[index];\n        const commentNextCharacter = code[index + 1];\n\n        if (commentCharacter === '*' && commentNextCharacter === '/') {\n          result += '  ';\n          index++;\n          break;\n        }\n\n        result +=\n          commentCharacter === '\\n' || commentCharacter === '\\r'\n            ? commentCharacter\n            : ' ';\n        index++;\n      }\n      continue;\n    }\n\n    result += character;\n  }\n\n  return result;\n}\n\nfunction hasReferenceTextInComments(code: string): boolean {\n  let quote: '\"' | \"'\" | '`' | null = null;\n\n  for (let index = 0; index < code.length; index++) {\n    const character = code[index];\n    const nextCharacter = code[index + 1];\n\n    if (quote) {\n      if (character === '\\\\' && nextCharacter) {\n        index++;\n        continue;\n      }\n      if (character === quote) {\n        quote = null;\n      }\n      continue;\n    }\n\n    if (character === '\"' || character === \"'\" || character === '`') {\n      quote = character;\n      continue;\n    }\n\n    if (character === '/' && nextCharacter === '*') {\n      const commentStart = index + 2;\n      index += 2;\n\n      while (index < code.length) {\n        const commentCharacter = code[index];\n        const commentNextCharacter = code[index + 1];\n\n        if (commentCharacter === '*' && commentNextCharacter === '/') {\n          break;\n        }\n        index++;\n      }\n\n      if (code.slice(commentStart, index).includes('@reference')) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nfunction inspectCssTailwindDirectives(code: string): CssTailwindDirectiveState {\n  const commentlessCode = stripCssBlockComments(code);\n\n  return {\n    commentlessCode,\n    hasReferenceDirective: CSS_REFERENCE_DIRECTIVE_REGEX.test(commentlessCode),\n    hasReferenceText: hasReferenceTextInComments(code),\n    hasTailwindImportDirective: CSS_TAILWIND_IMPORT_REGEX.test(commentlessCode),\n  };\n}\n\nfunction toReferenceSpecifier(\n  filename: string,\n  tailwindRootCss: string,\n): string {\n  const fromDir = path.posix.dirname(filename.replace(/\\\\/g, '/'));\n  const toFile = tailwindRootCss.replace(/\\\\/g, '/');\n  const relativePath = path.posix.relative(fromDir, toFile);\n\n  return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;\n}\n\nfunction throwTailwindReferenceTextError(\n  filename: string,\n  referenceSpecifier: string,\n): never {\n  throw new Error(\n    `${PLATFORM_TAILWIND_PREFIX} Tailwind @reference auto-injection was ` +\n      `blocked for \"${filename}\" because the stylesheet contains the ` +\n      `text \"@reference\" but does not contain a real @reference ` +\n      `directive.\\n\\n` +\n      `This is usually caused by a CSS comment such as ` +\n      `\"/* ... @reference ... */\".\\n\\n` +\n      `Fix one of:\\n` +\n      `  - Reword the comment so it does not contain \"@reference\"\\n` +\n      `  - Add a real @reference \"${referenceSpecifier}\"; directive\\n`,\n  );\n}\n\nexport interface TailwindPreprocessorOptions {\n  /** Absolute path to the Tailwind root CSS file that imports `tailwindcss`. */\n  tailwindRootCss: string;\n\n  /**\n   * Controls whether the preprocessor auto-detects, disables, or manually\n   * overrides the Tailwind prefix for a given file.\n   */\n  mode?:\n    | TailwindPreprocessorMode\n    | ((filename: string) => TailwindPreprocessorMode);\n\n  /**\n   * Optional predicate to override the default `@reference` injection behavior.\n   */\n  shouldInject?: (\n    code: string,\n    filename: string,\n    resolvedPrefix: string | null,\n  ) => boolean;\n}\n\n/**\n * Creates a stylesheet preprocessor that injects Tailwind v4 `@reference`\n * directives into Angular component styles when needed. The Tailwind prefix is\n * detected from the configured root CSS file.\n */\nexport function tailwindPreprocessor(\n  options: TailwindPreprocessorOptions,\n): StylePreprocessor {\n  const { tailwindRootCss, mode: modeOption = 'auto', shouldInject } = options;\n  let rootPrefix: string | undefined;\n\n  debugTailwind('configured', { tailwindRootCss, mode: modeOption });\n\n  return (code: string, filename: string): string => {\n    const directiveState = inspectCssTailwindDirectives(code);\n\n    if (directiveState.hasReferenceDirective) {\n      debugTailwind('skip (already has @reference)', { filename });\n      return code;\n    }\n\n    const resolvedMode =\n      typeof modeOption === 'function' ? modeOption(filename) : modeOption;\n\n    if (resolvedMode === 'disabled') {\n      debugTailwind('skip (mode disabled)', { filename });\n      return code;\n    }\n\n    const resolvedPrefix =\n      typeof resolvedMode === 'object' ? resolvedMode.prefix : getRootPrefix();\n    const isRootFile =\n      path.resolve(filename) === path.resolve(tailwindRootCss) ||\n      directiveState.hasTailwindImportDirective;\n    const hasTailwindUsage = resolvedPrefix\n      ? directiveState.commentlessCode.includes(`${resolvedPrefix}:`)\n      : false;\n    const shouldAddReference = shouldInject\n      ? shouldInject(code, filename, resolvedPrefix)\n      : hasTailwindUsage && !isRootFile;\n\n    if (!shouldAddReference || !resolvedPrefix) {\n      debugTailwind('skip (no injection needed)', {\n        filename,\n        resolvedPrefix,\n        isRootFile,\n        hasTailwindUsage,\n      });\n      return code;\n    }\n\n    const refPath = toReferenceSpecifier(filename, tailwindRootCss);\n    if (directiveState.hasReferenceText) {\n      throwTailwindReferenceTextError(filename, refPath);\n    }\n\n    debugTailwind('injected @reference', { filename, refPath });\n\n    return `@reference \"${refPath}\";\\n${code}`;\n  };\n\n  function getRootPrefix(): string | null {\n    if (rootPrefix === undefined) {\n      rootPrefix = extractTailwindPrefix(\n        readFileSync(tailwindRootCss, 'utf-8'),\n      );\n    }\n\n    return rootPrefix;\n  }\n}\n\nfunction extractTailwindPrefix(code: string): string | null {\n  const prefixMatch = code.match(\n    /@import\\s+[\"']tailwindcss[\"']\\s+prefix\\(\\s*([^)\\s;]+)\\s*\\)/i,\n  );\n\n  return prefixMatch?.[1]?.trim() ?? null;\n}\n"],"mappings":"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"}

package/src/lib/typed-routes-plugin.d.ts

@@ -0,0 +1,50 @@
+import { type Plugin } from "vite";
+export interface TypedRoutesPluginOptions {
+	/**
+	* Output path for the single generated route module,
+	* relative to the app root.
+	*
+	* @default 'src/routeTree.gen.ts'
+	*/
+	outFile?: string;
+	/**
+	* Workspace root used to resolve additional route/content directories.
+	*
+	* @default process.env['NX_WORKSPACE_ROOT'] ?? process.cwd()
+	*/
+	workspaceRoot?: string;
+	/**
+	* Additional page directories to scan for `.page.ts` files.
+	*/
+	additionalPagesDirs?: string[];
+	/**
+	* Additional content directories to scan for `.md` files.
+	*/
+	additionalContentDirs?: string[];
+	/**
+	* Include generated `routeJsonLdManifest` exports in the generated route file.
+	*
+	* @default true
+	*/
+	jsonLdManifest?: boolean;
+	/**
+	* When true, compare generated output against the existing file and
+	* throw an error if they differ instead of writing. Useful for CI to
+	* detect stale checked-in route files.
+	*
+	* @default false
+	*/
+	verify?: boolean;
+	/**
+	* When true, production builds fail after regenerating a stale checked-in
+	* route file. This preserves self-healing writes in development while making
+	* build-time freshness issues visible by default.
+	*
+	* @default true
+	*/
+	verifyOnBuild?: boolean;
+}
+/**
+* Vite plugin that generates a single typed route module for Analog file routes.
+*/
+export declare function typedRoutes(options?: TypedRoutesPluginOptions): Plugin;

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

@@ -0,0 +1,234 @@
+import { debugTypedRouter } from "./utils/debug.js";
+import { detectSchemaExports, filenameToRoutePath, formatManifestSummary, generateRouteManifest, generateRouteTableDeclaration, generateRouteTreeDeclaration } from "./route-manifest.js";
+import { detectJsonLdModuleExports, extractMarkdownJsonLd, generateJsonLdManifestSource } from "./json-ld-manifest-plugin.js";
+import { createRouteFileDiscovery } from "./route-file-discovery.js";
+import { dirname, join, relative, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { normalizePath } from "vite";
+//#region packages/platform/src/lib/typed-routes-plugin.ts
+var DEFAULT_OUT_FILE = "src/routeTree.gen.ts";
+function resolvePluginOptions(options = {}) {
+	return {
+		outFile: options.outFile ?? DEFAULT_OUT_FILE,
+		workspaceRoot: options.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd(),
+		additionalPagesDirs: options.additionalPagesDirs ?? [],
+		additionalContentDirs: options.additionalContentDirs ?? [],
+		jsonLdManifest: options.jsonLdManifest ?? true,
+		verify: options.verify ?? false,
+		verifyOnBuild: options.verifyOnBuild ?? true
+	};
+}
+/**
+* Vite plugin that generates a single typed route module for Analog file routes.
+*/
+function typedRoutes(options = {}) {
+	const resolvedOptions = resolvePluginOptions(options);
+	const workspaceRoot = normalizePath(resolvedOptions.workspaceRoot);
+	let root = "";
+	let command = "serve";
+	let discovery;
+	function isFreshnessCheck() {
+		return resolvedOptions.verify || command === "build" && resolvedOptions.verifyOnBuild;
+	}
+	function resolveDiscoveredFile(filename) {
+		const fromRoot = join(root, filename);
+		if (existsSync(fromRoot)) return fromRoot;
+		return join(workspaceRoot, filename);
+	}
+	function detectSchemas(relativeFilename) {
+		if (!relativeFilename.endsWith(".ts")) return {
+			hasParamsSchema: false,
+			hasQuerySchema: false
+		};
+		try {
+			return detectSchemaExports(readFileSync(resolveDiscoveredFile(relativeFilename), "utf-8"));
+		} catch {
+			return {
+				hasParamsSchema: false,
+				hasQuerySchema: false
+			};
+		}
+	}
+	/**
+	* Ensures the generated route file is imported from an app entry file
+	* so the module augmentation is always part of the TypeScript program.
+	*/
+	function ensureEntryImport() {
+		const entryFiles = ["src/main.ts", "src/main.server.ts"];
+		function importSpecifierFor(entryFile) {
+			const rel = relative(dirname(entryFile), resolvedOptions.outFile).replace(/\.ts$/, "").replace(/\\/g, "/");
+			return rel.startsWith(".") ? rel : "./" + rel;
+		}
+		for (const entryFile of entryFiles) {
+			const entryPath = join(root, entryFile);
+			if (!existsSync(entryPath)) continue;
+			const content = readFileSync(entryPath, "utf-8");
+			const specifier = importSpecifierFor(entryFile);
+			const escaped = specifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+			if (new RegExp(`import\\s+['"]${escaped}(\\.ts|\\.js)?['"]`).test(content)) return;
+			if (isFreshnessCheck()) return;
+			const importLine = `import '${specifier}';`;
+			const lines = content.split("\n");
+			let lastImportLine = -1;
+			for (let i = 0; i < lines.length; i++) if (/^import\s/.test(lines[i])) lastImportLine = i;
+			if (lastImportLine >= 0) lines.splice(lastImportLine + 1, 0, importLine);
+			else lines.unshift(importLine);
+			writeFileSync(entryPath, lines.join("\n"), "utf-8");
+			console.log(`[analog] Added route tree import to ${entryFile}`);
+			return;
+		}
+		const specifier = importSpecifierFor("src/main.ts");
+		if (isFreshnessCheck()) return;
+		console.warn(`[analog] Could not find an entry file (src/main.ts or src/main.server.ts) to add the route tree import. Add \`import '${specifier}';\` to your app entry file to ensure typed routing is active.`);
+	}
+	function generate() {
+		const routeFiles = discovery.getRouteFiles();
+		const contentFiles = discovery.getContentFiles();
+		debugTypedRouter("discovered files", {
+			routeFiles: routeFiles.length,
+			contentFiles: contentFiles.length
+		});
+		const manifest = generateRouteManifest([...routeFiles, ...contentFiles], detectSchemas, (filename) => discovery.isAppLocal(filename) ? 0 : 1);
+		const declaration = generateRouteTableDeclaration(manifest);
+		const canonicalFiles = new Set(manifest.routes.map((route) => route.filename));
+		const jsonLdEntries = buildJsonLdEntries(resolveDiscoveredFile, routeFiles.filter((filename) => canonicalFiles.has(filename)), contentFiles.filter((filename) => canonicalFiles.has(filename)));
+		const output = combineGeneratedModules(declaration, generateRouteTreeDeclaration(manifest, { jsonLdFiles: jsonLdEntries.map((entry) => entry.sourceFile) }), resolvedOptions.jsonLdManifest && jsonLdEntries.length > 0 ? generateJsonLdManifestSource(jsonLdEntries, resolvedOptions.outFile) : "");
+		const hardCollisions = manifest.collisions.filter((c) => c.samePriority);
+		if (manifest.collisions.length > 0) debugTypedRouter("route collisions", {
+			total: manifest.collisions.length,
+			hard: hardCollisions.length,
+			collisions: manifest.collisions.map((c) => ({
+				path: c.fullPath,
+				kept: c.keptFile,
+				dropped: c.droppedFile
+			}))
+		});
+		if (hardCollisions.length > 0 && command === "build") {
+			const details = hardCollisions.map((c) => `  '${c.fullPath}': '${c.keptFile}' vs '${c.droppedFile}'`).join("\n");
+			throw new Error(`[analog] Route collisions detected during build:\n${details}\n\nEach route path must be defined by exactly one source file. Remove or rename the conflicting files to resolve the collision.`);
+		}
+		if (manifest.routes.length > 0) console.log(formatManifestSummary(manifest));
+		const outPath = join(root, resolvedOptions.outFile);
+		const outDir = dirname(outPath);
+		const hadExistingOutput = existsSync(outPath);
+		if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
+		let existing = "";
+		try {
+			existing = readFileSync(outPath, "utf-8");
+		} catch {}
+		if (output.includes(root)) console.warn(`[analog] Generated route output contains an absolute path prefix (${root}). Route keys and sourceFile values should be workspace-relative.`);
+		const normalizeEndings = (s) => s.replace(/\r\n/g, "\n");
+		if (normalizeEndings(existing) !== normalizeEndings(output)) {
+			debugTypedRouter("route file changed", {
+				outFile: resolvedOptions.outFile,
+				routes: manifest.routes.length,
+				verify: resolvedOptions.verify,
+				verifyOnBuild: resolvedOptions.verifyOnBuild,
+				command
+			});
+			if (resolvedOptions.verify) throw new Error(`[analog] Stale route file detected: ${resolvedOptions.outFile}\nThe checked-in generated route file does not match the current route sources.\nRegenerate route files and commit the updated output.`);
+			writeFileSync(outPath, output, "utf-8");
+			if (command === "build" && resolvedOptions.verifyOnBuild && hadExistingOutput) throw new Error(`[analog] Stale route file detected during build: ${resolvedOptions.outFile}\nThe generated route file was updated to match the current route sources.\nReview the updated output, commit it if it is checked in, and rerun the build.`);
+		}
+	}
+	return {
+		name: "analog-typed-routes",
+		config(config, env) {
+			command = env.command;
+			root = normalizePath(resolve(workspaceRoot, config.root || ".") || ".");
+			discovery = createRouteFileDiscovery({
+				root,
+				workspaceRoot,
+				additionalPagesDirs: resolvedOptions.additionalPagesDirs,
+				additionalContentDirs: resolvedOptions.additionalContentDirs
+			});
+		},
+		buildStart() {
+			generate();
+			if (!isFreshnessCheck()) ensureEntryImport();
+		},
+		configureServer(server) {
+			const regenerate = (path, event) => {
+				if (!discovery.getDiscoveredFileKind(path)) return;
+				debugTypedRouter("watch regenerate", {
+					event,
+					path
+				});
+				discovery.updateDiscoveredFile(path, event);
+				generate();
+			};
+			server.watcher.on("add", (path) => regenerate(path, "add"));
+			server.watcher.on("change", (path) => regenerate(path, "change"));
+			server.watcher.on("unlink", (path) => regenerate(path, "unlink"));
+		}
+	};
+}
+function buildJsonLdEntries(resolveFile, routeFiles, contentFiles) {
+	const entries = [];
+	let importIndex = 0;
+	routeFiles.forEach((filename) => {
+		try {
+			if (!detectJsonLdModuleExports(readFileSync(resolveFile(filename), "utf-8"))) return;
+			entries.push({
+				kind: "module",
+				routePath: filenameToRoutePath(filename),
+				sourceFile: filename,
+				importAlias: `routeModule${importIndex++}`
+			});
+		} catch {}
+	});
+	contentFiles.forEach((filename) => {
+		try {
+			const jsonLd = extractMarkdownJsonLd(readFileSync(resolveFile(filename), "utf-8"));
+			if (jsonLd.length === 0) return;
+			entries.push({
+				kind: "content",
+				routePath: filenameToRoutePath(filename),
+				sourceFile: filename,
+				jsonLd
+			});
+		} catch {}
+	});
+	return entries.sort((a, b) => a.routePath.localeCompare(b.routePath));
+}
+function combineGeneratedModules(...sources) {
+	const imports = [];
+	const seenImports = /* @__PURE__ */ new Set();
+	const bodies = [];
+	for (const source of sources) {
+		const { body, importLines } = splitGeneratedModule(source);
+		for (const importLine of importLines) if (!seenImports.has(importLine)) {
+			seenImports.add(importLine);
+			imports.push(importLine);
+		}
+		if (body.trim()) bodies.push(body.trim());
+	}
+	return [
+		"// This file is auto-generated by @analogjs/platform",
+		"// Do not edit manually",
+		"",
+		...imports.length > 0 ? [...imports, ""] : [],
+		bodies.join("\n\n"),
+		""
+	].join("\n");
+}
+function splitGeneratedModule(source) {
+	const lines = source.split("\n");
+	let index = 0;
+	while (index < lines.length && lines[index].startsWith("//")) index++;
+	while (index < lines.length && lines[index] === "") index++;
+	const importLines = [];
+	while (index < lines.length && lines[index].startsWith("import ")) {
+		importLines.push(lines[index]);
+		index++;
+	}
+	while (index < lines.length && lines[index] === "") index++;
+	return {
+		importLines,
+		body: lines.slice(index).join("\n")
+	};
+}
+//#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 { normalizePath, type Plugin } from 'vite';\nimport { resolve, join, dirname, relative } from 'node:path';\nimport { writeFileSync, mkdirSync, existsSync, readFileSync } from 'node:fs';\n\nimport {\n  generateRouteManifest,\n  generateRouteTableDeclaration,\n  generateRouteTreeDeclaration,\n  detectSchemaExports,\n  formatManifestSummary,\n  filenameToRoutePath,\n} from './route-manifest.js';\nimport type { RouteSchemaInfo } from './route-manifest.js';\nimport {\n  detectJsonLdModuleExports,\n  extractMarkdownJsonLd,\n  generateJsonLdManifestSource,\n  type JsonLdManifestEntry,\n} from './json-ld-manifest-plugin.js';\nimport {\n  createRouteFileDiscovery,\n  type RouteFileDiscovery,\n} from './route-file-discovery.js';\nimport { debugTypedRouter } from './utils/debug.js';\n\nconst DEFAULT_OUT_FILE = 'src/routeTree.gen.ts';\n\nexport interface TypedRoutesPluginOptions {\n  /**\n   * Output path for the single generated route module,\n   * relative to the app root.\n   *\n   * @default 'src/routeTree.gen.ts'\n   */\n  outFile?: string;\n  /**\n   * Workspace root used to resolve additional route/content directories.\n   *\n   * @default process.env['NX_WORKSPACE_ROOT'] ?? process.cwd()\n   */\n  workspaceRoot?: string;\n  /**\n   * Additional page directories to scan for `.page.ts` files.\n   */\n  additionalPagesDirs?: string[];\n  /**\n   * Additional content directories to scan for `.md` files.\n   */\n  additionalContentDirs?: string[];\n  /**\n   * Include generated `routeJsonLdManifest` exports in the generated route file.\n   *\n   * @default true\n   */\n  jsonLdManifest?: boolean;\n  /**\n   * When true, compare generated output against the existing file and\n   * throw an error if they differ instead of writing. Useful for CI to\n   * detect stale checked-in route files.\n   *\n   * @default false\n   */\n  verify?: boolean;\n  /**\n   * When true, production builds fail after regenerating a stale checked-in\n   * route file. This preserves self-healing writes in development while making\n   * build-time freshness issues visible by default.\n   *\n   * @default true\n   */\n  verifyOnBuild?: boolean;\n}\n\nfunction resolvePluginOptions(\n  options: TypedRoutesPluginOptions = {},\n): Required<TypedRoutesPluginOptions> {\n  return {\n    outFile: options.outFile ?? DEFAULT_OUT_FILE,\n    workspaceRoot:\n      options.workspaceRoot ??\n      process.env['NX_WORKSPACE_ROOT'] ??\n      process.cwd(),\n    additionalPagesDirs: options.additionalPagesDirs ?? [],\n    additionalContentDirs: options.additionalContentDirs ?? [],\n    jsonLdManifest: options.jsonLdManifest ?? true,\n    verify: options.verify ?? false,\n    verifyOnBuild: options.verifyOnBuild ?? true,\n  };\n}\n\n/**\n * Vite plugin that generates a single typed route module for Analog file routes.\n */\nexport function typedRoutes(options: TypedRoutesPluginOptions = {}): Plugin {\n  const resolvedOptions = resolvePluginOptions(options);\n  const workspaceRoot = normalizePath(resolvedOptions.workspaceRoot);\n  let root = '';\n  let command: 'build' | 'serve' = 'serve';\n  let discovery: RouteFileDiscovery;\n\n  function isFreshnessCheck(): boolean {\n    return (\n      resolvedOptions.verify ||\n      (command === 'build' && resolvedOptions.verifyOnBuild)\n    );\n  }\n\n  function resolveDiscoveredFile(filename: string): string {\n    const fromRoot = join(root, filename);\n    if (existsSync(fromRoot)) return fromRoot;\n    return join(workspaceRoot, filename);\n  }\n\n  function detectSchemas(relativeFilename: string): RouteSchemaInfo {\n    if (!relativeFilename.endsWith('.ts')) {\n      return { hasParamsSchema: false, hasQuerySchema: false };\n    }\n\n    try {\n      const absPath = resolveDiscoveredFile(relativeFilename);\n      const content = readFileSync(absPath, 'utf-8');\n      return detectSchemaExports(content);\n    } catch {\n      return { hasParamsSchema: false, hasQuerySchema: false };\n    }\n  }\n\n  /**\n   * Ensures the generated route file is imported from an app entry file\n   * so the module augmentation is always part of the TypeScript program.\n   */\n  function ensureEntryImport(): void {\n    const entryFiles = ['src/main.ts', 'src/main.server.ts'];\n\n    // Compute the import specifier relative to the entry file\n    function importSpecifierFor(entryFile: string): string {\n      const rel = relative(dirname(entryFile), resolvedOptions.outFile)\n        .replace(/\\.ts$/, '')\n        .replace(/\\\\/g, '/');\n      return rel.startsWith('.') ? rel : './' + rel;\n    }\n\n    for (const entryFile of entryFiles) {\n      const entryPath = join(root, entryFile);\n      if (!existsSync(entryPath)) continue;\n\n      const content = readFileSync(entryPath, 'utf-8');\n      const specifier = importSpecifierFor(entryFile);\n\n      // Check if any variation of the import already exists\n      const escaped = specifier.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n      const pattern = new RegExp(`import\\\\s+['\"]${escaped}(\\\\.ts|\\\\.js)?['\"]`);\n      if (pattern.test(content)) {\n        return;\n      }\n\n      if (isFreshnessCheck()) {\n        return;\n      }\n\n      // Insert the import after the last existing import line\n      const importLine = `import '${specifier}';`;\n      const lines = content.split('\\n');\n      let lastImportLine = -1;\n\n      for (let i = 0; i < lines.length; i++) {\n        if (/^import\\s/.test(lines[i])) {\n          lastImportLine = i;\n        }\n      }\n\n      if (lastImportLine >= 0) {\n        lines.splice(lastImportLine + 1, 0, importLine);\n      } else {\n        lines.unshift(importLine);\n      }\n\n      writeFileSync(entryPath, lines.join('\\n'), 'utf-8');\n      console.log(`[analog] Added route tree import to ${entryFile}`);\n      return;\n    }\n\n    // No suitable entry file found\n    const specifier = importSpecifierFor('src/main.ts');\n    if (isFreshnessCheck()) {\n      return;\n    }\n    console.warn(\n      `[analog] Could not find an entry file (src/main.ts or src/main.server.ts) ` +\n        `to add the route tree import. Add \\`import '${specifier}';\\` ` +\n        `to your app entry file to ensure typed routing is active.`,\n    );\n  }\n\n  function generate(): void {\n    const routeFiles = discovery.getRouteFiles();\n    const contentFiles = discovery.getContentFiles();\n    debugTypedRouter('discovered files', {\n      routeFiles: routeFiles.length,\n      contentFiles: contentFiles.length,\n    });\n    const allFiles = [...routeFiles, ...contentFiles];\n    const manifest = generateRouteManifest(\n      allFiles,\n      detectSchemas,\n      (filename) => (discovery.isAppLocal(filename) ? 0 : 1),\n    );\n    const declaration = generateRouteTableDeclaration(manifest);\n    const canonicalFiles = new Set(\n      manifest.routes.map((route) => route.filename),\n    );\n    const jsonLdEntries = buildJsonLdEntries(\n      resolveDiscoveredFile,\n      routeFiles.filter((filename) => canonicalFiles.has(filename)),\n      contentFiles.filter((filename) => canonicalFiles.has(filename)),\n    );\n    const routeTree = generateRouteTreeDeclaration(manifest, {\n      jsonLdFiles: jsonLdEntries.map((entry) => entry.sourceFile),\n    });\n    const output = combineGeneratedModules(\n      declaration,\n      routeTree,\n      resolvedOptions.jsonLdManifest && jsonLdEntries.length > 0\n        ? generateJsonLdManifestSource(jsonLdEntries, resolvedOptions.outFile)\n        : '',\n    );\n\n    const hardCollisions = manifest.collisions.filter((c) => c.samePriority);\n    if (manifest.collisions.length > 0) {\n      debugTypedRouter('route collisions', {\n        total: manifest.collisions.length,\n        hard: hardCollisions.length,\n        collisions: manifest.collisions.map((c) => ({\n          path: c.fullPath,\n          kept: c.keptFile,\n          dropped: c.droppedFile,\n        })),\n      });\n    }\n    if (hardCollisions.length > 0 && command === 'build') {\n      const details = hardCollisions\n        .map((c) => `  '${c.fullPath}': '${c.keptFile}' vs '${c.droppedFile}'`)\n        .join('\\n');\n      throw new Error(\n        `[analog] Route collisions detected during build:\\n${details}\\n\\n` +\n          `Each route path must be defined by exactly one source file. ` +\n          `Remove or rename the conflicting files to resolve the collision.`,\n      );\n    }\n\n    if (manifest.routes.length > 0) {\n      console.log(formatManifestSummary(manifest));\n    }\n\n    const outPath = join(root, resolvedOptions.outFile);\n    const outDir = dirname(outPath);\n    const hadExistingOutput = existsSync(outPath);\n\n    if (!existsSync(outDir)) {\n      mkdirSync(outDir, { recursive: true });\n    }\n\n    let existing = '';\n\n    try {\n      existing = readFileSync(outPath, 'utf-8');\n    } catch {\n      // file does not exist yet\n    }\n\n    // Build-time guard: detect absolute path leaks in generated output.\n    // Machine-specific prefixes must never appear in route keys or sourceFile values.\n    if (output.includes(root)) {\n      console.warn(\n        `[analog] Generated route output contains an absolute path prefix (${root}). ` +\n          `Route keys and sourceFile values should be workspace-relative.`,\n      );\n    }\n\n    // Normalize line endings before comparison so that files checked in\n    // with LF don't appear stale on Windows where readFileSync may return CRLF.\n    const normalizeEndings = (s: string) => s.replace(/\\r\\n/g, '\\n');\n    if (normalizeEndings(existing) !== normalizeEndings(output)) {\n      debugTypedRouter('route file changed', {\n        outFile: resolvedOptions.outFile,\n        routes: manifest.routes.length,\n        verify: resolvedOptions.verify,\n        verifyOnBuild: resolvedOptions.verifyOnBuild,\n        command,\n      });\n      if (resolvedOptions.verify) {\n        throw new Error(\n          `[analog] Stale route file detected: ${resolvedOptions.outFile}\\n` +\n            `The checked-in generated route file does not match the current route sources.\\n` +\n            `Regenerate route files and commit the updated output.`,\n        );\n      }\n\n      writeFileSync(outPath, output, 'utf-8');\n\n      if (\n        command === 'build' &&\n        resolvedOptions.verifyOnBuild &&\n        hadExistingOutput\n      ) {\n        throw new Error(\n          `[analog] Stale route file detected during build: ${resolvedOptions.outFile}\\n` +\n            `The generated route file was updated to match the current route sources.\\n` +\n            `Review the updated output, commit it if it is checked in, and rerun the build.`,\n        );\n      }\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: resolvedOptions.additionalPagesDirs,\n        additionalContentDirs: resolvedOptions.additionalContentDirs,\n      });\n    },\n    buildStart() {\n      generate();\n      if (!isFreshnessCheck()) {\n        ensureEntryImport();\n      }\n    },\n    configureServer(server) {\n      const regenerate = (path: string, event: 'add' | 'change' | 'unlink') => {\n        // Reuse the discovery matcher so watch-time updates stay in sync with\n        // the initial scan and don't pull Nitro server routes into routeTree.gen.ts.\n        if (!discovery.getDiscoveredFileKind(path)) {\n          return;\n        }\n\n        debugTypedRouter('watch regenerate', { event, path });\n        discovery.updateDiscoveredFile(path, event);\n        generate();\n      };\n\n      server.watcher.on('add', (path) => regenerate(path, 'add'));\n      server.watcher.on('change', (path) => regenerate(path, 'change'));\n      server.watcher.on('unlink', (path) => regenerate(path, 'unlink'));\n    },\n  };\n}\n\nfunction buildJsonLdEntries(\n  resolveFile: (filename: string) => string,\n  routeFiles: string[],\n  contentFiles: string[],\n): JsonLdManifestEntry[] {\n  const entries: JsonLdManifestEntry[] = [];\n  let importIndex = 0;\n\n  routeFiles.forEach((filename) => {\n    try {\n      const source = readFileSync(resolveFile(filename), 'utf-8');\n      if (!detectJsonLdModuleExports(source)) {\n        return;\n      }\n\n      entries.push({\n        kind: 'module',\n        routePath: filenameToRoutePath(filename),\n        sourceFile: filename,\n        importAlias: `routeModule${importIndex++}`,\n      });\n    } catch {\n      // ignore unreadable route file\n    }\n  });\n\n  contentFiles.forEach((filename) => {\n    try {\n      const source = readFileSync(resolveFile(filename), 'utf-8');\n      const jsonLd = extractMarkdownJsonLd(source);\n\n      if (jsonLd.length === 0) {\n        return;\n      }\n\n      entries.push({\n        kind: 'content',\n        routePath: filenameToRoutePath(filename),\n        sourceFile: filename,\n        jsonLd,\n      });\n    } catch {\n      // ignore unreadable content file\n    }\n  });\n\n  return entries.sort((a, b) => a.routePath.localeCompare(b.routePath));\n}\n\nfunction combineGeneratedModules(...sources: string[]): string {\n  const imports: string[] = [];\n  const seenImports = new Set<string>();\n  const bodies: string[] = [];\n\n  for (const source of sources) {\n    const { body, importLines } = splitGeneratedModule(source);\n    for (const importLine of importLines) {\n      if (!seenImports.has(importLine)) {\n        seenImports.add(importLine);\n        imports.push(importLine);\n      }\n    }\n    if (body.trim()) {\n      bodies.push(body.trim());\n    }\n  }\n\n  return [\n    '// This file is auto-generated by @analogjs/platform',\n    '// Do not edit manually',\n    '',\n    ...(imports.length > 0 ? [...imports, ''] : []),\n    bodies.join('\\n\\n'),\n    '',\n  ].join('\\n');\n}\n\nfunction splitGeneratedModule(source: string): {\n  importLines: string[];\n  body: string;\n} {\n  const lines = source.split('\\n');\n  let index = 0;\n\n  while (index < lines.length && lines[index].startsWith('//')) {\n    index++;\n  }\n\n  while (index < lines.length && lines[index] === '') {\n    index++;\n  }\n\n  const importLines: string[] = [];\n  while (index < lines.length && lines[index].startsWith('import ')) {\n    importLines.push(lines[index]);\n    index++;\n  }\n\n  while (index < lines.length && lines[index] === '') {\n    index++;\n  }\n\n  return {\n    importLines,\n    body: lines.slice(index).join('\\n'),\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;