@fusion.dev/helix-headless 0.157.0 → 0.158.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.157.0",
+  "version": "0.158.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -49,13 +49,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.157.0",
-    "@fusion.dev/helix-icons": "0.157.0",
+    "@fusion.dev/helix-core": "0.158.0",
+    "@fusion.dev/helix-icons": "0.158.0",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.157.0",
-    "@fusion.dev/helix-testing": "0.157.0",
+    "@fusion.dev/helix-cem": "0.158.0",
+    "@fusion.dev/helix-testing": "0.158.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.14.5",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -8419,6 +8419,13 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessCommand["open"]) | undefined;
+  /** Whether a command is kept by the filter: a function given the command's
+words and the filter, trimmed, that returns `true` to keep it showing, as
+React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
+
+Absent, a command is kept where its words hold the filter, in any case. A
+property only, there being no way to write a function in markup. */
+  filterMatch?: (HelixHeadlessCommand["filterMatch"]) | undefined;
   /** The commands as data, for a palette too long to draw whole: each a value,
 which is also its words, or a record with a `value`, a `label` and
 `disabled`. Handed to the list, which draws only the commands in sight and
@@ -8548,6 +8555,13 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   "prop:open"?: (HelixHeadlessCommand["open"]) | undefined;
+  /** Whether a command is kept by the filter: a function given the command's
+words and the filter, trimmed, that returns `true` to keep it showing, as
+React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
+
+Absent, a command is kept where its words hold the filter, in any case. A
+property only, there being no way to write a function in markup. */
+  "prop:filterMatch"?: (HelixHeadlessCommand["filterMatch"]) | undefined;
   /** The commands as data, for a palette too long to draw whole: each a value,
 which is also its words, or a record with a `value`, a `label` and
 `disabled`. Handed to the list, which draws only the commands in sight and
@@ -17395,7 +17409,9 @@ Not reflected, as a state never is. `row-current` is the part a
 stylesheet draws it from. */
   current?: (HelixHeadlessListItem["current"]) | undefined;
   /** Takes the row out of reach in a list with `selection-mode`: the arrow keys
-pass over it and it cannot be selected or acted on. */
+pass over it and it cannot be selected or acted on. In a list with
+`disabled-behavior="selection"`, it cannot be selected and is reached and
+acted on as any row is. */
   disabled?: (HelixHeadlessListItem["disabled"]) | undefined;
   /** The URL the row links to. Leave it empty for a row that is not a link.
 
@@ -17431,6 +17447,10 @@ being moved, or the one the drop indicator is beside. Unset otherwise. */
 Written by the list from its own `value`, and unset where nothing can be
 selected, which keeps `aria-selected` off a list that does not select. */
   selected?: (HelixHeadlessListItem["selected"]) | undefined;
+  /** Whether `disabled` takes the row out of selection alone, written by a list
+with `disabled-behavior="selection"`. No attribute: it is coordination
+between elements, as `focusable` is. */
+  selectionOnly?: (HelixHeadlessListItem["selectionOnly"]) | undefined;
 
   /** The reader pressed Enter on the row, or pressed the row in a list that selects nothing, in a list with `selection-mode`. Read the row from `target`. A row with `href` follows its link instead. */
   "onhelix-action"?: ((e: HelixHeadlessListItemHelixActionElementEvent) => void) | undefined;
@@ -17446,7 +17466,9 @@ Not reflected, as a state never is. `row-current` is the part a
 stylesheet draws it from. */
   "prop:current"?: (HelixHeadlessListItem["current"]) | undefined;
   /** Takes the row out of reach in a list with `selection-mode`: the arrow keys
-pass over it and it cannot be selected or acted on. */
+pass over it and it cannot be selected or acted on. In a list with
+`disabled-behavior="selection"`, it cannot be selected and is reached and
+acted on as any row is. */
   "prop:disabled"?: (HelixHeadlessListItem["disabled"]) | undefined;
   /** The URL the row links to. Leave it empty for a row that is not a link.
 
@@ -17482,6 +17504,10 @@ being moved, or the one the drop indicator is beside. Unset otherwise. */
 Written by the list from its own `value`, and unset where nothing can be
 selected, which keeps `aria-selected` off a list that does not select. */
   "prop:selected"?: (HelixHeadlessListItem["selected"]) | undefined;
