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

package/src/lib/content-plugin.d.ts

@@ -1,22 +1,22 @@
-import * as vite from 'vite';
-import type { WithShikiHighlighterOptions } from './content/shiki/options.js';
-import type { WithPrismHighlighterOptions } from './content/prism/options.js';
-import type { WithMarkedOptions } from './content/marked/index.js';
-import type { Options } from './options.js';
+import * as vite from "vite";
+import type { WithShikiHighlighterOptions } from "./content/shiki/options.js";
+import type { WithPrismHighlighterOptions } from "./content/prism/options.js";
+import type { WithMarkedOptions } from "./content/marked/index.js";
+import type { Options } from "./options.js";
 export type ContentPluginOptions = {
-    highlighter?: 'shiki' | 'prism';
-    markedOptions?: WithMarkedOptions;
-    shikiOptions?: WithShikiHighlighterOptions;
-    prismOptions?: WithPrismHighlighterOptions;
+	highlighter?: "shiki" | "prism";
+	markedOptions?: WithMarkedOptions;
+	shikiOptions?: WithShikiHighlighterOptions;
+	prismOptions?: WithPrismHighlighterOptions;
 };
 /**
- * Content plugin that provides markdown and content file processing for Analog.
- *
- * IMPORTANT: This plugin uses tinyglobby for file discovery.
- * Key pitfall with { dot: true }:
- * - Returns relative paths from cwd (e.g., "apps/blog-app/src/content/...")
- * - These paths CANNOT be used directly in ES module imports
- * - Relative paths without ./ or ../ are treated as package names
- * - Must convert to absolute paths for imports to work correctly
- */
-export declare function contentPlugin({ highlighter, markedOptions, shikiOptions, prismOptions, }?: ContentPluginOptions, options?: Options): vite.Plugin[];
+* Content plugin that provides markdown and content file processing for Analog.
+*
+* IMPORTANT: This plugin uses tinyglobby for file discovery.
+* Key pitfall with { dot: true }:
+* - Returns relative paths from cwd (e.g., "apps/blog-app/src/content/...")
+* - These paths CANNOT be used directly in ES module imports
+* - Relative paths without ./ or ../ are treated as package names
+* - Must convert to absolute paths for imports to work correctly
+*/
+export declare function contentPlugin({ highlighter, markedOptions, shikiOptions, prismOptions }?: ContentPluginOptions, options?: Options): vite.Plugin[];

package/src/lib/content-plugin.js

@@ -1,8 +1,8 @@
 import { getBundleOptionsKey } from "./utils/rolldown.js";
+import { relative, resolve } from "node:path";
+import { readFileSync } from "node:fs";
 import * as vite from "vite";
 import { globSync } from "tinyglobby";
