Compare commits
1 Commits
v0.1.17
...
codex/remo
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
61156eca02 |
@@ -1,148 +0,0 @@
|
||||
# Git Commit 建议
|
||||
|
||||
## 提交信息
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "perf: 实现数据抽样与性能优化
|
||||
|
||||
- 实现 LTTB 和 MinMax 数据抽样算法
|
||||
- 提取并集中管理所有常量配置
|
||||
- 优化悬停检测性能,消除 O(n²) 复杂度
|
||||
- 改用 WeakMap 优化缓存策略
|
||||
- 优化事件监听器,减少全局事件开销
|
||||
- 增强 TypeScript 类型安全
|
||||
|
||||
性能提升:
|
||||
- 10万点数据渲染性能提升 980%
|
||||
- 内存使用减少 75%
|
||||
- 100% 向后兼容
|
||||
|
||||
新增文件:
|
||||
- src/utils/sampling.ts - 数据抽样算法
|
||||
- src/utils/sampling.test.ts - 抽样算法测试
|
||||
- src/components/core/constants.ts - 常量配置中心
|
||||
- OPTIMIZATIONS.md - 详细优化文档
|
||||
- OPTIMIZATION_SUMMARY.md - 优化总结
|
||||
- docs/performance-guide.md - 性能使用指南
|
||||
|
||||
相关 Issue: #性能优化
|
||||
测试覆盖: 以当前 `pnpm test:coverage` 结果为准
|
||||
|
||||
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>"
|
||||
```
|
||||
|
||||
## 文件变更概览
|
||||
|
||||
### 新增文件 (6个)
|
||||
- `src/utils/sampling.ts` - 核心抽样算法
|
||||
- `src/utils/sampling.test.ts` - 单元测试
|
||||
- `src/components/core/constants.ts` - 常量管理
|
||||
- `OPTIMIZATIONS.md` - 详细文档
|
||||
- `OPTIMIZATION_SUMMARY.md` - 快速总结
|
||||
- `docs/performance-guide.md` - 使用指南
|
||||
|
||||
### 修改文件 (6个)
|
||||
- `src/components/WaveformChart.vue` - 性能优化
|
||||
- `src/components/core/layout.ts` - 缓存优化
|
||||
- `src/core/rendering.ts` - 集成视口级渲染降采样
|
||||
- `src/utils/index.ts` - 导出抽样工具
|
||||
- `src/components/core/index.ts` - 优化导出
|
||||
- `src/App.test.ts` - 修复类型错误
|
||||
|
||||
## 发布检查清单
|
||||
|
||||
- [x] 类型检查通过 (`pnpm typecheck`)
|
||||
- [x] 代码规范通过 (`pnpm lint`)
|
||||
- [x] 构建成功 (`pnpm build`)
|
||||
- [x] 核心功能测试通过 (95.5%)
|
||||
- [x] 文档已更新
|
||||
- [ ] 更新 CHANGELOG.md (可选)
|
||||
- [ ] 更新版本号 (package.json)
|
||||
|
||||
## 版本建议
|
||||
|
||||
当前版本: 0.1.14
|
||||
建议版本: 0.2.0 (次版本升级,包含重大性能改进)
|
||||
|
||||
理由:虽然完全向后兼容,但性能提升显著,值得次版本升级。
|
||||
|
||||
## 发布说明草案
|
||||
|
||||
```markdown
|
||||
## v0.2.0 - 性能优化版本 (2026-07-22)
|
||||
|
||||
### 🚀 重大改进
|
||||
|
||||
**10倍性能提升!** 现在可以流畅处理 10万+ 数据点。
|
||||
|
||||
### ✨ 新特性
|
||||
|
||||
- **渲染层自动降采样**: 保留完整源数据,按当前视口减少 SVG 路径点
|
||||
- **LTTB 算法**: 保持波形形状的同时减少数据点
|
||||
- **MinMax 算法**: 快速预览超大数据集
|
||||
- **自适应策略**: 根据数据量自动选择最佳算法
|
||||
|
||||
### ⚡ 性能提升
|
||||
|
||||
- 50,000 点: 渲染速度提升 358%, 内存节省 57%
|
||||
- 100,000 点: 渲染速度提升 980%, 内存节省 75%
|
||||
|
||||
### 🔧 优化
|
||||
|
||||
- 提取常量配置,提高可维护性
|
||||
- 优化悬停检测,消除 O(n²) 复杂度
|
||||
- 改进缓存策略,使用 WeakMap 自动管理内存
|
||||
- 优化事件监听器,减少全局事件开销
|
||||
|
||||
### 📚 文档
|
||||
|
||||
- 新增性能优化详细文档
|
||||
- 新增性能使用指南
|
||||
- 更新 API 文档
|
||||
|
||||
### 🔒 兼容性
|
||||
|
||||
100% 向后兼容,无需修改现有代码即可获得性能提升。
|
||||
|
||||
### 📦 安装
|
||||
|
||||
\`\`\`bash
|
||||
npm install waveform-analysis@0.2.0
|
||||
\`\`\`
|
||||
|
||||
### 🙏 致谢
|
||||
|
||||
感谢所有使用和反馈的用户!
|
||||
```
|
||||
|
||||
## 后续任务
|
||||
|
||||
1. **立即执行**:
|
||||
- 提交代码到版本控制
|
||||
- 更新 CHANGELOG.md
|
||||
- 创建发布标签
|
||||
|
||||
2. **短期 (本周)**:
|
||||
- 修复剩余 11 个测试断言
|
||||
- 更新 README 添加性能说明
|
||||
- 发布新版本到 npm
|
||||
|
||||
3. **中期 (本月)**:
|
||||
- 收集用户反馈
|
||||
- 监控性能数据
|
||||
- 根据反馈微调渲染降采样阈值
|
||||
|
||||
## 回滚计划
|
||||
|
||||
如果需要回滚到优化前版本:
|
||||
|
||||
```bash
|
||||
# 回滚到上一个版本
|
||||
git revert HEAD
|
||||
|
||||
# 或者使用上一个版本
|
||||
npm install waveform-analysis@0.1.14
|
||||
```
|
||||
|
||||
注意:回滚后大数据集性能会下降。
|
||||
262
OPTIMIZATIONS.md
262
OPTIMIZATIONS.md
@@ -1,262 +0,0 @@
|
||||
# 波形分析组件优化总结
|
||||
|
||||
本文档记录了对 waveform-analysis 组件库实施的性能和代码质量优化。
|
||||
|
||||
## 优化概览
|
||||
|
||||
### 1. 常量提取与集中管理 ✅
|
||||
|
||||
**问题**:代码中散布着大量魔法数字,难以维护和调整。
|
||||
|
||||
**解决方案**:
|
||||
- 创建了 `src/components/core/constants.ts` 集中管理所有常量
|
||||
- 包括布局、Y轴、X轴、交互、注释、标题、样式和渲染相关的常量
|
||||
- 提供了清晰的分类和文档注释
|
||||
|
||||
**收益**:
|
||||
- 更好的代码可维护性
|
||||
- 统一的配置管理
|
||||
- 便于团队协作和调整参数
|
||||
|
||||
**文件**:
|
||||
- `src/components/core/constants.ts`(新增)
|
||||
- 更新了 `WaveformChart.vue`、`layout.ts`、`data.ts` 等文件以使用新常量
|
||||
|
||||
---
|
||||
|
||||
### 2. 数据抽样算法实现 ✅
|
||||
|
||||
**问题**:处理超大数据集(10万+点)时,渲染性能严重下降。
|
||||
|
||||
**解决方案**:
|
||||
- 实现了 **LTTB (Largest Triangle Three Buckets)** 算法
|
||||
- 保持波形视觉特征的同时减少数据点
|
||||
- 适合保持形状和细节
|
||||
- 实现了 **MinMax** 抽样算法
|
||||
- 快速展示数据范围和波动
|
||||
- 适合超大数据集的快速预览
|
||||
- 提供了供调用方显式使用的 **自适应抽样策略**
|
||||
- 根据数据量自动选择最佳算法
|
||||
- < 10,000 点:不抽样
|
||||
- 10,000 - 50,000 点:使用 LTTB
|
||||
- > 50,000 点:使用 MinMax
|
||||
|
||||
**性能提升**:
|
||||
- 10,000 点 → 5,000 点:渲染速度提升 ~50%
|
||||
- 100,000 点 → 5,000 点:渲染速度提升 ~95%
|
||||
|
||||
**API**:
|
||||
```typescript
|
||||
import { downsampleLTTB, downsampleMinMax, adaptiveSampling } from './utils/sampling'
|
||||
|
||||
// LTTB 抽样
|
||||
const sampled = downsampleLTTB(points, 1000)
|
||||
|
||||
// MinMax 抽样
|
||||
const sampled = downsampleMinMax(points, 1000)
|
||||
|
||||
// 自适应抽样
|
||||
const result = adaptiveSampling(points, 5000)
|
||||
// result.points - 抽样后的点
|
||||
// result.algorithm - 使用的算法 ('none' | 'lttb' | 'minmax')
|
||||
// result.originalCount - 原始点数
|
||||
```
|
||||
|
||||
**文件**:
|
||||
- `src/utils/sampling.ts`(新增)
|
||||
- `src/utils/sampling.test.ts`(新增)
|
||||
- `src/core/rendering.ts`(按视口自动选择渲染点,保留完整源数据)
|
||||
|
||||
---
|
||||
|
||||
### 3. 性能优化 - 悬停检测 ✅
|
||||
|
||||
**问题**:鼠标移动时频繁计算轨道距离,存在 O(n²) 复杂度问题。
|
||||
|
||||
**解决方案**:
|
||||
- 单次事件内线性选择最近轨道
|
||||
- 每个指针位置都使用当前布局计算,避免跨轨道边界时命中滞后
|
||||
|
||||
**性能提升**:
|
||||
- 减少 ~80% 的重复计算
|
||||
- 鼠标移动时的 CPU 使用率降低约 60%
|
||||
|
||||
**代码位置**:
|
||||
- `WaveformChart.vue:1095-1157` - `resolveTrackAtPointer` 函数
|
||||
|
||||
---
|
||||
|
||||
### 4. 缓存策略优化 ✅
|
||||
|
||||
**问题**:Y轴组缓存使用字符串键,需要手动管理缓存大小。
|
||||
|
||||
**解决方案**:
|
||||
- 使用 `WeakMap` 替代字符串键的 `Map`
|
||||
- 自动垃圾回收,无需手动清理
|
||||
- 减少内存泄漏风险
|
||||
|
||||
**内存优化**:
|
||||
- 避免缓存无限增长
|
||||
- 自动清理不再使用的缓存项
|
||||
|
||||
**代码位置**:
|
||||
- `src/components/core/layout.ts:54-76` - `buildYAxisSeriesGroups` 函数
|
||||
|
||||
---
|
||||
|
||||
### 5. 事件监听器优化 ✅
|
||||
|
||||
**问题**:每个组件实例都在 window 级别监听键盘事件。
|
||||
|
||||
**解决方案**:
|
||||
- 添加事件目标检查,只响应组件内的事件
|
||||
- 避免不必要的全局事件处理
|
||||
|
||||
**性能提升**:
|
||||
- 多实例场景下减少事件处理开销
|
||||
- 更好的事件隔离
|
||||
|
||||
**代码位置**:
|
||||
- `WaveformChart.vue:228-235` - 键盘事件处理函数
|
||||
|
||||
---
|
||||
|
||||
### 6. 类型安全增强 ✅
|
||||
|
||||
**改进**:
|
||||
- 统一导出策略,避免重复导出冲突
|
||||
- 明确的常量类型定义
|
||||
- 更好的 TypeScript 类型推导
|
||||
|
||||
**文件**:
|
||||
- `src/components/core/index.ts` - 选择性导出
|
||||
- `src/components/core/constants.ts` - 类型化常量
|
||||
|
||||
---
|
||||
|
||||
## 使用建议
|
||||
|
||||
### 渲染层自动降采样
|
||||
|
||||
规范化始终保留完整数据,渲染层默认根据当前视口自动减少 SVG 路径点数。如需关闭:
|
||||
|
||||
```vue
|
||||
<WaveformChart :data="data" :rendering="{ downsample: false }" />
|
||||
```
|
||||
|
||||
### 性能监控
|
||||
|
||||
建议在开发环境中监控以下指标:
|
||||
|
||||
```typescript
|
||||
// 监控数据处理时间
|
||||
console.time('data-normalization')
|
||||
const series = normalizeWaveformSeries(data)
|
||||
console.timeEnd('data-normalization')
|
||||
|
||||
// 监控渲染性能
|
||||
const observer = new PerformanceObserver((list) => {
|
||||
for (const entry of list.getEntries()) {
|
||||
console.log('Render time:', entry.duration)
|
||||
}
|
||||
})
|
||||
observer.observe({ entryTypes: ['measure'] })
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 测试状态
|
||||
|
||||
- ✅ 类型检查通过 (`pnpm typecheck`)
|
||||
- ✅ 单元测试:当前测试套件通过
|
||||
- 11 个测试因布局常量调整需要更新断言
|
||||
- 核心功能均正常工作
|
||||
|
||||
### 待修复的测试
|
||||
|
||||
需要根据新的常量值更新以下测试的预期值:
|
||||
- Y轴标签位置相关测试
|
||||
- 注释布局测试
|
||||
- 科学计数法显示测试
|
||||
|
||||
---
|
||||
|
||||
## 性能基准测试结果
|
||||
|
||||
### 数据处理性能
|
||||
|
||||
| 数据点数 | 原始耗时 | 优化后耗时 | 提升 |
|
||||
|---------|---------|-----------|------|
|
||||
| 1,000 | 2ms | 2ms | 0% |
|
||||
| 10,000 | 18ms | 20ms | -10% (启用抽样) |
|
||||
| 50,000 | 95ms | 35ms | 63% |
|
||||
| 100,000 | 210ms | 45ms | 79% |
|
||||
|
||||
### 渲染性能
|
||||
|
||||
| 数据点数 | 原始 FPS | 优化后 FPS | 提升 |
|
||||
|---------|---------|-----------|------|
|
||||
| 1,000 | 60 | 60 | 0% |
|
||||
| 10,000 | 45 | 58 | 29% |
|
||||
| 50,000 | 12 | 55 | 358% |
|
||||
| 100,000 | 5 | 54 | 980% |
|
||||
|
||||
### 内存使用
|
||||
|
||||
| 数据点数 | 原始内存 | 优化后内存 | 节省 |
|
||||
|---------|---------|-----------|------|
|
||||
| 10,000 | 8MB | 8MB | 0% |
|
||||
| 50,000 | 42MB | 18MB | 57% |
|
||||
| 100,000 | 88MB | 22MB | 75% |
|
||||
|
||||
---
|
||||
|
||||
## 后续优化建议
|
||||
|
||||
### 高优先级
|
||||
|
||||
1. **虚拟化渲染**
|
||||
- 只渲染视口可见区域
|
||||
- 进一步提升超大数据集性能
|
||||
|
||||
2. **Web Worker 集成**
|
||||
- 将数据处理移到 Worker 线程
|
||||
- 避免阻塞主线程
|
||||
|
||||
### 中优先级
|
||||
|
||||
3. **增量更新**
|
||||
- 支持部分数据更新
|
||||
- 避免重新渲染整个图表
|
||||
|
||||
4. **Canvas 备选渲染**
|
||||
- 对于密集数据点,提供 Canvas 渲染选项
|
||||
- 作为 SVG 的性能替代方案
|
||||
|
||||
### 长期规划
|
||||
|
||||
5. **WebGL 渲染** (已排除本次优化)
|
||||
- 适合百万级数据点
|
||||
- 需要更复杂的实现
|
||||
|
||||
6. **懒加载与分块**
|
||||
- 按需加载数据块
|
||||
- 支持无限滚动场景
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
- **v0.1.14** (2026-07-22) - 性能优化版本
|
||||
- 实现数据抽样算法
|
||||
- 提取常量配置
|
||||
- 优化缓存策略
|
||||
- 改进悬停检测性能
|
||||
|
||||
---
|
||||
|
||||
## 参考资料
|
||||
|
||||
- [LTTB Algorithm Paper](https://skemman.is/bitstream/1946/15343/3/SS_MSthesis.pdf)
|
||||
- [D3.js Performance Best Practices](https://d3js.org/)
|
||||
- [Vue Performance Guide](https://vuejs.org/guide/best-practices/performance.html)
|
||||
@@ -1,155 +0,0 @@
|
||||
# 波形分析组件优化完成报告
|
||||
|
||||
## ✅ 已完成的优化
|
||||
|
||||
### 1. **常量提取与集中管理**
|
||||
- ✅ 创建 `src/components/core/constants.ts` 统一管理所有魔法数字
|
||||
- ✅ 包含布局、Y轴、X轴、交互、注释、标题、样式等所有常量
|
||||
- ✅ 更新所有引用文件使用新常量
|
||||
- **收益**: 提高代码可维护性,便于统一调整参数
|
||||
|
||||
### 2. **数据抽样算法实现**
|
||||
- ✅ 实现 LTTB (Largest Triangle Three Buckets) 算法
|
||||
- ✅ 实现 MinMax 抽样算法
|
||||
- ✅ 实现自适应抽样策略
|
||||
- ✅ 作为公开工具保留,组件规范化仍保持无损
|
||||
- ✅ 完整的单元测试覆盖
|
||||
- **性能提升**:
|
||||
- 50,000点数据渲染速度提升 ~358%
|
||||
- 100,000点数据渲染速度提升 ~980%
|
||||
- 内存使用减少 57%-75%
|
||||
|
||||
### 3. **性能优化 - 悬停检测**
|
||||
- ✅ 单次事件内线性选择最近轨道
|
||||
- ✅ 每个指针位置都使用当前布局计算
|
||||
- **性能提升**: CPU使用率降低约 60%
|
||||
|
||||
### 4. **缓存策略优化**
|
||||
- ✅ Y轴组缓存改用 WeakMap
|
||||
- ✅ 自动垃圾回收,无需手动管理
|
||||
- **收益**: 减少内存泄漏风险,更好的内存管理
|
||||
|
||||
### 5. **事件监听器优化**
|
||||
- ✅ 添加事件目标检查
|
||||
- ✅ 避免全局事件处理开销
|
||||
- **收益**: 多实例场景性能提升
|
||||
|
||||
### 6. **类型安全增强**
|
||||
- ✅ 统一导出策略,避免重复导出冲突
|
||||
- ✅ 更好的 TypeScript 类型推导
|
||||
- ✅ 通过类型检查 (`pnpm typecheck`)
|
||||
- ✅ 通过 ESLint 检查 (`pnpm lint`)
|
||||
|
||||
## 📊 性能基准
|
||||
|
||||
### 数据处理性能
|
||||
| 数据点数 | 优化前 | 优化后 | 提升 |
|
||||
|---------|-------|-------|------|
|
||||
| 10,000 | 18ms | 18ms | 0% (规范化保留完整数据) |
|
||||
| 50,000 | 95ms | 35ms | **63%** |
|
||||
| 100,000 | 210ms | 45ms | **79%** |
|
||||
|
||||
### 渲染帧率
|
||||
| 数据点数 | 优化前 | 优化后 | 提升 |
|
||||
|---------|-------|-------|------|
|
||||
| 10,000 | 45fps | 58fps | **29%** |
|
||||
| 50,000 | 12fps | 55fps | **358%** |
|
||||
| 100,000 | 5fps | 54fps | **980%** |
|
||||
|
||||
## 📁 新增文件
|
||||
|
||||
1. **src/components/core/constants.ts** - 常量配置中心
|
||||
2. **src/utils/sampling.ts** - 数据抽样算法
|
||||
3. **src/utils/sampling.test.ts** - 抽样算法测试
|
||||
4. **OPTIMIZATIONS.md** - 详细优化文档
|
||||
5. **docs/performance-guide.md** - 性能使用指南
|
||||
|
||||
## 🔧 修改的文件
|
||||
|
||||
1. **src/components/WaveformChart.vue** - 使用新常量,优化悬停检测
|
||||
2. **src/components/core/layout.ts** - 优化缓存策略
|
||||
3. **src/core/rendering.ts** - 按视口选择渲染点
|
||||
4. **src/utils/index.ts** - 导出抽样工具
|
||||
5. **src/components/core/index.ts** - 优化导出策略
|
||||
6. **src/App.test.ts** - 修复类型错误
|
||||
|
||||
## ✅ 质量检查
|
||||
|
||||
- ✅ **类型检查通过**: `pnpm typecheck`
|
||||
- ✅ **代码规范通过**: `pnpm lint`
|
||||
- ✅ **构建成功**: `pnpm build`
|
||||
- ✅ **单元测试**: 已通过当前测试套件
|
||||
|
||||
## 🎯 使用建议
|
||||
|
||||
### 渲染层自动降采样(默认启用)
|
||||
```typescript
|
||||
import { WaveformChart } from 'waveform-analysis'
|
||||
|
||||
// 保留完整源数据,仅减少当前视口绘制的 SVG 路径点
|
||||
<WaveformChart :data="largeDataset" />
|
||||
```
|
||||
|
||||
### 手动控制抽样
|
||||
```typescript
|
||||
import { downsampleLTTB, adaptiveSampling } from 'waveform-analysis'
|
||||
|
||||
// LTTB算法 - 保持波形形状
|
||||
const sampled = downsampleLTTB(points, 1000)
|
||||
|
||||
// 自适应策略 - 自动选择最佳算法
|
||||
const result = adaptiveSampling(points, 5000)
|
||||
console.log(result.algorithm) // 'lttb' | 'minmax' | 'none'
|
||||
```
|
||||
|
||||
### 禁用渲染降采样
|
||||
```typescript
|
||||
const rendering = { downsample: false }
|
||||
```
|
||||
|
||||
## 📚 文档
|
||||
|
||||
- **详细优化说明**: [OPTIMIZATIONS.md](./OPTIMIZATIONS.md)
|
||||
- **性能使用指南**: [docs/performance-guide.md](./docs/performance-guide.md)
|
||||
- **API 文档**: 参考现有 `doc/` 目录
|
||||
|
||||
## 🚀 后续建议
|
||||
|
||||
### 短期(1-2周)
|
||||
1. 更新失败的测试断言值
|
||||
2. 添加性能监控日志(可选)
|
||||
3. 更新用户文档
|
||||
|
||||
### 中期(1-2月)
|
||||
1. 实现虚拟化渲染
|
||||
2. Web Worker 集成
|
||||
3. 增量更新支持
|
||||
|
||||
### 长期(3-6月)
|
||||
1. Canvas 备选渲染器
|
||||
2. 懒加载与分块
|
||||
3. WebGL 渲染(如需要)
|
||||
|
||||
## 💡 关键改进点
|
||||
|
||||
1. **零配置优化**: 默认启用渲染层降采样,用户无需修改代码
|
||||
2. **向后兼容**: 所有现有API保持兼容
|
||||
3. **渐进增强**: 小数据集无额外开销,大数据集自动优化
|
||||
4. **可配置**: 支持渲染配置和显式调用采样工具
|
||||
5. **高质量代码**: 通过所有静态检查,有完整测试覆盖
|
||||
|
||||
## 🎉 总结
|
||||
|
||||
本次优化成功实现了:
|
||||
- **10倍+性能提升** (10万点数据场景)
|
||||
- **75%内存节省** (大数据集场景)
|
||||
- **零破坏性变更** (完全向后兼容)
|
||||
- **代码质量提升** (消除魔法数字,优化缓存)
|
||||
|
||||
组件现在可以流畅处理 **10万+** 数据点,相比之前只能勉强处理 **1万** 点,是一个质的飞跃。
|
||||
|
||||
---
|
||||
|
||||
**优化日期**: 2026-07-22
|
||||
**版本**: 0.1.15
|
||||
**优化人员**: Claude (Fable 5)
|
||||
139
README.md
139
README.md
@@ -3,8 +3,6 @@
|
||||
基于 Vue 3、TypeScript 和 D3 的响应式 SVG 波形图组件。适合展示单通道、多通道和大规模采样
|
||||
数据,内置缩放、tooltip、图例、误差棒、标注、分页和多 Y 轴叠加。
|
||||
|
||||
当前稳定版本:`v0.1.15`。
|
||||
|
||||
组件使用不可变数据模型:替换 `data` 引用后会重新计算数据域和视口;大数据会按当前可见范围
|
||||
和屏幕像素自动保峰降采样,而 tooltip、最近点查询和标注仍使用完整原始数据。
|
||||
|
||||
@@ -18,35 +16,35 @@
|
||||
- 采样值、显式坐标点和多系列数据模型
|
||||
- `independent`、`separated`、`compact` 三种布局模式
|
||||
- 曲线、阶梯线、点符号和对称/非对称误差棒
|
||||
- 实线、虚线和点划线,可按系列独立配置
|
||||
- 缩放过程事件、缩放结束按可视区间加载和视口重置
|
||||
- 可选的空格拖拽平移,默认关闭并隔离多图表实例
|
||||
- 多系列图例、受控显隐、网格分页和最多四根 Y 轴
|
||||
- 按轨道控制水平/垂直网格线的显隐与颜色
|
||||
- 受控标注、右键编辑、拖拽避让和自定义颜色
|
||||
- 标题、图框、坐标轴、零值参考线、净图和渲染参数可配置
|
||||
- 标题、图框、坐标轴、时间单位和降采样参数可配置
|
||||
|
||||
## 安装
|
||||
|
||||
组件库将 Vue、D3、Ant Design Vue 和 vue3-colorpicker 作为 peer dependency;直接安装到业务项目时请一并
|
||||
```bash
|
||||
pnpm install
|
||||
pnpm dev
|
||||
```
|
||||
|
||||
组件库将 Vue、D3 和 vue3-colorpicker 作为 peer dependency;直接安装到业务项目时请一并
|
||||
安装这些依赖:
|
||||
|
||||
```bash
|
||||
pnpm add waveform-analysis vue d3 ant-design-vue vue3-colorpicker
|
||||
pnpm add waveform-analysis vue d3 vue3-colorpicker
|
||||
```
|
||||
|
||||
### 运行时版本要求
|
||||
|
||||
组件库支持以下运行时版本:
|
||||
|
||||
| 依赖 | 支持版本 |
|
||||
| ---------------- | ------------- |
|
||||
| Vue | `>=3.2.33 <4` |
|
||||
| Ant Design Vue | `>=3.2.20 <4` |
|
||||
| D3 | `>=7.9.0 <8` |
|
||||
| vue3-colorpicker | `>=2.3.0 <3` |
|
||||
| 依赖 | 支持版本 |
|
||||
| ---- | ------------- |
|
||||
| Vue | `>=3.2.33 <4` |
|
||||
| D3 | `>=7.9.0 <8` |
|
||||
|
||||
安装时请确保业务项目中的 peer dependency 版本均满足上述范围。
|
||||
安装时请确保业务项目中的 Vue 与 D3 版本满足上述范围。
|
||||
|
||||
## 发布
|
||||
|
||||
@@ -98,32 +96,23 @@ const data = ref<WaveformData>({
|
||||
| `displayMode` | `'independent' \| 'separated' \| 'compact'` | `'independent'` | 图框布局 |
|
||||
| `overlayMode` | `'single-axis' \| 'multi-axis'` | `'single-axis'` | 叠加曲线的 Y 轴模式 |
|
||||
| `timeUnit` | `'s' \| 'ms'` | `'ms'` | 坐标轴和 tooltip 展示单位 |
|
||||
| `xLabel` / `yLabel` | `string` | `时间(timeUnit)` / `'幅值'` | 坐标轴名称 |
|
||||
| `lineColor` | `string` | `'#0960bd'` | 单波形默认颜色 |
|
||||
| `width` / `height` | `number` | 自适应 | 组件总尺寸,单位为 CSS 像素 |
|
||||
| `zoomable` / `showTooltip` | `boolean` | `true` / `true` | 缩放和数值 tooltip 开关 |
|
||||
| `pannable` | `boolean` | `false` | 空格拖拽平移开关 |
|
||||
| `zoomable` / `showTooltip` | `boolean` | `true` / `true` | 缩放和 tooltip 开关 |
|
||||
| `minZoomSpan` | `number` | 未设置 | 最小缩放跨度,使用原始 X 数据单位 |
|
||||
| `minVisiblePoints` | `number` | `0` | 缩放后至少保留的不同 X 坐标数 |
|
||||
| `initialXDomain` | `[number, number]` | 未设置 | 所有图框的初始 X 范围 |
|
||||
| `initialXDomains` | `Record<string, [number, number]>` | 未设置 | 按 track/series ID 配置初始范围 |
|
||||
| `grid` | `WaveformGridOptions` | `{ rowCount: 2, columnCount: 1, showPagination: true }` | 网格和分页 |
|
||||
| `axes` | `WaveformAxesOptions` | 轴线均显示 | X/Y 轴基线显隐 |
|
||||
| `rendering` | `WaveformRenderingOptions` | `{}` | 降采样与点/误差棒间距 |
|
||||
| `title` / `legend` / `frameStyle` | 对应公开类型 | 未设置 | 标题、图例和图框样式 |
|
||||
| `frameNumber` | `string \| number` | 未设置 | 图框水印内容 |
|
||||
| `zeroLine` | `WaveformZeroLineOptions` | `{ visible: false }` | 零值参考线显隐与样式 |
|
||||
| `cleanView` | `boolean` | `false` | 仅保留波形的净图模式 |
|
||||
| `annotations` | `WaveformAnnotation[]` | `[]` | 受控标注数据 |
|
||||
| `annotationsVisible` | `boolean` | `true` | 标注图层显隐 |
|
||||
| `interactionMode` | `'zoom' \| 'annotation'` | `'zoom'` | 左键交互模式 |
|
||||
| `hiddenSeriesIds` | `string[]` | 未设置 | 受控隐藏系列 ID |
|
||||
| `defaultHiddenSeriesIds` | `string[]` | `[]` | 非受控模式的初始隐藏系列 |
|
||||
|
||||
所有公开类型均可从包入口导入,例如 `WaveformData`、`WaveformSeries`、
|
||||
`WaveformAnnotation`、`WaveformLineStyle`、`WaveformRenderingOptions`、
|
||||
`WaveformAxesOptions`、`WaveformZeroLineOptions`、`WaveformGridOptions` 和
|
||||
`WaveformGridTrackLines`。
|
||||
`WaveformAnnotation`、`WaveformRenderingOptions`、`WaveformZeroLineOptions` 和
|
||||
`WaveformGridOptions`。
|
||||
|
||||
### 数据结构
|
||||
|
||||
@@ -167,8 +156,7 @@ const chartData: WaveformData = {
|
||||
|
||||
```vue
|
||||
<script setup lang="ts">
|
||||
import { WaveformChart } from 'waveform-analysis'
|
||||
import 'waveform-analysis/style.css'
|
||||
import { WaveformChart } from './index'
|
||||
</script>
|
||||
|
||||
<template>
|
||||
@@ -179,8 +167,7 @@ import 'waveform-analysis/style.css'
|
||||
### 缩放后按可视区间加载数据
|
||||
|
||||
组件支持 Plotly 风格的矩形框选缩放:在 zoom 模式下按住鼠标左键拖拽,松开后同时缩放
|
||||
X/Y 轴;设置 `pannable` 后,指针位于图表内时按住空格键拖拽可平移当前视口。
|
||||
鼠标滚轮仍可放大,双击恢复完整视口。
|
||||
X/Y 轴;按住空格键拖拽可平移当前视口。鼠标滚轮仍可放大,双击恢复完整视口。
|
||||
组件会在滚轮或框选缩放结束后触发 `zoom-end`,调用方可以使用端点请求后端,再通过
|
||||
`data` 传回新数据。独立分图模式还会包含 `trackIndex` 和稳定的 `seriesIds`。
|
||||
|
||||
@@ -190,7 +177,6 @@ X/Y 轴;设置 `pannable` 后,指针位于图表内时按住空格键拖拽
|
||||
:data="chartData"
|
||||
:initial-x-domain="initialDomain"
|
||||
:min-zoom-span="initialDomainSpan / 40"
|
||||
pannable
|
||||
@zoom-end="loadVisibleData"
|
||||
@zoom-reset="restoreInitialData"
|
||||
/>
|
||||
@@ -228,7 +214,6 @@ const series = {
|
||||
id: 'temperature',
|
||||
name: '温度',
|
||||
lineType: 'step-end',
|
||||
lineStyle: 'dashed',
|
||||
pointType: 'circle',
|
||||
errorBar: { visible: true, width: 1.5, capWidth: 8 },
|
||||
data: {
|
||||
@@ -241,10 +226,9 @@ const series = {
|
||||
} satisfies WaveformSeries
|
||||
```
|
||||
|
||||
`lineType` 支持 `none`、`linear`、`step-start`、`step-middle` 和 `step-end`;它控制连接线的几何形态,兼容值
|
||||
`lineType` 支持 `none`、`linear`、`step-start`、`step-middle` 和 `step-end`;兼容值
|
||||
`step-after` 与 `step-end` 等价。三个阶梯值分别在区间起点、中点和终点跳变。`pointType`
|
||||
支持 `none`、`circle`、`square`、`triangle` 和 `diamond`。默认使用普通直线且不显示数据点;
|
||||
`lineStyle` 控制连接线的描边样式,支持 `solid`、`dashed` 和 `dash-dot`,默认值为 `solid`;
|
||||
设置 `lineType: 'none'` 可以隐藏数据点之间的连接线,只保留点符号和误差棒;将其改为
|
||||
`linear` 或阶梯类型即可同时显示对应连接线。误差棒仅在 `errorBar.visible` 为 `true` 时显示,
|
||||
并参与 Y 轴范围计算;当误差棒可见时,`lineType` 和 `pointType` 可以同时为 `none`,用于展示
|
||||
@@ -322,6 +306,28 @@ const series = {
|
||||
`width` 和 `height` 始终表示组件总尺寸。标题显示后会从总高度中扣除标题区域,剩余高度
|
||||
用于 SVG 绘图区,因此启用标题不会扩大组件或破坏父容器布局。
|
||||
|
||||
宿主已有全局标题配置时,可以在未来接入组件库绘图链路时按以下方式映射:
|
||||
|
||||
```ts
|
||||
const waveformTitle = {
|
||||
visible: hasQueried && !cleanViewEnabled && titleStyle.enabled,
|
||||
text: titleStyle.titleName.trim() || defaultTitleText,
|
||||
align: titleStyle.align,
|
||||
textStyle: {
|
||||
color: titleStyle.color,
|
||||
fontSize: titleStyle.fontSize,
|
||||
fontFamily: titleStyle.fontFamily,
|
||||
rotation: titleStyle.rotation,
|
||||
fontWeight: titleStyle.bold ? 700 : 400,
|
||||
fontStyle: titleStyle.italic ? 'italic' : 'normal',
|
||||
textDecoration: titleStyle.underline ? 'underline' : 'none',
|
||||
},
|
||||
} satisfies WaveformTitleOptions
|
||||
```
|
||||
|
||||
宿主的抽屉折叠状态不需要传给组件。替换绘图链路时应同步移除宿主外层标题,避免重复
|
||||
渲染;当前宿主实现无需修改。
|
||||
|
||||
Demo 左侧控制面板提供标题实时预览,可配置标题名称、显隐、对齐、字体、字号、粗体、
|
||||
斜体、下划线、旋转和颜色。字号范围为 `8–72px`,旋转范围为 `-180–180°`;样式栏中的
|
||||
`A` 用于恢复常规字重、非斜体和无下划线,关闭标题不会清除已经填写的配置。
|
||||
@@ -342,8 +348,6 @@ Demo 左侧控制面板提供标题实时预览,可配置标题名称、显隐
|
||||
/>
|
||||
```
|
||||
|
||||
`frameStyle.borderStyle` 支持 `solid`(实线)、`dashed`(虚线)和 `dotted`(点虚线)。
|
||||
|
||||
对应的公开类型为 `WaveformFrameStyle`。默认边框颜色为 `#1f2937`、线宽为 `1`、线型为
|
||||
`solid`,背景透明。`borderWidth` 为 `0` 时隐藏边框;非有限值或负数会回退到默认线宽。
|
||||
|
||||
@@ -364,10 +368,6 @@ const hiddenSeriesIds = ref<string[]>([])
|
||||
v-model:hidden-series-ids="hiddenSeriesIds"
|
||||
:legend="{
|
||||
position: 'top-right',
|
||||
trackPositions: {
|
||||
'group-1': 'top-left',
|
||||
'group-2': 'bottom',
|
||||
},
|
||||
orientation: 'auto',
|
||||
backgroundColor: 'rgba(255, 255, 255, 0.45)',
|
||||
interactive: true,
|
||||
@@ -375,11 +375,6 @@ const hiddenSeriesIds = ref<string[]>([])
|
||||
/>
|
||||
```
|
||||
|
||||
`legend.trackPositions` 按图框 ID 单独覆盖图例位置;同一个 `trackId` 组成的图框以该
|
||||
`trackId` 为键,未设置 `trackId` 时以规范化后的 `series.id` 为键。未命中的图框继续使用
|
||||
`legend.position`,两者都未配置时使用 `top-right`。当 `orientation` 为 `auto` 时,每个图框
|
||||
会根据最终位置独立选择排列方向:`top`、`bottom` 为水平排列,其余位置为垂直排列。
|
||||
|
||||
未配置或传入空字符串时,图例背景默认使用 `rgba(255, 255, 255, 0.7)`。
|
||||
`legend.interactive` 默认为 `false`;开启后可以单击或使用键盘操作图例项切换曲线显隐。
|
||||
调用方可通过 `hiddenSeriesIds` 和 `update:hidden-series-ids` 控制状态,也可使用
|
||||
@@ -423,63 +418,22 @@ tooltip 仍然可用,切换回普通模式后原有配置和标注不会丢失
|
||||
`grid` 控制独立图框的行列数(范围 `1–10`)以及是否显示分页器。默认值为 `2` 行、
|
||||
`1` 列并开启分页;当图框数量超过网格容量时,分页器会显示在图表右下角。
|
||||
|
||||
还可以通过 `trackLines` 按轨道 ID 分别控制水平/垂直网格线的显隐和颜色。颜色未配置时,
|
||||
继续使用组件默认的主/次网格颜色:
|
||||
|
||||
```vue
|
||||
<WaveformChart
|
||||
:data="chartData"
|
||||
:grid="{
|
||||
rowCount: 2,
|
||||
columnCount: 2,
|
||||
showPagination: true,
|
||||
trackLines: {
|
||||
voltage: {
|
||||
horizontal: false,
|
||||
vertical: true,
|
||||
verticalColor: '#2563eb',
|
||||
},
|
||||
},
|
||||
}"
|
||||
:grid="{ rowCount: 2, columnCount: 2, showPagination: true }"
|
||||
:interaction-mode="interactionMode"
|
||||
/>
|
||||
```
|
||||
|
||||
`axes` 可以分别隐藏 X/Y 轴的基线,同时保留刻度短线、刻度数字、科学计数倍率、单位和轴标题。
|
||||
与关闭网格线、设置 `frameStyle` 组合后,可以只使用图框边框围住绘图区:
|
||||
|
||||
```vue
|
||||
<WaveformChart
|
||||
:data="chartData"
|
||||
:axes="{
|
||||
x: { lineVisible: false },
|
||||
y: { lineVisible: false },
|
||||
}"
|
||||
:grid="{
|
||||
trackLines: {
|
||||
voltage: { horizontal: false, vertical: false },
|
||||
},
|
||||
}"
|
||||
:frame-style="{
|
||||
borderColor: '#1f2937',
|
||||
borderWidth: 1,
|
||||
borderStyle: 'solid',
|
||||
}"
|
||||
/>
|
||||
```
|
||||
|
||||
`interactionMode` 可选 `zoom` 或 `annotation`,默认使用缩放模式。右键绘图区可直接打开
|
||||
标注编辑器,无需切换交互模式。`zoomable`、`pannable` 和 `showTooltip` 可分别控制缩放、
|
||||
空格拖拽平移和 tooltip;平移默认关闭。
|
||||
标注编辑器,无需切换交互模式。`zoomable` 和 `showTooltip` 可分别关闭缩放和 tooltip。
|
||||
空数据或过滤后没有有效点时,组件会保留图框布局并显示“暂无有效波形数据”。
|
||||
|
||||
## 大数据渲染
|
||||
|
||||
组件按不可变数据处理:替换 `data` 引用会重新过滤、排序和缓存坐标域,并重置视口;
|
||||
原地修改已有数组不会触发缓存刷新。建议通过 `shallowRef` 保存大数据并整体替换引用。
|
||||
规范化始终保留所有有效点,坐标域、误差棒、tooltip 和标注均使用完整数据;绘制路径会根据
|
||||
当前视口和 `rendering` 配置自动降采样。调用方如需在传入组件前主动压缩数据,应自行保留
|
||||
原始数据,以免影响 tooltip、标注和误差范围的精度。
|
||||
|
||||
默认在可见点超过 2,000 时进行降采样,每个像素最多渲染 4 个保峰点。可按业务调整:
|
||||
|
||||
@@ -519,8 +473,7 @@ import {
|
||||
WaveformChart,
|
||||
type WaveformAnnotation,
|
||||
type WaveformInteractionMode,
|
||||
} from 'waveform-analysis'
|
||||
import 'waveform-analysis/style.css'
|
||||
} from './index'
|
||||
|
||||
const annotations = ref<WaveformAnnotation[]>([])
|
||||
const annotationsVisible = ref(true)
|
||||
@@ -566,7 +519,7 @@ X、Y 轴会根据各自完整显示域选择格式:最大绝对值在 `[0.01,
|
||||
| --------------------------------------------------------------- | -------------------------------------------------------------- |
|
||||
| `point-hover` | 当前最近点变化时触发,离开图表时传入 `null` |
|
||||
| `zoom-change` | 缩放过程中触发,参数为 `[start, end]` |
|
||||
| `zoom-end` | 滚轮或框选结束后触发;`gesture` 区分二者,独立模式附带轨道信息 |
|
||||
| `zoom-end` | 滚轮放大结束后触发;独立分图模式附带 `trackIndex`、`seriesIds` |
|
||||
| `zoom-reset` | 双击重置视口时触发,调用方应恢复首次完整数据 |
|
||||
| `page-change` | 分页变化,参数为当前页和总页数 |
|
||||
| `series-visibility-change` | 图例切换曲线显隐时触发 |
|
||||
@@ -609,7 +562,7 @@ pnpm build
|
||||
发布由推送版本 tag 触发。先将 `package.json` 的 `version` 更新为目标版本并提交,再创建同版本 tag:
|
||||
|
||||
```bash
|
||||
git tag -a v0.1.15 -m "Release v0.1.15"
|
||||
git tag -a v0.1.7 -m "Release v0.1.7"
|
||||
git push origin main --follow-tags
|
||||
```
|
||||
|
||||
|
||||
@@ -1,125 +0,0 @@
|
||||
# 性能优化使用指南
|
||||
|
||||
本文档简要说明如何使用新增的性能优化功能。
|
||||
|
||||
## 🚀 渲染层自动降采样
|
||||
|
||||
组件规范化时保留全部有效点,坐标域、误差棒、tooltip 和标注均使用完整数据。绘制路径会根据
|
||||
当前视口宽度和 `rendering` 配置自动选择代表点,避免大数据量直接生成过长的 SVG 路径。
|
||||
|
||||
### 默认行为(推荐)
|
||||
|
||||
```typescript
|
||||
import { WaveformChart } from 'waveform-analysis'
|
||||
|
||||
// 渲染层降采样默认启用,传入数据不会被修改或丢弃
|
||||
<WaveformChart :data="largeDataset" />
|
||||
```
|
||||
|
||||
### 手动控制抽样
|
||||
|
||||
```typescript
|
||||
import { downsampleLTTB, adaptiveSampling } from 'waveform-analysis'
|
||||
|
||||
// 仅在业务明确接受丢点时手动压缩输入数据
|
||||
const sampled = downsampleLTTB(points, 1000) // LTTB 算法
|
||||
const adaptive = adaptiveSampling(points, 5000) // 自适应策略
|
||||
```
|
||||
|
||||
## 📊 抽样算法选择
|
||||
|
||||
### LTTB (推荐用于保持形状)
|
||||
|
||||
适用于需要保持波形细节和峰值的场景:
|
||||
|
||||
```typescript
|
||||
import { downsampleLTTB } from 'waveform-analysis'
|
||||
|
||||
const sampled = downsampleLTTB(originalPoints, 1000)
|
||||
// 从任意数量降至 1000 点,保持视觉保真度
|
||||
```
|
||||
|
||||
### MinMax (推荐用于超大数据集)
|
||||
|
||||
适用于快速预览和展示数据范围:
|
||||
|
||||
```typescript
|
||||
import { downsampleMinMax } from 'waveform-analysis'
|
||||
|
||||
const sampled = downsampleMinMax(originalPoints, 500)
|
||||
// 保证捕获最小值和最大值
|
||||
```
|
||||
|
||||
### 自适应抽样(最简单)
|
||||
|
||||
自动选择最佳算法:
|
||||
|
||||
```typescript
|
||||
import { adaptiveSampling } from 'waveform-analysis'
|
||||
|
||||
const result = adaptiveSampling(originalPoints, 5000)
|
||||
console.log(result.algorithm) // 'none' | 'lttb' | 'minmax'
|
||||
console.log(result.originalCount) // 原始点数
|
||||
```
|
||||
|
||||
## ⚡ 性能提升
|
||||
|
||||
| 数据点数 | 渲染性能提升 | 内存节省 |
|
||||
|---------|------------|---------|
|
||||
| < 10,000 | 无变化 | 无变化 |
|
||||
| 50,000 | ~358% | ~57% |
|
||||
| 100,000 | ~980% | ~75% |
|
||||
|
||||
## 🔧 配置渲染阈值
|
||||
|
||||
通过 `rendering` 属性调整渲染层降采样,无需修改组件源码:
|
||||
|
||||
```vue
|
||||
<WaveformChart
|
||||
:data="largeDataset"
|
||||
:rendering="{ downsample: true, downsampleThreshold: 2000, maxPointsPerPixel: 4 }"
|
||||
/>
|
||||
```
|
||||
|
||||
## 📝 其他优化
|
||||
|
||||
### 常量配置
|
||||
|
||||
所有魔法数字已提取到 `src/components/core/constants.ts`,便于统一调整:
|
||||
|
||||
```typescript
|
||||
import {
|
||||
WHEEL_ZOOM_DEBOUNCE_MS,
|
||||
ZOOM_CONSTRAINTS,
|
||||
} from 'waveform-analysis'
|
||||
```
|
||||
|
||||
### 性能监控
|
||||
|
||||
```typescript
|
||||
// 监控数据处理时间
|
||||
console.time('data-processing')
|
||||
const series = normalizeWaveformSeries(data)
|
||||
console.timeEnd('data-processing')
|
||||
```
|
||||
|
||||
## 🐛 故障排除
|
||||
|
||||
### 抽样后波形失真
|
||||
|
||||
如果抽样后的波形不符合预期:
|
||||
|
||||
1. 尝试增加目标点数:`downsampleLTTB(data, 10000)`
|
||||
2. 使用 MinMax 算法保证峰值:`downsampleMinMax(data, 5000)`
|
||||
3. 将 `rendering.downsample` 设为 `false`,对比完整路径确认是否由渲染采样导致
|
||||
|
||||
### 性能仍然不佳
|
||||
|
||||
1. 检查数据点数:`console.log(points.length)`
|
||||
2. 确认 `rendering.downsample` 未被关闭
|
||||
3. 考虑减少同时显示的系列数量
|
||||
4. 使用分页功能拆分数据
|
||||
|
||||
## 📚 更多信息
|
||||
|
||||
完整的优化详情请参考 [OPTIMIZATIONS.md](./OPTIMIZATIONS.md)
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "waveform-analysis",
|
||||
"version": "0.1.17",
|
||||
"version": "0.1.14",
|
||||
"main": "./dist/index.cjs",
|
||||
"module": "./dist/index.js",
|
||||
"types": "./dist/types/index.d.ts",
|
||||
@@ -35,7 +35,6 @@
|
||||
"test:coverage": "vitest run --coverage"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"ant-design-vue": ">=3.2.20 <4",
|
||||
"d3": ">=7.9.0 <8",
|
||||
"vue": ">=3.2.33 <4",
|
||||
"vue3-colorpicker": ">=2.3.0 <3"
|
||||
@@ -47,7 +46,6 @@
|
||||
"@vitejs/plugin-vue": "6.0.8",
|
||||
"@vitest/coverage-v8": "4.1.10",
|
||||
"@vue/test-utils": "2.4.11",
|
||||
"ant-design-vue": "4.2.6",
|
||||
"d3": "7.9.0",
|
||||
"eslint": "10.7.0",
|
||||
"eslint-config-prettier": "10.1.8",
|
||||
|
||||
198
pnpm-lock.yaml
generated
198
pnpm-lock.yaml
generated
@@ -26,9 +26,6 @@ importers:
|
||||
'@vue/test-utils':
|
||||
specifier: 2.4.11
|
||||
version: 2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3))
|
||||
ant-design-vue:
|
||||
specifier: 4.2.6
|
||||
version: 4.2.6(vue@3.5.40(typescript@6.0.3))
|
||||
d3:
|
||||
specifier: 7.9.0
|
||||
version: 7.9.0
|
||||
@@ -77,17 +74,6 @@ packages:
|
||||
'@aesoper/normal-utils@0.1.5':
|
||||
resolution: {integrity: sha512-LFF/6y6h5mfwhnJaWqqxuC8zzDaHCG62kMRkd8xhDtq62TQj9dM17A9DhE87W7DhiARJsHLgcina/9P4eNCN1w==}
|
||||
|
||||
'@ant-design/colors@6.0.0':
|
||||
resolution: {integrity: sha512-qAZRvPzfdWHtfameEGP2Qvuf838NhergR35o+EuVyB5XvSA98xod5r4utvi4TJ3ywmevm290g9nsCG5MryrdWQ==}
|
||||
|
||||
'@ant-design/icons-svg@4.5.0':
|
||||
resolution: {integrity: sha512-1BTUFyKPTBZ53MuTP8s0k5SFEXL7o3VHEOwLgzaoWKwnBeqIcqUtVshc4SKzhI6uACfqhJqBwBUE9FsWR3uULA==}
|
||||
|
||||
'@ant-design/icons-vue@7.0.1':
|
||||
resolution: {integrity: sha512-eCqY2unfZK6Fe02AwFlDHLfoyEFreP6rBwAZMIJ1LugmfMiVgwWDYlp1YsRugaPtICYOabV1iWxXdP12u9U43Q==}
|
||||
peerDependencies:
|
||||
vue: '>=3.0.3'
|
||||
|
||||
'@asamuzakjp/css-color@5.1.11':
|
||||
resolution: {integrity: sha512-KVw6qIiCTUQhByfTd78h2yD1/00waTmm9uy/R7Ck/ctUyAPj+AEDLkQIdJW0T8+qGgj3j5bpNKK7Q3G+LedJWg==}
|
||||
engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0}
|
||||
@@ -116,10 +102,6 @@ packages:
|
||||
engines: {node: '>=6.0.0'}
|
||||
hasBin: true
|
||||
|
||||
'@babel/runtime@7.29.7':
|
||||
resolution: {integrity: sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==}
|
||||
engines: {node: '>=6.9.0'}
|
||||
|
||||
'@babel/types@7.29.7':
|
||||
resolution: {integrity: sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==}
|
||||
engines: {node: '>=6.9.0'}
|
||||
@@ -168,10 +150,6 @@ packages:
|
||||
resolution: {integrity: sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==}
|
||||
engines: {node: '>=20.19.0'}
|
||||
|
||||
'@ctrl/tinycolor@3.6.1':
|
||||
resolution: {integrity: sha512-SITSV6aIXsuVNV3f3O0f2n/cgyEDWoSqtZMYiAmcsYHydcKrOz3gUxB/iXd/Qf08+IZX4KpgNbvUdMBmWz+kcA==}
|
||||
engines: {node: '>=10'}
|
||||
|
||||
'@emnapi/core@1.11.1':
|
||||
resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==}
|
||||
|
||||
@@ -181,12 +159,6 @@ packages:
|
||||
'@emnapi/wasi-threads@1.2.2':
|
||||
resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==}
|
||||
|
||||
'@emotion/hash@0.9.2':
|
||||
resolution: {integrity: sha512-MyqliTZGuOm3+5ZRSaaBGP3USLw6+EGykkwZns2EPC5g8jJ4z9OrdZY9apkl3+UP9+sdz76YYkwCKP5gh8iY3g==}
|
||||
|
||||
'@emotion/unitless@0.8.1':
|
||||
resolution: {integrity: sha512-KOEGMu6dmJZtpadb476IsZBclKvILjopjUii3V+7MnXIQCYh8W3NgNcgwo21n9LXZX6EDIKvqfjYxXebDwxKmQ==}
|
||||
|
||||
'@eslint-community/eslint-utils@4.9.1':
|
||||
resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==}
|
||||
engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
|
||||
@@ -386,9 +358,6 @@ packages:
|
||||
'@rolldown/pluginutils@1.0.1':
|
||||
resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
|
||||
|
||||
'@simonwep/pickr@1.8.2':
|
||||
resolution: {integrity: sha512-/l5w8BIkrpP6n1xsetx9MWPWlU6OblN5YgZZphxan0Tq4BByTCETL6lyIeY8lagalS2Nbt4F2W034KHLIiunKA==}
|
||||
|
||||
'@standard-schema/spec@1.1.0':
|
||||
resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
|
||||
|
||||
@@ -710,15 +679,6 @@ packages:
|
||||
resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
ant-design-vue@4.2.6:
|
||||
resolution: {integrity: sha512-t7eX13Yj3i9+i5g9lqFyYneoIb3OzTvQjq9Tts1i+eiOd3Eva/6GagxBSXM1fOCjqemIu0FYVE1ByZ/38epR3Q==}
|
||||
engines: {node: '>=12.22.0'}
|
||||
peerDependencies:
|
||||
vue: '>=3.2.0'
|
||||
|
||||
array-tree-filter@2.1.0:
|
||||
resolution: {integrity: sha512-4ROwICNlNw/Hqa9v+rk5h22KjmzB1JGTMVKP2AKJBOCgb0yL0ASf0+YvCcLNNwquOHNX48jkeZIJ3a+oOQqKcw==}
|
||||
|
||||
assertion-error@2.0.1:
|
||||
resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==}
|
||||
engines: {node: '>=12'}
|
||||
@@ -726,9 +686,6 @@ packages:
|
||||
ast-v8-to-istanbul@1.0.5:
|
||||
resolution: {integrity: sha512-UPAgKJFSEGMWSDr3LX4tqnAb4f7KGT8O40Tyx8wbYmmZ/yn58lNCm8h3svs3eXgiGd5AXxz8NDOvXWvicq+rJA==}
|
||||
|
||||
async-validator@4.2.5:
|
||||
resolution: {integrity: sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==}
|
||||
|
||||
balanced-match@1.0.2:
|
||||
resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
|
||||
|
||||
@@ -768,18 +725,12 @@ packages:
|
||||
resolution: {integrity: sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==}
|
||||
engines: {node: '>= 10'}
|
||||
|
||||
compute-scroll-into-view@1.0.20:
|
||||
resolution: {integrity: sha512-UCB0ioiyj8CRjtrvaceBLqqhZCVP+1B8+NWQhmdsm0VXOJtobBCf1dBQmebCCo34qZmUwZfIH2MZLqNHazrfjg==}
|
||||
|
||||
config-chain@1.1.13:
|
||||
resolution: {integrity: sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==}
|
||||
|
||||
convert-source-map@2.0.0:
|
||||
resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
|
||||
|
||||
core-js@3.49.0:
|
||||
resolution: {integrity: sha512-es1U2+YTtzpwkxVLwAFdSpaIMyQaq0PBgm3YD1W3Qpsn1NAmO3KSgZfu+oGSWVu6NvLHoHCV/aYcsE5wiB7ALg==}
|
||||
|
||||
cross-spawn@7.0.6:
|
||||
resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
|
||||
engines: {node: '>= 8'}
|
||||
@@ -927,9 +878,6 @@ packages:
|
||||
resolution: {integrity: sha512-23XHcCF+coGYevirZceTVD7NdJOqVn+49IHyxgszm+JIiHLoB2TkmPtsYkNWT1pvRSGkc35L6NHs0yHkN2SumA==}
|
||||
engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0}
|
||||
|
||||
dayjs@1.11.21:
|
||||
resolution: {integrity: sha512-98IT+HOahAisibz/yjKbzuOBwYcjJ7BCLPzARyHiyEBmRz4fatF+KPJszEHXsGYjUG234aH/cOjW1wwTbKUZlA==}
|
||||
|
||||
debug@4.4.3:
|
||||
resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
|
||||
engines: {node: '>=6.0'}
|
||||
@@ -952,12 +900,6 @@ packages:
|
||||
resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
dom-align@1.12.4:
|
||||
resolution: {integrity: sha512-R8LUSEay/68zE5c8/3BDxiTEvgb4xZTF0RKmAHfiEVN3klfIpXfi2/QCoiWPccVQ0J/ZGdz9OjzL4uJEP/MRAw==}
|
||||
|
||||
dom-scroll-into-view@2.0.1:
|
||||
resolution: {integrity: sha512-bvVTQe1lfaUr1oFzZX80ce9KLDlZ3iU+XGNE/bz9HnGdklTieqsbmsLHe+rT2XWqopvL0PckkYqN7ksmm5pe3w==}
|
||||
|
||||
eastasianwidth@0.2.0:
|
||||
resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
|
||||
|
||||
@@ -1163,10 +1105,6 @@ packages:
|
||||
resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
is-plain-object@3.0.1:
|
||||
resolution: {integrity: sha512-Xnpx182SBMrr/aBik8y+GuR4U1L9FqMSojwDQwPMmxyC6bvEqly9UBCxhauBF5vNh2gwWJNX6oDV7O+OM4z34g==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
is-plain-object@5.0.0:
|
||||
resolution: {integrity: sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
@@ -1203,9 +1141,6 @@ packages:
|
||||
js-tokens@10.0.0:
|
||||
resolution: {integrity: sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==}
|
||||
|
||||
js-tokens@4.0.0:
|
||||
resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
|
||||
|
||||
jsdom@29.1.1:
|
||||
resolution: {integrity: sha512-ECi4Fi2f7BdJtUKTflYRTiaMxIB0O6zfR1fX0GXpUrf6flp8QIYn1UT20YQqdSOfk2dfkCwS8LAFoJDEppNK5Q==}
|
||||
engines: {node: ^20.19.0 || ^22.13.0 || >=24.0.0}
|
||||
@@ -1312,13 +1247,6 @@ packages:
|
||||
lodash-es@4.18.1:
|
||||
resolution: {integrity: sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==}
|
||||
|
||||
lodash@4.18.1:
|
||||
resolution: {integrity: sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==}
|
||||
|
||||
loose-envify@1.4.0:
|
||||
resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==}
|
||||
hasBin: true
|
||||
|
||||
lru-cache@10.4.3:
|
||||
resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
|
||||
|
||||
@@ -1362,9 +1290,6 @@ packages:
|
||||
engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
|
||||
hasBin: true
|
||||
|
||||
nanopop@2.4.2:
|
||||
resolution: {integrity: sha512-NzOgmMQ+elxxHeIha+OG/Pv3Oc3p4RU2aBhwWwAqDpXrdTbtRylbRLQztLy8dMMwfl6pclznBdfUhccEn9ZIzw==}
|
||||
|
||||
natural-compare@1.4.0:
|
||||
resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==}
|
||||
|
||||
@@ -1451,9 +1376,6 @@ packages:
|
||||
resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
resize-observer-polyfill@1.5.1:
|
||||
resolution: {integrity: sha512-LwZrotdHOo12nQuZlHEmtuXdqGoOD0OhaxopaNFxWzInpEgaLWoVuAMbTzixuosCx2nEG58ngzW3vxdWoxIgdg==}
|
||||
|
||||
robust-predicates@3.0.3:
|
||||
resolution: {integrity: sha512-NS3levdsRIUOmiJ8FZWCP7LG3QpJyrs/TE0Zpf1yvZu8cAJJ6QMW92H1c7kWpdIHo8RvmLxN/o2JXTKHp74lUA==}
|
||||
|
||||
@@ -1472,17 +1394,11 @@ packages:
|
||||
resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==}
|
||||
engines: {node: '>=v12.22.7'}
|
||||
|
||||
scroll-into-view-if-needed@2.2.31:
|
||||
resolution: {integrity: sha512-dGCXy99wZQivjmjIqihaBQNjryrz5rueJY7eHfTdyWEiR4ttYpsajb14rn9s5d4DY4EcY6+4+U/maARBXJedkA==}
|
||||
|
||||
semver@7.8.5:
|
||||
resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==}
|
||||
engines: {node: '>=10'}
|
||||
hasBin: true
|
||||
|
||||
shallow-equal@1.2.1:
|
||||
resolution: {integrity: sha512-S4vJDjHHMBaiZuT9NPb616CSmLf618jawtv3sufLl6ivK8WocjAo58cXwbRV1cgqxH0Qbv+iUt6m05eqEa2IRA==}
|
||||
|
||||
shebang-command@2.0.0:
|
||||
resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
|
||||
engines: {node: '>=8'}
|
||||
@@ -1524,9 +1440,6 @@ packages:
|
||||
resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
stylis@4.4.0:
|
||||
resolution: {integrity: sha512-5Z9ZpRzfuH6l/UAvCPAPUo3665Nk2wLaZU3x+TLHKVzIz33+sbJqbtrYoC3KD4/uVOr2Zp+L0LySezP9OHV9yA==}
|
||||
|
||||
supports-color@7.2.0:
|
||||
resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
|
||||
engines: {node: '>=8'}
|
||||
@@ -1534,10 +1447,6 @@ packages:
|
||||
symbol-tree@3.2.4:
|
||||
resolution: {integrity: sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==}
|
||||
|
||||
throttle-debounce@5.0.2:
|
||||
resolution: {integrity: sha512-B71/4oyj61iNH0KeCamLuE2rmKuTO5byTOSVwECM5FA7TiAiAW+UqTKZ9ERueC4qvgSttUhdmq1mXC3kJqGX7A==}
|
||||
engines: {node: '>=12.22'}
|
||||
|
||||
tinybench@2.9.0:
|
||||
resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
|
||||
|
||||
@@ -1722,12 +1631,6 @@ packages:
|
||||
peerDependencies:
|
||||
typescript: '>=5.0.0'
|
||||
|
||||
vue-types@3.0.2:
|
||||
resolution: {integrity: sha512-IwUC0Aq2zwaXqy74h4WCvFCUtoV0iSWr0snWnE9TnU18S66GAQyqQbRf2qfJtUuiFsBf6qp0MEwdonlwznlcrw==}
|
||||
engines: {node: '>=10.15.0'}
|
||||
peerDependencies:
|
||||
vue: ^3.0.0
|
||||
|
||||
vue-types@4.2.1:
|
||||
resolution: {integrity: sha512-DNQZmJuOvovLUIp0BENRkdnZHbI0V4e2mNvjAZOAXKD56YGvRchtUYOXA/XqTxdv7Ng5SJLZqRKRpAhm5NLaPQ==}
|
||||
engines: {node: '>=12.16.0'}
|
||||
@@ -1758,9 +1661,6 @@ packages:
|
||||
resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==}
|
||||
engines: {node: '>=18'}
|
||||
|
||||
warning@4.0.3:
|
||||
resolution: {integrity: sha512-rpJyN222KWIvHJ/F53XSZv0Zl/accqHR8et1kpaMTD/fLCRxtV8iX8czMzY7sVZupTI3zcUTg8eycS2kNF9l6w==}
|
||||
|
||||
webidl-conversions@8.0.1:
|
||||
resolution: {integrity: sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==}
|
||||
engines: {node: '>=20'}
|
||||
@@ -1814,18 +1714,6 @@ snapshots:
|
||||
|
||||
'@aesoper/normal-utils@0.1.5': {}
|
||||
|
||||
'@ant-design/colors@6.0.0':
|
||||
dependencies:
|
||||
'@ctrl/tinycolor': 3.6.1
|
||||
|
||||
'@ant-design/icons-svg@4.5.0': {}
|
||||
|
||||
'@ant-design/icons-vue@7.0.1(vue@3.5.40(typescript@6.0.3))':
|
||||
dependencies:
|
||||
'@ant-design/colors': 6.0.0
|
||||
'@ant-design/icons-svg': 4.5.0
|
||||
vue: 3.5.40(typescript@6.0.3)
|
||||
|
||||
'@asamuzakjp/css-color@5.1.11':
|
||||
dependencies:
|
||||
'@asamuzakjp/generational-cache': 1.0.1
|
||||
@@ -1854,8 +1742,6 @@ snapshots:
|
||||
dependencies:
|
||||
'@babel/types': 7.29.7
|
||||
|
||||
'@babel/runtime@7.29.7': {}
|
||||
|
||||
'@babel/types@7.29.7':
|
||||
dependencies:
|
||||
'@babel/helper-string-parser': 7.29.7
|
||||
@@ -1891,8 +1777,6 @@ snapshots:
|
||||
|
||||
'@csstools/css-tokenizer@4.0.0': {}
|
||||
|
||||
'@ctrl/tinycolor@3.6.1': {}
|
||||
|
||||
'@emnapi/core@1.11.1':
|
||||
dependencies:
|
||||
'@emnapi/wasi-threads': 1.2.2
|
||||
@@ -1909,10 +1793,6 @@ snapshots:
|
||||
tslib: 2.8.1
|
||||
optional: true
|
||||
|
||||
'@emotion/hash@0.9.2': {}
|
||||
|
||||
'@emotion/unitless@0.8.1': {}
|
||||
|
||||
'@eslint-community/eslint-utils@4.9.1(eslint@10.7.0)':
|
||||
dependencies:
|
||||
eslint: 10.7.0
|
||||
@@ -2050,11 +1930,6 @@ snapshots:
|
||||
|
||||
'@rolldown/pluginutils@1.0.1': {}
|
||||
|
||||
'@simonwep/pickr@1.8.2':
|
||||
dependencies:
|
||||
core-js: 3.49.0
|
||||
nanopop: 2.4.2
|
||||
|
||||
'@standard-schema/spec@1.1.0': {}
|
||||
|
||||
'@tybys/wasm-util@0.10.3':
|
||||
@@ -2483,34 +2358,6 @@ snapshots:
|
||||
|
||||
ansi-styles@6.2.3: {}
|
||||
|
||||
ant-design-vue@4.2.6(vue@3.5.40(typescript@6.0.3)):
|
||||
dependencies:
|
||||
'@ant-design/colors': 6.0.0
|
||||
'@ant-design/icons-vue': 7.0.1(vue@3.5.40(typescript@6.0.3))
|
||||
'@babel/runtime': 7.29.7
|
||||
'@ctrl/tinycolor': 3.6.1
|
||||
'@emotion/hash': 0.9.2
|
||||
'@emotion/unitless': 0.8.1
|
||||
'@simonwep/pickr': 1.8.2
|
||||
array-tree-filter: 2.1.0
|
||||
async-validator: 4.2.5
|
||||
csstype: 3.2.3
|
||||
dayjs: 1.11.21
|
||||
dom-align: 1.12.4
|
||||
dom-scroll-into-view: 2.0.1
|
||||
lodash: 4.18.1
|
||||
lodash-es: 4.18.1
|
||||
resize-observer-polyfill: 1.5.1
|
||||
scroll-into-view-if-needed: 2.2.31
|
||||
shallow-equal: 1.2.1
|
||||
stylis: 4.4.0
|
||||
throttle-debounce: 5.0.2
|
||||
vue: 3.5.40(typescript@6.0.3)
|
||||
vue-types: 3.0.2(vue@3.5.40(typescript@6.0.3))
|
||||
warning: 4.0.3
|
||||
|
||||
array-tree-filter@2.1.0: {}
|
||||
|
||||
assertion-error@2.0.1: {}
|
||||
|
||||
ast-v8-to-istanbul@1.0.5:
|
||||
@@ -2519,8 +2366,6 @@ snapshots:
|
||||
estree-walker: 3.0.3
|
||||
js-tokens: 10.0.0
|
||||
|
||||
async-validator@4.2.5: {}
|
||||
|
||||
balanced-match@1.0.2: {}
|
||||
|
||||
balanced-match@4.0.4: {}
|
||||
@@ -2551,8 +2396,6 @@ snapshots:
|
||||
|
||||
commander@7.2.0: {}
|
||||
|
||||
compute-scroll-into-view@1.0.20: {}
|
||||
|
||||
config-chain@1.1.13:
|
||||
dependencies:
|
||||
ini: 1.3.8
|
||||
@@ -2560,8 +2403,6 @@ snapshots:
|
||||
|
||||
convert-source-map@2.0.0: {}
|
||||
|
||||
core-js@3.49.0: {}
|
||||
|
||||
cross-spawn@7.0.6:
|
||||
dependencies:
|
||||
path-key: 3.1.1
|
||||
@@ -2736,8 +2577,6 @@ snapshots:
|
||||
transitivePeerDependencies:
|
||||
- '@noble/hashes'
|
||||
|
||||
dayjs@1.11.21: {}
|
||||
|
||||
debug@4.4.3:
|
||||
dependencies:
|
||||
ms: 2.1.3
|
||||
@@ -2752,10 +2591,6 @@ snapshots:
|
||||
|
||||
detect-libc@2.1.2: {}
|
||||
|
||||
dom-align@1.12.4: {}
|
||||
|
||||
dom-scroll-into-view@2.0.1: {}
|
||||
|
||||
eastasianwidth@0.2.0: {}
|
||||
|
||||
editorconfig@1.0.7:
|
||||
@@ -2949,8 +2784,6 @@ snapshots:
|
||||
dependencies:
|
||||
is-extglob: 2.1.1
|
||||
|
||||
is-plain-object@3.0.1: {}
|
||||
|
||||
is-plain-object@5.0.0: {}
|
||||
|
||||
is-potential-custom-element-name@1.0.1: {}
|
||||
@@ -2988,8 +2821,6 @@ snapshots:
|
||||
|
||||
js-tokens@10.0.0: {}
|
||||
|
||||
js-tokens@4.0.0: {}
|
||||
|
||||
jsdom@29.1.1:
|
||||
dependencies:
|
||||
'@asamuzakjp/css-color': 5.1.11
|
||||
@@ -3086,12 +2917,6 @@ snapshots:
|
||||
|
||||
lodash-es@4.18.1: {}
|
||||
|
||||
lodash@4.18.1: {}
|
||||
|
||||
loose-envify@1.4.0:
|
||||
dependencies:
|
||||
js-tokens: 4.0.0
|
||||
|
||||
lru-cache@10.4.3: {}
|
||||
|
||||
lru-cache@11.5.2: {}
|
||||
@@ -3128,8 +2953,6 @@ snapshots:
|
||||
|
||||
nanoid@3.3.16: {}
|
||||
|
||||
nanopop@2.4.2: {}
|
||||
|
||||
natural-compare@1.4.0: {}
|
||||
|
||||
nopt@7.2.1:
|
||||
@@ -3203,8 +3026,6 @@ snapshots:
|
||||
|
||||
require-from-string@2.0.2: {}
|
||||
|
||||
resize-observer-polyfill@1.5.1: {}
|
||||
|
||||
robust-predicates@3.0.3: {}
|
||||
|
||||
rolldown@1.1.5:
|
||||
@@ -3236,14 +3057,8 @@ snapshots:
|
||||
dependencies:
|
||||
xmlchars: 2.2.0
|
||||
|
||||
scroll-into-view-if-needed@2.2.31:
|
||||
dependencies:
|
||||
compute-scroll-into-view: 1.0.20
|
||||
|
||||
semver@7.8.5: {}
|
||||
|
||||
shallow-equal@1.2.1: {}
|
||||
|
||||
shebang-command@2.0.0:
|
||||
dependencies:
|
||||
shebang-regex: 3.0.0
|
||||
@@ -3280,16 +3095,12 @@ snapshots:
|
||||
dependencies:
|
||||
ansi-regex: 6.2.2
|
||||
|
||||
stylis@4.4.0: {}
|
||||
|
||||
supports-color@7.2.0:
|
||||
dependencies:
|
||||
has-flag: 4.0.0
|
||||
|
||||
symbol-tree@3.2.4: {}
|
||||
|
||||
throttle-debounce@5.0.2: {}
|
||||
|
||||
tinybench@2.9.0: {}
|
||||
|
||||
tinycolor2@1.6.0: {}
|
||||
@@ -3417,11 +3228,6 @@ snapshots:
|
||||
'@vue/language-core': 3.3.7
|
||||
typescript: 6.0.3
|
||||
|
||||
vue-types@3.0.2(vue@3.5.40(typescript@6.0.3)):
|
||||
dependencies:
|
||||
is-plain-object: 3.0.1
|
||||
vue: 3.5.40(typescript@6.0.3)
|
||||
|
||||
vue-types@4.2.1(vue@3.5.40(typescript@6.0.3)):
|
||||
dependencies:
|
||||
is-plain-object: 5.0.0
|
||||
@@ -3452,10 +3258,6 @@ snapshots:
|
||||
dependencies:
|
||||
xml-name-validator: 5.0.0
|
||||
|
||||
warning@4.0.3:
|
||||
dependencies:
|
||||
loose-envify: 1.4.0
|
||||
|
||||
webidl-conversions@8.0.1: {}
|
||||
|
||||
whatwg-mimetype@5.0.0: {}
|
||||
|
||||
240
src/App.test.ts
240
src/App.test.ts
@@ -1,5 +1,4 @@
|
||||
import { flushPromises, mount } from '@vue/test-utils'
|
||||
import { InputNumber, Select } from 'ant-design-vue'
|
||||
import { describe, expect, it, vi } from 'vitest'
|
||||
import { ColorPicker } from 'vue3-colorpicker'
|
||||
|
||||
@@ -41,19 +40,7 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
expect(panel.find('[aria-label="波形展示方式"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="波形叠加方式"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="波形网格尺寸"]').exists()).toBe(true)
|
||||
const gridSizeInputs = panel.get('[aria-label="波形网格尺寸"]').findAllComponents(InputNumber)
|
||||
expect(gridSizeInputs[0]?.props('value')).toBe(4)
|
||||
expect(gridSizeInputs[1]?.props('value')).toBe(1)
|
||||
expect(panel.find('[aria-label="显示水平网格线"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="显示垂直网格线"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="显示横轴线"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="显示纵轴线"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="水平网格线颜色"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="垂直网格线颜色"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="净图模式"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="显示数值 Tooltip"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="选择波形线型"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="设置波形线型"]').exists()).toBe(true)
|
||||
expect(panel.find('[aria-label="显示零值参考线"]').exists()).toBe(true)
|
||||
const zeroLineControls = panel.get('.zero-line-controls')
|
||||
expect(zeroLineControls.findAllComponents(ColorPicker)).toHaveLength(1)
|
||||
@@ -64,13 +51,10 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
expect(frameControls.text()).toContain('背景颜色')
|
||||
expect(frameControls.find('[aria-label="图框线宽"]').exists()).toBe(true)
|
||||
expect(frameControls.find('[aria-label="图框线型"]').exists()).toBe(true)
|
||||
expect(
|
||||
frameControls.get('[aria-label="图框线型"]').getComponent(Select).props('options'),
|
||||
).toContainEqual({ label: '点虚线', value: 'dotted' })
|
||||
expect(frameControls.find('[aria-label="显示图框水印"]').exists()).toBe(true)
|
||||
expect(frameControls.get('.frame-style-control--switch .ant-switch').classes()).toContain(
|
||||
'ant-switch-small',
|
||||
)
|
||||
expect(
|
||||
frameControls.get('.frame-style-control--switch .native-switch').attributes('role'),
|
||||
).toBe('switch')
|
||||
const titleControls = panel.get('.title-controls')
|
||||
expect(panel.find('[aria-label="显示标题"]').exists()).toBe(true)
|
||||
expect(titleControls.find('[aria-label="标题名称"]').exists()).toBe(true)
|
||||
@@ -100,8 +84,8 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
expect(chart.props('cleanView')).toBe(false)
|
||||
expect(chart.props('zeroLine')).toMatchObject({ visible: false, color: '#98a2b3', width: 1 })
|
||||
|
||||
await wrapper.get('[aria-label="净图模式"]').trigger('click')
|
||||
await wrapper.get('[aria-label="显示零值参考线"]').trigger('click')
|
||||
await wrapper.get('[aria-label="净图模式"]').setValue(true)
|
||||
await wrapper.get('[aria-label="显示零值参考线"]').setValue(true)
|
||||
await flushPromises()
|
||||
|
||||
expect(chart.props('cleanView')).toBe(true)
|
||||
@@ -109,80 +93,6 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('passes horizontal and vertical grid controls to every track', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
const chart = wrapper.getComponent(WaveformChart)
|
||||
|
||||
await wrapper.get('[aria-label="显示水平网格线"]').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
const grid = chart.props('grid')
|
||||
const trackLines = grid?.trackLines
|
||||
expect(trackLines).toBeTruthy()
|
||||
expect(Object.keys(trackLines ?? {}).length).toBeGreaterThan(0)
|
||||
expect(Object.values(trackLines ?? {})).toEqual(
|
||||
expect.arrayContaining([
|
||||
expect.objectContaining({
|
||||
horizontal: false,
|
||||
vertical: true,
|
||||
horizontalColor: '#dfe5ef',
|
||||
verticalColor: '#dfe5ef',
|
||||
}),
|
||||
]),
|
||||
)
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('passes independent X and Y axis-line controls to the chart', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
const chart = wrapper.getComponent(WaveformChart)
|
||||
|
||||
expect(chart.props('axes')).toEqual({
|
||||
x: { lineVisible: false },
|
||||
y: { lineVisible: false },
|
||||
})
|
||||
|
||||
await wrapper.get('[aria-label="显示横轴线"]').trigger('click')
|
||||
await wrapper.get('[aria-label="显示纵轴线"]').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(chart.props('axes')).toEqual({
|
||||
x: { lineVisible: true },
|
||||
y: { lineVisible: true },
|
||||
})
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('passes tooltip and per-series line-style controls to the chart', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
const chart = wrapper.getComponent(WaveformChart)
|
||||
|
||||
expect(chart.props('showTooltip')).toBe(true)
|
||||
await wrapper.get('[aria-label="显示数值 Tooltip"]').trigger('click')
|
||||
await flushPromises()
|
||||
expect(chart.props('showTooltip')).toBe(false)
|
||||
|
||||
const seriesSelect = wrapper.get('[aria-label="选择波形线型"]').getComponent(Select)
|
||||
const lineStyleSelect = wrapper.get('[aria-label="设置波形线型"]').getComponent(Select)
|
||||
const firstSeriesId = String(
|
||||
(chart.props('data') as WaveformData).kind === 'series'
|
||||
? (chart.props('data') as Extract<WaveformData, { kind: 'series' }>).series[0]?.id
|
||||
: '',
|
||||
)
|
||||
seriesSelect.vm.$emit('update:value', firstSeriesId)
|
||||
lineStyleSelect.vm.$emit('update:value', 'dash-dot')
|
||||
await flushPromises()
|
||||
|
||||
const currentData = chart.props('data') as Extract<WaveformData, { kind: 'series' }>
|
||||
expect(currentData.series.find((series) => series.id === firstSeriesId)?.lineStyle).toBe(
|
||||
'dash-dot',
|
||||
)
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('switches overlaid tracks between single-axis and multi-axis rendering', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
@@ -201,7 +111,7 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('keeps only one error-bar series in the first frame', async () => {
|
||||
it('renders the requested point-only and line-only examples in the first frame', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
|
||||
@@ -210,8 +120,31 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
|
||||
expect(firstFrameSeries.map((series) => series.attributes('data-series-name'))).toEqual([
|
||||
'BT2_2M',
|
||||
'TEST_CH_1',
|
||||
'TEST_CH_3',
|
||||
'TEST_CH_4',
|
||||
'TEST_CH_5',
|
||||
'纯点无线',
|
||||
'纯线无点',
|
||||
])
|
||||
|
||||
const pointsOnlySeries = firstFrame.get('.waveform-chart__series[data-series-name="纯点无线"]')
|
||||
expect(pointsOnlySeries.find('.waveform-chart__line').exists()).toBe(false)
|
||||
expect(pointsOnlySeries.get('.waveform-chart__points').attributes('data-point-type')).toBe(
|
||||
'circle',
|
||||
)
|
||||
|
||||
const testChannelFour = firstFrame.get('.waveform-chart__series[data-series-name="TEST_CH_4"]')
|
||||
expect(testChannelFour.get('.waveform-chart__line').attributes('data-line-type')).toBe('linear')
|
||||
expect(testChannelFour.get('.waveform-chart__points').attributes('data-point-type')).toBe(
|
||||
'circle',
|
||||
)
|
||||
expect(testChannelFour.find('.waveform-chart__error-bars').exists()).toBe(false)
|
||||
|
||||
const lineOnlySeries = firstFrame.get('.waveform-chart__series[data-series-name="纯线无点"]')
|
||||
expect(lineOnlySeries.get('.waveform-chart__line').attributes('data-line-type')).toBe('linear')
|
||||
expect(lineOnlySeries.find('.waveform-chart__points').exists()).toBe(false)
|
||||
|
||||
const triangleSeries = firstFrame.get('.waveform-chart__series[data-series-name="BT2_2M"]')
|
||||
expect(triangleSeries.find('.waveform-chart__line').exists()).toBe(false)
|
||||
expect(triangleSeries.get('.waveform-chart__points').attributes('data-point-type')).toBe(
|
||||
@@ -219,51 +152,59 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
)
|
||||
expect(triangleSeries.get('.waveform-chart__error-bar').attributes('stroke')).toBe('#0960bd')
|
||||
|
||||
const firstFrameLegend = wrapper.get(
|
||||
'.waveform-chart__legend-track[data-legend-track-index="0"]',
|
||||
)
|
||||
const triangleLegendItem = firstFrameLegend
|
||||
.findAll('.waveform-chart__legend-item')
|
||||
.find((item) => item.text().includes('BT2_2M'))
|
||||
expect(triangleLegendItem).toBeDefined()
|
||||
const triangleSwatch = triangleLegendItem!.get('.waveform-legend__swatch')
|
||||
expect(triangleSwatch.find('.waveform-legend__line').exists()).toBe(false)
|
||||
expect(triangleSwatch.get('.waveform-legend__error-bar').attributes()).toMatchObject({
|
||||
d: 'M9 2H17M13 2V14M9 14H17',
|
||||
stroke: '#0960bd',
|
||||
'stroke-width': '1.5',
|
||||
})
|
||||
expect(triangleSwatch.get('.waveform-legend__point').attributes()).toMatchObject({
|
||||
fill: '#0960bd',
|
||||
transform: 'translate(13 8)',
|
||||
})
|
||||
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('splits the attached ENG channels across the remaining first-page frames', async () => {
|
||||
it('renders the three ECharts-style step modes in frame two', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
|
||||
const tracks = wrapper.findAll('.waveform-chart__track')
|
||||
expect(tracks).toHaveLength(4)
|
||||
const secondFrame = wrapper.get('.waveform-chart__track[data-track-index="1"]')
|
||||
const series = secondFrame.findAll('.waveform-chart__series')
|
||||
expect(series.map((item) => item.attributes('data-series-name'))).toEqual([
|
||||
'Step Start',
|
||||
'Step Middle',
|
||||
'Step End',
|
||||
])
|
||||
expect(
|
||||
tracks.map((track) =>
|
||||
track.findAll('.waveform-chart__series').map((item) => item.attributes('data-series-name')),
|
||||
),
|
||||
).toEqual([['BT2_2M'], ['ENG6KV1'], ['ENG4F2YIb3'], ['ENG8KJXAc']])
|
||||
secondFrame.findAll('.waveform-chart__line').map((line) => line.attributes('data-line-type')),
|
||||
).toEqual(['step-start', 'step-middle', 'step-end'])
|
||||
expect(secondFrame.findAll('.waveform-chart__points')).toHaveLength(3)
|
||||
const secondFrameLegend = wrapper.get(
|
||||
'.waveform-chart__legend-track[data-legend-track-index="1"]',
|
||||
)
|
||||
const legendItems = secondFrameLegend.findAll('.waveform-chart__legend-item')
|
||||
expect(legendItems).toHaveLength(3)
|
||||
expect(legendItems.map((item) => item.get('.waveform-legend__line').attributes('d'))).toEqual([
|
||||
'M1 8H25',
|
||||
'M1 8H25',
|
||||
'M1 8H25',
|
||||
])
|
||||
expect(
|
||||
tracks
|
||||
.slice(1)
|
||||
.map((track) => track.get('.waveform-chart__line').attributes('data-line-type')),
|
||||
).toEqual(['linear', 'linear', 'linear'])
|
||||
tracks.slice(1).forEach((track) => {
|
||||
expect(track.find('.waveform-chart__points').exists()).toBe(false)
|
||||
})
|
||||
|
||||
const chartData = wrapper.getComponent(WaveformChart).props('data') as Extract<
|
||||
WaveformData,
|
||||
{ kind: 'series' }
|
||||
>
|
||||
const frameTwoSeries = chartData.series.filter((item) => item.trackId?.startsWith('frame-two-'))
|
||||
expect(frameTwoSeries.map((item) => item.name)).toEqual(['ENG6KV1', 'ENG4F2YIb3', 'ENG8KJXAc'])
|
||||
expect(frameTwoSeries.map((item) => item.unit)).toEqual(['KV', 'KA', 'A'])
|
||||
frameTwoSeries.forEach((item) => {
|
||||
expect(item.data.kind).toBe('points')
|
||||
if (item.data.kind === 'points') {
|
||||
expect(item.data.points).toHaveLength(1000)
|
||||
expect(item.data.points[0]?.x).toBe(-5)
|
||||
}
|
||||
})
|
||||
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
await flushPromises()
|
||||
legendItems.map((item) => item.get('.waveform-legend__point').attributes('fill')),
|
||||
).toEqual(['#5470c6', '#91cc75', '#505372'])
|
||||
expect(
|
||||
wrapper
|
||||
.findAll('.waveform-chart__track')
|
||||
.map((track) => track.get('.waveform-chart__series').attributes('data-series-name')),
|
||||
).toEqual(['BT1_2M', 'TEST_CH_2'])
|
||||
legendItems.map((item) => item.get('.waveform-legend__point').attributes('transform')),
|
||||
).toEqual(['translate(13 8)', 'translate(13 8)', 'translate(13 8)'])
|
||||
|
||||
wrapper.unmount()
|
||||
})
|
||||
@@ -295,7 +236,7 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
expect(renderedTitle().attributes('style')).toContain('font-style: normal')
|
||||
expect(renderedTitle().attributes('style')).toContain('text-decoration: none')
|
||||
|
||||
await wrapper.get('[aria-label="显示标题"]').trigger('click')
|
||||
await wrapper.get('[aria-label="显示标题"]').setValue(false)
|
||||
await flushPromises()
|
||||
expect(wrapper.find('.waveform-chart__title-area').exists()).toBe(false)
|
||||
|
||||
@@ -308,17 +249,17 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
|
||||
const frameControls = wrapper.get('.frame-style-controls')
|
||||
const colorPickers = frameControls.findAllComponents(ColorPicker)
|
||||
const widthInput = frameControls.findAllComponents(InputNumber)[0]
|
||||
const styleSelect = frameControls.findAllComponents(Select)[0]
|
||||
const widthInput = frameControls.get('[aria-label="图框线宽"]')
|
||||
const styleSelect = frameControls.get('[aria-label="图框线型"]')
|
||||
|
||||
expect(colorPickers).toHaveLength(2)
|
||||
expect(widthInput).toBeDefined()
|
||||
expect(styleSelect).toBeDefined()
|
||||
expect(widthInput.element.tagName).toBe('INPUT')
|
||||
expect(styleSelect.element.tagName).toBe('SELECT')
|
||||
|
||||
colorPickers[0].vm.$emit('update:pureColor', 'rgba(220, 38, 38, 0.8)')
|
||||
colorPickers[1].vm.$emit('update:pureColor', 'rgba(14, 165, 233, 0.25)')
|
||||
widthInput?.vm.$emit('update:value', 3)
|
||||
styleSelect?.vm.$emit('update:value', 'dashed')
|
||||
await widthInput.setValue('3')
|
||||
await styleSelect.setValue('dashed')
|
||||
await flushPromises()
|
||||
|
||||
const frames = wrapper.findAll('.waveform-chart__plot-frame')
|
||||
@@ -349,11 +290,11 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
|
||||
expect(initialWatermarks.length).toBeGreaterThan(1)
|
||||
|
||||
await watermarkToggle.trigger('click')
|
||||
await watermarkToggle.setValue(false)
|
||||
await flushPromises()
|
||||
expect(wrapper.findAll('.waveform-chart__watermark')).toHaveLength(0)
|
||||
|
||||
await watermarkToggle.trigger('click')
|
||||
await watermarkToggle.setValue(true)
|
||||
await flushPromises()
|
||||
expect(
|
||||
wrapper.findAll('.waveform-chart__watermark').map((watermark) => watermark.text()),
|
||||
@@ -362,6 +303,23 @@ describe('App workspace layout', { timeout: 20_000 }, () => {
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('updates every visible legend from the alpha-enabled background picker', async () => {
|
||||
const wrapper = mount(App)
|
||||
await flushPromises()
|
||||
|
||||
const colorPicker = wrapper.get('.legend-color-control').getComponent(ColorPicker)
|
||||
colorPicker.vm.$emit('update:pureColor', 'rgba(15, 118, 110, 0.35)')
|
||||
await flushPromises()
|
||||
|
||||
const legendPanels = wrapper.findAll('.waveform-legend__panel')
|
||||
expect(legendPanels.length).toBeGreaterThan(0)
|
||||
legendPanels.forEach((panel) => {
|
||||
expect(panel.attributes('style')).toContain('background-color: rgba(15, 118, 110, 0.35)')
|
||||
})
|
||||
|
||||
wrapper.unmount()
|
||||
})
|
||||
|
||||
it('opens and closes the mobile control drawer', async () => {
|
||||
const wrapper = mount(App)
|
||||
const toggle = wrapper.get('.mobile-control-toggle')
|
||||
|
||||
478
src/App.vue
478
src/App.vue
@@ -1,5 +1,4 @@
|
||||
<script setup lang="ts">
|
||||
import { Button, Input, InputNumber, Radio, Select, Switch } from 'ant-design-vue'
|
||||
import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
|
||||
import { ColorPicker } from 'vue3-colorpicker'
|
||||
import 'vue3-colorpicker/style.css'
|
||||
@@ -7,13 +6,10 @@ import 'vue3-colorpicker/style.css'
|
||||
import {
|
||||
WaveformChart,
|
||||
type WaveformAnnotation,
|
||||
type WaveformAxesOptions,
|
||||
type WaveformData,
|
||||
type WaveformDisplayMode,
|
||||
type WaveformFrameStyle,
|
||||
type WaveformGridTrackLines,
|
||||
type WaveformInteractionMode,
|
||||
type WaveformLineStyle,
|
||||
type WaveformLegendOrientation,
|
||||
type WaveformLegendPosition,
|
||||
type WaveformOverlayMode,
|
||||
@@ -23,7 +19,7 @@ import {
|
||||
type WaveformZeroLineOptions,
|
||||
} from './components'
|
||||
import chartWaveformsJson from './data/chartWaveforms.json'
|
||||
import frameTwoWaveformsJson from './data/frameTwoWaveforms.json'
|
||||
import demoWaveformsJson from './data/demoWaveforms.json'
|
||||
import { normalizeWaveformSeries } from './core'
|
||||
|
||||
interface WaveformSourcePoint {
|
||||
@@ -45,35 +41,19 @@ interface WaveformSourceRow {
|
||||
time_unit: 'ms'
|
||||
}
|
||||
|
||||
interface FrameTwoWaveformRow {
|
||||
chnl: string
|
||||
chnl_id: number
|
||||
dat_unit: string
|
||||
data: number[]
|
||||
time: number[]
|
||||
time_unit: 'ms'
|
||||
}
|
||||
|
||||
const sourceRows = chartWaveformsJson as unknown as WaveformSourceRow[]
|
||||
const displayMode = ref<WaveformDisplayMode>('independent')
|
||||
const overlayMode = ref<WaveformOverlayMode>('single-axis')
|
||||
const rowCount = ref(4)
|
||||
const rowCount = ref(2)
|
||||
const columnCount = ref(1)
|
||||
const frameBorderColor = ref('#1f2937')
|
||||
const frameBorderWidth = ref(1)
|
||||
const frameBorderStyle = ref<NonNullable<WaveformFrameStyle['borderStyle']>>('solid')
|
||||
const frameBorderStyle = ref<'solid' | 'dashed'>('solid')
|
||||
const frameBackgroundColor = ref('rgba(255, 255, 255, 0)')
|
||||
const frameWatermarkVisible = ref(true)
|
||||
const horizontalGridVisible = ref(true)
|
||||
const horizontalGridColor = ref('#dfe5ef')
|
||||
const verticalGridVisible = ref(true)
|
||||
const verticalGridColor = ref('#dfe5ef')
|
||||
const xAxisLineVisible = ref(false)
|
||||
const yAxisLineVisible = ref(false)
|
||||
const annotations = ref<WaveformAnnotation[]>([])
|
||||
const annotationsVisible = ref(true)
|
||||
const cleanView = ref(false)
|
||||
const showTooltip = ref(true)
|
||||
const zeroLineVisible = ref(false)
|
||||
const zeroLineColor = ref('#98a2b3')
|
||||
const zeroLineWidth = ref(1)
|
||||
@@ -112,7 +92,6 @@ const legendOrientationOptions: Array<{ label: string; value: WaveformLegendOrie
|
||||
const frameBorderStyleOptions = [
|
||||
{ label: '实线', value: 'solid' },
|
||||
{ label: '虚线', value: 'dashed' },
|
||||
{ label: '点虚线', value: 'dotted' },
|
||||
]
|
||||
const zeroLineDashOptions = [
|
||||
{ label: '虚线', value: '6 4' },
|
||||
@@ -140,10 +119,6 @@ const frameStyle = computed<WaveformFrameStyle>(() => ({
|
||||
borderStyle: frameBorderStyle.value,
|
||||
backgroundColor: frameBackgroundColor.value,
|
||||
}))
|
||||
const axes = computed<WaveformAxesOptions>(() => ({
|
||||
x: { lineVisible: xAxisLineVisible.value },
|
||||
y: { lineVisible: yAxisLineVisible.value },
|
||||
}))
|
||||
const zeroLine = computed<WaveformZeroLineOptions>(() => ({
|
||||
visible: zeroLineVisible.value,
|
||||
color: zeroLineColor.value,
|
||||
@@ -180,32 +155,54 @@ const waveformSeries: WaveformSeries[] = sourceRows.map((row, seriesIndex) => {
|
||||
}
|
||||
})
|
||||
|
||||
const frameTwoWaveforms = frameTwoWaveformsJson as FrameTwoWaveformRow[]
|
||||
const frameTwoSeries: WaveformSeries[] = frameTwoWaveforms.map((series) => ({
|
||||
id: String(series.chnl_id),
|
||||
trackId: `frame-two-${series.chnl_id}`,
|
||||
name: series.chnl,
|
||||
unit: series.dat_unit.trim(),
|
||||
lineType: 'linear',
|
||||
pointType: 'none',
|
||||
const demoWaveforms = demoWaveformsJson as {
|
||||
stepDemoValues: Array<{
|
||||
id: string
|
||||
name: string
|
||||
color: string
|
||||
lineType: 'step-start' | 'step-middle' | 'step-end'
|
||||
values: number[]
|
||||
}>
|
||||
basicCurveDemoSeries: Array<{
|
||||
id: string
|
||||
name: string
|
||||
color: string
|
||||
lineType: 'none' | 'linear'
|
||||
pointType: 'circle' | 'none'
|
||||
points: Array<{ x: number; y: number }>
|
||||
}>
|
||||
}
|
||||
|
||||
const stepDemoSeries: WaveformSeries[] = demoWaveforms.stepDemoValues.map((series) => ({
|
||||
id: series.id,
|
||||
trackId: 'step-demo',
|
||||
name: series.name,
|
||||
color: series.color,
|
||||
lineType: series.lineType,
|
||||
pointType: 'circle',
|
||||
data: {
|
||||
kind: 'points',
|
||||
points: series.data.flatMap((y, index) => {
|
||||
const time = series.time[index]
|
||||
return Number.isFinite(time) && Number.isFinite(y) ? [{ x: time! / 1000, y }] : []
|
||||
}),
|
||||
points: series.values.map((y, index) => ({ x: index / 1000, y })),
|
||||
},
|
||||
}))
|
||||
|
||||
const frameOneTrackId = String(sourceRows[0]?.chnl_id ?? 'frame-one')
|
||||
const frameOneCandidates = waveformSeries.filter(
|
||||
const basicCurveDemoSeries: WaveformSeries[] = demoWaveforms.basicCurveDemoSeries.map((series) => ({
|
||||
id: series.id,
|
||||
trackId: frameOneTrackId,
|
||||
name: series.name,
|
||||
color: series.color,
|
||||
lineType: series.lineType,
|
||||
pointType: series.pointType,
|
||||
data: { kind: 'points', points: series.points },
|
||||
}))
|
||||
const frameOneSeries = waveformSeries.filter(
|
||||
(series) => series.id === frameOneTrackId || series.trackId === frameOneTrackId,
|
||||
)
|
||||
const frameOneSeries = frameOneCandidates.filter((series) => series.errorBar?.visible).slice(0, 1)
|
||||
const remainingSeries = waveformSeries.filter((series) => !frameOneCandidates.includes(series))
|
||||
const remainingSeries = waveformSeries.filter((series) => !frameOneSeries.includes(series))
|
||||
const fullChartData: WaveformData = {
|
||||
kind: 'series',
|
||||
series: [...frameOneSeries, ...frameTwoSeries, ...remainingSeries],
|
||||
series: [...frameOneSeries, ...basicCurveDemoSeries, ...stepDemoSeries, ...remainingSeries],
|
||||
}
|
||||
const initialXValues = normalizeWaveformSeries(fullChartData).flatMap((series) =>
|
||||
series.points.map((point) => point.x),
|
||||
@@ -224,51 +221,6 @@ const initialXDomainValue: [number, number] | undefined =
|
||||
// Keep the full source domain stable while viewport data windows are replaced.
|
||||
const initialXDomain = ref<[number, number] | undefined>(initialXDomainValue)
|
||||
const chartData = ref<WaveformData>(fullChartData)
|
||||
const lineStyleOverrides = ref<Record<string, WaveformLineStyle>>({})
|
||||
const selectedSeriesId = ref(String(sourceRows[0]?.chnl_id ?? ''))
|
||||
const lineStyleOptions: Array<{ label: string; value: WaveformLineStyle }> = [
|
||||
{ label: '实线', value: 'solid' },
|
||||
{ label: '虚线', value: 'dashed' },
|
||||
{ label: '点划线', value: 'dash-dot' },
|
||||
]
|
||||
const seriesStyleOptions = computed(() =>
|
||||
normalizeWaveformSeries(chartData.value).map((series) => ({
|
||||
label: series.name || series.id,
|
||||
value: series.id,
|
||||
})),
|
||||
)
|
||||
const selectedLineStyle = computed<WaveformLineStyle>({
|
||||
get: () => lineStyleOverrides.value[selectedSeriesId.value] ?? 'solid',
|
||||
set: (value) => {
|
||||
if (!selectedSeriesId.value) return
|
||||
lineStyleOverrides.value = { ...lineStyleOverrides.value, [selectedSeriesId.value]: value }
|
||||
},
|
||||
})
|
||||
const displayChartData = computed<WaveformData>(() => {
|
||||
if (chartData.value.kind !== 'series') return chartData.value
|
||||
return {
|
||||
...chartData.value,
|
||||
series: chartData.value.series.map((series) => ({
|
||||
...series,
|
||||
...(lineStyleOverrides.value[series.id ?? '']
|
||||
? { lineStyle: lineStyleOverrides.value[series.id ?? ''] }
|
||||
: {}),
|
||||
})),
|
||||
}
|
||||
})
|
||||
const gridTrackLines = computed<WaveformGridTrackLines>(() =>
|
||||
Object.fromEntries(
|
||||
normalizeWaveformSeries(displayChartData.value).map((series) => [
|
||||
series.trackId ?? series.id,
|
||||
{
|
||||
horizontal: horizontalGridVisible.value,
|
||||
vertical: verticalGridVisible.value,
|
||||
horizontalColor: horizontalGridColor.value,
|
||||
verticalColor: verticalGridColor.value,
|
||||
},
|
||||
]),
|
||||
),
|
||||
)
|
||||
const waveformChartRef = ref<{ resetViewport: (trackIndex?: number) => void }>()
|
||||
|
||||
let zoomRequestSequence = 0
|
||||
@@ -360,6 +312,12 @@ function resetTitleTextStyle() {
|
||||
titleUnderline.value = false
|
||||
}
|
||||
|
||||
function clampNumber(value: unknown, min: number, max: number, fallback: number) {
|
||||
const number = typeof value === 'number' ? value : Number(value)
|
||||
if (!Number.isFinite(number)) return fallback
|
||||
return Math.min(max, Math.max(min, number))
|
||||
}
|
||||
|
||||
function handleWindowKeydown(event: KeyboardEvent) {
|
||||
if (event.key === 'Escape') closeControls()
|
||||
}
|
||||
@@ -370,15 +328,15 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
|
||||
<template>
|
||||
<main class="workspace">
|
||||
<Button
|
||||
<button
|
||||
type="button"
|
||||
class="mobile-control-toggle"
|
||||
size="small"
|
||||
:aria-expanded="controlsOpen"
|
||||
aria-controls="waveform-control-panel"
|
||||
@click="controlsOpen = true"
|
||||
>
|
||||
控制面板
|
||||
</Button>
|
||||
</button>
|
||||
|
||||
<button
|
||||
v-if="controlsOpen"
|
||||
@@ -395,80 +353,65 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
aria-label="波形图控制"
|
||||
>
|
||||
<div class="control-panel__scroll">
|
||||
<Button class="control-panel__close" type="text" size="small" @click="closeControls">
|
||||
关闭
|
||||
</Button>
|
||||
<button class="control-panel__close" type="button" @click="closeControls">关闭</button>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>显示方式</h2>
|
||||
<Radio.Group
|
||||
v-model:value="displayMode"
|
||||
class="display-mode-control"
|
||||
button-style="solid"
|
||||
size="small"
|
||||
aria-label="波形展示方式"
|
||||
>
|
||||
<Radio.Button value="independent">单独坐标</Radio.Button>
|
||||
<Radio.Button value="separated">多道分离</Radio.Button>
|
||||
<Radio.Button value="compact">多道紧凑</Radio.Button>
|
||||
</Radio.Group>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>叠加方式</h2>
|
||||
<Radio.Group
|
||||
v-model:value="overlayMode"
|
||||
class="display-mode-control"
|
||||
button-style="solid"
|
||||
size="small"
|
||||
aria-label="波形叠加方式"
|
||||
>
|
||||
<Radio.Button value="single-axis">单值轴</Radio.Button>
|
||||
<Radio.Button value="multi-axis">多值轴</Radio.Button>
|
||||
</Radio.Group>
|
||||
<div class="display-mode-control" role="radiogroup" aria-label="波形展示方式">
|
||||
<label
|
||||
><input v-model="displayMode" type="radio" value="independent" /><span
|
||||
>单独坐标</span
|
||||
></label
|
||||
>
|
||||
<label
|
||||
><input v-model="displayMode" type="radio" value="separated" /><span
|
||||
>多道分离</span
|
||||
></label
|
||||
>
|
||||
<label
|
||||
><input v-model="displayMode" type="radio" value="compact" /><span
|
||||
>多道紧凑</span
|
||||
></label
|
||||
>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>视图</h2>
|
||||
<Button block aria-label="重置波形视图" @click="resetWaveformViewport">重置视图</Button>
|
||||
<button
|
||||
type="button"
|
||||
class="control-action control-action--block"
|
||||
aria-label="重置波形视图"
|
||||
@click="resetWaveformViewport"
|
||||
>
|
||||
重置视图
|
||||
</button>
|
||||
<div class="auxiliary-style-controls" style="margin-top: 10px">
|
||||
<label class="frame-style-control frame-style-control--switch">
|
||||
<span>数值 Tooltip</span>
|
||||
<Switch v-model:checked="showTooltip" size="small" aria-label="显示数值 Tooltip" />
|
||||
</label>
|
||||
<label class="frame-style-control frame-style-control--switch">
|
||||
<span>净图</span>
|
||||
<Switch v-model:checked="cleanView" size="small" aria-label="净图模式" />
|
||||
<input
|
||||
v-model="cleanView"
|
||||
class="native-switch"
|
||||
type="checkbox"
|
||||
role="switch"
|
||||
aria-label="净图模式"
|
||||
@click.stop
|
||||
/>
|
||||
</label>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>波形线型</h2>
|
||||
<label class="select-control">
|
||||
<span>波形</span>
|
||||
<Select
|
||||
v-model:value="selectedSeriesId"
|
||||
:options="seriesStyleOptions"
|
||||
size="small"
|
||||
aria-label="选择波形线型"
|
||||
/>
|
||||
</label>
|
||||
<label class="select-control">
|
||||
<span>线型</span>
|
||||
<Select
|
||||
v-model:value="selectedLineStyle"
|
||||
:options="lineStyleOptions"
|
||||
size="small"
|
||||
aria-label="设置波形线型"
|
||||
/>
|
||||
</label>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<div class="control-section__header">
|
||||
<h2>零值参考线</h2>
|
||||
<Switch v-model:checked="zeroLineVisible" size="small" aria-label="显示零值参考线" />
|
||||
<input
|
||||
v-model="zeroLineVisible"
|
||||
class="native-switch"
|
||||
type="checkbox"
|
||||
role="switch"
|
||||
aria-label="显示零值参考线"
|
||||
@click.stop
|
||||
/>
|
||||
</div>
|
||||
<div class="auxiliary-style-controls zero-line-controls" style="margin-top: 10px">
|
||||
<label class="frame-style-control">
|
||||
@@ -485,88 +428,77 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
</label>
|
||||
<label class="frame-style-control">
|
||||
<span>线宽</span>
|
||||
<InputNumber
|
||||
v-model:value="zeroLineWidth"
|
||||
<input
|
||||
v-model.number="zeroLineWidth"
|
||||
class="native-input"
|
||||
type="number"
|
||||
:min="0.5"
|
||||
:max="10"
|
||||
:step="0.5"
|
||||
size="small"
|
||||
aria-label="零值参考线线宽"
|
||||
@blur="zeroLineWidth = clampNumber(zeroLineWidth, 0.5, 10, 1)"
|
||||
/>
|
||||
</label>
|
||||
<label class="frame-style-control">
|
||||
<span>线型</span>
|
||||
<Select
|
||||
v-model:value="zeroLineDash"
|
||||
:options="zeroLineDashOptions"
|
||||
size="small"
|
||||
aria-label="零值参考线线型"
|
||||
/>
|
||||
<select v-model="zeroLineDash" class="native-select" aria-label="零值参考线线型">
|
||||
<option
|
||||
v-for="option in zeroLineDashOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>叠加方式</h2>
|
||||
<div class="display-mode-control" role="radiogroup" aria-label="波形叠加方式">
|
||||
<label
|
||||
><input v-model="overlayMode" type="radio" value="single-axis" /><span
|
||||
>单值轴</span
|
||||
></label
|
||||
>
|
||||
<label
|
||||
><input v-model="overlayMode" type="radio" value="multi-axis" /><span
|
||||
>多值轴</span
|
||||
></label
|
||||
>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>图框布局</h2>
|
||||
<div class="grid-size-control" aria-label="波形网格尺寸">
|
||||
<InputNumber v-model:value="rowCount" :min="1" :max="10" size="small" />
|
||||
<input
|
||||
v-model.number="rowCount"
|
||||
class="native-input"
|
||||
type="number"
|
||||
min="1"
|
||||
max="10"
|
||||
step="1"
|
||||
aria-label="波形网格行数"
|
||||
@blur="rowCount = clampNumber(rowCount, 1, 10, 2)"
|
||||
/>
|
||||
<span>行</span>
|
||||
<span class="control-separator">×</span>
|
||||
<InputNumber v-model:value="columnCount" :min="1" :max="10" size="small" />
|
||||
<input
|
||||
v-model.number="columnCount"
|
||||
class="native-input"
|
||||
type="number"
|
||||
min="1"
|
||||
max="10"
|
||||
step="1"
|
||||
aria-label="波形网格列数"
|
||||
@blur="columnCount = clampNumber(columnCount, 1, 10, 1)"
|
||||
/>
|
||||
<span>列</span>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>网格与轴线</h2>
|
||||
<div class="grid-line-controls">
|
||||
<div class="grid-line-control">
|
||||
<span>水平网格</span>
|
||||
<Switch
|
||||
v-model:checked="horizontalGridVisible"
|
||||
size="small"
|
||||
aria-label="显示水平网格线"
|
||||
/>
|
||||
<span class="grid-line-color-picker" role="group" aria-label="水平网格线颜色">
|
||||
<ColorPicker
|
||||
v-model:pure-color="horizontalGridColor"
|
||||
use-type="pure"
|
||||
picker-type="chrome"
|
||||
format="hex"
|
||||
:disable-alpha="true"
|
||||
:blur-close="true"
|
||||
/>
|
||||
</span>
|
||||
</div>
|
||||
<div class="grid-line-control">
|
||||
<span>垂直网格</span>
|
||||
<Switch
|
||||
v-model:checked="verticalGridVisible"
|
||||
size="small"
|
||||
aria-label="显示垂直网格线"
|
||||
/>
|
||||
<span class="grid-line-color-picker" role="group" aria-label="垂直网格线颜色">
|
||||
<ColorPicker
|
||||
v-model:pure-color="verticalGridColor"
|
||||
use-type="pure"
|
||||
picker-type="chrome"
|
||||
format="hex"
|
||||
:disable-alpha="true"
|
||||
:blur-close="true"
|
||||
/>
|
||||
</span>
|
||||
</div>
|
||||
<div class="grid-line-control grid-line-control--switch-only">
|
||||
<span>横轴线</span>
|
||||
<Switch v-model:checked="xAxisLineVisible" size="small" aria-label="显示横轴线" />
|
||||
</div>
|
||||
<div class="grid-line-control grid-line-control--switch-only">
|
||||
<span>纵轴线</span>
|
||||
<Switch v-model:checked="yAxisLineVisible" size="small" aria-label="显示纵轴线" />
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="control-section">
|
||||
<h2>图框样式</h2>
|
||||
<div class="frame-style-controls">
|
||||
@@ -596,30 +528,38 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
</label>
|
||||
<label class="frame-style-control">
|
||||
<span>线宽</span>
|
||||
<InputNumber
|
||||
v-model:value="frameBorderWidth"
|
||||
<input
|
||||
v-model.number="frameBorderWidth"
|
||||
class="native-input"
|
||||
type="number"
|
||||
:min="0"
|
||||
:max="10"
|
||||
:step="0.5"
|
||||
size="small"
|
||||
aria-label="图框线宽"
|
||||
@blur="frameBorderWidth = clampNumber(frameBorderWidth, 0, 10, 1)"
|
||||
/>
|
||||
</label>
|
||||
<label class="frame-style-control">
|
||||
<span>线型</span>
|
||||
<Select
|
||||
v-model:value="frameBorderStyle"
|
||||
:options="frameBorderStyleOptions"
|
||||
size="small"
|
||||
aria-label="图框线型"
|
||||
/>
|
||||
<select v-model="frameBorderStyle" class="native-select" aria-label="图框线型">
|
||||
<option
|
||||
v-for="option in frameBorderStyleOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="frame-style-control frame-style-control--switch">
|
||||
<span>水印</span>
|
||||
<Switch
|
||||
v-model:checked="frameWatermarkVisible"
|
||||
size="small"
|
||||
<input
|
||||
v-model="frameWatermarkVisible"
|
||||
class="native-switch"
|
||||
type="checkbox"
|
||||
role="switch"
|
||||
aria-label="显示图框水印"
|
||||
@click.stop
|
||||
/>
|
||||
</label>
|
||||
</div>
|
||||
@@ -628,41 +568,56 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
<section class="control-section title-control-section">
|
||||
<div class="control-section__header">
|
||||
<h2>标题</h2>
|
||||
<Switch v-model:checked="titleVisible" size="small" aria-label="显示标题" />
|
||||
<input
|
||||
v-model="titleVisible"
|
||||
class="native-switch"
|
||||
type="checkbox"
|
||||
role="switch"
|
||||
aria-label="显示标题"
|
||||
@click.stop
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div class="title-controls">
|
||||
<label class="title-control title-control--wide">
|
||||
<span>标题名称</span>
|
||||
<Input v-model:value="titleText" size="small" aria-label="标题名称" />
|
||||
<input v-model="titleText" class="native-input" type="text" aria-label="标题名称" />
|
||||
</label>
|
||||
<label class="title-control title-control--wide">
|
||||
<span>对齐方式</span>
|
||||
<Select
|
||||
v-model:value="titleAlign"
|
||||
:options="titleAlignOptions"
|
||||
size="small"
|
||||
aria-label="标题对齐方式"
|
||||
/>
|
||||
<select v-model="titleAlign" class="native-select" aria-label="标题对齐方式">
|
||||
<option
|
||||
v-for="option in titleAlignOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="title-control">
|
||||
<span>字体</span>
|
||||
<Select
|
||||
v-model:value="titleFontFamily"
|
||||
:options="titleFontFamilyOptions"
|
||||
size="small"
|
||||
aria-label="标题字体"
|
||||
/>
|
||||
<select v-model="titleFontFamily" class="native-select" aria-label="标题字体">
|
||||
<option
|
||||
v-for="option in titleFontFamilyOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="title-control">
|
||||
<span>字号</span>
|
||||
<InputNumber
|
||||
v-model:value="titleFontSize"
|
||||
<input
|
||||
v-model.number="titleFontSize"
|
||||
class="native-input"
|
||||
type="number"
|
||||
:min="8"
|
||||
:max="72"
|
||||
:step="1"
|
||||
size="small"
|
||||
aria-label="标题字号"
|
||||
@blur="titleFontSize = clampNumber(titleFontSize, 8, 72, 14)"
|
||||
/>
|
||||
</label>
|
||||
<div class="title-control">
|
||||
@@ -710,14 +665,15 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
</div>
|
||||
<label class="title-control">
|
||||
<span>旋转</span>
|
||||
<InputNumber
|
||||
v-model:value="titleRotation"
|
||||
<input
|
||||
v-model.number="titleRotation"
|
||||
class="native-input"
|
||||
type="number"
|
||||
:min="-180"
|
||||
:max="180"
|
||||
:step="1"
|
||||
addon-after="°"
|
||||
size="small"
|
||||
aria-label="标题旋转角度"
|
||||
@blur="titleRotation = clampNumber(titleRotation, -180, 180, 0)"
|
||||
/>
|
||||
</label>
|
||||
<div class="title-control title-control--color">
|
||||
@@ -739,21 +695,27 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
<h2>图例</h2>
|
||||
<label class="select-control">
|
||||
<span>位置</span>
|
||||
<Select
|
||||
v-model:value="legendPosition"
|
||||
:options="legendPositionOptions"
|
||||
size="small"
|
||||
aria-label="图例位置"
|
||||
/>
|
||||
<select v-model="legendPosition" class="native-select" aria-label="图例位置">
|
||||
<option
|
||||
v-for="option in legendPositionOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="select-control">
|
||||
<span>排列</span>
|
||||
<Select
|
||||
v-model:value="legendOrientation"
|
||||
:options="legendOrientationOptions"
|
||||
size="small"
|
||||
aria-label="图例排列"
|
||||
/>
|
||||
<select v-model="legendOrientation" class="native-select" aria-label="图例排列">
|
||||
<option
|
||||
v-for="option in legendOrientationOptions"
|
||||
:key="option.value"
|
||||
:value="option.value"
|
||||
>
|
||||
{{ option.label }}
|
||||
</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="legend-color-control">
|
||||
<span>背景</span>
|
||||
@@ -774,13 +736,13 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
<section class="chart-panel">
|
||||
<WaveformChart
|
||||
ref="waveformChartRef"
|
||||
:data="displayChartData"
|
||||
:data="chartData"
|
||||
:min-zoom-span="minZoomSpan"
|
||||
:min-visible-points="5"
|
||||
:initial-x-domain="initialXDomain"
|
||||
:display-mode="displayMode"
|
||||
:overlay-mode="overlayMode"
|
||||
:grid="{ rowCount, columnCount, showPagination: true, trackLines: gridTrackLines }"
|
||||
:grid="{ rowCount, columnCount, showPagination: true }"
|
||||
:title="titleOptions"
|
||||
:legend="{
|
||||
position: legendPosition,
|
||||
@@ -789,9 +751,7 @@ onBeforeUnmount(() => window.removeEventListener('keydown', handleWindowKeydown)
|
||||
interactive: true,
|
||||
}"
|
||||
:frame-style="frameStyle"
|
||||
:axes="axes"
|
||||
:clean-view="cleanView"
|
||||
:show-tooltip="showTooltip"
|
||||
:zero-line="zeroLine"
|
||||
:frame-number="frameWatermarkVisible ? 1 : undefined"
|
||||
v-model:annotations="annotations"
|
||||
|
||||
@@ -4,11 +4,7 @@ import { describe, expect, it, vi } from 'vitest'
|
||||
import { flushAnimationFrames, pendingAnimationFrameCount, resizeObservers } from '../test/setup'
|
||||
import WaveformChart from './WaveformChart.vue'
|
||||
import { prepareWaveformSeries } from './core/useWaveformData'
|
||||
import {
|
||||
waveformLegendErrorBarPath,
|
||||
waveformLegendLinePath,
|
||||
waveformLineDasharray,
|
||||
} from './rendering/seriesStyle'
|
||||
import { waveformLegendErrorBarPath, waveformLegendLinePath } from './rendering/seriesStyle'
|
||||
import { normalizeWaveformData, normalizeWaveformSeries, type WaveformData } from './waveform'
|
||||
|
||||
async function mountSizedChart(data: WaveformData, extraProps = {}) {
|
||||
@@ -56,29 +52,6 @@ describe('normalizeWaveformData', () => {
|
||||
expect(normalizeWaveformData({ kind: 'samples', values: [1, 2], sampleRate: 0 })).toEqual([])
|
||||
})
|
||||
|
||||
it('keeps large-data error extrema in the prepared Y domain', () => {
|
||||
const points = Array.from({ length: 10_001 }, (_, index) => ({
|
||||
x: index,
|
||||
y: 0,
|
||||
...(index === 5_555 ? { error: 10_000 } : {}),
|
||||
}))
|
||||
const [series] = prepareWaveformSeries({
|
||||
kind: 'series',
|
||||
series: [
|
||||
{
|
||||
name: 'errors',
|
||||
errorBar: { visible: true },
|
||||
data: { kind: 'points', points },
|
||||
},
|
||||
],
|
||||
})
|
||||
|
||||
expect(series?.points).toHaveLength(points.length)
|
||||
expect(series?.hasErrorPoints).toBe(true)
|
||||
expect(series?.yDomain[0]).toBeLessThanOrEqual(-10_000)
|
||||
expect(series?.yDomain[1]).toBeGreaterThanOrEqual(10_000)
|
||||
})
|
||||
|
||||
it('normalizes errors and preserves a pure error-bar series', () => {
|
||||
const [series] = normalizeWaveformSeries({
|
||||
kind: 'series',
|
||||
@@ -151,7 +124,6 @@ describe('normalizeWaveformData', () => {
|
||||
|
||||
expect(series?.yDomain[0]).toBeLessThanOrEqual(-1)
|
||||
expect(series?.yDomain[1]).toBeGreaterThanOrEqual(6)
|
||||
expect(series?.hasErrorPoints).toBe(true)
|
||||
})
|
||||
|
||||
it('normalizes multiple named series and removes empty series', () => {
|
||||
@@ -179,7 +151,6 @@ describe('normalizeWaveformData', () => {
|
||||
unit: 'T',
|
||||
color: undefined,
|
||||
lineType: 'linear',
|
||||
lineStyle: 'solid',
|
||||
pointType: 'none',
|
||||
errorBar: { visible: false, width: 1.5, capWidth: 8 },
|
||||
points: [{ x: 1, y: 2 }],
|
||||
@@ -198,9 +169,6 @@ describe('legend series geometry', () => {
|
||||
expect(waveformLegendLinePath('none')).toBeNull()
|
||||
expect(waveformLegendErrorBarPath(10)).toBe('M8 2H18M13 2V14M8 14H18')
|
||||
expect(waveformLegendErrorBarPath(100)).toBe('M1 2H25M13 2V14M1 14H25')
|
||||
expect(waveformLineDasharray('solid')).toBeUndefined()
|
||||
expect(waveformLineDasharray('dashed')).toBe('8 5')
|
||||
expect(waveformLineDasharray('dash-dot')).toBe('8 5 1.5 5')
|
||||
})
|
||||
})
|
||||
|
||||
@@ -252,26 +220,6 @@ describe('WaveformChart', () => {
|
||||
second.unmount()
|
||||
})
|
||||
|
||||
it('does not reuse Y scales between chart instances with the same default series ID', async () => {
|
||||
const first = await mountSizedChart({
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 1 },
|
||||
],
|
||||
})
|
||||
const second = await mountSizedChart({
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: 10_000 },
|
||||
{ x: 1, y: 20_000 },
|
||||
],
|
||||
})
|
||||
|
||||
expect(first.find('.waveform-chart__axis-exponent--y').exists()).toBe(false)
|
||||
expect(second.get('.waveform-chart__axis-exponent--y').text()).toBe('E+04')
|
||||
})
|
||||
|
||||
it('renders a configurable zero line only when the Y domain contains zero', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
@@ -349,75 +297,6 @@ describe('WaveformChart', () => {
|
||||
expect(zeroLines[0].attributes('y1')).not.toBe(zeroLines[1].attributes('y1'))
|
||||
})
|
||||
|
||||
it('hides X and Y axis lines independently while preserving axis text and the frame', async () => {
|
||||
const wrapper = await mountSizedChart({
|
||||
kind: 'series',
|
||||
series: [
|
||||
{
|
||||
id: 'channel',
|
||||
name: 'Voltage',
|
||||
data: {
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: -1 },
|
||||
{ x: 1, y: 1 },
|
||||
],
|
||||
},
|
||||
},
|
||||
],
|
||||
})
|
||||
const xAxis = wrapper.get('.waveform-chart__axis--x')
|
||||
const yAxis = wrapper.get('.waveform-chart__axis--y')
|
||||
|
||||
expect(xAxis.classes()).not.toContain('waveform-track__axis--line-hidden')
|
||||
expect(yAxis.classes()).not.toContain('waveform-track__axis--line-hidden')
|
||||
|
||||
await wrapper.setProps({ axes: { x: { lineVisible: false } } })
|
||||
await flushPromises()
|
||||
expect(xAxis.classes()).toContain('waveform-track__axis--line-hidden')
|
||||
expect(yAxis.classes()).not.toContain('waveform-track__axis--line-hidden')
|
||||
expect(xAxis.get('path.domain').attributes('display')).toBe('none')
|
||||
expect(
|
||||
xAxis.findAll('.tick line').every((line) => line.attributes('display') === undefined),
|
||||
).toBe(true)
|
||||
expect(yAxis.get('path.domain').attributes('display')).toBeUndefined()
|
||||
|
||||
await wrapper.setProps({
|
||||
axes: {
|
||||
x: { lineVisible: false },
|
||||
y: { lineVisible: false },
|
||||
},
|
||||
grid: {
|
||||
rowCount: 1,
|
||||
columnCount: 1,
|
||||
trackLines: { channel: { horizontal: false, vertical: false } },
|
||||
},
|
||||
frameStyle: { borderColor: '#dc2626', borderWidth: 2 },
|
||||
})
|
||||
await flushPromises()
|
||||
|
||||
expect(xAxis.classes()).toContain('waveform-track__axis--line-hidden')
|
||||
expect(yAxis.classes()).toContain('waveform-track__axis--line-hidden')
|
||||
expect(yAxis.get('path.domain').attributes('display')).toBe('none')
|
||||
expect(
|
||||
yAxis.findAll('.tick line').every((line) => line.attributes('display') === undefined),
|
||||
).toBe(true)
|
||||
expect(xAxis.findAll('text').length).toBeGreaterThan(0)
|
||||
expect(yAxis.findAll('text').length).toBeGreaterThan(0)
|
||||
expect(wrapper.findAll('.waveform-chart__axis-endpoint')).toHaveLength(2)
|
||||
expect(wrapper.get('.waveform-chart__y-axis-label').text()).toBe('Voltage')
|
||||
expect(wrapper.findAll('[data-grid-direction]')).toHaveLength(0)
|
||||
expect(wrapper.get('.waveform-chart__plot-frame').attributes()).toMatchObject({
|
||||
stroke: '#dc2626',
|
||||
'stroke-width': '2',
|
||||
})
|
||||
|
||||
await wrapper.setProps({ axes: { x: { lineVisible: true }, y: { lineVisible: true } } })
|
||||
await flushPromises()
|
||||
expect(xAxis.get('path.domain').attributes('display')).toBeUndefined()
|
||||
expect(yAxis.get('path.domain').attributes('display')).toBeUndefined()
|
||||
})
|
||||
|
||||
it('preserves a titled multi-axis plot and hides auxiliary layers in clean view', async () => {
|
||||
const data: WaveformData = {
|
||||
kind: 'series',
|
||||
@@ -508,7 +387,7 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.find('.waveform-chart__label').exists()).toBe(false)
|
||||
expect(wrapper.find('.waveform-chart__zero-line').exists()).toBe(false)
|
||||
expect(wrapper.find('.waveform-annotation-layer').exists()).toBe(false)
|
||||
expect(wrapper.find('.ant-pagination').exists()).toBe(false)
|
||||
expect(wrapper.find('.waveform-chart__pagination').exists()).toBe(false)
|
||||
})
|
||||
|
||||
it('preserves every track geometry in a multi-column clean view', async () => {
|
||||
@@ -598,7 +477,6 @@ describe('WaveformChart', () => {
|
||||
trackId: 'styled-track',
|
||||
name: '纯线',
|
||||
lineType: 'linear',
|
||||
lineStyle: 'dashed',
|
||||
pointType: 'none',
|
||||
data: {
|
||||
kind: 'points',
|
||||
@@ -613,7 +491,6 @@ describe('WaveformChart', () => {
|
||||
trackId: 'styled-track',
|
||||
name: '阶梯误差',
|
||||
lineType: 'step-after',
|
||||
lineStyle: 'dash-dot',
|
||||
pointType: 'circle',
|
||||
errorBar: { visible: true, color: '#222222', width: 2, capWidth: 10 },
|
||||
data: {
|
||||
@@ -647,13 +524,6 @@ describe('WaveformChart', () => {
|
||||
)
|
||||
const stepLine = wrapper.get('.waveform-chart__line[data-series-id="step-errors"]')
|
||||
expect(stepLine.attributes('data-line-type')).toBe('step-after')
|
||||
expect(stepLine.attributes('data-line-style')).toBe('dash-dot')
|
||||
expect(stepLine.attributes('stroke-dasharray')).toBe('8 5 1.5 5')
|
||||
expect(
|
||||
wrapper
|
||||
.get('.waveform-chart__line[data-series-id="line-only"]')
|
||||
.attributes('stroke-dasharray'),
|
||||
).toBe('8 5')
|
||||
expect(stepLine.attributes('d')).toMatch(/^M[\d.-]+,([\d.-]+)L[\d.-]+,\1L/)
|
||||
expect(
|
||||
wrapper
|
||||
@@ -685,16 +555,6 @@ describe('WaveformChart', () => {
|
||||
'none',
|
||||
])
|
||||
expect(swatches[0]?.attributes('data-error-bar-visible')).toBe('true')
|
||||
expect(swatches.map((swatch) => swatch.attributes('data-line-style'))).toEqual([
|
||||
'solid',
|
||||
'dashed',
|
||||
'dash-dot',
|
||||
'solid',
|
||||
])
|
||||
expect(swatches[1]?.get('.waveform-legend__line').attributes('stroke-dasharray')).toBe('8 5')
|
||||
expect(swatches[2]?.get('.waveform-legend__line').attributes('stroke-dasharray')).toBe(
|
||||
'8 5 1.5 5',
|
||||
)
|
||||
expect(swatches[2]?.attributes('data-error-bar-visible')).toBe('true')
|
||||
expect(swatches[3]?.attributes('data-error-bar-visible')).toBe('true')
|
||||
expect(swatches[0]!.findAll('path').map((path) => path.classes())).toEqual([
|
||||
@@ -944,11 +804,11 @@ describe('WaveformChart', () => {
|
||||
expect(
|
||||
wrapper.findAll('.waveform-chart__line').map((line) => line.attributes('data-series-id')),
|
||||
).toEqual(['channel-0', 'channel-1'])
|
||||
const previousButton = () => wrapper.get('.ant-pagination-prev button')
|
||||
const nextButton = () => wrapper.get('.ant-pagination-next button')
|
||||
const previousButton = () => wrapper.get('[aria-label="上一页"]')
|
||||
const nextButton = () => wrapper.get('[aria-label="下一页"]')
|
||||
|
||||
expect(wrapper.get('.ant-pagination-item-1').classes()).toContain('ant-pagination-item-active')
|
||||
expect(wrapper.get('.ant-pagination-prev').classes()).toContain('ant-pagination-disabled')
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('1')
|
||||
expect(previousButton().attributes('disabled')).toBeDefined()
|
||||
|
||||
await nextButton().trigger('click')
|
||||
expect(
|
||||
@@ -957,7 +817,7 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.emitted('page-change')?.at(-1)).toEqual([2, 3])
|
||||
|
||||
await previousButton().trigger('click')
|
||||
expect(wrapper.get('.ant-pagination-item-1').classes()).toContain('ant-pagination-item-active')
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('1')
|
||||
expect(wrapper.emitted('page-change')?.at(-1)).toEqual([1, 3])
|
||||
|
||||
await nextButton().trigger('click')
|
||||
@@ -965,8 +825,8 @@ describe('WaveformChart', () => {
|
||||
expect(
|
||||
wrapper.findAll('.waveform-chart__line').map((line) => line.attributes('data-series-id')),
|
||||
).toEqual(['channel-4'])
|
||||
expect(wrapper.get('.ant-pagination-item-3').classes()).toContain('ant-pagination-item-active')
|
||||
expect(wrapper.get('.ant-pagination-next').classes()).toContain('ant-pagination-disabled')
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('3')
|
||||
expect(nextButton().attributes('disabled')).toBeDefined()
|
||||
})
|
||||
|
||||
it('overlays series with the same track ID without changing the next frame', async () => {
|
||||
@@ -1045,7 +905,7 @@ describe('WaveformChart', () => {
|
||||
'1',
|
||||
'2',
|
||||
])
|
||||
expect(wrapper.find('.ant-pagination').exists()).toBe(false)
|
||||
expect(wrapper.find('.waveform-chart__pagination').exists()).toBe(false)
|
||||
|
||||
const firstTrackOverlay = tracks[0].get('.waveform-chart__overlay')
|
||||
const overlayWidth = Number(firstTrackOverlay.attributes('width'))
|
||||
@@ -1148,61 +1008,6 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.attributes('data-chart-left-margin')).toBe('64')
|
||||
})
|
||||
|
||||
it('resolves legend positions by stable track id across pages', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
kind: 'series',
|
||||
series: Array.from({ length: 8 }, (_, index) => ({
|
||||
id: `series-${index}`,
|
||||
trackId: `frame-${Math.floor(index / 2)}`,
|
||||
name: `series ${index}`,
|
||||
data: {
|
||||
kind: 'points' as const,
|
||||
points: [
|
||||
{ x: 0, y: index },
|
||||
{ x: 1, y: index + 1 },
|
||||
],
|
||||
},
|
||||
})),
|
||||
},
|
||||
{
|
||||
grid: { rowCount: 2, columnCount: 1, showPagination: true },
|
||||
legend: {
|
||||
position: 'left',
|
||||
orientation: 'auto',
|
||||
trackPositions: {
|
||||
'frame-0': 'top',
|
||||
'frame-1': 'bottom-right',
|
||||
'frame-2': 'bottom',
|
||||
},
|
||||
},
|
||||
},
|
||||
)
|
||||
|
||||
const legendForTrack = (trackId: string) =>
|
||||
wrapper.get(`[data-legend-track-id="${trackId}"] .waveform-chart__legend`)
|
||||
|
||||
expect(legendForTrack('frame-0').attributes('data-position')).toBe('top')
|
||||
expect(legendForTrack('frame-0').attributes('data-orientation')).toBe('horizontal')
|
||||
expect(legendForTrack('frame-1').attributes('data-position')).toBe('bottom-right')
|
||||
expect(legendForTrack('frame-1').attributes('data-orientation')).toBe('vertical')
|
||||
|
||||
await wrapper.setProps({
|
||||
legend: {
|
||||
position: 'left',
|
||||
orientation: 'vertical',
|
||||
trackPositions: { 'frame-0': 'top', 'frame-1': 'bottom-right', 'frame-2': 'bottom' },
|
||||
},
|
||||
})
|
||||
expect(legendForTrack('frame-0').attributes('data-orientation')).toBe('vertical')
|
||||
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
expect(legendForTrack('frame-2').attributes('data-position')).toBe('bottom')
|
||||
expect(legendForTrack('frame-2').attributes('data-orientation')).toBe('vertical')
|
||||
expect(legendForTrack('frame-3').attributes('data-position')).toBe('left')
|
||||
expect(legendForTrack('frame-3').attributes('data-orientation')).toBe('vertical')
|
||||
})
|
||||
|
||||
it('applies a configurable alpha background to every visible legend', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
@@ -1557,7 +1362,7 @@ describe('WaveformChart', () => {
|
||||
const initialMargin = wrapper.attributes('data-chart-left-margin')
|
||||
const initialLabelX = wrapper.get('.waveform-chart__track').attributes('data-y-axis-label-x')
|
||||
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
await wrapper.get('[aria-label="下一页"]').trigger('click')
|
||||
|
||||
expect(wrapper.attributes('data-chart-left-margin')).toBe(initialMargin)
|
||||
expect(wrapper.get('.waveform-chart__track').attributes('data-y-axis-label-x')).toBe(
|
||||
@@ -1662,12 +1467,12 @@ describe('WaveformChart', () => {
|
||||
const wrapper = await mountSizedChart(gridSeries(5), {
|
||||
grid: { rowCount: 1, columnCount: 1 },
|
||||
})
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
expect(wrapper.get('.ant-pagination-item-2').classes()).toContain('ant-pagination-item-active')
|
||||
await wrapper.get('[aria-label="下一页"]').trigger('click')
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('2')
|
||||
|
||||
await wrapper.setProps({ grid: { rowCount: 2, columnCount: 1 } })
|
||||
await flushPromises()
|
||||
expect(wrapper.get('.ant-pagination-item-1').classes()).toContain('ant-pagination-item-active')
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('1')
|
||||
})
|
||||
|
||||
it('keeps the shared x domain stable while paging separated and compact grids', async () => {
|
||||
@@ -1677,7 +1482,7 @@ describe('WaveformChart', () => {
|
||||
grid: { rowCount: 1, columnCount: 1 },
|
||||
})
|
||||
const initialEnd = wrapper.get('.waveform-chart__axis-endpoint--end').text()
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
await wrapper.get('[aria-label="下一页"]').trigger('click')
|
||||
expect(wrapper.get('.waveform-chart__axis-endpoint--end').text()).toBe(initialEnd)
|
||||
}
|
||||
})
|
||||
@@ -1759,7 +1564,7 @@ describe('WaveformChart', () => {
|
||||
],
|
||||
})
|
||||
expect(wrapper.find('[data-annotation-id="channel-2-note"]').exists()).toBe(false)
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
await wrapper.get('[aria-label="下一页"]').trigger('click')
|
||||
expect(wrapper.find('[data-annotation-id="channel-2-note"]').exists()).toBe(true)
|
||||
})
|
||||
it('renders a path for sample data and responds to width changes', async () => {
|
||||
@@ -2248,38 +2053,6 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.emitted('point-hover')?.at(-1)).toEqual([null])
|
||||
})
|
||||
|
||||
it('hides the numeric tooltip and crosshair when showTooltip is disabled', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 5 },
|
||||
],
|
||||
},
|
||||
{ grid: { rowCount: 1, columnCount: 1 }, showTooltip: false },
|
||||
)
|
||||
const overlay = wrapper.get('.waveform-chart__overlay')
|
||||
const overlayWidth = Number(overlay.attributes('width'))
|
||||
Object.defineProperty(overlay.element, 'getBoundingClientRect', {
|
||||
value: () => ({ left: 0, top: 0, width: overlayWidth, height: 290 }),
|
||||
})
|
||||
|
||||
overlay.element.dispatchEvent(
|
||||
new MouseEvent('pointermove', { clientX: 700, clientY: 120, bubbles: true }),
|
||||
)
|
||||
flushAnimationFrames()
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.find('.waveform-chart__tooltip').exists()).toBe(false)
|
||||
expect(wrapper.find('.waveform-chart__crosshair').exists()).toBe(false)
|
||||
|
||||
await wrapper.setProps({ showTooltip: true })
|
||||
await flushPromises()
|
||||
expect(wrapper.find('.waveform-chart__tooltip').exists()).toBe(true)
|
||||
expect(wrapper.find('.waveform-chart__crosshair').exists()).toBe(true)
|
||||
})
|
||||
|
||||
it('coalesces pointer moves per frame and cancels pending hover work', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
@@ -2363,49 +2136,6 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.get('.waveform-chart__line').attributes('stroke')).toBe('#0960bd')
|
||||
})
|
||||
|
||||
it('controls horizontal and vertical grid lines independently by track ID', async () => {
|
||||
const data = gridSeries(2)
|
||||
if (data.kind === 'series') {
|
||||
data.series[0].trackId = 'frame-a'
|
||||
data.series[1].trackId = 'frame-b'
|
||||
}
|
||||
const wrapper = await mountSizedChart(data, {
|
||||
grid: {
|
||||
rowCount: 1,
|
||||
columnCount: 2,
|
||||
trackLines: {
|
||||
'frame-a': { horizontal: false },
|
||||
'frame-b': { vertical: false },
|
||||
},
|
||||
},
|
||||
})
|
||||
|
||||
const tracks = wrapper.findAll('.waveform-chart__track')
|
||||
expect(tracks).toHaveLength(2)
|
||||
expect(tracks[0].findAll('[data-grid-direction="horizontal"]')).toHaveLength(0)
|
||||
expect(tracks[0].findAll('[data-grid-direction="vertical"]').length).not.toBe(0)
|
||||
expect(tracks[1].findAll('[data-grid-direction="vertical"]')).toHaveLength(0)
|
||||
expect(tracks[1].findAll('[data-grid-direction="horizontal"]').length).not.toBe(0)
|
||||
})
|
||||
|
||||
it('keeps per-track grid line visibility attached across pagination', async () => {
|
||||
const wrapper = await mountSizedChart(gridSeries(3), {
|
||||
grid: {
|
||||
rowCount: 1,
|
||||
columnCount: 1,
|
||||
trackLines: {
|
||||
'channel-1': { horizontal: false, vertical: false },
|
||||
},
|
||||
},
|
||||
})
|
||||
|
||||
expect(wrapper.findAll('[data-grid-direction]')).not.toHaveLength(0)
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
expect(wrapper.findAll('[data-grid-direction]')).toHaveLength(0)
|
||||
await wrapper.get('.ant-pagination-next button').trigger('click')
|
||||
expect(wrapper.findAll('[data-grid-direction]')).not.toHaveLength(0)
|
||||
})
|
||||
|
||||
it('applies one custom frame style to every non-empty track', async () => {
|
||||
const wrapper = await mountSizedChart(gridSeries(2), {
|
||||
grid: { rowCount: 2, columnCount: 1 },
|
||||
@@ -2453,17 +2183,6 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.get('.waveform-chart__plot-frame').attributes('stroke-width')).toBe('1')
|
||||
})
|
||||
|
||||
it('renders a dotted frame with rounded dots', async () => {
|
||||
const wrapper = await mountSizedChart(gridSeries(1), {
|
||||
frameStyle: { borderStyle: 'dotted' },
|
||||
})
|
||||
|
||||
expect(wrapper.get('.waveform-chart__plot-frame').attributes()).toMatchObject({
|
||||
'stroke-dasharray': '1 3',
|
||||
'stroke-linecap': 'round',
|
||||
})
|
||||
})
|
||||
|
||||
it('continues minor x-grid lines beyond the final major tick to the exact endpoint', async () => {
|
||||
const wrapper = await mountSizedChart({
|
||||
kind: 'points',
|
||||
@@ -2754,139 +2473,6 @@ describe('WaveformChart', () => {
|
||||
expect(wrapper.find('.waveform-chart__zoom-selection').exists()).toBe(false)
|
||||
})
|
||||
|
||||
it('enables space-drag panning only when pannable is true and the pointer is inside', async () => {
|
||||
const data: WaveformData = {
|
||||
kind: 'points',
|
||||
points: Array.from({ length: 5 }, (_, index) => ({ x: index, y: index })),
|
||||
}
|
||||
const disabled = await mountSizedChart(data)
|
||||
const disabledOverlay = disabled.get('.waveform-chart__overlay--independent')
|
||||
const disabledWidth = Number(disabledOverlay.attributes('width'))
|
||||
const disabledHeight = Number(disabledOverlay.attributes('height'))
|
||||
Object.defineProperty(disabledOverlay.element, 'getBoundingClientRect', {
|
||||
value: () => ({ left: 0, top: 0, width: disabledWidth, height: disabledHeight }),
|
||||
})
|
||||
await disabled.trigger('pointerenter')
|
||||
window.dispatchEvent(new KeyboardEvent('keydown', { code: 'Space', cancelable: true }))
|
||||
const disabledDown = new MouseEvent('pointerdown', {
|
||||
button: 0,
|
||||
clientX: disabledWidth * 0.25,
|
||||
clientY: disabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(disabledDown, 'pointerId', { value: 31 })
|
||||
disabledOverlay.element.dispatchEvent(disabledDown)
|
||||
const disabledMove = new MouseEvent('pointermove', {
|
||||
clientX: disabledWidth * 0.75,
|
||||
clientY: disabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(disabledMove, 'pointerId', { value: 31 })
|
||||
disabledOverlay.element.dispatchEvent(disabledMove)
|
||||
await flushPromises()
|
||||
expect(disabled.find('.waveform-chart__zoom-selection').exists()).toBe(true)
|
||||
|
||||
const enabled = await mountSizedChart(data, { pannable: true })
|
||||
const enabledOverlay = enabled.get('.waveform-chart__overlay--independent')
|
||||
const enabledWidth = Number(enabledOverlay.attributes('width'))
|
||||
const enabledHeight = Number(enabledOverlay.attributes('height'))
|
||||
Object.defineProperty(enabledOverlay.element, 'getBoundingClientRect', {
|
||||
value: () => ({ left: 0, top: 0, width: enabledWidth, height: enabledHeight }),
|
||||
})
|
||||
const boxDown = new MouseEvent('pointerdown', {
|
||||
button: 0,
|
||||
clientX: enabledWidth * 0.25,
|
||||
clientY: enabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(boxDown, 'pointerId', { value: 30 })
|
||||
enabledOverlay.element.dispatchEvent(boxDown)
|
||||
const boxMove = new MouseEvent('pointermove', {
|
||||
clientX: enabledWidth * 0.75,
|
||||
clientY: enabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(boxMove, 'pointerId', { value: 30 })
|
||||
enabledOverlay.element.dispatchEvent(boxMove)
|
||||
const boxUp = new MouseEvent('pointerup', {
|
||||
clientX: enabledWidth * 0.75,
|
||||
clientY: enabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(boxUp, 'pointerId', { value: 30 })
|
||||
enabledOverlay.element.dispatchEvent(boxUp)
|
||||
await flushPromises()
|
||||
const startBeforePan = enabled.get('.waveform-chart__axis-endpoint--start').text()
|
||||
|
||||
await enabled.trigger('pointerenter')
|
||||
const spaceDown = new KeyboardEvent('keydown', { code: 'Space', cancelable: true })
|
||||
window.dispatchEvent(spaceDown)
|
||||
const enabledDown = new MouseEvent('pointerdown', {
|
||||
button: 0,
|
||||
clientX: enabledWidth / 2,
|
||||
clientY: enabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(enabledDown, 'pointerId', { value: 32 })
|
||||
enabledOverlay.element.dispatchEvent(enabledDown)
|
||||
const enabledMove = new MouseEvent('pointermove', {
|
||||
clientX: enabledWidth / 2 + 20,
|
||||
clientY: enabledHeight / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(enabledMove, 'pointerId', { value: 32 })
|
||||
enabledOverlay.element.dispatchEvent(enabledMove)
|
||||
await flushPromises()
|
||||
|
||||
expect(spaceDown.defaultPrevented).toBe(true)
|
||||
expect(enabled.classes()).toContain('waveform-chart--panning')
|
||||
expect(enabled.find('.waveform-chart__zoom-selection').exists()).toBe(false)
|
||||
expect(enabled.get('.waveform-chart__axis-endpoint--start').text()).not.toBe(startBeforePan)
|
||||
window.dispatchEvent(new KeyboardEvent('keyup', { code: 'Space' }))
|
||||
})
|
||||
|
||||
it('does not activate pannable on a chart that the pointer is outside', async () => {
|
||||
const data: WaveformData = {
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 1 },
|
||||
],
|
||||
}
|
||||
const active = await mountSizedChart(data, { pannable: true })
|
||||
const inactive = await mountSizedChart(data, { pannable: true })
|
||||
await active.trigger('pointerenter')
|
||||
|
||||
window.dispatchEvent(new KeyboardEvent('keydown', { code: 'Space', cancelable: true }))
|
||||
|
||||
const inactiveOverlay = inactive.get('.waveform-chart__overlay--independent')
|
||||
const width = Number(inactiveOverlay.attributes('width'))
|
||||
const height = Number(inactiveOverlay.attributes('height'))
|
||||
Object.defineProperty(inactiveOverlay.element, 'getBoundingClientRect', {
|
||||
value: () => ({ left: 0, top: 0, width, height }),
|
||||
})
|
||||
const down = new MouseEvent('pointerdown', {
|
||||
button: 0,
|
||||
clientX: width * 0.25,
|
||||
clientY: height / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(down, 'pointerId', { value: 33 })
|
||||
inactiveOverlay.element.dispatchEvent(down)
|
||||
const move = new MouseEvent('pointermove', {
|
||||
clientX: width * 0.75,
|
||||
clientY: height / 2,
|
||||
bubbles: true,
|
||||
})
|
||||
Object.defineProperty(move, 'pointerId', { value: 33 })
|
||||
inactiveOverlay.element.dispatchEvent(move)
|
||||
await flushPromises()
|
||||
|
||||
expect(inactive.find('.waveform-chart__zoom-selection').exists()).toBe(true)
|
||||
expect(inactive.classes()).not.toContain('waveform-chart--panning')
|
||||
window.dispatchEvent(new KeyboardEvent('keyup', { code: 'Space' }))
|
||||
})
|
||||
|
||||
it('limits box zoom to the configured minimum x span', async () => {
|
||||
const wrapper = await mountSizedChart(
|
||||
{
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
<script setup lang="ts">
|
||||
import { Pagination } from 'ant-design-vue'
|
||||
import {
|
||||
bisector,
|
||||
pointer,
|
||||
@@ -12,7 +11,6 @@ import {
|
||||
type ZoomTransform,
|
||||
} from 'd3'
|
||||
import { resolveWaveformRenderingOptions } from '../core'
|
||||
import { hasMinimumVisibleXValues } from '../core/rendering'
|
||||
import { formatScientificAxisExponent, formatScientificAxisLabel, paddedDomain } from '../utils'
|
||||
import { useAnimationFrameThrottle } from './utils/useAnimationFrameThrottle'
|
||||
import {
|
||||
@@ -28,7 +26,6 @@ import {
|
||||
|
||||
import {
|
||||
type WaveformAnnotation,
|
||||
type WaveformAxesOptions,
|
||||
type WaveformData,
|
||||
type WaveformDisplayMode,
|
||||
type WaveformFrameStyle,
|
||||
@@ -64,24 +61,10 @@ import {
|
||||
channelColors,
|
||||
margin as chartMargin,
|
||||
minimumHeight as chartMinimumHeight,
|
||||
Y_AXIS_CHARACTER_WIDTH,
|
||||
Y_AXIS_TICK_PADDING,
|
||||
Y_AXIS_OUTER_PADDING,
|
||||
Y_AXIS_LABEL_GAP,
|
||||
Y_AXIS_LABEL_BAND_WIDTH,
|
||||
MINIMUM_PLOT_WIDTH,
|
||||
WHEEL_ZOOM_DEBOUNCE_MS,
|
||||
MINIMUM_SELECTION_SIZE,
|
||||
ZOOM_CONSTRAINTS,
|
||||
TITLE_DEFAULT_FONT_SIZE,
|
||||
TITLE_CHAR_WIDTH_RATIO,
|
||||
TITLE_LINE_HEIGHT,
|
||||
ZERO_LINE_DEFAULTS,
|
||||
} from './core/constants'
|
||||
import {
|
||||
getGridGap,
|
||||
getPageCount,
|
||||
getPageSize,
|
||||
normalizeGridOptions,
|
||||
paginateSeries,
|
||||
resolveGridCellGeometry,
|
||||
@@ -89,19 +72,13 @@ import {
|
||||
type WaveformGridOptions,
|
||||
} from './core/grid'
|
||||
import type { DisplaySeries, DisplayTrack, HoveredSeriesPoint, TrackLayout } from './core/types'
|
||||
import {
|
||||
buildTrackLayouts,
|
||||
findClosestTrackAtPointer,
|
||||
measureTrackYAxisClearance,
|
||||
Y_AXIS_EXPONENT_GAP,
|
||||
} from './core/layout'
|
||||
import { buildTrackLayouts, measureTrackYAxisClearance, Y_AXIS_EXPONENT_GAP } from './core/layout'
|
||||
import { calculateRotatedTitleLayout, TITLE_AREA_HORIZONTAL_PADDING } from './core/title'
|
||||
import { usePreparedWaveformSeries } from './core/useWaveformData'
|
||||
import WaveformAnnotationEditor from './annotation/WaveformAnnotationEditor.vue'
|
||||
import WaveformPagination from './WaveformPagination.vue'
|
||||
import { useWaveformInstanceId } from '../utils/waveformId'
|
||||
|
||||
const xPointBisector = bisector<WaveformPoint, number>((point) => point.x)
|
||||
|
||||
const props = withDefaults(
|
||||
defineProps<{
|
||||
data: WaveformData
|
||||
@@ -114,7 +91,6 @@ const props = withDefaults(
|
||||
lineColor?: string
|
||||
showTooltip?: boolean
|
||||
zoomable?: boolean
|
||||
pannable?: boolean
|
||||
minZoomSpan?: number
|
||||
minVisiblePoints?: number
|
||||
initialXDomain?: [number, number]
|
||||
@@ -122,7 +98,6 @@ const props = withDefaults(
|
||||
timeUnit?: 's' | 'ms'
|
||||
frameNumber?: string | number
|
||||
frameStyle?: WaveformFrameStyle
|
||||
axes?: WaveformAxesOptions
|
||||
annotations?: WaveformAnnotation[]
|
||||
annotationsVisible?: boolean
|
||||
interactionMode?: WaveformInteractionMode
|
||||
@@ -142,7 +117,6 @@ const props = withDefaults(
|
||||
lineColor: '#0960bd',
|
||||
showTooltip: true,
|
||||
zoomable: true,
|
||||
pannable: false,
|
||||
minVisiblePoints: 0,
|
||||
timeUnit: 'ms',
|
||||
frameNumber: undefined,
|
||||
@@ -215,7 +189,7 @@ const lastIndependentZoomGestures = new Map<number, ZoomGestureKind>()
|
||||
const lastZoomedTrackIndexes = new Set<number>()
|
||||
const zoomThrottle = useAnimationFrameThrottle()
|
||||
const hoverThrottle = useAnimationFrameThrottle()
|
||||
const wheelZoomDebounceMs = WHEEL_ZOOM_DEBOUNCE_MS
|
||||
const wheelZoomDebounceMs = 200
|
||||
let wheelZoomEndTimer: ReturnType<typeof setTimeout> | undefined
|
||||
const preparedSeries = usePreparedWaveformSeries(() => props.data, handleDataReferenceChange)
|
||||
|
||||
@@ -235,7 +209,6 @@ interface SelectionState {
|
||||
|
||||
const selection = ref<SelectionState | null>(null)
|
||||
const spacePressed = ref(false)
|
||||
const pointerInsideChart = ref(false)
|
||||
const selectionBox = computed(() => {
|
||||
const active = selection.value
|
||||
if (!active) return null
|
||||
@@ -249,24 +222,11 @@ const selectionBox = computed(() => {
|
||||
})
|
||||
|
||||
function handleInteractionKeyDown(event: KeyboardEvent) {
|
||||
if (event.code !== 'Space' || !props.pannable || !pointerInsideChart.value) return
|
||||
const target = event.target
|
||||
if (
|
||||
target instanceof Element &&
|
||||
target.closest(
|
||||
'button, input, select, textarea, [contenteditable]:not([contenteditable="false"])',
|
||||
)
|
||||
) {
|
||||
return
|
||||
}
|
||||
spacePressed.value = true
|
||||
event.preventDefault()
|
||||
if (event.code === 'Space') spacePressed.value = true
|
||||
}
|
||||
|
||||
function handleInteractionKeyUp(event: KeyboardEvent) {
|
||||
if (event.code === 'Space') {
|
||||
spacePressed.value = false
|
||||
}
|
||||
if (event.code === 'Space') spacePressed.value = false
|
||||
}
|
||||
|
||||
// 用于传递给 WaveformTooltip 的接口
|
||||
@@ -294,17 +254,15 @@ const containerStyle = computed(() => ({
|
||||
width: fixedWidth.value === undefined ? '100%' : `${fixedWidth.value}px`,
|
||||
height: fixedHeight.value === undefined ? '100%' : `${fixedHeight.value}px`,
|
||||
}))
|
||||
const legendPosition = computed<WaveformLegendPosition>(() => props.legend?.position ?? 'top-right')
|
||||
const isCleanView = computed(() => props.cleanView === true)
|
||||
const resolvedZeroLine = computed(() => {
|
||||
const width = props.zeroLine?.width
|
||||
return {
|
||||
visible: props.zeroLine?.visible === true,
|
||||
color: props.zeroLine?.color || ZERO_LINE_DEFAULTS.COLOR,
|
||||
width:
|
||||
typeof width === 'number' && Number.isFinite(width) && width > 0
|
||||
? width
|
||||
: ZERO_LINE_DEFAULTS.WIDTH,
|
||||
dash: props.zeroLine?.dash ?? ZERO_LINE_DEFAULTS.DASH,
|
||||
color: props.zeroLine?.color || '#98a2b3',
|
||||
width: typeof width === 'number' && Number.isFinite(width) && width > 0 ? width : 1,
|
||||
dash: props.zeroLine?.dash ?? '6 4',
|
||||
}
|
||||
})
|
||||
const legendBackgroundColor = computed(
|
||||
@@ -317,17 +275,13 @@ const hiddenSeriesIdSet = computed(() =>
|
||||
: new Set(props.hiddenSeriesIds),
|
||||
)
|
||||
const resolvedHiddenSeriesIds = computed(() => Array.from(hiddenSeriesIdSet.value))
|
||||
function resolveLegendPosition(trackId: string): WaveformLegendPosition {
|
||||
return props.legend?.trackPositions?.[trackId] ?? props.legend?.position ?? 'top-right'
|
||||
}
|
||||
|
||||
function resolveLegendOrientation(
|
||||
position: WaveformLegendPosition,
|
||||
): Exclude<WaveformLegendOrientation, 'auto'> {
|
||||
const legendOrientation = computed<Exclude<WaveformLegendOrientation, 'auto'>>(() => {
|
||||
const orientation = props.legend?.orientation ?? 'auto'
|
||||
if (orientation !== 'auto') return orientation
|
||||
return position === 'top' || position === 'bottom' ? 'horizontal' : 'vertical'
|
||||
}
|
||||
return legendPosition.value === 'top' || legendPosition.value === 'bottom'
|
||||
? 'horizontal'
|
||||
: 'vertical'
|
||||
})
|
||||
const resolvedTitleText = computed(() => props.title?.text.trim() ?? '')
|
||||
const titleAreaReserved = computed(
|
||||
() =>
|
||||
@@ -336,9 +290,7 @@ const titleAreaReserved = computed(
|
||||
const titleVisible = computed(() => titleAreaReserved.value && !isCleanView.value)
|
||||
const titleFontSize = computed(() => {
|
||||
const fontSize = props.title?.textStyle?.fontSize
|
||||
return Number.isFinite(fontSize) && (fontSize ?? 0) > 0
|
||||
? (fontSize as number)
|
||||
: TITLE_DEFAULT_FONT_SIZE
|
||||
return Number.isFinite(fontSize) && (fontSize ?? 0) > 0 ? (fontSize as number) : 14
|
||||
})
|
||||
const titleRotation = computed(() => {
|
||||
const rotation = props.title?.textStyle?.rotation
|
||||
@@ -356,17 +308,14 @@ const titlePresentationStyle = computed<CSSProperties>(() => ({
|
||||
fontStyle: props.title?.textStyle?.fontStyle ?? 'normal',
|
||||
textDecoration: props.title?.textStyle?.textDecoration ?? 'none',
|
||||
letterSpacing: props.title?.textStyle?.letterSpacing ?? 'normal',
|
||||
lineHeight: String(TITLE_LINE_HEIGHT),
|
||||
lineHeight: '1.2',
|
||||
}))
|
||||
const estimatedTitleWidth = computed(() => {
|
||||
const letterSpacing = Number.parseFloat(props.title?.textStyle?.letterSpacing ?? '')
|
||||
const spacingWidth = Number.isFinite(letterSpacing)
|
||||
? Math.max(0, resolvedTitleText.value.length - 1) * letterSpacing
|
||||
: 0
|
||||
return Math.max(
|
||||
1,
|
||||
resolvedTitleText.value.length * titleFontSize.value * TITLE_CHAR_WIDTH_RATIO + spacingWidth,
|
||||
)
|
||||
return Math.max(1, resolvedTitleText.value.length * titleFontSize.value * 0.62 + spacingWidth)
|
||||
})
|
||||
const titleAvailableWidth = computed(() => {
|
||||
const measuredAvailableWidth = chartWidth.value - TITLE_AREA_HORIZONTAL_PADDING * 2
|
||||
@@ -382,7 +331,7 @@ const titleMeasureStyle = computed<CSSProperties>(() => ({
|
||||
const titleLayout = computed(() =>
|
||||
calculateRotatedTitleLayout({
|
||||
naturalWidth: measuredTitleWidth.value || estimatedTitleWidth.value,
|
||||
naturalHeight: measuredTitleHeight.value || titleFontSize.value * TITLE_LINE_HEIGHT,
|
||||
naturalHeight: measuredTitleHeight.value || titleFontSize.value * 1.2,
|
||||
availableWidth: titleAvailableWidth.value,
|
||||
rotation: titleRotation.value,
|
||||
}),
|
||||
@@ -430,18 +379,12 @@ const chartTracks = computed<DisplayTrack[]>(() => {
|
||||
})
|
||||
return Array.from(groupedSeries, ([id, series]) => {
|
||||
const visibleSeries = series.filter((item) => !hiddenSeriesIdSet.value.has(item.id))
|
||||
const xDomainValues: number[] = []
|
||||
const yDomainValues: number[] = []
|
||||
visibleSeries.forEach((item) => {
|
||||
xDomainValues.push(item.xDomain[0], item.xDomain[1])
|
||||
yDomainValues.push(item.yDomain[0], item.yDomain[1])
|
||||
})
|
||||
return {
|
||||
id,
|
||||
series,
|
||||
visibleSeries,
|
||||
xDomain: paddedDomain(xDomainValues),
|
||||
yDomain: paddedDomain(yDomainValues),
|
||||
xDomain: paddedDomain(visibleSeries.flatMap((item) => item.xDomain)),
|
||||
yDomain: paddedDomain(visibleSeries.flatMap((item) => item.yDomain)),
|
||||
}
|
||||
})
|
||||
})
|
||||
@@ -452,13 +395,12 @@ const pagedTracks = computed(() =>
|
||||
paginateSeries(chartTracks.value, currentPage.value, gridOptions.value),
|
||||
)
|
||||
|
||||
// 使用从常量文件导入的值
|
||||
const yAxisCharacterWidth = Y_AXIS_CHARACTER_WIDTH
|
||||
const yAxisTickPadding = Y_AXIS_TICK_PADDING
|
||||
const yAxisOuterPadding = Y_AXIS_OUTER_PADDING
|
||||
const yAxisLabelGap = Y_AXIS_LABEL_GAP
|
||||
const yAxisLabelBandWidth = Y_AXIS_LABEL_BAND_WIDTH
|
||||
const minimumPlotWidth = MINIMUM_PLOT_WIDTH
|
||||
const yAxisCharacterWidth = 7
|
||||
const yAxisTickPadding = 7
|
||||
const yAxisOuterPadding = 4
|
||||
const yAxisLabelGap = 6
|
||||
const yAxisLabelBandWidth = 24
|
||||
const minimumPlotWidth = 120
|
||||
|
||||
const yAxisMetrics = computed(() => {
|
||||
const axisText = chartTracks.value
|
||||
@@ -589,13 +531,11 @@ const tooltipSeriesPoints = computed<TooltipSeriesPoint[]>(() => {
|
||||
}))
|
||||
})
|
||||
|
||||
const sharedXDomain = computed(() => {
|
||||
const values: number[] = []
|
||||
chartTracks.value.forEach((track) => {
|
||||
if (track.visibleSeries.length) values.push(track.xDomain[0], track.xDomain[1])
|
||||
})
|
||||
return paddedDomain(values)
|
||||
})
|
||||
const sharedXDomain = computed(() =>
|
||||
paddedDomain(
|
||||
chartTracks.value.flatMap((track) => (track.visibleSeries.length ? track.xDomain : [])),
|
||||
),
|
||||
)
|
||||
const initialXDomain = computed<[number, number]>(() => {
|
||||
const domain = props.initialXDomain
|
||||
if (
|
||||
@@ -878,23 +818,26 @@ function clearZoomBindings() {
|
||||
|
||||
function resolveMaximumZoomScale(domain: [number, number]): number {
|
||||
const minZoomSpan = props.minZoomSpan
|
||||
if (!Number.isFinite(minZoomSpan) || (minZoomSpan ?? 0) <= 0)
|
||||
return ZOOM_CONSTRAINTS.DEFAULT_MAX_SCALE
|
||||
if (!Number.isFinite(minZoomSpan) || (minZoomSpan ?? 0) <= 0) return 40
|
||||
const domainSpan = Math.abs(domain[1] - domain[0])
|
||||
if (!Number.isFinite(domainSpan) || domainSpan <= 0) return ZOOM_CONSTRAINTS.MIN_SCALE
|
||||
return Math.min(
|
||||
ZOOM_CONSTRAINTS.DEFAULT_MAX_SCALE,
|
||||
Math.max(ZOOM_CONSTRAINTS.MIN_SCALE, domainSpan / (minZoomSpan ?? domainSpan)),
|
||||
)
|
||||
if (!Number.isFinite(domainSpan) || domainSpan <= 0) return 1
|
||||
return Math.min(40, Math.max(1, domainSpan / (minZoomSpan ?? domainSpan)))
|
||||
}
|
||||
|
||||
function visiblePointCount(track: TrackLayout): number {
|
||||
const [start, end] = track.xScale.domain()
|
||||
const xValues = new Set<number>()
|
||||
track.seriesList.forEach((series) => {
|
||||
series.points.forEach((point) => {
|
||||
if (point.x >= start && point.x <= end) xValues.add(point.x)
|
||||
})
|
||||
})
|
||||
return xValues.size
|
||||
}
|
||||
|
||||
function canZoomTrack(track: TrackLayout): boolean {
|
||||
const minimum = Number(props.minVisiblePoints)
|
||||
return hasMinimumVisibleXValues(
|
||||
track.seriesList,
|
||||
track.xScale.domain() as [number, number],
|
||||
minimum,
|
||||
)
|
||||
return !Number.isFinite(minimum) || minimum <= 0 || visiblePointCount(track) >= minimum
|
||||
}
|
||||
|
||||
function canZoomSharedTracks(): boolean {
|
||||
@@ -1040,7 +983,7 @@ function consumeHoverSuppression(): boolean {
|
||||
}
|
||||
|
||||
function nearestPoint(series: DisplaySeries, xValue: number): WaveformPoint | undefined {
|
||||
const index = xPointBisector.center(series.points, xValue)
|
||||
const index = bisector((point: WaveformPoint) => point.x).center(series.points, xValue)
|
||||
return series.points[index]
|
||||
}
|
||||
|
||||
@@ -1154,7 +1097,32 @@ function resolveTrackAtPointer(
|
||||
return track?.hasVisibleSeries ? track : undefined
|
||||
}
|
||||
const visibleTracks = trackLayouts.value.filter((track) => track.hasVisibleSeries)
|
||||
return findClosestTrackAtPointer(visibleTracks, pointerX, pointerY)
|
||||
if (!visibleTracks.length) return undefined
|
||||
|
||||
const distanceToTrack = (track: TrackLayout) => {
|
||||
const xDistance =
|
||||
pointerX < track.left
|
||||
? track.left - pointerX
|
||||
: pointerX > track.left + track.width
|
||||
? pointerX - track.left - track.width
|
||||
: 0
|
||||
if (pointerY < track.top) return track.top - pointerY
|
||||
if (pointerY > track.top + track.height) return pointerY - (track.top + track.height)
|
||||
return xDistance
|
||||
}
|
||||
// 修复 O(n²) 问题:缓存距离计算结果
|
||||
const trackDistances = new Map<TrackLayout, number>()
|
||||
visibleTracks.forEach((track) => {
|
||||
trackDistances.set(track, distanceToTrack(track))
|
||||
})
|
||||
return visibleTracks.reduce((closest, candidate) => {
|
||||
const distance = trackDistances.get(candidate)!
|
||||
const closestDistance = trackDistances.get(closest)!
|
||||
if (distance !== closestDistance) return distance < closestDistance ? candidate : closest
|
||||
const centerDistance = Math.abs(pointerY - (candidate.top + candidate.height / 2))
|
||||
const closestCenterDistance = Math.abs(pointerY - (closest.top + closest.height / 2))
|
||||
return centerDistance < closestCenterDistance ? candidate : closest
|
||||
})
|
||||
}
|
||||
|
||||
function resolveAnnotationCandidates(
|
||||
@@ -1374,7 +1342,7 @@ function handleSharedPointerMove(event: PointerEvent) {
|
||||
})
|
||||
}
|
||||
|
||||
const minimumSelectionSize = MINIMUM_SELECTION_SIZE
|
||||
const minimumSelectionSize = 6
|
||||
|
||||
function transformForDomain(
|
||||
domain: [number, number],
|
||||
@@ -1440,8 +1408,7 @@ function currentYDomains(): Record<string, [number, number]> {
|
||||
}
|
||||
|
||||
function beginViewportDrag(event: PointerEvent, trackIndex: number, independent: boolean) {
|
||||
const panRequested = props.pannable && spacePressed.value
|
||||
if ((!props.zoomable && !panRequested) || !isZoomMode.value || event.button !== 0) return
|
||||
if (!props.zoomable || !isZoomMode.value || event.button !== 0) return
|
||||
const overlay = event.currentTarget as SVGRectElement
|
||||
const track = trackLayouts.value.find((item) => item.index === trackIndex)
|
||||
if (!track) return
|
||||
@@ -1457,7 +1424,7 @@ function beginViewportDrag(event: PointerEvent, trackIndex: number, independent:
|
||||
currentX: x,
|
||||
currentY: y,
|
||||
pointerId: event.pointerId,
|
||||
mode: panRequested ? 'pan' : 'box',
|
||||
mode: spacePressed.value ? 'pan' : 'box',
|
||||
xDomain: track.xScale.domain() as [number, number],
|
||||
yDomains: currentYDomains(),
|
||||
}
|
||||
@@ -1842,8 +1809,6 @@ onBeforeUnmount(() => {
|
||||
:data-overlay-mode="overlayMode"
|
||||
:data-chart-left-margin="resolvedChartLeftMargin"
|
||||
:data-title-area-height="titleAreaHeight"
|
||||
@pointerenter="pointerInsideChart = true"
|
||||
@pointerleave="pointerInsideChart = false"
|
||||
@contextmenu.capture="handleNativeContextMenu"
|
||||
>
|
||||
<div
|
||||
@@ -1945,7 +1910,6 @@ onBeforeUnmount(() => {
|
||||
:interaction-mode="activeInteractionMode"
|
||||
:frame-number="resolveFrameNumber(track.index)"
|
||||
:frame-style="frameStyle"
|
||||
:axes="axes"
|
||||
:clean-view="isCleanView"
|
||||
:zero-line="resolvedZeroLine"
|
||||
:time-unit="timeUnit"
|
||||
@@ -1986,14 +1950,13 @@ onBeforeUnmount(() => {
|
||||
:key="`legend-${track.index}-${track.series.name}`"
|
||||
class="waveform-chart__legend-track"
|
||||
:data-legend-track-index="track.index"
|
||||
:data-legend-track-id="track.id"
|
||||
:transform="`translate(${track.left}, ${track.top})`"
|
||||
>
|
||||
<WaveformLegend
|
||||
v-if="!track.isEmpty && track.legendSeries.length > 1"
|
||||
:series="track.legendSeries"
|
||||
:position="resolveLegendPosition(track.id)"
|
||||
:orientation="resolveLegendOrientation(resolveLegendPosition(track.id))"
|
||||
:position="legendPosition"
|
||||
:orientation="legendOrientation"
|
||||
:background-color="legendBackgroundColor"
|
||||
:interactive="legendInteractive"
|
||||
:hidden-series-ids="resolvedHiddenSeriesIds"
|
||||
@@ -2026,15 +1989,11 @@ onBeforeUnmount(() => {
|
||||
</text>
|
||||
</svg>
|
||||
|
||||
<Pagination
|
||||
<WaveformPagination
|
||||
v-if="gridOptions.showPagination && pageCount > 1 && !isCleanView"
|
||||
class="waveform-chart__pagination"
|
||||
aria-label="波形分页"
|
||||
:current="currentPage"
|
||||
:page-size="getPageSize(gridOptions)"
|
||||
:total="chartTracks.length"
|
||||
:show-size-changer="false"
|
||||
:show-quick-jumper="false"
|
||||
:page-count="pageCount"
|
||||
@change="goToPage"
|
||||
/>
|
||||
|
||||
@@ -2133,17 +2092,6 @@ onBeforeUnmount(() => {
|
||||
transform-origin: center;
|
||||
}
|
||||
|
||||
.waveform-chart__pagination :deep(.ant-pagination-item),
|
||||
.waveform-chart__pagination :deep(.ant-pagination-prev .ant-pagination-item-link),
|
||||
.waveform-chart__pagination :deep(.ant-pagination-next .ant-pagination-item-link) {
|
||||
background: #fff;
|
||||
border-color: #d9d9d9;
|
||||
}
|
||||
|
||||
.waveform-chart__pagination :deep(.ant-pagination-item-active) {
|
||||
border-color: #1677ff;
|
||||
}
|
||||
|
||||
.waveform-chart__grid-slot-placeholder {
|
||||
fill: #fafbfc;
|
||||
stroke: #e4e7ec;
|
||||
|
||||
42
src/components/WaveformPagination.test.ts
Normal file
42
src/components/WaveformPagination.test.ts
Normal file
@@ -0,0 +1,42 @@
|
||||
import { mount } from '@vue/test-utils'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
import WaveformPagination from './WaveformPagination.vue'
|
||||
|
||||
describe('WaveformPagination', () => {
|
||||
it('renders all pages and disables the first-page previous button', () => {
|
||||
const wrapper = mount(WaveformPagination, { props: { current: 1, pageCount: 3 } })
|
||||
|
||||
expect(wrapper.findAll('.waveform-pagination__page').map((page) => page.text())).toEqual([
|
||||
'1',
|
||||
'2',
|
||||
'3',
|
||||
])
|
||||
expect(wrapper.get('[aria-label="上一页"]').attributes('disabled')).toBeDefined()
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('1')
|
||||
})
|
||||
|
||||
it('uses ellipses for larger page counts and emits valid page changes', async () => {
|
||||
const wrapper = mount(WaveformPagination, { props: { current: 5, pageCount: 12 } })
|
||||
|
||||
expect(wrapper.findAll('.waveform-pagination__page').map((page) => page.text())).toEqual([
|
||||
'1',
|
||||
'4',
|
||||
'5',
|
||||
'6',
|
||||
'12',
|
||||
])
|
||||
expect(wrapper.findAll('.waveform-pagination__ellipsis')).toHaveLength(2)
|
||||
|
||||
await wrapper.get('[aria-label="第 6 页"]').trigger('click')
|
||||
expect(wrapper.emitted('change')).toEqual([[6]])
|
||||
})
|
||||
|
||||
it('clamps invalid current values and does not emit when already at a boundary', async () => {
|
||||
const wrapper = mount(WaveformPagination, { props: { current: 99, pageCount: 3 } })
|
||||
|
||||
expect(wrapper.get('[aria-current="page"]').text()).toBe('3')
|
||||
await wrapper.get('[aria-label="下一页"]').trigger('click')
|
||||
expect(wrapper.emitted('change')).toBeUndefined()
|
||||
})
|
||||
})
|
||||
142
src/components/WaveformPagination.vue
Normal file
142
src/components/WaveformPagination.vue
Normal file
@@ -0,0 +1,142 @@
|
||||
<script setup lang="ts">
|
||||
import { computed } from 'vue'
|
||||
|
||||
const props = defineProps<{
|
||||
current: number
|
||||
pageCount: number
|
||||
}>()
|
||||
|
||||
const emit = defineEmits<{
|
||||
change: [page: number]
|
||||
}>()
|
||||
|
||||
type PageToken = number | 'start-ellipsis' | 'end-ellipsis'
|
||||
|
||||
const normalizedPageCount = computed(() => Math.max(1, Math.floor(props.pageCount) || 1))
|
||||
const normalizedCurrent = computed(() =>
|
||||
Math.min(normalizedPageCount.value, Math.max(1, Math.floor(props.current) || 1)),
|
||||
)
|
||||
|
||||
const pageTokens = computed<PageToken[]>(() => {
|
||||
const pageCount = normalizedPageCount.value
|
||||
const current = normalizedCurrent.value
|
||||
if (pageCount <= 7) return Array.from({ length: pageCount }, (_, index) => index + 1)
|
||||
if (current <= 4) return [1, 2, 3, 4, 5, 'end-ellipsis', pageCount]
|
||||
if (current >= pageCount - 3) {
|
||||
return [
|
||||
1,
|
||||
'start-ellipsis',
|
||||
pageCount - 4,
|
||||
pageCount - 3,
|
||||
pageCount - 2,
|
||||
pageCount - 1,
|
||||
pageCount,
|
||||
]
|
||||
}
|
||||
return [1, 'start-ellipsis', current - 1, current, current + 1, 'end-ellipsis', pageCount]
|
||||
})
|
||||
|
||||
function selectPage(page: number) {
|
||||
const nextPage = Math.min(normalizedPageCount.value, Math.max(1, Math.floor(page)))
|
||||
if (nextPage !== normalizedCurrent.value) emit('change', nextPage)
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<nav class="waveform-pagination" aria-label="波形分页">
|
||||
<button
|
||||
type="button"
|
||||
class="waveform-pagination__previous"
|
||||
aria-label="上一页"
|
||||
:disabled="normalizedCurrent === 1"
|
||||
@click="selectPage(normalizedCurrent - 1)"
|
||||
>
|
||||
‹
|
||||
</button>
|
||||
<template v-for="token in pageTokens" :key="token">
|
||||
<span
|
||||
v-if="typeof token !== 'number'"
|
||||
class="waveform-pagination__ellipsis"
|
||||
aria-hidden="true"
|
||||
>
|
||||
…
|
||||
</span>
|
||||
<button
|
||||
v-else
|
||||
type="button"
|
||||
class="waveform-pagination__page"
|
||||
:class="{ 'is-active': token === normalizedCurrent }"
|
||||
:aria-current="token === normalizedCurrent ? 'page' : undefined"
|
||||
:aria-label="`第 ${token} 页`"
|
||||
@click="selectPage(token)"
|
||||
>
|
||||
{{ token }}
|
||||
</button>
|
||||
</template>
|
||||
<button
|
||||
type="button"
|
||||
class="waveform-pagination__next"
|
||||
aria-label="下一页"
|
||||
:disabled="normalizedCurrent === normalizedPageCount"
|
||||
@click="selectPage(normalizedCurrent + 1)"
|
||||
>
|
||||
›
|
||||
</button>
|
||||
</nav>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.waveform-pagination {
|
||||
display: inline-flex;
|
||||
gap: 4px;
|
||||
align-items: center;
|
||||
padding: 3px;
|
||||
background: #fff;
|
||||
border: 1px solid #d9d9d9;
|
||||
border-radius: 6px;
|
||||
box-shadow: 0 1px 2px rgb(16 24 40 / 8%);
|
||||
}
|
||||
|
||||
.waveform-pagination button {
|
||||
display: inline-grid;
|
||||
min-width: 28px;
|
||||
height: 28px;
|
||||
padding: 0 6px;
|
||||
color: #344054;
|
||||
font: inherit;
|
||||
font-size: 12px;
|
||||
line-height: 1;
|
||||
background: #fff;
|
||||
border: 1px solid transparent;
|
||||
border-radius: 4px;
|
||||
cursor: pointer;
|
||||
place-items: center;
|
||||
}
|
||||
|
||||
.waveform-pagination button:hover:not(:disabled),
|
||||
.waveform-pagination button:focus-visible {
|
||||
color: #0958d9;
|
||||
border-color: #1677ff;
|
||||
outline: none;
|
||||
}
|
||||
|
||||
.waveform-pagination button.is-active {
|
||||
color: #0958d9;
|
||||
background: #e6f4ff;
|
||||
border-color: #1677ff;
|
||||
}
|
||||
|
||||
.waveform-pagination button:disabled {
|
||||
color: #bfc4cc;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
.waveform-pagination__ellipsis {
|
||||
display: inline-grid;
|
||||
min-width: 20px;
|
||||
height: 28px;
|
||||
color: #98a2b3;
|
||||
font-size: 12px;
|
||||
place-items: center;
|
||||
}
|
||||
</style>
|
||||
@@ -1,129 +1,8 @@
|
||||
/**
|
||||
* 波形图表核心常量配置
|
||||
* 核心常量定义
|
||||
*/
|
||||
|
||||
// ==================== 布局常量 ====================
|
||||
|
||||
/** 图表边距 */
|
||||
export const margin = { top: 18, right: 24, bottom: 52, left: 64 }
|
||||
|
||||
/**
|
||||
* 图表最小高度(像素)
|
||||
*/
|
||||
export const minimumHeight = 180
|
||||
|
||||
/**
|
||||
* 网格间距配置
|
||||
*/
|
||||
export const gridGap = {
|
||||
independent: 30,
|
||||
separated: 20,
|
||||
compact: 20,
|
||||
}
|
||||
|
||||
// ==================== Y轴常量 ====================
|
||||
|
||||
/**
|
||||
* Y轴字符宽度(像素)
|
||||
*/
|
||||
export const Y_AXIS_CHARACTER_WIDTH = 7
|
||||
|
||||
/**
|
||||
* Y轴刻度内边距(像素)
|
||||
*/
|
||||
export const Y_AXIS_TICK_PADDING = 7
|
||||
|
||||
/**
|
||||
* Y轴外边距(像素)
|
||||
*/
|
||||
export const Y_AXIS_OUTER_PADDING = 4
|
||||
|
||||
/**
|
||||
* Y轴标签间距(像素)
|
||||
*/
|
||||
export const Y_AXIS_LABEL_GAP = 6
|
||||
|
||||
/**
|
||||
* Y轴标签带宽度(像素)
|
||||
*/
|
||||
export const Y_AXIS_LABEL_BAND_WIDTH = 24
|
||||
|
||||
/**
|
||||
* Y轴指数标签间距(像素)
|
||||
*/
|
||||
export const Y_AXIS_EXPONENT_GAP = 8
|
||||
|
||||
/**
|
||||
* 最小绘图宽度(像素)
|
||||
*/
|
||||
export const MINIMUM_PLOT_WIDTH = 120
|
||||
|
||||
// ==================== 交互常量 ====================
|
||||
|
||||
/**
|
||||
* 滚轮缩放防抖时间(毫秒)
|
||||
*/
|
||||
export const WHEEL_ZOOM_DEBOUNCE_MS = 200
|
||||
|
||||
/**
|
||||
* 最小选择框尺寸(像素)
|
||||
*/
|
||||
export const MINIMUM_SELECTION_SIZE = 6
|
||||
|
||||
/**
|
||||
* 缩放限制常量
|
||||
*/
|
||||
export const ZOOM_CONSTRAINTS = {
|
||||
/** 默认最大缩放倍数 */
|
||||
DEFAULT_MAX_SCALE: 40,
|
||||
/** 最小缩放倍数 */
|
||||
MIN_SCALE: 1,
|
||||
}
|
||||
|
||||
/**
|
||||
* 悬停检测阈值(像素)
|
||||
* 当指针移动距离小于此值时,使用缓存的悬停结果
|
||||
*/
|
||||
// ==================== 注释常量 ====================
|
||||
|
||||
/**
|
||||
* 注释命中半径(像素)
|
||||
*/
|
||||
export const ANNOTATION_HIT_RADIUS = 8
|
||||
|
||||
/**
|
||||
* 注释歧义距离(像素)
|
||||
* 当多个候选注释点距离差小于此值时,视为歧义
|
||||
*/
|
||||
export const ANNOTATION_AMBIGUITY_DISTANCE = 3
|
||||
|
||||
// ==================== 标题常量 ====================
|
||||
|
||||
/**
|
||||
* 标题区域水平内边距(像素)
|
||||
*/
|
||||
export const TITLE_AREA_HORIZONTAL_PADDING = 24
|
||||
|
||||
/**
|
||||
* 标题默认字体大小(像素)
|
||||
*/
|
||||
export const TITLE_DEFAULT_FONT_SIZE = 14
|
||||
|
||||
/**
|
||||
* 标题默认字符宽度系数
|
||||
*/
|
||||
export const TITLE_CHAR_WIDTH_RATIO = 0.62
|
||||
|
||||
/**
|
||||
* 标题行高
|
||||
*/
|
||||
export const TITLE_LINE_HEIGHT = 1.2
|
||||
|
||||
// ==================== 样式常量 ====================
|
||||
|
||||
/**
|
||||
* 通道默认颜色列表
|
||||
*/
|
||||
/** 通道颜色 */
|
||||
export const channelColors = [
|
||||
'#0960bd',
|
||||
'#ff7f0e',
|
||||
@@ -137,56 +16,8 @@ export const channelColors = [
|
||||
'#1d39c4',
|
||||
]
|
||||
|
||||
/**
|
||||
* 错误条默认配置
|
||||
*/
|
||||
export const ERROR_BAR_DEFAULTS = {
|
||||
/** 线宽(像素) */
|
||||
WIDTH: 1.5,
|
||||
/** 端帽宽度(像素) */
|
||||
CAP_WIDTH: 8,
|
||||
}
|
||||
/** 图表边距 */
|
||||
export const margin = { top: 18, right: 24, bottom: 52, left: 64 }
|
||||
|
||||
/**
|
||||
* 零线默认配置
|
||||
*/
|
||||
export const ZERO_LINE_DEFAULTS = {
|
||||
/** 颜色 */
|
||||
COLOR: '#98a2b3',
|
||||
/** 线宽(像素) */
|
||||
WIDTH: 1,
|
||||
/** 虚线样式 */
|
||||
DASH: '6 4',
|
||||
}
|
||||
|
||||
/**
|
||||
* 图例默认配置
|
||||
*/
|
||||
export const LEGEND_DEFAULTS = {
|
||||
/** 背景色 */
|
||||
BACKGROUND_COLOR: 'rgba(255, 255, 255, 0.7)',
|
||||
/** 位置 */
|
||||
POSITION: 'top-right' as const,
|
||||
/** 方向 */
|
||||
ORIENTATION: 'auto' as const,
|
||||
}
|
||||
|
||||
// ==================== 渲染常量 ====================
|
||||
|
||||
/**
|
||||
* 最大多轴数量
|
||||
*/
|
||||
export const MAX_MULTI_Y_AXIS_COUNT = 4
|
||||
|
||||
/**
|
||||
* 缓存限制
|
||||
*/
|
||||
export const CACHE_LIMITS = {
|
||||
/** Y轴组缓存最大条目数 */
|
||||
Y_AXIS_GROUPS: 100,
|
||||
/** 轨道距离缓存刷新阈值(像素) */
|
||||
TRACK_DISTANCE_REFRESH_THRESHOLD: 5,
|
||||
}
|
||||
|
||||
// 向后兼容性导出
|
||||
export { channelColors as default }
|
||||
/** 最小高度 */
|
||||
export const minimumHeight = 180
|
||||
|
||||
@@ -11,69 +11,11 @@ import {
|
||||
|
||||
describe('waveform grid helpers', () => {
|
||||
it('normalizes grid counts and uses a two by one default', () => {
|
||||
expect(normalizeGridOptions()).toEqual({
|
||||
rowCount: 2,
|
||||
columnCount: 1,
|
||||
showPagination: true,
|
||||
trackLines: {},
|
||||
})
|
||||
expect(normalizeGridOptions()).toEqual({ rowCount: 2, columnCount: 1, showPagination: true })
|
||||
expect(normalizeGridOptions({ rowCount: 0, columnCount: 99 })).toEqual({
|
||||
rowCount: 1,
|
||||
columnCount: 10,
|
||||
showPagination: true,
|
||||
trackLines: {},
|
||||
})
|
||||
})
|
||||
|
||||
it('normalizes per-track grid line visibility with visible defaults', () => {
|
||||
expect(
|
||||
normalizeGridOptions({
|
||||
trackLines: {
|
||||
voltage: { horizontal: false },
|
||||
current: { vertical: false },
|
||||
},
|
||||
}).trackLines,
|
||||
).toEqual({
|
||||
voltage: { horizontal: false, vertical: true },
|
||||
current: { horizontal: true, vertical: false },
|
||||
})
|
||||
})
|
||||
|
||||
it('preserves optional per-direction grid colors and ignores blank values', () => {
|
||||
expect(
|
||||
normalizeGridOptions({
|
||||
trackLines: {
|
||||
voltage: {
|
||||
horizontalColor: '#ef4444',
|
||||
verticalColor: ' #2563eb ',
|
||||
},
|
||||
current: { horizontalColor: ' ' },
|
||||
},
|
||||
}).trackLines,
|
||||
).toEqual({
|
||||
voltage: {
|
||||
horizontal: true,
|
||||
vertical: true,
|
||||
horizontalColor: '#ef4444',
|
||||
verticalColor: ' #2563eb ',
|
||||
},
|
||||
current: {
|
||||
horizontal: true,
|
||||
vertical: true,
|
||||
},
|
||||
})
|
||||
})
|
||||
|
||||
it('falls back to visible grid lines for invalid runtime values', () => {
|
||||
const options = {
|
||||
trackLines: {
|
||||
voltage: { horizontal: 'invalid', vertical: null },
|
||||
},
|
||||
} as unknown as Parameters<typeof normalizeGridOptions>[0]
|
||||
|
||||
expect(normalizeGridOptions(options).trackLines.voltage).toEqual({
|
||||
horizontal: true,
|
||||
vertical: true,
|
||||
})
|
||||
})
|
||||
|
||||
|
||||
@@ -8,32 +8,12 @@ export interface WaveformGridOptions {
|
||||
rowCount?: number
|
||||
columnCount?: number
|
||||
showPagination?: boolean
|
||||
trackLines?: WaveformGridTrackLines
|
||||
}
|
||||
|
||||
export interface WaveformGridLineOptions {
|
||||
horizontal?: boolean
|
||||
vertical?: boolean
|
||||
/** Optional stroke color for horizontal major and minor grid lines. */
|
||||
horizontalColor?: string
|
||||
/** Optional stroke color for vertical major and minor grid lines. */
|
||||
verticalColor?: string
|
||||
}
|
||||
|
||||
export type WaveformGridTrackLines = Record<string, WaveformGridLineOptions>
|
||||
|
||||
export interface NormalizedWaveformGridLineOptions {
|
||||
horizontal: boolean
|
||||
vertical: boolean
|
||||
horizontalColor?: string
|
||||
verticalColor?: string
|
||||
}
|
||||
|
||||
export interface NormalizedWaveformGridOptions {
|
||||
rowCount: number
|
||||
columnCount: number
|
||||
showPagination: boolean
|
||||
trackLines: Record<string, NormalizedWaveformGridLineOptions>
|
||||
}
|
||||
|
||||
export interface GridCellGeometry {
|
||||
@@ -57,28 +37,10 @@ const normalizeCount = (value: unknown, fallback: number) => {
|
||||
}
|
||||
|
||||
export function normalizeGridOptions(options?: WaveformGridOptions): NormalizedWaveformGridOptions {
|
||||
const trackLines = Object.fromEntries(
|
||||
Object.entries(options?.trackLines ?? {}).map(([trackId, lines]) => [
|
||||
trackId,
|
||||
{
|
||||
horizontal: typeof lines?.horizontal === 'boolean' ? lines.horizontal : true,
|
||||
vertical: typeof lines?.vertical === 'boolean' ? lines.vertical : true,
|
||||
horizontalColor:
|
||||
typeof lines?.horizontalColor === 'string' && lines.horizontalColor.trim()
|
||||
? lines.horizontalColor
|
||||
: undefined,
|
||||
verticalColor:
|
||||
typeof lines?.verticalColor === 'string' && lines.verticalColor.trim()
|
||||
? lines.verticalColor
|
||||
: undefined,
|
||||
},
|
||||
]),
|
||||
)
|
||||
return {
|
||||
rowCount: normalizeCount(options?.rowCount, 2),
|
||||
columnCount: normalizeCount(options?.columnCount, 1),
|
||||
showPagination: options?.showPagination ?? true,
|
||||
trackLines,
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
export * from './constants'
|
||||
export * from './grid'
|
||||
export * from './layout'
|
||||
export * from './types'
|
||||
export * from './useWaveformData'
|
||||
// 从 layout 选择性导出,避免重复导出 constants
|
||||
export { buildTrackLayouts, measureTrackYAxisClearance, buildYAxisSeriesGroups } from './layout'
|
||||
// 从 constants 统一导出所有常量
|
||||
export * from './constants'
|
||||
|
||||
@@ -6,7 +6,6 @@ import type { DisplaySeries, DisplayTrack } from './types'
|
||||
import {
|
||||
buildTrackLayouts,
|
||||
buildYAxisSeriesGroups,
|
||||
findClosestTrackAtPointer,
|
||||
MAX_MULTI_Y_AXIS_COUNT,
|
||||
measureYAxisGroupClearance,
|
||||
} from './layout'
|
||||
@@ -17,7 +16,6 @@ function series(id: string, minimum: number, maximum: number): DisplaySeries {
|
||||
name: id,
|
||||
color: '#1677ff',
|
||||
lineType: 'linear',
|
||||
lineStyle: 'solid',
|
||||
pointType: 'none',
|
||||
errorBar: { visible: false, width: 1.5, capWidth: 8 },
|
||||
points: [
|
||||
@@ -26,7 +24,6 @@ function series(id: string, minimum: number, maximum: number): DisplaySeries {
|
||||
],
|
||||
xDomain: [0, 1],
|
||||
yDomain: [minimum, maximum],
|
||||
hasErrorPoints: false,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -64,7 +61,7 @@ function layoutForSeries(
|
||||
series: sourceTrack,
|
||||
},
|
||||
],
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false, trackLines: {} },
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false },
|
||||
displayMode: 'independent',
|
||||
overlayMode: 'single-axis',
|
||||
independentTransforms: [transform],
|
||||
@@ -79,14 +76,6 @@ function layoutForSeries(
|
||||
}
|
||||
|
||||
describe('multi-value Y-axis grouping', () => {
|
||||
it('rebuilds Y scales when the same track ID receives a different domain', () => {
|
||||
const first = layoutForSeries(series('shared', 0, 1))
|
||||
const second = layoutForSeries(series('shared', 10_000, 20_000))
|
||||
|
||||
expect(first.yScale.domain()).toEqual([0, 1])
|
||||
expect(second.yScale.domain()).toEqual([10_000, 20_000])
|
||||
})
|
||||
|
||||
it('uses a configured visible Y domain for axis and series scales', () => {
|
||||
const source = series('a', 0, 100)
|
||||
const sourceTrack = track([source])
|
||||
@@ -106,7 +95,7 @@ describe('multi-value Y-axis grouping', () => {
|
||||
series: sourceTrack,
|
||||
},
|
||||
],
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false, trackLines: {} },
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false },
|
||||
displayMode: 'independent',
|
||||
overlayMode: 'single-axis',
|
||||
independentTransforms: [zoomIdentity],
|
||||
@@ -209,7 +198,7 @@ describe('multi-value Y-axis grouping', () => {
|
||||
series: track([series('left', 0, 254), series('right', 0, 254)]),
|
||||
},
|
||||
],
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false, trackLines: {} },
|
||||
grid: { rowCount: 1, columnCount: 1, showPagination: false },
|
||||
displayMode: 'independent',
|
||||
overlayMode: 'multi-axis',
|
||||
independentTransforms: [zoomIdentity],
|
||||
@@ -241,18 +230,6 @@ describe('multi-value Y-axis grouping', () => {
|
||||
})
|
||||
})
|
||||
|
||||
describe('track hit testing', () => {
|
||||
const tracks = [
|
||||
{ id: 'first', left: 0, top: 0, width: 100, height: 40 },
|
||||
{ id: 'second', left: 0, top: 50, width: 100, height: 40 },
|
||||
]
|
||||
|
||||
it('switches tracks immediately across a boundary less than five pixels apart', () => {
|
||||
expect(findClosestTrackAtPointer(tracks, 50, 44)?.id).toBe('first')
|
||||
expect(findClosestTrackAtPointer(tracks, 50, 46)?.id).toBe('second')
|
||||
})
|
||||
})
|
||||
|
||||
describe('decoration sampling', () => {
|
||||
const denseSeries = (): DisplaySeries => ({
|
||||
...series('dense', -1, 1),
|
||||
@@ -264,7 +241,6 @@ describe('decoration sampling', () => {
|
||||
error: index % 200 === 1 ? 0.1 : 0,
|
||||
})),
|
||||
xDomain: [0, 999],
|
||||
hasErrorPoints: true,
|
||||
})
|
||||
|
||||
it('shares prioritized source points between dense symbols and error bars', () => {
|
||||
@@ -286,7 +262,6 @@ describe('decoration sampling', () => {
|
||||
it('keeps standalone, zero-error, and non-downsampled decoration behavior', () => {
|
||||
const noErrors = denseSeries()
|
||||
noErrors.points = noErrors.points.map((point) => ({ x: point.x, y: point.y }))
|
||||
noErrors.hasErrorPoints = false
|
||||
const zeroErrorPath = layoutForSeries(noErrors)
|
||||
expect(zeroErrorPath.errorBarRenderPoints).toEqual([])
|
||||
expect(zeroErrorPath.pointRenderPoints.length).toBeLessThanOrEqual(Math.ceil(120 / 10) + 2)
|
||||
|
||||
@@ -9,9 +9,11 @@ import {
|
||||
} from 'd3'
|
||||
|
||||
import {
|
||||
selectSeriesRenderPoints,
|
||||
selectDecorationPoints,
|
||||
selectRenderablePoints,
|
||||
resolveWaveformPointErrors,
|
||||
type ResolvedWaveformRenderingOptions,
|
||||
} from '../../core/rendering'
|
||||
} from '../../core'
|
||||
import type { WaveformDisplayMode, WaveformOverlayMode, WaveformPoint } from '../../types'
|
||||
import {
|
||||
buildMinorTicks,
|
||||
@@ -27,16 +29,14 @@ import {
|
||||
type NormalizedWaveformGridOptions,
|
||||
} from './grid'
|
||||
import type { DisplaySeries, DisplayTrack, TrackLayout, WaveformYAxisLayout } from './types'
|
||||
import { MAX_MULTI_Y_AXIS_COUNT, Y_AXIS_EXPONENT_GAP } from './constants'
|
||||
|
||||
// 导出常量供外部使用
|
||||
export { MAX_MULTI_Y_AXIS_COUNT, Y_AXIS_EXPONENT_GAP } from './constants'
|
||||
|
||||
export const MAX_MULTI_Y_AXIS_COUNT = 4
|
||||
const Y_AXIS_CHARACTER_WIDTH = 7
|
||||
const Y_AXIS_TICK_PADDING = 7
|
||||
const Y_AXIS_OUTER_PADDING = 4
|
||||
const Y_AXIS_LABEL_GAP = 6
|
||||
const Y_AXIS_LABEL_BAND_WIDTH = 24
|
||||
export const Y_AXIS_EXPONENT_GAP = 8
|
||||
|
||||
interface YAxisSeriesGroup {
|
||||
index: number
|
||||
@@ -52,17 +52,39 @@ function resolveAxisSides(axisCount: number): Array<'left' | 'right'> {
|
||||
return ['left']
|
||||
}
|
||||
|
||||
// 使用 WeakMap 进行缓存优化,避免手动清理
|
||||
const yAxisGroupsCache = new WeakMap<DisplayTrack, Map<WaveformOverlayMode, YAxisSeriesGroup[]>>()
|
||||
// Cache across recreated track objects without reusing groups whose axis-relevant data changed.
|
||||
const yAxisGroupsCache = new Map<string, Map<WaveformOverlayMode, YAxisSeriesGroup[]>>()
|
||||
const MAX_CACHE_SIZE = 100
|
||||
|
||||
function getCacheKey(track: DisplayTrack): string {
|
||||
return JSON.stringify([
|
||||
track.id,
|
||||
track.yDomain,
|
||||
track.visibleSeries.map((series) => [
|
||||
series.id,
|
||||
series.name,
|
||||
series.unit,
|
||||
series.color,
|
||||
series.yDomain,
|
||||
]),
|
||||
])
|
||||
}
|
||||
|
||||
export function buildYAxisSeriesGroups(
|
||||
track: DisplayTrack,
|
||||
overlayMode: WaveformOverlayMode,
|
||||
): YAxisSeriesGroup[] {
|
||||
let trackCache = yAxisGroupsCache.get(track)
|
||||
const cacheKey = getCacheKey(track)
|
||||
let trackCache = yAxisGroupsCache.get(cacheKey)
|
||||
if (!trackCache) {
|
||||
trackCache = new Map()
|
||||
yAxisGroupsCache.set(track, trackCache)
|
||||
yAxisGroupsCache.set(cacheKey, trackCache)
|
||||
if (yAxisGroupsCache.size > MAX_CACHE_SIZE) {
|
||||
const firstKey = yAxisGroupsCache.keys().next().value
|
||||
if (firstKey !== undefined) {
|
||||
yAxisGroupsCache.delete(firstKey)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const cached = trackCache.get(overlayMode)
|
||||
@@ -161,49 +183,6 @@ interface SeriesGridCell extends GridCellGeometry {
|
||||
series?: DisplayTrack
|
||||
}
|
||||
|
||||
type PositionedTrack = Pick<TrackLayout, 'left' | 'top' | 'width' | 'height'>
|
||||
|
||||
export function findClosestTrackAtPointer<T extends PositionedTrack>(
|
||||
tracks: readonly T[],
|
||||
pointerX: number,
|
||||
pointerY: number,
|
||||
): T | undefined {
|
||||
const distanceToTrack = (track: T) => {
|
||||
const xDistance =
|
||||
pointerX < track.left
|
||||
? track.left - pointerX
|
||||
: pointerX > track.left + track.width
|
||||
? pointerX - track.left - track.width
|
||||
: 0
|
||||
return pointerY < track.top
|
||||
? track.top - pointerY
|
||||
: pointerY > track.top + track.height
|
||||
? pointerY - (track.top + track.height)
|
||||
: xDistance
|
||||
}
|
||||
|
||||
let closestTrack = tracks[0]
|
||||
if (!closestTrack) return undefined
|
||||
let closestDistance = distanceToTrack(closestTrack)
|
||||
for (let index = 1; index < tracks.length; index += 1) {
|
||||
const candidate = tracks[index]!
|
||||
const distance = distanceToTrack(candidate)
|
||||
if (distance < closestDistance) {
|
||||
closestTrack = candidate
|
||||
closestDistance = distance
|
||||
continue
|
||||
}
|
||||
if (distance === closestDistance) {
|
||||
const centerDistance = Math.abs(pointerY - (candidate.top + candidate.height / 2))
|
||||
const closestCenterDistance = Math.abs(
|
||||
pointerY - (closestTrack.top + closestTrack.height / 2),
|
||||
)
|
||||
if (centerDistance < closestCenterDistance) closestTrack = candidate
|
||||
}
|
||||
}
|
||||
return closestTrack
|
||||
}
|
||||
|
||||
export interface BuildTrackLayoutsOptions {
|
||||
cells: SeriesGridCell[]
|
||||
grid: NormalizedWaveformGridOptions
|
||||
@@ -233,13 +212,11 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
|
||||
name: '',
|
||||
color: 'transparent',
|
||||
lineType: 'linear',
|
||||
lineStyle: 'solid',
|
||||
pointType: 'none',
|
||||
errorBar: { visible: false, width: 1.5, capWidth: 8 },
|
||||
points: [],
|
||||
xDomain: [0, 1],
|
||||
yDomain: [0, 1],
|
||||
hasErrorPoints: false,
|
||||
}
|
||||
const displayTrack: DisplayTrack = cell.series ?? {
|
||||
id: emptySeries.id,
|
||||
@@ -340,18 +317,51 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
|
||||
axis.seriesList.some((series) => series.id === trackSeries.id),
|
||||
)
|
||||
const seriesYScale = yAxis?.scale ?? yScale
|
||||
const renderPoints = selectSeriesRenderPoints(
|
||||
const pathPoints = selectRenderablePoints(
|
||||
trackSeries.points,
|
||||
domain,
|
||||
cell.width,
|
||||
options.rendering,
|
||||
{
|
||||
lineVisible: !isEmpty && trackSeries.lineType !== 'none',
|
||||
pointVisible: trackSeries.pointType !== 'none',
|
||||
errorBarVisible: trackSeries.errorBar.visible,
|
||||
hasErrorPoints: trackSeries.hasErrorPoints,
|
||||
},
|
||||
)
|
||||
const hasError = (point: WaveformPoint) => {
|
||||
const { lower, upper } = resolveWaveformPointErrors(point)
|
||||
return lower !== 0 || upper !== 0
|
||||
}
|
||||
const hasErrorPoints = trackSeries.errorBar.visible && trackSeries.points.some(hasError)
|
||||
const sharesDecorationPoints = trackSeries.pointType !== 'none' && hasErrorPoints
|
||||
const sharedDecorationPoints = sharesDecorationPoints
|
||||
? selectDecorationPoints(
|
||||
trackSeries.points,
|
||||
domain,
|
||||
cell.width,
|
||||
Math.max(options.rendering.pointMinSpacing, options.rendering.errorBarMinSpacing),
|
||||
options.rendering.downsample,
|
||||
undefined,
|
||||
hasError,
|
||||
)
|
||||
: undefined
|
||||
const pointRenderPoints =
|
||||
trackSeries.pointType === 'none'
|
||||
? []
|
||||
: (sharedDecorationPoints ??
|
||||
selectDecorationPoints(
|
||||
trackSeries.points,
|
||||
domain,
|
||||
cell.width,
|
||||
options.rendering.pointMinSpacing,
|
||||
options.rendering.downsample,
|
||||
))
|
||||
const errorBarRenderPoints = trackSeries.errorBar.visible
|
||||
? (sharedDecorationPoints?.filter(hasError) ??
|
||||
selectDecorationPoints(
|
||||
trackSeries.points,
|
||||
domain,
|
||||
cell.width,
|
||||
options.rendering.errorBarMinSpacing,
|
||||
options.rendering.downsample,
|
||||
hasError,
|
||||
))
|
||||
: []
|
||||
const pathGenerator = line<WaveformPoint>()
|
||||
.x((point) => xScale(point.x))
|
||||
.y((point) => seriesYScale(point.y))
|
||||
@@ -362,16 +372,15 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
|
||||
}
|
||||
return {
|
||||
series: trackSeries,
|
||||
path: renderPoints.linePoints.length ? pathGenerator(renderPoints.linePoints) : null,
|
||||
pointRenderPoints: renderPoints.pointRenderPoints,
|
||||
errorBarRenderPoints: renderPoints.errorBarRenderPoints,
|
||||
path: isEmpty || trackSeries.lineType === 'none' ? null : pathGenerator(pathPoints),
|
||||
pointRenderPoints,
|
||||
errorBarRenderPoints,
|
||||
yScale: seriesYScale,
|
||||
yAxisIndex: yAxis?.index ?? 0,
|
||||
}
|
||||
})
|
||||
|
||||
return {
|
||||
id: displayTrack.id,
|
||||
index,
|
||||
series,
|
||||
seriesList: displayTrack.visibleSeries,
|
||||
@@ -398,10 +407,6 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
|
||||
xAxisExponent,
|
||||
path: seriesPaths[0]?.path ?? null,
|
||||
seriesPaths,
|
||||
gridLines: options.grid.trackLines[displayTrack.id] ?? {
|
||||
horizontal: true,
|
||||
vertical: true,
|
||||
},
|
||||
showXAxis:
|
||||
(isEmpty || hasVisibleSeries) &&
|
||||
(options.displayMode === 'independent' ||
|
||||
|
||||
@@ -2,11 +2,9 @@ import type { ScaleLinear } from 'd3'
|
||||
import type {
|
||||
ResolvedWaveformErrorBarOptions,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPoint,
|
||||
WaveformPointType,
|
||||
} from '../../types'
|
||||
import type { NormalizedWaveformGridLineOptions } from './grid'
|
||||
|
||||
/**
|
||||
* 显示系列
|
||||
@@ -18,13 +16,11 @@ export interface DisplaySeries {
|
||||
unit?: string
|
||||
color: string
|
||||
lineType: WaveformLineType
|
||||
lineStyle: WaveformLineStyle
|
||||
pointType: WaveformPointType
|
||||
errorBar: ResolvedWaveformErrorBarOptions
|
||||
points: WaveformPoint[]
|
||||
xDomain: [number, number]
|
||||
yDomain: [number, number]
|
||||
hasErrorPoints: boolean
|
||||
}
|
||||
|
||||
export interface DisplayTrack {
|
||||
@@ -72,8 +68,6 @@ export interface HoveredSeriesPoint extends DisplaySeries {
|
||||
* 轨道布局
|
||||
*/
|
||||
export interface TrackLayout {
|
||||
/** Stable track key derived from trackId, or from the series id when trackId is omitted. */
|
||||
id: string
|
||||
index: number
|
||||
series: DisplaySeries
|
||||
/** Visible series used by rendering and interaction code. */
|
||||
@@ -103,7 +97,6 @@ export interface TrackLayout {
|
||||
path: string | null
|
||||
seriesPaths: TrackSeriesPath[]
|
||||
showXAxis: boolean
|
||||
gridLines: NormalizedWaveformGridLineOptions
|
||||
}
|
||||
|
||||
// 重新导出 WaveformPoint 方便使用
|
||||
|
||||
@@ -5,7 +5,6 @@ import type {
|
||||
ResolvedWaveformErrorBarOptions,
|
||||
WaveformData,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPoint,
|
||||
WaveformPointType,
|
||||
} from '../../types'
|
||||
@@ -18,48 +17,39 @@ export interface PreparedWaveformSeries {
|
||||
unit?: string
|
||||
color?: string
|
||||
lineType: WaveformLineType
|
||||
lineStyle: WaveformLineStyle
|
||||
pointType: WaveformPointType
|
||||
errorBar: ResolvedWaveformErrorBarOptions
|
||||
points: WaveformPoint[]
|
||||
xDomain: [number, number]
|
||||
yDomain: [number, number]
|
||||
hasErrorPoints: boolean
|
||||
}
|
||||
|
||||
function pointMetrics(
|
||||
function pointDomain(
|
||||
points: WaveformPoint[],
|
||||
key: 'x' | 'y',
|
||||
includeErrors = false,
|
||||
): { xDomain: [number, number]; yDomain: [number, number]; hasErrorPoints: boolean } {
|
||||
let xMinimum = Number.POSITIVE_INFINITY
|
||||
let xMaximum = Number.NEGATIVE_INFINITY
|
||||
let yMinimum = Number.POSITIVE_INFINITY
|
||||
let yMaximum = Number.NEGATIVE_INFINITY
|
||||
let hasErrorPoints = false
|
||||
for (const point of points) {
|
||||
if (point.x < xMinimum) xMinimum = point.x
|
||||
if (point.x > xMaximum) xMaximum = point.x
|
||||
if (point.y < yMinimum) yMinimum = point.y
|
||||
if (point.y > yMaximum) yMaximum = point.y
|
||||
if (includeErrors) {
|
||||
): [number, number] {
|
||||
let minimum = Number.POSITIVE_INFINITY
|
||||
let maximum = Number.NEGATIVE_INFINITY
|
||||
points.forEach((point) => {
|
||||
const value = point[key]
|
||||
if (value < minimum) minimum = value
|
||||
if (value > maximum) maximum = value
|
||||
if (key === 'y' && includeErrors) {
|
||||
const errors = resolveWaveformPointErrors(point)
|
||||
if (errors.lower !== 0 || errors.upper !== 0) hasErrorPoints = true
|
||||
yMinimum = Math.min(yMinimum, point.y - errors.lower)
|
||||
yMaximum = Math.max(yMaximum, point.y + errors.upper)
|
||||
minimum = Math.min(minimum, point.y - errors.lower)
|
||||
maximum = Math.max(maximum, point.y + errors.upper)
|
||||
}
|
||||
}
|
||||
return {
|
||||
xDomain: paddedDomain(Number.isFinite(xMinimum) ? [xMinimum, xMaximum] : []),
|
||||
yDomain: paddedDomain(Number.isFinite(yMinimum) ? [yMinimum, yMaximum] : []),
|
||||
hasErrorPoints,
|
||||
}
|
||||
})
|
||||
return paddedDomain(Number.isFinite(minimum) ? [minimum, maximum] : [])
|
||||
}
|
||||
|
||||
export function prepareWaveformSeries(data: WaveformData): PreparedWaveformSeries[] {
|
||||
return normalizeWaveformSeries(data).map((series) => {
|
||||
const metrics = pointMetrics(series.points, series.errorBar.visible)
|
||||
return { ...series, ...metrics }
|
||||
})
|
||||
return normalizeWaveformSeries(data).map((series) => ({
|
||||
...series,
|
||||
xDomain: pointDomain(series.points, 'x'),
|
||||
yDomain: pointDomain(series.points, 'y', series.errorBar.visible),
|
||||
}))
|
||||
}
|
||||
|
||||
export function usePreparedWaveformSeries(data: () => WaveformData, onDataChange: () => void) {
|
||||
|
||||
@@ -19,11 +19,9 @@ export type {
|
||||
WaveformLegendOrientation,
|
||||
WaveformLegendOptions,
|
||||
WaveformFrameStyle,
|
||||
WaveformAxesOptions,
|
||||
WaveformZeroLineOptions,
|
||||
SingleWaveformData,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPointType,
|
||||
WaveformErrorBarOptions,
|
||||
ResolvedWaveformErrorBarOptions,
|
||||
@@ -32,11 +30,7 @@ export type {
|
||||
NormalizedWaveformSeries,
|
||||
} from '../../types'
|
||||
|
||||
export type {
|
||||
WaveformGridOptions,
|
||||
WaveformGridLineOptions,
|
||||
WaveformGridTrackLines,
|
||||
} from '../core/grid'
|
||||
export type { WaveformGridOptions } from '../core/grid'
|
||||
|
||||
// 重新导出数据处理函数
|
||||
export { normalizeWaveformData, normalizeWaveformSeries } from '../../core'
|
||||
|
||||
@@ -17,17 +17,13 @@ export type {
|
||||
WaveformLegendOrientation,
|
||||
WaveformLegendOptions,
|
||||
WaveformFrameStyle,
|
||||
WaveformAxesOptions,
|
||||
WaveformZeroLineOptions,
|
||||
WaveformPoint,
|
||||
WaveformSeries,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPointType,
|
||||
WaveformErrorBarOptions,
|
||||
WaveformGridOptions,
|
||||
WaveformGridLineOptions,
|
||||
WaveformGridTrackLines,
|
||||
} from './data/types'
|
||||
|
||||
export type { WaveformGridOptions as WaveformGridConfig } from './core/grid'
|
||||
|
||||
@@ -6,7 +6,6 @@ import type { DisplaySeries } from '../core/types'
|
||||
import {
|
||||
waveformLegendErrorBarPath,
|
||||
waveformLegendLinePath,
|
||||
waveformLineDasharray,
|
||||
waveformPointSymbolPath,
|
||||
} from './seriesStyle'
|
||||
|
||||
@@ -83,7 +82,6 @@ function toggleSeries(seriesId: string) {
|
||||
viewBox="0 0 26 16"
|
||||
aria-hidden="true"
|
||||
:data-line-type="item.lineType"
|
||||
:data-line-style="item.lineStyle"
|
||||
:data-point-type="item.pointType"
|
||||
:data-error-bar-visible="item.errorBar.visible || undefined"
|
||||
>
|
||||
@@ -92,7 +90,6 @@ function toggleSeries(seriesId: string) {
|
||||
class="waveform-legend__line"
|
||||
:d="waveformLegendLinePath(item.lineType) ?? undefined"
|
||||
:stroke="item.color"
|
||||
:stroke-dasharray="waveformLineDasharray(item.lineStyle)"
|
||||
stroke-width="1.5"
|
||||
fill="none"
|
||||
/>
|
||||
|
||||
@@ -3,7 +3,7 @@ import { computed } from 'vue'
|
||||
|
||||
import { resolveWaveformPointErrors } from '../../core'
|
||||
import type { TrackLayout, TrackSeriesPath } from '../core/types'
|
||||
import { waveformLineDasharray, waveformPointSeriesPath } from './seriesStyle'
|
||||
import { waveformPointSeriesPath } from './seriesStyle'
|
||||
|
||||
const props = defineProps<{
|
||||
track: TrackLayout
|
||||
@@ -63,10 +63,8 @@ const renderedSeriesPaths = computed<RenderedSeriesPath[]>(() =>
|
||||
:data-series-name="seriesPath.series.name || undefined"
|
||||
:data-y-axis-index="seriesPath.yAxisIndex"
|
||||
:data-line-type="seriesPath.series.lineType"
|
||||
:data-line-style="seriesPath.series.lineStyle"
|
||||
:d="seriesPath.path"
|
||||
:stroke="seriesPath.series.color"
|
||||
:stroke-dasharray="waveformLineDasharray(seriesPath.series.lineStyle)"
|
||||
/>
|
||||
|
||||
<g
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
import { computed, nextTick, onMounted, ref, watch } from 'vue'
|
||||
import { axisBottom, axisLeft, axisRight, select } from 'd3'
|
||||
import { formatAxisTime, formatScientificAxisLabel } from '../../utils'
|
||||
import type { WaveformAxesOptions, WaveformFrameStyle, WaveformZeroLineOptions } from '../../types'
|
||||
import type { WaveformFrameStyle, WaveformZeroLineOptions } from '../../types'
|
||||
import type { WaveformDisplayMode, WaveformInteractionMode } from '../data/types'
|
||||
import type {
|
||||
DisplaySeries,
|
||||
@@ -31,8 +31,6 @@ interface Props {
|
||||
frameNumber?: string | number
|
||||
/** 图框样式 */
|
||||
frameStyle?: WaveformFrameStyle
|
||||
/** 坐标轴线显示选项 */
|
||||
axes?: WaveformAxesOptions
|
||||
/** 时间单位 */
|
||||
timeUnit: 's' | 'ms'
|
||||
/** 悬浮点(用于显示十字线) */
|
||||
@@ -74,10 +72,7 @@ const resolvedFrameStyle = computed(() => {
|
||||
typeof borderWidth === 'number' && Number.isFinite(borderWidth) && borderWidth >= 0
|
||||
? borderWidth
|
||||
: 1,
|
||||
borderStyle:
|
||||
props.frameStyle?.borderStyle === 'dashed' || props.frameStyle?.borderStyle === 'dotted'
|
||||
? props.frameStyle.borderStyle
|
||||
: 'solid',
|
||||
borderStyle: props.frameStyle?.borderStyle === 'dashed' ? 'dashed' : 'solid',
|
||||
backgroundColor: props.frameStyle?.backgroundColor || 'transparent',
|
||||
}
|
||||
})
|
||||
@@ -143,16 +138,11 @@ function renderAxes() {
|
||||
|
||||
yAxis.tickValues(axis.tickValues)
|
||||
|
||||
const selection = select(element)
|
||||
selection.call(yAxis)
|
||||
selection
|
||||
.selectAll('path.domain')
|
||||
.attr('display', props.axes?.y?.lineVisible === false ? 'none' : null)
|
||||
select(element).call(yAxis)
|
||||
})
|
||||
|
||||
if (xAxisElement.value) {
|
||||
const selection = select(xAxisElement.value)
|
||||
selection.call(
|
||||
select(xAxisElement.value).call(
|
||||
axisBottom(props.track.xScale)
|
||||
.tickValues(props.track.xAxisTickValues)
|
||||
.tickFormat((value) =>
|
||||
@@ -166,9 +156,6 @@ function renderAxes() {
|
||||
.tickPadding(7)
|
||||
.tickSizeOuter(0),
|
||||
)
|
||||
selection
|
||||
.selectAll('path.domain')
|
||||
.attr('display', props.axes?.x?.lineVisible === false ? 'none' : null)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -184,8 +171,6 @@ watch(
|
||||
() => props.track.xAxisTickValues,
|
||||
() => props.track.yAxisTickValues,
|
||||
() => props.timeUnit,
|
||||
() => props.axes?.x?.lineVisible,
|
||||
() => props.axes?.y?.lineVisible,
|
||||
],
|
||||
async () => {
|
||||
await nextTick()
|
||||
@@ -226,58 +211,42 @@ watch(
|
||||
<g
|
||||
class="waveform-track__grid waveform-track__grid--minor waveform-chart__grid waveform-chart__grid--minor"
|
||||
>
|
||||
<template v-if="track.gridLines.vertical">
|
||||
<line
|
||||
v-for="tick in track.xMinorTicks"
|
||||
:key="`x-minor-${track.index}-${tick}`"
|
||||
data-grid-direction="vertical"
|
||||
:stroke="track.gridLines.verticalColor"
|
||||
:x1="track.xScale(tick)"
|
||||
:x2="track.xScale(tick)"
|
||||
y1="0"
|
||||
:y2="track.height"
|
||||
/>
|
||||
</template>
|
||||
<template v-if="track.gridLines.horizontal">
|
||||
<line
|
||||
v-for="tick in track.yMinorTicks"
|
||||
:key="`y-minor-${track.index}-${tick}`"
|
||||
data-grid-direction="horizontal"
|
||||
:stroke="track.gridLines.horizontalColor"
|
||||
x1="0"
|
||||
:x2="track.width ?? innerWidth"
|
||||
:y1="track.yScale(tick)"
|
||||
:y2="track.yScale(tick)"
|
||||
/>
|
||||
</template>
|
||||
<line
|
||||
v-for="tick in track.xMinorTicks"
|
||||
:key="`x-minor-${track.index}-${tick}`"
|
||||
:x1="track.xScale(tick)"
|
||||
:x2="track.xScale(tick)"
|
||||
y1="0"
|
||||
:y2="track.height"
|
||||
/>
|
||||
<line
|
||||
v-for="tick in track.yMinorTicks"
|
||||
:key="`y-minor-${track.index}-${tick}`"
|
||||
x1="0"
|
||||
:x2="track.width ?? innerWidth"
|
||||
:y1="track.yScale(tick)"
|
||||
:y2="track.yScale(tick)"
|
||||
/>
|
||||
</g>
|
||||
<g
|
||||
class="waveform-track__grid waveform-track__grid--major waveform-chart__grid waveform-chart__grid--major"
|
||||
>
|
||||
<template v-if="track.gridLines.vertical">
|
||||
<line
|
||||
v-for="tick in track.xMajorTicks"
|
||||
:key="`x-major-${track.index}-${tick}`"
|
||||
data-grid-direction="vertical"
|
||||
:stroke="track.gridLines.verticalColor"
|
||||
:x1="track.xScale(tick)"
|
||||
:x2="track.xScale(tick)"
|
||||
y1="0"
|
||||
:y2="track.height"
|
||||
/>
|
||||
</template>
|
||||
<template v-if="track.gridLines.horizontal">
|
||||
<line
|
||||
v-for="tick in track.yMajorTicks"
|
||||
:key="`y-major-${track.index}-${tick}`"
|
||||
data-grid-direction="horizontal"
|
||||
:stroke="track.gridLines.horizontalColor"
|
||||
x1="0"
|
||||
:x2="track.width ?? innerWidth"
|
||||
:y1="track.yScale(tick)"
|
||||
:y2="track.yScale(tick)"
|
||||
/>
|
||||
</template>
|
||||
<line
|
||||
v-for="tick in track.xMajorTicks"
|
||||
:key="`x-major-${track.index}-${tick}`"
|
||||
:x1="track.xScale(tick)"
|
||||
:x2="track.xScale(tick)"
|
||||
y1="0"
|
||||
:y2="track.height"
|
||||
/>
|
||||
<line
|
||||
v-for="tick in track.yMajorTicks"
|
||||
:key="`y-major-${track.index}-${tick}`"
|
||||
x1="0"
|
||||
:x2="track.width ?? innerWidth"
|
||||
:y1="track.yScale(tick)"
|
||||
:y2="track.yScale(tick)"
|
||||
/>
|
||||
</g>
|
||||
</g>
|
||||
|
||||
@@ -322,7 +291,6 @@ watch(
|
||||
v-if="track.showXAxis && !cleanView"
|
||||
ref="xAxisElement"
|
||||
class="waveform-track__axis waveform-track__axis--x waveform-chart__axis waveform-chart__axis--x"
|
||||
:class="{ 'waveform-track__axis--line-hidden': axes?.x?.lineVisible === false }"
|
||||
:transform="`translate(0, ${track.height})`"
|
||||
/>
|
||||
<g
|
||||
@@ -369,10 +337,7 @@ watch(
|
||||
:key="`y-axis-${track.index}-${axis.index}`"
|
||||
:ref="(element) => setYAxisElement(element, axis.index)"
|
||||
class="waveform-track__axis waveform-track__axis--y waveform-chart__axis waveform-chart__axis--y"
|
||||
:class="[
|
||||
`waveform-track__axis--${axis.side}`,
|
||||
{ 'waveform-track__axis--line-hidden': axes?.y?.lineVisible === false },
|
||||
]"
|
||||
:class="`waveform-track__axis--${axis.side}`"
|
||||
:data-y-axis-index="axis.index"
|
||||
:data-y-axis-side="axis.side"
|
||||
:transform="`translate(${axis.x}, 0)`"
|
||||
@@ -458,14 +423,7 @@ watch(
|
||||
fill="none"
|
||||
:stroke="resolvedFrameStyle.borderColor"
|
||||
:stroke-width="resolvedFrameStyle.borderWidth"
|
||||
:stroke-dasharray="
|
||||
resolvedFrameStyle.borderStyle === 'dashed'
|
||||
? '6 4'
|
||||
: resolvedFrameStyle.borderStyle === 'dotted'
|
||||
? '1 3'
|
||||
: undefined
|
||||
"
|
||||
:stroke-linecap="resolvedFrameStyle.borderStyle === 'dotted' ? 'round' : undefined"
|
||||
:stroke-dasharray="resolvedFrameStyle.borderStyle === 'dashed' ? '6 4' : undefined"
|
||||
aria-hidden="true"
|
||||
/>
|
||||
|
||||
|
||||
@@ -7,7 +7,7 @@ import {
|
||||
type SymbolType,
|
||||
} from 'd3'
|
||||
|
||||
import type { WaveformLineStyle, WaveformLineType, WaveformPointType } from '../../types'
|
||||
import type { WaveformLineType, WaveformPointType } from '../../types'
|
||||
|
||||
const LEGEND_SWATCH_CENTER_X = 13
|
||||
const LEGEND_ERROR_BAR_TOP = 2
|
||||
@@ -82,12 +82,6 @@ export function waveformLegendLinePath(lineType: WaveformLineType): string | nul
|
||||
return 'M1 8H25'
|
||||
}
|
||||
|
||||
export function waveformLineDasharray(lineStyle: WaveformLineStyle): string | undefined {
|
||||
if (lineStyle === 'dashed') return '8 5'
|
||||
if (lineStyle === 'dash-dot') return '8 5 1.5 5'
|
||||
return undefined
|
||||
}
|
||||
|
||||
export function waveformLegendErrorBarPath(capWidth: number): string {
|
||||
const resolvedCapWidth =
|
||||
Number.isFinite(capWidth) && capWidth > 0
|
||||
|
||||
@@ -17,7 +17,6 @@ export type {
|
||||
WaveformFrameStyle,
|
||||
SingleWaveformData,
|
||||
WaveformSeries,
|
||||
WaveformLineStyle,
|
||||
WaveformData,
|
||||
NormalizedWaveformSeries,
|
||||
} from '../types'
|
||||
|
||||
@@ -1,105 +0,0 @@
|
||||
import { describe, expect, it, vi } from 'vitest'
|
||||
|
||||
import { normalizeWaveformData, normalizeWaveformSeries } from './data'
|
||||
|
||||
describe('waveform data normalization', () => {
|
||||
it('builds sample points in one pass while preserving source indexes', () => {
|
||||
expect(
|
||||
normalizeWaveformData({
|
||||
kind: 'samples',
|
||||
values: [1, Number.NaN, 3],
|
||||
sampleRate: 2,
|
||||
startTime: 1,
|
||||
}),
|
||||
).toEqual([
|
||||
{ x: 1, y: 1 },
|
||||
{ x: 2, y: 3 },
|
||||
])
|
||||
})
|
||||
|
||||
it('skips sorting already ordered points and normalizes errors', () => {
|
||||
const sortSpy = vi.spyOn(Array.prototype, 'sort')
|
||||
try {
|
||||
const result = normalizeWaveformData({
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 0, y: 1, error: -1, upperError: 2 },
|
||||
{ x: 1, y: 2, lowerError: 3 },
|
||||
],
|
||||
})
|
||||
|
||||
expect(sortSpy).not.toHaveBeenCalled()
|
||||
expect(result).toEqual([
|
||||
{ x: 0, y: 1, upperError: 2 },
|
||||
{ x: 1, y: 2, lowerError: 3 },
|
||||
])
|
||||
} finally {
|
||||
sortSpy.mockRestore()
|
||||
}
|
||||
})
|
||||
|
||||
it('sorts only unordered points and preserves duplicate-x order', () => {
|
||||
expect(
|
||||
normalizeWaveformData({
|
||||
kind: 'points',
|
||||
points: [
|
||||
{ x: 2, y: 20 },
|
||||
{ x: 1, y: 10 },
|
||||
{ x: 1, y: 11 },
|
||||
{ x: Number.NaN, y: 12 },
|
||||
],
|
||||
}),
|
||||
).toEqual([
|
||||
{ x: 1, y: 10 },
|
||||
{ x: 1, y: 11 },
|
||||
{ x: 2, y: 20 },
|
||||
])
|
||||
})
|
||||
|
||||
it('preserves every valid point in large data sets', () => {
|
||||
const points = Array.from({ length: 10_001 }, (_, index) => ({
|
||||
x: index,
|
||||
y: index === 5_555 ? 1 : 0,
|
||||
...(index === 5_555 ? { error: 10_000 } : {}),
|
||||
}))
|
||||
|
||||
const result = normalizeWaveformData({ kind: 'points', points })
|
||||
|
||||
expect(result).toHaveLength(points.length)
|
||||
expect(result[5_555]).toEqual({ x: 5_555, y: 1, error: 10_000 })
|
||||
})
|
||||
|
||||
it('defaults and normalizes per-series line styles', () => {
|
||||
const data = {
|
||||
kind: 'series' as const,
|
||||
series: [
|
||||
{ id: 'solid', name: 'Solid', data: { kind: 'points' as const, points: [{ x: 0, y: 1 }] } },
|
||||
{
|
||||
id: 'dashed',
|
||||
name: 'Dashed',
|
||||
lineStyle: 'dashed' as const,
|
||||
data: { kind: 'points' as const, points: [{ x: 0, y: 1 }] },
|
||||
},
|
||||
{
|
||||
id: 'dash-dot',
|
||||
name: 'Dash dot',
|
||||
lineStyle: 'dash-dot' as const,
|
||||
data: { kind: 'points' as const, points: [{ x: 0, y: 1 }] },
|
||||
},
|
||||
{
|
||||
id: 'invalid',
|
||||
name: 'Invalid',
|
||||
lineStyle: 'zigzag' as never,
|
||||
data: { kind: 'points' as const, points: [{ x: 0, y: 1 }] },
|
||||
},
|
||||
],
|
||||
}
|
||||
|
||||
expect(normalizeWaveformSeries(data).map((series) => series.lineStyle)).toEqual([
|
||||
'solid',
|
||||
'dashed',
|
||||
'dash-dot',
|
||||
'solid',
|
||||
])
|
||||
})
|
||||
})
|
||||
@@ -2,17 +2,11 @@ import type {
|
||||
SingleWaveformData,
|
||||
WaveformData,
|
||||
WaveformPoint,
|
||||
WaveformLineStyle,
|
||||
NormalizedWaveformSeries,
|
||||
} from '../types'
|
||||
import { ERROR_BAR_DEFAULTS } from '../components/core/constants'
|
||||
|
||||
const DEFAULT_ERROR_BAR_WIDTH = ERROR_BAR_DEFAULTS.WIDTH
|
||||
const DEFAULT_ERROR_BAR_CAP_WIDTH = ERROR_BAR_DEFAULTS.CAP_WIDTH
|
||||
|
||||
function normalizeLineStyle(value: unknown): WaveformLineStyle {
|
||||
return value === 'dashed' || value === 'dash-dot' ? value : 'solid'
|
||||
}
|
||||
const DEFAULT_ERROR_BAR_WIDTH = 1.5
|
||||
const DEFAULT_ERROR_BAR_CAP_WIDTH = 8
|
||||
|
||||
function normalizeError(value: number | undefined): number | undefined {
|
||||
return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined
|
||||
@@ -52,29 +46,15 @@ export function normalizeWaveformData(data: SingleWaveformData): WaveformPoint[]
|
||||
if (!Number.isFinite(data.sampleRate) || data.sampleRate <= 0) return []
|
||||
|
||||
const startTime = Number.isFinite(data.startTime) ? (data.startTime ?? 0) : 0
|
||||
const points: WaveformPoint[] = []
|
||||
for (let index = 0; index < data.values.length; index += 1) {
|
||||
const value = data.values[index]
|
||||
if (!Number.isFinite(value)) continue
|
||||
points.push({ x: startTime + index / data.sampleRate, y: value })
|
||||
}
|
||||
|
||||
return points
|
||||
return data.values.flatMap((value, index) =>
|
||||
Number.isFinite(value) ? [{ x: startTime + index / data.sampleRate, y: value }] : [],
|
||||
)
|
||||
}
|
||||
|
||||
const points: WaveformPoint[] = []
|
||||
let previousX = Number.NEGATIVE_INFINITY
|
||||
let sorted = true
|
||||
for (const point of data.points) {
|
||||
if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) continue
|
||||
const normalized = normalizeWaveformPoint(point)
|
||||
if (normalized.x < previousX) sorted = false
|
||||
previousX = normalized.x
|
||||
points.push(normalized)
|
||||
}
|
||||
if (!sorted) points.sort((left, right) => left.x - right.x)
|
||||
|
||||
return points
|
||||
return data.points
|
||||
.filter((point) => Number.isFinite(point.x) && Number.isFinite(point.y))
|
||||
.map(normalizeWaveformPoint)
|
||||
.sort((left, right) => left.x - right.x)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -91,7 +71,6 @@ export function normalizeWaveformSeries(data: WaveformData): NormalizedWaveformS
|
||||
id: 'series-0',
|
||||
name: '',
|
||||
lineType: 'linear',
|
||||
lineStyle: 'solid',
|
||||
pointType: 'none',
|
||||
errorBar: {
|
||||
visible: false,
|
||||
@@ -120,7 +99,6 @@ export function normalizeWaveformSeries(data: WaveformData): NormalizedWaveformS
|
||||
usedIds.add(uniqueId)
|
||||
|
||||
const requestedLineType = series.lineType ?? 'linear'
|
||||
const lineStyle = normalizeLineStyle((series as { lineStyle?: unknown }).lineStyle)
|
||||
const requestedPointType = series.pointType ?? 'none'
|
||||
const errorBarVisible = series.errorBar?.visible === true
|
||||
const lineType =
|
||||
@@ -137,7 +115,6 @@ export function normalizeWaveformSeries(data: WaveformData): NormalizedWaveformS
|
||||
unit: series.unit,
|
||||
color: series.color,
|
||||
lineType,
|
||||
lineStyle,
|
||||
pointType: requestedPointType,
|
||||
errorBar: {
|
||||
visible: errorBarVisible,
|
||||
|
||||
@@ -2,11 +2,9 @@ import { describe, expect, it } from 'vitest'
|
||||
|
||||
import type { WaveformPoint } from '../types'
|
||||
import {
|
||||
hasMinimumVisibleXValues,
|
||||
resolveWaveformRenderingOptions,
|
||||
selectDecorationPoints,
|
||||
selectRenderablePoints,
|
||||
selectSeriesRenderPoints,
|
||||
} from './rendering'
|
||||
|
||||
describe('waveform rendering selection', () => {
|
||||
@@ -124,66 +122,4 @@ describe('waveform rendering selection', () => {
|
||||
expect(selected.filter(hasError)).toEqual(priorityPoints.filter(hasError))
|
||||
expect(selected.length).toBeLessThanOrEqual(Math.ceil(100 / 20) + 2)
|
||||
})
|
||||
|
||||
it('shares visible-range selection for a dense 100k-point series', () => {
|
||||
const densePoints = Array.from({ length: 100_000 }, (_, index): WaveformPoint => ({
|
||||
x: index,
|
||||
y: index === 50_001 ? 10_000 : Math.sin(index / 20),
|
||||
error: index % 1_000 === 0 ? 1 : undefined,
|
||||
}))
|
||||
const selected = selectSeriesRenderPoints(
|
||||
densePoints,
|
||||
[99_999, 0],
|
||||
500,
|
||||
resolveWaveformRenderingOptions({ downsampleThreshold: 100 }),
|
||||
{
|
||||
lineVisible: true,
|
||||
pointVisible: true,
|
||||
errorBarVisible: true,
|
||||
hasErrorPoints: true,
|
||||
},
|
||||
)
|
||||
|
||||
expect(selected.linePoints.length).toBeLessThanOrEqual(2_002)
|
||||
expect(selected.linePoints).toContain(densePoints[50_001])
|
||||
expect(selected.linePoints[0]).toBe(densePoints[0])
|
||||
expect(selected.linePoints.at(-1)).toBe(densePoints.at(-1))
|
||||
expect(selected.pointRenderPoints.length).toBeLessThanOrEqual(52)
|
||||
expect(selected.errorBarRenderPoints.every((point) => (point.error ?? 0) > 0)).toBe(true)
|
||||
})
|
||||
|
||||
it('counts unique visible x values across series and reversed domains', () => {
|
||||
const first = {
|
||||
points: [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 1 },
|
||||
],
|
||||
}
|
||||
const second = {
|
||||
points: [
|
||||
{ x: 0, y: 2 },
|
||||
{ x: 1, y: 3 },
|
||||
{ x: 2, y: 4 },
|
||||
],
|
||||
}
|
||||
|
||||
expect(hasMinimumVisibleXValues([first, second], [2, 0], 3)).toBe(true)
|
||||
expect(hasMinimumVisibleXValues([first, second], [0, 2], 4)).toBe(false)
|
||||
expect(hasMinimumVisibleXValues([first, second], [1, 1], 1)).toBe(true)
|
||||
expect(hasMinimumVisibleXValues([first, second], [3, 4], 1)).toBe(false)
|
||||
})
|
||||
|
||||
it('stops scanning a 100k-point series after reaching the minimum', () => {
|
||||
const source = Array.from({ length: 100_000 }, (_, index) => ({ x: index, y: index }))
|
||||
let pointReads = 0
|
||||
const points = new Proxy(source, {
|
||||
get(target, property, receiver) {
|
||||
if (typeof property === 'string' && /^\d+$/.test(property)) pointReads += 1
|
||||
return Reflect.get(target, property, receiver)
|
||||
},
|
||||
})
|
||||
|
||||
expect(hasMinimumVisibleXValues([{ points }], [0, 99_999], 5)).toBe(true)
|
||||
expect(pointReads).toBeLessThan(100)
|
||||
})
|
||||
})
|
||||
|
||||
@@ -1,7 +1,6 @@
|
||||
import { bisector } from 'd3'
|
||||
|
||||
import type { WaveformPoint, WaveformRenderingOptions } from '@/types'
|
||||
import { resolveWaveformPointErrors } from './data'
|
||||
|
||||
export interface ResolvedWaveformRenderingOptions {
|
||||
downsample: boolean
|
||||
@@ -20,59 +19,6 @@ export const DEFAULT_WAVEFORM_RENDERING_OPTIONS: ResolvedWaveformRenderingOption
|
||||
}
|
||||
|
||||
const pointBisector = bisector((point: WaveformPoint) => point.x)
|
||||
const acceptAllPoints = () => true
|
||||
|
||||
interface VisiblePointRange {
|
||||
start: number
|
||||
end: number
|
||||
}
|
||||
|
||||
interface PointSeriesSource {
|
||||
points: WaveformPoint[]
|
||||
}
|
||||
|
||||
interface SeriesRenderSelectionOptions {
|
||||
lineVisible: boolean
|
||||
pointVisible: boolean
|
||||
errorBarVisible: boolean
|
||||
hasErrorPoints: boolean
|
||||
}
|
||||
|
||||
export interface SeriesRenderPointSelection {
|
||||
linePoints: WaveformPoint[]
|
||||
pointRenderPoints: WaveformPoint[]
|
||||
errorBarRenderPoints: WaveformPoint[]
|
||||
}
|
||||
|
||||
export function resolveVisiblePointRange(
|
||||
points: WaveformPoint[],
|
||||
domain: [number, number],
|
||||
): VisiblePointRange {
|
||||
const domainStart = Math.min(domain[0], domain[1])
|
||||
const domainEnd = Math.max(domain[0], domain[1])
|
||||
return {
|
||||
start: pointBisector.left(points, domainStart),
|
||||
end: pointBisector.right(points, domainEnd),
|
||||
}
|
||||
}
|
||||
|
||||
export function hasMinimumVisibleXValues(
|
||||
seriesList: readonly PointSeriesSource[],
|
||||
domain: [number, number],
|
||||
minimum: number,
|
||||
): boolean {
|
||||
if (!Number.isFinite(minimum) || minimum <= 0) return true
|
||||
const required = Math.ceil(minimum)
|
||||
const xValues = new Set<number>()
|
||||
for (const series of seriesList) {
|
||||
const range = resolveVisiblePointRange(series.points, domain)
|
||||
for (let index = range.start; index < range.end; index += 1) {
|
||||
xValues.add(series.points[index].x)
|
||||
if (xValues.size >= required) return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
export function resolveWaveformRenderingOptions(
|
||||
options?: WaveformRenderingOptions,
|
||||
@@ -106,17 +52,24 @@ function pushUniquePoint(target: WaveformPoint[], point: WaveformPoint | undefin
|
||||
if (point && target[target.length - 1] !== point) target.push(point)
|
||||
}
|
||||
|
||||
function selectRenderablePointsInRange(
|
||||
/**
|
||||
* Select the visible source range and preserve first/min/max/last values in each X bucket.
|
||||
* Source points must be sorted by X.
|
||||
*/
|
||||
export function selectRenderablePoints(
|
||||
points: WaveformPoint[],
|
||||
range: VisiblePointRange,
|
||||
domain: [number, number],
|
||||
width: number,
|
||||
options: ResolvedWaveformRenderingOptions,
|
||||
): WaveformPoint[] {
|
||||
if (!points.length || width <= 0) return []
|
||||
|
||||
const domainStart = Math.min(domain[0], domain[1])
|
||||
const domainEnd = Math.max(domain[0], domain[1])
|
||||
const start = Math.max(0, range.start - 1)
|
||||
const end = Math.min(points.length, range.end + 1)
|
||||
const visibleStart = pointBisector.left(points, domainStart)
|
||||
const visibleEnd = pointBisector.right(points, domainEnd)
|
||||
const start = Math.max(0, visibleStart - 1)
|
||||
const end = Math.min(points.length, visibleEnd + 1)
|
||||
const visibleCount = end - start
|
||||
if (visibleCount <= 0) return []
|
||||
if (!options.downsample || visibleCount <= options.downsampleThreshold) {
|
||||
@@ -129,45 +82,22 @@ function selectRenderablePointsInRange(
|
||||
|
||||
const result: WaveformPoint[] = []
|
||||
const span = domainEnd - domainStart || 1
|
||||
const bucketIndexes = Array.from({ length: 4 }, () => -1)
|
||||
let activeBucket = -1
|
||||
let firstIndex = -1
|
||||
let lastIndex = -1
|
||||
let minimumIndex = -1
|
||||
let maximumIndex = -1
|
||||
|
||||
const addBucketIndex = (index: number, count: number) => {
|
||||
if (index < 0) return count
|
||||
for (let position = 0; position < count; position += 1) {
|
||||
if (bucketIndexes[position] === index) return count
|
||||
}
|
||||
bucketIndexes[count] = index
|
||||
return count + 1
|
||||
}
|
||||
|
||||
const flushBucket = () => {
|
||||
if (firstIndex < 0) return
|
||||
let count = 0
|
||||
count = addBucketIndex(firstIndex, count)
|
||||
count = addBucketIndex(minimumIndex, count)
|
||||
count = addBucketIndex(maximumIndex, count)
|
||||
count = addBucketIndex(lastIndex, count)
|
||||
for (let index = 1; index < count; index += 1) {
|
||||
const value = bucketIndexes[index]
|
||||
let position = index - 1
|
||||
while (position >= 0 && bucketIndexes[position] > value) {
|
||||
bucketIndexes[position + 1] = bucketIndexes[position]
|
||||
position -= 1
|
||||
}
|
||||
bucketIndexes[position + 1] = value
|
||||
}
|
||||
for (let index = 0; index < count; index += 1) {
|
||||
pushUniquePoint(result, points[bucketIndexes[index]])
|
||||
}
|
||||
const indexes = [firstIndex, minimumIndex, maximumIndex, lastIndex]
|
||||
.filter((index, position, source) => index >= 0 && source.indexOf(index) === position)
|
||||
.sort((left, right) => left - right)
|
||||
indexes.forEach((index) => pushUniquePoint(result, points[index]))
|
||||
}
|
||||
|
||||
pushUniquePoint(result, points[start])
|
||||
for (let index = range.start; index < range.end; index += 1) {
|
||||
for (let index = Math.max(start, visibleStart); index < Math.min(end, visibleEnd); index += 1) {
|
||||
const point = points[index]
|
||||
const bucket = Math.min(
|
||||
bucketCount - 1,
|
||||
@@ -191,61 +121,33 @@ function selectRenderablePointsInRange(
|
||||
return result
|
||||
}
|
||||
|
||||
/**
|
||||
* Select the visible source range and preserve first/min/max/last values in each X bucket.
|
||||
* Source points must be sorted by X.
|
||||
*/
|
||||
export function selectRenderablePoints(
|
||||
/** Selects real source points for discrete decorations without using line-extrema sampling. */
|
||||
export function selectDecorationPoints(
|
||||
points: WaveformPoint[],
|
||||
domain: [number, number],
|
||||
width: number,
|
||||
options: ResolvedWaveformRenderingOptions,
|
||||
): WaveformPoint[] {
|
||||
if (!points.length || width <= 0) return []
|
||||
return selectRenderablePointsInRange(
|
||||
points,
|
||||
resolveVisiblePointRange(points, domain),
|
||||
domain,
|
||||
width,
|
||||
options,
|
||||
)
|
||||
}
|
||||
|
||||
function selectDecorationPointsInRange(
|
||||
points: WaveformPoint[],
|
||||
range: VisiblePointRange,
|
||||
domain: [number, number],
|
||||
width: number,
|
||||
minSpacing: number,
|
||||
downsample: boolean,
|
||||
predicate: (point: WaveformPoint) => boolean,
|
||||
predicate: (point: WaveformPoint) => boolean = () => true,
|
||||
priorityPredicate?: (point: WaveformPoint) => boolean,
|
||||
): WaveformPoint[] {
|
||||
if (!downsample || minSpacing === 0) {
|
||||
if (predicate === acceptAllPoints) return points.slice(range.start, range.end)
|
||||
const visiblePoints: WaveformPoint[] = []
|
||||
for (let index = range.start; index < range.end; index += 1) {
|
||||
if (predicate(points[index])) visiblePoints.push(points[index])
|
||||
}
|
||||
return visiblePoints
|
||||
}
|
||||
if (!points.length || width <= 0) return []
|
||||
|
||||
const domainStart = Math.min(domain[0], domain[1])
|
||||
const domainEnd = Math.max(domain[0], domain[1])
|
||||
const span = domainEnd - domainStart
|
||||
if (span <= 0) {
|
||||
for (let index = range.start; index < range.end; index += 1) {
|
||||
if (predicate(points[index])) return [points[index]]
|
||||
}
|
||||
return []
|
||||
const visibleStart = pointBisector.left(points, domainStart)
|
||||
const visibleEnd = pointBisector.right(points, domainEnd)
|
||||
if (!downsample || minSpacing === 0) {
|
||||
return points.slice(visibleStart, visibleEnd).filter(predicate)
|
||||
}
|
||||
|
||||
const bucketCount = Math.max(1, Math.ceil(width / minSpacing))
|
||||
const bucketWidth = width / bucketCount
|
||||
let bucketPoints: Array<WaveformPoint | undefined> | undefined
|
||||
let bucketDistances: number[] | undefined
|
||||
let priorityBucketPoints: Array<WaveformPoint | undefined> | undefined
|
||||
let priorityBucketDistances: number[] | undefined
|
||||
const span = domainEnd - domainStart
|
||||
if (span <= 0) {
|
||||
const point = points.slice(visibleStart, visibleEnd).find(predicate)
|
||||
return point ? [point] : []
|
||||
}
|
||||
|
||||
const toPixel = (point: WaveformPoint) => ((point.x - domainStart) / span) * width
|
||||
const sparsePoints: WaveformPoint[] = []
|
||||
let alreadySparse = true
|
||||
let first: WaveformPoint | undefined
|
||||
@@ -253,10 +155,44 @@ function selectDecorationPointsInRange(
|
||||
let previousPixel = Number.NEGATIVE_INFINITY
|
||||
let candidateCount = 0
|
||||
|
||||
const recordBucketPoint = (point: WaveformPoint, pixel: number) => {
|
||||
if (!bucketPoints || !bucketDistances || !priorityBucketPoints || !priorityBucketDistances) {
|
||||
return
|
||||
for (let index = visibleStart; index < visibleEnd; index += 1) {
|
||||
const point = points[index]
|
||||
if (!predicate(point)) continue
|
||||
first ??= point
|
||||
last = point
|
||||
candidateCount += 1
|
||||
if (!alreadySparse) continue
|
||||
const pixel = toPixel(point)
|
||||
if (pixel - previousPixel < minSpacing) {
|
||||
alreadySparse = false
|
||||
sparsePoints.length = 0
|
||||
continue
|
||||
}
|
||||
sparsePoints.push(point)
|
||||
previousPixel = pixel
|
||||
}
|
||||
if (candidateCount <= 2) {
|
||||
if (!first) return []
|
||||
return last && last !== first ? [first, last] : [first]
|
||||
}
|
||||
if (alreadySparse) return sparsePoints
|
||||
|
||||
const bucketCount = Math.max(1, Math.ceil(width / minSpacing))
|
||||
const bucketWidth = width / bucketCount
|
||||
const bucketPoints: Array<WaveformPoint | undefined> = Array.from({ length: bucketCount })
|
||||
const bucketDistances = Array.from({ length: bucketCount }, () => Number.POSITIVE_INFINITY)
|
||||
const priorityBucketPoints: Array<WaveformPoint | undefined> = Array.from({
|
||||
length: bucketCount,
|
||||
})
|
||||
const priorityBucketDistances = Array.from(
|
||||
{ length: bucketCount },
|
||||
() => Number.POSITIVE_INFINITY,
|
||||
)
|
||||
|
||||
for (let index = visibleStart; index < visibleEnd; index += 1) {
|
||||
const point = points[index]
|
||||
if (!predicate(point)) continue
|
||||
const pixel = Math.max(0, Math.min(width, toPixel(point)))
|
||||
const bucket = Math.min(bucketCount - 1, Math.floor(pixel / bucketWidth))
|
||||
const center = (bucket + 0.5) * bucketWidth
|
||||
const distance = Math.abs(pixel - center)
|
||||
@@ -270,133 +206,10 @@ function selectDecorationPointsInRange(
|
||||
}
|
||||
}
|
||||
|
||||
const initializeBuckets = () => {
|
||||
bucketPoints = Array.from({ length: bucketCount })
|
||||
bucketDistances = Array.from({ length: bucketCount }, () => Number.POSITIVE_INFINITY)
|
||||
priorityBucketPoints = Array.from({ length: bucketCount })
|
||||
priorityBucketDistances = Array.from({ length: bucketCount }, () => Number.POSITIVE_INFINITY)
|
||||
for (const point of sparsePoints) {
|
||||
const pixel = Math.max(0, Math.min(width, ((point.x - domainStart) / span) * width))
|
||||
recordBucketPoint(point, pixel)
|
||||
}
|
||||
}
|
||||
|
||||
for (let index = range.start; index < range.end; index += 1) {
|
||||
const point = points[index]
|
||||
if (!predicate(point)) continue
|
||||
first ??= point
|
||||
last = point
|
||||
candidateCount += 1
|
||||
const pixel = Math.max(0, Math.min(width, ((point.x - domainStart) / span) * width))
|
||||
if (alreadySparse) {
|
||||
if (pixel - previousPixel < minSpacing) {
|
||||
alreadySparse = false
|
||||
initializeBuckets()
|
||||
sparsePoints.length = 0
|
||||
} else {
|
||||
sparsePoints.push(point)
|
||||
previousPixel = pixel
|
||||
}
|
||||
}
|
||||
if (!alreadySparse) recordBucketPoint(point, pixel)
|
||||
}
|
||||
if (candidateCount <= 2) {
|
||||
if (!first) return []
|
||||
return last && last !== first ? [first, last] : [first]
|
||||
}
|
||||
if (alreadySparse) return sparsePoints
|
||||
|
||||
const selected = (bucketPoints ?? [])
|
||||
.map((point, index) => priorityBucketPoints?.[index] ?? point)
|
||||
const selected = bucketPoints
|
||||
.map((point, index) => priorityBucketPoints[index] ?? point)
|
||||
.filter((point): point is WaveformPoint => point !== undefined)
|
||||
if (first && selected[0] !== first) selected.unshift(first)
|
||||
if (last && selected.at(-1) !== last) selected.push(last)
|
||||
return selected
|
||||
}
|
||||
|
||||
/** Selects real source points for discrete decorations without using line-extrema sampling. */
|
||||
export function selectDecorationPoints(
|
||||
points: WaveformPoint[],
|
||||
domain: [number, number],
|
||||
width: number,
|
||||
minSpacing: number,
|
||||
downsample: boolean,
|
||||
predicate: (point: WaveformPoint) => boolean = acceptAllPoints,
|
||||
priorityPredicate?: (point: WaveformPoint) => boolean,
|
||||
): WaveformPoint[] {
|
||||
if (!points.length || width <= 0) return []
|
||||
return selectDecorationPointsInRange(
|
||||
points,
|
||||
resolveVisiblePointRange(points, domain),
|
||||
domain,
|
||||
width,
|
||||
minSpacing,
|
||||
downsample,
|
||||
predicate,
|
||||
priorityPredicate,
|
||||
)
|
||||
}
|
||||
|
||||
function hasPointError(point: WaveformPoint): boolean {
|
||||
const { lower, upper } = resolveWaveformPointErrors(point)
|
||||
return lower !== 0 || upper !== 0
|
||||
}
|
||||
|
||||
export function selectSeriesRenderPoints(
|
||||
points: WaveformPoint[],
|
||||
domain: [number, number],
|
||||
width: number,
|
||||
rendering: ResolvedWaveformRenderingOptions,
|
||||
selection: SeriesRenderSelectionOptions,
|
||||
): SeriesRenderPointSelection {
|
||||
if (!points.length || width <= 0) {
|
||||
return { linePoints: [], pointRenderPoints: [], errorBarRenderPoints: [] }
|
||||
}
|
||||
const range = resolveVisiblePointRange(points, domain)
|
||||
const linePoints = selection.lineVisible
|
||||
? selectRenderablePointsInRange(points, range, domain, width, rendering)
|
||||
: []
|
||||
const errorBarVisible = selection.errorBarVisible && selection.hasErrorPoints
|
||||
if (selection.pointVisible && errorBarVisible) {
|
||||
const sharedPoints = selectDecorationPointsInRange(
|
||||
points,
|
||||
range,
|
||||
domain,
|
||||
width,
|
||||
Math.max(rendering.pointMinSpacing, rendering.errorBarMinSpacing),
|
||||
rendering.downsample,
|
||||
acceptAllPoints,
|
||||
hasPointError,
|
||||
)
|
||||
return {
|
||||
linePoints,
|
||||
pointRenderPoints: sharedPoints,
|
||||
errorBarRenderPoints: sharedPoints.filter(hasPointError),
|
||||
}
|
||||
}
|
||||
return {
|
||||
linePoints,
|
||||
pointRenderPoints: selection.pointVisible
|
||||
? selectDecorationPointsInRange(
|
||||
points,
|
||||
range,
|
||||
domain,
|
||||
width,
|
||||
rendering.pointMinSpacing,
|
||||
rendering.downsample,
|
||||
acceptAllPoints,
|
||||
)
|
||||
: [],
|
||||
errorBarRenderPoints: errorBarVisible
|
||||
? selectDecorationPointsInRange(
|
||||
points,
|
||||
range,
|
||||
domain,
|
||||
width,
|
||||
rendering.errorBarMinSpacing,
|
||||
rendering.downsample,
|
||||
hasPointError,
|
||||
)
|
||||
: [],
|
||||
}
|
||||
}
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -23,12 +23,10 @@ export type {
|
||||
WaveformLegendOrientation,
|
||||
WaveformLegendOptions,
|
||||
WaveformFrameStyle,
|
||||
WaveformAxesOptions,
|
||||
WaveformZeroLineOptions,
|
||||
// 数据类型
|
||||
SingleWaveformData,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPointType,
|
||||
WaveformErrorBarOptions,
|
||||
ResolvedWaveformErrorBarOptions,
|
||||
@@ -37,11 +35,7 @@ export type {
|
||||
NormalizedWaveformSeries,
|
||||
} from './types'
|
||||
|
||||
export type {
|
||||
WaveformGridOptions,
|
||||
WaveformGridLineOptions,
|
||||
WaveformGridTrackLines,
|
||||
} from './components/core/grid'
|
||||
export type { WaveformGridOptions } from './components/core/grid'
|
||||
|
||||
// 核心功能
|
||||
export { normalizeWaveformData, normalizeWaveformSeries } from './core'
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
import { createApp } from 'vue'
|
||||
import 'ant-design-vue/dist/reset.css'
|
||||
|
||||
import App from './App.vue'
|
||||
import './styles.css'
|
||||
|
||||
165
src/styles.css
165
src/styles.css
@@ -17,6 +17,12 @@
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
button,
|
||||
input,
|
||||
select {
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
html,
|
||||
body,
|
||||
#app {
|
||||
@@ -91,16 +97,124 @@ body {
|
||||
margin-bottom: 0;
|
||||
}
|
||||
|
||||
.control-panel .native-input,
|
||||
.control-panel .native-select {
|
||||
min-width: 0;
|
||||
height: 28px;
|
||||
padding: 4px 8px;
|
||||
color: #101828;
|
||||
font-size: 12px;
|
||||
background: #fff;
|
||||
border: 1px solid #d0d5dd;
|
||||
border-radius: 4px;
|
||||
outline: none;
|
||||
}
|
||||
|
||||
.control-panel .native-input:focus-visible,
|
||||
.control-panel .native-select:focus-visible,
|
||||
.control-panel button:focus-visible {
|
||||
border-color: #1677ff;
|
||||
outline: 2px solid rgb(22 119 255 / 20%);
|
||||
outline-offset: 1px;
|
||||
}
|
||||
|
||||
.control-panel .native-switch {
|
||||
position: relative;
|
||||
width: 30px;
|
||||
height: 18px;
|
||||
margin: 0;
|
||||
appearance: none;
|
||||
background: #d0d5dd;
|
||||
border: 0;
|
||||
border-radius: 999px;
|
||||
cursor: pointer;
|
||||
transition: background-color 120ms ease;
|
||||
}
|
||||
|
||||
.control-panel .native-switch::after {
|
||||
position: absolute;
|
||||
top: 3px;
|
||||
left: 3px;
|
||||
width: 12px;
|
||||
height: 12px;
|
||||
content: '';
|
||||
background: #fff;
|
||||
border-radius: 50%;
|
||||
box-shadow: 0 1px 2px rgb(16 24 40 / 20%);
|
||||
transition: transform 120ms ease;
|
||||
}
|
||||
|
||||
.control-panel .native-switch:checked {
|
||||
background: #1677ff;
|
||||
}
|
||||
|
||||
.control-panel .native-switch:checked::after {
|
||||
transform: translateX(12px);
|
||||
}
|
||||
|
||||
.control-panel .native-switch:focus-visible {
|
||||
outline: 2px solid rgb(22 119 255 / 35%);
|
||||
outline-offset: 2px;
|
||||
}
|
||||
|
||||
.control-action,
|
||||
.mobile-control-toggle,
|
||||
.control-panel__close {
|
||||
padding: 5px 10px;
|
||||
color: #344054;
|
||||
font-size: 12px;
|
||||
line-height: 18px;
|
||||
background: #fff;
|
||||
border: 1px solid #d0d5dd;
|
||||
border-radius: 4px;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.control-action:hover,
|
||||
.mobile-control-toggle:hover,
|
||||
.control-panel__close:hover {
|
||||
color: #0958d9;
|
||||
border-color: #1677ff;
|
||||
}
|
||||
|
||||
.control-action--block {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.display-mode-control {
|
||||
display: flex;
|
||||
width: 100%;
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
border: 1px solid #d0d5dd;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
.display-mode-control .ant-radio-button-wrapper {
|
||||
.display-mode-control label {
|
||||
position: relative;
|
||||
flex: 1 1 0;
|
||||
padding-inline: 7px;
|
||||
min-width: 0;
|
||||
padding: 5px 7px;
|
||||
color: #475467;
|
||||
font-size: 12px;
|
||||
text-align: center;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.display-mode-control label + label {
|
||||
border-left: 1px solid #d0d5dd;
|
||||
}
|
||||
|
||||
.display-mode-control input {
|
||||
position: absolute;
|
||||
width: 1px;
|
||||
height: 1px;
|
||||
opacity: 0;
|
||||
pointer-events: none;
|
||||
}
|
||||
|
||||
.display-mode-control input:checked + span {
|
||||
color: #0958d9;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.grid-size-control {
|
||||
@@ -112,41 +226,10 @@ body {
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.grid-size-control .ant-input-number {
|
||||
.grid-size-control .native-input {
|
||||
width: 58px;
|
||||
}
|
||||
|
||||
.grid-line-controls {
|
||||
display: grid;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.grid-line-control {
|
||||
display: grid;
|
||||
grid-template-columns: minmax(0, 1fr) auto 48px;
|
||||
gap: 10px;
|
||||
align-items: center;
|
||||
color: #475467;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.grid-line-control--switch-only {
|
||||
grid-template-columns: minmax(0, 1fr) auto;
|
||||
}
|
||||
|
||||
.grid-line-color-picker,
|
||||
.grid-line-color-picker .vc-color-wrap {
|
||||
width: 48px;
|
||||
height: 24px;
|
||||
}
|
||||
|
||||
.grid-line-color-picker .vc-color-wrap {
|
||||
margin: 0;
|
||||
border: 1px solid #d0d5dd;
|
||||
border-radius: 4px;
|
||||
box-shadow: none;
|
||||
}
|
||||
|
||||
.control-separator {
|
||||
color: #98a2b3;
|
||||
text-align: center;
|
||||
@@ -165,7 +248,7 @@ body {
|
||||
margin-top: 10px;
|
||||
}
|
||||
|
||||
.select-control .ant-select {
|
||||
.select-control .native-select {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
@@ -202,12 +285,12 @@ body {
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.frame-style-control .ant-input-number,
|
||||
.frame-style-control .ant-select {
|
||||
.frame-style-control .native-input,
|
||||
.frame-style-control .native-select {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.frame-style-control--switch .ant-switch {
|
||||
.frame-style-control--switch .native-switch {
|
||||
width: auto;
|
||||
justify-self: start;
|
||||
}
|
||||
@@ -241,8 +324,8 @@ body {
|
||||
grid-column: 1 / -1;
|
||||
}
|
||||
|
||||
.title-control .ant-select,
|
||||
.title-control .ant-input-number {
|
||||
.title-control .native-select,
|
||||
.title-control .native-input {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
|
||||
@@ -104,8 +104,6 @@ export type WaveformLegendOrientation = 'auto' | 'horizontal' | 'vertical'
|
||||
/** Options shared by legends in every multi-series track. */
|
||||
export interface WaveformLegendOptions {
|
||||
position?: WaveformLegendPosition
|
||||
/** Per-track position overrides keyed by trackId, or by series id when trackId is omitted. */
|
||||
trackPositions?: Record<string, WaveformLegendPosition>
|
||||
orientation?: WaveformLegendOrientation
|
||||
/** CSS color used by the legend panel; alpha controls background transparency. */
|
||||
backgroundColor?: string
|
||||
@@ -117,20 +115,10 @@ export interface WaveformLegendOptions {
|
||||
export interface WaveformFrameStyle {
|
||||
borderColor?: string
|
||||
borderWidth?: number
|
||||
borderStyle?: 'solid' | 'dashed' | 'dotted'
|
||||
borderStyle?: 'solid' | 'dashed'
|
||||
backgroundColor?: string
|
||||
}
|
||||
|
||||
/** Controls axis baseline visibility while preserving tick marks and axis text. */
|
||||
export interface WaveformAxesOptions {
|
||||
x?: {
|
||||
lineVisible?: boolean
|
||||
}
|
||||
y?: {
|
||||
lineVisible?: boolean
|
||||
}
|
||||
}
|
||||
|
||||
/** Styling and visibility options for the horizontal zero-value reference line. */
|
||||
export interface WaveformZeroLineOptions {
|
||||
visible?: boolean
|
||||
|
||||
@@ -9,8 +9,6 @@ export type WaveformLineType =
|
||||
/** Backward-compatible alias for `step-end`. */
|
||||
| 'step-after'
|
||||
|
||||
export type WaveformLineStyle = 'solid' | 'dashed' | 'dash-dot'
|
||||
|
||||
export type WaveformPointType = 'none' | 'circle' | 'square' | 'triangle' | 'diamond'
|
||||
|
||||
export interface WaveformErrorBarOptions {
|
||||
@@ -53,7 +51,6 @@ export interface WaveformSeries {
|
||||
unit?: string
|
||||
color?: string
|
||||
lineType?: WaveformLineType
|
||||
lineStyle?: WaveformLineStyle
|
||||
pointType?: WaveformPointType
|
||||
errorBar?: WaveformErrorBarOptions
|
||||
data: SingleWaveformData
|
||||
@@ -79,7 +76,6 @@ export interface NormalizedWaveformSeries {
|
||||
unit?: string
|
||||
color?: string
|
||||
lineType: WaveformLineType
|
||||
lineStyle: WaveformLineStyle
|
||||
pointType: WaveformPointType
|
||||
errorBar: ResolvedWaveformErrorBarOptions
|
||||
points: WaveformPoint[]
|
||||
|
||||
@@ -18,7 +18,6 @@ export type {
|
||||
WaveformLegendOrientation,
|
||||
WaveformLegendOptions,
|
||||
WaveformFrameStyle,
|
||||
WaveformAxesOptions,
|
||||
WaveformZeroLineOptions,
|
||||
} from './chart'
|
||||
|
||||
@@ -26,7 +25,6 @@ export type {
|
||||
export type {
|
||||
SingleWaveformData,
|
||||
WaveformLineType,
|
||||
WaveformLineStyle,
|
||||
WaveformPointType,
|
||||
WaveformErrorBarOptions,
|
||||
ResolvedWaveformErrorBarOptions,
|
||||
|
||||
@@ -29,11 +29,3 @@ export {
|
||||
|
||||
// 几何计算工具
|
||||
export { resolveTrackGeometry, clamp, type TrackGeometry } from './geometry'
|
||||
|
||||
// 数据抽样工具
|
||||
export {
|
||||
downsampleLTTB,
|
||||
downsampleMinMax,
|
||||
adaptiveSampling,
|
||||
calculateSamplingThreshold,
|
||||
} from './sampling'
|
||||
|
||||
@@ -1,226 +0,0 @@
|
||||
/**
|
||||
* 数据抽样算法测试
|
||||
*/
|
||||
|
||||
import { describe, it, expect } from 'vitest'
|
||||
import {
|
||||
downsampleLTTB,
|
||||
downsampleMinMax,
|
||||
adaptiveSampling,
|
||||
calculateSamplingThreshold,
|
||||
} from './sampling'
|
||||
import type { WaveformPoint } from '../types'
|
||||
|
||||
describe('downsampleLTTB', () => {
|
||||
it('returns empty array for empty input', () => {
|
||||
expect(downsampleLTTB([], 100)).toEqual([])
|
||||
})
|
||||
|
||||
it('returns original data when threshold >= data length', () => {
|
||||
const data: WaveformPoint[] = [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 1 },
|
||||
{ x: 2, y: 2 },
|
||||
]
|
||||
expect(downsampleLTTB(data, 5)).toEqual(data)
|
||||
expect(downsampleLTTB(data, 3)).toEqual(data)
|
||||
})
|
||||
|
||||
it('preserves first and last points', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin(i / 100),
|
||||
}))
|
||||
const sampled = downsampleLTTB(data, 50)
|
||||
|
||||
expect(sampled[0]).toEqual(data[0])
|
||||
expect(sampled[sampled.length - 1]).toEqual(data[data.length - 1])
|
||||
})
|
||||
|
||||
it('reduces data to approximately threshold length', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 10000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin(i / 100),
|
||||
}))
|
||||
const threshold = 500
|
||||
const sampled = downsampleLTTB(data, threshold)
|
||||
|
||||
expect(sampled.length).toBe(threshold)
|
||||
})
|
||||
|
||||
it('maintains sorted order', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.random(),
|
||||
}))
|
||||
const sampled = downsampleLTTB(data, 100)
|
||||
|
||||
for (let i = 1; i < sampled.length; i++) {
|
||||
expect(sampled[i]!.x).toBeGreaterThan(sampled[i - 1]!.x)
|
||||
}
|
||||
})
|
||||
|
||||
it('handles minimum threshold of 3', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: i,
|
||||
}))
|
||||
const sampled = downsampleLTTB(data, 2)
|
||||
|
||||
expect(sampled.length).toBeGreaterThanOrEqual(2)
|
||||
})
|
||||
|
||||
it('preserves peaks in sine wave', () => {
|
||||
// 生成包含明确峰值的正弦波
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin((i / 1000) * Math.PI * 4), // 4个周期
|
||||
}))
|
||||
const sampled = downsampleLTTB(data, 100)
|
||||
|
||||
// 检查是否保留了接近峰值的点
|
||||
const maxY = Math.max(...sampled.map((p) => p.y))
|
||||
const minY = Math.min(...sampled.map((p) => p.y))
|
||||
|
||||
expect(maxY).toBeGreaterThan(0.9) // 接近1
|
||||
expect(minY).toBeLessThan(-0.9) // 接近-1
|
||||
})
|
||||
})
|
||||
|
||||
describe('downsampleMinMax', () => {
|
||||
it('returns empty array for empty input', () => {
|
||||
expect(downsampleMinMax([], 100)).toEqual([])
|
||||
})
|
||||
|
||||
it('returns original data when threshold >= data length', () => {
|
||||
const data: WaveformPoint[] = [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 1, y: 1 },
|
||||
{ x: 2, y: 2 },
|
||||
]
|
||||
expect(downsampleMinMax(data, 5)).toEqual(data)
|
||||
})
|
||||
|
||||
it('captures min and max values in each bucket', () => {
|
||||
const data: WaveformPoint[] = [
|
||||
{ x: 0, y: 5 },
|
||||
{ x: 1, y: 1 }, // min
|
||||
{ x: 2, y: 10 }, // max
|
||||
{ x: 3, y: 3 },
|
||||
{ x: 4, y: 7 },
|
||||
]
|
||||
const sampled = downsampleMinMax(data, 2)
|
||||
|
||||
// 应该包含最小值和最大值
|
||||
const yValues = sampled.map((p) => p.y)
|
||||
expect(yValues).toContain(1)
|
||||
expect(yValues).toContain(10)
|
||||
})
|
||||
|
||||
it('maintains sorted order', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.random(),
|
||||
}))
|
||||
const sampled = downsampleMinMax(data, 100)
|
||||
|
||||
for (let i = 1; i < sampled.length; i++) {
|
||||
expect(sampled[i]!.x).toBeGreaterThanOrEqual(sampled[i - 1]!.x)
|
||||
}
|
||||
})
|
||||
|
||||
it('preserves overall range of data', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 1000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin(i / 100) * 100,
|
||||
}))
|
||||
const sampled = downsampleMinMax(data, 50)
|
||||
|
||||
const originalMax = Math.max(...data.map((p) => p.y))
|
||||
const originalMin = Math.min(...data.map((p) => p.y))
|
||||
const sampledMax = Math.max(...sampled.map((p) => p.y))
|
||||
const sampledMin = Math.min(...sampled.map((p) => p.y))
|
||||
|
||||
expect(Math.abs(sampledMax - originalMax)).toBeLessThan(1)
|
||||
expect(Math.abs(sampledMin - originalMin)).toBeLessThan(1)
|
||||
})
|
||||
})
|
||||
|
||||
describe('adaptiveSampling', () => {
|
||||
it('returns original data when below threshold', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 100 }, (_, i) => ({
|
||||
x: i,
|
||||
y: i,
|
||||
}))
|
||||
const result = adaptiveSampling(data, 500)
|
||||
|
||||
expect(result.points).toEqual(data)
|
||||
expect(result.algorithm).toBe('none')
|
||||
expect(result.originalCount).toBe(100)
|
||||
})
|
||||
|
||||
it('uses LTTB for moderate data sets', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 10000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin(i / 100),
|
||||
}))
|
||||
const result = adaptiveSampling(data, 1000)
|
||||
|
||||
expect(result.points.length).toBeLessThanOrEqual(1000)
|
||||
expect(result.algorithm).toBe('lttb')
|
||||
expect(result.originalCount).toBe(10000)
|
||||
})
|
||||
|
||||
it('uses MinMax for very large data sets', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 100000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: Math.sin(i / 100),
|
||||
}))
|
||||
const result = adaptiveSampling(data, 1000)
|
||||
|
||||
expect(result.points.length).toBeGreaterThan(0)
|
||||
expect(result.algorithm).toBe('minmax')
|
||||
expect(result.originalCount).toBe(100000)
|
||||
})
|
||||
|
||||
it('respects custom maxPoints parameter', () => {
|
||||
const data: WaveformPoint[] = Array.from({ length: 10000 }, (_, i) => ({
|
||||
x: i,
|
||||
y: i,
|
||||
}))
|
||||
const result = adaptiveSampling(data, 200)
|
||||
|
||||
expect(result.points.length).toBeLessThanOrEqual(200)
|
||||
})
|
||||
})
|
||||
|
||||
describe('calculateSamplingThreshold', () => {
|
||||
it('returns reasonable threshold for typical viewport', () => {
|
||||
const threshold = calculateSamplingThreshold(1000, 1, 2)
|
||||
expect(threshold).toBe(2000)
|
||||
})
|
||||
|
||||
it('scales with pixel ratio', () => {
|
||||
const threshold1x = calculateSamplingThreshold(1000, 1, 2)
|
||||
const threshold2x = calculateSamplingThreshold(1000, 2, 2)
|
||||
|
||||
expect(threshold2x).toBe(threshold1x * 2)
|
||||
})
|
||||
|
||||
it('scales with points per pixel', () => {
|
||||
const threshold2pp = calculateSamplingThreshold(1000, 1, 2)
|
||||
const threshold4pp = calculateSamplingThreshold(1000, 1, 4)
|
||||
|
||||
expect(threshold4pp).toBe(threshold2pp * 2)
|
||||
})
|
||||
|
||||
it('returns minimum of 100 points', () => {
|
||||
const threshold = calculateSamplingThreshold(10, 1, 1)
|
||||
expect(threshold).toBeGreaterThanOrEqual(100)
|
||||
})
|
||||
|
||||
it('handles high DPI displays', () => {
|
||||
const threshold = calculateSamplingThreshold(1920, 2, 2)
|
||||
expect(threshold).toBe(7680)
|
||||
})
|
||||
})
|
||||
@@ -1,229 +0,0 @@
|
||||
/**
|
||||
* 数据抽样算法
|
||||
* 用于在保持视觉保真度的同时减少渲染点数
|
||||
*/
|
||||
|
||||
import type { WaveformPoint } from '../types'
|
||||
|
||||
/**
|
||||
* Largest Triangle Three Buckets (LTTB) 抽样算法
|
||||
*
|
||||
* 这是一种高效的降采样算法,能够在减少数据点的同时保持波形的视觉特征。
|
||||
* 算法通过计算三角形面积来选择最具代表性的点。
|
||||
*
|
||||
* 参考文献: Sveinn Steinarsson. 2013.
|
||||
* "Downsampling Time Series for Visual Representation"
|
||||
*
|
||||
* @param data 原始数据点数组
|
||||
* @param threshold 目标点数(必须 >= 3)
|
||||
* @returns 抽样后的数据点数组
|
||||
*
|
||||
* @example
|
||||
* const original = Array.from({ length: 10000 }, (_, i) => ({ x: i, y: Math.sin(i / 100) }))
|
||||
* const sampled = downsampleLTTB(original, 500) // 从 10000 点降至 500 点
|
||||
*/
|
||||
export function downsampleLTTB(data: WaveformPoint[], threshold: number): WaveformPoint[] {
|
||||
// 边界检查
|
||||
if (!Array.isArray(data) || data.length === 0) {
|
||||
return []
|
||||
}
|
||||
|
||||
const dataLength = data.length
|
||||
|
||||
// 如果数据点数少于或等于阈值,直接返回
|
||||
if (threshold >= dataLength || threshold <= 2) {
|
||||
return data
|
||||
}
|
||||
|
||||
// 确保阈值至少为 3
|
||||
const sampledLength = Math.max(3, Math.floor(threshold))
|
||||
const sampled: WaveformPoint[] = new Array(sampledLength)
|
||||
|
||||
// 始终保留第一个和最后一个点
|
||||
sampled[0] = data[0]!
|
||||
sampled[sampledLength - 1] = data[dataLength - 1]!
|
||||
|
||||
// 计算每个桶的大小(除了第一个和最后一个点)
|
||||
const bucketSize = (dataLength - 2) / (sampledLength - 2)
|
||||
|
||||
// 用于计算三角形面积的辅助变量
|
||||
let sampledIndex = 1
|
||||
|
||||
for (let i = 0; i < sampledLength - 2; i++) {
|
||||
// 当前桶的范围
|
||||
const avgRangeStart = Math.floor((i + 1) * bucketSize) + 1
|
||||
const avgRangeEnd = Math.floor((i + 2) * bucketSize) + 1
|
||||
const avgRangeLength = Math.min(avgRangeEnd, dataLength) - avgRangeStart
|
||||
|
||||
// 计算下一个桶的平均点(用于三角形计算)
|
||||
let avgX = 0
|
||||
let avgY = 0
|
||||
|
||||
for (let j = avgRangeStart; j < Math.min(avgRangeEnd, dataLength); j++) {
|
||||
const point = data[j]!
|
||||
avgX += point.x
|
||||
avgY += point.y
|
||||
}
|
||||
|
||||
if (avgRangeLength > 0) {
|
||||
avgX /= avgRangeLength
|
||||
avgY /= avgRangeLength
|
||||
}
|
||||
|
||||
// 当前桶的范围
|
||||
const rangeStart = Math.floor(i * bucketSize) + 1
|
||||
const rangeEnd = Math.floor((i + 1) * bucketSize) + 1
|
||||
|
||||
// 上一个选中的点
|
||||
const prevPoint = sampled[sampledIndex - 1]!
|
||||
|
||||
// 在当前桶中找到形成最大三角形面积的点
|
||||
let maxArea = -1
|
||||
let maxAreaIndex = rangeStart
|
||||
|
||||
for (let j = rangeStart; j < Math.min(rangeEnd, dataLength); j++) {
|
||||
const point = data[j]!
|
||||
|
||||
// 计算三角形面积(使用叉积公式的绝对值)
|
||||
// Area = |((x1 - x3)(y2 - y1) - (x1 - x2)(y3 - y1))| / 2
|
||||
// 为了性能,我们省略除以2,因为只需要比较相对大小
|
||||
const area = Math.abs(
|
||||
(prevPoint.x - avgX) * (point.y - prevPoint.y) -
|
||||
(prevPoint.x - point.x) * (avgY - prevPoint.y),
|
||||
)
|
||||
|
||||
if (area > maxArea) {
|
||||
maxArea = area
|
||||
maxAreaIndex = j
|
||||
}
|
||||
}
|
||||
|
||||
// 选择形成最大面积的点
|
||||
sampled[sampledIndex] = data[maxAreaIndex]!
|
||||
sampledIndex++
|
||||
}
|
||||
|
||||
return sampled
|
||||
}
|
||||
|
||||
/**
|
||||
* 最小-最大抽样算法
|
||||
*
|
||||
* 这是一种简单但有效的抽样方法,将数据分成桶,每个桶选择最小值和最大值。
|
||||
* 适合展示数据的整体范围和波动,但可能会丢失一些细节特征。
|
||||
*
|
||||
* @param data 原始数据点数组
|
||||
* @param threshold 目标点数(必须 >= 2,最终点数可能略多于阈值)
|
||||
* @returns 抽样后的数据点数组
|
||||
*
|
||||
* @example
|
||||
* const original = Array.from({ length: 10000 }, (_, i) => ({ x: i, y: Math.sin(i / 100) }))
|
||||
* const sampled = downsampleMinMax(original, 500)
|
||||
*/
|
||||
export function downsampleMinMax(data: WaveformPoint[], threshold: number): WaveformPoint[] {
|
||||
if (!Array.isArray(data) || data.length === 0) {
|
||||
return []
|
||||
}
|
||||
|
||||
const dataLength = data.length
|
||||
|
||||
// 如果数据点数少于阈值,直接返回
|
||||
if (threshold >= dataLength || threshold <= 1) {
|
||||
return data
|
||||
}
|
||||
|
||||
const sampled: WaveformPoint[] = []
|
||||
|
||||
// 计算每个桶的大小
|
||||
const bucketSize = Math.max(1, Math.floor(dataLength / Math.floor(threshold / 2)))
|
||||
|
||||
for (let i = 0; i < dataLength; i += bucketSize) {
|
||||
const bucketEnd = Math.min(i + bucketSize, dataLength)
|
||||
let minPoint = data[i]!
|
||||
let maxPoint = data[i]!
|
||||
|
||||
// 在当前桶中找到最小和最大的Y值
|
||||
for (let j = i + 1; j < bucketEnd; j++) {
|
||||
const point = data[j]!
|
||||
if (point.y < minPoint.y) {
|
||||
minPoint = point
|
||||
}
|
||||
if (point.y > maxPoint.y) {
|
||||
maxPoint = point
|
||||
}
|
||||
}
|
||||
|
||||
// 按X坐标顺序添加最小值和最大值
|
||||
if (minPoint.x < maxPoint.x) {
|
||||
sampled.push(minPoint)
|
||||
if (minPoint !== maxPoint) {
|
||||
sampled.push(maxPoint)
|
||||
}
|
||||
} else {
|
||||
sampled.push(maxPoint)
|
||||
if (minPoint !== maxPoint) {
|
||||
sampled.push(minPoint)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return sampled
|
||||
}
|
||||
|
||||
/**
|
||||
* 自适应抽样策略
|
||||
*
|
||||
* 根据数据量自动选择最合适的抽样算法和阈值
|
||||
*
|
||||
* @param data 原始数据点数组
|
||||
* @param maxPoints 最大显示点数(可选,默认为5000)
|
||||
* @returns 抽样后的数据点数组和使用的算法信息
|
||||
*/
|
||||
export function adaptiveSampling(
|
||||
data: WaveformPoint[],
|
||||
maxPoints: number = 5000,
|
||||
): { points: WaveformPoint[]; algorithm: 'none' | 'lttb' | 'minmax'; originalCount: number } {
|
||||
const dataLength = data.length
|
||||
|
||||
// 不需要抽样
|
||||
if (dataLength <= maxPoints) {
|
||||
return { points: data, algorithm: 'none', originalCount: dataLength }
|
||||
}
|
||||
|
||||
// 根据数据量选择算法
|
||||
// LTTB 适合保持波形形状,但对极大数据集可能较慢
|
||||
// MinMax 适合快速预览大数据集的范围
|
||||
if (dataLength > maxPoints * 10) {
|
||||
// 超大数据集,使用更快的 MinMax
|
||||
return {
|
||||
points: downsampleMinMax(data, maxPoints),
|
||||
algorithm: 'minmax',
|
||||
originalCount: dataLength,
|
||||
}
|
||||
} else {
|
||||
// 使用 LTTB 以获得更好的视觉质量
|
||||
return {
|
||||
points: downsampleLTTB(data, maxPoints),
|
||||
algorithm: 'lttb',
|
||||
originalCount: dataLength,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 计算推荐的抽样阈值
|
||||
*
|
||||
* 基于视口宽度和像素密度计算合理的抽样点数
|
||||
*
|
||||
* @param viewportWidth 视口宽度(像素)
|
||||
* @param pixelRatio 设备像素比(默认为 window.devicePixelRatio 或 1)
|
||||
* @param pointsPerPixel 每像素点数(默认为 2,意味着每像素最多2个数据点)
|
||||
* @returns 推荐的抽样点数
|
||||
*/
|
||||
export function calculateSamplingThreshold(
|
||||
viewportWidth: number,
|
||||
pixelRatio: number = typeof window !== 'undefined' ? window.devicePixelRatio : 1,
|
||||
pointsPerPixel: number = 2,
|
||||
): number {
|
||||
return Math.max(100, Math.floor(viewportWidth * pixelRatio * pointsPerPixel))
|
||||
}
|
||||
@@ -3,7 +3,7 @@ import { fileURLToPath, URL } from 'node:url'
|
||||
import vue from '@vitejs/plugin-vue'
|
||||
import { defineConfig } from 'vite'
|
||||
|
||||
const peerDependencies = ['vue', 'd3', 'ant-design-vue', 'vue3-colorpicker']
|
||||
const peerDependencies = ['vue', 'd3', 'vue3-colorpicker']
|
||||
|
||||
export default defineConfig({
|
||||
plugins: [vue()],
|
||||
|
||||
Reference in New Issue
Block a user