发布与兼容性
Yotsuba Gantt 当前处于 Alpha。预发布版本用于尽早验证真实业务数据与三端 API，小版本仍可能包含不兼容调整。本文明确区分 Registry 已发布版本与仓库中的源码候选版本。
包与仓库
| 平台 | 包 | Registry Alpha | 源码候选 | 仓库 |
|---|---|---|---|---|
| Core | @iyotsuba/gantt-core | 0.1.0-alpha.1 | 0.1.0-alpha.2 | isla4ever/yotsuba-gantt |
| Vue 3 | @iyotsuba/gantt-vue | 0.1.0-alpha.3 | 0.1.0-alpha.5 | isla4ever/yotsuba-gantt |
| React 18/19 | @iyotsuba/gantt-react | 0.1.0-alpha.0 | 0.1.0-alpha.1 | isla4ever/yotsuba-gantt |
| Flutter | yotsuba_gantt | 0.1.0-alpha.2 | 0.1.0-alpha.2 | isla4ever/yotsuba-gantt-flutter |
Web 端请在 Alpha 阶段显式安装 @alpha 标签；标为“源码候选”的 API 会在 Registry 消费回归通过后进入该通道：
bash
pnpm add @iyotsuba/gantt-vue@alpha @iyotsuba/gantt-core@alphatimelineResolver 与 timelineLabelResolver 已进入上表 Web 源码候选版；npm 安全验证和 Registry 消费回归完成前，不把候选版本写成已发布版本。
Flutter 独立仓库的 v0.1.0-alpha.2 Prerelease 同时提供 Android APK 与 SHA-256 校验文件。仓库根目录是组件包源码，example/ 是通过 pub.dev hosted dependency 接入发布包的开源演示应用；Release 工作流已核对 APK 实际使用的包版本。
兼容范围
| 环境 | 最低版本 |
|---|---|
| Node.js | 20.9 |
| Vue | 3.4 |
| React / React DOM | 18 |
| Dart | 3.4 |
| Flutter | 3.22 |
Web 包提供 ESM、TypeScript 声明和独立 CSS 子路径。Flutter 是原生 Widget，不使用 WebView。
升级原则
- 锁定 Alpha 精确版本，先在测试环境验证再升级。
- Vue 与 React 同时依赖 Core，发布顺序始终是 Core 后框架包。
- 自定义任务条只使用公开 Slot、Render Prop、Builder 和 Resolver，不依赖内部类名或私有 Widget。
- 将任务变更事件视为“建议值”，由宿主负责持久化和冲突处理。
每个 GitHub Release 附带变更说明；Flutter Release 还提供 Android 演示 APK 和 SHA-256 文件。参阅 Flutter 快速开始 了解源码结构、安装和校验方式。