@fusion.dev/helix 0.158.0 → 0.159.0

package/types/jsx.d.ts

@@ -1024,6 +1024,15 @@ export type HelixAppHeaderElementEvent<E = Event> = TypedEvent<
   HelixAppHeader,
   E
 >;
+/** `toggle` event type */
+export type HelixAppHeaderToggleElementEvent =
+  HelixAppHeaderElementEvent<ToggleEvent>;
+/** `helix-before-close` event type */
+export type HelixAppHeaderHelixBeforeCloseElementEvent =
+  HelixAppHeaderElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixAppHeaderHelixBeforeOpenElementEvent =
+  HelixAppHeaderElementEvent<HelixBeforeOpenEvent>;
 /** `helix-scrolled` event type */
 export type HelixAppHeaderHelixScrolledElementEvent =
   HelixAppHeaderElementEvent<HelixScrolledEvent>;
@@ -1081,6 +1090,23 @@ It pairs with `material`: a bar that does not stick is only ever over the
 top of the page, so `glass` and `transparent` have nothing to be
 translucent against and the `scrolled` state never lands. */
   sticky?: (HelixAppHeader["sticky"]) | undefined;
+  /** Whether the element starts open. Ignored once `open` is written. */
+  "default-open"?: (HelixAppHeader["defaultOpen"]) | undefined;
+  /** Whether the element starts open. Ignored once `open` is written. */
+  defaultOpen?: (HelixAppHeader["defaultOpen"]) | undefined;
+  /** Whether the element is open.
+
+One property, not two, so `dialog.open` answers the question anyone
+asking it meant. Writing always applies; `<helix-dialog open>` is the
+same statement in markup.
+
+**Not reflected, and that is required rather than tidy.** Reflection
+writes the resolved state back as an attribute, so an element that opened
+itself would put `open` on its own host: cloned, serialized for
+hydration, or diffed by a framework, it comes back holding whatever the
+last reader did rather than what the author wrote. `:state(open)` carries
+the resolved state for stylesheets, which is what the mirror is for. */
+  open?: (HelixAppHeader["open"]) | undefined;
   /** Where the middle region sits in the bar.
 
 Centered by default, which reads as the site's spine when the navigation is
@@ -1128,7 +1154,29 @@ page scrolls up. */
   /** The id of the element whose scrolling lifts the bar, for an app shell that
 scrolls a container instead of the window. Unset is the window. */
   scroller?: (HelixAppHeader["scroller"]) | undefined;
