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

package/src/lib/ssr/inject-html-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-html-plugin.js","names":[],"sources":["../../../../../../packages/platform/src/lib/ssr/inject-html-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { Plugin } from 'vite';\nimport { readFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\nfunction eventReplayPlugin(): Plugin {\n  return {\n    name: 'analogjs-event-replay-plugin',\n    async transformIndexHtml() {\n      const eventReplayScript = await readFile(\n        require.resolve('@angular/core/event-dispatch-contract.min.js'),\n        'utf-8',\n      );\n\n      return [\n        {\n          tag: 'script',\n          attrs: {\n            type: 'text/javascript',\n            id: 'ng-event-dispatch-contract',\n          },\n          children: eventReplayScript,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n}\n\nexport function injectHTMLPlugin(): Plugin[] {\n  const hasEventReplay = Number(VERSION.major) >= 18;\n\n  return hasEventReplay ? [eventReplayPlugin()] : [];\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,SAAS,oBAA4B;AACnC,QAAO;EACL,MAAM;EACN,MAAM,qBAAqB;AAMzB,UAAO,CACL;IACE,KAAK;IACL,OAAO;KACL,MAAM;KACN,IAAI;KACL;IACD,UAZsB,MAAM,SAC9B,QAAQ,QAAQ,+CAA+C,EAC/D,QACD;IAUG,UAAU;IACX,CACF;;EAEJ;;AAGH,SAAgB,mBAA6B;AAG3C,QAFuB,OAAO,QAAQ,MAAM,IAAI,KAExB,CAAC,mBAAmB,CAAC,GAAG,EAAE"}
+{"version":3,"file":"inject-html-plugin.js","names":[],"sources":["../../../../src/lib/ssr/inject-html-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { Plugin } from 'vite';\nimport { readFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\nfunction eventReplayPlugin(): Plugin {\n  return {\n    name: 'analogjs-event-replay-plugin',\n    async transformIndexHtml() {\n      const eventReplayScript = await readFile(\n        require.resolve('@angular/core/event-dispatch-contract.min.js'),\n        'utf-8',\n      );\n\n      return [\n        {\n          tag: 'script',\n          attrs: {\n            type: 'text/javascript',\n            id: 'ng-event-dispatch-contract',\n          },\n          children: eventReplayScript,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n}\n\nexport function injectHTMLPlugin(): Plugin[] {\n  const hasEventReplay = Number(VERSION.major) >= 18;\n\n  return hasEventReplay ? [eventReplayPlugin()] : [];\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,SAAS,oBAA4B;AACnC,QAAO;EACL,MAAM;EACN,MAAM,qBAAqB;AAMzB,UAAO,CACL;IACE,KAAK;IACL,OAAO;KACL,MAAM;KACN,IAAI;KACL;IACD,UAZsB,MAAM,SAC9B,QAAQ,QAAQ,+CAA+C,EAC/D,QACD;IAUG,UAAU;IACX,CACF;;EAEJ;;AAGH,SAAgB,mBAA6B;AAG3C,QAFuB,OAAO,QAAQ,MAAM,IAAI,KAExB,CAAC,mBAAmB,CAAC,GAAG,EAAE"}

package/src/lib/ssr/ssr-build-plugin.d.ts

@@ -1,18 +1,26 @@
-import * as vite from 'vite';
+import * as vite from "vite";
 /**
- * SSR build patches for Angular platform-server, Zone.js, and Domino.
- *
- * Returns an array of Vite plugins because under Vite 8+ (Rolldown) we
- * append Rolldown's built-in `replacePlugin` for an AST-safe
- * `global → globalThis` rewrite that avoids false positives inside string
- * literals and comments.
- *
- * **Why each patch exists:**
- * - zone-node: removes a `const global = globalThis` alias that shadows the
- *   real global in strict mode.
- * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
- *   replaces bare `global` references with `globalThis`.
- * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
- * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
- */
+* SSR build patches for Angular platform-server, Zone.js, and Domino.
+*
+* **Why each patch exists:**
+* - zone-node: removes a `const global = globalThis` alias that shadows the
+*   real global in strict mode.
+* - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
+*   replaces bare `global` references with `globalThis`.
+* - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
+* - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
+*/
 export declare function ssrBuildPlugin(): vite.Plugin[];
+/**
+* Vite plugin that patches `@angular/core`'s `getComponentId()` to
+* mirror every compiled component definition to a global Set, bypassing
+* the `ngServerMode` guard that normally prevents registration on the
+* server. The set lives at `globalThis.__ngComponentDefs` and is read by
+* `@analogjs/router`'s SSR render function to null cached `tView`
+* objects between requests so that `$localize` tagged templates in
+* `consts()` re-evaluate with the freshly loaded translations.
+*
+* Only active when the platform's `i18n` option is configured.
+* Only transforms `@angular/core` modules in SSR builds.
+*/
+export declare function i18nDefRegistryPlugin(): Plugin;

package/src/lib/ssr/ssr-build-plugin.js

@@ -1,14 +1,8 @@
 import * as vite from "vite";
-import { createRequire } from "node:module";
 //#region packages/platform/src/lib/ssr/ssr-build-plugin.ts
 /**
 * SSR build patches for Angular platform-server, Zone.js, and Domino.
 *
-* Returns an array of Vite plugins because under Vite 8+ (Rolldown) we
-* append Rolldown's built-in `replacePlugin` for an AST-safe
-* `global → globalThis` rewrite that avoids false positives inside string
-* literals and comments.
-*
 * **Why each patch exists:**
 * - zone-node: removes a `const global = globalThis` alias that shadows the
 *   real global in strict mode.
@@ -18,7 +12,7 @@ import { createRequire } from "node:module";
 * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
 */
 function ssrBuildPlugin() {
-	const plugins = [{
+	return [{
 		name: "analogjs-ssr-build-plugin",
 		apply: "build",
 		config() {
@@ -30,7 +24,7 @@ function ssrBuildPlugin() {
 				if (id.includes("zone-node") && code.includes("const global = globalThis;")) return { code: code.replace("const global = globalThis;", "") };
 				if (id.includes("platform-server")) {
 					let result = code.replace("new xhr2.XMLHttpRequest", "new (xhr2.default.XMLHttpRequest || xhr2.default)");
-					if (!vite.rolldownVersion) result = result.replaceAll("global.", "globalThis.").replaceAll("global,", "globalThis,").replaceAll(" global[", " globalThis[");
+					result = result.replaceAll("global.", "globalThis.").replaceAll("global,", "globalThis,").replaceAll(" global[", " globalThis[");
 					return { code: result };
 				}
 				if (id.includes(vite.normalizePath("xhr2.js"))) return { code: code.replace("os.type()", `''`).replace("os.arch()", `''`).replace("process.versions.node", `'node'`).replace("process.versions.v8", `'v8'`) };
@@ -38,16 +32,6 @@ function ssrBuildPlugin() {
 			}
 		}
 	}];
-	if (vite.rolldownVersion) {
-		const require = createRequire(import.meta.url);
-		const { replacePlugin } = require("rolldown/plugins");
-		const { withFilter } = require("rolldown/filter");
-		plugins.push(withFilter(replacePlugin({ global: "globalThis" }, {
-			preventAssignment: true,
-			objectGuards: true
-		}), { transform: { id: /platform-server/ } }));
-	}
-	return plugins;
 }
 //#endregion
 export { ssrBuildPlugin };

package/src/lib/ssr/ssr-build-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-build-plugin.js","names":[],"sources":["../../../../../../packages/platform/src/lib/ssr/ssr-build-plugin.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport * as vite from 'vite';\n\n/**\n * SSR build patches for Angular platform-server, Zone.js, and Domino.\n *\n * Returns an array of Vite plugins because under Vite 8+ (Rolldown) we\n * append Rolldown's built-in `replacePlugin` for an AST-safe\n * `global → globalThis` rewrite that avoids false positives inside string\n * literals and comments.\n *\n * **Why each patch exists:**\n * - zone-node: removes a `const global = globalThis` alias that shadows the\n *   real global in strict mode.\n * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and\n *   replaces bare `global` references with `globalThis`.\n * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.\n * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.\n */\nexport function ssrBuildPlugin(): vite.Plugin[] {\n  const plugins: vite.Plugin[] = [\n    {\n      name: 'analogjs-ssr-build-plugin',\n      apply: 'build',\n      config() {\n        return {\n          ssr: {\n            noExternal: ['xhr2'],\n          },\n        };\n      },\n      transform: {\n        filter: {\n          id: /zone-node|platform-server|xhr2\\.js|domino\\/lib\\/sloppy\\.js/,\n        },\n        handler(code, id) {\n          if (\n            id.includes('zone-node') &&\n            code.includes('const global = globalThis;')\n          ) {\n            return {\n              code: code.replace('const global = globalThis;', ''),\n            };\n          }\n\n          if (id.includes('platform-server')) {\n            let result = code.replace(\n              'new xhr2.XMLHttpRequest',\n              'new (xhr2.default.XMLHttpRequest || xhr2.default)',\n            );\n\n            // Under Vite 8+ the appended `replacePlugin` handles\n            // global → globalThis via AST-aware replacement (scoped to\n            // platform-server by `withFilter`).  For Vite ≤7 we fall back\n            // to text-based replaceAll — imprecise but sufficient for the\n            // known occurrences in @angular/platform-server bundles.\n            if (!vite.rolldownVersion) {\n              result = result\n                .replaceAll('global.', 'globalThis.')\n                .replaceAll('global,', 'globalThis,')\n                .replaceAll(' global[', ' globalThis[');\n            }\n\n            return { code: result };\n          }\n\n          if (id.includes(vite.normalizePath('xhr2.js'))) {\n            return {\n              code: code\n                .replace('os.type()', `''`)\n                .replace('os.arch()', `''`)\n                .replace('process.versions.node', `'node'`)\n                .replace('process.versions.v8', `'v8'`),\n            };\n          }\n\n          if (id.includes(vite.normalizePath('domino/lib/sloppy.js'))) {\n            return {\n              code: code.replace(/with\\(/gi, 'if('),\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n\n  // Under Vite 8+ (Rolldown), append Rolldown's built-in `replacePlugin`\n  // for AST-aware `global → globalThis` rewriting scoped to platform-server.\n  //\n  // `createRequire` is used instead of dynamic `import()` because this code\n  // runs synchronously during plugin construction (not inside an async hook).\n  // Rolldown is guaranteed to be installed when `vite.rolldownVersion` is truthy.\n  if (vite.rolldownVersion) {\n    const require = createRequire(import.meta.url);\n    const { replacePlugin } =\n      require('rolldown/plugins') as typeof import('rolldown/plugins');\n    const { withFilter } =\n      require('rolldown/filter') as typeof import('rolldown/filter');\n\n    plugins.push(\n      withFilter(\n        replacePlugin(\n          { global: 'globalThis' },\n          { preventAssignment: true, objectGuards: true },\n        ),\n        { transform: { id: /platform-server/ } },\n      ) as unknown as vite.Plugin,\n    );\n  }\n\n  return plugins;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,iBAAgC;CAC9C,MAAM,UAAyB,CAC7B;EACE,MAAM;EACN,OAAO;EACP,SAAS;AACP,UAAO,EACL,KAAK,EACH,YAAY,CAAC,OAAO,EACrB,EACF;;EAEH,WAAW;GACT,QAAQ,EACN,IAAI,8DACL;GACD,QAAQ,MAAM,IAAI;AAChB,QACE,GAAG,SAAS,YAAY,IACxB,KAAK,SAAS,6BAA6B,CAE3C,QAAO,EACL,MAAM,KAAK,QAAQ,8BAA8B,GAAG,EACrD;AAGH,QAAI,GAAG,SAAS,kBAAkB,EAAE;KAClC,IAAI,SAAS,KAAK,QAChB,2BACA,oDACD;AAOD,SAAI,CAAC,KAAK,gBACR,UAAS,OACN,WAAW,WAAW,cAAc,CACpC,WAAW,WAAW,cAAc,CACpC,WAAW,YAAY,eAAe;AAG3C,YAAO,EAAE,MAAM,QAAQ;;AAGzB,QAAI,GAAG,SAAS,KAAK,cAAc,UAAU,CAAC,CAC5C,QAAO,EACL,MAAM,KACH,QAAQ,aAAa,KAAK,CAC1B,QAAQ,aAAa,KAAK,CAC1B,QAAQ,yBAAyB,SAAS,CAC1C,QAAQ,uBAAuB,OAAO,EAC1C;AAGH,QAAI,GAAG,SAAS,KAAK,cAAc,uBAAuB,CAAC,CACzD,QAAO,EACL,MAAM,KAAK,QAAQ,YAAY,MAAM,EACtC;;GAKN;EACF,CACF;AAQD,KAAI,KAAK,iBAAiB;EACxB,MAAM,UAAU,cAAc,OAAO,KAAK,IAAI;EAC9C,MAAM,EAAE,kBACN,QAAQ,mBAAmB;EAC7B,MAAM,EAAE,eACN,QAAQ,kBAAkB;AAE5B,UAAQ,KACN,WACE,cACE,EAAE,QAAQ,cAAc,EACxB;GAAE,mBAAmB;GAAM,cAAc;GAAM,CAChD,EACD,EAAE,WAAW,EAAE,IAAI,mBAAmB,EAAE,CACzC,CACF;;AAGH,QAAO"}
+{"version":3,"file":"ssr-build-plugin.js","names":[],"sources":["../../../../src/lib/ssr/ssr-build-plugin.ts"],"sourcesContent":["import * as vite from 'vite';\n\n/**\n * SSR build patches for Angular platform-server, Zone.js, and Domino.\n *\n * **Why each patch exists:**\n * - zone-node: removes a `const global = globalThis` alias that shadows the\n *   real global in strict mode.\n * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and\n *   replaces bare `global` references with `globalThis`.\n * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.\n * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.\n */\nexport function ssrBuildPlugin(): vite.Plugin[] {\n  const plugins: vite.Plugin[] = [\n    {\n      name: 'analogjs-ssr-build-plugin',\n      apply: 'build',\n      config() {\n        return {\n          ssr: {\n            noExternal: ['xhr2'],\n          },\n        };\n      },\n      transform: {\n        filter: {\n          id: /zone-node|platform-server|xhr2\\.js|domino\\/lib\\/sloppy\\.js/,\n        },\n        handler(code, id) {\n          if (\n            id.includes('zone-node') &&\n            code.includes('const global = globalThis;')\n          ) {\n            return {\n              code: code.replace('const global = globalThis;', ''),\n            };\n          }\n\n          if (id.includes('platform-server')) {\n            let result = code.replace(\n              'new xhr2.XMLHttpRequest',\n              'new (xhr2.default.XMLHttpRequest || xhr2.default)',\n            );\n\n            // Narrowly scoped text replacement of the bare `global`\n            // identifier. Matching `global.`, `global,` and ` global[`\n            // targets the known occurrences in the @angular/platform-server\n            // bundle while leaving strings, comments and asset paths that\n            // merely contain the word `global` untouched (see #2426).\n            result = result\n              .replaceAll('global.', 'globalThis.')\n              .replaceAll('global,', 'globalThis,')\n              .replaceAll(' global[', ' globalThis[');\n\n            return { code: result };\n          }\n\n          if (id.includes(vite.normalizePath('xhr2.js'))) {\n            return {\n              code: code\n                .replace('os.type()', `''`)\n                .replace('os.arch()', `''`)\n                .replace('process.versions.node', `'node'`)\n                .replace('process.versions.v8', `'v8'`),\n            };\n          }\n\n          if (id.includes(vite.normalizePath('domino/lib/sloppy.js'))) {\n            return {\n              code: code.replace(/with\\(/gi, 'if('),\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n\n  return plugins;\n}\n\n/**\n * Vite plugin that patches `@angular/core`'s `getComponentId()` to\n * mirror every compiled component definition to a global Set, bypassing\n * the `ngServerMode` guard that normally prevents registration on the\n * server. The set lives at `globalThis.__ngComponentDefs` and is read by\n * `@analogjs/router`'s SSR render function to null cached `tView`\n * objects between requests so that `$localize` tagged templates in\n * `consts()` re-evaluate with the freshly loaded translations.\n *\n * Only active when the platform's `i18n` option is configured.\n * Only transforms `@angular/core` modules in SSR builds.\n */\nexport function i18nDefRegistryPlugin(): Plugin {\n  const DETECT_MARKER = 'GENERATED_COMP_IDS.set(compId, componentDef.type);';\n  const RETURN_STMT = 'return compId;\\n}';\n\n  return {\n    name: 'analogjs-i18n-def-registry',\n    enforce: 'post',\n\n    transform: {\n      filter: {\n        id: /\\/@angular\\/core\\//,\n      },\n      handler(code, id, options) {\n        if (!options?.ssr) return;\n        if (!code.includes(DETECT_MARKER)) return;\n\n        return {\n          code: code.replace(\n            RETURN_STMT,\n            '(globalThis.__ngComponentDefs ??= new Set()).add(componentDef);\\n' +\n              RETURN_STMT,\n          ),\n        };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,iBAAgC;AAmE9C,QAlE+B,CAC7B;EACE,MAAM;EACN,OAAO;EACP,SAAS;AACP,UAAO,EACL,KAAK,EACH,YAAY,CAAC,OAAO,EACrB,EACF;;EAEH,WAAW;GACT,QAAQ,EACN,IAAI,8DACL;GACD,QAAQ,MAAM,IAAI;AAChB,QACE,GAAG,SAAS,YAAY,IACxB,KAAK,SAAS,6BAA6B,CAE3C,QAAO,EACL,MAAM,KAAK,QAAQ,8BAA8B,GAAG,EACrD;AAGH,QAAI,GAAG,SAAS,kBAAkB,EAAE;KAClC,IAAI,SAAS,KAAK,QAChB,2BACA,oDACD;AAOD,cAAS,OACN,WAAW,WAAW,cAAc,CACpC,WAAW,WAAW,cAAc,CACpC,WAAW,YAAY,eAAe;AAEzC,YAAO,EAAE,MAAM,QAAQ;;AAGzB,QAAI,GAAG,SAAS,KAAK,cAAc,UAAU,CAAC,CAC5C,QAAO,EACL,MAAM,KACH,QAAQ,aAAa,KAAK,CAC1B,QAAQ,aAAa,KAAK,CAC1B,QAAQ,yBAAyB,SAAS,CAC1C,QAAQ,uBAAuB,OAAO,EAC1C;AAGH,QAAI,GAAG,SAAS,KAAK,cAAc,uBAAuB,CAAC,CACzD,QAAO,EACL,MAAM,KAAK,QAAQ,YAAY,MAAM,EACtC;;GAKN;EACF,CACF"}

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;