fix(analog): use the Vite root for routes and build meta in Nx workspaces

The Routes tab, get-routes and the Dashboard SSR and Analog fields
resolved the Analog app from the working directory, so in an Nx
workspace with several Analog apps they described the first app under
apps/ instead of the one Vite serves. They now share the Vite root
with the Analog tab through servedAnalogRoot().

Author: erkamyaman

apps/docs/src/content/inspectors/analog.md

@@ -96,7 +96,7 @@ Checks grouped by rule, each with a fix:
 ### Supported layouts
 
 - **Single app**: `package.json`, `vite.config.ts` and `src/app/pages` in one folder. The build output is read from `dist/analog/public`.
-- **Nx workspace**: the app lives in `apps/<name>` and `package.json` sits at the workspace root. The scan uses the Vite root, or the first folder under `apps/` whose `vite.config` calls `analog()` when the tools run from the workspace root. `package.json` is looked up from the app folder upward, and the build output is read from `dist/apps/<name>/analog/public`.
+- **Nx workspace**: the app lives in `apps/<name>` and `package.json` sits at the workspace root. The scan uses the Vite root, or the first folder under `apps/` whose `vite.config` calls `analog()` when the tools run from the workspace root. The **Routes** tab, `get-routes` and the **SSR** and **Analog** fields on the **Dashboard** read the same app, so they match this tab. `package.json` is looked up from the app folder upward, and the build output is read from `dist/apps/<name>/analog/public`.
 
 ### Render mode rules
 

packages/ng-devtools/src/__tests__/analog-scan.test.ts

@@ -9,10 +9,14 @@ import {
   frontmatter,
   lintAnalog,
   scanAnalog,
+  servedAnalogRoot,
+  setAnalogRoot,
   toRawPath,
   toSegment,
 } from '../rpc/analog-scan.ts';
+import { getBuildMeta } from '../rpc/build-meta.ts';
 import { extractRoutes } from '../rpc/get-routes.ts';
