class_name PanelModule
extends RefCounted

const I18nScript := preload("res://scripts/core/i18n.gd")

# 面板模块基类。
#
# 设计目标：
# - 子面板只关心自己的 UI 和业务流程，不直接依赖 GameScene 的大量字段。
# - GameScene 通过 callbacks 暴露必要能力，例如玩家数据、库存刷新、Toast、弹窗开关。
# - 所有跨模块状态写入都从这里走统一 helper，后续要替换成更严格的 State/Facade 时只改这一层。

# 公共服务和工具引用由 GameScene 注入。
# 这里故意不写成强类型，避免每个面板都需要 preload 具体实现，降低模块之间的编译耦合。
var _ui
var _texture_provider
var _game_config
var _activity_api
var _owner: Node
var _context

# context 是面板到宿主的统一桥；callbacks 只保留给未迁完的旧面板兼容。
# 约定：子类不能直接访问 GameScene 字段，只能通过 _call/_call_async 间接调用。
var _callbacks: Dictionary = {}
var _panel_screen_size := Vector2(640.0, 960.0)


func setup(options: Dictionary) -> void:
	# 所有面板统一使用字典注入，方便每个功能只拿自己需要的依赖。
	_ui = options.get("ui_builder")
	_texture_provider = options.get("texture_provider")
	_game_config = options.get("game_config")
	_activity_api = options.get("activity_api")
	_owner = options.get("owner") as Node
	_context = options.get("context")
	_callbacks = options.get("callbacks", {})
	if _callbacks.is_empty() and _context != null and _context.has_method("legacy_callbacks"):
		_callbacks = _context.legacy_callbacks()
	_panel_screen_size = options.get("panel_screen_size", _panel_screen_size)


func _clear_children(parent: Node) -> void:
	# 面板多次 render 时统一清理动态节点，避免旧按钮信号和旧列表项残留。
	for child in parent.get_children():
		child.queue_free()


func _is_live_node(node: Variant) -> bool:
	return node != null and is_instance_valid(node) and node is Node


func _is_current_node(candidate: Variant, current: Variant) -> bool:
	return _is_live_node(candidate) and _is_live_node(current) and candidate == current


func _clear_children_if_live(parent: Variant) -> bool:
	if not _is_live_node(parent):
		return false
	_clear_children(parent as Node)
	return true


func _format_timestamp(unix_time: int) -> String:
	if unix_time <= 0:
		return ""
	var dt := Time.get_datetime_dict_from_unix_time(unix_time)
	return "%02d-%02d %02d:%02d" % [int(dt.get("month", 1)), int(dt.get("day", 1)), int(dt.get("hour", 0)), int(dt.get("minute", 0))]


func _player_data() -> Dictionary:
	# 返回的是宿主玩家字典引用，面板内修改会直接反映到 HUD/后续接口参数。
	# 后续如果引入 PlayerInventoryFacade，这里是替换入口。
	var result = _call("player_data", [], {})
	return result if result is Dictionary else {}


func _token() -> String:
	return str(_call("token", [], ""))


func _player_id() -> int:
	return int(_call("player_id", [], 0))


func _is_busy() -> bool:
	# 全局操作锁，防止用户连续点击导致同一接口重复请求。
	return bool(_call("is_operation_in_progress", [], false))


func _set_busy(value: bool) -> void:
	_call("set_operation_in_progress", [value])


func _show_toast(message: String) -> void:
	_call("show_toast", [message])


func _open_modal(panel: Control) -> void:
	_call("open_modal_panel", [panel])


func _close_modal(animated := true) -> void:
	_call("close_modal_panel", [animated])


func _response_data(result: Dictionary, fallback: Variant = {}) -> Variant:
	# ApiClient 返回统一包裹结构，业务数据固定从 body.data 取。
	return _call("response_data", [result, fallback], fallback)


func _response_status_text(result: Dictionary, fallback := "操作失败") -> String:
	return I18nScript.t(str(_call("response_status_text", [result, fallback], fallback)))


func _parse_cost_string(cost_text: String) -> Array[Dictionary]:
	# 旧配置大量使用 "item_id:count,item_id:count" 字符串。
	# 面板不要自己 split，统一走 CostRules，兼容金豆/钻石/道具的后续特殊规则。
	var result = _call("parse_cost_string", [cost_text], [])
	var costs: Array[Dictionary] = []
	if result is Array:
		for cost in result:
			if cost is Dictionary:
				costs.append(cost)
	return costs


func _reward_fields_to_text(row: Dictionary, first_field: int, last_field: int, multiplier := 1) -> String:
	# 旧配置常用 fruit_id1..fruit_idN 表示奖励或消耗。
	# 返回统一 cost_text，方便复用库存校验、奖励展示和道具格渲染。
	return str(_call("reward_fields_to_text", [row, first_field, last_field, multiplier], ""))


func _format_reward_text(cost_text: String) -> String:
	return str(_call("format_reward_text", [cost_text], ""))


func _add_reward_items(cost_text: String) -> void:
	_call("add_reward_items", [cost_text])


func _render_player() -> void:
	_call("render_player")


func _add_player_exp(amount: int) -> void:
	_call("add_player_exp", [amount])


