@fusion.dev/helix-headless 0.177.2 → 0.179.0

package/custom-elements.json

@@ -11491,6 +11491,19 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -44952,6 +44965,23 @@
                 "module": "src/button/root/button-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessButton",
+                "module": "src/button/root/button-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -63668,6 +63698,19 @@
               },
               "description": "The caret of a row that opens a page, as the `chevron` slot's fallback, so\nan icon of your own replaces it by being slotted."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the row, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the row, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -69668,6 +69711,30 @@
             "name": "*",
             "module": "src/filter-input/root/filter-input-root.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "FilterSource",
+          "declaration": {
+            "name": "FilterSource",
+            "module": "./suggest.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FilterSourceRequest",
+          "declaration": {
+            "name": "FilterSourceRequest",
+            "module": "./suggest.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FilterSuggestion",
+          "declaration": {
+            "name": "FilterSuggestion",
+            "module": "./suggest.js"
+          }
         }
       ]
     },
@@ -70860,7 +70927,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Tokens are your own elements, slotted in. A filter can be a facet with a\nprefix, a saved query, or a range, and these belong to your model, so the\nelement does not render tokens from a list of strings. Removing a token is a\nrequest the element fires, and you apply it. Combobox works the other way:\nits tokens show a selection it owns, drawn from the options it was given.\n\n`value` is the typed text. Every keystroke fires `input` with the text on the\nelement, so a table can narrow as the user types. Backspace in an empty field\nfires `helix-dismiss` on the last token, the same event its remove control\nfires, so one handler covers the pointer and the keyboard.\n\n**What a form receives.** The text under `name`, and then one more entry\nunder `name` for each token, in the order the tokens stand:\n\n| Token | Entry |\n|---|---|\n| Any element with a `value` attribute | The value as written: `saved:mine` |\n| `FilterChip` with `name` and values | `status:open,pending` |\n| The same, with `operator=\"none\"` (what a typed `-status:` makes) | `-status:open,pending` |\n| The same, with any other `operator` except `any` | `created[after]:2024` |\n| A token with neither | Nothing |\n\nThe values are the chip's text outside its `field` and `operator` slots,\nwith the spaces around each comma removed. A server splits an entry at its\nfirst colon, reads a leading `-` as the negation, and reads a word in\nbrackets before the colon as the comparison.\n\n**Keyboard.** Focus stays in the text, which is the field's one tab stop. The\ntext names the highlighted suggestion as its `aria-activedescendant`, and the\narrow keys reach the tokens.\n\n| Key | What it does |\n|---|---|\n| Enter | Presses the highlighted suggestion. With none highlighted, reads the typed filters into chips, or submits the form when there are none. |\n| Down, Up | Moves the highlight through the suggestions, wrapping, and opens the panel. |\n| Home, End | Highlights the first or the last suggestion while the panel is open. |\n| Escape | Closes the panel and stops there, so a dialog around the field stays open. With the panel closed, empties the text. In an empty field, does nothing, so the page hears it. |\n| Backspace | In an empty field, asks the last token to go. |\n| Left | With the caret at the start of the text, moves to the last token's remove button. Right on a right-to-left page. |\n| Left, Right on a token | Move between the tokens, and past the last back to the text. |\n| Delete, Backspace on a token | Asks the token to go. |\n\n**Typed filters.** The field parses only the fields you declare. Write\n`FilterField` elements, usually inside the `FilterMenu` slotted into `start`,\nso the picker and the text share one set. On Enter, the field reads the text\nagainst them, and a paste is read the same way as soon as it lands.\n`disposition:refunded,settled` and `-disposition:refunded` fire\n`helix-facet` exactly as ticking those values in the picker would, and the\nparsed text is removed. Everything else stays, so `refund tuesday\ndisposition:settled` is a filter and a search at once. Helix defines the\npunctuation and you define every word. `grammar.ts` has the full rule, so\nread it before you rely on it. A field with no `FilterField` in it parses\nnothing.\n\nA field whose values cannot be listed, such as `assignee:ada`, goes directly\ninside this element, outside the menu. It is not assigned to a slot, so\nnothing draws it and the menu has no page for it, and the grammar still reads\nit.\n\n**The picker has an entry of its own.** `FilterMenu` draws its pages with\n`Menu`, which a field without a picker does not need, so this family's entry\nleaves it out. A page that writes one imports\n`@fusion.dev/helix/filter-input/menu` as well, and a picker written without it\nis reported once the page has loaded, with the entry to add.\n\n**Suggestions.** Slot options into `suggestions` and the field shows them,\nmoves through them with the arrow keys, and presses one on Enter. The option\nfires its own `helix-select`, and you decide what choosing it means. Keys\nbefore a colon and values after it use the same panel with different\ncontents. `filter-suggestions` narrows the panel to the options whose words\nhold the term at the caret, after its colon, ignoring case and accents, and\nhides the rest. `readFilterText` is exported so you can narrow it yourself\nagainst partly typed text. While the panel is open, a reader hears how many\nsuggestions it offers. The panel opens when it has options and closes when it has\nnone, and a choice does not close it, so after picking a key you see its\nvalues next. Use `selectionStart` and `setSelectionRange` to write a\ncompletion back and put the caret after it, or the next parse reads the wrong\nterm.\n\n**State.** Three things have three different owners:\n\n- `value` is the text. The user types, the element applies it, and `input`\n  reports it. Setting `value` seeds or corrects the text, and the next\n  keystroke overwrites it, even in React. To control the value, cancel\n  `helix-before-change` and write the value you want, as with every field in\n  this library. `default-value` seeds the field.\n- `open` is the suggestions panel. Cancel `helix-before-open` or\n  `helix-before-close` to control it, and use `default-open` to seed it.\n- Tokens are your elements in a slot and hold no state. A token goes when you\n  remove it from your markup after `helix-dismiss`. A `FilterChip` naming a\n  declared field works differently, because the picker holds what is ticked\n  and removing the chip alone would leave its value ticked in the hidden\n  menu. Its dismissal is treated as the field being filtered by nothing, so\n  it fires `helix-facet` like every other change, and the chip goes when the\n  filter goes. Set `chips` and the field adds, updates, and removes those\n  chips itself, from every `helix-facet` you do not cancel.",
+          "description": "Tokens are your own elements, slotted in. A filter can be a facet with a\nprefix, a saved query, or a range, and these belong to your model, so the\nelement does not render tokens from a list of strings. Removing a token is a\nrequest the element fires, and you apply it. Combobox works the other way:\nits tokens show a selection it owns, drawn from the options it was given.\n\n`value` is the typed text. Every keystroke fires `input` with the text on the\nelement, so a table can narrow as the user types. Backspace in an empty field\nfires `helix-dismiss` on the last token, the same event its remove control\nfires, so one handler covers the pointer and the keyboard.\n\n**What a form receives.** The text under `name`, and then one more entry\nunder `name` for each token, in the order the tokens stand:\n\n| Token | Entry |\n|---|---|\n| Any element with a `value` attribute | The value as written: `saved:mine` |\n| `FilterChip` with `name` and values | `status:open,pending` |\n| The same, with `operator=\"none\"` (what a typed `-status:` makes) | `-status:open,pending` |\n| The same, with any other `operator` except `any` | `created[after]:2024` |\n| A token with neither | Nothing |\n\nThe values are the chip's text outside its `field` and `operator` slots,\nwith the spaces around each comma removed. A server splits an entry at its\nfirst colon, reads a leading `-` as the negation, and reads a word in\nbrackets before the colon as the comparison.\n\n**Keyboard.** Focus stays in the text, which is the field's one tab stop. The\ntext names the highlighted suggestion as its `aria-activedescendant`, and the\narrow keys reach the tokens.\n\n| Key | What it does |\n|---|---|\n| Enter | Presses the highlighted suggestion. With none highlighted, reads the typed filters into chips, or submits the form when there are none. |\n| Down, Up | Moves the highlight through the suggestions, wrapping, and opens the panel. |\n| Home, End | Highlights the first or the last suggestion while the panel is open. |\n| Escape | Closes the panel and stops there, so a dialog around the field stays open. With the panel closed, empties the text. In an empty field, does nothing, so the page hears it. |\n| Backspace | In an empty field, asks the last token to go. |\n| Left | With the caret at the start of the text, moves to the last token's remove button. Right on a right-to-left page. |\n| Left, Right on a token | Move between the tokens, and past the last back to the text. |\n| Delete, Backspace on a token | Asks the token to go. |\n\n**Typed filters.** The field parses only the fields you declare. Write\n`FilterField` elements, usually inside the `FilterMenu` slotted into `start`,\nso the picker and the text share one set. On Enter, the field reads the text\nagainst them, and a paste is read the same way as soon as it lands.\n`disposition:refunded,settled` and `-disposition:refunded` fire\n`helix-facet` exactly as ticking those values in the picker would, and the\nparsed text is removed. Everything else stays, so `refund tuesday\ndisposition:settled` is a filter and a search at once. Helix defines the\npunctuation and you define every word. `grammar.ts` has the full rule, so\nread it before you rely on it. A field with no `FilterField` in it parses\nnothing.\n\nA field whose values cannot be listed, such as `assignee:ada`, goes directly\ninside this element, outside the menu. It is not assigned to a slot, so\nnothing draws it and the menu has no page for it, and the grammar still reads\nit.\n\n**The picker has an entry of its own.** `FilterMenu` draws its pages with\n`Menu`, which a field without a picker does not need, so this family's entry\nleaves it out. A page that writes a `FilterMenu` imports both entries:\n\n```js\nimport '@fusion.dev/helix/filter-input'\nimport '@fusion.dev/helix/filter-input/menu'\n```\n\nA picker written without the second is reported once the page has loaded,\nwith the entry to add.\n\n**Suggestions.** Slot options into `suggestions` and the field shows them,\nmoves through them with the arrow keys, and presses one on Enter. The option\nfires its own `helix-select`, and you decide what choosing it means. Keys\nbefore a colon and values after it use the same panel with different\ncontents. `filter-suggestions` narrows the panel to the options whose words\nhold the term at the caret, after its colon, ignoring case and accents, and\nhides the rest. `readFilterText` is exported so you can narrow it yourself\nagainst partly typed text. While the panel is open, a reader hears how many\nsuggestions it offers. The panel opens when it has options and closes when it has\nnone, and a choice does not close it, so after picking a key you see its\nvalues next. Use `selectionStart` and `setSelectionRange` to write a\ncompletion back and put the caret after it, or the next parse reads the wrong\nterm.\n\n**Suggestions from a source.** Set `source` to a function, and the field asks\nit for suggestions as the text changes and draws them as options in the\npanel. It is given the term at the caret, the field the term is a value of,\nthe whole text, and an `AbortSignal`, and returns the suggestions or a\npromise of them. `filter-delay` waits for typing to rest before asking, and\na later keystroke aborts a request still out. While a promise is pending, the\npanel shows `loading-text` and a screen reader hears it, then the count.\nChoosing a suggestion writes its value over the term at the caret, and a\nfinished `field:value` is read into a chip as Enter would. Cancel its\n`helix-select` to write it yourself.\n\n```js\nfilter.source = async ({ field, term, signal }) => {\n  const response = await fetch(`/values?field=${field}&q=${term}`, { signal })\n  return response.json()\n}\n```\n\n**State.** Three things have three different owners:\n\n- `value` is the text. The user types, the element applies it, and `input`\n  reports it. Setting `value` seeds or corrects the text, and the next\n  keystroke overwrites it, even in React. To control the value, cancel\n  `helix-before-change` and write the value you want, as with every field in\n  this library. `default-value` seeds the field.\n- `open` is the suggestions panel. Cancel `helix-before-open` or\n  `helix-before-close` to control it, and use `default-open` to seed it.\n- Tokens are your elements in a slot and hold no state. A token goes when you\n  remove it from your markup after `helix-dismiss`. A `FilterChip` naming a\n  declared field works differently, because the picker holds what is ticked\n  and removing the chip alone would leave its value ticked in the hidden\n  menu. Its dismissal is treated as the field being filtered by nothing, so\n  it fires `helix-facet` like every other change, and the chip goes when the\n  filter goes. Set `chips` and the field adds, updates, and removes those\n  chips itself, from every `helix-facet` you do not cancel.",
           "name": "HelixHeadlessFilterInput",
           "cssParts": [
             {
@@ -70900,7 +70967,7 @@
               "name": "live"
             },
             {
-              "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"
             },
             {
@@ -71028,6 +71095,16 @@
                 "words": true
               }
             },
