@fusion.dev/helix-headless 0.37.0 → 0.39.0

package/custom-elements.json

@@ -20391,7 +20391,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"
             },
             {
@@ -21987,7 +21987,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"
             },
             {
@@ -22242,7 +22242,7 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/combobox",
             "aliases": [
               "Autocomplete",
@@ -24410,6 +24410,10 @@
           "description": "**The schema is markup and the data is a property.** Columns are declared as\n`helix-table-column` children, because a schema is small and something a\nreader should see in the HTML; rows are handed over as an array, because a\ntable that draws ten thousand elements cannot window them.\n\n```html\n<helix-data-table .rows=${rows} sort=\"name:asc\" page-size=\"20\">\n  <helix-table-column field=\"name\" sortable>Name</helix-table-column>\n  <helix-table-column field=\"size\" align=\"end\" sortable .cell=${bytes}>Size</helix-table-column>\n</helix-data-table>\n```\n\n`helix-table` takes rows as markup and is the right component for a table of\ntwelve things a person wrote out.\n\n**Sort and filter apply to the whole set, never the page.** Sorting the drawn\nwindow is correct on the first screen and wrong on every other one.\n\n**The cell values do not server-render.** The headings do, and the row\nelements do, but reading a cell needs the columns, and the columns are markup\nchildren Lit SSR does not hand this element. So a crawler sees a table of the\nright shape with nothing in it. That is the cost of the first paragraph: use\n`helix-table` where the served HTML has to carry the values.\n\n**`selectable` adds a column of checkboxes, keyed on `row-key`.** A row is\nselected by its identity rather than its position, so a selection survives a\nsort, a filter and a page. `selected` is the chosen keys, comma separated, the\nshape Listbox uses for a multiple choice, and like `sort` it is controlled\nwhen set and seeded by `default-selected`. The box in the heading selects every\nrow in the result, across pages, and shows a dash while only some are chosen.\nChoosing one of many, rather than several, is opening a row, and that is a\nlink or a button in a cell rather than a selection.\n\n**A reader can size and order the columns.** `resizable` on a column puts a\nseparator on its edge; `reorderable` on the table puts a grip on each heading\nthat has a `field`, moved by dragging or with the arrow keys. The order lands\nin `order` as fields, and the consumer's own markup is never rewritten: the\ntable assigns the headings to its header in that order instead.\n\n**`csv()` hands back the result as text**: every row the filter lets through,\nin the order on screen, in the columns on screen. Saving it is the page's\nbusiness, the same as any other file.",
           "name": "HelixHeadlessDataTable",
           "cssProperties": [
+            {
+              "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"
+            },
             {
               "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"
@@ -24473,7 +24477,7 @@
               "name": "checkbox-mark-indeterminate"
             },
             {
-              "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"
             },
             {
@@ -25098,7 +25102,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"
@@ -25469,7 +25473,8 @@
                     "text": "boolean"
                   }
                 }
-              ]
+              ],
+              "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."
             },
             {
               "kind": "method",
@@ -26453,7 +26458,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/data-table",
             "aliases": [
               "Grid",
@@ -30698,7 +30703,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"
             },
             {
@@ -31033,7 +31038,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"
             }
           ],
@@ -31044,7 +31049,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": "headless",
             "group": "BaseDescriptionList",
@@ -31459,7 +31464,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/description-list",
             "aliases": [
               "Data list",
@@ -34311,7 +34316,7 @@
           "helix": {
             "category": "overlays",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drawer",
             "aliases": [
               "Sheet",
@@ -34873,7 +34878,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",
@@ -35639,6 +35644,20 @@
               }
             }
           ],
+          "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"
+            },
+            {
+              "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",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
           "mixins": [
             {
               "name": "MixinCollection",
@@ -35653,7 +35672,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/drilldown",
             "aliases": [
               "Panel",
@@ -35673,16 +35692,6 @@
           },
           "tagName": "helix-headless-drilldown",
           "customElement": true,
-          "cssStates": [
-            {
-              "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",
-              "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
-              }
-            }
-          ],
           "modulePath": "src/drilldown/root/drilldown-root.ts",
           "definitionPath": "src/drilldown/root/drilldown-root.ts"
         }
@@ -42745,7 +42754,7 @@
               "name": "cell"
             },
             {
-              "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"
             },
             {
@@ -42855,7 +42864,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"
             },
             {
@@ -42975,6 +42984,16 @@
               "description": "Every reading in the table, oldest first, as the table is written.\n\n**Not `readings`, which the mixin already has and which means a count.**\nTwo members of the same name meaning a number and an array is the kind of\ncollision that type-checks in one direction and reads wrong in both.",
               "readonly": true
             },