func _refresh_store_house() -> Variant:
	# 库存刷新是异步接口，面板领取/购买/消耗后都要 await，保证再次 render 时数量正确。
	return await _call_async("refresh_store_house")


func _has_costs(cost_text: String) -> bool:
	# 所有按钮可用态都应该走统一成本校验，避免不同面板对材料数量理解不一致。
	return bool(_call("has_costs", [cost_text], false))


func _apply_cost_deduction(cost_text: String) -> void:
	# 后端成功后才本地扣减，用于让 UI 立即刷新；失败时不能提前扣。
	_call("apply_cost_deduction", [cost_text])


func _owned_amount(item_id: int) -> int:
	return int(_call("owned_amount", [item_id], 0))


func _decrease_warehouse_item(item_id: int, count: int) -> void:
	_call("decrease_warehouse_item", [item_id, count])


func _set_texture_button_enabled(button_holder: Control, enabled: bool, normal_texture: Texture2D = null, disabled_texture: Texture2D = null) -> void:
	# TextureButton 是自定义 Control + Button 组合，禁用逻辑需要同时改透明度、贴图和 hit.disabled。
	_call("set_texture_button_enabled", [button_holder, enabled, normal_texture, disabled_texture])


func _format_duration(seconds: int) -> String:
	return I18nScript.t(str(_call("format_duration", [seconds], I18nScript.format_duration(seconds))))


func _get_item_icon_texture(icon_id: int) -> Texture2D:
	# 图标路径兼容 item_icon、icon、petIcon、plant 多个旧资源目录。
	if _texture_provider != null and _texture_provider.has_method("item_icon"):
		return _texture_provider.item_icon(icon_id)
	var result = _call("get_item_icon_texture", [icon_id], null)
	return result as Texture2D


func _style_label(label: Label, size: int, color: Color, outline: int, outline_color: Color) -> void:
	_call("style_label", [label, size, color, outline, outline_color])


func _apply_empty_button_style(button: Button) -> void:
	_call("apply_empty_button_style", [button])


func _create_tab_bar(parent: Control, name: String, labels: Array, position: Vector2, selected_index: int, callback: Callable, base_height := 40.0) -> Control:
	return _ui.create_tab_bar(parent, name, labels, position, selected_index, callback, base_height)


func _update_tab_bar(group: Control, selected_index: int) -> void:
	_ui.update_tab_bar(group, selected_index)


func _add_cost_slots(parent: Control, cost_text: String, position: Vector2, max_count: int, gap := 84.0, size := Vector2(76.0, 76.0)) -> void:
	# 多数旧面板都用横向材料格。这里只负责展示，是否足够由 _has_costs 决定。
	var costs := _parse_cost_string(cost_text)
	for index in range(mini(costs.size(), max_count)):
		var cost := costs[index]
		_ui.add_item_slot(parent, "CostSlot%s" % index, int(cost.get("item_id", 0)), int(cost.get("count", 0)), position + Vector2(gap * index, 0.0), size)


func _find_config_by_id(rows: Array[Dictionary], id: int) -> Dictionary:
	for row in rows:
		if int(row.get("id", 0)) == id:
			return row
	return {}


func _first_cost(cost_text: String) -> Dictionary:
	# 周卡/月卡、签到等配置只取首个奖励时使用。
	var costs := _parse_cost_string(cost_text)
	return costs[0] if not costs.is_empty() else {}


func _same_local_day(left_time: int, right_time: int) -> bool:
	# 旧后端用 Unix 秒记录领取时间，日卡类奖励需要按本地日期判断是否已领。
	if left_time <= 0 or right_time <= 0:
		return false
	var left := Time.get_datetime_dict_from_unix_time(left_time)
	var right := Time.get_datetime_dict_from_unix_time(right_time)
	return int(left.get("year", 0)) == int(right.get("year", 0)) and int(left.get("month", 0)) == int(right.get("month", 0)) and int(left.get("day", 0)) == int(right.get("day", 0))


func _normalize_reward_triplets(raw: String) -> String:
	# 游乐园奖励配置可能是 item:type:count，这里转成统一 item:count 文本给奖励展示层。
	var parts: Array[String] = []
	for piece in raw.split(",", false):
		var fields := piece.split(":", false)
		if fields.size() >= 3:
			parts.append("%s:%s" % [fields[0], fields[2]])
		elif fields.size() == 2:
			parts.append(piece)
	return ",".join(parts)


func _callback(name: String) -> Callable:
	if _context != null and _context.has_method("callback"):
		return _context.callback(name)
	return _callbacks.get(name, Callable()) as Callable


func _call(name: String, args: Array = [], fallback: Variant = null) -> Variant:
	# 同步 callback 的统一入口。无效 callback 必须静默返回 fallback，保证面板可单独 check-only。
	if _context != null and _context.has_method("call_action"):
		return _context.call_action(name, args, fallback)
	var callable := _callback(name)
	if not callable.is_valid():
		return fallback
	return callable.callv(args)


func _call_async(name: String, args: Array = []) -> Variant:
	# Godot 允许 await Callable.callv() 返回的异步函数；这里集中处理缺失 callback。
	if _context != null and _context.has_method("call_action_async"):
		return await _context.call_action_async(name, args)
	var callable := _callback(name)
	if not callable.is_valid():
		return null
	return await callable.callv(args)