@analogjs/vite-plugin-angular 3.0.0-alpha.6 → 3.0.0-alpha.60

package/src/lib/tools/src/builders/vite-dev-server/dev-server.impl.js

@@ -1,65 +1,54 @@
-import { createBuilder, targetFromTargetString, } from '@angular-devkit/architect';
+let _angular_devkit_architect = require("@angular-devkit/architect");
+//#region packages/vite-plugin-angular-tools/src/builders/vite-dev-server/dev-server.impl.ts
 async function viteDevServerBuilder(options, context) {
-    const { createServer } = await Function('return import("vite")')();
-    if (!context.target) {
-        throw new Error('Builder must be executed with a target');
-    }
-    const projectConfig = await context.getProjectMetadata(context.target);
-    const projectName = context.target.project;
-    const buildTargetSpecifier = options.buildTarget ?? `::development`;
-    const buildTarget = targetFromTargetString(buildTargetSpecifier, projectName, 'build');
-    const browserBuilderName = await context.getBuilderNameForTarget(buildTarget);
-    const rawBuildOptions = await context.getTargetOptions(buildTarget);
-    const buildOptions = await context.validateOptions(rawBuildOptions, browserBuilderName);
-    const serverConfig = {
-        configFile: buildOptions.configFile,
-        root: projectConfig.root,
-        mode: (process.env.NODE_ENV ??
-            buildOptions.mode ??
-            'development'),
-        build: {
-            sourcemap: !!buildOptions.sourcemap,
-        },
-        server: {
-            hmr: options?.hmr,
-            port: options?.port,
-        },
-    };
-    try {
-        const server = await createServer(serverConfig);
-        await runViteDevServer(server);
-        const resolvedUrls = [
-            ...server.resolvedUrls.local,
-            ...server.resolvedUrls.network,
-        ];
-        await new Promise((resolve) => {
-            process.once('SIGINT', () => resolve());
-            process.once('SIGTERM', () => resolve());
-            process.once('exit', () => resolve());
-        });
-        return {
-            success: true,
-            baseUrl: resolvedUrls[0] ?? '',
-        };
-    }
-    catch (e) {
-        console.error(e);
-        return {
-            success: false,
-            baseUrl: '',
-        };
-    }
+	const { createServer } = await Function("return import(\"vite\")")();
+	if (!context.target) throw new Error("Builder must be executed with a target");
+	const projectConfig = await context.getProjectMetadata(context.target);
+	const projectName = context.target.project;
+	const buildTarget = (0, _angular_devkit_architect.targetFromTargetString)(options.buildTarget ?? `::development`, projectName, "build");
+	const browserBuilderName = await context.getBuilderNameForTarget(buildTarget);
+	const rawBuildOptions = await context.getTargetOptions(buildTarget);
+	const buildOptions = await context.validateOptions(rawBuildOptions, browserBuilderName);
+	const serverConfig = {
+		configFile: buildOptions.configFile,
+		root: projectConfig.root,
+		mode: process.env.NODE_ENV ?? buildOptions.mode ?? "development",
+		build: { sourcemap: !!buildOptions.sourcemap },
+		server: {
+			hmr: options?.hmr,
+			port: options?.port
+		}
+	};
+	try {
+		const server = await createServer(serverConfig);
+		await server.listen();
+		server.printUrls();
+		const resolvedUrls = [...server.resolvedUrls.local, ...server.resolvedUrls.network];
+		const processOnExit = async () => {
+			await server.close();
+		};
+		await new Promise((resolve) => {
+			const shutdown = () => {
+				processOnExit().then(() => resolve(), () => resolve());
+			};
+			process.once("SIGINT", shutdown);
+			process.once("SIGTERM", shutdown);
+			process.once("exit", shutdown);
+		});
+		return {
+			success: true,
+			baseUrl: resolvedUrls[0] ?? ""
+		};
+	} catch (e) {
+		console.error(e);
+		return {
+			success: false,
+			baseUrl: ""
+		};
+	}
 }
-// vite ViteDevServer
-async function runViteDevServer(server) {
-    await server.listen();
-    server.printUrls();
-    const processOnExit = async () => {
-        await server.close();
-    };
-    process.once('SIGINT', processOnExit);
-    process.once('SIGTERM', processOnExit);
-    process.once('exit', processOnExit);
-}
-export default createBuilder(viteDevServerBuilder);
+var dev_server_impl_default = (0, _angular_devkit_architect.createBuilder)(viteDevServerBuilder);
+//#endregion
+module.exports = dev_server_impl_default;
+
 //# sourceMappingURL=dev-server.impl.js.map

