aetherbound-guild/runtime/entry/contract_choice_page_controller.gd

class_name ABGContractChoicePageController
extends RefCounted

const GuildContractService = preload("res://entry/guild_contract_service.gd")
const ContentRegistry = preload("res://p10_0/content_registry.gd")

## UI-independent Contract Choice view-data assembly.
## Contract creation remains owned by GuildContractService; this controller only
## describes the stable choice surface and whether the Confirm boundary may be
## exposed.


func snapshot(company: Dictionary, selected_difficulty := "standard", locale := "zh_CN") -> Dictionary:
	if company.is_empty():
		return {"ok": false, "code": "COMPANY_REQUIRED"}
	var active_contract = company.get("active_contract", {})
	if not active_contract is Dictionary:
		return {"ok": false, "code": "COMPANY_INVALID"}
	# A returned contract is history: the guild may offer the next one.
	if not Dictionary(active_contract).is_empty() and String(Dictionary(active_contract).get("status", "")) != "returned":
		return {"ok": false, "code": "CONTRACT_ALREADY_ACTIVE"}
	var normalized := normalize_difficulty(selected_difficulty)
	var catalog := _difficulty_catalog(locale, normalized)
	var recruits := _copy_array(company.get("owned_recruits", []))
	var company_data := {
		"company_id": String(company.get("company_id", "")),
		"owned_count": recruits.size(),
		"recruits": recruits,
	}
	var contract_row: Dictionary = _next_contract_row(locale, company)
	var creation_facts := {
		"contract_id": String(contract_row.get("id", GuildContractService.FIRST_CONTRACT_ID)),
		"route_id": String(contract_row.get("region_id", "RG-01")).to_lower(),
		"route_title": String(contract_row.get("route_title", _tr("风镜初渡", "FIRST WINDGLASS CROSSING", locale))),
		"route_copy": String(contract_row.get("route_copy", _tr("穿越悬浮风镜，建立公会的第一条安全通路。", "Cross the suspended windglass and establish the Guild's first safe route.", locale))),
		"starting_coin": GuildContractService.STARTING_COIN,
		"line_capacity": GuildContractService.STARTING_LINE_CAPACITY,
		"market_counts": {"recruit": 3, "equipment": 4, "battle": 3},
	}
	return {
		"ok": true,
		"page_id": "contract_choice",
		"company": company_data,
		"contract": creation_facts,
		"difficulties": catalog,
		"selected_difficulty": normalized,
		"confirm": {
			"eligible": true,
			"reason": "ready",
		},
		"locale": String(locale),
	}


func normalize_difficulty(value: String) -> String:
	return value if value in GuildContractService.DIFFICULTIES else "standard"


func is_valid_difficulty(value: String) -> bool:
	return value in GuildContractService.DIFFICULTIES


func confirm_state(company: Dictionary, selected_difficulty := "standard") -> Dictionary:
	if company.is_empty():
		return {"eligible": false, "reason": "company_required"}
	var active_contract = company.get("active_contract", {})
	if not active_contract is Dictionary:
		return {"eligible": false, "reason": "company_invalid"}
	# M79-I05: a returned contract is history, so the next one may be confirmed.
	if not Dictionary(active_contract).is_empty() and String(Dictionary(active_contract).get("status", "")) != "returned":
		return {"eligible": false, "reason": "contract_already_active"}
	if not is_valid_difficulty(selected_difficulty):
		return {"eligible": false, "reason": "invalid_difficulty"}
	return {"eligible": true, "reason": "ready"}


func _difficulty_catalog(locale: String, selected: String) -> Array[Dictionary]:
	var result: Array[Dictionary] = []
	for difficulty in GuildContractService.DIFFICULTIES:
		var id := String(difficulty)
		result.append({
			"id": id,
			"name": _difficulty_name(id, locale),
			"copy": _difficulty_copy(id, locale),
			"selected": id == selected,
		})
	return result


func _difficulty_name(value: String, locale: String) -> String:
	match value:
		"wayfinder": return _tr("引路", "Wayfinder", locale)
		"stormbound": return _tr("风暴", "Stormbound", locale)
		"iron_oath": return _tr("铁誓", "Iron Oath", locale)
	return _tr("标准", "Standard", locale)


func _difficulty_copy(value: String, locale: String) -> String:
	match value:
		"wayfinder": return _tr("较宽容的敌方参数；所有系统、进度与记录仍然可用。", "More forgiving enemy parameters; all systems, progression and Records remain available.", locale)
		"stormbound": return _tr("更高压力与回报；目标规则和远征团所有权不变。", "Higher pressure and rewards; target rules and Company ownership remain unchanged.", locale)
		"iron_oath": return _tr("最高压力；只改变敌人与回报参数，不隐藏规则。", "Highest pressure; only enemy and reward parameters change, never hidden rules.", locale)
	return _tr("完整的标准平衡；不需要额外永久战力。", "The complete standard balance; no extra permanent power is required.", locale)


func _copy_array(value) -> Array:
	var result: Array = []
	if value is Array:
		for item in value:
			result.append(item.duplicate(true) if item is Dictionary or item is Array else item)
	return result


func _tr(zh: String, en: String, locale: String) -> String:
	return en if String(locale).to_lower().begins_with("en") else zh

func _next_contract_row(locale: String, company: Dictionary) -> Dictionary:
	# The next contract follows the company's ordinal; region titles come from
	# the catalogue and its zh authority.
	var content: Dictionary = ContentRegistry.snapshot()
	var rows: Array = Array(content.get("contracts", []))
	rows.sort_custom(func(a, b): return String(a.get("id", "")) < String(b.get("id", "")))
	if rows.is_empty():
		return {}
	var ordinal := 0
	if company is Dictionary:
		ordinal = int(company.get("next_contract_ordinal", 0))
	var row: Dictionary = Dictionary(rows[clampi(ordinal, 0, rows.size() - 1)]).duplicate(true)
	var region_id := String(row.get("region_id", "RG-01"))
	row["route_title"] = ContentRegistry.localized_name(content, region_id, locale)
	if String(row["route_title"]).is_empty():
		row["route_title"] = region_id
	var region_rows: Array = Array(content.get("region", []))
	for region_row in region_rows:
		if String(Dictionary(region_row).get("id", "")) == region_id:
			row["route_copy"] = String(Dictionary(region_row).get("framing", ""))
			break
	return row