@fusion.dev/helix-headless 0.149.1 → 0.150.0

package/custom-elements.json

@@ -30684,6 +30684,10 @@
               "description": "Help text under the field.",
               "name": "hint"
             },
+            {
+              "description": "The label, for content richer than the `label` text.",
+              "name": "label"
+            },
             {
               "description": "Content in the panel under the picker, such as a note or an action.",
               "name": "panel-footer"
@@ -35741,7 +35745,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The list is a `Listbox`, which handles filtering, the empty state, the\nhighlight, `aria-activedescendant`, and scrolling an option into view. This\nelement handles the field, the panel, and the communication between them.\n\nThe typed text and the value are separate. The text is a filter: it narrows\nthe list and is then discarded. The value is the option you choose, and the\nfield then shows that option's text. The filter clears on close, so a\nreopened combobox starts from the whole list.\n\nFocus stays in the text field. The arrow keys move through the list with the\nlistbox's public `navigate` method. As typing narrows the list, a screen\nreader hears how many options are left, such as \"3 results\". Emptying the\nfield and leaving it clears a single choice.\n\n**Keyboard.**\n\n| Key | What it does |\n|---|---|\n| Down, Up | On a closed field, opens the list on the chosen option, or the first or the last. In the open list, moves the highlight, round from the last option to the first. |\n| Page Down, Page Up | In the open list, moves the highlight by as many options as the list shows at once. |\n| Enter | Chooses the highlighted option. With nothing left in the list, creates what was typed with `creatable`, or takes it with `allows-custom-value`. On a closed field, submits the form. |\n| Escape | Closes the list and puts the chosen words back. On a closed field, a second Escape clears a single choice. |\n| Tab | Closes the list and moves on. |\n| Backspace | With `multiple`, on an empty field, removes the last tag. |\n| Space, Home, End, letters | Edit the text. |\n\n**ARIA.** The input is the `combobox`, named by the label, with\n`aria-expanded`, `aria-controls` naming the list, `aria-autocomplete`\n(`both` with `suggest`, `list` otherwise) and `aria-activedescendant` on\nthe highlighted option. The list is the listbox `Listbox` describes.\n\nOn Apple devices, where VoiceOver does not read the option the field points\nto, the field says it in a live region as the highlight moves, says how many\noptions there are as the list opens, and says a choice once it is made, as\nReact Aria's combobox does there.\n\nSet `autocomplete` to let a browser's autofill choose an option.\n\nWith `multiple`, each chosen option is a tag in the field with its own remove\ncontrol. The panel stays open and the filter clears after each choice, so the\nnext choice starts from the whole list.\n\nWith `creatable`, the combobox offers a create row and fires `helix-create`.\nIt does not add the option. The options are your light DOM, and your\nframework would re-render over an element the combobox inserted, so add the\noption in your event handler.",
+          "description": "The list is a `Listbox`, which handles filtering, the empty state, the\nhighlight, `aria-activedescendant`, and scrolling an option into view. This\nelement handles the field, the panel, and the communication between them.\n\nThe typed text and the value are separate. The text is a filter: it narrows\nthe list and is then discarded. The value is the option you choose, and the\nfield then shows that option's text. The filter clears on close, so a\nreopened combobox starts from the whole list.\n\nFocus stays in the text field. The arrow keys move through the list with the\nlistbox's public `navigate` method. As typing narrows the list, a screen\nreader hears how many options are left, such as \"3 results\". Emptying the\nfield and leaving it clears a single choice.\n\n**Keyboard.**\n\n| Key | What it does |\n|---|---|\n| Down, Up | On a closed field, opens the list on the chosen option, or the first or the last. In the open list, moves the highlight, round from the last option to the first. |\n| Page Down, Page Up | In the open list, moves the highlight by as many options as the list shows at once. |\n| Enter | Chooses the highlighted option. With nothing left in the list, creates what was typed with `creatable`, or takes it with `allows-custom-value`. On a closed field, submits the form. |\n| Escape | Closes the list and puts the chosen words back. On a closed field, a second Escape clears a single choice. |\n| Tab | Closes the list and moves on. |\n| Backspace | With `multiple`, on an empty field, removes the last tag. |\n| Left | With `multiple`, with the caret at the start of the text, moves to the last tag's remove button. Right on a right-to-left page. |\n| Left, Right on a tag | Move between the tags, and past the last back to the text. |\n| Delete, Backspace on a tag | Removes the tag. |\n| Space, Home, End, letters | Edit the text. |\n\n**ARIA.** The input is the `combobox`, named by the label, with\n`aria-expanded`, `aria-controls` naming the list, `aria-autocomplete`\n(`both` with `suggest`, `list` otherwise) and `aria-activedescendant` on\nthe highlighted option. The list is the listbox `Listbox` describes.\n\nOn Apple devices, where VoiceOver does not read the option the field points\nto, the field says it in a live region as the highlight moves, says how many\noptions there are as the list opens, and says a choice once it is made, as\nReact Aria's combobox does there.\n\nSet `autocomplete` to let a browser's autofill choose an option.\n\nWith `multiple`, each chosen option is a tag in the field with its own remove\ncontrol. The text is the field's one tab stop, and the arrow keys reach the\ntags from it. The panel stays open and the filter clears after each choice, so the\nnext choice starts from the whole list.\n\nWith `creatable`, the combobox offers a create row and fires `helix-create`.\nIt does not add the option. The options are your light DOM, and your\nframework would re-render over an element the combobox inserted, so add the\noption in your event handler.",
           "name": "HelixHeadlessCombobox",
           "cssParts": [
             {
@@ -36719,6 +36723,35 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "tokenElements",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The tags, which the arrow keys reach from the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "focusTarget",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "protected",
+              "description": "Focus goes to the text field, the one tab stop, and never to a tag's remove\nbutton ahead of it, where Enter or Space would take a choice away.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixFormElement",
+                "module": "src/helix-form-element/helix-form-element.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleDismiss",
@@ -37056,6 +37089,46 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "tokenStops",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The remove button of each token shown that has one, in order.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tokenControl",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "description": "The host's text field.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTokenKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys between the tokens, and Delete or Backspace on one.\n\nThe arrow toward the end of the line moves to the next token, and past\nthe last into the text with the caret at its start. Delete or Backspace\nasks the focused token to go, as its remove button does, and focus that\nleaves with it comes back to the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderRest",
@@ -37920,20 +37993,6 @@
                 "text": "setCustomValidity(message: string) => void"
               }
             },
-            {
-              "kind": "field",
-              "name": "focusTarget",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "privacy": "protected",
-              "description": "The element focus goes to: the control's first tab stop, or `null` where\nthere is none.\n\nRead through shadow roots and slots, so a group lands on the member that\nholds its tab stop, which is the chosen radio in a radio group.",
-              "readonly": true,
-              "inheritedFrom": {
-                "name": "HelixFormElement",
-                "module": "src/helix-form-element/helix-form-element.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "focus",
@@ -40102,7 +40161,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Copies text to the clipboard and confirms the copy. The platform gives no\nfeedback for a clipboard write, so without a confirmation a press that copies\nlooks the same as one that fails.\n\nThe confirmation and the event wait for the write to finish. The browser can\nrefuse a clipboard write, for example on an insecure origin, in a document\nthat is not focused, or after a gesture that does not qualify. A refused\nwrite, or nothing to copy, names the button with `error-label` for the same\nmoment a copy shows `copied-label`, draws a cross, and sends\n`helix-copy-error`.\n\n`from` copies from another element on the page: its text, an attribute\nwritten `id[attribute]`, or a property written `id.property`, read at the\npress. It takes the place of `value`.\n\nIt replaces Button's render and its press, so it never submits a form or\nsends a command: `type`, `command`, `commandfor` and the `form*` overrides\nhave no effect, and the `start` and `end` slots and the `text` part are not\nrendered. An `aria-label` on the element names it before a copy, in place of\n`label`.\n\n**Keyboard.** Enter and Space copy, as they press a native button.\n\nThe button is named `label`, or the host's `aria-label`, and its name\nchanges to `copied-label` or `error-label` for the moment after a press,\nwhich is what a screen reader on it hears. The tooltip shows the same words.",
+          "description": "Copies text to the clipboard and confirms the copy. The platform gives no\nfeedback for a clipboard write, so without a confirmation a press that copies\nlooks the same as one that fails.\n\nThe confirmation and the event wait for the write to finish. The browser can\nrefuse a clipboard write, for example on an insecure origin, in a document\nthat is not focused, or after a gesture that does not qualify. A refused\nwrite, or nothing to copy, names the button with `error-label` for the same\nmoment a copy shows `copied-label`, draws a cross, and sends\n`helix-copy-error`.\n\n`from` copies from another element on the page: its text, an attribute\nwritten `id[attribute]`, or a property written `id.property`, read at the\npress. It takes the place of `value`.\n\nIt replaces Button's render and its press, so it never submits a form or\nsends a command: `type`, `command`, `commandfor` and the `form*` overrides\nhave no effect, and the `start` and `end` slots and the `text` part are not\nrendered. An `aria-label` on the element names it before a copy, in place of\n`label`.\n\n**Keyboard.** Enter and Space copy, as they press a native button.\n\nThe button is named `label`, or the host's `aria-label`, and its name\nchanges to `copied-label` or `error-label` for the moment after a press. The\nsame words are said in a live region, so a screen reader hears the result,\nand the tooltip shows them.",
           "name": "HelixHeadlessCopyButton",
           "cssParts": [
             {
@@ -40114,7 +40173,7 @@
               }
             },
             {
-              "description": "The live region that says `pending-label` when the button becomes pending under focus. It is rendered from the first time the button is pending.",
+              "description": "The live region that says `copied-label` or `error-label` after a press, and `pending-label` when the button becomes pending under focus. It is rendered from the first time it says anything.",
               "name": "live",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
@@ -46027,6 +46086,10 @@
               "description": "The help text under the field.",
               "name": "hint"
             },
+            {
+              "description": "The label, for content richer than the `label` text.",
+              "name": "label"
+            },
             {
               "description": "The icon on the calendar's next month control.",
               "name": "next-icon"
@@ -47235,6 +47298,17 @@
                 "module": "src/mixins/mixin-picker-editing/mixin-picker-editing.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleEditKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The first key that moves the caret or edits, while the focused field\nshows its rendering, puts the value in the field before the key acts.\n\nPicking hands focus back to a field that shows `August 5, 2026`, which is\nwhat the reader chose. `Intl` formats and does not parse, so a key that\nedited the rendering wrote text no date could be read from. The caret\nkeeps its place at the start, at the end, or around the whole text, and\ngoes to the end otherwise.",
+              "inheritedFrom": {
+                "name": "MixinPickerEditing",
+                "module": "src/mixins/mixin-picker-editing/mixin-picker-editing.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleFocus",
@@ -47698,6 +47772,60 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "tokenElements",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tokenStops",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The remove button of each token shown that has one, in order.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tokenControl",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "description": "The host's text field.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTokenKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys between the tokens, and Delete or Backspace on one.\n\nThe arrow toward the end of the line moves to the next token, and past\nthe last into the text with the caret at its start. Delete or Backspace\nasks the focused token to go, as its remove button does, and focus that\nleaves with it comes back to the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderRest",
@@ -62066,7 +62194,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Shows one filter declared by a `FilterField`: the field, the operator, and\nthe values, with a control to remove the filter.\n\nThe operator is shown only when it is not the field's default:\n\n```\nDisposition   refunded, chargeback         default operator, hidden\nDisposition   is not   refunded            chosen operator, shown\nCreated       after    1 Aug               a scalar field has no default\n```\n\nOmit `operator-label` for the field's default operator and pass it for every\nother operator. The code that builds the chip has the field, and the field\ndefines its default.\n\nThe chip shows a filter and does not apply it. Dismissing fires\n`helix-dismiss` as a request, as on `Tag` and `Announcement`. The chip is\nyour element in your list, so you remove it, which keeps your model and the\ndocument in step. Call `preventDefault()` on `helix-dismiss` to cancel the\ndismissal, which is also how you take control of the interaction for one\npress. `requestChange` documents the pattern.\n\n**Keyboard.** The remove button is a tab stop of its own, and Enter or Space\non it asks to remove the filter. In a `FilterInput`, Backspace in the empty\nfield asks to remove the last chip.\n\nThe remove button is named `dismiss-label` followed by the chip's words,\nsuch as \"Remove filter Status is not open\", so a row of chips says which\nfilter each button removes. Write `{label}` in `dismiss-label` to put the\nwords elsewhere.\n\nTo let the user change the operator, slot a menu trigger into `operator`.\nWith the text fallback, the operator is a label. The chip does not interpret\noperators: their meaning belongs to your domain, as `FilterOperator`\nexplains.",
+          "description": "Shows one filter declared by a `FilterField`: the field, the operator, and\nthe values, with a control to remove the filter.\n\nThe operator is shown only when it is not the field's default:\n\n```\nDisposition   refunded, chargeback         default operator, hidden\nDisposition   is not   refunded            chosen operator, shown\nCreated       after    1 Aug               a scalar field has no default\n```\n\nOmit `operator-label` for the field's default operator and pass it for every\nother operator. The code that builds the chip has the field, and the field\ndefines its default.\n\nThe chip shows a filter and does not apply it. Dismissing fires\n`helix-dismiss` as a request, as on `Tag` and `Announcement`. The chip is\nyour element in your list, so you remove it, which keeps your model and the\ndocument in step. Call `preventDefault()` on `helix-dismiss` to cancel the\ndismissal, which is also how you take control of the interaction for one\npress. `requestChange` documents the pattern.\n\n**Keyboard.** The remove button is a tab stop of its own, and Enter or Space\non it asks to remove the filter. In a `FilterInput`, Backspace in the empty\nfield asks to remove the last chip, the arrow keys move between the field\nand the chips, and Delete or Backspace on a chip asks to remove it.\n\nThe remove button is named `dismiss-label` followed by the chip's words,\nsuch as \"Remove filter Status is not open\", so a row of chips says which\nfilter each button removes. Write `{label}` in `dismiss-label` to put the\nwords elsewhere.\n\nTo let the user change the operator, slot a menu trigger into `operator`.\nWith the text fallback, the operator is a label. The chip does not interpret\noperators: their meaning belongs to your domain, as `FilterOperator`\nexplains.",
           "name": "HelixHeadlessFilterChip",
           "cssParts": [
             {
@@ -64567,7 +64695,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. The text names the highlighted\nsuggestion as its `aria-activedescendant`.\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. |\n| Backspace | In an empty field, asks the last 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. `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**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.",
+          "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. The text names the highlighted\nsuggestion as its `aria-activedescendant`.\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. |\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. `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**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.",
           "name": "HelixHeadlessFilterInput",
           "cssParts": [
             {
@@ -65173,6 +65301,21 @@
               "readonly": true,
               "description": "The row again, whenever what is in it changes."
             },
+            {
+              "kind": "method",
+              "name": "tokenElements",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The tokens slotted in `tags`, which the arrow keys reach from the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "removeLastToken",
@@ -65501,6 +65644,46 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "tokenStops",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The remove button of each token shown that has one, in order.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tokenControl",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "description": "The host's text field.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTokenKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys between the tokens, and Delete or Backspace on one.\n\nThe arrow toward the end of the line moves to the next token, and past\nthe last into the text with the caret at its start. Delete or Backspace\nasks the focused token to go, as its remove button does, and focus that\nleaves with it comes back to the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderRest",
@@ -109705,6 +109888,15 @@
               "readonly": true,
               "description": "Relayed, because `change` does not cross a shadow boundary on its own.\n\n**Settled first.** The field's `change` arrives before its `blur`, so\nrelaying it as it came announced the number as typed, 150 in a field whose\n`max` is 100, and the clamp that followed sent `input` alone: a consumer\nsaving on `change` kept 150 while the form submitted 100."
             },
+            {
+              "kind": "field",
+              "name": "enterCommit",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The value Enter settled and announced, until the field's `change` or the next keystroke."
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -109776,7 +109968,7 @@
               "name": "handleKeypress",
               "privacy": "private",
               "readonly": true,
-              "description": "Enter submits the form, as it does in a native text field.\n\nOn `keypress`, where the platform runs its own implicit submission, so a\nconsumer who prevents the `keydown` for Enter stops this too."
+              "description": "Enter submits the form, as it does in a native text field.\n\nOn `keypress`, where the platform runs its own implicit submission, so a\nconsumer who prevents the `keydown` for Enter stops this too.\n\n**Settled first**, as blur settles it. The typed text is read as a number,\n`change` announces it, and the form value is written before the form is\nsubmitted, so a field showing `$2,500.50` submits 2500.5."
             },
             {
               "kind": "field",
@@ -113888,10 +114080,18 @@
               "description": "The option's label.",
               "name": ""
             },
+            {
+              "description": "A second line under the label, for content richer than the `description` text.",
+              "name": "description"
+            },
             {
               "description": "Content after the label, such as a shortcut or a count.",
               "name": "end"
             },
+            {
+              "description": "An icon shown while the option is chosen, in place of the check the styled option draws.",
+              "name": "indicator"
+            },
             {
               "description": "Content before the label, such as an icon or an avatar.",
               "name": "start"
@@ -113943,7 +114143,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "A second line under the label that describes the choice.\n\nA palette row reads better as a name and a caption than as one sentence\ncarrying both: \"Helix\" and \"the design system\" are two facts, and a comma\nbetween them makes a reader parse the punctuation to find where the name\nends. Matching still reads the label, so what somebody types is matched\nagainst the name rather than against prose about it.\n\n**A property and not a slot, which is the departure worth explaining.** The\narea rules say a content property is its slot's fallback, and that holds for\na region always drawn: `Avatar`'s initials, `Tooltip`'s text. This one is\nusually absent, and a wrapped slot generates a box whether or not it is\nfilled, so every option without a caption would carry an empty line. The\ndetection that would avoid it does not exist, `:host(:has())` being invalid\nand the server having no children to inspect. A property is known at render\ntime, so the component can decline to draw the box at all.\n\nIt does not reflect, per the rule that payload state stays off the host: a\nstring is not a fact a selector needs.",
+              "description": "A second line under the label that describes the choice.\n\nA palette row reads better as a name and a caption than as one sentence\ncarrying both: \"Helix\" and \"the design system\" are two facts, and a comma\nbetween them makes a reader parse the punctuation to find where the name\nends. Matching still reads the label, so what somebody types is matched\nagainst the name rather than against prose about it.\n\nFor a caption richer than a string, slot it into `description`. The\nproperty is that slot's fallback inside the `description` part. With no\nproperty the slot is drawn bare, which takes no box while it is empty, so\nan option without a caption carries no empty line.\n\nIt does not reflect, per the rule that payload state stays off the host: a\nstring is not a fact a selector needs.",
               "attribute": "description"
             },
             {
@@ -114007,6 +114207,15 @@
               "description": "Whether this choice is currently chosen.\n\nWritten by the listbox.",
               "attribute": "selected"
             },
+            {
+              "kind": "field",
+              "name": "selectionFollowsActive",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the option says it is selected while the keyboard is on it.\n\nWritten by a control whose list holds suggestions, such as `FilterInput`:\nnothing there stays chosen, so the row the keyboard is on is the\nselection, as the APG combobox's list with selection that follows focus\nsays. No attribute: it is coordination between elements."
+            },
             {
               "kind": "field",
               "name": "target",
@@ -114451,7 +114660,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "A second line under the label that describes the choice.\n\nA palette row reads better as a name and a caption than as one sentence\ncarrying both: \"Helix\" and \"the design system\" are two facts, and a comma\nbetween them makes a reader parse the punctuation to find where the name\nends. Matching still reads the label, so what somebody types is matched\nagainst the name rather than against prose about it.\n\n**A property and not a slot, which is the departure worth explaining.** The\narea rules say a content property is its slot's fallback, and that holds for\na region always drawn: `Avatar`'s initials, `Tooltip`'s text. This one is\nusually absent, and a wrapped slot generates a box whether or not it is\nfilled, so every option without a caption would carry an empty line. The\ndetection that would avoid it does not exist, `:host(:has())` being invalid\nand the server having no children to inspect. A property is known at render\ntime, so the component can decline to draw the box at all.\n\nIt does not reflect, per the rule that payload state stays off the host: a\nstring is not a fact a selector needs.",
+              "description": "A second line under the label that describes the choice.\n\nA palette row reads better as a name and a caption than as one sentence\ncarrying both: \"Helix\" and \"the design system\" are two facts, and a comma\nbetween them makes a reader parse the punctuation to find where the name\nends. Matching still reads the label, so what somebody types is matched\nagainst the name rather than against prose about it.\n\nFor a caption richer than a string, slot it into `description`. The\nproperty is that slot's fallback inside the `description` part. With no\nproperty the slot is drawn bare, which takes no box while it is empty, so\nan option without a caption carries no empty line.\n\nIt does not reflect, per the rule that payload state stays off the host: a\nstring is not a fact a selector needs.",
               "fieldName": "description"
             },
             {
@@ -114541,6 +114750,14 @@
               "description": "While the keyboard is on the option, which is the option `aria-activedescendant` names.",
               "name": "active"
             },
+            {
+              "description": "While the option cannot be chosen.",
+              "name": "disabled"
+            },
+            {
+              "description": "An icon is slotted into `indicator`.",
+              "name": "has-indicator"
+            },
             {
               "description": "While the option is chosen.",
               "name": "selected"
@@ -124690,9 +124907,17 @@
               "type": {
                 "text": "HelixHeadlessRadio[]"
               },
-              "description": "The radios, in light-DOM order. Client only: the server has no tree.",
+              "description": "The radios, in light-DOM order. Client only: the server has no tree.\n\nDescendants, as `Checkbox.Group` reads its boxes, so a radio inside a\nlayout wrapper of yours is one of the group's. A radio held by a group\nnested inside this one is that group's.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "observer",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "handleSelection",
@@ -135645,6 +135870,16 @@
               "description": "A single thumb's fill: `--slider-fraction`, and under `origin` the span\nfrom the origin to the thumb as `--slider-from` and `--slider-to`.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "axis",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "The range's axis, written on it, so a vertical slider is vertical to the\naccessibility tree with no stylesheet: Chromium reads a range's\norientation off its writing mode and ignores `aria-orientation` there.\n`direction: rtl` puts the maximum at the top, which `vertical-lr` alone\nputs at the foot.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "snapped",
@@ -152510,7 +152745,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A part of `Tag` that holds tags as one control: a grid of rows, one tab stop\nfor the whole set. The arrow keys move between tags, Home and End go to the\nfirst and the last, and a typed letter goes to the next tag starting with\nit. Delete or Backspace removes the focused tag where it is `dismissible`,\nby sending its `helix-dismiss`: remove it from your list in the handler, and\nfocus moves to the next tag, or the previous one after the last.\n\n`selection-mode` lets a reader select tags, with Space, Enter or a press:\n`single` selects one at a time and `multiple` any number. `value` holds the\nselected tags' values, separated by commas, and a change asks with\n`helix-before-change` and tells with `change`. Enter on a tag with an\n`href` follows its link. A `disabled` tag is passed over. A selected tag\nthat is removed leaves `value`, which then sends `change`.\n\nName the set with `label`. Each tag is named by its words alone, without\nits remove button. `value` takes an array of values on the property as\nwell, as React sets `value={['Apple']}`; a press writes it back as a\nstring.\n\n**Removing the last tag keeps focus in the group.** With no tags left the\nset is a `group`, and focus moves to its `empty` part,\nwhich holds the `empty` slot: put words there such as \"No filters\" for a\nreader to hear. With nothing slotted it says `empty-label`, \"No tags\".",
+          "description": "A part of `Tag` that holds tags as one control: a grid of rows, one tab stop\nfor the whole set. The arrow keys move between tags, Home and End go to the\nfirst and the last, and a typed letter goes to the next tag starting with\nit. Delete or Backspace removes the focused tag where it is `dismissible`,\nby sending its `helix-dismiss`: remove it from your list in the handler, and\nfocus moves to the next tag, or the previous one after the last.\n\n`selection-mode` lets a reader select tags, with Space, Enter or a press:\n`single` selects one at a time and `multiple` any number. In `multiple`,\nShift with an arrow, Home or End selects the range from the tag last\npressed to the tag focus moves to, and Control or Command with A selects\nevery tag that is not disabled. `value` holds the\nselected tags' values, separated by commas, and a change asks with\n`helix-before-change` and tells with `change`. Enter on a tag with an\n`href` follows its link. A `disabled` tag is passed over. A selected tag\nthat is removed leaves `value`, which then sends `change`.\n\nName the set with `label`. Each tag is named by its words alone, without\nits remove button. `value` takes an array of values on the property as\nwell, as React sets `value={['Apple']}`; a press writes it back as a\nstring.\n\n**Removing the last tag keeps focus in the group.** With no tags left the\nset is a `group`, and focus moves to its `empty` part,\nwhich holds the `empty` slot: put words there such as \"No filters\" for a\nreader to hear. With nothing slotted it says `empty-label`, \"No tags\".\nWhere only disabled tags are left, the first of them holds the tab stop and\ntakes focus, so the reader stays in the set.",
           "name": "HelixHeadlessTagGroup",
           "cssParts": [
             {
@@ -152590,6 +152825,23 @@
               "privacy": "private",
               "description": "The tag the reader was last on, which keeps the tab stop."
             },
+            {
+              "kind": "field",
+              "name": "anchor",
+              "type": {
+                "text": "HelixHeadlessTag | undefined"
+              },
+              "privacy": "private",
+              "description": "Where a range chosen with Shift and an arrow starts, and where it reached,\nin `multiple`: the tag last pressed or moved to without Shift."
+            },
+            {
+              "kind": "field",
+              "name": "reached",
+              "type": {
+                "text": "HelixHeadlessTag | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "keys",
@@ -152714,6 +152966,75 @@
               ],
               "description": "Selects the tag, or lets it go, asking first.\n\n`helix-before-change` carries the `value` the press would leave, and a\nlistener that refuses it keeps the selection. `change` follows once it\nhas moved."
             },
+            {
+              "kind": "method",
+              "name": "span",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessTag[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "HelixHeadlessTag"
+                  }
+                },
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "HelixHeadlessTag"
+                  }
+                }
+              ],
+              "description": "The reachable tags from one to the other, either way round."
+            },
+            {
+              "kind": "method",
+              "name": "extend",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "HelixHeadlessTag"
+                  }
+                },
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "HelixHeadlessTag"
+                  }
+                }
+              ],
+              "description": "Shift and an arrow, Home or End, in `multiple`: the range from the anchor\nto the tag focus moved to is selected, in place of the range the last such\nkey selected, as React Aria's selection extends."
+            },
+            {
+              "kind": "method",
+              "name": "choose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "tags",
+                  "type": {
+                    "text": "readonly HelixHeadlessTag[]"
+                  }
+                }
+              ],
+              "description": "Asks for `value` to hold these tags' values, in their order."
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -153325,6 +153646,15 @@
                 "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, outside a `Tag.Group`.\n\nA field that holds tags as its tokens, such as a `multiple` Combobox,\nwrites `false`: the field's text is its one tab stop, and the arrow keys\nmove from the text to the tags. No attribute: it is coordination between\nelements, as `focusable` is."
