@fusion.dev/helix 0.157.0 → 0.158.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.157.0",
+  "version": "0.158.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -54,13 +54,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.157.0",
-    "@fusion.dev/helix-headless": "0.157.0",
-    "@fusion.dev/helix-styles": "0.157.0"
+    "@fusion.dev/helix-core": "0.158.0",
+    "@fusion.dev/helix-headless": "0.158.0",
+    "@fusion.dev/helix-styles": "0.158.0"
   },
   "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

@@ -10051,6 +10051,13 @@ how many are left, written in the locale, and each language writes the
 forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
 {# poleceń} other {# polecenia}}`. */
   resultsLabel?: (HelixCommand["resultsLabel"]) | 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?: (HelixCommand["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
@@ -10176,6 +10183,13 @@ how many are left, written in the locale, and each language writes the
 forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
 {# poleceń} other {# polecenia}}`. */
   "prop:resultsLabel"?: (HelixCommand["resultsLabel"]) | 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"?: (HelixCommand["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
@@ -19988,7 +20002,9 @@ Not reflected, as a state never is. `row-current` is the part a
 stylesheet draws it from. */
   current?: (HelixListItem["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?: (HelixListItem["disabled"]) | undefined;
   /** The URL the row links to. Leave it empty for a row that is not a link.
 
@@ -20024,6 +20040,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?: (HelixListItem["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?: (HelixListItem["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: HelixListItemHelixActionElementEvent) => void) | undefined;
@@ -20039,7 +20059,9 @@ Not reflected, as a state never is. `row-current` is the part a
 stylesheet draws it from. */
   "prop:current"?: (HelixListItem["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"?: (HelixListItem["disabled"]) | undefined;
   /** The URL the row links to. Leave it empty for a row that is not a link.
 
@@ -20075,6 +20097,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"?: (HelixListItem["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"?: (HelixListItem["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: HelixListItemHelixActionElementEvent) => void) | undefined;
 
@@ -20126,6 +20152,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?: (HelixList["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"?: (HelixList["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?: (HelixList["disabledBehavior"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
   "dropped-label"?: (HelixList["droppedLabel"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
@@ -20273,6 +20313,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"?: (HelixList["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"?: (HelixList["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"?: (HelixList["disabledBehavior"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
   "attr:dropped-label"?: (HelixList["droppedLabel"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
@@ -20663,6 +20717,14 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixListbox["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?: (HelixListbox["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
@@ -20955,6 +21017,14 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   "prop:name"?: (HelixListbox["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"?: (HelixListbox["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
@@ -24386,8 +24456,11 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixNumberInput["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. */
@@ -24661,8 +24734,11 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   "prop:name"?: (HelixNumberInput["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. */
@@ -30009,7 +30085,8 @@ control height until you size it, with a height on the element or
   /** 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?: (HelixSkeleton["label"]) | undefined;
   /** Whether the content inside is still loading, which keeps it inert and
 draws the placeholder over it.
@@ -30039,7 +30116,8 @@ control height until you size it, with a height on the element or
   /** 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"?: (HelixSkeleton["label"]) | undefined;
   /** Whether the content inside is still loading, which keeps it inert and
 draws the placeholder over it.
@@ -46058,6 +46136,12 @@ export type CustomElements = {
    * how many are left, written in the locale, and each language writes the
    * forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
    * {# poleceń} other {# polecenia}}`.
+   * - `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
@@ -46156,6 +46240,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
    *
@@ -52997,7 +53082,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
@@ -53024,6 +53111,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.
    *
@@ -53101,6 +53191,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.
    */
@@ -53133,6 +53224,12 @@ export type CustomElements = {
    * `unordered` too, where it numbers what a bullet did not.
    * - `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.
@@ -53432,6 +53529,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
@@ -53468,7 +53572,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)
@@ -55301,6 +55408,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.
    */
@@ -56351,8 +56462,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)
@@ -60796,7 +60910,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.
    *
@@ -74542,6 +74657,12 @@ export type CustomElementsSolidJs = {
    * how many are left, written in the locale, and each language writes the
    * forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
    * {# poleceń} other {# polecenia}}`.
+   * - `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
@@ -74640,6 +74761,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
    *
@@ -81585,7 +81707,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
@@ -81612,6 +81736,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.
    *
@@ -81689,6 +81816,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.
    */
@@ -81724,6 +81852,12 @@ export type CustomElementsSolidJs = {
    * `unordered` too, where it numbers what a bullet did not.
    * - `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.
@@ -82025,6 +82159,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
@@ -82061,7 +82202,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)
@@ -83938,6 +84082,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.
    */
@@ -85010,8 +85158,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)
@@ -89539,7 +89690,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.
    *

package/types/vue.d.ts

@@ -5211,6 +5211,13 @@ how many are left, written in the locale, and each language writes the
 forms it has: `{count, plural, one {# polecenie} few {# polecenia} many
 {# poleceń} other {# polecenia}}`. */
   resultsLabel?: (HelixCommand["resultsLabel"]) | 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?: (HelixCommand["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
@@ -10237,7 +10244,9 @@ Not reflected, as a state never is. `row-current` is the part a
 stylesheet draws it from. */
   current?: (HelixListItem["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?: (HelixListItem["disabled"]) | undefined;
   /** The URL the row links to. Leave it empty for a row that is not a link.
 
@@ -10273,6 +10282,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?: (HelixListItem["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?: (HelixListItem["selectionOnly"]) | undefined;
 };
 
 export type HelixListItemVueEvents = {
@@ -10322,6 +10335,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?: (HelixList["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"?: (HelixList["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?: (HelixList["disabledBehavior"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
   "dropped-label"?: (HelixList["droppedLabel"]) | undefined;
   /** What screen readers hear when a row is dropped, in a `reorderable` list. */
@@ -10706,6 +10733,14 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixListbox["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?: (HelixListbox["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
@@ -12643,8 +12678,11 @@ imperatively later, and nothing is hydrating by then.
 
 Here rather than on each control. */
   name?: (HelixNumberInput["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. */
@@ -15407,7 +15445,8 @@ control height until you size it, with a height on the element or
   /** 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?: (HelixSkeleton["label"]) | undefined;
   /** Whether the content inside is still loading, which keeps it inert and
 draws the placeholder over it.