Class ComparisonController

Put an instrument on the chart alongside the primary series.

Shared baseline timestamp, or null for no overlap, no visible sources, or independent baselines. Asks about the price pane unless a slot is named.

Take them all off, putting every pane back the way it was found.

Remove every comparison and forget the chart.

Every comparison on the chart, in the order they were added.

Re-project onto the primary's current bars. Chart handles data replacement and replay automatically. A structural host without data events or primary history identity can call this after replacing its timestamps.

Take one instrument off. Returns false if it was already gone.

Select a shared timestamp without changing the instruments' stored price units.

Change the mode the panes are held in while comparisons are on them. Panes that already have one switch immediately.

Bring the overlay scales in line with the primary axis, re-aligning first if the shared time axis has moved under us (a live bar, history paged in, a replay step). Runs once per base paint through the per-pane hook.

Re-aligning here writes series data mid-frame, which is safe because the hook is a bottom primitive: it runs after the pane has autoscaled and before any series is drawn, so the frame that notices the change is also the frame that draws it. The repaint that write asks for lands on the next frame, or re-enters this one on a host that runs frames synchronously, which is what realign's guard is for.