@fusion.dev/helix 0.37.0 → 0.39.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",
@@ -31127,6 +31127,14 @@
               "description": "Type size, headings and cells alike.",
               "name": "--data-table-text"
             },
+            {
+              "description": "The edge the column a cell sits under is set to, `start`, `center` or `end`, and unset under a column that sets none. Written by the component onto each cell it draws, read by the sheet that paints one; `helix-table` publishes `--table-cell-align` for the same attribute on the cells a consumer wrote, under its own family's name.",
+              "name": "--data-table-cell-align",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDataTable",
+                "module": "src/data-table/root/data-table-root.ts"
+              }
+            },
             {
               "description": "The column track list this element worked out from the columns declared in it. Written by the component, read by the sheet that paints: a stylesheet takes it to lay the grid out, and setting it does nothing, because the component writes it inline on the very element that reads it and an inline declaration beats any sheet. `--data-table-columns` is the one to set.",
               "name": "--data-table-template",
@@ -31258,7 +31266,7 @@
               }
             },
             {
-              "description": "Shown when no rows match.",
+              "description": "Shown when the result has nothing in it, whether it arrived empty or a filter emptied it. A result still on its way is `loading` instead, which wins over this.",
               "name": "empty",
               "inheritedFrom": {
                 "name": "HelixHeadlessDataTable",
@@ -31577,7 +31585,7 @@
               },
               "privacy": "protected",
               "readonly": true,
-              "description": "Emptiness is a fact about the data here, not about slotted children.",
+              "description": "Emptiness is a fact about the data here, not about slotted children.\n\n**The page rather than the window**, which is the difference between the two\ncounts `view` carries and the reason this reads `available`. A windowed\ntable draws a slice, and a slice can be short of the rows that are there:\nasking whether *this* slice has rows says \"nothing matched\" about a result\nthat matched plenty.\n\nThe mixin's own answer counts children with no `slot`, which for this\nelement is the columns. Left in place, a table with columns and no data\nwould call itself full.",
               "inheritedFrom": {
                 "name": "MixinCollection",
                 "module": "src/mixins/mixin-collection/mixin-collection.ts"
@@ -32780,6 +32788,7 @@
                   }
                 }
               ],
+              "description": "One cell, carrying its column's edge as a fact rather than as a decision.\n\n**A fact published rather than a property chosen**, which is what\n`helix-table` does with the same attribute: what lining up *means*, a\n`justify-content` for a value that fits or a `text-align` for one that\nwraps, belongs to whoever draws the cell. Written here as an inline\n`text-align` it was this tier choosing, in the tier that ships no CSS, and a\nconsumer could not overrule it either, an inline declaration beating any\n`::part(cell)` rule they wrote.\n\nOnly the three edges reach it, `align` being a string anybody can write and\nthis being a style attribute: `edgeOf` is that guard, and `helix-table`\nholds the same value to the same three.",
               "inheritedFrom": {
                 "name": "HelixHeadlessDataTable",
                 "module": "src/data-table/root/data-table-root.ts"
@@ -33431,7 +33440,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/data-table",
             "tier": "styled",
             "group": "DataTable",
@@ -38601,7 +38610,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "What the value is, for the common case of plain text.\n\nThe fallback of the `label` slot, so slotted content replaces it rather than\nappearing beside it.",
+              "description": "What the value is called, for the common case of plain text.\n\nThe fallback of the `label` slot, so slotted content replaces it rather than\nappearing beside it. The value itself is the default slot: it is the half\nthat varies and is often more than text.",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessDescriptionListItem",
@@ -38940,7 +38949,7 @@
           "summary": "One label and its value.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/description-list",
             "tier": "styled",
             "group": "DescriptionList",
@@ -38991,7 +39000,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "What the value is, for the common case of plain text.\n\nThe fallback of the `label` slot, so slotted content replaces it rather than\nappearing beside it.",
+              "description": "What the value is called, for the common case of plain text.\n\nThe fallback of the `label` slot, so slotted content replaces it rather than\nappearing beside it. The value itself is the default slot: it is the half\nthat varies and is often more than text.",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessDescriptionListItem",
@@ -39062,7 +39071,7 @@
           "name": "HelixDescriptionList",
           "cssProperties": [
             {
-              "description": "Space between one pair and the next.",
+              "description": "Space between one pair and the next. Its resting value is tighter with `direction=\"row\"` than stacked, a row of pairs needing less air between them than a column of them does, and setting this takes both.",
               "name": "--description-list-gap"
             }
           ],
@@ -39464,7 +39473,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/description-list",
             "aliases": [
               "Data list",
@@ -42247,7 +42256,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 +42276,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 +42922,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 +43015,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drawer",
             "aliases": [
               "Sheet",
@@ -43091,6 +43050,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 +43658,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 +44507,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drilldown",
             "aliases": [
               "Panel",
@@ -44672,6 +44681,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",
@@ -54001,7 +54018,7 @@
               }
             },
             {
-              "description": "Shown when the table has no readings in it.",
+              "description": "Shown when the table has no readings in it, and not before the table can be read at all: on a server, and while hydrating what one sent, there is no document to resolve `for` in and nothing is known yet.",
               "name": "empty",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -54034,10 +54051,6 @@
             }
           ],
           "slots": [
-            {
-              "description": "The `<table>` this draws, where it is not named by `for`.",
-              "name": ""
-            },
             {
               "description": "Below the strip, at the trailing edge.",
               "name": "end",
@@ -54216,7 +54229,7 @@
                 "text": "string"
               },
               "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.",
+              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
               "attribute": "empty-text",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -54360,6 +54373,20 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "sourceKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a document rather than of a\ntree. An id that resolves to nothing in a browser is still known, and still\nempty: a `for` naming no table should say so rather than sit blank.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessHeatmap",
+                "module": "src/heatmap/root/heatmap-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "rowCount",
@@ -54851,7 +54878,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/heatmap",
             "tier": "styled",
             "group": "Heatmap",
@@ -54923,7 +54950,7 @@
                 "text": "string"
               },
               "default": "'No readings'",
-              "description": "Shown when the table has no readings in it.",
+              "description": "Shown when the table has no readings in it.\n\nNever shown while the table cannot be read at all, which is a server render\nand the hydrating one after it: see `sourceKnown`.",
               "fieldName": "emptyText",
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -66824,7 +66851,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 +67001,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 +67719,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/megamenu",
             "aliases": [
               "Mega menu",
@@ -67765,7 +67792,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 +67913,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",
@@ -76563,9 +76598,8 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to leave the copy button off.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.",
+              "description": "Whether to leave the copy button off.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.\n\n**It does not reflect, where Code Block's does**, and the difference is what\nthe two sheets need. Code Block reserves the button's width with\n`:host(:not([no-copy]))`, so the attribute has to be there for a consumer\nwho set the property. This button is positioned out of the flow and takes no\nroom, so nothing selects on it, and reflection exists so that a selector can\nreach a value.",
               "attribute": "no-copy",
-              "reflects": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessObjectInspector",
                 "module": "src/object-inspector/root/object-inspector-root.ts"
@@ -76933,6 +76967,7 @@
                   }
                 }
               ],