+            {
+              "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"
+            },
             {
               "kind": "field",
               "name": "filterSuggestions",
@@ -71082,6 +71159,14 @@
               "description": "The text shown while the field is empty.\n\nNot a label: it goes when typing starts.",
               "attribute": "placeholder"
             },
+            {
+              "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."
+            },
             {
               "kind": "field",
               "name": "suggestionLabel",
@@ -71481,6 +71566,130 @@
               },
               "description": "Opens the panel when there is something in it, and closes it when there is\nnot.\n\n**Derived rather than commanded, which is the whole of how two levels\nwork.** A reader who picks `disposition` wants its values next, and the\nconsumer answers by rendering those values; if picking closed the panel it\nwould shut and reopen between two renders, which a reader sees as a flicker\nand a screen reader hears as a list going away. Nothing here closes on a\nchoice: the panel goes when the consumer stops offering, which is exactly\nwhen a value has been completed and there is nothing left to say.\n\nThrough `requestOpen` for both directions, so `helix-before-open` and\n`helix-before-close` still gate it and a consumer who refuses is obeyed.\n**No guard of its own**, because that method already returns early when the\nanswer has not moved: this runs after every render, and a second guard here\nwould only be a copy of that one going stale."
             },
+            {
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "busy",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the suggestions are loading: `loading`, or a request to `source` out.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "request",
+              "type": {
+                "text": "AbortController | undefined"
+              },
+              "privacy": "private",
+              "description": "The request to `source` still out, which a later one aborts."
+            },
+            {
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "used",
+              "type": {
+                "text": "FilterSource | undefined"
+              },
+              "privacy": "private",
+              "description": "The source the suggestions drawn now came from."
+            },
+            {
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "asking",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new DelayController(this, { renders: false })",
+              "description": "The request waiting out `filterDelay`, if any."
+            },
+            {
+              "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."
+            },
+            {
+              "kind": "method",
+              "name": "askSoon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks `source` once typing rests for `filterDelay`, or at once without one."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
             {
               "kind": "method",
               "name": "move",
@@ -73410,7 +73619,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"
             },
@@ -73463,6 +73672,15 @@
               "description": "The name of the clear button, read by screen readers. The button shows only\nan icon.",
               "fieldName": "clearLabel"
             },