+            },
             {
               "kind": "field",
               "name": "focusable",
@@ -156439,6 +156769,10 @@
               "description": "Help under the field.",
               "name": "hint"
             },
+            {
+              "description": "The label, for content richer than the `label` text.",
+              "name": "label"
+            },
             {
               "description": "Content in the panel under the times, such as a note or an action.",
               "name": "panel-footer"
@@ -157442,6 +157776,17 @@
                 "module": "src/mixins/mixin-picker-editing/mixin-picker-editing.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleEditKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The first key that moves the caret or edits, while the focused field\nshows its rendering, puts the value in the field before the key acts.\n\nPicking hands focus back to a field that shows `August 5, 2026`, which is\nwhat the reader chose. `Intl` formats and does not parse, so a key that\nedited the rendering wrote text no date could be read from. The caret\nkeeps its place at the start, at the end, or around the whole text, and\ngoes to the end otherwise.",
+              "inheritedFrom": {
+                "name": "MixinPickerEditing",
+                "module": "src/mixins/mixin-picker-editing/mixin-picker-editing.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleFocus",
@@ -157928,6 +158273,60 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "tokenElements",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tokenStops",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "The remove button of each token shown that has one, in order.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tokenControl",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "description": "The host's text field.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTokenKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys between the tokens, and Delete or Backspace on one.\n\nThe arrow toward the end of the line moves to the next token, and past\nthe last into the text with the caret at its start. Delete or Backspace\nasks the focused token to go, as its remove button does, and focus that\nleaves with it comes back to the text.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderRest",
@@ -165486,8 +165885,17 @@
                 "text": "HelixHeadlessToggle[]"
               },
               "privacy": "private",
+              "description": "The toggles, in light-DOM order, at any depth, so a toggle inside a layout\nwrapper of yours is one of the group's. A toggle held by a group nested\ninside this one is that group's.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "observer",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "handleSelection",
@@ -167105,7 +167513,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Renders a `<button role=\"radio\">` for use as a form control. In a group with\n`selection-mode=\"multiple\"` it is a `<button>` that says whether it is\npressed with `aria-pressed`.\n\nDo not use it for navigation. For navigation, use links marked with\n`aria-current` and styled by the `data-navigation-item` recipe in the base\nlayer. The recipe has the same look, and links are not announced as choices.",
+          "description": "Renders a `<button role=\"radio\">` for use as a form control. In a group with\n`selection-mode=\"multiple\"` it is a `<button>` that says whether it is\npressed with `aria-pressed`.\n\n**On its own, outside a `Toggle.Group`, it is a toggle button**, as React\nAria's `ToggleButton`: a `<button>` with `aria-pressed`. A press, Enter or\nSpace sends `helix-select`, which you can cancel, then flips `selected` and\nsends `change`. Write `selected` in the markup to start it pressed.\n\nDo not use it for navigation. For navigation, use links marked with\n`aria-current` and styled by the `data-navigation-item` recipe in the base\nlayer. The recipe has the same look, and links are not announced as choices.",
           "name": "HelixHeadlessToggle",
           "cssParts": [
             {
@@ -167142,7 +167550,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Whether the item holds the group's tab stop. Unset, the chosen item holds\nit.\n\nWritten by the group on every item: `true` for the chosen item, or for the\nfirst item that can be chosen while there is no selection to carry the\nstop, and `false` for every item, the chosen one too, while a toolbar the\ngroup sits in holds the stop. No attribute: it is coordination between\nelements, and `tabindex` on a host the consumer rendered is the change a\nReact consumer's hydration reports and does not patch up."
+              "description": "Whether the item holds the group's tab stop. Unset, no group holds the\nitem, and it is a toggle button with a tab stop of its own.\n\nWritten by the group on every item: `true` for the chosen item, or for the\nfirst item that can be chosen while there is no selection to carry the\nstop, and `false` for every item, the chosen one too, while a toolbar the\ngroup sits in holds the stop. No attribute: it is coordination between\nelements, and `tabindex` on a host the consumer rendered is the change a\nReact consumer's hydration reports and does not patch up."
             },
             {
               "kind": "field",
@@ -167152,6 +167560,33 @@
               },
               "description": "Whether the item is pressed, in a group where several can be, and\n`undefined` in a group where one is chosen.\n\nWritten by the group, like `selected`, so no attribute."
             },
+            {
+              "kind": "field",
+              "name": "alone",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether no `Toggle.Group` holds the item, which makes it a toggle button\nof its own. A group writes `focusable` on every item it holds. A server,\nand the render that hydrates its markup, cannot tell, and draw the item a\ngroup holds.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "select",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Chooses the item in its group, or, on its own, flips `selected` once\n`helix-select` stands and sends `change`.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
+              "type": {
+                "text": "select() => boolean"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -167226,23 +167661,6 @@
                 "text": "focusItem() => void"
               }
             },
-            {
-              "kind": "method",
-              "name": "select",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Selects the item and fires `helix-select`. Returns `false` if the item is\ndisabled or a listener cancels the event.",
-              "inheritedFrom": {
-                "name": "MixinSelectableItem",
-                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
-              },
-              "type": {
-                "text": "select() => boolean"
-              }
-            },
             {
               "kind": "field",
               "name": "tier",
@@ -167584,6 +168002,14 @@
             }
           ],
           "events": [
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired after a toggle button on its own is pressed or released.",
+              "name": "change",
+              "reactProp": "onchange"
+            },
             {
               "type": {
                 "text": "HelixSelectEvent"
@@ -167621,7 +168047,7 @@
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
           },
-          "summary": "One option in a toggle group.",
+          "summary": "One option in a toggle group, or a toggle button on its own.",
           "helix": {
             "category": "actions",
             "since": "0.1.0",
@@ -182029,6 +182455,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.149.1"
+    "version": "0.150.0"
   }
 }