@stencil/vitest 1.15.1 → 1.16.0

package/README.md

@@ -42,6 +42,8 @@ First-class testing utilities for Stencil components, powered by Vitest.
 npm i --save-dev @stencil/vitest vitest
 ```
 
+Requires Node.js `^22.12.0 || ^24.0.0 || >=26.0.0`. Vitest 2, 3, 4, and 5 are supported; Vitest 5 also requires Vite `^6.4.0 || ^7.0.0 || ^8.0.0`. See the [Vitest migration guide](https://vitest.dev/guide/migration) when upgrading an existing project.
+
 For browser testing, also install:
 
 ```bash

package/dist/__tests__/environment.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment.spec.d.ts.map

package/dist/__tests__/environment.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/environment.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/environment.spec.js

@@ -0,0 +1,15 @@
+import { expect, it } from 'vitest';
+import environment from '../environments/stencil.js';
+it.each(['mock-doc', 'jsdom', 'happy-dom'])('%s keeps the native Event constructor usable during setup and after teardown', async (domEnvironment) => {
+    const target = { Event };
+    const { teardown } = await environment.setup(target, { stencil: { domEnvironment } });
+    try {
+        expect(new target.Event('ready')).toBeInstanceOf(Event);
+        expect(target.document.createElement('div').tagName).toBe('DIV');
+    }
+    finally {
+        await teardown(target);
+    }
+    expect(target.Event).toBe(Event);
+    expect(target).not.toHaveProperty('document');
+});

package/dist/environments/stencil.d.ts

