@analogjs/vite-plugin-angular 3.0.0-alpha.73 → 3.0.0-alpha.75

package/README.md

@@ -116,6 +116,6 @@ Create a `tsconfig.app.json` in the root of the project.
 
 ## Tailwind CSS v4
 
-For Angular component styles that use Tailwind utilities like `@apply`, configure `tailwindCss.rootStylesheet` and follow the Tailwind guide for Analog:
+For Angular component styles that use Tailwind utilities like `@apply`, add a `@reference` to your root stylesheet in those component stylesheets and follow the Tailwind guide for Analog:
 
 - https://analogjs.org/docs/integrations/tailwind

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analogjs/vite-plugin-angular",
-  "version": "3.0.0-alpha.73",
+  "version": "3.0.0-alpha.75",
   "description": "Vite Plugin for Angular",
   "type": "module",
   "keywords": [

package/src/index.d.ts

@@ -1,6 +1,6 @@
 import { angular } from "./lib/angular-vite-plugin.js";
 export { angular } from "./lib/angular-vite-plugin.js";
 export type { PluginOptions } from "./lib/angular-vite-plugin.js";
-export type { AnalogIntegrationPlugin, AnalogPluginContext, AnalogPluginHooks } from "./lib/analog-plugin-interop.js";
-export type { StylePreprocessor, StylesheetTransformContext, StylesheetTransformResult } from "./lib/style-preprocessor.js";
+export type { AnalogIntegrationPlugin, AnalogPluginContext, AnalogPluginHooks, StylesheetRegistryConfigurator, StylesheetRegistryContext } from "./lib/analog-plugin-interop.js";
+export type { StylePreprocessor, StylesheetDependency, StylesheetDiagnostic, StylesheetRegistryReader, StylesheetTransformContext, StylesheetTransformResult } from "./lib/style-preprocessor.js";
 export default angular;

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import { angular } from './lib/angular-vite-plugin.js';\nexport { angular } from './lib/angular-vite-plugin.js';\nexport type { PluginOptions } from './lib/angular-vite-plugin.js';\nexport type {\n  AnalogIntegrationPlugin,\n  AnalogPluginContext,\n  AnalogPluginHooks,\n} from './lib/analog-plugin-interop.js';\nexport type {\n  StylePreprocessor,\n  StylesheetTransformContext,\n  StylesheetTransformResult,\n} from './lib/style-preprocessor.js';\n\nexport default angular;\n"],"mappings":";;AAcA,IAAA,cAAe"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import { angular } from './lib/angular-vite-plugin.js';\nexport { angular } from './lib/angular-vite-plugin.js';\nexport type { PluginOptions } from './lib/angular-vite-plugin.js';\nexport type {\n  AnalogIntegrationPlugin,\n  AnalogPluginContext,\n  AnalogPluginHooks,\n  StylesheetRegistryConfigurator,\n  StylesheetRegistryContext,\n} from './lib/analog-plugin-interop.js';\nexport type {\n  StylePreprocessor,\n  StylesheetDependency,\n  StylesheetDiagnostic,\n  StylesheetRegistryReader,\n  StylesheetTransformContext,\n  StylesheetTransformResult,\n} from './lib/style-preprocessor.js';\n\nexport default angular;\n"],"mappings":";;AAmBA,IAAA,cAAe"}

package/src/lib/analog-plugin-interop.d.ts

@@ -1,5 +1,9 @@
 import type { Plugin, ResolvedConfig } from "vite";
-import { type StylePreprocessor } from "./style-preprocessor.js";
+import { type StylePreprocessor, type StylesheetRegistryReader } from "./style-preprocessor.js";
+export interface StylesheetRegistryContext {
+	workspaceRoot: string;
+}
+export type StylesheetRegistryConfigurator = (registry: StylesheetRegistryReader, context: StylesheetRegistryContext) => void;
 /**
 * Narrow framework context handed to a Vite plugin's `analog.setup()` hook.
 * Only grows when a concrete integration needs another seam.
@@ -18,6 +22,12 @@ export interface AnalogPluginContext {
 	* inlining component styles.
 	*/
 	externalizeComponentStyles(): void;
