@fusion.dev/helix-headless 0.178.0 → 0.179.0

package/custom-elements.json

@@ -11491,6 +11491,19 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -44952,6 +44965,23 @@
                 "module": "src/button/root/button-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessButton",
+                "module": "src/button/root/button-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -63668,6 +63698,19 @@
               },
               "description": "The caret of a row that opens a page, as the `chevron` slot's fallback, so\nan icon of your own replaces it by being slotted."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the row, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the row, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -79127,7 +79170,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A grid of cells, each colored by a tone. `rows=\"1\"` makes a status strip, and\n`rows=\"7\"` makes a contribution graph. GitHub's contribution graph uses five\ndiscrete levels, which a set of tones covers.\n\nColor in a heatmap is per cell. In every other Helix chart, color is per\nseries, so ninety differently colored cells would need ninety series.\n\n**The data is a real `<table>` named by `for`**, as in every Helix chart, and\nthe table is the accessible representation. Hide it with\n`data-hidden-visually`, and screen readers still read it.\n\nA cell takes its tone from its own `data-tone`, or from `thresholds` and\n`tones` applied to its value. `data-tone` wins, so when you already know a\nday was degraded, you can set the tone directly.\n\n**The headless tier does not resolve tone names.** A tone named `success`\nwrites `--heatmap-tone: var(--heatmap-tone-success)`, and the styled tier or\nyour own stylesheet defines that property. The headless tier does not use\n`var(--helix-color-*)`.\n\n**The strip is read by key.** It takes focus once it has cells. The up and\ndown arrows move a cell, the left and right arrows move a column, which is a\nweek with `rows=\"7\"`, and Home and End go to the first and the last. The\ntooltip follows, the `live` part says the cell's row in words, and Escape\nputs the tooltip away. PageUp and PageDown move a month, to the same day,\nwhere each row's header carries its date as a `<time datetime>`, and four\ncolumns otherwise, which is four weeks with `rows=\"7\"`.\n\n**The strip describes itself.** The `overview` part says the busiest\nreading and the total of the readings drawn, \"Busiest: 11 Jun, 12; Total\n84\", and the strip is described by it, as every chart is by its summary.\nHide it visually. The `summary` slot is still yours, for words of your own.\n\n**`selection-mode` lets a reader select cells**: `single` one at a time and\n`multiple` any number. Space, Enter or a press selects the cell the keys or\nthe pointer rest on, or lets it go, and under `multiple` Shift with an arrow,\nHome, End, PageUp or PageDown takes in every cell from the last one pressed\nto where the key went. `value` holds the selected days, separated by\ncommas: each by its row's `<time datetime>`, such as `2026-06-11`, or by\nits row's name where the row carries no date. A change asks with\n`helix-before-change` and tells with `change`, and the `selection` part says\nhow many are selected, in `selection-label`.\n\n**Keyboard.** The strip is one tab stop once it has cells.\n\n| Key | What it does |\n|---|---|\n| Tab | Moves focus to the strip and shows the first cell. |\n| Down, Up | Moves to the next or the previous cell. |\n| Right, Left | Moves a column on or back, a week with `rows=\"7\"`. On a right-to-left page, Left moves on. |\n| Home, End | Moves to the first or the last cell. |\n| Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |\n| Enter, Space | Selects the cell, or lets it go, under `selection-mode`. |\n| Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode=\"multiple\"`. |\n| Escape | Puts the cell's tooltip away. |",
