@fusion.dev/helix 0.185.0 → 0.186.1

package/types/jsx.d.ts

@@ -107,6 +107,7 @@ import type {
   HelixIconButton,
   HelixImage,
   HelixInput,
+  HelixIsometricHeatmap,
   HelixKbd,
   HelixLegend,
   HelixLightbox,
@@ -18974,10 +18975,12 @@ disagreeing with its own name for every reader who meant the left. */
   /** The name of the icon in the Helix set.
 
 **A lookup, and the reason both this and `icon` exist.** A name is a string,
-so it is what markup can carry, and resolving one means an index that no
-bundler can shake. The family's entry indexes a small set, `icon/all`
-indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
-page that registers the glyphs it names or hands over the value instead.
+so it is what markup can carry, and resolving one means an index of the
+whole set that no bundler can shake: 15 kB for a consumer who renders one
+mark. An attribute is the only thing an HTML author can write, and that is
+worth the index; a consumer who would rather not pay it imports the
+element from `icon/root` and registers the glyphs it names, or hands over
+the value instead.
 
 A name written `prefix:name` asks the library registered under that
 prefix. */
@@ -19046,10 +19049,12 @@ disagreeing with its own name for every reader who meant the left. */
   /** The name of the icon in the Helix set.
 
 **A lookup, and the reason both this and `icon` exist.** A name is a string,
-so it is what markup can carry, and resolving one means an index that no
-bundler can shake. The family's entry indexes a small set, `icon/all`
-indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
-page that registers the glyphs it names or hands over the value instead.
+so it is what markup can carry, and resolving one means an index of the
+whole set that no bundler can shake: 15 kB for a consumer who renders one
+mark. An attribute is the only thing an HTML author can write, and that is
+worth the index; a consumer who would rather not pay it imports the
+element from `icon/root` and registers the glyphs it names, or hands over
+the value instead.
 
 A name written `prefix:name` asks the library registered under that
 prefix. */
@@ -19809,6 +19814,494 @@ invalid, and `true`, `null`, or nothing to accept the value. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixIsometricHeatmap` component event */
+export type HelixIsometricHeatmapElementEvent<E = Event> = TypedEvent<
+  HelixIsometricHeatmap,
+  E
+>;
+/** `helix-before-change` event type */
+export type HelixIsometricHeatmapHelixBeforeChangeElementEvent =
+  HelixIsometricHeatmapElementEvent<HelixBeforeChangeEvent>;
+/** `helix-reading-change` event type */
+export type HelixIsometricHeatmapHelixReadingChangeElementEvent =
+  HelixIsometricHeatmapElementEvent<HelixReadingChangeEvent>;
+/** `helix-reading-press` event type */
+export type HelixIsometricHeatmapHelixReadingPressElementEvent =
+  HelixIsometricHeatmapElementEvent<HelixReadingPressEvent>;
+/** `helix-resize` event type */
+export type HelixIsometricHeatmapHelixResizeElementEvent =
+  HelixIsometricHeatmapElementEvent<HelixResizeEvent>;
+
+export type HelixIsometricHeatmapProps = {
+  /** Draws every prism at no height, so the tones lie on a plane. */
+  flat?: (HelixIsometricHeatmap["flat"]) | undefined;
+  /** How tall the highest reading stands, in cells. Every other reading stands
+at its share of it. */
+  relief?: (HelixIsometricHeatmap["relief"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  "empty-text"?: (HelixIsometricHeatmap["emptyText"]) | undefined;
+  /** The words shown in place of the drawing when the table has no readings,
+and the fallback of the `empty` slot. */
+  emptyText?: (HelixIsometricHeatmap["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?: (HelixIsometricHeatmap["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"?: (HelixIsometricHeatmap["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?: (HelixIsometricHeatmap["loadingText"]) | undefined;
+  /** The id of the table to read.
+
+Names a table in the same tree, so a chart inside another component's
+shadow root reads a table in that root rather than one in the document. A
+`<table>` or anything built from grid roles, including `helix-table`.
+
+**In React this arrives as a property and not as an attribute**, the way
+`Tooltip.for` does, so it does not reflect and nothing styles on it. */
+  for?: (HelixIsometricHeatmap["for"]) | undefined;
+  /** The chart's name, which starts the chart's text summary.
+
+Absent falls back to the table's own caption, which is usually the right
+words and is already written. */
+  label?: (HelixIsometricHeatmap["label"]) | undefined;
+  /** The locale the chart's own numbers are written in: its axis, its
+percentages and its totals, such as `de` for `1.240` and `32 %`.
+
+Absent reads the nearest `lang`, then the runtime's own. The table's
+cells are shown as the table writes them, whatever this says. */
+  locale?: (HelixIsometricHeatmap["locale"]) | undefined;
+  /** Where a reading the keys moved to stands among the readings, said after
+it. `{position}` and `{count}` are replaced with the numbers, written in
+`locale`.
+
+Set it to the words of the page's language, such as `{position} von
+{count}`, or to nothing to say no position. A slice or a series a
+legend hid is not counted. */
+  "position-label"?: (HelixIsometricHeatmap["positionLabel"]) | undefined;
+  /** Where a reading the keys moved to stands among the readings, said after
+it. `{position}` and `{count}` are replaced with the numbers, written in
+`locale`.
+
+Set it to the words of the page's language, such as `{position} von
+{count}`, or to nothing to say no position. A slice or a series a
+legend hid is not counted. */
+  positionLabel?: (HelixIsometricHeatmap["positionLabel"]) | undefined;
+  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
+`overview-label`. */
+  "busiest-label"?: (HelixIsometricHeatmap["busiestLabel"]) | undefined;
+  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
+`overview-label`. */
+  busiestLabel?: (HelixIsometricHeatmap["busiestLabel"]) | undefined;
+  /** Space between cells, in CSS pixels. It is a number for the same reason
+`min-cell` is. */
+  gap?: (HelixIsometricHeatmap["gap"]) | undefined;
+  /** The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+
+**Set this only to overrule what the strip actually draws.** The arithmetic
+needs a width in pixels and the width is a length the stylesheet resolves,
+so a number written here that disagrees with the sheet is a promise the
+consumer has to keep by hand, and the one number a summary is told to trust
+is the one it gets wrong.
+
+The strip measures itself, so sizing the cells in a sheet is enough on its
+own and these two are the estimate used until the first measurement lands.
+Writing the attribute pins the value and stops the measurement being
+consulted, which is what a container query or a transition on the cell size
+wants, where what is drawn this frame is not what the arithmetic should
+plan around.
+
+Zero turns the dropping off altogether, which is right for a strip in a
+container that cannot get narrow. */
+  "min-cell"?: (HelixIsometricHeatmap["minCell"] | `${number}`) | undefined;
+  /** The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+
+**Set this only to overrule what the strip actually draws.** The arithmetic
+needs a width in pixels and the width is a length the stylesheet resolves,
+so a number written here that disagrees with the sheet is a promise the
+consumer has to keep by hand, and the one number a summary is told to trust
+is the one it gets wrong.
+
+The strip measures itself, so sizing the cells in a sheet is enough on its
+own and these two are the estimate used until the first measurement lands.
+Writing the attribute pins the value and stops the measurement being
+consulted, which is what a container query or a transition on the cell size
+wants, where what is drawn this frame is not what the arithmetic should
+plan around.
+
+Zero turns the dropping off altogether, which is right for a strip in a
+container that cannot get narrow. */
+  minCell?: (HelixIsometricHeatmap["minCell"]) | undefined;
+  /** The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+`busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+and its reading as the table writes it, and `{total}` the total of the
+readings drawn, written in the locale. */
+  "overview-label"?: (HelixIsometricHeatmap["overviewLabel"]) | undefined;
+  /** The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+`busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+and its reading as the table writes it, and `{total}` the total of the
+readings drawn, written in the locale. */
+  overviewLabel?: (HelixIsometricHeatmap["overviewLabel"]) | undefined;
+  /** How many rows the strip has.
+
+`1` is a status strip and `7` is a calendar week, which are the two readings
+this covers. Cells fill down the column and then across, which is what a
+calendar heatmap does: a week is a column, so the strip reads along the
+line in weeks, from the right on a right-to-left page, and top to bottom in
+days. */
+  rows?: (HelixIsometricHeatmap["rows"]) | undefined;
+  /** What the readout added for a selected cell, under `selection-mode`. */
+  "selected-label"?: (HelixIsometricHeatmap["selectedLabel"]) | undefined;
+  /** What the readout added for a selected cell, under `selection-mode`. */
+  selectedLabel?: (HelixIsometricHeatmap["selectedLabel"]) | undefined;
+  /** What the `selection` part says after the selection changes. `{count}` is
+how many cells are selected, written in the locale, and a language that
+needs plural forms writes them: `{count, plural, one {# wybrany} few
+{# wybrane} many {# wybranych} other {# wybranego}}`. */
+  "selection-label"?: (HelixIsometricHeatmap["selectionLabel"]) | undefined;
+  /** What the `selection` part says after the selection changes. `{count}` is
+how many cells are selected, written in the locale, and a language that
+needs plural forms writes them: `{count, plural, one {# wybrany} few
+{# wybrane} many {# wybranych} other {# wybranego}}`. */
+  selectionLabel?: (HelixIsometricHeatmap["selectionLabel"]) | undefined;
+  /** How many cells a reader can select: `single` or `multiple`.
+
+Absent selects nothing, and a press or Space does what it did. */
+  "selection-mode"?: (HelixIsometricHeatmap["selectionMode"]) | undefined;
+  /** How many cells a reader can select: `single` or `multiple`.
+
+Absent selects nothing, and a press or Space does what it did. */
+  selectionMode?: (HelixIsometricHeatmap["selectionMode"]) | undefined;
+  /** What Shift takes in under `selection-mode="multiple"`: `linear`, every
+cell between two in the table's order, or `rectangle`, the cells between
+two corners by row and by column, as a spreadsheet selects a range. */
+  "selection-shape"?: (HelixIsometricHeatmap["selectionShape"]) | undefined;
+  /** What Shift takes in under `selection-mode="multiple"`: `linear`, every
+cell between two in the table's order, or `rectangle`, the cells between
+two corners by row and by column, as a spreadsheet selects a range. */
+  selectionShape?: (HelixIsometricHeatmap["selectionShape"]) | undefined;
+  /** The strip's name where the chart has none: no `aria-label`, `label`, or
+table caption. */
+  "strip-label"?: (HelixIsometricHeatmap["stripLabel"]) | undefined;
+  /** The strip's name where the chart has none: no `aria-label`, `label`, or
+table caption. */
+  stripLabel?: (HelixIsometricHeatmap["stripLabel"]) | undefined;
+  /** Lower bounds for the tone buckets, in the order the tones are given.
+
+`thresholds="1 3 6 9"` with `tones="1 2 3 4"` puts 1 and 2 in the ramp's
+first step, 3 to 5 in the second, 6 to 8 in the third, and 9 upward in the
+fourth. A value below the first bound gets no tone at all: an empty day in a
+contribution graph is a day with nothing in it, and painting it as the
+lowest bucket claims a reading that does not exist. */
+  thresholds?: (HelixIsometricHeatmap["thresholds"]) | undefined;
+  /** The tone for each bucket, in the same order as `thresholds`.
+
+A name, resolved as `--heatmap-tone-<name>` by whichever tier answers.
+**`"1"` through `"5"` are a ramp and everything else is a category**, which
+is the distinction a heatmap lives or dies on: magnitude has to be one hue
+getting louder, because a reader compares two cells by weight and cannot
+compare two hues at all. `tones="surface info accent success primary"` for a
+commit count is five unrelated hues for five amounts, which is confetti with
+no order in it. */
+  tones?: (HelixIsometricHeatmap["tones"]) | undefined;
+  /** The name the `overview` gives the total of the readings drawn,
+`{totalLabel}` in `overview-label`. */
+  "total-label"?: (HelixIsometricHeatmap["totalLabel"]) | undefined;
+  /** The name the `overview` gives the total of the readings drawn,
+`{totalLabel}` in `overview-label`. */
+  totalLabel?: (HelixIsometricHeatmap["totalLabel"]) | undefined;
+  /** 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`. */
+  value?: (HelixIsometricHeatmap["value"]) | undefined;
+  /** 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.
+
+```js
+chart.data = {
+  caption: 'Sessions by channel',
+  columns: ['Month', 'Direct', 'Referral'],
+  rows: [['Jan', 10, 4], ['Feb', 20, 8]],
+}
+```
+
+The first column holds each row's label and every column after it a
+series, as in a table. A cell is a number, words, `null` for a blank,
+or `{ value, text }` for a number shown as words, such as `$128k`. A
+number is shown in `locale`.
+
+**A table is still the better source where the page can show one**:
+it reads with no script and before hydration, and a reader can sort and
+copy it. Data is drawn on the client only, so a server serves the
+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?: (HelixIsometricHeatmap["data"]) | undefined;
+
+  /** Fired once a press or a key has changed which cells are selected. */
+  onchange?: ((e: HelixIsometricHeatmapElementEvent) => void) | undefined;
+  /** Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable. */
+  "onhelix-before-change"?: ((
+    e: HelixIsometricHeatmapHelixBeforeChangeElementEvent,
+  ) => void) | undefined;
+  /** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
+  "onhelix-reading-change"?: ((
+    e: HelixIsometricHeatmapHelixReadingChangeElementEvent,
+  ) => 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: HelixIsometricHeatmapHelixReadingPressElementEvent,
+  ) => void) | undefined;
+  /** Fired when the number of cells drawn changes, with the new number. */
+  "onhelix-resize"?: ((e: HelixIsometricHeatmapHelixResizeElementEvent) => void) | undefined;
+};
+
+export type HelixIsometricHeatmapSolidJsProps = {
+  /** Draws every prism at no height, so the tones lie on a plane. */
+  "prop:flat"?: (HelixIsometricHeatmap["flat"]) | undefined;
+  /** How tall the highest reading stands, in cells. Every other reading stands
+at its share of it. */
+  "prop:relief"?: (HelixIsometricHeatmap["relief"]) | 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"?: (HelixIsometricHeatmap["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"?: (HelixIsometricHeatmap["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"?: (HelixIsometricHeatmap["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"?: (HelixIsometricHeatmap["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"?: (HelixIsometricHeatmap["loadingText"]) | undefined;
+  /** The id of the table to read.
+
+Names a table in the same tree, so a chart inside another component's
+shadow root reads a table in that root rather than one in the document. A
+`<table>` or anything built from grid roles, including `helix-table`.
+
+**In React this arrives as a property and not as an attribute**, the way
+`Tooltip.for` does, so it does not reflect and nothing styles on it. */
+  "prop:for"?: (HelixIsometricHeatmap["for"]) | undefined;
+  /** The chart's name, which starts the chart's text summary.
+
+Absent falls back to the table's own caption, which is usually the right
+words and is already written. */
+  "prop:label"?: (HelixIsometricHeatmap["label"]) | undefined;
+  /** The locale the chart's own numbers are written in: its axis, its
+percentages and its totals, such as `de` for `1.240` and `32 %`.
+
+Absent reads the nearest `lang`, then the runtime's own. The table's
+cells are shown as the table writes them, whatever this says. */
+  "prop:locale"?: (HelixIsometricHeatmap["locale"]) | undefined;
+  /** Where a reading the keys moved to stands among the readings, said after
+it. `{position}` and `{count}` are replaced with the numbers, written in
+`locale`.
+
+Set it to the words of the page's language, such as `{position} von
+{count}`, or to nothing to say no position. A slice or a series a
+legend hid is not counted. */
+  "attr:position-label"?: (HelixIsometricHeatmap["positionLabel"]) | undefined;
+  /** Where a reading the keys moved to stands among the readings, said after
+it. `{position}` and `{count}` are replaced with the numbers, written in
+`locale`.
+
+Set it to the words of the page's language, such as `{position} von
+{count}`, or to nothing to say no position. A slice or a series a
+legend hid is not counted. */
+  "prop:positionLabel"?: (HelixIsometricHeatmap["positionLabel"]) | undefined;
+  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
+`overview-label`. */
+  "attr:busiest-label"?: (HelixIsometricHeatmap["busiestLabel"]) | undefined;
+  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
+`overview-label`. */
+  "prop:busiestLabel"?: (HelixIsometricHeatmap["busiestLabel"]) | undefined;
+  /** Space between cells, in CSS pixels. It is a number for the same reason
+`min-cell` is. */
+  "prop:gap"?: (HelixIsometricHeatmap["gap"]) | undefined;
+  /** The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+
+**Set this only to overrule what the strip actually draws.** The arithmetic
+needs a width in pixels and the width is a length the stylesheet resolves,
+so a number written here that disagrees with the sheet is a promise the
+consumer has to keep by hand, and the one number a summary is told to trust
+is the one it gets wrong.
+
+The strip measures itself, so sizing the cells in a sheet is enough on its
+own and these two are the estimate used until the first measurement lands.
+Writing the attribute pins the value and stops the measurement being
+consulted, which is what a container query or a transition on the cell size
+wants, where what is drawn this frame is not what the arithmetic should
+plan around.
+
+Zero turns the dropping off altogether, which is right for a strip in a
+container that cannot get narrow. */
+  "attr:min-cell"?: (HelixIsometricHeatmap["minCell"] | `${number}`) | undefined;
+  /** The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+
+**Set this only to overrule what the strip actually draws.** The arithmetic
+needs a width in pixels and the width is a length the stylesheet resolves,
+so a number written here that disagrees with the sheet is a promise the
+consumer has to keep by hand, and the one number a summary is told to trust
+is the one it gets wrong.
+
+The strip measures itself, so sizing the cells in a sheet is enough on its
+own and these two are the estimate used until the first measurement lands.
+Writing the attribute pins the value and stops the measurement being
+consulted, which is what a container query or a transition on the cell size
+wants, where what is drawn this frame is not what the arithmetic should
+plan around.
+
+Zero turns the dropping off altogether, which is right for a strip in a
+container that cannot get narrow. */
+  "prop:minCell"?: (HelixIsometricHeatmap["minCell"]) | undefined;
+  /** The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+`busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+and its reading as the table writes it, and `{total}` the total of the
+readings drawn, written in the locale. */
+  "attr:overview-label"?: (HelixIsometricHeatmap["overviewLabel"]) | undefined;
+  /** The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+`busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+and its reading as the table writes it, and `{total}` the total of the
+readings drawn, written in the locale. */
+  "prop:overviewLabel"?: (HelixIsometricHeatmap["overviewLabel"]) | undefined;
+  /** How many rows the strip has.
+
+`1` is a status strip and `7` is a calendar week, which are the two readings
+this covers. Cells fill down the column and then across, which is what a
+calendar heatmap does: a week is a column, so the strip reads along the
+line in weeks, from the right on a right-to-left page, and top to bottom in
+days. */
+  "prop:rows"?: (HelixIsometricHeatmap["rows"]) | undefined;
+  /** What the readout added for a selected cell, under `selection-mode`. */
+  "attr:selected-label"?: (HelixIsometricHeatmap["selectedLabel"]) | undefined;
+  /** What the readout added for a selected cell, under `selection-mode`. */
+  "prop:selectedLabel"?: (HelixIsometricHeatmap["selectedLabel"]) | undefined;
+  /** What the `selection` part says after the selection changes. `{count}` is
+how many cells are selected, written in the locale, and a language that
+needs plural forms writes them: `{count, plural, one {# wybrany} few
+{# wybrane} many {# wybranych} other {# wybranego}}`. */
+  "attr:selection-label"?: (HelixIsometricHeatmap["selectionLabel"]) | undefined;
+  /** What the `selection` part says after the selection changes. `{count}` is
+how many cells are selected, written in the locale, and a language that
+needs plural forms writes them: `{count, plural, one {# wybrany} few
+{# wybrane} many {# wybranych} other {# wybranego}}`. */
+  "prop:selectionLabel"?: (HelixIsometricHeatmap["selectionLabel"]) | undefined;
+  /** How many cells a reader can select: `single` or `multiple`.
+
+Absent selects nothing, and a press or Space does what it did. */
+  "attr:selection-mode"?: (HelixIsometricHeatmap["selectionMode"]) | undefined;
+  /** How many cells a reader can select: `single` or `multiple`.
+
+Absent selects nothing, and a press or Space does what it did. */
+  "prop:selectionMode"?: (HelixIsometricHeatmap["selectionMode"]) | undefined;
+  /** What Shift takes in under `selection-mode="multiple"`: `linear`, every
+cell between two in the table's order, or `rectangle`, the cells between
+two corners by row and by column, as a spreadsheet selects a range. */
+  "attr:selection-shape"?: (HelixIsometricHeatmap["selectionShape"]) | undefined;
+  /** What Shift takes in under `selection-mode="multiple"`: `linear`, every
+cell between two in the table's order, or `rectangle`, the cells between
+two corners by row and by column, as a spreadsheet selects a range. */
+  "prop:selectionShape"?: (HelixIsometricHeatmap["selectionShape"]) | undefined;
+  /** The strip's name where the chart has none: no `aria-label`, `label`, or
+table caption. */
+  "attr:strip-label"?: (HelixIsometricHeatmap["stripLabel"]) | undefined;
+  /** The strip's name where the chart has none: no `aria-label`, `label`, or
+table caption. */
+  "prop:stripLabel"?: (HelixIsometricHeatmap["stripLabel"]) | undefined;
+  /** Lower bounds for the tone buckets, in the order the tones are given.
+
+`thresholds="1 3 6 9"` with `tones="1 2 3 4"` puts 1 and 2 in the ramp's
+first step, 3 to 5 in the second, 6 to 8 in the third, and 9 upward in the
+fourth. A value below the first bound gets no tone at all: an empty day in a
+contribution graph is a day with nothing in it, and painting it as the
+lowest bucket claims a reading that does not exist. */
+  "prop:thresholds"?: (HelixIsometricHeatmap["thresholds"]) | undefined;
+  /** The tone for each bucket, in the same order as `thresholds`.
+
+A name, resolved as `--heatmap-tone-<name>` by whichever tier answers.
+**`"1"` through `"5"` are a ramp and everything else is a category**, which
+is the distinction a heatmap lives or dies on: magnitude has to be one hue
+getting louder, because a reader compares two cells by weight and cannot
+compare two hues at all. `tones="surface info accent success primary"` for a
+commit count is five unrelated hues for five amounts, which is confetti with
+no order in it. */
+  "prop:tones"?: (HelixIsometricHeatmap["tones"]) | undefined;
+  /** The name the `overview` gives the total of the readings drawn,
+`{totalLabel}` in `overview-label`. */
+  "attr:total-label"?: (HelixIsometricHeatmap["totalLabel"]) | undefined;
+  /** The name the `overview` gives the total of the readings drawn,
+`{totalLabel}` in `overview-label`. */
+  "prop:totalLabel"?: (HelixIsometricHeatmap["totalLabel"]) | undefined;
+  /** 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`. */
+  "prop:value"?: (HelixIsometricHeatmap["value"]) | undefined;
+  /** 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.
+
+```js
+chart.data = {
+  caption: 'Sessions by channel',
+  columns: ['Month', 'Direct', 'Referral'],
+  rows: [['Jan', 10, 4], ['Feb', 20, 8]],
+}
+```
+
+The first column holds each row's label and every column after it a
+series, as in a table. A cell is a number, words, `null` for a blank,
+or `{ value, text }` for a number shown as words, such as `$128k`. A
+number is shown in `locale`.
+
+**A table is still the better source where the page can show one**:
+it reads with no script and before hydration, and a reader can sort and
+copy it. Data is drawn on the client only, so a server serves the
+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"?: (HelixIsometricHeatmap["data"]) | undefined;
+  /** Fired once a press or a key has changed which cells are selected. */
+  "on:change"?: ((e: HelixIsometricHeatmapElementEvent) => void) | undefined;
+  /** Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable. */
+  "on:helix-before-change"?: ((
+    e: HelixIsometricHeatmapHelixBeforeChangeElementEvent,
+  ) => void) | undefined;
+  /** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
+  "on:helix-reading-change"?: ((
+    e: HelixIsometricHeatmapHelixReadingChangeElementEvent,
+  ) => 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: HelixIsometricHeatmapHelixReadingPressElementEvent,
+  ) => void) | undefined;
+  /** Fired when the number of cells drawn changes, with the new number. */
+  "on:helix-resize"?: ((e: HelixIsometricHeatmapHelixResizeElementEvent) => void) | undefined;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: (string) | undefined;
+  /** Set the textContent of the element */
+  textContent?: (string | number) | undefined;
+};
+
 /** `HelixKbd` component event */
 export type HelixKbdElementEvent<E = Event> = TypedEvent<HelixKbd, E>;
 /** `helix-shortcut` event type */
