@fusion.dev/helix 0.39.0 → 0.40.0

package/custom-elements.json

@@ -85,7 +85,7 @@
               }
             },
             {
-              "description": "Padding wrapper inside the animated region.",
+              "description": "The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.",
               "name": "content-inner",
               "inheritedFrom": {
                 "name": "HelixHeadlessAccordionItem",
@@ -649,44 +649,6 @@
               }
             }
           ],
-          "events": [
-            {
-              "type": {
-                "text": "HelixBeforeOpenEvent"
-              },
-              "description": "Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.",
-              "name": "helix-before-open",
-              "reactProp": "onhelix-before-open",
-              "inheritedFrom": {
-                "name": "HelixHeadlessAccordionItem",
-                "module": "src/accordion/item/accordion-item.ts"
-              }
-            },
-            {
-              "type": {
-                "text": "HelixBeforeCloseEvent"
-              },
-              "description": "Fired before the section closes, and cancelable.",
-              "name": "helix-before-close",
-              "reactProp": "onhelix-before-close",
-              "inheritedFrom": {
-                "name": "HelixHeadlessAccordionItem",
-                "module": "src/accordion/item/accordion-item.ts"
-              }
-            },
-            {
-              "type": {
-                "text": "Event"
-              },
-              "description": "Says the state moved, carrying `newState` and `oldState`.",
-              "name": "toggle",
-              "reactProp": "ontoggle",
-              "inheritedFrom": {
-                "name": "HelixHeadlessAccordionItem",
-                "module": "src/accordion/item/accordion-item.ts"
-              }
-            }
-          ],
           "superclass": {
             "name": "HelixHeadlessAccordionItem",
             "package": "@fusion.dev/helix-headless/accordion"
@@ -694,7 +656,7 @@
           "summary": "One collapsible section of an accordion.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/accordion",
             "aliases": [
               "Collapsible",
@@ -758,6 +720,44 @@
               }
             }
           ],
