@stencil/vitest 1.7.2 → 1.8.1

package/README.md

@@ -357,6 +357,38 @@ The `stencil-test` CLI supports most of Stencil's CLI options and all of Vitest
 - For full Stencil CLI options, see [Stencil CLI docs](https://stenciljs.com/docs/cli).
 - For full Vitest CLI options, see [Vitest CLI docs](https://vitest.dev/guide/cli.html).
 
+### Global Variables
+
+The `stencil-test` CLI exposes global variables that can be accessed in your tests to check which CLI flags were used:
+
+| Global              | Type      | Description                            |
+| ------------------- | --------- | -------------------------------------- |
+| `__STENCIL_PROD__`  | `boolean` | `true` when `--prod` flag is passed    |
+| `__STENCIL_SERVE__` | `boolean` | `true` when `--serve` flag is passed   |
+| `__STENCIL_PORT__`  | `string`  | Port number when `--port` is specified |
+
+```tsx
+if (__STENCIL_PROD__) {
+  console.log('Running tests against production build');
+}
+
+if (__STENCIL_SERVE__) {
+  const baseUrl = `http://localhost:${__STENCIL_PORT__ || '3333'}`;
+}
+```
+
+#### TypeScript Support
+
+Add to your `tsconfig.json` for type definitions:
+
+```json
+{
+  "compilerOptions": {
+    "types": ["@stencil/vitest/globals"]
+  }
+}
+```
+
 ## License
 
 MIT

package/dist/bin/stencil-test.js

@@ -207,6 +207,10 @@ function runTests() {
         env: {
             ...process.env,
             NODE_ENV: 'test',
+            // Expose CLI flags to tests via environment variables
+            STENCIL_PROD: args.prod ? 'true' : '',
+            STENCIL_SERVE: args.serve ? 'true' : '',
+            STENCIL_PORT: args.port || '',
         },
     });
     vitestProcess.on('exit', (code) => {

package/dist/config.js

@@ -124,8 +124,37 @@ function generateCoverageExcludes(testIncludes, srcDir) {
 function applyStencilDefaults(config, stencilConfig) {
     // Start with the user's config
     const result = { ...config };
-    // Add esbuild JSX config if not present
-    if (!result.esbuild) {
+    // Expose STENCIL_* env vars to all test environments
+    // These are set by the stencil-test CLI when spawning vitest
+    const stencilEnvDefines = {
+        __STENCIL_PROD__: JSON.stringify(process.env.STENCIL_PROD === 'true'),
+        __STENCIL_SERVE__: JSON.stringify(process.env.STENCIL_SERVE === 'true'),
+        __STENCIL_PORT__: JSON.stringify(process.env.STENCIL_PORT || ''),
+    };
+    if (!result.define) {
+        result.define = stencilEnvDefines;
+    }
+    else {
+        // Merge with existing defines, user's defines take precedence
+        result.define = {
+            ...stencilEnvDefines,
+            ...result.define,
+        };
+    }
+    // Add JSX config for the active transformer
+    // Vite 7+ uses oxc by default, older versions use esbuild
+    if (result.oxc) {
+        // oxc is explicitly configured - set JSX options on it
+        if (!result.oxc.jsx) {
+            result.oxc.jsx = {
+                runtime: 'classic',
+                pragma: 'h',
+                pragmaFrag: 'Fragment',
+            };
+        }
+    }
+    else if (!result.esbuild) {
+        // No oxc config, set esbuild JSX options (for older Vite versions)
         result.esbuild = {
             jsxFactory: 'h',
             jsxFragment: 'Fragment',
@@ -307,6 +336,22 @@ function enhanceTestConfig(testConfig, stencilConfig) {
  */
 function enhanceProject(project, stencilConfig) {
     const enhanced = { ...project };
+    // Expose STENCIL_* env vars at the project level for browser tests
+    // This ensures the defines are available in all project types
+    const stencilEnvDefines = {
+        __STENCIL_PROD__: JSON.stringify(process.env.STENCIL_PROD === 'true'),
+        __STENCIL_SERVE__: JSON.stringify(process.env.STENCIL_SERVE === 'true'),
+        __STENCIL_PORT__: JSON.stringify(process.env.STENCIL_PORT || ''),
+    };
+    if (!enhanced.define) {
+        enhanced.define = stencilEnvDefines;
+    }
+    else {
+        enhanced.define = {
+            ...stencilEnvDefines,
+            ...enhanced.define,
+        };
+    }
     // Get output directories from Stencil config
     const outputDirs = getStencilOutputDirs(stencilConfig);
     const defaultExcludes = ['**/node_modules/**', ...outputDirs.map((dir) => `**/${dir}/**`)];

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;AAOvD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;CACrD;AAQD;;;;;;;;;;;;;;;;GAgBG;wBACa,WAAW;AAA3B,wBAkEE"}
+{"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,wBAmEE"}

package/dist/environments/stencil.js

@@ -1,4 +1,14 @@
-import { populateGlobal } from 'vitest/environments';
+// 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 happyDom from './env/happy-dom.js';
 import jsdom from './env/jsdom.js';
 import mockDoc from './env/mock-doc.js';
@@ -53,6 +63,7 @@ export default {
             win.process.env.NODE_ENV = 'test';
         }
         // Populate global with window properties
+        const populateGlobal = await getPopulateGlobal();
         const { keys, originals } = populateGlobal(global, win, {
             bindFunctions: true,
         });

package/dist/globals.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Global variables injected by stencil-test CLI via Vite's define config.
+ *
+ * Usage in tests:
+ * ```typescript
+ * if (__STENCIL_PROD__) {
+ *   // Running with --prod flag
+ * }
+ * ```
+ *
+ * To get TypeScript support, add to your tsconfig.json:
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "types": ["@stencil/vitest/globals"]
+ *   }
+ * }
+ * ```
+ */
+
+declare const __STENCIL_PROD__: boolean;
+declare const __STENCIL_SERVE__: boolean;
+declare const __STENCIL_PORT__: string;

package/dist/testing/matchers.d.ts

@@ -51,6 +51,8 @@ interface CustomMatchers<R = unknown> {
 declare module 'vitest' {
     interface Assertion<T = any> extends CustomMatchers<T> {
     }
+    interface Matchers<T = any, R = T> extends CustomMatchers<R> {
+    }
     interface AsymmetricMatchersContaining extends CustomMatchers {
     }
 }

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,4BAA6B,SAAQ,cAAc;KAAG;CACjE;AAioBD,OAAO,EAAE,CAAC"}
+{"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"}

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/stenciljs/vitest"
   },
-  "version": "1.7.2",
+  "version": "1.8.1",
   "description": "First-class testing utilities for Stencil design systems with Vitest",
   "license": "MIT",
   "type": "module",
@@ -43,6 +43,9 @@
     "./environments/stencil": {
       "types": "./dist/environments/stencil.d.ts",
       "import": "./dist/environments/stencil.js"
+    },
+    "./globals": {
+      "types": "./dist/globals.d.ts"
     }
   },
   "files": [
@@ -97,7 +100,7 @@
   "dependencies": {
     "jiti": "^2.6.1",
     "local-pkg": "^1.1.2",
-    "vitest-environment-stencil": "1.7.2"
+    "vitest-environment-stencil": "1.8.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
@@ -108,7 +111,7 @@
     "@types/node": "24.10.4",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
-    "@vitest/coverage-v8": "^4.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "eslint": "^9.39.2",
     "installed-check": "^9.3.0",
     "knip": "^5.76.3",
@@ -116,13 +119,13 @@
     "prettier": "^3.7.4",
     "semantic-release": "^25.0.2",
     "typescript": "~5.8.3",
-    "vitest": "^4.0.0"
+    "vitest": "^4.1.0"
   },
   "engines": {
     "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
   },
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.bin.json",
+    "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:unit": "vitest run",