Merge branch 'main' into fix/pivotBoxPlot

Author: 666haiwen

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,60 @@
+<!--
+First of all, thank you for your contribution! 😄
+For requesting to pull a new feature or bugfix, please send it from a feature/bugfix branch based on the `main` branch.
+Before submitting your pull request, please make sure the checklist below is confirmed.
+Your pull requests will be merged after one of the collaborators approve.
+Thank you!
+-->
+
+[[中文版模板 / Chinese template](https://github.com/VisActor/VChart/blob/main/.github/PULL_REQUEST_TEMPLATE/pr_cn.md?plain=1)]
+
+### 🤔 This is a ...
+
+- [ ] New feature
+- [ ] Bug fix
+- [ ] TypeScript definition update
+- [ ] Bundle size optimization
+- [ ] Performance optimization
+- [ ] Enhancement feature
+- [ ] Refactoring
+- [ ] Update dependency
+- [ ] Code style optimization
+- [ ] Test Case
+- [ ] Branch merge
+- [ ] Release
+- [ ] Site / documentation update
+- [ ] Demo update
+- [ ] Workflow
+- [ ] Other (about what?)
+
+### 🔗 Related issue link
+
+<!--
+1. Put the related issue or discussion links here.
+2. close #xxxx or fix #xxxx for instance.
+-->
+
+### 🔗 Related PR link
+
+<!-- Put the related PR links here. -->
+
+### 🐞 Bugserver case id
+
+<!-- paste the `fileid` field in the bugserver case url -->
+
+### 💡 Background and solution
+
+<!--
+1. Describe the problem and the scenario.
+2. GIF or snapshot should be provided if includes UI/interactive modification.
+3. How to fix the problem, and list the final API implementation and usage sample if that is a new feature.
+-->
+
+### ☑️ Self-Check before Merge
+
+⚠️ Please check all items below before requesting a reviewing. ⚠️
+
+- [ ] Doc is updated/provided or not needed
+- [ ] Demo is updated/provided or not needed
+- [ ] TypeScript definition is updated/provided or not needed
+- [ ] Changelog is provided or not needed

.github/PULL_REQUEST_TEMPLATE/pr_cn.md

@@ -0,0 +1,58 @@
+<!--
+首先，感谢您参与代码贡献! 😄
+为了提交新的功能或修改,请在主分支`main`分支上拉取开发分支 。
+在提交PR 之前，请确认下面列到的一些内容
+你的PR在核心成员review后，合并到主分支
+谢谢！
+-->
+
+### 🤔 这个分支是...
+
+- [ ] 新功能
+- [ ] Bug fix
+- [ ] Ts 类型更新
+- [ ] 打包优化
+- [ ] 性能优化
+- [ ] 功能增强
+- [ ] 重构
+- [ ] 依赖版本更新
+- [ ] 代码优化
+- [ ] 测试 case 更新
+- [ ] 分支合并
+- [ ] 发布
+- [ ] 网站/文档更新
+- [ ] demo 更新
+- [ ] Workflow
+- [ ] 其他 (具体是什么，请补充?)
+
+### 🔗 相关 issue 链接
+
+<!--
+1. 相关的issue或者讨论，请贴在这里.
+2. close #xxxx or fix #xxxx for instance.
+-->
+
+### 🔗 相关的 PR 链接
+
+<!-- 如果有关联的其他项目 PR，请贴在这里 -->
+
+### 🐞 Bugserver 用例 id
+
+<!-- 将 bugserver case 上的 `fileid` 字段值黏贴过来 -->
+
+### 💡 问题的背景&解决方案
+
+<!--
+1. 描述问题和场景
+2. 如果包含UI/交互相关的修改，请提供GIF或者截图
+3. 提供如何解决问题的，如果是开发新的功能，请提供最终的API实现和使用案例
+-->
+
+### ☑️ 自测
+
+⚠️ 在提交 PR 之前，请检查一下内容. ⚠️
+
+- [ ] 文档提供了，或者更新，或者不需要
+- [ ] Demo 提供了，或者更新，或者不需要
+- [ ] Ts 类型定义提供了，或者更新，或者不需要
+- [ ] Changelog 提供了，或者不需要

.github/workflows/test.yml

@@ -0,0 +1,69 @@
+# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
+
+name: TEST CI
+
+on:
+  push:
+    branches: ['main', 'develop']
+  pull_request:
+    branches: ['main', 'develop', 'dev/**']
+
+jobs:
+  unit-test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run unit tests
+        run: pnpm --filter @visactor/vseed test:unit
+
+  integration-test:
+    name: Integration Tests
+    runs-on: macos-13
+
+    strategy:
+      matrix:
+        node-version: [18.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run integration tests
+        run: pnpm --filter @visactor/vseed test:integration

.vscode/settings.json

@@ -17,5 +17,16 @@
   "[json]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
-  "cSpell.words": ["catmull", "duckdb", "Introspector", "Kysely", "permille", "preorder", "rsdoctor", "vquery", "vseed"]
+  "cSpell.words": [
+    "catmull",
+    "duckdb",
+    "Introspector",
+    "Kysely",
+    "permille",
+    "preorder",
+    "rsdoctor",
+    "VBIDSL",
+    "vquery",
+    "vseed"
+  ]
 }

README.md

@@ -3,7 +3,7 @@
 VSeed, an elegant data composer, transforming complexity into simplicity.
 
 [![npm Version](https://img.shields.io/npm/v/@visactor/vseed.svg)](https://www.npmjs.com/package/@visactor/vseed)
-[![Coverage](https://img.shields.io/badge/Coverage-90.04%25-brightgreen.svg)](https://github.com/VisActor/VSeed/actions/workflows/coverage.yml)
+[![Coverage](https://img.shields.io/badge/Coverage-89.59%25-green.svg)](https://github.com/VisActor/VSeed/actions/workflows/coverage.yml)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/VisActor/VSeed)
 [![Changesets](https://github.com/VisActor/VSeed/actions/workflows/changesets.yml/badge.svg)](https://github.com/VisActor/VSeed/actions/workflows/changesets.yml)
 [![Deploy to GitHub Pages](https://github.com/VisActor/VSeed/actions/workflows/deploy.yml/badge.svg)](https://visactor.github.io/VSeed/)

apps/website/docs/zh-CN/_meta.json

@@ -22,19 +22,7 @@
   {
     "text": "Playground",
     "link": "/playground/vseed",
-    "activeMatch": "/playground",
-    "items": [
-      {
-        "link": "/playground/vseed",
-        "text": "VSeed",
-        "activeMatch": "/playground/vseed"
-      },
-      {
-        "link": "/playground/vquery",
-        "text": "VQuery",
-        "activeMatch": "/playground/vquery"
-      }
-    ]
+    "activeMatch": "/playground"
   },
   {
     "text": "了解VChart",

apps/website/docs/zh-CN/development/devProgress/tests.md

@@ -16,9 +16,53 @@
 鼓励用多个小的commit, 代替一个大的commit, 否则快照变化会庞大到无法review
 :::
 
-## 测试用例
+## 测试分类
 
-在目录`packages/vseed/tests`内包含所有的测试用例
+VSeed 的测试分为两类：
+
+### 单元测试（Unit Tests）
+
+位于 `packages/vseed/tests/unit/` 目录下，针对独立函数、工具类、管道函数等进行单元级别的测试。
+
+**特点：**
+- 测试粒度细，专注单一功能
+- 运行速度快
+- 无需依赖完整的 VSeed 配置
+- 易于定位问题
+
+**运行命令：**
+```bash
+# 运行所有单元测试
+pnpm test:unit
+
+# 运行单元测试并生成覆盖率报告
+pnpm test:unit:coverage
+```
+
+### 集成测试（Integration Tests）
+
+位于 `packages/vseed/tests/integration` 目录下，基于完整的 VSeed 配置进行端到端测试。
+
+**特点：**
+- 测试完整的数据流转和图表生成
+- 通过快照验证最终输出
+- 覆盖真实使用场景
+
+**运行命令：**
+```bash
+# 运行所有集成测试
+pnpm test:integration
+
+# 运行集成测试并更新快照
+pnpm test:integration:update
+
+# 运行集成测试并生成覆盖率报告
+pnpm test:integration:coverage
+```
+
+## 集成测试用例
+
+在目录`packages/vseed/tests/integration`内包含所有的集成测试用例
 - 每个用例是一个`json`文件, 包含一个完整的 `vseed` 配置
 - 每个`json`文件的文件名即为测试用例的名称
 - 每个 `*.test.ts` 文件均为自动生成, 请勿手动维护
@@ -28,6 +72,27 @@
 仅维护 `json`配置, 极大的提升测试用例的可维护性, 并降低测试用例的编写成本
 :::
 
+## 单元测试用例
+
+在目录 `packages/vseed/tests/unit/` 内包含所有的单元测试用例
+- 每个测试文件手动编写，针对特定函数或模块
+- 测试文件命名为 `*.test.ts`
+- 使用 Vitest 测试框架
+- 专注于测试独立功能，不依赖完整配置
+
+**目录结构：**
+```
+tests/unit/
+├── pipes/          # 管道函数测试
+│   └── dual/
+│       └── dualChartType.test.ts
+└── utils/          # 工具函数测试
+    ├── checkVSeed.test.ts
+    ├── createFormatterByMeasure.test.ts
+    ├── findFunctions.test.ts
+    └── measures.test.ts
+```
+
 ## build:test
 
 根据每一个`vseed`, 生成测试用例, 每个用例包含`spec` 和 `advancedVseed` 的快照
@@ -51,7 +116,14 @@ pnpm run build:canvasTest
 运行测试并生成覆盖率报告后, 会自动生成覆盖率徽章到README.md文件, 并打开覆盖率报告页面
 
 ```bash
+# 所有测试的覆盖率
 pnpm test:coverage
+
+# 仅单元测试的覆盖率
+pnpm test:unit:coverage
+
+# 仅集成测试的覆盖率
+pnpm test:integration:coverage
 ```
 
 - **HTML 报告**: `packages/vseed/coverage/index.html`
@@ -64,4 +136,17 @@ pnpm test:coverage
 ```bash title="source: scripts/build-coverage-badge.mjs"
 https://img.shields.io/badge/Coverage-{percentage}%-{color}.svg
 ```
-:::
+:::
+
+## 测试命令总览
+
+| 命令 | 说明 |
+|------|------|
+| `pnpm test` | 运行所有测试（单元测试 + 集成测试） |
+| `pnpm test:unit` | 仅运行单元测试 |
+| `pnpm test:unit:coverage` | 运行单元测试并生成覆盖率报告 |
+| `pnpm test:integration` | 仅运行集成测试 |
+| `pnpm test:integration:update` | 运行集成测试并更新快照 |
+| `pnpm test:integration:coverage` | 运行集成测试并生成覆盖率报告 |
+| `pnpm test:update` | 运行所有测试并更新快照 |
+| `pnpm test:coverage` | 运行所有测试并生成覆盖率报告 |