DKChan
b605022001
P1-6 类型闸（须 T1-T4 全落后——本波按执行顺序锁殿后）: - tools/audit_type_hints.py 新机器闸（V7）: R1 无类型容器注解/R2 有值返回缺返回类型/ R3 参数缺类型三规则+行级 # type-hint: ignore 显式白名单通道；产品码 core/data/presentation - 存量收口: 368 处显式 Array/Dictionary 非参数化注解→机械参数化（Array[Variant]/ Dictionary[Variant, Variant] 零行为面）；13 处参数真类型（SaveManagerCore/ConfigDb/ BattleOrchestrator/MinesweeperRules/LevelRunner/SettingsStore 等） - 白名单豁免四处: board_generator generate/_attempt/legality/_finalize 的 db 参—— 测量面 _BoardRowStub 冒烟夹具鸭子型注入（typed 参拒 stub） - project.godot 拉起 gdscript/warnings/untyped_declaration=1（V7 源码断言在 smoke _smoke_type_gate） - static_scan 新 S9 类型闸规则；顺修历史 cd 错位（9-24 布局迁移后 /.. 落 game/ 致守卫 恒跳过静默空转——修复后 S1-S4/S9 首次实跑全绿）+S1/S2 增 ADR-0007-exempt 标记豁免通道 （main _seed_value 引擎熵源=文档化豁免面） 验收: 冒烟 1081/0（+V7×2）+run_all 27 套+static_scan 全绿+probe click+render golden+对拍三变体全同
149 lines
6.6 KiB
GDScript
149 lines
6.6 KiB
GDScript
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||
# Date: 2026-09-29（迭代 8 卡④ 最小设置面）
|
||
# 设置覆盖层（纯视图边界规范 1.3 同款）：音量滑杆/全屏/减动效三件+返回（退出游戏已提级开始菜单）。
|
||
# 生效与持久化全经 SettingsStore 单点（实时应用+即改即存）；本类零核心触碰。
|
||
# 减动效转正承载（测试调整板旧开关退役——设置面唯一入口，卡④ AC③）。
|
||
# 探针接缝：retarget(store) = 隔离存档换注口（同 camp 换注先例）；控件引用公有只读供断言。
|
||
class_name SettingsOverlay
|
||
extends Control
|
||
|
||
signal closed
|
||
|
||
var _store
|
||
var _volume: HSlider
|
||
var _volume_val: Label
|
||
var _fs_btn: Button # M4 换 SwitchToggle 拨杆（仍 Button 子类——探针接缝保持）
|
||
var _motion_btn: Button # M4 同上
|
||
var _fs_st: Label # M4 状态字随行（开/关）
|
||
var _motion_st: Label # M4 状态字（完整/快速）
|
||
|
||
|
||
func _init(store) -> void:
|
||
_store = store
|
||
_build()
|
||
_sync()
|
||
visible = false
|
||
|
||
|
||
# 探针隔离换注（冒烟/探针禁碰真实 user://settings.cfg——换注后按新 store 重挂控件态）
|
||
func retarget(store: SettingsStore) -> void:
|
||
_store = store
|
||
_sync()
|
||
|
||
|
||
func _build() -> void:
|
||
# M4（UI 落码批）：石板面板化（demo ③）+行牌化（标签+拨杆+状态字+后果说明行）；
|
||
# 设置项零增减（P-C6：只有主音量——demo 音效音量行系原型发明已撤）；
|
||
# 减动效与结算演出动画=同一设置（语义命名批合并），一行承载。
|
||
# T8（UI 设计对齐批 2026-10-06）：两列对齐（label 列定宽 140——demo .setrow label/控制两列）+
|
||
# 后果说明内联随行（demo .why 同排）+返回钮紧凑化（demo .btn9 紧凑——原 216 宽砖）。
|
||
var shell: Dictionary[Variant, Variant] = UiKit.modal_shell(self, UiKit.BG_BRIGHT, Vector2(560, 0), 8, true,
|
||
UiKit.panel_skinned(Vector4(20, 16, 20, 16)))
|
||
var box: VBoxContainer = shell.box
|
||
|
||
var title := UiKit.label("设置",UiKit.FS_TITLE, true, UiKit.INK_TITLE)
|
||
title.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
|
||
box.add_child(title)
|
||
var hint := UiKit.label("系统级设置——独立存储不随存档（一安装一份，删游戏才消失）",UiKit.FS_HINT, false, UiKit.INK_HINT)
|
||
hint.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
|
||
box.add_child(hint)
|
||
box.add_child(HSeparator.new())
|
||
|
||
# 音量（master bus 实时生效——入口归设置、生效口径归 音频.md）
|
||
var vol_row := HBoxContainer.new()
|
||
vol_row.add_theme_constant_override("separation", 14)
|
||
box.add_child(vol_row)
|
||
var vol_lab := UiKit.label("主音量",UiKit.FS_BODY, false, UiKit.INK_LABEL)
|
||
vol_lab.custom_minimum_size = Vector2(140, 0) # T8 label 列定宽（两列对齐）
|
||
vol_row.add_child(vol_lab)
|
||
_volume = HSlider.new()
|
||
_volume.min_value = 0.0
|
||
_volume.max_value = 100.0
|
||
_volume.value = 100.0
|
||
_volume.custom_minimum_size = Vector2(200, 24) # 几何/量程内联（迭代 25：样式滑杆工厂退役，皮肤走全局主题）
|
||
_volume.step = 1
|
||
_volume.size_flags_horizontal = Control.SIZE_EXPAND_FILL
|
||
_volume.value_changed.connect(_on_volume_changed)
|
||
vol_row.add_child(_volume)
|
||
_volume_val = UiKit.label("100%",UiKit.FS_BODY, true, UiKit.INK_TITLE)
|
||
_volume_val.custom_minimum_size = Vector2(60, 0)
|
||
vol_row.add_child(_volume_val)
|
||
|
||
# 全屏（拨杆形——M10 SwitchToggle；状态字随行）
|
||
var fs_row := HBoxContainer.new()
|
||
fs_row.add_theme_constant_override("separation", 14)
|
||
box.add_child(fs_row)
|
||
var fs_lab := UiKit.label("全屏",UiKit.FS_BODY, false, UiKit.INK_LABEL)
|
||
fs_lab.custom_minimum_size = Vector2(140, 0) # T8 同上
|
||
fs_row.add_child(fs_lab)
|
||
_fs_btn = UiKit.switch_toggle(false)
|
||
_fs_btn.toggled.connect(_on_fullscreen_toggled)
|
||
fs_row.add_child(_fs_btn)
|
||
_fs_st = UiKit.label("关",UiKit.FS_HINT, true, UiKit.INK_LABEL)
|
||
fs_row.add_child(_fs_st)
|
||
|
||
# 结算演出动画（=减动效实称——语义命名批 T17；拨杆 on=完整，off=快速时长减半。
|
||
# T8 核证：reduced_motion 单设置同驱 UiKit.motion_scale 与结算演播——demo「减动效」行与
|
||
# 本行系同一设置，不另立行（拆两行=一设置双行重复，违语义命名批裁决）
|
||
var motion_row := HBoxContainer.new()
|
||
motion_row.add_theme_constant_override("separation", 14)
|
||
box.add_child(motion_row)
|
||
var motion_lab := UiKit.label("结算演出动画",UiKit.FS_BODY, false, UiKit.INK_LABEL)
|
||
motion_lab.custom_minimum_size = Vector2(140, 0) # T8 同上
|
||
motion_row.add_child(motion_lab)
|
||
_motion_btn = UiKit.switch_toggle(true)
|
||
_motion_btn.toggled.connect(_on_motion_toggled)
|
||
motion_row.add_child(_motion_btn)
|
||
_motion_st = UiKit.label("完整",UiKit.FS_HINT, true, UiKit.INK_LABEL)
|
||
motion_row.add_child(_motion_st)
|
||
var why := UiKit.label("快速 = 时长减半（运动敏感 / 演示用）",UiKit.FS_CAPTION, false, UiKit.INK_HINT)
|
||
motion_row.add_child(why) # T8 内联随行（demo .why 同排；原独立行换排）
|
||
|
||
box.add_child(HSeparator.new())
|
||
# 退出游戏已提级开始菜单（D1——设置面不再承载，用户裁决「退出只在一级菜单出现」）
|
||
var close_row := HBoxContainer.new()
|
||
close_row.alignment = BoxContainer.ALIGNMENT_CENTER
|
||
box.add_child(close_row)
|
||
var close_btn := UiKit.button("返回", 90.0) # T8 紧凑返回钮（demo 紧凑形；原 216 宽砖）
|
||
close_btn.pressed.connect(_emit_closed)
|
||
close_row.add_child(close_btn)
|
||
|
||
|
||
func _sync() -> void:
|
||
_volume.set_value_no_signal(roundf(_store.volume_linear * 100.0))
|
||
_volume_val.text = "%d%%" % roundi(_store.volume_linear * 100.0)
|
||
_fs_btn.set_pressed_no_signal(_store.fullscreen)
|
||
_fs_st.text = "开" if _store.fullscreen else "关"
|
||
_motion_btn.set_pressed_no_signal(not _store.reduced_motion) # 拨杆 on=完整
|
||
_sync_motion_text()
|
||
|
||
|
||
# T17 修复：文案随状态即时刷新（旧 bug=切换后文案恒「开」，玩家无法得知当前态）+语义命名
|
||
# （「减动效」玩家读不懂——实称「结算演出动画」速度档）+操作提示内联（所见即所得）。
|
||
func _sync_motion_text() -> void:
|
||
_motion_st.text = "快速" if _store.reduced_motion else "完整"
|
||
|
||
|
||
func _on_volume_changed(v: float) -> void:
|
||
_store.volume_linear = v / 100.0
|
||
_store.apply()
|
||
_store.save_settings()
|
||
_volume_val.text = "%d%%" % int(v)
|
||
|
||
|
||
func _on_fullscreen_toggled(on: bool) -> void:
|
||
_store.fullscreen = on
|
||
_store.apply()
|
||
_store.save_settings()
|
||
|
||
|
||
func _on_motion_toggled(on: bool) -> void:
|
||
_store.reduced_motion = not on # M4 拨杆语义翻转：on=完整（off=快速）
|
||
_store.apply()
|
||
_store.save_settings()
|
||
_sync_motion_text() # T17 修复：切换即时刷新文案（旧版漏刷新=状态文字恒「开」）
|
||
|
||
|
||
func _emit_closed() -> void:
|
||
closed.emit()
|