@fusion.dev/helix 0.38.0 → 0.39.0

package/custom-elements.json

@@ -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",
@@ -54009,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",
@@ -54042,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",
@@ -54224,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",
@@ -54368,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",
@@ -54859,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",
@@ -54931,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",
@@ -76579,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"
@@ -76949,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"
@@ -77296,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",
@@ -77601,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",

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/heatmap/root/heatmap-root.d.ts

@@ -18,11 +18,10 @@ import '../../tooltip/index.js';
  * thing two cells can be compared by.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category charts
  * @documentation https://fusion.dev/helix/components/heatmap
  *
- * @slot - The `<table>` this draws, where it is not named by `for`.
  * @slot end - Below the strip, at the trailing edge.
  * @slot start - Below the strip, at the leading edge.
  * @slot summary - Below the strip, in the middle.

package/dist/object-inspector/root/object-inspector-root.css.js

@@ -81,11 +81,11 @@ var(--helix-space-sm)
 );
 }
 
-[part="tree"]:focus [part~="row"][data-active] {
+[part="tree"]:focus [part~="row-active"] {
 background-color: var(--helix-color-surface-sunken);
 }
 
-[part="tree"]:focus-visible [part~="row"][data-active] {
+[part="tree"]:focus-visible [part~="row-active"] {
 outline: var(--helix-size-focus-ring) solid var(--helix-color-focus-ring);
 outline-offset: calc(var(--helix-size-focus-offset) * -1);
 }

package/dist/object-inspector/root/object-inspector-root.d.ts

@@ -13,7 +13,7 @@ import '../../copy-button/index.js';
  * never has to measure them one by one.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category data
  * @aliases JSON viewer, Object viewer, Inspector, Data explorer
  * @documentation https://fusion.dev/helix/components/object-inspector

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

@@ -6441,18 +6441,20 @@ reader makes in one of these. */
 };
 
 export type HelixDescriptionListItemProps = {
-  /** 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?: (HelixDescriptionListItem["label"]) | undefined;
 };
 
 export type HelixDescriptionListItemSolidJsProps = {
-  /** 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. */
   "prop:label"?: (HelixDescriptionListItem["label"]) | undefined;
 
   /** Set the innerHTML of the element */
@@ -8270,9 +8272,15 @@ shadow root names a table in that root rather than in the document. A
 Absent falls back to the table's own caption, which is usually the right
 words and is already written. */
   label?: (HelixHeatmap["label"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   "empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   emptyText?: (HelixHeatmap["emptyText"]) | undefined;
   /** Space between cells, in CSS pixels, for the same reason `min-cell` is a
 number. */
@@ -8359,9 +8367,15 @@ shadow root names a table in that root rather than in the document. A
 Absent falls back to the table's own caption, which is usually the right
 words and is already written. */
   "prop:label"?: (HelixHeatmap["label"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   "attr:empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   "prop:emptyText"?: (HelixHeatmap["emptyText"]) | undefined;
   /** Space between cells, in CSS pixels, for the same reason `min-cell` is a
 number. */
@@ -11679,12 +11693,26 @@ page's markup should not take the page down over a comma. */
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   "no-copy"?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   noCopy?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to draw only the rows in view.
 
@@ -11727,12 +11755,26 @@ page's markup should not take the page down over a comma. */
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   "bool:no-copy"?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   "prop:noCopy"?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to draw only the rows in view.
 
@@ -24510,6 +24552,7 @@ export type CustomElements = {
    * - `--data-table-padding-inline`: Space either side of a cell's content. (default: `undefined`)
    * - `--data-table-rule-color`: Color of the hairline between rows. A color and not a border: it lands in the color slot of a shorthand, so a whole border written into it produces invalid CSS and drops the rule. Drawn on the cells rather than the row, which is `display: contents` and measures `0px`. (default: `undefined`)
    * - `--data-table-text`: Type size, headings and cells alike. (default: `undefined`)
+   * - `--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. (default: `undefined`)
    * - `--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. (default: `undefined`)
    *
    * ## CSS Parts
@@ -24531,7 +24574,7 @@ export type CustomElements = {
    * - `checkbox-mark`: The tick, or the dash while some rows are selected.
    * - `checkbox-mark-checked`: The mark while its box is checked, beside `checkbox-mark`.
    * - `checkbox-mark-indeterminate`: The dash while only some rows are selected, beside `checkbox-mark`.
-   * - `empty`: Shown when no rows match.
+   * - `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.
    * - `footer`: The region below the grid.
    * - `head`: The row the column headings sit in. `display: contents`, so it takes no space.
    * - `loading`: Shown while the rows are still on their way.
@@ -25126,10 +25169,11 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `label`: What the value is, for the common case of plain text.
+   * - `label`: 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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -25259,7 +25303,7 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--description-list-gap`: Space between one pair and the next. (default: `undefined`)
+   * - `--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. (default: `undefined`)
    *
    * ## CSS Parts
    *
@@ -27231,6 +27275,9 @@ export type CustomElements = {
    * Absent falls back to the table's own caption, which is usually the right
    * words and is already written.
    * - `empty-text`/`emptyText`: Shown when the table has no readings in it.
+   *
+   * Never shown while the table cannot be read at all, which is a server render
+   * and the hydrating one after it: see `sourceKnown`.
    * - `gap`: Space between cells, in CSS pixels, for the same reason `min-cell` is a
    * number.
    * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
@@ -27347,7 +27394,6 @@ export type CustomElements = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The `<table>` this draws, where it is not named by `for`.
    * - `end`: Below the strip, at the trailing edge.
    * - `start`: Below the strip, at the leading edge.
    * - `summary`: Below the strip, in the middle.
@@ -27399,7 +27445,7 @@ export type CustomElements = {
    * - `tooltip-right`: The bubble while it is right of the reading, beside `tooltip`.
    * - `tooltip-top`: The bubble while it is above the reading, beside `tooltip`.
    * - `tooltip-value`: A column's value inside the tooltip.
-   * - `empty`: Shown when the table has no readings in it.
+   * - `empty`: 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.
    * - `end`: The trailing slot's box.
    * - `start`: The leading slot's box.
    * - `summary`: The middle slot's box.
@@ -30444,6 +30490,13 @@ export type CustomElements = {
    *
    * Negative for the reason Code Block's is: a boolean attribute defaulting to
    * true could never be turned off from markup.
+   *
+   * **It does not reflect, where Code Block's does**, and the difference is what
+   * the two sheets need. Code Block reserves the button's width with
+   * `:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+   * who set the property. This button is positioned out of the flow and takes no
+   * room, so nothing selects on it, and reflection exists so that a selector can
+   * reach a value.
    * - `windowed`: Whether to draw only the rows in view.
    *
    * For a value of thousands of entries. Reflected, because the box it scrolls
@@ -43427,6 +43480,7 @@ export type CustomElementsSolidJs = {
    * - `--data-table-padding-inline`: Space either side of a cell's content. (default: `undefined`)
    * - `--data-table-rule-color`: Color of the hairline between rows. A color and not a border: it lands in the color slot of a shorthand, so a whole border written into it produces invalid CSS and drops the rule. Drawn on the cells rather than the row, which is `display: contents` and measures `0px`. (default: `undefined`)
    * - `--data-table-text`: Type size, headings and cells alike. (default: `undefined`)
+   * - `--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. (default: `undefined`)
    * - `--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. (default: `undefined`)
    *
    * ## CSS Parts
@@ -43448,7 +43502,7 @@ export type CustomElementsSolidJs = {
    * - `checkbox-mark`: The tick, or the dash while some rows are selected.
    * - `checkbox-mark-checked`: The mark while its box is checked, beside `checkbox-mark`.
    * - `checkbox-mark-indeterminate`: The dash while only some rows are selected, beside `checkbox-mark`.
-   * - `empty`: Shown when no rows match.
+   * - `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.
    * - `footer`: The region below the grid.
    * - `head`: The row the column headings sit in. `display: contents`, so it takes no space.
    * - `loading`: Shown while the rows are still on their way.
@@ -44052,10 +44106,11 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `label`: What the value is, for the common case of plain text.
+   * - `label`: 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.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -44186,7 +44241,7 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
-   * - `--description-list-gap`: Space between one pair and the next. (default: `undefined`)
+   * - `--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. (default: `undefined`)
    *
    * ## CSS Parts
    *
@@ -46209,6 +46264,9 @@ export type CustomElementsSolidJs = {
    * Absent falls back to the table's own caption, which is usually the right
    * words and is already written.
    * - `empty-text`/`emptyText`: Shown when the table has no readings in it.
+   *
+   * Never shown while the table cannot be read at all, which is a server render
+   * and the hydrating one after it: see `sourceKnown`.
    * - `gap`: Space between cells, in CSS pixels, for the same reason `min-cell` is a
    * number.
    * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
@@ -46325,7 +46383,6 @@ export type CustomElementsSolidJs = {
    *
    * Areas where markup can be added to the component.
    *
-   * - `(default)`: The `<table>` this draws, where it is not named by `for`.
    * - `end`: Below the strip, at the trailing edge.
    * - `start`: Below the strip, at the leading edge.
    * - `summary`: Below the strip, in the middle.
@@ -46377,7 +46434,7 @@ export type CustomElementsSolidJs = {
    * - `tooltip-right`: The bubble while it is right of the reading, beside `tooltip`.
    * - `tooltip-top`: The bubble while it is above the reading, beside `tooltip`.
    * - `tooltip-value`: A column's value inside the tooltip.
-   * - `empty`: Shown when the table has no readings in it.
+   * - `empty`: 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.
    * - `end`: The trailing slot's box.
    * - `start`: The leading slot's box.
    * - `summary`: The middle slot's box.
@@ -49487,6 +49544,13 @@ export type CustomElementsSolidJs = {
    *
    * Negative for the reason Code Block's is: a boolean attribute defaulting to
    * true could never be turned off from markup.
+   *
+   * **It does not reflect, where Code Block's does**, and the difference is what
+   * the two sheets need. Code Block reserves the button's width with
+   * `:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+   * who set the property. This button is positioned out of the flow and takes no
+   * room, so nothing selects on it, and reflection exists so that a selector can
+   * reach a value.
    * - `windowed`: Whether to draw only the rows in view.
    *
    * For a value of thousands of entries. Reflected, because the box it scrolls
@@ -58217,6 +58281,8 @@ export type CustomCssProperties = {
   "--data-table-rule-color"?: (string) | undefined;
   /** Type size, headings and cells alike. */
   "--data-table-text"?: (string) | undefined;
+  /** 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. */
+  "--data-table-cell-align"?: (string) | undefined;
   /** 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. */
   "--data-table-template"?: (string) | undefined;
   /** Fill behind the field. */
@@ -58241,7 +58307,7 @@ export type CustomCssProperties = {
   "--date-picker-track-size"?: (string) | undefined;
   /** How many month columns are drawn, capped at two. `--date-picker-columns` overrides it. */
   "--date-picker-column-count"?: (string) | undefined;
-  /** Space between one pair and the next. */
+  /** 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. */
   "--description-list-gap"?: (string) | undefined;
   /** Color of the panel's edge. */
   "--dialog-border-color"?: (string) | undefined;

package/types/vue.d.ts

@@ -3301,10 +3301,11 @@ export type HelixDatePickerVueEvents = {
 };
 
 export type HelixDescriptionListItemVueProps = {
-  /** 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?: (HelixDescriptionListItem["label"]) | undefined;
 };
 
@@ -4254,9 +4255,15 @@ shadow root names a table in that root rather than in the document. A
 Absent falls back to the table's own caption, which is usually the right
 words and is already written. */
   label?: (HelixHeatmap["label"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   "empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
-  /** Shown when the table has no readings in it. */
+  /** Shown when the table has no readings in it.
+
+Never shown while the table cannot be read at all, which is a server render
+and the hydrating one after it: see `sourceKnown`. */
   emptyText?: (HelixHeatmap["emptyText"]) | undefined;
   /** Space between cells, in CSS pixels, for the same reason `min-cell` is a
 number. */
@@ -5999,12 +6006,26 @@ page's markup should not take the page down over a comma. */
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   "no-copy"?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to leave the copy button off.
 
 Negative for the reason Code Block's is: a boolean attribute defaulting to
-true could never be turned off from markup. */
+true could never be turned off from markup.
+
+**It does not reflect, where Code Block's does**, and the difference is what
+the two sheets need. Code Block reserves the button's width with
+`:host(:not([no-copy]))`, so the attribute has to be there for a consumer
+who set the property. This button is positioned out of the flow and takes no
+room, so nothing selects on it, and reflection exists so that a selector can
+reach a value. */
   noCopy?: (HelixObjectInspector["noCopy"]) | undefined;
   /** Whether to draw only the rows in view.
 
@@ -10474,6 +10495,8 @@ export type CustomCssProperties = {
   "--data-table-rule-color"?: (string) | undefined;
   /** Type size, headings and cells alike. */
   "--data-table-text"?: (string) | undefined;
+  /** 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. */
+  "--data-table-cell-align"?: (string) | undefined;
   /** 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. */
   "--data-table-template"?: (string) | undefined;
   /** Fill behind the field. */
@@ -10498,7 +10521,7 @@ export type CustomCssProperties = {
   "--date-picker-track-size"?: (string) | undefined;
   /** How many month columns are drawn, capped at two. `--date-picker-columns` overrides it. */
   "--date-picker-column-count"?: (string) | undefined;
-  /** Space between one pair and the next. */
+  /** 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. */
   "--description-list-gap"?: (string) | undefined;
   /** Color of the panel's edge. */
   "--dialog-border-color"?: (string) | undefined;