gplan-2/game/tests/unit/presentation/terrain_tile_sets_test.gd

# tests/unit/presentation/terrain_tile_sets_test.gd — 瓦片换色机检（T6 卡交付：色相域抽检+套完整性）
# 运行：godot --headless --path game --script res://tests/unit/presentation/terrain_tile_sets_test.gd
# 事实源：board_gen.tres board_type 词表 v1.1（dungeon/underdark/deep_underdark——从表读值，禁写死）；
#        色相域方向 = art-bible §4.3 三关方向（underdark 灰白蓝紫 / deep_underdark 蓝黑紫黑）；
#        图底分离 = 圣经 §8.5（已开地面明度低于未开墙体）。
# 前置守卫：素材不入 git（用户裁定）——fresh checkout 无瓦片文件时本套件跳过（打印注记，不红）；
#          源 dungeon 套在盘而换色套缺位 = 回归（换色脚本在库可复现）。
extends SceneTree

const ConfigDBScript := preload("res://core/config_db.gd")
const BoardViewScript := preload("res://presentation/views/board_view.gd")

var _failures := 0
var _checks := 0


func _init() -> void:
	var board_dir := ProjectSettings.globalize_path("res://assets/art/board/")
	var probe_path := board_dir.path_join("terrain_wall_center_dungeon.png")
	if not FileAccess.file_exists(probe_path):
		print("[terrain_tile_sets_test] SKIP——素材工作区缺位（瓦片不入 git 纪律，fresh checkout 预期态）")
		quit(0)
		return
	var db = ConfigDBScript.new()
	var load_ok: bool = db.load_tables("res://data/tables", true)
	_check("前置：表加载零 error", load_ok and db.diagnostics_count("error") == 0)
	if not load_ok:
		quit(1)
		return
	# board_type 词表自 board_gen 行集推导（禁测试侧写死词表）
	var types: Array = []
	for row in db.board_gen.rows:
		var bt := String(row.get("board_type", ""))
		if bt != "" and not types.has(bt):
			types.append(bt)
	_check("前置：board_gen 词表非空（%d 型）" % types.size(), types.size() > 0)
	_test_set_completeness(board_dir, types)
	_test_hue_domains(board_dir)
	_test_digit_ink_modes(board_dir, types)
	if _failures > 0:
		push_error("[terrain_tile_sets_test] %d/%d 项失败" % [_failures, _checks])
		quit(1)
		return
	print("[terrain_tile_sets_test] all green (%d checks)" % _checks)
	quit(0)


func _check(desc: String, ok: bool) -> void:
	_checks += 1
	if ok:
		print("  [PASS] " + desc)
	else:
		_failures += 1
		push_error("  [FAIL] " + desc)


# 套完整性：词表每个 board_type 的 16 墙 + 5 地面变体全部在盘（缺位 → BoardView 整批回落 dungeon 的
# 缺位回退断言由 ui_input_probe 覆盖；本断言管「入包完整」面）
func _test_set_completeness(board_dir: String, types: Array) -> void:
	var wall_names: Array = BoardViewScript.TILE_WALL_NAMES
	var variants: int = int(BoardViewScript.TILE_FLOOR_VARIANTS)
	for bt in types:
		var missing: Array = []
		for w in wall_names:
			var p := board_dir.path_join("terrain_%s_%s.png" % [String(w), String(bt)])
			if not FileAccess.file_exists(p):
				missing.append(String(w))
		for i in range(1, variants + 1):
			var pf := board_dir.path_join("terrain_floor_%s_%d.png" % [String(bt), i])
			if not FileAccess.file_exists(pf):
				missing.append("floor_%d" % i)
		_check("图型 %s 瓦片套完整（16 墙 + %d 地面，缺=%s）" % [String(bt), variants, str(missing)], missing.is_empty())


# 色相域抽检：wall_center 上半幅（墙顶面）与 floor_1 全幅的均值色相/明度
func _test_hue_domains(board_dir: String) -> void:
	var bands := {
		"dungeon": [0.02, 0.16],        # 暖石棕 ≈15°–58°
		"underdark": [0.50, 0.72],      # 灰白蓝紫 ≈180°–260°
		"deep_underdark": [0.55, 0.78], # 蓝黑紫黑 ≈200°–280°
	}
	var wall_v := {}
	var floor_v := {}
	for bt in bands.keys():
		var wall := _load_stats(board_dir, "terrain_wall_center_%s.png" % String(bt), true)
		var floor_img := _load_stats(board_dir, "terrain_floor_%s_1.png" % String(bt), false)
		if wall.is_empty() or floor_img.is_empty():
			_check("图型 %s 抽检样本可读" % String(bt), false)
			continue
		wall_v[bt] = float(wall["v"])
		floor_v[bt] = float(floor_img["v"])
		var band: Array = bands[bt]
		_check("图型 %s 墙顶均值色相在带 %s（实测 %.3f）" % [String(bt), str(band), float(wall["h"])],
			float(wall["h"]) >= float(band[0]) and float(wall["h"]) <= float(band[1]))
		_check("图型 %s 图底分离（墙顶明度 %.3f > 地面 %.3f）" % [String(bt), wall_v[bt], floor_v[bt]],
			wall_v[bt] > floor_v[bt])
	if wall_v.has("underdark") and wall_v.has("deep_underdark"):
		_check("deep_underdark 墙顶更暗于 underdark（更深蓝黑方向）", float(wall_v["deep_underdark"]) < float(wall_v["underdark"]))


