docs(visualizer): fix five inaccurate comments — sub-unity restitution, uniform heat boost, progressive push-out, scroll-speed cross-ref, eight-knob bar

DeepDrftPublic.Client/Controls/MixWaveformVisualizer.razor.cs

@@ -59,7 +59,7 @@ public partial class MixWaveformVisualizer : ComponentBase, IAsyncDisposable
     // `[MixVisualizer]`, same as the JS logs so the two interleave into one timeline). These pinpoint
     // which upstream link is broken when the ribbon stays blank — set false once confirmed healthy.
     // ON for the Phase 10 reframe Wave R4 controls test (matches the JS-side DEBUG in
-    // MixVisualizer.ts). Daniel evaluates the seven-knob bar + pause behavior in-browser; flip back to
+    // MixVisualizer.ts). Daniel evaluates the eight-knob bar + pause behavior in-browser; flip back to
     // false at reframe close along with the JS flag.
     private static readonly bool Debug = true;
     private const string Tag = "[MixVisualizer]";

DeepDrftPublic.Client/Services/MixVisualizerControlState.cs

@@ -30,9 +30,10 @@ public sealed class MixVisualizerControlState
     // sweet spot (§4c).
 
     /// <summary>
-    /// Default scroll-speed dial. Mirrors <c>DEFAULT_SCROLL_SPEED</c> in MixVisualizer.ts. Normalized
-    /// [0,1] → mapped to the visible time-span via <see cref="MixZoomMapping"/> (0 = slow/wide window,
-    /// 1 = fast/tight window). Opens mid-range.
+    /// Default scroll-speed dial. Normalized [0,1] → mapped C#-side to a visible time-span in seconds
+    /// via <see cref="MixZoomMapping"/>, then sent to MixVisualizer.ts as a seconds value via
+    /// <c>setScrollSpeed</c>. The TS-side anchor is <c>DEFAULT_VISIBLE_SECONDS</c>. Opens mid-range
+    /// (0 = slow/wide window, 1 = fast/tight window).
     /// </summary>
     public const double DefaultScrollSpeed = 0.5;