The <tableau-viz> element. It must already be in the document,
and it is never moved, restyled or otherwise modified.
Figure id and title, the include-list, per-worksheet overrides, and the live-update opt-in.
A binding, or null when there was nothing to mount — a detached
element, a viz that failed to load or never became interactive, a story
sheet, an empty include-list, or worksheets that yielded no navigable layer.
In every null case the page is left exactly as it was found, with one
warning explaining why. It always settles: a viz that never loads resolves to
null rather than leaving the caller waiting.
Mount MAIDR beside an embedded Tableau view and keep it in step with it.
Waits for the viz to become interactive, reads every worksheet on the active sheet, builds one MAIDR subplot per worksheet, and renders the accessible figure into a wrapper inserted immediately before the
<tableau-viz>element. Filter, parameter, data and tab changes re-discover and re-read the worksheets and re-render; MAIDR's cursor is mirrored back into the viz as a Tableau mark selection, which is cleared again when focus leaves the figure.Asynchronous because the first read is: whether any worksheet yields a navigable layer is a property of the data, not of the DOM, and a binder that returned before finding out could only report failure by mounting an empty figure.