@fusion.dev/helix-headless 0.156.0 → 0.157.0

package/types/jsx.d.ts

@@ -12308,6 +12308,16 @@ export type HelixHeadlessDrilldownItemHelixSelectElementEvent =
 export type HelixHeadlessDrilldownItemProps = {
   /** Whether the row can be reached at all. */
   disabled?: (HelixHeadlessDrilldownItem["disabled"]) | undefined;
+  /** Whether the link downloads the file when the row is chosen. Only
+meaningful beside an `href`, and only for a file served from this origin. */
+  download?: (HelixHeadlessDrilldownItem["download"]) | undefined;
+  /** The URL the row links to. Setting it renders the row as a link, unless the
+row opens a page or is disabled. */
+  href?: (HelixHeadlessDrilldownItem["href"]) | undefined;
+  /** The link's `rel`. Set it whenever you set `target="_blank"`. */
+  rel?: (HelixHeadlessDrilldownItem["rel"]) | undefined;
+  /** Where the link opens, for rows that should open outside the current page. */
+  target?: (HelixHeadlessDrilldownItem["target"]) | undefined;
   /** Identifies the row to your event listeners. */
   value?: (HelixHeadlessDrilldownItem["value"]) | undefined;
   /** Whether this row holds the region's tab stop. Set by the drill-down.
@@ -12332,6 +12342,16 @@ lands inside this shadow root instead. */
 export type HelixHeadlessDrilldownItemSolidJsProps = {
   /** Whether the row can be reached at all. */
   "prop:disabled"?: (HelixHeadlessDrilldownItem["disabled"]) | undefined;
+  /** Whether the link downloads the file when the row is chosen. Only
+meaningful beside an `href`, and only for a file served from this origin. */
+  "prop:download"?: (HelixHeadlessDrilldownItem["download"]) | undefined;
+  /** The URL the row links to. Setting it renders the row as a link, unless the
+row opens a page or is disabled. */
+  "prop:href"?: (HelixHeadlessDrilldownItem["href"]) | undefined;
+  /** The link's `rel`. Set it whenever you set `target="_blank"`. */
+  "prop:rel"?: (HelixHeadlessDrilldownItem["rel"]) | undefined;
+  /** Where the link opens, for rows that should open outside the current page. */
+  "prop:target"?: (HelixHeadlessDrilldownItem["target"]) | undefined;
   /** Identifies the row to your event listeners. */
   "prop:value"?: (HelixHeadlessDrilldownItem["value"]) | undefined;
   /** Whether this row holds the region's tab stop. Set by the drill-down.
@@ -12362,6 +12382,9 @@ export type HelixHeadlessDrilldownElementEvent<E = Event> = TypedEvent<
   HelixHeadlessDrilldown,
   E
 >;
+/** `helix-navigate` event type */
+export type HelixHeadlessDrilldownHelixNavigateElementEvent =
+  HelixHeadlessDrilldownElementEvent<HelixNavigateEvent>;
 /** `helix-select` event type */
 export type HelixHeadlessDrilldownHelixSelectElementEvent =
   HelixHeadlessDrilldownElementEvent<HelixSelectEvent>;
@@ -12377,6 +12400,14 @@ and wins over this. */
   "back-label"?: (HelixHeadlessDrilldown["backLabel"]) | undefined;
   /** The text of the back button. */
   backLabel?: (HelixHeadlessDrilldown["backLabel"]) | undefined;
+  /** Whether the drilldown is a site's navigation: a `navigation` landmark
+named by `label`, whose pages are lists of links. Without it, each page is
+a `menu`. */
+  navigation?: (HelixHeadlessDrilldown["navigation"]) | undefined;
+  /** The page showing, as the `value` of the row that opens it. Empty is the
+top page. Setting it shows that page, and a value no row with a page has
+shows the top page. */
+  page?: (HelixHeadlessDrilldown["page"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
   "empty-text"?: (HelixHeadlessDrilldown["emptyText"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
@@ -12392,6 +12423,10 @@ say that without the component knowing what a row looks like. */
   /** The text shown and announced while the rows load. */
   loadingText?: (HelixHeadlessDrilldown["loadingText"]) | undefined;
 
+  /** Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing. */
+  "onhelix-navigate"?: ((
+    e: HelixHeadlessDrilldownHelixNavigateElementEvent,
+  ) => void) | undefined;
   /** Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
   "onhelix-select"?: ((e: HelixHeadlessDrilldownHelixSelectElementEvent) => void) | undefined;
 };
@@ -12407,6 +12442,14 @@ and wins over this. */
   "attr:back-label"?: (HelixHeadlessDrilldown["backLabel"]) | undefined;
   /** The text of the back button. */
   "prop:backLabel"?: (HelixHeadlessDrilldown["backLabel"]) | undefined;
+  /** Whether the drilldown is a site's navigation: a `navigation` landmark
+named by `label`, whose pages are lists of links. Without it, each page is
+a `menu`. */
+  "prop:navigation"?: (HelixHeadlessDrilldown["navigation"]) | undefined;
+  /** The page showing, as the `value` of the row that opens it. Empty is the
+top page. Setting it shows that page, and a value no row with a page has
+shows the top page. */
+  "prop:page"?: (HelixHeadlessDrilldown["page"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
   "attr:empty-text"?: (HelixHeadlessDrilldown["emptyText"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
@@ -12421,6 +12464,10 @@ say that without the component knowing what a row looks like. */
   "attr:loading-text"?: (HelixHeadlessDrilldown["loadingText"]) | undefined;
   /** The text shown and announced while the rows load. */
   "prop:loadingText"?: (HelixHeadlessDrilldown["loadingText"]) | undefined;
+  /** Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing. */
+  "on:helix-navigate"?: ((
+    e: HelixHeadlessDrilldownHelixNavigateElementEvent,
+  ) => void) | undefined;
   /** Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
   "on:helix-select"?: ((
     e: HelixHeadlessDrilldownHelixSelectElementEvent,
@@ -19855,8 +19902,24 @@ narrow exception the server specs describe covers a mirror that can only
 become true long after hydration, and a viewport measured before the first
 paint is the opposite case. See `MixinControllerOpen` on `open`. */
   bandBelow?: (HelixHeadlessMegamenu["bandBelow"]) | undefined;
+  /** How long a pointer leaving the trigger and the panel waits before the panel
+closes, in milliseconds. The pointer needs the time to cross from the
+trigger to the panel. */
+  "close-delay"?: (HelixHeadlessMegamenu["closeDelay"] | `${number}`) | undefined;
+  /** How long a pointer leaving the trigger and the panel waits before the panel
+closes, in milliseconds. The pointer needs the time to cross from the
+trigger to the panel. */
+  closeDelay?: (HelixHeadlessMegamenu["closeDelay"]) | undefined;
   /** The section's name, used for the default trigger and the panel. */
   label?: (HelixHeadlessMegamenu["label"]) | undefined;
+  /** How long a pointer rests on the trigger before the panel opens, in
+milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+way somewhere else opens nothing. */
+  "open-delay"?: (HelixHeadlessMegamenu["openDelay"] | `${number}`) | undefined;
+  /** How long a pointer rests on the trigger before the panel opens, in
+milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+way somewhere else opens nothing. */
+  openDelay?: (HelixHeadlessMegamenu["openDelay"]) | undefined;
   /** Whether hovering over the trigger opens the panel (`hover`), or only a press
 does (`click`).
 
@@ -19873,6 +19936,10 @@ the trigger, and it is the default because that is what a navigation bar
 does. `click` is for a trigger that does something else as well, or a panel
 heavy enough that opening it on the way past is rude. */
   openOn?: (HelixHeadlessMegamenu["openOn"]) | undefined;
+  /** The side of the trigger a card panel opens on, when there is room. It
+moves if that side does not fit. A band ignores it, since a band spans the
+page under its bar. */
+  placement?: (HelixHeadlessMegamenu["placement"]) | undefined;
   /** Whether the panel is a card under the trigger or a band across the page.
 
 The resting one is the card, hanging off the trigger and as wide as it
@@ -19975,8 +20042,24 @@ narrow exception the server specs describe covers a mirror that can only
 become true long after hydration, and a viewport measured before the first
 paint is the opposite case. See `MixinControllerOpen` on `open`. */
   "prop:bandBelow"?: (HelixHeadlessMegamenu["bandBelow"]) | undefined;
+  /** How long a pointer leaving the trigger and the panel waits before the panel
+closes, in milliseconds. The pointer needs the time to cross from the
+trigger to the panel. */
+  "attr:close-delay"?: (HelixHeadlessMegamenu["closeDelay"] | `${number}`) | undefined;
+  /** How long a pointer leaving the trigger and the panel waits before the panel
+closes, in milliseconds. The pointer needs the time to cross from the
+trigger to the panel. */
+  "prop:closeDelay"?: (HelixHeadlessMegamenu["closeDelay"]) | undefined;
   /** The section's name, used for the default trigger and the panel. */
   "prop:label"?: (HelixHeadlessMegamenu["label"]) | undefined;
+  /** How long a pointer rests on the trigger before the panel opens, in
+milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+way somewhere else opens nothing. */
+  "attr:open-delay"?: (HelixHeadlessMegamenu["openDelay"] | `${number}`) | undefined;
+  /** How long a pointer rests on the trigger before the panel opens, in
+milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+way somewhere else opens nothing. */
+  "prop:openDelay"?: (HelixHeadlessMegamenu["openDelay"]) | undefined;
   /** Whether hovering over the trigger opens the panel (`hover`), or only a press
 does (`click`).
 
@@ -19993,6 +20076,10 @@ the trigger, and it is the default because that is what a navigation bar
 does. `click` is for a trigger that does something else as well, or a panel
 heavy enough that opening it on the way past is rude. */
   "prop:openOn"?: (HelixHeadlessMegamenu["openOn"]) | undefined;
+  /** The side of the trigger a card panel opens on, when there is room. It
+moves if that side does not fit. A band ignores it, since a band spans the
+page under its bar. */
+  "prop:placement"?: (HelixHeadlessMegamenu["placement"]) | undefined;
   /** Whether the panel is a card under the trigger or a band across the page.
 
 The resting one is the card, hanging off the trigger and as wide as it
@@ -20244,12 +20331,29 @@ Empty by default, which names the surface by its trigger, so a menu opened
 from "Actions" is announced as "Actions". An `aria-label` or
 `aria-labelledby` on the host names it too, and wins over both. */
   label?: (HelixHeadlessMenu["label"]) | undefined;
+  /** The description a trigger gives under `open-on="long-press"`, saying how
+to open the menu. Translate it with the rest of your interface. */
+  "long-press-label"?: (HelixHeadlessMenu["longPressLabel"]) | undefined;
+  /** The description a trigger gives under `open-on="long-press"`, saying how
+to open the menu. Translate it with the rest of your interface. */
+  longPressLabel?: (HelixHeadlessMenu["longPressLabel"]) | undefined;
   /** Space between the trigger and the surface, in pixels. */
   offset?: (HelixHeadlessMenu["offset"]) | undefined;
+  /** What opens the menu from its trigger. `long-press` leaves a press to the
+trigger's own action and opens the menu on a press held for half a second,
+or on Alt+Down or Alt+Up. */
+  "open-on"?: (HelixHeadlessMenu["openOn"]) | undefined;
+  /** What opens the menu from its trigger. `long-press` leaves a press to the
+trigger's own action and opens the menu on a press held for half a second,
+or on Alt+Down or Alt+Up. */
+  openOn?: (HelixHeadlessMenu["openOn"]) | undefined;
   /** The side the menu opens on, when there is room.
 
 It moves if that side does not fit. */
   placement?: (HelixHeadlessMenu["placement"]) | 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?: (HelixHeadlessMenu["submenus"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
   "empty-text"?: (HelixHeadlessMenu["emptyText"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
@@ -20310,12 +20414,29 @@ Empty by default, which names the surface by its trigger, so a menu opened
 from "Actions" is announced as "Actions". An `aria-label` or
 `aria-labelledby` on the host names it too, and wins over both. */
   "prop:label"?: (HelixHeadlessMenu["label"]) | undefined;
+  /** The description a trigger gives under `open-on="long-press"`, saying how
+to open the menu. Translate it with the rest of your interface. */
+  "attr:long-press-label"?: (HelixHeadlessMenu["longPressLabel"]) | undefined;
+  /** The description a trigger gives under `open-on="long-press"`, saying how
+to open the menu. Translate it with the rest of your interface. */
+  "prop:longPressLabel"?: (HelixHeadlessMenu["longPressLabel"]) | undefined;
   /** Space between the trigger and the surface, in pixels. */
   "prop:offset"?: (HelixHeadlessMenu["offset"]) | undefined;
+  /** What opens the menu from its trigger. `long-press` leaves a press to the
+trigger's own action and opens the menu on a press held for half a second,
+or on Alt+Down or Alt+Up. */
+  "attr:open-on"?: (HelixHeadlessMenu["openOn"]) | undefined;
+  /** What opens the menu from its trigger. `long-press` leaves a press to the
+trigger's own action and opens the menu on a press held for half a second,
+or on Alt+Down or Alt+Up. */
+  "prop:openOn"?: (HelixHeadlessMenu["openOn"]) | undefined;
   /** The side the menu opens on, when there is room.
 
 It moves if that side does not fit. */
   "prop:placement"?: (HelixHeadlessMenu["placement"]) | 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"?: (HelixHeadlessMenu["submenus"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
   "attr:empty-text"?: (HelixHeadlessMenu["emptyText"]) | undefined;
   /** The text shown and announced when there are no rows and none are loading. */
@@ -21054,6 +21175,12 @@ export type HelixHeadlessNotificationsHelixReadElementEvent =
   HelixHeadlessNotificationsElementEvent<HelixReadEvent>;
 
 export type HelixHeadlessNotificationsProps = {
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "arrived-label"?: (HelixHeadlessNotifications["arrivedLabel"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  arrivedLabel?: (HelixHeadlessNotifications["arrivedLabel"]) | undefined;
   /** The region's name where `label` is empty. */
   "fallback-label"?: (HelixHeadlessNotifications["fallbackLabel"]) | undefined;
   /** The region's name where `label` is empty. */
@@ -21126,6 +21253,12 @@ say that without the component knowing what a row looks like. */
 };
 
 export type HelixHeadlessNotificationsSolidJsProps = {
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "attr:arrived-label"?: (HelixHeadlessNotifications["arrivedLabel"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "prop:arrivedLabel"?: (HelixHeadlessNotifications["arrivedLabel"]) | undefined;
   /** The region's name where `label` is empty. */
   "attr:fallback-label"?: (HelixHeadlessNotifications["fallbackLabel"]) | undefined;
   /** The region's name where `label` is empty. */
@@ -31381,6 +31514,10 @@ A word property: register it for a locale under the host's key. A family
 that names the control otherwise, such as Tag's `Remove {label}`,
 declares its own English with `@words` above the override. */
   dismissLabel?: (HelixHeadlessToastItem["dismissLabel"]) | undefined;
+  /** Whether the region holds the message back, because more messages are
+showing than its `max-visible`. The region sets it. A waiting message is
+hidden, its timer has not started, and it is said once it shows. */
+  waiting?: (HelixHeadlessToastItem["waiting"]) | undefined;
 
   /** Fired when the message is dismissed, by the control or by its timer, and cancelable. Canceling it keeps the message. */
   "onhelix-dismiss"?: ((
@@ -31435,6 +31572,10 @@ A word property: register it for a locale under the host's key. A family
 that names the control otherwise, such as Tag's `Remove {label}`,
 declares its own English with `@words` above the override. */
   "prop:dismissLabel"?: (HelixHeadlessToastItem["dismissLabel"]) | undefined;
+  /** Whether the region holds the message back, because more messages are
+showing than its `max-visible`. The region sets it. A waiting message is
+hidden, its timer has not started, and it is said once it shows. */
+  "prop:waiting"?: (HelixHeadlessToastItem["waiting"]) | undefined;
   /** Fired when the message is dismissed, by the control or by its timer, and cancelable. Canceling it keeps the message. */
   "on:helix-dismiss"?: ((
     e: HelixHeadlessToastItemHelixDismissElementEvent,
@@ -31464,6 +31605,14 @@ Empty turns it off. */
   /** Accessible name for the region, with `{hotkey}` filled in. Translate it with
 the rest of your interface. */
   label?: (HelixHeadlessToast["label"]) | undefined;
+  /** How many messages show at once. The messages after that many wait, hidden
+and with their timers stopped, until a message before them goes. Unset,
+every message shows. */
+  "max-visible"?: (HelixHeadlessToast["maxVisible"] | `${number}`) | undefined;
+  /** How many messages show at once. The messages after that many wait, hidden
+and with their timers stopped, until a message before them goes. Unset,
+every message shows. */
+  maxVisible?: (HelixHeadlessToast["maxVisible"]) | undefined;
   /** Which corner or edge the stack sits at.
 
 Named here rather than on each message, because where a page puts its
@@ -31503,6 +31652,14 @@ Empty turns it off. */
   /** Accessible name for the region, with `{hotkey}` filled in. Translate it with
 the rest of your interface. */
   "prop:label"?: (HelixHeadlessToast["label"]) | undefined;
+  /** How many messages show at once. The messages after that many wait, hidden
+and with their timers stopped, until a message before them goes. Unset,
+every message shows. */
+  "attr:max-visible"?: (HelixHeadlessToast["maxVisible"] | `${number}`) | undefined;
+  /** How many messages show at once. The messages after that many wait, hidden
+and with their timers stopped, until a message before them goes. Unset,
+every message shows. */
+  "prop:maxVisible"?: (HelixHeadlessToast["maxVisible"]) | undefined;
   /** Which corner or edge the stack sits at.
 
 Named here rather than on each message, because where a page puts its
@@ -43706,6 +43863,16 @@ export type CustomElements = {
    * `aria-haspopup`, the same way `Menu` marks a row with a submenu. The server
    * render leaves both out, because the server cannot see the children.
    *
+   * **A row with an `href` is a link.** The row itself renders as an `<a>`
+   * carrying `menuitem`, as `Menu.Item` does, so a middle click, a modified
+   * click and the status bar keep working. Enter follows it, and Space does too.
+   * Choosing it fires `helix-select` first: cancel the event and the link is not
+   * followed, so a router can take the navigation. A row that opens a page, or a
+   * disabled row, renders no link.
+   *
+   * A development build warns when a row has no words to be named by, such as a
+   * row holding only an icon with no label.
+   *
    * The row is named by its label alone. Words in `description`, a line under
    * the label, and in `end` describe it instead, through `aria-describedby`, as
    * `Menu.Item` does: a reader hears "Theme", then "Dark".
@@ -43715,6 +43882,12 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `disabled`: Whether the row can be reached at all.
+   * - `download`: Whether the link downloads the file when the row is chosen. Only
+   * meaningful beside an `href`, and only for a file served from this origin.
+   * - `href`: The URL the row links to. Setting it renders the row as a link, unless the
+   * row opens a page or is disabled.
+   * - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
+   * - `target`: Where the link opens, for rows that should open outside the current page.
    * - `value`: Identifies the row to your event listeners.
    * - `focusable`: Whether this row holds the region's tab stop. Set by the drill-down.
    *
@@ -43788,7 +43961,7 @@ export type CustomElements = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `item`: The row itself.
+   * - `item`: The row itself, which is an `<a>` where `href` is set.
    * - `label`: The row's label.
    * - `mark`: The caret at the end of a row that opens a page, after the `end` slot. The caret points, so a stylesheet mirrors it in a right-to-left document.
    *
@@ -43820,6 +43993,11 @@ export type CustomElements = {
    * and reads the rest from the DOM. The behavior lives in `DrilldownController`,
    * which `Menu` shares.
    *
+   * **`page` is the page showing**, as the `value` of the row that opens it,
+   * and empty on the top page. Set it to show a page, such as one a link to a
+   * settings screen names. A reader's move updates it, and `helix-navigate`
+   * comes first, so you can refuse the move or take it yourself.
+   *
    * After each move the host carries `data-direction`, `forward` into a page or
    * `back` out of one, and records `:state(forward)` or `:state(back)`, so a
    * stylesheet can slide the new page in from the side the reader is going. Both
@@ -43827,13 +44005,25 @@ export type CustomElements = {
    * page, two moves the same way included. The styled tier slides the page and
    * swaps it at once under `prefers-reduced-motion`.
    *
-   * Keys, on a row: Up and Down Arrow move between the rows, Home and End go to
-   * the first and the last, and a typed letter moves to the next row whose name
-   * starts with it. Enter, Space, or Right Arrow opens a row's page, and Left
-   * Arrow or Escape goes back, the two arrows swapping on a right-to-left page.
+   * **Keyboard.** The drilldown is one tab stop, on the row last focused.
+   *
+   * | Key | What it does |
+   * |---|---|
+   * | Down Arrow, Up Arrow | Moves to the next or the previous row. |
+   * | Home, End | Moves to the first or the last row. |
+   * | A letter | Moves to the next row whose name starts with it. |
+   * | Enter, Space | Chooses the row: opens its page, follows its link, or sends `helix-select`. |
+   * | Right Arrow | Opens the row's page. Left Arrow on a right-to-left page. |
+   * | Left Arrow, Escape | Goes back one page, with focus on the row that opened it. Right Arrow on a right-to-left page. |
    *
    * The rows of the page showing are a `menu`, named by `label` on the top page
-   * and by the page's title below it. The back button and the title sit above
+   * and by the page's title below it.
+   *
+   * **`navigation` makes it a site's navigation.** The host is a `navigation`
+   * landmark named by `label`, each page is a list, and each row is a list item
+   * holding a link or a button, as the APG's disclosure navigation is built,
+   * so a reader meets places to go in place of a menu of commands. The keys stay
+   * the same. The back button and the title sit above
    * the menu. Disabled rows stay reachable with the arrow keys, and typing a
    * letter moves to the next row whose name starts with it.
    *
@@ -43847,6 +44037,12 @@ export type CustomElements = {
    * An `aria-label` or `aria-labelledby` on the host names the top page too,
    * and wins over this.
    * - `back-label`/`backLabel`: The text of the back button.
+   * - `navigation`: Whether the drilldown is a site's navigation: a `navigation` landmark
+   * named by `label`, whose pages are lists of links. Without it, each page is
+   * a `menu`.
+   * - `page`: The page showing, as the `value` of the row that opens it. Empty is the
+   * top page. Setting it shows that page, and a value no row with a page has
+   * shows the top page.
    * - `empty-text`/`emptyText`: The text shown and announced when there are no rows and none are loading.
    * - `loading`: Whether the rows are still loading.
    *
@@ -43879,6 +44075,7 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
+   * - `helix-navigate`: Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing.
    * - `helix-select`: Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
    *
    * ## Slots
@@ -44734,6 +44931,7 @@ export type CustomElements = {
    * - `entry-shortcut-key`: One key of the shortcut's chord.
    * - `entry-shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
    * - `entry-start`: The leading column.
+   * - `entry-surface`: The panel a row's submenu opens in beside it. The filter menu's rows have none.
    * - `menu`: The menu the fields are offered in.
    * - `menu-back`: The button that goes back from a field's page.
    * - `menu-back-mark`: The icon on the back button.
@@ -49880,7 +50078,10 @@ export type CustomElements = {
    *
    * It opens on hover by default, and a press always opens it too. `open-on` sets
    * which. Hover is the default because in a navigation bar people expect to move
-   * along the row and see each section.
+   * along the row and see each section. A pointer resting on the trigger opens
+   * the panel after `open-delay`, and leaving closes it after `close-delay`. Moving
+   * from one open panel's trigger to another's opens the next at once, as Radix's
+   * `skipDelayDuration` does.
    *
    * When one panel opens in place of another, each says which way the reader
    * moved, as Radix's `data-motion` does. Moving toward the end of the bar, the
@@ -49898,6 +50099,10 @@ export type CustomElements = {
    * navigation menu publishes the same pair from its shared viewport, so a
    * stylesheet can grow or shrink one panel into the next.
    *
+   * While a link in the panel carries `aria-current="page"`, the host has
+   * `:state(current)`, so the trigger of the section holding the page you are
+   * on can say so, as Radix's navigation menu marks its active link.
+   *
    * The panel's default slot is the `columns` part and draws no box, so a sheet
    * can give the columns one of their own. While a panel is open, an
    * `indicator` slot is rendered beside its trigger, as Radix's indicator
@@ -49914,6 +50119,12 @@ export type CustomElements = {
    * way out. The trigger says `aria-expanded`, and the panel is a group named by
    * `label`.
    *
+   * A Helix trigger, such as `helix-button`, is told whether the panel is open
+   * inside its own shadow root. On a plain element, such as a `<button>`, the
+   * megamenu writes `aria-expanded`, from a frame after its own first render, so
+   * a server's markup is never changed while a framework hydrates it. It never
+   * writes it where you wrote `aria-expanded` yourself.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -49942,7 +50153,13 @@ export type CustomElements = {
    * narrow exception the server specs describe covers a mirror that can only
    * become true long after hydration, and a viewport measured before the first
    * paint is the opposite case. See `MixinControllerOpen` on `open`.
+   * - `close-delay`/`closeDelay`: How long a pointer leaving the trigger and the panel waits before the panel
+   * closes, in milliseconds. The pointer needs the time to cross from the
+   * trigger to the panel.
    * - `label`: The section's name, used for the default trigger and the panel.
+   * - `open-delay`/`openDelay`: How long a pointer rests on the trigger before the panel opens, in
+   * milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+   * way somewhere else opens nothing.
    * - `open-on`/`openOn`: Whether hovering over the trigger opens the panel (`hover`), or only a press
    * does (`click`).
    *
@@ -49950,6 +50167,9 @@ export type CustomElements = {
    * the trigger, and it is the default because that is what a navigation bar
    * does. `click` is for a trigger that does something else as well, or a panel
    * heavy enough that opening it on the way past is rude.
+   * - `placement`: The side of the trigger a card panel opens on, when there is room. It
+   * moves if that side does not fit. A band ignores it, since a band spans the
+   * page under its bar.
    * - `variant`: Whether the panel is a card under the trigger or a band across the page.
    *
    * The resting one is the card, hanging off the trigger and as wide as it
@@ -50057,6 +50277,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `current`: A link in the panel carries `aria-current="page"`, so the trigger can show the section you are in.
    * - `from-end`: The panel opened in place of one earlier in the bar, so it can enter from the end side.
    * - `from-start`: The panel opened in place of one later in the bar, so it can enter from the start side.
    * - `narrow`: The page is narrower than `band-below`, so the panel is shown as a band whatever its variant.
@@ -50099,6 +50320,9 @@ export type CustomElements = {
    * React Aria's menu item does with its description: a reader hears "Copy",
    * then "Copies the selection".
    *
+   * A development build warns when a row has no words to be named by, such as a
+   * row holding only an icon with no label.
+   *
    * The check mark and the caret are the fallbacks of the `check` and `chevron`
    * slots, so a mark of your own replaces either by being slotted. Neither is
    * read as part of the row's name.
@@ -50243,12 +50467,15 @@ export type CustomElements = {
    * - `shortcut-key`: One key of the shortcut's chord, such as `Ctrl`.
    * - `shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
    * - `start`: The leading column that holds the `start` slot. It is always rendered.
+   * - `surface`: The panel a submenu opens in beside the row, under the menu's `submenus="flyout"`.
    *
    * ## CSS States
    *
    * These can be used to apply styling when a component is in a given state.
    *
    * - `checked`: The row is checked.
+   * - `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.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-menu-item": Partial<
@@ -50261,15 +50488,24 @@ export type CustomElements = {
    * ancestor with `overflow: hidden` does not clip it and it needs no `z-index`.
    *
    * Slot a `helix-button` or `helix-icon-button` as the trigger, and the menu
-   * tells it that it opens a menu and whether the menu is open. A plain
-   * `<button>` can only be told by writing attributes onto your markup, which
-   * the menu does not do, so give it `aria-haspopup="menu"` and set its
-   * `aria-expanded` from the `toggle` event.
-   *
-   * Submenus drill down. A submenu replaces the panel's content, and a back row
-   * returns to the previous page. One panel avoids the diagonal pointer path that
-   * side-by-side panels need, stays inside a narrow window, and works on touch
-   * screens, which have no hover.
+   * tells it that it opens a menu and whether the menu is open, inside its own
+   * shadow root. On a plain element, such as a `<button>`, the menu writes
+   * `aria-haspopup="menu"` and `aria-expanded`, from a frame after its own first
+   * render, so a server's markup is never changed while a framework hydrates it.
+   * It never writes `aria-expanded` where you wrote it yourself.
+   *
+   * Submenus drill down by default. A submenu replaces the panel's content, and a
+   * back row returns to the previous page. One panel stays inside a narrow
+   * window, and works on touch screens, which have no hover.
+   *
+   * **`submenus="flyout"` opens each submenu in a panel of its own beside its
+   * row**, as React Aria's `SubmenuTrigger` and Radix's `Sub` do. Resting the
+   * pointer on the row opens it, and a pointer crossing toward the open panel
+   * over the rows between keeps it open, as Radix's grace area does. Right Arrow
+   * opens a row's submenu on its first row, and Left Arrow or Escape closes it
+   * and returns focus to the row, the two arrows swapping on a right-to-left
+   * page. The row says `aria-expanded`, and the panel is a `menu` named by the
+   * row.
    *
    * The root holds which page is open, because only one page shows at a time. It
    * sets this on items as a property, never as an attribute. An attribute written
@@ -50297,7 +50533,14 @@ export type CustomElements = {
    * right-click, a long press, Shift+F10 or the menu key over the area opens it
    * at the pointer, or at the area's corner from the keyboard, as Radix's context
    * menu does. A press on the area does not open it, and closing it returns focus
-   * to where it was.
+   * to where it was. A touch or a pen held still on the area opens it too, on
+   * every browser, since iOS sends no `contextmenu` for one.
+   *
+   * **A trigger with its own action.** With `open-on="long-press"`, a press on
+   * the trigger is the trigger's own, and a press held for half a second opens
+   * the menu, as React Aria's `trigger="longPress"` does. Alt+Down or Alt+Up
+   * opens it from the keyboard, and the trigger is described by
+   * `long-press-label`, which says so.
    *
    * ## Attributes & Properties
    *
@@ -50311,10 +50554,17 @@ export type CustomElements = {
    * Empty by default, which names the surface by its trigger, so a menu opened
    * from "Actions" is announced as "Actions". An `aria-label` or
    * `aria-labelledby` on the host names it too, and wins over both.
+   * - `long-press-label`/`longPressLabel`: The description a trigger gives under `open-on="long-press"`, saying how
+   * to open the menu. Translate it with the rest of your interface.
    * - `offset`: Space between the trigger and the surface, in pixels.
+   * - `open-on`/`openOn`: What opens the menu from its trigger. `long-press` leaves a press to the
+   * trigger's own action and opens the menu on a press held for half a second,
+   * or on Alt+Down or Alt+Up.
    * - `placement`: The side the menu opens on, when there is room.
    *
    * It moves if that side does not fit.
+   * - `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.
    * - `empty-text`/`emptyText`: The text shown and announced when there are no rows and none are loading.
    * - `loading`: Whether the rows are still loading.
    *
@@ -51109,6 +51359,11 @@ export type CustomElements = {
    * | Control+Home | From anywhere in the feed, moves to the nearest control before it on the page. |
    * | Tab | Moves through the controls in a row, and on out of the feed. |
    *
+   * **A notification that arrives says so.** Unread rows added above the rows
+   * there were are counted in the live region,
+   * "1 new notification", in `arrived-label`. Rows that arrive while `loading`
+   * is set say nothing, so set it while a page is on its way.
+   *
    * **`load-more` adds a button after the list** that sends `helix-load-more`,
    * for a feed that holds one page of a longer list. Append the next page, set
    * `loading` while it is on its way, and take `load-more` off once there is
@@ -51124,6 +51379,8 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `arrived-label`/`arrivedLabel`: What the feed says when unread notifications arrive, with `{count}` the
+   * number of them. Empty it to say nothing.
    * - `fallback-label`/`fallbackLabel`: The region's name where `label` is empty.
    * - `label`: The feed's name, read by screen readers.
    * - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
@@ -59912,6 +60169,9 @@ export type CustomElements = {
    * control. While it moves, the distance is on the `item` part as
    * `--toast-swipe-x`.
    *
+   * **Escape dismisses the message holding focus**, through the same
+   * `helix-dismiss`, and focus moves to the next message.
+   *
    * **Messages are inverted by default.** The item flips `color-scheme`, so a new
    * message stands out from the page without using a color that carries meaning.
    *
@@ -59949,6 +60209,9 @@ export type CustomElements = {
    * A word property: register it for a locale under the host's key. A family
    * that names the control otherwise, such as Tag's `Remove {label}`,
    * declares its own English with `@words` above the override.
+   * - `waiting`: Whether the region holds the message back, because more messages are
+   * showing than its `max-visible`. The region sets it. A waiting message is
+   * hidden, its timer has not started, and it is said once it shows. (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
@@ -60026,6 +60289,9 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `closed`: The message has been dismissed and is hidden, or leaving.
+   * - `paused`: The dismiss timer is paused, while a pointer or focus is on the message, or while the page is hidden.
+   * - `waiting`: The region holds the message back, past its `max-visible`, until a message before it goes.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-toast-item": Partial<
@@ -60078,6 +60344,19 @@ export type CustomElements = {
    * message, then the one before it, then back to where it was before it entered
    * the stack.
    *
+   * **`max-visible` limits how many messages show at once**, as Zag's `max`
+   * does. The messages after that many, in document order, wait: each is hidden,
+   * its timer has not started, and the region says it once it shows, when a
+   * message before it goes. A waiting message has `:state(waiting)`.
+   *
+   * **Keyboard.**
+   *
+   * | Key | What it does |
+   * |---|---|
+   * | F8, or your `hotkey` | Moves focus to the first control in the stack, and back to where it was when pressed in the stack. |
+   * | Tab, Shift+Tab | Moves between the controls of the messages. |
+   * | Escape | Dismisses the message holding focus. Focus moves to the next message, then the one before it, then back to where it was. |
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -60088,6 +60367,9 @@ export type CustomElements = {
    * Empty turns it off.
    * - `label`: Accessible name for the region, with `{hotkey}` filled in. Translate it with
    * the rest of your interface.
+   * - `max-visible`/`maxVisible`: How many messages show at once. The messages after that many wait, hidden
+   * and with their timers stopped, until a message before them goes. Unset,
+   * every message shows.
    * - `placement`: Which corner or edge the stack sits at.
    *
    * Named here rather than on each message, because where a page puts its
@@ -62020,6 +62302,7 @@ export type CustomElements = {
    * - `entry-shortcut-key`: One key of an entry's shortcut chord, inside `entry-shortcut`. The playlist's entries set none.
    * - `entry-shortcut-separator`: The `+` between two keys of an entry's shortcut, where the platform writes one.
    * - `entry-start`: The column at the start of an entry. It is a slot and is always present.
+   * - `entry-surface`: The panel an entry's submenu opens in beside it. The playlist's entries have none.
    * - `menu`: The menu that holds the entries.
    * - `menu-back`: The button that goes back from a submenu.
    * - `menu-back-mark`: The icon on a submenu's back button.
@@ -62584,6 +62867,7 @@ export type CustomElements = {
    * - `entry-shortcut-key`: One key of a row's shortcut chord, inside `entry-shortcut`. The player's rows set none.
    * - `entry-shortcut-separator`: The `+` between two keys of a row's shortcut, where the platform writes one.
    * - `entry-start`: The leading column that holds the `start` slot. It is always rendered.
+   * - `entry-surface`: The panel a row's submenu opens in beside it. The player's rows have none.
    * - `failure`: The message shown when the source cannot be played.
    * - `forward`: The button that skips forward ten seconds.
    * - `fullscreen`: The button that enters and leaves fullscreen.
@@ -71785,6 +72069,16 @@ export type CustomElementsSolidJs = {
    * `aria-haspopup`, the same way `Menu` marks a row with a submenu. The server
    * render leaves both out, because the server cannot see the children.
    *
+   * **A row with an `href` is a link.** The row itself renders as an `<a>`
+   * carrying `menuitem`, as `Menu.Item` does, so a middle click, a modified
+   * click and the status bar keep working. Enter follows it, and Space does too.
+   * Choosing it fires `helix-select` first: cancel the event and the link is not
+   * followed, so a router can take the navigation. A row that opens a page, or a
+   * disabled row, renders no link.
+   *
+   * A development build warns when a row has no words to be named by, such as a
+   * row holding only an icon with no label.
+   *
    * The row is named by its label alone. Words in `description`, a line under
    * the label, and in `end` describe it instead, through `aria-describedby`, as
    * `Menu.Item` does: a reader hears "Theme", then "Dark".
@@ -71794,6 +72088,12 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `disabled`: Whether the row can be reached at all.
+   * - `download`: Whether the link downloads the file when the row is chosen. Only
+   * meaningful beside an `href`, and only for a file served from this origin.
+   * - `href`: The URL the row links to. Setting it renders the row as a link, unless the
+   * row opens a page or is disabled.
+   * - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
+   * - `target`: Where the link opens, for rows that should open outside the current page.
    * - `value`: Identifies the row to your event listeners.
    * - `focusable`: Whether this row holds the region's tab stop. Set by the drill-down.
    *
@@ -71867,7 +72167,7 @@ export type CustomElementsSolidJs = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `item`: The row itself.
+   * - `item`: The row itself, which is an `<a>` where `href` is set.
    * - `label`: The row's label.
    * - `mark`: The caret at the end of a row that opens a page, after the `end` slot. The caret points, so a stylesheet mirrors it in a right-to-left document.
    *
@@ -71900,6 +72200,11 @@ export type CustomElementsSolidJs = {
    * and reads the rest from the DOM. The behavior lives in `DrilldownController`,
    * which `Menu` shares.
    *
+   * **`page` is the page showing**, as the `value` of the row that opens it,
+   * and empty on the top page. Set it to show a page, such as one a link to a
+   * settings screen names. A reader's move updates it, and `helix-navigate`
+   * comes first, so you can refuse the move or take it yourself.
+   *
    * After each move the host carries `data-direction`, `forward` into a page or
    * `back` out of one, and records `:state(forward)` or `:state(back)`, so a
    * stylesheet can slide the new page in from the side the reader is going. Both
@@ -71907,13 +72212,25 @@ export type CustomElementsSolidJs = {
    * page, two moves the same way included. The styled tier slides the page and
    * swaps it at once under `prefers-reduced-motion`.
    *
-   * Keys, on a row: Up and Down Arrow move between the rows, Home and End go to
-   * the first and the last, and a typed letter moves to the next row whose name
-   * starts with it. Enter, Space, or Right Arrow opens a row's page, and Left
-   * Arrow or Escape goes back, the two arrows swapping on a right-to-left page.
+   * **Keyboard.** The drilldown is one tab stop, on the row last focused.
+   *
+   * | Key | What it does |
+   * |---|---|
+   * | Down Arrow, Up Arrow | Moves to the next or the previous row. |
+   * | Home, End | Moves to the first or the last row. |
+   * | A letter | Moves to the next row whose name starts with it. |
+   * | Enter, Space | Chooses the row: opens its page, follows its link, or sends `helix-select`. |
+   * | Right Arrow | Opens the row's page. Left Arrow on a right-to-left page. |
+   * | Left Arrow, Escape | Goes back one page, with focus on the row that opened it. Right Arrow on a right-to-left page. |
    *
    * The rows of the page showing are a `menu`, named by `label` on the top page
-   * and by the page's title below it. The back button and the title sit above
+   * and by the page's title below it.
+   *
+   * **`navigation` makes it a site's navigation.** The host is a `navigation`
+   * landmark named by `label`, each page is a list, and each row is a list item
+   * holding a link or a button, as the APG's disclosure navigation is built,
+   * so a reader meets places to go in place of a menu of commands. The keys stay
+   * the same. The back button and the title sit above
    * the menu. Disabled rows stay reachable with the arrow keys, and typing a
    * letter moves to the next row whose name starts with it.
    *
@@ -71927,6 +72244,12 @@ export type CustomElementsSolidJs = {
    * An `aria-label` or `aria-labelledby` on the host names the top page too,
    * and wins over this.
    * - `back-label`/`backLabel`: The text of the back button.
+   * - `navigation`: Whether the drilldown is a site's navigation: a `navigation` landmark
+   * named by `label`, whose pages are lists of links. Without it, each page is
+   * a `menu`.
+   * - `page`: The page showing, as the `value` of the row that opens it. Empty is the
+   * top page. Setting it shows that page, and a value no row with a page has
+   * shows the top page.
    * - `empty-text`/`emptyText`: The text shown and announced when there are no rows and none are loading.
    * - `loading`: Whether the rows are still loading.
    *
@@ -71959,6 +72282,7 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
+   * - `helix-navigate`: Fired before a reader moves into a page or back out of one. `detail.value` is the `value` of the row whose page is about to show, empty for the top page. Cancelable: cancel it to stay on the page showing.
    * - `helix-select`: Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
    *
    * ## Slots
@@ -72825,6 +73149,7 @@ export type CustomElementsSolidJs = {
    * - `entry-shortcut-key`: One key of the shortcut's chord.
    * - `entry-shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
    * - `entry-start`: The leading column.
+   * - `entry-surface`: The panel a row's submenu opens in beside it. The filter menu's rows have none.
    * - `menu`: The menu the fields are offered in.
    * - `menu-back`: The button that goes back from a field's page.
    * - `menu-back-mark`: The icon on the back button.
@@ -78039,7 +78364,10 @@ export type CustomElementsSolidJs = {
    *
    * It opens on hover by default, and a press always opens it too. `open-on` sets
    * which. Hover is the default because in a navigation bar people expect to move
-   * along the row and see each section.
+   * along the row and see each section. A pointer resting on the trigger opens
+   * the panel after `open-delay`, and leaving closes it after `close-delay`. Moving
+   * from one open panel's trigger to another's opens the next at once, as Radix's
+   * `skipDelayDuration` does.
    *
    * When one panel opens in place of another, each says which way the reader
    * moved, as Radix's `data-motion` does. Moving toward the end of the bar, the
@@ -78057,6 +78385,10 @@ export type CustomElementsSolidJs = {
    * navigation menu publishes the same pair from its shared viewport, so a
    * stylesheet can grow or shrink one panel into the next.
    *
+   * While a link in the panel carries `aria-current="page"`, the host has
+   * `:state(current)`, so the trigger of the section holding the page you are
+   * on can say so, as Radix's navigation menu marks its active link.
+   *
    * The panel's default slot is the `columns` part and draws no box, so a sheet
    * can give the columns one of their own. While a panel is open, an
    * `indicator` slot is rendered beside its trigger, as Radix's indicator
@@ -78073,6 +78405,12 @@ export type CustomElementsSolidJs = {
    * way out. The trigger says `aria-expanded`, and the panel is a group named by
    * `label`.
    *
+   * A Helix trigger, such as `helix-button`, is told whether the panel is open
+   * inside its own shadow root. On a plain element, such as a `<button>`, the
+   * megamenu writes `aria-expanded`, from a frame after its own first render, so
+   * a server's markup is never changed while a framework hydrates it. It never
+   * writes it where you wrote `aria-expanded` yourself.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -78101,7 +78439,13 @@ export type CustomElementsSolidJs = {
    * narrow exception the server specs describe covers a mirror that can only
    * become true long after hydration, and a viewport measured before the first
    * paint is the opposite case. See `MixinControllerOpen` on `open`.
+   * - `close-delay`/`closeDelay`: How long a pointer leaving the trigger and the panel waits before the panel
+   * closes, in milliseconds. The pointer needs the time to cross from the
+   * trigger to the panel.
    * - `label`: The section's name, used for the default trigger and the panel.
+   * - `open-delay`/`openDelay`: How long a pointer rests on the trigger before the panel opens, in
+   * milliseconds, under `open-on="hover"`. A pointer crossing the bar on its
+   * way somewhere else opens nothing.
    * - `open-on`/`openOn`: Whether hovering over the trigger opens the panel (`hover`), or only a press
    * does (`click`).
    *
@@ -78109,6 +78453,9 @@ export type CustomElementsSolidJs = {
    * the trigger, and it is the default because that is what a navigation bar
    * does. `click` is for a trigger that does something else as well, or a panel
    * heavy enough that opening it on the way past is rude.
+   * - `placement`: The side of the trigger a card panel opens on, when there is room. It
+   * moves if that side does not fit. A band ignores it, since a band spans the
+   * page under its bar.
    * - `variant`: Whether the panel is a card under the trigger or a band across the page.
    *
    * The resting one is the card, hanging off the trigger and as wide as it
@@ -78216,6 +78563,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `current`: A link in the panel carries `aria-current="page"`, so the trigger can show the section you are in.
    * - `from-end`: The panel opened in place of one earlier in the bar, so it can enter from the end side.
    * - `from-start`: The panel opened in place of one later in the bar, so it can enter from the start side.
    * - `narrow`: The page is narrower than `band-below`, so the panel is shown as a band whatever its variant.
@@ -78261,6 +78609,9 @@ export type CustomElementsSolidJs = {
    * React Aria's menu item does with its description: a reader hears "Copy",
    * then "Copies the selection".
    *
+   * A development build warns when a row has no words to be named by, such as a
+   * row holding only an icon with no label.
+   *
    * The check mark and the caret are the fallbacks of the `check` and `chevron`
    * slots, so a mark of your own replaces either by being slotted. Neither is
    * read as part of the row's name.
@@ -78405,12 +78756,15 @@ export type CustomElementsSolidJs = {
    * - `shortcut-key`: One key of the shortcut's chord, such as `Ctrl`.
    * - `shortcut-separator`: The `+` between two keys of the shortcut, where the platform writes one.
    * - `start`: The leading column that holds the `start` slot. It is always rendered.
+   * - `surface`: The panel a submenu opens in beside the row, under the menu's `submenus="flyout"`.
    *
    * ## CSS States
    *
    * These can be used to apply styling when a component is in a given state.
    *
    * - `checked`: The row is checked.
+   * - `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.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-menu-item": Partial<
@@ -78426,15 +78780,24 @@ export type CustomElementsSolidJs = {
    * ancestor with `overflow: hidden` does not clip it and it needs no `z-index`.
    *
    * Slot a `helix-button` or `helix-icon-button` as the trigger, and the menu
-   * tells it that it opens a menu and whether the menu is open. A plain
-   * `<button>` can only be told by writing attributes onto your markup, which
-   * the menu does not do, so give it `aria-haspopup="menu"` and set its
-   * `aria-expanded` from the `toggle` event.
-   *
-   * Submenus drill down. A submenu replaces the panel's content, and a back row
-   * returns to the previous page. One panel avoids the diagonal pointer path that
-   * side-by-side panels need, stays inside a narrow window, and works on touch
-   * screens, which have no hover.
+   * tells it that it opens a menu and whether the menu is open, inside its own
+   * shadow root. On a plain element, such as a `<button>`, the menu writes
+   * `aria-haspopup="menu"` and `aria-expanded`, from a frame after its own first
+   * render, so a server's markup is never changed while a framework hydrates it.
+   * It never writes `aria-expanded` where you wrote it yourself.
+   *
+   * Submenus drill down by default. A submenu replaces the panel's content, and a
+   * back row returns to the previous page. One panel stays inside a narrow
+   * window, and works on touch screens, which have no hover.
+   *
+   * **`submenus="flyout"` opens each submenu in a panel of its own beside its
+   * row**, as React Aria's `SubmenuTrigger` and Radix's `Sub` do. Resting the
+   * pointer on the row opens it, and a pointer crossing toward the open panel
+   * over the rows between keeps it open, as Radix's grace area does. Right Arrow
+   * opens a row's submenu on its first row, and Left Arrow or Escape closes it
+   * and returns focus to the row, the two arrows swapping on a right-to-left
+   * page. The row says `aria-expanded`, and the panel is a `menu` named by the
+   * row.
    *
    * The root holds which page is open, because only one page shows at a time. It
    * sets this on items as a property, never as an attribute. An attribute written
@@ -78462,7 +78825,14 @@ export type CustomElementsSolidJs = {
    * right-click, a long press, Shift+F10 or the menu key over the area opens it
    * at the pointer, or at the area's corner from the keyboard, as Radix's context
    * menu does. A press on the area does not open it, and closing it returns focus
-   * to where it was.
+   * to where it was. A touch or a pen held still on the area opens it too, on
+   * every browser, since iOS sends no `contextmenu` for one.
+   *
+   * **A trigger with its own action.** With `open-on="long-press"`, a press on
+   * the trigger is the trigger's own, and a press held for half a second opens
+   * the menu, as React Aria's `trigger="longPress"` does. Alt+Down or Alt+Up
+   * opens it from the keyboard, and the trigger is described by
+   * `long-press-label`, which says so.
    *
    * ## Attributes & Properties
    *
@@ -78476,10 +78846,17 @@ export type CustomElementsSolidJs = {
    * Empty by default, which names the surface by its trigger, so a menu opened
    * from "Actions" is announced as "Actions". An `aria-label` or
    * `aria-labelledby` on the host names it too, and wins over both.
+   * - `long-press-label`/`longPressLabel`: The description a trigger gives under `open-on="long-press"`, saying how
+   * to open the menu. Translate it with the rest of your interface.
    * - `offset`: Space between the trigger and the surface, in pixels.
+   * - `open-on`/`openOn`: What opens the menu from its trigger. `long-press` leaves a press to the
+   * trigger's own action and opens the menu on a press held for half a second,
+   * or on Alt+Down or Alt+Up.
    * - `placement`: The side the menu opens on, when there is room.
    *
    * It moves if that side does not fit.
+   * - `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.
    * - `empty-text`/`emptyText`: The text shown and announced when there are no rows and none are loading.
    * - `loading`: Whether the rows are still loading.
    *
@@ -79284,6 +79661,11 @@ export type CustomElementsSolidJs = {
    * | Control+Home | From anywhere in the feed, moves to the nearest control before it on the page. |
    * | Tab | Moves through the controls in a row, and on out of the feed. |
    *
+   * **A notification that arrives says so.** Unread rows added above the rows
+   * there were are counted in the live region,
+   * "1 new notification", in `arrived-label`. Rows that arrive while `loading`
+   * is set say nothing, so set it while a page is on its way.
+   *
    * **`load-more` adds a button after the list** that sends `helix-load-more`,
    * for a feed that holds one page of a longer list. Append the next page, set
    * `loading` while it is on its way, and take `load-more` off once there is
@@ -79299,6 +79681,8 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `arrived-label`/`arrivedLabel`: What the feed says when unread notifications arrive, with `{count}` the
+   * number of them. Empty it to say nothing.
    * - `fallback-label`/`fallbackLabel`: The region's name where `label` is empty.
    * - `label`: The feed's name, read by screen readers.
    * - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
@@ -88200,6 +88584,9 @@ export type CustomElementsSolidJs = {
    * control. While it moves, the distance is on the `item` part as
    * `--toast-swipe-x`.
    *
+   * **Escape dismisses the message holding focus**, through the same
+   * `helix-dismiss`, and focus moves to the next message.
+   *
    * **Messages are inverted by default.** The item flips `color-scheme`, so a new
    * message stands out from the page without using a color that carries meaning.
    *
@@ -88237,6 +88624,9 @@ export type CustomElementsSolidJs = {
    * A word property: register it for a locale under the host's key. A family
    * that names the control otherwise, such as Tag's `Remove {label}`,
    * declares its own English with `@words` above the override.
+   * - `waiting`: Whether the region holds the message back, because more messages are
+   * showing than its `max-visible`. The region sets it. A waiting message is
+   * hidden, its timer has not started, and it is said once it shows. (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
@@ -88314,6 +88704,9 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `closed`: The message has been dismissed and is hidden, or leaving.
+   * - `paused`: The dismiss timer is paused, while a pointer or focus is on the message, or while the page is hidden.
+   * - `waiting`: The region holds the message back, past its `max-visible`, until a message before it goes.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-toast-item": Partial<
@@ -88369,6 +88762,19 @@ export type CustomElementsSolidJs = {
    * message, then the one before it, then back to where it was before it entered
    * the stack.
    *
+   * **`max-visible` limits how many messages show at once**, as Zag's `max`
+   * does. The messages after that many, in document order, wait: each is hidden,
+   * its timer has not started, and the region says it once it shows, when a
+   * message before it goes. A waiting message has `:state(waiting)`.
+   *
+   * **Keyboard.**
+   *
+   * | Key | What it does |
+   * |---|---|
+   * | F8, or your `hotkey` | Moves focus to the first control in the stack, and back to where it was when pressed in the stack. |
+   * | Tab, Shift+Tab | Moves between the controls of the messages. |
+   * | Escape | Dismisses the message holding focus. Focus moves to the next message, then the one before it, then back to where it was. |
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -88379,6 +88785,9 @@ export type CustomElementsSolidJs = {
    * Empty turns it off.
    * - `label`: Accessible name for the region, with `{hotkey}` filled in. Translate it with
    * the rest of your interface.
+   * - `max-visible`/`maxVisible`: How many messages show at once. The messages after that many wait, hidden
+   * and with their timers stopped, until a message before them goes. Unset,
+   * every message shows.
    * - `placement`: Which corner or edge the stack sits at.
    *
    * Named here rather than on each message, because where a page puts its
@@ -90340,6 +90749,7 @@ export type CustomElementsSolidJs = {
    * - `entry-shortcut-key`: One key of an entry's shortcut chord, inside `entry-shortcut`. The playlist's entries set none.
    * - `entry-shortcut-separator`: The `+` between two keys of an entry's shortcut, where the platform writes one.
    * - `entry-start`: The column at the start of an entry. It is a slot and is always present.
+   * - `entry-surface`: The panel an entry's submenu opens in beside it. The playlist's entries have none.
    * - `menu`: The menu that holds the entries.
    * - `menu-back`: The button that goes back from a submenu.
    * - `menu-back-mark`: The icon on a submenu's back button.
@@ -90906,6 +91316,7 @@ export type CustomElementsSolidJs = {
    * - `entry-shortcut-key`: One key of a row's shortcut chord, inside `entry-shortcut`. The player's rows set none.
    * - `entry-shortcut-separator`: The `+` between two keys of a row's shortcut, where the platform writes one.
    * - `entry-start`: The leading column that holds the `start` slot. It is always rendered.
+   * - `entry-surface`: The panel a row's submenu opens in beside it. The player's rows have none.
    * - `failure`: The message shown when the source cannot be played.
    * - `forward`: The button that skips forward ten seconds.
    * - `fullscreen`: The button that enters and leaves fullscreen.