+              "description": "One entry, named for its state where it holds one.\n\n**`row-active` and no attribute beside it.** Which row the keys are on is\ndrawn by a sheet and by nothing else: the accessibility tree hears it from\n`aria-activedescendant` on the tree, which points at this row's id, so an\nattribute would be a second spelling with no reader. The name is the one a\nconsumer can reach, nothing being able to follow `::part()` with an\nattribute selector.",
               "inheritedFrom": {
                 "name": "HelixHeadlessObjectInspector",
                 "module": "src/object-inspector/root/object-inspector-root.ts"
@@ -77280,7 +77315,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/object-inspector",
             "aliases": [
               "JSON viewer",
@@ -77585,7 +77620,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to leave the copy button off.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.",
+              "description": "Whether to leave the copy button off.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.\n\n**It does not reflect, where Code Block's does**, and the difference is what\nthe two sheets need. Code Block reserves the button's width with\n`:host(:not([no-copy]))`, so the attribute has to be there for a consumer\nwho set the property. This button is positioned out of the flow and takes no\nroom, so nothing selects on it, and reflection exists so that a selector can\nreach a value.",
               "fieldName": "noCopy",
               "inheritedFrom": {
                 "name": "HelixHeadlessObjectInspector",
@@ -80243,7 +80278,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 +81027,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 +127203,7 @@
               "name": "--tooltip-arrow-size"
             },
             {
-              "description": "Blur behind a `glass` bubble.",
+              "description": "Blur behind a `frosted` or `glass` bubble.",
               "name": "--tooltip-backdrop"
             },
             {
@@ -128243,7 +128278,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/data-table/root/data-table-root.css.js

@@ -66,6 +66,8 @@ font-size: var(--data-table-text, var(--helix-text-sm));
 padding-block: var(--data-table-padding-block, var(--helix-space-sm));
 
 padding-inline: var(--data-table-padding-inline, var(--helix-space-none) var(--helix-space-md));
+
+text-align: var(--data-table-cell-align);
 }
 
 [part="row"]:last-of-type [part~="cell"] {

package/dist/data-table/root/data-table-root.d.ts

@@ -25,7 +25,7 @@ import '../../table/index.js';
  * `helix-table` where the content has to be in the served HTML.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category data
  * @documentation https://fusion.dev/helix/components/data-table
  *

package/dist/description-list/item/description-list-item.d.ts

@@ -8,7 +8,7 @@ import type { CSSResultGroup } from 'lit';
  * to a screen reader, while lining up with every other pair in the list.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/description-list
  */
 export declare class HelixDescriptionListItem extends HelixHeadlessDescriptionListItem {

package/dist/description-list/root/description-list-root.d.ts

@@ -20,12 +20,12 @@ import type { CSSResultGroup } from 'lit';
  * figures of one width, which is how a set of totals is read.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category data
  * @aliases Data list, Key-value list, Details, Properties
  * @documentation https://fusion.dev/helix/components/description-list
  *
- * @cssproperty --description-list-gap - Space between one pair and the next.
+ * @cssproperty --description-list-gap - Space between one pair and the next. Its resting value is tighter with `direction="row"` than stacked, a row of pairs needing less air between them than a column of them does, and setting this takes both.
  */
 export declare class HelixDescriptionList extends HelixHeadlessDescriptionList {
     static styles: CSSResultGroup;

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