package/src/lib/tools/src/builders/vite-dev-server/dev-server.impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.impl.js","sourceRoot":"","sources":["../../../../../../../../../packages/vite-plugin-angular-tools/src/builders/vite-dev-server/dev-server.impl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev-server.impl.js","names":[],"sources":["../../../../../../../../vite-plugin-angular-tools/src/builders/vite-dev-server/dev-server.impl.ts"],"sourcesContent":["import {\n  BuilderContext,\n  BuilderOutput,\n  createBuilder,\n  targetFromTargetString,\n} from '@angular-devkit/architect';\nimport type { InlineConfig } from 'vite';\nimport { ViteDevServerSchema } from './schema';\n\nasync function viteDevServerBuilder(\n  options: ViteDevServerSchema,\n  context: BuilderContext,\n): Promise<BuilderOutput> {\n  const { createServer } = await Function('return import(\"vite\")')();\n  if (!context.target) {\n    throw new Error('Builder must be executed with a target');\n  }\n  const projectConfig = await context.getProjectMetadata(context.target);\n  const projectName = context.target.project;\n  const buildTargetSpecifier = options.buildTarget ?? `::development`;\n  const buildTarget = targetFromTargetString(\n    buildTargetSpecifier,\n    projectName,\n    'build',\n  );\n\n  const browserBuilderName = await context.getBuilderNameForTarget(buildTarget);\n  const rawBuildOptions = await context.getTargetOptions(buildTarget);\n  const buildOptions = await context.validateOptions(\n    rawBuildOptions,\n    browserBuilderName,\n  );\n\n  const serverConfig: InlineConfig = {\n    configFile: buildOptions.configFile as string,\n    root: projectConfig.root as string,\n    mode: (process.env.NODE_ENV ??\n      buildOptions.mode ??\n      'development') as string,\n    build: {\n      sourcemap: !!buildOptions.sourcemap,\n    },\n    server: {\n      hmr: options?.hmr,\n      port: options?.port,\n    },\n  };\n\n  try {\n    const server = await createServer(serverConfig);\n    await server.listen();\n    server.printUrls();\n\n    const resolvedUrls = [\n      ...server.resolvedUrls.local,\n      ...server.resolvedUrls.network,\n    ];\n\n    const processOnExit = async () => {\n      await server.close();\n    };\n\n    // Use process.once to avoid listener accumulation when Nx invokes\n    // multiple builders in the same process during a large build graph.\n    await new Promise<void>((resolve) => {\n      const shutdown = () => {\n        processOnExit().then(\n          () => resolve(),\n          () => resolve(),\n        );\n      };\n      process.once('SIGINT', shutdown);\n      process.once('SIGTERM', shutdown);\n      process.once('exit', shutdown);\n    });\n\n    return {\n      success: true,\n      baseUrl: resolvedUrls[0] ?? '',\n    };\n  } catch (e) {\n    console.error(e);\n    return {\n      success: false,\n      baseUrl: '',\n    };\n  }\n}\n\nexport default createBuilder(viteDevServerBuilder) as any;\n"],"mappings":";;AASA,eAAe,qBACb,SACA,SACwB;CACxB,MAAM,EAAE,iBAAiB,MAAM,SAAS,0BAAwB,EAAE;AAClE,KAAI,CAAC,QAAQ,OACX,OAAM,IAAI,MAAM,yCAAyC;CAE3D,MAAM,gBAAgB,MAAM,QAAQ,mBAAmB,QAAQ,OAAO;CACtE,MAAM,cAAc,QAAQ,OAAO;CAEnC,MAAM,eAAA,GAAA,0BAAA,wBADuB,QAAQ,eAAe,iBAGlD,aACA,QACD;CAED,MAAM,qBAAqB,MAAM,QAAQ,wBAAwB,YAAY;CAC7E,MAAM,kBAAkB,MAAM,QAAQ,iBAAiB,YAAY;CACnE,MAAM,eAAe,MAAM,QAAQ,gBACjC,iBACA,mBACD;CAED,MAAM,eAA6B;EACjC,YAAY,aAAa;EACzB,MAAM,cAAc;EACpB,MAAA,QAAA,IAAA,YACE,aAAa,QACb;EACF,OAAO,EACL,WAAW,CAAC,CAAC,aAAa,WAC3B;EACD,QAAQ;GACN,KAAK,SAAS;GACd,MAAM,SAAS;GAChB;EACF;AAED,KAAI;EACF,MAAM,SAAS,MAAM,aAAa,aAAa;AAC/C,QAAM,OAAO,QAAQ;AACrB,SAAO,WAAW;EAElB,MAAM,eAAe,CACnB,GAAG,OAAO,aAAa,OACvB,GAAG,OAAO,aAAa,QACxB;EAED,MAAM,gBAAgB,YAAY;AAChC,SAAM,OAAO,OAAO;;AAKtB,QAAM,IAAI,SAAe,YAAY;GACnC,MAAM,iBAAiB;AACrB,mBAAe,CAAC,WACR,SAAS,QACT,SAAS,CAChB;;AAEH,WAAQ,KAAK,UAAU,SAAS;AAChC,WAAQ,KAAK,WAAW,SAAS;AACjC,WAAQ,KAAK,QAAQ,SAAS;IAC9B;AAEF,SAAO;GACL,SAAS;GACT,SAAS,aAAa,MAAM;GAC7B;UACM,GAAG;AACV,UAAQ,MAAM,EAAE;AAChB,SAAO;GACL,SAAS;GACT,SAAS;GACV;;;AAIL,IAAA,2BAAA,GAAA,0BAAA,eAA6B,qBAAqB"}

package/src/lib/tools/src/index.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=index.js.map

package/src/lib/utils/compilation-shared.d.ts

@@ -0,0 +1,62 @@
+import { AnalogStylesheetRegistry } from "../stylesheet-registry.js";
+import type { StylePreprocessor } from "../style-preprocessor.js";
+import type { FileReplacement } from "../plugins/file-replacements.plugin.js";
+export declare enum DiagnosticModes {
+	None = 0,
+	Option = 1,
+	Syntactic = 2,
+	Semantic = 4,
+	All = 7
+}
+export declare function injectViteIgnoreForHmrMetadata(code: string): string;
+export declare function isIgnoredHmrFile(file: string): boolean;
+/**
+* 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;
+/**
+* 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 describeStylesheetContent(code: string): {
+	length: number;
+	digest: string;
+	preview: string;
+};
+/**
+* Refreshes any already-served stylesheet records that map back to a changed
+* source file.
+*
+* This is the critical bridge for externalized Angular component styles during
+* HMR. Angular's resource watcher can notice that `/src/...component.css`
+* changed before Angular recompilation has had a chance to repopulate the
+* stylesheet registry. If we emit a CSS update against the existing virtual
+* stylesheet id without first refreshing the registry content, the browser gets
+* a hot update containing stale CSS. By rewriting the existing served records
+* from disk up front, HMR always pushes the latest source content.
+*/
+export declare function refreshStylesheetRegistryForFile(file: string, stylesheetRegistry?: AnalogStylesheetRegistry, stylePreprocessor?: StylePreprocessor): void;
+/**
+* Checks for vitest run from the command line
+* @returns boolean
+*/
+export declare function isTestWatchMode(args?): boolean;

package/src/lib/utils/compilation-shared.js

@@ -0,0 +1,138 @@
+import { debugStylesV } from "./debug.js";
+import { normalizeStylesheetDependencies } from "../style-preprocessor.js";
+import { preprocessStylesheetResult, rewriteRelativeCssImports } from "../stylesheet-registry.js";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, isAbsolute, resolve } from "node:path";
+import { normalizePath } from "vite";
+import { createHash } from "node:crypto";
+//#region packages/vite-plugin-angular/src/lib/utils/compilation-shared.ts
+/**
+* Shared utilities used by both angular-vite-plugin.ts and
+* compilation-api/compilation-api-plugin.ts.
+*/
+var DiagnosticModes = /* @__PURE__ */ function(DiagnosticModes) {
+	DiagnosticModes[DiagnosticModes["None"] = 0] = "None";
+	DiagnosticModes[DiagnosticModes["Option"] = 1] = "Option";
+	DiagnosticModes[DiagnosticModes["Syntactic"] = 2] = "Syntactic";
+	DiagnosticModes[DiagnosticModes["Semantic"] = 4] = "Semantic";
+	DiagnosticModes[DiagnosticModes["All"] = 7] = "All";
+	return DiagnosticModes;
+}({});
+function injectViteIgnoreForHmrMetadata(code) {
+	let patched = code.replace(/\bimport\(([a-zA-Z_$][\w$]*\.\u0275\u0275getReplaceMetadataURL)/g, "import(/* @vite-ignore */ $1");
+	if (patched === code) patched = patched.replace(/import\((\S+getReplaceMetadataURL)/g, "import(/* @vite-ignore */ $1");
+	return patched;
+}
+function isIgnoredHmrFile(file) {
+	return file.endsWith(".tsbuildinfo");
+}
+/**
+* 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.
+*/
+function toAngularCompilationFileReplacements(replacements, workspaceRoot) {
+	const mappedReplacements = replacements.flatMap((replacement) => {
+		if (!("with" in replacement)) return [];
+		return [[isAbsolute(replacement.replace) ? replacement.replace : resolve(workspaceRoot, replacement.replace), isAbsolute(replacement.with) ? replacement.with : resolve(workspaceRoot, replacement.with)]];
+	});
+	return mappedReplacements.length ? Object.fromEntries(mappedReplacements) : void 0;
+}
+/**
+* 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.).
+*/
+function mapTemplateUpdatesToFiles(templateUpdates) {
+	const updatesByFile = /* @__PURE__ */ new Map();
+	templateUpdates?.forEach((code, encodedUpdateId) => {
+		const [file, className = ""] = decodeURIComponent(encodedUpdateId).split("@");
+		const resolvedFile = normalizePath(resolve(process.cwd(), file));
+		updatesByFile.set(resolvedFile, {
+			className,
+			code
+		});
+	});
+	return updatesByFile;
+}
+function describeStylesheetContent(code) {
+	return {
+		length: code.length,
+		digest: createHash("sha256").update(code).digest("hex").slice(0, 12),
+		preview: code.replace(/\s+/g, " ").trim().slice(0, 160)
+	};
+}
+/**
+* Refreshes any already-served stylesheet records that map back to a changed
+* source file.
+*
+* This is the critical bridge for externalized Angular component styles during
+* HMR. Angular's resource watcher can notice that `/src/...component.css`
+* changed before Angular recompilation has had a chance to repopulate the
+* stylesheet registry. If we emit a CSS update against the existing virtual
+* stylesheet id without first refreshing the registry content, the browser gets
+* a hot update containing stale CSS. By rewriting the existing served records
+* from disk up front, HMR always pushes the latest source content.
+*/
+function refreshStylesheetRegistryForFile(file, stylesheetRegistry, stylePreprocessor) {
+	const normalizedFile = normalizePath(file.split("?")[0]);
+	if (!stylesheetRegistry || !existsSync(normalizedFile)) return;
+	const publicIds = stylesheetRegistry.getPublicIdsForSource(normalizedFile);
+	if (publicIds.length === 0) return;
+	const rawCss = readFileSync(normalizedFile, "utf-8");
+	const preprocessed = preprocessStylesheetResult(rawCss, normalizedFile, stylePreprocessor);
+	const servedCss = rewriteRelativeCssImports(preprocessed.code, normalizedFile);
+	for (const publicId of publicIds) stylesheetRegistry.registerServedStylesheet({
+		publicId,
+		sourcePath: normalizedFile,
+		originalCode: rawCss,
+		normalizedCode: servedCss,
+		dependencies: normalizeStylesheetDependencies(preprocessed.dependencies),
+		diagnostics: preprocessed.diagnostics,
+		tags: preprocessed.tags
+	}, [
+		normalizedFile,
+		normalizePath(normalizedFile),
+		basename(normalizedFile),
+		normalizedFile.replace(/^\//, "")
+	]);
+	debugStylesV("stylesheet registry refreshed from source file", {
+		file: normalizedFile,
+		publicIds,
+		dependencies: preprocessed.dependencies,
+		diagnostics: preprocessed.diagnostics,
+		tags: preprocessed.tags,
+		source: describeStylesheetContent(rawCss),
+		served: describeStylesheetContent(servedCss)
+	});
+}
+/**
+* Checks for vitest run from the command line
+* @returns boolean
+*/
+function isTestWatchMode(args = process.argv) {
+	if (args.find((arg) => arg.includes("--run"))) return false;
+	if (args.includes("run")) return false;
+	if (args.find((arg) => arg.includes("--no-run"))) return true;
+	const hasWatch = args.find((arg) => arg.includes("watch"));
+	if (hasWatch && ["false", "no"].some((neg) => hasWatch.includes(neg))) return false;
+	const watchArg = args[args.findIndex((arg) => arg.includes("watch")) + 1];
+	if (watchArg && watchArg === "false") return false;
+	return true;
+}
+//#endregion
+export { DiagnosticModes, describeStylesheetContent, injectViteIgnoreForHmrMetadata, isIgnoredHmrFile, isTestWatchMode, mapTemplateUpdatesToFiles, refreshStylesheetRegistryForFile, toAngularCompilationFileReplacements };
+
+//# sourceMappingURL=compilation-shared.js.map

package/src/lib/utils/compilation-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compilation-shared.js","names":[],"sources":["../../../../src/lib/utils/compilation-shared.ts"],"sourcesContent":["/**\n * Shared utilities used by both angular-vite-plugin.ts and\n * compilation-api/compilation-api-plugin.ts.\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { basename, isAbsolute, resolve } from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { normalizePath } from 'vite';\n\nimport {\n  AnalogStylesheetRegistry,\n  preprocessStylesheetResult,\n  rewriteRelativeCssImports,\n} from '../stylesheet-registry.js';\nimport { normalizeStylesheetDependencies } from '../style-preprocessor.js';\nimport type { StylePreprocessor } from '../style-preprocessor.js';\nimport type { FileReplacement } from '../plugins/file-replacements.plugin.js';\nimport { debugStylesV } from './debug.js';\n\nexport enum DiagnosticModes {\n  None = 0,\n  Option = 1 << 0,\n  Syntactic = 1 << 1,\n  Semantic = 1 << 2,\n  All = Option | Syntactic | Semantic,\n}\n\nexport function injectViteIgnoreForHmrMetadata(code: string): string {\n  let patched = code.replace(\n    /\\bimport\\(([a-zA-Z_$][\\w$]*\\.\\u0275\\u0275getReplaceMetadataURL)/g,\n    'import(/* @vite-ignore */ $1',\n  );\n\n  if (patched === code) {\n    patched = patched.replace(\n      /import\\((\\S+getReplaceMetadataURL)/g,\n      'import(/* @vite-ignore */ $1',\n    );\n  }\n\n  return patched;\n}\n\nexport function isIgnoredHmrFile(file: string): boolean {\n  return file.endsWith('.tsbuildinfo');\n}\n\n/**\n * Convert Analog/Angular CLI-style file replacements into the flat record\n * expected by `AngularHostOptions.fileReplacements`.\n *\n * Only browser replacements (`{ replace, with }`) are converted. SSR-only\n * replacements (`{ replace, ssr }`) are left for the Vite runtime plugin to\n * handle — they should not be baked into the Angular compilation host because\n * that would apply them to both browser and server builds.\n *\n * Relative paths are resolved against `workspaceRoot` so that the host\n * receives the same absolute paths it would get from the Angular CLI.\n */\nexport function toAngularCompilationFileReplacements(\n  replacements: FileReplacement[],\n  workspaceRoot: string,\n): Record<string, string> | undefined {\n  const mappedReplacements = replacements.flatMap((replacement) => {\n    if (!('with' in replacement)) {\n      return [];\n    }\n\n    return [\n      [\n        isAbsolute(replacement.replace)\n          ? replacement.replace\n          : resolve(workspaceRoot, replacement.replace),\n        isAbsolute(replacement.with)\n          ? replacement.with\n          : resolve(workspaceRoot, replacement.with),\n      ] as const,\n    ];\n  });\n\n  return mappedReplacements.length\n    ? Object.fromEntries(mappedReplacements)\n    : undefined;\n}\n\n/**\n * Map Angular's `templateUpdates` (keyed by `encodedFilePath@ClassName`)\n * back to absolute file paths with their associated HMR code and component\n * class name.\n *\n * Angular's private Compilation API emits template update keys in the form\n * `encodeURIComponent(relativePath + '@' + className)`. We decode and resolve\n * them so the caller can look up updates by the same normalized absolute path\n * used elsewhere in the plugin (`outputFiles`, `classNames`, etc.).\n */\nexport function mapTemplateUpdatesToFiles(\n  templateUpdates: ReadonlyMap<string, string> | undefined,\n): Map<\n  string,\n  {\n    className: string;\n    code: string;\n  }\n> {\n  const updatesByFile = new Map<string, { className: string; code: string }>();\n\n  templateUpdates?.forEach((code, encodedUpdateId) => {\n    const [file, className = ''] =\n      decodeURIComponent(encodedUpdateId).split('@');\n    const resolvedFile = normalizePath(resolve(process.cwd(), file));\n\n    updatesByFile.set(resolvedFile, {\n      className,\n      code,\n    });\n  });\n\n  return updatesByFile;\n}\n\nexport function describeStylesheetContent(code: string): {\n  length: number;\n  digest: string;\n  preview: string;\n} {\n  return {\n    length: code.length,\n    digest: createHash('sha256').update(code).digest('hex').slice(0, 12),\n    preview: code.replace(/\\s+/g, ' ').trim().slice(0, 160),\n  };\n}\n\n/**\n * Refreshes any already-served stylesheet records that map back to a changed\n * source file.\n *\n * This is the critical bridge for externalized Angular component styles during\n * HMR. Angular's resource watcher can notice that `/src/...component.css`\n * changed before Angular recompilation has had a chance to repopulate the\n * stylesheet registry. If we emit a CSS update against the existing virtual\n * stylesheet id without first refreshing the registry content, the browser gets\n * a hot update containing stale CSS. By rewriting the existing served records\n * from disk up front, HMR always pushes the latest source content.\n */\nexport function refreshStylesheetRegistryForFile(\n  file: string,\n  stylesheetRegistry?: AnalogStylesheetRegistry,\n  stylePreprocessor?: StylePreprocessor,\n): void {\n  const normalizedFile = normalizePath(file.split('?')[0]);\n  if (!stylesheetRegistry || !existsSync(normalizedFile)) {\n    return;\n  }\n\n  const publicIds = stylesheetRegistry.getPublicIdsForSource(normalizedFile);\n  if (publicIds.length === 0) {\n    return;\n  }\n\n  const rawCss = readFileSync(normalizedFile, 'utf-8');\n  const preprocessed = preprocessStylesheetResult(\n    rawCss,\n    normalizedFile,\n    stylePreprocessor,\n  );\n  const servedCss = rewriteRelativeCssImports(\n    preprocessed.code,\n    normalizedFile,\n  );\n\n  for (const publicId of publicIds) {\n    stylesheetRegistry.registerServedStylesheet(\n      {\n        publicId,\n        sourcePath: normalizedFile,\n        originalCode: rawCss,\n        normalizedCode: servedCss,\n        dependencies: normalizeStylesheetDependencies(\n          preprocessed.dependencies,\n        ),\n        diagnostics: preprocessed.diagnostics,\n        tags: preprocessed.tags,\n      },\n      [\n        normalizedFile,\n        normalizePath(normalizedFile),\n        basename(normalizedFile),\n        normalizedFile.replace(/^\\//, ''),\n      ],\n    );\n  }\n\n  debugStylesV('stylesheet registry refreshed from source file', {\n    file: normalizedFile,\n    publicIds,\n    dependencies: preprocessed.dependencies,\n    diagnostics: preprocessed.diagnostics,\n    tags: preprocessed.tags,\n    source: describeStylesheetContent(rawCss),\n    served: describeStylesheetContent(servedCss),\n  });\n}\n\n/**\n * Checks for vitest run from the command line\n * @returns boolean\n */\nexport function isTestWatchMode(args = process.argv): boolean {\n  // vitest --run\n  const hasRun = args.find((arg) => arg.includes('--run'));\n  if (hasRun) {\n    return false;\n  }\n\n  // vitest run\n  if (args.includes('run')) {\n    return false;\n  }\n\n  // vitest --no-run\n  const hasNoRun = args.find((arg) => arg.includes('--no-run'));\n  if (hasNoRun) {\n    return true;\n  }\n\n  // check for --watch=false or --no-watch\n  const hasWatch = args.find((arg) => arg.includes('watch'));\n  if (hasWatch && ['false', 'no'].some((neg) => hasWatch.includes(neg))) {\n    return false;\n  }\n\n  // check for --watch false\n  const watchIndex = args.findIndex((arg) => arg.includes('watch'));\n  const watchArg = args[watchIndex + 1];\n  if (watchArg && watchArg === 'false') {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":"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"}

package/src/lib/utils/compiler-plugin-options.d.ts

@@ -1,13 +1,13 @@
-import { SourceFileCache } from './source-file-cache';
+import { SourceFileCache } from "./source-file-cache";
 export interface CompilerPluginOptions {
-    sourcemap: boolean;
-    tsconfig: string;
-    jit?: boolean;
-    /** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
-    noopTypeScriptCompilation?: boolean;
-    advancedOptimizations?: boolean;
-    thirdPartySourcemaps?: boolean;
-    fileReplacements?: Record<string, string>;
-    sourceFileCache?: SourceFileCache;
-    incremental: boolean;
+	sourcemap: boolean;
+	tsconfig: string;
+	jit?: boolean;
+	/** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
+	noopTypeScriptCompilation?: boolean;
+	advancedOptimizations?: boolean;
+	thirdPartySourcemaps?: boolean;
+	fileReplacements?: Record<string, string>;
+	sourceFileCache?: SourceFileCache;
+	incremental: boolean;
 }

package/src/lib/utils/css-extension-resolver.d.ts

@@ -0,0 +1,32 @@
+import * as vite from "vite";
+/**
+* Resolves bare-specifier `.css` imports with the `style` package-export
+* condition in scope, without leaking `style` into Vite's global
+* `resolve.conditions`.
+*
+* Two real cases pull in opposite directions on this condition:
+*
+*   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:
+*      Material's prebuilt theme entries are gated *only* under the `style`
+*      condition (no `default`, no `import`), so without `style` in scope
+*      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+*
+*   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS
+*      plugin resolver inherits Vite's global conditions. If `style` is
+*      injected globally, that resolver matches the package's `style`
+*      export (a `.css` file) and feeds it to Node's ESM loader, which
+*      can't load `.css` and throws
+*      `Internal server error: Unknown file extension ".css"`.
+*
+* The fix: scope the `style` condition to requests that *look* like CSS
+* assets — bare specifiers ending in `.css` (with optional query suffix
+* for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through
+* to Vite's normal resolver chain, so packages with mixed exports
+* (`tailwindcss-primeui` exposes both `style` and `import`) resolve to
+* their JS surface.
+*
+* Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes
+* `vite.createIdResolver(config, options)`. Their resolver-call signatures
+* differ — this plugin normalizes both.
+*/
+export declare function cssExtensionStyleResolverPlugin(): vite.Plugin;

package/src/lib/utils/css-extension-resolver.js

@@ -0,0 +1,73 @@
+import * as vite from "vite";
+//#region packages/vite-plugin-angular/src/lib/utils/css-extension-resolver.ts
+/**
+* Resolves bare-specifier `.css` imports with the `style` package-export
+* condition in scope, without leaking `style` into Vite's global
+* `resolve.conditions`.
+*
+* Two real cases pull in opposite directions on this condition:
+*
+*   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:
+*      Material's prebuilt theme entries are gated *only* under the `style`
+*      condition (no `default`, no `import`), so without `style` in scope
+*      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+*
+*   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS
+*      plugin resolver inherits Vite's global conditions. If `style` is
+*      injected globally, that resolver matches the package's `style`
+*      export (a `.css` file) and feeds it to Node's ESM loader, which
+*      can't load `.css` and throws
+*      `Internal server error: Unknown file extension ".css"`.
+*
+* The fix: scope the `style` condition to requests that *look* like CSS
+* assets — bare specifiers ending in `.css` (with optional query suffix
+* for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through
+* to Vite's normal resolver chain, so packages with mixed exports
+* (`tailwindcss-primeui` exposes both `style` and `import`) resolve to
+* their JS surface.
+*
+* Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes
+* `vite.createIdResolver(config, options)`. Their resolver-call signatures
+* differ — this plugin normalizes both.
+*/
+function cssExtensionStyleResolverPlugin() {
+	let resolveCss;
+	return {
+		name: "@analogjs/vite-plugin-angular:css-style-resolver",
+		enforce: "pre",
+		configResolved(config) {
+			const styleResolveOptions = {
+				...config.resolve,
+				conditions: [...config.resolve.conditions ?? [], "style"]
+			};
+			const createIdResolver = vite.createIdResolver;
+			if (typeof createIdResolver === "function") {
+				const r = createIdResolver(config, styleResolveOptions);
+				resolveCss = async (id, importer, environment) => {
+					return await r(environment ?? { name: "client" }, id, importer, false);
+				};
+				return;
+			}
+			const legacyCreateResolver = config.createResolver;
+			if (typeof legacyCreateResolver === "function") {
+				const r = legacyCreateResolver(styleResolveOptions);
+				resolveCss = async (id, importer) => {
+					return await r(id, importer, false, false);
+				};
+				return;
+			}
+			throw new Error("[@analogjs/vite-plugin-angular]: neither vite.createIdResolver (Vite 8) nor ResolvedConfig.createResolver (Vite 7) is available. Unsupported Vite version.");
+		},
+		async resolveId(id, importer) {
+			if (!resolveCss) return null;
+			if (id.startsWith(".") || id.startsWith("/") || /^[A-Za-z]:\//.test(id) || id.startsWith("\0") || id.startsWith("data:") || id.startsWith("virtual:")) return null;
+			if (!/\.css(?:\?|$)/.test(id)) return null;
+			const env = this.environment;
+			return await resolveCss(id, importer, env) ?? null;
+		}
+	};
+}
+//#endregion
+export { cssExtensionStyleResolverPlugin };
+
+//# sourceMappingURL=css-extension-resolver.js.map

package/src/lib/utils/css-extension-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-extension-resolver.js","names":[],"sources":["../../../../src/lib/utils/css-extension-resolver.ts"],"sourcesContent":["import * as vite from 'vite';\n\ntype CssResolver = (\n  id: string,\n  importer: string | undefined,\n  environment?: { name: string } | undefined,\n) => Promise<string | undefined>;\n\n/**\n * Resolves bare-specifier `.css` imports with the `style` package-export\n * condition in scope, without leaking `style` into Vite's global\n * `resolve.conditions`.\n *\n * Two real cases pull in opposite directions on this condition:\n *\n *   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:\n *      Material's prebuilt theme entries are gated *only* under the `style`\n *      condition (no `default`, no `import`), so without `style` in scope\n *      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.\n *\n *   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS\n *      plugin resolver inherits Vite's global conditions. If `style` is\n *      injected globally, that resolver matches the package's `style`\n *      export (a `.css` file) and feeds it to Node's ESM loader, which\n *      can't load `.css` and throws\n *      `Internal server error: Unknown file extension \".css\"`.\n *\n * The fix: scope the `style` condition to requests that *look* like CSS\n * assets — bare specifiers ending in `.css` (with optional query suffix\n * for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through\n * to Vite's normal resolver chain, so packages with mixed exports\n * (`tailwindcss-primeui` exposes both `style` and `import`) resolve to\n * their JS surface.\n *\n * Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes\n * `vite.createIdResolver(config, options)`. Their resolver-call signatures\n * differ — this plugin normalizes both.\n */\nexport function cssExtensionStyleResolverPlugin(): vite.Plugin {\n  let resolveCss: CssResolver | undefined;\n\n  return {\n    name: '@analogjs/vite-plugin-angular:css-style-resolver',\n    enforce: 'pre',\n\n    configResolved(config) {\n      const styleResolveOptions = {\n        ...config.resolve,\n        conditions: [...(config.resolve.conditions ?? []), 'style'],\n      };\n\n      const createIdResolver = (\n        vite as unknown as {\n          createIdResolver?: (\n            c: vite.ResolvedConfig,\n            o: typeof styleResolveOptions,\n          ) => (\n            environment: { name: string },\n            id: string,\n            importer: string | undefined,\n            ssr: boolean,\n          ) => Promise<string | undefined>;\n        }\n      ).createIdResolver;\n\n      if (typeof createIdResolver === 'function') {\n        const r = createIdResolver(config, styleResolveOptions);\n        resolveCss = async (id, importer, environment) => {\n          return await r(\n            environment ?? { name: 'client' },\n            id,\n            importer,\n            false,\n          );\n        };\n        return;\n      }\n\n      const legacyCreateResolver = (\n        config as unknown as {\n          createResolver?: (\n            o: typeof styleResolveOptions,\n          ) => (\n            id: string,\n            importer: string | undefined,\n            aliasOnly: boolean,\n            ssr: boolean,\n          ) => Promise<string | undefined>;\n        }\n      ).createResolver;\n\n      if (typeof legacyCreateResolver === 'function') {\n        const r = legacyCreateResolver(styleResolveOptions);\n        resolveCss = async (id, importer) => {\n          return await r(id, importer, false, false);\n        };\n        return;\n      }\n\n      // Both APIs have been stable across the supported Vite range\n      // (7.x via `ResolvedConfig.createResolver`, 8.x via\n      // `vite.createIdResolver`). If neither is present, fail loudly\n      // rather than silently regressing CSS imports of `style`-only\n      // package exports such as `@angular/material/prebuilt-themes/*`.\n      throw new Error(\n        '[@analogjs/vite-plugin-angular]: neither vite.createIdResolver ' +\n          '(Vite 8) nor ResolvedConfig.createResolver (Vite 7) is available. ' +\n          'Unsupported Vite version.',\n      );\n    },\n\n    async resolveId(id, importer) {\n      if (!resolveCss) return null;\n\n      // Skip non-bare specifiers — relative, absolute, virtual, and\n      // data-URI imports don't consult package exports, so the `style`\n      // condition is irrelevant for them.\n      if (\n        id.startsWith('.') ||\n        id.startsWith('/') ||\n        /^[A-Za-z]:\\//.test(id) ||\n        id.startsWith('\\0') ||\n        id.startsWith('data:') ||\n        id.startsWith('virtual:')\n      ) {\n        return null;\n      }\n\n      // Only fire on `.css` requests (with optional query, e.g. `?inline`,\n      // `?module`). Non-CSS bare specifiers go through Vite's normal\n      // resolver chain unchanged, which is critical for packages whose\n      // exports include both `style` and `import`/`default` — e.g.\n      // `tailwindcss-primeui`, where `@plugin` resolution must land on\n      // the JS file, not the CSS file.\n      if (!/\\.css(?:\\?|$)/.test(id)) return null;\n\n      const env = (this as unknown as { environment?: { name: string } })\n        .environment;\n      const resolved = await resolveCss(id, importer, env);\n      return resolved ?? null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,kCAA+C;CAC7D,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,SAAS;EAET,eAAe,QAAQ;GACrB,MAAM,sBAAsB;IAC1B,GAAG,OAAO;IACV,YAAY,CAAC,GAAI,OAAO,QAAQ,cAAc,EAAE,EAAG,QAAQ;IAC5D;GAED,MAAM,mBACJ,KAWA;AAEF,OAAI,OAAO,qBAAqB,YAAY;IAC1C,MAAM,IAAI,iBAAiB,QAAQ,oBAAoB;AACvD,iBAAa,OAAO,IAAI,UAAU,gBAAgB;AAChD,YAAO,MAAM,EACX,eAAe,EAAE,MAAM,UAAU,EACjC,IACA,UACA,MACD;;AAEH;;GAGF,MAAM,uBACJ,OAUA;AAEF,OAAI,OAAO,yBAAyB,YAAY;IAC9C,MAAM,IAAI,qBAAqB,oBAAoB;AACnD,iBAAa,OAAO,IAAI,aAAa;AACnC,YAAO,MAAM,EAAE,IAAI,UAAU,OAAO,MAAM;;AAE5C;;AAQF,SAAM,IAAI,MACR,6JAGD;;EAGH,MAAM,UAAU,IAAI,UAAU;AAC5B,OAAI,CAAC,WAAY,QAAO;AAKxB,OACE,GAAG,WAAW,IAAI,IAClB,GAAG,WAAW,IAAI,IAClB,eAAe,KAAK,GAAG,IACvB,GAAG,WAAW,KAAK,IACnB,GAAG,WAAW,QAAQ,IACtB,GAAG,WAAW,WAAW,CAEzB,QAAO;AAST,OAAI,CAAC,gBAAgB,KAAK,GAAG,CAAE,QAAO;GAEtC,MAAM,MAAO,KACV;AAEH,UADiB,MAAM,WAAW,IAAI,UAAU,IAAI,IACjC;;EAEtB"}

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

@@ -0,0 +1,23 @@
+import type { Debugger } from "obug";
+export type DebugMode = "build" | "dev";
+export interface DebugModeOptions<S extends string = string> {
+	scopes?: boolean | S[];
+	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
+}
+export type DebugOption<S extends string = string> = boolean | S[] | DebugModeOptions<S> | DebugModeOptions<S>[];
+export interface DebugHarness<S extends string = string> {
+	applyDebugOption(debug: DebugOption<S> | undefined, workspaceRoot?: string): void;
+	activateDeferredDebug(command: "build" | "serve"): void;
+	/** @internal test-only reset */
+	_resetDeferredDebug(): void;
+}
+export declare function createDebugHarness<S extends string = string>(config: {
+	fallbackNamespace: string;
+	instanceGroups: Debugger[][];
+}): DebugHarness<S>;

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

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