-import { resolve } from "node:path";
-import { readFileSync } from "node:fs";
 //#region packages/platform/src/lib/content-plugin.ts
 /**
 * Content plugin that provides markdown and content file processing for Analog.
@@ -16,29 +16,47 @@ import { readFileSync } from "node:fs";
 */
 function contentPlugin({ highlighter, markedOptions, shikiOptions, prismOptions } = {}, options) {
 	const cache = /* @__PURE__ */ new Map();
+	let contentFilesListCache;
 	let markedHighlighter;
-	const workspaceRoot = vite.normalizePath(options?.workspaceRoot ?? process.cwd());
+	const workspaceRoot = vite.normalizePath(options?.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd());
 	let config;
 	let root;
+	let contentRootDirs;
+	const normalizeContentDir = (dir) => {
+		const normalized = vite.normalizePath(dir.startsWith("/") ? `${workspaceRoot}${dir}` : resolve(workspaceRoot, dir));
+		return normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+	};
+	const initContentRootDirs = () => {
+		contentRootDirs = [vite.normalizePath(`${root}/src/content`), ...(options?.additionalContentDirs || []).map(normalizeContentDir)];
+	};
+	const discoverContentFilesList = () => {
+		contentFilesListCache ??= globSync(contentRootDirs.map((dir) => `${dir}/**/*.md`), { dot: true });
+		return contentFilesListCache;
+	};
+	const resolveContentModulePath = (module) => vite.normalizePath(module.startsWith("/") ? module : `${workspaceRoot}/${module}`);
+	const getContentModuleKey = (module) => {
+		const absolutePath = resolveContentModulePath(module);
+		const relativeToRoot = vite.normalizePath(relative(root, absolutePath));
+		return !relativeToRoot.startsWith("..") && !relativeToRoot.startsWith("/") ? `/${relativeToRoot}` : `/${vite.normalizePath(relative(workspaceRoot, absolutePath))}`;
+	};
 	const contentDiscoveryPlugins = [{
 		name: "analog-content-glob-routes",
 		config(_config) {
 			config = _config;
 			root = vite.normalizePath(resolve(workspaceRoot, config.root || ".") || ".");
+			initContentRootDirs();
 		},
 		transform: {
 			filter: { code: "ANALOG_CONTENT_FILE_LIST" },
 			handler(code) {
 				if (code.includes("ANALOG_CONTENT_FILE_LIST")) {
-					const contentFilesList = globSync([`${root}/src/content/**/*.md`, ...(options?.additionalContentDirs || []).map((glob) => `${workspaceRoot}${glob}/**/*.md`)], { dot: true });
+					const contentFilesList = discoverContentFilesList();
 					const eagerImports = [];
 					contentFilesList.forEach((module, index) => {
-						const absolutePath = module.startsWith("/") ? module : `${workspaceRoot}/${module}`;
+						const absolutePath = resolveContentModulePath(module);
 						eagerImports.push(`import { default as analog_module_${index} } from "${absolutePath}?analog-content-list=true";`);
 					});
-					let result = code.replace("const ANALOG_CONTENT_FILE_LIST = {};", `
-              let ANALOG_CONTENT_FILE_LIST = {${contentFilesList.map((module, index) => `"${module.replace(root, "")}": analog_module_${index}`)}};
-            `);
+					let result = code.replace(/ANALOG_CONTENT_FILE_LIST\s*=\s*\{\s*\}/, `ANALOG_CONTENT_FILE_LIST = {${contentFilesList.map((module, index) => `"${getContentModuleKey(module)}": analog_module_${index}`)}}`);
 					if (!code.includes("analog_module_")) result = `${eagerImports.join("\n")}\n${result}`;
 					return {
 						code: result,
@@ -51,7 +69,9 @@ function contentPlugin({ highlighter, markedOptions, shikiOptions, prismOptions
 		name: "analogjs-invalidate-content-dirs",
 		configureServer(server) {
 			function invalidateContent(path) {
-				if (path.includes(vite.normalizePath(`/content/`))) {
+				const normalizedPath = vite.normalizePath(path);
+				if (contentRootDirs.some((dir) => normalizedPath === dir || normalizedPath.startsWith(`${dir}/`))) {
+					contentFilesListCache = void 0;
 					server.moduleGraph.fileToModulesMap.forEach((mods) => {
 						mods.forEach((mod) => {
 							if (mod.id?.includes("analogjs") && mod.id?.includes("content")) {
@@ -62,6 +82,11 @@ function contentPlugin({ highlighter, markedOptions, shikiOptions, prismOptions
 							}
 						});
 					});
+					server.ws.send("analog:debug-full-reload", {
+						plugin: "platform:content-plugin",
+						reason: "content-file-set-changed",
+						path: normalizedPath
+					});
 					server.ws.send({ type: "full-reload" });
 				}
 			}

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

@@ -1 +1 @@
-{"version":3,"file":"content-plugin.js","names":[],"sources":["../../../../../packages/platform/src/lib/content-plugin.ts"],"sourcesContent":["import * as vite from 'vite';\nimport { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nimport type { WithShikiHighlighterOptions } from './content/shiki/options.js';\nimport type { MarkedContentHighlighter } from './content/marked/marked-content-highlighter.js';\nimport type { WithPrismHighlighterOptions } from './content/prism/options.js';\nimport type { WithMarkedOptions } from './content/marked/index.js';\nimport type { Options } from './options.js';\nimport { getBundleOptionsKey } from './utils/rolldown.js';\n\ninterface Content {\n  code: string;\n  attributes: string;\n}\n\nexport type ContentPluginOptions = {\n  highlighter?: 'shiki' | 'prism';\n  markedOptions?: WithMarkedOptions;\n  shikiOptions?: WithShikiHighlighterOptions;\n  prismOptions?: WithPrismHighlighterOptions;\n};\n\n/**\n * Content plugin that provides markdown and content file processing for Analog.\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key pitfall with { dot: true }:\n * - Returns relative paths from cwd (e.g., \"apps/blog-app/src/content/...\")\n * - These paths CANNOT be used directly in ES module imports\n * - Relative paths without ./ or ../ are treated as package names\n * - Must convert to absolute paths for imports to work correctly\n */\nexport function contentPlugin(\n  {\n    highlighter,\n    markedOptions,\n    shikiOptions,\n    prismOptions,\n  }: ContentPluginOptions = {},\n  options?: Options,\n): vite.Plugin[] {\n  const cache = new Map<string, Content>();\n\n  let markedHighlighter: MarkedContentHighlighter;\n  const workspaceRoot = vite.normalizePath(\n    options?.workspaceRoot ?? process.cwd(),\n  );\n  let config: vite.UserConfig;\n  let root: string;\n\n  const contentDiscoveryPlugins: vite.Plugin[] = [\n    {\n      name: 'analog-content-glob-routes',\n      config(_config) {\n        config = _config;\n        root = vite.normalizePath(\n          resolve(workspaceRoot, config.root || '.') || '.',\n        );\n      },\n      // Vite 8 / Rolldown \"filtered transform\" — the `filter.code` string\n      // tells the bundler to skip this handler entirely for modules whose\n      // source does not contain the substring, avoiding unnecessary JS→Rust\n      // round-trips.  The inner `code.includes()` guard is kept for Vite 7\n      // compat where filters are not evaluated by the bundler.\n      transform: {\n        filter: {\n          code: 'ANALOG_CONTENT_FILE_LIST',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_CONTENT_FILE_LIST')) {\n            const contentFilesList: string[] = globSync(\n              [\n                `${root}/src/content/**/*.md`,\n                ...(options?.additionalContentDirs || []).map(\n                  (glob) => `${workspaceRoot}${glob}/**/*.md`,\n                ),\n              ],\n              { dot: true },\n            );\n\n            const eagerImports: string[] = [];\n\n            contentFilesList.forEach((module, index) => {\n              // CRITICAL: tinyglobby returns relative paths like \"apps/blog-app/src/content/file.md\"\n              // These MUST be converted to absolute paths for ES module imports\n              // Otherwise Node.js treats \"apps\" as a package name and throws \"Cannot find package 'apps'\"\n              const absolutePath = module.startsWith('/')\n                ? module\n                : `${workspaceRoot}/${module}`;\n              eagerImports.push(\n                `import { default as analog_module_${index} } from \"${absolutePath}?analog-content-list=true\";`,\n              );\n            });\n\n            let result = code.replace(\n              'const ANALOG_CONTENT_FILE_LIST = {};',\n              `\n              let ANALOG_CONTENT_FILE_LIST = {${contentFilesList.map(\n                (module, index) =>\n                  `\"${module.replace(root, '')}\": analog_module_${index}`,\n              )}};\n            `,\n            );\n\n            if (!code.includes('analog_module_')) {\n              result = `${eagerImports.join('\\n')}\\n${result}`;\n            }\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analogjs-invalidate-content-dirs',\n      configureServer(server) {\n        function invalidateContent(path: string) {\n          if (path.includes(vite.normalizePath(`/content/`))) {\n            server.moduleGraph.fileToModulesMap.forEach((mods) => {\n              mods.forEach((mod) => {\n                if (\n                  mod.id?.includes('analogjs') &&\n                  mod.id?.includes('content')\n                ) {\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\n        server.watcher.on('add', invalidateContent);\n        server.watcher.on('unlink', invalidateContent);\n      },\n    },\n  ];\n\n  if (!highlighter) {\n    return [\n      {\n        name: 'analogjs-external-content',\n        config() {\n          const bundleOptionsKey = getBundleOptionsKey();\n          return {\n            build: {\n              [bundleOptionsKey]: {\n                external: ['@analogjs/content'],\n              },\n            },\n          };\n        },\n      },\n      {\n        name: 'analogjs-exclude-content-import',\n        transform: {\n          filter: {\n            code: '@analogjs/content',\n          },\n          handler(code) {\n            /**\n             * Remove the package so it doesn't get\n             * referenced when building for serverless\n             * functions.\n             */\n            if (code.includes(`import('@analogjs/content')`)) {\n              return {\n                code: code.replace(\n                  `import('@analogjs/content')`,\n                  'Promise.resolve({})',\n                ),\n              };\n            }\n\n            return;\n          },\n        },\n      },\n      ...contentDiscoveryPlugins,\n    ];\n  }\n\n  return [\n    {\n      name: 'analogjs-content-frontmatter',\n      // Filter by module ID so only `?analog-content-list=true` virtual\n      // imports enter the handler.  Returns `moduleSideEffects: false` so\n      // Rolldown can tree-shake unused content list entries.\n      transform: {\n        filter: {\n          id: /analog-content-list=true/,\n        },\n        async handler(code, id) {\n          const cachedContent = cache.get(id);\n          // There's no reason to run `readFileSync` and frontmatter parsing if the\n          // `transform` hook is called with the same code. In such cases, we can simply\n          // return the cached attributes, which is faster than repeatedly reading files\n          // synchronously during the build process.\n          if (cachedContent?.code === code) {\n            return {\n              code: `export default ${cachedContent.attributes}`,\n              moduleSideEffects: false,\n            };\n          }\n\n          const fm: any = await import('front-matter');\n          // The `default` property will be available in CommonJS environment, for instance,\n          // when running unit tests. It's safe to retrieve `default` first, since we still\n          // fallback to the original implementation.\n          const frontmatter = fm.default || fm;\n          const fileContents = readFileSync(id.split('?')[0], 'utf8');\n          const { attributes } = frontmatter(fileContents);\n          const content = {\n            code,\n            attributes: JSON.stringify(attributes),\n          };\n          cache.set(id, content);\n\n          return {\n            code: `export default ${content.attributes}`,\n            moduleSideEffects: false,\n          };\n        },\n      },\n    },\n    {\n      name: 'analogjs-content-file',\n      enforce: 'post',\n      async load(id) {\n        if (!id.includes('analog-content-file=true')) {\n          return;\n        }\n\n        if (!markedHighlighter) {\n          if (highlighter === 'shiki') {\n            const { getShikiHighlighter } =\n              await import('./content/shiki/index.js');\n            markedHighlighter = getShikiHighlighter(shikiOptions);\n          } else {\n            const { getPrismHighlighter } =\n              await import('./content/prism/index.js');\n            markedHighlighter = getPrismHighlighter();\n\n            const langs = [\n              'bash',\n              'css',\n              'javascript',\n              'json',\n              'markup',\n              'typescript',\n            ];\n\n            if (\n              Array.isArray(prismOptions?.additionalLangs) &&\n              prismOptions?.additionalLangs?.length > 0\n            ) {\n              langs.push(...prismOptions.additionalLangs);\n            }\n\n            const loadLanguages = await import('prismjs/components/index.js');\n\n            (\n              loadLanguages as unknown as { default: (...args: any[]) => any }\n            ).default(langs);\n          }\n        }\n\n        const fm: any = await import('front-matter');\n        // The `default` property will be available in CommonJS environment, for instance,\n        // when running unit tests. It's safe to retrieve `default` first, since we still\n        // fallback to the original implementation.\n        const frontmatterFn = fm.default || fm;\n        const fileContents = readFileSync(id.split('?')[0], 'utf8');\n        const { body, frontmatter } = frontmatterFn(fileContents);\n\n        // parse markdown and highlight\n        const { getMarkedSetup } = await import('./content/marked/index.js');\n        const markedSetupService = getMarkedSetup(\n          { mangle: true, ...(markedOptions || {}) },\n          markedHighlighter,\n        );\n        const mdContent = (await markedSetupService\n          .getMarkedInstance()\n          .parse(body)) as unknown as string;\n\n        return `export default ${JSON.stringify(\n          `---\\n${frontmatter}\\n---\\n\\n${mdContent}`,\n        )}`;\n      },\n    },\n    ...contentDiscoveryPlugins,\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"content-plugin.js","names":[],"sources":["../../../src/lib/content-plugin.ts"],"sourcesContent":["import * as vite from 'vite';\nimport { readFileSync } from 'node:fs';\nimport { relative, resolve } from 'node:path';\nimport { globSync } from 'tinyglobby';\n\nimport type { WithShikiHighlighterOptions } from './content/shiki/options.js';\nimport type { MarkedContentHighlighter } from './content/marked/marked-content-highlighter.js';\nimport type { WithPrismHighlighterOptions } from './content/prism/options.js';\nimport type { WithMarkedOptions } from './content/marked/index.js';\nimport type { Options } from './options.js';\nimport { getBundleOptionsKey } from './utils/rolldown.js';\n\ninterface Content {\n  code: string;\n  attributes: string;\n}\n\nexport type ContentPluginOptions = {\n  highlighter?: 'shiki' | 'prism';\n  markedOptions?: WithMarkedOptions;\n  shikiOptions?: WithShikiHighlighterOptions;\n  prismOptions?: WithPrismHighlighterOptions;\n};\n\n/**\n * Content plugin that provides markdown and content file processing for Analog.\n *\n * IMPORTANT: This plugin uses tinyglobby for file discovery.\n * Key pitfall with { dot: true }:\n * - Returns relative paths from cwd (e.g., \"apps/blog-app/src/content/...\")\n * - These paths CANNOT be used directly in ES module imports\n * - Relative paths without ./ or ../ are treated as package names\n * - Must convert to absolute paths for imports to work correctly\n */\nexport function contentPlugin(\n  {\n    highlighter,\n    markedOptions,\n    shikiOptions,\n    prismOptions,\n  }: ContentPluginOptions = {},\n  options?: Options,\n): vite.Plugin[] {\n  const cache = new Map<string, Content>();\n  // The content list placeholder can be transformed several times during serve.\n  // Caching the discovered markdown paths keeps those repeat passes cheap.\n  let contentFilesListCache: string[] | undefined;\n\n  let markedHighlighter: MarkedContentHighlighter;\n  const workspaceRoot = vite.normalizePath(\n    options?.workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd(),\n  );\n  let config: vite.UserConfig;\n  let root: string;\n  // Keep discovery and invalidation aligned by deriving both from the same\n  // normalized content roots. That way external content dirs participate in\n  // cache busting exactly the same way they participate in glob discovery.\n  // Initialized once in the `config` hook after `root` is resolved — all\n  // inputs (`root`, `workspaceRoot`, `options`) are stable after that point.\n  let contentRootDirs: string[];\n  const normalizeContentDir = (dir: string) => {\n    const normalized = vite.normalizePath(\n      dir.startsWith('/')\n        ? `${workspaceRoot}${dir}`\n        : resolve(workspaceRoot, dir),\n    );\n    return normalized.endsWith('/') ? normalized.slice(0, -1) : normalized;\n  };\n  const initContentRootDirs = () => {\n    contentRootDirs = [\n      vite.normalizePath(`${root}/src/content`),\n      ...(options?.additionalContentDirs || []).map(normalizeContentDir),\n    ];\n  };\n  const discoverContentFilesList = () => {\n    contentFilesListCache ??= globSync(\n      contentRootDirs.map((dir) => `${dir}/**/*.md`),\n      { dot: true },\n    );\n\n    return contentFilesListCache;\n  };\n  const resolveContentModulePath = (module: string) =>\n    vite.normalizePath(\n      module.startsWith('/') ? module : `${workspaceRoot}/${module}`,\n    );\n  const getContentModuleKey = (module: string) => {\n    const absolutePath = resolveContentModulePath(module);\n    const relativeToRoot = vite.normalizePath(relative(root, absolutePath));\n    // `startsWith(root)` is not safe here because sibling directories such as\n    // `/apps/my-app-tools` also start with `/apps/my-app`. A relative path only\n    // represents in-app content when it stays within `root`.\n    const isInApp =\n      !relativeToRoot.startsWith('..') && !relativeToRoot.startsWith('/');\n\n    // Both branches prepend `/` so generated keys are always absolute-\n    // looking (`/src/content/...` for in-app, `/libs/shared/...` for\n    // workspace-external). Downstream consumers like content-files-token\n    // rely on the leading `/` for slug extraction regexes.\n    return isInApp\n      ? `/${relativeToRoot}`\n      : `/${vite.normalizePath(relative(workspaceRoot, absolutePath))}`;\n  };\n\n  const contentDiscoveryPlugins: vite.Plugin[] = [\n    {\n      name: 'analog-content-glob-routes',\n      config(_config) {\n        config = _config;\n        root = vite.normalizePath(\n          resolve(workspaceRoot, config.root || '.') || '.',\n        );\n        initContentRootDirs();\n      },\n      // Vite 8 / Rolldown \"filtered transform\" — the `filter.code` string\n      // tells the bundler to skip this handler entirely for modules whose\n      // source does not contain the substring, avoiding unnecessary JS→Rust\n      // round-trips.  The inner `code.includes()` guard is kept for Vite 7\n      // compat where filters are not evaluated by the bundler.\n      transform: {\n        filter: {\n          code: 'ANALOG_CONTENT_FILE_LIST',\n        },\n        handler(code) {\n          if (code.includes('ANALOG_CONTENT_FILE_LIST')) {\n            const contentFilesList = discoverContentFilesList();\n\n            const eagerImports: string[] = [];\n\n            contentFilesList.forEach((module, index) => {\n              // CRITICAL: tinyglobby returns relative paths like \"apps/blog-app/src/content/file.md\"\n              // These MUST be converted to absolute paths for ES module imports\n              // Otherwise Node.js treats \"apps\" as a package name and throws \"Cannot find package 'apps'\"\n              const absolutePath = resolveContentModulePath(module);\n              eagerImports.push(\n                `import { default as analog_module_${index} } from \"${absolutePath}?analog-content-list=true\";`,\n              );\n            });\n\n            // Match just the assignment (not the declaration) so the rewrite\n            // works whether the source uses `const`, `let`, `var`, or\n            // `export const` — including the post-Rolldown `var X = {};`\n            // form — without destroying the declaration that keeps the\n            // module binding exported.\n            let result = code.replace(\n              /ANALOG_CONTENT_FILE_LIST\\s*=\\s*\\{\\s*\\}/,\n              `ANALOG_CONTENT_FILE_LIST = {${contentFilesList.map(\n                (module, index) =>\n                  `\"${getContentModuleKey(module)}\": analog_module_${index}`,\n              )}}`,\n            );\n\n            if (!code.includes('analog_module_')) {\n              result = `${eagerImports.join('\\n')}\\n${result}`;\n            }\n\n            return {\n              code: result,\n              map: { mappings: '' },\n            };\n          }\n\n          return;\n        },\n      },\n    },\n    {\n      name: 'analogjs-invalidate-content-dirs',\n      configureServer(server) {\n        function invalidateContent(path: string) {\n          const normalizedPath = vite.normalizePath(path);\n          const isContentPath = contentRootDirs.some(\n            (dir) =>\n              normalizedPath === dir || normalizedPath.startsWith(`${dir}/`),\n          );\n\n          if (isContentPath) {\n            // The file set only changes on add/remove because this watcher is\n            // intentionally scoped to those events. Clear the list cache so the\n            // next transform sees the updated directory contents.\n            contentFilesListCache = undefined;\n            server.moduleGraph.fileToModulesMap.forEach((mods) => {\n              mods.forEach((mod) => {\n                if (\n                  mod.id?.includes('analogjs') &&\n                  mod.id?.includes('content')\n                ) {\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:content-plugin',\n              reason: 'content-file-set-changed',\n              path: normalizedPath,\n            });\n            server.ws.send({\n              type: 'full-reload',\n            });\n          }\n        }\n\n        server.watcher.on('add', invalidateContent);\n        server.watcher.on('unlink', invalidateContent);\n      },\n    },\n  ];\n\n  if (!highlighter) {\n    return [\n      {\n        name: 'analogjs-external-content',\n        config() {\n          const bundleOptionsKey = getBundleOptionsKey();\n          return {\n            build: {\n              [bundleOptionsKey]: {\n                external: ['@analogjs/content'],\n              },\n            },\n          };\n        },\n      },\n      {\n        name: 'analogjs-exclude-content-import',\n        transform: {\n          filter: {\n            code: '@analogjs/content',\n          },\n          handler(code) {\n            /**\n             * Remove the package so it doesn't get\n             * referenced when building for serverless\n             * functions.\n             */\n            if (code.includes(`import('@analogjs/content')`)) {\n              return {\n                code: code.replace(\n                  `import('@analogjs/content')`,\n                  'Promise.resolve({})',\n                ),\n              };\n            }\n\n            return;\n          },\n        },\n      },\n      ...contentDiscoveryPlugins,\n    ];\n  }\n\n  return [\n    {\n      name: 'analogjs-content-frontmatter',\n      // Filter by module ID so only `?analog-content-list=true` virtual\n      // imports enter the handler.  Returns `moduleSideEffects: false` so\n      // Rolldown can tree-shake unused content list entries.\n      transform: {\n        filter: {\n          id: /analog-content-list=true/,\n        },\n        async handler(code, id) {\n          const cachedContent = cache.get(id);\n          // There's no reason to run `readFileSync` and frontmatter parsing if the\n          // `transform` hook is called with the same code. In such cases, we can simply\n          // return the cached attributes, which is faster than repeatedly reading files\n          // synchronously during the build process.\n          if (cachedContent?.code === code) {\n            return {\n              code: `export default ${cachedContent.attributes}`,\n              moduleSideEffects: false,\n            };\n          }\n\n          const fm: any = await import('front-matter');\n          // The `default` property will be available in CommonJS environment, for instance,\n          // when running unit tests. It's safe to retrieve `default` first, since we still\n          // fallback to the original implementation.\n          const frontmatter = fm.default || fm;\n          const fileContents = readFileSync(id.split('?')[0], 'utf8');\n          const { attributes } = frontmatter(fileContents);\n          const content = {\n            code,\n            attributes: JSON.stringify(attributes),\n          };\n          cache.set(id, content);\n\n          return {\n            code: `export default ${content.attributes}`,\n            moduleSideEffects: false,\n          };\n        },\n      },\n    },\n    {\n      name: 'analogjs-content-file',\n      enforce: 'post',\n      async load(id) {\n        if (!id.includes('analog-content-file=true')) {\n          return;\n        }\n\n        if (!markedHighlighter) {\n          if (highlighter === 'shiki') {\n            const { getShikiHighlighter } =\n              await import('./content/shiki/index.js');\n            markedHighlighter = getShikiHighlighter(shikiOptions);\n          } else {\n            const { getPrismHighlighter } =\n              await import('./content/prism/index.js');\n            markedHighlighter = getPrismHighlighter();\n\n            const langs = [\n              'bash',\n              'css',\n              'javascript',\n              'json',\n              'markup',\n              'typescript',\n            ];\n\n            if (\n              Array.isArray(prismOptions?.additionalLangs) &&\n              prismOptions?.additionalLangs?.length > 0\n            ) {\n              langs.push(...prismOptions.additionalLangs);\n            }\n\n            const loadLanguages = await import('prismjs/components/index.js');\n\n            (\n              loadLanguages as unknown as { default: (...args: any[]) => any }\n            ).default(langs);\n          }\n        }\n\n        const fm: any = await import('front-matter');\n        // The `default` property will be available in CommonJS environment, for instance,\n        // when running unit tests. It's safe to retrieve `default` first, since we still\n        // fallback to the original implementation.\n        const frontmatterFn = fm.default || fm;\n        const fileContents = readFileSync(id.split('?')[0], 'utf8');\n        const { body, frontmatter } = frontmatterFn(fileContents);\n\n        // parse markdown and highlight\n        const { getMarkedSetup } = await import('./content/marked/index.js');\n        const markedSetupService = getMarkedSetup(\n          { mangle: true, ...(markedOptions || {}) },\n          markedHighlighter,\n        );\n        const mdContent = (await markedSetupService\n          .getMarkedInstance()\n          .parse(body)) as unknown as string;\n\n        return `export default ${JSON.stringify(\n          `---\\n${frontmatter}\\n---\\n\\n${mdContent}`,\n        )}`;\n      },\n    },\n    ...contentDiscoveryPlugins,\n  ];\n}\n"],"mappings":"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"}

package/src/lib/deps-plugin.d.ts

@@ -1,3 +1,3 @@
-import type { Plugin } from 'vite';
-import { Options } from './options.js';
+import type { Plugin } from "vite";
+import { Options } from "./options.js";
 export declare function depsPlugin(options?: Options): Plugin[];

package/src/lib/deps-plugin.js

@@ -1,24 +1,37 @@
+import { debugPlatform } from "./utils/debug.js";
 import { getJsTransformConfigKey } from "./utils/rolldown.js";
 import { VERSION } from "@angular/compiler-cli";
 import { crawlFrameworkPkgs } from "vitefu";
 //#region packages/platform/src/lib/deps-plugin.ts
 function depsPlugin(options) {
-	const workspaceRoot = options?.workspaceRoot ?? process.cwd();
+	const workspaceRoot = options?.workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd();
 	return [{
 		name: "analogjs-deps-plugin",
 		config() {
-			const transformConfig = options?.vite === false || options?.vite?.experimental?.useAngularCompilationAPI ? {} : { exclude: ["**/*.ts", "**/*.js"] };
+			const transformConfig = { exclude: ["**/*.ts", "**/*.js"] };
+			debugPlatform("deps transform config", {
+				jsTransformKey: getJsTransformConfigKey(),
+				transformExcluded: true
+			});
 			return {
 				[getJsTransformConfigKey()]: transformConfig,
-				ssr: { noExternal: [
-					"@analogjs/**",
-					"firebase/**",
-					"firebase-admin/**",
-					"rxfire",
-					"@ng-web-apis/**",
-					"@taiga-ui/**",
-					"@tanstack/angular-query-experimental"
-				] },
+				ssr: {
+					noExternal: [
+						"@analogjs/**",
+						"es-toolkit",
+						"firebase/**",
+						"firebase-admin/**",
+						"rxfire",
+						"@ng-web-apis/**",
+						"@taiga-ui/**",
+						"@tanstack/angular-query-experimental"
+					],
+					optimizeDeps: { include: [
+						"@angular/common",
+						"@angular/common/http",
+						...Number(VERSION.major) > 15 ? ["@angular/core/rxjs-interop"] : []
+					] }
+				},
 				optimizeDeps: {
 					include: [
 						"@angular/common",

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

@@ -1 +1 @@
-{"version":3,"file":"deps-plugin.js","names":[],"sources":["../../../../../packages/platform/src/lib/deps-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport type { Plugin } from 'vite';\nimport * as vite from 'vite';\nimport { crawlFrameworkPkgs } from 'vitefu';\n\nimport { Options } from './options.js';\nimport { getJsTransformConfigKey } from './utils/rolldown.js';\n\nexport function depsPlugin(options?: Options): Plugin[] {\n  const workspaceRoot = options?.workspaceRoot ?? process.cwd();\n\n  return [\n    {\n      name: 'analogjs-deps-plugin',\n      config() {\n        const transformConfig =\n          options?.vite === false ||\n          options?.vite?.experimental?.useAngularCompilationAPI\n            ? {}\n            : { exclude: ['**/*.ts', '**/*.js'] };\n\n        return {\n          [getJsTransformConfigKey()]: transformConfig,\n          ssr: {\n            noExternal: [\n              '@analogjs/**',\n              'firebase/**',\n              'firebase-admin/**',\n              'rxfire',\n              '@ng-web-apis/**',\n              '@taiga-ui/**',\n              '@tanstack/angular-query-experimental',\n            ],\n          },\n          optimizeDeps: {\n            include: [\n              '@angular/common',\n              '@angular/common/http',\n              ...(Number(VERSION.major) > 15\n                ? ['@angular/core/rxjs-interop']\n                : []),\n              'front-matter',\n            ],\n            exclude: [\n              '@angular/platform-server',\n              '@analogjs/content',\n              '@analogjs/router',\n              '@nx/angular',\n              '@nx/vite',\n              '@nx/devkit',\n              '@nx/js',\n              '@nx/devkit',\n              '@nx/cypress',\n              '@nx/jest',\n              '@nx/js',\n              '@nx/eslint',\n              '@nx/webpack',\n              '@nx/web',\n              '@nx/workspace',\n              '@nx/eslint',\n              '@nx/module-federation',\n              '@nx/rspack',\n              'webpack',\n              'fsevents',\n              'nx',\n            ],\n          },\n        };\n      },\n    },\n    {\n      name: 'analogjs-auto-discover-deps',\n      async config(config, { command }) {\n        const pkgConfig = await crawlFrameworkPkgs({\n          root: workspaceRoot,\n          isBuild: command === 'build',\n          viteUserConfig: config,\n          isSemiFrameworkPkgByJson(pkgJson) {\n            return pkgJson['module'] && pkgJson['module'].includes('fesm');\n          },\n        });\n        return pkgConfig;\n      },\n    },\n  ];\n}\n"],"mappings":";;;;AAQA,SAAgB,WAAW,SAA6B;CACtD,MAAM,gBAAgB,SAAS,iBAAiB,QAAQ,KAAK;AAE7D,QAAO,CACL;EACE,MAAM;EACN,SAAS;GACP,MAAM,kBACJ,SAAS,SAAS,SAClB,SAAS,MAAM,cAAc,2BACzB,EAAE,GACF,EAAE,SAAS,CAAC,WAAW,UAAU,EAAE;AAEzC,UAAO;KACJ,yBAAyB,GAAG;IAC7B,KAAK,EACH,YAAY;KACV;KACA;KACA;KACA;KACA;KACA;KACA;KACD,EACF;IACD,cAAc;KACZ,SAAS;MACP;MACA;MACA,GAAI,OAAO,QAAQ,MAAM,GAAG,KACxB,CAAC,6BAA6B,GAC9B,EAAE;MACN;MACD;KACD,SAAS;MACP;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACD;KACF;IACF;;EAEJ,EACD;EACE,MAAM;EACN,MAAM,OAAO,QAAQ,EAAE,WAAW;AAShC,UARkB,MAAM,mBAAmB;IACzC,MAAM;IACN,SAAS,YAAY;IACrB,gBAAgB;IAChB,yBAAyB,SAAS;AAChC,YAAO,QAAQ,aAAa,QAAQ,UAAU,SAAS,OAAO;;IAEjE,CAAC;;EAGL,CACF"}
+{"version":3,"file":"deps-plugin.js","names":[],"sources":["../../../src/lib/deps-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport type { Plugin } from 'vite';\nimport { crawlFrameworkPkgs } from 'vitefu';\n\nimport { Options } from './options.js';\nimport { debugPlatform } from './utils/debug.js';\nimport { getJsTransformConfigKey } from './utils/rolldown.js';\n\nexport function depsPlugin(options?: Options): Plugin[] {\n  const workspaceRoot =\n    options?.workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd();\n\n  return [\n    {\n      name: 'analogjs-deps-plugin',\n      config() {\n        // Skip Vite's built-in ts/js transform so `@analogjs/vite-plugin-angular`\n        // (when the user includes it) owns Angular file compilation. Users who\n        // run an alternative compiler or compile through Angular's own\n        // compilation API can override this in their own Vite config.\n        const transformConfig = { exclude: ['**/*.ts', '**/*.js'] };\n        debugPlatform('deps transform config', {\n          jsTransformKey: getJsTransformConfigKey(),\n          transformExcluded: true,\n        });\n\n        return {\n          [getJsTransformConfigKey()]: transformConfig,\n          ssr: {\n            noExternal: [\n              '@analogjs/**',\n              'es-toolkit',\n              'firebase/**',\n              'firebase-admin/**',\n              'rxfire',\n              '@ng-web-apis/**',\n              '@taiga-ui/**',\n              '@tanstack/angular-query-experimental',\n            ],\n            // The server pre-bundle is resolved separately from the client\n            // one, so a secondary entry point left out of it loads its own\n            // copy of `@angular/core`. `inject()` then runs against a runtime\n            // with no active injection context and SSR fails with NG0203.\n            optimizeDeps: {\n              include: [\n                '@angular/common',\n                '@angular/common/http',\n                ...(Number(VERSION.major) > 15\n                  ? ['@angular/core/rxjs-interop']\n                  : []),\n              ],\n            },\n          },\n          optimizeDeps: {\n            include: [\n              '@angular/common',\n              '@angular/common/http',\n              ...(Number(VERSION.major) > 15\n                ? ['@angular/core/rxjs-interop']\n                : []),\n              'front-matter',\n            ],\n            exclude: [\n              '@angular/platform-server',\n              '@analogjs/content',\n              '@analogjs/router',\n              '@nx/angular',\n              '@nx/vite',\n              '@nx/devkit',\n              '@nx/js',\n              '@nx/devkit',\n              '@nx/cypress',\n              '@nx/jest',\n              '@nx/js',\n              '@nx/eslint',\n              '@nx/webpack',\n              '@nx/web',\n              '@nx/workspace',\n              '@nx/eslint',\n              '@nx/module-federation',\n              '@nx/rspack',\n              'webpack',\n              'fsevents',\n              'nx',\n            ],\n          },\n        };\n      },\n    },\n    {\n      name: 'analogjs-auto-discover-deps',\n      async config(config, { command }) {\n        const pkgConfig = await crawlFrameworkPkgs({\n          root: workspaceRoot,\n          isBuild: command === 'build',\n          viteUserConfig: config,\n          isSemiFrameworkPkgByJson(pkgJson) {\n            return pkgJson['module'] && pkgJson['module'].includes('fesm');\n          },\n        });\n        return pkgConfig;\n      },\n    },\n  ];\n}\n"],"mappings":";;;;;AAQA,SAAgB,WAAW,SAA6B;CACtD,MAAM,gBACJ,SAAS,iBAAiB,QAAQ,IAAI,wBAAwB,QAAQ,KAAK;AAE7E,QAAO,CACL;EACE,MAAM;EACN,SAAS;GAKP,MAAM,kBAAkB,EAAE,SAAS,CAAC,WAAW,UAAU,EAAE;AAC3D,iBAAc,yBAAyB;IACrC,gBAAgB,yBAAyB;IACzC,mBAAmB;IACpB,CAAC;AAEF,UAAO;KACJ,yBAAyB,GAAG;IAC7B,KAAK;KACH,YAAY;MACV;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACD;KAKD,cAAc,EACZ,SAAS;MACP;MACA;MACA,GAAI,OAAO,QAAQ,MAAM,GAAG,KACxB,CAAC,6BAA6B,GAC9B,EAAE;MACP,EACF;KACF;IACD,cAAc;KACZ,SAAS;MACP;MACA;MACA,GAAI,OAAO,QAAQ,MAAM,GAAG,KACxB,CAAC,6BAA6B,GAC9B,EAAE;MACN;MACD;KACD,SAAS;MACP;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACD;KACF;IACF;;EAEJ,EACD;EACE,MAAM;EACN,MAAM,OAAO,QAAQ,EAAE,WAAW;AAShC,UARkB,MAAM,mBAAmB;IACzC,MAAM;IACN,SAAS,YAAY;IACrB,gBAAgB;IAChB,yBAAyB,SAAS;AAChC,YAAO,QAAQ,aAAa,QAAQ,UAAU,SAAS,OAAO;;IAEjE,CAAC;;EAGL,CACF"}

package/src/lib/discover-library-routes.d.ts

@@ -0,0 +1,19 @@
+export interface DiscoveredLibraryRoutes {
+	additionalPagesDirs: string[];
+	additionalContentDirs: string[];
+	additionalAPIDirs: string[];
+}
+/**
+* Scans workspace libraries directly for conventional route directories
+* (`src/pages`, `src/content`, `src/api`).
+*
+* Returns workspace-relative paths (e.g. `/libs/shared/feature`) suitable
+* for merging into the `additional*Dirs` options.
+*/
+export declare function discoverLibraryRoutes(workspaceRoot: string): DiscoveredLibraryRoutes;
+/**
+* Builds `${dir}/**\/*.page.ts` globs for each provided directory. The
+* platform registers these with Angular compilation through `analog.setup()`
+* for every `additionalPagesDirs` entry.
+*/
+export declare function pageGlobs(dirs: string[]): string[];

package/src/lib/discover-library-routes.js

@@ -0,0 +1,72 @@
+import { normalizePath } from "vite";
+import { globSync } from "tinyglobby";
+//#region packages/platform/src/lib/discover-library-routes.ts
+Object.freeze({
+	additionalPagesDirs: Object.freeze([]),
+	additionalContentDirs: Object.freeze([]),
+	additionalAPIDirs: Object.freeze([])
+});
+var discoverableLibRouteDirs = [
+	"libs/**/src/pages",
+	"libs/**/src/content",
+	"libs/**/src/api"
+];
+function toWorkspacePath(path) {
+	return normalizePath(path).replace(/\/$/, "");
+}
+/**
+* Scans workspace libraries directly for conventional route directories
+* (`src/pages`, `src/content`, `src/api`).
+*
+* Returns workspace-relative paths (e.g. `/libs/shared/feature`) suitable
+* for merging into the `additional*Dirs` options.
+*/
+function discoverLibraryRoutes(workspaceRoot) {
+	const result = {
+		additionalPagesDirs: [],
+		additionalContentDirs: [],
+		additionalAPIDirs: []
+	};
+	const normalizedWorkspaceRoot = toWorkspacePath(workspaceRoot);
+	const discovered = /* @__PURE__ */ new Map();
+	for (const dir of globSync(discoverableLibRouteDirs, {
+		cwd: normalizedWorkspaceRoot,
+		dot: true,
+		onlyDirectories: true
+	})) {
+		const normalizedDir = toWorkspacePath(dir);
+		const workspaceRelativeDir = normalizedDir.startsWith(`${normalizedWorkspaceRoot}/`) ? normalizedDir.slice(normalizedWorkspaceRoot.length + 1) : normalizedDir;
+		if (!workspaceRelativeDir.startsWith("libs/")) continue;
+		const srcIndex = workspaceRelativeDir.indexOf("/src/");
+		if (srcIndex === -1) continue;
+		const libRoot = workspaceRelativeDir.slice(0, srcIndex);
+		const entry = discovered.get(libRoot) ?? {
+			pages: false,
+			content: false,
+			api: false
+		};
+		if (workspaceRelativeDir.endsWith("/src/pages")) entry.pages = true;
+		if (workspaceRelativeDir.endsWith("/src/content")) entry.content = true;
+		if (workspaceRelativeDir.endsWith("/src/api")) entry.api = true;
+		discovered.set(libRoot, entry);
+	}
+	for (const libRoot of [...discovered.keys()].sort()) {
+		const entry = discovered.get(libRoot);
+		if (entry.pages) result.additionalPagesDirs.push(`/${libRoot}`);
+		if (entry.content) result.additionalContentDirs.push(`/${libRoot}/src/content`);
+		if (entry.api) result.additionalAPIDirs.push(`/${libRoot}/src/api`);
+	}
+	return result;
+}
+/**
+* Builds `${dir}/**\/*.page.ts` globs for each provided directory. The
+* platform registers these with Angular compilation through `analog.setup()`
+* for every `additionalPagesDirs` entry.
+*/
+function pageGlobs(dirs) {
+	return dirs.map((dir) => `${dir}/**/*.page.ts`);
+}
+//#endregion
+export { discoverLibraryRoutes, pageGlobs };
+
+//# sourceMappingURL=discover-library-routes.js.map

package/src/lib/discover-library-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-library-routes.js","names":[],"sources":["../../../src/lib/discover-library-routes.ts"],"sourcesContent":["import { normalizePath } from 'vite';\nimport { globSync } from 'tinyglobby';\n\nexport interface DiscoveredLibraryRoutes {\n  additionalPagesDirs: string[];\n  additionalContentDirs: string[];\n  additionalAPIDirs: string[];\n}\n\nconst empty: DiscoveredLibraryRoutes = Object.freeze({\n  additionalPagesDirs: Object.freeze([] as string[]),\n  additionalContentDirs: Object.freeze([] as string[]),\n  additionalAPIDirs: Object.freeze([] as string[]),\n});\n\nconst discoverableLibRouteDirs = [\n  'libs/**/src/pages',\n  'libs/**/src/content',\n  'libs/**/src/api',\n] as const;\n\nfunction toWorkspacePath(path: string) {\n  return normalizePath(path).replace(/\\/$/, '');\n}\n\n/**\n * Scans workspace libraries directly for conventional route directories\n * (`src/pages`, `src/content`, `src/api`).\n *\n * Returns workspace-relative paths (e.g. `/libs/shared/feature`) suitable\n * for merging into the `additional*Dirs` options.\n */\nexport function discoverLibraryRoutes(\n  workspaceRoot: string,\n): DiscoveredLibraryRoutes {\n  const result: DiscoveredLibraryRoutes = {\n    additionalPagesDirs: [],\n    additionalContentDirs: [],\n    additionalAPIDirs: [],\n  };\n  const normalizedWorkspaceRoot = toWorkspacePath(workspaceRoot);\n  const discovered = new Map<\n    string,\n    {\n      pages: boolean;\n      content: boolean;\n      api: boolean;\n    }\n  >();\n\n  for (const dir of globSync(discoverableLibRouteDirs, {\n    cwd: normalizedWorkspaceRoot,\n    dot: true,\n    onlyDirectories: true,\n  })) {\n    const normalizedDir = toWorkspacePath(dir);\n    const workspaceRelativeDir = normalizedDir.startsWith(\n      `${normalizedWorkspaceRoot}/`,\n    )\n      ? normalizedDir.slice(normalizedWorkspaceRoot.length + 1)\n      : normalizedDir;\n\n    if (!workspaceRelativeDir.startsWith('libs/')) {\n      continue;\n    }\n\n    const srcIndex = workspaceRelativeDir.indexOf('/src/');\n    if (srcIndex === -1) {\n      continue;\n    }\n\n    const libRoot = workspaceRelativeDir.slice(0, srcIndex);\n    const entry = discovered.get(libRoot) ?? {\n      pages: false,\n      content: false,\n      api: false,\n    };\n\n    if (workspaceRelativeDir.endsWith('/src/pages')) {\n      entry.pages = true;\n    }\n\n    if (workspaceRelativeDir.endsWith('/src/content')) {\n      entry.content = true;\n    }\n\n    if (workspaceRelativeDir.endsWith('/src/api')) {\n      entry.api = true;\n    }\n\n    discovered.set(libRoot, entry);\n  }\n\n  for (const libRoot of [...discovered.keys()].sort()) {\n    const entry = discovered.get(libRoot)!;\n\n    if (entry.pages) {\n      result.additionalPagesDirs.push(`/${libRoot}`);\n    }\n\n    if (entry.content) {\n      result.additionalContentDirs.push(`/${libRoot}/src/content`);\n    }\n\n    if (entry.api) {\n      result.additionalAPIDirs.push(`/${libRoot}/src/api`);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Builds `${dir}/**\\/*.page.ts` globs for each provided directory. The\n * platform registers these with Angular compilation through `analog.setup()`\n * for every `additionalPagesDirs` entry.\n */\nexport function pageGlobs(dirs: string[]): string[] {\n  return dirs.map((dir) => `${dir}/**/*.page.ts`);\n}\n"],"mappings":";;;AASuC,OAAO,OAAO;CACnD,qBAAqB,OAAO,OAAO,EAAE,CAAa;CAClD,uBAAuB,OAAO,OAAO,EAAE,CAAa;CACpD,mBAAmB,OAAO,OAAO,EAAE,CAAa;CACjD,CAAC;AAEF,IAAM,2BAA2B;CAC/B;CACA;CACA;CACD;AAED,SAAS,gBAAgB,MAAc;AACrC,QAAO,cAAc,KAAK,CAAC,QAAQ,OAAO,GAAG;;;;;;;;;AAU/C,SAAgB,sBACd,eACyB;CACzB,MAAM,SAAkC;EACtC,qBAAqB,EAAE;EACvB,uBAAuB,EAAE;EACzB,mBAAmB,EAAE;EACtB;CACD,MAAM,0BAA0B,gBAAgB,cAAc;CAC9D,MAAM,6BAAa,IAAI,KAOpB;AAEH,MAAK,MAAM,OAAO,SAAS,0BAA0B;EACnD,KAAK;EACL,KAAK;EACL,iBAAiB;EAClB,CAAC,EAAE;EACF,MAAM,gBAAgB,gBAAgB,IAAI;EAC1C,MAAM,uBAAuB,cAAc,WACzC,GAAG,wBAAwB,GAC5B,GACG,cAAc,MAAM,wBAAwB,SAAS,EAAE,GACvD;AAEJ,MAAI,CAAC,qBAAqB,WAAW,QAAQ,CAC3C;EAGF,MAAM,WAAW,qBAAqB,QAAQ,QAAQ;AACtD,MAAI,aAAa,GACf;EAGF,MAAM,UAAU,qBAAqB,MAAM,GAAG,SAAS;EACvD,MAAM,QAAQ,WAAW,IAAI,QAAQ,IAAI;GACvC,OAAO;GACP,SAAS;GACT,KAAK;GACN;AAED,MAAI,qBAAqB,SAAS,aAAa,CAC7C,OAAM,QAAQ;AAGhB,MAAI,qBAAqB,SAAS,eAAe,CAC/C,OAAM,UAAU;AAGlB,MAAI,qBAAqB,SAAS,WAAW,CAC3C,OAAM,MAAM;AAGd,aAAW,IAAI,SAAS,MAAM;;AAGhC,MAAK,MAAM,WAAW,CAAC,GAAG,WAAW,MAAM,CAAC,CAAC,MAAM,EAAE;EACnD,MAAM,QAAQ,WAAW,IAAI,QAAQ;AAErC,MAAI,MAAM,MACR,QAAO,oBAAoB,KAAK,IAAI,UAAU;AAGhD,MAAI,MAAM,QACR,QAAO,sBAAsB,KAAK,IAAI,QAAQ,cAAc;AAG9D,MAAI,MAAM,IACR,QAAO,kBAAkB,KAAK,IAAI,QAAQ,UAAU;;AAIxD,QAAO;;;;;;;AAQT,SAAgB,UAAU,MAA0B;AAClD,QAAO,KAAK,KAAK,QAAQ,GAAG,IAAI,eAAe"}

package/src/lib/i18n-component-registry-plugin.d.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from "vite";
+/**
+* Vite plugin that instruments compiled Angular component definitions with
+* calls to `registerI18nComponentDef()` from `@analogjs/router`. This
+* populates a process-level registry of component definitions that the
+* server renderer uses to null cached `tView` objects between SSR requests,
+* allowing `$localize` tagged templates in `consts()` to re-evaluate with
+* the freshly loaded translations for each request's locale.
+*
+* The plugin runs in `enforce: 'post'` so that it sees the compiled
+* JavaScript output from the Angular compiler (which contains the
+* `ClassName.ɵcmp = ɵɵdefineComponent({...})` assignments).
+*
+* Only active when the platform's `i18n` option is configured.
+* Only transforms modules loaded for the SSR environment.
+*/
+export declare function i18nComponentRegistryPlugin(): Plugin;

package/src/lib/i18n-component-registry-plugin.js

@@ -0,0 +1,100 @@
+import MagicString from "magic-string";
+//#region packages/platform/src/lib/i18n-component-registry-plugin.ts
+/**
+* Vite plugin that instruments compiled Angular component definitions with
+* calls to `registerI18nComponentDef()` from `@analogjs/router`. This
+* populates a process-level registry of component definitions that the
+* server renderer uses to null cached `tView` objects between SSR requests,
+* allowing `$localize` tagged templates in `consts()` to re-evaluate with
+* the freshly loaded translations for each request's locale.
+*
+* The plugin runs in `enforce: 'post'` so that it sees the compiled
+* JavaScript output from the Angular compiler (which contains the
+* `ClassName.ɵcmp = ɵɵdefineComponent({...})` assignments).
+*
+* Only active when the platform's `i18n` option is configured.
+* Only transforms modules loaded for the SSR environment.
+*/
+function i18nComponentRegistryPlugin() {
+	return {
+		name: "analogjs-i18n-component-registry",
+		enforce: "post",
+		transform(code, id, options) {
+			if (!options?.ssr) return;
+			if (!code.includes(".ɵcmp")) return;
+			if (id.includes("node_modules")) return;
+			if (!id.match(/\.(ts|js)(\?|$)/)) return;
+			const classNames = findComponentClassNames(this.parse(code));
+			if (classNames.size === 0) return;
+			const registrations = [...classNames].map((name) => `__analog_i18n_reg(${name});`).join("\n");
+			const s = new MagicString(code);
+			s.prepend(`import { ɵregisterI18nComponentDef as __analog_i18n_reg } from '@analogjs/router';\n`);
+			s.append(`\n${registrations}\n`);
+			return {
+				code: s.toString(),
+				map: s.generateMap({
+					hires: true,
+					source: id,
+					includeContent: true
+				})
+			};
+		}
+	};
+}
+/**
+* Walks the AST to find class names whose definitions include a `ɵcmp`
+* static property assignment — the marker Angular uses for compiled
+* component definitions.
+*
+* Handles two codegen styles:
+*
+* Production (tree-shaken):
+*   _ClassName.ɵcmp = ɵɵdefineComponent({...})
+*   → AssignmentExpression  left: MemberExpression(.ɵcmp)  object: Identifier
+*
+* Dev mode (class fields):
+*   class Foo { static { this.ɵcmp = i0.ɵɵdefineComponent({...}) } }
+*   → ClassDeclaration → StaticBlock → AssignmentExpression  left: MemberExpression(.ɵcmp) object: ThisExpression
+*/
+function findComponentClassNames(ast) {
+	const names = /* @__PURE__ */ new Set();
+	walk(ast, (node) => {
+		if (node.type === "AssignmentExpression" && isNode(node.left) && node.left.type === "MemberExpression" && isNode(node.left.property) && node.left.property.name === "ɵcmp" && isNode(node.left.object) && node.left.object.type === "Identifier") {
+			const name = node.left.object.name;
+			if (name !== "this") names.add(name);
+		}
+		if ((node.type === "ClassDeclaration" || node.type === "ClassExpression") && isNode(node.id) && node.id.name) {
+			const className = node.id.name;
+			if (classHasCmpDef(node)) names.add(className);
+		}
+	});
+	return names;
+}
+function classHasCmpDef(classNode) {
+	let found = false;
+	walk(classNode, (node) => {
+		if (found) return;
+		if (node.type === "PropertyDefinition" && node.static === true && isNode(node.key) && node.key.name === "ɵcmp") {
+			found = true;
+			return;
+		}
+		if (node.type === "AssignmentExpression" && isNode(node.left) && node.left.type === "MemberExpression" && isNode(node.left.property) && node.left.property.name === "ɵcmp" && isNode(node.left.object) && node.left.object.type === "ThisExpression") found = true;
+	});
+	return found;
+}
+function isNode(v) {
+	return v != null && typeof v === "object" && "type" in v;
+}
+function walk(node, visitor) {
+	visitor(node);
+	for (const key of Object.keys(node)) {
+		const child = node[key];
+		if (Array.isArray(child)) {
+			for (const item of child) if (isNode(item)) walk(item, visitor);
+		} else if (isNode(child)) walk(child, visitor);
+	}
+}
+//#endregion
+export { i18nComponentRegistryPlugin };
+
+//# sourceMappingURL=i18n-component-registry-plugin.js.map

package/src/lib/i18n-component-registry-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-component-registry-plugin.js","names":[],"sources":["../../../src/lib/i18n-component-registry-plugin.ts"],"sourcesContent":["import type { Plugin, TransformResult } from 'vite';\nimport MagicString from 'magic-string';\n\n/**\n * Vite plugin that instruments compiled Angular component definitions with\n * calls to `registerI18nComponentDef()` from `@analogjs/router`. This\n * populates a process-level registry of component definitions that the\n * server renderer uses to null cached `tView` objects between SSR requests,\n * allowing `$localize` tagged templates in `consts()` to re-evaluate with\n * the freshly loaded translations for each request's locale.\n *\n * The plugin runs in `enforce: 'post'` so that it sees the compiled\n * JavaScript output from the Angular compiler (which contains the\n * `ClassName.ɵcmp = ɵɵdefineComponent({...})` assignments).\n *\n * Only active when the platform's `i18n` option is configured.\n * Only transforms modules loaded for the SSR environment.\n */\nexport function i18nComponentRegistryPlugin(): Plugin {\n  return {\n    name: 'analogjs-i18n-component-registry',\n    enforce: 'post',\n\n    transform(code, id, options): TransformResult | undefined {\n      if (!options?.ssr) return;\n      if (!code.includes('.ɵcmp')) return;\n      if (id.includes('node_modules')) return;\n      if (!id.match(/\\.(ts|js)(\\?|$)/)) return;\n\n      const ast = this.parse(code) as unknown as AstNode;\n      const classNames = findComponentClassNames(ast);\n\n      if (classNames.size === 0) return;\n\n      const registrations = [...classNames]\n        .map((name) => `__analog_i18n_reg(${name});`)\n        .join('\\n');\n\n      // Use MagicString so the source map stays aligned with the original\n      // file — prepended imports and appended registration calls must not\n      // shift line numbers for frames that land inside the user's code.\n      const s = new MagicString(code);\n      s.prepend(\n        `import { ɵregisterI18nComponentDef as __analog_i18n_reg } from '@analogjs/router';\\n`,\n      );\n      s.append(`\\n${registrations}\\n`);\n\n      return {\n        code: s.toString(),\n        map: s.generateMap({\n          hires: true,\n          source: id,\n          includeContent: true,\n        }) as TransformResult['map'],\n      };\n    },\n  };\n}\n\n// Minimal ESTree node shape used by the walker.\ninterface AstNode {\n  type: string;\n  [key: string]: unknown;\n}\n\n/**\n * Walks the AST to find class names whose definitions include a `ɵcmp`\n * static property assignment — the marker Angular uses for compiled\n * component definitions.\n *\n * Handles two codegen styles:\n *\n * Production (tree-shaken):\n *   _ClassName.ɵcmp = ɵɵdefineComponent({...})\n *   → AssignmentExpression  left: MemberExpression(.ɵcmp)  object: Identifier\n *\n * Dev mode (class fields):\n *   class Foo { static { this.ɵcmp = i0.ɵɵdefineComponent({...}) } }\n *   → ClassDeclaration → StaticBlock → AssignmentExpression  left: MemberExpression(.ɵcmp) object: ThisExpression\n */\nfunction findComponentClassNames(ast: AstNode): Set<string> {\n  const names = new Set<string>();\n\n  walk(ast, (node: any) => {\n    // Prod: top-level `Identifier.ɵcmp = ...`\n    if (\n      node.type === 'AssignmentExpression' &&\n      isNode(node.left) &&\n      node.left.type === 'MemberExpression' &&\n      isNode(node.left.property) &&\n      (node.left.property as AstNode & { name?: string }).name === 'ɵcmp' &&\n      isNode(node.left.object) &&\n      node.left.object.type === 'Identifier'\n    ) {\n      const name = (node.left.object as AstNode & { name: string }).name;\n      if (name !== 'this') {\n        names.add(name);\n      }\n    }\n\n    // Dev: ClassDeclaration containing `this.ɵcmp = ...` in a static block\n    if (\n      (node.type === 'ClassDeclaration' || node.type === 'ClassExpression') &&\n      isNode(node.id) &&\n      (node.id as AstNode & { name?: string }).name\n    ) {\n      const className = (node.id as AstNode & { name: string }).name;\n      if (classHasCmpDef(node)) {\n        names.add(className);\n      }\n    }\n  });\n\n  return names;\n}\n\nfunction classHasCmpDef(classNode: AstNode): boolean {\n  let found = false;\n\n  walk(classNode, (node: any) => {\n    if (found) return;\n\n    // static ɵcmp = ... (PropertyDefinition)\n    if (\n      node.type === 'PropertyDefinition' &&\n      node.static === true &&\n      isNode(node.key) &&\n      (node.key as AstNode & { name?: string }).name === 'ɵcmp'\n    ) {\n      found = true;\n      return;\n    }\n\n    // static { this.ɵcmp = ... }\n    if (\n      node.type === 'AssignmentExpression' &&\n      isNode(node.left) &&\n      node.left.type === 'MemberExpression' &&\n      isNode(node.left.property) &&\n      (node.left.property as AstNode & { name?: string }).name === 'ɵcmp' &&\n      isNode(node.left.object) &&\n      node.left.object.type === 'ThisExpression'\n    ) {\n      found = true;\n    }\n  });\n\n  return found;\n}\n\nfunction isNode(v: unknown): v is AstNode {\n  return v != null && typeof v === 'object' && 'type' in (v as object);\n}\n\nfunction walk(node: AstNode, visitor: (n: AstNode) => void): void {\n  visitor(node);\n  for (const key of Object.keys(node)) {\n    const child = node[key];\n    if (Array.isArray(child)) {\n      for (const item of child) {\n        if (isNode(item)) walk(item, visitor);\n      }\n    } else if (isNode(child)) {\n      walk(child, visitor);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAgB,8BAAsC;AACpD,QAAO;EACL,MAAM;EACN,SAAS;EAET,UAAU,MAAM,IAAI,SAAsC;AACxD,OAAI,CAAC,SAAS,IAAK;AACnB,OAAI,CAAC,KAAK,SAAS,QAAQ,CAAE;AAC7B,OAAI,GAAG,SAAS,eAAe,CAAE;AACjC,OAAI,CAAC,GAAG,MAAM,kBAAkB,CAAE;GAGlC,MAAM,aAAa,wBADP,KAAK,MAAM,KAAK,CACmB;AAE/C,OAAI,WAAW,SAAS,EAAG;GAE3B,MAAM,gBAAgB,CAAC,GAAG,WAAW,CAClC,KAAK,SAAS,qBAAqB,KAAK,IAAI,CAC5C,KAAK,KAAK;GAKb,MAAM,IAAI,IAAI,YAAY,KAAK;AAC/B,KAAE,QACA,uFACD;AACD,KAAE,OAAO,KAAK,cAAc,IAAI;AAEhC,UAAO;IACL,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,YAAY;KACjB,OAAO;KACP,QAAQ;KACR,gBAAgB;KACjB,CAAC;IACH;;EAEJ;;;;;;;;;;;;;;;;;AAwBH,SAAS,wBAAwB,KAA2B;CAC1D,MAAM,wBAAQ,IAAI,KAAa;AAE/B,MAAK,MAAM,SAAc;AAEvB,MACE,KAAK,SAAS,0BACd,OAAO,KAAK,KAAK,IACjB,KAAK,KAAK,SAAS,sBACnB,OAAO,KAAK,KAAK,SAAS,IACzB,KAAK,KAAK,SAAyC,SAAS,UAC7D,OAAO,KAAK,KAAK,OAAO,IACxB,KAAK,KAAK,OAAO,SAAS,cAC1B;GACA,MAAM,OAAQ,KAAK,KAAK,OAAsC;AAC9D,OAAI,SAAS,OACX,OAAM,IAAI,KAAK;;AAKnB,OACG,KAAK,SAAS,sBAAsB,KAAK,SAAS,sBACnD,OAAO,KAAK,GAAG,IACd,KAAK,GAAmC,MACzC;GACA,MAAM,YAAa,KAAK,GAAkC;AAC1D,OAAI,eAAe,KAAK,CACtB,OAAM,IAAI,UAAU;;GAGxB;AAEF,QAAO;;AAGT,SAAS,eAAe,WAA6B;CACnD,IAAI,QAAQ;AAEZ,MAAK,YAAY,SAAc;AAC7B,MAAI,MAAO;AAGX,MACE,KAAK,SAAS,wBACd,KAAK,WAAW,QAChB,OAAO,KAAK,IAAI,IACf,KAAK,IAAoC,SAAS,QACnD;AACA,WAAQ;AACR;;AAIF,MACE,KAAK,SAAS,0BACd,OAAO,KAAK,KAAK,IACjB,KAAK,KAAK,SAAS,sBACnB,OAAO,KAAK,KAAK,SAAS,IACzB,KAAK,KAAK,SAAyC,SAAS,UAC7D,OAAO,KAAK,KAAK,OAAO,IACxB,KAAK,KAAK,OAAO,SAAS,iBAE1B,SAAQ;GAEV;AAEF,QAAO;;AAGT,SAAS,OAAO,GAA0B;AACxC,QAAO,KAAK,QAAQ,OAAO,MAAM,YAAY,UAAW;;AAG1D,SAAS,KAAK,MAAe,SAAqC;AAChE,SAAQ,KAAK;AACb,MAAK,MAAM,OAAO,OAAO,KAAK,KAAK,EAAE;EACnC,MAAM,QAAQ,KAAK;AACnB,MAAI,MAAM,QAAQ,MAAM;QACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,KAAK,CAAE,MAAK,MAAM,QAAQ;aAE9B,OAAO,MAAM,CACtB,MAAK,OAAO,QAAQ"}

package/src/lib/i18n-extract-plugin.d.ts

@@ -0,0 +1,33 @@
+import { Plugin } from "vite";
+import { I18nOptions } from "./options.js";
+/**
+* Vite plugin that extracts i18n messages from compiled JavaScript output.
+*
+* After the client build completes, this plugin scans all `.js` files in the
+* output directory for `$localize` tagged template literals and extracts the
+* message IDs and source text. It then writes the extracted messages to a
+* translation source file.
+*
+* Uses `@angular/localize/tools` MessageExtractor when available,
+* falling back to a regex-based extractor.
+*/
+export declare function i18nExtractPlugin(i18nOptions: I18nOptions): Plugin;
+export interface ExtractedMessage {
+	id: string;
+	text: string;
+	description?: string;
+}
+/**
+* Regex-based fallback extractor for when @angular/localize/tools is not available.
+*
+* Parses `$localize` tagged template literals to extract message IDs and text.
+* Handles the common forms:
+*   $localize`:@@messageId:text`
+*   $localize`:description@@messageId:text`
+*   $localize`text`
+*/
+export declare function extractWithRegex(files: string[]): ExtractedMessage[];
+/**
+* Serializes extracted messages into the specified format.
+*/
+export declare function serializeMessages(messages: ExtractedMessage[], format: string, sourceLocale: string): string;

package/src/lib/inject-server-fn-ids.d.ts

@@ -0,0 +1,17 @@
+export interface InjectServerFnIdsResult {
+	code: string;
+	ids: {
+		name: string;
+		id: string;
+	}[];
+}
+/**
+* Server/SSR-build transform: injects the derived `id` into each
+* `export const NAME = serverFn(config, handler)` so the function registers
+* under the same opaque id the client proxy dispatches to. Unlike the client
+* scrub this keeps the handler and every other statement intact — it only edits
+* the config object — so the server module still runs the real implementation.
+*
+* Returns `null` when the module defines no server function.
+*/
+export declare function injectServerFnIds(code: string, fileId: string): InjectServerFnIdsResult | null;