+            {
+              "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"
+            },
             {
               "name": "filter-suggestions",
               "type": {
@@ -73750,7 +73968,7 @@
               "name": "invalid"
             },
             {
-              "description": "While `loading` is set.",
+              "description": "While `loading` is set, or a request to `source` is out.",
               "name": "loading"
             },
             {
@@ -73868,6 +74086,61 @@
           ],
           "description": "The term being typed at the caret: the run of text since the last space,\nand after its colon where it has one, so `status:ope` narrows by `ope`."
         },
+        {
+          "kind": "function",
+          "name": "currentField",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "caret",
+              "default": "text.length",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "The field the term at the caret is a value of: the word before its colon,\nwithout a leading `-`, so `-status:ope` is a value of `status`. Empty where\nthe term has no colon, which is a key being typed."
+        },
+        {
+          "kind": "function",
+          "name": "completeTerm",
+          "return": {
+            "type": {
+              "text": "{ caret: number; text: string }"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "caret",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The text with a suggestion written over the term at the caret, and where\nthe caret goes after it.\n\nThe word's field and its colon stay, and a leading `-`, so a value chosen\nfor `-status:op` gives `-status:open`. A space follows, ready for the next\nterm, unless the suggestion ends with a colon, which is a key whose value\ncomes next."
+        },
         {
           "kind": "function",
           "name": "suggests",
@@ -73938,6 +74211,22 @@
             "module": "src/filter-input/suggest.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "currentField",
+          "declaration": {
+            "name": "currentField",
+            "module": "src/filter-input/suggest.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "completeTerm",
+          "declaration": {
+            "name": "completeTerm",
+            "module": "src/filter-input/suggest.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "suggests",
@@ -75477,7 +75766,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Helix draws no graph. A force layout of thousands of notes is physics and\nWebGL, which a renderer such as Sigma.js does. Put the renderer's box in the\nframe, and `connectGraph` from `@fusion.dev/helix-graph` draws `nodes` and\n`links` in it and keeps it in step with the frame.\n\nWhat the frame adds is what a drawing of a graph cannot do: a list of every\nnote beside it, which is the graph for a screen reader and a quick way to\nfind a note for anyone. The selected note comes first, then the notes it\nlinks to and from, then every other note, and the search field narrows it.\nSelecting a note in the list or in the drawing is the same selection.\n\nSet `depth` to show the local graph: only the notes within that many links\nof the selected one.\n\nSet `legend` to name the groups over the drawing, each a button that shows\nor hides its notes. `hiddenGroups` holds the groups turned off, and the\nlist holds only what the drawing shows. The legend is a toolbar and one tab\nstop: the arrow keys, Home, End and a group's first letters move between\nits buttons, and Space or Enter presses one.\n\n`nodes` and `links` are properties, never markup: a graph of ten thousand\nnotes as ten thousand elements would cost what the renderer exists to save.\nThe list draws only the rows in view.\n\nThe list scrolls on this tier. It carries `data-scroller`, and `core` ships\n`[data-scroller] { overflow: auto }` into every shadow root. You still need\nto set a block size on the list, or it grows to hold every row.",
+          "description": "Helix draws no graph. A force layout of thousands of notes is physics and\nWebGL, which a renderer such as Sigma.js does. Put the renderer's box in the\nframe, and `connectGraph` from `@fusion.dev/helix-graph` draws `nodes` and\n`links` in it and keeps it in step with the frame.\n\nWhat the frame adds is what a drawing of a graph cannot do: a list of every\nnote beside it, which is the graph for a screen reader and a quick way to\nfind a note for anyone. The selected note comes first, then the notes it\nlinks to and from, then every other note, and the search field narrows it.\nSelecting a note in the list or in the drawing is the same selection.\n\nSet `depth` to show the local graph: only the notes within that many links\nof the selected one.\n\nThe search field is a combobox over the list. Down and Up move through the\nnotes while the focus stays in the field, and Enter selects one.\n\n**Walk the links with Alt and the arrow keys**, in the list or in the\nsearch field once its keys are on a note. The note the keys are on is\nmarked in the drawing.\n\n| Key | What it does |\n|---|---|\n| Alt+Right | Follows a link, to the first note the one the keys are on links to or from. |\n| Alt+Down, Alt+Up | Moves to the next or the previous note linked to 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 it\nstands to the note it came from, and its place among that note's links,\nsuch as \"Hiring plan. Linked from Roadmap. 2 of 3\". Enter selects the note.\n\nSet `legend` to name the groups over the drawing, each a button that shows\nor hides its notes. `hiddenGroups` holds the groups turned off, and the\nlist holds only what the drawing shows. The legend is a toolbar and one tab\nstop: the arrow keys, Home, End and a group's first letters move between\nits buttons, and Space or Enter presses one.\n\n`nodes` and `links` are properties, never markup: a graph of ten thousand\nnotes as ten thousand elements would cost what the renderer exists to save.\nThe list draws only the rows in view.\n\nThe list scrolls on this tier. It carries `data-scroller`, and `core` ships\n`[data-scroller] { overflow: auto }` into every shadow root. You still need\nto set a block size on the list, or it grows to hold every row.",
           "name": "HelixHeadlessGraph",
           "cssParts": [
             {
@@ -75830,6 +76119,19 @@
                 "words": true
               }
             },
+            {
+              "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
+              }
+            },
             {
               "kind": "field",
               "name": "linkedBothLabel",
@@ -76081,6 +76383,19 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.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
+              }
+            },
             {
               "kind": "field",
               "name": "wheelHintLabel",
@@ -76154,6 +76469,45 @@
               "default": "false",
               "description": "Whether the search and the list are open over the drawing, with `no-panel`."
             },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
             {
               "kind": "field",
               "name": "adjacency",
@@ -76276,6 +76630,17 @@
               "readonly": true,
               "default": "new VirtualizeController(this, { container: () => this.partNamed('list'), count: () => this.entries.length, estimate: () => 32, rows: () => [...(this.renderRoot.querySelectorAll?.('[data-index]') ?? [])].map((element) => ({ element: element as HTMLElement, index: Number((element as HTMLElement).dataset.index), })), })"
             },
+            {
+              "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."
+            },
             {
               "kind": "field",
               "name": "ready",
@@ -76592,6 +76957,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`."
@@ -76657,6 +77026,88 @@
               ],
               "description": "Moves to the next note whose name starts with what was typed, through\ncore's `Typeahead`, as a listbox does: letters within half a second run\ntogether, and a repeated letter steps through the names that start with it."
             },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
+            {
+              "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."
+            },
             {
               "kind": "method",
               "name": "pageRows",
@@ -76673,7 +77124,14 @@
               "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."
+            },
+            {
+              "kind": "field",
+              "name": "handleSearchBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Leaving the field lets go of the note its keys were on."
             },
             {
               "kind": "method",
@@ -76718,7 +77176,8 @@
               "kind": "field",
               "name": "handleSearch",
               "privacy": "private",
-              "readonly": true
+              "readonly": true,
+              "description": "Typing is a new search, read from its top, with no note under the keys until Down."
             },
             {
               "kind": "method",
@@ -77905,7 +78364,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"
             },
@@ -78015,6 +78474,15 @@
               "description": "The legend's name, read by screen readers.",
               "fieldName": "legendLabel"
             },
+            {
+              "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"
+            },
             {
               "name": "linked-both-label",
               "type": {
@@ -78168,6 +78636,15 @@
               "description": "The line shown while the graph, with `gestures=\"activate\"`, has the gestures.",
               "fieldName": "usingLabel"
             },
+            {
+              "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"
+            },
             {
               "name": "wheel-hint-label",
               "type": {
@@ -78693,7 +79170,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A grid of cells, each colored by a tone. `rows=\"1\"` makes a status strip, and\n`rows=\"7\"` makes a contribution graph. GitHub's contribution graph uses five\ndiscrete levels, which a set of tones covers.\n\nColor in a heatmap is per cell. In every other Helix chart, color is per\nseries, so ninety differently colored cells would need ninety series.\n\n**The data is a real `<table>` named by `for`**, as in every Helix chart, and\nthe table is the accessible representation. Hide it with\n`data-hidden-visually`, and screen readers still read it.\n\nA cell takes its tone from its own `data-tone`, or from `thresholds` and\n`tones` applied to its value. `data-tone` wins, so when you already know a\nday was degraded, you can set the tone directly.\n\n**The headless tier does not resolve tone names.** A tone named `success`\nwrites `--heatmap-tone: var(--heatmap-tone-success)`, and the styled tier or\nyour own stylesheet defines that property. The headless tier does not use\n`var(--helix-color-*)`.\n\n**The strip is read by key.** It takes focus once it has cells. The up and\ndown arrows move a cell, the left and right arrows move a column, which is a\nweek with `rows=\"7\"`, and Home and End go to the first and the last. The\ntooltip follows, the `live` part says the cell's row in words, and Escape\nputs the tooltip away. PageUp and PageDown move a month, to the same day,\nwhere each row's header carries its date as a `<time datetime>`, and four\ncolumns otherwise, which is four weeks with `rows=\"7\"`.\n\n**The strip describes itself.** The `overview` part says the busiest\nreading and the total of the readings drawn, \"Busiest: 11 Jun, 12; Total\n84\", and the strip is described by it, as every chart is by its summary.\nHide it visually. The `summary` slot is still yours, for words of your own.\n\n**`selection-mode` lets a reader select cells**: `single` one at a time and\n`multiple` any number. Space, Enter or a press selects the cell the keys or\nthe pointer rest on, or lets it go, and under `multiple` Shift with an arrow,\nHome, End, PageUp or PageDown takes in every cell from the last one pressed\nto where the key went. `value` holds the selected days, separated by\ncommas: each by its row's `<time datetime>`, such as `2026-06-11`, or by\nits row's name where the row carries no date. A change asks with\n`helix-before-change` and tells with `change`, and the `selection` part says\nhow many are selected, in `selection-label`.\n\n**Keyboard.** The strip is one tab stop once it has cells.\n\n| Key | What it does |\n|---|---|\n| Tab | Moves focus to the strip and shows the first cell. |\n| Down, Up | Moves to the next or the previous cell. |\n| Right, Left | Moves a column on or back, a week with `rows=\"7\"`. On a right-to-left page, Left moves on. |\n| Home, End | Moves to the first or the last cell. |\n| Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |\n| Enter, Space | Selects the cell, or lets it go, under `selection-mode`. |\n| Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode=\"multiple\"`. |\n| Escape | Puts the cell's tooltip away. |",
+          "description": "A grid of cells, each colored by a tone. `rows=\"1\"` makes a status strip, and\n`rows=\"7\"` makes a contribution graph. GitHub's contribution graph uses five\ndiscrete levels, which a set of tones covers.\n\nColor in a heatmap is per cell. In every other Helix chart, color is per\nseries, so ninety differently colored cells would need ninety series.\n\n**The data is a real `<table>` named by `for`**, as in every Helix chart, and\nthe table is the accessible representation. Hide it with\n`data-hidden-visually`, and screen readers still read it.\n\nA cell takes its tone from its own `data-tone`, or from `thresholds` and\n`tones` applied to its value. `data-tone` wins, so when you already know a\nday was degraded, you can set the tone directly.\n\n**The headless tier does not resolve tone names.** A tone named `success`\nwrites `--heatmap-tone: var(--heatmap-tone-success)`, and the styled tier or\nyour own stylesheet defines that property. The headless tier does not use\n`var(--helix-color-*)`.\n\n**The strip is read by key.** It takes focus once it has cells. The up and\ndown arrows move a cell, the left and right arrows move a column, which is a\nweek with `rows=\"7\"`, and Home and End go to the first and the last. The\ntooltip follows, the `live` part says the cell's row in words, and Escape\nputs the tooltip away. PageUp and PageDown move a month, to the same day,\nwhere each row's header carries its date as a `<time datetime>`, and four\ncolumns otherwise, which is four weeks with `rows=\"7\"`.\n\n**The strip describes itself.** The `overview` part says the busiest\nreading and the total of the readings drawn, \"Busiest: 11 Jun, 12; Total\n84\", and the strip is described by it, as every chart is by its summary.\nHide it visually. The `summary` slot is still yours, for words of your own.\n\n**`selection-mode` lets a reader select cells**: `single` one at a time and\n`multiple` any number. Space, Enter or a press selects the cell the keys or\nthe pointer rest on, or lets it go, and under `multiple` Shift with an arrow,\nHome, End, PageUp or PageDown takes in every cell from the last one pressed\nto where the key went. `value` holds the selected days, separated by\ncommas: each by its row's `<time datetime>`, such as `2026-06-11`, or by\nits row's name where the row carries no date. A change asks with\n`helix-before-change` and tells with `change`, and the `selection` part says\nhow many are selected, in `selection-label`.\n\n**Under `selection-mode` the strip is a grid**, so the selection is state a\nreader is told rather than words alone: each column of the strip is a `row`,\na week with `rows=\"7\"`, and each cell a `gridcell` named by its row in the\ntable and carrying `aria-selected`. The strip says\n`aria-multiselectable` under `multiple` and points at the cell the keys rest\non with `aria-activedescendant`, so a screen reader reads that cell, and the\n`live` part stays quiet. Without `selection-mode` nothing is selectable, and\nthe strip is an application with the readout, as every chart's plot is.\n\n**Readings are sent as every chart sends them.** `helix-reading-change`\nsays each move of the reading, by pointer, tap or key, and\n`helix-reading-press` a reading clicked, tapped, or pressed with Enter or\nSpace, each with the row of the table in `index`.\n\n**Nothing to draw.** A table with no readings shows `empty-text`, \"No\nreadings\", under the strip, and `loading` shows `loading-text` there until\nreadings arrive. The `empty` and `loading` slots take markup in place of\neither, as on every chart.\n\n**Keyboard.** The strip is one tab stop once it has cells.\n\n| Key | What it does |\n|---|---|\n| Tab | Moves focus to the strip and shows the first cell. |\n| Down, Up | Moves to the next or the previous cell. |\n| Right, Left | Moves a column on or back, a week with `rows=\"7\"`. On a right-to-left page, Left moves on. |\n| Home, End | Moves to the first or the last cell. |\n| Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |\n| Enter, Space | Presses the cell, which sends `helix-reading-press`, and selects it or lets it go under `selection-mode`. |\n| Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode=\"multiple\"`. |\n| Escape | Puts the cell's tooltip away. |",
           "name": "HelixHeadlessHeatmap",
           "cssProperties": [
             {
@@ -78767,7 +79244,7 @@
               "name": "cell-selected"
             },
             {
-              "description": "Shown when the table has no readings. It stays hidden until the table can be read: on the server and during hydration, there is no document to resolve `for` in.",
+              "description": "The words under the strip when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration, there being no document to resolve `for` in.",
               "name": "empty"
             },
             {
@@ -78782,6 +79259,10 @@
               "description": "The readout: a polite live region that says the cell the keys moved to. Hide it visually.",
               "name": "live"
             },
+            {
+              "description": "The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.",
+              "name": "loading"
+            },
             {
               "description": "The invisible point the tooltip is anchored to.",
               "name": "mark"
@@ -78790,6 +79271,14 @@
               "description": "The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.",
               "name": "overview"
             },
+            {
+              "description": "The same element as `strip`, under the name every chart gives the drawing that takes focus.",
+              "name": "plot"
+            },
+            {
+              "description": "A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.",
+              "name": "row"
+            },
             {
               "description": "A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.",
               "name": "selection"
@@ -78876,10 +79365,18 @@
             }
           ],
           "slots": [
+            {
+              "description": "Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.",
+              "name": "empty"
+            },
             {
               "description": "Below the strip, at the trailing edge: usually the newest date.",
               "name": "end"
             },
+            {
+              "description": "Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.",
+              "name": "loading"
+            },
             {
               "description": "Below the strip, at the leading edge: usually the oldest date.",
               "name": "start"
@@ -78917,19 +79414,6 @@
                 "words": true
               }
             },
-            {
-              "kind": "field",
-              "name": "emptyText",
-              "type": {
-                "text": "string"
-              },
-              "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
-              "attribute": "empty-text",
-              "helix": {
-                "words": true
-              }
-            },
             {
               "kind": "field",
               "name": "gap",
@@ -78980,7 +79464,7 @@
                 "text": "string"
               },
               "default": "'selected'",
-              "description": "What the readout adds for a selected cell, under `selection-mode`, after\nwhere the cell stands: \"Day 1: 0 (1 of 14, selected)\". Empty adds\nnothing.",
+              "description": "What the readout added for a selected cell, under `selection-mode`.",
               "attribute": "selected-label",
               "helix": {
                 "words": true
@@ -79218,16 +79702,6 @@
               "description": "Every row in the table, oldest first, as the table is written, with its\nreading where the row has one.\n\n**Not `readings`, which the mixin already has and which means a count.**\nTwo members of the same name meaning a number and an array is the kind of\ncollision that type-checks in one direction and reads wrong in both.\n\n**One cell per row, and a blank row is a cell with no reading.** Taken from\nthe series alone, a blank dropped its day and every day after it moved one\ncell along, while the tooltip still counted rows and named the day beside\nthe one under the pointer.",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "sourceKnown",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a tree that can answer about\nids rather than of one that holds children. An id that resolves to nothing\nin a browser is still known, and still empty: a `for` naming no table\nshould say so rather than sit blank, which is why this asks\n`searchableById` and not `elementById`.\n\n`readingsKnown` asks it for every chart, and for `data` too, which a\nserver does not draw.",
-              "readonly": true
-            },
             {
               "kind": "field",
               "name": "rowCount",
@@ -79342,52 +79816,95 @@
             },
             {
               "kind": "method",
-              "name": "renderOverview",
-              "privacy": "protected",
+              "name": "renderRows",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult"
+                  "text": "TemplateResult[]"
                 }
               },
               "parameters": [
                 {
                   "name": "cells",
                   "type": {
-                    "text": "Reading[]"
+                    "text": "TemplateResult[]"
                   }
                 }
               ],
-              "description": "What the strip shows, in a sentence: the busiest reading drawn, as the\ntable writes it, and the total of them all, in `locale`. The strip is\ndescribed by it, so a reader landing on the strip hears what it holds\nbefore walking it."
+              "description": "The cells as a grid's rows, one for each column of the strip, so a week\nis a row with `rows=\"7\"` and a status strip is one row.\n\n**A column, because that is the order the cells are in.** The strip fills\ndown the column and then across, so a row wrapping a column keeps every\ncell where it was, and `display: contents` keeps the wrapper out of the\nstrip's grid, drawing no box, which is a mechanism and not a look. A row\nacross the strip would have taken cells out of order and moved them."
             },
             {
               "kind": "method",
-              "name": "renderTooltip",
-              "privacy": "protected",
+              "name": "renderGridCell",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult | typeof nothing"
+                  "text": "TemplateResult"
                 }
               },
-              "description": "The bubble over the cell a pointer is resting on.\n\n**One tooltip that moves, which is what every other chart here does.** Bar\nChart, Line Chart and Donut Chart each render a single anchor against an\ninvisible mark and move the mark, so the count is one however many readings\nthere are, rather than one element per cell. `drawTooltip` is their shared\nmarkup and this is the fourth caller.\n\nWhat it buys over a native `title` is the row rather than the reading.\n`sourceRows` carries every column of the table including the ones nothing\nwas plotted from, so a cell reads \"11 Jun 2026 / Uptime 81.2% / Note Partial\noutage\" where `title` could only ever say the two values this component\nhappens to hold. It is also styleable, appears at once rather than after the\nplatform's second of delay, and cannot be truncated by the window edge.\n\nThe mark is placed in pixels rather than in percent, which is the one thing\nthis does differently from its siblings: they divide a plot into equal\nslots, and a strip's cells are a fixed size with a fixed gap inside a box\nthat is usually wider, so a percentage of the box lands between cells. The\npitch is `cell + gap` and both are measured."
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "active",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "picked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "tone",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "One cell under `selection-mode`: a `gridcell` named by its row in the\ntable, its reading and its place, and saying whether it is selected, which\na reader hears on reaching it as the strip's active descendant."
             },
             {
               "kind": "method",
-              "name": "reading",
-              "privacy": "private",
+              "name": "renderOverview",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "ReadingCursor"
+                  "text": "TemplateResult"
                 }
               },
               "parameters": [
                 {
-                  "name": "at",
+                  "name": "cells",
                   "type": {
-                    "text": "number"
+                    "text": "Reading[]"
                   }
                 }
               ],
