@fusion.dev/helix 0.177.2 → 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",
@@ -87900,6 +88039,20 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "filterDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long typing rests before `source` is asked, in milliseconds. A delay\nsends one request for a word in place of one for each letter. The arrow\nkeys and Enter ask at once. `0` asks on every keystroke.",
+              "attribute": "filter-delay",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "filterSuggestions",
@@ -87974,6 +88127,18 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "source",
+              "type": {
+                "text": "FilterSource | undefined | undefined"
+              },
+              "description": "Where the suggestions come from: a function given the term at the caret,\nthe field it is a value of, the whole text, and an `AbortSignal`, which\nreturns the suggestions or a promise of them. Each is a string, or a\n`value` with a `label` and `disabled`. The field draws them as options in\nthe panel, beside any you slot. A property only, there being no way to\nwrite a function in markup. See the class description.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "suggestionLabel",
@@ -88521,6 +88686,178 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "fetching",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether a request to `source` is out, which the panel shows as loading.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "busy",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the suggestions are loading: `loading`, or a request to `source` out.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "request",
+              "type": {
+                "text": "AbortController | undefined"
+              },
+              "privacy": "private",
+              "description": "The request to `source` still out, which a later one aborts.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "asked",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The text `source` was last asked about, so focus alone does not ask again.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "used",
+              "type": {
+                "text": "FilterSource | undefined"
+              },
+              "privacy": "private",
+              "description": "The source the suggestions drawn now came from.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "sourced",
+              "type": {
+                "text": "SuggestionOption[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The options this element drew from what `source` gave, which the next answer replaces.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "asking",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new DelayController(this, { renders: false })",
+              "description": "The request waiting out `filterDelay`, if any.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resetSource",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "A new source, or none: what the old one gave goes, and the new one is\nasked where the reader is in the field.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "askSoon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks `source` once typing rests for `filterDelay`, or at once without one.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "ask",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks `source` for suggestions for the term at the caret, and draws what\nit gives.\n\n**A later request aborts this one, and an answer that arrives late is\ndropped**, whether or not the source heeds the signal: the panel shows\nwhat the text says now.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "drawSourced",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "suggestions",
+                  "type": {
+                    "text": "readonly FilterSuggestion[]"
+                  }
+                }
+              ],
+              "description": "Draws what `source` gave as options in the `suggestions` slot, in place of\nthe ones it gave before, and leaves the ones you slotted alone. The\noptions are this tier's `Option`, which a page on the headless tier\nimports; one not registered is reported.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSourcedSelect",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A suggestion `source` gave, chosen: its value written over the term at the\ncaret, and a finished `field:value` read into a chip, as Enter reads it.\n\n**After every listener has had its turn**, as a chip under `chips` is\ndrawn, so a `preventDefault()` on the `helix-select` is read and leaves the\ntext to you.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "move",
@@ -89829,6 +90166,19 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "name": "filter-delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long typing rests before `source` is asked, in milliseconds. A delay\nsends one request for a word in place of one for each letter. The arrow\nkeys and Enter ask at once. `0` asks on every keystroke.",
+              "fieldName": "filterDelay",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "name": "filter-suggestions",
               "type": {
@@ -90035,7 +90385,7 @@
               "type": {
                 "text": "HelixSelectEvent"
               },
-              "description": "Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on a choice; you decide what it does.",
+              "description": "Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on an option you slotted, and you decide what it does. A suggestion from `source` is written over the term at the caret unless you cancel it.",
               "name": "helix-select",
               "reactProp": "onhelix-select",
               "inheritedFrom": {
@@ -90212,7 +90562,7 @@
               }
             },
             {
-              "description": "Shown in the panel while the suggestions load.",
+              "description": "Shown in the panel while the suggestions load: while `loading` is set, or a request to `source` is out.",
               "name": "loading",
               "inheritedFrom": {
                 "name": "HelixHeadlessFilterInput",
@@ -90254,7 +90604,7 @@
               }
             },
             {
-              "description": "While `loading` is set.",
+              "description": "While `loading` is set, or a request to `source` is out.",
               "name": "loading",
               "inheritedFrom": {
                 "name": "HelixHeadlessFilterInput",
@@ -93504,6 +93854,23 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "linkCountLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{note}. {count, plural, =0 {No links} one {# link} other {# links}}'",
+              "description": "What screen readers hear when a walk along the links reaches a note that\nhas no link to follow, or goes back to a note: `{note}` for its name and\n`{count}` for how many notes the list holds that it links to or from.",
+              "attribute": "link-count-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "linkedBothLabel",
@@ -93793,6 +94160,23 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "walkLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{note}. {relation}. {index} of {count}'",
+              "description": "What screen readers hear when a walk along the links moves to a note:\n`{note}` for its name, `{relation}` for how it stands to the note the\nstep came from, such as \"Linked from Roadmap\", and `{index}` and `{count}`\nfor its place among that note's links.",
+              "attribute": "walk-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "zoomedInLabel",
@@ -93869,6 +94253,61 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "fieldKeys",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the search field's arrow keys have moved onto a note, which the\nfield then names as its `aria-activedescendant` while the focus stays in\nit. Typing, Left, Right, Escape, and leaving the field let it go.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "listKeys",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the list has the focus, so the drawing marks the note its keys are on.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "trail",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The notes a walk along the links stepped from, by `id`, the last the one\nthe note the keys are on was reached from. Empty when the keys moved some\nother way.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "keyedSent",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The note the drawing last heard the keys are on, so it hears each move once.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "adjacency",
@@ -94043,6 +94482,21 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "keyedId",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
+                }
+              },
+              "description": "The `id` of the note the keys are on, or `undefined` where neither the list nor the field has them.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "ready",
@@ -94296,6 +94750,10 @@
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "walking",
+                  "default": "false"
                 }
               ],
               "description": "Moves the keyboard to a row, and the list to show it.\n\n**The row the keys are on is always drawn**, beside the window where it is\noutside it, so `aria-activedescendant` names a row that exists. The list\nthen scrolls to it, see `revealCursor`.",