+          "description": "A grid of cells, each colored by a tone. `rows=\"1\"` makes a status strip, and\n`rows=\"7\"` makes a contribution graph. GitHub's contribution graph uses five\ndiscrete levels, which a set of tones covers.\n\nColor in a heatmap is per cell. In every other Helix chart, color is per\nseries, so ninety differently colored cells would need ninety series.\n\n**The data is a real `<table>` named by `for`**, as in every Helix chart, and\nthe table is the accessible representation. Hide it with\n`data-hidden-visually`, and screen readers still read it.\n\nA cell takes its tone from its own `data-tone`, or from `thresholds` and\n`tones` applied to its value. `data-tone` wins, so when you already know a\nday was degraded, you can set the tone directly.\n\n**The headless tier does not resolve tone names.** A tone named `success`\nwrites `--heatmap-tone: var(--heatmap-tone-success)`, and the styled tier or\nyour own stylesheet defines that property. The headless tier does not use\n`var(--helix-color-*)`.\n\n**The strip is read by key.** It takes focus once it has cells. The up and\ndown arrows move a cell, the left and right arrows move a column, which is a\nweek with `rows=\"7\"`, and Home and End go to the first and the last. The\ntooltip follows, the `live` part says the cell's row in words, and Escape\nputs the tooltip away. PageUp and PageDown move a month, to the same day,\nwhere each row's header carries its date as a `<time datetime>`, and four\ncolumns otherwise, which is four weeks with `rows=\"7\"`.\n\n**The strip describes itself.** The `overview` part says the busiest\nreading and the total of the readings drawn, \"Busiest: 11 Jun, 12; Total\n84\", and the strip is described by it, as every chart is by its summary.\nHide it visually. The `summary` slot is still yours, for words of your own.\n\n**`selection-mode` lets a reader select cells**: `single` one at a time and\n`multiple` any number. Space, Enter or a press selects the cell the keys or\nthe pointer rest on, or lets it go, and under `multiple` Shift with an arrow,\nHome, End, PageUp or PageDown takes in every cell from the last one pressed\nto where the key went. `value` holds the selected days, separated by\ncommas: each by its row's `<time datetime>`, such as `2026-06-11`, or by\nits row's name where the row carries no date. A change asks with\n`helix-before-change` and tells with `change`, and the `selection` part says\nhow many are selected, in `selection-label`.\n\n**Under `selection-mode` the strip is a grid**, so the selection is state a\nreader is told rather than words alone: each column of the strip is a `row`,\na week with `rows=\"7\"`, and each cell a `gridcell` named by its row in the\ntable and carrying `aria-selected`. The strip says\n`aria-multiselectable` under `multiple` and points at the cell the keys rest\non with `aria-activedescendant`, so a screen reader reads that cell, and the\n`live` part stays quiet. Without `selection-mode` nothing is selectable, and\nthe strip is an application with the readout, as every chart's plot is.\n\n**Readings are sent as every chart sends them.** `helix-reading-change`\nsays each move of the reading, by pointer, tap or key, and\n`helix-reading-press` a reading clicked, tapped, or pressed with Enter or\nSpace, each with the row of the table in `index`.\n\n**Nothing to draw.** A table with no readings shows `empty-text`, \"No\nreadings\", under the strip, and `loading` shows `loading-text` there until\nreadings arrive. The `empty` and `loading` slots take markup in place of\neither, as on every chart.\n\n**Keyboard.** The strip is one tab stop once it has cells.\n\n| Key | What it does |\n|---|---|\n| Tab | Moves focus to the strip and shows the first cell. |\n| Down, Up | Moves to the next or the previous cell. |\n| Right, Left | Moves a column on or back, a week with `rows=\"7\"`. On a right-to-left page, Left moves on. |\n| Home, End | Moves to the first or the last cell. |\n| Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |\n| Enter, Space | Presses the cell, which sends `helix-reading-press`, and selects it or lets it go under `selection-mode`. |\n| Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode=\"multiple\"`. |\n| Escape | Puts the cell's tooltip away. |",
           "name": "HelixHeadlessHeatmap",
           "cssProperties": [
             {
@@ -79201,7 +79244,7 @@
               "name": "cell-selected"
             },
             {
-              "description": "Shown when the table has no readings. It stays hidden until the table can be read: on the server and during hydration, there is no document to resolve `for` in.",
+              "description": "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.",
               "name": "empty"
             },
             {
@@ -79216,6 +79259,10 @@
               "description": "The readout: a polite live region that says the cell the keys moved to. Hide it visually.",
               "name": "live"
             },
+            {
+              "description": "The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.",
+              "name": "loading"
+            },
             {
               "description": "The invisible point the tooltip is anchored to.",
               "name": "mark"
@@ -79224,6 +79271,14 @@
               "description": "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.",
               "name": "overview"
             },
+            {
+              "description": "The same element as `strip`, under the name every chart gives the drawing that takes focus.",
+              "name": "plot"
+            },
+            {
+              "description": "A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.",
+              "name": "row"
+            },
             {
               "description": "A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.",
               "name": "selection"
@@ -79310,10 +79365,18 @@
             }
           ],
           "slots": [
+            {
+              "description": "Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.",
+              "name": "empty"
+            },
             {
               "description": "Below the strip, at the trailing edge: usually the newest date.",
               "name": "end"
             },
+            {
+              "description": "Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.",
+              "name": "loading"
+            },
             {
               "description": "Below the strip, at the leading edge: usually the oldest date.",
               "name": "start"
@@ -79351,19 +79414,6 @@
                 "words": true
               }
             },
