docs: auto-update API reference from source code

Author: github-actions[bot]

wiki/API-Reference:-Dashboard.md

@@ -458,6 +458,47 @@ ALLPAGEWIDGETS Return concatenation of all pages' Widgets.
   Used for ReflowCallback injection and Follow toggle sweep.
   When Pages is empty, returns obj.Widgets.
 
+#### `linked = collectLinkedCrosshairs_(obj, widgets)`
+
+COLLECTLINKEDCROSSHAIRS_ Enumerate linked+rendered crosshairs on active page (260602-mri).
+  linked = collectLinkedCrosshairs_(obj, widgets) flattens widgets via
+  flattenWidgetsForPreview_ and returns a cell array of structs:
+    {struct('widget', w, 'hc', hc), ...}
+  for every flattened FastSenseWidget with CrosshairLinked=true AND a
+  valid rendered HoverCrosshair_.  Widgets failing any guard are silently
+  skipped.  PURE (no side effects) so it is unit-testable with a
+  hand-built widget list.
+  Made public (Access=public) so tests and DashboardLayout can call it.
+
+#### `rewireCrosshairLinks_(obj)`
+
+REWIRECEOSSHAIRLINKS_ Re-prime BroadcastFcn_ on active-page linked crosshairs (260602-mri).
+  1. Clear BroadcastFcn_/BroadcastLeaveFcn_ on ALL active-page FastSense
+     crosshairs (handles toggled-OFF widgets + previous-page crosshairs).
+  2. For each currently-linked+rendered crosshair, install the engine
+     broadcast callbacks.  Must be called after rerenderWidgets (fresh
+     HoverCrosshair_ handles), after switchPage, and after detachWidget.
+  Wrapped in try/catch at call sites; inner per-handle errors are silently
+  skipped so a single bad crosshair never breaks the whole sweep.
+
+#### `broadcastCrosshairX_(obj, sourceHc, xQuery)`
+
+BROADCASTCROSSHAIRX_ Mirror xQuery onto all OTHER linked crosshairs on active page (260602-mri).
+  Fired at end of source crosshair's onMove (via BroadcastFcn_).
+  Re-collects the linked set each call (cheap; active page only;
+  upstream throttle limits call rate to ~40 Hz; N widgets small).
+
+#### `broadcastCrosshairLeave_(obj, sourceHc)`
+
+BROADCASTCROSSHAIRLEAVE_ Tell all OTHER linked crosshairs to hide (260602-mri).
+  Fired at end of source crosshair's onLeave (via BroadcastLeaveFcn_).
+
+#### `onCrosshairLinkToggle(obj, widget)`
+
+ONCROSSHAIRLINKTOGGLE Called by DashboardLayout after widget.setCrosshairLink(tf) (260602-mri).
+  Re-derives the whole active-page link set from current flags — idempotent.
+  Wrapped in try/catch so a single toggle failure never crashes the bar.
+
 #### `notifyEventsChanged(obj)`
 
 NOTIFYEVENTSCHANGED Refresh all event-aware widgets after store mutation (260513-snt).
@@ -851,6 +892,24 @@ ONPLANTLOGTOGGLEPRESSED_ Toggle button callback — wraps setShowPlantLog with t
   software-level guard for Enable='off' because uicontrols only
   honor Enable natively for user-driven mouse clicks.
 
+#### `addCrosshairLinkToggle(obj, widget)`
+
+ADDCROSSHAIRLINKTOGGLE Inject crosshair-link 'X' button into WidgetButtonBar (260602-mri).
+  Duck-typed: only called for widgets where ismethod(widget,'setCrosshairLink').
+  Idempotent: removes any prior CrosshairLinkButton before creating the new one.
+  Glyph: 'X' (ASCII, Octave-safe — matches existing V/A/L/i/^ glyphs).
+  Position: leftmost chrome button, placed to the LEFT of the V/A cluster;
+  final position settled by reflowChrome_ (reflowChrome_ is called from
+  both realizeWidget and from this method for callback-driven rebuilds).
+  Active (linked) state highlighted via chooseYLimitActiveBg_ (same as V/A).
+
+#### `onCrosshairLinkTogglePressed_(obj, src, widget)`
+
+ONCROSSHAIRLINKTOGLEPRESSED_ CrosshairLink toggle callback (260602-mri).
+  Flips widget.CrosshairLinked, notifies the engine, and rebuilds the
+  button visual. All errors are caught and surfaced as namespaced
+  warnings so no toggle failure can crash the dashboard refresh loop.
+
 ### Static Methods
 
 #### `DashboardLayout.reflowChrome_(hCell, barH, inset)`
