HealBattleMutationInterceptor.kt

package io.github.lishangbu.avalon.game.battle.engine.core.runtime.flow

import io.github.lishangbu.avalon.game.battle.engine.core.constant.BattleAttributeKeys
import io.github.lishangbu.avalon.game.battle.engine.core.event.StandardHookNames
import io.github.lishangbu.avalon.game.battle.engine.core.mutation.BattleMutation
import io.github.lishangbu.avalon.game.battle.engine.core.mutation.HealMutation
import io.github.lishangbu.avalon.game.battle.engine.core.runtime.support.MutationTargetSelectorResolver

/**
 * 回复 mutation 的生命周期拦截器。
 *
 * 设计意图：
 * - 把 `HealMutation` 真正接到 `on_heal` 生命周期函数上；
 * - 让回复前拦截类 effect 可以在状态写回前介入；
 * - 与 `DamageBattleMutationInterceptor` 保持同一套“可 veto、可改写数值”的编排习惯。
 *
 * 当前约束也与伤害一致：
 * - 多目标 `HealMutation` 仍然共用一个 mutation 负载；
 * - 只有所有目标都返回一致 relay 时，才会把回复值 rewrite 回写成固定值。
 */
class HealBattleMutationInterceptor : BattleMutationInterceptor {
    override val order: Int = 300

    override fun supports(mutation: BattleMutation): Boolean = mutation is HealMutation

    override fun intercept(
        context: BattleMutationInterceptionContext,
        attachedEffectProcessor: BattleAttachedEffectProcessor,
    ): BattleMutationInterceptionResult {
        val mutation =
            context.mutation as? HealMutation
                ?: return BattleMutationInterceptionResult(context.snapshot, true, context.mutation)
        val targetUnitIds =
            MutationTargetSelectorResolver.resolve(
                mutation.target,
                BattleMutationInterceptorSupport.mutationApplicationContext(context),
            )
        var currentSnapshot = context.snapshot
        var blocked = false
        var rewrittenHeal: Int? = null
        var rewriteConflicted = false

        targetUnitIds.forEach { affectedTargetId ->
            val affectedUnit = currentSnapshot.units[affectedTargetId] ?: return@forEach
            val amount = BattleMutationInterceptorSupport.calculateAmount(affectedUnit, mutation.mode, mutation.value)
            val result =
                attachedEffectProcessor.process(
                    snapshot = currentSnapshot,
                    unitId = affectedTargetId,
                    hookName = StandardHookNames.ON_HEAL.value,
                    targetId = affectedTargetId,
                    sourceId = context.sourceId,
                    relay = amount,
                    attributes =
                        buildMap {
                            put("mode", mutation.mode)
                            put("value", mutation.value)
                            put("amount", amount)
                            BattleMutationInterceptorSupport
                                .resolveTargetRelation(currentSnapshot, context.sourceId, affectedTargetId)
                                ?.let { relation -> put(BattleAttributeKeys.TARGET_RELATION, relation) }
                        },
                )
            currentSnapshot = result.snapshot
            if (result.cancelled || result.relay == false) {
                blocked = true
                return@forEach
            }

            val relayHeal = BattleMutationInterceptorSupport.normalizeIntegerRelay(result.relay) ?: return@forEach
            if (targetUnitIds.size == 1) {
                rewrittenHeal = relayHeal.coerceAtLeast(0)
                return@forEach
            }
            if (rewrittenHeal == null) {
                rewrittenHeal = relayHeal.coerceAtLeast(0)
            } else if (rewrittenHeal != relayHeal.coerceAtLeast(0)) {
                rewriteConflicted = true
            }
        }

        val nextMutation =
            if (!blocked && !rewriteConflicted && rewrittenHeal != null) {
                mutation.copy(
                    mode = null,
                    value = requireNotNull(rewrittenHeal).toDouble(),
                )
            } else {
                mutation
            }

        return BattleMutationInterceptionResult(
            snapshot = currentSnapshot,
            allowed = !blocked,
            mutation = nextMutation,
        )
    }
}