+            {
+              "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
+            },
             {
               "kind": "field",
               "name": "rowCount",
@@ -43548,7 +43567,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"
             },
             {
@@ -43637,7 +43656,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/heatmap",
             "aliases": [
               "Contribution graph",
@@ -53530,7 +53549,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"
             },
             {
@@ -54263,7 +54282,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"
             },
             {
@@ -54319,6 +54338,10 @@
             }
           ],
           "cssStates": [
+            {
+              "description": "While the page is under `full-below`, so the panel is a band whether or not one was asked for.",
+              "name": "narrow"
+            },
             {
               "description": "While the panel is open, which is when the trigger reads as current.",
               "name": "open"
@@ -54346,7 +54369,7 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/megamenu",
             "aliases": [
               "Mega menu",
@@ -61502,9 +61525,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.",
-              "attribute": "no-copy",
-              "reflects": true
+              "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"
             },
             {
               "kind": "field",
@@ -61783,7 +61805,8 @@
                     "text": "number"
                   }
                 }
-              ]
+              ],
+              "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."
             },
             {
               "kind": "method",
@@ -62173,7 +62196,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"
             },
             {
@@ -62194,7 +62217,7 @@
           "helix": {
             "category": "data",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/object-inspector",
             "aliases": [
               "JSON viewer",
@@ -63945,11 +63968,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"
             }
           ],
           "attributes": [
@@ -85243,6 +85266,24 @@
           ],
           "description": "A dot path resolved against a row.\n\nWritten here rather than taken from a library, because the whole of what is\nneeded is \"walk the keys and stop at the first thing that is not an object\".\nReturns `undefined` for a path that does not resolve, which the table renders\nas an empty cell: a missing key is a hole in the data and drawing `undefined`\ninto a table tells a reader the software is broken rather than the row is."
         },