@@ -54593,11 +55086,6 @@ export type CustomElements = {
    * Reduced motion stills every animation. `auto-width` gives the box the
    * glyph's own proportions, for a mark wider than it is tall.
    *
-   * **`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a
-   * control most often needs, and `@fusion.dev/helix/icon/all` registers the
-   * whole set. The headless element lists the thirteen and says how a name is
-   * resolved.
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -54629,10 +55117,12 @@ export type CustomElements = {
    * - `name`: The name of the icon in the Helix set.
    *
    * **A lookup, and the reason both this and `icon` exist.** A name is a string,
-   * so it is what markup can carry, and resolving one means an index that no
-   * bundler can shake. The family's entry indexes a small set, `icon/all`
-   * indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
-   * page that registers the glyphs it names or hands over the value instead.
+   * so it is what markup can carry, and resolving one means an index of the
+   * whole set that no bundler can shake: 15 kB for a consumer who renders one
+   * mark. An attribute is the only thing an HTML author can write, and that is
+   * worth the index; a consumer who would rather not pay it imports the
+   * element from `icon/root` and registers the glyphs it names, or hands over
+   * the value instead.
    *
    * A name written `prefix:name` asks the library registered under that
    * prefix.
@@ -55179,6 +55669,340 @@ export type CustomElements = {
    */
   "helix-input": Partial<HelixInputProps & BaseProps<HelixInput> & BaseEvents<HelixInput>>;
 
+  /**
+   * Each reading is a prism. The top face takes the cell's tone, and the two
+   * sides are the same tone, shaded darker, so the whole relief follows your
+   * theme's colors.
+   *
+   * `tones="1 2 3 4 5"` uses the same five-step ramp as `Heatmap`, so the tone
+   * and the height both show the value. Set `--isometric-heatmap-cell-size` to
+   * change how large a cell may grow.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `flat`: Draws every prism at no height, so the tones lie on a plane.
+   * - `relief`: How tall the highest reading stands, in cells. Every other reading stands
+   * at its share of it.
+   * - `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
+   * shadow root reads a table in that root rather than one in the document. A
+   * `<table>` or anything built from grid roles, including `helix-table`.
+   *
+   * **In React this arrives as a property and not as an attribute**, the way
+   * `Tooltip.for` does, so it does not reflect and nothing styles on it.
+   * - `label`: The chart's name, which starts the chart's text summary.
+   *
+   * Absent falls back to the table's own caption, which is usually the right
+   * words and is already written.
+   * - `locale`: The locale the chart's own numbers are written in: its axis, its
+   * percentages and its totals, such as `de` for `1.240` and `32 %`.
+   *
+   * Absent reads the nearest `lang`, then the runtime's own. The table's
+   * cells are shown as the table writes them, whatever this says.
+   * - `position-label`/`positionLabel`: Where a reading the keys moved to stands among the readings, said after
+   * it. `{position}` and `{count}` are replaced with the numbers, written in
+   * `locale`.
+   *
+   * Set it to the words of the page's language, such as `{position} von
+   * {count}`, or to nothing to say no position. A slice or a series a
+   * legend hid is not counted.
+   * - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
+   * `overview-label`.
+   * - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
+   * `min-cell` is.
+   * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+   *
+   * **Set this only to overrule what the strip actually draws.** The arithmetic
+   * needs a width in pixels and the width is a length the stylesheet resolves,
+   * so a number written here that disagrees with the sheet is a promise the
+   * consumer has to keep by hand, and the one number a summary is told to trust
+   * is the one it gets wrong.
+   *
+   * The strip measures itself, so sizing the cells in a sheet is enough on its
+   * own and these two are the estimate used until the first measurement lands.
+   * Writing the attribute pins the value and stops the measurement being
+   * consulted, which is what a container query or a transition on the cell size
+   * wants, where what is drawn this frame is not what the arithmetic should
+   * plan around.
+   *
+   * Zero turns the dropping off altogether, which is right for a strip in a
+   * container that cannot get narrow.
+   * - `overview-label`/`overviewLabel`: The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+   * `busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+   * and its reading as the table writes it, and `{total}` the total of the
+   * readings drawn, written in the locale.
+   * - `rows`: How many rows the strip has.
+   *
+   * `1` is a status strip and `7` is a calendar week, which are the two readings
+   * this covers. Cells fill down the column and then across, which is what a
+   * calendar heatmap does: a week is a column, so the strip reads along the
+   * line in weeks, from the right on a right-to-left page, and top to bottom in
+   * days.
+   * - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
+   * - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
+   * how many cells are selected, written in the locale, and a language that
+   * needs plural forms writes them: `{count, plural, one {# wybrany} few
+   * {# wybrane} many {# wybranych} other {# wybranego}}`.
+   * - `selection-mode`/`selectionMode`: How many cells a reader can select: `single` or `multiple`.
+   *
+   * Absent selects nothing, and a press or Space does what it did.
+   * - `selection-shape`/`selectionShape`: What Shift takes in under `selection-mode="multiple"`: `linear`, every
+   * cell between two in the table's order, or `rectangle`, the cells between
+   * two corners by row and by column, as a spreadsheet selects a range.
+   * - `strip-label`/`stripLabel`: The strip's name where the chart has none: no `aria-label`, `label`, or
+   * table caption.
+   * - `thresholds`: Lower bounds for the tone buckets, in the order the tones are given.
+   *
+   * `thresholds="1 3 6 9"` with `tones="1 2 3 4"` puts 1 and 2 in the ramp's
+   * first step, 3 to 5 in the second, 6 to 8 in the third, and 9 upward in the
+   * fourth. A value below the first bound gets no tone at all: an empty day in a
+   * contribution graph is a day with nothing in it, and painting it as the
+   * lowest bucket claims a reading that does not exist.
+   * - `tones`: The tone for each bucket, in the same order as `thresholds`.
+   *
+   * A name, resolved as `--heatmap-tone-<name>` by whichever tier answers.
+   * **`"1"` through `"5"` are a ramp and everything else is a category**, which
+   * is the distinction a heatmap lives or dies on: magnitude has to be one hue
+   * getting louder, because a reader compares two cells by weight and cannot
+   * compare two hues at all. `tones="surface info accent success primary"` for a
+   * commit count is five unrelated hues for five amounts, which is confetti with
+   * 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, 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`.
+   * - `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.
+   *
+   * ```js
+   * chart.data = {
+   *   caption: 'Sessions by channel',
+   *   columns: ['Month', 'Direct', 'Referral'],
+   *   rows: [['Jan', 10, 4], ['Feb', 20, 8]],
+   * }
+   * ```
+   *
+   * The first column holds each row's label and every column after it a
+   * series, as in a table. A cell is a number, words, `null` for a blank,
+   * or `{ value, text }` for a number shown as words, such as `$128k`. A
+   * number is shown in `locale`.
+   *
+   * **A table is still the better source where the page can show one**:
+   * it reads with no script and before hydration, and a reader can sort and
+   * copy it. Data is drawn on the client only, so a server serves the
+   * 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. (property only)
+   * - `series`: The table's columns, one series each. Empty when there is no table.
+   *
+   * Held by the controller between edits, so a render reading this five
+   * times parses the table once. See `SourceController.series`. (property only) (readonly)
+   * - `named`: The chart's name: an `aria-label` written on the chart, then `label`,
+   * then the table's caption.
+   *
+   * The fallback is the reason this is shared rather than copied: a caption is
+   * already written, already the right words, and already the thing a reader
+   * of the table sees. A chart that made the consumer say it twice would be
+   * asking for the second one to drift.
+   *
+   * **An `aria-label` on the chart comes first**, because it is how a page
+   * 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)
+   * - `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
+   * column is a series where any row parses, so a series survives one blank
+   * cell and a column of words is never one. (property only) (readonly)
+   * - `readings`: The number of readings, which the pointer position maps onto. (property only) (readonly)
+   * - `visible`: How many cells are actually drawn.
+   *
+   * **This is the number a summary has to agree with**, and the reason it is
+   * published at all: a consumer's own summary is their markup and this element
+   * cannot rewrite it, so the only honest arrangement is to hand over the count
+   * and say when it changed.
+   *
+   * **A plain getter, and the attribute is written in `updated`, because
+   * `@property({ reflect: true })` on a getter with no setter reflects once and
+   * then goes stale.** Lit reflects a property that is in `changedProperties`,
+   * and nothing puts a derived getter there after the first update: the
+   * attribute would be right on load and wrong from the first resize, which is
+   * the exact failure the count exists to prevent, arriving through the
+   * mechanism meant to prevent it. (property only) (readonly)
+   * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
+   *
+   * **Named `whenSettled` because `settled` is taken four times over**, by
+   * Image, Splitter and both color controls, none of them about transitions. A
+   * base class takes the name every subclass then cannot use.
+   *
+   * **The state it reports cannot be watched, which is why this exists.** A
+   * custom state is deliberately not in the DOM, so there is no
+   * `MutationObserver` equivalent for `ElementInternals.states`. Await this
+   * instead.
+   *
+   * Separate from `updateComplete`, which resolves in the microtask checkpoint
+   * the suppression is still active in. That is the distinction `readyToMove`
+   * in `@fusion.dev/helix-testing` is written around.
+   *
+   * It never resolves where `requestAnimationFrame` never fires, which is a
+   * server, a hidden tab, and happy-dom. Callers that must not hang there race
+   * it against a timeout, as the happy-dom harness's `readyToMove` does. The
+   * 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.
+   *
+   * - `change`: Fired once a press or a key has changed which cells are selected.
+   * - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
+   * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, 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`.
+   * - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
+   * - `end`: Below the strip, at the trailing edge: usually the newest date.
+   * - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
+   * - `start`: Below the strip, at the leading edge: usually the oldest date.
+   * - `summary`: Below the strip, in the middle: a summary of the range shown.
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `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
+   * spent a while assuming it was.** `readSeries` drops a column nothing
+   * parses and `readRows` keeps it, so one column of notes among the figures
+   * moves every column after it one color along in the bubble: a row reading
+   * `Referral 1,080` wearing series three's green beside a legend that says
+   * series three is something else, which is the one failure the dot exists
+   * to prevent.
+   *
+   * Overridden where a chart reads the table some other way. `ScatterChart`
+   * splits the first plotted column off as the measure across, so its first
+   * *plotted* series is this table's second numeric column.
+   * - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
+   * reading the same table hid it.
+   *
+   * Asked of the table rather than of a legend, the table being the one
+   * thing the two share: see `SourceController.hide`. A series keeps its
+   * palette slot while it is hidden, so the colors of the others do not move.
+   * For a ring the names are its rows, the slices being the rows.
+   * - `showsColumn(cell: number) => boolean`: Whether the series read from the cell at this place in a row is drawn,
+   * by its column's heading. The keys and the readout pass over one a
+   * legend hid.
+   *
+   * A column's heading is the cell's name in every row, so the first row
+   * answers for the column.
+   * - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
+   * column's heading, read from the first row that has a cell there, so a
+   * short first row does not lose the heading. `''` where no row has one.
+   * - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
+   * month on or back, by the dates the rows' headers carry. Undefined where
+   * they carry none, and the keys move four columns.
+   *
+   * ## CSS Custom Properties
+   *
+   * CSS variables available for styling the component.
+   *
+   * - `--isometric-heatmap-cell-size`: The largest a cell grows, along its edge. The strip is never wider than its box, and draws smaller cells to fit.
+   * - `--isometric-heatmap-left-shade`: How much darker the left face is than the top, as a percentage mixed toward black.
+   * - `--isometric-heatmap-right-shade`: How much darker the right face is than the top, as a percentage mixed toward black.
+   * - `--isometric-heatmap-selected-color`: The color of the dashed edges of a selected prism, under `selection-mode`. By default, white on a dark face and black on a light one.
+   * - `--isometric-heatmap-span`: How many cells the drawing spans across: its columns and its rows together. The component writes it on the strip, and a stylesheet that caps the cell size reads it.
+   * - `--heatmap-rows`: How many rows the strip lays out. The component writes it from the data, and the stylesheet that draws the strip reads it.
+   * - `--heatmap-tone`: The tone of the cell it is set on. The component writes it, and the stylesheet that paints the cell reads it.
+   * - `--heatmap-tone-1`: The weakest step of the magnitude ramp, used by `tones="1 …"`.
+   * - `--heatmap-tone-2`: The second step of the magnitude ramp.
+   * - `--heatmap-tone-3`: The third step of the magnitude ramp.
+   * - `--heatmap-tone-4`: The fourth step of the magnitude ramp.
+   * - `--heatmap-tone-5`: The strongest step of the magnitude ramp.
+   * - `--heatmap-tone-accent`: The color of the `accent` tone.
+   * - `--heatmap-tone-danger`: The color of the `danger` tone.
+   * - `--heatmap-tone-info`: The color of the `info` tone.
+   * - `--heatmap-tone-muted`: The color of the `muted` tone: a quiet background, for a bucket that means nothing happened.
+   * - `--heatmap-tone-primary`: The color of the `primary` tone.
+   * - `--heatmap-tone-success`: The color of the `success` tone, named in `tones` or in `data-tone`.
+   * - `--heatmap-tone-warning`: The color of the `warning` tone.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `cell`: One reading.
+   * - `drawing`: The SVG every prism is drawn in. It is mirrored on a right-to-left page.
+   * - `left-face`: The face of a prism toward the next row, drawn at its lower left.
+   * - `right-face`: The face of a prism toward the next column, drawn at its lower right.
+   * - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
+   * - `strip`: The grid of cells, which takes focus to be read by key. It is named by the host's `aria-labelledby` or `aria-label`, then by `label`, then by the caption of the table.
+   * - `top-face`: The top of a prism, which carries the reading's tone.
+   * - `cell-active`: The cell the pointer or the keys rest on. Set alongside `cell`.
+   * - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
+   * - `empty`: The words under the strip 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, there being no document to resolve `for` in.
+   * - `end`: The trailing slot's box.
+   * - `footer`: The three-slot row under the strip.
+   * - `live`: The readout: a polite live region that says the cell the keys moved to. Hide it visually.
+   * - `loading`: The words under the strip 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.
+   * - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
+   * - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
+   * - `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.
+   * - `tooltip`: The bubble, forwarded from `Tooltip`.
+   * - `tooltip-anchor`: The `Tooltip` element itself.
+   * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
+   * - `tooltip-arrow-bottom`: The point while the bubble is below the reading, on its top edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-left`: The point while the bubble is left of the reading, on its right edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-right`: The point while the bubble is right of the reading, on its left edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-top`: The point while the bubble is above the reading, on its bottom edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-bottom`: The bubble while it is below the reading. Set alongside `tooltip`.
+   * - `tooltip-cell`: One column's name and value inside the tooltip.
+   * - `tooltip-cell-current`: The cell the series keys rest on, in the charts whose readings hold several series. A strip draws one, so it is never set here.
+   * - `tooltip-label`: The reading's own name inside the tooltip.
+   * - `tooltip-left`: The bubble while it is left of the reading. Set alongside `tooltip`.
+   * - `tooltip-name`: A column's name inside the tooltip.
+   * - `tooltip-right`: The bubble while it is right of the reading. Set alongside `tooltip`.
+   * - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
+   * - `tooltip-value`: A column's value inside the tooltip.
+   *
+   * ## 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.
+   * - `loading`: While the `loading` 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-isometric-heatmap": Partial<
+    HelixIsometricHeatmapProps & BaseProps<HelixIsometricHeatmap> & BaseEvents<HelixIsometricHeatmap>
+  >;
+
   /**
    * Drawn as a physical key, with a hairline border, a sunken fill, and one inset
    * shadow along the bottom edge.
@@ -84517,11 +85341,6 @@ export type CustomElementsSolidJs = {
    * Reduced motion stills every animation. `auto-width` gives the box the
    * glyph's own proportions, for a mark wider than it is tall.
    *
-   * **`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a
-   * control most often needs, and `@fusion.dev/helix/icon/all` registers the
-   * whole set. The headless element lists the thirteen and says how a name is
-   * resolved.
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -84553,10 +85372,12 @@ export type CustomElementsSolidJs = {
    * - `name`: The name of the icon in the Helix set.
    *
    * **A lookup, and the reason both this and `icon` exist.** A name is a string,
-   * so it is what markup can carry, and resolving one means an index that no
-   * bundler can shake. The family's entry indexes a small set, `icon/all`
-   * indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
-   * page that registers the glyphs it names or hands over the value instead.
+   * so it is what markup can carry, and resolving one means an index of the
+   * whole set that no bundler can shake: 15 kB for a consumer who renders one
+   * mark. An attribute is the only thing an HTML author can write, and that is
+   * worth the index; a consumer who would rather not pay it imports the
+   * element from `icon/root` and registers the glyphs it names, or hands over
+   * the value instead.
    *
    * A name written `prefix:name` asks the library registered under that
    * prefix.
@@ -85115,6 +85936,343 @@ export type CustomElementsSolidJs = {
       BaseEvents<HelixInput>
   >;
 
+  /**
+   * Each reading is a prism. The top face takes the cell's tone, and the two
+   * sides are the same tone, shaded darker, so the whole relief follows your
+   * theme's colors.
+   *
+   * `tones="1 2 3 4 5"` uses the same five-step ramp as `Heatmap`, so the tone
+   * and the height both show the value. Set `--isometric-heatmap-cell-size` to
+   * change how large a cell may grow.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `flat`: Draws every prism at no height, so the tones lie on a plane.
+   * - `relief`: How tall the highest reading stands, in cells. Every other reading stands
+   * at its share of it.
+   * - `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
+   * shadow root reads a table in that root rather than one in the document. A
+   * `<table>` or anything built from grid roles, including `helix-table`.
+   *
+   * **In React this arrives as a property and not as an attribute**, the way
+   * `Tooltip.for` does, so it does not reflect and nothing styles on it.
+   * - `label`: The chart's name, which starts the chart's text summary.
+   *
+   * Absent falls back to the table's own caption, which is usually the right
+   * words and is already written.
+   * - `locale`: The locale the chart's own numbers are written in: its axis, its
+   * percentages and its totals, such as `de` for `1.240` and `32 %`.
+   *
+   * Absent reads the nearest `lang`, then the runtime's own. The table's
+   * cells are shown as the table writes them, whatever this says.
+   * - `position-label`/`positionLabel`: Where a reading the keys moved to stands among the readings, said after
+   * it. `{position}` and `{count}` are replaced with the numbers, written in
+   * `locale`.
+   *
+   * Set it to the words of the page's language, such as `{position} von
+   * {count}`, or to nothing to say no position. A slice or a series a
+   * legend hid is not counted.
+   * - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
+   * `overview-label`.
+   * - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
+   * `min-cell` is.
+   * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
+   *
+   * **Set this only to overrule what the strip actually draws.** The arithmetic
+   * needs a width in pixels and the width is a length the stylesheet resolves,
+   * so a number written here that disagrees with the sheet is a promise the
+   * consumer has to keep by hand, and the one number a summary is told to trust
+   * is the one it gets wrong.
+   *
+   * The strip measures itself, so sizing the cells in a sheet is enough on its
+   * own and these two are the estimate used until the first measurement lands.
+   * Writing the attribute pins the value and stops the measurement being
+   * consulted, which is what a container query or a transition on the cell size
+   * wants, where what is drawn this frame is not what the arithmetic should
+   * plan around.
+   *
+   * Zero turns the dropping off altogether, which is right for a strip in a
+   * container that cannot get narrow.
+   * - `overview-label`/`overviewLabel`: The `overview`'s sentence. `{busiestLabel}` and `{totalLabel}` are
+   * `busiest-label` and `total-label`, `{busiest}` the busiest reading's name
+   * and its reading as the table writes it, and `{total}` the total of the
+   * readings drawn, written in the locale.
+   * - `rows`: How many rows the strip has.
+   *
+   * `1` is a status strip and `7` is a calendar week, which are the two readings
+   * this covers. Cells fill down the column and then across, which is what a
+   * calendar heatmap does: a week is a column, so the strip reads along the
+   * line in weeks, from the right on a right-to-left page, and top to bottom in
+   * days.
+   * - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
+   * - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
+   * how many cells are selected, written in the locale, and a language that
+   * needs plural forms writes them: `{count, plural, one {# wybrany} few
+   * {# wybrane} many {# wybranych} other {# wybranego}}`.
+   * - `selection-mode`/`selectionMode`: How many cells a reader can select: `single` or `multiple`.
+   *
+   * Absent selects nothing, and a press or Space does what it did.
+   * - `selection-shape`/`selectionShape`: What Shift takes in under `selection-mode="multiple"`: `linear`, every
+   * cell between two in the table's order, or `rectangle`, the cells between
+   * two corners by row and by column, as a spreadsheet selects a range.
+   * - `strip-label`/`stripLabel`: The strip's name where the chart has none: no `aria-label`, `label`, or
+   * table caption.
+   * - `thresholds`: Lower bounds for the tone buckets, in the order the tones are given.
+   *
+   * `thresholds="1 3 6 9"` with `tones="1 2 3 4"` puts 1 and 2 in the ramp's
+   * first step, 3 to 5 in the second, 6 to 8 in the third, and 9 upward in the
+   * fourth. A value below the first bound gets no tone at all: an empty day in a
+   * contribution graph is a day with nothing in it, and painting it as the
+   * lowest bucket claims a reading that does not exist.
+   * - `tones`: The tone for each bucket, in the same order as `thresholds`.
+   *
+   * A name, resolved as `--heatmap-tone-<name>` by whichever tier answers.
+   * **`"1"` through `"5"` are a ramp and everything else is a category**, which
+   * is the distinction a heatmap lives or dies on: magnitude has to be one hue
+   * getting louder, because a reader compares two cells by weight and cannot
+   * compare two hues at all. `tones="surface info accent success primary"` for a
+   * commit count is five unrelated hues for five amounts, which is confetti with
+   * 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, 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`.
+   * - `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.
+   *
+   * ```js
+   * chart.data = {
+   *   caption: 'Sessions by channel',
+   *   columns: ['Month', 'Direct', 'Referral'],
+   *   rows: [['Jan', 10, 4], ['Feb', 20, 8]],
+   * }
+   * ```
+   *
+   * The first column holds each row's label and every column after it a
+   * series, as in a table. A cell is a number, words, `null` for a blank,
+   * or `{ value, text }` for a number shown as words, such as `$128k`. A
+   * number is shown in `locale`.
+   *
+   * **A table is still the better source where the page can show one**:
+   * it reads with no script and before hydration, and a reader can sort and
+   * copy it. Data is drawn on the client only, so a server serves the
+   * 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. (property only)
+   * - `series`: The table's columns, one series each. Empty when there is no table.
+   *
+   * Held by the controller between edits, so a render reading this five
+   * times parses the table once. See `SourceController.series`. (property only) (readonly)
+   * - `named`: The chart's name: an `aria-label` written on the chart, then `label`,
+   * then the table's caption.
+   *
+   * The fallback is the reason this is shared rather than copied: a caption is
+   * already written, already the right words, and already the thing a reader
+   * of the table sees. A chart that made the consumer say it twice would be
+   * asking for the second one to drift.
+   *
+   * **An `aria-label` on the chart comes first**, because it is how a page
+   * 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)
+   * - `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
+   * column is a series where any row parses, so a series survives one blank
+   * cell and a column of words is never one. (property only) (readonly)
+   * - `readings`: The number of readings, which the pointer position maps onto. (property only) (readonly)
+   * - `visible`: How many cells are actually drawn.
+   *
+   * **This is the number a summary has to agree with**, and the reason it is
+   * published at all: a consumer's own summary is their markup and this element
+   * cannot rewrite it, so the only honest arrangement is to hand over the count
+   * and say when it changed.
+   *
+   * **A plain getter, and the attribute is written in `updated`, because
+   * `@property({ reflect: true })` on a getter with no setter reflects once and
+   * then goes stale.** Lit reflects a property that is in `changedProperties`,
+   * and nothing puts a derived getter there after the first update: the
+   * attribute would be right on load and wrong from the first resize, which is
+   * the exact failure the count exists to prevent, arriving through the
+   * mechanism meant to prevent it. (property only) (readonly)
+   * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
+   *
+   * **Named `whenSettled` because `settled` is taken four times over**, by
+   * Image, Splitter and both color controls, none of them about transitions. A
+   * base class takes the name every subclass then cannot use.
+   *
+   * **The state it reports cannot be watched, which is why this exists.** A
+   * custom state is deliberately not in the DOM, so there is no
+   * `MutationObserver` equivalent for `ElementInternals.states`. Await this
+   * instead.
+   *
+   * Separate from `updateComplete`, which resolves in the microtask checkpoint
+   * the suppression is still active in. That is the distinction `readyToMove`
+   * in `@fusion.dev/helix-testing` is written around.
+   *
+   * It never resolves where `requestAnimationFrame` never fires, which is a
+   * server, a hidden tab, and happy-dom. Callers that must not hang there race
+   * it against a timeout, as the happy-dom harness's `readyToMove` does. The
+   * 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.
+   *
+   * - `change`: Fired once a press or a key has changed which cells are selected.
+   * - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
+   * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, 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`.
+   * - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
+   * - `end`: Below the strip, at the trailing edge: usually the newest date.
+   * - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
+   * - `start`: Below the strip, at the leading edge: usually the oldest date.
+   * - `summary`: Below the strip, in the middle: a summary of the range shown.
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `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
+   * spent a while assuming it was.** `readSeries` drops a column nothing
+   * parses and `readRows` keeps it, so one column of notes among the figures
+   * moves every column after it one color along in the bubble: a row reading
+   * `Referral 1,080` wearing series three's green beside a legend that says
+   * series three is something else, which is the one failure the dot exists
+   * to prevent.
+   *
+   * Overridden where a chart reads the table some other way. `ScatterChart`
+   * splits the first plotted column off as the measure across, so its first
+   * *plotted* series is this table's second numeric column.
+   * - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
+   * reading the same table hid it.
+   *
+   * Asked of the table rather than of a legend, the table being the one
+   * thing the two share: see `SourceController.hide`. A series keeps its
+   * palette slot while it is hidden, so the colors of the others do not move.
+   * For a ring the names are its rows, the slices being the rows.
+   * - `showsColumn(cell: number) => boolean`: Whether the series read from the cell at this place in a row is drawn,
+   * by its column's heading. The keys and the readout pass over one a
+   * legend hid.
+   *
+   * A column's heading is the cell's name in every row, so the first row
+   * answers for the column.
+   * - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
+   * column's heading, read from the first row that has a cell there, so a
+   * short first row does not lose the heading. `''` where no row has one.
+   * - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
+   * month on or back, by the dates the rows' headers carry. Undefined where
+   * they carry none, and the keys move four columns.
+   *
+   * ## CSS Custom Properties
+   *
+   * CSS variables available for styling the component.
+   *
+   * - `--isometric-heatmap-cell-size`: The largest a cell grows, along its edge. The strip is never wider than its box, and draws smaller cells to fit.
+   * - `--isometric-heatmap-left-shade`: How much darker the left face is than the top, as a percentage mixed toward black.
+   * - `--isometric-heatmap-right-shade`: How much darker the right face is than the top, as a percentage mixed toward black.
+   * - `--isometric-heatmap-selected-color`: The color of the dashed edges of a selected prism, under `selection-mode`. By default, white on a dark face and black on a light one.
+   * - `--isometric-heatmap-span`: How many cells the drawing spans across: its columns and its rows together. The component writes it on the strip, and a stylesheet that caps the cell size reads it.
+   * - `--heatmap-rows`: How many rows the strip lays out. The component writes it from the data, and the stylesheet that draws the strip reads it.
+   * - `--heatmap-tone`: The tone of the cell it is set on. The component writes it, and the stylesheet that paints the cell reads it.
+   * - `--heatmap-tone-1`: The weakest step of the magnitude ramp, used by `tones="1 …"`.
+   * - `--heatmap-tone-2`: The second step of the magnitude ramp.
+   * - `--heatmap-tone-3`: The third step of the magnitude ramp.
+   * - `--heatmap-tone-4`: The fourth step of the magnitude ramp.
+   * - `--heatmap-tone-5`: The strongest step of the magnitude ramp.
+   * - `--heatmap-tone-accent`: The color of the `accent` tone.
+   * - `--heatmap-tone-danger`: The color of the `danger` tone.
+   * - `--heatmap-tone-info`: The color of the `info` tone.
+   * - `--heatmap-tone-muted`: The color of the `muted` tone: a quiet background, for a bucket that means nothing happened.
+   * - `--heatmap-tone-primary`: The color of the `primary` tone.
+   * - `--heatmap-tone-success`: The color of the `success` tone, named in `tones` or in `data-tone`.
+   * - `--heatmap-tone-warning`: The color of the `warning` tone.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `cell`: One reading.
+   * - `drawing`: The SVG every prism is drawn in. It is mirrored on a right-to-left page.
+   * - `left-face`: The face of a prism toward the next row, drawn at its lower left.
+   * - `right-face`: The face of a prism toward the next column, drawn at its lower right.
+   * - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
+   * - `strip`: The grid of cells, which takes focus to be read by key. It is named by the host's `aria-labelledby` or `aria-label`, then by `label`, then by the caption of the table.
+   * - `top-face`: The top of a prism, which carries the reading's tone.
+   * - `cell-active`: The cell the pointer or the keys rest on. Set alongside `cell`.
+   * - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
+   * - `empty`: The words under the strip 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, there being no document to resolve `for` in.
+   * - `end`: The trailing slot's box.
+   * - `footer`: The three-slot row under the strip.
+   * - `live`: The readout: a polite live region that says the cell the keys moved to. Hide it visually.
+   * - `loading`: The words under the strip 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.
+   * - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
+   * - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
+   * - `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.
+   * - `tooltip`: The bubble, forwarded from `Tooltip`.
+   * - `tooltip-anchor`: The `Tooltip` element itself.
+   * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
+   * - `tooltip-arrow-bottom`: The point while the bubble is below the reading, on its top edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-left`: The point while the bubble is left of the reading, on its right edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-right`: The point while the bubble is right of the reading, on its left edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-arrow-top`: The point while the bubble is above the reading, on its bottom edge. Set alongside `tooltip-arrow`.
+   * - `tooltip-bottom`: The bubble while it is below the reading. Set alongside `tooltip`.
+   * - `tooltip-cell`: One column's name and value inside the tooltip.
+   * - `tooltip-cell-current`: The cell the series keys rest on, in the charts whose readings hold several series. A strip draws one, so it is never set here.
+   * - `tooltip-label`: The reading's own name inside the tooltip.
+   * - `tooltip-left`: The bubble while it is left of the reading. Set alongside `tooltip`.
+   * - `tooltip-name`: A column's name inside the tooltip.
+   * - `tooltip-right`: The bubble while it is right of the reading. Set alongside `tooltip`.
+   * - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
+   * - `tooltip-value`: A column's value inside the tooltip.
+   *
+   * ## 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.
+   * - `loading`: While the `loading` 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-isometric-heatmap": Partial<
+    HelixIsometricHeatmapProps &
+      HelixIsometricHeatmapSolidJsProps &
+      BaseProps<HelixIsometricHeatmap> &
+      BaseEvents<HelixIsometricHeatmap>
+  >;
+
   /**
    * Drawn as a physical key, with a hairline border, a sunken fill, and one inset
    * shadow along the bottom edge.
@@ -103422,6 +104580,16 @@ export type CustomCssProperties = {
   "--input-radius"?: (string) | undefined;
   /** Height of the field. */
   "--input-size"?: (string) | undefined;
+  /** The largest a cell grows, along its edge. The strip is never wider than its box, and draws smaller cells to fit. */
+  "--isometric-heatmap-cell-size"?: (string) | undefined;
+  /** How much darker the left face is than the top, as a percentage mixed toward black. */
+  "--isometric-heatmap-left-shade"?: (string) | undefined;
+  /** How much darker the right face is than the top, as a percentage mixed toward black. */
+  "--isometric-heatmap-right-shade"?: (string) | undefined;
+  /** The color of the dashed edges of a selected prism, under `selection-mode`. By default, white on a dark face and black on a light one. */
+  "--isometric-heatmap-selected-color"?: (string) | undefined;
+  /** How many cells the drawing spans across: its columns and its rows together. The component writes it on the strip, and a stylesheet that caps the cell size reads it. */
+  "--isometric-heatmap-span"?: (string) | undefined;
   /** The fill of the key. */
   "--kbd-background-color"?: (string) | undefined;
   /** The height of a key, and the least width of one, in `em` of the text around it. */