regressing rn

webui/src/hooks/useDefaultNickname.js

@@ -1,3 +1,5 @@
+// Hook: useDefaultNickname
+// Purpose: Computes and applies fallback nickname behavior for unauthenticated/new sessions. Scope: Wraps nickname initialization policy and side effects.
 import { useEffect, useRef } from 'react';
 import { useSettingsNamespace } from '../settings/index.js';
 import { useSessionActions } from '../context/SessionContext.jsx';

webui/src/hooks/useDockIr.js

@@ -1,3 +1,5 @@
+// Hook: useDockIr
+// Purpose: Tracks dock IR telemetry/status values for docking-related UI indicators. Scope: Converts telemetry feed updates into component-friendly reactive state.
 import { useEffect, useMemo, useState } from 'react';
 
 const HOLD_MS = 650;

webui/src/hooks/useFullscreenPrompt.js

@@ -1,3 +1,5 @@
+// Hook: useFullscreenPrompt
+// Purpose: Manages fullscreen prompt visibility and dismissal logic across screen sizes/devices. Scope: Provides reusable fullscreen UX state and action handlers.
 import { useCallback, useEffect, useMemo, useState } from 'react';
 
 const SESSION_KEY = 'fullscreenPromptDismissed';

webui/src/hooks/useHudMapSetting.js

@@ -1,3 +1,5 @@
+// Hook: useHudMapSetting
+// Purpose: Reads and persists HUD map visibility/preferences via settings namespaces. Scope: Exposes a small stateful API for map toggle interactions.
 import { useSettingsNamespace } from '../settings/index.js';
 
 export function useHudMapSetting() {

webui/src/hooks/useRoomCameraSnapshots.js

@@ -1,3 +1,5 @@
+// Hook: useRoomCameraSnapshots
+// Purpose: Subscribes to room camera snapshot updates and tracks latest image payloads. Scope: Normalizes snapshot event handling for room camera display components.
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { useSocket } from '../context/SocketContext.jsx';
 

webui/src/hooks/useRoverSnapshots.js

@@ -1,3 +1,5 @@
+// Hook: useRoverSnapshots
+// Purpose: Subscribes to rover snapshot streams and stores latest per-rover image states. Scope: Manages socket request/subscription lifecycle and data normalization.
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { useSocket } from '../context/SocketContext.jsx';
 

webui/src/hooks/useSpectatorMode.js

@@ -1,3 +1,5 @@
+// Hook: useSpectatorMode
+// Purpose: Encapsulates spectator mode detection and toggle behavior for controls/UI gating. Scope: Derives spectator-specific flags from session and route state.
 import { useEffect, useState } from 'react';
 import { useSession } from '../context/SessionContext.jsx';
 

webui/src/hooks/useUserIdentitySync.js

@@ -1,3 +1,5 @@
+// Hook: useUserIdentitySync
+// Purpose: Keeps local identity state synchronized with server session/auth updates. Scope: Handles identity hydration, change propagation, and persistence touch points.
 import { useCallback, useEffect, useRef } from 'react';
 import { useSessionActions, useSessionSelector } from '../context/SessionContext.jsx';
 import { useSocket } from '../context/SocketContext.jsx';

webui/src/hooks/useVideoRequests.js

@@ -1,3 +1,5 @@
+// Hook: useVideoRequests
+// Purpose: Coordinates client-side video stream request intents and authorization timing. Scope: Provides reusable request helpers for rover and room video consumers.
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { useSocket } from '../context/SocketContext.jsx';