@damoqiongqiu/ice-chart 0.28.0 → 0.29.0

package/README.md

@@ -131,7 +131,7 @@ gray-100~900、`--bs-border-radius`、`--bs-body-font-family`），图表放进
 | 跨图联动 | hover / zoom / brush | `linkCharts([a, b])`，按 x 数据值对齐 |
 | 动画 | 进入与数据更新 | 走引擎的 `AnimationManager`（`state.progress` 驱动） |
 | 主题 | light / dark / 自定义片段 | 默认色板取自 ice-render 的设计 token |
-| 大数据 | LTTB 降采样 + 二分命中 | 5 万点 × 3 系列构建 35ms，每条曲线只绘制约 2 点/像素 |
+| 大数据 | LTTB 降采样 + 二分命中 + 列存（虚拟）系列 | 5 万点 × 3 系列构建 35ms，每条曲线只绘制约 2 点/像素；**100 万点散点**开 `virtual: true` 后堆 2.2MB、命中 0.00ms —— [机制与复用边界](./docs/column-store-virtual-series.md) |
 | 无障碍 | 数据表镜像 + aria-live 播报 | `attachA11yMirror()` / `getDataTable()` / `getA11yTree()` |
 
 > **内置文案可配**：无障碍数据表的表头与默认 tooltip 标签可以用 `option.labels` 覆盖
@@ -181,6 +181,11 @@ gray-100~900、`--bs-border-radius`、`--bs-body-font-family`），图表放进
 | `bar` | 类目在 x（默认） | 分组（多系列）与堆叠（同 `stack` 名）；数据项写 `{ value, color }` 可**逐项配色** |
 | `bar`（横向） | `yAxis: { type: 'category', data: [...] }` + `xAxis: { type: 'value' }` | 排行榜；类目也可写在数据项的 `name` 上 |
 | `scatter` | `data: [[x, y, size]]` + `symbolSizeRange` | 第三维映射成直径即气泡图；`symbolSize` 也可传函数 |
+| `scatter` / `line` / `area`（大数据） | `virtual: true` + `data: { x, y }`（列式，推荐 `Float64Array`） | 列存（虚拟）系列：百万级点不建数据点对象与按点缓存，堆 2.2MB / 命中 0.00ms（折线按像素列保留极值）。代价（不进快照、`params.data` 为空）见 [机制与复用边界](./docs/column-store-virtual-series.md) |
+| `heatmap`（大数据） | `virtual: true` + `data: { xCategories, yCategories, values }`（稠密矩阵） | 列存矩阵：1000×1000 = 100 万格堆 3.3MB、命中 O(1)（普通路 4 万格单次命中已 6.8ms）；亚像素按屏幕像素块聚合，热点取最大值 |
+| 实时流（大数据） | `virtual: true` + `appendData(id, items, { maxPoints })` | 列存环形缓冲：窗口满了覆盖最老的，不 concat、不重建。10 万点窗口 **0.40ms/次**（普通路径 5.80ms、p95 15.10ms） |
+| 亿级数据 | `virtual: true` + `data: { sizes, rangeOf, yDomain, loadChunk }` | 分块按需加载：只驻留可见窗口的块。**10 亿逻辑点**（1 万块、常驻 3 块）初始化 3ms、堆 2.7MB |
+| 交给引擎 | `chart.createVirtualSource(id)` → `ICEVirtualLayer` | 列**不复制**直接喂给引擎虚拟子源：窗口裁剪/批量落墨/命中归引擎，白拿「命中即物化」、SVG 导出、对齐参考线；100 万点落墨 2.1ms/帧、命中 0.00ms |
 | `pie` | `data: [{ name, value }]` | `innerRadius` 出环形，`roseType` 出玫瑰图；扇区可点图例隐藏 |
 | `radar` | `radar.indicators` + `data: [数值...]` | 一个系列一个多边形，顶点命中 |
 | `boxplot` | `data: [[min, Q1, median, Q3, max]]` 或一组原始观测值 | 恰好 5 个数按五数概括解释，其它长度自动算分位数；命中覆盖整条须 |
@@ -555,7 +560,7 @@ npm run examples:serve      # http://localhost:5177
 
 示例页面覆盖：基础折线 / 面积、分组与堆叠柱形、多 y 轴叠加、饼图 / 环形图 / 玫瑰图、雷达图、
 热力图、桑基图、交互总览（框选 + 多选 + 键盘 + 事件日志）、时间轴 + dataZoom 滑块、
-大数据量（5 万点降采样）、无障碍、跨图联动、迷你 MATLAB，以及 **5 个深色大屏**
+大数据量（5 万点降采样 / **100 万点列存虚拟化：散点 + 折线**）、无障碍、跨图联动、迷你 MATLAB，以及 **5 个深色大屏**
 （运营 / 设备 / 能源 / 物流 / 函数实验）。
 
 五个大屏共用同一套脚手架（`examples/assets/dash-kit.js`：12 列栅格 + 面板组件 + 数据流主循环），
@@ -653,12 +658,14 @@ node scripts/audit-space.mjs         # 104 张示例图：直角坐标占宽 ≥
 ## 路线图
 
 已落地：极坐标（饼图 / 玫瑰图）、雷达图、多 y 轴、dataZoom 滑块、LTTB 降采样与二分命中、
-无障碍（数据表镜像 + 播报）、热力图、桑基图、标注（目标线 / 异常点 / 目标区间）。
+**列存（虚拟）系列**（百万级散点，`virtual: true`）、无障碍（数据表镜像 + 播报）、
+热力图、桑基图、标注（目标线 / 异常点 / 目标区间）。
 
 后续候选：
 
 - 桑基节点拖拽重排与折叠（布局已与渲染解耦，扩展成本低）
-- 数据 append 的增量绘制（当前是全量重建像素缓存）
+- 数据 append 的增量绘制（当前是全量重建像素缓存；列存 + 环形缓冲是它的落地路径）
+- 把列存推广到折线 / 面积与热力图（模板与边界见 `docs/column-store-virtual-series.md`）
 - y 轴方向的 dataZoom 滑块（`setAxisDomain` 已可用，缺 UI）
 - 标注的第二梯队：树图 / 日历热力（层级与时间热力的标配）、趋势线与误差棒（按需；
   冷门形态走自定义系列注册口）