-            {
-              "kind": "field",
-              "name": "emptyText",
-              "type": {
-                "text": "string"
-              },
-              "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
-              "attribute": "empty-text",
-              "helix": {
-                "words": true
-              }
-            },
             {
               "kind": "field",
               "name": "gap",
@@ -79414,7 +79464,7 @@
                 "text": "string"
               },
               "default": "'selected'",
-              "description": "What the readout adds for a selected cell, under `selection-mode`, after\nwhere the cell stands: \"Day 1: 0 (1 of 14, selected)\". Empty adds\nnothing.",
+              "description": "What the readout added for a selected cell, under `selection-mode`.",
               "attribute": "selected-label",
               "helix": {
                 "words": true
@@ -79652,16 +79702,6 @@
               "description": "Every row in the table, oldest first, as the table is written, with its\nreading where the row has one.\n\n**Not `readings`, which the mixin already has and which means a count.**\nTwo members of the same name meaning a number and an array is the kind of\ncollision that type-checks in one direction and reads wrong in both.\n\n**One cell per row, and a blank row is a cell with no reading.** Taken from\nthe series alone, a blank dropped its day and every day after it moved one\ncell along, while the tooltip still counted rows and named the day beside\nthe one under the pointer.",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "sourceKnown",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a tree that can answer about\nids rather than of one that holds children. An id that resolves to nothing\nin a browser is still known, and still empty: a `for` naming no table\nshould say so rather than sit blank, which is why this asks\n`searchableById` and not `elementById`.\n\n`readingsKnown` asks it for every chart, and for `data` too, which a\nserver does not draw.",
-              "readonly": true
-            },
             {
               "kind": "field",
               "name": "rowCount",
@@ -79776,52 +79816,95 @@
             },
             {
               "kind": "method",
-              "name": "renderOverview",
-              "privacy": "protected",
+              "name": "renderRows",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult"
+                  "text": "TemplateResult[]"
                 }
               },
               "parameters": [
                 {
                   "name": "cells",
                   "type": {
-                    "text": "Reading[]"
+                    "text": "TemplateResult[]"
                   }
                 }
               ],
-              "description": "What the strip shows, in a sentence: the busiest reading drawn, as the\ntable writes it, and the total of them all, in `locale`. The strip is\ndescribed by it, so a reader landing on the strip hears what it holds\nbefore walking it."
+              "description": "The cells as a grid's rows, one for each column of the strip, so a week\nis a row with `rows=\"7\"` and a status strip is one row.\n\n**A column, because that is the order the cells are in.** The strip fills\ndown the column and then across, so a row wrapping a column keeps every\ncell where it was, and `display: contents` keeps the wrapper out of the\nstrip's grid, drawing no box, which is a mechanism and not a look. A row\nacross the strip would have taken cells out of order and moved them."
             },
             {
               "kind": "method",
-              "name": "renderTooltip",
-              "privacy": "protected",
+              "name": "renderGridCell",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult | typeof nothing"
+                  "text": "TemplateResult"
                 }
               },
-              "description": "The bubble over the cell a pointer is resting on.\n\n**One tooltip that moves, which is what every other chart here does.** Bar\nChart, Line Chart and Donut Chart each render a single anchor against an\ninvisible mark and move the mark, so the count is one however many readings\nthere are, rather than one element per cell. `drawTooltip` is their shared\nmarkup and this is the fourth caller.\n\nWhat it buys over a native `title` is the row rather than the reading.\n`sourceRows` carries every column of the table including the ones nothing\nwas plotted from, so a cell reads \"11 Jun 2026 / Uptime 81.2% / Note Partial\noutage\" where `title` could only ever say the two values this component\nhappens to hold. It is also styleable, appears at once rather than after the\nplatform's second of delay, and cannot be truncated by the window edge.\n\nThe mark is placed in pixels rather than in percent, which is the one thing\nthis does differently from its siblings: they divide a plot into equal\nslots, and a strip's cells are a fixed size with a fixed gap inside a box\nthat is usually wider, so a percentage of the box lands between cells. The\npitch is `cell + gap` and both are measured."
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "active",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "picked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "tone",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "One cell under `selection-mode`: a `gridcell` named by its row in the\ntable, its reading and its place, and saying whether it is selected, which\na reader hears on reaching it as the strip's active descendant."
             },
             {
               "kind": "method",
-              "name": "reading",
-              "privacy": "private",
+              "name": "renderOverview",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "ReadingCursor"
+                  "text": "TemplateResult"
                 }
               },
               "parameters": [
                 {
-                  "name": "at",
+                  "name": "cells",
                   "type": {
-                    "text": "number"
+                    "text": "Reading[]"
                   }
                 }
               ],
