Scatter Chart

• series[].points holds { x, y, r? }. A point with a non-finite x, y or r is dropped.
• Both axes are independent numeric domains computed from the data extent. Zero is not forced, and hiding a series keeps the scale.
• The identity of a series is id ?? name. Two series or slices sharing an identity get distinct keys (a, a#1, ...), and in development mode the chart logs one warning for a duplicate explicit id and for a data array whose length differs from categories.
• A flat domain (every value equal) is expanded so the axis never collapses, and ticks are rounded to the precision their step needs.
• series[].color or slices[].color is optional; without it the marks use a round-robin over the eight --kui-chart-series-1..8 tokens in the order given.

• Hiding a series does not recompute the value-axis domain, so the remaining series keep a stable scale across toggles.
• Hovering a legend item highlights the matching mark, and hovering a mark highlights its legend entry. Hidden items stay interactive; "every series hidden" is a legend-only state and not the empty composition.
• A hidden item is marked by more than its pressed state: the label is struck through and the swatch becomes an outline.

Standalone legend

Every chart implements KuiChartLegendSource: a public legendItems() and hoveredLegendId() read surface plus toggleLegendItem(id) and setHoveredLegendId(id). Pass the chart through a template reference variable to kui-chart-legend to render the legend anywhere, and set [legend]="false" on the chart so it is not drawn twice. Project a kuiChartLegendItem template (context KuiChartLegendItemContext: $implicit is the KuiChartLegendEntry, hovered the cross-highlight state) to replace the default button markup; wiring the toggle and hover calls is the template's job.

<kui-line-chart
  #chartRef
  ariaLabel="Sessions per day"
  [series]="series"
  [categories]="categories"
  [legend]="false"
/>
<kui-chart-legend [chart]="chartRef" />

• size is sm, md or lg (default md): a plot height of 200, 280 or 360px.
• The chart measures its container with a ResizeObserver and draws at one user unit per CSS pixel, so text, strokes and marks keep their pixel size at any width. The axis padding fits the widest measured tick label and the axis title.
• Server rendering and the first client render use a nominal width (320, 480 or 640px) inside a graphic whose height is already final, so hydration does not shift the layout.
• Tick labels are thinned by their measured width plus an 8px gap so they never overlap, and a label wider than its slot is cut with an ellipsis (the full text stays in the element <title>). Axis text defaults to --kui-text-sm-size; the --kui-chart-axis-text-font-size token changes it.
• Axis titles come from axes.xTitle and axes.yTitle and are drawn in the SVG. There is no built-in zoom, pan or decimation: aggregate very dense data before passing it in.

• The scatter skeleton is a loose cluster of shimmering dots built from [kuiSkeleton].
• An empty or missing input (no non-gap value anywhere) always renders the empty composition: a dashed border, a faded chart icon and the "No data" text. It is not the kui-empty-state component.
• The loading and empty texts are chart messages.

protected formatTooltip(point: KuiChartPoint): string {
  return `${point.categoryLabel}: $${point.value.toLocaleString('en-US')}`;
}

• tooltip overrides the default text: <series>: (<x>, <y>), with the radius added for bubbles.
• valueFormat defaults to the compact notation of the locale (1.2K and 3.4M in English, 1,5 Mio. in German). It formats axis ticks and the default tooltip and legend numbers, and is never used for the alt-table, which shows exact values.
• The tooltip is dismissible (Escape closes it without moving focus or the pointer until a new trigger) and persistent (it stays until hover or focus ends). It follows the pointer and ignores pointer events, so it is not hoverable (WCAG 1.4.13); see Known gaps.
• Accessible names, role descriptions, the loading and empty texts, the table headers and the point text are chart messages. Every chart takes a messages input for one-off overrides.

• The alt-table is the accessible-charts recommendation of pairing a graphic with a tabular alternative, not a decorative duplicate. It lists the visible series with exact (not compact-formatted) numbers and has a caption with the chart name.
• It lists every point of a dense chart whatever the chart draws.
• The Table button keeps keyboard focus when the view switches.
• The columns are Series, X and Y (plus R when bubble is on), not category-keyed rows.

• With more than one series, marks use a marker shape per series index (circle, square, diamond, up and down triangle, cross, plus, star) and the legend swatch shows the same shape. A single series stays circles, and hiding another series never changes the shape.
• In forced colours (Windows High Contrast) the chart draws with the system colours CanvasText, Canvas, GrayText and Highlight only. Series then differ by hatch pattern, by dash (lines) and by marker shape; patterns and dashes turn on automatically.

• Points are ordered by x within a series. ArrowLeft and ArrowRight move along the series, ArrowUp and ArrowDown move between series, and Home and End jump to the first and last point of the series.
• Escape dismisses the tooltip; Enter and Space on a legend item toggle it.
• The roving position is a key (series and category), not an index, so hiding a series moves it to the nearest remaining mark and re-focuses that mark if focus was inside the chart. Focus mirrors hover: the focused mark highlights its series and opens the tooltip.

• Scatter charts draw every shape. The practical limit is a few thousand shapes; above that, aggregate before passing the data in.
• Library measurements in Chromium (a two-series line chart and a one-series scatter chart of the same point count): 500 points paint in 46 ms with 1,629 DOM nodes, 2,000 points in 115 ms with 6,123 nodes and 5,000 points in 259 ms with 15,123 nodes. Hiding a series on the 2,000-point line chart paints in 27 ms. Decimation is out of scope.