@fusion.dev/helix 0.178.0 → 0.179.0

package/custom-elements.json

@@ -6238,7 +6238,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "One fragment shader draws over a full-screen triangle, and its palette comes\nfrom the tokens. A background built on `--helix-color-primary` changes when\nyour brand color changes.\n\nEvery shape ramps through four token stops, and the token layer inverts each\none: the page background, `primary-subtle`, `primary`, and a peak. The peak\nis the foreground on a dark page and `primary-active` on a light one, because\nmixing a saturated hue toward near-black removes its chroma. The component\nreads which way the page runs from the background's luminance, because the\nmode is a private token.\n\nThe geometry is three vertices derived from `gl_VertexID`. There is no\ndependency, scene graph, attribute, buffer, or upload.\n\nThe shader stops drawing in these cases:\n- The element is off screen or in a background tab.\n- `prefers-reduced-motion` is set. The element shows one still frame.\n- `paused` is set, from a pause control on your page. The element holds the\n  frame it shows.\n- The browser takes back the drawing context, on a GPU reset or past its\n  limit of about sixteen contexts. The gradient shows until the context\n  returns.\n\nOn a renderer that draws on the CPU, such as a headless browser or a machine\nwith no usable GPU, the element shows the gradient. There the shader costs\nabout 450ms for the first frame of each element, against 2ms on a GPU.\n\nAura is styled only and has behavior, which the tier split does not otherwise\nallow. Its behavior is drawing to a canvas, so there is no structure for you\nto restyle and nothing for a headless version to hold.\n\n**Content placed inside sits over the field**, in a `content` part that\ncovers the aura, so an interactive aura answers the pointer over the\ncontent too. Clicks still reach the content. Style `::part(content)` to\nplace it, such as centering a hero's heading.\n\n**The colors are the theme's, and each has a hook**: `--aura-ground`,\n`--aura-haze`, `--aura-glow` and `--aura-peak`, read by the shader and by the\nfallback gradient alike, from wherever on the page you set them. A hook\nchanged while the aura draws, by a class, a style or the color mode,\nreaches the shader on the next frame.\n\nWhere the gradient shows in place of the shader, the aura matches\n`:state(fallback)` and sends `helix-aura-fallback` with the reason.",
+          "description": "One fragment shader draws over a full-screen triangle, and its palette comes\nfrom the tokens. A background built on `--helix-color-primary` changes when\nyour brand color changes.\n\nEvery shape ramps through four token stops, and the token layer inverts each\none: the page background, `primary-subtle`, `primary`, and a peak. The peak\nis the foreground on a dark page and `primary-active` on a light one, because\nmixing a saturated hue toward near-black removes its chroma. The component\nreads which way the page runs from the background's luminance, because the\nmode is a private token.\n\nThe geometry is three vertices derived from `gl_VertexID`. There is no\ndependency, scene graph, attribute, buffer, or upload.\n\nThe shader stops drawing in these cases:\n- The element is off screen or in a background tab.\n- `prefers-reduced-motion` is set. The element shows one still frame.\n- `paused` is set, from a pause control on your page or from the aura's own\n  under `pause-control`. The element holds the frame it shows.\n- The browser takes back the drawing context, on a GPU reset or past its\n  limit of about sixteen contexts. The gradient shows until the context\n  returns.\n\nOn a renderer that draws on the CPU, such as a headless browser or a machine\nwith no usable GPU, the element shows the gradient. There the shader costs\nabout 450ms for the first frame of each element, against 2ms on a GPU.\n\nAura is styled only and has behavior, which the tier split does not otherwise\nallow. Its behavior is drawing to a canvas, so there is no structure for you\nto restyle and nothing for a headless version to hold.\n\n**Content placed inside sits over the field**, in a `content` part that\ncovers the aura, so an interactive aura answers the pointer over the\ncontent too. Clicks still reach the content. Style `::part(content)` to\nplace it, such as centering a hero's heading.\n\n**The colors are the theme's, and each has a hook**: `--aura-ground`,\n`--aura-haze`, `--aura-glow` and `--aura-peak`, read by the shader and by the\nfallback gradient alike, from wherever on the page you set them. A hook\nchanged while the aura draws, by a class, a style or the color mode,\nreaches the shader on the next frame.\n\n**`pause-control` draws a control that stops the motion and starts it\nagain**, in the trailing corner of the field, as WCAG 2.2.2 asks of\nanything that moves for more than five seconds. It is a toggle button named\nby `pause-label`, which says it is pressed while the field is paused, and a\npress sends `change`. A reader who asked for reduced motion sees no motion\nand no control.\n\nWhere the gradient shows in place of the shader, the aura matches\n`:state(fallback)` and sends `helix-aura-fallback` with the reason.",
           "name": "HelixAura",
           "cssProperties": [
             {
@@ -6253,6 +6253,10 @@
               "description": "The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`.",
               "name": "--aura-haze"
             },
+            {
+              "description": "The pause control's ground. Defaults to `--helix-color-surface-overlay`.",
+              "name": "--aura-pause-background-color"
+            },
             {
               "description": "The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one.",
               "name": "--aura-peak"
@@ -6266,6 +6270,14 @@
             {
               "description": "The box over the field that holds the content. It covers the aura.",
               "name": "content"
+            },
+            {
+              "description": "The control that pauses the field and starts it again, drawn under `pause-control`.",
+              "name": "pause"
+            },
+            {
+              "description": "The glyph on the pause control: pause while the field moves, play while it is paused.",
+              "name": "pause-mark"
             }
           ],
           "slots": [
@@ -6275,6 +6287,16 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "words",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-aura'",
+              "description": "The key this family's words are registered under:\n`registerWords('de', { 'helix-aura': { pauseLabel: 'Bewegung anhalten' } })`."
+            },
             {
               "kind": "field",
               "name": "bloom",
@@ -6325,6 +6347,16 @@
               "attribute": "interactive",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "pauseControl",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the aura draws its own control that pauses the field and starts it\nagain, in its trailing corner. Absent draws none, for a page with a pause\ncontrol of its own.",
+              "attribute": "pause-control"
+            },
             {
               "kind": "field",
               "name": "paused",
@@ -6335,6 +6367,19 @@
               "description": "Whether the field holds still on the frame it shows.\n\nSet it from a pause control on your page, so a reader can stop the motion,\nas WCAG 2.2.2 asks of anything that moves for more than five seconds. A\nchange to another property still repaints the frame. Clearing it starts\nthe field from where it stopped.",
               "attribute": "paused"
             },
+            {
+              "kind": "field",
+              "name": "pauseLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pause the motion'",
+              "description": "The pause control's name, read by screen readers. The control is a toggle\nand says it is pressed while the field is paused, so the name stays the\nsame.",
+              "attribute": "pause-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "reach",
@@ -6631,6 +6676,23 @@
               "default": "0",
               "description": "When to stop waiting and draw anyway.\n\nA page that resizes the field every frame forever would otherwise never get\nan opening frame at all. Half a second is far longer than a load takes to\nsettle and far shorter than a reader waits before deciding the background is\nsimply a gradient."
             },
+            {
+              "kind": "method",
+              "name": "renderPause",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "The aura's own pause control, under `pause-control`."
+            },
+            {
+              "kind": "field",
+              "name": "togglePause",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "start",
@@ -7264,6 +7326,14 @@
             }
           ],
           "events": [
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when the aura's own pause control pauses the field or starts it again.",
+              "name": "change",
+              "reactProp": "onchange"
+            },
             {
               "type": {
                 "text": "HelixAuraFallbackEvent"
@@ -7318,6 +7388,15 @@
               "description": "Whether the pointer shifts and lifts the field.\n\nReflected because the stylesheet selects on it: a background is not\nhit-testable at rest, or it would swallow clicks meant for what is over it,\nand an element that is not hit-testable never receives the `pointermove`\nthis listens for. Asking for the pointer is asking for the hit test.",
               "fieldName": "interactive"
             },
+            {
+              "name": "pause-control",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the aura draws its own control that pauses the field and starts it\nagain, in its trailing corner. Absent draws none, for a page with a pause\ncontrol of its own.",
+              "fieldName": "pauseControl"
+            },
             {
               "name": "paused",
               "type": {
@@ -7327,6 +7406,15 @@
               "description": "Whether the field holds still on the frame it shows.\n\nSet it from a pause control on your page, so a reader can stop the motion,\nas WCAG 2.2.2 asks of anything that moves for more than five seconds. A\nchange to another property still repaints the frame. Clearing it starts\nthe field from where it stopped.",
               "fieldName": "paused"
             },
+            {
+              "name": "pause-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pause the motion'",
+              "description": "The pause control's name, read by screen readers. The control is a toggle\nand says it is pressed while the field is paused, so the name stays the\nsame.",
+              "fieldName": "pauseLabel"
+            },
             {
               "name": "reach",
               "type": {
@@ -15888,6 +15976,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",
@@ -55439,6 +55544,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",
@@ -78452,6 +78574,23 @@
                 "module": "src/drilldown/item/drilldown-item.ts"
               }
             },
+            {
+              "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"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrilldownItem",
+                "module": "src/drilldown/item/drilldown-item.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -97542,7 +97681,7 @@
               }
             },
             {
-              "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",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -97557,6 +97696,14 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "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",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "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",
@@ -97565,6 +97712,22 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "description": "The same element as `strip`, under the name every chart gives the drawing that takes focus.",
+              "name": "plot",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
+            {
+              "description": "A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.",
+              "name": "row",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "description": "A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.",
               "name": "selection",
@@ -97622,6 +97785,22 @@
                 "name": "HelixHeadlessHeatmap",
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
+            },
+            {
+              "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",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
+            {
+              "description": "Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
             }
           ],
           "members": [
@@ -97675,12 +97854,91 @@
               },
               "static": true,
               "default": "''",
-              "description": "The key `position-label` is registered under: the host's own, which\neach chart names with its styled tag, `static words =\n'helix-line-chart'`. A host with none reads its tag name.",
+              "description": "The key the empty and loading words are registered under: the host's\nown, which each chart names with its styled tag, `static words =\n'helix-line-chart'`. A host with none reads its tag name.",
               "inheritedFrom": {
                 "name": "MixinChartSource",
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "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",
@@ -97949,23 +98207,6 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
-            {
-              "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
-              },
-              "inheritedFrom": {
-                "name": "HelixHeadlessHeatmap",
-                "module": "src/heatmap/root/heatmap-root.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "overviewLabel",
@@ -98004,7 +98245,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
@@ -98330,20 +98571,6 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
-            {
-              "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,
-              "inheritedFrom": {
-                "name": "HelixHeadlessHeatmap",
-                "module": "src/heatmap/root/heatmap-root.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "rowCount",
@@ -98477,22 +98704,22 @@
             },
             {
               "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
                 "module": "src/heatmap/root/heatmap-root.ts"
@@ -98500,14 +98727,40 @@
             },
             {
               "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
                 "module": "src/heatmap/root/heatmap-root.ts"
@@ -98515,22 +98768,43 @@
             },
             {
               "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.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
+            {
+              "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
                 "module": "src/heatmap/root/heatmap-root.ts"
@@ -98547,6 +98821,16 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onPointerUp",
+              "privacy": "private",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "onPointerLeave",
@@ -98931,6 +99215,45 @@
           "tagName": "helix-heatmap",
           "customElement": true,
           "attributes": [
+            {
+              "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": {
@@ -98996,19 +99319,6 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
-            {
-              "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",
-              "inheritedFrom": {
-                "name": "HelixHeadlessHeatmap",
-                "module": "src/heatmap/root/heatmap-root.ts"
-              }
-            },
             {
               "name": "gap",
               "type": {
@@ -99067,7 +99377,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",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -99190,6 +99500,30 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "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",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
+            {
+              "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",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixResizeEvent"
@@ -99220,6 +99554,14 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "description": "While the `loading` part stands in place of the cells.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -99736,6 +100078,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",
@@ -134623,6 +134982,23 @@
                 "module": "src/menu/item/menu-item.ts"
               }
             },
+            {
+              "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"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenuItem",
+                "module": "src/menu/item/menu-item.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "tag",
@@ -142252,23 +142628,6 @@
                 "module": "src/notifications/notification/notification.ts"
               }
             },
-            {
-              "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
-              },
-              "inheritedFrom": {
-                "name": "HelixHeadlessNotification",
-                "module": "src/notifications/notification/notification.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "readState",
@@ -142365,6 +142724,37 @@
                 "module": "src/notifications/notification/notification.ts"
               }
             },
+            {
+              "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
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessNotification",
+                "module": "src/notifications/notification/notification.ts"
+              }
+            },
+            {
+              "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,
+              "inheritedFrom": {
+                "name": "HelixHeadlessNotification",
+                "module": "src/notifications/notification/notification.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleActions",
@@ -142394,7 +142784,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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
                 "module": "src/notifications/notification/notification.ts"
@@ -189223,6 +189613,23 @@
                 "module": "src/speed-dial/item/speed-dial-item.ts"
               }
             },
+            {
+              "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"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessSpeedDialItem",
+                "module": "src/speed-dial/item/speed-dial-item.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -209659,6 +210066,23 @@
                 "module": "src/tabs/tab/tab.ts"
               }
             },
+            {
+              "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"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessTab",
+                "module": "src/tabs/tab/tab.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -250704,6 +251128,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.178.0"
+    "version": "0.179.0"
   }
 }