-              "description": "The readout's cursor: the pointer, with the selected word after where a\nselected cell stands, so a reader moving through the strip hears which\ncells are in the selection and not only how many."
+              "description": "What the strip shows, in a sentence: the busiest reading drawn, as the\ntable writes it, and the total of them all, in `locale`. The strip is\ndescribed by it, so a reader landing on the strip hears what it holds\nbefore walking it."
+            },
+            {
+              "kind": "method",
+              "name": "renderTooltip",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "grid",
+                  "default": "false"
+                }
+              ],
+              "description": "The bubble over the cell a pointer is resting on.\n\n**One tooltip that moves, which is what every other chart here does.** Bar\nChart, Line Chart and Donut Chart each render a single anchor against an\ninvisible mark and move the mark, so the count is one however many readings\nthere are, rather than one element per cell. `drawTooltip` is their shared\nmarkup and this is the fourth caller.\n\nWhat it buys over a native `title` is the row rather than the reading.\n`sourceRows` carries every column of the table including the ones nothing\nwas plotted from, so a cell reads \"11 Jun 2026 / Uptime 81.2% / Note Partial\noutage\" where `title` could only ever say the two values this component\nhappens to hold. It is also styleable, appears at once rather than after the\nplatform's second of delay, and cannot be truncated by the window edge.\n\nThe mark is placed in pixels rather than in percent, which is the one thing\nthis does differently from its siblings: they divide a plot into equal\nslots, and a strip's cells are a fixed size with a fixed gap inside a box\nthat is usually wider, so a percentage of the box lands between cells. The\npitch is `cell + gap` and both are measured."
             },
             {
               "kind": "field",
@@ -79396,12 +79913,97 @@
               "readonly": true,
               "description": "Which drawn cell the pointer is over, or -1.\n\n`pointerover` on the strip rather than a listener per cell: the event\nbubbles, so one handler covers however many cells there are, and unlike\n`mouseover` it is delivered for a pen."
             },