-              "description": "The readout's cursor: the pointer, with the selected word after where a\nselected cell stands, so a reader moving through the strip hears which\ncells are in the selection and not only how many."
+              "description": "What the strip shows, in a sentence: the busiest reading drawn, as the\ntable writes it, and the total of them all, in `locale`. The strip is\ndescribed by it, so a reader landing on the strip hears what it holds\nbefore walking it."
+            },
+            {
+              "kind": "method",
+              "name": "renderTooltip",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "grid",
+                  "default": "false"
+                }
+              ],
+              "description": "The bubble over the cell a pointer is resting on.\n\n**One tooltip that moves, which is what every other chart here does.** Bar\nChart, Line Chart and Donut Chart each render a single anchor against an\ninvisible mark and move the mark, so the count is one however many readings\nthere are, rather than one element per cell. `drawTooltip` is their shared\nmarkup and this is the fourth caller.\n\nWhat it buys over a native `title` is the row rather than the reading.\n`sourceRows` carries every column of the table including the ones nothing\nwas plotted from, so a cell reads \"11 Jun 2026 / Uptime 81.2% / Note Partial\noutage\" where `title` could only ever say the two values this component\nhappens to hold. It is also styleable, appears at once rather than after the\nplatform's second of delay, and cannot be truncated by the window edge.\n\nThe mark is placed in pixels rather than in percent, which is the one thing\nthis does differently from its siblings: they divide a plot into equal\nslots, and a strip's cells are a fixed size with a fixed gap inside a box\nthat is usually wider, so a percentage of the box lands between cells. The\npitch is `cell + gap` and both are measured."
             },
             {
               "kind": "field",
@@ -79830,12 +79913,97 @@
               "readonly": true,
               "description": "Which drawn cell the pointer is over, or -1.\n\n`pointerover` on the strip rather than a listener per cell: the event\nbubbles, so one handler covers however many cells there are, and unlike\n`mouseover` it is delivered for a pen."
             },
+            {
+              "kind": "field",
+              "name": "onPointerUp",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "onPointerLeave",
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "emptyText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No readings'",
+              "description": "The words shown in place of the drawing when the table has no readings,\nand the fallback of the `empty` slot.",
+              "attribute": "empty-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the readings are still on their way. The chart shows\n`loading-text` in place of an empty drawing until it has readings.\n\nReflected, so a stylesheet can treat the chart while it waits. A chart\nthat already has readings keeps drawing them, so a refresh does not\nblank it.",
+              "attribute": "loading",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loadingText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading readings'",
+              "description": "The words shown in place of the drawing while `loading` is set and\nthere are no readings yet, and the fallback of the `loading` slot.",
+              "attribute": "loading-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderStatus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "What stands in the plot while there is nothing to draw: the `loading`\nline, the `empty` line, or nothing while the table cannot be read yet.\n\n`dir=\"auto\"`, so words in a right-to-left script read their own way in\na plot that holds itself left to right, as Scatter Chart's does.",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderEmpty",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The plot while there is nothing to draw: a group named as the chart is,\nholding `renderStatus`. Not focusable, there being no reading to walk.",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "source",
@@ -80431,6 +80599,22 @@
               "name": "helix-before-change",
               "reactProp": "onhelix-before-change"
             },
