comments and descriptions

webui/src/components/VideoTile/HudChatInput.jsx

@@ -1,4 +1,6 @@
-// Inline HUD chat input for driver speech messages.
+// Hud Chat Input
+// Purpose: Defines the Hud Chat Input module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import { useMemo, useState } from 'react';
 import { useChat } from '../../context/ChatContext.jsx';
 import { useSessionSelector } from '../../context/SessionContext.jsx';

webui/src/components/VideoTile/HudOverlay.jsx

@@ -1,4 +1,6 @@
-// Telemetry HUD and map overlay for VideoTile.
+// Hud Overlay
+// Purpose: Defines the Hud Overlay module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import React from 'react';
 import TopDownMap from '../TopDownMap/index.jsx';
 import { roverNameChromeStyle } from '../../lib/roverColor.js';

webui/src/components/VideoTile/LightBumpBars.jsx

@@ -1,4 +1,6 @@
-// Light bump signal bars used under the tile HUD.
+// Light Bump Bars
+// Purpose: Defines the Light Bump Bars module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import React from 'react';
 
 export default function LightBumpBars({ sensors }) {

webui/src/components/VideoTile/LowBatteryOverlay.jsx

@@ -1,4 +1,6 @@
-// Low battery warning overlay.
+// Low Battery Overlay
+// Purpose: Defines the Low Battery Overlay module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import React from 'react';
 
 export default function LowBatteryOverlay({ battery, compact = false }) {

webui/src/components/VideoTile/OvercurrentOverlay.jsx

@@ -1,4 +1,6 @@
-// Overcurrent warning overlay.
+// Overcurrent Overlay
+// Purpose: Defines the Overcurrent Overlay module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import React from 'react';
 import { OVERCURRENT_LABELS } from './constants.js';
 

webui/src/components/VideoTile/TurnCueOverlay.jsx

@@ -1,4 +1,6 @@
-// Turn cue overlay shown to active drivers.
+// Turn Cue Overlay
+// Purpose: Defines the Turn Cue Overlay module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import React from 'react';
 
 export default function TurnCueOverlay({

webui/src/components/VideoTile/constants.js

@@ -1,4 +1,6 @@
-// VideoTile timing and threshold constants.
+// constants
+// Purpose: Defines the constants module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 export const RESTART_DELAY_MS = 2000;
 export const UNMUTE_RETRY_MS = 3000;
 export const AUDIO_RETRY_MS = 3000;

webui/src/components/VideoTile/index.jsx

@@ -1,3 +1,6 @@
+// Video Tile
+// Purpose: Defines the Video Tile module and the local helpers/components used in this file.
+// Scope: Keeps behavior unchanged while isolating this concern into a clear, single-responsibility unit.
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { WhepPlayer } from '../../lib/whepPlayer.js';
 import { useHudMapSetting } from '../../hooks/useHudMapSetting.js';