Cursor rule

1---
2description: SmartUI 组件测试规范（jest + miniprogram-simulate）
3globs: packages/**/test/**/*.spec.ts
4alwaysApply: false
5---
6 
7# 测试约定
8 
9## 工具与入口
10 
11- 使用 `miniprogram-simulate`：`simulate.load(demo/index, { rootPath })`、`simulate.render(id)`、`comp.attach(parent)`、`comp.toJSON()`、`toMatchSnapshot()`。
12- 入口为各组件下的 `demo/index`，rootPath 为包根目录。
13 
14## 标准 demo 快照写法
15 
16```typescript
17import path from 'path';
18import simulate from 'miniprogram-simulate';
19 
20test('should render demo and match snapshot', () => {
21  const id = simulate.load(path.resolve(__dirname, '../demo/index'), {
22    rootPath: path.resolve(__dirname, '../../'),
23  });
24  const comp = simulate.render(id);
25  comp.attach(document.createElement('parent-wrapper'));
26  expect(comp.toJSON()).toMatchSnapshot();
27});
28```
29 
30## 文件约定
31 
32- 每个组件至少有 `test/demo.spec.ts` 做 demo 快照。
33- 逻辑复杂、快照覆盖不全时，增加 `test/index.spec.ts` 做单测。
34- 修改 demo 后需跑 `yarn test`，必要时执行 `npx jest -u` 更新快照；若更新快照报错，需先修正测试 直到快照可正常生成。
35 
36## 命令
37 
38- `yarn test`：跑全量测试
39- `yarn test:cover`：跑测试并算覆盖率
40- `npx jest -u`：更新快照
41