@fusion.dev/helix 0.156.0 → 0.157.0

package/types/vue.d.ts

@@ -7294,6 +7294,16 @@ export type HelixDrilldownItemHelixSelectElementEvent =
 export type HelixDrilldownItemVueProps = {
   /** 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.
@@ -7320,6 +7330,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>;
@@ -7349,9 +7362,19 @@ 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;
 };
 
 export type HelixDrilldownVueEvents = {
+  /** 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-navigate": HelixDrilldownHelixNavigateElementEvent;
   /** Fired when a row with no page is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
   "helix-select": HelixDrilldownHelixSelectElementEvent;
 };
@@ -11623,8 +11646,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`).
 
@@ -11641,6 +11680,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
@@ -11815,12 +11858,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;
 };
 
 export type HelixMenuVueEvents = {
@@ -12255,6 +12315,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. */
@@ -18380,6 +18446,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;
 };
 
 export type HelixToastItemVueEvents = {
@@ -18402,6 +18472,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

package/types/words.d.ts

@@ -25,6 +25,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `{author}: {text}`
        */
       arrivalLabel: Message
+      /**
+       * What the feed says when unread notifications arrive, with `{count}` the
+       * number of them. Empty it to say nothing.
+       *
+       * English: `{count, plural, one {# new notification} other {# new notifications}}`
+       */
+      arrivedLabel: Message
       /**
        * The word for an ascending sort, in a `sorted-label` that writes `{order}`.
        *
@@ -334,6 +341,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `Load more`
        */
       loadMoreLabel: Message
+      /**
+       * The description a trigger gives under `open-on="long-press"`, saying how
+       * to open the menu. Translate it with the rest of your interface.
+       *
+       * English: `Long press or press Alt+Down to show the menu`
+       */
+      longPressLabel: Message
       /**
        * The name of the map types in the layers menu, read by screen readers.
        *