+	/**
+	* Receives the live stylesheet registry for externalized component styles
+	* each time a compilation creates one, so the plugin can map component
+	* stylesheet sources to their served ids, dependencies, and diagnostics.
+	*/
+	configureStylesheetRegistry(configure: StylesheetRegistryConfigurator): void;
 }
 export interface AnalogPluginHooks {
 	setup?(context: AnalogPluginContext): void | Promise<void>;
@@ -32,6 +42,7 @@ export type AnalogIntegrationPlugin = Plugin & {
 };
 export interface AnalogIntegrations {
 	stylePreprocessor?: StylePreprocessor;
+	configureStylesheetRegistry?: StylesheetRegistryConfigurator;
 	externalizeStyles: boolean;
 }
 /**

package/src/lib/analog-plugin-interop.js

@@ -16,6 +16,7 @@ function discoverAnalogIntegrations(config) {
 }
 async function runAnalogSetupHooks(plugins) {
 	const preprocessors = [];
+	const registryConfigurators = [];
 	let externalizeStyles = false;
 	for (const plugin of plugins) {
 		if (typeof plugin.analog?.setup !== "function") continue;
@@ -26,6 +27,9 @@ async function runAnalogSetupHooks(plugins) {
 			},
 			externalizeComponentStyles() {
 				externalizeStyles = true;
+			},
+			configureStylesheetRegistry(configure) {
+				registryConfigurators.push(wrapRegistryConfigurator(plugin.name, configure));
 			}
 		};
 		try {
@@ -36,11 +40,15 @@ async function runAnalogSetupHooks(plugins) {
 		debugStylePipeline("analog.setup() completed", {
 			plugin: plugin.name,
 			stylePreprocessors: preprocessors.length - registeredBefore,
+			registryConfigurators: registryConfigurators.length,
 			externalizeStyles
 		});
 	}
 	return {
 		stylePreprocessor: composeStylePreprocessors(preprocessors),
+		configureStylesheetRegistry: registryConfigurators.length ? (registry, context) => {
+			for (const configure of registryConfigurators) configure(registry, context);
+		} : void 0,
 		externalizeStyles
 	};
 }
@@ -54,6 +62,7 @@ async function resolveAnalogIntegrations(config, configured) {
 	const integrations = await discoverAnalogIntegrations(config);
 	return {
 		stylePreprocessor: composeStylePreprocessors([integrations.stylePreprocessor, configured]),
+		configureStylesheetRegistry: integrations.configureStylesheetRegistry,
 		externalizeStyles: integrations.externalizeStyles
 	};
 }
@@ -66,10 +75,19 @@ function wrapStylePreprocessor(pluginName, preprocessor) {
 		}
 	};
 }
+function wrapRegistryConfigurator(pluginName, configure) {
+	return (registry, context) => {
+		try {
+			configure(registry, context);
+		} catch (error) {
+			throw new Error(`[analog] Stylesheet registry configurator from plugin "${pluginName}" failed: ${describeError(error)}`);
+		}
+	};
+}
 function describeError(error) {
 	return error instanceof Error ? error.message : String(error);
 }
 //#endregion
-export { resolveAnalogIntegrations };
+export { discoverAnalogIntegrations, resolveAnalogIntegrations };
 
 //# sourceMappingURL=analog-plugin-interop.js.map

package/src/lib/analog-plugin-interop.js.map

@@ -1 +1 @@
-{"version":3,"file":"analog-plugin-interop.js","names":[],"sources":["../../../src/lib/analog-plugin-interop.ts"],"sourcesContent":["import type { Plugin, ResolvedConfig } from 'vite';\nimport {\n  composeStylePreprocessors,\n  type StylePreprocessor,\n} from './style-preprocessor.js';\nimport { debugStylePipeline } from './utils/debug.js';\n\n/**\n * Narrow framework context handed to a Vite plugin's `analog.setup()` hook.\n * Only grows when a concrete integration needs another seam.\n */\nexport interface AnalogPluginContext {\n  /**\n   * Registers a pre-transform that runs on every Angular component stylesheet\n   * before it enters Vite's `preprocessCSS` pipeline.\n   */\n  registerStylePreprocessor(preprocessor: StylePreprocessor): void;\n  /**\n   * Requests that component styles are externalized in dev and watch mode so\n   * they run through Vite's CSS plugin pipeline (for example\n   * `@tailwindcss/vite`) instead of being inlined through `preprocessCSS`,\n   * which only runs PostCSS and CSS preprocessors. Production builds keep\n   * inlining component styles.\n   */\n  externalizeComponentStyles(): void;\n}\n\nexport interface AnalogPluginHooks {\n  setup?(context: AnalogPluginContext): void | Promise<void>;\n}\n\n/**\n * A normal Vite plugin that optionally exposes an `analog` setup hook.\n * Discovery is structural (`plugin.analog?.setup`), so this type is a DX aid\n * rather than a requirement.\n */\nexport type AnalogIntegrationPlugin = Plugin & { analog?: AnalogPluginHooks };\n\nexport interface AnalogIntegrations {\n  stylePreprocessor?: StylePreprocessor;\n  externalizeStyles: boolean;\n}\n\nconst integrationsByConfig = new WeakMap<\n  ResolvedConfig,\n  Promise<AnalogIntegrations>\n>();\n\n/**\n * Runs every `analog.setup()` hook found in the resolved Vite plugin list,\n * once per resolved config, and composes the registrations in plugin order.\n */\nexport function discoverAnalogIntegrations(\n  config: ResolvedConfig,\n): Promise<AnalogIntegrations> {\n  let pending = integrationsByConfig.get(config);\n  if (!pending) {\n    pending = runAnalogSetupHooks(config.plugins ?? []);\n    integrationsByConfig.set(config, pending);\n  }\n  return pending;\n}\n\nexport async function runAnalogSetupHooks(\n  plugins: readonly Plugin[],\n): Promise<AnalogIntegrations> {\n  const preprocessors: StylePreprocessor[] = [];\n  let externalizeStyles = false;\n\n  for (const plugin of plugins as readonly AnalogIntegrationPlugin[]) {\n    if (typeof plugin.analog?.setup !== 'function') {\n      continue;\n    }\n\n    const registeredBefore = preprocessors.length;\n    const context: AnalogPluginContext = {\n      registerStylePreprocessor(preprocessor) {\n        preprocessors.push(wrapStylePreprocessor(plugin.name, preprocessor));\n      },\n      externalizeComponentStyles() {\n        externalizeStyles = true;\n      },\n    };\n\n    try {\n      await plugin.analog.setup(context);\n    } catch (error) {\n      throw new Error(\n        `[analog] analog.setup() from plugin \"${plugin.name}\" failed: ${describeError(error)}`,\n      );\n    }\n\n    debugStylePipeline('analog.setup() completed', {\n      plugin: plugin.name,\n      stylePreprocessors: preprocessors.length - registeredBefore,\n      externalizeStyles,\n    });\n  }\n\n  return {\n    stylePreprocessor: composeStylePreprocessors(preprocessors),\n    externalizeStyles,\n  };\n}\n\n/**\n * Resolves what a compilation path needs from the discovered integrations:\n * the stylesheet preprocessor chain (plugin-registered preprocessors first,\n * then the chain configured through `angular()` options) and whether any\n * plugin asked for externalized component styles.\n */\nexport async function resolveAnalogIntegrations(\n  config: ResolvedConfig,\n  configured?: StylePreprocessor,\n): Promise<AnalogIntegrations> {\n  const integrations = await discoverAnalogIntegrations(config);\n  return {\n    stylePreprocessor: composeStylePreprocessors([\n      integrations.stylePreprocessor,\n      configured,\n    ]),\n    externalizeStyles: integrations.externalizeStyles,\n  };\n}\n\nfunction wrapStylePreprocessor(\n  pluginName: string,\n  preprocessor: StylePreprocessor,\n): StylePreprocessor {\n  return (code, filename, context) => {\n    try {\n      return preprocessor(code, filename, context);\n    } catch (error) {\n      throw new Error(\n        `[analog] Style preprocessor from plugin \"${pluginName}\" failed for \"${filename}\": ${describeError(error)}`,\n      );\n    }\n  };\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";;;AA2CA,IAAM,uCAAuB,IAAI,SAG9B;;;;;AAMH,SAAgB,2BACd,QAC6B;CAC7B,IAAI,UAAU,qBAAqB,IAAI,OAAO;AAC9C,KAAI,CAAC,SAAS;AACZ,YAAU,oBAAoB,OAAO,WAAW,EAAE,CAAC;AACnD,uBAAqB,IAAI,QAAQ,QAAQ;;AAE3C,QAAO;;AAGT,eAAsB,oBACpB,SAC6B;CAC7B,MAAM,gBAAqC,EAAE;CAC7C,IAAI,oBAAoB;AAExB,MAAK,MAAM,UAAU,SAA+C;AAClE,MAAI,OAAO,OAAO,QAAQ,UAAU,WAClC;EAGF,MAAM,mBAAmB,cAAc;EACvC,MAAM,UAA+B;GACnC,0BAA0B,cAAc;AACtC,kBAAc,KAAK,sBAAsB,OAAO,MAAM,aAAa,CAAC;;GAEtE,6BAA6B;AAC3B,wBAAoB;;GAEvB;AAED,MAAI;AACF,SAAM,OAAO,OAAO,MAAM,QAAQ;WAC3B,OAAO;AACd,SAAM,IAAI,MACR,wCAAwC,OAAO,KAAK,YAAY,cAAc,MAAM,GACrF;;AAGH,qBAAmB,4BAA4B;GAC7C,QAAQ,OAAO;GACf,oBAAoB,cAAc,SAAS;GAC3C;GACD,CAAC;;AAGJ,QAAO;EACL,mBAAmB,0BAA0B,cAAc;EAC3D;EACD;;;;;;;;AASH,eAAsB,0BACpB,QACA,YAC6B;CAC7B,MAAM,eAAe,MAAM,2BAA2B,OAAO;AAC7D,QAAO;EACL,mBAAmB,0BAA0B,CAC3C,aAAa,mBACb,WACD,CAAC;EACF,mBAAmB,aAAa;EACjC;;AAGH,SAAS,sBACP,YACA,cACmB;AACnB,SAAQ,MAAM,UAAU,YAAY;AAClC,MAAI;AACF,UAAO,aAAa,MAAM,UAAU,QAAQ;WACrC,OAAO;AACd,SAAM,IAAI,MACR,4CAA4C,WAAW,gBAAgB,SAAS,KAAK,cAAc,MAAM,GAC1G;;;;AAKP,SAAS,cAAc,OAAwB;AAC7C,QAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}
+{"version":3,"file":"analog-plugin-interop.js","names":[],"sources":["../../../src/lib/analog-plugin-interop.ts"],"sourcesContent":["import type { Plugin, ResolvedConfig } from 'vite';\nimport {\n  composeStylePreprocessors,\n  type StylePreprocessor,\n  type StylesheetRegistryReader,\n} from './style-preprocessor.js';\nimport { debugStylePipeline } from './utils/debug.js';\n\nexport interface StylesheetRegistryContext {\n  workspaceRoot: string;\n}\n\nexport type StylesheetRegistryConfigurator = (\n  registry: StylesheetRegistryReader,\n  context: StylesheetRegistryContext,\n) => void;\n\n/**\n * Narrow framework context handed to a Vite plugin's `analog.setup()` hook.\n * Only grows when a concrete integration needs another seam.\n */\nexport interface AnalogPluginContext {\n  /**\n   * Registers a pre-transform that runs on every Angular component stylesheet\n   * before it enters Vite's `preprocessCSS` pipeline.\n   */\n  registerStylePreprocessor(preprocessor: StylePreprocessor): void;\n  /**\n   * Requests that component styles are externalized in dev and watch mode so\n   * they run through Vite's CSS plugin pipeline (for example\n   * `@tailwindcss/vite`) instead of being inlined through `preprocessCSS`,\n   * which only runs PostCSS and CSS preprocessors. Production builds keep\n   * inlining component styles.\n   */\n  externalizeComponentStyles(): void;\n  /**\n   * Receives the live stylesheet registry for externalized component styles\n   * each time a compilation creates one, so the plugin can map component\n   * stylesheet sources to their served ids, dependencies, and diagnostics.\n   */\n  configureStylesheetRegistry(configure: StylesheetRegistryConfigurator): void;\n}\n\nexport interface AnalogPluginHooks {\n  setup?(context: AnalogPluginContext): void | Promise<void>;\n}\n\n/**\n * A normal Vite plugin that optionally exposes an `analog` setup hook.\n * Discovery is structural (`plugin.analog?.setup`), so this type is a DX aid\n * rather than a requirement.\n */\nexport type AnalogIntegrationPlugin = Plugin & { analog?: AnalogPluginHooks };\n\nexport interface AnalogIntegrations {\n  stylePreprocessor?: StylePreprocessor;\n  configureStylesheetRegistry?: StylesheetRegistryConfigurator;\n  externalizeStyles: boolean;\n}\n\nconst integrationsByConfig = new WeakMap<\n  ResolvedConfig,\n  Promise<AnalogIntegrations>\n>();\n\n/**\n * Runs every `analog.setup()` hook found in the resolved Vite plugin list,\n * once per resolved config, and composes the registrations in plugin order.\n */\nexport function discoverAnalogIntegrations(\n  config: ResolvedConfig,\n): Promise<AnalogIntegrations> {\n  let pending = integrationsByConfig.get(config);\n  if (!pending) {\n    pending = runAnalogSetupHooks(config.plugins ?? []);\n    integrationsByConfig.set(config, pending);\n  }\n  return pending;\n}\n\nexport async function runAnalogSetupHooks(\n  plugins: readonly Plugin[],\n): Promise<AnalogIntegrations> {\n  const preprocessors: StylePreprocessor[] = [];\n  const registryConfigurators: StylesheetRegistryConfigurator[] = [];\n  let externalizeStyles = false;\n\n  for (const plugin of plugins as readonly AnalogIntegrationPlugin[]) {\n    if (typeof plugin.analog?.setup !== 'function') {\n      continue;\n    }\n\n    const registeredBefore = preprocessors.length;\n    const context: AnalogPluginContext = {\n      registerStylePreprocessor(preprocessor) {\n        preprocessors.push(wrapStylePreprocessor(plugin.name, preprocessor));\n      },\n      externalizeComponentStyles() {\n        externalizeStyles = true;\n      },\n      configureStylesheetRegistry(configure) {\n        registryConfigurators.push(\n          wrapRegistryConfigurator(plugin.name, configure),\n        );\n      },\n    };\n\n    try {\n      await plugin.analog.setup(context);\n    } catch (error) {\n      throw new Error(\n        `[analog] analog.setup() from plugin \"${plugin.name}\" failed: ${describeError(error)}`,\n      );\n    }\n\n    debugStylePipeline('analog.setup() completed', {\n      plugin: plugin.name,\n      stylePreprocessors: preprocessors.length - registeredBefore,\n      registryConfigurators: registryConfigurators.length,\n      externalizeStyles,\n    });\n  }\n\n  return {\n    stylePreprocessor: composeStylePreprocessors(preprocessors),\n    configureStylesheetRegistry: registryConfigurators.length\n      ? (registry, context) => {\n          for (const configure of registryConfigurators) {\n            configure(registry, context);\n          }\n        }\n      : undefined,\n    externalizeStyles,\n  };\n}\n\n/**\n * Resolves what a compilation path needs from the discovered integrations:\n * the stylesheet preprocessor chain (plugin-registered preprocessors first,\n * then the chain configured through `angular()` options) and whether any\n * plugin asked for externalized component styles.\n */\nexport async function resolveAnalogIntegrations(\n  config: ResolvedConfig,\n  configured?: StylePreprocessor,\n): Promise<AnalogIntegrations> {\n  const integrations = await discoverAnalogIntegrations(config);\n  return {\n    stylePreprocessor: composeStylePreprocessors([\n      integrations.stylePreprocessor,\n      configured,\n    ]),\n    configureStylesheetRegistry: integrations.configureStylesheetRegistry,\n    externalizeStyles: integrations.externalizeStyles,\n  };\n}\n\nfunction wrapStylePreprocessor(\n  pluginName: string,\n  preprocessor: StylePreprocessor,\n): StylePreprocessor {\n  return (code, filename, context) => {\n    try {\n      return preprocessor(code, filename, context);\n    } catch (error) {\n      throw new Error(\n        `[analog] Style preprocessor from plugin \"${pluginName}\" failed for \"${filename}\": ${describeError(error)}`,\n      );\n    }\n  };\n}\n\nfunction wrapRegistryConfigurator(\n  pluginName: string,\n  configure: StylesheetRegistryConfigurator,\n): StylesheetRegistryConfigurator {\n  return (registry, context) => {\n    try {\n      configure(registry, context);\n    } catch (error) {\n      throw new Error(\n        `[analog] Stylesheet registry configurator from plugin \"${pluginName}\" failed: ${describeError(error)}`,\n      );\n    }\n  };\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";;;AA4DA,IAAM,uCAAuB,IAAI,SAG9B;;;;;AAMH,SAAgB,2BACd,QAC6B;CAC7B,IAAI,UAAU,qBAAqB,IAAI,OAAO;AAC9C,KAAI,CAAC,SAAS;AACZ,YAAU,oBAAoB,OAAO,WAAW,EAAE,CAAC;AACnD,uBAAqB,IAAI,QAAQ,QAAQ;;AAE3C,QAAO;;AAGT,eAAsB,oBACpB,SAC6B;CAC7B,MAAM,gBAAqC,EAAE;CAC7C,MAAM,wBAA0D,EAAE;CAClE,IAAI,oBAAoB;AAExB,MAAK,MAAM,UAAU,SAA+C;AAClE,MAAI,OAAO,OAAO,QAAQ,UAAU,WAClC;EAGF,MAAM,mBAAmB,cAAc;EACvC,MAAM,UAA+B;GACnC,0BAA0B,cAAc;AACtC,kBAAc,KAAK,sBAAsB,OAAO,MAAM,aAAa,CAAC;;GAEtE,6BAA6B;AAC3B,wBAAoB;;GAEtB,4BAA4B,WAAW;AACrC,0BAAsB,KACpB,yBAAyB,OAAO,MAAM,UAAU,CACjD;;GAEJ;AAED,MAAI;AACF,SAAM,OAAO,OAAO,MAAM,QAAQ;WAC3B,OAAO;AACd,SAAM,IAAI,MACR,wCAAwC,OAAO,KAAK,YAAY,cAAc,MAAM,GACrF;;AAGH,qBAAmB,4BAA4B;GAC7C,QAAQ,OAAO;GACf,oBAAoB,cAAc,SAAS;GAC3C,uBAAuB,sBAAsB;GAC7C;GACD,CAAC;;AAGJ,QAAO;EACL,mBAAmB,0BAA0B,cAAc;EAC3D,6BAA6B,sBAAsB,UAC9C,UAAU,YAAY;AACrB,QAAK,MAAM,aAAa,sBACtB,WAAU,UAAU,QAAQ;MAGhC,KAAA;EACJ;EACD;;;;;;;;AASH,eAAsB,0BACpB,QACA,YAC6B;CAC7B,MAAM,eAAe,MAAM,2BAA2B,OAAO;AAC7D,QAAO;EACL,mBAAmB,0BAA0B,CAC3C,aAAa,mBACb,WACD,CAAC;EACF,6BAA6B,aAAa;EAC1C,mBAAmB,aAAa;EACjC;;AAGH,SAAS,sBACP,YACA,cACmB;AACnB,SAAQ,MAAM,UAAU,YAAY;AAClC,MAAI;AACF,UAAO,aAAa,MAAM,UAAU,QAAQ;WACrC,OAAO;AACd,SAAM,IAAI,MACR,4CAA4C,WAAW,gBAAgB,SAAS,KAAK,cAAc,MAAM,GAC1G;;;;AAKP,SAAS,yBACP,YACA,WACgC;AAChC,SAAQ,UAAU,YAAY;AAC5B,MAAI;AACF,aAAU,UAAU,QAAQ;WACrB,OAAO;AACd,SAAM,IAAI,MACR,0DAA0D,WAAW,YAAY,cAAc,MAAM,GACtG;;;;AAKP,SAAS,cAAc,OAAwB;AAC7C,QAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}

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

@@ -1,6 +1,5 @@
 import { getJitInlineStyles } from "./utils/jit-inline-styles.js";
 import { debugStyles } from "./utils/debug.js";
-import { isTailwindReferenceError } from "./utils/tailwind-reference.js";
 import { resolveAnalogIntegrations } from "./analog-plugin-interop.js";
 import { preprocessStylesheet } from "./stylesheet-registry.js";
 import { preprocessCSS } from "vite";
@@ -34,7 +33,6 @@ function jitPlugin({ inlineStylesExtension }) {
 				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,

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

@@ -1 +1 @@
-{"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 { resolveAnalogIntegrations } 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 resolveAnalogIntegrations(config))\n        .stylePreprocessor;\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,wBAAqB,MAAM,0BAA0B,OAAO,EACzD;;EAEL,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"}
+{"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 { resolveAnalogIntegrations } 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 resolveAnalogIntegrations(config))\n        .stylePreprocessor;\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          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":";;;;;;AAUA,SAAgB,UAAU,EACxB,yBAGS;CACT,IAAI;CACJ,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,eAAe,SAAS;AACtB,YAAS;;EAEX,MAAM,aAAa;AACjB,wBAAqB,MAAM,0BAA0B,OAAO,EACzD;;EAEL,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;KACV,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-vite-plugin.d.ts

@@ -5,9 +5,7 @@ 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;
@@ -58,7 +56,7 @@ export interface PluginOptions {
 	* Enable debug logging for specific scopes.
 	*
 	* - `true` → enables all `analog:angular:*` scopes
-	* - `string[]` → enables listed namespaces (e.g. `['analog:angular:tailwind']`)
+	* - `string[]` → enables listed namespaces (e.g. `['analog:angular:hmr']`)
 	* - `{ scopes?, mode? }` → object form with optional `mode: 'build' | 'dev'`
 	*   to restrict output to a specific Vite command (omit for both)
 	*
@@ -76,80 +74,6 @@ export interface PluginOptions {
 	* @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>;

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

@@ -11,7 +11,6 @@ import { jitPlugin } from "./angular-jit-plugin.js";
 import { StyleUrlsResolver, TemplateUrlsResolver } from "./component-resolvers.js";
 import { augmentHostWithCaching, augmentHostWithResources, augmentProgramWithVersioning, mergeTransformers } from "./host.js";
 import { TsconfigResolver } from "./utils/tsconfig-resolver.js";
-import { configureStylePipelineRegistry } from "./style-pipeline.js";
 import { describeStylesheetContent, injectViteIgnoreForHmrMetadata, isIgnoredHmrFile, isTestWatchMode } from "./utils/compilation-shared.js";
 import { toVirtualRawId } from "./utils/virtual-ids.js";
 import { loadVirtualRawModule, rewriteHtmlRawImport } from "./utils/virtual-resources.js";
@@ -21,7 +20,6 @@ import { ANGULAR_DECORATOR_CALL_RE } from "./compiler/constants.js";
 import "./compiler/index.js";
 import { markStylePathSafe } from "./utils/safe-module-paths.js";
 import { fastCompilePlugin } from "./fast-compile-plugin.js";
-import { buildStylePreprocessor, tailwindReferencePlugin, validateTailwindConfig } from "./tailwind-plugin.js";
 import { encapsulationPlugin, getComponentStyleSheetMeta, isComponentStyleSheet } from "./encapsulation-plugin.js";
 import { virtualModulesPlugin } from "./virtual-modules-plugin.js";
 import { angularVitestPlugins } from "./angular-vitest-plugin.js";
@@ -48,8 +46,9 @@ function evictDeletedFileMetadata(file, { classNamesMap, fileTransformMap }) {
 function angular(options) {
 	applyDebugOption(options?.debug, options?.workspaceRoot);
 	const liveReload = options?.liveReload ?? true;
-	const configuredStylePreprocessor = buildStylePreprocessor(options);
+	const configuredStylePreprocessor = options?.stylePreprocessor;
 	let externalizeStylesRequested = false;
+	let configureStylesheetRegistry;
 	/**
 	* Normalize plugin options so defaults
 	* are used for values not provided.
@@ -73,8 +72,6 @@ function angular(options) {
 		useAngularCompilationAPI: options?.experimental?.useAngularCompilationAPI ?? false,
 		fastCompile: options?.fastCompile ?? false,
 		fastCompileMode: options?.fastCompileMode ?? "full",
-		hasTailwindCss: !!options?.tailwindCss,
-		tailwindCss: options?.tailwindCss,
 		stylePreprocessor: configuredStylePreprocessor
 	};
 	let resolvedConfig;
@@ -89,7 +86,6 @@ function angular(options) {
 		workspaceRoot: pluginOptions.workspaceRoot,
 		include: pluginOptions.include,
 		liveReload: pluginOptions.liveReload,
-		hasTailwindCss: pluginOptions.hasTailwindCss,
 		isTest
 	});
 	function invalidateFsCaches() {
@@ -118,19 +114,15 @@ function angular(options) {
 	*
 	* Required for TWO independent use-cases:
 	*   1. HMR — Vite needs external modules for hot replacement
-	*   2. Tailwind CSS (hasTailwindCss) — styles must pass through Vite's
-	*      CSS pipeline so @tailwindcss/vite can resolve @apply directives
+	*   2. A Vite plugin asked for it through `analog.setup()` so its styles
+	*      pass through Vite's CSS pipeline (e.g. @tailwindcss/vite)
 	*
 	* In production builds (!watchMode), styles are NOT externalized — they
 	* are inlined after preprocessCSS runs eagerly in transformStylesheet.
 	*/
 	function shouldExternalizeStyles() {
 		if (!(isTest ? testWatchMode : watchMode)) return false;
-		return !!(shouldEnableLiveReload() || pluginOptions.hasTailwindCss || externalizeStylesRequested);
-	}
-	function validateNoDuplicateAnalogPlugins(config) {
-		const analogInstances = (config.plugins ?? []).filter((p) => p.name === "@analogjs/vite-plugin-angular");
-		if (analogInstances.length > 1 && !config.build?.ssr) throw new Error(`[@analogjs/vite-plugin-angular] analog() is registered ${analogInstances.length} times. Each instance creates separate style maps, causing component styles to be lost. Remove duplicate registrations.`);
+		return !!(shouldEnableLiveReload() || externalizeStylesRequested);
 	}
 	let stylesheetRegistry;
 	const sourceFileCache$1 = new sourceFileCache();
@@ -258,10 +250,6 @@ function angular(options) {
 						originalWarnOnce(msg, options);
 					};
 				}
-				if (pluginOptions.hasTailwindCss) {
-					validateTailwindConfig(pluginOptions.tailwindCss, config, watchMode);
-					validateNoDuplicateAnalogPlugins(config);
-				}
 				if (!jit) styleTransform = (code, filename) => preprocessCSS(code, filename, config);
 				if (isTest) testWatchMode = !(config.server.watch === null) || config.test?.watch === true || testWatchMode;
 			},
@@ -726,9 +714,6 @@ function angular(options) {
 		transformFilter: options?.transformFilter,
 		fileReplacements: pluginOptions.fileReplacements,
 		stylePreprocessor: pluginOptions.stylePreprocessor,
-		stylePipeline: options?.stylePipeline,
-		hasTailwindCss: pluginOptions.hasTailwindCss,
-		tailwindCss: pluginOptions.tailwindCss,
 		isTest,
 		isAstroIntegration,
 		include: pluginOptions.include,
@@ -750,7 +735,6 @@ function angular(options) {
 		cssExtensionStyleResolverPlugin(),
 		replaceFiles(pluginOptions.fileReplacements, pluginOptions.workspaceRoot),
 		virtualModulesPlugin({ jit }),
-		pluginOptions.hasTailwindCss && tailwindReferencePlugin({ tailwindCss: pluginOptions.tailwindCss }),
 		pluginOptions.liveReload && liveReloadPlugin({
 			classNames,
 			fileEmitter
@@ -786,6 +770,7 @@ function angular(options) {
 			const integrations = await resolveAnalogIntegrations(config, configuredStylePreprocessor);
 			pluginOptions.stylePreprocessor = integrations.stylePreprocessor;
 			externalizeStylesRequested = integrations.externalizeStyles;
+			configureStylesheetRegistry = integrations.configureStylesheetRegistry;
 			await _doPerformCompilation(config, ids);
 		} finally {
 			resolve();
@@ -849,7 +834,7 @@ function angular(options) {
 		if (!jit) {
 			const externalizeStyles = !!tsCompilerOptions["externalRuntimeStyles"];
 			stylesheetRegistry = externalizeStyles ? new AnalogStylesheetRegistry() : void 0;
-			if (stylesheetRegistry) configureStylePipelineRegistry(pluginOptions.stylePipeline, stylesheetRegistry, { workspaceRoot: pluginOptions.workspaceRoot });
+			if (stylesheetRegistry) configureStylesheetRegistry?.(stylesheetRegistry, { workspaceRoot: pluginOptions.workspaceRoot });
 			debugStyles("stylesheet registry initialized (NgtscProgram path)", { externalizeStyles });
 			augmentHostWithResources(host, styleTransform, {
 				inlineStylesExtension: pluginOptions.inlineStylesExtension,