+            {
+              "kind": "field",
+              "name": "onPointerUp",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "onPointerLeave",
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "emptyText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No readings'",
+              "description": "The words shown in place of the drawing when the table has no readings,\nand the fallback of the `empty` slot.",
+              "attribute": "empty-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the readings are still on their way. The chart shows\n`loading-text` in place of an empty drawing until it has readings.\n\nReflected, so a stylesheet can treat the chart while it waits. A chart\nthat already has readings keeps drawing them, so a refresh does not\nblank it.",
+              "attribute": "loading",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loadingText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading readings'",
+              "description": "The words shown in place of the drawing while `loading` is set and\nthere are no readings yet, and the fallback of the `loading` slot.",
+              "attribute": "loading-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderStatus",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "What stands in the plot while there is nothing to draw: the `loading`\nline, the `empty` line, or nothing while the table cannot be read yet.\n\n`dir=\"auto\"`, so words in a right-to-left script read their own way in\na plot that holds itself left to right, as Scatter Chart's does.",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderEmpty",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The plot while there is nothing to draw: a group named as the chart is,\nholding `renderStatus`. Not focusable, there being no reading to walk.",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "source",
@@ -79997,6 +80599,22 @@
               "name": "helix-before-change",
               "reactProp": "onhelix-before-change"
             },
