## VERTICAL SLICE - NOT FOR PRODUCTION
## 战斗结算表「伤害掷点与护甲」段 schema：当量参考敞口、攻击类型×护甲克制矩阵、护甲等级掷点
## 与伤害下限共 10 列纯数据载体（由 SettlementTable.damage_roll 持有；零函数零随机零 await）。
## 域校验由主表 validate 分面执行（fail-fast）。
class_name DamageRollTable
extends Resource

@export var equivalence_ref_damage: int = 12      # [1,999] knob——当量参考敞口 D_ref
# ---- 攻击类型 × 护甲克制 + 充能奖励定义（数值 provisional）----
# 主角攻击 = 普通（atk×(1+attack_up)，不吃克制）+ 穿刺 + 魔法（后两者由充能供给），三分量各自 floor 后相加。
# 【两条抽象分离，勿焊死】攻击类型 = 伤害的属性轴，只决定查 armor_effectiveness 哪一行，定义里不含任何棋盘来源；
# 充能 = 按攻击类型分桶的附加伤害储备，"谁往桶里放东西"属**奖励的定义**（开格/标雷只是奖励触发源，奖励内容可改）。
# 无 damage_a_per_cell / damage_a_cap / damage_b_per_seal 与 charge_grants 字段（攻击模型=单分量）。
@export var armor_effectiveness: Dictionary[String, Variant] = {}  # 克制修正矩阵（加法点数 delta）：{攻击类型 {normal|pierce|magic}: {护甲 {light|ward|heavy}: 点数 [-3,+3]}}
# ---- 护甲等级掷点（数字即规范——registry settlement_table.ac_roll/ac_discount_tiers 定稿）----
# 判定式：掷 1d20，掷点 ≥ 防守方 AC + 攻击加成 → 全额；低掷按缺口（AC−掷点）查档打折，无 miss、无零收益档；
# nat 最大面（crit_roll）= 暴击：该次基础攻击分量 ×2 且恒全额；任何伤害落地全局下限 damage_floor（≥1）——
# 全来源（攻击双方/棋盘直伤/地形变异/反噬，取值域 [1,+∞) 无上限）。
# 掷点只吃基础攻击分量（主角普通分量 / 敌方攻击拍与重击拍基线），穿刺/魔法充能与棋盘来源伤害不掷不折。
# 微调旋钮 = 档位边界（roll_tier_bounds）与档位值（roll_tier_discounts），不动 AC 值（armor_class 归单位表）。
@export var roll_faces: int = 20                  # [2,1000] knob——掷点骰面（d20）
@export var attack_bonus: int = 0                 # [0,999] 结构位——攻击者掷点加成，切片恒 0（元进度/武器附魔未来投值）
@export var roll_tier_bounds: Array[int] = []          # 缺口档边界升序：缺口 ≥ bounds[i] 落入第 i 档（[3,7] = 缺口1-3/4-7/8+ 三档）
@export var roll_tier_discounts: Array[int] = []       # 档位值 percent 降序（与 bounds 同长；[75,50,25] = ×0.75/×0.5/×0.25）
@export var crit_roll: int = 20                   # [1,roll_faces] knob——nat 最大面 = 暴击触发掷点（恒全额）
@export var crit_multiplier: int = 200            # [100,999] percent knob——暴击倍率（200 = ×2，只乘该次基础攻击分量）
@export var damage_floor: int = 1                 # [1,999] knob——任何伤害落地全局下限·全来源（无"被减伤归零 v=0"语义）
@export var armor_roll_stream: String = "armor_roll"  # 掷点用途标签（rng_service PURPOSE_TAGS 成员——不参与派生，仅作事件日志用途标记）