+import { scan } from '../rpc/__tests__/scan.ts';
 import { BASE_FILES, BROKEN_FILES, makeProject } from './analog-fixture.ts';
 
 describe('Analog route rules', () => {
@@ -219,6 +223,33 @@ describe('Analog route rules', () => {
     );
   });
 
+  it('uses the Vite root for every surface when an Nx workspace has several Analog apps', async () => {
+    const { 'package.json': pkg, ...app } = BASE_FILES;
+    const inApp = (name: string) =>
+      Object.fromEntries(Object.entries(app).map(([file, text]) => [`apps/${name}/${file}`, text]));
+    const ws = makeProject(
+      {
+        'package.json': pkg,
+        'nx.json': '{}',
+        'apps/blog/src/app/pages/blog-only.page.ts': app['src/app/pages/index.page.ts']!,
+        'apps/blog/vite.config.ts': `import analog from '@analogjs/platform';\nexport default { plugins: [analog({ ssr: false })] };\n`,
+      },
+      inApp('shop'),
+    );
+    const shop = join(ws, 'apps/shop');
+    setAnalogRoot(shop);
+    try {
+      expect(servedAnalogRoot(ws)).toBe(shop);
+      const files = extractRoutes(ws).map((r) => r.file);
+      expect(files).toContain('apps/shop/src/app/pages/(marketing)/pricing.page.ts');
+      expect(files.some((file) => file.startsWith('apps/blog/'))).toBe(false);
+      expect(await scan(getBuildMeta, ws)).toMatchObject({ ssr: true, analog: '2.7.5' });
+    } finally {
+      setAnalogRoot(undefined);
+    }
+    expect(servedAnalogRoot(ws)).toBe(join(ws, 'apps/blog'));
+  });
+
   it('does not treat a plain Angular app as Analog because the workspace root installs Analog', () => {
     const { 'package.json': pkg, ...app } = BASE_FILES;
     const ws = makeProject(

packages/ng-devtools/src/rpc/analog-register.ts

@@ -7,7 +7,7 @@ import {
   recentCalls,
   type AnalogCall,
 } from '../analog-server-log.ts';
-import { explainUrl, scanAnalog, type AnalogProject } from './analog-scan.ts';
+import { explainUrl, scanAnalog, servedAnalogRoot, type AnalogProject } from './analog-scan.ts';
 import {
   analogApiRoutesText,
   analogContentText,
@@ -36,7 +36,6 @@ const PAGE_TTL_MS = 15_000;
 
 let disposeAnalog: (() => void) | undefined;
 let analogOwner: unknown;
-let viteRoot: string | undefined;
 
 interface Scoped {
   rpc: {
@@ -105,10 +104,6 @@ export async function callApi(request: ApiRequest, origin = devOrigin()): Promis
   }
 }
 
-export function setAnalogRoot(root: string | undefined) {
-  viteRoot = root;
-}
-
 export function stopAnalog(owner?: unknown) {
   if (owner !== undefined && owner !== analogOwner) return;
   disposeAnalog?.();
@@ -165,7 +160,7 @@ export async function registerAnalog(
   let cache: { at: number; project: AnalogProject } | null = null;
   const project = () => {
     if (!cache || Date.now() - cache.at > SCAN_CACHE_MS) {
-      cache = { at: Date.now(), project: scanAnalog(viteRoot ?? ctx.cwd) };
+      cache = { at: Date.now(), project: scanAnalog(servedAnalogRoot(ctx.cwd)) };
     }
     return cache.project;
   };

packages/ng-devtools/src/rpc/analog-scan.ts

@@ -491,6 +491,16 @@ function hasAnalogConfig(dir: string): boolean {
   return !!file && /\banalog\s*\(/.test(stripComments(read(join(dir, file))));
 }
 
+let viteRoot: string | undefined;
+
+export function setAnalogRoot(root: string | undefined) {
+  viteRoot = root;
+}
+
+export function servedAnalogRoot(cwd: string): string {
+  return analogRoot(viteRoot ?? cwd);
+}
+
 export function analogRoot(cwd: string): string {
   if (existsSync(join(cwd, 'src/app/pages')) || hasAnalogConfig(cwd)) return cwd;
   let names: string[];

packages/ng-devtools/src/rpc/build-meta.ts

@@ -4,7 +4,7 @@ import { describable } from './agent-schema.ts';
 import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
-import { analogConfig, analogRoot, analogVersion } from './analog-scan.ts';
+import { analogConfig, analogVersion, servedAnalogRoot } from './analog-scan.ts';
 
 const BuildMetaSchema = v.object({
   angularVersion: v.string(),
@@ -37,7 +37,7 @@ export const getBuildMeta = defineRpcFunction({
         installedVersion(ctx.cwd, 'typescript') ?? versionFromRange(deps['typescript']);
 
       const project = mainProject(ctx.cwd);
-      const app = analogRoot(ctx.cwd);
+      const app = servedAnalogRoot(ctx.cwd);
       const analog = analogVersion(app);
       return {
         angularVersion,

packages/ng-devtools/src/rpc/get-routes.ts

@@ -1,7 +1,7 @@
 import { defineRpcFunction } from 'devframe';
 import * as v from 'valibot';
 import { describable } from './agent-schema.ts';
-import { analogRoot, analogVersion, buildRoutes, flattenRoutes } from './analog-scan.ts';
+import { analogVersion, buildRoutes, flattenRoutes, servedAnalogRoot } from './analog-scan.ts';
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { dirname, isAbsolute, join, relative } from 'node:path';
 import {
@@ -47,7 +47,7 @@ export const getRoutes = defineRpcFunction({
 });
 
 export function extractRoutes(cwd: string): ExtractedRoute[] {
-  const app = analogRoot(cwd);
+  const app = servedAnalogRoot(cwd);
   const routes: ExtractedRoute[] = analogVersion(app) ? analogRoutes(app, cwd) : [];
   const files: string[] = [];
   for (const root of sourceRoots(cwd)) {

packages/ng-devtools/src/vite.ts

@@ -6,8 +6,8 @@ import type { WsOriginRegistry } from 'devframe/rpc/transports/ws-server';
 import { isLoopbackHostname } from 'devframe/utils/origin';
 import { NG_DEVTOOLS_HUB_BASE, initNgDevtoolsHub } from './hub.ts';
 import { analogMiddleware, setDevOrigin } from './analog-server-log.ts';
-import { analogConfig } from './rpc/analog-scan.ts';
-import { setAnalogRoot, stopAnalog } from './rpc/analog-register.ts';
+import { analogConfig, setAnalogRoot } from './rpc/analog-scan.ts';
+import { stopAnalog } from './rpc/analog-register.ts';
 import { httpRegistry } from './http-rules.ts';
 import { pickNgDevtoolsConfig, resolveNgDevtoolsConfig, type NgDevtoolsConfig } from './config.ts';