NEO-26: wrap GDScript doc lines for gdlint max-line-length

pull/51/head
VinPropane 2026-04-25 19:43:14 -04:00
parent 1882476fd3
commit 42d0025457
1 changed files with 12 additions and 7 deletions

View File

@ -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: