ability

type CastError int

type CastState int

type Cost[R any] struct {
	Resource R       // 资源类型标识(如 MP/Rage/Ammo)
	Amount   float64 // 消耗量
}

type Cue struct {
	Tag   string  // 提示类型(如 "vfx"、"sfx"、"camera_shake")
	Asset string  // 资源标识(特效/音效文件名)
	Value float64 // 参数(强度、持续时间等)
}

type Effect[E any] struct {
	Tag    string  // 效果类型标签
	Value  float64 // 效果数值(伤害值、治疗量、持续时间等)
	Source E       // 施法者
	Target E       // 受击者
}

type Phase[E any] interface {
	// Tick 推进阶段。返回 PhaseComplete 时管线自动进入下一阶段;
	// 返回 PhaseCancelled 时整个技能中止。
	Tick(frame uint64) PhaseResult[E]
	// Reset 重置阶段内部状态(技能再次使用时调用)。
	Reset()
}

type PhaseFunc[E any] func(frame uint64) PhaseResult[E]

type PhaseResult[E any] struct {
	Status  PhaseStatus
	Effects []Effect[E]
	Cues    []Cue
}

type PhaseStatus int

type ResourceChecker[E, R any] interface {
	// CanAfford 检查 caster 是否有足够资源支付 costs。
	CanAfford(caster E, costs []Cost[R]) bool
	// Spend 扣除资源。调用方保证已通过 CanAfford 检查。
	Spend(caster E, costs []Cost[R])
}

type ResourceFunc[E, R any] struct {
	CheckFn func(caster E, costs []Cost[R]) bool
	SpendFn func(caster E, costs []Cost[R])
}

type Runner[E, R any] struct {
	// contains filtered or unexported fields
}

type Spec[E, R any] struct {
	ID           string     // 技能唯一标识
	Costs        []Cost[R]  // 资源消耗
	CooldownTick int        // 冷却帧数(0 = 无冷却)
	Phases       []Phase[E] // 执行阶段序列
}

type TickResult[E any] struct {
	Active  bool // 是否有技能在执行
	Effects []Effect[E]
	Cues    []Cue
	Done    bool // 本帧技能完成(所有阶段结束)
	Cancel  bool // 本帧技能被取消
}