@fusion.dev/helix 0.170.0 → 0.171.0

package/custom-elements.json

@@ -33154,7 +33154,7 @@
                   "text": "void"
                 }
               },
-              "description": "Makes the log a tab stop while it scrolls, and takes the stop away when it\ndoes not.\n\n**A reader on a keyboard scrolls the history from the log itself.**\nChromium and Firefox make a box that scrolls focusable on their own, and\nSafari does not, so there the arrow keys could not reach a long history.\nA log that fits is no stop at all, so Tab goes straight to the composer.",
+              "description": "Makes the log a tab stop while it holds a turn or scrolls, and takes the\nstop away from an empty log.\n\n**A reader on a keyboard scrolls the history from the log itself.**\nChromium and Firefox make a box that scrolls focusable on their own, and\nSafari does not, so there the arrow keys could not reach a long history.\n\n**And it is where the turns are entered.** Page Down from the log goes to\nthe turn at the top of the view. A log that fits was no stop at all, so a\nconversation whose turns held no control had no way into them by keyboard.",
               "inheritedFrom": {
                 "name": "HelixHeadlessChat",
                 "module": "src/chat/root/chat-root.ts"
@@ -33492,6 +33492,35 @@
                 "module": "src/chat/root/chat-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "warnedMixed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the chat has said it was given turns both ways.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "warnMixed",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Says once that turns arrived both as children and as `turns`.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "follow",
@@ -33591,6 +33620,29 @@
                 "module": "src/chat/root/chat-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "showTurn",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Draws turn `at` where it is windowed and not drawn, and visits it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "stop",
@@ -33627,6 +33679,42 @@
                 "module": "src/chat/root/chat-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "placed",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "Where this element last scrolled the transcript to show a turn, until the scroll that follows.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reveal",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "turn",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Scrolls the transcript, and nothing around it, until `turn` is in view,\nand notes the turn at the top as the reader's place. A pinned transcript\nis left at the bottom, which is where whoever holds the pin wants it.\n\nThe edge nearest the turn moves the least, and a turn taller than the\ntranscript is shown from its start.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "firstControlIn",
@@ -34461,6 +34549,38 @@
             }
           ],
           "cssStates": [
+            {
+              "description": "The conversation has no turns.",
+              "name": "empty",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "description": "Older turns are loading: `history` is `loading`.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "description": "The transcript follows its newest turn.",
+              "name": "pinned",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "description": "`typing` names someone on the other side.",
+              "name": "typing",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-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",
@@ -38842,6 +38962,20 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "addedLines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines to mark as inserted, as numbers and ranges counted from 1, such\nas `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff.",
+              "attribute": "added-lines",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "codeLabel",
@@ -39134,6 +39268,20 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "removedLines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines to mark as deleted, as numbers and ranges counted from 1. Drawn\nas `mark-lines` is, in the removed color. Not for a diff.",
+              "attribute": "removed-lines",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "showUnchangedLabel",
@@ -39673,6 +39821,10 @@
                 {
                   "name": "drawn",
                   "default": "name"
+                },
+                {
+                  "name": "own",
+                  "default": "false"
                 }
               ],
               "description": "The name with the copy button beside it, or nothing when there is no name.\n\n**The button is in the header wherever there is one**, because beside the\ncode it stands over the block and the block has to make room for it. A\ndiff cannot: its washes run to the edge, so the button stood on the hunk\nline and the line under it. In the header it is over nothing.\n\n**No name draws no header**, unless the page put a control in `actions`\nor asked for the wrap button. A bar holding the copy button alone turned a\n`Usage` section of one-line imports into a run of empty strips. The button\nthen stands beside the code, in room the block keeps for it.",
@@ -40356,6 +40508,22 @@
                 "name": "HelixHeadlessCodeBlock",
                 "module": "src/code-block/root/code-block-root.ts"
               }
