feat(vseed): 支持按坐标范围绘制区域标注

[666haiwen]

🤔 这个分支是...

• 新功能
• Ts 类型更新
• 测试 case 更新
• 网站/文档更新
• demo 更新

🔗 相关 issue 链接

暂无。

🔗 相关的 PR 链接

无。

🐞 Bugserver 用例 id

不适用。

💡 问题的背景&解决方案

现有 annotationArea.selector 依赖已选中的数据点，无法准确表达“y > 10 是高危险区域”或散点图中没有数据点的矩形区域。本 PR 新增与 selector 互斥的 range 模式，使用线性数值轴的坐标上下界绘制区域：

annotationArea: {
  range: { y: { min: 10, max: AxisBoundaryEnum.Max } },
  text: '高危险区域',
  areaColor: '#ef4444',
  areaColorOpacity: 0.12,
}

• range.x、range.y 至少填写一项；每项必须同时提供 min / max，可用导出的 AxisBoundaryEnum.Min/Max 指向当前轴边界。未填写的轴铺满绘图区。
• 支持散点、折线/面积、柱/条、箱线和直方图及适用变体；仅允许普通数值线性轴。完全越界时不绘制，部分越界时裁剪。
• 保留原有 selector 色带行为，并在类型、Schema 和 Builder 路径校验两种模式的互斥及必填约束。
• 增加 Builder、坐标计算、实际 VChart 渲染和文档生成的回归测试，补充可运行示例并重新生成配置文档。顺带修复示例生成器的代码围栏尾随空格。

验证

• 本轮 review 修改并合并 main 后，@visactor/vseed 完整测试与覆盖率、单测覆盖率、类型检查及构建通过；完整覆盖率：语句/行 91.43%，分支 82.46%，函数 84.83%；单测覆盖率：语句/行 84.53%，分支 77.53%，函数 82.85%。
• 原功能开发阶段网站测试与覆盖率、类型检查、生产构建通过；本轮合并后的仓库根级 lint 与 typecheck 通过。
• 原功能开发阶段已在本地文档站浏览器确认直方图区域着色及选项文档的互斥/可选字段显示；页面：/VBI/vseed/examples/features/annotationArea.html。本轮合并后浏览器工具因本地 URL 安全策略拒绝访问，未重新完成可视验收。

发布计划

• 已添加 @visactor/vseed 的 patch Changeset。pnpm changeset status 确认固定版本组中的 VSeed、VBI、VQuery 都规划为 patch；合并 main 后当前版本为 0.6.4，预计下一个 patch 版本为 0.6.5（以版本 PR 为准）。此 PR 不直接修改包版本，也不执行发布。

☑️ 自测

• 文档提供了，或者更新，或者不需要
• Demo 提供了，或者更新，或者不需要
• Ts 类型定义提供了，或者更新，或者不需要
• Changelog 提供了，或者不需要（已添加 Changeset，版本 PR 将生成更新记录）

[youngwinds]

建议pipe解除图表类型依赖, 最小功能pipe, 在各个图表类型中组装;

每个pipeline已经确定图表类型了, 应该避免在pipe内根据图表类型做不同的逻辑;

[666haiwen]

已按建议调整：通用 annotation pipe 现在只提取并校验配置，不再维护图表类型白名单或按图表类型分支。各图表的 advanced pipeline 显式组合 range 限制；支持 range 的图表仅在透视分支拒绝，不支持的图表明确拒绝。原有校验与相关测试保持通过。改动见 1aebb23ed8；随后合并了最新 main，PR 冲突已清除。