comments and descriptions

webui/src/mini/MiniSummaryApp/MiniSummaryAppRoot.jsx

@@ -1,4 +1,6 @@
-// Top-level mini summary app shell with hard-refresh timer and alerts.
+// Mini Summary App Root
+// Purpose: Defines the Mini Summary App Root 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 { useEffect } from 'react';
 import AlertFeed from '../../components/AlertFeed/index.jsx';
 import MiniSummaryContent from './MiniSummaryContent.jsx';

webui/src/mini/MiniSummaryApp/MiniSummaryContent.jsx

@@ -1,4 +1,6 @@
-// Main mini summary screen composition and rotation logic.
+// Mini Summary Content
+// Purpose: Defines the Mini Summary Content 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 { useEffect, useMemo, useState } from 'react';
 import { useSession } from '../../context/SessionContext.jsx';
 import { useTelemetryFrames } from '../../context/TelemetryContext.jsx';

webui/src/mini/MiniSummaryApp/components/AutoFitText.jsx

@@ -1,4 +1,6 @@
-// Auto-fitting single-line text component for mini summary layout.
+// Auto Fit Text
+// Purpose: Defines the Auto Fit Text 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 { useLayoutEffect, useRef, useState } from 'react';
 
 export default function AutoFitText({ children, className = '', maxSize = 1000, minSize = 14, style = undefined }) {

webui/src/mini/MiniSummaryApp/components/FitViewportFrame.jsx

@@ -1,4 +1,6 @@
-// 4:3 viewport fitting frame for active mini-summary video.
+// Fit Viewport Frame
+// Purpose: Defines the Fit Viewport Frame 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 default function FitViewportFrame({ children }) {
   return (
     <div className="flex h-full w-full items-center justify-start overflow-hidden bg-black">

webui/src/mini/MiniSummaryApp/components/InfoColumn.jsx

@@ -1,4 +1,6 @@
-// Rover information and optional preview column for mini summary UI.
+// Info Column
+// Purpose: Defines the Info Column 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 VideoTile from '../../../components/VideoTile/index.jsx';
 import BatteryBar from '../../../components/BatteryBar/index.jsx';
 import { roverNameChromeStyle } from '../../../lib/roverColor.js';

webui/src/mini/MiniSummaryApp/constants.js

@@ -1,3 +1,5 @@
-// Mini summary app timing 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 ROTATE_MS = 20000;
 export const HARD_REFRESH_MS = 1 * 60 * 60 * 1000;

webui/src/mini/MiniSummaryApp/utils.js

@@ -1,4 +1,6 @@
-// Mini summary app session/telemetry formatting utilities.
+// utils
+// Purpose: Defines the utils 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 { buildBatteryVisual } from '../../lib/battery.js';
 
 export function formatDriverLabel({ roverId, session }) {