Skip to content

feat(vseed): 支持柱图圆角配置并完善 light-dashboard skill - #556

Merged
youngwinds merged 11 commits into
mainfrom
codex/vseed-corner-radius-skill-api
Oct 12, 2026
Merged

youngwinds merged 11 commits into
mainfrom
codex/vseed-corner-radius-skill-api

Conversation

@youngwinds

@youngwinds youngwinds commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

🤔 This is a ...

  • New feature
  • TypeScript definition update
  • Refactoring
  • Test Case
  • Site / documentation update
  • Demo update

💡 Background and solution

柱图默认使用整组 clip 绘制圆角时,clip 与图元更新动画不同步,容易出现动画重叠。本次新增 cornerRadius,浅色、深色主题中柱状图相关的默认值统一为 0,默认不启用圆角,避免堆叠图元之间出现圆角缺口。显式设置非零 cornerRadius 时,对每个图元绘制圆角;同时设置 stackCornerRadius: true 时,使用 cornerRadius 裁剪整组堆叠柱体,并优先于 barStyle.barRadius。该显式模式仍保留已记录的 VChart 更新动画限制。

  • 为柱图、条形图、直方图、双轴图及竞赛图更新类型、Schema、主题、构建管线和回归测试,并生成配置文档与圆角示例。普通、并列、百分比和竞赛柱图均默认使用直角;显式圆角与自定义主题覆盖继续生效。
  • 将唯一 skill 重命名为 light-dashboard,目录同步迁移到 skills/light-dashboard;更新名称、描述与中文标题,明确小而美、低信息密度的交互式仪表盘定位。
  • 完善指标、布局、配色、筛选联动与截图验收指南,提供 24 份 Dashboard 模板及桌面、手机截图,模板 HTML 作为直接维护的参考产物。
  • VBI 与 VSeed API 参考保留在 references/api/vbi、references/api/vseed,补充源码定位链接;移除不再使用的 skill 生成脚本和中间产物。
  • HTML 示例按 charts、dashboard、screen 归类,修正移动后的引用;轻量看板兼容其固定的 0.6.4 SDK 圆角行为。
  • 添加 @visactor/vseed minor changeset;固定版本组的 VSeed、VBI、VQuery 发布计划均为 0.7.0。

🔄 API migration

stackCornerRadius 从数值或数组改为布尔开关。将旧值移到 cornerRadius;需要整组堆叠圆角时,再设置 stackCornerRadius: true。changeset 已记录迁移说明。

// 默认不启用圆角
{ chartType: 'column' }

// 显式设置:每个图元单独圆角
{ chartType: 'column', cornerRadius: [4, 4, 0, 0] }

// 显式启用整组堆叠圆角
{ chartType: 'column', cornerRadius: [4, 4, 0, 0], stackCornerRadius: true }

✅ Validation

已 rebase 到最新 main(0bd4ee667e,包含区域注释与 0.6.5 发布)。解决 README 覆盖率徽标、示例测试索引及覆盖率配置三处冲突;测试索引由生成器重建,同时保留区域注释和圆角示例。

  • VSeed g、VBI g 通过;生成差异已核对,未保留示例格式化噪声。VBI 生成阶段没有快照更新。
  • VSeed 全量 1,546 项测试、单元 724 项测试通过;VBI 全量 167 项测试通过。
  • VSeed 单元覆盖率(statements / branches / functions / lines):rebase 前 83.96 / 77.24 / 82.26 / 83.96%,之后 85.48 / 77.89 / 83.29 / 85.48%。完整套件为 91.49 / 82.55 / 84.97 / 91.49%;已提高提交中的覆盖率门槛,并重新验证单元门槛。
  • VBI 完整套件四项覆盖率均为 100%。单独过滤 tests/unit 的 81 项测试前后均通过,覆盖率同为 82.98 / 77.58 / 76.57 / 82.24%,没有下降;该过滤运行低于现有全局 100% 门槛并返回非零,默认完整套件覆盖率检查通过。
  • 覆盖率报告位于 packages/vseed/coverage/unit/index.html、packages/vseed/coverage/full/index.html 与 packages/vbi/coverage/index.html。
  • 根目录 lint:check、typecheck 通过(24 个 Turbo 任务全部重新执行);改动文件格式检查、git diff --check 与提交钩子通过。
  • 浏览器验收:/VBI/vseed/examples/chartType/column.html 默认堆叠柱图为直角,图例筛选正常;http://localhost:3000/VBI/ 首页、/VBI/vseed/examples/features/cornerRadius.html、/VBI/vseed/examples/features/annotationArea.html 正常渲染;圆角图例筛选及恢复、柱图数值区间注释通过,未发现控制台错误。验收后关闭本次启动的开发服务。
  • Changeset 发布计划验证通过:VSeed、VBI、VQuery 仍计划发布 0.7.0。
  • skill 目录搬迁完整性已验证:102 个文件保留,模板、截图和参考资料没有丢失。专用 skill 校验器缺少 PyYAML,本次未运行成功。

☑️ Self-Check before Merge

  • Doc is updated/provided or not needed
  • Demo is updated/provided or not needed
  • TypeScript definition is updated/provided or not needed
  • Changelog is provided or not needed — minor changeset included

@youngwinds youngwinds changed the title feat(vseed): 支持柱图圆角配置并完善 VBI skill API feat(vseed): 支持柱图圆角配置并完善 light-dashboard skill Oct 12, 2026
@youngwinds
youngwinds force-pushed the codex/vseed-corner-radius-skill-api branch from 3a948ae to 06e205f Compare October 12, 2026 03:39
@youngwinds
youngwinds merged commit 3a2f437 into main Oct 12, 2026
4 of 5 checks passed
@youngwinds
youngwinds deleted the codex/vseed-corner-radius-skill-api branch October 12, 2026 08:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant