@fusion.dev/helix 0.176.1 → 0.177.0

package/types/jsx.d.ts

@@ -1696,6 +1696,13 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
 and an element that is not hit-testable never receives the `pointermove`
 this listens for. Asking for the pointer is asking for the hit test. */
   interactive?: (HelixAura["interactive"]) | undefined;
+  /** Whether the field holds still on the frame it shows.
+
+Set it from a pause control on your page, so a reader can stop the motion,
+as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
+change to another property still repaints the frame. Clearing it starts
+the field from where it stopped. */
+  paused?: (HelixAura["paused"]) | undefined;
   /** How far the pointer reaches into the field, `0` upward.
 
 Multiplied into the presence the pointer already fades in and out with, so
@@ -1808,6 +1815,13 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
 and an element that is not hit-testable never receives the `pointermove`
 this listens for. Asking for the pointer is asking for the hit test. */
   "prop:interactive"?: (HelixAura["interactive"]) | undefined;
+  /** Whether the field holds still on the frame it shows.
+
+Set it from a pause control on your page, so a reader can stop the motion,
+as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
+change to another property still repaints the frame. Clearing it starts
+the field from where it stopped. */
+  "prop:paused"?: (HelixAura["paused"]) | undefined;
   /** How far the pointer reaches into the field, `0` upward.
 
 Multiplied into the presence the pointer already fades in and out with, so
@@ -14216,6 +14230,18 @@ Unset is horizontal, or across the toolbar the divider sits in. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixDonutChart` component event */
+export type HelixDonutChartElementEvent<E = Event> = TypedEvent<
+  HelixDonutChart,
+  E
+>;
+/** `helix-reading-change` event type */
+export type HelixDonutChartHelixReadingChangeElementEvent =
+  HelixDonutChartElementEvent<HelixReadingChangeEvent>;
+/** `helix-reading-press` event type */
+export type HelixDonutChartHelixReadingPressElementEvent =
+  HelixDonutChartElementEvent<HelixReadingPressEvent>;
+
 export type HelixDonutChartProps = {
   /** How strongly the slices are drawn.
 
@@ -14258,6 +14284,25 @@ chart and a card mean the same thing by the word.
 material choice, it is an absent series, and a chart says that by not
 having the datum rather than by painting it invisibly. */
   material?: (HelixDonutChart["material"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  "empty-text"?: (HelixDonutChart["emptyText"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  emptyText?: (HelixDonutChart["emptyText"]) | undefined;
+  /** Whether the readings are still on their way. The chart shows
+`loading-text` in place of an empty drawing until it has readings.
+
+Reflected, so a stylesheet can treat the chart while it waits. A chart
+that already has readings keeps drawing them, so a refresh does not
+blank it. */
+  loading?: (HelixDonutChart["loading"]) | undefined;
+  /** The words shown in place of the drawing while `loading` is set and
+there are no readings yet, and the fallback of the `loading` slot. */
+  "loading-text"?: (HelixDonutChart["loadingText"]) | undefined;
+  /** The words shown in place of the drawing while `loading` is set and
+there are no readings yet, and the fallback of the `loading` slot. */
+  loadingText?: (HelixDonutChart["loadingText"]) | undefined;
   /** The id of the table to read.
 
 Names a table in the same tree, so a chart inside another component's
@@ -14381,6 +14426,15 @@ frame, and the summary, the keys and the readout are then the whole of
 what a screen reader is given. Set a new object to redraw: the chart
 does not look inside the one it has. */
   data?: (HelixDonutChart["data"]) | undefined;
+
+  /** The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it. */
+  "onhelix-reading-change"?: ((
+    e: HelixDonutChartHelixReadingChangeElementEvent,
+  ) => void) | undefined;
+  /** A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
+  "onhelix-reading-press"?: ((
+    e: HelixDonutChartHelixReadingPressElementEvent,
+  ) => void) | undefined;
 };
 
 export type HelixDonutChartSolidJsProps = {
@@ -14425,6 +14479,25 @@ chart and a card mean the same thing by the word.
 material choice, it is an absent series, and a chart says that by not
 having the datum rather than by painting it invisibly. */
   "prop:material"?: (HelixDonutChart["material"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  "attr:empty-text"?: (HelixDonutChart["emptyText"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  "prop:emptyText"?: (HelixDonutChart["emptyText"]) | undefined;
+  /** Whether the readings are still on their way. The chart shows
+`loading-text` in place of an empty drawing until it has readings.
+
+Reflected, so a stylesheet can treat the chart while it waits. A chart
+that already has readings keeps drawing them, so a refresh does not
+blank it. */
+  "prop:loading"?: (HelixDonutChart["loading"]) | undefined;
+  /** The words shown in place of the drawing while `loading` is set and
+there are no readings yet, and the fallback of the `loading` slot. */
+  "attr:loading-text"?: (HelixDonutChart["loadingText"]) | undefined;
+  /** The words shown in place of the drawing while `loading` is set and
+there are no readings yet, and the fallback of the `loading` slot. */
+  "prop:loadingText"?: (HelixDonutChart["loadingText"]) | undefined;
   /** The id of the table to read.
 
 Names a table in the same tree, so a chart inside another component's
@@ -14548,6 +14621,14 @@ frame, and the summary, the keys and the readout are then the whole of
 what a screen reader is given. Set a new object to redraw: the chart
 does not look inside the one it has. */
   "prop:data"?: (HelixDonutChart["data"]) | undefined;
+  /** The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it. */
+  "on:helix-reading-change"?: ((
+    e: HelixDonutChartHelixReadingChangeElementEvent,
+  ) => void) | undefined;
+  /** A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
+  "on:helix-reading-press"?: ((
+    e: HelixDonutChartHelixReadingPressElementEvent,
+  ) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -17140,6 +17221,14 @@ own, since the fallback name is the same word. Empty leaves the role. */
   "selected-label"?: (HelixGraph["selectedLabel"]) | undefined;
   /** How the selected note is described in the list. */
   selectedLabel?: (HelixGraph["selectedLabel"]) | undefined;
+  /** What screen readers hear after a reader selects a note, in the list or in
+the drawing, with `{note}` for its name and `{count}` for how many notes
+the list then holds, written with `count-label`. */
+  "selection-label"?: (HelixGraph["selectionLabel"]) | undefined;
+  /** What screen readers hear after a reader selects a note, in the list or in
+the drawing, with `{note}` for its name and `{count}` for how many notes
+the list then holds, written with `count-label`. */
+  selectionLabel?: (HelixGraph["selectionLabel"]) | undefined;
   /** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
   "two-finger-hint-label"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
   /** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
@@ -17459,6 +17548,14 @@ own, since the fallback name is the same word. Empty leaves the role. */
   "attr:selected-label"?: (HelixGraph["selectedLabel"]) | undefined;
   /** How the selected note is described in the list. */
   "prop:selectedLabel"?: (HelixGraph["selectedLabel"]) | undefined;
+  /** What screen readers hear after a reader selects a note, in the list or in
+the drawing, with `{note}` for its name and `{count}` for how many notes
+the list then holds, written with `count-label`. */
+  "attr:selection-label"?: (HelixGraph["selectionLabel"]) | undefined;
+  /** What screen readers hear after a reader selects a note, in the list or in
+the drawing, with `{note}` for its name and `{count}` for how many notes
+the list then holds, written with `count-label`. */
+  "prop:selectionLabel"?: (HelixGraph["selectionLabel"]) | undefined;
   /** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
   "attr:two-finger-hint-label"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
   /** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
@@ -17876,8 +17973,9 @@ no order in it. */
   /** The name the `overview` gives the total of the readings drawn,
 `{totalLabel}` in `overview-label`. */
   totalLabel?: (HelixHeatmap["totalLabel"]) | undefined;
-  /** The selected cells, by the names their rows have in the table, such as
-`2026-06-11`, separated by commas.
+  /** The selected cells, separated by commas: each by the date its row's
+header carries in a `<time datetime>`, such as `2026-06-11`, or by the
+header's words where it carries none.
 
 Set it to start with cells selected. Written by a press or a key under
 `selection-mode`. */
@@ -18082,8 +18180,9 @@ no order in it. */
   /** The name the `overview` gives the total of the readings drawn,
 `{totalLabel}` in `overview-label`. */
   "prop:totalLabel"?: (HelixHeatmap["totalLabel"]) | undefined;
-  /** The selected cells, by the names their rows have in the table, such as
-`2026-06-11`, separated by commas.
+  /** The selected cells, separated by commas: each by the date its row's
+header carries in a `<time datetime>`, such as `2026-06-11`, or by the
+header's words where it carries none.
 
 Set it to start with cells selected. Written by a press or a key under
 `selection-mode`. */
@@ -21900,6 +21999,10 @@ loader is on the page.
 Names an element in the same tree. In React it arrives as a property, the
 way `Tooltip.for` does. */
   for?: (HelixLoader["for"]) | undefined;
+  /** Whether no work is in progress. The loader draws nothing of its own, has
+no role, and marks no region busy, and what is in the `content` slot
+shows. Clearing it starts `delay` again. */
+  idle?: (HelixLoader["idle"]) | undefined;
   /** The loader's name, announced by screen readers while the work is in
 progress. */
   label?: (HelixLoader["label"]) | undefined;
@@ -21930,6 +22033,10 @@ loader is on the page.
 Names an element in the same tree. In React it arrives as a property, the
 way `Tooltip.for` does. */
   "prop:for"?: (HelixLoader["for"]) | undefined;
+  /** Whether no work is in progress. The loader draws nothing of its own, has
+no role, and marks no region busy, and what is in the `content` slot
+shows. Clearing it starts `delay` again. */
+  "prop:idle"?: (HelixLoader["idle"]) | undefined;
   /** The loader's name, announced by screen readers while the work is in
 progress. */
   "prop:label"?: (HelixLoader["label"]) | undefined;
@@ -31994,6 +32101,18 @@ cannot be written in an attribute. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixSparkline` component event */
+export type HelixSparklineElementEvent<E = Event> = TypedEvent<
+  HelixSparkline,
+  E
+>;
+/** `helix-reading-change` event type */
+export type HelixSparklineHelixReadingChangeElementEvent =
+  HelixSparklineElementEvent<HelixReadingChangeEvent>;
+/** `helix-reading-press` event type */
+export type HelixSparklineHelixReadingPressElementEvent =
+  HelixSparklineElementEvent<HelixReadingPressEvent>;
+
 export type HelixSparklineProps = {
   /** How strongly the line, area, or columns are drawn.
 
@@ -32177,6 +32296,15 @@ with `values={[1240, 1318]}`. The attribute is the form to prefer, because
 a string is what survives React's hydration where an array property does
 not. */
   values?: (HelixSparkline["values"]) | undefined;
+
+  /** The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it. */
+  "onhelix-reading-change"?: ((
+    e: HelixSparklineHelixReadingChangeElementEvent,
+  ) => void) | undefined;
+  /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
+  "onhelix-reading-press"?: ((
+    e: HelixSparklineHelixReadingPressElementEvent,
+  ) => void) | undefined;
 };
 
 export type HelixSparklineSolidJsProps = {
@@ -32362,6 +32490,14 @@ with `values={[1240, 1318]}`. The attribute is the form to prefer, because
 a string is what survives React's hydration where an array property does
 not. */
   "prop:values"?: (HelixSparkline["values"]) | undefined;
+  /** The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it. */
+  "on:helix-reading-change"?: ((
+    e: HelixSparklineHelixReadingChangeElementEvent,
+  ) => void) | undefined;
+  /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
+  "on:helix-reading-press"?: ((
+    e: HelixSparklineHelixReadingPressElementEvent,
+  ) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -35295,8 +35431,9 @@ Absent selects nothing, and the tags carry no selected state at all. */
 
 Absent selects nothing, and the tags carry no selected state at all. */
   selectionMode?: (HelixTagGroup["selectionMode"]) | undefined;
-  /** The selected tags' values, separated by commas, since a value may hold a
-space.
+  /** The selected tags' values, separated by commas with no space, as Toggle
+Group and Table write theirs, since a value may hold a space. A value
+written with a space after each comma is read the same way.
 
 Set it to start with tags selected. A tag's value is its `value`, or its
 words where it has none. */
@@ -35352,8 +35489,9 @@ Absent selects nothing, and the tags carry no selected state at all. */
 
 Absent selects nothing, and the tags carry no selected state at all. */
   "prop:selectionMode"?: (HelixTagGroup["selectionMode"]) | undefined;
-  /** The selected tags' values, separated by commas, since a value may hold a
-space.
+  /** The selected tags' values, separated by commas with no space, as Toggle
+Group and Table write theirs, since a value may hold a space. A value
+written with a space after each comma is read the same way.
 
 Set it to start with tags selected. A tag's value is its `value`, or its
 words where it has none. */
@@ -42593,12 +42731,6 @@ export type CustomElements = {
    *
    * Absent draws none: bands read as a composition need no numbers beside
    * them, and the tooltip and the table hold every reading.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -42637,21 +42769,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -42697,8 +42814,6 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -42758,9 +42873,10 @@ export type CustomElements = {
    * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
    * - `svg`: The drawing surface the bands sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
@@ -42783,6 +42899,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-area-chart": Partial<
@@ -42807,6 +42926,8 @@ export type CustomElements = {
    * The shader stops drawing in these cases:
    * - The element is off screen or in a background tab.
    * - `prefers-reduced-motion` is set. The element shows one still frame.
+   * - `paused` is set, from a pause control on your page. The element holds the
+   *   frame it shows.
    * - The browser takes back the drawing context, on a GPU reset or past its
    *   limit of about sixteen contexts. The gradient shows until the context
    *   returns.
@@ -42869,6 +42990,12 @@ export type CustomElements = {
    * hit-testable at rest, or it would swallow clicks meant for what is over it,
    * and an element that is not hit-testable never receives the `pointermove`
    * this listens for. Asking for the pointer is asking for the hit test.
+   * - `paused`: Whether the field holds still on the frame it shows.
+   *
+   * Set it from a pause control on your page, so a reader can stop the motion,
+   * as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
+   * change to another property still repaints the frame. Clearing it starts
+   * the field from where it stopped.
    * - `reach`: How far the pointer reaches into the field, `0` upward.
    *
    * Multiplied into the presence the pointer already fades in and out with, so
@@ -43172,7 +43299,7 @@ export type CustomElements = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: Replaces the image and initials entirely, for an icon.
+   * - `(default)`: Shown when there is no usable image, in place of the initials, for an icon. Hidden from assistive technology when the avatar has a `name`, which the host announces.
    *
    * ## CSS Custom Properties
    *
@@ -43586,12 +43713,6 @@ export type CustomElements = {
    *
    * Absent draws none with one scale, since bars compared with each other need
    * no numbers. With `secondary` both scales are drawn whatever this says.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -43630,21 +43751,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -43690,8 +43796,6 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -43759,9 +43863,10 @@ export type CustomElements = {
    * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
    * - `svg`: The drawing surface the bars and lines sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tick`: One number on an axis.
    * - `tooltip`: The tooltip bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
@@ -43784,6 +43889,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-bar-chart": Partial<
@@ -44945,6 +45053,10 @@ export type CustomElements = {
    * that one transform reads, so the cards are placed once in the document's
    * coordinates and are not laid out again.
    *
+   * The [Canvases](https://fusion.dev/helix/docs/canvases) guide loads and saves
+   * a board, keeps it in your state, and lists every key and the roles a screen
+   * reader meets.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -50734,6 +50846,16 @@ export type CustomElements = {
    * **`transparent` is where this one stops.** A mark with no ink is not a
    * material choice, it is an absent series, and a chart says that by not
    * having the datum rather than by painting it invisibly.
+   * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
+   * and the fallback of the `empty` slot.
+   * - `loading`: Whether the readings are still on their way. The chart shows
+   * `loading-text` in place of an empty drawing until it has readings.
+   *
+   * Reflected, so a stylesheet can treat the chart while it waits. A chart
+   * that already has readings keeps drawing them, so a refresh does not
+   * blank it.
+   * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
+   * there are no readings yet, and the fallback of the `loading` slot.
    * - `for`: The id of the table to read.
    *
    * Names a table in the same tree, so a chart inside another component's
@@ -50811,12 +50933,6 @@ export type CustomElements = {
    * rotation that puts the first slice at nine o'clock, the aspect ratio of a
    * box that is no longer square, and where the middle sits once the bottom of
    * the circle is not drawn.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -50855,21 +50971,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -50897,18 +50998,25 @@ export type CustomElements = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `helix-reading-change`: The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it.
+   * - `helix-reading-press`: A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
+   *
    * ## Slots
    *
    * Areas where markup can be added to the component.
    *
    * - `(default)`: Content in the middle of the ring, usually a total. It is read by screen readers, while the ring itself is hidden from them.
+   * - `empty`: Content shown in place of the ring when the table has no readings. Falls back to `empty-text`.
+   * - `loading`: Content shown in place of the ring while `loading` is set and there are no readings yet. Falls back to `loading-text`.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -50958,14 +51066,17 @@ export type CustomElements = {
    * Custom selectors for styling elements within the component.
    *
    * - `center`: The middle of the ring, holding whatever is slotted.
+   * - `empty`: The words in place of the ring when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
    * - `live`: The readout: a polite live region that says the slice the keys moved to. Hide it visually.
+   * - `loading`: The words in place of the ring while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `segment`: One slice.
    * - `segment-active`: The slice under the pointer. Set alongside `segment`.
    * - `segment-edge`: One slice as a closed shape, used to draw its outline.
    * - `slice-label`: One slice's share, written on the slice under `slice-labels`. Placed with `left` and `top`, or `inset-inline-start` and `top` on a half ring, and carries its series color as `--chart-series`.
    * - `summary`: The chart's name and each slice's share, written as a sentence for screen readers. Hide it visually.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
    * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -50988,6 +51099,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a slice is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in place of the ring.
+   * - `loading`: While the `loading` part stands in place of the ring.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-donut-chart": Partial<
@@ -52898,6 +53012,10 @@ export type CustomElements = {
    * `no-panel`, the drawing takes the whole frame, and a button among the
    * controls opens the search and the list over its end.
    *
+   * The [Graphs](https://fusion.dev/helix/docs/graphs) guide connects a
+   * renderer, lists the keys and what a screen reader hears, and describes the
+   * methods of a driver for another renderer.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -53024,6 +53142,9 @@ export type CustomElements = {
    * own, since the fallback name is the same word. Empty leaves the role.
    * - `search-label`/`searchLabel`: The search field's name.
    * - `selected-label`/`selectedLabel`: How the selected note is described in the list.
+   * - `selection-label`/`selectionLabel`: What screen readers hear after a reader selects a note, in the list or in
+   * the drawing, with `{note}` for its name and `{count}` for how many notes
+   * the list then holds, written with `count-label`.
    * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
    * - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
    * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
@@ -53174,7 +53295,7 @@ export type CustomElements = {
    * - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
    * - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
    * - `header`: The strip above the graph.
-   * - `legend`: The groups over the drawing, with `legend`, each a button that shows or hides its notes.
+   * - `legend`: The groups over the drawing, with `legend`: a toolbar of buttons, each showing or hiding its notes, which is one tab stop.
    * - `legend-item`: One group in the legend, pressed while its notes are shown. Carries `data-tone` where every note in the group has the same tone, which colors the notes over the group's own color.
    * - `legend-item-hidden`: A group in the legend whose notes are hidden.
    * - `legend-swatch`: The mark in a group's color, before its name.
@@ -53435,17 +53556,12 @@ export type CustomElements = {
    * no order in it.
    * - `total-label`/`totalLabel`: The name the `overview` gives the total of the readings drawn,
    * `{totalLabel}` in `overview-label`.
-   * - `value`: The selected cells, by the names their rows have in the table, such as
-   * `2026-06-11`, separated by commas.
+   * - `value`: The selected cells, separated by commas: each by the date its row's
+   * header carries in a `<time datetime>`, such as `2026-06-11`, or by the
+   * header's words where it carries none.
    *
    * Set it to start with cells selected. Written by a press or a key under
    * `selection-mode`.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -53484,21 +53600,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -53560,8 +53661,6 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -53654,11 +53753,14 @@ export type CustomElements = {
    * - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
    * - `start`: The leading slot's box.
    * - `summary`: The middle slot's box.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    *
    * ## CSS States
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in place of the cells.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-heatmap": Partial<
@@ -55367,12 +55469,6 @@ export type CustomElements = {
    * Set it where the distance from nothing is the point rather than the shape,
    * and accept that a series which never approaches zero becomes a flat rule
    * near the top of the box.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -55411,21 +55507,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -55471,8 +55552,6 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -55543,9 +55622,10 @@ export type CustomElements = {
    * - `mark`: The invisible point the tooltip is anchored to.
    * - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
    * - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
    * - `svg`: The drawing surface the lines and areas sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `terminus`: The mark on one series' last reading.
    * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
@@ -55569,6 +55649,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-line-chart": Partial<
@@ -56300,6 +56383,9 @@ export type CustomElements = {
    * While `delay` runs, the loader keeps its size and draws nothing, so the line
    * it sits in does not move when it appears.
    *
+   * With something in the `content` slot, the loader takes the larger of the ring
+   * and the content, and the ring centers over the content while the work runs.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -56324,6 +56410,9 @@ export type CustomElements = {
    *
    * Names an element in the same tree. In React it arrives as a property, the
    * way `Tooltip.for` does.
+   * - `idle`: Whether no work is in progress. The loader draws nothing of its own, has
+   * no role, and marks no region busy, and what is in the `content` slot
+   * shows. Clearing it starts `delay` again.
    * - `label`: The loader's name, announced by screen readers while the work is in
    * progress.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -56352,13 +56441,14 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: An icon or logo that stays still at the center. Empty by default.
+   * - `content`: What the loader stands in for while the work runs, such as a button. It keeps its size, hidden and inert, until `idle` is set.
    *
    * ## CSS Custom Properties
    *
    * CSS variables available for styling the component.
    *
    * - `--loader-color`: Color of the moving arc.
-   * - `--loader-duration`: How long one turn of the arc takes, 0.8s by default. With motion reduced the turn slows to a crawl whatever this says.
+   * - `--loader-duration`: How long one turn of the arc takes, 0.8s by default. With motion reduced the arc turns once every four seconds, whatever this says.
    * - `--loader-size`: Diameter. Defaults to the size token that `size` picks, which is 1.5rem at the default density.
    * - `--loader-track-color`: Color of the circle behind the arc.
    * - `--loader-track-width`: Width of the arc and the circle behind it, in units of a 24-unit drawing. Defaults to 2.
@@ -56367,6 +56457,7 @@ export type CustomElements = {
    *
    * Custom selectors for styling elements within the component.
    *
+   * - `content`: The box that holds the `content` slot. Hidden while the work runs, and shown while `idle` is set.
    * - `indicator`: The arc that turns.
    * - `mark`: The region that holds the slotted content at the center.
    * - `svg`: The rotating circle pair.
@@ -56977,6 +57068,10 @@ export type CustomElements = {
    * to draw the map's credit compact in a corner over the map, which suits a
    * map the width of the page.
    *
+   * The [Maps](https://fusion.dev/helix/docs/maps) guide connects a renderer,
+   * lists the keys and what a screen reader hears, and describes every method
+   * a driver for another renderer can have.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -63055,12 +63150,6 @@ export type CustomElements = {
    * Absent draws none. A series with fewer than two points, or with every
    * point at one measure across, has no line to draw. The summary already
    * gives each series' correlation, which says how near the points are to it.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -63099,21 +63188,6 @@ export type CustomElements = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -63159,8 +63233,6 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -63219,11 +63291,12 @@ export type CustomElements = {
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
    * - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `point`: One row, as a point.
    * - `point-active`: A point in the row under the pointer. Set alongside `point`.
    * - `summary`: The text that says how strongly the measures relate, for people who cannot see the points.
    * - `svg`: The drawing surface the gridlines and the trend lines sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
    * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -63243,7 +63316,7 @@ export type CustomElements = {
    * - `trend`: One series' line of best fit, under `trend`. Carries its series color as `--chart-series`.
    * - `x-axis`: The values along the horizontal axis, under the plot.
    * - `x-name`: The name of the horizontal measure.
-   * - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on.
+   * - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on. The one at the far edge carries `data-edge="end"`.
    * - `y-axis`: The values along the vertical axis, beside the plot.
    * - `y-name`: The name of the vertical measure.
    * - `y-tick`: One labeled value on the vertical axis.
@@ -63252,6 +63325,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-scatter-chart": Partial<
@@ -64425,8 +64501,6 @@ export type CustomElements = {
    * with `values={[1240, 1318]}`. The attribute is the form to prefer, because
    * a string is what survives React's hydration where an array property does
    * not.
-   * - `pointer`: Finds the reading a pointer or a key rests on, as it does for every
-   * chart, so a sparkline is read the way they are. (property only) (readonly)
    * - `named`: The drawing's name: an `aria-label` written on the sparkline, then `label`. (property only) (readonly)
    * - `readings`: How many readings there are, which the pointer and the keys walk. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -64450,11 +64524,12 @@ export type CustomElements = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
-   * ## Methods
+   * ## Events
    *
-   * Methods that can be called to access component functionality.
+   * Events that will be emitted by the component.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes; a new `aria-label` renames the drawing.
+   * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it.
+   * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
    *
    * ## CSS Custom Properties
    *
@@ -66920,8 +66995,9 @@ export type CustomElements = {
    * - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
    *
    * Absent selects nothing, and the tags carry no selected state at all.
-   * - `value`: The selected tags' values, separated by commas, since a value may hold a
-   * space.
+   * - `value`: The selected tags' values, separated by commas with no space, as Toggle
+   * Group and Table write theirs, since a value may hold a space. A value
+   * written with a space after each comma is read the same way.
    *
    * Set it to start with tags selected. A tag's value is its `value`, or its
    * words where it has none.
@@ -70035,7 +70111,7 @@ export type CustomElements = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The item's label.
+   * - `(default)`: The item's label. A nested item does not go here: give it `slot="children"`. In a development build, an item nested here is reported.
    * - `chevron`: Replaces the expand and collapse mark of a branch. A slotted icon is sized and turned like the drawn one.
    * - `children`: Nested items, which make this a branch.
    * - `end`: Content after the label, at the far side of the row, such as a count or a state.
@@ -72178,12 +72254,6 @@ export type CustomElementsSolidJs = {
    *
    * Absent draws none: bands read as a composition need no numbers beside
    * them, and the tooltip and the table hold every reading.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -72222,21 +72292,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -72282,8 +72337,6 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -72343,9 +72396,10 @@ export type CustomElementsSolidJs = {
    * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
    * - `svg`: The drawing surface the bands sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
@@ -72368,6 +72422,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-area-chart": Partial<
@@ -72395,6 +72452,8 @@ export type CustomElementsSolidJs = {
    * The shader stops drawing in these cases:
    * - The element is off screen or in a background tab.
    * - `prefers-reduced-motion` is set. The element shows one still frame.
+   * - `paused` is set, from a pause control on your page. The element holds the
+   *   frame it shows.
    * - The browser takes back the drawing context, on a GPU reset or past its
    *   limit of about sixteen contexts. The gradient shows until the context
    *   returns.
@@ -72457,6 +72516,12 @@ export type CustomElementsSolidJs = {
    * hit-testable at rest, or it would swallow clicks meant for what is over it,
    * and an element that is not hit-testable never receives the `pointermove`
    * this listens for. Asking for the pointer is asking for the hit test.
+   * - `paused`: Whether the field holds still on the frame it shows.
+   *
+   * Set it from a pause control on your page, so a reader can stop the motion,
+   * as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
+   * change to another property still repaints the frame. Clearing it starts
+   * the field from where it stopped.
    * - `reach`: How far the pointer reaches into the field, `0` upward.
    *
    * Multiplied into the presence the pointer already fades in and out with, so
@@ -72765,7 +72830,7 @@ export type CustomElementsSolidJs = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: Replaces the image and initials entirely, for an icon.
+   * - `(default)`: Shown when there is no usable image, in place of the initials, for an icon. Hidden from assistive technology when the avatar has a `name`, which the host announces.
    *
    * ## CSS Custom Properties
    *
@@ -73187,12 +73252,6 @@ export type CustomElementsSolidJs = {
    *
    * Absent draws none with one scale, since bars compared with each other need
    * no numbers. With `secondary` both scales are drawn whatever this says.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -73231,21 +73290,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -73291,8 +73335,6 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -73360,9 +73402,10 @@ export type CustomElementsSolidJs = {
    * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
    * - `svg`: The drawing surface the bars and lines sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tick`: One number on an axis.
    * - `tooltip`: The tooltip bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
@@ -73385,6 +73428,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-bar-chart": Partial<
@@ -74573,6 +74619,10 @@ export type CustomElementsSolidJs = {
    * that one transform reads, so the cards are placed once in the document's
    * coordinates and are not laid out again.
    *
+   * The [Canvases](https://fusion.dev/helix/docs/canvases) guide loads and saves
+   * a board, keeps it in your state, and lists every key and the roles a screen
+   * reader meets.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -80423,6 +80473,16 @@ export type CustomElementsSolidJs = {
    * **`transparent` is where this one stops.** A mark with no ink is not a
    * material choice, it is an absent series, and a chart says that by not
    * having the datum rather than by painting it invisibly.
+   * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
+   * and the fallback of the `empty` slot.
+   * - `loading`: Whether the readings are still on their way. The chart shows
+   * `loading-text` in place of an empty drawing until it has readings.
+   *
+   * Reflected, so a stylesheet can treat the chart while it waits. A chart
+   * that already has readings keeps drawing them, so a refresh does not
+   * blank it.
+   * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
+   * there are no readings yet, and the fallback of the `loading` slot.
    * - `for`: The id of the table to read.
    *
    * Names a table in the same tree, so a chart inside another component's
@@ -80500,12 +80560,6 @@ export type CustomElementsSolidJs = {
    * rotation that puts the first slice at nine o'clock, the aspect ratio of a
    * box that is no longer square, and where the middle sits once the bottom of
    * the circle is not drawn.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -80544,21 +80598,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -80586,18 +80625,25 @@ export type CustomElementsSolidJs = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `helix-reading-change`: The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it.
+   * - `helix-reading-press`: A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
+   *
    * ## Slots
    *
    * Areas where markup can be added to the component.
    *
    * - `(default)`: Content in the middle of the ring, usually a total. It is read by screen readers, while the ring itself is hidden from them.
+   * - `empty`: Content shown in place of the ring when the table has no readings. Falls back to `empty-text`.
+   * - `loading`: Content shown in place of the ring while `loading` is set and there are no readings yet. Falls back to `loading-text`.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -80647,14 +80693,17 @@ export type CustomElementsSolidJs = {
    * Custom selectors for styling elements within the component.
    *
    * - `center`: The middle of the ring, holding whatever is slotted.
+   * - `empty`: The words in place of the ring when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
    * - `live`: The readout: a polite live region that says the slice the keys moved to. Hide it visually.
+   * - `loading`: The words in place of the ring while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `segment`: One slice.
    * - `segment-active`: The slice under the pointer. Set alongside `segment`.
    * - `segment-edge`: One slice as a closed shape, used to draw its outline.
    * - `slice-label`: One slice's share, written on the slice under `slice-labels`. Placed with `left` and `top`, or `inset-inline-start` and `top` on a half ring, and carries its series color as `--chart-series`.
    * - `summary`: The chart's name and each slice's share, written as a sentence for screen readers. Hide it visually.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
    * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -80677,6 +80726,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a slice is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in place of the ring.
+   * - `loading`: While the `loading` part stands in place of the ring.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-donut-chart": Partial<
@@ -82627,6 +82679,10 @@ export type CustomElementsSolidJs = {
    * `no-panel`, the drawing takes the whole frame, and a button among the
    * controls opens the search and the list over its end.
    *
+   * The [Graphs](https://fusion.dev/helix/docs/graphs) guide connects a
+   * renderer, lists the keys and what a screen reader hears, and describes the
+   * methods of a driver for another renderer.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -82753,6 +82809,9 @@ export type CustomElementsSolidJs = {
    * own, since the fallback name is the same word. Empty leaves the role.
    * - `search-label`/`searchLabel`: The search field's name.
    * - `selected-label`/`selectedLabel`: How the selected note is described in the list.
+   * - `selection-label`/`selectionLabel`: What screen readers hear after a reader selects a note, in the list or in
+   * the drawing, with `{note}` for its name and `{count}` for how many notes
+   * the list then holds, written with `count-label`.
    * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
    * - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
    * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
@@ -82903,7 +82962,7 @@ export type CustomElementsSolidJs = {
    * - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
    * - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
    * - `header`: The strip above the graph.
-   * - `legend`: The groups over the drawing, with `legend`, each a button that shows or hides its notes.
+   * - `legend`: The groups over the drawing, with `legend`: a toolbar of buttons, each showing or hiding its notes, which is one tab stop.
    * - `legend-item`: One group in the legend, pressed while its notes are shown. Carries `data-tone` where every note in the group has the same tone, which colors the notes over the group's own color.
    * - `legend-item-hidden`: A group in the legend whose notes are hidden.
    * - `legend-swatch`: The mark in a group's color, before its name.
@@ -83171,17 +83230,12 @@ export type CustomElementsSolidJs = {
    * no order in it.
    * - `total-label`/`totalLabel`: The name the `overview` gives the total of the readings drawn,
    * `{totalLabel}` in `overview-label`.
-   * - `value`: The selected cells, by the names their rows have in the table, such as
-   * `2026-06-11`, separated by commas.
+   * - `value`: The selected cells, separated by commas: each by the date its row's
+   * header carries in a `<time datetime>`, such as `2026-06-11`, or by the
+   * header's words where it carries none.
    *
    * Set it to start with cells selected. Written by a press or a key under
    * `selection-mode`.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -83220,21 +83274,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -83296,8 +83335,6 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -83390,11 +83427,14 @@ export type CustomElementsSolidJs = {
    * - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
    * - `start`: The leading slot's box.
    * - `summary`: The middle slot's box.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    *
    * ## CSS States
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in place of the cells.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-heatmap": Partial<
@@ -85132,12 +85172,6 @@ export type CustomElementsSolidJs = {
    * Set it where the distance from nothing is the point rather than the shape,
    * and accept that a series which never approaches zero becomes a flat rule
    * near the top of the box.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -85176,21 +85210,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -85236,8 +85255,6 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -85308,9 +85325,10 @@ export type CustomElementsSolidJs = {
    * - `mark`: The invisible point the tooltip is anchored to.
    * - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
    * - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
    * - `svg`: The drawing surface the lines and areas sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `terminus`: The mark on one series' last reading.
    * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
@@ -85334,6 +85352,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-line-chart": Partial<
@@ -86076,6 +86097,9 @@ export type CustomElementsSolidJs = {
    * While `delay` runs, the loader keeps its size and draws nothing, so the line
    * it sits in does not move when it appears.
    *
+   * With something in the `content` slot, the loader takes the larger of the ring
+   * and the content, and the ring centers over the content while the work runs.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -86100,6 +86124,9 @@ export type CustomElementsSolidJs = {
    *
    * Names an element in the same tree. In React it arrives as a property, the
    * way `Tooltip.for` does.
+   * - `idle`: Whether no work is in progress. The loader draws nothing of its own, has
+   * no role, and marks no region busy, and what is in the `content` slot
+   * shows. Clearing it starts `delay` again.
    * - `label`: The loader's name, announced by screen readers while the work is in
    * progress.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -86128,13 +86155,14 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: An icon or logo that stays still at the center. Empty by default.
+   * - `content`: What the loader stands in for while the work runs, such as a button. It keeps its size, hidden and inert, until `idle` is set.
    *
    * ## CSS Custom Properties
    *
    * CSS variables available for styling the component.
    *
    * - `--loader-color`: Color of the moving arc.
-   * - `--loader-duration`: How long one turn of the arc takes, 0.8s by default. With motion reduced the turn slows to a crawl whatever this says.
+   * - `--loader-duration`: How long one turn of the arc takes, 0.8s by default. With motion reduced the arc turns once every four seconds, whatever this says.
    * - `--loader-size`: Diameter. Defaults to the size token that `size` picks, which is 1.5rem at the default density.
    * - `--loader-track-color`: Color of the circle behind the arc.
    * - `--loader-track-width`: Width of the arc and the circle behind it, in units of a 24-unit drawing. Defaults to 2.
@@ -86143,6 +86171,7 @@ export type CustomElementsSolidJs = {
    *
    * Custom selectors for styling elements within the component.
    *
+   * - `content`: The box that holds the `content` slot. Hidden while the work runs, and shown while `idle` is set.
    * - `indicator`: The arc that turns.
    * - `mark`: The region that holds the slotted content at the center.
    * - `svg`: The rotating circle pair.
@@ -86780,6 +86809,10 @@ export type CustomElementsSolidJs = {
    * to draw the map's credit compact in a corner over the map, which suits a
    * map the width of the page.
    *
+   * The [Maps](https://fusion.dev/helix/docs/maps) guide connects a renderer,
+   * lists the keys and what a screen reader hears, and describes every method
+   * a driver for another renderer can have.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -92969,12 +93002,6 @@ export type CustomElementsSolidJs = {
    * Absent draws none. A series with fewer than two points, or with every
    * point at one measure across, has no line to draw. The summary already
    * gives each series' correlation, which says how near the points are to it.
-   * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
-   *
-   * Public for the same reason `series` and `named` are: a protected member
-   * cannot be cast onto across unrelated classes, so it would be invisible to
-   * every chart that needs it. Reading where a pointer is resting is a fair
-   * thing to ask a chart anyway. (property only) (readonly)
    * - `data`: The readings as data, in the shape of a table, where the page has no
    * table to point `for` at. `for` wins where both are set.
    *
@@ -93013,21 +93040,6 @@ export type CustomElementsSolidJs = {
    * names an element, and the chart is a generic around its plot: written
    * on the host, the name reached nobody. The plot takes it, as Heatmap's
    * strip always did. (property only) (readonly)
-   * - `readingsKnown`: Whether the readings have been looked for: false on the server and
-   * while hydrating, where no table is resolved and no data is read. A
-   * chart says it has no readings only once this is true. (property only) (readonly)
-   * - `sourceRows`: Every row of the table, with each cell's text and number.
-   *
-   * This is where a tooltip's content comes from, and it is deliberately not
-   * `series`. A chart draws numbers; a reader resting a pointer on one wants
-   * what the table says, which is `$128k` and not `128000`, and often wants
-   * the column beside it that nothing plotted at all.
-   *
-   * **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
-   * name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
-   * calendar week, and declaring that against a base class whose `rows` is a
-   * `Row[]` getter is a type error at best. Name the member for what it holds
-   * rather than for the shortest word available. (property only) (readonly)
    * - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
    *
    * The same test `readSeries` applies when it drops a column of notes: a
@@ -93073,8 +93085,6 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
-   * `aria-label` asks for an update, because it names the plot.
    * - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
    *
    * **A cell's place in its row is not its series' depth, and the tooltip
@@ -93133,11 +93143,12 @@ export type CustomElementsSolidJs = {
    * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
    * - `mark`: The invisible point the tooltip is anchored to.
    * - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
-   * - `plot`: The drawing, which takes focus to be read by key.
+   * - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
    * - `point`: One row, as a point.
    * - `point-active`: A point in the row under the pointer. Set alongside `point`.
    * - `summary`: The text that says how strongly the measures relate, for people who cannot see the points.
    * - `svg`: The drawing surface the gridlines and the trend lines sit on.
+   * - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
    * - `tooltip`: The bubble, forwarded from `Tooltip`.
    * - `tooltip-anchor`: The `Tooltip` element itself.
    * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -93157,7 +93168,7 @@ export type CustomElementsSolidJs = {
    * - `trend`: One series' line of best fit, under `trend`. Carries its series color as `--chart-series`.
    * - `x-axis`: The values along the horizontal axis, under the plot.
    * - `x-name`: The name of the horizontal measure.
-   * - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on.
+   * - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on. The one at the far edge carries `data-edge="end"`.
    * - `y-axis`: The values along the vertical axis, beside the plot.
    * - `y-name`: The name of the vertical measure.
    * - `y-tick`: One labeled value on the vertical axis.
@@ -93166,6 +93177,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
+   * - `empty`: While the `empty` part stands in the plot.
+   * - `loading`: While the `loading` part stands in the plot.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-scatter-chart": Partial<
@@ -94357,8 +94371,6 @@ export type CustomElementsSolidJs = {
    * with `values={[1240, 1318]}`. The attribute is the form to prefer, because
    * a string is what survives React's hydration where an array property does
    * not.
-   * - `pointer`: Finds the reading a pointer or a key rests on, as it does for every
-   * chart, so a sparkline is read the way they are. (property only) (readonly)
    * - `named`: The drawing's name: an `aria-label` written on the sparkline, then `label`. (property only) (readonly)
    * - `readings`: How many readings there are, which the pointer and the keys walk. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -94382,11 +94394,12 @@ export type CustomElementsSolidJs = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
-   * ## Methods
+   * ## Events
    *
-   * Methods that can be called to access component functionality.
+   * Events that will be emitted by the component.
    *
-   * - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes; a new `aria-label` renames the drawing.
+   * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it.
+   * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
    *
    * ## CSS Custom Properties
    *
@@ -96909,8 +96922,9 @@ export type CustomElementsSolidJs = {
    * - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
    *
    * Absent selects nothing, and the tags carry no selected state at all.
-   * - `value`: The selected tags' values, separated by commas, since a value may hold a
-   * space.
+   * - `value`: The selected tags' values, separated by commas with no space, as Toggle
+   * Group and Table write theirs, since a value may hold a space. A value
+   * written with a space after each comma is read the same way.
    *
    * Set it to start with tags selected. A tag's value is its `value`, or its
    * words where it has none.
@@ -100074,7 +100088,7 @@ export type CustomElementsSolidJs = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The item's label.
+   * - `(default)`: The item's label. A nested item does not go here: give it `slot="children"`. In a development build, an item nested here is reported.
    * - `chevron`: Replaces the expand and collapse mark of a branch. A slotted icon is sized and turned like the drawn one.
    * - `children`: Nested items, which make this a branch.
    * - `end`: Content after the label, at the far side of the row, such as a count or a state.
@@ -102728,7 +102742,7 @@ export type CustomCssProperties = {
   "--listbox-max-block-size"?: (string) | undefined;
   /** Color of the moving arc. */
   "--loader-color"?: (string) | undefined;
-  /** How long one turn of the arc takes, 0.8s by default. With motion reduced the turn slows to a crawl whatever this says. */
+  /** How long one turn of the arc takes, 0.8s by default. With motion reduced the arc turns once every four seconds, whatever this says. */
   "--loader-duration"?: (string) | undefined;
   /** Diameter. Defaults to the size token that `size` picks, which is 1.5rem at the default density. */
   "--loader-size"?: (string) | undefined;