@fusion.dev/helix 0.171.0 → 0.172.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.171.0",
+  "version": "0.172.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.171.0",
-    "@fusion.dev/helix-headless": "0.171.0",
-    "@fusion.dev/helix-styles": "0.171.0"
+    "@fusion.dev/helix-core": "0.172.0",
+    "@fusion.dev/helix-headless": "0.172.0",
+    "@fusion.dev/helix-styles": "0.172.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.171.0",
-    "@fusion.dev/helix-testing": "0.171.0",
+    "@fusion.dev/helix-cem": "0.172.0",
+    "@fusion.dev/helix-testing": "0.172.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

@@ -6429,6 +6429,10 @@ export type HelixChatComposerHelixTypingElementEvent =
   HelixChatComposerElementEvent<HelixTypingEvent>;
 
 export type HelixChatComposerProps = {
+  /** A message about the draft, shown under the field. While set, the composer
+is invalid, does not send, and does not submit, as a field's `feedback`
+does, and the message is announced as it appears. */
+  feedback?: (HelixChatComposer["feedback"]) | undefined;
   /** The field's name, read by screen readers. */
   label?: (HelixChatComposer["label"]) | undefined;
   /** The most characters a draft can have. The field stops taking more. */
@@ -6515,6 +6519,10 @@ Here rather than on each control. */
 };
 
 export type HelixChatComposerSolidJsProps = {
+  /** A message about the draft, shown under the field. While set, the composer
+is invalid, does not send, and does not submit, as a field's `feedback`
+does, and the message is announced as it appears. */
+  "prop:feedback"?: (HelixChatComposer["feedback"]) | undefined;
   /** The field's name, read by screen readers. */
   "prop:label"?: (HelixChatComposer["label"]) | undefined;
   /** The most characters a draft can have. The field stops taking more. */
@@ -11356,7 +11364,11 @@ thousand rows, where the page is a reasonable fetch and a poor render.
 
 Off by default. Windowing costs a scroll listener, a measurement per row
 drawn, and a `block-size` on the scrolling box, and a table of twenty rows
-should pay none of them. */
+should pay none of them.
+
+While windowed, the `table` part scrolls on this tier: it carries
+`data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into
+every shadow root. You still need to give it a block size. */
   windowed?: (HelixDataTable["windowed"]) | undefined;
   /** Every row of the result, in the order it arrived.
 
@@ -11771,7 +11783,11 @@ thousand rows, where the page is a reasonable fetch and a poor render.
 
 Off by default. Windowing costs a scroll listener, a measurement per row
 drawn, and a `block-size` on the scrolling box, and a table of twenty rows
-should pay none of them. */
+should pay none of them.
+
+While windowed, the `table` part scrolls on this tier: it carries
+`data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into
+every shadow root. You still need to give it a block size. */
   "prop:windowed"?: (HelixDataTable["windowed"]) | undefined;
   /** Every row of the result, in the order it arrived.
 
@@ -23910,6 +23926,14 @@ or on Alt+Down or Alt+Up. */
 
 It moves if that side does not fit. */
   placement?: (HelixMenu["placement"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  "results-label"?: (HelixMenu["resultsLabel"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  resultsLabel?: (HelixMenu["resultsLabel"]) | undefined;
   /** How a submenu opens. `drill` shows it in place of the page showing, with
 a way back. `flyout` opens it in a panel of its own beside its row. */
   submenus?: (HelixMenu["submenus"]) | undefined;
@@ -23920,9 +23944,19 @@ Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
 Absent, a row 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?: (HelixMenu["filterMatch"]) | undefined;
+  /** The values of the choice rows that are checked, anywhere in the menu, in
+document order.
+
+Set it to check exactly those rows and uncheck every other choice row, as
+React Aria's `selectedKeys` controls a menu's selection from one place.
+Each row keeps its own `checked` too, which this reads and writes. `change`
+is sent on the menu when a reader's choice changes it. */
+  checkedValues?: (HelixMenu["checkedValues"]) | undefined;
 
   /** The menu opened or closed. The event carries `newState` and `oldState`. */
   ontoggle?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
+  /** A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now. */
+  onchange?: ((e: HelixMenuElementEvent) => void) | undefined;
   /** The menu is about to close. Cancelable: cancel it to keep it open. */
   "onhelix-before-close"?: ((e: HelixMenuHelixBeforeCloseElementEvent) => void) | undefined;
   /** The menu is about to open. Cancelable: cancel it to keep it closed. */
@@ -24026,6 +24060,14 @@ or on Alt+Down or Alt+Up. */
 
 It moves if that side does not fit. */
   "prop:placement"?: (HelixMenu["placement"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  "attr:results-label"?: (HelixMenu["resultsLabel"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  "prop:resultsLabel"?: (HelixMenu["resultsLabel"]) | undefined;
   /** How a submenu opens. `drill` shows it in place of the page showing, with
 a way back. `flyout` opens it in a panel of its own beside its row. */
   "prop:submenus"?: (HelixMenu["submenus"]) | undefined;
@@ -24036,8 +24078,18 @@ Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
 Absent, a row 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"?: (HelixMenu["filterMatch"]) | undefined;
+  /** The values of the choice rows that are checked, anywhere in the menu, in
+document order.
+
+Set it to check exactly those rows and uncheck every other choice row, as
+React Aria's `selectedKeys` controls a menu's selection from one place.
+Each row keeps its own `checked` too, which this reads and writes. `change`
+is sent on the menu when a reader's choice changes it. */
+  "prop:checkedValues"?: (HelixMenu["checkedValues"]) | undefined;
   /** The menu opened or closed. The event carries `newState` and `oldState`. */
   "on:toggle"?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
+  /** A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now. */
+  "on:change"?: ((e: HelixMenuElementEvent) => void) | undefined;
   /** The menu is about to close. Cancelable: cancel it to keep it open. */
   "on:helix-before-close"?: ((e: HelixMenuHelixBeforeCloseElementEvent) => void) | undefined;
   /** The menu is about to open. Cancelable: cancel it to keep it closed. */
@@ -27563,17 +27615,42 @@ 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?: (HelixPopover["open"]) | undefined;
+  /** The element the panel opens against, where that is not the trigger: its
+`id` in the same document or shadow root, or the element itself. Left
+empty, the panel opens against the trigger, or against the button whose
+command opened it. */
+  anchor?: (HelixPopover["anchor"]) | undefined;
   /** Draws a point on the panel's edge facing the trigger.
 
 Off by default, which is the house style: a panel that opens from its
 trigger already reads as belonging to it. */
   arrow?: (HelixPopover["arrow"]) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  "container-padding"?: (HelixPopover["containerPadding"] | `${number}`) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  containerPadding?: (HelixPopover["containerPadding"]) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  "cross-offset"?: (HelixPopover["crossOffset"] | `${number}`) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  crossOffset?: (HelixPopover["crossOffset"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   "fallback-label"?: (HelixPopover["fallbackLabel"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   fallbackLabel?: (HelixPopover["fallbackLabel"]) | undefined;
+  /** Whether the panel moves to the other side of the trigger when its own
+side has no room. On by default. Write `flip="false"` to keep it on its
+side, where it shrinks to fit, as React Aria's `shouldFlip` turns off. */
+  flip?: (HelixPopover["flip"]) | undefined;
   /** The panel's name, read by screen readers. Left empty, the first heading in
 the panel names it, and then `fallback-label`. */
   label?: (HelixPopover["label"]) | undefined;
@@ -27627,17 +27704,42 @@ 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"?: (HelixPopover["open"]) | undefined;
+  /** The element the panel opens against, where that is not the trigger: its
+`id` in the same document or shadow root, or the element itself. Left
+empty, the panel opens against the trigger, or against the button whose
+command opened it. */
+  "prop:anchor"?: (HelixPopover["anchor"]) | undefined;
   /** Draws a point on the panel's edge facing the trigger.
 
 Off by default, which is the house style: a panel that opens from its
 trigger already reads as belonging to it. */
   "prop:arrow"?: (HelixPopover["arrow"]) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  "attr:container-padding"?: (HelixPopover["containerPadding"] | `${number}`) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  "prop:containerPadding"?: (HelixPopover["containerPadding"]) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  "attr:cross-offset"?: (HelixPopover["crossOffset"] | `${number}`) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  "prop:crossOffset"?: (HelixPopover["crossOffset"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   "attr:fallback-label"?: (HelixPopover["fallbackLabel"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   "prop:fallbackLabel"?: (HelixPopover["fallbackLabel"]) | undefined;
+  /** Whether the panel moves to the other side of the trigger when its own
+side has no room. On by default. Write `flip="false"` to keep it on its
+side, where it shrinks to fit, as React Aria's `shouldFlip` turns off. */
+  "prop:flip"?: (HelixPopover["flip"]) | undefined;
   /** The panel's name, read by screen readers. Left empty, the first heading in
 the panel names it, and then `fallback-label`. */
   "prop:label"?: (HelixPopover["label"]) | undefined;
@@ -45432,6 +45534,9 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `feedback`: A message about the draft, shown under the field. While set, the composer
+   * is invalid, does not send, and does not submit, as a field's `feedback`
+   * does, and the message is announced as it appears.
    * - `label`: The field's name, read by screen readers.
    * - `maxlength`/`maxLength`: The most characters a draft can have. The field stops taking more.
    * - `minlength`/`minLength`: The fewest characters a draft can have, once the reader has written in
@@ -45597,6 +45702,7 @@ export type CustomElements = {
    * - `tools`: The row under the field.
    * - `composer`: The whole composer.
    * - `end`: The box around the `end` slot.
+   * - `feedback`: The `feedback` message, under the field while it is set.
    * - `mark`: The icon inside the send button.
    * - `start`: The box around the `start` slot.
    *
@@ -45604,7 +45710,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
-   * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it.
+   * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it. Or `feedback` is set.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-chat-composer": Partial<
@@ -48628,6 +48734,10 @@ export type CustomElements = {
    * Off by default. Windowing costs a scroll listener, a measurement per row
    * drawn, and a `block-size` on the scrolling box, and a table of twenty rows
    * should pay none of them.
+   *
+   * While windowed, the `table` part scrolls on this tier: it carries
+   * `data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into
+   * every shadow root. You still need to give it a block size.
    * - `rows`: Every row of the result, in the order it arrived.
    *
    * A property and not an attribute: it is an array. Left alone this element
@@ -57293,6 +57403,8 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `checked`: The row is checked.
+   * - `disabled`: The row is disabled.
+   * - `expanded`: Under `submenus="flyout"`, the row's submenu is open beside it.
    * - `highlighted`: In a menu with `filterable`, the arrow keys or the pointer reached the row while focus stays in the filter field.
    * - `submenu-mark`: Under `submenus="flyout"`, a row in this row's submenu can be ticked or opens a submenu, so the submenu keeps its trailing column.
    * - `submenu-start`: Under `submenus="flyout"`, a row in this row's submenu has content before its label, so the submenu keeps its leading column.
@@ -57363,6 +57475,9 @@ export type CustomElements = {
    * - `placement`: The side the menu opens on, when there is room.
    *
    * It moves if that side does not fit.
+   * - `results-label`/`resultsLabel`: What a screen reader hears when the filter narrows the rows. `{count}` is
+   * how many rows are left, written in the locale, and each language writes
+   * the forms it has, as Listbox's `results-label` does.
    * - `submenus`: How a submenu opens. `drill` shows it in place of the page showing, with
    * a way back. `flyout` opens it in a panel of its own beside its row.
    * - `filterMatch`: Whether a row is kept by the filter: a function given the row's words and
@@ -57371,6 +57486,13 @@ export type CustomElements = {
    *
    * Absent, a row 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)
+   * - `checkedValues`: The values of the choice rows that are checked, anywhere in the menu, in
+   * document order.
+   *
+   * Set it to check exactly those rows and uncheck every other choice row, as
+   * React Aria's `selectedKeys` controls a menu's selection from one place.
+   * Each row keeps its own `checked` too, which this reads and writes. `change`
+   * is sent on the menu when a reader's choice changes it. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -57397,6 +57519,7 @@ export type CustomElements = {
    * Events that will be emitted by the component.
    *
    * - `toggle`: The menu opened or closed. The event carries `newState` and `oldState`.
+   * - `change`: A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now.
    * - `helix-before-close`: The menu is about to close. Cancelable: cancel it to keep it open.
    * - `helix-before-open`: The menu is about to open. Cancelable: cancel it to keep it closed.
    * - `helix-filter`: The text in the filter field changed, with the new text in `detail.value`. Cancelable: cancel it to keep every row showing and narrow the rows yourself.
@@ -57407,6 +57530,8 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The items.
+   * - `empty`: What the menu shows when it has no items, for content richer than `empty-text`.
+   * - `loading`: What the menu shows while its items load, for content richer than `loading-text`.
    * - `no-results`: What the menu shows when the filter keeps no rows, for content richer than `no-results-text`.
    * - `trigger`: The control that opens the menu, or with `context` the area a context menu opens over.
    *
@@ -57458,6 +57583,8 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
+   * - `entering`: From the moment the panel shows until its entrance has finished.
+   * - `exiting`: From the moment the panel hides until its exit has finished.
    * - `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.
@@ -60319,12 +60446,25 @@ 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.
+   * - `anchor`: The element the panel opens against, where that is not the trigger: its
+   * `id` in the same document or shadow root, or the element itself. Left
+   * empty, the panel opens against the trigger, or against the button whose
+   * command opened it.
    * - `arrow`: Draws a point on the panel's edge facing the trigger.
    *
    * Off by default, which is the house style: a panel that opens from its
    * trigger already reads as belonging to it.
+   * - `container-padding`/`containerPadding`: How close to the window's edges the panel may come, in pixels, when it
+   * slides, shrinks or moves to the other side to fit. Left unset, it slides
+   * and shrinks to 8 pixels from an edge and moves to the other side only
+   * once it would cross one.
+   * - `cross-offset`/`crossOffset`: How far to slide the panel along the side it is on, in pixels: to the
+   * right on the top or the bottom, and down on the left or the right.
    * - `fallback-label`/`fallbackLabel`: The panel's name where nothing else names it: no `label`, no heading in
    * the panel, and no `aria-labelledby` on the host.
+   * - `flip`: Whether the panel moves to the other side of the trigger when its own
+   * side has no room. On by default. Write `flip="false"` to keep it on its
+   * side, where it shrinks to fit, as React Aria's `shouldFlip` turns off.
    * - `label`: The panel's name, read by screen readers. Left empty, the first heading in
    * the panel names it, and then `fallback-label`.
    * - `modal`: Keeps `Tab` inside the panel while it is open, marks the panel
@@ -60416,6 +60556,8 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `aligned-end`: While the panel is aligned to the end of the side it sits on.
+   * - `aligned-start`: While the panel is aligned to the start of the side it sits on.
    * - `entering`: From the moment the panel shows until its entrance has finished.
    * - `exiting`: From the moment the panel hides until its exit has finished.
    * - `open`: While the popover is open.
@@ -66792,6 +66934,10 @@ export type CustomElements = {
    * along, so the two writes a consumer would make in sequence do not compose
    * into the range they asked for. The platform has this method for that reason
    * and so does this.
+   * - `setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void`: Replaces a range of the text, as the native method does: the selection
+   * where `start` and `end` are left out, and `selectMode` says what is
+   * selected after. It sends no event, as the native method sends none.
+   * - `select() => void`: Selects everything in the field.
    * - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
    * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
    *
@@ -74781,6 +74927,9 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `feedback`: A message about the draft, shown under the field. While set, the composer
+   * is invalid, does not send, and does not submit, as a field's `feedback`
+   * does, and the message is announced as it appears.
    * - `label`: The field's name, read by screen readers.
    * - `maxlength`/`maxLength`: The most characters a draft can have. The field stops taking more.
    * - `minlength`/`minLength`: The fewest characters a draft can have, once the reader has written in
@@ -74946,6 +75095,7 @@ export type CustomElementsSolidJs = {
    * - `tools`: The row under the field.
    * - `composer`: The whole composer.
    * - `end`: The box around the `end` slot.
+   * - `feedback`: The `feedback` message, under the field while it is set.
    * - `mark`: The icon inside the send button.
    * - `start`: The box around the `start` slot.
    *
@@ -74953,7 +75103,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
-   * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it.
+   * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it. Or `feedback` is set.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-chat-composer": Partial<
@@ -78011,6 +78161,10 @@ export type CustomElementsSolidJs = {
    * Off by default. Windowing costs a scroll listener, a measurement per row
    * drawn, and a `block-size` on the scrolling box, and a table of twenty rows
    * should pay none of them.
+   *
+   * While windowed, the `table` part scrolls on this tier: it carries
+   * `data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into
+   * every shadow root. You still need to give it a block size.
    * - `rows`: Every row of the result, in the order it arrived.
    *
    * A property and not an attribute: it is an array. Left alone this element
@@ -86820,6 +86974,8 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `checked`: The row is checked.
+   * - `disabled`: The row is disabled.
+   * - `expanded`: Under `submenus="flyout"`, the row's submenu is open beside it.
    * - `highlighted`: In a menu with `filterable`, the arrow keys or the pointer reached the row while focus stays in the filter field.
    * - `submenu-mark`: Under `submenus="flyout"`, a row in this row's submenu can be ticked or opens a submenu, so the submenu keeps its trailing column.
    * - `submenu-start`: Under `submenus="flyout"`, a row in this row's submenu has content before its label, so the submenu keeps its leading column.
@@ -86893,6 +87049,9 @@ export type CustomElementsSolidJs = {
    * - `placement`: The side the menu opens on, when there is room.
    *
    * It moves if that side does not fit.
+   * - `results-label`/`resultsLabel`: What a screen reader hears when the filter narrows the rows. `{count}` is
+   * how many rows are left, written in the locale, and each language writes
+   * the forms it has, as Listbox's `results-label` does.
    * - `submenus`: How a submenu opens. `drill` shows it in place of the page showing, with
    * a way back. `flyout` opens it in a panel of its own beside its row.
    * - `filterMatch`: Whether a row is kept by the filter: a function given the row's words and
@@ -86901,6 +87060,13 @@ export type CustomElementsSolidJs = {
    *
    * Absent, a row 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)
+   * - `checkedValues`: The values of the choice rows that are checked, anywhere in the menu, in
+   * document order.
+   *
+   * Set it to check exactly those rows and uncheck every other choice row, as
+   * React Aria's `selectedKeys` controls a menu's selection from one place.
+   * Each row keeps its own `checked` too, which this reads and writes. `change`
+   * is sent on the menu when a reader's choice changes it. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -86927,6 +87093,7 @@ export type CustomElementsSolidJs = {
    * Events that will be emitted by the component.
    *
    * - `toggle`: The menu opened or closed. The event carries `newState` and `oldState`.
+   * - `change`: A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now.
    * - `helix-before-close`: The menu is about to close. Cancelable: cancel it to keep it open.
    * - `helix-before-open`: The menu is about to open. Cancelable: cancel it to keep it closed.
    * - `helix-filter`: The text in the filter field changed, with the new text in `detail.value`. Cancelable: cancel it to keep every row showing and narrow the rows yourself.
@@ -86937,6 +87104,8 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The items.
+   * - `empty`: What the menu shows when it has no items, for content richer than `empty-text`.
+   * - `loading`: What the menu shows while its items load, for content richer than `loading-text`.
    * - `no-results`: What the menu shows when the filter keeps no rows, for content richer than `no-results-text`.
    * - `trigger`: The control that opens the menu, or with `context` the area a context menu opens over.
    *
@@ -86988,6 +87157,8 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `drilled`: A submenu's page is showing, so content that is not a row can hide with the top page.
+   * - `entering`: From the moment the panel shows until its entrance has finished.
+   * - `exiting`: From the moment the panel hides until its exit has finished.
    * - `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.
@@ -89903,12 +90074,25 @@ 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.
+   * - `anchor`: The element the panel opens against, where that is not the trigger: its
+   * `id` in the same document or shadow root, or the element itself. Left
+   * empty, the panel opens against the trigger, or against the button whose
+   * command opened it.
    * - `arrow`: Draws a point on the panel's edge facing the trigger.
    *
    * Off by default, which is the house style: a panel that opens from its
    * trigger already reads as belonging to it.
+   * - `container-padding`/`containerPadding`: How close to the window's edges the panel may come, in pixels, when it
+   * slides, shrinks or moves to the other side to fit. Left unset, it slides
+   * and shrinks to 8 pixels from an edge and moves to the other side only
+   * once it would cross one.
+   * - `cross-offset`/`crossOffset`: How far to slide the panel along the side it is on, in pixels: to the
+   * right on the top or the bottom, and down on the left or the right.
    * - `fallback-label`/`fallbackLabel`: The panel's name where nothing else names it: no `label`, no heading in
    * the panel, and no `aria-labelledby` on the host.
+   * - `flip`: Whether the panel moves to the other side of the trigger when its own
+   * side has no room. On by default. Write `flip="false"` to keep it on its
+   * side, where it shrinks to fit, as React Aria's `shouldFlip` turns off.
    * - `label`: The panel's name, read by screen readers. Left empty, the first heading in
    * the panel names it, and then `fallback-label`.
    * - `modal`: Keeps `Tab` inside the panel while it is open, marks the panel
@@ -90000,6 +90184,8 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `aligned-end`: While the panel is aligned to the end of the side it sits on.
+   * - `aligned-start`: While the panel is aligned to the start of the side it sits on.
    * - `entering`: From the moment the panel shows until its entrance has finished.
    * - `exiting`: From the moment the panel hides until its exit has finished.
    * - `open`: While the popover is open.
@@ -96501,6 +96687,10 @@ export type CustomElementsSolidJs = {
    * along, so the two writes a consumer would make in sequence do not compose
    * into the range they asked for. The platform has this method for that reason
    * and so does this.
+   * - `setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void`: Replaces a range of the text, as the native method does: the selection
+   * where `start` and `end` are left out, and `selectMode` says what is
+   * selected after. It sends no event, as the native method sends none.
+   * - `select() => void`: Selects everything in the field.
    * - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
    * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
    *

package/types/vue.d.ts

@@ -3318,6 +3318,10 @@ export type HelixChatComposerHelixTypingElementEvent =
   HelixChatComposerElementEvent<HelixTypingEvent>;
 
 export type HelixChatComposerVueProps = {
+  /** A message about the draft, shown under the field. While set, the composer
+is invalid, does not send, and does not submit, as a field's `feedback`
+does, and the message is announced as it appears. */
+  feedback?: (HelixChatComposer["feedback"]) | undefined;
   /** The field's name, read by screen readers. */
   label?: (HelixChatComposer["label"]) | undefined;
   /** The most characters a draft can have. The field stops taking more. */
@@ -6037,7 +6041,11 @@ thousand rows, where the page is a reasonable fetch and a poor render.
 
 Off by default. Windowing costs a scroll listener, a measurement per row
 drawn, and a `block-size` on the scrolling box, and a table of twenty rows
-should pay none of them. */
+should pay none of them.
+
+While windowed, the `table` part scrolls on this tier: it carries
+`data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into
+every shadow root. You still need to give it a block size. */
   windowed?: (HelixDataTable["windowed"]) | undefined;
   /** Every row of the result, in the order it arrived.
 
@@ -12316,6 +12324,14 @@ or on Alt+Down or Alt+Up. */
 
 It moves if that side does not fit. */
   placement?: (HelixMenu["placement"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  "results-label"?: (HelixMenu["resultsLabel"]) | undefined;
+  /** What a screen reader hears when the filter narrows the rows. `{count}` is
+how many rows are left, written in the locale, and each language writes
+the forms it has, as Listbox's `results-label` does. */
+  resultsLabel?: (HelixMenu["resultsLabel"]) | undefined;
   /** How a submenu opens. `drill` shows it in place of the page showing, with
 a way back. `flyout` opens it in a panel of its own beside its row. */
   submenus?: (HelixMenu["submenus"]) | undefined;
@@ -12326,11 +12342,21 @@ Aria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.
 Absent, a row 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?: (HelixMenu["filterMatch"]) | undefined;
+  /** The values of the choice rows that are checked, anywhere in the menu, in
+document order.
+
+Set it to check exactly those rows and uncheck every other choice row, as
+React Aria's `selectedKeys` controls a menu's selection from one place.
+Each row keeps its own `checked` too, which this reads and writes. `change`
+is sent on the menu when a reader's choice changes it. */
+  checkedValues?: (HelixMenu["checkedValues"]) | undefined;
 };
 
 export type HelixMenuVueEvents = {
   /** The menu opened or closed. The event carries `newState` and `oldState`. */
   toggle: HelixMenuToggleElementEvent;
+  /** A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now. */
+  change: HelixMenuElementEvent;
   /** The menu is about to close. Cancelable: cancel it to keep it open. */
   "helix-before-close": HelixMenuHelixBeforeCloseElementEvent;
   /** The menu is about to open. Cancelable: cancel it to keep it closed. */
@@ -14156,17 +14182,42 @@ 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?: (HelixPopover["open"]) | undefined;
+  /** The element the panel opens against, where that is not the trigger: its
+`id` in the same document or shadow root, or the element itself. Left
+empty, the panel opens against the trigger, or against the button whose
+command opened it. */
+  anchor?: (HelixPopover["anchor"]) | undefined;
   /** Draws a point on the panel's edge facing the trigger.
 
 Off by default, which is the house style: a panel that opens from its
 trigger already reads as belonging to it. */
   arrow?: (HelixPopover["arrow"]) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  "container-padding"?: (HelixPopover["containerPadding"] | `${number}`) | undefined;
+  /** How close to the window's edges the panel may come, in pixels, when it
+slides, shrinks or moves to the other side to fit. Left unset, it slides
+and shrinks to 8 pixels from an edge and moves to the other side only
+once it would cross one. */
+  containerPadding?: (HelixPopover["containerPadding"]) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  "cross-offset"?: (HelixPopover["crossOffset"] | `${number}`) | undefined;
+  /** How far to slide the panel along the side it is on, in pixels: to the
+right on the top or the bottom, and down on the left or the right. */
+  crossOffset?: (HelixPopover["crossOffset"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   "fallback-label"?: (HelixPopover["fallbackLabel"]) | undefined;
   /** The panel's name where nothing else names it: no `label`, no heading in
 the panel, and no `aria-labelledby` on the host. */
   fallbackLabel?: (HelixPopover["fallbackLabel"]) | undefined;
+  /** Whether the panel moves to the other side of the trigger when its own
+side has no room. On by default. Write `flip="false"` to keep it on its
+side, where it shrinks to fit, as React Aria's `shouldFlip` turns off. */
+  flip?: (HelixPopover["flip"]) | undefined;
   /** The panel's name, read by screen readers. Left empty, the first heading in
 the panel names it, and then `fallback-label`. */
   label?: (HelixPopover["label"]) | undefined;