test: increase coverage and add codecov integration

.github/workflows/ci.yml

@@ -28,17 +28,28 @@ jobs:
       - name: Install dependencies
         run: pnpm install
 
+      - name: Install Playwright
+        run: pnpm run test:setup:ci
+
       - name: Lint
         run: pnpm run lint
 
       - name: Typecheck
         run: pnpm run typecheck && pnpm run dev:typecheck
 
       - name: Test
-        run: pnpm run test
+        run: pnpm run test:coverage
 
       - name: Build
         run: pnpm run build
 
       - name: Publint
         run: pnpm run publint
+
+      - name: Upload coverage to Codecov
+        if: ${{ github.event_name == 'pull_request' || github.ref == 'refs/heads/main' }}
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/browser/lcov.info
+          disable_search: true

.gitignore

@@ -1,6 +1,8 @@
 .DS_Store
 node_modules
 /dist
+/coverage
+/tests/__screenshots__
 
 
 # local env files

AGENTS.md

@@ -14,7 +14,7 @@ This project targets Vue 3 + TypeScript with ECMAScript modules. Follow the exis
 
 ## Testing Guidelines
 
-There is no standalone unit-test runner yet; rely on TypeScript, linting, and manual QA in the demo. Before opening a PR, run `pnpm lint`, `pnpm typecheck`, and `pnpm build`. Exercise relevant demos in `demo/src/` and add or update examples that showcase new behaviors. For major fixes, include reproduction and verification steps in the PR description so reviewers can follow along.
+For complete and up-to-date testing and CI guidance, see [`tests/TESTING.md`](tests/TESTING.md).
 
 ## Commit & Pull Request Guidelines
 

README.md

@@ -436,6 +436,8 @@ pnpm dev
 
 Open `http://localhost:5173` to see the demo.
 
+For testing and CI details, see [`tests/TESTING.md`](tests/TESTING.md).
+
 ## Notice
 
 The Apache Software Foundation [Apache ECharts, ECharts](https://echarts.apache.org/), Apache, the Apache feather, and the Apache ECharts project logo are either registered trademarks or trademarks of the [Apache Software Foundation](https://www.apache.org/).

README.zh-Hans.md

@@ -436,6 +436,8 @@ pnpm dev
 
 打开 `http://localhost:5173` 来查看 demo。
 
+更多测试与 CI 说明请参见 [`tests/TESTING.md`](tests/TESTING.md)。
+
 ## 声明
 
 The Apache Software Foundation [Apache ECharts, ECharts](https://echarts.apache.org/), Apache, the Apache feather, and the Apache ECharts project logo are either registered trademarks or trademarks of the [Apache Software Foundation](https://www.apache.org/).

demo/index.html

@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge" />
     <meta name="viewport" content="width=device-width,initial-scale=1.0" />
-    <link rel="icon" href="/favicon.ico"/>
-    <link rel="icon" href="/favicon.svg" type="image/svg+xml"/>
+    <link rel="icon" href="/favicon.ico" />
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
     <link
       href="https://fonts.googleapis.com/css?family=Inter:300,500;display=swap"
       rel="stylesheet"

package.json

@@ -11,16 +11,19 @@
   "scripts": {
     "dev": "vite",
     "build": "tsdown",
-    "typecheck": "tsc",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.vitest.json",
     "lint": "eslint . --fix",
     "format": "prettier . --write",
     "publint": "publint",
     "dev:build": "vite build",
     "dev:preview": "vite preview",
     "dev:typecheck": "vue-tsc -p ./demo",
+    "test:setup": "playwright install chromium",
+    "test:setup:ci": "playwright install --with-deps chromium",
     "docs": "jiti ./scripts/docs.ts",
     "release": "bumpp --execute \"pnpm run docs\" --all",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest watch"
   },
   "packageManager": "pnpm@10.17.0",
@@ -46,6 +49,8 @@
     "@typescript-eslint/utils": "^8.39.1",
     "@vercel/analytics": "^1.5.0",
     "@vitejs/plugin-vue": "^6.0.1",
+    "@vitest/browser": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.4",
     "@vue/eslint-config-prettier": "^10.2.0",
     "@vue/eslint-config-typescript": "^14.6.0",
     "@vue/tsconfig": "^0.8.0",
@@ -61,6 +66,7 @@
     "highlight.js": "^11.11.1",
     "jiti": "^2.5.1",
     "pinia": "^3.0.3",
+    "playwright": "^1.55.0",
     "postcss-nested": "^7.0.2",
     "prettier": "^3.6.2",
     "publint": "^0.3.12",
@@ -70,6 +76,7 @@
     "unplugin-raw": "^0.6.0",
     "vite": "npm:rolldown-vite@latest",
     "vitest": "^3.2.4",
+    "vitest-browser-vue": "^1.1.0",
     "vue": "^3.5.18",
     "vue-tsc": "^3.0.5"
   },