@umriss-ui/charts 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -29,6 +29,53 @@ interface was still expected to move before `0.3.0`.
 
 ---
 
+## 0.15.0 – A chosen hit, a histogram, and zoom keys without a tooltip (Oct. 2026)
+
+### Changed
+
+- **A chart with a zoomable x axis is one tab stop even without a
+  `<Tooltip>`** (ADR-0030). Its plot is `role="application"` with the role
+  description "chart" and takes the focus, so `+`, `-`, Shift+←/→ and `0`
+  reach a keyboard. There is no Active point to walk: the arrows without Shift
+  do nothing. After a zoom or pan key the polite live region reads the span in
+  view ("From 10 to 90."); the summary names the zoom keys and not the walk's.
+  A chart with a tooltip, and one with neither, are unchanged.
+- **The summary names the labelled limits.** A chart with a `LimitLine` or
+  `LimitBand` that has a `label` adds "Limits: Objective 300 ms, Warning band
+  250 ms – 300 ms." to the text the plot is described by - each value in its own
+  axis' format, a band's two edges as one value. A limit without a label is left
+  out; a chart without labelled limits reads as before. The wording has a new
+  entry, `limitList`, so a custom `ChartsWording` needs it.
+
+### Added
+
+- **`bin()`**, the arithmetic behind a histogram: `bin(values, { width, count,
+  domain })`, or `bin(rows, value, options)`, returns rows with `from`, `to`,
+  the middle `x` and `count` for a `Bar` on a numeric x axis. The edges are on
+  the 1-2-5 grid of the ticks; a value on an edge falls into the bin that edge
+  starts, the last bin is closed, and what is not a finite number is skipped.
+  A given `domain` is taken as it is, and values outside it are left out.
+  Exports `Bin` and `BinOptions`. One example, "Count readings into a
+  histogram", on the Bar page.
+- **`<Tooltip limits />`**, off by default: the built-in tooltip adds one row
+  per labelled limit of the hit's y axis, its label and value in that axis'
+  format, and what a key reads out says the same. One example on the Tooltip
+  page.
+- **`onSelect`**, an option of `useChart(rows, { onSelect })`: a click or a tap
+  on a hit, and Enter on the Active point, call it with the hit - the
+  `TooltipHit` a custom tooltip's `render` receives, typed at the row. Once per
+  click; the end of a drag that pans does not report, a double click reports on
+  its first click and then resets the zoom as before. The chart holds no
+  selection and draws none: what is chosen is the application's state. It
+  needs a `<Tooltip>` for its hits (the development build warns without) and
+  the hit does not travel over `syncId`. Where it is given, the summary names
+  Enter; the wording has a new entry, `selectHelp`, so a custom
+  `ChartsWording` needs it. `ChartOptions` takes the row type as a parameter
+  (`ChartOptions<Z>`, default `unknown`). One example, "Choose a hit", on the
+  Tooltip page.
+
+---
+
 ## 0.14.0 – A chart reads its rows as they come (Oct. 2026)
 
 A chart takes rows as an application has them (ADR-0052). A category is a

package/README.md

@@ -66,8 +66,11 @@ the chart takes it away; a finger swiping over the chart scrolls the page.
 
 **By keyboard and screen reader**, a chart with a `<Tooltip>` is one tab stop:
 the arrows walk its values, ↑/↓ choose the series read first, and a screen
-reader hears each value once the keys rest and a summary of the whole. The
-words are English; German comes from its own subpath:
+reader hears each value once the keys rest and a summary of the whole. A chart
+with a zoomable x axis is one as well, without a tooltip: there is nothing to
+walk, and plus, minus, Shift with an arrow and 0 zoom and pan it. `onSelect` on
+`useChart` hears a click on a hit and Enter on the walked one; the chart keeps
+no selection. The words are English; German comes from its own subpath:
 
 ```tsx
 import { GERMAN_CHARTS_WORDING } from "@umriss-ui/charts/wording/de";
@@ -114,8 +117,9 @@ loaded: Geist when the application has it, the system fonts otherwise.
   and dims a course already drawn, and where there is nothing yet a
   silhouette of the chart to come shimmers in the plot (ADR-0042).
 * **The instruments**: `LimitLine` and `LimitBand`, `ControlChart` with its four
-  rule violations, `pareto()` with a collected remainder, and a working-time
-  axis that takes the empty hours out and marks every removed span.
+  rule violations, `pareto()` with a collected remainder, `bin()` for a
+  histogram, and a working-time axis that takes the empty hours out and marks
+  every removed span. `<Tooltip limits />` reads the labelled limits at a hit.
 * **The pure modules are exported**, not hidden: `assess`, `controlLimits`,
   `zones`, `violations`, `pareto`, `workingCalendar` and the rest. Whoever
   wants to draw something other than the composition offers should reach the