@fusion.dev/helix 0.156.0 → 0.157.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.156.0",
+  "version": "0.157.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.156.0",
-    "@fusion.dev/helix-headless": "0.156.0",
-    "@fusion.dev/helix-styles": "0.156.0"
+    "@fusion.dev/helix-core": "0.157.0",
+    "@fusion.dev/helix-headless": "0.157.0",
+    "@fusion.dev/helix-styles": "0.157.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.156.0",
-    "@fusion.dev/helix-testing": "0.156.0",
+    "@fusion.dev/helix-cem": "0.157.0",
+    "@fusion.dev/helix-testing": "0.157.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

@@ -14228,6 +14228,16 @@ export type HelixDrilldownItemHelixSelectElementEvent =
 export type HelixDrilldownItemProps = {
   /** Whether the row can be reached at all. */
   disabled?: (HelixDrilldownItem["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?: (HelixDrilldownItem["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?: (HelixDrilldownItem["href"]) | undefined;
+  /** The link's `rel`. Set it whenever you set `target="_blank"`. */
+  rel?: (HelixDrilldownItem["rel"]) | undefined;
+  /** Where the link opens, for rows that should open outside the current page. */
+  target?: (HelixDrilldownItem["target"]) | undefined;
   /** Identifies the row to your event listeners. */
   value?: (HelixDrilldownItem["value"]) | undefined;
   /** Whether this row holds the region's tab stop. Set by the drill-down.
@@ -14250,6 +14260,16 @@ lands inside this shadow root instead. */
 export type HelixDrilldownItemSolidJsProps = {
   /** Whether the row can be reached at all. */
   "prop:disabled"?: (HelixDrilldownItem["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"?: (HelixDrilldownItem["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"?: (HelixDrilldownItem["href"]) | undefined;
+  /** The link's `rel`. Set it whenever you set `target="_blank"`. */
+  "prop:rel"?: (HelixDrilldownItem["rel"]) | undefined;
+  /** Where the link opens, for rows that should open outside the current page. */
+  "prop:target"?: (HelixDrilldownItem["target"]) | undefined;
   /** Identifies the row to your event listeners. */
   "prop:value"?: (HelixDrilldownItem["value"]) | undefined;
   /** Whether this row holds the region's tab stop. Set by the drill-down.
@@ -14278,6 +14298,9 @@ export type HelixDrilldownElementEvent<E = Event> = TypedEvent<
   HelixDrilldown,
   E
 >;
+/** `helix-navigate` event type */
+export type HelixDrilldownHelixNavigateElementEvent =
+  HelixDrilldownElementEvent<HelixNavigateEvent>;
 /** `helix-select` event type */
 export type HelixDrilldownHelixSelectElementEvent =
   HelixDrilldownElementEvent<HelixSelectEvent>;
@@ -14307,7 +14330,17 @@ and wins over this. */
   "back-label"?: (HelixDrilldown["backLabel"]) | undefined;
   /** The text of the back button. */
   backLabel?: (HelixDrilldown["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?: (HelixDrilldown["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?: (HelixDrilldown["page"]) | 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: HelixDrilldownHelixNavigateElementEvent) => 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: HelixDrilldownHelixSelectElementEvent) => void) | undefined;
 };
@@ -14337,6 +14370,16 @@ and wins over this. */
   "attr:back-label"?: (HelixDrilldown["backLabel"]) | undefined;
   /** The text of the back button. */
   "prop:backLabel"?: (HelixDrilldown["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"?: (HelixDrilldown["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"?: (HelixDrilldown["page"]) | 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: HelixDrilldownHelixNavigateElementEvent) => 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: HelixDrilldownHelixSelectElementEvent) => void) | undefined;
 
@@ -22595,8 +22638,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?: (HelixMegamenu["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"?: (HelixMegamenu["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?: (HelixMegamenu["closeDelay"]) | undefined;
   /** The section's name, used for the default trigger and the panel. */
   label?: (HelixMegamenu["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"?: (HelixMegamenu["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?: (HelixMegamenu["openDelay"]) | undefined;
   /** Whether hovering over the trigger opens the panel (`hover`), or only a press
 does (`click`).
 
@@ -22613,6 +22672,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?: (HelixMegamenu["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?: (HelixMegamenu["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
@@ -22713,8 +22776,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"?: (HelixMegamenu["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"?: (HelixMegamenu["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"?: (HelixMegamenu["closeDelay"]) | undefined;
   /** The section's name, used for the default trigger and the panel. */
   "prop:label"?: (HelixMegamenu["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"?: (HelixMegamenu["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"?: (HelixMegamenu["openDelay"]) | undefined;
   /** Whether hovering over the trigger opens the panel (`hover`), or only a press
 does (`click`).
 
@@ -22731,6 +22810,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"?: (HelixMegamenu["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"?: (HelixMegamenu["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
@@ -22989,12 +23072,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?: (HelixMenu["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"?: (HelixMenu["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?: (HelixMenu["longPressLabel"]) | undefined;
   /** Space between the trigger and the surface, in pixels. */
   offset?: (HelixMenu["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"?: (HelixMenu["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?: (HelixMenu["openOn"]) | undefined;
   /** The side the menu opens on, when there is room.
 
 It moves if that side does not fit. */
   placement?: (HelixMenu["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?: (HelixMenu["submenus"]) | undefined;
 
   /** The menu opened or closed. The event carries `newState` and `oldState`. */
   ontoggle?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
@@ -23051,12 +23151,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"?: (HelixMenu["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"?: (HelixMenu["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"?: (HelixMenu["longPressLabel"]) | undefined;
   /** Space between the trigger and the surface, in pixels. */
   "prop:offset"?: (HelixMenu["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"?: (HelixMenu["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"?: (HelixMenu["openOn"]) | undefined;
   /** The side the menu opens on, when there is room.
 
 It moves if that side does not fit. */
   "prop:placement"?: (HelixMenu["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"?: (HelixMenu["submenus"]) | undefined;
   /** The menu opened or closed. The event carries `newState` and `oldState`. */
   "on:toggle"?: ((e: HelixMenuToggleElementEvent) => void) | undefined;
   /** The menu is about to close. Cancelable: cancel it to keep it open. */
@@ -23850,6 +23967,12 @@ say that without the component knowing what a row looks like. */
   "loading-text"?: (HelixNotifications["loadingText"]) | undefined;
   /** The text shown and announced while the rows load. */
   loadingText?: (HelixNotifications["loadingText"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "arrived-label"?: (HelixNotifications["arrivedLabel"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  arrivedLabel?: (HelixNotifications["arrivedLabel"]) | undefined;
   /** The region's name where `label` is empty. */
   "fallback-label"?: (HelixNotifications["fallbackLabel"]) | undefined;
   /** The region's name where `label` is empty. */
@@ -23931,6 +24054,12 @@ say that without the component knowing what a row looks like. */
   "attr:loading-text"?: (HelixNotifications["loadingText"]) | undefined;
   /** The text shown and announced while the rows load. */
   "prop:loadingText"?: (HelixNotifications["loadingText"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "attr:arrived-label"?: (HelixNotifications["arrivedLabel"]) | undefined;
+  /** What the feed says when unread notifications arrive, with `{count}` the
+number of them. Empty it to say nothing. */
+  "prop:arrivedLabel"?: (HelixNotifications["arrivedLabel"]) | undefined;
   /** The region's name where `label` is empty. */
   "attr:fallback-label"?: (HelixNotifications["fallbackLabel"]) | undefined;
   /** The region's name where `label` is empty. */
@@ -35822,6 +35951,10 @@ attribute nobody can use. */
 
 A subset of the tone axis: a toast reports a status and never a brand role. */
   tone?: (HelixToastItem["tone"]) | 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?: (HelixToastItem["waiting"]) | undefined;
 
   /** Fired when the message is dismissed, by the control or by its timer, and cancelable. Canceling it keeps the message. */
   "onhelix-dismiss"?: ((e: HelixToastItemHelixDismissElementEvent) => void) | undefined;
@@ -35874,6 +36007,10 @@ attribute nobody can use. */
 
 A subset of the tone axis: a toast reports a status and never a brand role. */
   "prop:tone"?: (HelixToastItem["tone"]) | 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"?: (HelixToastItem["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: HelixToastItemHelixDismissElementEvent) => void) | undefined;
 
@@ -35898,6 +36035,14 @@ Empty turns it off. */
   /** Accessible name for the region, with `{hotkey}` filled in. Translate it with
 the rest of your interface. */
   label?: (HelixToast["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"?: (HelixToast["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?: (HelixToast["maxVisible"]) | undefined;
   /** Which corner or edge the stack sits at.
 
 Named here rather than on each message, because where a page puts its
@@ -35937,6 +36082,14 @@ Empty turns it off. */
   /** Accessible name for the region, with `{hotkey}` filled in. Translate it with
 the rest of your interface. */
   "prop:label"?: (HelixToast["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"?: (HelixToast["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"?: (HelixToast["maxVisible"]) | undefined;
   /** Which corner or edge the stack sits at.
 
 Named here rather than on each message, because where a page puts its
@@ -48542,6 +48695,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.
    *
@@ -48628,7 +48787,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.
    *
@@ -48667,6 +48826,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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -48692,6 +48857,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
@@ -49468,6 +49634,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.
@@ -54683,7 +54850,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`).
    *
@@ -54691,6 +54864,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
@@ -54803,6 +54979,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.
@@ -54973,12 +55150,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-menu-item": Partial<
@@ -55024,10 +55204,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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -55837,6 +56024,8 @@ export type CustomElements = {
    * are dimmed rather than removed while a new set arrives, and only CSS can
    * say that without the component knowing what a row looks like.
    * - `loading-text`/`loadingText`: The text shown and announced while the rows load.
+   * - `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
@@ -65157,6 +65346,9 @@ export type CustomElements = {
    * - `tone`: The kind of message, which sets its mark and the mark's accessible name.
    *
    * A subset of the tone axis: a toast reports a status and never a brand role.
+   * - `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
@@ -65242,6 +65434,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-toast-item": Partial<
@@ -65267,6 +65462,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
@@ -67088,6 +67286,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.
@@ -67621,6 +67820,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.
@@ -77010,6 +77210,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.
    *
@@ -77096,7 +77302,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.
    *
@@ -77138,6 +77344,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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -77163,6 +77375,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
@@ -77956,6 +78169,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.
@@ -83267,7 +83481,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`).
    *
@@ -83275,6 +83495,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
@@ -83387,6 +83610,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.
@@ -83560,12 +83784,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-menu-item": Partial<
@@ -83614,10 +83841,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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -84446,6 +84680,8 @@ export type CustomElementsSolidJs = {
    * are dimmed rather than removed while a new set arrives, and only CSS can
    * say that without the component knowing what a row looks like.
    * - `loading-text`/`loadingText`: The text shown and announced while the rows load.
+   * - `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
@@ -93938,6 +94174,9 @@ export type CustomElementsSolidJs = {
    * - `tone`: The kind of message, which sets its mark and the mark's accessible name.
    *
    * A subset of the tone axis: a toast reports a status and never a brand role.
+   * - `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
@@ -94023,6 +94262,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-toast-item": Partial<
@@ -94051,6 +94293,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
@@ -95907,6 +96152,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.
@@ -96446,6 +96692,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.