# 均值读数：hue 取饱和度 > 0.05 的像素（墨线/灰黑不影响色相均值）；v 取全幅均值
func _load_stats(board_dir: String, fname: String, top_half: bool) -> Dictionary:
	var p := board_dir.path_join(fname)
	if not FileAccess.file_exists(p):
		return {}
	var img := Image.load_from_file(p)
	if img == null:
		return {}
	if img.is_compressed():
		img.decompress()
	var w := img.get_width()
	var h := img.get_height()
	var y0 := 0
	var y1 := h
	if top_half:
		y1 = h / 2   # 墙顶面 = 上半幅（立面暗带不参与色相均值）
	var h_sum := 0.0
	var v_sum := 0.0
	var n_h := 0
	var n_v := 0
	for y in range(y0, y1):
		for x in range(w):
			var c := img.get_pixel(x, y)
			v_sum += c.v
			n_v += 1
			if c.s > 0.05:
				h_sum += c.h
				n_h += 1
	if n_v == 0 or n_h == 0:
		return {}
	return {"h": h_sum / n_h, "v": v_sum / n_v}


# 数字墨族按板自适应对比断言（L2/L3 亮瓦融字缺陷修复 2026-10-01——甲案机检面）：
# 每个图型走 BoardView 同一归一+测光+选族管线（禁测试侧另写算法），断言：
# ①所选墨族对 p90 亮斑 ≥4.5 且对均值 ≥2.5（双门槛，同 _digit_ink_mode 判据常量）
# ②期望族面：dungeon=亮族（样张 v3.5 冻结④原样）；underdark/deep_underdark=深族（亮白筋纹 p95
#   0.66–0.77 上亮墨 CR 1.0–1.9 融字实证）——期望表防「选族逻辑被顺手改坏」回归
func _test_digit_ink_modes(board_dir: String, types: Array) -> void:
	var expect_dark := {"dungeon": false, "underdark": true, "deep_underdark": true}
	var variants: int = int(BoardViewScript.TILE_FLOOR_VARIANTS)
	for bt in types:
		var lumas: Array = []
		var readable := true
		for i in range(1, variants + 1):
			var p := board_dir.path_join("terrain_floor_%s_%d.png" % [String(bt), i])
			if not FileAccess.file_exists(p):
				readable = false
				break
			var tex: Texture2D = ImageTexture.create_from_image(Image.load_from_file(p))
			BoardViewScript._normalize_floor_luma(tex, 0.10, lumas)
		if not readable:
			_check("图型 %s 数字墨族断言样本可读" % String(bt), false)
			continue
		var mode: Dictionary = BoardViewScript._digit_ink_mode(lumas)
		var dark: bool = bool(mode["dark"])
		var cr_p90 := float(mode["cr_p90_bright"]) if not dark else float(mode["cr_p90_dark"])
		var cr_mean := float(mode["cr_mean_bright"]) if not dark else float(mode["cr_mean_dark"])
		var family := "亮墨族" if not dark else "深墨族"
		_check("图型 %s 所选%s 对 p90 ≥%.1f（实测 %.2f）" % [String(bt), family,
			float(BoardViewScript.DIGIT_INK_CR_P90), cr_p90],
			cr_p90 >= float(BoardViewScript.DIGIT_INK_CR_P90))
		_check("图型 %s 所选%s 对均值 ≥%.1f（实测 %.2f）" % [String(bt), family,
			float(BoardViewScript.DIGIT_INK_CR_MEAN), cr_mean],
			cr_mean >= float(BoardViewScript.DIGIT_INK_CR_MEAN))
		if expect_dark.has(bt):
			_check("图型 %s 墨族期望=%s（实测=%s）" % [String(bt),
				"深族" if bool(expect_dark[bt]) else "亮族", family], dark == bool(expect_dark[bt]))