+          "events": [
+            {
+              "type": {
+                "text": "HelixBeforeCloseEvent"
+              },
+              "description": "Fired before the section closes, and cancelable.",
+              "name": "helix-before-close",
+              "reactProp": "onhelix-before-close",
+              "inheritedFrom": {
+                "name": "HelixHeadlessAccordionItem",
+                "module": "src/accordion/item/accordion-item.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeOpenEvent"
+              },
+              "description": "Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves.",
+              "name": "helix-before-open",
+              "reactProp": "onhelix-before-open",
+              "inheritedFrom": {
+                "name": "HelixHeadlessAccordionItem",
+                "module": "src/accordion/item/accordion-item.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Says the state moved, carrying `newState` and `oldState`.",
+              "name": "toggle",
+              "reactProp": "ontoggle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessAccordionItem",
+                "module": "src/accordion/item/accordion-item.ts"
+              }
+            }
+          ],
           "cssStates": [
             {
               "description": "While the item is open.",
@@ -1255,7 +1255,7 @@
           "helix": {
             "category": "layout",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/accordion",
             "aliases": [
               "Collapse",
@@ -1278,7 +1278,7 @@
                 "slug": "events"
               },
               {
-                "description": "A hairline around the set, for a panel that needs an edge against the page.",
+                "description": "A hairline around each item, for a set sitting directly on the page.",
                 "slug": "outlined"
               },
               {
@@ -68010,7 +68010,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The tick and the arrow hold their space whether or not they are showing, so\nthe labels in a menu start at one place and the rows read as a column rather\nthan as a ragged list.",
+          "description": "A row draws a column beside its label only where it has something to put in\none, and the width is the menu's rather than the row's: the page reserves a\nleading or a trailing track as soon as any row on it fills one, so every\nlabel on that page starts at the same edge and a page that fills neither pays\nfor neither. A row knows about its own slots and nothing about its\nneighbors, which is why the reservation is not made here.",
           "name": "HelixMenuItem",
           "cssProperties": [
             {
@@ -68677,7 +68677,7 @@
           "summary": "One row in a menu: a command, a choice, or a way into a submenu.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/menu",
             "aliases": [
               "Menu option",
@@ -69836,7 +69836,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/menu",
             "aliases": [
               "Dropdown",
@@ -71668,7 +71668,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/navigation",
             "aliases": [
               "Nav",
@@ -82136,7 +82136,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/pagination",
             "aliases": [
               "Pager",
@@ -82152,7 +82152,7 @@
                 "slug": "preview"
               },
               {
-                "description": "Large counts written short, so a summary does not wrap at page nine hundred.",
+                "description": "Large counts grouped for the locale and written short, so a summary does not wrap at page nine hundred.",
                 "slug": "compact-counts"
               },
               {
@@ -83239,7 +83239,7 @@
           "summary": "Chooses how many items a page holds.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/pagination",
             "aliases": [
               "Page size",
@@ -83817,7 +83817,7 @@
           "summary": "Reads out which items of how many are on show.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/pagination",
             "aliases": [
               "Result count",
@@ -107901,7 +107901,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/steps",
             "aliases": [
               "Stepper",
@@ -107917,11 +107917,11 @@
                 "slug": "preview"
               },
               {
-                "description": "A sequence with the third step current, so before and after both show.",
+                "description": "A sequence with the middle step current, so a finished one and one still ahead both show.",
                 "slug": "active"
               },
               {
-                "description": "Steps that fold to the current one where there is no room for all of them.",
+                "description": "Down a column, where only the stage the reader is in holds its content open.",
                 "slug": "collapsible"
               },
               {
@@ -108557,7 +108557,7 @@
           "summary": "One stage in a sequence.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/steps",
             "aliases": [
               "Stage"
@@ -108578,7 +108578,7 @@
               }
             },
             {
-              "description": "What the stage holds, shown while it is the current one.",
+              "description": "What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with; the styled tier opens it on the current step down a column, and a row has no space under a step to open it into.",
               "name": "content",
               "inheritedFrom": {
                 "name": "HelixHeadlessStep",
@@ -113308,7 +113308,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Selection is marked with a rule under the active tab rather than a filled\npill, which keeps the row flat and lets the underline animate between tabs as\na movement instead of two separate fills.",
+          "description": "One mark travels between the tabs rather than each of them filling and\nemptying in turn. A fill that swaps is two things changing at once and reads\nas a flicker; one that moves is a single object the eye follows, and it says\nwhere the current tab was as well as where it is. `Navigation` marks its\ndestinations the same way and for the same reason.\n\nWhat the mark is depends on `variant`: unset it is a raised pill on the\nselected tab with nothing behind the row, `underlined` makes it a bar along\nthe bottom of the strip on a rule, and `segmented` grows it to the tab's own\nbox inside a sunken track.",
           "name": "HelixTabs",
           "cssParts": [
             {
@@ -113338,7 +113338,7 @@
           ],
           "slots": [
             {
-              "description": "The tabs.",
+              "description": "The tabs, which are this element's own children.",
               "name": "",
               "inheritedFrom": {
                 "name": "HelixHeadlessTabs",
@@ -113346,7 +113346,7 @@
               }
             },
             {
-              "description": "The panels.",
+              "description": "The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.",
               "name": "panels",
               "inheritedFrom": {
                 "name": "HelixHeadlessTabs",

package/dist/accordion/item/accordion-item.d.ts

@@ -12,19 +12,17 @@ import type { CSSResultGroup } from 'lit';
  * Usable on its own as a disclosure, with no accordion around it.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Collapsible, Expander, Disclosure
  * @documentation https://fusion.dev/helix/components/accordion
  *
  * @slot - The content revealed when open.
  * @slot summary - The always-visible trigger content.
  *
- * @event {HelixBeforeOpenEvent} helix-before-open - Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.
- *
  * @csspart chevron - The open and close indicator.
  * @csspart container - The outer wrapper.
  * @csspart content - The revealed region.
- * @csspart content-inner - Padding wrapper inside the animated region.
+ * @csspart content-inner - The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
  * @csspart trigger - The clickable summary row.
  *
  * @cssproperty --accordion-item-padding - Inset of the trigger and content.

package/dist/accordion/root/accordion-root.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * the default: an accordion is a list, where a card is a surface.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category layout
  * @aliases Collapse, Expander group
  * @documentation https://fusion.dev/helix/components/accordion

package/dist/menu/item/menu-item.d.ts

@@ -4,12 +4,15 @@ import type { CSSResultGroup } from 'lit';
  * @summary One row in a menu: a command, a choice, or a way into a submenu.
  *
  * @description
- * The tick and the arrow hold their space whether or not they are showing, so
- * the labels in a menu start at one place and the rows read as a column rather
- * than as a ragged list.
+ * A row draws a column beside its label only where it has something to put in
+ * one, and the width is the menu's rather than the row's: the page reserves a
+ * leading or a trailing track as soon as any row on it fills one, so every
+ * label on that page starts at the same edge and a page that fills neither pays
+ * for neither. A row knows about its own slots and nothing about its
+ * neighbors, which is why the reservation is not made here.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Menu option, Menu row
  * @documentation https://fusion.dev/helix/components/menu
  *

package/dist/menu/root/menu-root.d.ts

@@ -11,7 +11,7 @@ import type { CSSResultGroup } from 'lit';
  * one panel and reads the same on a phone as on a desk.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @aliases Dropdown, Action menu
  * @documentation https://fusion.dev/helix/components/menu

package/dist/navigation/root/navigation-root.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * says where the current page was as well as where it is.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Nav, NavList, Tabs
  * @documentation https://fusion.dev/helix/components/navigation

package/dist/pagination/root/pagination-root.d.ts

@@ -29,7 +29,7 @@ import type { CSSResultGroup } from 'lit';
  * is a way through rather than a destination, so it does not compete.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Pager, Page nav
  * @documentation https://fusion.dev/helix/components/pagination

package/dist/pagination/size/pagination-size.d.ts

@@ -15,7 +15,7 @@ import '../../select/index.js';
  * as the select it is.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Page size, Rows per page
  * @documentation https://fusion.dev/helix/components/pagination
  *

package/dist/pagination/summary/pagination-summary.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * a way to move through it.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Result count, Range
  * @documentation https://fusion.dev/helix/components/pagination
  */

package/dist/steps/root/steps-root.d.ts

@@ -14,7 +14,7 @@ import type { CSSResultGroup } from 'lit';
  * second name for it here would be a second thing to keep in step.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Stepper, Wizard, Progress steps
  * @documentation https://fusion.dev/helix/components/steps

package/dist/steps/step/step.d.ts

@@ -5,7 +5,7 @@ import '../../button/index.js';
  * @summary One stage in a sequence.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Stage
  * @documentation https://fusion.dev/helix/components/steps
  */

package/dist/tabs/root/tabs-root.d.ts

@@ -4,17 +4,24 @@ import type { CSSResultGroup } from 'lit';
  * @summary A row of tabs and the panel each one shows.
  *
  * @description
- * Selection is marked with a rule under the active tab rather than a filled
- * pill, which keeps the row flat and lets the underline animate between tabs as
- * a movement instead of two separate fills.
+ * One mark travels between the tabs rather than each of them filling and
+ * emptying in turn. A fill that swaps is two things changing at once and reads
+ * as a flicker; one that moves is a single object the eye follows, and it says
+ * where the current tab was as well as where it is. `Navigation` marks its
+ * destinations the same way and for the same reason.
+ *
+ * What the mark is depends on `variant`: unset it is a raised pill on the
+ * selected tab with nothing behind the row, `underlined` makes it a bar along
+ * the bottom of the strip on a rule, and `segmented` grows it to the tab's own
+ * box inside a sunken track.
  *
  * @since 0.1.0
  * @status experimental
  * @category navigation
  * @documentation https://fusion.dev/helix/components/tabs
  *
- * @slot - The tabs.
- * @slot panels - The panels.
+ * @slot - The tabs, which are this element's own children.
+ * @slot panels - The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
  *
  * @csspart panels - The panel container.
  * @csspart tabs - The tab list.

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.39.0",
+  "version": "0.40.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -47,14 +47,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.39.0",
-    "@fusion.dev/helix-headless": "0.39.0",
-    "@fusion.dev/helix-styles": "0.39.0"
+    "@fusion.dev/helix-core": "0.40.0",
+    "@fusion.dev/helix-headless": "0.40.0",
+    "@fusion.dev/helix-styles": "0.40.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.39.0",
-    "@fusion.dev/helix-testing": "0.39.0",
+    "@fusion.dev/helix-cem": "0.40.0",
+    "@fusion.dev/helix-testing": "0.40.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -390,12 +390,12 @@ export type HelixAccordionItemElementEvent<E = Event> = TypedEvent<
   HelixAccordionItem,
   E
 >;
-/** `helix-before-open` event type */
-export type HelixAccordionItemHelixBeforeOpenElementEvent =
-  HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
 /** `helix-before-close` event type */
 export type HelixAccordionItemHelixBeforeCloseElementEvent =
   HelixAccordionItemElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixAccordionItemHelixBeforeOpenElementEvent =
+  HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixAccordionItemProps = {
   /** Whether the element is open.
@@ -452,14 +452,14 @@ it, and the resting state of a reflected property is the attribute's
 absence. Caught by `hydration.dom.spec.ts`. */
   name?: (HelixAccordionItem["name"]) | undefined;
 
-  /** Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "onhelix-before-open"?: ((
-    e: HelixAccordionItemHelixBeforeOpenElementEvent,
-  ) => void) | undefined;
   /** Fired before the section closes, and cancelable. */
   "onhelix-before-close"?: ((
     e: HelixAccordionItemHelixBeforeCloseElementEvent,
   ) => void) | undefined;
+  /** Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "onhelix-before-open"?: ((
+    e: HelixAccordionItemHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
   ontoggle?: ((e: HelixAccordionItemElementEvent) => void) | undefined;
 };
@@ -518,14 +518,14 @@ empty string writes `name=""` onto every item ever rendered: Lit reflects
 it, and the resting state of a reflected property is the attribute's
 absence. Caught by `hydration.dom.spec.ts`. */
   "prop:name"?: (HelixAccordionItem["name"]) | undefined;
-  /** Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "on:helix-before-open"?: ((
-    e: HelixAccordionItemHelixBeforeOpenElementEvent,
-  ) => void) | undefined;
   /** Fired before the section closes, and cancelable. */
   "on:helix-before-close"?: ((
     e: HelixAccordionItemHelixBeforeCloseElementEvent,
   ) => void) | undefined;
+  /** Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "on:helix-before-open"?: ((
+    e: HelixAccordionItemHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
   "on:toggle"?: ((e: HelixAccordionItemElementEvent) => void) | undefined;
 
@@ -19970,8 +19970,8 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-open`: Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-before-close`: Fired before the section closes, and cancelable.
+   * - `helix-before-open`: Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *
    * ## Slots
@@ -20012,7 +20012,7 @@ export type CustomElements = {
    * - `chevron`: The open and close indicator.
    * - `container`: The outer wrapper.
    * - `content`: The revealed region.
-   * - `content-inner`: Padding wrapper inside the animated region.
+   * - `content-inner`: The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
    * - `trigger`: The clickable summary row.
    *
    * ## CSS States
@@ -29273,9 +29273,12 @@ export type CustomElements = {
   >;
 
   /**
-   * The tick and the arrow hold their space whether or not they are showing, so
-   * the labels in a menu start at one place and the rows read as a column rather
-   * than as a ragged list.
+   * A row draws a column beside its label only where it has something to put in
+   * one, and the width is the menu's rather than the row's: the page reserves a
+   * leading or a trailing track as soon as any row on it fills one, so every
+   * label on that page starts at the same edge and a page that fills neither pays
+   * for neither. A row knows about its own slots and nothing about its
+   * neighbors, which is why the reservation is not made here.
    *
    * ## Attributes & Properties
    *
@@ -34770,7 +34773,7 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The step's name.
-   * - `content`: What the stage holds, shown while it is the current one.
+   * - `content`: What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with; the styled tier opens it on the current step down a column, and a row has no space under a step to open it into.
    * - `description`: A line under the name, for what the stage is for.
    * - `marker`: Replaces the number, or the check a complete step shows.
    *
@@ -35412,9 +35415,16 @@ export type CustomElements = {
   >;
 
   /**
-   * Selection is marked with a rule under the active tab rather than a filled
-   * pill, which keeps the row flat and lets the underline animate between tabs as
-   * a movement instead of two separate fills.
+   * One mark travels between the tabs rather than each of them filling and
+   * emptying in turn. A fill that swaps is two things changing at once and reads
+   * as a flicker; one that moves is a single object the eye follows, and it says
+   * where the current tab was as well as where it is. `Navigation` marks its
+   * destinations the same way and for the same reason.
+   *
+   * What the mark is depends on `variant`: unset it is a raised pill on the
+   * selected tab with nothing behind the row, `underlined` makes it a bar along
+   * the bottom of the strip on a rule, and `segmented` grows it to the tab's own
+   * box inside a sunken track.
    *
    * ## Attributes & Properties
    *
@@ -35484,8 +35494,8 @@ export type CustomElements = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The tabs.
-   * - `panels`: The panels.
+   * - `(default)`: The tabs, which are this element's own children.
+   * - `panels`: The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
    *
    * ## Methods
    *
@@ -38810,8 +38820,8 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-open`: Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-before-close`: Fired before the section closes, and cancelable.
+   * - `helix-before-open`: Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *
    * ## Slots
@@ -38852,7 +38862,7 @@ export type CustomElementsSolidJs = {
    * - `chevron`: The open and close indicator.
    * - `container`: The outer wrapper.
    * - `content`: The revealed region.
-   * - `content-inner`: Padding wrapper inside the animated region.
+   * - `content-inner`: The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
    * - `trigger`: The clickable summary row.
    *
    * ## CSS States
@@ -48302,9 +48312,12 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * The tick and the arrow hold their space whether or not they are showing, so
-   * the labels in a menu start at one place and the rows read as a column rather
-   * than as a ragged list.
+   * A row draws a column beside its label only where it has something to put in
+   * one, and the width is the menu's rather than the row's: the page reserves a
+   * leading or a trailing track as soon as any row on it fills one, so every
+   * label on that page starts at the same edge and a page that fills neither pays
+   * for neither. A row knows about its own slots and nothing about its
+   * neighbors, which is why the reservation is not made here.
    *
    * ## Attributes & Properties
    *
@@ -53933,7 +53946,7 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The step's name.
-   * - `content`: What the stage holds, shown while it is the current one.
+   * - `content`: What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with; the styled tier opens it on the current step down a column, and a row has no space under a step to open it into.
    * - `description`: A line under the name, for what the stage is for.
    * - `marker`: Replaces the number, or the check a complete step shows.
    *
@@ -54597,9 +54610,16 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * Selection is marked with a rule under the active tab rather than a filled
-   * pill, which keeps the row flat and lets the underline animate between tabs as
-   * a movement instead of two separate fills.
+   * One mark travels between the tabs rather than each of them filling and
+   * emptying in turn. A fill that swaps is two things changing at once and reads
+   * as a flicker; one that moves is a single object the eye follows, and it says
+   * where the current tab was as well as where it is. `Navigation` marks its
+   * destinations the same way and for the same reason.
+   *
+   * What the mark is depends on `variant`: unset it is a raised pill on the
+   * selected tab with nothing behind the row, `underlined` makes it a bar along
+   * the bottom of the strip on a rule, and `segmented` grows it to the tab's own
+   * box inside a sunken track.
    *
    * ## Attributes & Properties
    *
@@ -54669,8 +54689,8 @@ export type CustomElementsSolidJs = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The tabs.
-   * - `panels`: The panels.
+   * - `(default)`: The tabs, which are this element's own children.
+   * - `panels`: The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
    *
    * ## Methods
    *

package/types/vue.d.ts

@@ -138,8 +138,8 @@ import type {
   HelixVideoPlaylist,
   HelixVideo,
   HelixVirtualList,
-  HelixBeforeOpenEvent,
   HelixBeforeCloseEvent,
+  HelixBeforeOpenEvent,
   HelixDismissEvent,
   HelixScrolledEvent,
   HelixSelectEvent,
@@ -218,12 +218,12 @@ export type HelixAccordionItemElementEvent<E = Event> = TypedEvent<
   HelixAccordionItem,
   E
 >;
-/** `helix-before-open` event type */
-export type HelixAccordionItemHelixBeforeOpenElementEvent =
-  HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
 /** `helix-before-close` event type */
 export type HelixAccordionItemHelixBeforeCloseElementEvent =
   HelixAccordionItemElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixAccordionItemHelixBeforeOpenElementEvent =
+  HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixAccordionItemVueProps = {
   /** Whether the element is open.
@@ -282,10 +282,10 @@ absence. Caught by `hydration.dom.spec.ts`. */
 };
 
 export type HelixAccordionItemVueEvents = {
-  /** Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "helix-before-open": HelixAccordionItemHelixBeforeOpenElementEvent;
   /** Fired before the section closes, and cancelable. */
   "helix-before-close": HelixAccordionItemHelixBeforeCloseElementEvent;
+  /** Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "helix-before-open": HelixAccordionItemHelixBeforeOpenElementEvent;
   /** Says the state moved, carrying `newState` and `oldState`. */
   toggle: HelixAccordionItemElementEvent;
 };
@@ -11629,7 +11629,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixMegamenuVueProps,
     HelixMegamenuVueEvents
   >;
-  /** The tick and the arrow hold their space whether or not they are showing, so the labels in a menu start at one place and the rows read as a column rather than as a ragged list. */
+  /** A row draws a column beside its label only where it has something to put in one, and the width is the menu's rather than the row's: the page reserves a leading or a trailing track as soon as any row on it fills one, so every label on that page starts at the same edge and a page that fills neither pays for neither. A row knows about its own slots and nothing about its neighbors, which is why the reservation is not made here. */
   "helix-menu-item": DefineCustomElement<
     HelixMenuItem,
     HelixMenuItemVueProps,
@@ -11928,7 +11928,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixTabPanelVueProps,
     HelixTabPanelVueEvents
   >;
-  /** Selection is marked with a rule under the active tab rather than a filled pill, which keeps the row flat and lets the underline animate between tabs as a movement instead of two separate fills. */
+  /** One mark travels between the tabs rather than each of them filling and emptying in turn. A fill that swaps is two things changing at once and reads as a flicker; one that moves is a single object the eye follows, and it says where the current tab was as well as where it is. 'Navigation' marks its destinations the same way and for the same reason.  What the mark is depends on 'variant': unset it is a raised pill on the selected tab with nothing behind the row, 'underlined' makes it a bar along the bottom of the strip on a rule, and 'segmented' grows it to the tab's own box inside a sunken track. */
   "helix-tabs": DefineCustomElement<
     HelixTabs,
     HelixTabsVueProps,