feat(ui): implant app hierarchy in HudGroups (D-170)
Implant apps use hierarchical groups: implant/map, implant/wiki, implant/journal, etc. Apps are mutually exclusive with each other and with gameplay. Opening implant/map hides gameplay + any other implant app. Closing returns to gameplay. API: open_app(), close_app(), toggle_app(), is_app_active(). Star map uses implant/map. Future apps register their own group. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.6
@@ -1,30 +1,35 @@
|
||||
extends Node
|
||||
## HUD visibility group manager (D-170).
|
||||
##
|
||||
## Nodes register themselves into groups. When a group's visibility changes,
|
||||
## all registered nodes show/hide together. This replaces per-panel manual
|
||||
## hide/show of individual HUD elements.
|
||||
## Nodes register into hierarchical groups. Groups control show/hide as a unit.
|
||||
##
|
||||
## Groups:
|
||||
## "gameplay" — stance indicator, minimap, health/time, interaction prompts,
|
||||
## cursor renderer, inventory, news ticker, examine display
|
||||
## "implant" — star map, travel planner, GTTR reader, station profile
|
||||
## "modal" — settings, bug report, loading screen, debug console
|
||||
## "debug" — debug overlay, gauntlet HUD, checklist
|
||||
## "always" — nodes that never hide (reserved for future use)
|
||||
## Hierarchy:
|
||||
## "gameplay" — stance, minimap, health, prompts, cursor, inventory
|
||||
## "implant/map" — star map
|
||||
## "implant/wiki" — GTTR reader
|
||||
## "implant/journal" — knowledge journal
|
||||
## "implant/travel" — travel planner
|
||||
## "implant/station" — station profile
|
||||
## "implant/cargo" — cargo manifest
|
||||
## "modal" — settings, bug report, loading (independent layer)
|
||||
## "debug" — debug overlay, gauntlet HUD (independent layer)
|
||||
##
|
||||
## Usage from any node:
|
||||
## Rules:
|
||||
## - "gameplay" and any "implant/*" are mutually exclusive.
|
||||
## Opening an implant app hides gameplay.
|
||||
## - "implant/*" apps are mutually exclusive with each other.
|
||||
## Opening implant/map hides implant/wiki.
|
||||
## - "modal" and "debug" are independent — overlay on anything.
|
||||
##
|
||||
## Usage:
|
||||
## HudGroups.register(self, "gameplay")
|
||||
## HudGroups.show_group("implant") # shows implant, hides gameplay
|
||||
## HudGroups.show_group("gameplay") # shows gameplay, hides implant
|
||||
## HudGroups.toggle_group("implant") # toggle between gameplay and implant
|
||||
## HudGroups.register(self, "implant/map")
|
||||
## HudGroups.open_app("implant/map") # hides gameplay + other implant apps
|
||||
## HudGroups.close_app() # returns to gameplay
|
||||
## HudGroups.toggle_app("implant/map") # open if closed, close if open
|
||||
|
||||
## Which groups are mutually exclusive — showing one hides the others.
|
||||
## Modal and debug are independent (they overlay on top of anything).
|
||||
const EXCLUSIVE_GROUPS: Array[String] = ["gameplay", "implant"]
|
||||
|
||||
var _groups: Dictionary = {} # group_name -> Array[Control]
|
||||
var _active_exclusive: String = "gameplay"
|
||||
var _groups: Dictionary = {} # group_name -> Array[Control]
|
||||
var _active_app: String = "" # currently open implant/* app ("" = none)
|
||||
|
||||
|
||||
func register(node: Control, group: String) -> void:
|
||||
@@ -32,9 +37,11 @@ func register(node: Control, group: String) -> void:
|
||||
_groups[group] = []
|
||||
if node not in _groups[group]:
|
||||
_groups[group].append(node)
|
||||
# Apply current visibility state
|
||||
if group in EXCLUSIVE_GROUPS:
|
||||
node.visible = (group == _active_exclusive)
|
||||
# Apply current visibility
|
||||
if group == "gameplay":
|
||||
node.visible = _active_app.is_empty()
|
||||
elif group.begins_with("implant/"):
|
||||
node.visible = (group == _active_app)
|
||||
|
||||
|
||||
func unregister(node: Control, group: String) -> void:
|
||||
@@ -42,42 +49,55 @@ func unregister(node: Control, group: String) -> void:
|
||||
_groups[group].erase(node)
|
||||
|
||||
|
||||
## Show a group. If it's exclusive, hide the other exclusive groups.
|
||||
func show_group(group: String) -> void:
|
||||
if group in EXCLUSIVE_GROUPS:
|
||||
_active_exclusive = group
|
||||
for g: String in EXCLUSIVE_GROUPS:
|
||||
_set_group_visible(g, g == group)
|
||||
## Open an implant app. Hides gameplay and any other implant app.
|
||||
func open_app(app: String) -> void:
|
||||
if not app.begins_with("implant/"):
|
||||
push_warning("HudGroups.open_app: expected implant/* group, got: " + app)
|
||||
return
|
||||
|
||||
# Hide previous app if different
|
||||
if not _active_app.is_empty() and _active_app != app:
|
||||
_set_group_visible(_active_app, false)
|
||||
|
||||
_active_app = app
|
||||
_set_group_visible("gameplay", false)
|
||||
_set_group_visible(app, true)
|
||||
|
||||
|
||||
## Close the current implant app. Returns to gameplay.
|
||||
func close_app() -> void:
|
||||
if not _active_app.is_empty():
|
||||
_set_group_visible(_active_app, false)
|
||||
_active_app = ""
|
||||
_set_group_visible("gameplay", true)
|
||||
|
||||
|
||||
## Toggle an implant app. If it's open, close it. If another is open, switch.
|
||||
func toggle_app(app: String) -> void:
|
||||
if _active_app == app:
|
||||
close_app()
|
||||
else:
|
||||
_set_group_visible(group, true)
|
||||
open_app(app)
|
||||
|
||||
|
||||
## Hide a group. If exclusive, falls back to "gameplay".
|
||||
func hide_group(group: String) -> void:
|
||||
if group in EXCLUSIVE_GROUPS:
|
||||
show_group("gameplay")
|
||||
else:
|
||||
_set_group_visible(group, false)
|
||||
## Check if a specific app is currently open.
|
||||
func is_app_active(app: String) -> bool:
|
||||
return _active_app == app
|
||||
|
||||
|
||||
## Toggle between gameplay and the specified group.
|
||||
func toggle_group(group: String) -> void:
|
||||
if _active_exclusive == group:
|
||||
show_group("gameplay")
|
||||
else:
|
||||
show_group(group)
|
||||
## Check if any implant app is open.
|
||||
func is_implant_active() -> bool:
|
||||
return not _active_app.is_empty()
|
||||
|
||||
|
||||
## Check if a group is currently active.
|
||||
func is_group_active(group: String) -> bool:
|
||||
if group in EXCLUSIVE_GROUPS:
|
||||
return _active_exclusive == group
|
||||
# Non-exclusive: check if any member is visible
|
||||
if _groups.has(group):
|
||||
for node: Control in _groups[group]:
|
||||
if is_instance_valid(node) and node.visible:
|
||||
return true
|
||||
return false
|
||||
## Get the currently active app name, or "" if none.
|
||||
func get_active_app() -> String:
|
||||
return _active_app
|
||||
|
||||
|
||||
## Show/hide an independent group (modal, debug). Does not affect gameplay/implant.
|
||||
func show_group(group: String, vis: bool = true) -> void:
|
||||
_set_group_visible(group, vis)
|
||||
|
||||
|
||||
func _set_group_visible(group: String, vis: bool) -> void:
|
||||
|
||||
Reference in New Issue
Block a user