## 轮循环驱动件：每轮结算周期的唯一驱动——结算重入门闸（settling）、五段段序执行
## （段序骨架冻结于 SettlementTable.segment_order）、开轮摇号（共识点 B：技能选择前置到轮次开始，
## 摇定即本拍结算的选技）、踩雷计数账（转存时点=摇号轮末）。
## 单一变化原因：轮结算周期的推进结构（段序、重入闸、摇号时序）。
## 耦合边界：oc=宿主引用（五段段类既定同款直调形态）——经 oc 取 facts/协作件/行发射/出口分发；
## 五段构造参数与持有形态不变（grant/combat 三引用、aura/decay/verdict 单引用）；判定段零改动
## （_exit_distribution 留宿主）；随机只经 oc.rng 的 behavior_roll 封闭流（流名、开流时点、取号序逐字）；
## 零信号连接、零 await；随编排器每战新建同灭。
class_name RoundCycle
extends RefCounted

var oc: BattleOrchestrator        # 宿主引用（段类同款直调——facts/协作件/行发射/出口分发取数单点）
var mines_hits: Dictionary[Variant, Variant] = {"total": 0, "last": 0, "round": 0}   # 踩雷计数（本场累计/上轮转存/当轮累计三读数合一账）
var _grant_seg = null      # GrantSegment（①授予段——含封印判与 counter/grant 助手单点）
var _aura_seg = null       # AuraSegment（②增益/减益段）
var _combat_seg = null     # CombatSegment（③战斗段）
var _decay_seg = null      # DecaySegment（④衰减段）
var _verdict_seg = null    # VerdictSegment（⑤判定段——返回裁定，终局早退语义归宿主）
var _settling := false


func _init(host: BattleOrchestrator, fx_host_ref: BattleFxHost, reward_grant_ref: RewardGrant) -> void:
	oc = host
	# 结算五段接线（授予/战斗两段持三引用=宿主+两协作件；信号连接纪律不涉段〔段零信号连接〕——五行自宿主 _init 逐字迁入）
	_grant_seg = GrantSegment.new(oc, fx_host_ref, reward_grant_ref)
	_aura_seg = AuraSegment.new(oc)
	_combat_seg = CombatSegment.new(oc, fx_host_ref, reward_grant_ref)
	_decay_seg = DecaySegment.new(oc)
	_verdict_seg = VerdictSegment.new(oc)


# 结算重入门闸＋段序体（原宿主 _maybe_settle 三闸与 _settle 合体——闸序 settling→battle_result→phase
# 逐字；终局早退不回置 _settling，_battle_over 接管）
func settle_if_due() -> void:
	if _settling or oc.battle_result != "":
		return
	if oc.action_economy.phase != oc.action_economy.PHASE_WAITING:
		return
	_settling = true
	var ri := oc.round_index
	# 段序编排（五段——段体归 game/core/settlement/，宿主只做行发射/开单原语单点）
	_grant_seg.run(ri)   # ① 授予段（案C 闸随段装载）
	_aura_seg.run(ri)    # ② 增益/减益段（续存实例组合行）
	_combat_seg.run(ri)  # ③ 战斗段（主角先手 → 逐敌还手 → 地图伤害账殿后〔案C〕）
	_decay_seg.run(ri)   # ④ 衰减段（恰一次恒执行含末轮——先兑付后衰减）
	var verdict: String = _verdict_seg.run(ri)   # ⑤ 判定段（防御性优先级 hero 先判）
	if verdict != "continue":
		return   # 终局：_settling 不回置——_battle_over 已接管
	_settling = false


func is_settling() -> bool:
	return _settling


