@analogjs/platform 3.0.0-alpha.23 → 3.0.0-alpha.25

package/src/lib/router-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"router-plugin.js","names":[],"sources":["../../../src/lib/router-plugin.ts"],"sourcesContent":["import { normalizePath, Plugin, UserConfig, ViteDevServer } from 'vite';\nimport { globSync } from 'tinyglobby';\nimport { isAbsolute, relative, resolve } from 'node:path';\n\nimport { Options } from './options.js';\n\n/**\n * Router plugin that handles route file discovery and hot module replacement.\n *\n * This plugin provides three main functionalities:\n * 1. Route invalidation when files are added/deleted (HMR workaround)\n * 2. Dynamic route file discovery and import generation\n * 3. Content route file discovery for markdown and Analog content\n *\n * @param options Configuration options for the router plugin\n * @returns Array of Vite plugins for route handling\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key behavior with { dot: true, absolute: true }:\n * - Returns absolute paths for ALL discovered files\n * - Path normalization is required to match expected output format\n * - Files within project root must use relative paths in object keys\n * - Files outside project root keep absolute paths in object keys\n */\nexport function routerPlugin(options?: Options): Plugin[] {\n  const workspaceRoot = normalizePath(\n    options?.workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd(),\n  );\n  let config: UserConfig;\n  let root: string;\n  // Option dirs are workspace-relative, often written with a leading `/`.\n  // Normalize them once into absolute workspace paths so watcher events,\n  // glob patterns, and key generation all compare against the same shape.\n  const normalizeWatchedDir = (dir: string) => {\n    const normalizedDir = normalizePath(\n      dir.startsWith(`${workspaceRoot}/`) || dir === workspaceRoot\n        ? dir\n        : dir.startsWith('/')\n          ? `${workspaceRoot}${dir}`\n          : resolve(workspaceRoot, dir),\n    );\n    return normalizedDir.endsWith('/')\n      ? normalizedDir.slice(0, -1)\n      : normalizedDir;\n  };\n  // Computed eagerly — these depend only on `options` and `workspaceRoot`,\n  // both of which are fixed at construction time.\n  const additionalPagesDirs = (options?.additionalPagesDirs || []).map((dir) =>\n    normalizeWatchedDir(dir),\n  );\n  const additionalContentDirs = (options?.additionalContentDirs || []).map(\n    (dir) => normalizeWatchedDir(dir),\n  );\n  // Returns every directory that can contain route-like files. The root-\n  // relative entries are only available after the Vite `config` hook sets\n  // `root`. The short-form fallbacks (`/app/routes`, etc.) let watcher\n  // events match before `config` runs — they cover the common convention\n  // where paths start with these prefixes.\n  const getRouteLikeDirs = () => [\n    ...(root\n      ? [\n          normalizeWatchedDir(`${root}/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/pages`),\n          normalizeWatchedDir(`${root}/src/content`),\n        ]\n      : []),\n    '/app/routes',\n    '/src/app/routes',\n    '/src/app/pages',\n    '/src/content',\n    ...additionalPagesDirs,\n    ...additionalContentDirs,\n  ];\n  // These lists are used repeatedly by transform hooks during serve. Keeping\n  // them warm avoids a full glob on every route/content invalidation.\n  let routeFilesCache: string[] | undefined;\n  let contentRouteFilesCache: string[] | undefined;\n  let endpointFilesCache: string[] | undefined;\n  const isRouteLikeFile = (path: string) => {\n    // Watcher paths from chokidar are already absolute — `normalizePath`\n    // (forward-slash only) is sufficient; `resolve()` would be a no-op.\n    const normalizedPath = normalizePath(path);\n\n    return getRouteLikeDirs().some(\n      (dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`),\n    );\n  };\n  const discoverRouteFiles = () => {\n    routeFilesCache ??= globSync(\n      [\n        `${root}/app/routes/**/*.ts`,\n        `${root}/src/app/routes/**/*.ts`,\n        `${root}/src/app/pages/**/*.page.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.page.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return routeFilesCache;\n  };\n  const discoverContentRouteFiles = () => {\n    contentRouteFilesCache ??= globSync(\n      [\n        `${root}/src/app/routes/**/*.md`,\n        `${root}/src/app/pages/**/*.md`,\n        `${root}/src/content/**/*.md`,\n        ...additionalContentDirs.map((dir) => `${dir}/**/*.md`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return contentRouteFilesCache;\n  };\n  const discoverEndpointFiles = () => {\n    endpointFilesCache ??= globSync(\n      [\n        `${root}/src/app/pages/**/*.server.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.server.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return endpointFilesCache;\n  };\n  const invalidateDiscoveryCaches = () => {\n    routeFilesCache = undefined;\n    contentRouteFilesCache = undefined;\n    endpointFilesCache = undefined;\n  };\n  const getModuleKey = (module: string) => {\n    // Before config sets `root`, fall back to workspace-relative keys.\n    if (!root) {\n      return `/${normalizePath(relative(workspaceRoot, module))}`;\n    }\n\n    const relToRoot = normalizePath(relative(root, module));\n    // Use true path containment instead of a raw prefix check so siblings like\n    // `/apps/my-app-tools/...` are not mistaken for files inside `/apps/my-app`.\n    const isInRoot = !relToRoot.startsWith('..') && !isAbsolute(relToRoot);\n\n    if (isInRoot) {\n      return `/${relToRoot}`;\n    }\n\n    return `/${normalizePath(relative(workspaceRoot, module))}`;\n  };\n  const invalidateFileModules = (server: ViteDevServer, path: string) => {\n    const normalizedPath = normalizePath(path);\n    // A newly added page can be discovered before its final contents settle.\n    // Invalidate the page module itself so later edits don't keep serving the\n    // first incomplete transform from Vite's module graph.\n    const fileModules =\n      server.moduleGraph.getModulesByFile?.(normalizedPath) ??\n      server.moduleGraph.fileToModulesMap.get(normalizedPath);\n\n    fileModules?.forEach((mod) => {\n      server.moduleGraph.invalidateModule(mod);\n\n      mod.importers.forEach((imp) => {\n        server.moduleGraph.invalidateModule(imp);\n      });\n    });\n  };\n\n  return [\n    {\n      name: 'analogjs-router-invalidate-routes',\n      configureServer(server) {\n        /**\n         * Invalidates route modules when files are added or deleted.\n         * This is a workaround for Vite's HMR limitations with dynamic imports.\n         *\n         * @param path The file path that was added or deleted\n         */\n        function invalidateRoutes(\n          path: string,\n          event: 'add' | 'change' | 'unlink',\n        ) {\n          if (!isRouteLikeFile(path)) {\n            return;\n          }\n\n          // Add/remove changes the route graph shape, so the discovery caches\n          // must be rebuilt. Plain edits can keep using the current file set.\n          if (event !== 'change') {\n            invalidateDiscoveryCaches();\n          }\n\n          invalidateFileModules(server, path);\n\n          // For an in-place edit we only need module invalidation. Keeping the\n          // app alive here lets Angular/Vite attempt the narrower HMR path.\n          if (event === 'change') {\n            return;\n          }\n\n          server.moduleGraph.fileToModulesMap.forEach((mods) => {\n            mods.forEach((mod) => {\n              if (mod.id?.includes('analogjs') && mod.id?.includes('fesm')) {\n                server.moduleGraph.invalidateModule(mod);\n\n                mod.importers.forEach((imp) => {\n                  server.moduleGraph.invalidateModule(imp);\n                });\n              }\n            });\n          });\n\n          server.ws.send({\n            type: 'full-reload',\n          });\n        }\n\n        server.watcher.on('add', (path) => invalidateRoutes(path, 'add'));\n        server.watcher.on('change', (path) => invalidateRoutes(path, 'change'));\n        server.watcher.on('unlink', (path) => invalidateRoutes(path, 'unlink'));\n\n        // Vite's watcher only covers the app root by default.\n        // additionalPagesDirs / additionalContentDirs live outside the\n        // root (e.g. libs/shared/feature in a monorepo), so file\n        // add/rename/delete events are never fired for them.  Explicitly\n        // add these directories to chokidar so route invalidation works.\n        for (const dir of [...additionalPagesDirs, ...additionalContentDirs]) {\n          server.watcher.add(dir);\n        }\n      },\n    },\n    {\n      name: 'analog-glob-routes',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the route replacements.\n      enforce: 'post',\n      config(_config) {\n        config = _config;\n        root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      },\n      /**\n       * Transforms code to replace ANALOG_ROUTE_FILES and ANALOG_CONTENT_ROUTE_FILES\n       * placeholders with actual dynamic imports of discovered route and content files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      // Vite 8 / Rolldown filtered transform: the `filter.code` substring\n      // pre-filter lets the bundler skip modules that don't contain the\n      // marker.  '_ROUTE_FILES' is a common substring of both\n      // 'ANALOG_ROUTE_FILES' and 'ANALOG_CONTENT_ROUTE_FILES'.\n      //\n      // IMPORTANT: Do NOT change this to 'ANALOG_ROUTE_FILES' — that is NOT\n      // a substring of 'ANALOG_CONTENT_ROUTE_FILES' (they diverge at\n      // position 7: 'ANALOG_C...' vs 'ANALOG_R...').  When tsconfig path\n      // aliases resolve @analogjs/router and @analogjs/router/content to\n      // separate source files, each variable lives in its own module and\n      // the filter must match both independently.\n      transform: {\n        filter: {\n          code: '_ROUTE_FILES',\n        },\n        handler(code) {\n          if (\n            code.includes('ANALOG_ROUTE_FILES') ||\n            code.includes('ANALOG_CONTENT_ROUTE_FILES')\n          ) {\n            // Discover route files using tinyglobby\n            // NOTE: { absolute: true } returns absolute paths for ALL files\n            const routeFiles = discoverRouteFiles();\n\n            // Discover content files using tinyglobby\n            const contentRouteFiles = discoverContentRouteFiles();\n\n            let result = code.replace(\n              'ANALOG_ROUTE_FILES = {};',\n              `\n              ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {\n                // Keys are app-root-relative for in-app files,\n                // workspace-relative for library files (additionalPagesDirs).\n                // import() keeps absolute paths for Vite's module resolution.\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_ROUTE_FILES = {};',\n              `\n            ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {\n              const key = getModuleKey(module);\n              return `\"${key}\": () => import('${module}?analog-content-file=true').then(m => m.default)`;\n            })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_FILE_COUNT = 0',\n              `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analog-glob-endpoints',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the endpoint replacements.\n      enforce: 'post',\n      /**\n       * Transforms code to replace ANALOG_PAGE_ENDPOINTS placeholder\n       * with actual dynamic imports of discovered server endpoint files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      transform: {\n        filter: {\n          code: 'ANALOG_PAGE_ENDPOINTS',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_PAGE_ENDPOINTS')) {\n            // Discover server endpoint files using tinyglobby\n            const endpointFiles = discoverEndpointFiles();\n\n            const result = code.replace(\n              'ANALOG_PAGE_ENDPOINTS = {};',\n              `\n              ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"router-plugin.js","names":[],"sources":["../../../src/lib/router-plugin.ts"],"sourcesContent":["import { normalizePath, Plugin, UserConfig, ViteDevServer } from 'vite';\nimport { globSync } from 'tinyglobby';\nimport { readFileSync } from 'node:fs';\nimport { isAbsolute, relative, resolve } from 'node:path';\n\nimport { Options } from './options.js';\nimport {\n  analyzeAnalogRouteFile,\n  formatAnalogRouteIdiomDiagnostic,\n} from './route-idiom-diagnostics.js';\n\n/**\n * Router plugin that handles route file discovery and hot module replacement.\n *\n * This plugin provides three main functionalities:\n * 1. Route invalidation when files are added/deleted (HMR workaround)\n * 2. Dynamic route file discovery and import generation\n * 3. Content route file discovery for markdown and Analog content\n *\n * @param options Configuration options for the router plugin\n * @returns Array of Vite plugins for route handling\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key behavior with { dot: true, absolute: true }:\n * - Returns absolute paths for ALL discovered files\n * - Path normalization is required to match expected output format\n * - Files within project root must use relative paths in object keys\n * - Files outside project root keep absolute paths in object keys\n */\nexport function routerPlugin(options?: Options): Plugin[] {\n  const workspaceRoot = normalizePath(\n    options?.workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd(),\n  );\n  let config: UserConfig;\n  let root: string;\n  // Option dirs are workspace-relative, often written with a leading `/`.\n  // Normalize them once into absolute workspace paths so watcher events,\n  // glob patterns, and key generation all compare against the same shape.\n  const normalizeWatchedDir = (dir: string) => {\n    const normalizedDir = normalizePath(\n      dir.startsWith(`${workspaceRoot}/`) || dir === workspaceRoot\n        ? dir\n        : dir.startsWith('/')\n          ? `${workspaceRoot}${dir}`\n          : resolve(workspaceRoot, dir),\n    );\n    return normalizedDir.endsWith('/')\n      ? normalizedDir.slice(0, -1)\n      : normalizedDir;\n  };\n  // Computed eagerly — these depend only on `options` and `workspaceRoot`,\n  // both of which are fixed at construction time.\n  const additionalPagesDirs = (options?.additionalPagesDirs || []).map((dir) =>\n    normalizeWatchedDir(dir),\n  );\n  const additionalContentDirs = (options?.additionalContentDirs || []).map(\n    (dir) => normalizeWatchedDir(dir),\n  );\n  // Returns every directory that can contain route-like files. The root-\n  // relative entries are only available after the Vite `config` hook sets\n  // `root`. The short-form fallbacks (`/app/routes`, etc.) let watcher\n  // events match before `config` runs — they cover the common convention\n  // where paths start with these prefixes.\n  const getRouteLikeDirs = () => [\n    ...(root\n      ? [\n          normalizeWatchedDir(`${root}/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/routes`),\n          normalizeWatchedDir(`${root}/src/app/pages`),\n          normalizeWatchedDir(`${root}/src/content`),\n        ]\n      : []),\n    '/app/routes',\n    '/src/app/routes',\n    '/src/app/pages',\n    '/src/content',\n    ...additionalPagesDirs,\n    ...additionalContentDirs,\n  ];\n  // These lists are used repeatedly by transform hooks during serve. Keeping\n  // them warm avoids a full glob on every route/content invalidation.\n  let routeFilesCache: string[] | undefined;\n  let pageRouteFilesCache: string[] | undefined;\n  let contentRouteFilesCache: string[] | undefined;\n  let endpointFilesCache: string[] | undefined;\n  const routeDiagnosticCache = new Map<string, string>();\n  const isRouteLikeFile = (path: string) => {\n    // Watcher paths from chokidar are already absolute — `normalizePath`\n    // (forward-slash only) is sufficient; `resolve()` would be a no-op.\n    const normalizedPath = normalizePath(path);\n\n    return getRouteLikeDirs().some(\n      (dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`),\n    );\n  };\n  const discoverRouteFiles = () => {\n    routeFilesCache ??= globSync(\n      [\n        `${root}/app/routes/**/*.ts`,\n        `${root}/src/app/routes/**/*.ts`,\n        `${root}/src/app/pages/**/*.page.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.page.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return routeFilesCache;\n  };\n  const discoverContentRouteFiles = () => {\n    contentRouteFilesCache ??= globSync(\n      [\n        `${root}/src/app/routes/**/*.md`,\n        `${root}/src/app/pages/**/*.md`,\n        `${root}/src/content/**/*.md`,\n        ...additionalContentDirs.map((dir) => `${dir}/**/*.md`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return contentRouteFilesCache;\n  };\n  const discoverEndpointFiles = () => {\n    endpointFilesCache ??= globSync(\n      [\n        `${root}/src/app/pages/**/*.server.ts`,\n        ...additionalPagesDirs.map((dir) => `${dir}/**/*.server.ts`),\n      ],\n      { dot: true, absolute: true },\n    );\n\n    return endpointFilesCache;\n  };\n  const discoverPageRouteFiles = () => {\n    pageRouteFilesCache ??= discoverRouteFiles().filter((file) =>\n      file.endsWith('.page.ts'),\n    );\n\n    return pageRouteFilesCache;\n  };\n  const invalidateDiscoveryCaches = () => {\n    routeFilesCache = undefined;\n    pageRouteFilesCache = undefined;\n    contentRouteFilesCache = undefined;\n    endpointFilesCache = undefined;\n  };\n  const reportRouteDiagnostics = (path: string) => {\n    if (!path.endsWith('.page.ts')) {\n      return;\n    }\n\n    try {\n      const code = readFileSync(path, 'utf-8');\n      const routeFiles = discoverPageRouteFiles();\n      const diagnostics = analyzeAnalogRouteFile({\n        filename: path,\n        code,\n        routeFiles,\n      });\n\n      const rendered = diagnostics.map((diagnostic) =>\n        formatAnalogRouteIdiomDiagnostic(diagnostic, path, workspaceRoot),\n      );\n      const fingerprint = rendered.join('\\n\\n');\n\n      if (!fingerprint) {\n        routeDiagnosticCache.delete(path);\n        return;\n      }\n\n      if (routeDiagnosticCache.get(path) === fingerprint) {\n        return;\n      }\n\n      routeDiagnosticCache.set(path, fingerprint);\n      rendered.forEach((message) => console.warn(message));\n    } catch {\n      routeDiagnosticCache.delete(path);\n    }\n  };\n  const getModuleKey = (module: string) => {\n    // Before config sets `root`, fall back to workspace-relative keys.\n    if (!root) {\n      return `/${normalizePath(relative(workspaceRoot, module))}`;\n    }\n\n    const relToRoot = normalizePath(relative(root, module));\n    // Use true path containment instead of a raw prefix check so siblings like\n    // `/apps/my-app-tools/...` are not mistaken for files inside `/apps/my-app`.\n    const isInRoot = !relToRoot.startsWith('..') && !isAbsolute(relToRoot);\n\n    if (isInRoot) {\n      return `/${relToRoot}`;\n    }\n\n    return `/${normalizePath(relative(workspaceRoot, module))}`;\n  };\n  const invalidateFileModules = (server: ViteDevServer, path: string) => {\n    const normalizedPath = normalizePath(path);\n    // A newly added page can be discovered before its final contents settle.\n    // Invalidate the page module itself so later edits don't keep serving the\n    // first incomplete transform from Vite's module graph.\n    const fileModules =\n      server.moduleGraph.getModulesByFile?.(normalizedPath) ??\n      server.moduleGraph.fileToModulesMap.get(normalizedPath);\n\n    fileModules?.forEach((mod) => {\n      server.moduleGraph.invalidateModule(mod);\n\n      mod.importers.forEach((imp) => {\n        server.moduleGraph.invalidateModule(imp);\n      });\n    });\n  };\n\n  return [\n    {\n      name: 'analogjs-router-invalidate-routes',\n      configureServer(server) {\n        /**\n         * Invalidates route modules when files are added or deleted.\n         * This is a workaround for Vite's HMR limitations with dynamic imports.\n         *\n         * @param path The file path that was added or deleted\n         */\n        function invalidateRoutes(\n          path: string,\n          event: 'add' | 'change' | 'unlink',\n        ) {\n          if (!isRouteLikeFile(path)) {\n            return;\n          }\n\n          // Add/remove changes the route graph shape, so the discovery caches\n          // must be rebuilt. Plain edits can keep using the current file set.\n          if (event !== 'change') {\n            invalidateDiscoveryCaches();\n          }\n\n          if (event === 'change') {\n            reportRouteDiagnostics(path);\n          } else if (event === 'unlink') {\n            routeDiagnosticCache.delete(path);\n            discoverPageRouteFiles().forEach((file) =>\n              reportRouteDiagnostics(file),\n            );\n          } else {\n            discoverPageRouteFiles().forEach((file) =>\n              reportRouteDiagnostics(file),\n            );\n          }\n\n          invalidateFileModules(server, path);\n\n          // For an in-place edit we only need module invalidation. Keeping the\n          // app alive here lets Angular/Vite attempt the narrower HMR path.\n          if (event === 'change') {\n            return;\n          }\n\n          server.moduleGraph.fileToModulesMap.forEach((mods) => {\n            mods.forEach((mod) => {\n              if (mod.id?.includes('analogjs') && mod.id?.includes('fesm')) {\n                server.moduleGraph.invalidateModule(mod);\n\n                mod.importers.forEach((imp) => {\n                  server.moduleGraph.invalidateModule(imp);\n                });\n              }\n            });\n          });\n\n          server.ws.send('analog:debug-full-reload', {\n            plugin: 'platform:router-plugin',\n            reason: 'route-graph-shape-changed',\n            event,\n            path,\n          });\n          server.ws.send({\n            type: 'full-reload',\n          });\n        }\n\n        server.watcher.on('add', (path) => invalidateRoutes(path, 'add'));\n        server.watcher.on('change', (path) => invalidateRoutes(path, 'change'));\n        server.watcher.on('unlink', (path) => invalidateRoutes(path, 'unlink'));\n\n        // Vite's watcher only covers the app root by default.\n        // additionalPagesDirs / additionalContentDirs live outside the\n        // root (e.g. libs/shared/feature in a monorepo), so file\n        // add/rename/delete events are never fired for them.  Explicitly\n        // add these directories to chokidar so route invalidation works.\n        for (const dir of [...additionalPagesDirs, ...additionalContentDirs]) {\n          server.watcher.add(dir);\n        }\n\n        discoverPageRouteFiles().forEach((file) =>\n          reportRouteDiagnostics(file),\n        );\n      },\n    },\n    {\n      name: 'analog-glob-routes',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the route replacements.\n      enforce: 'post',\n      config(_config) {\n        config = _config;\n        root = normalizePath(resolve(workspaceRoot, config.root || '.') || '.');\n      },\n      /**\n       * Transforms code to replace ANALOG_ROUTE_FILES and ANALOG_CONTENT_ROUTE_FILES\n       * placeholders with actual dynamic imports of discovered route and content files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      // Vite 8 / Rolldown filtered transform: the `filter.code` substring\n      // pre-filter lets the bundler skip modules that don't contain the\n      // marker.  '_ROUTE_FILES' is a common substring of both\n      // 'ANALOG_ROUTE_FILES' and 'ANALOG_CONTENT_ROUTE_FILES'.\n      //\n      // IMPORTANT: Do NOT change this to 'ANALOG_ROUTE_FILES' — that is NOT\n      // a substring of 'ANALOG_CONTENT_ROUTE_FILES' (they diverge at\n      // position 7: 'ANALOG_C...' vs 'ANALOG_R...').  When tsconfig path\n      // aliases resolve @analogjs/router and @analogjs/router/content to\n      // separate source files, each variable lives in its own module and\n      // the filter must match both independently.\n      transform: {\n        filter: {\n          code: '_ROUTE_FILES',\n        },\n        handler(code) {\n          if (\n            code.includes('ANALOG_ROUTE_FILES') ||\n            code.includes('ANALOG_CONTENT_ROUTE_FILES')\n          ) {\n            // Discover route files using tinyglobby\n            // NOTE: { absolute: true } returns absolute paths for ALL files\n            const routeFiles = discoverRouteFiles();\n\n            // Discover content files using tinyglobby\n            const contentRouteFiles = discoverContentRouteFiles();\n\n            let result = code.replace(\n              'ANALOG_ROUTE_FILES = {};',\n              `\n              ANALOG_ROUTE_FILES = {${routeFiles.map((module) => {\n                // Keys are app-root-relative for in-app files,\n                // workspace-relative for library files (additionalPagesDirs).\n                // import() keeps absolute paths for Vite's module resolution.\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_ROUTE_FILES = {};',\n              `\n            ANALOG_CONTENT_ROUTE_FILES = {${contentRouteFiles.map((module) => {\n              const key = getModuleKey(module);\n              return `\"${key}\": () => import('${module}?analog-content-file=true').then(m => m.default)`;\n            })}};\n            `,\n            );\n\n            result = result.replace(\n              'ANALOG_CONTENT_FILE_COUNT = 0',\n              `ANALOG_CONTENT_FILE_COUNT = ${contentRouteFiles.length}`,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analog-glob-endpoints',\n      // enforce: 'post' ensures this transform runs AFTER the Angular compiler\n      // plugin, which replaces module content with its own compiled output.\n      // Without this, the Angular plugin would overwrite the endpoint replacements.\n      enforce: 'post',\n      /**\n       * Transforms code to replace ANALOG_PAGE_ENDPOINTS placeholder\n       * with actual dynamic imports of discovered server endpoint files.\n       *\n       * @param code The source code to transform\n       * @returns Transformed code with dynamic imports or undefined if no transformation needed\n       */\n      transform: {\n        filter: {\n          code: 'ANALOG_PAGE_ENDPOINTS',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_PAGE_ENDPOINTS')) {\n            // Discover server endpoint files using tinyglobby\n            const endpointFiles = discoverEndpointFiles();\n\n            const result = code.replace(\n              'ANALOG_PAGE_ENDPOINTS = {};',\n              `\n              ANALOG_PAGE_ENDPOINTS = {${endpointFiles.map((module) => {\n                const key = getModuleKey(module);\n                return `\"${key}\": () => import('${module}')`;\n              })}};\n            `,\n            );\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/src/lib/tailwind-preprocessor.js

@@ -1,6 +1,6 @@
 import { debugTailwind } from "./utils/debug.js";
-import { readFileSync } from "node:fs";
 import path from "node:path";
+import { readFileSync } from "node:fs";
 //#region packages/platform/src/lib/tailwind-preprocessor.ts
 /**
 * Creates a stylesheet preprocessor that injects Tailwind v4 `@reference`

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

@@ -2,8 +2,8 @@ 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 { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 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";

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

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

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

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

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

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

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

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

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

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

@@ -8,33 +8,14 @@ export type DebugMode = "build" | "dev";
 export interface DebugModeOptions {
 	scopes?: boolean | DebugScope[];
 	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
 }
 export type DebugOption = boolean | DebugScope[] | DebugModeOptions | DebugModeOptions[];
-/**
-* Translates the user-facing `debug` platform option into obug namespace
-* activations.  Called once during the Vite plugin config hook.
-*
-* When `true`, enables all `analog:*` scopes (platform + angular + nitro).
-* Additive — does not replace namespaces already enabled via the DEBUG
-* env var or localStorage.debug.
-*
-* When an object with `mode` is provided, activation is deferred until
-* {@link activateDeferredDebug} is called from a Vite config hook.
-*
-* Accepts an array of objects to enable different scopes per command:
-* ```ts
-* debug: [
-*   { scopes: ['analog:angular:hmr'], mode: 'dev' },
-*   { scopes: ['analog:platform:typed-router'], mode: 'build' },
-* ]
-* ```
-*/
-export declare function applyDebugOption(debug: DebugOption | undefined): void;
-/**
-* Called from a Vite config hook once `command` is known.
-* Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.
-* Idempotent — clears pending state after the first call.
-*/
-export declare function activateDeferredDebug(command: "build" | "serve"): void;
-/** @internal test-only reset */
-export declare function _resetDeferredDebug(): void;
+export declare const applyDebugOption: (debug: DebugOption | undefined, workspaceRoot?: string) => void;
+export declare const activateDeferredDebug: (command: "build" | "serve") => void;
+export declare const _resetDeferredDebug: () => void;

package/src/lib/utils/debug.js

@@ -1,74 +1,25 @@
-import { createDebug, enable } from "obug";
+import { createDebugHarness } from "./debug-harness.js";
+import { createDebug } from "obug";
+import { debugInstances } from "@analogjs/vite-plugin-nitro/internal";
 //#region packages/platform/src/lib/utils/debug.ts
 var debugPlatform = createDebug("analog:platform");
-createDebug("analog:platform:routes");
-createDebug("analog:platform:content");
+var debugRoutes = createDebug("analog:platform:routes");
+var debugContent = createDebug("analog:platform:content");
 var debugTypedRouter = createDebug("analog:platform:typed-router");
 var debugTailwind = createDebug("analog:platform:tailwind");
-var pendingDebug = [];
-function resolveNamespaces(scopes, fallback) {
-	if (scopes === true || scopes === void 0) return fallback;
-	if (Array.isArray(scopes) && scopes.length) return scopes.join(",");
-	return null;
-}
-function applyEntry(entry, fallback) {
-	if (!entry.mode) {
-		const ns = resolveNamespaces(entry.scopes ?? true, fallback);
-		if (ns) enable(ns);
-	} else pendingDebug.push(entry);
-}
-/**
-* Translates the user-facing `debug` platform option into obug namespace
-* activations.  Called once during the Vite plugin config hook.
-*
-* When `true`, enables all `analog:*` scopes (platform + angular + nitro).
-* Additive — does not replace namespaces already enabled via the DEBUG
-* env var or localStorage.debug.
-*
-* When an object with `mode` is provided, activation is deferred until
-* {@link activateDeferredDebug} is called from a Vite config hook.
-*
-* Accepts an array of objects to enable different scopes per command:
-* ```ts
-* debug: [
-*   { scopes: ['analog:angular:hmr'], mode: 'dev' },
-*   { scopes: ['analog:platform:typed-router'], mode: 'build' },
-* ]
-* ```
-*/
-function applyDebugOption(debug) {
-	if (debug == null || debug === false) return;
-	if (typeof debug === "boolean") {
-		const ns = resolveNamespaces(debug, "analog:*");
-		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) applyEntry(entry, "analog:*");
-		return;
-	}
-	applyEntry(debug, "analog:*");
-}
-/**
-* Called from a Vite config hook once `command` is known.
-* Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.
-* Idempotent — clears pending state after the first call.
-*/
-function activateDeferredDebug(command) {
-	if (pendingDebug.length === 0) return;
-	const currentMode = command === "serve" ? "dev" : "build";
-	for (const entry of pendingDebug) if (entry.mode === currentMode) {
-		const ns = resolveNamespaces(entry.scopes ?? true, "analog:*");
-		if (ns) enable(ns);
-	}
-	pendingDebug = [];
-}
+var harness = createDebugHarness({
+	fallbackNamespace: "analog:*",
+	instanceGroups: [[
+		debugPlatform,
+		debugRoutes,
+		debugContent,
+		debugTypedRouter,
+		debugTailwind
+	], debugInstances]
+});
+var applyDebugOption = harness.applyDebugOption;
+var activateDeferredDebug = harness.activateDeferredDebug;
+harness._resetDeferredDebug;
 //#endregion
 export { activateDeferredDebug, applyDebugOption, debugPlatform, debugTailwind, debugTypedRouter };
 

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

@@ -1 +1 @@
-{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug, enable } from 'obug';\n\nexport const debugPlatform = createDebug('analog:platform');\nexport const debugRoutes = createDebug('analog:platform:routes');\nexport const debugContent = createDebug('analog:platform:content');\nexport const debugTypedRouter = createDebug('analog:platform:typed-router');\nexport const debugTailwind = createDebug('analog:platform:tailwind');\n\nexport type DebugScope =\n  | 'analog:*'\n  | 'analog:platform'\n  | 'analog:platform:*'\n  | 'analog:platform:routes'\n  | 'analog:platform:content'\n  | 'analog:platform:typed-router'\n  | 'analog:platform:tailwind'\n  | 'analog:angular:*'\n  | 'analog:angular:hmr'\n  | 'analog:angular:styles'\n  | 'analog:angular:compiler'\n  | 'analog:angular:compilation-api'\n  | 'analog:angular:tailwind'\n  | 'analog:nitro'\n  | 'analog:nitro:*'\n  | 'analog:nitro:ssr'\n  | 'analog:nitro:prerender'\n  | (string & {});\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions {\n  scopes?: boolean | DebugScope[];\n  mode?: DebugMode;\n}\n\nexport type DebugOption =\n  | boolean\n  | DebugScope[]\n  | DebugModeOptions\n  | DebugModeOptions[];\n\nlet pendingDebug: DebugModeOptions[] = [];\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 applyEntry(entry: DebugModeOptions, fallback: string): void {\n  if (!entry.mode) {\n    const ns = resolveNamespaces(entry.scopes ?? true, fallback);\n    if (ns) enable(ns);\n  } else {\n    pendingDebug.push(entry);\n  }\n}\n\n/**\n * Translates the user-facing `debug` platform option into obug namespace\n * activations.  Called once during the Vite plugin config hook.\n *\n * When `true`, enables all `analog:*` scopes (platform + angular + nitro).\n * Additive — does not replace namespaces already enabled via the DEBUG\n * env var or localStorage.debug.\n *\n * When an object with `mode` is provided, activation is deferred until\n * {@link activateDeferredDebug} is called from a Vite config hook.\n *\n * Accepts an array of objects to enable different scopes per command:\n * ```ts\n * debug: [\n *   { scopes: ['analog:angular:hmr'], mode: 'dev' },\n *   { scopes: ['analog:platform:typed-router'], mode: 'build' },\n * ]\n * ```\n */\nexport function applyDebugOption(debug: DebugOption | undefined): void {\n  if (debug == null || debug === false) return;\n\n  if (typeof debug === 'boolean') {\n    const ns = resolveNamespaces(debug, 'analog:*');\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[]) {\n      applyEntry(entry, 'analog:*');\n    }\n    return;\n  }\n\n  applyEntry(debug, 'analog:*');\n}\n\n/**\n * Called from a Vite config hook once `command` is known.\n * Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.\n * Idempotent — clears pending state after the first call.\n */\nexport function activateDeferredDebug(command: 'build' | 'serve'): void {\n  if (pendingDebug.length === 0) return;\n\n  const currentMode = command === 'serve' ? 'dev' : 'build';\n\n  for (const entry of pendingDebug) {\n    if (entry.mode === currentMode) {\n      const ns = resolveNamespaces(entry.scopes ?? true, 'analog:*');\n      if (ns) enable(ns);\n    }\n  }\n\n  pendingDebug = [];\n}\n\n/** @internal test-only reset */\nexport function _resetDeferredDebug(): void {\n  pendingDebug = [];\n}\n"],"mappings":";;AAEA,IAAa,gBAAgB,YAAY,kBAAkB;AAChC,YAAY,yBAAyB;AACpC,YAAY,0BAA0B;AAClE,IAAa,mBAAmB,YAAY,+BAA+B;AAC3E,IAAa,gBAAgB,YAAY,2BAA2B;AAmCpE,IAAI,eAAmC,EAAE;AAEzC,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,WAAW,OAAyB,UAAwB;AACnE,KAAI,CAAC,MAAM,MAAM;EACf,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,SAAS;AAC5D,MAAI,GAAI,QAAO,GAAG;OAElB,cAAa,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;AAuB5B,SAAgB,iBAAiB,OAAsC;AACrE,KAAI,SAAS,QAAQ,UAAU,MAAO;AAEtC,KAAI,OAAO,UAAU,WAAW;EAC9B,MAAM,KAAK,kBAAkB,OAAO,WAAW;AAC/C,MAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,EAAG;AAExB,MAAI,OAAO,MAAM,OAAO,UAAU;GAChC,MAAM,KAAM,MAAmB,KAAK,IAAI;AACxC,OAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,OAAK,MAAM,SAAS,MAClB,YAAW,OAAO,WAAW;AAE/B;;AAGF,YAAW,OAAO,WAAW;;;;;;;AAQ/B,SAAgB,sBAAsB,SAAkC;AACtE,KAAI,aAAa,WAAW,EAAG;CAE/B,MAAM,cAAc,YAAY,UAAU,QAAQ;AAElD,MAAK,MAAM,SAAS,aAClB,KAAI,MAAM,SAAS,aAAa;EAC9B,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,WAAW;AAC9D,MAAI,GAAI,QAAO,GAAG;;AAItB,gBAAe,EAAE"}
+{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug } from 'obug';\nimport { debugInstances as nitroDebugInstances } from '@analogjs/vite-plugin-nitro/internal';\nimport { createDebugHarness } from './debug-harness.js';\n\nexport const debugPlatform = createDebug('analog:platform');\nexport const debugRoutes = createDebug('analog:platform:routes');\nexport const debugContent = createDebug('analog:platform:content');\nexport const debugTypedRouter = createDebug('analog:platform:typed-router');\nexport const debugTailwind = createDebug('analog:platform:tailwind');\n\nconst platformDebugInstances = [\n  debugPlatform,\n  debugRoutes,\n  debugContent,\n  debugTypedRouter,\n  debugTailwind,\n];\n\nexport type DebugScope =\n  | 'analog:*'\n  | 'analog:platform'\n  | 'analog:platform:*'\n  | 'analog:platform:routes'\n  | 'analog:platform:content'\n  | 'analog:platform:typed-router'\n  | 'analog:platform:tailwind'\n  | 'analog:angular:*'\n  | 'analog:angular:hmr'\n  | 'analog:angular:styles'\n  | 'analog:angular:compiler'\n  | 'analog:angular:compilation-api'\n  | 'analog:angular:tailwind'\n  | 'analog:nitro'\n  | 'analog:nitro:*'\n  | 'analog:nitro:ssr'\n  | 'analog:nitro:prerender'\n  | (string & {});\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions {\n  scopes?: boolean | DebugScope[];\n  mode?: DebugMode;\n  /**\n   * Write debug output to log files under `tmp/debug/` in the workspace root.\n   * - `true` or `'single'` — all output to `tmp/debug/analog.log`\n   * - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`\n   */\n  logFile?: boolean | 'single' | 'scoped';\n}\n\nexport type DebugOption =\n  | boolean\n  | DebugScope[]\n  | DebugModeOptions\n  | DebugModeOptions[];\n\nconst harness = createDebugHarness({\n  fallbackNamespace: 'analog:*',\n  instanceGroups: [platformDebugInstances, nitroDebugInstances],\n});\n\nexport const applyDebugOption: (\n  debug: DebugOption | undefined,\n  workspaceRoot?: string,\n) => void = harness.applyDebugOption;\nexport const activateDeferredDebug: (command: 'build' | 'serve') => void =\n  harness.activateDeferredDebug;\nexport const _resetDeferredDebug: () => void = harness._resetDeferredDebug;\n"],"mappings":";;;;AAIA,IAAa,gBAAgB,YAAY,kBAAkB;AAC3D,IAAa,cAAc,YAAY,yBAAyB;AAChE,IAAa,eAAe,YAAY,0BAA0B;AAClE,IAAa,mBAAmB,YAAY,+BAA+B;AAC3E,IAAa,gBAAgB,YAAY,2BAA2B;AAiDpE,IAAM,UAAU,mBAAmB;CACjC,mBAAmB;CACnB,gBAAgB,CAjDa;EAC7B;EACA;EACA;EACA;EACA;EACD,EA2C0C,eAAoB;CAC9D,CAAC;AAEF,IAAa,mBAGD,QAAQ;AACpB,IAAa,wBACX,QAAQ;AACqC,QAAQ"}