# VERTICAL SLICE - NOT FOR PRODUCTION
# 实现 GDD：design/ux/battle.md（§Transitions 结算逐行兑现——B 区因果演出链骨架：
# 结算轮光带自棋盘区横扫 → 伤害/治疗弹道自棋盘飞向敌我站桩 → 受击闪白与血条递减由站桩侧承接）。
# 位置语义：全屏覆盖层（A–D 区之上、模态之下），只做跨区飞行的演出载体——棋盘区内演出
# （清图金粒/完美排雷横幅/标中旗弹道/Boss 影子）仍归 board_fx_view。
# 高内聚边界：纯演出——组合根按结算信号调用 play_*，传全局坐标（组合根持有棋盘与站桩两域句柄）；
# 本类零核心依赖、不自持游戏状态、mouse_filter 全忽略（不劫持输入）。
# 动画密度/缓动曲线归战斗表现样张批终稿——本批落"因果全程可见"骨架（规划兑现 P2 义务）。
# Date: 2026-09-20（结算演出链批）
class_name SettlementFxView
extends Control


func _init() -> void:
	mouse_filter = Control.MOUSE_FILTER_IGNORE
	set_anchors_preset(Control.PRESET_FULL_RECT)


# 结算轮光带：金橙半透明横带自棋盘上缘扫至下缘（一次 0.5s，自动回收）——
# "棋盘能量向战斗画面汇聚"的开轮语义（§2.2 色彩转金橙主导；区分于 board_fx 的完美排雷金光带）。
# 终稿（样张 v2 冻结批 T3）：加 2px 亮金前导缘线——扫带运动方向可读（兑现光带逐行横扫 §2.2）
func play_round_sweep(board_rect: Rect2) -> void:
	if board_rect.size == Vector2.ZERO:
		return
	var band := ColorRect.new()
	band.color = Color(UiKit.GOLD, 0.22)
	band.mouse_filter = Control.MOUSE_FILTER_IGNORE
	band.position = Vector2(board_rect.position.x, board_rect.position.y)
	band.size = Vector2(board_rect.size.x, 34.0)
	add_child(band)
	var edge := ColorRect.new()
	edge.color = Color(UiKit.GOLD_LIT, 0.7)
	edge.mouse_filter = Control.MOUSE_FILTER_IGNORE
	edge.size = Vector2(board_rect.size.x, 2.0)
	edge.position = band.position
	add_child(edge)
	var tw := band.create_tween()
	tw.tween_property(band, "position:y", board_rect.end.y - 34.0, UiKit.motion(0.5)).set_trans(Tween.TRANS_SINE)
	tw.parallel().tween_property(band, "modulate:a", 0.0, UiKit.motion(0.5)).set_delay(UiKit.motion(0.15))
	tw.tween_callback(band.queue_free)
	var etw := edge.create_tween()
	etw.tween_property(edge, "position:y", board_rect.end.y - 2.0, UiKit.motion(0.5)).set_trans(Tween.TRANS_SINE)
	etw.parallel().tween_property(edge, "modulate:a", 0.0, UiKit.motion(0.2)).set_delay(UiKit.motion(0.3))
	etw.tween_callback(edge.queue_free)


# 跨区弹道：glyph 字形自 from 飞向 to（0.35s + 轻微上抛弧线 + 终点淡出，自动回收）——
# 开格之因 → 站桩之果的因果可视承载（P2）；crit 弹道由调用方传加重标记
func play_projectile(from: Vector2, to: Vector2, glyph: String, col: Color, crit: bool = false) -> void:
	var shot := UiKit.label(glyph, 22 if crit else 16, true)
	shot.add_theme_color_override("font_color", col)
	shot.mouse_filter = Control.MOUSE_FILTER_IGNORE
	shot.size = Vector2(24, 24)
	shot.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
	shot.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
	shot.position = from - shot.size * 0.5
	shot.pivot_offset = shot.size * 0.5
	shot.z_index = 5
	add_child(shot)
	var mid := (from + to) * 0.5 + Vector2(0, -36.0)   # 轻微上抛弧线
	var tw := shot.create_tween()
	if crit:
		tw.tween_property(shot, "scale", Vector2(1.5, 1.5), UiKit.motion(0.08))
	tw.tween_property(shot, "position", mid, UiKit.motion(0.16)).set_trans(Tween.TRANS_SINE).set_ease(Tween.EASE_OUT)
	tw.tween_property(shot, "position", to - shot.size * 0.5, UiKit.motion(0.19)).set_trans(Tween.TRANS_SINE).set_ease(Tween.EASE_IN)
	tw.parallel().tween_property(shot, "modulate:a", 0.0, UiKit.motion(0.12)).set_delay(UiKit.motion(0.23))
	tw.tween_callback(shot.queue_free)


# ---- 轮切换横幅（迭代 8 卡⑦——「第 N 轮」驻留 0.6s 后消隐进下一轮；白名单 0.5–0.8s 内取值）----
# 减动效=静态呈现（驻留后即隐，零位移/零透明度动画——行呈现不跳过同语义，卡⑦ AC③）。
const BANNER_DWELL := 0.6

var _fx_banners := 0   # 演出探针计数（fx_probe 断言面）


# 演出探针出口（卡⑦——轮横幅发射计数）
func probe_banners() -> int:
	return _fx_banners


func play_round_banner(ri: int) -> void:
	_fx_banners += 1
	var banner := Panel.new()
	banner.mouse_filter = Control.MOUSE_FILTER_IGNORE
	banner.add_theme_stylebox_override("panel", UiKit.panel_flat(Color(UiKit.BG_OVERLAY, 0.88), UiKit.GOLD_DEEP, 8, 2))
	var lab := UiKit.label("第 %d 轮" % ri, 22, true)
	lab.add_theme_color_override("font_color", UiKit.GOLD)
	lab.set_anchors_and_offsets_preset(Control.PRESET_FULL_RECT)
	lab.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
	lab.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
	banner.add_child(lab)
	banner.size = Vector2(190, 46)
	banner.position = Vector2((size.x - banner.size.x) * 0.5, size.y * 0.30)   # 棋盘中带上缘——不压明细带
	banner.z_index = 4
	add_child(banner)
	if UiKit.motion_scale < 1.0:
		var st := get_tree().create_timer(BANNER_DWELL)
		st.timeout.connect(banner.queue_free)
		return
	banner.modulate.a = 0.0
	var tw := banner.create_tween()
	tw.tween_property(banner, "modulate:a", 1.0, UiKit.motion(0.15))
	tw.tween_interval(UiKit.motion(BANNER_DWELL))
	tw.tween_property(banner, "modulate:a", 0.0, UiKit.motion(0.25))
	tw.tween_callback(banner.queue_free)