⬆️ Support Cosmiconfig 10 and Vitest 5

.github/workflows/ci.yml

@@ -14,10 +14,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -42,7 +42,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: ['22.13.1', 24]
+        node-version: ['22.18.0', 24]
 
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

.github/workflows/release-ember-client.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -124,7 +124,7 @@ jobs:
       - name: Set Node.js back to release version
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies

.github/workflows/release-ruby-client.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@97ecb7b512899eb71ab1bf2310a624c6f1589ac6 # v1

.github/workflows/release-static-site-client.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -115,7 +115,7 @@ jobs:
       - name: Set Node.js back to release version
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies

.github/workflows/release-storybook-client.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -115,7 +115,7 @@ jobs:
       - name: Set Node.js back to release version
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies

.github/workflows/release-swift-client.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -150,7 +150,7 @@ jobs:
       - name: Restore Node.js for publishing
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Restore npm for publishing

.github/workflows/release-vitest-client.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -115,7 +115,7 @@ jobs:
       - name: Set Node.js back to release version
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Install dependencies

.github/workflows/release.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Upgrade npm for Trusted Publishers
@@ -159,7 +159,7 @@ jobs:
       - name: Restore Node.js for publishing
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.14.0'
+          node-version: '22.18.0'
           registry-url: 'https://registry.npmjs.org'
 
       - name: Restore npm and pnpm for publishing

.github/workflows/reporter.yml

@@ -15,10 +15,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |

.github/workflows/sdk-e2e.yml

@@ -16,10 +16,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -78,10 +78,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -141,10 +141,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -221,10 +221,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -295,10 +295,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -366,10 +366,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -424,10 +424,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |

.github/workflows/sdk-unit.yml

@@ -62,10 +62,10 @@ jobs:
         with:
           ruby-version: ${{ matrix.ruby-version }}
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |
@@ -103,7 +103,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: ['22.13.1', 24]
+        node-version: ['22.18.0', 24]
 
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -153,7 +153,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: ['22.13.1', 24]
+        node-version: ['22.18.0', 24]
 
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -195,15 +195,16 @@ jobs:
 
   # Vitest SDK - runs on multiple Node versions
   vitest:
-    name: Vitest SDK
+    name: Vitest SDK (Node ${{ matrix.node-version }}, Vitest ${{ matrix.vitest-version }})
     runs-on: ubuntu-latest
     timeout-minutes: 8
     needs: changes
     if: needs.changes.outputs.vitest == 'true'
 
     strategy:
       matrix:
-        node-version: ['22.13.1', 24]
+        node-version: ['22.18.0', 24]
+        vitest-version: [4, 5]
 
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -229,6 +230,11 @@ jobs:
         working-directory: ./clients/vitest
         run: pnpm install --frozen-lockfile
 
+      - name: Install Vitest 4 for compatibility tests
+        if: matrix.vitest-version == 4
+        working-directory: ./clients/vitest
+        run: pnpm add -D vitest@4.1.11 @vitest/browser@4.1.11 @vitest/browser-playwright@4.1.11
+
       - name: Get installed Playwright version
         working-directory: ./clients/vitest
         id: playwright-version
@@ -250,6 +256,12 @@ jobs:
         working-directory: ./clients/vitest
         run: pnpm run lint
 
+      - name: Run Vitest client browser tests
+        working-directory: ./clients/vitest
+        run: pnpm run test:browser
+        env:
+          CI: true
+
       - name: Run Vitest client unit tests
         working-directory: ./clients/vitest
         run: pnpm run test:unit
@@ -290,10 +302,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Install pnpm
         run: |

.github/workflows/tui.yml

@@ -15,10 +15,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
-      - name: Use Node.js 22.13.1
+      - name: Use Node.js 22.18.0
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '22.13.1'
+          node-version: '22.18.0'
 
       - name: Setup tui-driver
         uses: vizzly-testing/tui-driver@f21ea93489f2160eccf4d58844e456a9b38a0491 # main

README.md

@@ -20,7 +20,7 @@ build or diff data for scripts, automation, and coding agents.
 
 ## Quick Start
 
-You need Node.js 22+.
+You need Node.js 22.18 or newer within Node 22, or Node.js 24+.
 
 ```bash
 pnpm install -g @vizzly-testing/cli
@@ -43,6 +43,19 @@ existing Vizzly config.
 Use `vizzly init --agent-skill` to install or refresh only the local skill, or
 `vizzly init --skip-agent-skill` when you want config without the agent prompt.
 
+### TypeScript Configuration
+
+Vizzly loads `vizzly.config.ts` with Node's native type stripping. Type
+annotations, interfaces, and `satisfies` work without installing TypeScript.
+Use `import type` for type-only imports and include file extensions when
+importing local helpers, such as `./helpers.ts`.
+
+Enums, namespaces containing runtime code, and constructor parameter properties
+aren't supported. Replace them with ordinary JavaScript values and assignments.
+Node doesn't apply `tsconfig.json` path aliases when loading your config.
+These restrictions apply to the config and its imports; they don't change how
+your application or tests compile.
+
 ### Start Local TDD
 
 Start the TDD server, run your tests, and open the dashboard at the URL the

clients/ember/package.json

@@ -61,7 +61,7 @@
     "check:fix": "biome check --write src tests bin"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": "^22.18.0 || >=24.0.0"
   },
   "publishConfig": {
     "access": "public",

clients/static-site/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Changed
+
+- Require Node.js 22.18 or newer within Node 22, or Node.js 24+.
+- Remove the unused Cosmiconfig dependency. Configuration still comes from
+  the CLI and the existing interactions file loader.
+
 ## [0.3.0] - 2026-06-01
 
 ## What's Changed