@fusion.dev/helix 0.37.0 → 0.38.0

package/custom-elements.json

@@ -26164,7 +26164,7 @@
               "name": "--combobox-border-width"
             },
             {
-              "description": "Smallest the text field shrinks to",
+              "description": "Smallest the text field shrinks to once tags share its line.",
               "name": "--combobox-control-size"
             },
             {
@@ -26986,7 +26986,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.",
+              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
               "attribute": "multiple",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
@@ -27882,7 +27882,7 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/combobox",
             "aliases": [
               "Autocomplete",
@@ -28194,7 +28194,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.",
+              "description": "Whether more than one option can be chosen.\n\nThe list already does the work: `value` comes apart on commas, a press\ntoggles rather than replaces, and the arrows move without choosing. What\nthis adds is the tags, and keeping the panel open between picks.\n\nA comma is therefore not available inside an option's value, which is the\nlistbox's contract and not this element's to change.\n\n**The list is told, and the field is not.** `aria-multiselectable` belongs\nto `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in\nARIA 1.2; the list sets it on itself through `ElementInternals`, where a\nreader on the field hears it through `aria-controls`. This element wrote it\nonto its own `role=\"combobox\"` input as well, which an audit reports as a\nproperty the role does not support and no spec here ever asserted: the one\nthat covers this says in as many words that telling the list is what this\nelement is responsible for.",
               "fieldName": "multiple",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
@@ -42247,7 +42247,7 @@
           "name": "HelixDrawer",
           "cssProperties": [
             {
-              "description": "Filter applied behind a `material=\"glass\"` drawer. Follows the theme's material policy; set it to override the strength on one drawer.",
+              "description": "Filter applied behind a `frosted` or `glass` drawer. Follows the theme's material policy; set it to override the strength on one drawer.",
               "name": "--drawer-backdrop"
             },
             {
@@ -42267,7 +42267,7 @@
               "name": "--drawer-padding"
             },
             {
-              "description": "Padding above the content, which clears the close control.",
+              "description": "Padding above the header, which is a step deeper than the other three so the first line clears the window's own edge. Falls back to `--drawer-padding`, so setting that alone governs all four sides.",
               "name": "--drawer-padding-block-start"
             },
             {
@@ -42913,56 +42913,6 @@
               }
             }
           ],
-          "events": [
-            {
-              "type": {
-                "text": "HelixBeforeOpenEvent"
-              },
-              "description": "Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves.",
-              "name": "helix-before-open",
-              "reactProp": "onhelix-before-open",
-              "inheritedFrom": {
-                "name": "HelixHeadlessDrawer",
-                "module": "src/drawer/root/drawer-root.ts"
-              }
-            },
-            {
-              "type": {
-                "text": "Event"
-              },
-              "description": "Relayed, because the platform's own does not escape.",
-              "name": "close",
-              "reactProp": "onclose",
-              "inheritedFrom": {
-                "name": "HelixHeadlessDrawer",
-                "module": "src/drawer/root/drawer-root.ts"
-              }
-            },
-            {
-              "type": {
-                "text": "HelixBeforeCloseEvent"
-              },
-              "description": "Fired before the panel closes, and cancelable.",
-              "name": "helix-before-close",
-              "reactProp": "onhelix-before-close",
-              "inheritedFrom": {
-                "name": "HelixHeadlessDrawer",
-                "module": "src/drawer/root/drawer-root.ts"
-              }
-            },
-            {
-              "type": {
-                "text": "Event"
-              },
-              "description": "Says the state moved, carrying `newState` and `oldState`.",
-              "name": "toggle",
-              "reactProp": "ontoggle",
-              "inheritedFrom": {
-                "name": "HelixHeadlessDrawer",
-                "module": "src/drawer/root/drawer-root.ts"
-              }
-            }
-          ],
           "attributes": [
             {
               "name": "material",
@@ -43056,7 +43006,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drawer",
             "aliases": [
               "Sheet",
@@ -43091,6 +43041,56 @@
           },
           "tagName": "helix-drawer",
           "customElement": true,
+          "events": [
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Relayed, because the platform's own does not escape.",
+              "name": "close",
+              "reactProp": "onclose",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrawer",
+                "module": "src/drawer/root/drawer-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeCloseEvent"
+              },
+              "description": "Fired before the panel closes, and cancelable.",
+              "name": "helix-before-close",
+              "reactProp": "onhelix-before-close",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrawer",
+                "module": "src/drawer/root/drawer-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeOpenEvent"
+              },
+              "description": "Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.",
+              "name": "helix-before-open",
+              "reactProp": "onhelix-before-open",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrawer",
+                "module": "src/drawer/root/drawer-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Says the state moved, carrying `newState` and `oldState`.",
+              "name": "toggle",
+              "reactProp": "ontoggle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrawer",
+                "module": "src/drawer/root/drawer-root.ts"
+              }
+            }
+          ],
           "cssStates": [
             {
               "description": "While the drawer is open.",
@@ -43649,7 +43649,7 @@
           "summary": "One row of a drill-down, which may hold a page of its own.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drilldown",
             "aliases": [
               "Panel item",
@@ -44498,7 +44498,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drilldown",
             "aliases": [
               "Panel",
@@ -44672,6 +44672,14 @@
             }
           ],
           "cssStates": [
+            {
+              "description": "While a row's page is showing rather than the top one, so a frame around this can answer the depth it is at.",
+              "name": "drilled",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrilldown",
+                "module": "src/drilldown/root/drilldown-root.ts"
+              }
+            },
             {
               "description": "Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.",
               "name": "settled",
@@ -66824,7 +66832,7 @@
           "name": "HelixMegamenu",
           "cssProperties": [
             {
-              "description": "A filter behind the panel, for glass.",
+              "description": "A filter behind the panel, which is `none` until one is asked for: this family carries no `material`, so the pair is two hooks rather than a word.",
               "name": "--megamenu-backdrop"
             },
             {
@@ -66974,7 +66982,7 @@
                 "text": "number"
               },
               "default": "640",
-              "description": "The width, in pixels, under which a card becomes a band. Zero never does.\n\nA card is a panel hung off one word, and there is no room to hang anything\noff a word on a phone: the columns do not shrink past\n`--megamenu-column-size`, so four of them stay four of them and the panel\nruns off the side of the screen rather than reflowing. Below this it takes\nthe whole width and its columns stack, which is the only arrangement that\nfits.\n\n**In script rather than a media query, and only once.** Whether the panel is\na band is not a question of paint: a band is not placed against the trigger,\nso the controller has to be told not to measure, and that decision is here\nwhatever the stylesheet says. Writing the width in both places would be one\nnumber in two languages, drifting the first time either moved. This sets\n`data-narrow` on the host and the stylesheet arranges itself off that.",
+              "description": "The width, in pixels, under which a card becomes a band. Zero never does.\n\nA card is a panel hung off one word, and there is no room to hang anything\noff a word on a phone: the columns do not shrink past\n`--megamenu-column-size`, so four of them stay four of them and the panel\nruns off the side of the screen rather than reflowing. Below this it takes\nthe whole width and its columns stack, which is the only arrangement that\nfits.\n\n**In script rather than a media query, and only once.** Whether the panel is\na band is not a question of paint: a band is not placed against the trigger,\nso the controller has to be told not to measure, and that decision is here\nwhatever the stylesheet says. Writing the width in both places would be one\nnumber in two languages, drifting the first time either moved. This records\n`:state(narrow)` on the host and the stylesheet arranges itself off that.\n\n**A custom state and never `data-narrow`, which is what it was.** The width\nis read in `connectedCallback`, so on a phone this is true on the very first\nupdate: an attribute written there is markup a consumer's server never sent,\nwhich React reports as a mismatch and answers by rebuilding the subtree. The\nnarrow exception the server specs describe covers a mirror that can only\nbecome true long after hydration, and a viewport measured before the first\npaint is the opposite case. See `MixinControllerOpen` on `open`.",
               "attribute": "full-below",
               "inheritedFrom": {
                 "name": "HelixHeadlessMegamenu",
@@ -67692,7 +67700,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/megamenu",
             "aliases": [
               "Mega menu",
@@ -67765,7 +67773,7 @@
                 "text": "number"
               },
               "default": "640",
-              "description": "The width, in pixels, under which a card becomes a band. Zero never does.\n\nA card is a panel hung off one word, and there is no room to hang anything\noff a word on a phone: the columns do not shrink past\n`--megamenu-column-size`, so four of them stay four of them and the panel\nruns off the side of the screen rather than reflowing. Below this it takes\nthe whole width and its columns stack, which is the only arrangement that\nfits.\n\n**In script rather than a media query, and only once.** Whether the panel is\na band is not a question of paint: a band is not placed against the trigger,\nso the controller has to be told not to measure, and that decision is here\nwhatever the stylesheet says. Writing the width in both places would be one\nnumber in two languages, drifting the first time either moved. This sets\n`data-narrow` on the host and the stylesheet arranges itself off that.",
+              "description": "The width, in pixels, under which a card becomes a band. Zero never does.\n\nA card is a panel hung off one word, and there is no room to hang anything\noff a word on a phone: the columns do not shrink past\n`--megamenu-column-size`, so four of them stay four of them and the panel\nruns off the side of the screen rather than reflowing. Below this it takes\nthe whole width and its columns stack, which is the only arrangement that\nfits.\n\n**In script rather than a media query, and only once.** Whether the panel is\na band is not a question of paint: a band is not placed against the trigger,\nso the controller has to be told not to measure, and that decision is here\nwhatever the stylesheet says. Writing the width in both places would be one\nnumber in two languages, drifting the first time either moved. This records\n`:state(narrow)` on the host and the stylesheet arranges itself off that.\n\n**A custom state and never `data-narrow`, which is what it was.** The width\nis read in `connectedCallback`, so on a phone this is true on the very first\nupdate: an attribute written there is markup a consumer's server never sent,\nwhich React reports as a mismatch and answers by rebuilding the subtree. The\nnarrow exception the server specs describe covers a mirror that can only\nbecome true long after hydration, and a viewport measured before the first\npaint is the opposite case. See `MixinControllerOpen` on `open`.",
               "fieldName": "fullBelow",
               "inheritedFrom": {
                 "name": "HelixHeadlessMegamenu",
@@ -67886,6 +67894,14 @@
             }
           ],
           "cssStates": [
+            {
+              "description": "While the page is under `full-below`, so the panel is a band whether or not one was asked for.",
+              "name": "narrow",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMegamenu",
+                "module": "src/megamenu/root/megamenu-root.ts"
+              }
+            },
             {
               "description": "While the panel is open, which is when the trigger reads as current.",
               "name": "open",
@@ -80243,7 +80259,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A rule down the leading edge with the current section lit along it, which is\nthe shape a table of contents has taken since printed marginalia: the line\nsays the list is one thing, and the lit segment says where in it you are.\n\nNesting is the consumer's, expressed as `data-level` on a link. An outline\nthat read heading levels itself would have to look at the document, and the\ndocument is not always where the headings are.",
+          "description": "A rule down the leading edge with the current section lit along it, which is\nthe shape a table of contents has taken since printed marginalia: the line\nsays the list is one thing, and the lit segment says where in it you are.\n\nNesting is the consumer's, expressed as `data-level` on a link, and the\nlevels are the heading levels: `2` through `6` each take one more step of\n`--outline-indent`, and a link with no `data-level` is the top one. An\noutline that read heading levels itself would have to look at the document,\nand the document is not always where the headings are.",
           "name": "HelixOutline",
           "cssProperties": [
             {
@@ -80992,11 +81008,11 @@
           "events": [
             {
               "type": {
-                "text": "HelixBeforeActivateEvent"
+                "text": "HelixActivateEvent"
               },
-              "description": "The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves.",
-              "name": "helix-before-activate",
-              "reactProp": "onhelix-before-activate",
+              "description": "The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take.",
+              "name": "helix-activate",
+              "reactProp": "onhelix-activate",
               "inheritedFrom": {
                 "name": "HelixHeadlessOutline",
                 "module": "src/outline/root/outline-root.ts"
@@ -127168,7 +127184,7 @@
               "name": "--tooltip-arrow-size"
             },
             {
-              "description": "Blur behind a `glass` bubble.",
+              "description": "Blur behind a `frosted` or `glass` bubble.",
               "name": "--tooltip-backdrop"
             },
             {
@@ -128243,7 +128259,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/tooltip",
             "aliases": [
               "Hint",

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

@@ -11,7 +11,7 @@ import '../../tag/index.js';
  * Input, Color Input and Date Input all take.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Autocomplete, Typeahead, Search select
  * @documentation https://fusion.dev/helix/components/combobox
@@ -21,7 +21,7 @@ import '../../tag/index.js';
  * @cssproperty --combobox-border-width - Width of the panel's edge. Follows
  *   `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a
  *   theme says otherwise.
- * @cssproperty --combobox-control-size - Smallest the text field shrinks to
+ * @cssproperty --combobox-control-size - Smallest the text field shrinks to once tags share its line.
  * @cssproperty --combobox-panel-size - Width of the panel. Follows the field by default.
  * @cssproperty --combobox-shadow - Lift under the panel. Follows `--helix-shadow-floating`: a
  *   floating surface sits over content nobody can predict, so it keeps a lift by default.

package/dist/drawer/root/drawer-root.css.js

@@ -42,7 +42,7 @@ inset: auto;
 inline-size: auto;
 block-size: auto;
 
-background-color: var(--helix-color-surface-overlay);
+background-color: var(--drawer-background-color, var(--helix-color-surface-overlay));
 
 padding: var(--drawer-padding, var(--helix-space-lg));
 

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

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * rest is flat and the movement is what says something happened.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @aliases Sheet, Sidebar, Panel, Off-canvas
  * @documentation https://fusion.dev/helix/components/drawer
@@ -17,13 +17,11 @@ import type { CSSResultGroup } from 'lit';
  * @slot - The drawer's content.
  * @slot header - Content pinned above the scrolling area.
  *
- * @event {HelixBeforeOpenEvent} helix-before-open - Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves.
- *
  * @csspart content - The scrolling content region.
  * @csspart header - The header region.
  * @csspart panel - The sliding panel.
  *
- * @cssproperty --drawer-backdrop - Filter applied behind a `material="glass"` drawer.
+ * @cssproperty --drawer-backdrop - Filter applied behind a `frosted` or `glass` drawer.
  *   Follows the theme's material policy; set it to override the strength on one drawer.
  * @cssproperty --drawer-background-color - Surface behind the panel.
  * @cssproperty --drawer-border-color - Color of the panel's edge.
@@ -31,7 +29,9 @@ import type { CSSResultGroup } from 'lit';
  *   `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a
  *   theme says otherwise.
  * @cssproperty --drawer-padding - Padding inside the panel.
- * @cssproperty --drawer-padding-block-start - Padding above the content, which clears the close control.
+ * @cssproperty --drawer-padding-block-start - Padding above the header, which is a step deeper than
+ *   the other three so the first line clears the window's own edge. Falls back to
+ *   `--drawer-padding`, so setting that alone governs all four sides.
  * @cssproperty --drawer-radius - Corner radius on the edges that face the page.
  * @cssproperty --drawer-scrim - The wash over the page behind the drawer. Set on the host, where a token still resolves: a `var()` written inside `::backdrop` cannot see one.
  * @cssproperty --drawer-shadow - Lift under the panel. Follows `--helix-shadow-floating`: a

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

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * lines up with the edge the eye is already following down the list.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases Panel item, Drill row
  * @documentation https://fusion.dev/helix/components/drilldown
  *

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

@@ -15,7 +15,7 @@ import type { CSSResultGroup } from 'lit';
  * `prefers-reduced-motion` it becomes the instant swap `Menu` does.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Panel, Nested list, Drill-in
  * @documentation https://fusion.dev/helix/components/drilldown

package/dist/element-events.generated.js

@@ -86,7 +86,7 @@ registerElementEvents({
     'helix-number-input': ['change', 'helix-before-change', 'input'],
     'helix-object-inspector': ['helix-copy'],
     'helix-option': ['helix-select'],
-    'helix-outline': ['helix-before-activate'],
+    'helix-outline': ['helix-activate'],
     'helix-pagination': ['helix-navigate'],
     'helix-pagination-size': ['helix-before-change'],
     'helix-pin-input': ['change', 'helix-before-change', 'helix-complete', 'input'],

package/dist/megamenu/root/megamenu-root.css.js

@@ -99,7 +99,7 @@ clip-path: inset(0 100% 100% calc(var(--helix-space-xl) * -1));
 }
 
 :host([variant="full"]) [part="surface"],
-:host([data-narrow]) [part="surface"] {
+:host(:state(narrow)) [part="surface"] {
 
 backdrop-filter: var(--megamenu-backdrop, none);
 background-color: var(--megamenu-background-color, var(--helix-color-background));
@@ -125,18 +125,18 @@ position: fixed;
 }
 
 :host([variant="full"]) [part="surface"]:popover-open,
-:host([data-narrow]) [part="surface"]:popover-open {
+:host(:state(narrow)) [part="surface"]:popover-open {
 clip-path: inset(0 0 calc(var(--helix-space-xl) * -1) 0);
 }
 
 @starting-style {
 :host([variant="full"]) [part="surface"]:popover-open,
-:host([data-narrow]) [part="surface"]:popover-open {
+:host(:state(narrow)) [part="surface"]:popover-open {
 clip-path: inset(0 0 100% 0);
 }
 }
 
-:host([data-narrow]) [part="surface"] {
+:host(:state(narrow)) [part="surface"] {
 grid-auto-flow: row;
 grid-template-columns: 1fr;
 

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

@@ -8,12 +8,13 @@ import type { CSSResultGroup } from 'lit';
  * Everything about what opens it and what closes it is the base class.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Mega menu, Flyout, Nav panel
  * @documentation https://fusion.dev/helix/components/megamenu
  *
- * @cssproperty --megamenu-backdrop - A filter behind the panel, for glass.
+ * @cssproperty --megamenu-backdrop - A filter behind the panel, which is `none` until one is
+ *   asked for: this family carries no `material`, so the pair is two hooks rather than a word.
  * @cssproperty --megamenu-background-color - The panel's own fill.
  * @cssproperty --megamenu-border-width - Width of the panel's edge. Follows
  *   `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a

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

@@ -8,9 +8,11 @@ import type { CSSResultGroup } from 'lit';
  * the shape a table of contents has taken since printed marginalia: the line
  * says the list is one thing, and the lit segment says where in it you are.
  *
- * Nesting is the consumer's, expressed as `data-level` on a link. An outline
- * that read heading levels itself would have to look at the document, and the
- * document is not always where the headings are.
+ * Nesting is the consumer's, expressed as `data-level` on a link, and the
+ * levels are the heading levels: `2` through `6` each take one more step of
+ * `--outline-indent`, and a link with no `data-level` is the top one. An
+ * outline that read heading levels itself would have to look at the document,
+ * and the document is not always where the headings are.
  *
  * @since 0.1.0
  * @status experimental

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

@@ -11,14 +11,14 @@ import type { CSSResultGroup } from 'lit';
  * still points at the trigger after the bubble has slid along to stay in view.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @groups charts
  * @aliases Hint, Popup label
  * @documentation https://fusion.dev/helix/components/tooltip
  *
  * @cssproperty --tooltip-arrow-size - Size of the point at the bubble's edge.
- * @cssproperty --tooltip-backdrop - Blur behind a `glass` bubble.
+ * @cssproperty --tooltip-backdrop - Blur behind a `frosted` or `glass` bubble.
  * @cssproperty --tooltip-background-color - Fill of the bubble.
  * @cssproperty --tooltip-max-inline-size - Widest the bubble grows before wrapping.
  */

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.37.0",
+  "version": "0.38.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.37.0",
-    "@fusion.dev/helix-headless": "0.37.0",
-    "@fusion.dev/helix-styles": "0.37.0"
+    "@fusion.dev/helix-core": "0.38.0",
+    "@fusion.dev/helix-headless": "0.38.0",
+    "@fusion.dev/helix-styles": "0.38.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.37.0",
-    "@fusion.dev/helix-testing": "0.37.0",
+    "@fusion.dev/helix-cem": "0.38.0",
+    "@fusion.dev/helix-testing": "0.38.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

@@ -4438,7 +4438,16 @@ toggles rather than replaces, and the arrows move without choosing. What
 this adds is the tags, and keeping the panel open between picks.
 
 A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change. */
+listbox's contract and not this element's to change.
+
+**The list is told, and the field is not.** `aria-multiselectable` belongs
+to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+reader on the field hears it through `aria-controls`. This element wrote it
+onto its own `role="combobox"` input as well, which an audit reports as a
+property the role does not support and no spec here ever asserted: the one
+that covers this says in as many words that telling the list is what this
+element is responsible for. */
   multiple?: (HelixCombobox["multiple"]) | undefined;
   /** Text shown while nothing has been chosen. */
   placeholder?: (HelixCombobox["placeholder"]) | undefined;
@@ -4602,7 +4611,16 @@ toggles rather than replaces, and the arrows move without choosing. What
 this adds is the tags, and keeping the panel open between picks.
 
 A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change. */
+listbox's contract and not this element's to change.
+
+**The list is told, and the field is not.** `aria-multiselectable` belongs
+to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+reader on the field hears it through `aria-controls`. This element wrote it
+onto its own `role="combobox"` input as well, which an audit reports as a
+property the role does not support and no spec here ever asserted: the one
+that covers this says in as many words that telling the list is what this
+element is responsible for. */
   "prop:multiple"?: (HelixCombobox["multiple"]) | undefined;
   /** Text shown while nothing has been chosen. */
   "prop:placeholder"?: (HelixCombobox["placeholder"]) | undefined;
@@ -6939,12 +6957,12 @@ the circle is not drawn. */
 
 /** `HelixDrawer` component event */
 export type HelixDrawerElementEvent<E = Event> = TypedEvent<HelixDrawer, E>;
-/** `helix-before-open` event type */
-export type HelixDrawerHelixBeforeOpenElementEvent =
-  HelixDrawerElementEvent<HelixBeforeOpenEvent>;
 /** `helix-before-close` event type */
 export type HelixDrawerHelixBeforeCloseElementEvent =
   HelixDrawerElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixDrawerHelixBeforeOpenElementEvent =
+  HelixDrawerElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixDrawerProps = {
   /** Whether the panel is glass rather than opaque.
@@ -7038,12 +7056,12 @@ Held here as well as on the element, so a value set before the first render
 survives to it and a consumer reading one back gets what they wrote. */
   returnValue?: (HelixDrawer["returnValue"]) | undefined;
 
-  /** Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "onhelix-before-open"?: ((e: HelixDrawerHelixBeforeOpenElementEvent) => void) | undefined;
   /** Relayed, because the platform's own does not escape. */
   onclose?: ((e: HelixDrawerElementEvent) => void) | undefined;
   /** Fired before the panel closes, and cancelable. */
   "onhelix-before-close"?: ((e: HelixDrawerHelixBeforeCloseElementEvent) => void) | undefined;
+  /** Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "onhelix-before-open"?: ((e: HelixDrawerHelixBeforeOpenElementEvent) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
   ontoggle?: ((e: HelixDrawerElementEvent) => void) | undefined;
 };
@@ -7139,14 +7157,14 @@ alone, and `Dialog`'s `close()` is the one that takes the value directly.
 Held here as well as on the element, so a value set before the first render
 survives to it and a consumer reading one back gets what they wrote. */
   "prop:returnValue"?: (HelixDrawer["returnValue"]) | undefined;
-  /** Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "on:helix-before-open"?: ((e: HelixDrawerHelixBeforeOpenElementEvent) => void) | undefined;
   /** Relayed, because the platform's own does not escape. */
   "on:close"?: ((e: HelixDrawerElementEvent) => void) | undefined;
   /** Fired before the panel closes, and cancelable. */
   "on:helix-before-close"?: ((
     e: HelixDrawerHelixBeforeCloseElementEvent,
   ) => void) | undefined;
+  /** Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "on:helix-before-open"?: ((e: HelixDrawerHelixBeforeOpenElementEvent) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
   "on:toggle"?: ((e: HelixDrawerElementEvent) => void) | undefined;
 
@@ -10332,8 +10350,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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`. */
   "full-below"?: (HelixMegamenu["fullBelow"] | `${number}`) | undefined;
   /** The width, in pixels, under which a card becomes a band. Zero never does.
 
@@ -10348,8 +10374,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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`. */
   fullBelow?: (HelixMegamenu["fullBelow"]) | undefined;
   /** The section's name, which names the default trigger and the panel. */
   label?: (HelixMegamenu["label"]) | undefined;
@@ -10423,8 +10457,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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`. */
   "attr:full-below"?: (HelixMegamenu["fullBelow"] | `${number}`) | undefined;
   /** The width, in pixels, under which a card becomes a band. Zero never does.
 
@@ -10439,8 +10481,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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:fullBelow"?: (HelixMegamenu["fullBelow"]) | undefined;
   /** The section's name, which names the default trigger and the panel. */
   "prop:label"?: (HelixMegamenu["label"]) | undefined;
@@ -11977,9 +12027,9 @@ markup. */
 
 /** `HelixOutline` component event */
 export type HelixOutlineElementEvent<E = Event> = TypedEvent<HelixOutline, E>;
-/** `helix-before-activate` event type */
-export type HelixOutlineHelixBeforeActivateElementEvent =
-  HelixOutlineElementEvent<HelixBeforeActivateEvent>;
+/** `helix-activate` event type */
+export type HelixOutlineHelixActivateElementEvent =
+  HelixOutlineElementEvent<HelixActivateEvent>;
 
 export type HelixOutlineProps = {
   /** How a click on one of these links travels to its section.
@@ -12012,10 +12062,8 @@ a little more: without it the current section changes as a heading slides
 under the chrome rather than as it reaches the top of what can be seen. */
   offset?: (HelixOutline["offset"]) | undefined;
 
-  /** The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves. */
-  "onhelix-before-activate"?: ((
-    e: HelixOutlineHelixBeforeActivateElementEvent,
-  ) => void) | undefined;
+  /** The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take. */
+  "onhelix-activate"?: ((e: HelixOutlineHelixActivateElementEvent) => void) | undefined;
 };
 
 export type HelixOutlineSolidJsProps = {
@@ -12048,10 +12096,8 @@ The reading line. A page with a sticky masthead sets this to its height, or
 a little more: without it the current section changes as a heading slides
 under the chrome rather than as it reaches the top of what can be seen. */
   "prop:offset"?: (HelixOutline["offset"]) | undefined;
-  /** The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves. */
-  "on:helix-before-activate"?: ((
-    e: HelixOutlineHelixBeforeActivateElementEvent,
-  ) => void) | undefined;
+  /** The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take. */
+  "on:helix-activate"?: ((e: HelixOutlineHelixActivateElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -23647,6 +23693,15 @@ export type CustomElements = {
    *
    * A comma is therefore not available inside an option's value, which is the
    * listbox's contract and not this element's to change.
+   *
+   * **The list is told, and the field is not.** `aria-multiselectable` belongs
+   * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+   * ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+   * reader on the field hears it through `aria-controls`. This element wrote it
+   * onto its own `role="combobox"` input as well, which an audit reports as a
+   * property the role does not support and no spec here ever asserted: the one
+   * that covers this says in as many words that telling the list is what this
+   * element is responsible for.
    * - `placeholder`: Text shown while nothing has been chosen.
    * - `remove-label`/`removeLabel`: What a tag's remove control is called, since the mark has no name.
    * - `suggest`: Whether the field finishes the word as it is typed.
@@ -23801,7 +23856,7 @@ export type CustomElements = {
    * - `--combobox-background-color`: Fill behind the field. (default: `undefined`)
    * - `--combobox-border-color`: Color of the panel's edge. (default: `undefined`)
    * - `--combobox-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
-   * - `--combobox-control-size`: Smallest the text field shrinks to (default: `undefined`)
+   * - `--combobox-control-size`: Smallest the text field shrinks to once tags share its line. (default: `undefined`)
    * - `--combobox-panel-size`: Width of the panel. Follows the field by default. (default: `undefined`)
    * - `--combobox-shadow`: Lift under the panel. Follows `--helix-shadow-floating`: a floating surface sits over content nobody can predict, so it keeps a lift by default. (default: `undefined`)
    *
@@ -25763,9 +25818,9 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-open`: Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `close`: Relayed, because the platform's own does not escape.
    * - `helix-before-close`: Fired before the panel closes, and cancelable.
+   * - `helix-before-open`: Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *
    * ## Slots
@@ -25792,12 +25847,12 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--drawer-backdrop`: Filter applied behind a `material="glass"` drawer. Follows the theme's material policy; set it to override the strength on one drawer. (default: `undefined`)
+   * - `--drawer-backdrop`: Filter applied behind a `frosted` or `glass` drawer. Follows the theme's material policy; set it to override the strength on one drawer. (default: `undefined`)
    * - `--drawer-background-color`: Surface behind the panel. (default: `undefined`)
    * - `--drawer-border-color`: Color of the panel's edge. (default: `undefined`)
    * - `--drawer-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
    * - `--drawer-padding`: Padding inside the panel. (default: `undefined`)
-   * - `--drawer-padding-block-start`: Padding above the content, which clears the close control. (default: `undefined`)
+   * - `--drawer-padding-block-start`: Padding above the header, which is a step deeper than the other three so the first line clears the window's own edge. Falls back to `--drawer-padding`, so setting that alone governs all four sides. (default: `undefined`)
    * - `--drawer-radius`: Corner radius on the edges that face the page. (default: `undefined`)
    * - `--drawer-scrim`: The wash over the page behind the drawer. Set on the host, where a token still resolves: a `var()` written inside `::backdrop` cannot see one. (default: `undefined`)
    * - `--drawer-shadow`: Lift under the panel. Follows `--helix-shadow-floating`: a floating surface sits over content nobody can predict, so it keeps a lift by default. (default: `undefined`)
@@ -26008,6 +26063,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `drilled`: While a row's page is showing rather than the top one, so a frame around this can answer the depth it is at.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
   "helix-drilldown": Partial<
@@ -29059,8 +29115,16 @@ export type CustomElements = {
    * a band is not a question of paint: a band is not placed against the trigger,
    * so the controller has to be told not to measure, and that decision is here
    * whatever the stylesheet says. Writing the width in both places would be one
-   * number in two languages, drifting the first time either moved. This sets
-   * `data-narrow` on the host and the stylesheet arranges itself off that.
+   * number in two languages, drifting the first time either moved. This records
+   * `:state(narrow)` on the host and the stylesheet arranges itself off that.
+   *
+   * **A custom state and never `data-narrow`, which is what it was.** The width
+   * is read in `connectedCallback`, so on a phone this is true on the very first
+   * update: an attribute written there is markup a consumer's server never sent,
+   * which React reports as a mismatch and answers by rebuilding the subtree. The
+   * 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`.
    * - `label`: The section's name, which names the default trigger and the panel.
    * - `open-on`/`openOn`: Whether hovering the trigger opens the panel, or only a press does.
    *
@@ -29134,7 +29198,7 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--megamenu-backdrop`: A filter behind the panel, for glass. (default: `undefined`)
+   * - `--megamenu-backdrop`: A filter behind the panel, which is `none` until one is asked for: this family carries no `material`, so the pair is two hooks rather than a word. (default: `undefined`)
    * - `--megamenu-background-color`: The panel's own fill. (default: `undefined`)
    * - `--megamenu-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
    * - `--megamenu-column-size`: The narrowest a column goes before the grid wraps. (default: `undefined`)
@@ -29154,6 +29218,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `narrow`: While the page is under `full-below`, so the panel is a band whether or not one was asked for.
    * - `open`: While the panel is open, which is when the trigger reads as current.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
@@ -30819,9 +30884,11 @@ export type CustomElements = {
    * the shape a table of contents has taken since printed marginalia: the line
    * says the list is one thing, and the lit segment says where in it you are.
    *
-   * Nesting is the consumer's, expressed as `data-level` on a link. An outline
-   * that read heading levels itself would have to look at the document, and the
-   * document is not always where the headings are.
+   * Nesting is the consumer's, expressed as `data-level` on a link, and the
+   * levels are the heading levels: `2` through `6` each take one more step of
+   * `--outline-indent`, and a link with no `data-level` is the top one. An
+   * outline that read heading levels itself would have to look at the document,
+   * and the document is not always where the headings are.
    *
    * ## Attributes & Properties
    *
@@ -30886,7 +30953,7 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-activate`: The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves.
+   * - `helix-activate`: The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take.
    *
    * ## Slots
    *
@@ -37337,7 +37404,7 @@ export type CustomElements = {
    * CSS variables available for styling the component.
    *
    * - `--tooltip-arrow-size`: Size of the point at the bubble's edge. (default: `undefined`)
-   * - `--tooltip-backdrop`: Blur behind a `glass` bubble. (default: `undefined`)
+   * - `--tooltip-backdrop`: Blur behind a `frosted` or `glass` bubble. (default: `undefined`)
    * - `--tooltip-background-color`: Fill of the bubble. (default: `undefined`)
    * - `--tooltip-max-inline-size`: Widest the bubble grows before wrapping. (default: `undefined`)
    *
@@ -42534,6 +42601,15 @@ export type CustomElementsSolidJs = {
    *
    * A comma is therefore not available inside an option's value, which is the
    * listbox's contract and not this element's to change.
+   *
+   * **The list is told, and the field is not.** `aria-multiselectable` belongs
+   * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+   * ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+   * reader on the field hears it through `aria-controls`. This element wrote it
+   * onto its own `role="combobox"` input as well, which an audit reports as a
+   * property the role does not support and no spec here ever asserted: the one
+   * that covers this says in as many words that telling the list is what this
+   * element is responsible for.
    * - `placeholder`: Text shown while nothing has been chosen.
    * - `remove-label`/`removeLabel`: What a tag's remove control is called, since the mark has no name.
    * - `suggest`: Whether the field finishes the word as it is typed.
@@ -42688,7 +42764,7 @@ export type CustomElementsSolidJs = {
    * - `--combobox-background-color`: Fill behind the field. (default: `undefined`)
    * - `--combobox-border-color`: Color of the panel's edge. (default: `undefined`)
    * - `--combobox-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
-   * - `--combobox-control-size`: Smallest the text field shrinks to (default: `undefined`)
+   * - `--combobox-control-size`: Smallest the text field shrinks to once tags share its line. (default: `undefined`)
    * - `--combobox-panel-size`: Width of the panel. Follows the field by default. (default: `undefined`)
    * - `--combobox-shadow`: Lift under the panel. Follows `--helix-shadow-floating`: a floating surface sits over content nobody can predict, so it keeps a lift by default. (default: `undefined`)
    *
@@ -44681,9 +44757,9 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-open`: Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `close`: Relayed, because the platform's own does not escape.
    * - `helix-before-close`: Fired before the panel closes, and cancelable.
+   * - `helix-before-open`: Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *
    * ## Slots
@@ -44710,12 +44786,12 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--drawer-backdrop`: Filter applied behind a `material="glass"` drawer. Follows the theme's material policy; set it to override the strength on one drawer. (default: `undefined`)
+   * - `--drawer-backdrop`: Filter applied behind a `frosted` or `glass` drawer. Follows the theme's material policy; set it to override the strength on one drawer. (default: `undefined`)
    * - `--drawer-background-color`: Surface behind the panel. (default: `undefined`)
    * - `--drawer-border-color`: Color of the panel's edge. (default: `undefined`)
    * - `--drawer-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
    * - `--drawer-padding`: Padding inside the panel. (default: `undefined`)
-   * - `--drawer-padding-block-start`: Padding above the content, which clears the close control. (default: `undefined`)
+   * - `--drawer-padding-block-start`: Padding above the header, which is a step deeper than the other three so the first line clears the window's own edge. Falls back to `--drawer-padding`, so setting that alone governs all four sides. (default: `undefined`)
    * - `--drawer-radius`: Corner radius on the edges that face the page. (default: `undefined`)
    * - `--drawer-scrim`: The wash over the page behind the drawer. Set on the host, where a token still resolves: a `var()` written inside `::backdrop` cannot see one. (default: `undefined`)
    * - `--drawer-shadow`: Lift under the panel. Follows `--helix-shadow-floating`: a floating surface sits over content nobody can predict, so it keeps a lift by default. (default: `undefined`)
@@ -44932,6 +45008,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `drilled`: While a row's page is showing rather than the top one, so a frame around this can answer the depth it is at.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
   "helix-drilldown": Partial<
@@ -48053,8 +48130,16 @@ export type CustomElementsSolidJs = {
    * a band is not a question of paint: a band is not placed against the trigger,
    * so the controller has to be told not to measure, and that decision is here
    * whatever the stylesheet says. Writing the width in both places would be one
-   * number in two languages, drifting the first time either moved. This sets
-   * `data-narrow` on the host and the stylesheet arranges itself off that.
+   * number in two languages, drifting the first time either moved. This records
+   * `:state(narrow)` on the host and the stylesheet arranges itself off that.
+   *
+   * **A custom state and never `data-narrow`, which is what it was.** The width
+   * is read in `connectedCallback`, so on a phone this is true on the very first
+   * update: an attribute written there is markup a consumer's server never sent,
+   * which React reports as a mismatch and answers by rebuilding the subtree. The
+   * 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`.
    * - `label`: The section's name, which names the default trigger and the panel.
    * - `open-on`/`openOn`: Whether hovering the trigger opens the panel, or only a press does.
    *
@@ -48128,7 +48213,7 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--megamenu-backdrop`: A filter behind the panel, for glass. (default: `undefined`)
+   * - `--megamenu-backdrop`: A filter behind the panel, which is `none` until one is asked for: this family carries no `material`, so the pair is two hooks rather than a word. (default: `undefined`)
    * - `--megamenu-background-color`: The panel's own fill. (default: `undefined`)
    * - `--megamenu-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. (default: `undefined`)
    * - `--megamenu-column-size`: The narrowest a column goes before the grid wraps. (default: `undefined`)
@@ -48148,6 +48233,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `narrow`: While the page is under `full-below`, so the panel is a band whether or not one was asked for.
    * - `open`: While the panel is open, which is when the trigger reads as current.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
@@ -49852,9 +49938,11 @@ export type CustomElementsSolidJs = {
    * the shape a table of contents has taken since printed marginalia: the line
    * says the list is one thing, and the lit segment says where in it you are.
    *
-   * Nesting is the consumer's, expressed as `data-level` on a link. An outline
-   * that read heading levels itself would have to look at the document, and the
-   * document is not always where the headings are.
+   * Nesting is the consumer's, expressed as `data-level` on a link, and the
+   * levels are the heading levels: `2` through `6` each take one more step of
+   * `--outline-indent`, and a link with no `data-level` is the top one. An
+   * outline that read heading levels itself would have to look at the document,
+   * and the document is not always where the headings are.
    *
    * ## Attributes & Properties
    *
@@ -49919,7 +50007,7 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-activate`: The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves.
+   * - `helix-activate`: The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take.
    *
    * ## Slots
    *
@@ -56530,7 +56618,7 @@ export type CustomElementsSolidJs = {
    * CSS variables available for styling the component.
    *
    * - `--tooltip-arrow-size`: Size of the point at the bubble's edge. (default: `undefined`)
-   * - `--tooltip-backdrop`: Blur behind a `glass` bubble. (default: `undefined`)
+   * - `--tooltip-backdrop`: Blur behind a `frosted` or `glass` bubble. (default: `undefined`)
    * - `--tooltip-background-color`: Fill of the bubble. (default: `undefined`)
    * - `--tooltip-max-inline-size`: Widest the bubble grows before wrapping. (default: `undefined`)
    *
@@ -58095,7 +58183,7 @@ export type CustomCssProperties = {
   "--combobox-border-color"?: (string) | undefined;
   /** Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. */
   "--combobox-border-width"?: (string) | undefined;
-  /** Smallest the text field shrinks to */
+  /** Smallest the text field shrinks to once tags share its line. */
   "--combobox-control-size"?: (string) | undefined;
   /** Width of the panel. Follows the field by default. */
   "--combobox-panel-size"?: (string) | undefined;
@@ -58191,7 +58279,7 @@ export type CustomCssProperties = {
   "--donut-chart-track-color"?: (string) | undefined;
   /** How thick the ring is drawn, derived from `hole`. */
   "--donut-chart-stroke"?: (string) | undefined;
-  /** Filter applied behind a `material="glass"` drawer. Follows the theme's material policy; set it to override the strength on one drawer. */
+  /** Filter applied behind a `frosted` or `glass` drawer. Follows the theme's material policy; set it to override the strength on one drawer. */
   "--drawer-backdrop"?: (string) | undefined;
   /** Surface behind the panel. */
   "--drawer-background-color"?: (string) | undefined;
@@ -58201,7 +58289,7 @@ export type CustomCssProperties = {
   "--drawer-border-width"?: (string) | undefined;
   /** Padding inside the panel. */
   "--drawer-padding"?: (string) | undefined;
-  /** Padding above the content, which clears the close control. */
+  /** Padding above the header, which is a step deeper than the other three so the first line clears the window's own edge. Falls back to `--drawer-padding`, so setting that alone governs all four sides. */
   "--drawer-padding-block-start"?: (string) | undefined;
   /** Corner radius on the edges that face the page. */
   "--drawer-radius"?: (string) | undefined;
@@ -58359,7 +58447,7 @@ export type CustomCssProperties = {
   "--loader-size"?: (string) | undefined;
   /** Color of the circle behind it. */
   "--loader-track-color"?: (string) | undefined;
-  /** A filter behind the panel, for glass. */
+  /** A filter behind the panel, which is `none` until one is asked for: this family carries no `material`, so the pair is two hooks rather than a word. */
   "--megamenu-backdrop"?: (string) | undefined;
   /** The panel's own fill. */
   "--megamenu-background-color"?: (string) | undefined;
@@ -58795,7 +58883,7 @@ export type CustomCssProperties = {
   "--toolbar-gap"?: (string) | undefined;
   /** Size of the point at the bubble's edge. */
   "--tooltip-arrow-size"?: (string) | undefined;
-  /** Blur behind a `glass` bubble. */
+  /** Blur behind a `frosted` or `glass` bubble. */
   "--tooltip-backdrop"?: (string) | undefined;
   /** Fill of the bubble. */
   "--tooltip-background-color"?: (string) | undefined;

package/types/vue.d.ts

@@ -160,7 +160,7 @@ import type {
   HelixResizeEvent,
   HelixShortcutEvent,
   HelixReadEvent,
-  HelixBeforeActivateEvent,
+  HelixActivateEvent,
   HelixCompleteEvent,
   HelixConsoleEvent,
   HelixBeforeEditEvent,
@@ -169,7 +169,7 @@ import type {
   HelixCaretEvent,
   HelixBeforeCollapseEvent,
   HelixBeforeResizeEvent,
-  HelixActivateEvent,
+  HelixBeforeActivateEvent,
   HelixTourAskEvent,
   HelixNextEvent,
   HelixPreviousEvent,
@@ -2326,7 +2326,16 @@ toggles rather than replaces, and the arrows move without choosing. What
 this adds is the tags, and keeping the panel open between picks.
 
 A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change. */
+listbox's contract and not this element's to change.
+
+**The list is told, and the field is not.** `aria-multiselectable` belongs
+to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+reader on the field hears it through `aria-controls`. This element wrote it
+onto its own `role="combobox"` input as well, which an audit reports as a
+property the role does not support and no spec here ever asserted: the one
+that covers this says in as many words that telling the list is what this
+element is responsible for. */
   multiple?: (HelixCombobox["multiple"]) | undefined;
   /** Text shown while nothing has been chosen. */
   placeholder?: (HelixCombobox["placeholder"]) | undefined;
@@ -3552,12 +3561,12 @@ export type HelixDonutChartVueEvents = {};
 
 /** `HelixDrawer` component event */
 export type HelixDrawerElementEvent<E = Event> = TypedEvent<HelixDrawer, E>;
-/** `helix-before-open` event type */
-export type HelixDrawerHelixBeforeOpenElementEvent =
-  HelixDrawerElementEvent<HelixBeforeOpenEvent>;
 /** `helix-before-close` event type */
 export type HelixDrawerHelixBeforeCloseElementEvent =
   HelixDrawerElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixDrawerHelixBeforeOpenElementEvent =
+  HelixDrawerElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixDrawerVueProps = {
   /** Whether the panel is glass rather than opaque.
@@ -3653,12 +3662,12 @@ survives to it and a consumer reading one back gets what they wrote. */
 };
 
 export type HelixDrawerVueEvents = {
-  /** Fired before the drawer opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
-  "helix-before-open": HelixDrawerHelixBeforeOpenElementEvent;
   /** Relayed, because the platform's own does not escape. */
   close: HelixDrawerElementEvent;
   /** Fired before the panel closes, and cancelable. */
   "helix-before-close": HelixDrawerHelixBeforeCloseElementEvent;
+  /** Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves. */
+  "helix-before-open": HelixDrawerHelixBeforeOpenElementEvent;
   /** Says the state moved, carrying `newState` and `oldState`. */
   toggle: HelixDrawerElementEvent;
 };
@@ -5302,8 +5311,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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`. */
   "full-below"?: (HelixMegamenu["fullBelow"] | `${number}`) | undefined;
   /** The width, in pixels, under which a card becomes a band. Zero never does.
 
@@ -5318,8 +5335,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+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`. */
   fullBelow?: (HelixMegamenu["fullBelow"]) | undefined;
   /** The section's name, which names the default trigger and the panel. */
   label?: (HelixMegamenu["label"]) | undefined;
@@ -6138,9 +6163,9 @@ export type HelixOrbVueEvents = {};
 
 /** `HelixOutline` component event */
 export type HelixOutlineElementEvent<E = Event> = TypedEvent<HelixOutline, E>;
-/** `helix-before-activate` event type */
-export type HelixOutlineHelixBeforeActivateElementEvent =
-  HelixOutlineElementEvent<HelixBeforeActivateEvent>;
+/** `helix-activate` event type */
+export type HelixOutlineHelixActivateElementEvent =
+  HelixOutlineElementEvent<HelixActivateEvent>;
 
 export type HelixOutlineVueProps = {
   /** How a click on one of these links travels to its section.
@@ -6175,8 +6200,8 @@ under the chrome rather than as it reaches the top of what can be seen. */
 };
 
 export type HelixOutlineVueEvents = {
-  /** The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves. */
-  "helix-before-activate": HelixOutlineHelixBeforeActivateElementEvent;
+  /** The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take. */
+  "helix-activate": HelixOutlineHelixActivateElementEvent;
 };
 
 /** `HelixPagination` component event */
@@ -10415,7 +10440,7 @@ export type CustomCssProperties = {
   "--combobox-border-color"?: (string) | undefined;
   /** Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel is told apart by its lift unless a theme says otherwise. */
   "--combobox-border-width"?: (string) | undefined;
-  /** Smallest the text field shrinks to */
+  /** Smallest the text field shrinks to once tags share its line. */
   "--combobox-control-size"?: (string) | undefined;
   /** Width of the panel. Follows the field by default. */
   "--combobox-panel-size"?: (string) | undefined;
@@ -10511,7 +10536,7 @@ export type CustomCssProperties = {
   "--donut-chart-track-color"?: (string) | undefined;
   /** How thick the ring is drawn, derived from `hole`. */
   "--donut-chart-stroke"?: (string) | undefined;
-  /** Filter applied behind a `material="glass"` drawer. Follows the theme's material policy; set it to override the strength on one drawer. */
+  /** Filter applied behind a `frosted` or `glass` drawer. Follows the theme's material policy; set it to override the strength on one drawer. */
   "--drawer-backdrop"?: (string) | undefined;
   /** Surface behind the panel. */
   "--drawer-background-color"?: (string) | undefined;
@@ -10521,7 +10546,7 @@ export type CustomCssProperties = {
   "--drawer-border-width"?: (string) | undefined;
   /** Padding inside the panel. */
   "--drawer-padding"?: (string) | undefined;
-  /** Padding above the content, which clears the close control. */
+  /** Padding above the header, which is a step deeper than the other three so the first line clears the window's own edge. Falls back to `--drawer-padding`, so setting that alone governs all four sides. */
   "--drawer-padding-block-start"?: (string) | undefined;
   /** Corner radius on the edges that face the page. */
   "--drawer-radius"?: (string) | undefined;
@@ -10679,7 +10704,7 @@ export type CustomCssProperties = {
   "--loader-size"?: (string) | undefined;
   /** Color of the circle behind it. */
   "--loader-track-color"?: (string) | undefined;
-  /** A filter behind the panel, for glass. */
+  /** A filter behind the panel, which is `none` until one is asked for: this family carries no `material`, so the pair is two hooks rather than a word. */
   "--megamenu-backdrop"?: (string) | undefined;
   /** The panel's own fill. */
   "--megamenu-background-color"?: (string) | undefined;
@@ -11115,7 +11140,7 @@ export type CustomCssProperties = {
   "--toolbar-gap"?: (string) | undefined;
   /** Size of the point at the bubble's edge. */
   "--tooltip-arrow-size"?: (string) | undefined;
-  /** Blur behind a `glass` bubble. */
+  /** Blur behind a `frosted` or `glass` bubble. */
   "--tooltip-backdrop"?: (string) | undefined;
   /** Fill of the bubble. */
   "--tooltip-background-color"?: (string) | undefined;
@@ -11653,7 +11678,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixOrbVueProps,
     HelixOrbVueEvents
   >;
-  /** A rule down the leading edge with the current section lit along it, which is the shape a table of contents has taken since printed marginalia: the line says the list is one thing, and the lit segment says where in it you are.  Nesting is the consumer's, expressed as 'data-level' on a link. An outline that read heading levels itself would have to look at the document, and the document is not always where the headings are. */
+  /** A rule down the leading edge with the current section lit along it, which is the shape a table of contents has taken since printed marginalia: the line says the list is one thing, and the lit segment says where in it you are.  Nesting is the consumer's, expressed as 'data-level' on a link, and the levels are the heading levels: '2' through '6' each take one more step of '--outline-indent', and a link with no 'data-level' is the top one. An outline that read heading levels itself would have to look at the document, and the document is not always where the headings are. */
   "helix-outline": DefineCustomElement<
     HelixOutline,
     HelixOutlineVueProps,