+            },
+            {
+              "description": "An icon on the button that shows every line of a capped block, before its words.",
+              "name": "expand-icon",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "description": "The block's name in the header, such as a file icon beside the file name. Replaces `label` and `language` there, and draws the header.",
+              "name": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
             }
           ],
           "cssParts": [
@@ -40624,13 +40792,29 @@
               }
             },
             {
-              "description": "The band behind a run of lines `mark-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.",
+              "description": "The band behind a run of lines `mark-lines`, `added-lines` or `removed-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.",
               "name": "mark",
               "inheritedFrom": {
                 "name": "HelixHeadlessCodeBlock",
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "description": "The band behind a run of lines `added-lines` names. Applied with `mark`.",
+              "name": "mark-added",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "description": "The band behind a run of lines `removed-lines` names. Applied with `mark`.",
+              "name": "mark-removed",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "description": "In a diff, the `+`, `-`, or space that starts a line.",
               "name": "marker",
@@ -40697,6 +40881,19 @@
             }
           ],
           "attributes": [
+            {
+              "name": "added-lines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines to mark as inserted, as numbers and ranges counted from 1, such\nas `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff.",
+              "fieldName": "addedLines",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "name": "code-label",
               "type": {
@@ -40929,6 +41126,19 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "name": "removed-lines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines to mark as deleted, as numbers and ranges counted from 1. Drawn\nas `mark-lines` is, in the removed color. Not for a diff.",
+              "fieldName": "removedLines",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "name": "show-unchanged-label",
               "type": {
@@ -45021,7 +45231,7 @@
                   "text": "void"
                 }
               },
-              "description": "Returns the control to its `defaultValue`, or to its `value` attribute\nwhere there is no `default-value`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value.",
+              "description": "A reset ends any typing and takes back text that was not a color, so the\nfield shows the color the reset put back.",
               "inheritedFrom": {
                 "name": "HelixFormElement",
                 "module": "src/helix-form-element/helix-form-element.ts"
@@ -45595,7 +45805,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Requires a color before the form can submit.\n\n**A color is exactly as requirable as a date**, which is the comparison\nthat settles it: this element extends `HelixFormElement`, carries `name`\nand reports its value, so a consumer writing `<helix-headless-color-picker\nname=\"brand\" required>` inside a form has every reason to expect the form\nto refuse an empty one. Its two siblings in the same composition position,\nDate Picker and Time Picker, both check it.\n\nWritten out rather than taken from `MixinField`, for the reason those two\nrecord: the mixin brings a label, a hint and a feedback region, and this is\na panel composed *into* a field that already has all three, so taking it\nwould give one control two of each. What is left is the validity call and\nthe anchor the browser points its bubble at.\n\n**Text that is not a color is bad input**, so a form does not submit\n`#00` from a half-typed value. The picker draws no message of its own, so\nreporting it as each keystroke arrives shows nothing until the form asks;\nColor Input shows its own message against the field the reader typed\ninto.",
+              "description": "Requires a color before the form can submit.\n\n**A color is exactly as requirable as a date**, which is the comparison\nthat settles it: this element extends `HelixFormElement`, carries `name`\nand reports its value, so a consumer writing `<helix-headless-color-picker\nname=\"brand\" required>` inside a form has every reason to expect the form\nto refuse an empty one. Its two siblings in the same composition position,\nDate Picker and Time Picker, both check it.\n\nWritten out rather than taken from `MixinField`, for the reason those two\nrecord: the mixin brings a label, a hint and a feedback region, and this is\na panel composed *into* a field that already has all three, so taking it\nwould give one control two of each. What is left is the validity call and\nthe anchor the browser points its bubble at.\n\n**Text that is not a color is bad input**, so a form does not submit\n`#00` from a half-typed value. The picker marks it, and says\n`badInputMessage` under itself, once the reader leaves the value field or\npresses Enter, and a missing color once the reader has committed one or a\nform has refused the picker. Color Input shows its own message against the\nfield the reader typed into.",
               "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
@@ -45832,6 +46042,48 @@
                 "module": "src/color-picker/root/color-picker-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "typing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader is typing into the value field, between the first\nkeystroke and the `change` that ends it.\n\nHalf-typed text is rarely a color: `#00ff00` passes through `#0` and\n`#00ff0` on the way. So text that is not a color is refused once the\nreader leaves the field or presses Enter, and not on every keystroke.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorPicker",
+                "module": "src/color-picker/root/color-picker-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "draft",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "Text in the value field that is not a color, or undefined while the field\nholds the value.\n\n**Kept in the field and out of the value**, as a native number field keeps\n\"12e\": the text stays where the reader can correct it, the value stays the\nlast color, and the picker reports `badInput` until the text is a color or\nthe value moves. Measured before this: typed \"nonsense\" became the value,\nso a form read `brand=nonsense` and the square had no color to show.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorPicker",
+                "module": "src/color-picker/root/color-picker-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "said",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "The line under the picker: `feedback`, or, where the picker is marked by\nits own validation, what is wrong.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorPicker",
+                "module": "src/color-picker/root/color-picker-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "dragging",
@@ -47634,7 +47886,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Requires a color before the form can submit.\n\n**A color is exactly as requirable as a date**, which is the comparison\nthat settles it: this element extends `HelixFormElement`, carries `name`\nand reports its value, so a consumer writing `<helix-headless-color-picker\nname=\"brand\" required>` inside a form has every reason to expect the form\nto refuse an empty one. Its two siblings in the same composition position,\nDate Picker and Time Picker, both check it.\n\nWritten out rather than taken from `MixinField`, for the reason those two\nrecord: the mixin brings a label, a hint and a feedback region, and this is\na panel composed *into* a field that already has all three, so taking it\nwould give one control two of each. What is left is the validity call and\nthe anchor the browser points its bubble at.\n\n**Text that is not a color is bad input**, so a form does not submit\n`#00` from a half-typed value. The picker draws no message of its own, so\nreporting it as each keystroke arrives shows nothing until the form asks;\nColor Input shows its own message against the field the reader typed\ninto.",
+              "description": "Requires a color before the form can submit.\n\n**A color is exactly as requirable as a date**, which is the comparison\nthat settles it: this element extends `HelixFormElement`, carries `name`\nand reports its value, so a consumer writing `<helix-headless-color-picker\nname=\"brand\" required>` inside a form has every reason to expect the form\nto refuse an empty one. Its two siblings in the same composition position,\nDate Picker and Time Picker, both check it.\n\nWritten out rather than taken from `MixinField`, for the reason those two\nrecord: the mixin brings a label, a hint and a feedback region, and this is\na panel composed *into* a field that already has all three, so taking it\nwould give one control two of each. What is left is the validity call and\nthe anchor the browser points its bubble at.\n\n**Text that is not a color is bad input**, so a form does not submit\n`#00` from a half-typed value. The picker marks it, and says\n`badInputMessage` under itself, once the reader leaves the value field or\npresses Enter, and a missing color once the reader has committed one or a\nform has refused the picker. Color Input shows its own message against the\nfield the reader typed into.",
               "fieldName": "required",
               "inheritedFrom": {
                 "name": "HelixHeadlessColorPicker",
@@ -47963,7 +48215,7 @@
               }
             },
             {
-              "description": "The message under the picker, while `feedback` is set.",
+              "description": "The message under the picker: `feedback`, or what is wrong with the answer once the picker is marked invalid.",
               "name": "feedback",
               "inheritedFrom": {
                 "name": "HelixHeadlessColorPicker",
@@ -49526,7 +49778,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
+              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` is the chosen values joined with\ncommas, a press toggles rather than replaces, and the arrows move without\nchoosing. What this adds is the tags, and keeping the panel open between\npicks.\n\nAn option's value may hold a comma, and it is read as one value, as\n`Select` and `Listbox` read it. So may an answer the reader created.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
               "attribute": "multiple",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
@@ -49833,8 +50085,20 @@
                 "text": "string[]"
               },
               "privacy": "private",
-              "description": "The values chosen, in the order they were chosen.",
+              "description": "The values chosen, in the order they were chosen, read against the\noptions' values and the answers created here, so a value that holds a\ncomma is one value. See `chosenValues`.\n\nMeasured before this: choosing `Paris, France` drew two tags, \"Paris\" and\n\"France\", and the form received two entries.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessCombobox",
+                "module": "src/combobox/root/combobox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "created",
+              "privacy": "private",
               "readonly": true,
+              "default": "new Set<string>()",
+              "description": "The answers created here, which no option holds, kept so their commas read as theirs.",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
                 "module": "src/combobox/root/combobox-root.ts"
@@ -51662,7 +51926,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
+              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` is the chosen values joined with\ncommas, a press toggles rather than replaces, and the arrows move without\nchoosing. What this adds is the tags, and keeping the panel open between\npicks.\n\nAn option's value may hold a comma, and it is read as one value, as\n`Select` and `Listbox` read it. So may an answer the reader created.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
               "fieldName": "multiple",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
@@ -52595,6 +52859,19 @@
                 "module": "src/command/root/command-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "homeEnd",
+              "type": {
+                "text": "'list' | undefined"
+              },
+              "description": "Where Home and End go from the filter field.\n\nAbsent, they move the caret, as APG's combobox has them. `list` moves the\nhighlight to the first or the last command, as React Aria's Autocomplete\ndoes, and Shift with either still selects the text.",
+              "attribute": "home-end",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCommand",
+                "module": "src/command/root/command-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "hotkey",
@@ -52654,6 +52931,20 @@
                 "module": "src/command/root/command-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "layout",
+              "type": {
+                "text": "'grid' | 'stack' | undefined"
+              },
+              "description": "How the commands are laid out, as Listbox's `layout`: `grid` draws them in\nrows and columns, for a palette of icons or emoji, and the arrow keys\nfollow the rows and the columns. Absent is one command under another.",
+              "attribute": "layout",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessCommand",
+                "module": "src/command/root/command-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "loadError",
@@ -53473,6 +53764,18 @@
                 "module": "src/command/root/command-root.ts"
               }
             },
+            {
+              "name": "home-end",
+              "type": {
+                "text": "'list' | undefined"
+              },
+              "description": "Where Home and End go from the filter field.\n\nAbsent, they move the caret, as APG's combobox has them. `list` moves the\nhighlight to the first or the last command, as React Aria's Autocomplete\ndoes, and Shift with either still selects the text.",
+              "fieldName": "homeEnd",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCommand",
+                "module": "src/command/root/command-root.ts"
+              }
+            },
             {
               "name": "hotkey",
               "type": {
@@ -53512,6 +53815,18 @@
                 "module": "src/command/root/command-root.ts"
               }
             },
+            {
+              "name": "layout",
+              "type": {
+                "text": "'grid' | 'stack' | undefined"
+              },
+              "description": "How the commands are laid out, as Listbox's `layout`: `grid` draws them in\nrows and columns, for a palette of icons or emoji, and the arrow keys\nfollow the rows and the columns. Absent is one command under another.",
+              "fieldName": "layout",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCommand",
+                "module": "src/command/root/command-root.ts"
+              }
+            },
             {
               "name": "load-error",
               "type": {
@@ -83020,6 +83335,19 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "dismissTabStop",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the remove button is a tab stop of its own.\n\n`FilterInput` writes `false` on the chips in its `tags` slot: the field's\ntext is its one tab stop, and the arrow keys move from the text to the\nchips, as in a `multiple` Combobox. No attribute: it is coordination\nbetween elements, as `Tag.dismissTabStop` is.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterChip",
+                "module": "src/filter-input/chip/filter-chip.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "label",
@@ -85707,6 +86035,20 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "tier",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-'",
+              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "defaultOpen",
@@ -86654,6 +86996,20 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chips",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the field keeps a `FilterChip` for each filter in its `tags` slot,\nfrom the `helix-facet` events it hears.\n\nOff, you build the chips, which is what you do when your own model holds\nthe filters. On, a filter typed, picked, or changed adds or updates the\nchip for its field, one with no values takes it away (unless its\ncomparison takes none, such as \"is empty\"), and removing the chip clears\nthe filter. A `helix-facet` you cancel changes no chip.\n\nThe chips are elements the field adds to its own children, so leave this\noff where a framework renders those children and would remove them.",
+              "attribute": "chips",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "clearable",
@@ -86699,6 +87055,52 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the suggestions are still loading, such as while a request for the\nvalues of a typed key is out.\n\nThe panel opens on `loading-text`, or the `loading` slot, while the field\nhas focus, and a screen reader hears it. Slot the options and clear this\nwhen they arrive.",
+              "attribute": "loading",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loadingText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading'",
+              "description": "Text the panel shows while the suggestions load.",
+              "attribute": "loading-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "noResultsText",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Text the panel shows when `filter-suggestions` hides every suggestion, such\nas \"No matching filters\".\n\nEmpty, or no `no-results` slot, and the panel closes instead, as it does\nwhen it has nothing to offer.",
+              "attribute": "no-results-text",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "placeholder",
@@ -87174,6 +87576,40 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleFacet",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Keeps the chip for a filter in step with it, under `chips`.\n\nAfter every listener has had its turn, so a consumer's `preventDefault()`\non the same event, on this element or above it, is read: `dispatchEvent`\nruns them all before the microtask does.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "drawChip",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "facet",
+                  "type": {
+                    "text": "FacetDetail"
+                  }
+                }
+              ],
+              "description": "Adds, updates or removes the chip for one filter. See `chips`.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleDismiss",
@@ -87274,6 +87710,20 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "unmatched",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether `filter-suggestions` has hidden every suggestion there is, where a\n`no-results-text` or a `no-results` slot says so. The panel stays open on\nit, and `:state(no-results)` is on the host.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleSuggestions",
@@ -87323,7 +87773,7 @@
               "name": "handleTokens",
               "privacy": "private",
               "readonly": true,
