@analogjs/vite-plugin-angular 3.0.0-alpha.41 → 3.0.0-alpha.43

package/src/lib/encapsulation-plugin.js

@@ -0,0 +1,48 @@
+import { debugStylesV } from "./utils/debug.js";
+import * as ngCompiler from "@angular/compiler";
+//#region packages/vite-plugin-angular/src/lib/encapsulation-plugin.ts
+function isComponentStyleSheet(id) {
+	return id.includes("ngcomp=");
+}
+function getComponentStyleSheetMeta(id) {
+	const params = new URL(id, "http://localhost").searchParams;
+	return {
+		componentId: params.get("ngcomp"),
+		encapsulation: {
+			"0": "emulated",
+			"2": "none",
+			"3": "shadow"
+		}[params.get("e")]
+	};
+}
+/**
+* Encapsulation runs in enforce: 'post' so that @tailwindcss/vite
+* (enforce: 'pre') fully resolves @apply directives — including those
+* inside :host {} — before Angular's ShadowCss rewrites selectors.
+* (#2293)
+*/
+function encapsulationPlugin(shouldExternalizeStyles) {
+	return {
+		name: "@analogjs/vite-plugin-angular:encapsulation",
+		enforce: "post",
+		transform(code, id) {
+			if (shouldExternalizeStyles() && isComponentStyleSheet(id)) {
+				const { encapsulation, componentId } = getComponentStyleSheetMeta(id);
+				if (encapsulation === "emulated" && componentId) {
+					debugStylesV("applying emulated view encapsulation (post)", {
+						stylesheet: id.split("?")[0],
+						componentId
+					});
+					return {
+						code: ngCompiler.encapsulateStyle(code, componentId),
+						map: null
+					};
+				}
+			}
+		}
+	};
+}
+//#endregion
+export { encapsulationPlugin, getComponentStyleSheetMeta, isComponentStyleSheet };
+
+//# sourceMappingURL=encapsulation-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encapsulation-plugin.js","names":[],"sources":["../../../src/lib/encapsulation-plugin.ts"],"sourcesContent":["import * as ngCompiler from '@angular/compiler';\nimport { Plugin } from 'vite';\nimport { debugStylesV } from './utils/debug.js';\n\nexport function isComponentStyleSheet(id: string): boolean {\n  return id.includes('ngcomp=');\n}\n\nexport function getComponentStyleSheetMeta(id: string): {\n  componentId: string;\n  encapsulation: 'emulated' | 'shadow' | 'none';\n} {\n  const params = new URL(id, 'http://localhost').searchParams;\n  const encapsulationMapping = {\n    '0': 'emulated',\n    '2': 'none',\n    '3': 'shadow',\n  };\n  return {\n    componentId: params.get('ngcomp')!,\n    encapsulation: encapsulationMapping[\n      params.get('e') as keyof typeof encapsulationMapping\n    ] as 'emulated' | 'shadow' | 'none',\n  };\n}\n\n/**\n * Encapsulation runs in enforce: 'post' so that @tailwindcss/vite\n * (enforce: 'pre') fully resolves @apply directives — including those\n * inside :host {} — before Angular's ShadowCss rewrites selectors.\n * (#2293)\n */\nexport function encapsulationPlugin(\n  shouldExternalizeStyles: () => boolean,\n): Plugin {\n  return {\n    name: '@analogjs/vite-plugin-angular:encapsulation',\n    enforce: 'post',\n    transform(code: string, id: string) {\n      if (shouldExternalizeStyles() && isComponentStyleSheet(id)) {\n        const { encapsulation, componentId } = getComponentStyleSheetMeta(id);\n        if (encapsulation === 'emulated' && componentId) {\n          debugStylesV('applying emulated view encapsulation (post)', {\n            stylesheet: id.split('?')[0],\n            componentId,\n          });\n          const encapsulated = ngCompiler.encapsulateStyle(code, componentId);\n          return {\n            code: encapsulated,\n            map: null,\n          };\n        }\n      }\n    },\n  };\n}\n"],"mappings":";;;AAIA,SAAgB,sBAAsB,IAAqB;AACzD,QAAO,GAAG,SAAS,UAAU;;AAG/B,SAAgB,2BAA2B,IAGzC;CACA,MAAM,SAAS,IAAI,IAAI,IAAI,mBAAmB,CAAC;AAM/C,QAAO;EACL,aAAa,OAAO,IAAI,SAAS;EACjC,eAP2B;GAC3B,KAAK;GACL,KAAK;GACL,KAAK;GACN,CAIG,OAAO,IAAI,IAAI;EAElB;;;;;;;;AASH,SAAgB,oBACd,yBACQ;AACR,QAAO;EACL,MAAM;EACN,SAAS;EACT,UAAU,MAAc,IAAY;AAClC,OAAI,yBAAyB,IAAI,sBAAsB,GAAG,EAAE;IAC1D,MAAM,EAAE,eAAe,gBAAgB,2BAA2B,GAAG;AACrE,QAAI,kBAAkB,cAAc,aAAa;AAC/C,kBAAa,+CAA+C;MAC1D,YAAY,GAAG,MAAM,IAAI,CAAC;MAC1B;MACD,CAAC;AAEF,YAAO;MACL,MAFmB,WAAW,iBAAiB,MAAM,YAAY;MAGjE,KAAK;MACN;;;;EAIR"}

package/src/lib/fast-compile-plugin.js

@@ -1,5 +1,4 @@
-import { toVirtualRawId, toVirtualStyleId } from "./utils/virtual-ids.js";
-import { loadVirtualRawModule, loadVirtualStyleModule, rewriteHtmlRawImport, rewriteInlineStyleImport, shouldPreprocessTestCss } from "./utils/virtual-resources.js";
+import { TS_EXT_REGEX, createDepOptimizerConfig, getTsConfigPath } from "./utils/plugin-config.js";
 import { debugCompile, debugRegistry } from "./compiler/debug.js";
 import { compile } from "./compiler/compile.js";
 import { scanFile } from "./compiler/registry.js";
@@ -8,12 +7,11 @@ import { jitTransform } from "./compiler/jit-transform.js";
 import { generateHmrCode } from "./compiler/hmr.js";
 import { extractInlineStyles, inlineResourceUrls } from "./compiler/resource-inliner.js";
 import "./compiler/index.js";
-import { TS_EXT_REGEX, createDepOptimizerConfig, getTsConfigPath } from "./utils/plugin-config.js";
 import { promises } from "node:fs";
 import { dirname, resolve } from "node:path";
 import * as compilerCli from "@angular/compiler-cli";
 import * as vite from "vite";
-import { defaultClientConditions, normalizePath, preprocessCSS } from "vite";
+import { defaultClientConditions, preprocessCSS } from "vite";
 //#region packages/vite-plugin-angular/src/lib/fast-compile-plugin.ts
 function fastCompilePlugin(pluginOptions) {
 	let resolvedConfig;
@@ -223,30 +221,6 @@ function fastCompilePlugin(pluginOptions) {
 			}
 			return ctx.modules;
 		},
