@analogjs/vite-plugin-angular 3.0.0-alpha.7 → 3.0.0-alpha.71

package/src/lib/angular-jit-plugin.js

@@ -1,39 +1,53 @@
-import { createHash } from 'node:crypto';
-import { preprocessCSS } from 'vite';
-export function jitPlugin({ inlineStylesExtension, }) {
-    let config;
-    return {
-        name: '@analogjs/vite-plugin-angular-jit',
-        configResolved(_config) {
-            config = _config;
-        },
-        resolveId(id) {
-            if (id.startsWith('virtual:angular')) {
-                return `\0${id}`;
-            }
-            return;
-        },
-        async load(id) {
-            if (id.includes('virtual:angular:jit:style:inline;')) {
-                const styleId = id.split('style:inline;')[1];
-                // styleId may exceed 255 bytes of base64-encoded content, limit to 16
-                const styleIdHash = createHash('sha256')
-                    .update(styleId)
-                    .digest('hex')
-                    .slice(0, 16);
-                const decodedStyles = Buffer.from(decodeURIComponent(styleId), 'base64').toString();
-                let styles = '';
-                try {
-                    const compiled = await preprocessCSS(decodedStyles, `${styleIdHash}.${inlineStylesExtension}?direct`, config);
-                    styles = compiled?.code;
-                }
-                catch (e) {
-                    console.error(`${e}`);
-                }
-                return `export default \`${styles}\``;
-            }
-            return;
-        },
-    };
+import { getJitInlineStyles } from "./utils/jit-inline-styles.js";
+import { debugStyles } from "./utils/debug.js";
+import { isTailwindReferenceError } from "./utils/tailwind-reference.js";
+import { resolveStylePreprocessor } from "./analog-plugin-interop.js";
+import { preprocessStylesheet } from "./stylesheet-registry.js";
+import { preprocessCSS } from "vite";
+//#region packages/vite-plugin-angular/src/lib/angular-jit-plugin.ts
+function jitPlugin({ inlineStylesExtension }) {
+	let config;
+	let stylePreprocessor;
+	return {
+		name: "@analogjs/vite-plugin-angular-jit",
+		configResolved(_config) {
+			config = _config;
+		},
+		async buildStart() {
+			stylePreprocessor = await resolveStylePreprocessor(config);
+		},
+		resolveId(id) {
+			if (id.startsWith("virtual:angular")) return `\0${id}`;
+		},
+		async load(id) {
+			if (id.includes("virtual:angular:jit:style:inline;")) {
+				const styleIdHash = id.split("style:inline;")[1];
+				const encodedStyles = getJitInlineStyles(styleIdHash);
+				if (encodedStyles === void 0) return;
+				const decodedStyles = Buffer.from(decodeURIComponent(encodedStyles), "base64").toString();
+				const filename = `${styleIdHash}.${inlineStylesExtension}`;
+				const preprocessed = preprocessStylesheet(decodedStyles, filename, stylePreprocessor, {
+					filename,
+					inline: true
+				});
+				let styles = "";
+				try {
+					styles = (await preprocessCSS(preprocessed, `${filename}?direct`, config))?.code;
+				} catch (e) {
+					if (isTailwindReferenceError(e)) throw e;
+					const errorMessage = e instanceof Error ? e.message : String(e);
+					debugStyles("jit css compilation error", {
+						styleIdHash,
+						error: errorMessage
+					});
+					console.warn("[@analogjs/vite-plugin-angular]: Failed to preprocess inline JIT stylesheet %s. Returning an empty stylesheet instead. %s", styleIdHash, errorMessage);
+				}
+				return `export default \`${styles}\``;
+			}
+		}
+	};
 }
+//#endregion
+export { jitPlugin };
+
 //# sourceMappingURL=angular-jit-plugin.js.map

package/src/lib/angular-jit-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"angular-jit-plugin.js","sourceRoot":"","sources":["../../../../../packages/vite-plugin-angular/src/lib/angular-jit-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAA0B,aAAa,EAAE,MAAM,MAAM,CAAC;AAE7D,MAAM,UAAU,SAAS,CAAC,EACxB,qBAAqB,GAGtB;IACC,IAAI,MAAsB,CAAC;IAE3B,OAAO;QACL,IAAI,EAAE,mCAAmC;QACzC,cAAc,CAAC,OAAO;YACpB,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC;QACD,SAAS,CAAC,EAAU;YAClB,IAAI,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACrC,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,CAAC;YAED,OAAO;QACT,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAU;YACnB,IAAI,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C,sEAAsE;gBACtE,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC;qBACrC,MAAM,CAAC,OAAO,CAAC;qBACf,MAAM,CAAC,KAAK,CAAC;qBACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAEhB,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,kBAAkB,CAAC,OAAO,CAAC,EAC3B,QAAQ,CACT,CAAC,QAAQ,EAAE,CAAC;gBAEb,IAAI,MAAM,GAAuB,EAAE,CAAC;gBAEpC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,aAAa,EACb,GAAG,WAAW,IAAI,qBAAqB,SAAS,EAChD,MAAM,CACP,CAAC;oBACF,MAAM,GAAG,QAAQ,EAAE,IAAI,CAAC;gBAC1B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,CAAC;gBAED,OAAO,oBAAoB,MAAM,IAAI,CAAC;YACxC,CAAC;YAED,OAAO;QACT,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"angular-jit-plugin.js","names":[],"sources":["../../../src/lib/angular-jit-plugin.ts"],"sourcesContent":["import { Plugin, ResolvedConfig, preprocessCSS } from 'vite';\nimport {\n  JIT_INLINE_STYLE_PREFIX,\n  getJitInlineStyles,\n} from './utils/jit-inline-styles.js';\nimport { debugStyles } from './utils/debug.js';\nimport { isTailwindReferenceError } from './utils/tailwind-reference.js';\nimport { resolveStylePreprocessor } from './analog-plugin-interop.js';\nimport { preprocessStylesheet } from './stylesheet-registry.js';\nimport type { StylePreprocessor } from './style-preprocessor.js';\n\nexport function jitPlugin({\n  inlineStylesExtension,\n}: {\n  inlineStylesExtension: string;\n}): Plugin {\n  let config: ResolvedConfig;\n  let stylePreprocessor: StylePreprocessor | undefined;\n\n  return {\n    name: '@analogjs/vite-plugin-angular-jit',\n    configResolved(_config) {\n      config = _config;\n    },\n    async buildStart() {\n      stylePreprocessor = await resolveStylePreprocessor(config);\n    },\n    resolveId(id: string) {\n      if (id.startsWith('virtual:angular')) {\n        return `\\0${id}`;\n      }\n\n      return;\n    },\n    async load(id: string) {\n      if (id.includes(JIT_INLINE_STYLE_PREFIX)) {\n        const styleIdHash = id.split('style:inline;')[1];\n        const encodedStyles = getJitInlineStyles(styleIdHash);\n\n        if (encodedStyles === undefined) {\n          return;\n        }\n\n        const decodedStyles = Buffer.from(\n          decodeURIComponent(encodedStyles),\n          'base64',\n        ).toString();\n        const filename = `${styleIdHash}.${inlineStylesExtension}`;\n        const preprocessed = preprocessStylesheet(\n          decodedStyles,\n          filename,\n          stylePreprocessor,\n          { filename, inline: true },\n        );\n\n        let styles: string | undefined = '';\n\n        try {\n          const compiled = await preprocessCSS(\n            preprocessed,\n            `${filename}?direct`,\n            config,\n          );\n          styles = compiled?.code;\n        } catch (e) {\n          if (isTailwindReferenceError(e)) {\n            throw e;\n          }\n          const errorMessage = e instanceof Error ? e.message : String(e);\n          debugStyles('jit css compilation error', {\n            styleIdHash,\n            error: errorMessage,\n          });\n          console.warn(\n            '[@analogjs/vite-plugin-angular]: Failed to preprocess inline JIT stylesheet %s. Returning an empty stylesheet instead. %s',\n            styleIdHash,\n            errorMessage,\n          );\n        }\n\n        return `export default \\`${styles}\\``;\n      }\n\n      return;\n    },\n  };\n}\n"],"mappings":";;;;;;;AAWA,SAAgB,UAAU,EACxB,yBAGS;CACT,IAAI;CACJ,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,eAAe,SAAS;AACtB,YAAS;;EAEX,MAAM,aAAa;AACjB,uBAAoB,MAAM,yBAAyB,OAAO;;EAE5D,UAAU,IAAY;AACpB,OAAI,GAAG,WAAW,kBAAkB,CAClC,QAAO,KAAK;;EAKhB,MAAM,KAAK,IAAY;AACrB,OAAI,GAAG,SAAA,oCAAiC,EAAE;IACxC,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC;IAC9C,MAAM,gBAAgB,mBAAmB,YAAY;AAErD,QAAI,kBAAkB,KAAA,EACpB;IAGF,MAAM,gBAAgB,OAAO,KAC3B,mBAAmB,cAAc,EACjC,SACD,CAAC,UAAU;IACZ,MAAM,WAAW,GAAG,YAAY,GAAG;IACnC,MAAM,eAAe,qBACnB,eACA,UACA,mBACA;KAAE;KAAU,QAAQ;KAAM,CAC3B;IAED,IAAI,SAA6B;AAEjC,QAAI;AAMF,eALiB,MAAM,cACrB,cACA,GAAG,SAAS,UACZ,OACD,GACkB;aACZ,GAAG;AACV,SAAI,yBAAyB,EAAE,CAC7B,OAAM;KAER,MAAM,eAAe,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC/D,iBAAY,6BAA6B;MACvC;MACA,OAAO;MACR,CAAC;AACF,aAAQ,KACN,6HACA,aACA,aACD;;AAGH,WAAO,oBAAoB,OAAO;;;EAKvC"}

package/src/lib/angular-pending-tasks.plugin.d.ts

@@ -1,9 +1,9 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
 /**
- * This plugin is a workaround for the ɵPendingTasks symbol being renamed
- * to ɵPendingTasksInternal in Angular v19.0.4. The symbol is renamed to support previous versions of
- * Angular with Analog that used the ɵPendingTasks symbol.
- *
- * Commmit: https://github.com/angular/angular/commit/24e317cb157bf1ef159ed8554f1b79cb3443edf4
- */
+* This plugin is a workaround for the ɵPendingTasks symbol being renamed
+* to ɵPendingTasksInternal in Angular v19.0.4. The symbol is renamed to support previous versions of
+* Angular with Analog that used the ɵPendingTasks symbol.
+*
+* Commmit: https://github.com/angular/angular/commit/24e317cb157bf1ef159ed8554f1b79cb3443edf4
+*/
 export declare function pendingTasksPlugin(): Plugin;

package/src/lib/angular-pending-tasks.plugin.js

@@ -1,21 +1,20 @@
+//#region packages/vite-plugin-angular/src/lib/angular-pending-tasks.plugin.ts
 /**
- * This plugin is a workaround for the ɵPendingTasks symbol being renamed
- * to ɵPendingTasksInternal in Angular v19.0.4. The symbol is renamed to support previous versions of
- * Angular with Analog that used the ɵPendingTasks symbol.
- *
- * Commmit: https://github.com/angular/angular/commit/24e317cb157bf1ef159ed8554f1b79cb3443edf4
- */
-export function pendingTasksPlugin() {
-    return {
-        name: 'analogjs-pending-tasks-plugin',
-        transform(code, id) {
-            if (id.includes('analogjs-content.mjs')) {
-                return {
-                    code: code.replace('ɵPendingTasksInternal', 'ɵPendingTasks'),
-                };
-            }
-            return;
-        },
-    };
+* This plugin is a workaround for the ɵPendingTasks symbol being renamed
+* to ɵPendingTasksInternal in Angular v19.0.4. The symbol is renamed to support previous versions of
+* Angular with Analog that used the ɵPendingTasks symbol.
+*
+* Commmit: https://github.com/angular/angular/commit/24e317cb157bf1ef159ed8554f1b79cb3443edf4
+*/
+function pendingTasksPlugin() {
+	return {
+		name: "analogjs-pending-tasks-plugin",
+		transform(code, id) {
+			if (id.includes("analogjs-content.mjs")) return { code: code.replace("ɵPendingTasksInternal", "ɵPendingTasks") };
+		}
+	};
 }
+//#endregion
+export { pendingTasksPlugin };
+
 //# sourceMappingURL=angular-pending-tasks.plugin.js.map

package/src/lib/angular-pending-tasks.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"angular-pending-tasks.plugin.js","sourceRoot":"","sources":["../../../../../packages/vite-plugin-angular/src/lib/angular-pending-tasks.plugin.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,+BAA+B;QACrC,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBACxC,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,eAAe,CAAC;iBAC7D,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"angular-pending-tasks.plugin.js","names":[],"sources":["../../../src/lib/angular-pending-tasks.plugin.ts"],"sourcesContent":["import { Plugin } from 'vite';\n\nimport { angularFullVersion } from './utils/devkit.js';\n\n/**\n * This plugin is a workaround for the ɵPendingTasks symbol being renamed\n * to ɵPendingTasksInternal in Angular v19.0.4. The symbol is renamed to support previous versions of\n * Angular with Analog that used the ɵPendingTasks symbol.\n *\n * Commmit: https://github.com/angular/angular/commit/24e317cb157bf1ef159ed8554f1b79cb3443edf4\n */\nexport function pendingTasksPlugin(): Plugin {\n  return {\n    name: 'analogjs-pending-tasks-plugin',\n    transform(code, id) {\n      if (id.includes('analogjs-content.mjs')) {\n        return {\n          code: code.replace('ɵPendingTasksInternal', 'ɵPendingTasks'),\n        };\n      }\n      return;\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAWA,SAAgB,qBAA6B;AAC3C,QAAO;EACL,MAAM;EACN,UAAU,MAAM,IAAI;AAClB,OAAI,GAAG,SAAS,uBAAuB,CACrC,QAAO,EACL,MAAM,KAAK,QAAQ,yBAAyB,gBAAgB,EAC7D;;EAIN"}

package/src/lib/angular-vite-plugin.d.ts

@@ -1,76 +1,184 @@
-import { NgtscProgram } from '@angular/compiler-cli';
-import * as ts from 'typescript';
-import { Plugin } from 'vite';
-import { FileReplacement } from './plugins/file-replacements.plugin.js';
-export declare enum DiagnosticModes {
-    None = 0,
-    Option = 1,
-    Syntactic = 2,
-    Semantic = 4,
-    All = 7
-}
+import { NgtscProgram } from "@angular/compiler-cli";
+import * as ts from "typescript";
+import { ModuleNode, Plugin, ViteDevServer } from "vite";
+import type { StylePreprocessor } from "./style-preprocessor.js";
+import { type DebugOption } from "./utils/debug.js";
+import { FileReplacement } from "./plugins/file-replacements.plugin.js";
+import { AnalogStylesheetRegistry } from "./stylesheet-registry.js";
+import { AngularStylePipelineOptions } from "./style-pipeline.js";
+export { DiagnosticModes, injectViteIgnoreForHmrMetadata, isIgnoredHmrFile, toAngularCompilationFileReplacements, mapTemplateUpdatesToFiles, refreshStylesheetRegistryForFile, describeStylesheetContent, isTestWatchMode } from "./utils/compilation-shared.js";
+export { buildStylePreprocessor } from "./tailwind-plugin.js";
 export interface PluginOptions {
-    tsconfig?: string | (() => string);
-    workspaceRoot?: string;
-    inlineStylesExtension?: string;
-    jit?: boolean;
-    advanced?: {
-        /**
-         * Custom TypeScript transformers that are run before Angular compilation
-         */
-        tsTransformers?: ts.CustomTransformers;
-    };
-    supportedBrowsers?: string[];
-    transformFilter?: (code: string, id: string) => boolean;
-    /**
-     * Additional files to include in compilation
-     */
-    include?: string[];
-    additionalContentDirs?: string[];
-    liveReload?: boolean;
-    disableTypeChecking?: boolean;
-    fileReplacements?: FileReplacement[];
-    experimental?: {
-        useAngularCompilationAPI?: boolean;
-    };
+	tsconfig?: string | (() => string);
+	workspaceRoot?: string;
+	inlineStylesExtension?: string;
+	jit?: boolean;
+	advanced?: {
+		/**
+		* Custom TypeScript transformers that are run before Angular compilation
+		*/
+		tsTransformers?: ts.CustomTransformers;
+	};
+	supportedBrowsers?: string[];
+	transformFilter?: (code: string, id: string) => boolean;
+	/**
+	* Additional files to include in compilation
+	*/
+	include?: string[];
+	additionalContentDirs?: string[];
+	/**
+	* Enables Analog's Angular live-reload/HMR pipeline during development/watch mode.
+	*
+	* This is separate from Vite's `server.hmr` option, which configures the
+	* HMR client transport.
+	*
+	* Defaults to `true` for watch mode. Set to `false` to disable Angular
+	* reload updates while keeping other stylesheet externalization behavior
+	* available when needed.
+	*/
+	liveReload?: boolean;
+	disableTypeChecking?: boolean;
+	fileReplacements?: FileReplacement[];
+	/**
+	* Opt into the fast compile path. Skips Angular's template type-checking
+	* and routes compilation through an internal single-pass transform.
+	* Defaults to `false`.
+	*/
+	fastCompile?: boolean;
+	/**
+	* Compilation output mode used when `fastCompile` is enabled.
+	* - `'full'` (default): Emit final Ivy definitions for application builds.
+	* - `'partial'`: Emit partial declarations for library publishing.
+	*/
+	fastCompileMode?: "full" | "partial";
+	experimental?: {
+		useAngularCompilationAPI?: boolean;
+	};
+	/**
+	* Enable debug logging for specific scopes.
+	*
+	* - `true` → enables all `analog:angular:*` scopes
+	* - `string[]` → enables listed namespaces (e.g. `['analog:angular:tailwind']`)
+	* - `{ scopes?, mode? }` → object form with optional `mode: 'build' | 'dev'`
+	*   to restrict output to a specific Vite command (omit for both)
+	*
+	* Also responds to the `DEBUG` env var (Node.js) or `localStorage.debug`
+	* (browser), using the `obug` convention.
+	*/
+	debug?: DebugOption;
+	/**
+	* Optional preprocessor that transforms component CSS before it enters Vite's
+	* preprocessCSS pipeline. Runs on every component stylesheet (both external
+	* `.component.css` files and inline `styles: [...]` blocks).
+	*
+	* @param code - Raw CSS content of the component stylesheet
+	* @param filename - Resolved file path of the stylesheet (or containing .ts file for inline styles)
+	* @returns Transformed CSS string, or the original code if no transformation is needed
+	*/
+	stylePreprocessor?: StylePreprocessor;
+	/**
+	* Experimental Angular stylesheet-resource hooks for community-maintained
+	* style-pipeline plugins.
+	*
+	* These hooks run inside the Angular resource pipeline, which is the seam a
+	* standalone Vite plugin cannot own on its own.
+	*/
+	stylePipeline?: AngularStylePipelineOptions;
+	/**
+	* First-class Tailwind CSS v4 integration for Angular component styles.
+	*
+	* Angular's compiler processes component CSS through Vite's `preprocessCSS()`,
+	* which runs `@tailwindcss/vite` — but each component stylesheet is processed
+	* in isolation without access to the root Tailwind configuration (prefix, @theme,
+	* @custom-variant, @plugin definitions). This causes errors like:
+	*
+	*   "Cannot apply utility class `sa:grid` because the `sa` variant does not exist"
+	*
+	* The `tailwindCss` option solves this by auto-injecting a `@reference` directive
+	* into every component CSS file that uses Tailwind utilities, pointing it to the
+	* root Tailwind stylesheet so `@tailwindcss/vite` can resolve the full configuration.
+	*
+	* @example Basic usage — reference a root Tailwind CSS file:
+	* ```ts
+	* import { resolve } from 'node:path';
+	*
+	* angular({
+	*   tailwindCss: {
+	*     rootStylesheet: resolve(__dirname, 'src/styles/tailwind.css'),
+	*   },
+	* })
+	* ```
+	*
+	* @example With prefix detection — only inject for files using specific prefixes:
+	* ```ts
+	* angular({
+	*   tailwindCss: {
+	*     rootStylesheet: resolve(__dirname, 'src/styles/tailwind.css'),
+	*     // Only inject @reference into files that use these prefixed classes
+	*     prefixes: ['sa:', 'tw:'],
+	*   },
+	* })
+	* ```
+	*
+	* @example AnalogJS platform — passed through the `vite` option:
+	* ```ts
+	* analog({
+	*   vite: {
+	*     tailwindCss: {
+	*       rootStylesheet: resolve(__dirname, '../../../libs/meritos/tailwind.config.css'),
+	*     },
+	*   },
+	* })
+	* ```
+	*/
+	tailwindCss?: {
+		/**
+		* Absolute path to the root Tailwind CSS file that contains `@import "tailwindcss"`,
+		* `@theme`, `@custom-variant`, and `@plugin` definitions.
+		*
+		* A `@reference` directive pointing to this file will be auto-injected into
+		* component CSS files that use Tailwind utilities.
+		*/
+		rootStylesheet: string;
+		/**
+		* Optional list of class prefixes to detect (e.g. `['sa:', 'tw:']`).
+		* When provided, `@reference` is only injected into component CSS files that
+		* contain at least one of these prefixes. When omitted, `@reference` is injected
+		* into all component CSS files that contain `@apply` or `@` directives.
+		*
+		* @default undefined — inject into all component CSS files with `@apply`
+		*/
+		prefixes?: string[];
+	};
 }
+export declare function evictDeletedFileMetadata(file: string, { classNamesMap, fileTransformMap }: {
+	classNamesMap: Map<string, string>;
+	fileTransformMap: Map<string, string>;
+}): void;
 export declare function angular(options?: PluginOptions): Plugin[];
 export declare function createFsWatcherCacheInvalidator(invalidateFsCaches: () => void, invalidateTsconfigCaches: () => void, performCompilation: () => Promise<void>): () => Promise<void>;
 /**
- * Convert Analog/Angular CLI-style file replacements into the flat record
- * expected by `AngularHostOptions.fileReplacements`.
- *
- * Only browser replacements (`{ replace, with }`) are converted. SSR-only
- * replacements (`{ replace, ssr }`) are left for the Vite runtime plugin to
- * handle — they should not be baked into the Angular compilation host because
- * that would apply them to both browser and server builds.
- *
- * Relative paths are resolved against `workspaceRoot` so that the host
- * receives the same absolute paths it would get from the Angular CLI.
- */
-export declare function toAngularCompilationFileReplacements(replacements: FileReplacement[], workspaceRoot: string): Record<string, string> | undefined;
+* Returns every live Vite module that can legitimately represent a changed
+* Angular resource file.
+*
+* For normal files, `getModulesByFile()` is enough. For Angular component
+* stylesheets, it is not: the browser often holds virtual hashed requests
+* (`/abc123.css?direct&ngcomp=...` and `/abc123.css?ngcomp=...`) that are no
+* longer discoverable from the original source path alone. We therefore merge:
+* - watcher event modules
+* - module-graph modules by source file
+* - registry-tracked live request ids resolved back through the module graph
+*/
+export declare function getModulesForChangedFile(server: ViteDevServer, file: string, eventModules?: readonly ModuleNode[], stylesheetRegistry?: AnalogStylesheetRegistry): Promise<ModuleNode[]>;
+export declare function isModuleForChangedResource(mod: ModuleNode, changedFile: string, stylesheetRegistry?: AnalogStylesheetRegistry): boolean;
+export declare function findComponentStylesheetWrapperModules(server: ViteDevServer, changedFile: string, directModule: ModuleNode, fileModules: ModuleNode[], stylesheetRegistry?: AnalogStylesheetRegistry): Promise<ModuleNode[]>;
+export declare function findTemplateOwnerModules(server: ViteDevServer, resourceFile: string): ModuleNode[];
 /**
- * Map Angular's `templateUpdates` (keyed by `encodedFilePath@ClassName`)
- * back to absolute file paths with their associated HMR code and component
- * class name.
- *
- * Angular's private Compilation API emits template update keys in the form
- * `encodeURIComponent(relativePath + '@' + className)`. We decode and resolve
- * them so the caller can look up updates by the same normalized absolute path
- * used elsewhere in the plugin (`outputFiles`, `classNames`, etc.).
- */
-export declare function mapTemplateUpdatesToFiles(templateUpdates: ReadonlyMap<string, string> | undefined): Map<string, {
-    className: string;
-    code: string;
-}>;
-export declare function getFileMetadata(program: ts.BuilderProgram, angularCompiler?: NgtscProgram['compiler'], liveReload?: boolean, disableTypeChecking?: boolean): (file: string) => {
-    errors?: string[];
-    warnings?: (string | ts.DiagnosticMessageChain)[];
-    hmrUpdateCode?: string | null;
-    hmrEligible?: boolean;
+* @internal
+*/
+export declare function getFileMetadata(program: ts.BuilderProgram, angularCompiler?: NgtscProgram["compiler"], hmrEnabled?: boolean, disableTypeChecking?: boolean): (file: string) => {
+	errors?: string[];
+	warnings?: (string | ts.DiagnosticMessageChain)[];
+	hmrUpdateCode?: string | null;
+	hmrEligible?: boolean;
 };
-/**
- * Checks for vitest run from the command line
- * @returns boolean
- */
-export declare function isTestWatchMode(args?: string[]): boolean;