+            {
+              "type": {
+                "text": "HelixReadingChangeEvent"
+              },
+              "description": "The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it.",
+              "name": "helix-reading-change",
+              "reactProp": "onhelix-reading-change"
+            },
+            {
+              "type": {
+                "text": "HelixReadingPressEvent"
+              },
+              "description": "A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.",
+              "name": "helix-reading-press",
+              "reactProp": "onhelix-reading-press"
+            },
             {
               "type": {
                 "text": "HelixResizeEvent"
@@ -80016,15 +80634,6 @@
               "description": "The name the `overview` gives the busiest reading, `{busiestLabel}` in\n`overview-label`.",
               "fieldName": "busiestLabel"
             },
-            {
-              "name": "empty-text",
-              "type": {
-                "text": "string"
-              },
-              "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
-              "fieldName": "emptyText"
-            },
             {
               "name": "gap",
               "type": {
@@ -80067,7 +80676,7 @@
                 "text": "string"
               },
               "default": "'selected'",
-              "description": "What the readout adds for a selected cell, under `selection-mode`, after\nwhere the cell stands: \"Day 1: 0 (1 of 14, selected)\". Empty adds\nnothing.",
+              "description": "What the readout added for a selected cell, under `selection-mode`.",
               "fieldName": "selectedLabel"
             },
             {
@@ -80132,6 +80741,45 @@
               "description": "The selected cells, separated by commas: each by the date its row's\nheader carries in a `<time datetime>`, such as `2026-06-11`, or by the\nheader's words where it carries none.\n\nSet it to start with cells selected. Written by a press or a key under\n`selection-mode`.",
               "fieldName": "value"
             },
+            {
+              "name": "empty-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No readings'",
+              "description": "The words shown in place of the drawing when the table has no readings,\nand the fallback of the `empty` slot.",
+              "fieldName": "emptyText",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the readings are still on their way. The chart shows\n`loading-text` in place of an empty drawing until it has readings.\n\nReflected, so a stylesheet can treat the chart while it waits. A chart\nthat already has readings keeps drawing them, so a refresh does not\nblank it.",
+              "fieldName": "loading",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
+            {
+              "name": "loading-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading readings'",
+              "description": "The words shown in place of the drawing while `loading` is set and\nthere are no readings yet, and the fallback of the `loading` slot.",
+              "fieldName": "loadingText",
+              "inheritedFrom": {
+                "name": "MixinChartStatus",
+                "module": "src/mixins/mixin-chart-status/mixin-chart-status.ts"
+              }
+            },
             {
               "name": "for",
               "type": {
@@ -80194,6 +80842,10 @@
               "description": "While the `empty` part stands in place of the cells.",
               "name": "empty"
             },
+            {
+              "description": "While the `loading` part stands in place of the cells.",
+              "name": "loading"
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -80204,6 +80856,10 @@
             }
           ],
           "mixins": [
+            {
+              "name": "MixinChartStatus",
+              "package": "@fusion.dev/helix-core"
+            },
             {
               "name": "MixinChartSource",
               "package": "@fusion.dev/helix-core"
@@ -80633,6 +81289,23 @@
                 "module": "src/button/root/button-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the button, as `click()` presses a native one: the command is sent,\nthe form submits or resets, and `helix-press` says `virtual`.\n\n**Passed to the inner control, because a click on the host reaches nothing\nthat acts.** The control in the shadow root is what answers a click, so\n`click()` from a script, an automation or a test, dispatched on the host,\nsubmitted nothing and sent no `helix-press`. The control's own click reaches\nthe host's listeners once, retargeted, as one from a native button does. A\ndisabled button does nothing, and a pending one refuses the press.",
+              "type": {
+                "text": "click() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessButton",
+                "module": "src/button/root/button-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "act",
@@ -110367,6 +111040,19 @@
               "description": "Whether the row says what it is from its host, for a field's `aria-activedescendant`.",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the row, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the row, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -116040,6 +116726,23 @@
               "description": "Whether the notification starts as read, used until `read` is set.",
               "attribute": "default-read"
             },
+            {
+              "kind": "field",
+              "name": "dismissLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dismiss {label}'",
+              "description": "The dismiss control's name, read by screen readers, with `{label}` for the\nrow's own words.\n\nOne sentence with the words in it, so a translation puts them where its\nlanguage does: `registerWords('de', { 'helix-notification': { dismissLabel:\n'{label} schließen' } })`.",
+              "attribute": "dismiss-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "locale",
@@ -116059,19 +116762,6 @@
               "description": "Whether the notification has been read.\n\nSet it and this element defers: a reader's click fires `helix-read` and\nchanges nothing until a new value arrives. `default-read` seeds a state\nthis element then owns.\n\n**Not reflected.** Unread is a visual state, which is why the four mixins\nmirror theirs, but the mirror may not be the property's own attribute:\n`<helix-headless-notification default-read>` comes back from a server\nwithout `read` and would gain it on the first update, which React reports\nas a hydration mismatch, and which a copy of the serialized element\nre-parses as a declaration. `:state(read)` is what the stylesheet reads.\n`hydration.dom.spec.ts` holds it.",
               "attribute": "read"
             },
-            {
-              "kind": "field",
-              "name": "unreadLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Unread'",
-              "description": "What a screen reader hears before an unread notification's text.\n\nThe unread mark is drawn, so a reader who cannot see it hears this word in\nits place. Translate it with the rest of your interface.",
-              "attribute": "unread-label",
-              "helix": {
-                "words": true
-              }
-            },
             {
               "kind": "field",
               "name": "readState",
@@ -116144,6 +116834,29 @@
               },
               "description": "When it happened, delegated whole.\n\nThe tag is interpolated rather than written, so each tier renders its own:\nthe base tier may not name a styled element, and a styled item inherits this\ntemplate without having a tag of its own to remind anybody.\n\n`exportparts` and no `part` of its own, which is the rule about a part\nalready named for its role: the child publishes `time`, the role here is\n`time`, and naming both would leave `::part(time)` matching two elements.\nWhat a consumer wants to reach is the `<time>`, so that is what the name\nreaches. Format Date's field parts go on under `time-`, as every composed\nchild's do, though an elapsed time draws no fields."
             },
+            {
+              "kind": "field",
+              "name": "unreadLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Unread'",
+              "description": "What a screen reader hears before an unread notification's text.\n\nThe unread mark is drawn, so a reader who cannot see it hears this word in\nits place. Translate it with the rest of your interface.",
+              "attribute": "unread-label",
+              "helix": {
+                "words": true
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dismissName",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "The dismiss control's name: `dismissLabel` with the row's words.\n\n**Named for its row**, because a feed of rows each with a control named\nDismiss is a list of buttons that says nothing about which notice each one\nends. The words are the default slot's, the ones `helix-dismiss` reports,\nso a row's actions are not read into it. A page's own `dismiss-label` with\nno `{label}` is followed by them, unless it holds them already, as `Tag`\nnames its remove button. Read from the children, so the verb alone on a\nserver, until the update after.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "handleActions",
@@ -116165,7 +116878,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "Where focus goes when this row leaves: the next row's first control, the\none before, then the first control left in the feed."
+              "description": "Where focus goes when this row leaves: the next row, the one before, then\nthe first control left in the feed.\n\n**The row itself, and not a control in it**, because the row is what a\nreader moves through the feed by, and every row takes focus. Sent to the\nnext dismiss control, focus passed over each row with no controls between,\nand to Load more where no row after had one. Focused, the row becomes the\nfeed's stop, as one reached with the arrows does."
             },
             {
               "kind": "field",
@@ -116182,23 +116895,6 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "dismissLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "The dismiss control's label, read by screen readers.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.\n\nA word property: register it for a locale under the host's key. A family\nthat names the control otherwise, such as Tag's `Remove {label}`,\ndeclares its own English with `@words` above the override.",
-              "attribute": "dismiss-label",
-              "helix": {
-                "words": true
-              },
-              "inheritedFrom": {
-                "name": "MixinDismissible",
-                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "dismissEvent",
@@ -116739,6 +117435,19 @@
               "description": "Whether the notification starts as read, used until `read` is set.",
               "fieldName": "defaultRead"
             },
+            {
+              "name": "dismiss-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dismiss {label}'",
+              "description": "The dismiss control's name, read by screen readers, with `{label}` for the\nrow's own words.\n\nOne sentence with the words in it, so a translation puts them where its\nlanguage does: `registerWords('de', { 'helix-notification': { dismissLabel:\n'{label} schließen' } })`.",
+              "fieldName": "dismissLabel",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "name": "locale",
               "type": {
@@ -116777,19 +117486,6 @@
                 "name": "MixinDismissible",
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
-            },
-            {
-              "name": "dismiss-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "The dismiss control's label, read by screen readers.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.\n\nA word property: register it for a locale under the host's key. A family\nthat names the control otherwise, such as Tag's `Remove {label}`,\ndeclares its own English with `@words` above the override.",
-              "fieldName": "dismissLabel",
-              "inheritedFrom": {
-                "name": "MixinDismissible",
-                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
-              }
             }
           ],
           "cssStates": [
@@ -149947,6 +150643,19 @@
                 "text": "focusItem() => void"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the action, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nchooses the action and follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -164681,6 +165390,19 @@
               "readonly": true,
               "description": "Chooses the tab before the browser follows its link, and keeps the browser\nfrom following where the choice was refused. A press with a modifier, or\nwith a button other than the main one, opens the link where the browser\nopens it and chooses nothing here."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the tab, as `click()` presses a native button: passed to the\ncontrol inside, which is what answers a click, so a script's `click()`\nselects the tab, or follows its link, once.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "dismissible",
@@ -199002,6 +199724,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.177.2"
+    "version": "0.179.0"
   }
 }