diff --git a/client/scripts/target_selection_client.gd b/client/scripts/target_selection_client.gd index 46bdaf1..b6d85f2 100644 --- a/client/scripts/target_selection_client.gd +++ b/client/scripts/target_selection_client.gd @@ -1,8 +1,8 @@ extends Node ## NEO-24 (E1M3-02): client tab-target + lock UI synced to server (NEO-23 `TargetState` v1). -## NEO-26 (E1M3-04): emits [signal selection_event] when server-acknowledged [code]lockedTargetId[/code] -## changes (see [member log_selection_events]). +## NEO-26 (E1M3-04): emits [signal selection_event] when server-acknowledged +## [code]lockedTargetId[/code] changes (see [member log_selection_events]). ## ## Flow: ## - `request_sync_from_server()` → `GET …/target` returns `PlayerTargetStateResponse` v1. @@ -23,8 +23,9 @@ signal target_state_changed(state: Dictionary) ## NEO-26: fired only when normalized [code]lockedTargetId[/code] changes after a GET/POST. ## Payload: [code]previous[/code] ([String] or [code]null[/code]), [code]next[/code] (same), -## [code]cause[/code] ([code]"tab"[/code] | [code]"clear"[/code] | [code]"server_correction"[/code]), -## [code]sequence[/code] ([int], from new state). E1.M4+ may [code]connect[/code] here without reshaping. +## [code]cause[/code] ([code]"tab"[/code] | [code]"clear"[/code] | +## [code]"server_correction"[/code]), [code]sequence[/code] ([int], from new state). +## E1.M4+ may [code]connect[/code] here without reshaping. signal selection_event(event: Dictionary) enum Phase { IDLE, GET, POST_SELECT } @@ -38,7 +39,8 @@ const _REFRESH_COOLDOWN_MSEC: int = 250 @export var base_url: String = "http://127.0.0.1:5253" @export var dev_player_id: String = "dev-local-1" -## When true, each [signal selection_event] is also printed to the Godot output (dev aid only). +## When true, each [signal selection_event] is also printed to the Godot output +## (dev aid only). @export var log_selection_events: bool = false var _http: Node @@ -65,7 +67,8 @@ var _state: Dictionary = {} ## `-_REFRESH_COOLDOWN_MSEC` so the first snap is never blocked by the window on boot. var _last_refresh_msec: int = -_REFRESH_COOLDOWN_MSEC -## Cause for the in-flight HTTP request (GET → [code]server_correction[/code]; POST → [code]tab[/code] / [code]clear[/code]). +## Cause for the in-flight HTTP request (GET → [code]server_correction[/code]; +## POST → [code]tab[/code] / [code]clear[/code]). ## Set immediately before a request starts; cleared when the response is applied or dropped. var _http_selection_cause: String = "" @@ -331,7 +334,9 @@ func _normalized_lock_id(state: Dictionary) -> Variant: return null -func _maybe_emit_selection_event(prev_state: Dictionary, new_state: Dictionary, cause: String) -> void: +func _maybe_emit_selection_event( + prev_state: Dictionary, new_state: Dictionary, cause: String +) -> void: var prev_id: Variant = _normalized_lock_id(prev_state) var next_id: Variant = _normalized_lock_id(new_state) if prev_id == next_id: