Files
star-seed/docs/bit-components.md
T

1.4 KiB

Bit-ready Vue 动画组件

本项目按照 Bit 文档所强调的“独立、可组合组件”方式组织视觉层,同时保留标准 Vite 构建,以确保下载后可以直接运行。

组件边界

EvolutionScene

  • 输入:当前纪元、资源数、点击强度、自动产率、发射状态;
  • 输出:pulse 事件;
  • 动画:Motion 弹簧入场和按压反馈;CSS 行星呼吸、城市灯光、星种发射轨迹;
  • 不读取存档,不直接修改游戏状态。

MilestoneRail

  • 输入:纪元配置、资源数、已完成里程碑;
  • 输出:purchase(id) 事件;
  • 动画:Motion 交错入场和悬停位移;
  • 所有购买合法性仍由 gameState.js 判定。

SignalLog

  • 输入:叙事信号数组;
  • 动画:新信号淡入;
  • 无全局状态依赖。

EndingOverlay

  • 输入:结局等级;
  • 输出:restart 事件;
  • 动画:全屏结局转场;
  • 不负责创建下一轮状态。

为什么保持 Vite 主构建

Bit 可用于后续独立跟踪、预览和发布这些组件;游戏发行仍使用 Vite SingleFile,把全部组件、动画和样式内联到 dist/index.html。因此玩家不需要 Bit CLI、Node.js 或网络连接。

若团队后续采用 Bit,可在现有项目执行官方文档中的 bit init,再将 src/components 下的组件按各自目录边界跟踪。游戏规则层与发行构建无需改变。