@@ -1,4 +1,5 @@
-import type { Environment } from 'vitest/environments';
+import type { WorkerGlobalState } from 'vitest';
+type Environment = WorkerGlobalState['environment'];
 export interface StencilEnvironmentOptions {
     /**
      * The DOM environment to use for testing
@@ -23,6 +24,6 @@ export interface StencilEnvironmentOptions {
  * })
  * ```
  */
-declare const _default: Environment;
-export default _default;
+declare const environment: Environment;
+export default environment;
 //# sourceMappingURL=stencil.d.ts.map

package/dist/environments/stencil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../src/environments/stencil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiBvD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;CACrD;AAQD;;;;;;;;;;;;;;;;GAgBG;wBACa,WAAW;AAA3B,wBA6FE"}
+{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../src/environments/stencil.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAOhD,KAAK,WAAW,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAmCpD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;CACrD;AAQD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,WAAW,EAAE,WAsGlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/environments/stencil.js

@@ -1,17 +1,40 @@
-// Dynamically import populateGlobal to support both vitest 4.1+ (vitest/runtime) and older versions (vitest/environments)
-async function getPopulateGlobal() {
-    try {
-        // Use variable to prevent Vite's static import analysis from failing on older vitest
-        const runtimePath = 'vitest/' + 'runtime';
-        return (await import(/* @vite-ignore */ runtimePath)).populateGlobal;
-    }
-    catch {
-        return (await import('vitest/environments')).populateGlobal;
-    }
-}
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
 import happyDom from './env/happy-dom.js';
 import jsdom from './env/jsdom.js';
 import mockDoc from './env/mock-doc.js';
+const require = createRequire(import.meta.url);
+// Vitest 4 replaced `transformMode` with `viteEnvironment` and warns when the old field is still set.
+const vitestMajor = Number.parseInt(require('vitest/package.json').version, 10);
+const environmentOptions = vitestMajor >= 4 ? { viteEnvironment: 'ssr' } : { transformMode: 'ssr' };
+// populateGlobal lives in vitest/runtime from Vitest 4.1 and in vitest/environments before that (removed in Vitest 5).
+// The specifiers are variables because Vite fails to analyze an entry the installed Vitest lacks.
+// The file URL is a fallback for Vitest 5 on Windows, whose two module runners each mishandle one form:
+// the one that loads environments rejects the URL, and the one that runs test code (where this module
+// ends up when it is imported directly) resolves the bare specifier against the cwd.
+async function getPopulateGlobal() {
+    let error;
+    for (const entry of ['vitest/runtime', 'vitest/environments']) {
+        let resolved;
+        try {
+            resolved = require.resolve(entry);
+        }
+        catch {
+            continue;
+        }
+        for (const specifier of [entry, pathToFileURL(resolved).href]) {
+            try {
+                return (await import(/* @vite-ignore */ specifier)).populateGlobal;
+            }
+            catch (e) {
+                error ??= e;
+            }
+        }
+    }
+    throw new Error('@stencil/vitest: could not load populateGlobal from the installed version of vitest', {
+        cause: error,
+    });
+}
 const environmentMap = {
     'happy-dom': happyDom,
     jsdom: jsdom,
@@ -34,9 +57,9 @@ const environmentMap = {
  * })
  * ```
  */
-export default {
+const environment = {
     name: 'stencil',
-    viteEnvironment: 'ssr',
+    ...environmentOptions,
     async setup(global, options) {
         const { stencil = {} } = options;
         const domEnvironment = stencil.domEnvironment || 'mock-doc';
@@ -67,6 +90,14 @@ export default {
         if (!win.process.env.NODE_ENV) {
             win.process.env.NODE_ENV = 'test';
         }
+        // Vitest 2–4 store values in originals; Vitest 5 stores descriptors.
+        // Capture descriptors ourselves so both preserve the native globals.
+        const originalDescriptors = Object.getOwnPropertyDescriptors(global);
+        const restoreGlobal = (key) => {
+            const descriptor = originalDescriptors[key];
+            if (descriptor)
+                Object.defineProperty(global, key, descriptor);
+        };
         // Populate global with window properties
         const populateGlobal = await getPopulateGlobal();
         const { keys, originals } = populateGlobal(global, win, {
@@ -75,7 +106,7 @@ export default {
         // Restore Node's native Event constructor (chai needs this)
         // CustomEvent can stay as mock-doc's version since it's needed for event creation
         if (originals.has('Event')) {
-            global.Event = originals.get('Event');
+            restoreGlobal('Event');
         }
         // Create HTMLElement wrapper that captures ownerDocument
         // In Stencil 4.43+, win.HTMLElement returns MockHTMLElement directly which expects
@@ -83,7 +114,7 @@ export default {
         // super() with no args (standard browser behavior). This wrapper bridges the gap.
         const MockHTMLElementBase = global.HTMLElement;
         const doc = win.document;
-        global.HTMLElement = class extends MockHTMLElementBase {
+        const HTMLElement = class extends MockHTMLElementBase {
             constructor() {
                 super(doc, '');
                 const observedAttributes = this.constructor.observedAttributes;
@@ -97,10 +128,11 @@ export default {
                 }
             }
         };
+        Object.defineProperty(global, 'HTMLElement', { value: HTMLElement, writable: true, configurable: true });
         // Remove undefined properties that shadow native globals
         keys.forEach((key) => {
             if (global[key] === undefined && originals.has(key)) {
-                global[key] = originals.get(key);
+                restoreGlobal(key);
             }
         });
         return {
@@ -111,8 +143,9 @@ export default {
                 envTeardown();
                 // Then clean up populated globals
                 keys.forEach((key) => delete global[key]);
-                originals.forEach((v, k) => (global[k] = v));
+                originals.forEach((_, key) => restoreGlobal(key));
             },
         };
     },
 };
+export default environment;

package/dist/testing/matchers.d.ts

@@ -3,57 +3,57 @@
  *
  * These extend Vitest's expect with Stencil-specific assertions
  */
-/**
- * Custom matchers interface
- */
-interface CustomMatchers<R = unknown> {
+type MatcherResult<T> = T extends {
+    toBe: (...args: any[]) => infer R;
+} ? R : unknown;
+interface CustomMatchers {
     /** Asserts element has the specified CSS class. */
-    toHaveClass(className: string): R;
+    toHaveClass(className: string): MatcherResult<this>;
     /** Asserts element has all specified CSS classes. */
-    toHaveClasses(classNames: string[]): R;
+    toHaveClasses(classNames: string[]): MatcherResult<this>;
     /** Asserts element has exactly the specified CSS classes (no more, no less). */
-    toMatchClasses(classNames: string[]): R;
+    toMatchClasses(classNames: string[]): MatcherResult<this>;
     /** Asserts element has the attribute, optionally with a specific value. */
-    toHaveAttribute(attribute: string, value?: string): R;
+    toHaveAttribute(attribute: string, value?: string): MatcherResult<this>;
     /** Asserts element attribute equals the expected value exactly. */
-    toEqualAttribute(attribute: string, value: string): R;
+    toEqualAttribute(attribute: string, value: string): MatcherResult<this>;
     /** Asserts element has all specified attributes with exact values. */
-    toEqualAttributes(expectedAttrs: Record<string, string>): R;
-    /** Asserts element has the property, optionally with a specific value. */
-    toHaveProperty(property: string, value?: any): R;
+    toEqualAttributes(expectedAttrs: Record<string, string>): MatcherResult<this>;
     /** Asserts element's text content (including shadow DOM) contains the specified text. */
-    toHaveTextContent(text: string): R;
+    toHaveTextContent(text: string): MatcherResult<this>;
     /** Asserts element's light DOM text content contains the specified text. */
-    toHaveLightTextContent(text: string): R;
+    toHaveLightTextContent(text: string): MatcherResult<this>;
     /** Asserts element's trimmed text content (including shadow DOM) equals the expected text exactly. */
-    toEqualText(expectedText: string): R;
+    toEqualText(expectedText: string): MatcherResult<this>;
     /** Asserts element's trimmed light DOM text content (excluding shadow DOM) equals the expected text exactly. */
-    toEqualLightText(expectedText: string): R;
+    toEqualLightText(expectedText: string): MatcherResult<this>;
     /** Asserts element has an attached shadow root. */
-    toHaveShadowRoot(): R;
+    toHaveShadowRoot(): MatcherResult<this>;
     /** Asserts element's serialized HTML (including shadow DOM) matches expected HTML. */
-    toEqualHtml(expectedHtml: string): R;
+    toEqualHtml(expectedHtml: string): MatcherResult<this>;
     /** Asserts element's light DOM HTML (excluding shadow DOM internals) matches expected HTML. */
-    toEqualLightHtml(expectedHtml: string): R;
+    toEqualLightHtml(expectedHtml: string): MatcherResult<this>;
     /** Asserts event spy has received at least one event. */
-    toHaveReceivedEvent(): R;
+    toHaveReceivedEvent(): MatcherResult<this>;
     /** Asserts event spy has received exactly the specified number of events. */
-    toHaveReceivedEventTimes(count: number): R;
+    toHaveReceivedEventTimes(count: number): MatcherResult<this>;
     /** Asserts event spy's last received event has the expected detail. */
-    toHaveReceivedEventDetail(detail: any): R;
+    toHaveReceivedEventDetail(detail: any): MatcherResult<this>;
     /** Asserts event spy's first received event has the expected detail. */
-    toHaveFirstReceivedEventDetail(detail: any): R;
+    toHaveFirstReceivedEventDetail(detail: any): MatcherResult<this>;
     /** Asserts event spy's last received event has the expected detail. */
-    toHaveLastReceivedEventDetail(detail: any): R;
+    toHaveLastReceivedEventDetail(detail: any): MatcherResult<this>;
     /** Asserts event spy's nth received event (0-indexed) has the expected detail. */
-    toHaveNthReceivedEventDetail(index: number, detail: any): R;
+    toHaveNthReceivedEventDetail(index: number, detail: any): MatcherResult<this>;
 }
 declare module 'vitest' {
-    interface Assertion<T = any> extends CustomMatchers<T> {
-    }
-    interface Matchers<T = any, R = T> extends CustomMatchers<R> {
+    interface Assertion extends CustomMatchers {
+        toHaveClass(className: string): MatcherResult<this>;
+        toHaveAttribute(attribute: string, value?: string): MatcherResult<this>;
+        toHaveTextContent(text: string): MatcherResult<this>;
     }
     interface AsymmetricMatchersContaining extends CustomMatchers {
+        toHaveProperty(property: string, value?: any): unknown;
     }
 }
 export {};

package/dist/testing/matchers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/testing/matchers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,UAAU,cAAc,CAAC,CAAC,GAAG,OAAO;IAClC,mDAAmD;IACnD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC;IAClC,qDAAqD;IACrD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,gFAAgF;IAChF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,2EAA2E;IAC3E,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACtD,mEAAmE;IACnE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC;IACtD,sEAAsE;IACtE,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5D,0EAA0E;IAC1E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;IACjD,yFAAyF;IACzF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IACnC,4EAA4E;IAC5E,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IACxC,sGAAsG;IACtG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;IACrC,gHAAgH;IAChH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;IAC1C,mDAAmD;IACnD,gBAAgB,IAAI,CAAC,CAAC;IACtB,sFAAsF;IACtF,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;IACrC,+FAA+F;IAC/F,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;IAC1C,yDAAyD;IACzD,mBAAmB,IAAI,CAAC,CAAC;IACzB,6EAA6E;IAC7E,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC;IAC3C,uEAAuE;IACvE,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC1C,wEAAwE;IACxE,8BAA8B,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC/C,uEAAuE;IACvE,6BAA6B,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC9C,kFAAkF;IAClF,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;CAC7D;AAGD,OAAO,QAAQ,QAAQ,CAAC;IACtB,UAAU,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;KAAG;IACzD,UAAU,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;KAAG;IAC/D,UAAU,4BAA6B,SAAQ,cAAc;KAAG;CACjE;AAioBD,OAAO,EAAE,CAAC"}
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/testing/matchers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/stenciljs/vitest"
   },
-  "version": "1.15.1",
+  "version": "1.16.0",
   "description": "First-class testing utilities for Stencil design systems with Vitest",
   "license": "MIT",
   "type": "module",
@@ -77,7 +77,7 @@
   },
   "peerDependencies": {
     "@stencil/core": "^4.0.0 || >=5.0.0-alpha.0 <5.0.0-next.0 || ^5.0.0",
-    "vitest": "^4.0.0 || ^3.0.0 || ^2.0.0"
+    "vitest": "^5.0.0 || ^4.0.0 || ^3.0.0 || ^2.0.0"
   },
   "peerDependenciesMeta": {
     "@playwright/test": {
@@ -111,34 +111,37 @@
   "dependencies": {
     "jiti": "^2.6.1",
     "local-pkg": "^1.1.2",
-    "vitest-environment-stencil": "1.15.1"
+    "vitest-environment-stencil": "1.16.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@stencil/core": "^4.0.0 || >=5.0.0-alpha.0 <5.0.0-next.0 || ^5.0.0",
     "@stencil/cli": "^5.0.0 || >=5.0.0-alpha.0 <5.0.0-next.0",
+    "@stencil/core": "^4.0.0 || >=5.0.0-alpha.0 <5.0.0-next.0 || ^5.0.0",
     "@types/node": "24.10.4",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/browser": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.3",
     "eslint": "^9.39.2",
+    "happy-dom": "^20.0.11",
     "installed-check": "^9.3.0",
+    "jsdom": "^27.3.0",
     "knip": "^5.76.3",
     "prettier": "^3.7.4",
     "semantic-release": "^25.0.2",
     "typescript": "~5.8.3",
-    "vitest": "^4.1.0"
+    "vitest": "^5.0.3"
   },
   "engines": {
-    "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
+    "node": "^22.12.0 || ^24.0.0 || >=26.0.0"
   },
   "scripts": {
     "build": "tsc && tsc -p tsconfig.bin.json && cp src/globals.d.ts dist/globals.d.ts",
     "dev": "tsc --watch",
-    "test:e2e": "pnpm --filter test-project test",
+    "test:e2e": "pnpm --filter test-project --filter test-env-comments test",
     "test:unit": "vitest run",
     "test:unit:watch": "vitest",
     "test:engines": "pnpm installed-check --no-workspaces --ignore-dev",
@@ -149,6 +152,7 @@
     "knip": "knip",
     "quality": "pnpm format && pnpm lint && pnpm knip",
     "quality:fix": "pnpm format:fix && pnpm lint:fix && pnpm knip",
-    "release": "semantic-release"
+    "release": "semantic-release",
+    "test:types": "tsc -p tsconfig.types.json"
   }
 }