debug-and-verify-charts

用途：诊断并验证 TanStack Charts 图表中的类型、数据、比例尺、几何、焦点与交互、生命周期、打包体积和性能问题，以场景级证据定位失败层。核心原则是按归因顺序排查：先确认已准备行、顺序、区间、缺失值与单位，再看 mark 通道与分组、比例尺 domain/range/bandwidth/ticks/对数有效性、scene.chart 边界与边距、场景节点键与裁剪、渲染器输入与静态输出，最后才是挂载表面、框架生命周期、字体和应用 CSS。若场景本身错误，改渲染器无法修复；若场景正确，不应再改 transform 与 scale。场景检查可断言确定性不变量，如点数与行数一致、绘图宽度大于零、SVG 无 NaN/Infinity。交互与生命周期需验证指针聚焦数据、语义点与 tooltip、固定选择、重排过滤更新缩放中断、状态跟随存活键、键盘遍历与销毁后无残留监听。截图应与语义断言配对使用，固定数据、字体、视口、设备缩放、动画、locale、时区和版本。打包需在最小消费者中安装产物，验证根与子路径导入、SSR、ESM tree shaking、可选 peer 边界、声明输出与运行时。性能样本须带正确性闸门，并报告环境、数据规模、预热、样本数、分位数与能力集。常见错误包括用 as any 掩盖类型不匹配、只断言元素存在、只测工作区源码而非打包导出、只看单一聚合性能数、只查末帧而忽略中断期间的状态正确性。