+        {
+          "kind": "function",
+          "name": "edgeOf",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "align",
+              "type": {
+                "text": "string | undefined"
+              }
+            }
+          ],
+          "description": "The edge a column names, where it names one of the three.\n\n**`align` is a string anybody can write**, the union on the property being a\ncompile-time claim and nothing else, and both tables put the value straight\ninto CSS: `helix-table` into a rule in each row's shadow root, `helix-data-table`\ninto the cell it draws. One guard, here with the property, rather than one in\neach table and only one of them written."
+        },
         {
           "kind": "class",
           "description": "**The column is the source of both its heading and its track.** Add one and\nthe table has another track; remove one and it does not. Declaring the widths\nseparately, as a CSS track list on the table, leaves nothing tying the two\ntogether: a table with three headings and a two-track list renders without\ncomplaint, and a track list that is accidentally the headings is invalid CSS\nthe grid silently ignores, collapsing the whole table into one column.\n\n**It is also where every per-column fact goes**, which is the reason\n`helix-data-table` needs no column config object. `field` names the key the\ncell reads, `sortable` says a reader may reorder by it, `align` says which\nedge the values line up against, and `cell` takes a function for anything the\nfield alone cannot express. The schema is markup and the data is a property:\na schema is small, declarative, and something a reader should be able to see\nin the HTML, and data is large and windowed.\n\n**The same element serves both tables**, the markup one and the data one. It\nis identified by a flag rather than by `instanceof`, so a `helix-table-column`\nworks inside either without the two roots sharing anything else.\n\n**It generates no box of its own**, the same as a row: the heading is a grid\nitem of the table, so it lines up with the cells under it rather than sitting\nin a wrapper that has to be kept the same width.\n\n**`hidden` takes the column out of the grid**, its heading and its track\nboth, so the columns after it keep their own widths and every row keeps its\ncells under their headings. `hidden=\"until-found\"` keeps its track, the\nheading being left drawn, as every Helix element leaves one with that value.\n`helix-data-table` draws the cells, so it leaves out the ones under a hidden\ncolumn. A `helix-table`'s cells are markup the consumer wrote, so hide them\nwith the column, as removing a column means removing its cells: a row with a\ncell more than the table has tracks wraps into the next.\n\n**A heading that does something holds a control that does it.** The host is\nthe column header, and a header is not focusable, so a sortable heading is a\n`<button>` inside it: the pattern for a sortable table, and the only way a\nreader on a keyboard reaches the sort at all. A column a reader may resize\ncarries a `separator` on its end edge, moved by dragging it or with the arrow\nkeys, and a column in a table that lets a reader reorder its columns carries\na grip the table moves.",
@@ -85980,6 +86021,14 @@
             "module": "src/table/column/table-column.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "edgeOf",
+          "declaration": {
+            "name": "edgeOf",
+            "module": "src/table/column/table-column.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixHeadlessTableColumn",
@@ -100133,7 +100182,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

@@ -34,7 +34,7 @@ declare const HelixHeadlessCombobox_base: (new (...args: any[]) => import("@fusi
  * row and fires the event; adding the option is the consumer's.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Autocomplete, Typeahead, Search select
  * @documentation https://fusion.dev/helix/components/combobox
@@ -134,6 +134,15 @@ export declare class HelixHeadlessCombobox extends HelixHeadlessCombobox_base {
      *
      * 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.
      */
     multiple: boolean;
     /**

package/dist/combobox/root/combobox-root.js

@@ -304,7 +304,6 @@ let HelixHeadlessCombobox = class HelixHeadlessCombobox extends MixinControllerO
           aria-autocomplete=${this.suggest ? 'both' : 'list'}
           aria-expanded=${this.open ? 'true' : 'false'}
           aria-describedby=${this.describedBy ?? nothing}
-          aria-multiselectable=${this.multiple ? 'true' : nothing}
           placeholder=${(this.chosen.length > 0 ? '' : this.placeholder) || nothing}
           ?disabled=${this.isDisabled}
           .value=${this.multiple || this.open ? this.suggestion || this.typed : this.word}

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

@@ -53,7 +53,7 @@ declare const HelixHeadlessDataTable_base: (new (...args: any[]) => import("@fus
  * business, the same as any other file.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category data
  * @aliases Grid, Result table, Data grid
  * @documentation https://fusion.dev/helix/components/data-table
@@ -82,7 +82,7 @@ declare const HelixHeadlessDataTable_base: (new (...args: any[]) => import("@fus
  * @csspart checkbox-mark - The tick, or the dash while some rows are selected.
  * @csspart checkbox-mark-checked - The mark while its box is checked, beside `checkbox-mark`.
  * @csspart checkbox-mark-indeterminate - The dash while only some rows are selected, beside `checkbox-mark`.
- * @csspart empty - Shown when no rows match.
+ * @csspart empty - 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.
  * @csspart footer - The region below the grid.
  * @csspart head - The row the column headings sit in. `display: contents`, so it takes no space.
  * @csspart loading - Shown while the rows are still on their way.
@@ -106,6 +106,7 @@ declare const HelixHeadlessDataTable_base: (new (...args: any[]) => import("@fus
  * @csspart table - The grid.
  * @csspart toolbar - The region above the grid.
  *
+ * @cssproperty --data-table-cell-align - 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.
  * @cssproperty --data-table-template - 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.
  */
 export declare class HelixHeadlessDataTable extends HelixHeadlessDataTable_base {
@@ -451,7 +452,19 @@ export declare class HelixHeadlessDataTable extends HelixHeadlessDataTable_base
      * asking `view` for it would recurse through the clamp in `page`.
      */
     private get matched();
-    /** Emptiness is a fact about the data here, not about slotted children. */
+    /**
+     * Emptiness is a fact about the data here, not about slotted children.
+     *
+     * **The page rather than the window**, which is the difference between the two
+     * counts `view` carries and the reason this reads `available`. A windowed
+     * table draws a slice, and a slice can be short of the rows that are there:
+     * asking whether *this* slice has rows says "nothing matched" about a result
+     * that matched plenty.
+     *
+     * The mixin's own answer counts children with no `slot`, which for this
+     * element is the columns. Left in place, a table with columns and no data
+     * would call itself full.
+     */
     protected get hasRows(): boolean;
     /**
      * Asks for a different order, and reports whether the request stood.
@@ -575,6 +588,21 @@ export declare class HelixHeadlessDataTable extends HelixHeadlessDataTable_base
     private announceSort;
     /** Columns arrive from the light DOM, which changes no property here. */
     private readonly handleSlotChange;
+    /**
+     * One cell, carrying its column's edge as a fact rather than as a decision.
+     *
+     * **A fact published rather than a property chosen**, which is what
+     * `helix-table` does with the same attribute: what lining up *means*, a
+     * `justify-content` for a value that fits or a `text-align` for one that
+     * wraps, belongs to whoever draws the cell. Written here as an inline
+     * `text-align` it was this tier choosing, in the tier that ships no CSS, and a
+     * consumer could not overrule it either, an inline declaration beating any
+     * `::part(cell)` rule they wrote.
+     *
+     * Only the three edges reach it, `align` being a string anybody can write and
+     * this being a style attribute: `edgeOf` is that guard, and `helix-table`
+     * holds the same value to the same three.
+     */
     private renderCell;
     /**
      * A checkbox, named for what it chooses, whose change the table takes.

package/dist/data-table/root/data-table-root.js

@@ -10,7 +10,7 @@ import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { repeat } from 'lit/directives/repeat.js';
 import { html } from 'lit/static-html.js';
-import { at } from '../../table/column/table-column.js';
+import { at, edgeOf } from '../../table/column/table-column.js';
 import '../../checkbox/index.js';
 import '../../pagination/index.js';
 import { arranged, cycle, format, ordered, parse, window_, } from './order.js';
@@ -353,7 +353,7 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
         })).length;
     }
     get hasRows() {
-        return this.view.rows.length > 0;
+        return this.view.available > 0;
     }
     requestSort(next) {
         return requestChange({
@@ -547,10 +547,11 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
         }
     }
     renderCell(column, row, picked) {
+        const edge = edgeOf(column.align);
         return html `<span
       part="cell${picked ? ' cell-selected' : ''}"
       role="gridcell"
-      style=${column.align ? `text-align: ${column.align}` : nothing}
+      style=${edge ? `--data-table-cell-align: ${edge}` : nothing}
       >${column.read(row)}</span
     >`;
     }
@@ -619,6 +620,7 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
     }
     render() {
         const { available, matched, rows } = this.view;
+        const filled = this.hasRows;
         const template = this.template;
         const columns = this.shownColumns;
         const pagination = this.tag('pagination');
@@ -638,7 +640,7 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
             : html `<slot name="columns" @slotchange=${this.handleSlotChange}></slot>`}
         </div>
         ${this.renderSpacer('before')}${this.renderRows(rows)}${this.renderSpacer('after')}
-        ${this.renderStatus(available > 0)}
+        ${this.renderStatus(filled)}
       </div>
       <div part="footer">
         <slot name="footer"></slot>

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

@@ -13,7 +13,7 @@ import { type TemplateResult } from 'lit';
  * it is also a property.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @documentation https://fusion.dev/helix/components/description-list
  *
  * @slot - The value.
@@ -24,10 +24,11 @@ import { type TemplateResult } from 'lit';
  */
 export declare class HelixHeadlessDescriptionListItem extends HelixElement {
     /**
-     * What the value is, for the common case of plain text.
+     * What the value is called, for the common case of plain text.
      *
      * The fallback of the `label` slot, so slotted content replaces it rather than
-     * appearing beside it.
+     * appearing beside it. The value itself is the default slot: it is the half
+     * that varies and is often more than text.
      */
     label: string;
     protected render(): TemplateResult;

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

@@ -21,7 +21,7 @@ import { type TemplateResult } from 'lit';
  * `display: contents` alike.
  *
  * @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

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

@@ -29,7 +29,7 @@ declare const HelixHeadlessDrawer_base: (new (...args: any[]) => import("@fusion
  * ```
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category overlays
  * @aliases Sheet, Sidebar, Panel, Off-canvas
  * @documentation https://fusion.dev/helix/components/drawer

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

@@ -24,7 +24,7 @@ import { nothing, type PropertyValues, type TemplateResult } from 'lit';
  * pressed. Not on the server, which cannot see the children and so cannot know.
  *
  * @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

@@ -27,7 +27,7 @@ declare const HelixHeadlessDrilldown_base: (new (...args: any[]) => import("@fus
  * shares.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category navigation
  * @aliases Panel, Nested list, Drill-in
  * @documentation https://fusion.dev/helix/components/drilldown
@@ -43,6 +43,8 @@ declare const HelixHeadlessDrilldown_base: (new (...args: any[]) => import("@fus
  * @csspart loading - Shown while the entries are still on their way.
  * @csspart page - The region the rows are in.
  * @csspart title - The name of the page showing.
+ *
+ * @cssstate 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.
  */
 export declare class HelixHeadlessDrilldown extends HelixHeadlessDrilldown_base {
     /**

package/dist/drilldown/root/drilldown-root.js

@@ -123,7 +123,7 @@ let HelixHeadlessDrilldown = class HelixHeadlessDrilldown extends MixinCollectio
             this.mark(child, page, page === null);
         }
         this.placeTabStop();
-        this.toggleAttribute('data-drilled', !this.drilldown.atRoot);
+        this.toggleState('drilled', !this.drilldown.atRoot);
         if (this.direction === undefined) {
             this.removeAttribute('data-direction');
         }

package/dist/element-events.generated.js

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