-
+  /** Where the toggle that opens a folded middle region sits: at the end of the
+bar, after the trailing content, or with `start`, before the leading
+content.
+
+Optional, so the resting bar writes no attribute onto the host. */
+  "toggle-placement"?: (HelixAppHeader["togglePlacement"]) | undefined;
+  /** Where the toggle that opens a folded middle region sits: at the end of the
+bar, after the trailing content, or with `start`, before the leading
+content.
+
+Optional, so the resting bar writes no attribute onto the host. */
+  togglePlacement?: (HelixAppHeader["togglePlacement"]) | undefined;
+
+  /** The folded region opened or closed. The event carries `newState` and `oldState`. */
+  ontoggle?: ((e: HelixAppHeaderToggleElementEvent) => void) | undefined;
+  /** The folded region is about to close. Cancelable: cancel it to keep it open. */
+  "onhelix-before-close"?: ((
+    e: HelixAppHeaderHelixBeforeCloseElementEvent,
+  ) => void) | undefined;
+  /** The folded region is about to open. Cancelable: cancel it to keep it closed. */
+  "onhelix-before-open"?: ((
+    e: HelixAppHeaderHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Fired when the page crosses the scroll threshold, with the new state. A custom state cannot be observed the way an attribute can, so listen for this event to follow it. The event uses the header's own threshold and hysteresis, so you do not need a second scroll listener. */
   "onhelix-scrolled"?: ((e: HelixAppHeaderHelixScrolledElementEvent) => void) | undefined;
 };
@@ -1186,6 +1234,23 @@ It pairs with `material`: a bar that does not stick is only ever over the
 top of the page, so `glass` and `transparent` have nothing to be
 translucent against and the `scrolled` state never lands. */
   "prop:sticky"?: (HelixAppHeader["sticky"]) | undefined;
+  /** Whether the element starts open. Ignored once `open` is written. */
+  "bool:default-open"?: (HelixAppHeader["defaultOpen"]) | undefined;
+  /** Whether the element starts open. Ignored once `open` is written. */
+  "prop:defaultOpen"?: (HelixAppHeader["defaultOpen"]) | undefined;
+  /** Whether the element is open.
+
+One property, not two, so `dialog.open` answers the question anyone
+asking it meant. Writing always applies; `<helix-dialog open>` is the
+same statement in markup.
+
+**Not reflected, and that is required rather than tidy.** Reflection
+writes the resolved state back as an attribute, so an element that opened
+itself would put `open` on its own host: cloned, serialized for
+hydration, or diffed by a framework, it comes back holding whatever the
+last reader did rather than what the author wrote. `:state(open)` carries
+the resolved state for stylesheets, which is what the mirror is for. */
+  "prop:open"?: (HelixAppHeader["open"]) | undefined;
   /** Where the middle region sits in the bar.
 
 Centered by default, which reads as the site's spine when the navigation is
@@ -1233,6 +1298,28 @@ page scrolls up. */
   /** The id of the element whose scrolling lifts the bar, for an app shell that
 scrolls a container instead of the window. Unset is the window. */
   "prop:scroller"?: (HelixAppHeader["scroller"]) | undefined;
+  /** Where the toggle that opens a folded middle region sits: at the end of the
+bar, after the trailing content, or with `start`, before the leading
+content.
+
+Optional, so the resting bar writes no attribute onto the host. */
+  "attr:toggle-placement"?: (HelixAppHeader["togglePlacement"]) | undefined;
+  /** Where the toggle that opens a folded middle region sits: at the end of the
+bar, after the trailing content, or with `start`, before the leading
+content.
+
+Optional, so the resting bar writes no attribute onto the host. */
+  "prop:togglePlacement"?: (HelixAppHeader["togglePlacement"]) | undefined;
+  /** The folded region opened or closed. The event carries `newState` and `oldState`. */
+  "on:toggle"?: ((e: HelixAppHeaderToggleElementEvent) => void) | undefined;
+  /** The folded region is about to close. Cancelable: cancel it to keep it open. */
+  "on:helix-before-close"?: ((
+    e: HelixAppHeaderHelixBeforeCloseElementEvent,
+  ) => void) | undefined;
+  /** The folded region is about to open. Cancelable: cancel it to keep it closed. */
+  "on:helix-before-open"?: ((
+    e: HelixAppHeaderHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Fired when the page crosses the scroll threshold, with the new state. A custom state cannot be observed the way an attribute can, so listen for this event to follow it. The event uses the header's own threshold and hysteresis, so you do not need a second scroll listener. */
   "on:helix-scrolled"?: ((e: HelixAppHeaderHelixScrolledElementEvent) => void) | undefined;
 
@@ -3133,6 +3220,14 @@ separate actions. The semantics and the joining are separate questions:
 `role="group"` and a shared name are what make a set of buttons a set, and
 `helix-flex` gives the spacing without the group. */
   variant?: (HelixButtonGroup["variant"]) | undefined;
+  /** Keeps at least one button pressed once one is, as React Aria's
+`disallowEmptySelection`: a press that would leave none pressed is
+refused. */
+  "disallow-empty-selection"?: (HelixButtonGroup["disallowEmptySelection"]) | undefined;
+  /** Keeps at least one button pressed once one is, as React Aria's
+`disallowEmptySelection`: a press that would leave none pressed is
+refused. */
+  disallowEmptySelection?: (HelixButtonGroup["disallowEmptySelection"]) | undefined;
   /** The group's name, read by screen readers.
 
 On the host through internals, so an author's `aria-label` still overrides
@@ -3198,6 +3293,14 @@ separate actions. The semantics and the joining are separate questions:
 `role="group"` and a shared name are what make a set of buttons a set, and
 `helix-flex` gives the spacing without the group. */
   "prop:variant"?: (HelixButtonGroup["variant"]) | undefined;
+  /** Keeps at least one button pressed once one is, as React Aria's
+`disallowEmptySelection`: a press that would leave none pressed is
+refused. */
+  "bool:disallow-empty-selection"?: (HelixButtonGroup["disallowEmptySelection"]) | undefined;
+  /** Keeps at least one button pressed once one is, as React Aria's
+`disallowEmptySelection`: a press that would leave none pressed is
+refused. */
+  "prop:disallowEmptySelection"?: (HelixButtonGroup["disallowEmptySelection"]) | undefined;
   /** The group's name, read by screen readers.
 
 On the host through internals, so an author's `aria-label` still overrides
@@ -33230,7 +33333,16 @@ known by its place among the rows as written. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixTabPanel` component event */
+export type HelixTabPanelElementEvent<E = Event> = TypedEvent<HelixTabPanel, E>;
+/** `helix-load` event type */
+export type HelixTabPanelHelixLoadElementEvent =
+  HelixTabPanelElementEvent<HelixLoadEvent>;
+
 export type HelixTabPanelProps = {
+  /** Whether the panel's content waits in a `<template>` until the panel is
+first shown. */
+  lazy?: (HelixTabPanel["lazy"]) | undefined;
   /** Whether this panel is the visible one. */
   selected?: (HelixTabPanel["selected"]) | undefined;
   /** Pairs the panel with the tab of the same value. */
@@ -33246,9 +33358,15 @@ written in, and the tab's control is inside the tab's shadow root, which no
 reference from the light DOM can reach. `aria-label` on a `tabpanel` is how
 the pattern names one anyway. */
   label?: (HelixTabPanel["label"]) | undefined;
+
+  /** Fired the first time a `lazy` panel is shown, once its template's content is in. */
+  "onhelix-load"?: ((e: HelixTabPanelHelixLoadElementEvent) => void) | undefined;
 };
 
 export type HelixTabPanelSolidJsProps = {
+  /** Whether the panel's content waits in a `<template>` until the panel is
+first shown. */
+  "prop:lazy"?: (HelixTabPanel["lazy"]) | undefined;
   /** Whether this panel is the visible one. */
   "prop:selected"?: (HelixTabPanel["selected"]) | undefined;
   /** Pairs the panel with the tab of the same value. */
@@ -33264,6 +33382,8 @@ written in, and the tab's control is inside the tab's shadow root, which no
 reference from the light DOM can reach. `aria-label` on a `tabpanel` is how
 the pattern names one anyway. */
   "prop:label"?: (HelixTabPanel["label"]) | undefined;
+  /** Fired the first time a `lazy` panel is shown, once its template's content is in. */
+  "on:helix-load"?: ((e: HelixTabPanelHelixLoadElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -36146,6 +36266,12 @@ consumer's server markup does not have. A sheet carries the resting
 arrangement in its own `:host` rule and the selectors describe only the
 departures, which is what `orientation` does. */
   placement?: (HelixToast["placement"]) | undefined;
+  /** The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+the end of the line, or `start`, `top` or `bottom`. Unset is `end`. */
+  "swipe-direction"?: (HelixToast["swipeDirection"]) | undefined;
+  /** The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+the end of the line, or `start`, `top` or `bottom`. Unset is `end`. */
+  swipeDirection?: (HelixToast["swipeDirection"]) | undefined;
 
   /** A message is being dismissed, by its control or by its timer. The message sends it, and you can listen for it on the region. Cancelable: canceling it keeps the message. */
   "onhelix-dismiss"?: ((e: HelixToastHelixDismissElementEvent) => void) | undefined;
@@ -36193,6 +36319,12 @@ consumer's server markup does not have. A sheet carries the resting
 arrangement in its own `:host` rule and the selectors describe only the
 departures, which is what `orientation` does. */
   "prop:placement"?: (HelixToast["placement"]) | undefined;
+  /** The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+the end of the line, or `start`, `top` or `bottom`. Unset is `end`. */
+  "attr:swipe-direction"?: (HelixToast["swipeDirection"]) | undefined;
+  /** The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+the end of the line, or `start`, `top` or `bottom`. Unset is `end`. */
+  "prop:swipeDirection"?: (HelixToast["swipeDirection"]) | undefined;
   /** A message is being dismissed, by its control or by its timer. The message sends it, and you can listen for it on the region. Cancelable: canceling it keeps the message. */
   "on:helix-dismiss"?: ((e: HelixToastHelixDismissElementEvent) => void) | undefined;
 
@@ -37200,6 +37332,14 @@ The shape is `Carousel`'s, which is the nearest thing in the library: a
   "next-label"?: (HelixTour["nextLabel"]) | undefined;
   /** Label for the control that goes on. */
   nextLabel?: (HelixTour["nextLabel"]) | undefined;
+  /** What a press outside the current stop and its target does while the tour
+runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+Skip does, and `block` refuses the press. */
+  "outside-press"?: (HelixTour["outsidePress"]) | undefined;
+  /** What a press outside the current stop and its target does while the tour
+runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+Skip does, and `block` refuses the press. */
+  outsidePress?: (HelixTour["outsidePress"]) | undefined;
   /** Draws each stop's place in the run in its panel, as well as saying it. */
   progress?: (HelixTour["progress"]) | undefined;
   /** Each stop's place in the run, with `{index}` and `{count}` filled in and
@@ -37284,6 +37424,14 @@ The shape is `Carousel`'s, which is the nearest thing in the library: a
   "attr:next-label"?: (HelixTour["nextLabel"]) | undefined;
   /** Label for the control that goes on. */
   "prop:nextLabel"?: (HelixTour["nextLabel"]) | undefined;
+  /** What a press outside the current stop and its target does while the tour
+runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+Skip does, and `block` refuses the press. */
+  "attr:outside-press"?: (HelixTour["outsidePress"]) | undefined;
+  /** What a press outside the current stop and its target does while the tour
+runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+Skip does, and `block` refuses the press. */
+  "prop:outsidePress"?: (HelixTour["outsidePress"]) | undefined;
   /** Draws each stop's place in the run in its panel, as well as saying it. */
   "prop:progress"?: (HelixTour["progress"]) | undefined;
   /** Each stop's place in the run, with `{index}` and `{count}` filled in and
@@ -37376,6 +37524,9 @@ heading. */
 Reflected, because the styled tier places a dialog and a floating panel by
 it, and unset at rest, so no default is written onto the host. */
   type?: (HelixTourStop["type"]) | undefined;
+  /** Run as the tour reaches the stop, before it is shown: see the description
+above. A function, so it is set from script and has no attribute. */
+  effect?: (HelixTourStop["effect"]) | undefined;
 
   /** Fired when one of the stop's controls is pressed, to move the tour. */
   "onhelix-tour-ask"?: ((e: HelixTourStopHelixTourAskElementEvent) => void) | undefined;
@@ -37426,6 +37577,9 @@ heading. */
 Reflected, because the styled tier places a dialog and a floating panel by
 it, and unset at rest, so no default is written onto the host. */
   "prop:type"?: (HelixTourStop["type"]) | undefined;
+  /** Run as the tour reaches the stop, before it is shown: see the description
+above. A function, so it is set from script and has no attribute. */
+  "prop:effect"?: (HelixTourStop["effect"]) | undefined;
   /** Fired when one of the stop's controls is pressed, to move the tour. */
   "on:helix-tour-ask"?: ((e: HelixTourStopHelixTourAskElementEvent) => void) | undefined;
 
@@ -40182,6 +40336,19 @@ export type CustomElements = {
    * It pairs with `material`: a bar that does not stick is only ever over the
    * top of the page, so `glass` and `transparent` have nothing to be
    * translucent against and the `scrolled` state never lands.
+   * - `default-open`/`defaultOpen`: Whether the element starts open. Ignored once `open` is written.
+   * - `open`: Whether the element is open.
+   *
+   * One property, not two, so `dialog.open` answers the question anyone
+   * asking it meant. Writing always applies; `<helix-dialog open>` is the
+   * same statement in markup.
+   *
+   * **Not reflected, and that is required rather than tidy.** Reflection
+   * writes the resolved state back as an attribute, so an element that opened
+   * itself would put `open` on its own host: cloned, serialized for
+   * hydration, or diffed by a framework, it comes back holding whatever the
+   * last reader did rather than what the author wrote. `:state(open)` carries
+   * the resolved state for stylesheets, which is what the mirror is for.
    * - `content-align`/`contentAlign`: Where the middle region sits in the bar.
    *
    * Centered by default, which reads as the site's spine when the navigation is
@@ -40202,6 +40369,11 @@ export type CustomElements = {
    * - `menu-label`/`menuLabel`: The name of the toggle that opens a folded middle region.
    * - `scroller`: The id of the element whose scrolling lifts the bar, for an app shell that
    * scrolls a container instead of the window. Unset is the window.
+   * - `toggle-placement`/`togglePlacement`: Where the toggle that opens a folded middle region sits: at the end of the
+   * bar, after the trailing content, or with `start`, before the leading
+   * content.
+   *
+   * Optional, so the resting bar writes no attribute onto the host.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -40227,6 +40399,9 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
+   * - `toggle`: The folded region opened or closed. The event carries `newState` and `oldState`.
+   * - `helix-before-close`: The folded region is about to close. Cancelable: cancel it to keep it open.
+   * - `helix-before-open`: The folded region is about to open. Cancelable: cancel it to keep it closed.
    * - `helix-scrolled`: Fired when the page crosses the scroll threshold, with the new state. A custom state cannot be observed the way an attribute can, so listen for this event to follow it. The event uses the header's own threshold and hysteresis, so you do not need a second scroll listener.
    *
    * ## Slots
@@ -40238,6 +40413,20 @@ export type CustomElements = {
    * - `start`: Leading content, usually a wordmark.
    * - `menu-icon`: Replaces the glyph inside the toggle that opens a folded middle region.
    *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `requestOpen(next: boolean) => boolean`: Requests that the element open or close, and returns whether the change
+   * was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-open` or
+   * `helix-before-close` is a refusal and nothing moves. Nobody refusing means the
+   * element opens or closes itself, whether or not a consumer declared
+   * `open`: a declared property is a seed and a correction, and a consumer
+   * who wants the decision for themselves refuses it and assigns their own.
+   * - `toggleOpen() => boolean`: Requests the opposite of the current state.
+   *
    * ## CSS Custom Properties
    *
    * CSS variables available for styling the component.
@@ -41911,6 +42100,9 @@ export type CustomElements = {
    * separate actions. The semantics and the joining are separate questions:
    * `role="group"` and a shared name are what make a set of buttons a set, and
    * `helix-flex` gives the spacing without the group.
+   * - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one button pressed once one is, as React Aria's
+   * `disallowEmptySelection`: a press that would leave none pressed is
+   * refused.
    * - `label`: The group's name, read by screen readers.
    *
    * On the host through internals, so an author's `aria-label` still overrides
@@ -42322,6 +42514,7 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `pending`: The button is pending: `pending` is set. A ring turns over its hidden words.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-button": Partial<
@@ -46505,6 +46698,7 @@ export type CustomElements = {
    * - `copied`: The moment after a successful copy, while `copied-label` names the button.
    * - `failed`: The moment after a press that put nothing on the clipboard, while `error-label` names the button.
    * - `pending`: The button is pending: `pending` is set.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-copy-button": Partial<
@@ -51479,6 +51673,7 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `pending`: The button is pending: `pending` is set. A ring turns over its hidden icon.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-icon-button": Partial<
@@ -52648,6 +52843,8 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `entering`: From the moment the viewer opens until its entrance has finished.
+   * - `exiting`: From the moment the viewer closes until its exit has finished.
    * - `fullscreen`: While the viewer fills the screen.
    * - `idle`: The user has been still long enough for the controls to hide.
    * - `open`: While the viewer is open.
@@ -63415,6 +63612,8 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `lazy`: Whether the panel's content waits in a `<template>` until the panel is
+   * first shown.
    * - `selected`: Whether this panel is the visible one.
    * - `value`: Pairs the panel with the tab of the same value.
    * - `label`: The name of the panel, which is the text of the tab that opens it.
@@ -63448,6 +63647,12 @@ export type CustomElements = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `helix-load`: Fired the first time a `lazy` panel is shown, once its template's content is in.
+   *
    * ## Slots
    *
    * Areas where markup can be added to the component.
@@ -63470,6 +63675,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `loaded`: Once a `lazy` panel has been shown and its content is in.
    * - `selected`: While its tab is the one selected.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -63579,6 +63785,8 @@ export type CustomElements = {
    * - `(default)`: The tabs, as direct children of this element.
    * - `indicator`: A mark of your own, drawn inside the `indicator` part, where the selected tab's place and size reach it.
    * - `panels`: The panels, as direct children of this element. Panels inside a wrapper are not paired with tabs, because pairing reads only the direct children.
+   * - `scroll-end-icon`: Replaces the glyph on the button that scrolls the strip toward its end.
+   * - `scroll-start-icon`: Replaces the glyph on the button that scrolls the strip toward its start.
    *
    * ## Methods
    *
@@ -63612,7 +63820,9 @@ export type CustomElements = {
    * - `indicator`: The mark that moves to the selected tab. It carries the selected tab's place and size as `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size`.
    * - `panels`: The panel container.
    * - `scroll-end`: The button that scrolls the strip toward its end, shown under `scroll-controls` while there is more that way. It holds to the end of the strip.
+   * - `scroll-end-mark`: The glyph on that button, where none is slotted.
    * - `scroll-start`: The button that scrolls the strip toward its start, shown under `scroll-controls` while there is more that way. It holds to the start of the strip.
+   * - `scroll-start-mark`: The glyph on that button, where none is slotted.
    * - `tabs`: The tab list.
    *
    * ## CSS States
@@ -63689,6 +63899,7 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The tab's label.
+   * - `dismiss-icon`: Replaces the glyph on the mark that closes a `dismissible` tab.
    *
    * ## Methods
    *
@@ -63727,6 +63938,7 @@ export type CustomElements = {
    * Custom selectors for styling elements within the component.
    *
    * - `dismiss`: The mark a pointer presses to close a `dismissible` tab.
+   * - `dismiss-mark`: The glyph on that mark, where none is slotted.
    * - `tab`: The tab itself.
    *
    * ## CSS States
@@ -65529,6 +65741,7 @@ export type CustomElements = {
    * - `--toast-tone-color`: Color of the mark and the countdown bar. Unset, each `tone` takes its own color, so set it per tone, as in `helix-toast-item[tone="danger"]`.
    * - `--toast-duration`: How long this message stays, in milliseconds, for a progress hint.
    * - `--toast-swipe-x`: How far a swipe has moved the message across, in pixels, toward the right.
+   * - `--toast-swipe-y`: How far a swipe has moved the message down, in pixels, under a `swipe-direction` of `top` or `bottom`.
    *
    * ## CSS Parts
    *
@@ -65550,7 +65763,7 @@ 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.
+   * - `paused`: The dismiss timer is paused, while a pointer or focus is on the message or in the stack, 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.
    */
@@ -65604,6 +65817,8 @@ export type CustomElements = {
    * consumer's server markup does not have. A sheet carries the resting
    * arrangement in its own `:host` rule and the selectors describe only the
    * departures, which is what `orientation` does.
+   * - `swipe-direction`/`swipeDirection`: The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+   * the end of the line, or `start`, `top` or `bottom`. Unset is `end`.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -66449,6 +66664,9 @@ export type CustomElements = {
    * `undefined` until somebody sets one.
    * - `label`: The tour's name, read by screen readers, such as "Getting started".
    * - `next-label`/`nextLabel`: Label for the control that goes on.
+   * - `outside-press`/`outsidePress`: What a press outside the current stop and its target does while the tour
+   * runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+   * Skip does, and `block` refuses the press.
    * - `progress`: Draws each stop's place in the run in its panel, as well as saying it.
    * - `progress-label`/`progressLabel`: Each stop's place in the run, with `{index}` and `{count}` filled in and
    * written in the locale. Translate it with the rest of your text.
@@ -66541,6 +66759,7 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `open`: While the tour is running.
+   * - `preparing`: While the tour waits for the current stop's `effect` before showing the stop.
    * - `waiting`: While the tour waits at a `wait` stop for its target to be on the page.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -66580,6 +66799,8 @@ export type CustomElements = {
    *
    * Reflected, because the styled tier places a dialog and a floating panel by
    * it, and unset at rest, so no default is written onto the host.
+   * - `effect`: Run as the tour reaches the stop, before it is shown: see the description
+   * above. A function, so it is set from script and has no attribute. (property only)
    * - `target`: The element the stop points at, or `null` when no element has the `for` id. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -66673,6 +66894,8 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `entering`: From the moment the stop is shown until its entrance has finished.
+   * - `exiting`: From the moment the stop is left until its exit has finished.
    * - `placed-bottom`: The panel sits below its target.
    * - `placed-left`: The panel sits to the left of its target.
    * - `placed-right`: The panel sits to the right of its target.
@@ -68621,6 +68844,19 @@ export type CustomElementsSolidJs = {
    * It pairs with `material`: a bar that does not stick is only ever over the
    * top of the page, so `glass` and `transparent` have nothing to be
    * translucent against and the `scrolled` state never lands.
+   * - `default-open`/`defaultOpen`: Whether the element starts open. Ignored once `open` is written.
+   * - `open`: Whether the element is open.
+   *
+   * One property, not two, so `dialog.open` answers the question anyone
+   * asking it meant. Writing always applies; `<helix-dialog open>` is the
+   * same statement in markup.
+   *
+   * **Not reflected, and that is required rather than tidy.** Reflection
+   * writes the resolved state back as an attribute, so an element that opened
+   * itself would put `open` on its own host: cloned, serialized for
+   * hydration, or diffed by a framework, it comes back holding whatever the
+   * last reader did rather than what the author wrote. `:state(open)` carries
+   * the resolved state for stylesheets, which is what the mirror is for.
    * - `content-align`/`contentAlign`: Where the middle region sits in the bar.
    *
    * Centered by default, which reads as the site's spine when the navigation is
@@ -68641,6 +68877,11 @@ export type CustomElementsSolidJs = {
    * - `menu-label`/`menuLabel`: The name of the toggle that opens a folded middle region.
    * - `scroller`: The id of the element whose scrolling lifts the bar, for an app shell that
    * scrolls a container instead of the window. Unset is the window.
+   * - `toggle-placement`/`togglePlacement`: Where the toggle that opens a folded middle region sits: at the end of the
+   * bar, after the trailing content, or with `start`, before the leading
+   * content.
+   *
+   * Optional, so the resting bar writes no attribute onto the host.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -68666,6 +68907,9 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
+   * - `toggle`: The folded region opened or closed. The event carries `newState` and `oldState`.
+   * - `helix-before-close`: The folded region is about to close. Cancelable: cancel it to keep it open.
+   * - `helix-before-open`: The folded region is about to open. Cancelable: cancel it to keep it closed.
    * - `helix-scrolled`: Fired when the page crosses the scroll threshold, with the new state. A custom state cannot be observed the way an attribute can, so listen for this event to follow it. The event uses the header's own threshold and hysteresis, so you do not need a second scroll listener.
    *
    * ## Slots
@@ -68677,6 +68921,20 @@ export type CustomElementsSolidJs = {
    * - `start`: Leading content, usually a wordmark.
    * - `menu-icon`: Replaces the glyph inside the toggle that opens a folded middle region.
    *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `requestOpen(next: boolean) => boolean`: Requests that the element open or close, and returns whether the change
+   * was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-open` or
+   * `helix-before-close` is a refusal and nothing moves. Nobody refusing means the
+   * element opens or closes itself, whether or not a consumer declared
+   * `open`: a declared property is a seed and a correction, and a consumer
+   * who wants the decision for themselves refuses it and assigns their own.
+   * - `toggleOpen() => boolean`: Requests the opposite of the current state.
+   *
    * ## CSS Custom Properties
    *
    * CSS variables available for styling the component.
@@ -70381,6 +70639,9 @@ export type CustomElementsSolidJs = {
    * separate actions. The semantics and the joining are separate questions:
    * `role="group"` and a shared name are what make a set of buttons a set, and
    * `helix-flex` gives the spacing without the group.
+   * - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one button pressed once one is, as React Aria's
+   * `disallowEmptySelection`: a press that would leave none pressed is
+   * refused.
    * - `label`: The group's name, read by screen readers.
    *
    * On the host through internals, so an author's `aria-label` still overrides
@@ -70795,6 +71056,7 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `pending`: The button is pending: `pending` is set. A ring turns over its hidden words.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-button": Partial<
@@ -75029,6 +75291,7 @@ export type CustomElementsSolidJs = {
    * - `copied`: The moment after a successful copy, while `copied-label` names the button.
    * - `failed`: The moment after a press that put nothing on the clipboard, while `error-label` names the button.
    * - `pending`: The button is pending: `pending` is set.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-copy-button": Partial<
@@ -80075,6 +80338,7 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `pending`: The button is pending: `pending` is set. A ring turns over its hidden icon.
+   * - `pressed`: A Button Group in a selection mode has this button pressed.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-icon-button": Partial<
@@ -81267,6 +81531,8 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `entering`: From the moment the viewer opens until its entrance has finished.
+   * - `exiting`: From the moment the viewer closes until its exit has finished.
    * - `fullscreen`: While the viewer fills the screen.
    * - `idle`: The user has been still long enough for the controls to hide.
    * - `open`: While the viewer is open.
@@ -92248,6 +92514,8 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `lazy`: Whether the panel's content waits in a `<template>` until the panel is
+   * first shown.
    * - `selected`: Whether this panel is the visible one.
    * - `value`: Pairs the panel with the tab of the same value.
    * - `label`: The name of the panel, which is the text of the tab that opens it.
@@ -92281,6 +92549,12 @@ export type CustomElementsSolidJs = {
    * browser harness's awaits it alone: a browser always runs the frame, and a
    * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
    *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `helix-load`: Fired the first time a `lazy` panel is shown, once its template's content is in.
+   *
    * ## Slots
    *
    * Areas where markup can be added to the component.
@@ -92303,6 +92577,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `loaded`: Once a `lazy` panel has been shown and its content is in.
    * - `selected`: While its tab is the one selected.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -92415,6 +92690,8 @@ export type CustomElementsSolidJs = {
    * - `(default)`: The tabs, as direct children of this element.
    * - `indicator`: A mark of your own, drawn inside the `indicator` part, where the selected tab's place and size reach it.
    * - `panels`: The panels, as direct children of this element. Panels inside a wrapper are not paired with tabs, because pairing reads only the direct children.
+   * - `scroll-end-icon`: Replaces the glyph on the button that scrolls the strip toward its end.
+   * - `scroll-start-icon`: Replaces the glyph on the button that scrolls the strip toward its start.
    *
    * ## Methods
    *
@@ -92448,7 +92725,9 @@ export type CustomElementsSolidJs = {
    * - `indicator`: The mark that moves to the selected tab. It carries the selected tab's place and size as `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size`.
    * - `panels`: The panel container.
    * - `scroll-end`: The button that scrolls the strip toward its end, shown under `scroll-controls` while there is more that way. It holds to the end of the strip.
+   * - `scroll-end-mark`: The glyph on that button, where none is slotted.
    * - `scroll-start`: The button that scrolls the strip toward its start, shown under `scroll-controls` while there is more that way. It holds to the start of the strip.
+   * - `scroll-start-mark`: The glyph on that button, where none is slotted.
    * - `tabs`: The tab list.
    *
    * ## CSS States
@@ -92527,6 +92806,7 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The tab's label.
+   * - `dismiss-icon`: Replaces the glyph on the mark that closes a `dismissible` tab.
    *
    * ## Methods
    *
@@ -92565,6 +92845,7 @@ export type CustomElementsSolidJs = {
    * Custom selectors for styling elements within the component.
    *
    * - `dismiss`: The mark a pointer presses to close a `dismissible` tab.
+   * - `dismiss-mark`: The glyph on that mark, where none is slotted.
    * - `tab`: The tab itself.
    *
    * ## CSS States
@@ -94394,6 +94675,7 @@ export type CustomElementsSolidJs = {
    * - `--toast-tone-color`: Color of the mark and the countdown bar. Unset, each `tone` takes its own color, so set it per tone, as in `helix-toast-item[tone="danger"]`.
    * - `--toast-duration`: How long this message stays, in milliseconds, for a progress hint.
    * - `--toast-swipe-x`: How far a swipe has moved the message across, in pixels, toward the right.
+   * - `--toast-swipe-y`: How far a swipe has moved the message down, in pixels, under a `swipe-direction` of `top` or `bottom`.
    *
    * ## CSS Parts
    *
@@ -94415,7 +94697,7 @@ 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.
+   * - `paused`: The dismiss timer is paused, while a pointer or focus is on the message or in the stack, 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.
    */
@@ -94472,6 +94754,8 @@ export type CustomElementsSolidJs = {
    * consumer's server markup does not have. A sheet carries the resting
    * arrangement in its own `:host` rule and the selectors describe only the
    * departures, which is what `orientation` does.
+   * - `swipe-direction`/`swipeDirection`: The edge a touch or a pen swipes a message toward to dismiss it: `end`,
+   * the end of the line, or `start`, `top` or `bottom`. Unset is `end`.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -95334,6 +95618,9 @@ export type CustomElementsSolidJs = {
    * `undefined` until somebody sets one.
    * - `label`: The tour's name, read by screen readers, such as "Getting started".
    * - `next-label`/`nextLabel`: Label for the control that goes on.
+   * - `outside-press`/`outsidePress`: What a press outside the current stop and its target does while the tour
+   * runs. Unset, nothing: the page stays usable. `close` ends the tour, as
+   * Skip does, and `block` refuses the press.
    * - `progress`: Draws each stop's place in the run in its panel, as well as saying it.
    * - `progress-label`/`progressLabel`: Each stop's place in the run, with `{index}` and `{count}` filled in and
    * written in the locale. Translate it with the rest of your text.
@@ -95426,6 +95713,7 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `open`: While the tour is running.
+   * - `preparing`: While the tour waits for the current stop's `effect` before showing the stop.
    * - `waiting`: While the tour waits at a `wait` stop for its target to be on the page.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -95467,6 +95755,8 @@ export type CustomElementsSolidJs = {
    *
    * Reflected, because the styled tier places a dialog and a floating panel by
    * it, and unset at rest, so no default is written onto the host.
+   * - `effect`: Run as the tour reaches the stop, before it is shown: see the description
+   * above. A function, so it is set from script and has no attribute. (property only)
    * - `target`: The element the stop points at, or `null` when no element has the `for` id. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
@@ -95560,6 +95850,8 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `entering`: From the moment the stop is shown until its entrance has finished.
+   * - `exiting`: From the moment the stop is left until its exit has finished.
    * - `placed-bottom`: The panel sits below its target.
    * - `placed-left`: The panel sits to the left of its target.
    * - `placed-right`: The panel sits to the right of its target.
@@ -99261,6 +99553,8 @@ export type CustomCssProperties = {
   "--toast-duration"?: (string) | undefined;
   /** How far a swipe has moved the message across, in pixels, toward the right. */
   "--toast-swipe-x"?: (string) | undefined;
+  /** How far a swipe has moved the message down, in pixels, under a `swipe-direction` of `top` or `bottom`. */
+  "--toast-swipe-y"?: (string) | undefined;
   /** Space between one message and the next. */
   "--toast-gap"?: (string) | undefined;
   /** Width of a message. */