-		resolveId(id, importer) {
-			if (id.startsWith("virtual:@analogjs/vite-plugin-angular:inline-style:") || id.startsWith("virtual:@analogjs/vite-plugin-angular:raw:")) return `\0${id}`;
-			if (pluginOptions.jit && id.startsWith("angular:jit:")) {
-				const filePath = normalizePath(resolve(dirname(importer), id.split(";")[1]));
-				return id.includes(":style") ? toVirtualStyleId(filePath) : toVirtualRawId(filePath);
-			}
-			const rawRewrite = rewriteHtmlRawImport(id, importer);
-			if (rawRewrite) return rawRewrite;
-			const inlineRewrite = rewriteInlineStyleImport(id, importer);
-			if (inlineRewrite) return inlineRewrite;
-		},
-		async load(id) {
-			const styleModule = await loadVirtualStyleModule(this, id, resolvedConfig);
-			if (styleModule !== void 0) return styleModule;
-			const rawModule = await loadVirtualRawModule(this, id);
-			if (rawModule !== void 0) return rawModule;
-			if (/\.(css|scss|sass|less)\?inline$/.test(id)) {
-				const filePath = id.split("?")[0];
-				const code = await promises.readFile(filePath, "utf-8");
-				if (!shouldPreprocessTestCss(resolvedConfig, filePath)) return `export default ${JSON.stringify(code)}`;
-				const result = await preprocessCSS(code, filePath, resolvedConfig);
-				return `export default ${JSON.stringify(result.code)}`;
-			}
-		},
 		transform: {
 			filter: { id: {
 				include: [TS_EXT_REGEX],

package/src/lib/fast-compile-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"fast-compile-plugin.js","names":[],"sources":["../../../src/lib/fast-compile-plugin.ts"],"sourcesContent":["import { promises as fsPromises } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport * as vite from 'vite';\n\nimport * as compilerCli from '@angular/compiler-cli';\nimport {\n  defaultClientConditions,\n  normalizePath,\n  Plugin,\n  preprocessCSS,\n  ResolvedConfig,\n} from 'vite';\n\nimport {\n  compile,\n  scanFile,\n  scanPackageDts,\n  collectImportedPackages,\n  collectRelativeReExports,\n  jitTransform,\n  inlineResourceUrls,\n  extractInlineStyles,\n  generateHmrCode,\n  debugCompile,\n  debugRegistry,\n  type ComponentRegistry,\n} from './compiler/index.js';\n\nimport {\n  TS_EXT_REGEX,\n  getTsConfigPath,\n  createDepOptimizerConfig,\n  type TsConfigResolutionContext,\n} from './utils/plugin-config.js';\nimport {\n  VIRTUAL_RAW_PREFIX,\n  VIRTUAL_STYLE_PREFIX,\n  toVirtualRawId,\n  toVirtualStyleId,\n} from './utils/virtual-ids.js';\nimport {\n  loadVirtualRawModule,\n  loadVirtualStyleModule,\n  rewriteHtmlRawImport,\n  rewriteInlineStyleImport,\n  shouldPreprocessTestCss,\n} from './utils/virtual-resources.js';\n\nexport interface FastCompilePluginOptions {\n  tsconfigGetter: () => string;\n  workspaceRoot: string;\n  inlineStylesExtension: string;\n  jit: boolean;\n  liveReload: boolean;\n  supportedBrowsers: string[];\n  transformFilter?: (code: string, id: string) => boolean;\n  isTest: boolean;\n  isAstroIntegration: boolean;\n  fastCompileMode?: 'full' | 'partial';\n}\n\nexport function fastCompilePlugin(\n  pluginOptions: FastCompilePluginOptions,\n): Plugin {\n  let resolvedConfig: ResolvedConfig;\n  let tsConfigResolutionContext: TsConfigResolutionContext | null = null;\n  let watchMode = false;\n\n  // fast-compile plugin state\n  const registry: ComponentRegistry = new Map();\n  const resourceToSource = new Map<string, string>();\n  const scannedDtsPackages = new Set<string>();\n  let projectRoot = '';\n  let useDefineForClassFields = true;\n\n  /**\n   * Scan a file into the registry, then recursively walk its relative\n   * `export *` / `export { … } from './x'` chain so any underlying\n   * directive classes also land in the registry. Used both at\n   * `buildStart` (for tsconfig path entries) and at dev time (file\n   * `add` and `handleHotUpdate`) so newly added barrels stay in sync\n   * without requiring a server restart.\n   *\n   * The `visited` set prevents infinite recursion within a single\n   * top-level call. Each fresh scan should pass an empty set (so HMR\n   * re-scans aren't blocked by buildStart's earlier visits).\n   */\n  async function scanBarrelExports(\n    file: string,\n    visited: Set<string> = new Set(),\n    overwrite = false,\n  ): Promise<void> {\n    if (visited.has(file)) return;\n    visited.add(file);\n    let code: string;\n    try {\n      code = await fsPromises.readFile(file, 'utf-8');\n    } catch (e) {\n      if (debugRegistry.enabled) {\n        debugRegistry(\n          'scanBarrelExports: failed to read %s: %s',\n          file,\n          (e as Error)?.message,\n        );\n      }\n      return;\n    }\n    const entries = scanFile(code, file);\n    for (const entry of entries) {\n      // At buildStart we want stable registry entries (don't overwrite\n      // an earlier scan with a barrel re-scan); HMR explicitly asks\n      // for overwrite so updated metadata replaces stale entries.\n      if (overwrite || !registry.has(entry.className)) {\n        registry.set(entry.className, entry);\n      }\n    }\n    // Collect every relative re-export specifier via OXC AST so\n    // recursive scans can't trip over each other (a shared `/g` regex\n    // would have its `lastIndex` reset by each recursive call and\n    // silently skip half of an outer barrel's re-exports, which\n    // previously left directives like `HlmRadioGroup` unregistered).\n    const dir = dirname(file);\n    for (const rel of collectRelativeReExports(code, file)) {\n      // NodeNext-style libraries write `export * from './foo.js'`\n      // even though the source is `./foo.ts`. Strip the ESM\n      // extension before probing or the candidates would be\n      // `foo.js.ts` / `foo.js/index.ts`, which never exist.\n      const normalizedRel = rel.replace(/\\.(?:js|mjs)$/u, '');\n      const reExportCandidates = [\n        resolve(dir, normalizedRel + '.ts'),\n        resolve(dir, normalizedRel, 'index.ts'),\n      ];\n      let resolved = false;\n      for (const candidate of reExportCandidates) {\n        try {\n          await fsPromises.access(candidate);\n          await scanBarrelExports(candidate, visited, overwrite);\n          resolved = true;\n          break;\n        } catch {\n          // try next candidate\n        }\n      }\n      if (!resolved && debugRegistry.enabled) {\n        debugRegistry(\n          'scanBarrelExports: %s re-export %s did not resolve to %o',\n          file,\n          rel,\n          reExportCandidates,\n        );\n      }\n    }\n  }\n\n  async function initFastCompile() {\n    if (pluginOptions.jit) return; // JIT: no registry scan needed\n\n    // Scan all source files to build the registry\n    registry.clear();\n    scannedDtsPackages.clear();\n    const resolvedTsConfigPath = resolveTsConfigPath();\n    projectRoot = dirname(resolvedTsConfigPath);\n    const config = compilerCli.readConfiguration(resolvedTsConfigPath);\n    useDefineForClassFields = config.options?.useDefineForClassFields ?? true;\n\n    // Collect candidate files: tsconfig rootNames PLUS the entry points\n    // named in `compilerOptions.paths`. App tsconfigs typically only\n    // include the app's own sources, so workspace library entry barrels\n    // (e.g. `HlmSelectImports = [HlmSelect, HlmSelectContent, ...] as\n    // const`) live outside `rootNames` and would otherwise miss the\n    // initial scan. The compiler then can't see that `HlmSelectImports`\n    // is a tuple barrel and emits the bare identifier into the parent\n    // component's `dependencies()` list, where Angular's runtime\n    // silently drops it because arrays don't have a directive def.\n    const candidates = new Set<string>(config.rootNames);\n    const tsPaths = config.options?.paths;\n    const baseUrl = (config.options?.baseUrl ?? projectRoot) as string;\n    if (tsPaths) {\n      for (const targets of Object.values(tsPaths)) {\n        for (const target of targets as string[]) {\n          // Skip wildcard patterns — entry barrels are normally exact\n          // file paths like \"libs/helm/select/src/index.ts\".\n          if (target.includes('*')) continue;\n          candidates.add(resolve(baseUrl, target));\n        }\n      }\n    }\n    const results = await Promise.all(\n      Array.from(candidates).map(async (file) => {\n        try {\n          const code = await fsPromises.readFile(file, 'utf-8');\n          return scanFile(code, file);\n        } catch (e) {\n          if (debugRegistry.enabled) {\n            debugRegistry(\n              'initFastCompile: skipping unreadable %s: %s',\n              file,\n              (e as Error)?.message,\n            );\n          }\n          return []; // Skip unreadable files\n        }\n      }),\n    );\n\n    for (const entries of results) {\n      for (const entry of entries) {\n        registry.set(entry.className, entry);\n      }\n    }\n\n    // Library barrels typically `export * from './lib/...'` rather than\n    // declaring directives directly, so the entry file alone gives us\n    // the tuple consts but not the directive classes they reference.\n    // Walk the relative `export *` chain so the underlying classes also\n    // land in the registry. Use a SHARED visited set across all\n    // barrels so recursive walks don't double-scan a file that's\n    // re-exported from multiple entry points.\n    const buildStartVisited = new Set<string>();\n    if (tsPaths) {\n      const barrelCandidates: string[] = [];\n      for (const targets of Object.values(tsPaths)) {\n        for (const target of targets as string[]) {\n          if (target.includes('*')) continue;\n          barrelCandidates.push(resolve(baseUrl, target));\n        }\n      }\n      await Promise.all(\n        barrelCandidates.map((c) => scanBarrelExports(c, buildStartVisited)),\n      );\n    }\n    debugRegistry(\n      'initFastCompile done: %d entries from %d candidate files',\n      registry.size,\n      candidates.size,\n    );\n  }\n\n  function ensureDtsRegistryForSource(code: string, id: string) {\n    for (const pkg of collectImportedPackages(code, id)) {\n      if (scannedDtsPackages.has(pkg)) continue;\n      scannedDtsPackages.add(pkg);\n\n      try {\n        const dtsEntries = scanPackageDts(pkg, projectRoot);\n        for (const entry of dtsEntries) {\n          if (!registry.has(entry.className)) {\n            registry.set(entry.className, entry);\n          }\n        }\n      } catch {\n        // Package may not have .d.ts files or may not be Angular\n      }\n    }\n  }\n\n  async function handleFastCompileTransform(\n    code: string,\n    id: string,\n  ): Promise<{ code: string; map: any } | undefined> {\n    if (!/(Component|Directive|Pipe|Injectable|NgModule)\\(/.test(code)) {\n      // Non-Angular file — leave it alone so a downstream plugin (or\n      // Vite's built-in TS handler) can process it.\n      return undefined;\n    }\n\n    // JIT mode\n    if (pluginOptions.jit) {\n      const result = jitTransform(code, id);\n      return { code: result.code, map: result.map };\n    }\n\n    // Inline external templateUrl/styleUrl(s) into the source before compilation\n    code = inlineResourceUrls(code, id);\n\n    // Pre-resolve inline styles that need preprocessing (SCSS/Sass/Less)\n    let resolvedStyles: Map<string, string> | undefined;\n    let resolvedInlineStyles: Map<number, string> | undefined;\n\n    if (pluginOptions.inlineStylesExtension !== 'css') {\n      const styleStrings = extractInlineStyles(code, id);\n\n      if (styleStrings.length > 0) {\n        resolvedInlineStyles = new Map();\n        for (let i = 0; i < styleStrings.length; i++) {\n          try {\n            const fakePath = id.replace(\n              /\\.ts$/,\n              `.inline-${i}.${pluginOptions.inlineStylesExtension}`,\n            );\n            // In tests, mirror Vitest's `test.css` rules — defaults to no\n            // preprocessing (matches Vite's CSS pipeline behavior). (#2297)\n            if (!shouldPreprocessTestCss(resolvedConfig, fakePath)) {\n              resolvedInlineStyles.set(i, styleStrings[i]);\n              continue;\n            }\n            const processed = await preprocessCSS(\n              styleStrings[i],\n              fakePath,\n              resolvedConfig,\n            );\n            resolvedInlineStyles.set(i, processed.code);\n          } catch (e) {\n            if (debugCompile.enabled) {\n              debugCompile(\n                'inline style #%d preprocessing failed in %s: %s',\n                i,\n                id,\n                (e as Error)?.message,\n              );\n            }\n            // Skip styles that can't be preprocessed\n          }\n        }\n        if (resolvedInlineStyles.size === 0) resolvedInlineStyles = undefined;\n      }\n    }\n\n    ensureDtsRegistryForSource(code, id);\n\n    const result = compile(code, id, {\n      registry,\n      resolvedStyles,\n      resolvedInlineStyles,\n      useDefineForClassFields,\n      compilationMode: pluginOptions.fastCompileMode,\n    });\n\n    // Track resource dependencies for HMR\n    for (const dep of result.resourceDependencies) {\n      resourceToSource.set(dep, id);\n    }\n\n    // Strip TypeScript-only syntax\n    const stripped = vite.transformWithOxc\n      ? await vite.transformWithOxc(result.code, id, {\n          lang: 'ts',\n          sourcemap: false,\n          decorator: { legacy: false, emitDecoratorMetadata: false },\n        })\n      : await vite.transformWithEsbuild(result.code, id, {\n          loader: 'ts',\n          sourcemap: false,\n        });\n    let outputCode = stripped.code;\n\n    // Append HMR code in dev mode\n    if (watchMode && pluginOptions.liveReload) {\n      const fileDeclarations = [...registry.values()].filter(\n        (e) => e.fileName === id,\n      );\n      if (fileDeclarations.length > 0) {\n        const localDepClassNames = fileDeclarations.map((e) => e.className);\n        outputCode += generateHmrCode(fileDeclarations, localDepClassNames);\n      }\n    }\n\n    return { code: outputCode, map: result.map };\n  }\n\n  function resolveTsConfigPath() {\n    const { root, isProd, isLib } = tsConfigResolutionContext!;\n    return getTsConfigPath(\n      root,\n      pluginOptions.tsconfigGetter(),\n      isProd,\n      pluginOptions.isTest,\n      isLib,\n    );\n  }\n\n  return {\n    name: '@analogjs/vite-plugin-angular-fast-compile',\n    enforce: 'pre' as const,\n    async config(config, { command }) {\n      watchMode = command === 'serve';\n      const isProd =\n        config.mode === 'production' ||\n        process.env['NODE_ENV'] === 'production';\n\n      tsConfigResolutionContext = {\n        root: config.root || '.',\n        isProd,\n        isLib: !!config?.build?.lib,\n      };\n\n      const preliminaryTsConfigPath = resolveTsConfigPath();\n\n      const depOptimizer = createDepOptimizerConfig({\n        tsconfig: preliminaryTsConfigPath,\n        isProd,\n        jit: pluginOptions.jit,\n        watchMode,\n        isTest: pluginOptions.isTest,\n        isAstroIntegration: pluginOptions.isAstroIntegration,\n      });\n\n      return {\n        ...(vite.rolldownVersion ? { oxc: {} as any } : { esbuild: false }),\n        ...depOptimizer,\n        resolve: {\n          conditions: [\n            ...depOptimizer.resolve.conditions,\n            ...(config.resolve?.conditions || defaultClientConditions),\n          ],\n        },\n      };\n    },\n    configResolved(config) {\n      resolvedConfig = config;\n    },\n    configureServer(server) {\n      // Watch for new .ts files and scan them into the registry. Use\n      // the barrel-aware scanner so a newly added re-export entry\n      // (`export * from './x'`) also expands its underlying directive\n      // classes — otherwise the registry stays stale until restart.\n      server.watcher.on('add', async (filePath) => {\n        if (\n          filePath.endsWith('.ts') &&\n          !filePath.endsWith('.spec.ts') &&\n          !filePath.endsWith('.d.ts')\n        ) {\n          await scanBarrelExports(filePath, new Set(), true);\n        }\n      });\n    },\n    async buildStart() {\n      await initFastCompile();\n    },\n    async handleHotUpdate(ctx) {\n      // Resource file changes → invalidate parent .ts module\n      if (resourceToSource.has(ctx.file)) {\n        const parentSource = resourceToSource.get(ctx.file)!;\n        const parentModule = ctx.server.moduleGraph.getModuleById(parentSource);\n        if (parentModule) {\n          return [parentModule];\n        }\n      }\n\n      if (TS_EXT_REGEX.test(ctx.file)) {\n        const [fileId] = ctx.file.split('?');\n\n        // Remove old entries from this file\n        const oldEntries = [...registry.entries()]\n          .filter(([_, v]) => v.fileName === fileId)\n          .map(([k]) => k);\n        for (const key of oldEntries) {\n          registry.delete(key);\n        }\n\n        // Rescan the changed file via the barrel-aware scanner so an\n        // edited barrel re-export picks up newly-referenced files.\n        // Pass overwrite=true so updated metadata replaces stale\n        // entries from the previous scan.\n        await scanBarrelExports(fileId, new Set(), true);\n      }\n\n      // Let Vite handle the rest — the transform hook will recompile\n      return ctx.modules;\n    },\n    resolveId(id, importer) {\n      if (\n        id.startsWith(VIRTUAL_STYLE_PREFIX) ||\n        id.startsWith(VIRTUAL_RAW_PREFIX)\n      ) {\n        return `\\0${id}`;\n      }\n\n      if (pluginOptions.jit && id.startsWith('angular:jit:')) {\n        const filePath = normalizePath(\n          resolve(dirname(importer as string), id.split(';')[1]),\n        );\n        return id.includes(':style')\n          ? toVirtualStyleId(filePath)\n          : toVirtualRawId(filePath);\n      }\n\n      const rawRewrite = rewriteHtmlRawImport(id, importer);\n      if (rawRewrite) return rawRewrite;\n\n      const inlineRewrite = rewriteInlineStyleImport(id, importer);\n      if (inlineRewrite) return inlineRewrite;\n\n      return undefined;\n    },\n    async load(id) {\n      const styleModule = await loadVirtualStyleModule(\n        this,\n        id,\n        resolvedConfig,\n      );\n      if (styleModule !== undefined) return styleModule;\n\n      const rawModule = await loadVirtualRawModule(this, id);\n      if (rawModule !== undefined) return rawModule;\n\n      // Vitest bypass: module-runner skips resolveId, so the bare `?inline`\n      // query reaches load unchanged.\n      if (/\\.(css|scss|sass|less)\\?inline$/.test(id)) {\n        const filePath = id.split('?')[0];\n        const code = await fsPromises.readFile(filePath, 'utf-8');\n        // In tests, mirror Vitest's `test.css` rules — defaults to no\n        // preprocessing (matches Vite's CSS pipeline behavior). (#2297)\n        if (!shouldPreprocessTestCss(resolvedConfig, filePath)) {\n          return `export default ${JSON.stringify(code)}`;\n        }\n        const result = await preprocessCSS(code, filePath, resolvedConfig);\n        return `export default ${JSON.stringify(result.code)}`;\n      }\n\n      return;\n    },\n    transform: {\n      filter: {\n        id: {\n          include: [TS_EXT_REGEX],\n          exclude: [/node_modules/, 'type=script', '@ng/component'],\n        },\n      },\n      async handler(code, id) {\n        if (\n          pluginOptions.transformFilter &&\n          !(pluginOptions.transformFilter(code, id) ?? true)\n        ) {\n          return;\n        }\n\n        if (id.includes('.ts?')) {\n          id = id.replace(/\\?(.*)/, '');\n        }\n        return handleFastCompileTransform(code, id);\n      },\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"fast-compile-plugin.js","names":[],"sources":["../../../src/lib/fast-compile-plugin.ts"],"sourcesContent":["import { promises as fsPromises } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport * as vite from 'vite';\n\nimport * as compilerCli from '@angular/compiler-cli';\nimport {\n  defaultClientConditions,\n  normalizePath,\n  Plugin,\n  preprocessCSS,\n  ResolvedConfig,\n} from 'vite';\n\nimport {\n  compile,\n  scanFile,\n  scanPackageDts,\n  collectImportedPackages,\n  collectRelativeReExports,\n  jitTransform,\n  inlineResourceUrls,\n  extractInlineStyles,\n  generateHmrCode,\n  debugCompile,\n  debugRegistry,\n  type ComponentRegistry,\n} from './compiler/index.js';\n\nimport {\n  TS_EXT_REGEX,\n  getTsConfigPath,\n  createDepOptimizerConfig,\n  type TsConfigResolutionContext,\n} from './utils/plugin-config.js';\n\nexport interface FastCompilePluginOptions {\n  tsconfigGetter: () => string;\n  workspaceRoot: string;\n  inlineStylesExtension: string;\n  jit: boolean;\n  liveReload: boolean;\n  supportedBrowsers: string[];\n  transformFilter?: (code: string, id: string) => boolean;\n  isTest: boolean;\n  isAstroIntegration: boolean;\n  fastCompileMode?: 'full' | 'partial';\n}\n\nexport function fastCompilePlugin(\n  pluginOptions: FastCompilePluginOptions,\n): Plugin {\n  let resolvedConfig: ResolvedConfig;\n  let tsConfigResolutionContext: TsConfigResolutionContext | null = null;\n  let watchMode = false;\n\n  // fast-compile plugin state\n  const registry: ComponentRegistry = new Map();\n  const resourceToSource = new Map<string, string>();\n  const scannedDtsPackages = new Set<string>();\n  let projectRoot = '';\n  let useDefineForClassFields = true;\n\n  /**\n   * Scan a file into the registry, then recursively walk its relative\n   * `export *` / `export { … } from './x'` chain so any underlying\n   * directive classes also land in the registry. Used both at\n   * `buildStart` (for tsconfig path entries) and at dev time (file\n   * `add` and `handleHotUpdate`) so newly added barrels stay in sync\n   * without requiring a server restart.\n   *\n   * The `visited` set prevents infinite recursion within a single\n   * top-level call. Each fresh scan should pass an empty set (so HMR\n   * re-scans aren't blocked by buildStart's earlier visits).\n   */\n  async function scanBarrelExports(\n    file: string,\n    visited: Set<string> = new Set(),\n    overwrite = false,\n  ): Promise<void> {\n    if (visited.has(file)) return;\n    visited.add(file);\n    let code: string;\n    try {\n      code = await fsPromises.readFile(file, 'utf-8');\n    } catch (e) {\n      if (debugRegistry.enabled) {\n        debugRegistry(\n          'scanBarrelExports: failed to read %s: %s',\n          file,\n          (e as Error)?.message,\n        );\n      }\n      return;\n    }\n    const entries = scanFile(code, file);\n    for (const entry of entries) {\n      // At buildStart we want stable registry entries (don't overwrite\n      // an earlier scan with a barrel re-scan); HMR explicitly asks\n      // for overwrite so updated metadata replaces stale entries.\n      if (overwrite || !registry.has(entry.className)) {\n        registry.set(entry.className, entry);\n      }\n    }\n    // Collect every relative re-export specifier via OXC AST so\n    // recursive scans can't trip over each other (a shared `/g` regex\n    // would have its `lastIndex` reset by each recursive call and\n    // silently skip half of an outer barrel's re-exports, which\n    // previously left directives like `HlmRadioGroup` unregistered).\n    const dir = dirname(file);\n    for (const rel of collectRelativeReExports(code, file)) {\n      // NodeNext-style libraries write `export * from './foo.js'`\n      // even though the source is `./foo.ts`. Strip the ESM\n      // extension before probing or the candidates would be\n      // `foo.js.ts` / `foo.js/index.ts`, which never exist.\n      const normalizedRel = rel.replace(/\\.(?:js|mjs)$/u, '');\n      const reExportCandidates = [\n        resolve(dir, normalizedRel + '.ts'),\n        resolve(dir, normalizedRel, 'index.ts'),\n      ];\n      let resolved = false;\n      for (const candidate of reExportCandidates) {\n        try {\n          await fsPromises.access(candidate);\n          await scanBarrelExports(candidate, visited, overwrite);\n          resolved = true;\n          break;\n        } catch {\n          // try next candidate\n        }\n      }\n      if (!resolved && debugRegistry.enabled) {\n        debugRegistry(\n          'scanBarrelExports: %s re-export %s did not resolve to %o',\n          file,\n          rel,\n          reExportCandidates,\n        );\n      }\n    }\n  }\n\n  async function initFastCompile() {\n    if (pluginOptions.jit) return; // JIT: no registry scan needed\n\n    // Scan all source files to build the registry\n    registry.clear();\n    scannedDtsPackages.clear();\n    const resolvedTsConfigPath = resolveTsConfigPath();\n    projectRoot = dirname(resolvedTsConfigPath);\n    const config = compilerCli.readConfiguration(resolvedTsConfigPath);\n    useDefineForClassFields = config.options?.useDefineForClassFields ?? true;\n\n    // Collect candidate files: tsconfig rootNames PLUS the entry points\n    // named in `compilerOptions.paths`. App tsconfigs typically only\n    // include the app's own sources, so workspace library entry barrels\n    // (e.g. `HlmSelectImports = [HlmSelect, HlmSelectContent, ...] as\n    // const`) live outside `rootNames` and would otherwise miss the\n    // initial scan. The compiler then can't see that `HlmSelectImports`\n    // is a tuple barrel and emits the bare identifier into the parent\n    // component's `dependencies()` list, where Angular's runtime\n    // silently drops it because arrays don't have a directive def.\n    const candidates = new Set<string>(config.rootNames);\n    const tsPaths = config.options?.paths;\n    const baseUrl = (config.options?.baseUrl ?? projectRoot) as string;\n    if (tsPaths) {\n      for (const targets of Object.values(tsPaths)) {\n        for (const target of targets as string[]) {\n          // Skip wildcard patterns — entry barrels are normally exact\n          // file paths like \"libs/helm/select/src/index.ts\".\n          if (target.includes('*')) continue;\n          candidates.add(resolve(baseUrl, target));\n        }\n      }\n    }\n    const results = await Promise.all(\n      Array.from(candidates).map(async (file) => {\n        try {\n          const code = await fsPromises.readFile(file, 'utf-8');\n          return scanFile(code, file);\n        } catch (e) {\n          if (debugRegistry.enabled) {\n            debugRegistry(\n              'initFastCompile: skipping unreadable %s: %s',\n              file,\n              (e as Error)?.message,\n            );\n          }\n          return []; // Skip unreadable files\n        }\n      }),\n    );\n\n    for (const entries of results) {\n      for (const entry of entries) {\n        registry.set(entry.className, entry);\n      }\n    }\n\n    // Library barrels typically `export * from './lib/...'` rather than\n    // declaring directives directly, so the entry file alone gives us\n    // the tuple consts but not the directive classes they reference.\n    // Walk the relative `export *` chain so the underlying classes also\n    // land in the registry. Use a SHARED visited set across all\n    // barrels so recursive walks don't double-scan a file that's\n    // re-exported from multiple entry points.\n    const buildStartVisited = new Set<string>();\n    if (tsPaths) {\n      const barrelCandidates: string[] = [];\n      for (const targets of Object.values(tsPaths)) {\n        for (const target of targets as string[]) {\n          if (target.includes('*')) continue;\n          barrelCandidates.push(resolve(baseUrl, target));\n        }\n      }\n      await Promise.all(\n        barrelCandidates.map((c) => scanBarrelExports(c, buildStartVisited)),\n      );\n    }\n    debugRegistry(\n      'initFastCompile done: %d entries from %d candidate files',\n      registry.size,\n      candidates.size,\n    );\n  }\n\n  function ensureDtsRegistryForSource(code: string, id: string) {\n    for (const pkg of collectImportedPackages(code, id)) {\n      if (scannedDtsPackages.has(pkg)) continue;\n      scannedDtsPackages.add(pkg);\n\n      try {\n        const dtsEntries = scanPackageDts(pkg, projectRoot);\n        for (const entry of dtsEntries) {\n          if (!registry.has(entry.className)) {\n            registry.set(entry.className, entry);\n          }\n        }\n      } catch {\n        // Package may not have .d.ts files or may not be Angular\n      }\n    }\n  }\n\n  async function handleFastCompileTransform(\n    code: string,\n    id: string,\n  ): Promise<{ code: string; map: any } | undefined> {\n    if (!/(Component|Directive|Pipe|Injectable|NgModule)\\(/.test(code)) {\n      // Non-Angular file — leave it alone so a downstream plugin (or\n      // Vite's built-in TS handler) can process it.\n      return undefined;\n    }\n\n    // JIT mode\n    if (pluginOptions.jit) {\n      const result = jitTransform(code, id);\n      return { code: result.code, map: result.map };\n    }\n\n    // Inline external templateUrl/styleUrl(s) into the source before compilation\n    code = inlineResourceUrls(code, id);\n\n    // Pre-resolve inline styles that need preprocessing (SCSS/Sass/Less)\n    let resolvedStyles: Map<string, string> | undefined;\n    let resolvedInlineStyles: Map<number, string> | undefined;\n\n    if (pluginOptions.inlineStylesExtension !== 'css') {\n      const styleStrings = extractInlineStyles(code, id);\n\n      if (styleStrings.length > 0) {\n        resolvedInlineStyles = new Map();\n        for (let i = 0; i < styleStrings.length; i++) {\n          try {\n            const fakePath = id.replace(\n              /\\.ts$/,\n              `.inline-${i}.${pluginOptions.inlineStylesExtension}`,\n            );\n            // In tests, mirror Vitest's `test.css` rules — defaults to no\n            // preprocessing (matches Vite's CSS pipeline behavior). (#2297)\n            if (!shouldPreprocessTestCss(resolvedConfig, fakePath)) {\n              resolvedInlineStyles.set(i, styleStrings[i]);\n              continue;\n            }\n            const processed = await preprocessCSS(\n              styleStrings[i],\n              fakePath,\n              resolvedConfig,\n            );\n            resolvedInlineStyles.set(i, processed.code);\n          } catch (e) {\n            if (debugCompile.enabled) {\n              debugCompile(\n                'inline style #%d preprocessing failed in %s: %s',\n                i,\n                id,\n                (e as Error)?.message,\n              );\n            }\n            // Skip styles that can't be preprocessed\n          }\n        }\n        if (resolvedInlineStyles.size === 0) resolvedInlineStyles = undefined;\n      }\n    }\n\n    ensureDtsRegistryForSource(code, id);\n\n    const result = compile(code, id, {\n      registry,\n      resolvedStyles,\n      resolvedInlineStyles,\n      useDefineForClassFields,\n      compilationMode: pluginOptions.fastCompileMode,\n    });\n\n    // Track resource dependencies for HMR\n    for (const dep of result.resourceDependencies) {\n      resourceToSource.set(dep, id);\n    }\n\n    // Strip TypeScript-only syntax\n    const stripped = vite.transformWithOxc\n      ? await vite.transformWithOxc(result.code, id, {\n          lang: 'ts',\n          sourcemap: false,\n          decorator: { legacy: false, emitDecoratorMetadata: false },\n        })\n      : await vite.transformWithEsbuild(result.code, id, {\n          loader: 'ts',\n          sourcemap: false,\n        });\n    let outputCode = stripped.code;\n\n    // Append HMR code in dev mode\n    if (watchMode && pluginOptions.liveReload) {\n      const fileDeclarations = [...registry.values()].filter(\n        (e) => e.fileName === id,\n      );\n      if (fileDeclarations.length > 0) {\n        const localDepClassNames = fileDeclarations.map((e) => e.className);\n        outputCode += generateHmrCode(fileDeclarations, localDepClassNames);\n      }\n    }\n\n    return { code: outputCode, map: result.map };\n  }\n\n  function resolveTsConfigPath() {\n    const { root, isProd, isLib } = tsConfigResolutionContext!;\n    return getTsConfigPath(\n      root,\n      pluginOptions.tsconfigGetter(),\n      isProd,\n      pluginOptions.isTest,\n      isLib,\n    );\n  }\n\n  return {\n    name: '@analogjs/vite-plugin-angular-fast-compile',\n    enforce: 'pre' as const,\n    async config(config, { command }) {\n      watchMode = command === 'serve';\n      const isProd =\n        config.mode === 'production' ||\n        process.env['NODE_ENV'] === 'production';\n\n      tsConfigResolutionContext = {\n        root: config.root || '.',\n        isProd,\n        isLib: !!config?.build?.lib,\n      };\n\n      const preliminaryTsConfigPath = resolveTsConfigPath();\n\n      const depOptimizer = createDepOptimizerConfig({\n        tsconfig: preliminaryTsConfigPath,\n        isProd,\n        jit: pluginOptions.jit,\n        watchMode,\n        isTest: pluginOptions.isTest,\n        isAstroIntegration: pluginOptions.isAstroIntegration,\n      });\n\n      return {\n        ...(vite.rolldownVersion ? { oxc: {} as any } : { esbuild: false }),\n        ...depOptimizer,\n        resolve: {\n          conditions: [\n            ...depOptimizer.resolve.conditions,\n            ...(config.resolve?.conditions || defaultClientConditions),\n          ],\n        },\n      };\n    },\n    configResolved(config) {\n      resolvedConfig = config;\n    },\n    configureServer(server) {\n      // Watch for new .ts files and scan them into the registry. Use\n      // the barrel-aware scanner so a newly added re-export entry\n      // (`export * from './x'`) also expands its underlying directive\n      // classes — otherwise the registry stays stale until restart.\n      server.watcher.on('add', async (filePath) => {\n        if (\n          filePath.endsWith('.ts') &&\n          !filePath.endsWith('.spec.ts') &&\n          !filePath.endsWith('.d.ts')\n        ) {\n          await scanBarrelExports(filePath, new Set(), true);\n        }\n      });\n    },\n    async buildStart() {\n      await initFastCompile();\n    },\n    async handleHotUpdate(ctx) {\n      // Resource file changes → invalidate parent .ts module\n      if (resourceToSource.has(ctx.file)) {\n        const parentSource = resourceToSource.get(ctx.file)!;\n        const parentModule = ctx.server.moduleGraph.getModuleById(parentSource);\n        if (parentModule) {\n          return [parentModule];\n        }\n      }\n\n      if (TS_EXT_REGEX.test(ctx.file)) {\n        const [fileId] = ctx.file.split('?');\n\n        // Remove old entries from this file\n        const oldEntries = [...registry.entries()]\n          .filter(([_, v]) => v.fileName === fileId)\n          .map(([k]) => k);\n        for (const key of oldEntries) {\n          registry.delete(key);\n        }\n\n        // Rescan the changed file via the barrel-aware scanner so an\n        // edited barrel re-export picks up newly-referenced files.\n        // Pass overwrite=true so updated metadata replaces stale\n        // entries from the previous scan.\n        await scanBarrelExports(fileId, new Set(), true);\n      }\n\n      // Let Vite handle the rest — the transform hook will recompile\n      return ctx.modules;\n    },\n    transform: {\n      filter: {\n        id: {\n          include: [TS_EXT_REGEX],\n          exclude: [/node_modules/, 'type=script', '@ng/component'],\n        },\n      },\n      async handler(code, id) {\n        if (\n          pluginOptions.transformFilter &&\n          !(pluginOptions.transformFilter(code, id) ?? true)\n        ) {\n          return;\n        }\n\n        if (id.includes('.ts?')) {\n          id = id.replace(/\\?(.*)/, '');\n        }\n        return handleFastCompileTransform(code, id);\n      },\n    },\n  };\n}\n"],"mappings":"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"}

package/src/lib/host.js

@@ -2,9 +2,9 @@ import { debugStyles } from "./utils/debug.js";
 import { isTailwindReferenceError } from "./utils/tailwind-reference.js";
 import { normalizeStylesheetDependencies } from "./style-preprocessor.js";
 import { preprocessStylesheetResult, registerStylesheetContent } from "./stylesheet-registry.js";
-import { createHash } from "node:crypto";
 import path from "node:path";
 import { normalizePath } from "vite";
+import { createHash } from "node:crypto";
 //#region packages/vite-plugin-angular/src/lib/host.ts
 function augmentHostWithResources(host, transform, options) {
 	const resourceHost = host;

package/src/lib/stylesheet-registry.js

@@ -1,7 +1,7 @@
 import { normalizeStylesheetTransformResult } from "./style-preprocessor.js";
-import { createHash } from "node:crypto";
 import { dirname, normalize, resolve } from "node:path";
 import { normalizePath } from "vite";
+import { createHash } from "node:crypto";
 //#region packages/vite-plugin-angular/src/lib/stylesheet-registry.ts
 var AnalogStylesheetRegistry = class {
 	servedById = /* @__PURE__ */ new Map();

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

@@ -0,0 +1,34 @@
+import { Plugin, ResolvedConfig } from "vite";
+import type { StylePreprocessor } from "./style-preprocessor.js";
+import type { AngularStylePipelineOptions } from "./style-pipeline.js";
+export interface TailwindCssOptions {
+	rootStylesheet: string;
+	prefixes?: string[];
+}
+export interface TailwindReferencePluginOptions {
+	tailwindCss?: TailwindCssOptions;
+}
+export declare function tailwindReferencePlugin(options: TailwindReferencePluginOptions): Plugin;
+/**
+* Builds a resolved stylePreprocessor function from plugin options.
+*
+* When `tailwindCss` is configured, creates an injector that prepends
+* `@reference "<rootStylesheet>"` into component CSS that uses Tailwind
+* utilities. Uses absolute paths because Angular's externalRuntimeStyles
+* serves component CSS as virtual modules (hash-based IDs) with no
+* meaningful directory — relative paths can't resolve from a hash.
+*
+* If both `tailwindCss` and `stylePreprocessor` are provided, they are
+* chained: Tailwind reference injection runs first, then the user's
+* custom preprocessor.
+*/
+export declare function buildStylePreprocessor(options?: {
+	stylePreprocessor?: StylePreprocessor;
+	stylePipeline?: AngularStylePipelineOptions;
+	tailwindCss?: TailwindCssOptions;
+}): StylePreprocessor | undefined;
+/**
+* Validates the Tailwind CSS integration configuration and emits actionable
+* warnings for common misconfigurations that cause silent failures.
+*/
+export declare function validateTailwindConfig(tailwindCss: TailwindCssOptions | undefined, config: ResolvedConfig, isWatchMode: boolean): void;

package/src/lib/tailwind-plugin.js

@@ -0,0 +1,116 @@
+import { debugTailwind, debugTailwindV } from "./utils/debug.js";
+import { inspectCssTailwindDirectives, throwTailwindReferenceTextError } from "./utils/tailwind-reference.js";
+import { composeStylePreprocessors } from "./style-preprocessor.js";
+import { stylePipelinePreprocessorFromPlugins } from "./style-pipeline.js";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, isAbsolute } from "node:path";
+import { normalizePath } from "vite";
+//#region packages/vite-plugin-angular/src/lib/tailwind-plugin.ts
+/**
+* Core injection logic shared by both the Vite pre-transform plugin and the
+* Angular style preprocessor. Returns the `@reference`-prepended CSS when
+* injection is needed, or `undefined` when the file should be left alone.
+*/
+function injectTailwindReference(code, opts) {
+	const directiveState = inspectCssTailwindDirectives(code);
+	if (directiveState.hasReferenceDirective || directiveState.hasTailwindImportDirective) return;
+	if (!(opts.prefixes ? opts.prefixes.some((p) => directiveState.commentlessCode.includes(p)) : directiveState.commentlessCode.includes("@apply"))) return;
+	if (directiveState.hasReferenceText) throwTailwindReferenceTextError(opts.fileId, opts.rootStylesheet);
+	return `@reference "${opts.rootStylesheet.replace(/\\/g, "/")}";\n${code}`;
+}
+function tailwindReferencePlugin(options) {
+	return {
+		name: "@analogjs/vite-plugin-angular:tailwind-reference",
+		enforce: "pre",
+		transform(code, id) {
+			const tw = options.tailwindCss;
+			if (!tw || !id.includes(".css")) return;
+			if (id.split("?")[0] === tw.rootStylesheet) return;
+			const rootBasename = basename(tw.rootStylesheet);
+			if (inspectCssTailwindDirectives(code).commentlessCode.includes(rootBasename)) return;
+			const result = injectTailwindReference(code, {
+				rootStylesheet: tw.rootStylesheet,
+				prefixes: tw.prefixes,
+				fileId: id
+			});
+			if (result) debugTailwind("injected @reference via pre-transform", { id: id.split("/").slice(-2).join("/") });
+			return result;
+		}
+	};
+}
+/**
+* Builds a resolved stylePreprocessor function from plugin options.
+*
+* When `tailwindCss` is configured, creates an injector that prepends
+* `@reference "<rootStylesheet>"` into component CSS that uses Tailwind
+* utilities. Uses absolute paths because Angular's externalRuntimeStyles
+* serves component CSS as virtual modules (hash-based IDs) with no
+* meaningful directory — relative paths can't resolve from a hash.
+*
+* If both `tailwindCss` and `stylePreprocessor` are provided, they are
+* chained: Tailwind reference injection runs first, then the user's
+* custom preprocessor.
+*/
+function buildStylePreprocessor(options) {
+	const userPreprocessor = options?.stylePreprocessor;
+	const stylePipelinePreprocessor = stylePipelinePreprocessorFromPlugins(options?.stylePipeline);
+	const tw = options?.tailwindCss;
+	if (!tw && !userPreprocessor && !stylePipelinePreprocessor) return;
+	let tailwindPreprocessor;
+	if (tw) {
+		const rootStylesheet = tw.rootStylesheet;
+		const prefixes = tw.prefixes;
+		debugTailwind("configured", {
+			rootStylesheet,
+			prefixes
+		});
+		if (!existsSync(rootStylesheet)) console.warn(`[@analogjs/vite-plugin-angular] tailwindCss.rootStylesheet not found at "${rootStylesheet}". @reference directives will point to a non-existent file, which will cause Tailwind CSS errors. Ensure the path is absolute and the file exists.`);
+		tailwindPreprocessor = (code, filename) => {
+			const result = injectTailwindReference(code, {
+				rootStylesheet,
+				prefixes,
+				fileId: filename
+			});
+			if (result) {
+				debugTailwind("injected @reference via preprocessor", { filename });
+				return result;
+			}
+			debugTailwindV("skip (no injection needed)", { filename });
+			return code;
+		};
+	}
+	if (tailwindPreprocessor && (stylePipelinePreprocessor || userPreprocessor)) debugTailwind("chained with style pipeline or user stylePreprocessor");
+	return composeStylePreprocessors([
+		tailwindPreprocessor,
+		stylePipelinePreprocessor,
+		userPreprocessor
+	]);
+}
+/**
+* Validates the Tailwind CSS integration configuration and emits actionable
+* warnings for common misconfigurations that cause silent failures.
+*/
+function validateTailwindConfig(tailwindCss, config, isWatchMode) {
+	const PREFIX = "[@analogjs/vite-plugin-angular]";
+	const tw = tailwindCss;
+	if (!tw) return;
+	if (!isAbsolute(tw.rootStylesheet)) console.warn(`${PREFIX} tailwindCss.rootStylesheet must be an absolute path. Got: "${tw.rootStylesheet}". Use path.resolve(__dirname, '...') in your vite.config to convert it.`);
+	const hasTailwindPlugin = config.plugins.some((p) => p.name.startsWith("@tailwindcss/vite") || p.name.startsWith("tailwindcss"));
+	if (isWatchMode && !hasTailwindPlugin) throw new Error(`${PREFIX} tailwindCss is configured but no @tailwindcss/vite plugin was found. Component CSS with @apply directives will not be processed.\n\n  Fix: npm install @tailwindcss/vite --save-dev\n  Then add tailwindcss() to your vite.config plugins array.\n`);
+	if (isWatchMode && tw.rootStylesheet) {
+		const projectRoot = normalizePath(config.root);
+		const normalizedRootStylesheet = normalizePath(tw.rootStylesheet);
+		if (!normalizedRootStylesheet.startsWith(projectRoot)) {
+			if (!(config.server?.fs?.allow ?? []).some((allowed) => normalizedRootStylesheet.startsWith(normalizePath(allowed)))) console.warn(`${PREFIX} tailwindCss.rootStylesheet is outside the Vite project root. The dev server may reject it with 403.\n\n  Root: ${projectRoot}\n  Stylesheet: ${tw.rootStylesheet}\n\n  Fix: server.fs.allow: ['${dirname(tw.rootStylesheet)}']\n`);
+		}
+	}
+	if (tw.prefixes !== void 0 && tw.prefixes.length === 0) console.warn(`${PREFIX} tailwindCss.prefixes is an empty array. No component stylesheets will receive @reference injection. Either remove the prefixes option (to use @apply detection) or specify your prefixes: ['tw:']\n`);
+	if (existsSync(tw.rootStylesheet)) try {
+		const rootContent = readFileSync(tw.rootStylesheet, "utf-8");
+		if (!rootContent.includes("@import \"tailwindcss\"") && !rootContent.includes("@import 'tailwindcss'")) console.warn(`${PREFIX} tailwindCss.rootStylesheet does not contain @import "tailwindcss". The @reference directive will point to a file without Tailwind configuration.\n\n  File: ${tw.rootStylesheet}\n`);
+	} catch {}
+}
+//#endregion
+export { buildStylePreprocessor, tailwindReferencePlugin, validateTailwindConfig };
+
+//# sourceMappingURL=tailwind-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-plugin.js","names":[],"sources":["../../../src/lib/tailwind-plugin.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { basename, dirname, isAbsolute } from 'node:path';\nimport { normalizePath, Plugin, ResolvedConfig } from 'vite';\nimport {\n  inspectCssTailwindDirectives,\n  throwTailwindReferenceTextError,\n} from './utils/tailwind-reference.js';\nimport { debugTailwind, debugTailwindV } from './utils/debug.js';\nimport { composeStylePreprocessors } from './style-preprocessor.js';\nimport type { StylePreprocessor } from './style-preprocessor.js';\nimport { stylePipelinePreprocessorFromPlugins } from './style-pipeline.js';\nimport type { AngularStylePipelineOptions } from './style-pipeline.js';\n\nexport interface TailwindCssOptions {\n  rootStylesheet: string;\n  prefixes?: string[];\n}\n\nexport interface TailwindReferencePluginOptions {\n  tailwindCss?: TailwindCssOptions;\n}\n\n/**\n * Core injection logic shared by both the Vite pre-transform plugin and the\n * Angular style preprocessor. Returns the `@reference`-prepended CSS when\n * injection is needed, or `undefined` when the file should be left alone.\n */\nfunction injectTailwindReference(\n  code: string,\n  opts: {\n    rootStylesheet: string;\n    prefixes?: string[];\n    fileId: string;\n  },\n): string | undefined {\n  const directiveState = inspectCssTailwindDirectives(code);\n\n  if (\n    directiveState.hasReferenceDirective ||\n    directiveState.hasTailwindImportDirective\n  ) {\n    return undefined;\n  }\n\n  const needsRef = opts.prefixes\n    ? opts.prefixes.some((p) => directiveState.commentlessCode.includes(p))\n    : directiveState.commentlessCode.includes('@apply');\n\n  if (!needsRef) {\n    return undefined;\n  }\n\n  if (directiveState.hasReferenceText) {\n    throwTailwindReferenceTextError(opts.fileId, opts.rootStylesheet);\n  }\n\n  return `@reference \"${opts.rootStylesheet.replace(/\\\\/g, '/')}\";\\n${code}`;\n}\n\nexport function tailwindReferencePlugin(\n  options: TailwindReferencePluginOptions,\n): Plugin {\n  return {\n    name: '@analogjs/vite-plugin-angular:tailwind-reference',\n    enforce: 'pre',\n    transform(code: string, id: string) {\n      const tw = options.tailwindCss;\n      if (!tw || !id.includes('.css')) return;\n\n      const cleanId = id.split('?')[0];\n      if (cleanId === tw.rootStylesheet) return;\n\n      // Skip entry stylesheets that @import the root config\n      const rootBasename = basename(tw.rootStylesheet);\n      const directiveState = inspectCssTailwindDirectives(code);\n      if (directiveState.commentlessCode.includes(rootBasename)) return;\n\n      const result = injectTailwindReference(code, {\n        rootStylesheet: tw.rootStylesheet,\n        prefixes: tw.prefixes,\n        fileId: id,\n      });\n\n      if (result) {\n        debugTailwind('injected @reference via pre-transform', {\n          id: id.split('/').slice(-2).join('/'),\n        });\n      }\n\n      return result;\n    },\n  };\n}\n\n/**\n * Builds a resolved stylePreprocessor function from plugin options.\n *\n * When `tailwindCss` is configured, creates an injector that prepends\n * `@reference \"<rootStylesheet>\"` into component CSS that uses Tailwind\n * utilities. Uses absolute paths because Angular's externalRuntimeStyles\n * serves component CSS as virtual modules (hash-based IDs) with no\n * meaningful directory — relative paths can't resolve from a hash.\n *\n * If both `tailwindCss` and `stylePreprocessor` are provided, they are\n * chained: Tailwind reference injection runs first, then the user's\n * custom preprocessor.\n */\nexport function buildStylePreprocessor(options?: {\n  stylePreprocessor?: StylePreprocessor;\n  stylePipeline?: AngularStylePipelineOptions;\n  tailwindCss?: TailwindCssOptions;\n}): StylePreprocessor | undefined {\n  const userPreprocessor = options?.stylePreprocessor;\n  const stylePipelinePreprocessor = stylePipelinePreprocessorFromPlugins(\n    options?.stylePipeline,\n  );\n  const tw = options?.tailwindCss;\n\n  if (!tw && !userPreprocessor && !stylePipelinePreprocessor) {\n    return undefined;\n  }\n\n  let tailwindPreprocessor:\n    | ((code: string, filename: string) => string)\n    | undefined;\n\n  if (tw) {\n    const rootStylesheet = tw.rootStylesheet;\n    const prefixes = tw.prefixes;\n    debugTailwind('configured', { rootStylesheet, prefixes });\n\n    if (!existsSync(rootStylesheet)) {\n      console.warn(\n        `[@analogjs/vite-plugin-angular] tailwindCss.rootStylesheet not found ` +\n          `at \"${rootStylesheet}\". @reference directives will point to a ` +\n          `non-existent file, which will cause Tailwind CSS errors. ` +\n          `Ensure the path is absolute and the file exists.`,\n      );\n    }\n\n    tailwindPreprocessor = (code: string, filename: string): string => {\n      const result = injectTailwindReference(code, {\n        rootStylesheet,\n        prefixes,\n        fileId: filename,\n      });\n\n      if (result) {\n        debugTailwind('injected @reference via preprocessor', { filename });\n        return result;\n      }\n\n      debugTailwindV('skip (no injection needed)', { filename });\n      return code;\n    };\n  }\n\n  if (tailwindPreprocessor && (stylePipelinePreprocessor || userPreprocessor)) {\n    debugTailwind('chained with style pipeline or user stylePreprocessor');\n  }\n\n  return composeStylePreprocessors([\n    tailwindPreprocessor,\n    stylePipelinePreprocessor,\n    userPreprocessor,\n  ]);\n}\n\n/**\n * Validates the Tailwind CSS integration configuration and emits actionable\n * warnings for common misconfigurations that cause silent failures.\n */\nexport function validateTailwindConfig(\n  tailwindCss: TailwindCssOptions | undefined,\n  config: ResolvedConfig,\n  isWatchMode: boolean,\n): void {\n  const PREFIX = '[@analogjs/vite-plugin-angular]';\n  const tw = tailwindCss;\n\n  if (!tw) return;\n\n  if (!isAbsolute(tw.rootStylesheet)) {\n    console.warn(\n      `${PREFIX} tailwindCss.rootStylesheet must be an absolute path. ` +\n        `Got: \"${tw.rootStylesheet}\". Use path.resolve(__dirname, '...') ` +\n        `in your vite.config to convert it.`,\n    );\n  }\n\n  const resolvedPlugins = config.plugins;\n  const hasTailwindPlugin = resolvedPlugins.some(\n    (p) =>\n      p.name.startsWith('@tailwindcss/vite') ||\n      p.name.startsWith('tailwindcss'),\n  );\n\n  if (isWatchMode && !hasTailwindPlugin) {\n    throw new Error(\n      `${PREFIX} tailwindCss is configured but no @tailwindcss/vite ` +\n        `plugin was found. Component CSS with @apply directives will ` +\n        `not be processed.\\n\\n` +\n        `  Fix: npm install @tailwindcss/vite --save-dev\\n` +\n        `  Then add tailwindcss() to your vite.config plugins array.\\n`,\n    );\n  }\n\n  if (isWatchMode && tw.rootStylesheet) {\n    const projectRoot = normalizePath(config.root);\n    const normalizedRootStylesheet = normalizePath(tw.rootStylesheet);\n    if (!normalizedRootStylesheet.startsWith(projectRoot)) {\n      const fsAllow = config.server?.fs?.allow ?? [];\n      const isAllowed = fsAllow.some((allowed) =>\n        normalizedRootStylesheet.startsWith(normalizePath(allowed)),\n      );\n      if (!isAllowed) {\n        console.warn(\n          `${PREFIX} tailwindCss.rootStylesheet is outside the Vite ` +\n            `project root. The dev server may reject it with 403.\\n\\n` +\n            `  Root: ${projectRoot}\\n` +\n            `  Stylesheet: ${tw.rootStylesheet}\\n\\n` +\n            `  Fix: server.fs.allow: ['${dirname(tw.rootStylesheet)}']\\n`,\n        );\n      }\n    }\n  }\n\n  if (tw.prefixes !== undefined && tw.prefixes.length === 0) {\n    console.warn(\n      `${PREFIX} tailwindCss.prefixes is an empty array. No component ` +\n        `stylesheets will receive @reference injection. Either remove ` +\n        `the prefixes option (to use @apply detection) or specify your ` +\n        `prefixes: ['tw:']\\n`,\n    );\n  }\n\n  if (existsSync(tw.rootStylesheet)) {\n    try {\n      const rootContent = readFileSync(tw.rootStylesheet, 'utf-8');\n      if (\n        !rootContent.includes('@import \"tailwindcss\"') &&\n        !rootContent.includes(\"@import 'tailwindcss'\")\n      ) {\n        console.warn(\n          `${PREFIX} tailwindCss.rootStylesheet does not contain ` +\n            `@import \"tailwindcss\". The @reference directive will ` +\n            `point to a file without Tailwind configuration.\\n\\n` +\n            `  File: ${tw.rootStylesheet}\\n`,\n        );\n      }\n    } catch {\n      // Silently skip — existence check already warned in buildStylePreprocessor.\n    }\n  }\n}\n"],"mappings":"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"}

package/src/lib/template-class-binding-guard-plugin.d.ts

@@ -0,0 +1,30 @@
+import { Plugin } from "vite";
+import { StyleUrlsResolver } from "./component-resolvers.js";
+export interface ActiveGraphComponentRecord {
+	file: string;
+	className: string;
+	selector?: string;
+}
+export interface StyleOwnerRecord {
+	sourcePath: string;
+	ownerFile: string;
+}
+interface TemplateClassBindingIssue {
+	line: number;
+	column: number;
+	snippet: string;
+}
+export interface TemplateClassBindingGuardContext {
+	styleUrlsResolver: StyleUrlsResolver;
+	activeGraphComponentMetadata: Map<string, ActiveGraphComponentRecord[]>;
+	selectorOwners: Map<string, Set<string>>;
+	classNameOwners: Map<string, Set<string>>;
+	transformedStyleOwnerMetadata: Map<string, StyleOwnerRecord[]>;
+	styleSourceOwners: Map<string, Set<string>>;
+}
+export declare function templateClassBindingGuardPlugin(ctx: TemplateClassBindingGuardContext): Plugin;
+export declare function removeActiveGraphMetadata(ctx: TemplateClassBindingGuardContext, file: string): void;
+export declare function removeStyleOwnerMetadata(ctx: TemplateClassBindingGuardContext, file: string): void;
+export declare function findStaticClassAndBoundClassConflicts(template: string): TemplateClassBindingIssue[];
+export declare function findBoundClassAndNgClassConflicts(template: string): TemplateClassBindingIssue[];
+export {};