+  /** Whether `disabled` takes the row out of selection alone, written by a list
+with `disabled-behavior="selection"`. No attribute: it is coordination
+between elements, as `focusable` is. */
+  "prop:selectionOnly"?: (HelixHeadlessListItem["selectionOnly"]) | undefined;
   /** The reader pressed Enter on the row, or pressed the row in a list that selects nothing, in a list with `selection-mode`. Read the row from `target`. A row with `href` follows its link instead. */
   "on:helix-action"?: ((e: HelixHeadlessListItemHelixActionElementEvent) => void) | undefined;
 
@@ -17519,6 +17545,20 @@ refused, in a `reorderable` list. */
   /** What screen readers hear when a held row is put back, or a move is
 refused, in a `reorderable` list. */
   canceledLabel?: (HelixHeadlessList["canceledLabel"]) | undefined;
+  /** What `disabled` takes from a row, in a list that selects: `all`, which
+passes over the row, or `selection`, which keeps the row out of the
+selection and lets the keys reach it and Enter or a press act on it, as
+React Aria's GridList takes `disabledBehavior`.
+
+Absent is `all`. */
+  "disabled-behavior"?: (HelixHeadlessList["disabledBehavior"]) | undefined;
+  /** What `disabled` takes from a row, in a list that selects: `all`, which
+passes over the row, or `selection`, which keeps the row out of the
+selection and lets the keys reach it and Enter or a press act on it, as
+React Aria's GridList takes `disabledBehavior`.
+
+Absent is `all`. */
+  disabledBehavior?: (HelixHeadlessList["disabledBehavior"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
   "dropped-label"?: (HelixHeadlessList["droppedLabel"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
@@ -17651,6 +17691,20 @@ refused, in a `reorderable` list. */
   /** What screen readers hear when a held row is put back, or a move is
 refused, in a `reorderable` list. */
   "prop:canceledLabel"?: (HelixHeadlessList["canceledLabel"]) | undefined;
+  /** What `disabled` takes from a row, in a list that selects: `all`, which
+passes over the row, or `selection`, which keeps the row out of the
+selection and lets the keys reach it and Enter or a press act on it, as
+React Aria's GridList takes `disabledBehavior`.
+
+Absent is `all`. */
+  "attr:disabled-behavior"?: (HelixHeadlessList["disabledBehavior"]) | undefined;
+  /** What `disabled` takes from a row, in a list that selects: `all`, which
+passes over the row, or `selection`, which keeps the row out of the
+selection and lets the keys reach it and Enter or a press act on it, as
+React Aria's GridList takes `disabledBehavior`.
+
+Absent is `all`. */
+  "prop:disabledBehavior"?: (HelixHeadlessList["disabledBehavior"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
   "attr:dropped-label"?: (HelixHeadlessList["droppedLabel"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
@@ -18042,6 +18096,14 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixHeadlessListbox["name"]) | undefined;
+  /** Whether an option is kept by the filter: a function given the option's
+words and the filter, trimmed, that returns `true` to keep it showing, as
+React Aria's `Autocomplete` takes `filter`. For matching that ignores
+accents, matches the start of each word, or matches out of order.
+
+Absent, an option is kept where its words hold the filter, in any case. A
+property only, there being no way to write a function in markup. */
+  filterMatch?: (HelixHeadlessListbox["filterMatch"]) | undefined;
   /** The options as data, for a list too long to draw whole: each a value,
 which is also its words, or a record with a `value`, a `label` and
 `disabled`. Set, the list draws only the options in sight, and the ones
@@ -18332,6 +18394,14 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   "prop:name"?: (HelixHeadlessListbox["name"]) | undefined;
+  /** Whether an option is kept by the filter: a function given the option's
+words and the filter, trimmed, that returns `true` to keep it showing, as
+React Aria's `Autocomplete` takes `filter`. For matching that ignores
+accents, matches the start of each word, or matches out of order.
+
+Absent, an option is kept where its words hold the filter, in any case. A
+property only, there being no way to write a function in markup. */
+  "prop:filterMatch"?: (HelixHeadlessListbox["filterMatch"]) | undefined;
   /** The options as data, for a list too long to draw whole: each a value,
 which is also its words, or a record with a `value`, a `label` and
 `disabled`. Set, the list draws only the options in sight, and the ones
@@ -21603,8 +21673,11 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixHeadlessNumberInput["name"]) | undefined;
-  /** The value as a number, or `NaN` while the control is empty.
+  /** The value as a number, or `NaN` while the control is empty or does not
+hold a number.
 
+Read in the locale and the format, as the form reads it, so `1,5` typed
+in a locale with a decimal comma is 1.5 here while the form holds 1.5.
 `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
 is zero, so an empty control would report a number it does not hold and a
 form would submit it. */
@@ -21878,8 +21951,11 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   "prop:name"?: (HelixHeadlessNumberInput["name"]) | undefined;
-  /** The value as a number, or `NaN` while the control is empty.
+  /** The value as a number, or `NaN` while the control is empty or does not
+hold a number.
 
+Read in the locale and the format, as the form reads it, so `1,5` typed
+in a locale with a decimal comma is 1.5 here while the form holds 1.5.
 `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
 is zero, so an empty control would report a number it does not hold and a
 form would submit it. */
@@ -26018,7 +26094,8 @@ export type HelixHeadlessSkeletonProps = {
   /** What is loading, read out as the placeholder's name, such as "Loading
 profile".
 
-Absent hides the placeholder from screen readers. */
+Absent hides the placeholder from screen readers. Around content, the name
+is read while `loading` is set, and the loaded content is read as it is. */
   label?: (HelixHeadlessSkeleton["label"]) | undefined;
   /** Whether the content inside is still loading, which keeps it inert and
 draws the placeholder over it.
@@ -26032,7 +26109,8 @@ export type HelixHeadlessSkeletonSolidJsProps = {
   /** What is loading, read out as the placeholder's name, such as "Loading
 profile".
 
-Absent hides the placeholder from screen readers. */
+Absent hides the placeholder from screen readers. Around content, the name
+is read while `loading` is set, and the loaded content is read as it is. */
   "prop:label"?: (HelixHeadlessSkeleton["label"]) | undefined;
   /** Whether the content inside is still loading, which keeps it inert and
 draws the placeholder over it.
@@ -41095,8 +41173,9 @@ export type CustomElements = {
    *
    * Choosing the opener says `helix-select` with its value, and canceling it
    * keeps the page that is shown. The list then shows the page, named by the
-   * opener's words, and Backspace in an empty filter goes back. `page` says
-   * which page is shown.
+   * opener's words, and a screen reader hears those words. Backspace in an empty
+   * filter goes back, and a screen reader hears the name of the page it goes
+   * back to. `page` says which page is shown.
    *
    * The filter is cleared when the palette closes, so each opening starts from
    * the full list. Combobox and Select do the same. As typing narrows the list, a
@@ -41118,9 +41197,10 @@ export type CustomElements = {
    * | Tab | Stays in the palette, which is modal. With `inline`, moves on through the page. |
    *
    * **ARIA.** The palette is a modal `dialog` named by `label`, or with
-   * `inline` no dialog at all. Inside it the filter field is a `combobox` with
-   * `aria-activedescendant` on the highlighted command, and the commands are a
-   * `listbox` of `option`s. How many commands typing left, the empty text and
+   * `inline` no dialog at all. Inside it the filter field is a text field with
+   * `aria-autocomplete="list"`, `aria-controls` on the list, and
+   * `aria-activedescendant` on the highlighted command, as the field of React
+   * Aria's `Autocomplete` is. The commands are a `listbox` of `option`s. How many commands typing left, the empty text and
    * the loading text are said in a polite live region.
    *
    * ## Attributes & Properties
@@ -41184,6 +41264,12 @@ export type CustomElements = {
    * hydration, or diffed by a framework, it comes back holding whatever the
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
+   * - `filterMatch`: Whether a command is kept by the filter: a function given the command's
+   * words and the filter, trimmed, that returns `true` to keep it showing, as
+   * React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
+   *
+   * Absent, a command is kept where its words hold the filter, in any case. A
+   * property only, there being no way to write a function in markup. (property only)
    * - `items`: The commands as data, for a palette too long to draw whole: each a value,
    * which is also its words, or a record with a `value`, a `label` and
    * `disabled`. Handed to the list, which draws only the commands in sight and
@@ -41275,6 +41361,7 @@ export type CustomElements = {
    * - `listbox-loading`: The text shown while the commands are loading.
    * - `listbox-search`: The region that holds the filter field.
    * - `listbox-search-field`: The filter field.
+   * - `live`: The region a screen reader announces the page shown from, by the words of the command that opens it, drawn once there is one to say. Visually hidden in the styled tier.
    *
    * ## CSS States
    *
@@ -48186,7 +48273,9 @@ export type CustomElements = {
    * Not reflected, as a state never is. `row-current` is the part a
    * stylesheet draws it from.
    * - `disabled`: Takes the row out of reach in a list with `selection-mode`: the arrow keys
-   * pass over it and it cannot be selected or acted on.
+   * pass over it and it cannot be selected or acted on. In a list with
+   * `disabled-behavior="selection"`, it cannot be selected and is reached and
+   * acted on as any row is.
    * - `href`: The URL the row links to. Leave it empty for a row that is not a link.
    *
    * Empty rather than optional, and unset by default: a list is not always a
@@ -48213,6 +48302,9 @@ export type CustomElements = {
    *
    * Written by the list from its own `value`, and unset where nothing can be
    * selected, which keeps `aria-selected` off a list that does not select. (property only)
+   * - `selectionOnly`: Whether `disabled` takes the row out of selection alone, written by a list
+   * with `disabled-behavior="selection"`. No attribute: it is coordination
+   * between elements, as `focusable` is. (property only)
    * - `words`: The row's words, or none where the children are not known yet. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -48273,6 +48365,7 @@ export type CustomElements = {
    * - `dragging`: The row is being moved, in a `reorderable` list.
    * - `drop-after`: The row being moved goes after this one when it is dropped.
    * - `drop-before`: The row being moved goes before this one when it is dropped.
+   * - `focus-visible`: The row's cell has keyboard focus that the browser shows, in a list with `selection-mode`.
    * - `selected`: The row is selected, in a list that selects.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -48289,7 +48382,9 @@ export type CustomElements = {
    * `multiple` any number, and `value` holds the selected rows' values,
    * separated by commas. A change asks with `helix-before-change` and tells
    * with `change`. `none` selects nothing, so a press acts on the row. A
-   * `disabled` row is passed over. Each row is named by its label and described
+   * `disabled` row is passed over. With `disabled-behavior="selection"`, a
+   * `disabled` row cannot be selected, and is reached and acted on as any row
+   * is, as React Aria's GridList has it. Each row is named by its label and described
    * by its description, so the words of the controls in `end` are not read as
    * part of its name.
    *
@@ -48367,6 +48462,12 @@ export type CustomElements = {
    *
    * - `canceled-label`/`canceledLabel`: What screen readers hear when a held row is put back, or a move is
    * refused, in a `reorderable` list.
+   * - `disabled-behavior`/`disabledBehavior`: What `disabled` takes from a row, in a list that selects: `all`, which
+   * passes over the row, or `selection`, which keeps the row out of the
+   * selection and lets the keys reach it and Enter or a press act on it, as
+   * React Aria's GridList takes `disabledBehavior`.
+   *
+   * Absent is `all`.
    * - `dropped-label`/`droppedLabel`: What screen readers hear when a row is dropped, in a `reorderable` list.
    * - `empty-label`/`emptyLabel`: The text of the row shown while the list has no rows, where the `empty`
    * slot is empty. Empty, the default, shows no row.
@@ -48506,7 +48607,9 @@ export type CustomElements = {
    * With `multiple` set, `value` is a comma-separated string, like
    * `Checkbox.Group`'s, because `MixinControllerValue` holds a string. The form
    * receives one entry per selected option, as a native `<select multiple>` sends
-   * it, so your server does not split on commas.
+   * it, so your server does not split on commas. An option's value may hold a
+   * comma: a run of the string that is an option's value is read as that one
+   * value, and the form sends it as one entry.
    *
    * Selected and active are separate. The selected option is the value. The
    * active option is where the keyboard is: the arrow keys move it, and
@@ -48713,6 +48816,13 @@ export type CustomElements = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
+   * - `filterMatch`: Whether an option is kept by the filter: a function given the option's
+   * words and the filter, trimmed, that returns `true` to keep it showing, as
+   * React Aria's `Autocomplete` takes `filter`. For matching that ignores
+   * accents, matches the start of each word, or matches out of order.
+   *
+   * Absent, an option is kept where its words hold the filter, in any case. A
+   * property only, there being no way to write a function in markup. (property only)
    * - `items`: The options as data, for a list too long to draw whole: each a value,
    * which is also its words, or a record with a `value`, a `label` and
    * `disabled`. Set, the list draws only the options in sight, and the ones
@@ -48749,7 +48859,10 @@ export type CustomElements = {
    * Descendants rather than children, because a group puts a level between the
    * list and its options and the keyboard has to move through a grouped list
    * exactly as it moves through a flat one. (property only) (readonly)
-   * - `values`: The chosen values, as an array whether or not `multiple` is set. (property only) (readonly)
+   * - `values`: The chosen values, as an array whether or not `multiple` is set.
+   *
+   * Read against the options' values, so an option whose value holds a comma
+   * is one value. See `chosenValues`. (property only) (readonly)
    * - `validity`: Whether the control meets its constraints, and why not. (property only) (readonly)
    * - `validationMessage`: The message the browser would show for the control, or an empty string. (property only) (readonly)
    * - `willValidate`: Whether the control is checked when its form is submitted. (property only) (readonly)
@@ -50520,8 +50633,8 @@ export type CustomElements = {
    * rows, Home and End go to the first and the last, a typed letter moves to
    * the next row whose name starts with it, Enter and Space choose, Right Arrow
    * opens a row's submenu and Left Arrow goes back, the two swapping on a
-   * right-to-left page, and Escape closes the menu and returns focus to the
-   * trigger. Tab closes it and moves on.
+   * right-to-left page. Left Arrow on the top page does nothing. Escape closes
+   * the menu and returns focus to the trigger. Tab closes it and moves on.
    *
    * While it is open, the surface carries the trigger's width as
    * `--floating-anchor-inline-size` and the room left below it as
@@ -50665,6 +50778,10 @@ export type CustomElements = {
    * - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
    * - `mark`: A row on the current page has a checkbox or a link, so every row keeps the trailing column.
    * - `open`: While the menu is open.
+   * - `placed-bottom`: While the open panel sits below its trigger.
+   * - `placed-left`: While the open panel sits to the left of its trigger.
+   * - `placed-right`: While the open panel sits to the right of its trigger.
+   * - `placed-top`: While the open panel sits above its trigger.
    * - `start`: A row on the current page has content in its leading column, so every row keeps that column.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -51564,9 +51681,9 @@ export type CustomElements = {
    * The locale's group separators are read in every field, so `1,234` is a
    * number in `en-US`.
    *
-   * The field and its two buttons sit in a `role="group"`, and the field carries
-   * `role-label`, "number field" in English, as its `aria-roledescription`, as
-   * React Aria's NumberField does. On iOS and iPadOS the field is a plain text
+   * The field and its two buttons sit in a `role="group"` named by the label,
+   * and the field carries `role-label`, "number field" in English, as its
+   * `aria-roledescription`, as React Aria's NumberField does. On iOS and iPadOS the field is a plain text
    * field, with no `role="spinbutton"`, which VoiceOver reads as a slider you
    * cannot type in, and no role description, so VoiceOver says the field is
    * required. React Aria's NumberField does the same.
@@ -51745,8 +51862,11 @@ export type CustomElements = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
-   * - `valueAsNumber`: The value as a number, or `NaN` while the control is empty.
+   * - `valueAsNumber`: The value as a number, or `NaN` while the control is empty or does not
+   * hold a number.
    *
+   * Read in the locale and the format, as the form reads it, so `1,5` typed
+   * in a locale with a decimal comma is 1.5 here while the form holds 1.5.
    * `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
    * is zero, so an empty control would report a number it does not hold and a
    * form would submit it. (property only)
@@ -55142,7 +55262,9 @@ export type CustomElements = {
    * whole set.
    *
    * `Select` owns the value, passes it down to the listbox, and takes changes
-   * back, so the value lives in one place.
+   * back, so the value lives in one place. With `multiple`, the value is the
+   * chosen values joined with commas, and the form receives one entry for each.
+   * An option's value may hold a comma, and it is read as one value.
    *
    * Set `valueContent` to draw the trigger's content from the chosen options,
    * and several chosen options are written as a list in the reader's language.
@@ -55519,7 +55641,8 @@ export type CustomElements = {
    * - `label`: What is loading, read out as the placeholder's name, such as "Loading
    * profile".
    *
-   * Absent hides the placeholder from screen readers.
+   * Absent hides the placeholder from screen readers. Around content, the name
+   * is read while `loading` is set, and the loaded content is read as it is.
    * - `loading`: Whether the content inside is still loading, which keeps it inert and
    * draws the placeholder over it.
    *
@@ -69278,8 +69401,9 @@ export type CustomElementsSolidJs = {
    *
    * Choosing the opener says `helix-select` with its value, and canceling it
    * keeps the page that is shown. The list then shows the page, named by the
-   * opener's words, and Backspace in an empty filter goes back. `page` says
-   * which page is shown.
+   * opener's words, and a screen reader hears those words. Backspace in an empty
+   * filter goes back, and a screen reader hears the name of the page it goes
+   * back to. `page` says which page is shown.
    *
    * The filter is cleared when the palette closes, so each opening starts from
    * the full list. Combobox and Select do the same. As typing narrows the list, a
@@ -69301,9 +69425,10 @@ export type CustomElementsSolidJs = {
    * | Tab | Stays in the palette, which is modal. With `inline`, moves on through the page. |
    *
    * **ARIA.** The palette is a modal `dialog` named by `label`, or with
-   * `inline` no dialog at all. Inside it the filter field is a `combobox` with
-   * `aria-activedescendant` on the highlighted command, and the commands are a
-   * `listbox` of `option`s. How many commands typing left, the empty text and
+   * `inline` no dialog at all. Inside it the filter field is a text field with
+   * `aria-autocomplete="list"`, `aria-controls` on the list, and
+   * `aria-activedescendant` on the highlighted command, as the field of React
+   * Aria's `Autocomplete` is. The commands are a `listbox` of `option`s. How many commands typing left, the empty text and
    * the loading text are said in a polite live region.
    *
    * ## Attributes & Properties
@@ -69367,6 +69492,12 @@ export type CustomElementsSolidJs = {
    * hydration, or diffed by a framework, it comes back holding whatever the
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
+   * - `filterMatch`: Whether a command is kept by the filter: a function given the command's
+   * words and the filter, trimmed, that returns `true` to keep it showing, as
+   * React Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
+   *
+   * Absent, a command is kept where its words hold the filter, in any case. A
+   * property only, there being no way to write a function in markup. (property only)
    * - `items`: The commands as data, for a palette too long to draw whole: each a value,
    * which is also its words, or a record with a `value`, a `label` and
    * `disabled`. Handed to the list, which draws only the commands in sight and
@@ -69458,6 +69589,7 @@ export type CustomElementsSolidJs = {
    * - `listbox-loading`: The text shown while the commands are loading.
    * - `listbox-search`: The region that holds the filter field.
    * - `listbox-search-field`: The filter field.
+   * - `live`: The region a screen reader announces the page shown from, by the words of the command that opens it, drawn once there is one to say. Visually hidden in the styled tier.
    *
    * ## CSS States
    *
@@ -76437,7 +76569,9 @@ export type CustomElementsSolidJs = {
    * Not reflected, as a state never is. `row-current` is the part a
    * stylesheet draws it from.
    * - `disabled`: Takes the row out of reach in a list with `selection-mode`: the arrow keys
-   * pass over it and it cannot be selected or acted on.
+   * pass over it and it cannot be selected or acted on. In a list with
+   * `disabled-behavior="selection"`, it cannot be selected and is reached and
+   * acted on as any row is.
    * - `href`: The URL the row links to. Leave it empty for a row that is not a link.
    *
    * Empty rather than optional, and unset by default: a list is not always a
@@ -76464,6 +76598,9 @@ export type CustomElementsSolidJs = {
    *
    * Written by the list from its own `value`, and unset where nothing can be
    * selected, which keeps `aria-selected` off a list that does not select. (property only)
+   * - `selectionOnly`: Whether `disabled` takes the row out of selection alone, written by a list
+   * with `disabled-behavior="selection"`. No attribute: it is coordination
+   * between elements, as `focusable` is. (property only)
    * - `words`: The row's words, or none where the children are not known yet. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -76524,6 +76661,7 @@ export type CustomElementsSolidJs = {
    * - `dragging`: The row is being moved, in a `reorderable` list.
    * - `drop-after`: The row being moved goes after this one when it is dropped.
    * - `drop-before`: The row being moved goes before this one when it is dropped.
+   * - `focus-visible`: The row's cell has keyboard focus that the browser shows, in a list with `selection-mode`.
    * - `selected`: The row is selected, in a list that selects.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -76543,7 +76681,9 @@ export type CustomElementsSolidJs = {
    * `multiple` any number, and `value` holds the selected rows' values,
    * separated by commas. A change asks with `helix-before-change` and tells
    * with `change`. `none` selects nothing, so a press acts on the row. A
-   * `disabled` row is passed over. Each row is named by its label and described
+   * `disabled` row is passed over. With `disabled-behavior="selection"`, a
+   * `disabled` row cannot be selected, and is reached and acted on as any row
+   * is, as React Aria's GridList has it. Each row is named by its label and described
    * by its description, so the words of the controls in `end` are not read as
    * part of its name.
    *
@@ -76621,6 +76761,12 @@ export type CustomElementsSolidJs = {
    *
    * - `canceled-label`/`canceledLabel`: What screen readers hear when a held row is put back, or a move is
    * refused, in a `reorderable` list.
+   * - `disabled-behavior`/`disabledBehavior`: What `disabled` takes from a row, in a list that selects: `all`, which
+   * passes over the row, or `selection`, which keeps the row out of the
+   * selection and lets the keys reach it and Enter or a press act on it, as
+   * React Aria's GridList takes `disabledBehavior`.
+   *
+   * Absent is `all`.
    * - `dropped-label`/`droppedLabel`: What screen readers hear when a row is dropped, in a `reorderable` list.
    * - `empty-label`/`emptyLabel`: The text of the row shown while the list has no rows, where the `empty`
    * slot is empty. Empty, the default, shows no row.
@@ -76763,7 +76909,9 @@ export type CustomElementsSolidJs = {
    * With `multiple` set, `value` is a comma-separated string, like
    * `Checkbox.Group`'s, because `MixinControllerValue` holds a string. The form
    * receives one entry per selected option, as a native `<select multiple>` sends
-   * it, so your server does not split on commas.
+   * it, so your server does not split on commas. An option's value may hold a
+   * comma: a run of the string that is an option's value is read as that one
+   * value, and the form sends it as one entry.
    *
    * Selected and active are separate. The selected option is the value. The
    * active option is where the keyboard is: the arrow keys move it, and
@@ -76970,6 +77118,13 @@ export type CustomElementsSolidJs = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
+   * - `filterMatch`: Whether an option is kept by the filter: a function given the option's
+   * words and the filter, trimmed, that returns `true` to keep it showing, as
+   * React Aria's `Autocomplete` takes `filter`. For matching that ignores
+   * accents, matches the start of each word, or matches out of order.
+   *
+   * Absent, an option is kept where its words hold the filter, in any case. A
+   * property only, there being no way to write a function in markup. (property only)
    * - `items`: The options as data, for a list too long to draw whole: each a value,
    * which is also its words, or a record with a `value`, a `label` and
    * `disabled`. Set, the list draws only the options in sight, and the ones
@@ -77006,7 +77161,10 @@ export type CustomElementsSolidJs = {
    * Descendants rather than children, because a group puts a level between the
    * list and its options and the keyboard has to move through a grouped list
    * exactly as it moves through a flat one. (property only) (readonly)
-   * - `values`: The chosen values, as an array whether or not `multiple` is set. (property only) (readonly)
+   * - `values`: The chosen values, as an array whether or not `multiple` is set.
+   *
+   * Read against the options' values, so an option whose value holds a comma
+   * is one value. See `chosenValues`. (property only) (readonly)
    * - `validity`: Whether the control meets its constraints, and why not. (property only) (readonly)
    * - `validationMessage`: The message the browser would show for the control, or an empty string. (property only) (readonly)
    * - `willValidate`: Whether the control is checked when its form is submitted. (property only) (readonly)
@@ -78812,8 +78970,8 @@ export type CustomElementsSolidJs = {
    * rows, Home and End go to the first and the last, a typed letter moves to
    * the next row whose name starts with it, Enter and Space choose, Right Arrow
    * opens a row's submenu and Left Arrow goes back, the two swapping on a
-   * right-to-left page, and Escape closes the menu and returns focus to the
-   * trigger. Tab closes it and moves on.
+   * right-to-left page. Left Arrow on the top page does nothing. Escape closes
+   * the menu and returns focus to the trigger. Tab closes it and moves on.
    *
    * While it is open, the surface carries the trigger's width as
    * `--floating-anchor-inline-size` and the room left below it as
@@ -78957,6 +79115,10 @@ export type CustomElementsSolidJs = {
    * - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
    * - `mark`: A row on the current page has a checkbox or a link, so every row keeps the trailing column.
    * - `open`: While the menu is open.
+   * - `placed-bottom`: While the open panel sits below its trigger.
+   * - `placed-left`: While the open panel sits to the left of its trigger.
+   * - `placed-right`: While the open panel sits to the right of its trigger.
+   * - `placed-top`: While the open panel sits above its trigger.
    * - `start`: A row on the current page has content in its leading column, so every row keeps that column.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -79867,9 +80029,9 @@ export type CustomElementsSolidJs = {
    * The locale's group separators are read in every field, so `1,234` is a
    * number in `en-US`.
    *
-   * The field and its two buttons sit in a `role="group"`, and the field carries
-   * `role-label`, "number field" in English, as its `aria-roledescription`, as
-   * React Aria's NumberField does. On iOS and iPadOS the field is a plain text
+   * The field and its two buttons sit in a `role="group"` named by the label,
+   * and the field carries `role-label`, "number field" in English, as its
+   * `aria-roledescription`, as React Aria's NumberField does. On iOS and iPadOS the field is a plain text
    * field, with no `role="spinbutton"`, which VoiceOver reads as a slider you
    * cannot type in, and no role description, so VoiceOver says the field is
    * required. React Aria's NumberField does the same.
@@ -80048,8 +80210,11 @@ export type CustomElementsSolidJs = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
-   * - `valueAsNumber`: The value as a number, or `NaN` while the control is empty.
+   * - `valueAsNumber`: The value as a number, or `NaN` while the control is empty or does not
+   * hold a number.
    *
+   * Read in the locale and the format, as the form reads it, so `1,5` typed
+   * in a locale with a decimal comma is 1.5 here while the form holds 1.5.
    * `NaN` and not zero, which is the trap the platform already avoids: `Number('')`
    * is zero, so an empty control would report a number it does not hold and a
    * form would submit it. (property only)
@@ -83482,7 +83647,9 @@ export type CustomElementsSolidJs = {
    * whole set.
    *
    * `Select` owns the value, passes it down to the listbox, and takes changes
-   * back, so the value lives in one place.
+   * back, so the value lives in one place. With `multiple`, the value is the
+   * chosen values joined with commas, and the form receives one entry for each.
+   * An option's value may hold a comma, and it is read as one value.
    *
    * Set `valueContent` to draw the trigger's content from the chosen options,
    * and several chosen options are written as a list in the reader's language.
@@ -83862,7 +84029,8 @@ export type CustomElementsSolidJs = {
    * - `label`: What is loading, read out as the placeholder's name, such as "Loading
    * profile".
    *
-   * Absent hides the placeholder from screen readers.
+   * Absent hides the placeholder from screen readers. Around content, the name
+   * is read while `loading` is set, and the loaded content is read as it is.
    * - `loading`: Whether the content inside is still loading, which keeps it inert and
    * draws the placeholder over it.
    *