comments and descriptions

webui/src/components/TopDownMap/TopDownMapContent.jsx

@@ -1,4 +1,6 @@
-// Top-down rover telemetry visual map.
+// Top Down Map Content
+// Purpose: Defines the Top Down Map 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 React from 'react';
 import { buildSegments } from './helpers.js';
 import {

webui/src/components/TopDownMap/helpers.js

@@ -1,4 +1,6 @@
-// Geometry and color helpers for top-down rover sensor map.
+// helpers
+// Purpose: Defines the helpers 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 function clamp01(value) {
   return Math.max(0, Math.min(1, value));
 }

webui/src/components/TopDownMap/index.jsx

@@ -1,3 +1,6 @@
+// Top Down Map
+// Purpose: Defines the Top Down Map 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 TopDownMapContent from './TopDownMapContent.jsx';
 
 export default TopDownMapContent;

webui/src/components/TopDownMap/visuals.jsx

@@ -1,4 +1,6 @@
-// SVG primitives for top-down rover map rendering.
+// visuals
+// Purpose: Defines the visuals 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 { clamp01, currentColor, describeArc, lightBumpColor, cliffColor, polarToCartesian, toRad } from './helpers.js';