@analogjs/vitest-angular 3.0.0-alpha.88 → 3.0.0-alpha.89

package/README.md

@@ -99,9 +99,11 @@ As of Angular v21, `Zoneless` change detection is the default for new projects.
 Use the following setup:
 
 ```ts
+// src/test-setup.ts
 import '@angular/compiler';
 import '@analogjs/vitest-angular/setup-snapshots';
 import '@analogjs/vitest-angular/setup-serializers';
+
 import { setupTestBed } from '@analogjs/vitest-angular/setup-testbed';
 
 setupTestBed();
@@ -109,11 +111,13 @@ setupTestBed();
 
 ### Zone.js setup
 
-If you are using `Zone.js` for change detection, import the `setup-zone` script. This script automatically includes support for setting up snapshot tests.
+If you are using `Zone.js` for change detection, import the `setup-zone` script before setting up the `TestBed`. This script patches the test environment for `Zone.js` helpers such as `fakeAsync`, and automatically includes support for setting up snapshot tests.
 
 ```ts
+// src/test-setup.ts
 import '@angular/compiler';
 import '@analogjs/vitest-angular/setup-zone';
+
 import { setupTestBed } from '@analogjs/vitest-angular/setup-testbed';
 
 setupTestBed({
@@ -121,6 +125,10 @@ setupTestBed({
 });
 ```
 
+The side effect imports must come first. If your formatter sorts side effect imports below named imports, keep them in a separate import group with a blank line, or exclude `src/test-setup.ts` from import sorting.
+
+> **Note:** With `Zone.js`, use Vitest's global test functions, with `globals: true` set in the `vite.config.mts`, and `vitest/globals` added to the `types` array in the `tsconfig.spec.json`. Importing `describe`, `it`, `beforeEach`, and other functions from `vitest` directly bypasses the `Zone.js` patching, and `fakeAsync` fails with the error `Expected to be running in 'ProxyZone', but it was not found`. Zoneless tests have no such restriction — when migrating to zoneless change detection, you can switch back to importing the functions from `vitest`.
+
 ### Configuration Options
 
 The `setupTestBed()` function accepts an optional configuration object with the following properties:
@@ -289,19 +297,7 @@ export default defineConfig(({ mode }) => ({
 
 ### With Nx
 
-For Nx workspaces, import and use the `nxViteTsPaths` plugin from the `@nx/vite` package.
-
-```ts
-/// <reference types="vitest" />
-import { defineConfig } from 'vite';
-
-import angular from '@analogjs/vite-plugin-angular';
-import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
-
-export default defineConfig(({ mode }) => ({
-  plugins: [angular(), nxViteTsPaths()],
-}));
-```
+Nx workspaces use the same `vite-tsconfig-paths` plugin. The `nxViteTsPaths` plugin from `@nx/vite` is deprecated and is removed in Nx 24, so replace it with `viteTsConfigPaths()`.
 
 ## IDE Support
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analogjs/vitest-angular",
-  "version": "3.0.0-alpha.88",
+  "version": "3.0.0-alpha.89",
   "description": "Vitest Builder for Angular",
   "type": "module",
   "author": "Brandon Roberts <robertsbt@gmail.com>",
@@ -58,7 +58,7 @@
     "@analogjs/vite-plugin-angular": "*",
     "@angular-devkit/architect": ">=0.1500.0 < 0.2300.0",
     "@angular-devkit/schematics": ">=17.0.0",
-    "vitest": "^1.3.1 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "vitest": "^1.3.1 || ^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0",
     "zone.js": ">=0.14.0"
   },
   "peerDependenciesMeta": {

package/src/lib/tools/schematics/utils/versions.d.ts

@@ -1,4 +1,4 @@
-export declare const ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.88";
+export declare const ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.89";
 export declare const JSDOM = "^22.0.0";
 export declare const VITE_TSCONFIG_PATHS = "^4.2.0";
 export declare const VITE = "^7.0.0";

package/src/lib/tools/schematics/utils/versions.js

@@ -1,5 +1,5 @@
 //#region packages/vitest-angular-tools/src/schematics/utils/versions.ts
-var ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.88";
+var ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.89";
 var JSDOM = "^22.0.0";
 var VITE_TSCONFIG_PATHS = "^4.2.0";
 var VITE = "^7.0.0";

package/src/lib/tools/schematics/utils/versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions.js","names":[],"sources":["../../../../../../../vitest-angular-tools/src/schematics/utils/versions.ts"],"sourcesContent":["// Version constants (Angular 20+)\nexport const ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.88';\nexport const JSDOM = '^22.0.0';\nexport const VITE_TSCONFIG_PATHS = '^4.2.0';\nexport const VITE = '^7.0.0';\nexport const VITEST_V4 = '^4.0.0';\n\n// Browser mode dependencies\nexport const VITEST_BROWSER_PLAYWRIGHT = '^4.0.0';\nexport const PLAYWRIGHT = '^1.54.0';\n"],"mappings":";AACA,IAAa,gCAAgC;AAC7C,IAAa,QAAQ;AACrB,IAAa,sBAAsB;AACnC,IAAa,OAAO;AACpB,IAAa,YAAY;AAGzB,IAAa,4BAA4B;AACzC,IAAa,aAAa"}
+{"version":3,"file":"versions.js","names":[],"sources":["../../../../../../../vitest-angular-tools/src/schematics/utils/versions.ts"],"sourcesContent":["// Version constants (Angular 20+)\nexport const ANALOG_JS_VITE_PLUGIN_ANGULAR = '^3.0.0-alpha.89';\nexport const JSDOM = '^22.0.0';\nexport const VITE_TSCONFIG_PATHS = '^4.2.0';\nexport const VITE = '^7.0.0';\nexport const VITEST_V4 = '^4.0.0';\n\n// Browser mode dependencies\nexport const VITEST_BROWSER_PLAYWRIGHT = '^4.0.0';\nexport const PLAYWRIGHT = '^1.54.0';\n"],"mappings":";AACA,IAAa,gCAAgC;AAC7C,IAAa,QAAQ;AACrB,IAAa,sBAAsB;AACnC,IAAa,OAAO;AACpB,IAAa,YAAY;AAGzB,IAAa,4BAA4B;AACzC,IAAa,aAAa"}

package/src/lib/tools/src/schematics/utils/versions.d.ts

@@ -1,4 +1,4 @@
-export declare const ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.88";
+export declare const ANALOG_JS_VITE_PLUGIN_ANGULAR = "^3.0.0-alpha.89";
 export declare const JSDOM = "^22.0.0";
 export declare const VITE_TSCONFIG_PATHS = "^4.2.0";
 export declare const VITE = "^7.0.0";