chatwoot-viz

用途：@chatwoot/viz 是面向 Vue 3.5+ 应用的图表组件库，用于添加小型、响应式的数据可视化，不适合 React、Svelte、Vue 2 或无 Vue 的服务端模板。主要能力：导出 BarChart、DonutChart、LineChart、PercentageChart、HeatmapChart 和 SankeyChart。柱状图与折线图共用 categories + series 数据结构，支持 formatValue、tooltip、数值显示、yDomain/yTicks/yStepSize 等刻度控制及 stacked 堆叠。百分比图与环形图接收非负分段原始值，可带 total，自动计算占比并生成 Unused 余段。热力图用于行列交叉值，行列标签需由使用方提供。桑基图用于有向无环流的阶段与结果展示。使用方式：用项目现有包管理器安装 pnpm add @chatwoot/viz（或 npm/yarn/bun 对应命令），在全局入口导入一次 import '@chatwoot/viz/style.css'（文件名以资料为准），按需引入组件。数据放入 computed 派生，不直接改写源记录。交互通过 @item-click 处理，组件已支持鼠标与键盘操作。限制：热力图不解析日期、不计算星期、不处理时区、不本地化标签；桑基图不允许环，链路值须为正；聚合图显式 total 下超出会产生错误而非重新缩放；格式值在桑基图中只能是函数。建议为每个图表提供 aria-label，图表宽度由容器决定，避免硬编码宽度。