-              "description": "The row again, whenever what is in it changes.",
+              "description": "The row again, whenever what is in it changes.\n\n**And the text is the field's one tab stop.** Each token's remove button\nwas a stop of its own, so Tab through a field with five filters took six\npresses. A `Tag` or `FilterChip` takes `dismissTabStop` for this, as the\ntags of a `multiple` Combobox do, and the arrow keys still reach every one.\nA token not yet defined is told once it is.",
               "inheritedFrom": {
                 "name": "HelixHeadlessFilterInput",
                 "module": "src/filter-input/root/filter-input-root.ts"
@@ -87864,20 +88314,6 @@
                 "module": "src/helix-form-element/helix-form-element.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "tier",
-              "type": {
-                "text": "string"
-              },
-              "static": true,
-              "default": "'helix-headless-'",
-              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
-              "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "tag",
@@ -88455,6 +88891,19 @@
                 "module": "src/mixins/mixin-field/mixin-field.ts"
               }
             },
+            {
+              "name": "chips",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the field keeps a `FilterChip` for each filter in its `tags` slot,\nfrom the `helix-facet` events it hears.\n\nOff, you build the chips, which is what you do when your own model holds\nthe filters. On, a filter typed, picked, or changed adds or updates the\nchip for its field, one with no values takes it away (unless its\ncomparison takes none, such as \"is empty\"), and removing the chip clears\nthe filter. A `helix-facet` you cancel changes no chip.\n\nThe chips are elements the field adds to its own children, so leave this\noff where a framework renders those children and would remove them.",
+              "fieldName": "chips",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "name": "clearable",
               "type": {
@@ -88494,6 +88943,45 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the suggestions are still loading, such as while a request for the\nvalues of a typed key is out.\n\nThe panel opens on `loading-text`, or the `loading` slot, while the field\nhas focus, and a screen reader hears it. Slot the options and clear this\nwhen they arrive.",
+              "fieldName": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "name": "loading-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Loading'",
+              "description": "Text the panel shows while the suggestions load.",
+              "fieldName": "loadingText",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "name": "no-results-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Text the panel shows when `filter-suggestions` hides every suggestion, such\nas \"No matching filters\".\n\nEmpty, or no `no-results` slot, and the panel closes instead, as it does\nwhen it has nothing to offer.",
+              "fieldName": "noResultsText",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "name": "placeholder",
               "type": {
@@ -88710,6 +89198,22 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "What the panel shows while `loading` is set, for content richer than `loading-text`.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "description": "What the panel shows when `filter-suggestions` hides every suggestion, for content richer than `no-results-text`.",
+              "name": "no-results",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "Content before the text, such as a search icon.",
               "name": "start",
@@ -88752,6 +89256,14 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "Shown in the panel when `filter-suggestions` hides every suggestion.",
+              "name": "empty",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "The error message under the field.",
               "name": "feedback",
@@ -88800,6 +89312,14 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "Shown in the panel while the suggestions load.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "The count of tokens that did not fit. It is a `<button>` with `expandable` and a `<span>` without it.",
               "name": "rest",
@@ -88834,6 +89354,22 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "While `loading` is set.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "description": "`filter-suggestions` hid every suggestion, and `no-results-text` or the `no-results` slot says so.",
+              "name": "no-results",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "The suggestions are open.",
               "name": "open",
@@ -102982,6 +103518,52 @@
                 "module": "src/input/root/input-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "setRangeText",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "replacement",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "start",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "end",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "selectMode",
+                  "optional": true,
+                  "type": {
+                    "text": "SelectionMode"
+                  }
+                }
+              ],
+              "description": "Replaces a range of the text, as the native method does: the selection\nwhere `start` and `end` are left out, and `selectMode` says what is\nselected after. It sends no event, as the native method sends none.",
+              "type": {
+                "text": "setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessInput",
+                "module": "src/input/root/input-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setSelectionRange",
@@ -142920,7 +143502,7 @@
                 "text": "string"
               },
               "default": "'Decrease'",
-              "description": "The name of the step down button, read by screen readers.",
+              "description": "The name of the step down button, read by screen readers. The field's\nlabel follows it, so a reader hears \"Decrease Quantity\", as React Aria\nnames its steppers.",
               "attribute": "decrement-label",
               "helix": {
                 "words": true
@@ -142950,7 +143532,7 @@
                 "text": "string"
               },
               "default": "'Increase'",
-              "description": "The name of the step up button, read by screen readers.",
+              "description": "The name of the step up button, read by screen readers. The field's\nlabel follows it, so a reader hears \"Increase Quantity\", as React Aria\nnames its steppers.",
               "attribute": "increment-label",
               "helix": {
                 "words": true
@@ -143458,13 +144040,16 @@
               },
               "parameters": [
                 {
-                  "name": "large",
-                  "default": "false"
+                  "name": "count",
+                  "default": "1",
+                  "type": {
+                    "text": "number | boolean"
+                  }
                 }
               ],
-              "description": "Steps the value up, by `largeStep` steps when `large` is set.",
+              "description": "Steps the value up by `step`, `count` times, as the native method and\n`Input.stepUp` do. `true` takes `largeStep` steps, as `PageUp` does.",
               "type": {
-                "text": "stepUp(large = false) => void"
+                "text": "stepUp(count: number | boolean = 1) => void"
               },
               "inheritedFrom": {
                 "name": "HelixHeadlessNumberInput",
@@ -143481,14 +144066,40 @@
               },
               "parameters": [
                 {
-                  "name": "large",
-                  "default": "false"
+                  "name": "count",
+                  "default": "1",
+                  "type": {
+                    "text": "number | boolean"
+                  }
                 }
               ],
-              "description": "Steps the value down, by `largeStep` steps when `large` is set.\n\nThe same path a press of the down arrow takes, so a consumer driving this\nfrom their own control gets the clamping and the announcement rather than\nhaving to repeat both.",
+              "description": "Steps the value down by `step`, `count` times. `true` takes `largeStep`\nsteps, as `PageDown` does.\n\nThe same path a press of the down arrow takes, so a consumer driving this\nfrom their own control gets the clamping and the announcement rather than\nhaving to repeat both.",
               "type": {
-                "text": "stepDown(large = false) => void"
+                "text": "stepDown(count: number | boolean = 1) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessNumberInput",
+                "module": "src/number-input/root/number-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "stepsOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
               },
+              "parameters": [
+                {
+                  "name": "count",
+                  "type": {
+                    "text": "number | boolean"
+                  }
+                }
+              ],
+              "description": "How many steps a `stepUp` argument asks for: a count, or `largeStep` for `true`.",
               "inheritedFrom": {
                 "name": "HelixHeadlessNumberInput",
                 "module": "src/number-input/root/number-input-root.ts"
@@ -144856,7 +145467,7 @@
                 "text": "string"
               },
               "default": "'Decrease'",
-              "description": "The name of the step down button, read by screen readers.",
+              "description": "The name of the step down button, read by screen readers. The field's\nlabel follows it, so a reader hears \"Decrease Quantity\", as React Aria\nnames its steppers.",
               "fieldName": "decrementLabel",
               "inheritedFrom": {
                 "name": "HelixHeadlessNumberInput",
@@ -144881,7 +145492,7 @@
                 "text": "string"
               },
               "default": "'Increase'",
-              "description": "The name of the step up button, read by screen readers.",
+              "description": "The name of the step up button, read by screen readers. The field's\nlabel follows it, so a reader hears \"Increase Quantity\", as React Aria\nnames its steppers.",
               "fieldName": "incrementLabel",
               "inheritedFrom": {
                 "name": "HelixHeadlessNumberInput",
@@ -167668,7 +168279,17 @@
             "type": {
               "text": "string"
             }
-          }
+          },
+          "parameters": [
+            {
+              "name": "imports",
+              "optional": true,
+              "type": {
+                "text": "Readonly<Record<string, string>>"
+              }
+            }
+          ],
+          "description": "The built-in document, with an import map for `imports` where there are any.\n\n**The map comes first in the head**, because a browser reads an import map\nonly before the first module it loads, and the example's scripts are\nmodules. `</` is escaped in the map as in the script, so a URL cannot close\nthe element early."
         }
       ],
       "exports": [
@@ -167932,7 +168553,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A sandboxed `<iframe>` that loads `src`, a document you provide. That\ndocument imports what the examples need, listens for a render message, and\nwrites the markup into itself.\n\n**Without `src`, the frame loads a built-in document**, so a sandbox renders\nwith nothing to host. It runs HTML, CSS, and scripts, and reports the\nconsole, uncaught errors, its height, and presses as a frame on\n`servePreview` does. It defines no element, so an example that uses Helix\ncomponents needs a `src` that imports them.\n\n**Examples render in a frame**, so an example's styles and scripts do not\naffect the page around the sandbox, and `position: fixed` stays inside the\npane. The frame starts empty, with its own stylesheets and its own custom\nelement registry, so `src` must load the styles and components the examples\nuse.\n\n**The source is untrusted, and the frame keeps it isolated.** The frame uses\n`sandbox=\"allow-scripts\"` and never `allow-same-origin`. Together, the two\nlet a document on the same origin remove its own sandbox, which is the same\nas having none.\n\n**A preview says where it is.** It is `:state(loading)` from the moment it\nhas a `src` until that document can take the example, and again through\n`reload()`. It is `:state(failed)` once the example throws an error it does\nnot catch, until the next source is sent, which a frame on `servePreview`\nreports. A page draws its own spinner or message from either, such as a\nsibling shown by `helix-sandbox-preview:state(failed) + .message`.\n\n**A failed preview shows the error over the example**, in the `error` part,\nuntil the next source is sent. The terminal says it too, so the part is not\nannounced. Hide it with `::part(error) { display: none }` where the page\ndraws its own.\n\n**`controls` draws two buttons in the preview's corner**: one reloads the\nframe's document, as `reload()` does, and one opens the example in a new\ntab, as `open()` does. The tab runs it in a frame sandboxed as this one is.",
+          "description": "A sandboxed `<iframe>` that loads `src`, a document you provide. That\ndocument imports what the examples need, listens for a render message, and\nwrites the markup into itself.\n\n**Without `src`, the frame loads a built-in document**, so a sandbox renders\nwith nothing to host. It runs HTML, CSS, and scripts, and reports the\nconsole, uncaught errors, its height, and presses as a frame on\n`servePreview` does. It defines no element, so an example that uses Helix\ncomponents needs a `src` that imports them.\n\n**`imports` lets an example import packages by name** in the built-in\ndocument, as an import map: each name maps to the address of an ES module,\nsuch as `{\"canvas-confetti\": \"https://esm.sh/canvas-confetti@1.9.3\"}`, and\n`import confetti from 'canvas-confetti'` in the `js` pane then loads it. A\nCDN that serves npm packages as modules, such as esm.sh or jsDelivr's\n`+esm`, gives every package an address. A new map loads the document again,\nsince a browser reads one only as a document starts. A `src` document\ndeclares its own.\n\n**Examples render in a frame**, so an example's styles and scripts do not\naffect the page around the sandbox, and `position: fixed` stays inside the\npane. The frame starts empty, with its own stylesheets and its own custom\nelement registry, so `src` must load the styles and components the examples\nuse.\n\n**The source is untrusted, and the frame keeps it isolated.** The frame uses\n`sandbox=\"allow-scripts\"` and never `allow-same-origin`. Together, the two\nlet a document on the same origin remove its own sandbox, which is the same\nas having none.\n\n**A preview says where it is.** It is `:state(loading)` from the moment it\nhas a `src` until that document can take the example, and again through\n`reload()`. It is `:state(failed)` once the example throws an error it does\nnot catch, until the next source is sent, which a frame on `servePreview`\nreports. A page draws its own spinner or message from either, such as a\nsibling shown by `helix-sandbox-preview:state(failed) + .message`.\n\n**A failed preview shows the error over the example**, in the `error` part,\nuntil the next source is sent. The terminal says it too, so the part is not\nannounced. Hide it with `::part(error) { display: none }` where the page\ndraws its own.\n\n**`controls` draws two buttons in the preview's corner**: one reloads the\nframe's document, as `reload()` does, and one opens the example in a new\ntab, as `open()` does. The tab runs it in a frame sandboxed as this one is.",
           "name": "HelixSandboxPreview",
           "cssParts": [
             {
@@ -167996,6 +168617,15 @@
               "description": "Writing direction inside the frame.\n\nNot reflected. It is payload for the render message and nothing selects on\nit, here or anywhere: a frame is a document of its own and what is written\non this host reaches nothing inside it, which is the same reason\n`colorMode` has to be sent rather than set.",
               "attribute": "direction"
             },
+            {
+              "kind": "field",
+              "name": "imports",
+              "type": {
+                "text": "Record<string, string> | undefined"
+              },
+              "description": "The packages an example can import by name in the built-in document,\neach mapped to the address of an ES module, as an import map's `imports`.\nSet it as JSON in the attribute or as an object. Not read where `src` is\nset.",
+              "attribute": "imports"
+            },
             {
               "kind": "field",
               "name": "label",
@@ -168648,6 +169278,14 @@
               "description": "Writing direction inside the frame.\n\nNot reflected. It is payload for the render message and nothing selects on\nit, here or anywhere: a frame is a document of its own and what is written\non this host reaches nothing inside it, which is the same reason\n`colorMode` has to be sent rather than set.",
               "fieldName": "direction"
             },
+            {
+              "name": "imports",
+              "type": {
+                "text": "Record<string, string> | undefined"
+              },
+              "description": "The packages an example can import by name in the built-in document,\neach mapped to the address of an ES module, as an import map's `imports`.\nSet it as JSON in the attribute or as an object. Not read where `src` is\nset.",
+              "fieldName": "imports"
+            },
             {
               "name": "label",
               "type": {
@@ -170228,7 +170866,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A real `<textarea>`, so undo, selection, spellcheck suppression, mobile\nkeyboards, and screen reader support come from the platform.\n\nTab inserts two spaces, so you can indent code. To move focus out of the\nfield, press Escape and then Tab. Shift+Tab moves focus back as it does\nanywhere else. The field's description says so to a screen reader.\n\n**`tokenize` colors the source** with a highlighter you bring, such as one\nbuilt on Lezer, Prism or Shiki. It is a function from the source to runs of\ntext, each with an optional kind, and the pane draws the runs under a\ntransparent field, so typing, selection and undo stay the textarea's. The\nkinds are `callable`, `comment`, `constant`, `invalid`, `keyword`, `name`,\n`string` and `tag`, each colored by the `--helix-color-syntax-*` token of\nits name and a hook of its own, such as `--sandbox-source-keyword-color`.\nA run of any other kind is drawn in the field's own color. Every run with a\nkind is a `token` part, and carries its kind as `data-kind`. A `tokenize`\nthat throws leaves the source drawn plain and the field editable, and the\nerror is reported to the page as an uncaught one.",
+          "description": "A real `<textarea>`, so undo, selection, spellcheck suppression, mobile\nkeyboards, and screen reader support come from the platform.\n\nTab inserts two spaces, so you can indent code. To move focus out of the\nfield, press Escape and then Tab. Shift+Tab moves focus back as it does\nanywhere else. The field's description says so to a screen reader.\n\n**`tokenize` colors the source** with a highlighter you bring, such as one\nbuilt on Lezer, Prism or Shiki. It is a function from the source to runs of\ntext, each with an optional kind, and the pane draws the runs under a\ntransparent field, so typing, selection and undo stay the textarea's. The\nkinds are `callable`, `comment`, `constant`, `invalid`, `keyword`, `name`,\n`string` and `tag`, each colored by the `--helix-color-syntax-*` token of\nits name and a hook of its own, such as `--sandbox-source-keyword-color`.\nA run of any other kind is drawn in the field's own color. Every run with a\nkind is a `token` part, and carries its kind as `data-kind`. A `tokenize`\nthat throws leaves the source drawn plain and the field editable, and the\nerror is reported to the page as an uncaught one.\n\n**`line-numbers` numbers each line** in a gutter beside the source. A line\nthat wraps keeps one number. The numbers are drawn, and hidden from screen\nreaders, which read the field.\n\nEnter keeps the indentation of the line it breaks, and the new line is\nundone with the next undo as typing is.\n\n**The source can be written inside the pane** where `value` is not set: its\ntext, or the markup of a `<template>` it holds, without the indentation the\npage gave it. Markup goes in a template so the page does not render it or\nrun its scripts. Text inside the pane is read once, when it connects.",
           "name": "HelixSandboxSource",
           "cssProperties": [
             {
@@ -170255,6 +170893,10 @@
               "description": "Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`.",
               "name": "--sandbox-source-keyword-color"
             },
+            {
+              "description": "Color of the line numbers, under `line-numbers`. Defaults to `--helix-color-foreground-subtle`.",
+              "name": "--sandbox-source-line-number-color"
+            },
             {
               "description": "Minimum height of the pane.",
               "name": "--sandbox-source-min-block-size"
@@ -170274,13 +170916,17 @@
           ],
           "cssParts": [
             {
-              "description": "The box that scrolls the field and its colors together, under `tokenize`.",
+              "description": "The box that scrolls the field and its colors together, under `tokenize` or `line-numbers`.",
               "name": "field"
             },
             {
-              "description": "The colored copy of the source drawn under the field, under `tokenize`.",
+              "description": "The colored copy of the source drawn under the field, under `tokenize` or `line-numbers`.",
               "name": "highlight"
             },
+            {
+              "description": "One line of that copy, under `line-numbers`, numbered in the gutter by its `::before`.",
+              "name": "line"
+            },
             {
               "description": "The editable region.",
               "name": "source"
@@ -170350,6 +170996,17 @@
               "description": "The pane's file name, such as `index.html`, on its tab where a sandbox\nholds several panes. Empty puts the pane's `name` on the tab.",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "lineNumbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether each line of the source is numbered, in a gutter beside it.",
+              "attribute": "line-numbers",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "name",
@@ -170398,6 +171055,27 @@
               "default": "false",
               "description": "Set by Escape, so the next Tab leaves the field."
             },
+            {
+              "kind": "field",
+              "name": "read",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the source written inside the pane has been read."
+            },
+            {
+              "kind": "method",
+              "name": "readWritten",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Takes the source written inside the pane where `value` is not set: a\ntemplate's markup, or else the text. Client only, like every read of the\nlight DOM, and once there is something to read.\n\n**As it connects, and again before its first render.** A pane that\nupgrades after the parser is done holds its text as it connects, which is\nbefore a sandbox around it reads `value` to seed its preview. A parser that\nconnects the pane before its children, as one with the element already\ndefined does, leaves the text for the render."
+            },
             {
               "kind": "field",
               "name": "reportCaret",
@@ -170445,7 +171123,26 @@
             },
             {
               "kind": "method",
-              "name": "indent",
+              "name": "breakLine",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Breaks the line with the indentation it has, where it has some. A line at\nthe margin is left to the platform's own Enter."
+            },
+            {
+              "kind": "method",
+              "name": "insert",
               "privacy": "private",
               "return": {
                 "type": {
@@ -170458,9 +171155,15 @@
                   "type": {
                     "text": "HTMLTextAreaElement"
                   }
+                },
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ],
-              "description": "Writes the two spaces Tab inserts, as typing would.\n\n**Through `insertText`, so undo takes the indent back.** Assigning\n`field.value` empties the textarea's undo history: a reader who typed,\npressed Tab and then Cmd+Z or Ctrl+Z lost the indent and everything typed\nbefore it. `insertText` is the edit a keystroke makes, so it joins the\nhistory and sends the `input` event that `handleInput` takes. It writes\ninto whatever has focus, so it is used only while the field has it. Where it\nis not supported, the field is written directly."
+              "description": "Writes text at the caret, as typing would: the two spaces Tab inserts,\nand the indentation Enter keeps.\n\n**Through `insertText`, so undo takes the indent back.** Assigning\n`field.value` empties the textarea's undo history: a reader who typed,\npressed Tab and then Cmd+Z or Ctrl+Z lost the indent and everything typed\nbefore it. `insertText` is the edit a keystroke makes, so it joins the\nhistory and sends the `input` event that `handleInput` takes. It writes\ninto whatever has focus, so it is used only while the field has it. Where it\nis not supported, the field is written directly."
             },
             {
               "kind": "method",
@@ -170876,6 +171579,15 @@
               "description": "The pane's file name, such as `index.html`, on its tab where a sandbox\nholds several panes. Empty puts the pane's `name` on the tab.",
               "fieldName": "label"
             },
+            {
+              "name": "line-numbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether each line of the source is numbered, in a gutter beside it.",
+              "fieldName": "lineNumbers"
+            },
             {
               "name": "name",
               "type": {
@@ -190709,7 +191421,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the arrow keys move focus between the stages' names, along the\nway the steps run. Off by default, so the arrows keep scrolling the page.",
+              "description": "Whether the arrow keys move focus between the stages' names, along the\nway the steps run, and the names are one tab stop. Off by default, so the\narrows keep scrolling the page.",
               "attribute": "arrows",
               "inheritedFrom": {
                 "name": "HelixHeadlessSteps",
@@ -190843,6 +191555,17 @@
                 "module": "src/steps/root/steps-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "commands",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new CommandController(this, { commands: { '--next': () => this.next(), '--previous': () => this.previous(), '--reset': () => this.reset(), }, })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessSteps",
+                "module": "src/steps/root/steps-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "steps",
@@ -190871,6 +191594,29 @@
                 "module": "src/steps/root/steps-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "named",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessStep | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "steps",
+                  "type": {
+                    "text": "HelixHeadlessStep[]"
+                  }
+                }
+              ],
+              "description": "The step `active` names, by `value` or by place, or the first enabled one.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessSteps",
+                "module": "src/steps/root/steps-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "next",
@@ -191044,6 +191790,44 @@
                 "module": "src/steps/root/steps-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "holder",
+              "type": {
+                "text": "HelixHeadlessStep | undefined"
+              },
+              "privacy": "private",
+              "description": "The step whose name holds the sequence's one tab stop under `arrows`, once focus has chosen it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessSteps",
+                "module": "src/steps/root/steps-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "rove",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Gives the one tab stop to a name, under `arrows`: the one focus last left,\nelse the current stage's, else the first a reader can go to. Without\n`arrows` every name is its own stop. Client only.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessSteps",
+                "module": "src/steps/root/steps-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFocus",
+              "privacy": "private",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessSteps",
+                "module": "src/steps/root/steps-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleSlotChange",
@@ -191496,7 +192280,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the arrow keys move focus between the stages' names, along the\nway the steps run. Off by default, so the arrows keep scrolling the page.",
+              "description": "Whether the arrow keys move focus between the stages' names, along the\nway the steps run, and the names are one tab stop. Off by default, so the\narrows keep scrolling the page.",
               "fieldName": "arrows",
               "inheritedFrom": {
                 "name": "HelixHeadlessSteps",
@@ -191826,7 +192610,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The value the step sends in `helix-select`.",
+              "description": "The value the step sends in `helix-select`, and what names the step in its\nsequence's `active`. Without one, the sequence names the step by its place,\ncounted from 1.",
               "attribute": "value",
               "inheritedFrom": {
                 "name": "HelixHeadlessStep",
@@ -192504,7 +193288,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The value the step sends in `helix-select`.",
+              "description": "The value the step sends in `helix-select`, and what names the step in its\nsequence's `active`. Without one, the sequence names the step by its place,\ncounted from 1.",
               "fieldName": "value",
               "inheritedFrom": {
                 "name": "HelixHeadlessStep",
@@ -238402,6 +239186,48 @@
                 "module": "src/video-playlist/root/video-playlist-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "wroteName",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The name this playlist last wrote on a plain media player, to tell it from yours.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessVideoPlaylist",
+                "module": "src/video-playlist/root/video-playlist-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "name",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "player",
+                  "type": {
+                    "text": "Player"
+                  }
+                },
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Names the player by the entry.\n\nThe consumer's own name for the player stands. Only a player named by\nnobody takes the entry's words as its name: `label` on a player that has\none, and `aria-label` on a plain `<video>` or `<audio>`, which has none and\nwas heard as an unnamed video.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessVideoPlaylist",
+                "module": "src/video-playlist/root/video-playlist-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "pointed",
@@ -244914,7 +245740,7 @@
                   }
                 }
               ],
-              "description": "Writes a row's role, and whether it is chosen in a list that selects:\n`option` with `aria-selected` there, and `listitem` otherwise, and\n`aria-disabled` on an item `disabled-keys` names. Every pass,\nsince a choice changes no row's content.",
+              "description": "Writes a row's role, and whether it is chosen in a list that selects:\n`option` with `aria-selected` there, and `listitem` otherwise, and\n`aria-disabled` on an item `disabled-keys` names. Every pass,\nsince a choice changes no row's content.\n\n`data-selected` and `data-disabled` say the same to a stylesheet, as\nReact Aria's rows do, so one rule reads the same in either kind of list.",
               "inheritedFrom": {
                 "name": "HelixHeadlessVirtualList",
                 "module": "src/virtual-list/root/virtual-list-root.ts"
@@ -245861,6 +246687,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.170.0"
+    "version": "0.171.0"
   }
 }