@@ -94385,6 +94843,104 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "linkedRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The rows of the notes `id` links to or is linked from, in the list's\norder, which is the order of their names. Only the notes the list holds:\na search, the legend, or `depth` leaves the others out.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "relationFrom",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "How the note `id` stands to the note `from`, in the words the list uses for the selection.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "walk",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "A walk along the links from the note the keys are on, with Alt and the\narrow keys, so a reader follows the lines of the drawing and not only\nthe order of the list. **The same four keys a tree takes**, with Alt,\nsince the list's own arrows already move through it:\n\n- Alt+Right follows a link, to the first note the one the keys are on\n  links to or from.\n- Alt+Down and Alt+Up move to the next and the previous note linked to\n  the one the step came from, wrapping.\n- Alt+Left goes back along the links walked.\n\nRight and Left swap on a right-to-left page. Each step says the note, how\nit stands to the note it was reached from, and its place among that\nnote's links. Returns whether the key was one of the walk's.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "sayLinks",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Says the note at row `at` and how many notes in the list it links to or from.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "pageRows",
@@ -94405,7 +94961,18 @@
               "name": "handleSearchKeydown",
               "privacy": "private",
               "readonly": true,
-              "description": "The search field's keys, which belong to the field and never pan the\ngraph. Escape empties a search that has words in it, and passes through\nan empty one to whatever the page does with it.",
+              "description": "The search field's keys, which belong to the field and never pan the\ngraph.\n\n**The field is a combobox over the list**, as React Aria's Autocomplete\nand the APG combobox are: the focus stays in the field, and Down and Up\nmove the keys through the notes, which the field names as its\n`aria-activedescendant`. Down starts on the note the keys were last on,\nthe first after a search, and Up on the last. Page Down and Page Up move\na page, Enter selects, Alt and the arrows walk the links as in the list,\nand Left, Right, Home and End go back to the text.\n\nEscape lets the note go, then empties a search that has words in it, and\npasses through an empty one to whatever the page does with it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSearchBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Leaving the field lets go of the note its keys were on.",
               "inheritedFrom": {
                 "name": "HelixHeadlessGraph",
                 "module": "src/graph/root/graph-root.ts"
@@ -94448,6 +95015,7 @@
               "name": "handleSearch",
               "privacy": "private",
               "readonly": true,
+              "description": "Typing is a new search, read from its top, with no note under the keys until Down.",
               "inheritedFrom": {
                 "name": "HelixHeadlessGraph",
                 "module": "src/graph/root/graph-root.ts"
@@ -95166,6 +95734,19 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "name": "link-count-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{note}. {count, plural, =0 {No links} one {# link} other {# links}}'",
+              "description": "What screen readers hear when a walk along the links reaches a note that\nhas no link to follow, or goes back to a note: `{note}` for its name and\n`{count}` for how many notes the list holds that it links to or from.",
+              "fieldName": "linkCountLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "name": "linked-both-label",
               "type": {
@@ -95387,6 +95968,19 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "name": "walk-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{note}. {relation}. {index} of {count}'",
+              "description": "What screen readers hear when a walk along the links moves to a note:\n`{note}` for its name, `{relation}` for how it stands to the note the\nstep came from, such as \"Linked from Roadmap\", and `{index}` and `{count}`\nfor its place among that note's links.",
+              "fieldName": "walkLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "name": "wheel-hint-label",
               "type": {
@@ -95492,7 +96086,7 @@
               "type": {
                 "text": "HelixGraphPartChangeEvent"
               },
-              "description": "The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.",
+              "description": "The notes, the links, the selection, the depth, the note the keys are on, or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.",
               "name": "helix-graph-part-change",
               "reactProp": "onhelix-graph-part-change",
               "inheritedFrom": {
@@ -97087,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",
@@ -97102,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",
@@ -97110,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",
@@ -97167,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": [
@@ -97220,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",
@@ -97494,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",
@@ -97549,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
@@ -97875,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",
@@ -98022,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"
@@ -98045,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"
@@ -98060,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"
@@ -98092,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",
@@ -98476,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": {
@@ -98541,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": {
@@ -98612,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",
@@ -98735,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"
@@ -98765,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",
@@ -99281,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",
@@ -134168,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",
@@ -141797,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",
@@ -141910,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",
@@ -141939,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"
@@ -188768,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",
@@ -209204,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",
@@ -250249,6 +251128,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.177.2"
+    "version": "0.179.0"
   }
 }