# ---- 开轮摇号（共识点 B：技能选择前置到轮次开始，数值计算留结算段——原宿主函数逐字迁入）----
# 每实例：保底判定（连续执行普攻 ≥ M → 必出特殊技、特殊技内按权重、不受冷却限制）→ 排除冷却中技能
# （中签率 = 权重 ÷ 可摇权重合计——份额归一）→ 按行序逐敌从统一流顺序取号摇定本拍动作。
# 随机消费只在换算层（本方法 + SkillLottery）；单位容器收确定值（零随机纪律——armor_roll 先例同构）。
# 统一流：behavior_roll 无子流派生向量（位置交错，单点定位由事件日志承载）。
# 摇定后、兑现前死亡 → 本拍技能作废。
func roll_round_actions() -> void:
	var pity_m: int = int(oc.db.combat.skill.pity_threshold)
	# facts 组包（开轮摇号前一次成型——last_round_end 空字典首轮映射 none 唯一落点；hero 事实不进 facts，
	# 容器内直读主角行）
	var facts := {
		"round_index": oc.round_index,
		"last_round_end": "none" if oc.action_economy.last_round_end().is_empty() else String(oc.action_economy.last_round_end().get("path_tag", "none")),
		"mines_hit_last": int(mines_hits["last"]),
		"mines_hit_total": int(mines_hits["total"]),
	}
	for u in oc._enemy_system.query_alive("enemy"):
		# Boss 半血解锁闩（迭代14④ T4——开轮摇号前逐敌检查；一次过门单向闩；解锁出一次归因明细行
		# 「XX 解锁了 YY」带 skill_unlock 高光键〔type=highlight 既有行型零新增〕，呈现层弹一次性
		# 技能名提示〔轻量 toast 非演出——D8 呈现面〕。门=确定性谓词，机制面零随机，摇号随机
		# 消费仍在 behavior_roll 既有流——同种子逐位复现不破坏）
		for sid in oc._enemy_system.check_trigger_unlocks(u, facts):
			var srow_u: Dictionary[Variant, Variant] = oc.db.combat.skill.row_by_id(sid)
			oc._emit_row({"type": "highlight", "source_class": "enemy_action", "origin_cell": Vector2i(-1, -1), "highlight": "skill_unlock"},
				oc.round_index, "%s 解锁了 %s" % [String(u.display_name), String(srow_u.get("display_name", sid))],
				0, {"skill_id": sid})
			# enemy_hp_threshold 发射点（内容数据驱动扩展批 T1——血量阈值沿；对所有带该字段敌人逐个发射，
			# 非 Boss 专属——Boss 语义留给订阅者 when 判定。pct=本次解锁条目的 trigger 行值）
			var pct_v := 0
			for pe in (u.get("pool", []) as Array):
				var pe_d: Dictionary[Variant, Variant] = pe
				if String(pe_d.get("skill_id", "")) == sid and (pe_d.get("trigger", {}) as Dictionary).has("value"):
					pct_v = int((pe_d.get("trigger", {}) as Dictionary).get("value", 0))
					break
			# target_attack_bonus 施加面（处刑台：敌血量阈值沿挂单位字典标记，
			# 主角攻击面 _resolve_hero_attack 通用消费——fx_atk_bonus 键加算进 base_value）
			var eht_hits := oc._fx_host.fx_emit("enemy_hp_threshold", {"unit": String(u.enemy_id), "pct": pct_v,
				"is_boss": String(oc._facts.encounter.get("node_type", "")) == "boss"})
			for h in eht_hits:
				if String(h.get("kind", "")) == "target_attack_bonus":
					u["fx_atk_bonus"] = int(u.get("fx_atk_bonus", 0)) + int(h.get("value", 0))
		var entries: Array[Variant] = oc._enemy_system.rollable_skills(u, facts)
		if oc._enemy_system.basic_streak(u) >= pity_m:
			var specials: Array[Variant] = oc._enemy_system.special_skills(u, facts)
			if not specials.is_empty():
				entries = specials   # 保底命中——普攻恒可摇 → 非保底路径池恒非空，此为唯一替代集合
		var stream: RandomNumberGenerator = oc.rng.open_stream("behavior_roll")
		oc._enemy_system.set_pending_action(u, SkillLottery.draw(entries, stream))
	oc._enemy_system.tick_cooldowns()   # 递减在摇号读值之后——"施放后连续 N 拍不可摇中"的等价实现（单位容器 注记）
	mines_hits["last"] = mines_hits["round"]   # 轮次真正结束转存（轮内部分结算不更新）
	mines_hits["round"] = 0