+            {
+              "type": {
+                "text": "HelixReadingChangeEvent"
+              },
+              "description": "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.",
+              "name": "helix-reading-change",
+              "reactProp": "onhelix-reading-change"
+            },
+            {
+              "type": {
+                "text": "HelixReadingPressEvent"
+              },
+              "description": "A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.",
+              "name": "helix-reading-press",
+              "reactProp": "onhelix-reading-press"
+            },
             {
               "type": {
                 "text": "HelixResizeEvent"
@@ -80450,15 +80634,6 @@
               "description": "The name the `overview` gives the busiest reading, `{busiestLabel}` in\n`overview-label`.",
               "fieldName": "busiestLabel"
             },
-            {
-              "name": "empty-text",
-              "type": {
-                "text": "string"
-              },
-              "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
-              "fieldName": "emptyText"
-            },
             {
               "name": "gap",
               "type": {
@@ -80501,7 +80676,7 @@
                 "text": "string"
               },
               "default": "'selected'",
-              "description": "What the readout adds for a selected cell, under `selection-mode`, after\nwhere the cell stands: \"Day 1: 0 (1 of 14, selected)\". Empty adds\nnothing.",
+              "description": "What the readout added for a selected cell, under `selection-mode`.",
               "fieldName": "selectedLabel"
             },
             {
@@ -80566,6 +80741,45 @@
               "description": "The selected cells, separated by commas: each by the date its row's\nheader carries in a `<time datetime>`, such as `2026-06-11`, or by the\nheader's words where it carries none.\n\nSet it to start with cells selected. Written by a press or a key under\n`selection-mode`.",
               "fieldName": "value"
             },
+            {
+              "name": "empty-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No readings'",
+              "description": "The words shown in place of the drawing when the table has no readings,\nand the fallback of the `empty` slot.",
+              "fieldName": "emptyText",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the readings are still on their way. The chart shows\n`loading-text` in place of an empty drawing until it has readings.\n\nReflected, so a stylesheet can treat the chart while it waits. A chart\nthat already has readings keeps drawing them, so a refresh does not\nblank it.",
+              "fieldName": "loading",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "name": "loading-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading readings'",
+              "description": "The words shown in place of the drawing while `loading` is set and\nthere are no readings yet, and the fallback of the `loading` slot.",
+              "fieldName": "loadingText",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
             {
               "name": "for",
               "type": {
@@ -80628,6 +80842,10 @@
               "description": "While the `empty` part stands in place of the cells.",
               "name": "empty"
             },
+            {
+              "description": "While the `loading` part stands in place of the cells.",
+              "name": "loading"
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -80638,6 +80856,10 @@
             }
           ],
           "mixins": [
+            {
+              "name": "MixinChartStatus",
+              "package": "@fusion.dev/helix-core"
+            },
             {
               "name": "MixinChartSource",
               "package": "@fusion.dev/helix-core"
@@ -81067,6 +81289,23 @@
                 "module": "src/button/root/button-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessButton",
+                "module": "src/button/root/button-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -110801,6 +111040,19 @@
               "description": "Whether the row says what it is from its host, for a field's `aria-activedescendant`.",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the row, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the row, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -116474,6 +116726,23 @@
               "description": "Whether the notification starts as read, used until `read` is set.",
               "attribute": "default-read"
             },
+            {
+              "kind": "field",
+              "name": "dismissLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dismiss {label}'",
+              "description": "The dismiss control's name, read by screen readers, with `{label}` for the\nrow's own words.\n\nOne sentence with the words in it, so a translation puts them where its\nlanguage does: `registerWords('de', { 'helix-notification': { dismissLabel:\n'{label} schließen' } })`.",
+              "attribute": "dismiss-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "locale",
@@ -116493,19 +116762,6 @@
               "description": "Whether the notification has been read.\n\nSet it and this element defers: a reader's click fires `helix-read` and\nchanges nothing until a new value arrives. `default-read` seeds a state\nthis element then owns.\n\n**Not reflected.** Unread is a visual state, which is why the four mixins\nmirror theirs, but the mirror may not be the property's own attribute:\n`<helix-headless-notification default-read>` comes back from a server\nwithout `read` and would gain it on the first update, which React reports\nas a hydration mismatch, and which a copy of the serialized element\nre-parses as a declaration. `:state(read)` is what the stylesheet reads.\n`hydration.dom.spec.ts` holds it.",
               "attribute": "read"
             },
-            {
-              "kind": "field",
-              "name": "unreadLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Unread'",
-              "description": "What a screen reader hears before an unread notification's text.\n\nThe unread mark is drawn, so a reader who cannot see it hears this word in\nits place. Translate it with the rest of your interface.",
-              "attribute": "unread-label",
-              "helix": {
-                "words": true
-              }
-            },
             {
               "kind": "field",
               "name": "readState",
@@ -116578,6 +116834,29 @@
               },
               "description": "When it happened, delegated whole.\n\nThe tag is interpolated rather than written, so each tier renders its own:\nthe base tier may not name a styled element, and a styled item inherits this\ntemplate without having a tag of its own to remind anybody.\n\n`exportparts` and no `part` of its own, which is the rule about a part\nalready named for its role: the child publishes `time`, the role here is\n`time`, and naming both would leave `::part(time)` matching two elements.\nWhat a consumer wants to reach is the `<time>`, so that is what the name\nreaches. Format Date's field parts go on under `time-`, as every composed\nchild's do, though an elapsed time draws no fields."
             },
+            {
+              "kind": "field",
+              "name": "unreadLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Unread'",
+              "description": "What a screen reader hears before an unread notification's text.\n\nThe unread mark is drawn, so a reader who cannot see it hears this word in\nits place. Translate it with the rest of your interface.",
+              "attribute": "unread-label",
+              "helix": {
+                "words": true
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dismissName",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "The dismiss control's name: `dismissLabel` with the row's words.\n\n**Named for its row**, because a feed of rows each with a control named\nDismiss is a list of buttons that says nothing about which notice each one\nends. The words are the default slot's, the ones `helix-dismiss` reports,\nso a row's actions are not read into it. A page's own `dismiss-label` with\nno `{label}` is followed by them, unless it holds them already, as `Tag`\nnames its remove button. Read from the children, so the verb alone on a\nserver, until the update after.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "handleActions",
@@ -116599,7 +116878,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "Where focus goes when this row leaves: the next row's first control, the\none before, then the first control left in the feed."
+              "description": "Where focus goes when this row leaves: the next row, the one before, then\nthe first control left in the feed.\n\n**The row itself, and not a control in it**, because the row is what a\nreader moves through the feed by, and every row takes focus. Sent to the\nnext dismiss control, focus passed over each row with no controls between,\nand to Load more where no row after had one. Focused, the row becomes the\nfeed's stop, as one reached with the arrows does."
             },
             {
               "kind": "field",
@@ -116616,23 +116895,6 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "dismissLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "The dismiss control's label, read by screen readers.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.\n\nA word property: register it for a locale under the host's key. A family\nthat names the control otherwise, such as Tag's `Remove {label}`,\ndeclares its own English with `@words` above the override.",
-              "attribute": "dismiss-label",
-              "helix": {
-                "words": true
-              },
-              "inheritedFrom": {
-                "name": "MixinDismissible",
-                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "dismissEvent",
@@ -117173,6 +117435,19 @@
               "description": "Whether the notification starts as read, used until `read` is set.",
               "fieldName": "defaultRead"
             },
+            {
+              "name": "dismiss-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dismiss {label}'",
+              "description": "The dismiss control's name, read by screen readers, with `{label}` for the\nrow's own words.\n\nOne sentence with the words in it, so a translation puts them where its\nlanguage does: `registerWords('de', { 'helix-notification': { dismissLabel:\n'{label} schließen' } })`.",
+              "fieldName": "dismissLabel",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "name": "locale",
               "type": {
@@ -117211,19 +117486,6 @@
                 "name": "MixinDismissible",
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
-            },
-            {
-              "name": "dismiss-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "The dismiss control's label, read by screen readers.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.\n\nA word property: register it for a locale under the host's key. A family\nthat names the control otherwise, such as Tag's `Remove {label}`,\ndeclares its own English with `@words` above the override.",
-              "fieldName": "dismissLabel",
-              "inheritedFrom": {
-                "name": "MixinDismissible",
-                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
-              }
             }
           ],
           "cssStates": [
@@ -150381,6 +150643,19 @@
                 "text": "focusItem() => void"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the action, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the action and follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -165115,6 +165390,19 @@
               "readonly": true,
               "description": "Chooses the tab before the browser follows its link, and keeps the browser\nfrom following where the choice was refused. A press with a modifier, or\nwith a button other than the main one, opens the link where the browser\nopens it and chooses nothing here."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the tab, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nselects the tab, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "dismissible",
@@ -199436,6 +199724,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.178.0"
+    "version": "0.179.0"
   }
 }