@analogjs/vite-plugin-angular 3.0.0-alpha.36 → 3.0.0-alpha.38

package/README.md

@@ -48,6 +48,28 @@ export default defineConfig({
 
 > The `angular` plugin should be listed **first** in the plugins array.
 
+## Fast Compile Mode
+
+`fastCompile` opts the plugin into a single-pass compilation path that emits Ivy instructions directly and skips Angular's template type-checking. It's intended for content-focused apps and faster dev iteration where build throughput matters more than inline type-safety feedback.
+
+```ts
+export default defineConfig({
+  plugins: [angular({ fastCompile: true })],
+});
+```
+
+When `fastCompile` is enabled, template and input type errors will not surface during compilation — run `ngc -p tsconfig.app.json --noEmit` as a separate step in your build script to keep full type safety:
+
+```json
+{
+  "scripts": {
+    "build": "ngc -p tsconfig.app.json --noEmit && vite build"
+  }
+}
+```
+
+The fast compile path currently passes ~91% of Angular's conformance suite. Behavior and output may change between minor releases.
+
 ## Setting up the TypeScript config
 
 The integration needs a `tsconfig.app.json` at the root of the project for compilation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analogjs/vite-plugin-angular",
-  "version": "3.0.0-alpha.36",
+  "version": "3.0.0-alpha.38",
   "description": "Vite Plugin for Angular",
   "type": "module",
   "keywords": [
@@ -36,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@analogjs/angular-compiler": "3.0.0-alpha.36",
     "es-toolkit": "^1.45.1",
+    "magic-string": "^0.30.21",
     "obug": "^2.1.1",
     "oxc-parser": "^0.124.0",
     "oxc-resolver": "^11.19.1",
@@ -65,8 +65,7 @@
       "@analogjs/storybook-angular",
       "@analogjs/vite-plugin-angular",
       "@analogjs/vite-plugin-nitro",
-      "@analogjs/vitest-angular",
-      "@analogjs/angular-compiler"
+      "@analogjs/vitest-angular"
     ],
     "migrations": "./migrations/migration.json"
   },

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

@@ -1,5 +1,6 @@
 import { debugStyles } from "./utils/debug.js";
 import { isTailwindReferenceError } from "./utils/tailwind-reference.js";
+import { shouldPreprocessTestCss } from "./utils/virtual-resources.js";
 import { createHash } from "node:crypto";
 import { preprocessCSS } from "vite";
 //#region packages/vite-plugin-angular/src/lib/angular-jit-plugin.ts
@@ -19,6 +20,8 @@ function jitPlugin({ inlineStylesExtension }) {
 				const styleIdHash = createHash("sha256").update(styleId).digest("hex").slice(0, 16);
 				const decodedStyles = Buffer.from(decodeURIComponent(styleId), "base64").toString();
 				let styles = "";
+				const inlineStyleId = `${styleIdHash}.${inlineStylesExtension}`;
+				if (!shouldPreprocessTestCss(config, inlineStyleId)) return `export default \`\``;
 				try {
 					styles = (await preprocessCSS(decodedStyles, `${styleIdHash}.${inlineStylesExtension}?direct`, config))?.code;
 				} catch (e) {

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 { createHash } from 'node:crypto';\nimport { Plugin, ResolvedConfig, preprocessCSS } from 'vite';\nimport { debugStyles } from './utils/debug.js';\nimport { isTailwindReferenceError } from './utils/tailwind-reference.js';\n\nexport function jitPlugin({\n  inlineStylesExtension,\n}: {\n  inlineStylesExtension: string;\n}): Plugin {\n  let config: ResolvedConfig;\n\n  return {\n    name: '@analogjs/vite-plugin-angular-jit',\n    configResolved(_config) {\n      config = _config;\n    },\n    resolveId(id: string) {\n      if (id.startsWith('virtual:angular')) {\n        return `\\0${id}`;\n      }\n\n      return;\n    },\n    async load(id: string) {\n      if (id.includes('virtual:angular:jit:style:inline;')) {\n        const styleId = id.split('style:inline;')[1];\n        // styleId may exceed 255 bytes of base64-encoded content, limit to 16\n        const styleIdHash = createHash('sha256')\n          .update(styleId)\n          .digest('hex')\n          .slice(0, 16);\n\n        const decodedStyles = Buffer.from(\n          decodeURIComponent(styleId),\n          'base64',\n        ).toString();\n\n        let styles: string | undefined = '';\n\n        try {\n          const compiled = await preprocessCSS(\n            decodedStyles,\n            `${styleIdHash}.${inlineStylesExtension}?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":";;;;;AAKA,SAAgB,UAAU,EACxB,yBAGS;CACT,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,eAAe,SAAS;AACtB,YAAS;;EAEX,UAAU,IAAY;AACpB,OAAI,GAAG,WAAW,kBAAkB,CAClC,QAAO,KAAK;;EAKhB,MAAM,KAAK,IAAY;AACrB,OAAI,GAAG,SAAS,oCAAoC,EAAE;IACpD,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC;IAE1C,MAAM,cAAc,WAAW,SAAS,CACrC,OAAO,QAAQ,CACf,OAAO,MAAM,CACb,MAAM,GAAG,GAAG;IAEf,MAAM,gBAAgB,OAAO,KAC3B,mBAAmB,QAAQ,EAC3B,SACD,CAAC,UAAU;IAEZ,IAAI,SAA6B;AAEjC,QAAI;AAMF,eALiB,MAAM,cACrB,eACA,GAAG,YAAY,GAAG,sBAAsB,UACxC,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 { createHash } from 'node:crypto';\nimport { Plugin, ResolvedConfig, preprocessCSS } from 'vite';\nimport { debugStyles } from './utils/debug.js';\nimport { isTailwindReferenceError } from './utils/tailwind-reference.js';\n\nimport { shouldPreprocessTestCss } from './utils/virtual-resources.js';\n\nexport function jitPlugin({\n  inlineStylesExtension,\n}: {\n  inlineStylesExtension: string;\n}): Plugin {\n  let config: ResolvedConfig;\n\n  return {\n    name: '@analogjs/vite-plugin-angular-jit',\n    configResolved(_config) {\n      config = _config;\n    },\n    resolveId(id: string) {\n      if (id.startsWith('virtual:angular')) {\n        return `\\0${id}`;\n      }\n\n      return;\n    },\n    async load(id: string) {\n      if (id.includes('virtual:angular:jit:style:inline;')) {\n        const styleId = id.split('style:inline;')[1];\n        // styleId may exceed 255 bytes of base64-encoded content, limit to 16\n        const styleIdHash = createHash('sha256')\n          .update(styleId)\n          .digest('hex')\n          .slice(0, 16);\n\n        const decodedStyles = Buffer.from(\n          decodeURIComponent(styleId),\n          'base64',\n        ).toString();\n\n        let styles: string | undefined = '';\n\n        // In tests, mirror Vitest's `test.css` rules — defaults to no\n        // preprocessing (matches Vite's CSS pipeline behavior). Inline\n        // component styles have no real file path to match include/exclude\n        // patterns against, so only `test.css: true` opts them in. (#2297)\n        const inlineStyleId = `${styleIdHash}.${inlineStylesExtension}`;\n        if (!shouldPreprocessTestCss(config, inlineStyleId)) {\n          return `export default \\`\\``;\n        }\n\n        try {\n          const compiled = await preprocessCSS(\n            decodedStyles,\n            `${styleIdHash}.${inlineStylesExtension}?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":";;;;;;AAOA,SAAgB,UAAU,EACxB,yBAGS;CACT,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,eAAe,SAAS;AACtB,YAAS;;EAEX,UAAU,IAAY;AACpB,OAAI,GAAG,WAAW,kBAAkB,CAClC,QAAO,KAAK;;EAKhB,MAAM,KAAK,IAAY;AACrB,OAAI,GAAG,SAAS,oCAAoC,EAAE;IACpD,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC;IAE1C,MAAM,cAAc,WAAW,SAAS,CACrC,OAAO,QAAQ,CACf,OAAO,MAAM,CACb,MAAM,GAAG,GAAG;IAEf,MAAM,gBAAgB,OAAO,KAC3B,mBAAmB,QAAQ,EAC3B,SACD,CAAC,UAAU;IAEZ,IAAI,SAA6B;IAMjC,MAAM,gBAAgB,GAAG,YAAY,GAAG;AACxC,QAAI,CAAC,wBAAwB,QAAQ,cAAc,CACjD,QAAO;AAGT,QAAI;AAMF,eALiB,MAAM,cACrB,eACA,GAAG,YAAY,GAAG,sBAAsB,UACxC,OACD,GACkB;aACZ,GAAG;AACV,SAAI,yBAAyB,EAAE,CAC7B,OAAM;KAER,MAAM,eAAe,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC/D,iBAAY,6BAA6B;MACvC;MACA,OAAO;MACR,CAAC;AACF,aAAQ,KACN,6HACA,aACA,aACD;;AAGH,WAAO,oBAAoB,OAAO;;;EAKvC"}

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

@@ -44,15 +44,20 @@ export interface PluginOptions {
 	liveReload?: boolean;
 	disableTypeChecking?: boolean;
 	fileReplacements?: FileReplacement[];
+	/**
+	* Opt into the fast compile path. Skips Angular's template type-checking
+	* and routes compilation through an internal single-pass transform.
+	* Defaults to `false`.
+	*/
+	fastCompile?: boolean;
+	/**
+	* Compilation output mode used when `fastCompile` is enabled.
+	* - `'full'` (default): Emit final Ivy definitions for application builds.
+	* - `'partial'`: Emit partial declarations for library publishing.
+	*/
+	fastCompileMode?: "full" | "partial";
 	experimental?: {
 		useAngularCompilationAPI?: boolean;
-		useAnalogCompiler?: boolean;
-		/**
-		* Compilation output mode for the Analog compiler.
-		* - `'full'` (default): Emit final Ivy definitions for application builds.
-		* - `'partial'`: Emit partial declarations for library publishing.
-		*/
-		analogCompilationMode?: "full" | "partial";
 	};
 	/**
 	* Enable debug logging for specific scopes.

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

@@ -3,6 +3,8 @@ import { getJsTransformConfigKey, isRolldown } from "./utils/rolldown.js";
 import { buildOptimizerPlugin } from "./angular-build-optimizer-plugin.js";
 import { activateDeferredDebug, applyDebugOption, debugCompilationApi, debugCompiler, debugCompilerV, debugEmit, debugEmitV, debugHmr, debugHmrV, debugStyles, debugStylesV, debugTailwind, debugTailwindV } from "./utils/debug.js";
 import { inspectCssTailwindDirectives, isTailwindReferenceError, throwTailwindReferenceTextError } from "./utils/tailwind-reference.js";
+import { toVirtualRawId, toVirtualStyleId } from "./utils/virtual-ids.js";
+import { loadVirtualRawModule, loadVirtualStyleModule } from "./utils/virtual-resources.js";
 import { jitPlugin } from "./angular-jit-plugin.js";
 import { createCompilerPlugin, createRolldownCompilerPlugin } from "./compiler-plugin.js";
 import { StyleUrlsResolver, TemplateUrlsResolver, getAngularComponentMetadata } from "./component-resolvers.js";
@@ -10,9 +12,7 @@ import { composeStylePreprocessors, normalizeStylesheetDependencies } from "./st
 import { AnalogStylesheetRegistry, preprocessStylesheet, preprocessStylesheetResult, registerStylesheetContent, rewriteRelativeCssImports } from "./stylesheet-registry.js";
 import { augmentHostWithCaching, augmentHostWithResources, augmentProgramWithVersioning, mergeTransformers } from "./host.js";
 import { TS_EXT_REGEX, createTsConfigGetter, getTsConfigPath } from "./utils/plugin-config.js";
-import { toVirtualRawId, toVirtualStyleId } from "./utils/virtual-ids.js";
-import { loadVirtualRawModule, loadVirtualStyleModule } from "./utils/virtual-resources.js";
-import { analogCompilerPlugin } from "./analog-compiler-plugin.js";
+import { fastCompilePlugin } from "./fast-compile-plugin.js";
 import { angularVitestPlugins } from "./angular-vitest-plugin.js";
 import { pendingTasksPlugin } from "./angular-pending-tasks.plugin.js";
 import { liveReloadPlugin } from "./live-reload-plugin.js";
@@ -135,6 +135,8 @@ function angular(options) {
 		disableTypeChecking: options?.disableTypeChecking ?? true,
 		fileReplacements: options?.fileReplacements ?? [],
 		useAngularCompilationAPI: options?.experimental?.useAngularCompilationAPI ?? false,
+		fastCompile: options?.fastCompile ?? false,
+		fastCompileMode: options?.fastCompileMode ?? "full",
 		hasTailwindCss: !!options?.tailwindCss,
 		tailwindCss: options?.tailwindCss,
 		stylePreprocessor: buildStylePreprocessor(options)
@@ -980,7 +982,7 @@ function angular(options) {
 			}
 		};
 	}
-	pluginOptions.useAnalogCompiler ? analogCompilerPlugin({
+	pluginOptions.fastCompile ? fastCompilePlugin({
 		tsconfigGetter: pluginOptions.tsconfigGetter,
 		workspaceRoot: pluginOptions.workspaceRoot,
 		inlineStylesExtension: pluginOptions.inlineStylesExtension,
@@ -990,7 +992,7 @@ function angular(options) {
 		transformFilter: options?.transformFilter,
 		isTest,
 		isAstroIntegration,
-		analogCompilationMode: pluginOptions.analogCompilationMode
+		fastCompileMode: pluginOptions.fastCompileMode
 	}) : angularPlugin();
 	return [
 		replaceFiles(pluginOptions.fileReplacements, pluginOptions.workspaceRoot),