class_name MenuScreen
extends Control
# 开始菜单屏壳（场景=组合单元与生命周期单元）。
# 视图代码原样构建（节点构建归 ui_assembler.gd 纪律不变——本屏壳只持有与暴露句柄）；
# 按钮接线归组合根 main.gd（信号连接只在组合根）。
# 可独立实例化（F6/headless 挂载）——V2「各新屏场景可独立实例化」探针断言载体。
# main 组合根保留 _start_overlay 等句柄指向本屏成员——可见性开关与探针挂载假设零迁移。

var start_overlay: Control      # 全屏菜单层（原 main._start_overlay——组合根可见性开关句柄不变）
var box: VBoxContainer
var entersavebtn: Button
var settingsbtn: Button
var quitbtn: Button

const UiAssembler := preload("res://presentation/ui_assembler.gd")   # 构建归装配器（规范 1.1——非全局类，preload 引用）


func _ready() -> void:
	mouse_filter = Control.MOUSE_FILTER_IGNORE   # 屏壳=纯容器（ui_input 实证：全屏 STOP 壳会吃掉下层模态鼠标输入）
	var start: Dictionary[Variant, Variant] = UiAssembler.build_start_overlay(self, get_node("/root/ConfigDB"))
	start_overlay = start.overlay
	box = start.box
	entersavebtn = start.entersavebtn
	settingsbtn = start.settingsbtn
	quitbtn = start.quitbtn