@umriss-ui/charts 0.16.0 → 0.35.0

package/docs/llms-full.md

@@ -1,4 +1,4 @@
-# @umriss-ui/charts 0.16.0
+# @umriss-ui/charts 0.35.0
 
 > React canvas chart library for data-dense dashboards - line, area, bar, box plot, scatter, control and Pareto charts. Few chart kinds, drawn well, fast.
 
@@ -1057,7 +1057,7 @@ npm install @umriss-ui/charts
 
 Demo page: https://romanhaendler.github.io/umriss-ui/charts/installation/
 
-The command installs the package alone: React 18 or 19 is its only peer and stays the application's own, and the package depends on nothing else. The stylesheet comes with the JavaScript, so there is nothing to import - `@umriss-ui/charts/styles.css` is there for setups that link stylesheets by hand. Its colours, type and sizes are `--uc-` tokens that fall back onto core's; [core's Theming page](https://romanhaendler.github.io/umriss-ui/core/theming/#charts-tokens) lists them all.
+The command installs the package alone: React 19 or newer is its only peer and stays the application's own, and the package depends on nothing else. The stylesheet comes with the JavaScript, so there is nothing to import - `@umriss-ui/charts/styles.css` is there for setups that link stylesheets by hand. Its colours, type and sizes are `--uc-` tokens that fall back onto core's; [core's Theming page](https://romanhaendler.github.io/umriss-ui/core/theming/#charts-tokens) lists them all.
 
 A chart takes its container's width and follows it; give it a `height` (300 px without one). `useChart(rows)` hands out `Chart`, its axes and its series, typed at the row; each reads its value from a row through `value`, a field name or a function - a value that is `null`, `undefined` or not finite is a gap, never a zero.
 
@@ -1407,11 +1407,10 @@ export default function Empty() {
 
 ##### Read it by keyboard and screen reader
 
-A chart with a `Tooltip` is one tab stop: the keys walk its values, and a screen reader hears them; `wording` gives the German words.
+A chart with a `Tooltip` is one tab stop: the keys walk its values, and a screen reader hears them; `wording` gives the German words, numbers and times.
 
 ```tsx
-import { useState } from "react";
-import { Tooltip, useChart, type ChartView } from "@umriss-ui/charts";
+import { Tooltip, useChart, type ChartParts } from "@umriss-ui/charts";
 import { GERMAN_CHARTS_WORDING } from "@umriss-ui/charts/wording/de";
 
 /* Data from the operations world, written out here so the example runs on its own. */
@@ -1513,10 +1512,9 @@ function week(serviceId: string, step: number): MetricPoint[] {
 const SEARCH_WEEK = week("search", 5 * 60_000);
 
 export default function KeyboardAndScreenReader() {
-  // The two charts zoom together: each hands the other what it reports.
-  const [view, setView] = useState<ChartView>({});
-  const english = useChart(SEARCH_WEEK, { initialView: view, onViewChange: setView });
-  const german = useChart(SEARCH_WEEK, { initialView: view, onViewChange: setView });
+  // The two charts zoom together: each sends the other what the reader did to it.
+  const english: ChartParts<MetricPoint> = useChart(SEARCH_WEEK, { onViewChange: (v) => german.setView(v) });
+  const german: ChartParts<MetricPoint> = useChart(SEARCH_WEEK, { onViewChange: (v) => english.setView(v) });
   const { Chart, XAxis, YAxis, Line } = english;
   const { Chart: Diagramm } = german;
   return (
@@ -2184,9 +2182,9 @@ Under forced colours the chart draws in the system colours and tells its series
 | `padding` | `number \| Partial<`[`Padding`](#type-Padding)`>` | — | Outer spacing of the plot area in CSS pixels.<br>Shown in: [Fix the domain and name the ticks (Axis)](#/axis/configuration) |
 | `empty` | `ReactNode` | the wording's `empty` | Shown in the middle of the plot area when no visible series has a point to show - no data, only gaps, or every series hidden. Axes and frame stay. Not while `loading`.<br>Shown in: [Say there is nothing to show](#/chart/empty) |
 | `loading` | `boolean` | `false` | The rows are on their way, as the table's `loading` says ([ADR-0042](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0042-a-rows-height-never-follows-what-it-shows.md)). A course already drawn stays: it dims after a moment and takes no pointer until the answer is in. Where there is nothing to show, the empty message waits. The plot is `aria-busy` meanwhile.<br>Shown in: [Show that rows are on their way](#/chart/loading) |
-| `wording` | `Partial<`[`ChartsWording`](#type-ChartsWording)`>` | `DEFAULT_CHARTS_WORDING` | The chart's words ([ADR-0031](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0031-the-charts-carry-their-own-wording.md)); entries left out fall back to English. German: `GERMAN_CHARTS_WORDING` from `@umriss-ui/charts/wording/de`.<br>Shown in: [Read it by keyboard and screen reader](#/chart/keyboard-and-screen-reader) |
+| `wording` | `Partial<`[`ChartsWording`](#type-ChartsWording)`>` | `DEFAULT_CHARTS_WORDING` | The chart's words ([ADR-0031](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0031-the-charts-carry-their-own-wording.md)); entries left out fall back to English. Its `locale` also formats every number and every date or time label the chart makes itself (`en-GB`, `de-DE`; the browser's language is not read) - a `tickFormat` or `format` of your own stays in charge of its axis or series. German: `GERMAN_CHARTS_WORDING` from `@umriss-ui/charts/wording/de`.<br>Shown in: [Read it by keyboard and screen reader](#/chart/keyboard-and-screen-reader) |
 | `encoding` | `"color" \| "marks"` | `"color"` | How series are told apart. `"color"`: by their colour. `"marks"`: by a dash and a marker shape as well - a line, an area and a scatter -, and by a hatch - a bar, a state, a matrix cell, a limit band -, chosen by the same palette place as the colour, so that a reader who does not see the colours still tells them apart; the legend's chips show the same. A caller's own `dash` wins over the place's.<br>Shown in: [Tell series apart without colour](#/chart/told-apart-without-colour), [Mark every kind](#/chart/marks-on-every-kind), [Mark bands, limits and cells](#/chart/bands-limits-and-cells) |
-| `syncId` | `string` | — | Charts with the same id share the pointer's x position, in domain units: each draws its crosshair there, the tooltip stays with the chart under the pointer. Zoom is not shared this way: charts zoom together by handing each other their view (`useChart`'s `initialView` and `onViewChange`).<br>Shown in: [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Watch latency against its objective (Scenarios)](#/scenarios/watch-latency-against-its-objective), [Hold the tile length in control (Scenarios)](#/scenarios/hold-the-tile-length-in-control) |
+| `syncId` | `string` | — | Charts with the same id share the pointer's x position, in domain units: each draws its crosshair there, the tooltip stays with the chart under the pointer. Zoom is not shared this way: charts zoom together by sending each other their view (`useChart`'s `onViewChange` and `setView`).<br>Shown in: [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Watch latency against its objective (Scenarios)](#/scenarios/watch-latency-against-its-objective), [Hold the tile length in control (Scenarios)](#/scenarios/hold-the-tile-length-in-control) |
 | `children` | `ReactNode` | — | The axes, series and companions of this chart. They draw nothing themselves: each registers its configuration and the scene draws it, and the order in the JSX is the drawing order.<br>Shown in: [Mix series kinds](#/chart/mixed), [Say there is nothing to show](#/chart/empty), [Read it by keyboard and screen reader](#/chart/keyboard-and-screen-reader) and 74 more |
 
 ###### Events
@@ -2227,6 +2225,7 @@ Everything the charts put out as text.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
+| `locale` *required* | `string` | — | The BCP 47 tag every number and every date or time label of the chart is formatted in (`en-GB`, `de-DE`). The one input for the locale: the browser's language is not read. The clock stays 24-hour in both. |
 | `roleDescription` *required* | `string` | — | What a screen reader calls the plot area that takes the keys (`aria-roledescription`). |
 | `empty` *required* | `string` | — | Shown in the plot area when no visible series has a point to show. |
 | `seriesList` *required* | `(names: readonly string[]) => string` | — | The summary's visible series, by name. |
@@ -2234,15 +2233,15 @@ Everything the charts put out as text.
 | `seriesExtent` *required* | `(name: string, min: string, max: string) => string` | — | The summary's lowest and highest value of one series in that stretch. |
 | `limitList` *required* | `(limits: readonly { name: string; value: string }[]) => string` | — | The summary's labelled limits, each with its value in its axis' format (a band's two edges as one value). |
 | `readout` *required* | `(x: string, rows: readonly { name: string; value: string; x: string }[]) => string` | — | What is read after a key: the position, then each series with its value (and its own x where it stands on another x axis), the emphasised one first. |
-| `stackTotal` *required* | `string` | — | The last row of a stack in the tooltip and the readout: the sum of its members at the point (charts-stacking K4). |
-| `percent` *required* | `(value: string) => string` | — | A share in a normalised stack, its number already formatted (K5). |
+| `stackTotal` *required* | `string` | — | The last row of a stack in the tooltip and the readout: the sum of its members at the point. |
+| `percent` *required* | `(value: string) => string` | — | A share in a normalised stack, its number already formatted. |
 | `walkHelp` *required* | `string` | — | The keys that walk the chart. |
 | `selectHelp` *required* | `string` | — | The key that reports the Active point - only where `onSelect` is given. |
 | `zoomHelp` *required* | `string` | — | The keys that zoom and pan it - only where the chart can be zoomed. |
 | `legendHelp` *required* | `string` | — | The keys of the legend's entries - only where it has one to press. |
 | `allShown` *required* | `string` | — | Read out where hiding would leave nothing to see, and every series is shown instead. |
 | `showAll` *required* | `string` | — | The control over a zoomed plot that brings every zoomed axis back to its own domain (component-view 04). |
-| `showData` *required* | `string` | — | The data table's disclosure key, closed and open (charts-alternatives C1). |
+| `showData` *required* | `string` | — | The data table's disclosure key, closed and open. |
 | `hideData` *required* | `string` | — |  |
 | `positionColumn` *required* | `string` | — | The heading of the table's x column where its axis has no `label`, and of a matrix' row column where its y axis has none. |
 | `rowColumn` *required* | `string` | — |  |
@@ -2257,7 +2256,7 @@ Everything the charts put out as text.
 | `notch` *required* | `string` | — |  |
 | `count` *required* | `string` | — |  |
 | `outlierList` *required* | `(values: readonly string[], more: number) => string` | — |  |
-| `downsampled` *required* | `(readings: number) => string` | — | Added to the caption where the table shows the downsampled course (C2): how many readings its rows stand for. |
+| `downsampled` *required* | `(readings: number) => string` | — | Added to the caption where the table shows the downsampled course: how many readings its rows stand for. |
 
 ###### `ChartPerf`
 
@@ -2949,11 +2948,11 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 | Prop | Type | Default | Description |
 |---|---|---|---|
 | `value` *required* | [`AxisField`](#type-AxisField)`<T> \| ((d: T, index: number) => `[`AxisValue`](#type-AxisValue)`)` | — | Where a row lies on this axis: a field of the row, compared by its name, or a function of it, compared by its source text as a series' is (`ValueFunction`) - with the same closure limit. A number is a position, a `Date` an instant, a string a category: every distinct one gets a place of its own, in the order the rows bring them, a tick and its name as the label ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). The type decides, never the content - `"2024"` is a category, `2024` a number - and a row without a value has no place. The axis reads the rows of every series bound to it; where those bring their own `data`, name their row: `<XAxis<HourCount> value="hour" />`.<br>Shown in: [Fix the domain and name the ticks](#/axis/configuration), [Add axes for other magnitudes](#/axis/axes), [Leave out the hours nobody works](#/axis/working-time) and 74 more |
-| `domain` | `"nice" \| "data" \| readonly [number, number] \| readonly [Date, Date]` | `"nice"` | `"nice"` widens the data's extent to ticks - to named `ticks` where there are any, on a time axis to whole units of a step of hours or longer -, `"data"` keeps it, a pair is fixed: numbers, on a time axis milliseconds or two `Date`s, on a category axis places. On a `zoomable` axis it is the start: what the axis shows while the chart's view names no span for it.<br>Shown in: [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Gestures and keys (Zoom and pan)](#/zoom-and-pan/gestures-and-keys) and 10 more |
+| `domain` | `"nice" \| "data" \| readonly [number, number] \| readonly [Date, Date]` | `"nice"` | `"nice"` widens the data's extent to ticks - to named `ticks` where there are any, on a time axis to whole units of a step of hours or longer -, `"data"` keeps it, a pair is fixed: numbers, on a time axis milliseconds or two `Date`s, on a category axis places. On a `zoomable` axis it is the start: what the axis shows while the chart's view names no span for it.<br>Shown in: [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Gestures and keys (Zoom and pan)](#/zoom-and-pan/gestures-and-keys) and 11 more |
 | `position` | `"bottom" \| "top"` | `"bottom"` | Which edge the axis stands at. A second x axis on the opposite edge is how a series counts in a unit of its own.<br>Shown in: [Add axes for other magnitudes](#/axis/axes), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis) |
 | `time` | `boolean` | — | The values are instants: milliseconds since the epoch, or with `time` said ISO 8601 strings as an API sends them, read by the platform's rule - a date with a time and no offset is local time, a date alone is UTC; a string that is none is not drawn. Rows that hold a `Date` put the axis in time without `time`. Ticks on local boundaries from the minute to the month, labels by level in en-GB with a 24-hour clock - `15:00`, `17 Mar`, `Mar 2026` - and the date on the first tick and on the first of a new day (`17 Mar 00:00`); a day tick there carries the year. The tooltip's x value carries the seconds where the readings lie less than a minute apart. Another language is a `tickFormat`, which is handed the instant in milliseconds. `calendar` implies it.<br>Shown in: [Align a second axis to the grid](#/axis/aligned-ticks), [Draw a first chart (Installation)](#/installation/first-chart), [Size a chart by its container (Installation)](#/installation/in-its-container) and 36 more |
 | `calendar` | `readonly `[`WorkingInterval`](#type-WorkingInterval)`[]` | — | Working calendar: the intervals in which time counts. With it the axis stands in working time - nights and weekends are out, and every removed span gets a break mark. The scale stays affine; the mapping happens in materialisation ([ADR-0001](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0001-affine-scale-contract.md)).<br>Shown in: [Leave out the hours nobody works](#/axis/working-time) |
-| `zoomable` | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setDomain`). The plain wheel always scrolls the page.<br>Shown in: [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Gestures and keys (Zoom and pan)](#/zoom-and-pan/gestures-and-keys), [Limit the zoom (Zoom and pan)](#/zoom-and-pan/zoom-limits) and 5 more |
+| `zoomable` | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setView`, `setDomain`). The plain wheel always scrolls the page.<br>Shown in: [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Gestures and keys (Zoom and pan)](#/zoom-and-pan/gestures-and-keys), [Limit the zoom (Zoom and pan)](#/zoom-and-pan/zoom-limits) and 6 more |
 | `zoomLimits` | [`ZoomLimits`](#type-ZoomLimits) | at most the data's extent or this axis' own `domain`, whichever is wider, at least three data steps | The narrowest and the widest span zoom may reach, in the axis' units - milliseconds on a time axis.<br>Shown in: [Limit the zoom (Zoom and pan)](#/zoom-and-pan/zoom-limits) |
 | `id` | `string` | `"x"` | Axis id, through which series bind themselves.<br>Shown in: [Add axes for other magnitudes](#/axis/axes), [Align a second axis to the grid](#/axis/aligned-ticks), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis) and 7 more |
 | `label` | `string` | — | Axis title.<br>Shown in: [Fix the domain and name the ticks](#/axis/configuration), [Add axes for other magnitudes](#/axis/axes), [Leave out the hours nobody works](#/axis/working-time) and 66 more |
@@ -2968,7 +2967,7 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `domain` | `"nice" \| "data" \| "visible" \| readonly [number, number]` | `"nice"` | As on the x axis, and `"visible"`: what the series show inside their x axis' domain - a zoomed hour gets the hour's range, not the week's -, widened to ticks as `"nice"` is. Where the x domain is not fixed that is every point.<br>Shown in: [Fix the domain and name the ticks](#/axis/configuration), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 10 more |
+| `domain` | `"nice" \| "data" \| "visible" \| readonly [number, number]` | `"nice"` | As on the x axis, and `"visible"`: what the series show inside their x axis' domain - a zoomed hour gets the hour's range, not the week's -, widened to ticks as `"nice"` is. Where the x domain is not fixed that is every point.<br>Shown in: [Fix the domain and name the ticks](#/axis/configuration), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 11 more |
 | `alignTicks` | `boolean` | — | On a further y axis: take the first y axis' tick count and widen this axis' domain until its ticks fall on that one's grid lines, the steps still 1-2-5 - one grid serves both. `tickCount` then does not apply; on the first y axis it changes nothing.<br>Shown in: [Align a second axis to the grid](#/axis/aligned-ticks) |
 | `position` | `"left" \| "right"` | `"left"` | Which edge the axis stands at. Several y axes per side are stacked outwards, so that extents of clearly different magnitude stay readable.<br>Shown in: [Add axes for other magnitudes](#/axis/axes), [Align a second axis to the grid](#/axis/aligned-ticks), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis) and 7 more |
 | `id` | `string` | `"y"` | Axis id, through which series bind themselves.<br>Shown in: [Add axes for other magnitudes](#/axis/axes), [Align a second axis to the grid](#/axis/aligned-ticks), [Bind every kind of series to a second axis](#/axis/every-kind-on-a-second-axis) and 7 more |
@@ -3046,11 +3045,11 @@ import { useChart } from "@umriss-ui/charts";
 
 Demo page: https://romanhaendler.github.io/umriss-ui/charts/zoom-and-pan/
 
-`zoomable` on an x axis turns the gestures and keys on; nothing else is needed. The span shown is part of the chart's view ([ADR-0047](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0047-a-component-holds-its-own-view.md)): `useChart(rows, { initialView, onViewChange })` takes a start and reports every change, whole, at most once per frame; `domains` and `setDomain(axisId, span | null)` stand on what the hook returns. A lone x axis is `"x"`.
+`zoomable` on an x axis turns the gestures and keys on; nothing else is needed. The span shown is part of the chart's view ([ADR-0047](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0047-a-component-holds-its-own-view.md)): `useChart(rows, { initialView, onViewChange })` takes a start and reports what the reader does, whole, at most once per frame; `setView(view)`, `domains` and `setDomain(axisId, span | null)` stand on what the hook returns. A lone x axis is `"x"`.
 
 Once an axis is zoomed, the chart offers 'Show all' over a corner of its plot - a button of its own, a tab stop beside the plot's, that brings every zoomed axis back and goes. Its words are the wording's `showAll`.
 
-Charts stay in step by handing each other what they report: one `useState` for the view, its value as every chart's `initialView` and its setter as every `onViewChange`. A view equal to the one a chart reported itself changes nothing, so a pan does not jump back. `syncId` shares only the pointer.
+Charts stay in step by sending each other what the reader did: each chart's `onViewChange` calls the other's `setView`. `setView` is not reported, so two charts linked both ways do not answer each other, and a pan does not jump back. `syncId` shares only the pointer.
 
 A zoom stops at `zoomLimits`; without them at three readings and at the data's extent. A y axis with `domain="visible"` follows the stretch shown.
 
@@ -3419,10 +3418,10 @@ export default function VisibleDomain() {
 
 ##### Keep charts in step
 
-Charts with one `syncId` share the pointer; hand them one view through `initialView` and `onViewChange`, and a zoom in any of them zooms all.
+Charts with one `syncId` share the pointer; send each one's `onViewChange` to the others' `setView`, and a zoom in any of them zooms all.
 
 ```tsx
-import { useState } from "react";
+import { useEffect, useState } from "react";
 import { Tooltip, useChart, type ChartView } from "@umriss-ui/charts";
 
 /* Data from the operations world, written out here so the example runs on its own. */
@@ -3530,21 +3529,29 @@ const CHANNELS = [
 ] as const;
 
 export default function CursorSync() {
-  // The view the three share: each hands it what it reports.
-  const [view, setView] = useState<ChartView>({});
+  // The three share a view: each sends the others what the reader did to it.
+  const [peers] = useState(() => new Map<string, (view: ChartView) => void>());
   return (
     <div>
       {/* Each plot begins where its y axis ends: labels of one width - three
           figures here - keep the crosshairs in one column. */}
       {CHANNELS.map((c) => (
-        <Channel key={c.name} channel={c} view={view} onViewChange={setView} />
+        <Channel key={c.name} channel={c} peers={peers} />
       ))}
     </div>
   );
 }
 
-function Channel({ channel: c, view, onViewChange }: { channel: (typeof CHANNELS)[number]; view: ChartView; onViewChange: (view: ChartView) => void }) {
-  const { Chart, XAxis, YAxis, Line } = useChart(IMAGES_WEEK, { initialView: view, onViewChange });
+function Channel({ channel: c, peers }: { channel: (typeof CHANNELS)[number]; peers: Map<string, (view: ChartView) => void> }) {
+  const { Chart, XAxis, YAxis, Line, setView } = useChart(IMAGES_WEEK, {
+    onViewChange: (view) => {
+      for (const [name, goTo] of peers) if (name !== c.name) goTo(view);
+    },
+  });
+  useEffect(() => {
+    peers.set(c.name, setView);
+    return () => void peers.delete(c.name);
+  }, [peers, c.name, setView]);
   return (
     <Chart height={140} syncId="images" ariaLabel={`Image service ${c.name} over last week`}>
       <XAxis value="t" time domain="data" zoomable />
@@ -3567,11 +3574,11 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 | Prop | Type | Default | Description |
 |---|---|---|---|
 | `value` *required* | [`AxisField`](#type-AxisField)`<T> \| ((d: T, index: number) => `[`AxisValue`](#type-AxisValue)`)` | — | Where a row lies on this axis: a field of the row, compared by its name, or a function of it, compared by its source text as a series' is (`ValueFunction`) - with the same closure limit. A number is a position, a `Date` an instant, a string a category: every distinct one gets a place of its own, in the order the rows bring them, a tick and its name as the label ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). The type decides, never the content - `"2024"` is a category, `2024` a number - and a row without a value has no place. The axis reads the rows of every series bound to it; where those bring their own `data`, name their row: `<XAxis<HourCount> value="hour" />`.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 74 more |
-| `domain` | `"nice" \| "data" \| readonly [number, number] \| readonly [Date, Date]` | `"nice"` | `"nice"` widens the data's extent to ticks - to named `ticks` where there are any, on a time axis to whole units of a step of hours or longer -, `"data"` keeps it, a pair is fixed: numbers, on a time axis milliseconds or two `Date`s, on a category axis places. On a `zoomable` axis it is the start: what the axis shows while the chart's view names no span for it.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 10 more |
+| `domain` | `"nice" \| "data" \| readonly [number, number] \| readonly [Date, Date]` | `"nice"` | `"nice"` widens the data's extent to ticks - to named `ticks` where there are any, on a time axis to whole units of a step of hours or longer -, `"data"` keeps it, a pair is fixed: numbers, on a time axis milliseconds or two `Date`s, on a category axis places. On a `zoomable` axis it is the start: what the axis shows while the chart's view names no span for it.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 11 more |
 | `position` | `"bottom" \| "top"` | `"bottom"` | Which edge the axis stands at. A second x axis on the opposite edge is how a series counts in a unit of its own.<br>Shown in: [Add axes for other magnitudes (Axis)](#/axis/axes), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) |
 | `time` | `boolean` | — | The values are instants: milliseconds since the epoch, or with `time` said ISO 8601 strings as an API sends them, read by the platform's rule - a date with a time and no offset is local time, a date alone is UTC; a string that is none is not drawn. Rows that hold a `Date` put the axis in time without `time`. Ticks on local boundaries from the minute to the month, labels by level in en-GB with a 24-hour clock - `15:00`, `17 Mar`, `Mar 2026` - and the date on the first tick and on the first of a new day (`17 Mar 00:00`); a day tick there carries the year. The tooltip's x value carries the seconds where the readings lie less than a minute apart. Another language is a `tickFormat`, which is handed the instant in milliseconds. `calendar` implies it.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 36 more |
 | `calendar` | `readonly `[`WorkingInterval`](#type-WorkingInterval)`[]` | — | Working calendar: the intervals in which time counts. With it the axis stands in working time - nights and weekends are out, and every removed span gets a break mark. The scale stays affine; the mapping happens in materialisation ([ADR-0001](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0001-affine-scale-contract.md)).<br>Shown in: [Leave out the hours nobody works (Axis)](#/axis/working-time) |
-| `zoomable` | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setDomain`). The plain wheel always scrolls the page.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 5 more |
+| `zoomable` | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setView`, `setDomain`). The plain wheel always scrolls the page.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 6 more |
 | `zoomLimits` | [`ZoomLimits`](#type-ZoomLimits) | at most the data's extent or this axis' own `domain`, whichever is wider, at least three data steps | The narrowest and the widest span zoom may reach, in the axis' units - milliseconds on a time axis.<br>Shown in: [Limit the zoom](#/zoom-and-pan/zoom-limits) |
 | `id` | `string` | `"x"` | Axis id, through which series bind themselves.<br>Shown in: [Add axes for other magnitudes (Axis)](#/axis/axes), [Align a second axis to the grid (Axis)](#/axis/aligned-ticks), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) and 7 more |
 | `label` | `string` | — | Axis title.<br>Shown in: [Gestures and keys](#/zoom-and-pan/gestures-and-keys), [Limit the zoom](#/zoom-and-pan/zoom-limits), [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain) and 66 more |
@@ -3586,13 +3593,13 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `initialView` | [`ChartView`](#/view/type-ChartView) | — | The view to start from, and to go to whenever one differing in content from the last is handed in - the same view again changes nothing, and what it leaves out is reset; one the chart reported itself, handed back late, is its own state coming back and not gone to - two charts in step do not jump back mid-pan. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain), [Keep charts in step](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) and 2 more |
+| `initialView` | [`ChartView`](#/view/type-ChartView) | — | The view to start from, read once when the hook first runs; a different value on a later render is ignored, as React ignores a changed `defaultValue`. To go to a view later, call `setView`. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Fit the y axis to what is visible](#/zoom-and-pan/visible-domain), [Hide a series from the legend (Legend)](#/legend/hide-a-series) |
 
 ###### Events
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `onViewChange` | `(view: `[`ChartView`](#/view/type-ChartView)`) => void` | — | Every change of the view, once, always the whole view - the one to keep, or to hand another chart as its `initialView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with.<br>Shown in: [Keep charts in step](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Keep and restore a view (View)](#/view/keep-and-restore) |
+| `onViewChange` | `(view: `[`ChartView`](#/view/type-ChartView)`) => void` | — | Every change the reader makes, once, always the whole view - the one to keep, or to hand another chart's `setView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with, nor for one `setView` applies.<br>Shown in: [Keep charts in step](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) |
 | `onSelect` | `(hit: `[`TooltipHit`](#type-TooltipHit)`<Z>) => void` | — | The reader chose a point: a click on a hit (a tap too), or Enter on the Active point - the same hit the tooltip's `render` receives. Once per click; the end of a drag does not report, and the second click of a double click does not either. The chart holds no selection and draws none: what is chosen is the application's state. Needs a `<Tooltip>`, which makes the hits; the hit does not travel over `syncId`.<br>Shown in: [Choose a hit (Tooltip)](#/tooltip/choose-a-hit) |
 
 ##### Types on this page
@@ -3685,7 +3692,7 @@ A box's further numbers beside its median, by name.
 
 ###### `BoxExtras<V = number>`
 
-The optional numbers of a box (box-plot 04), by name.
+The optional numbers of a box by name.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
@@ -3702,7 +3709,7 @@ What umriss deliberately does not build, and why: [ADR-0032](https://romanhaendl
 
 ### View
 
-How a reader is looking at a chart - the span in view and the hidden series - kept by the chart, reported whole, and handed back to restore it (saved state, a bookmark, a reload).
+How a reader is looking at a chart - the span in view and the hidden series - kept by the chart, reported whole, and gone back to with `setView` to restore it (saved state, a bookmark, a reload).
 
 ```ts
 import { useChart } from "@umriss-ui/charts";
@@ -3712,13 +3719,13 @@ Demo page: https://romanhaendler.github.io/umriss-ui/charts/view/
 
 A chart holds its own view ([ADR-0047](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0047-a-component-holds-its-own-view.md)): `{ domains, hidden }` - the span each zoomable x axis shows, by axis `id`, and the hidden series, by `name`. Whatever is at its default is absent, so a chart nobody touched reports `{}`.
 
-`useChart(rows, { initialView, onViewChange })`: `onViewChange` hears every change once, always the whole view; `initialView` is the start, and a view handed in later is gone to whenever its content differs from the last one handed in. An axis id or a series name that no longer occurs falls out. Where a view is kept - state, storage, an address - is the application's decision; the chart remembers none.
+`useChart(rows, { initialView, onViewChange })`: `onViewChange` hears every change the reader makes once, always the whole view; `initialView` is the start, read once - a different value on a later render is ignored; `setView(view)` goes to a whole view later and is not reported. An axis id or a series name that no longer occurs falls out. Where a view is kept - state, storage, an address - is the application's decision; the chart remembers none.
 
 #### Examples
 
 ##### Keep and restore a view
 
-`onViewChange` reports the span in view and the hidden series as one view; keep it - here in the browser's storage, so it outlives a reload - and hand it back through `initialView`. Zoom, hide a series, keep, reload, restore.
+`onViewChange` reports the span in view and the hidden series as one view; keep it - here in the browser's storage, so it outlives a reload - and go back to it with `setView`. Zoom, hide a series, keep, reload, restore.
 
 ```tsx
 import { useState } from "react";
@@ -3833,11 +3840,10 @@ function keep(view: ChartView): void {
 }
 
 export default function KeepAndRestore() {
-  /* The application holds the view the chart reports; handing it another one
-     is all it takes to restore. */
-  const [view, setView] = useState<ChartView>({});
+  /* The chart holds its view; `view` is what it shows now, and `setView`
+     restores a kept one. */
   const [kept, setKept] = useState<ChartView | null>(readKept);
-  const { Chart, XAxis, YAxis, Line } = useChart(SERIES[0]!.data, { initialView: view, onViewChange: setView });
+  const { Chart, XAxis, YAxis, Line, view, setView } = useChart(SERIES[0]!.data);
   return (
     <>
       <Chart height={260} ariaLabel="Latency of three services today">
@@ -3890,13 +3896,13 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `initialView` | [`ChartView`](#type-ChartView) | — | The view to start from, and to go to whenever one differing in content from the last is handed in - the same view again changes nothing, and what it leaves out is reset; one the chart reported itself, handed back late, is its own state coming back and not gone to - two charts in step do not jump back mid-pan. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Keep and restore a view](#/view/keep-and-restore), [Fit the y axis to what is visible (Zoom and pan)](#/zoom-and-pan/visible-domain), [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync) and 2 more |
+| `initialView` | [`ChartView`](#type-ChartView) | — | The view to start from, read once when the hook first runs; a different value on a later render is ignored, as React ignores a changed `defaultValue`. To go to a view later, call `setView`. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Fit the y axis to what is visible (Zoom and pan)](#/zoom-and-pan/visible-domain), [Hide a series from the legend (Legend)](#/legend/hide-a-series) |
 
 ###### Events
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `onViewChange` | `(view: `[`ChartView`](#type-ChartView)`) => void` | — | Every change of the view, once, always the whole view - the one to keep, or to hand another chart as its `initialView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with.<br>Shown in: [Keep and restore a view](#/view/keep-and-restore), [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) |
+| `onViewChange` | `(view: `[`ChartView`](#type-ChartView)`) => void` | — | Every change the reader makes, once, always the whole view - the one to keep, or to hand another chart's `setView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with, nor for one `setView` applies.<br>Shown in: [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) |
 | `onSelect` | `(hit: `[`TooltipHit`](#type-TooltipHit)`<Z>) => void` | — | The reader chose a point: a click on a hit (a tap too), or Enter on the Active point - the same hit the tooltip's `render` receives. Once per click; the end of a drag does not report, and the second click of a double click does not either. The chart holds no selection and draws none: what is chosen is the application's state. Needs a `<Tooltip>`, which makes the hits; the hit does not travel over `syncId`.<br>Shown in: [Choose a hit (Tooltip)](#/tooltip/choose-a-hit) |
 
 ##### `ChartView`
@@ -3957,7 +3963,7 @@ A box's further numbers beside its median, by name.
 
 ###### `BoxExtras<V = number>`
 
-The optional numbers of a box (box-plot 04), by name.
+The optional numbers of a box by name.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
@@ -5501,11 +5507,11 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `value` *required* | [`Value`](#type-Value)`<T>` | — | Y value - a number field of the row or a function of it; null/undefined/NaN/±Infinity means a gap.<br>Shown in: [Plot single measurements](#/scatter/arrivals), [Mark samples that miss a target](#/scatter/against-a-target), [Mix series kinds (Chart)](#/chart/mixed) and 2 more |
+| `value` *required* | [`Value`](#type-Value)`<T>` | — | Y value - a number field of the row or a function of it; null/undefined/NaN/±Infinity means a gap.<br>Shown in: [Plot single measurements](#/scatter/arrivals), [Mark samples that miss a target](#/scatter/against-a-target), [Mix series kinds (Chart)](#/chart/mixed) and 3 more |
 | `xAxisId` | `string` | `"x"` | Binding to an x axis.<br>Shown in: [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) |
 | `yAxisId` | `string` | `"y"` | Binding to a y axis.<br>Shown in: [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) |
 | `data` | `readonly T[]` | — | Series-own data; overrides the container data.<br>Shown in: [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) |
-| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [Plot single measurements](#/scatter/arrivals), [Mark samples that miss a target](#/scatter/against-a-target), [Mix series kinds (Chart)](#/chart/mixed) and 2 more |
+| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [Plot single measurements](#/scatter/arrivals), [Mark samples that miss a target](#/scatter/against-a-target), [Mix series kinds (Chart)](#/chart/mixed) and 3 more |
 | `format` | `(value: number) => string` | the y axis' `tickFormat`, else the built-in number format | The value as the tooltip writes it. |
 | `color` | `string` | the palette's `--uc-series-N` | Any CSS colour value. |
 | `tone` | `"ok" \| "warning" \| "alarm"` | — | A role instead of a colour value; the theme resolves it.<br>Shown in: [Mark samples that miss a target](#/scatter/against-a-target) |
@@ -6703,12 +6709,12 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `value` *required* | [`Value`](#type-Value)`<T>` | — | Index of the state in `states` - a number field of the row or a function of it; null/undefined/NaN/±Infinity is a gap - and a gap stays a hole, it gets no colour for "unknown". A colour would be a claim about the interval.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 3 more |
-| `states` *required* | `readonly `[`StateEntry`](#type-StateEntry)`[]` | — | The closed set of states, in the order of their codes.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 3 more |
+| `value` *required* | [`Value`](#type-Value)`<T>` | — | Index of the state in `states` - a number field of the row or a function of it; null/undefined/NaN/±Infinity is a gap - and a gap stays a hole, it gets no colour for "unknown". A colour would be a claim about the interval.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 4 more |
+| `states` *required* | `readonly `[`StateEntry`](#type-StateEntry)`[]` | — | The closed set of states, in the order of their codes.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 4 more |
 | `xAxisId` | `string` | — | Binding to an x axis. |
 | `yAxisId` | `string` | — | Binding to a y axis.<br>Shown in: [Lay a state under a course](#/stateband/under-a-course), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [Read limits above the states (LimitLine)](#/limitline/limits-and-state) |
 | `data` | `readonly T[]` | — | Series-own data; overrides the container data.<br>Shown in: [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 2 more |
-| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 3 more |
+| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [One vehicle through the day](#/stateband/one-vehicle), [Lay a state under a course](#/stateband/under-a-course), [Give each one a lane](#/stateband/one-lane-each) and 4 more |
 | `lane` | `string` | — | The lane by its name: a category of the y axis, whose place the band takes, as wide as a bar is. The y axis then lists a lane per name, the first at the top, in the bands' order or its own `categories` ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). Not together with `laneFrom` or `laneTo`.<br>Shown in: [Give each one a lane](#/stateband/one-lane-each), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [Read limits above the states (LimitLine)](#/limitline/limits-and-state) and 1 more |
 | `laneFrom` | `number` | the beginning of the axis' domain | Lower edge of the lane in domain units of a numeric y axis.<br>Shown in: [Lay a state under a course](#/stateband/under-a-course) |
 | `laneTo` | `number` | the end of the axis' domain | Upper edge of the lane in domain units of a numeric y axis.<br>Shown in: [Lay a state under a course](#/stateband/under-a-course) |
@@ -6953,13 +6959,13 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `value` *required* | [`AxisField`](#type-AxisField)`<T, number \| string \| null \| undefined> \| ((d: T, index: number) => number \| string \| null \| undefined)` | — | The row on the y axis - a field of the data's row or a function of it. A number is a position, as every series' y is; a string is a category: the y axis then has a named row per distinct one, the first at the top, in the order the data bring them or the y axis' `categories` ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). Never an instant: a `Date` is refused.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) |
-| `level` *required* | [`Value`](#type-Value)`<T>` | — | The level that decides the colour - a number field of the row or a function of it. A missing level is a hole, not a zero.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) |
+| `value` *required* | [`AxisField`](#type-AxisField)`<T, number \| string \| null \| undefined> \| ((d: T, index: number) => number \| string \| null \| undefined)` | — | The row on the y axis - a field of the data's row or a function of it. A number is a position, as every series' y is; a string is a category: the y axis then has a named row per distinct one, the first at the top, in the order the data bring them or the y axis' `categories` ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). Never an instant: a `Date` is refused.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 1 more |
+| `level` *required* | [`Value`](#type-Value)`<T>` | — | The level that decides the colour - a number field of the row or a function of it. A missing level is a hole, not a zero.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 1 more |
 | `coloring` | [`MatrixColoring`](#type-MatrixColoring) | `{ kind: "gradient", stops: DEFAULT_GRADIENT }` | How the level colours a cell: by assessment against limits, or across a gradient.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) |
 | `xAxisId` | `string` | `"x"` | Binding to an x axis. |
 | `yAxisId` | `string` | `"y"` | Binding to a y axis. |
 | `data` | `readonly T[]` | — | Series-own data; overrides the container data. |
-| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) |
+| `name` | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits), [Colour cells along a gradient](#/matrix/gradient), [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells) and 1 more |
 | `format` | `(value: number) => string` | the built-in number format | The level as the tooltip writes it. The y axis' `tickFormat` writes the row, not the level.<br>Shown in: [Colour cells by their limits](#/matrix/by-limits) |
 
 ##### Types on this page
@@ -9578,13 +9584,13 @@ The keys of [Chart](#/chart/keyboard-chart) apply here.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `initialView` | [`ChartView`](#/view/type-ChartView) | — | The view to start from, and to go to whenever one differing in content from the last is handed in - the same view again changes nothing, and what it leaves out is reset; one the chart reported itself, handed back late, is its own state coming back and not gone to - two charts in step do not jump back mid-pan. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Fit the y axis to what is visible (Zoom and pan)](#/zoom-and-pan/visible-domain), [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) and 2 more |
+| `initialView` | [`ChartView`](#/view/type-ChartView) | — | The view to start from, read once when the hook first runs; a different value on a later render is ignored, as React ignores a changed `defaultValue`. To go to a view later, call `setView`. The chart remembers none: where a view is kept is the application's decision.<br>Shown in: [Fit the y axis to what is visible (Zoom and pan)](#/zoom-and-pan/visible-domain), [Hide a series from the legend (Legend)](#/legend/hide-a-series) |
 
 ###### Events
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `onViewChange` | `(view: `[`ChartView`](#/view/type-ChartView)`) => void` | — | Every change of the view, once, always the whole view - the one to keep, or to hand another chart as its `initialView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with.<br>Shown in: [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Keep and restore a view (View)](#/view/keep-and-restore) |
+| `onViewChange` | `(view: `[`ChartView`](#/view/type-ChartView)`) => void` | — | Every change the reader makes, once, always the whole view - the one to keep, or to hand another chart's `setView`. A pan or zoom is reported at most once per frame. Not called for the view the chart starts with, nor for one `setView` applies.<br>Shown in: [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader) |
 | `onSelect` | `(hit: `[`TooltipHit`](#type-TooltipHit)`<Z>) => void` | — | The reader chose a point: a click on a hit (a tap too), or Enter on the Active point - the same hit the tooltip's `render` receives. Once per click; the end of a drag does not report, and the second click of a double click does not either. The chart holds no selection and draws none: what is chosen is the application's state. Needs a `<Tooltip>`, which makes the hits; the hit does not travel over `syncId`.<br>Shown in: [Choose a hit](#/tooltip/choose-a-hit) |
 
 ##### Types on this page
@@ -9630,7 +9636,7 @@ A box's further numbers beside its median, by name.
 
 ###### `BoxExtras<V = number>`
 
-The optional numbers of a box (box-plot 04), by name.
+The optional numbers of a box by name.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
@@ -9950,20 +9956,39 @@ interface LoadPoint {
   s1: number;
   s2: number;
   s3: number;
-}
+  /** A state code 0..3 that holds for a run of about ten points. */
+  st: number;
+  /** Column, row and level of the same points laid out as a grid 200 rows high. */
+  c: number;
+  r: number;
+  lvl: number;
+}
+
+const STATES = [
+  { label: "A", color: "#2f6fb4" },
+  { label: "B", color: "#c08a2e" },
+  { label: "C", color: "#8a8f98" },
+  { label: "D", color: "#6b8e5a" },
+] as const;
+const ROWS = 200;
 
-/** Three random walks of any length. */
+/** Three random walks of any length, with a state, and a grid laid over them. */
 function load(seed: number, n: number): LoadPoint[] {
   const r = random(seed);
   const points = new Array<LoadPoint>(n);
   let s1 = 100;
   let s2 = 60;
   let s3 = 140;
+  let st = 0;
+  const columns = Math.max(1, Math.ceil(n / ROWS));
   for (let i = 0; i < n; i++) {
     s1 += r() - 0.5;
     s2 += (r() - 0.5) * 0.8;
     s3 += (r() - 0.5) * 1.2;
-    points[i] = { t: i, s1, s2, s3 };
+    if (r() < 0.1) st = Math.floor(r() * 4);
+    const c = i % columns;
+    const row = Math.floor(i / columns);
+    points[i] = { t: i, s1, s2, s3, st, c, r: row, lvl: 0.5 + 0.5 * Math.sin(c / 40) * Math.cos(row / 15) + (r() - 0.5) * 0.2 };
   }
   return points;
 }
@@ -9974,11 +9999,15 @@ const WINDOW = 400;
 /** Series kinds of the measuring run. A filled mark and a rectangle per point are
     different work from a stroked path - the measurements in the capability record
     must not hold for lines only. */
-type Mode = "lines" | "mixed";
+type Mode = "lines" | "mixed" | "bars" | "scatter" | "state" | "matrix";
+const MODES: readonly Mode[] = ["lines", "mixed", "bars", "scatter", "state", "matrix"];
+
+/** How many points along x (columns for the matrix) a zoom shows. */
+const ZOOMED = 400;
 
 export default function Benchmark() {
   const [data, setData] = useState<readonly LoadPoint[]>(() => load(5, 1_000));
-  const { Chart, XAxis, YAxis, Line, Bar, Area } = useChart(data);
+  const { Chart, XAxis, YAxis, Line, Bar, Area, Scatter, StateBand, Matrix, setDomain } = useChart(data);
   const [perf, setPerf] = useState<ChartPerf>({
     materializeMs: 0,
     seriesDrawMs: 0,
@@ -9987,6 +10016,14 @@ export default function Benchmark() {
   const [fps, setFps] = useState<number | null>(null);
   const [live, setLive] = useState(false);
   const [mode, setMode] = useState<Mode>("lines");
+  /* The time the chart's handlers take for one pointer move, the mean of the
+     last twenty: the hit test of the matrix is in it. */
+  const [hoverMs, setHoverMs] = useState<number | null>(null);
+  const moves = useRef<number[]>([]);
+  const moveStart = useRef(0);
+  const matrix = mode === "matrix";
+  const columns = matrix ? Math.max(1, Math.ceil(data.length / ROWS)) : data.length;
+  const course = mode === "lines" || mode === "mixed";
 
   const onPerf = useCallback((p: ChartPerf) => setPerf(p), []);
 
@@ -10030,6 +10067,10 @@ export default function Benchmark() {
           s1: last.s1 + (r() - 0.5) * 3,
           s2: last.s2 + (r() - 0.5) * 2.4,
           s3: last.s3 + (r() - 0.5) * 3.6,
+          st: r() < 0.1 ? Math.floor(r() * 4) : last.st,
+          c: last.c + 1,
+          r: last.r,
+          lvl: last.lvl,
         };
         const grown = [...previous, next];
         return grown.length > WINDOW ? grown.slice(grown.length - WINDOW) : grown;
@@ -10041,62 +10082,90 @@ export default function Benchmark() {
   const loadPoints = (n: number) => {
     setLive(false);
     setData(load(5, n));
+    setDomain("x", null);
+    moves.current = [];
+  };
+  const pick = (m: Mode) => {
+    setMode(m);
+    setDomain("x", null);
+    moves.current = [];
+  };
+  /* A span in the middle of the data: a small part of the volume is in view. */
+  const zoom = () => {
+    const from = Math.floor(columns / 2);
+    setDomain("x", [from, from + ZOOMED]);
   };
 
   return (
     <>
       <div className="demo-actions">
         {SIZES.map((n) => (
-          <button key={n} className="demo-button" onClick={() => loadPoints(n)}>
+          <button key={n} className="demo-button" data-role={`points-${n}`} onClick={() => loadPoints(n)}>
             {n.toLocaleString("en-US")} points
           </button>
         ))}
         <button className="demo-button" onClick={() => setLive((v) => !v)}>{live ? "Stop live" : "Live"}</button>
-        <button
-          className="demo-button"
-          data-role="mode"
-          onClick={() => setMode((m) => (m === "lines" ? "mixed" : "lines"))}
-        >
-          {mode === "lines" ? "Mixed" : "Lines only"}
+        {MODES.map((m) => (
+          <button key={m} className="demo-button" data-role={`kind-${m}`} aria-pressed={mode === m} onClick={() => pick(m)}>
+            {m}
+          </button>
+        ))}
+        <button className="demo-button" data-role="zoom" onClick={zoom}>
+          Zoom in
+        </button>
+        <button className="demo-button" data-role="unzoom" onClick={() => setDomain("x", null)}>
+          Whole
         </button>
       </div>
       <dl className="metrics">
         <div>
           <dt>Points</dt>
-          <dd>{perf.points.toLocaleString("en-US")}</dd>
+          <dd data-role="points">{perf.points.toLocaleString("en-US")}</dd>
         </div>
         <div>
           <dt>Materialisation</dt>
-          <dd>{perf.materializeMs.toFixed(1)} ms</dd>
+          <dd data-role="materialize-ms">{perf.materializeMs.toFixed(1)} ms</dd>
         </div>
         <div>
           <dt>Series draw</dt>
-          <dd>{perf.seriesDrawMs.toFixed(1)} ms</dd>
+          <dd data-role="series-draw-ms">{perf.seriesDrawMs.toFixed(1)} ms</dd>
         </div>
         <div>
           <dt>FPS (hover)</dt>
           <dd>{fps === null ? "–" : fps}</dd>
         </div>
+        <div>
+          <dt>Pointer move</dt>
+          <dd data-role="hover-ms">{hoverMs === null ? "–" : `${hoverMs.toFixed(2)} ms`}</dd>
+        </div>
       </dl>
-      <div onPointerEnter={startMeasuring} onPointerLeave={stopMeasuring}>
+      <div
+        data-role="plot"
+        onPointerEnter={startMeasuring}
+        onPointerLeave={stopMeasuring}
+        onPointerMoveCapture={() => {
+          moveStart.current = performance.now();
+        }}
+        onPointerMove={() => {
+          moves.current.push(performance.now() - moveStart.current);
+          if (moves.current.length > 20) moves.current.shift();
+          setHoverMs(moves.current.reduce((a, b) => a + b, 0) / moves.current.length);
+        }}
+      >
         <Chart
           height={320}
           ariaLabel="Benchmark with three series"
           onPerf={onPerf}
         >
-          <XAxis value="t" label="Index" />
-          <YAxis />
-          {mode === "lines" ? (
-            <Line value="s1" name="S1" />
-          ) : (
-            <Bar value="s1" name="S1" />
-          )}
-          {mode === "lines" ? (
-            <Line value="s2" name="S2" />
-          ) : (
-            <Area value="s2" name="S2" />
-          )}
-          <Line value="s3" name="S3" />
+          <XAxis value={matrix ? "c" : "t"} label="Index" domain="data" zoomable />
+          <YAxis domain={mode === "state" ? [0, 1] : undefined} />
+          {mode === "scatter" ? <Scatter value="s1" name="S1" /> : null}
+          {mode === "state" ? <StateBand value="st" states={STATES} name="State" /> : null}
+          {matrix ? <Matrix value="r" level="lvl" name="Level" /> : null}
+          {mode === "bars" ? <Bar value="s1" name="S1" /> : null}
+          {course ? mode === "lines" ? <Line value="s1" name="S1" /> : <Bar value="s1" name="S1" /> : null}
+          {course ? mode === "lines" ? <Line value="s2" name="S2" /> : <Area value="s2" name="S2" /> : null}
+          {course ? <Line value="s3" name="S3" /> : null}
           <Legend placement="top" />
           <Tooltip mode="x" />
         </Chart>
@@ -10278,7 +10347,7 @@ From `XAxisProps` — the full table stands on [Axis](#/axis/type-XAxisProps).
 | [`value`](#/axis/XAxisProps-value) *required* | [`AxisField`](#/axis/type-AxisField)`<T> \| ((d: T, index: number) => `[`AxisValue`](#/axis/type-AxisValue)`)` | — | Where a row lies on this axis: a field of the row, compared by its name, or a function of it, compared by its source text as a series' is (`ValueFunction`) - with the same closure limit. A number is a position, a `Date` an instant, a string a category: every distinct one gets a place of its own, in the order the rows bring them, a tick and its name as the label ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). The type decides, never the content - `"2024"` is a category, `2024` a number - and a row without a value has no place. The axis reads the rows of every series bound to it; where those bring their own `data`, name their row: `<XAxis<HourCount> value="hour" />`. |
 | [`domain`](#/axis/XAxisProps-domain) | `"nice" \| "data" \| readonly [number, number] \| readonly [Date, Date]` | `"nice"` | `"nice"` widens the data's extent to ticks - to named `ticks` where there are any, on a time axis to whole units of a step of hours or longer -, `"data"` keeps it, a pair is fixed: numbers, on a time axis milliseconds or two `Date`s, on a category axis places. On a `zoomable` axis it is the start: what the axis shows while the chart's view names no span for it. |
 | [`time`](#/axis/XAxisProps-time) | `boolean` | — | The values are instants: milliseconds since the epoch, or with `time` said ISO 8601 strings as an API sends them, read by the platform's rule - a date with a time and no offset is local time, a date alone is UTC; a string that is none is not drawn. Rows that hold a `Date` put the axis in time without `time`. Ticks on local boundaries from the minute to the month, labels by level in en-GB with a 24-hour clock - `15:00`, `17 Mar`, `Mar 2026` - and the date on the first tick and on the first of a new day (`17 Mar 00:00`); a day tick there carries the year. The tooltip's x value carries the seconds where the readings lie less than a minute apart. Another language is a `tickFormat`, which is handed the instant in milliseconds. `calendar` implies it. |
-| [`zoomable`](#/axis/XAxisProps-zoomable) | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setDomain`). The plain wheel always scrolls the page. |
+| [`zoomable`](#/axis/XAxisProps-zoomable) | `boolean` | `false` | Zoom and pan: Ctrl or ⌘ with the wheel - and a pinch - zoom around the pointer, a drag, a horizontal wheel or Shift with the wheel pan, a double click goes back to `domain`; with the focus on the chart, + and − zoom, Shift with ← or → pans and 0 goes back. The span shown is part of the chart's view, by this axis' `id` (`useChart`'s `initialView`, `onViewChange`, `setView`, `setDomain`). The plain wheel always scrolls the page. |
 | [`id`](#/axis/XAxisProps-id) | `string` | `"x"` | Axis id, through which series bind themselves. |
 | [`label`](#/axis/XAxisProps-label) | `string` | — | Axis title. |
 
@@ -10313,6 +10382,29 @@ From `BarProps` — the full table stands on [Bar](#/bar/type-BarProps).
 | [`value`](#/bar/BarProps-value) *required* | [`Value`](#/bar/type-Value)`<T>` | — | Height - a number field of the row or a function of it; null/undefined/NaN/±Infinity means a gap. |
 | [`name`](#/bar/BarProps-name) | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up. |
 
+From `ScatterProps` — the full table stands on [Scatter](#/scatter/type-ScatterProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`value`](#/scatter/ScatterProps-value) *required* | [`Value`](#/scatter/type-Value)`<T>` | — | Y value - a number field of the row or a function of it; null/undefined/NaN/±Infinity means a gap. |
+| [`name`](#/scatter/ScatterProps-name) | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up. |
+
+From `StateBandProps` — the full table stands on [StateBand](#/stateband/type-StateBandProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`value`](#/stateband/StateBandProps-value) *required* | [`Value`](#/stateband/type-Value)`<T>` | — | Index of the state in `states` - a number field of the row or a function of it; null/undefined/NaN/±Infinity is a gap - and a gap stays a hole, it gets no colour for "unknown". A colour would be a claim about the interval. |
+| [`states`](#/stateband/StateBandProps-states) *required* | `readonly `[`StateEntry`](#/stateband/type-StateEntry)`[]` | — | The closed set of states, in the order of their codes. |
+| [`name`](#/stateband/StateBandProps-name) | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up. |
+
+From `MatrixProps` — the full table stands on [Matrix](#/matrix/type-MatrixProps).
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| [`value`](#/matrix/MatrixProps-value) *required* | [`AxisField`](#/matrix/type-AxisField)`<T, number \| string \| null \| undefined> \| ((d: T, index: number) => number \| string \| null \| undefined)` | — | The row on the y axis - a field of the data's row or a function of it. A number is a position, as every series' y is; a string is a category: the y axis then has a named row per distinct one, the first at the top, in the order the data bring them or the y axis' `categories` ([ADR-0052](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0052-a-chart-reads-its-rows-as-they-come.md)). Never an instant: a `Date` is refused. |
+| [`level`](#/matrix/MatrixProps-level) *required* | [`Value`](#/matrix/type-Value)`<T>` | — | The level that decides the colour - a number field of the row or a function of it. A missing level is a hole, not a zero. |
+| [`name`](#/matrix/MatrixProps-name) | `string` | "Series n", after its place in the chart | The name in legend and tooltip. Without one a warning stands in DEV - an unnamed series is a colour nobody can look up. |
+
 From `TooltipProps` — the full table stands on [Tooltip](#/tooltip/type-TooltipProps).
 
 | Prop | Type | Default | Description |
@@ -10494,15 +10586,6 @@ for a grid up to the next clock change.
 function localOffset(instant: number): number;
 ```
 
-##### `mapSeries`
-
-Map a whole series inwards - the route materialisation takes when it wants to
-go it in one piece. Only the first n values are touched.
-
-```ts
-function mapSeries(input: CalendarInput, source: Float64Array, n: number, target: Float64Array): void;
-```
-
 ##### `pareto`
 
 Sorts descending, accumulates, collects the tail and finds the cutoff
@@ -10546,55 +10629,6 @@ colours of
 function resolveColours<K extends string>(root: Element, colours: Readonly<Record<K, string>>): Record<K, string>;
 ```
 
-##### `ruleOutlier`
-
-Rule 1 (Nelson 1, Western Electric 1): one point beyond three sigma.
-Beyond, not on it - a point exactly on the limit violates nothing.
-
-```ts
-function ruleOutlier(values: readonly number[], limits: ControlLimits): number[];
-```
-
-##### `ruleRun`
-
-Rule 2 (Nelson 2): a run of points on one side of the centre line. The
-default length is nine - Nelson. Western Electric counts eight; that is why
-the length is a parameter and not a literal, so that a works with a rule of
-its own need not argue with the library.
-
-```ts
-function ruleRun(values: readonly number[], limits: ControlLimits, length?: number): number[];
-```
-
-##### `ruleTrend`
-
-Rule 3 (Nelson 3): a run of nothing but rises or nothing but falls. The
-default length is six points, so five steps - Nelson. Two equal values are
-neither a rise nor a fall and break the run.
-
-```ts
-function ruleTrend(values: readonly number[], length?: number): number[];
-```
-
-##### `ruleTwoOfThree`
-
-Rule 4 (Nelson 5): two of three consecutive points beyond two sigma on the
-same side. Reported are the points beyond the zone, not the one in between -
-that one is unremarkable and, marked, would look like a measurement error.
-
-```ts
-function ruleTwoOfThree(values: readonly number[], limits: ControlLimits): number[];
-```
-
-##### `sigmaFromLimit`
-
-Sigma calculated back from a limit that stands on paper. For callers whose
-baseline has been handed down as a centre line and a control limit.
-
-```ts
-function sigmaFromLimit(center: number, upper: number): number;
-```
-
 ##### `subscribeTheme`
 
 Subscribe to theme invalidations - a switch of `color-scheme` on the
@@ -10629,26 +10663,6 @@ interval has no next and comes back as itself.
 function toWallClock(workingTime: number, input: CalendarInput): number;
 ```
 
-##### `toWorkingTime`
-
-Wall clock time → working time.
-
-A point in a removed interval is a gap and becomes `NaN` - the encoding every
-gap of this library already uses, and the drawing loop breaks the mark at it
-of its own accord. Not the edge of the interval: a measurement from a time
-which, according to the calendar, did not exist could not be laid there
-honestly; it would pile up on what really does lie there. The same holds
-before the first and after the last interval.
-
-The end of one interval and the beginning of the next fall on the same value:
-in working time they are neighbours, and the line between two points on
-either side is drawn. That is not a lie but the whole purpose of the axis; the
-mark in the axis band tells the reader that time was taken out there.
-
-```ts
-function toWorkingTime(wallClock: number, input: CalendarInput): number;
-```
-
 ##### `toWorkingTimeClamped`
 
 Wall clock time → working time, but without NaN: whatever lies in removed
@@ -10656,10 +10670,8 @@ time falls onto the seam that this span collapses onto anyway; whatever lies
 before the first or after the last interval onto 0 or onto the whole
 working time respectively.
 
-Why this exists: the materialised x values must stay ascending. Binary search
-- for a hit as for a segment boundary - assumes that, and every comparison
-with NaN is false, so that a search over a block of NaN silently lands on the
-wrong point. The clamped value is a POSITION, not a statement: the point
+The materialised x values must stay ascending: binary search assumes it, and
+a search over NaN silently lands on the wrong point. The clamped value is a POSITION, not a statement: the point
 itself is carried as a gap and is never drawn and never hit.
 
 ```ts
@@ -10710,22 +10722,6 @@ function workingCalendar(intervals: readonly WorkingInterval[]): WorkingCalendar
 
 Used on [Axis](#/axis).
 
-##### `workingTicks`
-
-Tick values for an axis extent that already stands in WORKING TIME - the
-route the axis layout takes.
-
-The extent is trimmed to the working time that exists (an extent widened to
-nice boundaries reaches beyond it), calculated back into wall clock time, and
-the candidates arise there. The step comes from the span in working time and
-not from the one in wall clock time: roughly one candidate per step of
-working time survives, and calculated from the wall clock span, four out of
-ten wanted ticks would be left.
-
-```ts
-function workingTicks(input: CalendarInput, from: number, to: number, count: number, offset?: number): number[];
-```
-
 ##### `workingTimeTicks`
 
 Ticks for a working time axis, from an extent in WALL CLOCK TIME.
@@ -10798,42 +10794,6 @@ const DEFAULT_GRADIENT: readonly string[];
 
 Used on [Matrix](#/matrix).
 
-##### `defaultRules`
-
-All four rules, with Nelson's run lengths: nine points on one side, six
-points in succession rising or falling. Western Electric counts eight; both
-lengths are therefore parameters.
-
-```ts
-const defaultRules: RuleOptions;
-```
-
-##### `Echoes`
-
-The views a component reported that may still come back, by their
-content key - the chart's and the schedule's ([ADR-0047](https://github.com/romanhaendler/umriss-ui/blob/main/docs/adr/0047-a-component-holds-its-own-view.md)), the table holding
-a copy of its own. An application keeping the view hands
-it back a frame or more late - by then a pan has moved on, and going to the
-view handed in would jump back. So a view handed in that equals one
-reported since the last one handed in, within a second, is the component's
-own state coming back, not a view to go to. The echoes come in order: one drops
-itself and every older report, a view from outside drops them all. The
-second bounds the list where nothing is handed back, and lets such an
-application still restore a view it kept.
-
-```ts
-class Echoes {
-    private reports;
-    /** Notes a view reported, by its key. */
-    reported(key: string): void;
-    /** Whether the view handed in is a report coming back. */
-    has(key: string): boolean;
-    /** Forgets what the view handed in answers. */
-    handed(key: string): void;
-    private at;
-}
-```
-
 ##### `HOUR`
 
 One hour in milliseconds.
@@ -10873,16 +10833,6 @@ const MINUTE: number;
 
 Used on [Scenarios](#/), [Installation](#/installation), [Chart](#/chart), [Axis](#/axis), [Zoom and pan](#/zoom-and-pan), [View](#/view), [Line](#/line), [Area](#/area), [Scatter](#/scatter), [BoxPlot](#/boxplot), [StateBand](#/stateband), [LimitLine](#/limitline), [Tooltip](#/tooltip), [Legend](#/legend) and [Benchmark](#/benchmark).
 
-##### `paretoDefaults`
-
-What [`pareto`](#/api/pareto) assumes where a call says nothing: a cutoff of 80 %, and no
-collecting of the tail.
-
-```ts
-const defaultOptions: Omit<ParetoOptions, "remainderName">;
-// exported as paretoDefaults
-```
-
 ##### `SECOND`
 
 One second in milliseconds, the unit of a time axis.
@@ -10916,8 +10866,8 @@ An `Area` as the chart holds it once registered.
 | `format` | `(value: number) => string` | — | The value in the tooltip; before the y axis' `tickFormat`. Compared by its source text, as an accessor is. From `SeriesBase`. |
 | `color` | `string` | — |  From `SeriesBase`. |
 | `tone` | `"ok" \| "warning" \| "alarm"` | — | A role instead of a colour value: the theme resolves it, in both themes. For series that mean something rather than just being the next one - the violating points of a control chart, say. `color` beats it. From `SeriesBase`. |
-| `stack` | `string` | — | The stack this series stands in: series with the same id, on the same x and y axis, stack in registration order (K1). From `Stackable`. |
-| `normalize` | `boolean` | — | On any member, the whole stack sums to 100 at every x (K5). From `Stackable`. |
+| `stack` | `string` | — | The stack this series stands in: series with the same id, on the same x and y axis, stack in registration order. From `Stackable`. |
+| `normalize` | `boolean` | — | On any member, the whole stack sums to 100 at every x. From `Stackable`. |
 
 ##### `Assessment`
 
@@ -11026,8 +10976,8 @@ A `Bar` as the chart holds it once registered.
 | `format` | `(value: number) => string` | — | The value in the tooltip; before the y axis' `tickFormat`. Compared by its source text, as an accessor is. From `SeriesBase`. |
 | `color` | `string` | — |  From `SeriesBase`. |
 | `tone` | `"ok" \| "warning" \| "alarm"` | — | A role instead of a colour value: the theme resolves it, in both themes. For series that mean something rather than just being the next one - the violating points of a control chart, say. `color` beats it. From `SeriesBase`. |
-| `stack` | `string` | — | The stack this series stands in: series with the same id, on the same x and y axis, stack in registration order (K1). From `Stackable`. |
-| `normalize` | `boolean` | — | On any member, the whole stack sums to 100 at every x (K5). From `Stackable`. |
+| `stack` | `string` | — | The stack this series stands in: series with the same id, on the same x and y axis, stack in registration order. From `Stackable`. |
+| `normalize` | `boolean` | — | On any member, the whole stack sums to 100 at every x. From `Stackable`. |
 
 ##### `Bin`
 
@@ -11070,7 +11020,7 @@ is a gap; and its outliers ([ADR-0040](https://github.com/romanhaendler/umriss-u
 
 ##### `BoxExtras<V = number>`
 
-The optional numbers of a box (box-plot 04), by name.
+The optional numbers of a box by name.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
@@ -11149,18 +11099,21 @@ is typed by that `data` instead.
 | `Line` *required* | `<T = Z>(props: `[`LineProps`](#/line/type-LineProps)`<T>) => null` | — | <br>Shown in: [Draw a first chart (Installation)](#/installation/first-chart), [Size a chart by its container (Installation)](#/installation/in-its-container), [Mix series kinds (Chart)](#/chart/mixed) and 47 more |
 | `Area` *required* | `<T = Z>(props: `[`AreaProps`](#/area/type-AreaProps)`<T>) => null` | — | <br>Shown in: [Mix series kinds (Chart)](#/chart/mixed), [Mark every kind (Chart)](#/chart/marks-on-every-kind), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) and 5 more |
 | `Bar` *required* | `<T = Z>(props: `[`BarProps`](#/bar/type-BarProps)`<T>) => null` | — | <br>Shown in: [Mix series kinds (Chart)](#/chart/mixed), [Mark every kind (Chart)](#/chart/marks-on-every-kind), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) and 13 more |
-| `Scatter` *required* | `<T = Z>(props: `[`ScatterProps`](#/scatter/type-ScatterProps)`<T>) => null` | — | <br>Shown in: [Mix series kinds (Chart)](#/chart/mixed), [Mark every kind (Chart)](#/chart/marks-on-every-kind), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) and 2 more |
-| `StateBand` *required* | `<T = Z>(props: `[`StateBandProps`](#/stateband/type-StateBandProps)`<T> & `[`OneLane`](#type-OneLane)`) => null` | — | <br>Shown in: [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [One vehicle through the day (StateBand)](#/stateband/one-vehicle), [Lay a state under a course (StateBand)](#/stateband/under-a-course) and 3 more |
-| `Matrix` *required* | `<T = Z>(props: `[`MatrixProps`](#/matrix/type-MatrixProps)`<T>) => null` | — | <br>Shown in: [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [Colour cells by their limits (Matrix)](#/matrix/by-limits), [Colour cells along a gradient (Matrix)](#/matrix/gradient) |
+| `Scatter` *required* | `<T = Z>(props: `[`ScatterProps`](#/scatter/type-ScatterProps)`<T>) => null` | — | <br>Shown in: [Mix series kinds (Chart)](#/chart/mixed), [Mark every kind (Chart)](#/chart/marks-on-every-kind), [Bind every kind of series to a second axis (Axis)](#/axis/every-kind-on-a-second-axis) and 3 more |
+| `StateBand` *required* | `<T = Z>(props: `[`StateBandProps`](#/stateband/type-StateBandProps)`<T> & `[`OneLane`](#type-OneLane)`) => null` | — | <br>Shown in: [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [One vehicle through the day (StateBand)](#/stateband/one-vehicle), [Lay a state under a course (StateBand)](#/stateband/under-a-course) and 4 more |
+| `Matrix` *required* | `<T = Z>(props: `[`MatrixProps`](#/matrix/type-MatrixProps)`<T>) => null` | — | <br>Shown in: [Mark bands, limits and cells (Chart)](#/chart/bands-limits-and-cells), [Colour cells by their limits (Matrix)](#/matrix/by-limits), [Colour cells along a gradient (Matrix)](#/matrix/gradient) and 1 more |
 | `BoxPlot` *required* | `<T = Z>(props: `[`BoxPlotProps`](#/boxplot/type-BoxPlotProps)`<T>) => null` | — | <br>Shown in: [One box per service (BoxPlot)](#/boxplot/minimal), [A box per hour on a time axis (BoxPlot)](#/boxplot/over-time), [With outliers (BoxPlot)](#/boxplot/outliers) and 4 more |
-| `view` *required* | [`ChartView`](#/view/type-ChartView) | — | How the reader is looking at the chart. |
+| `view` *required* | [`ChartView`](#/view/type-ChartView) | — | How the reader is looking at the chart.<br>Shown in: [Keep and restore a view (View)](#/view/keep-and-restore) |
 | `domains` *required* | [`AxisSpans`](#type-AxisSpans) | — | The span each zoomable x axis shows, by axis `id`; an axis absent shows its own `domain`. |
-| `setDomain` *required* | `(axisId: string, span: readonly [number, number] \| null) => void` | — | Puts a span in view on a zoomable x axis - a lone one is `"x"`; `null` shows the axis' own `domain` again. |
+| `setView` *required* | `(view: `[`ChartView`](#/view/type-ChartView)`) => void` | — | Goes to a whole view; what it leaves out is shown whole again. Not reported through `onViewChange`: two charts kept in step by `onViewChange: (v) => other.setView(v)` in both directions do not answer each other. A view with the content already shown changes nothing.<br>Shown in: [Read it by keyboard and screen reader (Chart)](#/chart/keyboard-and-screen-reader), [Keep charts in step (Zoom and pan)](#/zoom-and-pan/cursor-sync), [Keep and restore a view (View)](#/view/keep-and-restore) |
+| `setDomain` *required* | `(axisId: string, span: readonly [number, number] \| null) => void` | — | Puts a span in view on a zoomable x axis - a lone one is `"x"`; `null` shows the axis' own `domain` again.<br>Shown in: [Measure a million points (Benchmark)](#/benchmark/benchmark) |
 | `hidden` *required* | `readonly string[]` | — | The hidden series, by `name`. |
 | `toggleSeries` *required* | `(name: string) => void` | — | Hides the series `name`, or shows it where it is hidden - as a click on its legend entry does. Hiding the last series visible shows all. |
 | `showOnly` *required* | `(name: string) => void` | — | Hides every series but `name`; all are shown where none carries it.<br>Shown in: [Hide a series from the legend (Legend)](#/legend/hide-a-series) |
 | `showAllSeries` *required* | `() => void` | — | Shows every series again.<br>Shown in: [Hide a series from the legend (Legend)](#/legend/hide-a-series) |
 
+Used on [Chart](#/chart).
+
 ##### `ChartPerf`
 
 Measurements of the instrumentation for the benchmark page.
@@ -11183,6 +11136,7 @@ Everything the charts put out as text.
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
+| `locale` *required* | `string` | — | The BCP 47 tag every number and every date or time label of the chart is formatted in (`en-GB`, `de-DE`). The one input for the locale: the browser's language is not read. The clock stays 24-hour in both. |
 | `roleDescription` *required* | `string` | — | What a screen reader calls the plot area that takes the keys (`aria-roledescription`). |
 | `empty` *required* | `string` | — | Shown in the plot area when no visible series has a point to show. |
 | `seriesList` *required* | `(names: readonly string[]) => string` | — | The summary's visible series, by name. |
@@ -11190,15 +11144,15 @@ Everything the charts put out as text.
 | `seriesExtent` *required* | `(name: string, min: string, max: string) => string` | — | The summary's lowest and highest value of one series in that stretch. |
 | `limitList` *required* | `(limits: readonly { name: string; value: string }[]) => string` | — | The summary's labelled limits, each with its value in its axis' format (a band's two edges as one value). |
 | `readout` *required* | `(x: string, rows: readonly { name: string; value: string; x: string }[]) => string` | — | What is read after a key: the position, then each series with its value (and its own x where it stands on another x axis), the emphasised one first. |
-| `stackTotal` *required* | `string` | — | The last row of a stack in the tooltip and the readout: the sum of its members at the point (charts-stacking K4). |
-| `percent` *required* | `(value: string) => string` | — | A share in a normalised stack, its number already formatted (K5). |
+| `stackTotal` *required* | `string` | — | The last row of a stack in the tooltip and the readout: the sum of its members at the point. |
+| `percent` *required* | `(value: string) => string` | — | A share in a normalised stack, its number already formatted. |
 | `walkHelp` *required* | `string` | — | The keys that walk the chart. |
 | `selectHelp` *required* | `string` | — | The key that reports the Active point - only where `onSelect` is given. |
 | `zoomHelp` *required* | `string` | — | The keys that zoom and pan it - only where the chart can be zoomed. |
 | `legendHelp` *required* | `string` | — | The keys of the legend's entries - only where it has one to press. |
 | `allShown` *required* | `string` | — | Read out where hiding would leave nothing to see, and every series is shown instead. |
 | `showAll` *required* | `string` | — | The control over a zoomed plot that brings every zoomed axis back to its own domain (component-view 04). |
-| `showData` *required* | `string` | — | The data table's disclosure key, closed and open (charts-alternatives C1). |
+| `showData` *required* | `string` | — | The data table's disclosure key, closed and open. |
 | `hideData` *required* | `string` | — |  |
 | `positionColumn` *required* | `string` | — | The heading of the table's x column where its axis has no `label`, and of a matrix' row column where its y axis has none. |
 | `rowColumn` *required* | `string` | — |  |
@@ -11213,13 +11167,13 @@ Everything the charts put out as text.
 | `notch` *required* | `string` | — |  |
 | `count` *required* | `string` | — |  |
 | `outlierList` *required* | `(values: readonly string[], more: number) => string` | — |  |
-| `downsampled` *required* | `(readings: number) => string` | — | Added to the caption where the table shows the downsampled course (C2): how many readings its rows stand for. |
+| `downsampled` *required* | `(readings: number) => string` | — | Added to the caption where the table shows the downsampled course: how many readings its rows stand for. |
 
 ##### `ChartView`
 
 Its table stands on [View](#/view/type-ChartView).
 
-Used on [Chart](#/chart), [Zoom and pan](#/zoom-and-pan) and [View](#/view).
+Used on [Zoom and pan](#/zoom-and-pan) and [View](#/view).
 
 ##### `ControlChartProps`
 
@@ -11296,7 +11250,7 @@ to `to`.
 | `kind` *required* | `"band"` | — |  |
 | `from` *required* | `number` | — |  |
 | `to` *required* | `number` | — |  |
-| `axisId` | `string` | — | Axis on which the value lies; without one, the first axis of its orientation (charts-fixes 08). From `LimitBase`. |
+| `axisId` | `string` | — | Axis on which the value lies; without one, the first axis of its orientation. From `LimitBase`. |
 | `orientation` *required* | [`AxisOrientation`](#type-AxisOrientation)<br>`"x" \| "y"` | — |  From `LimitBase`. |
 | `severity` *required* | [`Severity`](#type-Severity)<br>`"warning" \| "alarm"` | — |  From `LimitBase`. |
 | `label` | `string` | — |  From `LimitBase`. |
@@ -11329,7 +11283,7 @@ A `LimitLine` as the chart holds it once registered.
 |---|---|---|---|
 | `kind` *required* | `"line"` | — |  |
 | `value` *required* | `number` | — |  |
-| `axisId` | `string` | — | Axis on which the value lies; without one, the first axis of its orientation (charts-fixes 08). From `LimitBase`. |
+| `axisId` | `string` | — | Axis on which the value lies; without one, the first axis of its orientation. From `LimitBase`. |
 | `orientation` *required* | [`AxisOrientation`](#type-AxisOrientation)<br>`"x" \| "y"` | — |  From `LimitBase`. |
 | `severity` *required* | [`Severity`](#type-Severity)<br>`"warning" \| "alarm"` | — |  From `LimitBase`. |
 | `label` | `string` | — |  From `LimitBase`. |
@@ -11553,7 +11507,7 @@ The settings of `pareto`, complete; a call gives `ParetoSettings`.
 |---|---|---|---|
 | `cutoff` *required* | `number` | `0.8` | The share whose crossing is sought. Whoever lands exactly on it counts as the crossing: the question is "which reasons make up eighty per cent", and whoever reaches eighty exactly belongs to them. |
 | `collectRank` *required* | `number` | `Infinity` | How many items stay on their own. Everything behind that becomes a single entry. Beyond the number of items no remainder arises at all - not an empty one. |
-| `remainderName` | `string` | none - the caller names it | Name of the collected remainder. `@umriss-ui/charts` has no wording module - every string it draws comes from the caller - and no module is introduced for a single label. Until library-audit 03 the name here was "Sonstige", the one German word the package brought along itself. |
+| `remainderName` | `string` | none - the caller names it | Name of the collected remainder. The helper has no default wording for it. |
 
 ##### `ParetoResult`