@analogjs/vite-plugin-angular 3.0.0-alpha.42 → 3.0.0-alpha.44

package/src/lib/template-class-binding-guard-plugin.js

@@ -0,0 +1,237 @@
+import { debugHmrV } from "./utils/debug.js";
+import { getAngularComponentMetadata } from "./component-resolvers.js";
+import { TS_EXT_REGEX } from "./utils/plugin-config.js";
+import { normalizePath } from "vite";
+//#region packages/vite-plugin-angular/src/lib/template-class-binding-guard-plugin.ts
+function templateClassBindingGuardPlugin(ctx) {
+	return {
+		name: "@analogjs/vite-plugin-angular:template-class-binding-guard",
+		enforce: "pre",
+		transform(code, id) {
+			if (id.includes("node_modules")) return;
+			const cleanId = id.split("?")[0];
+			if (/\.(html|htm)$/i.test(cleanId)) {
+				const staticClassIssue = findStaticClassAndBoundClassConflicts(code)[0];
+				if (staticClassIssue) throwTemplateClassBindingConflict(cleanId, staticClassIssue);
+				const mixedClassIssue = findBoundClassAndNgClassConflicts(code)[0];
+				if (mixedClassIssue) this.warn([
+					"[Analog Angular] Conflicting class composition.",
+					`File: ${cleanId}:${mixedClassIssue.line}:${mixedClassIssue.column}`,
+					"This element mixes `[class]` and `[ngClass]`.",
+					"Prefer a single class-binding strategy so class merging stays predictable.",
+					"Use one `[ngClass]` expression or explicit `[class.foo]` bindings.",
+					`Snippet: ${mixedClassIssue.snippet}`
+				].join("\n"));
+				return;
+			}
+			if (TS_EXT_REGEX.test(cleanId)) {
+				const rawStyleUrls = ctx.styleUrlsResolver.resolve(code, cleanId);
+				registerStyleOwnerMetadata(ctx, cleanId, rawStyleUrls);
+				debugHmrV("component stylesheet owner metadata registered", {
+					file: cleanId,
+					styleUrlCount: rawStyleUrls.length,
+					styleUrls: rawStyleUrls,
+					ownerSources: [...ctx.transformedStyleOwnerMetadata.get(cleanId)?.map((record) => record.sourcePath) ?? []]
+				});
+				const components = getAngularComponentMetadata(code);
+				const inlineTemplateIssue = components.flatMap((component) => component.inlineTemplates.flatMap((template) => findStaticClassAndBoundClassConflicts(template)))[0];
+				if (inlineTemplateIssue) throwTemplateClassBindingConflict(cleanId, inlineTemplateIssue);
+				const mixedInlineClassIssue = components.flatMap((component) => component.inlineTemplates.flatMap((template) => findBoundClassAndNgClassConflicts(template)))[0];
+				if (mixedInlineClassIssue) this.warn([
+					"[Analog Angular] Conflicting class composition.",
+					`File: ${cleanId}:${mixedInlineClassIssue.line}:${mixedInlineClassIssue.column}`,
+					"This element mixes `[class]` and `[ngClass]`.",
+					"Prefer a single class-binding strategy so class merging stays predictable.",
+					"Use one `[ngClass]` expression or explicit `[class.foo]` bindings.",
+					`Snippet: ${mixedInlineClassIssue.snippet}`
+				].join("\n"));
+				registerActiveGraphMetadata(ctx, cleanId, components.map((component) => ({
+					file: cleanId,
+					className: component.className,
+					selector: component.selector
+				})));
+				for (const component of components) {
+					if (!component.selector && !isLikelyPageOnlyComponent(cleanId)) throw new Error([
+						"[Analog Angular] Selectorless component detected.",
+						`File: ${cleanId}`,
+						`Component: ${component.className}`,
+						"This component has no `selector`, so Angular will render it as `ng-component`.",
+						"That increases the chance of component ID collisions and makes diagnostics harder to interpret.",
+						"Add an explicit selector for reusable components.",
+						"Selectorless components are only supported for page and route-only files."
+					].join("\n"));
+					if (component.selector) {
+						const selectorEntries = ctx.selectorOwners.get(component.selector);
+						if (selectorEntries && selectorEntries.size > 1) throw new Error([
+							"[Analog Angular] Duplicate component selector detected.",
+							`Selector: ${component.selector}`,
+							"Multiple components in the active application graph use the same selector.",
+							"Selectors must be unique within the active graph to avoid ambiguous rendering and confusing diagnostics.",
+							`Locations:\n${formatActiveGraphLocations(selectorEntries)}`
+						].join("\n"));
+					}
+					const classNameEntries = ctx.classNameOwners.get(component.className);
+					if (classNameEntries && classNameEntries.size > 1) this.warn([
+						"[Analog Angular] Duplicate component class name detected.",
+						`Class name: ${component.className}`,
+						"Two or more Angular components in the active graph share the same exported class name.",
+						"Rename one of them to keep HMR, stack traces, and compiler diagnostics unambiguous.",
+						`Locations:\n${formatActiveGraphLocations(classNameEntries)}`
+					].join("\n"));
+				}
+			}
+		}
+	};
+}
+function removeActiveGraphMetadata(ctx, file) {
+	const previous = ctx.activeGraphComponentMetadata.get(file);
+	if (!previous) return;
+	for (const record of previous) {
+		const location = `${record.file}#${record.className}`;
+		if (record.selector) {
+			const selectorSet = ctx.selectorOwners.get(record.selector);
+			selectorSet?.delete(location);
+			if (selectorSet?.size === 0) ctx.selectorOwners.delete(record.selector);
+		}
+		const classNameSet = ctx.classNameOwners.get(record.className);
+		classNameSet?.delete(location);
+		if (classNameSet?.size === 0) ctx.classNameOwners.delete(record.className);
+	}
+	ctx.activeGraphComponentMetadata.delete(file);
+}
+function registerActiveGraphMetadata(ctx, file, records) {
+	removeActiveGraphMetadata(ctx, file);
+	if (records.length === 0) return;
+	ctx.activeGraphComponentMetadata.set(file, records);
+	for (const record of records) {
+		const location = `${record.file}#${record.className}`;
+		if (record.selector) {
+			let selectorSet = ctx.selectorOwners.get(record.selector);
+			if (!selectorSet) {
+				selectorSet = /* @__PURE__ */ new Set();
+				ctx.selectorOwners.set(record.selector, selectorSet);
+			}
+			selectorSet.add(location);
+		}
+		let classNameSet = ctx.classNameOwners.get(record.className);
+		if (!classNameSet) {
+			classNameSet = /* @__PURE__ */ new Set();
+			ctx.classNameOwners.set(record.className, classNameSet);
+		}
+		classNameSet.add(location);
+	}
+}
+function removeStyleOwnerMetadata(ctx, file) {
+	const previous = ctx.transformedStyleOwnerMetadata.get(file);
+	if (!previous) return;
+	for (const record of previous) {
+		const owners = ctx.styleSourceOwners.get(record.sourcePath);
+		owners?.delete(record.ownerFile);
+		if (owners?.size === 0) ctx.styleSourceOwners.delete(record.sourcePath);
+	}
+	ctx.transformedStyleOwnerMetadata.delete(file);
+}
+function registerStyleOwnerMetadata(ctx, file, styleUrls) {
+	removeStyleOwnerMetadata(ctx, file);
+	const records = styleUrls.map((urlSet) => {
+		const [, absoluteFileUrl] = urlSet.split("|");
+		return absoluteFileUrl ? {
+			ownerFile: file,
+			sourcePath: normalizePath(absoluteFileUrl)
+		} : void 0;
+	}).filter((record) => !!record);
+	if (records.length === 0) return;
+	ctx.transformedStyleOwnerMetadata.set(file, records);
+	for (const record of records) {
+		let owners = ctx.styleSourceOwners.get(record.sourcePath);
+		if (!owners) {
+			owners = /* @__PURE__ */ new Set();
+			ctx.styleSourceOwners.set(record.sourcePath, owners);
+		}
+		owners.add(record.ownerFile);
+	}
+}
+function isLikelyPageOnlyComponent(id) {
+	return id.includes("/pages/") || /\.page\.[cm]?[jt]sx?$/i.test(id) || /\([^/]+\)\.page\.[cm]?[jt]sx?$/i.test(id);
+}
+function findStaticClassAndBoundClassConflicts(template) {
+	const issues = [];
+	for (const { index, snippet } of findOpeningTagSnippets(template)) {
+		if (!snippet.includes("[class]")) continue;
+		const hasStaticClass = /\sclass\s*=\s*(['"])(?:(?!\1)[\s\S])*\1/.test(snippet);
+		const hasBoundClass = /\s\[class\]\s*=\s*(['"])(?:(?!\1)[\s\S])*\1/.test(snippet);
+		if (hasStaticClass && hasBoundClass) {
+			const prefix = template.slice(0, index);
+			const line = prefix.split("\n").length;
+			const column = index - prefix.lastIndexOf("\n");
+			issues.push({
+				line,
+				column,
+				snippet: snippet.replace(/\s+/g, " ").trim()
+			});
+		}
+	}
+	return issues;
+}
+function findBoundClassAndNgClassConflicts(template) {
+	const issues = [];
+	if (!/\[class\]\s*=/.test(template) || !template.includes("[ngClass]")) return issues;
+	for (const { index, snippet } of findOpeningTagSnippets(template)) {
+		if (!/\[class\]\s*=/.test(snippet) || !snippet.includes("[ngClass]")) continue;
+		const prefix = template.slice(0, index);
+		const line = prefix.split("\n").length;
+		const column = index - prefix.lastIndexOf("\n");
+		issues.push({
+			line,
+			column,
+			snippet: snippet.replace(/\s+/g, " ").trim()
+		});
+	}
+	return issues;
+}
+function throwTemplateClassBindingConflict(id, issue) {
+	throw new Error([
+		"[Analog Angular] Invalid template class binding.",
+		`File: ${id}:${issue.line}:${issue.column}`,
+		"The same element uses both a static `class=\"...\"` attribute and a whole-element `[class]=\"...\"` binding.",
+		"That pattern can replace or conflict with static Tailwind classes, which makes styles appear to stop applying.",
+		"Use `[ngClass]` or explicit `[class.foo]` bindings instead of `[class]` when the element also has static classes.",
+		`Snippet: ${issue.snippet}`
+	].join("\n"));
+}
+function findOpeningTagSnippets(template) {
+	const matches = [];
+	for (let index = 0; index < template.length; index++) {
+		if (template[index] !== "<") continue;
+		const tagStart = template[index + 1];
+		if (!tagStart || !/[a-zA-Z]/.test(tagStart)) continue;
+		let quote = null;
+		for (let end = index + 1; end < template.length; end++) {
+			const char = template[end];
+			if (quote) {
+				if (char === quote) quote = null;
+				continue;
+			}
+			if (char === "\"" || char === "'") {
+				quote = char;
+				continue;
+			}
+			if (char === ">") {
+				matches.push({
+					index,
+					snippet: template.slice(index, end + 1)
+				});
+				index = end;
+				break;
+			}
+		}
+	}
+	return matches;
+}
+function formatActiveGraphLocations(entries) {
+	return [...entries].sort().map((entry) => `- ${entry}`).join("\n");
+}
+//#endregion
+export { findBoundClassAndNgClassConflicts, findStaticClassAndBoundClassConflicts, removeActiveGraphMetadata, removeStyleOwnerMetadata, templateClassBindingGuardPlugin };
+
+//# sourceMappingURL=template-class-binding-guard-plugin.js.map

package/src/lib/template-class-binding-guard-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-class-binding-guard-plugin.js","names":[],"sources":["../../../src/lib/template-class-binding-guard-plugin.ts"],"sourcesContent":["import { normalizePath, Plugin } from 'vite';\nimport {\n  getAngularComponentMetadata,\n  StyleUrlsResolver,\n} from './component-resolvers.js';\nimport { debugHmrV } from './utils/debug.js';\nimport { TS_EXT_REGEX } from './utils/plugin-config.js';\n\nexport interface ActiveGraphComponentRecord {\n  file: string;\n  className: string;\n  selector?: string;\n}\n\nexport interface StyleOwnerRecord {\n  sourcePath: string;\n  ownerFile: string;\n}\n\ninterface TemplateClassBindingIssue {\n  line: number;\n  column: number;\n  snippet: string;\n}\n\nexport interface TemplateClassBindingGuardContext {\n  styleUrlsResolver: StyleUrlsResolver;\n  activeGraphComponentMetadata: Map<string, ActiveGraphComponentRecord[]>;\n  selectorOwners: Map<string, Set<string>>;\n  classNameOwners: Map<string, Set<string>>;\n  transformedStyleOwnerMetadata: Map<string, StyleOwnerRecord[]>;\n  styleSourceOwners: Map<string, Set<string>>;\n}\n\nexport function templateClassBindingGuardPlugin(\n  ctx: TemplateClassBindingGuardContext,\n): Plugin {\n  return {\n    name: '@analogjs/vite-plugin-angular:template-class-binding-guard',\n    enforce: 'pre',\n    transform(code: string, id: string) {\n      if (id.includes('node_modules')) {\n        return;\n      }\n\n      const cleanId = id.split('?')[0];\n\n      if (/\\.(html|htm)$/i.test(cleanId)) {\n        const staticClassIssue = findStaticClassAndBoundClassConflicts(code)[0];\n        if (staticClassIssue) {\n          throwTemplateClassBindingConflict(cleanId, staticClassIssue);\n        }\n\n        const mixedClassIssue = findBoundClassAndNgClassConflicts(code)[0];\n        if (mixedClassIssue) {\n          this.warn(\n            [\n              '[Analog Angular] Conflicting class composition.',\n              `File: ${cleanId}:${mixedClassIssue.line}:${mixedClassIssue.column}`,\n              'This element mixes `[class]` and `[ngClass]`.',\n              'Prefer a single class-binding strategy so class merging stays predictable.',\n              'Use one `[ngClass]` expression or explicit `[class.foo]` bindings.',\n              `Snippet: ${mixedClassIssue.snippet}`,\n            ].join('\\n'),\n          );\n        }\n        return;\n      }\n\n      if (TS_EXT_REGEX.test(cleanId)) {\n        const rawStyleUrls = ctx.styleUrlsResolver.resolve(code, cleanId);\n        registerStyleOwnerMetadata(ctx, cleanId, rawStyleUrls);\n        debugHmrV('component stylesheet owner metadata registered', {\n          file: cleanId,\n          styleUrlCount: rawStyleUrls.length,\n          styleUrls: rawStyleUrls,\n          ownerSources: [\n            ...(ctx.transformedStyleOwnerMetadata\n              .get(cleanId)\n              ?.map((record) => record.sourcePath) ?? []),\n          ],\n        });\n\n        const components = getAngularComponentMetadata(code);\n\n        const inlineTemplateIssue = components.flatMap((component) =>\n          component.inlineTemplates.flatMap((template) =>\n            findStaticClassAndBoundClassConflicts(template),\n          ),\n        )[0];\n\n        if (inlineTemplateIssue) {\n          throwTemplateClassBindingConflict(cleanId, inlineTemplateIssue);\n        }\n\n        const mixedInlineClassIssue = components.flatMap((component) =>\n          component.inlineTemplates.flatMap((template) =>\n            findBoundClassAndNgClassConflicts(template),\n          ),\n        )[0];\n\n        if (mixedInlineClassIssue) {\n          this.warn(\n            [\n              '[Analog Angular] Conflicting class composition.',\n              `File: ${cleanId}:${mixedInlineClassIssue.line}:${mixedInlineClassIssue.column}`,\n              'This element mixes `[class]` and `[ngClass]`.',\n              'Prefer a single class-binding strategy so class merging stays predictable.',\n              'Use one `[ngClass]` expression or explicit `[class.foo]` bindings.',\n              `Snippet: ${mixedInlineClassIssue.snippet}`,\n            ].join('\\n'),\n          );\n        }\n\n        const activeGraphRecords = components.map((component) => ({\n          file: cleanId,\n          className: component.className,\n          selector: component.selector,\n        }));\n\n        registerActiveGraphMetadata(ctx, cleanId, activeGraphRecords);\n\n        for (const component of components) {\n          if (!component.selector && !isLikelyPageOnlyComponent(cleanId)) {\n            throw new Error(\n              [\n                '[Analog Angular] Selectorless component detected.',\n                `File: ${cleanId}`,\n                `Component: ${component.className}`,\n                'This component has no `selector`, so Angular will render it as `ng-component`.',\n                'That increases the chance of component ID collisions and makes diagnostics harder to interpret.',\n                'Add an explicit selector for reusable components.',\n                'Selectorless components are only supported for page and route-only files.',\n              ].join('\\n'),\n            );\n          }\n\n          if (component.selector) {\n            const selectorEntries = ctx.selectorOwners.get(component.selector);\n            if (selectorEntries && selectorEntries.size > 1) {\n              throw new Error(\n                [\n                  '[Analog Angular] Duplicate component selector detected.',\n                  `Selector: ${component.selector}`,\n                  'Multiple components in the active application graph use the same selector.',\n                  'Selectors must be unique within the active graph to avoid ambiguous rendering and confusing diagnostics.',\n                  `Locations:\\n${formatActiveGraphLocations(selectorEntries)}`,\n                ].join('\\n'),\n              );\n            }\n          }\n\n          const classNameEntries = ctx.classNameOwners.get(component.className);\n          if (classNameEntries && classNameEntries.size > 1) {\n            this.warn(\n              [\n                '[Analog Angular] Duplicate component class name detected.',\n                `Class name: ${component.className}`,\n                'Two or more Angular components in the active graph share the same exported class name.',\n                'Rename one of them to keep HMR, stack traces, and compiler diagnostics unambiguous.',\n                `Locations:\\n${formatActiveGraphLocations(classNameEntries)}`,\n              ].join('\\n'),\n            );\n          }\n        }\n      }\n    },\n  };\n}\n\nexport function removeActiveGraphMetadata(\n  ctx: TemplateClassBindingGuardContext,\n  file: string,\n): void {\n  const previous = ctx.activeGraphComponentMetadata.get(file);\n  if (!previous) {\n    return;\n  }\n\n  for (const record of previous) {\n    const location = `${record.file}#${record.className}`;\n    if (record.selector) {\n      const selectorSet = ctx.selectorOwners.get(record.selector);\n      selectorSet?.delete(location);\n      if (selectorSet?.size === 0) {\n        ctx.selectorOwners.delete(record.selector);\n      }\n    }\n\n    const classNameSet = ctx.classNameOwners.get(record.className);\n    classNameSet?.delete(location);\n    if (classNameSet?.size === 0) {\n      ctx.classNameOwners.delete(record.className);\n    }\n  }\n\n  ctx.activeGraphComponentMetadata.delete(file);\n}\n\nfunction registerActiveGraphMetadata(\n  ctx: TemplateClassBindingGuardContext,\n  file: string,\n  records: ActiveGraphComponentRecord[],\n) {\n  removeActiveGraphMetadata(ctx, file);\n\n  if (records.length === 0) {\n    return;\n  }\n\n  ctx.activeGraphComponentMetadata.set(file, records);\n\n  for (const record of records) {\n    const location = `${record.file}#${record.className}`;\n\n    if (record.selector) {\n      let selectorSet = ctx.selectorOwners.get(record.selector);\n      if (!selectorSet) {\n        selectorSet = new Set<string>();\n        ctx.selectorOwners.set(record.selector, selectorSet);\n      }\n      selectorSet.add(location);\n    }\n\n    let classNameSet = ctx.classNameOwners.get(record.className);\n    if (!classNameSet) {\n      classNameSet = new Set<string>();\n      ctx.classNameOwners.set(record.className, classNameSet);\n    }\n    classNameSet.add(location);\n  }\n}\n\nexport function removeStyleOwnerMetadata(\n  ctx: TemplateClassBindingGuardContext,\n  file: string,\n): void {\n  const previous = ctx.transformedStyleOwnerMetadata.get(file);\n  if (!previous) {\n    return;\n  }\n\n  for (const record of previous) {\n    const owners = ctx.styleSourceOwners.get(record.sourcePath);\n    owners?.delete(record.ownerFile);\n    if (owners?.size === 0) {\n      ctx.styleSourceOwners.delete(record.sourcePath);\n    }\n  }\n\n  ctx.transformedStyleOwnerMetadata.delete(file);\n}\n\nfunction registerStyleOwnerMetadata(\n  ctx: TemplateClassBindingGuardContext,\n  file: string,\n  styleUrls: string[],\n) {\n  removeStyleOwnerMetadata(ctx, file);\n\n  const records = styleUrls\n    .map((urlSet) => {\n      const [, absoluteFileUrl] = urlSet.split('|');\n      return absoluteFileUrl\n        ? {\n            ownerFile: file,\n            sourcePath: normalizePath(absoluteFileUrl),\n          }\n        : undefined;\n    })\n    .filter((record): record is StyleOwnerRecord => !!record);\n\n  if (records.length === 0) {\n    return;\n  }\n\n  ctx.transformedStyleOwnerMetadata.set(file, records);\n\n  for (const record of records) {\n    let owners = ctx.styleSourceOwners.get(record.sourcePath);\n    if (!owners) {\n      owners = new Set<string>();\n      ctx.styleSourceOwners.set(record.sourcePath, owners);\n    }\n    owners.add(record.ownerFile);\n  }\n}\n\nfunction isLikelyPageOnlyComponent(id: string): boolean {\n  return (\n    id.includes('/pages/') ||\n    /\\.page\\.[cm]?[jt]sx?$/i.test(id) ||\n    /\\([^/]+\\)\\.page\\.[cm]?[jt]sx?$/i.test(id)\n  );\n}\n\nexport function findStaticClassAndBoundClassConflicts(\n  template: string,\n): TemplateClassBindingIssue[] {\n  const issues: TemplateClassBindingIssue[] = [];\n\n  for (const { index, snippet } of findOpeningTagSnippets(template)) {\n    if (!snippet.includes('[class]')) {\n      continue;\n    }\n\n    const hasStaticClass = /\\sclass\\s*=\\s*(['\"])(?:(?!\\1)[\\s\\S])*\\1/.test(\n      snippet,\n    );\n    const hasBoundClass = /\\s\\[class\\]\\s*=\\s*(['\"])(?:(?!\\1)[\\s\\S])*\\1/.test(\n      snippet,\n    );\n\n    if (hasStaticClass && hasBoundClass) {\n      const prefix = template.slice(0, index);\n      const line = prefix.split('\\n').length;\n      const lastNewline = prefix.lastIndexOf('\\n');\n      const column = index - lastNewline;\n      issues.push({\n        line,\n        column,\n        snippet: snippet.replace(/\\s+/g, ' ').trim(),\n      });\n    }\n  }\n\n  return issues;\n}\n\nexport function findBoundClassAndNgClassConflicts(\n  template: string,\n): TemplateClassBindingIssue[] {\n  const issues: TemplateClassBindingIssue[] = [];\n  const hasWholeElementClassBinding = /\\[class\\]\\s*=/.test(template);\n\n  if (!hasWholeElementClassBinding || !template.includes('[ngClass]')) {\n    return issues;\n  }\n\n  for (const { index, snippet } of findOpeningTagSnippets(template)) {\n    if (!/\\[class\\]\\s*=/.test(snippet) || !snippet.includes('[ngClass]')) {\n      continue;\n    }\n\n    const prefix = template.slice(0, index);\n    const line = prefix.split('\\n').length;\n    const lastNewline = prefix.lastIndexOf('\\n');\n    const column = index - lastNewline;\n    issues.push({\n      line,\n      column,\n      snippet: snippet.replace(/\\s+/g, ' ').trim(),\n    });\n  }\n\n  return issues;\n}\n\nfunction throwTemplateClassBindingConflict(\n  id: string,\n  issue: TemplateClassBindingIssue,\n): never {\n  throw new Error(\n    [\n      '[Analog Angular] Invalid template class binding.',\n      `File: ${id}:${issue.line}:${issue.column}`,\n      'The same element uses both a static `class=\"...\"` attribute and a whole-element `[class]=\"...\"` binding.',\n      'That pattern can replace or conflict with static Tailwind classes, which makes styles appear to stop applying.',\n      'Use `[ngClass]` or explicit `[class.foo]` bindings instead of `[class]` when the element also has static classes.',\n      `Snippet: ${issue.snippet}`,\n    ].join('\\n'),\n  );\n}\n\nfunction findOpeningTagSnippets(\n  template: string,\n): Array<{ index: number; snippet: string }> {\n  const matches: Array<{ index: number; snippet: string }> = [];\n\n  for (let index = 0; index < template.length; index++) {\n    if (template[index] !== '<') {\n      continue;\n    }\n\n    const tagStart = template[index + 1];\n    if (!tagStart || !/[a-zA-Z]/.test(tagStart)) {\n      continue;\n    }\n\n    let quote: '\"' | \"'\" | null = null;\n\n    for (let end = index + 1; end < template.length; end++) {\n      const char = template[end];\n\n      if (quote) {\n        if (char === quote) {\n          quote = null;\n        }\n        continue;\n      }\n\n      if (char === '\"' || char === \"'\") {\n        quote = char;\n        continue;\n      }\n\n      if (char === '>') {\n        matches.push({\n          index,\n          snippet: template.slice(index, end + 1),\n        });\n        index = end;\n        break;\n      }\n    }\n  }\n\n  return matches;\n}\n\nfunction formatActiveGraphLocations(entries: Iterable<string>): string {\n  return [...entries]\n    .sort()\n    .map((entry) => `- ${entry}`)\n    .join('\\n');\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,58 @@
+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;
+export declare function isTestWatchMode(args?: string[]): boolean;

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

@@ -0,0 +1,133 @@
+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)
+	});
+}
+function isTestWatchMode(args = process.argv) {
+	if (args.find((arg) => arg.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\nexport function isTestWatchMode(args: string[] = 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 --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/tsconfig-resolver.d.ts

@@ -0,0 +1,28 @@
+import { ResolvedConfig } from "vite";
+export interface TsconfigResolverOptions {
+	workspaceRoot: string;
+	include: string[];
+	liveReload: boolean;
+	hasTailwindCss: boolean;
+	isTest: boolean;
+}
+export declare class TsconfigResolver {
+	private options;
+	private includeCache;
+	private tsconfigOptionsCache;
+	private tsconfigGraphRootCache;
+	constructor(options: TsconfigResolverOptions);
+	invalidateIncludeCache(): void;
+	invalidateTsconfigCaches(): void;
+	invalidateAll(): void;
+	ensureIncludeCache(): string[];
+	readAngularTsconfigConfiguration(resolvedTsConfigPath: string, config: ResolvedConfig);
+	getCachedTsconfigOptions(resolvedTsConfigPath: string, config: ResolvedConfig): {
+		options: any;
+		rootNames: string[];
+	};
+	collectExpandedTsconfigRoots(resolvedTsConfigPath: string, config: ResolvedConfig, visited?): string[];
+	private getTsconfigCacheKey;
+	private findIncludes;
+}
+export declare function normalizeIncludeGlob(workspaceRoot: string, glob: string): string;