docs(street-level): shorten comments and docs, drop audit references

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/ui/panelPositionControls.js

@@ -79,9 +79,8 @@ export class PanelPositionControls {
       this._restorePanelPosition(spec.id, spec.panel);
       this._makePanelDraggable(spec.id, spec.panel, spec.handle);
     }
-    // Keep a positioned panel on-screen when its HEIGHT changes after restore — it expands to its
-    // full row set a frame or two later, so the restore-time clamp used a stale (shorter) height and
-    // the panel could still hang off the bottom (audit U2). Re-clamp on every size change.
+    // A restored panel grows a frame or two later, so the restore-time clamp
+    // is stale: re-clamp on every size change.
     if (this._ppToggles && typeof ResizeObserver !== 'undefined') {
       this._draggableResizeObserver = new ResizeObserver(() =>
         this._reclampDraggablePanels(),
@@ -159,8 +158,7 @@ export class PanelPositionControls {
       const pos = JSON.parse(raw);
       if (!pos || typeof pos.left !== 'number' || typeof pos.top !== 'number')
         return;
-      // Clamp to the viewport: a position saved at one window size would otherwise land off-screen at
-      // another (audit U2 — observed a panel at x:-192). The drag handler clamps; restore must too.
+      // A position saved at another window size can land off-screen.
       const { left, top } = this._clampToViewport(
         Math.round(pos.left),
         Math.round(pos.top),

src/ui/streetLevelControls.js

@@ -105,10 +105,8 @@ export class StreetLevelControls {
       this._setParams({ sinceDays: sinceDays() }),
     );
     this.listen(el.viewerClose, 'click', () => this.layer.closeViewer?.());
-    // EXPAND is the browser's own fullscreen: it handles Esc, focus and the
-    // rest of the page. iPhone Safari has no element fullscreen, so there the
-    // viewer opens as a top-layer popover over the page instead (Esc and the
-    // button close it). With neither, the button is not offered.
+    // EXPAND is the browser's fullscreen. iPhone Safari has no element
+    // fullscreen, so there it is a top-layer popover; with neither, no button.
     this._expandMode =
       typeof el.viewerWrap?.requestFullscreen === 'function'
         ? 'fullscreen'
@@ -195,9 +193,8 @@ export class StreetLevelControls {
 
   async _toggleEnabled() {
     const enabled = this.actions.isEnabled?.() === true;
-    // The pill is the only switch. A share link or tool can switch Mapillary
-    // off under a layer that is on; the pill then reads OFF, and switching on
-    // brings Mapillary back (and the layer, if it is off too).
+    // The pill is the only switch: it also brings back Mapillary that a link
+    // or tool switched off under a layer that is on.
     if (this._state?.providerOn === false) {
       this._setParams({ mapillary: true });
       if (enabled) return;
@@ -252,11 +249,7 @@ export class StreetLevelControls {
     this._syncExpanded();
   }
 
-  /**
-   * While expanded, leave when Clean View, recording or the cockpit starts:
-   * they hide every panel, and the photo would stay over the globe (and in a
-   * recording).
-   */
+  /** Clean View, recording and the cockpit hide every panel, so they end EXPAND too. */
   _watchPanelHidingModes(on) {
     const body = document.body;
     if (!on || !body) {