@@ -1571,6 +1630,7 @@ obj = FastSenseWidget(varargin)
 | ShowPlantLog | `false` | Phase 1032 PLOG-VIZ-03 — opt-in per-widget plant-log vertical-line overlay |
 | LiveViewMode | `'preserve'` |  |
 | YLimitMode | `'auto-visible'` |  |
+| CrosshairLinked | `false` |  |
 | CurrentXLimOverrideForTest_ | `[]` |  |
 
 ### Methods
@@ -1632,6 +1692,14 @@ SETYLIMITMODE Set the Y-axis rescale strategy and re-fit if rendered.
     'auto-all'     - rescale to all data the bound Tag exposes
     'locked'       - freeze YLim; no further rescale on tick/refresh
 
+#### `setCrosshairLink(obj, tf)`
+
+SETCROSSHAIRLINK Set the crosshair-link flag (260602-mri).
+  setCrosshairLink(obj, tf) sets CrosshairLinked to logical(tf).
+  tf must be a logical scalar or a numeric 0/1 scalar.
+  Does NOT touch graphics — the engine owns broadcast wiring.
+  Throws FastSenseWidget:invalidCrosshairLink for invalid input.
+
 #### `autoScaleY_(obj, y)`
 
 AUTOSCALEY_ Rescale the Y axis to cover current data + thresholds.

wiki/API-Reference:-FastPlot.md

@@ -1192,6 +1192,33 @@ HOVERCROSSHAIR Construct hover crosshair attached to a FastSense.
 
 ### Methods
 
+#### `setBroadcastFcn(obj, moveFn, leaveFn)`
+
+SETBROADCASTFCN Set (or clear) crosshair-link broadcast callbacks (260602-mri).
+  setBroadcastFcn(obj, moveFn, leaveFn)
+  moveFn  — @(x) callback, or [] to clear.  Called at end of onMove.
+  leaveFn — @() callback, or []. Called at end of onLeave on source.
+  nargin < 3: leaveFn defaults to [].
+
+#### `onMoveExternal(obj, xQuery)`
+
+ONMOVEEXTERNAL Mirror an external crosshair data-x without re-broadcasting.
+  Called by DashboardEngine.broadcastCrosshairX_ to drive a peer
+  crosshair at xQuery.  Sets IsMirrored_ so the peer's own
+  onFigureMove_->onLeave (fired in the same motion dispatch when
+  the cursor is not over this widget) is swallowed and the
+  mirrored crosshair stays visible. IsMirrored_ is cleared either
+  when this widget becomes the hover source (its own real onMove)
+  or by onLeaveExternal (the source's leave-broadcast).
+
+#### `onLeaveExternal(obj)`
+
+ONLEAVEEXTERNAL Clear mirror state and hide crosshair on command.
+  Called by DashboardEngine.broadcastCrosshairLeave_ when the
+  source crosshair's own onLeave fires (cursor left all linked axes).
+  Hides DIRECTLY (does NOT call onLeave) so it never re-broadcasts
+  leave — that would ping-pong between linked peers indefinitely.
+
 #### `onMove(obj, xQuery)`
 
 ONMOVE Update + show the crosshair at data x-coordinate xQuery.
@@ -1202,6 +1229,11 @@ ONMOVE Update + show the crosshair at data x-coordinate xQuery.
 
 ONLEAVE Hide the crosshair line + datatip.
 
+#### `hideGraphics_(obj)`
+
+HIDEGRAPHICS_ Hide the crosshair line + datatip (no broadcast).
+  Shared by onLeave (source path) and onLeaveExternal (peer path).
+
 ---
 
 ## `NavigatorOverlay` --- Zoom rectangle, dimming, and drag interaction on navigator axes.