@fusion.dev/helix-headless 0.37.0 → 0.39.0

package/types/jsx.d.ts

@@ -162,6 +162,7 @@ import type {
   HelixSortEvent,
   HelixTourAskEvent,
   at,
+  edgeOf,
   fromMinutes,
   initialsOf,
   isTime,
@@ -3283,7 +3284,16 @@ toggles rather than replaces, and the arrows move without choosing. What
 this adds is the tags, and keeping the panel open between picks.
 
 A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change. */
+listbox's contract and not this element's to change.
+
+**The list is told, and the field is not.** `aria-multiselectable` belongs
+to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+reader on the field hears it through `aria-controls`. This element wrote it
+onto its own `role="combobox"` input as well, which an audit reports as a
+property the role does not support and no spec here ever asserted: the one
+that covers this says in as many words that telling the list is what this
+element is responsible for. */
   multiple?: (HelixHeadlessCombobox["multiple"]) | undefined;
   /** Text shown while nothing has been chosen. */
   placeholder?: (HelixHeadlessCombobox["placeholder"]) | undefined;
@@ -3449,7 +3459,16 @@ toggles rather than replaces, and the arrows move without choosing. What
 this adds is the tags, and keeping the panel open between picks.
 
 A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change. */
+listbox's contract and not this element's to change.
+
+**The list is told, and the field is not.** `aria-multiselectable` belongs
+to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+reader on the field hears it through `aria-controls`. This element wrote it
+onto its own `role="combobox"` input as well, which an audit reports as a
+property the role does not support and no spec here ever asserted: the one
+that covers this says in as many words that telling the list is what this
+element is responsible for. */
   "prop:multiple"?: (HelixHeadlessCombobox["multiple"]) | undefined;
   /** Text shown while nothing has been chosen. */
   "prop:placeholder"?: (HelixHeadlessCombobox["placeholder"]) | undefined;
@@ -5297,18 +5316,20 @@ reader makes in one of these. */
 };
 
 export type HelixHeadlessDescriptionListItemProps = {
-  /** 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?: (HelixHeadlessDescriptionListItem["label"]) | undefined;
 };
 
 export type HelixHeadlessDescriptionListItemSolidJsProps = {
-  /** 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"?: (HelixHeadlessDescriptionListItem["label"]) | undefined;
 
   /** Set the innerHTML of the element */
@@ -6923,9 +6944,15 @@ export type HelixHeadlessHeatmapHelixResizeElementEvent =
   HelixHeadlessHeatmapElementEvent<HelixResizeEvent>;
 
 export type HelixHeadlessHeatmapProps = {
-  /** 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"?: (HelixHeadlessHeatmap["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?: (HelixHeadlessHeatmap["emptyText"]) | undefined;
   /** Space between cells, in CSS pixels, for the same reason `min-cell` is a
 number. */
@@ -7012,9 +7039,15 @@ words and is already written. */
 };
 
 export type HelixHeadlessHeatmapSolidJsProps = {
-  /** 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"?: (HelixHeadlessHeatmap["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"?: (HelixHeadlessHeatmap["emptyText"]) | undefined;
   /** Space between cells, in CSS pixels, for the same reason `min-cell` is a
 number. */
@@ -8659,8 +8692,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+narrow exception the server specs describe covers a mirror that can only
+become true long after hydration, and a viewport measured before the first
+paint is the opposite case. See `MixinControllerOpen` on `open`. */
   "full-below"?: (HelixHeadlessMegamenu["fullBelow"] | `${number}`) | undefined;
   /** The width, in pixels, under which a card becomes a band. Zero never does.
 
@@ -8675,8 +8716,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+narrow exception the server specs describe covers a mirror that can only
+become true long after hydration, and a viewport measured before the first
+paint is the opposite case. See `MixinControllerOpen` on `open`. */
   fullBelow?: (HelixHeadlessMegamenu["fullBelow"]) | undefined;
   /** The section's name, which names the default trigger and the panel. */
   label?: (HelixHeadlessMegamenu["label"]) | undefined;
@@ -8752,8 +8801,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+narrow exception the server specs describe covers a mirror that can only
+become true long after hydration, and a viewport measured before the first
+paint is the opposite case. See `MixinControllerOpen` on `open`. */
   "attr:full-below"?: (HelixHeadlessMegamenu["fullBelow"] | `${number}`) | undefined;
   /** The width, in pixels, under which a card becomes a band. Zero never does.
 
@@ -8768,8 +8825,16 @@ fits.
 a band is not a question of paint: a band is not placed against the trigger,
 so the controller has to be told not to measure, and that decision is here
 whatever the stylesheet says. Writing the width in both places would be one
-number in two languages, drifting the first time either moved. This sets
-`data-narrow` on the host and the stylesheet arranges itself off that. */
+number in two languages, drifting the first time either moved. This records
+`:state(narrow)` on the host and the stylesheet arranges itself off that.
+
+**A custom state and never `data-narrow`, which is what it was.** The width
+is read in `connectedCallback`, so on a phone this is true on the very first
+update: an attribute written there is markup a consumer's server never sent,
+which React reports as a mismatch and answers by rebuilding the subtree. The
+narrow exception the server specs describe covers a mirror that can only
+become true long after hydration, and a viewport measured before the first
+paint is the opposite case. See `MixinControllerOpen` on `open`. */
   "prop:fullBelow"?: (HelixHeadlessMegamenu["fullBelow"]) | undefined;
   /** The section's name, which names the default trigger and the panel. */
   "prop:label"?: (HelixHeadlessMegamenu["label"]) | undefined;
@@ -9929,12 +9994,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"?: (HelixHeadlessObjectInspector["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?: (HelixHeadlessObjectInspector["noCopy"]) | undefined;
   /** Whether to draw only the rows in view.
 
@@ -9979,12 +10058,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"?: (HelixHeadlessObjectInspector["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"?: (HelixHeadlessObjectInspector["noCopy"]) | undefined;
   /** Whether to draw only the rows in view.
 
@@ -10230,9 +10323,9 @@ export type HelixHeadlessOutlineElementEvent<E = Event> = TypedEvent<
   HelixHeadlessOutline,
   E
 >;
-/** `helix-before-activate` event type */
-export type HelixHeadlessOutlineHelixBeforeActivateElementEvent =
-  HelixHeadlessOutlineElementEvent<HelixBeforeActivateEvent>;
+/** `helix-activate` event type */
+export type HelixHeadlessOutlineHelixActivateElementEvent =
+  HelixHeadlessOutlineElementEvent<HelixActivateEvent>;
 
 export type HelixHeadlessOutlineProps = {
   /** How a click on one of these links travels to its section.
@@ -10265,9 +10358,9 @@ a little more: without it the current section changes as a heading slides
 under the chrome rather than as it reaches the top of what can be seen. */
   offset?: (HelixHeadlessOutline["offset"]) | undefined;
 
-  /** The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves. */
-  "onhelix-before-activate"?: ((
-    e: HelixHeadlessOutlineHelixBeforeActivateElementEvent,
+  /** The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take. */
+  "onhelix-activate"?: ((
+    e: HelixHeadlessOutlineHelixActivateElementEvent,
   ) => void) | undefined;
 };
 
@@ -10301,9 +10394,9 @@ The reading line. A page with a sticky masthead sets this to its height, or
 a little more: without it the current section changes as a heading slides
 under the chrome rather than as it reaches the top of what can be seen. */
   "prop:offset"?: (HelixHeadlessOutline["offset"]) | undefined;
-  /** The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves. */
-  "on:helix-before-activate"?: ((
-    e: HelixHeadlessOutlineHelixBeforeActivateElementEvent,
+  /** The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take. */
+  "on:helix-activate"?: ((
+    e: HelixHeadlessOutlineHelixActivateElementEvent,
   ) => void) | undefined;
 
   /** Set the innerHTML of the element */
@@ -20385,6 +20478,15 @@ export type CustomElements = {
    *
    * A comma is therefore not available inside an option's value, which is the
    * listbox's contract and not this element's to change.
+   *
+   * **The list is told, and the field is not.** `aria-multiselectable` belongs
+   * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+   * ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+   * reader on the field hears it through `aria-controls`. This element wrote it
+   * onto its own `role="combobox"` input as well, which an audit reports as a
+   * property the role does not support and no spec here ever asserted: the one
+   * that covers this says in as many words that telling the list is what this
+   * element is responsible for.
    * - `placeholder`: Text shown while nothing has been chosen.
    * - `remove-label`/`removeLabel`: What a tag's remove control is called, since the mark has no name.
    * - `suggest`: Whether the field finishes the word as it is typed.
@@ -21216,6 +21318,7 @@ export type CustomElements = {
    *
    * CSS variables available for styling the component.
    *
+   * - `--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
@@ -21236,7 +21339,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.
@@ -21819,10 +21922,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
@@ -22678,6 +22782,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `drilled`: While a row's page is showing rather than the top one, so a frame around this can answer the depth it is at.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
   "helix-headless-drilldown": Partial<
@@ -23873,6 +23978,9 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `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.
@@ -24034,7 +24142,7 @@ export type CustomElements = {
    * Custom selectors for styling elements within the component.
    *
    * - `cell`: One reading.
-   * - `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.
    * - `footer`: The three-slot row under the strip.
    * - `mark`: The invisible point the tooltip is anchored to.
@@ -25614,8 +25722,16 @@ export type CustomElements = {
    * a band is not a question of paint: a band is not placed against the trigger,
    * so the controller has to be told not to measure, and that decision is here
    * whatever the stylesheet says. Writing the width in both places would be one
-   * number in two languages, drifting the first time either moved. This sets
-   * `data-narrow` on the host and the stylesheet arranges itself off that.
+   * number in two languages, drifting the first time either moved. This records
+   * `:state(narrow)` on the host and the stylesheet arranges itself off that.
+   *
+   * **A custom state and never `data-narrow`, which is what it was.** The width
+   * is read in `connectedCallback`, so on a phone this is true on the very first
+   * update: an attribute written there is markup a consumer's server never sent,
+   * which React reports as a mismatch and answers by rebuilding the subtree. The
+   * narrow exception the server specs describe covers a mirror that can only
+   * become true long after hydration, and a viewport measured before the first
+   * paint is the opposite case. See `MixinControllerOpen` on `open`.
    * - `label`: The section's name, which names the default trigger and the panel.
    * - `open-on`/`openOn`: Whether hovering the trigger opens the panel, or only a press does.
    *
@@ -25715,6 +25831,7 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `narrow`: While the page is under `full-below`, so the panel is a band whether or not one was asked for.
    * - `open`: While the panel is open, which is when the trigger reads as current.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
@@ -26929,6 +27046,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
@@ -27344,7 +27468,7 @@ export type CustomElements = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-activate`: The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves.
+   * - `helix-activate`: The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take.
    *
    * ## Slots
    *
@@ -37839,6 +37963,15 @@ export type CustomElementsSolidJs = {
    *
    * A comma is therefore not available inside an option's value, which is the
    * listbox's contract and not this element's to change.
+   *
+   * **The list is told, and the field is not.** `aria-multiselectable` belongs
+   * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
+   * ARIA 1.2; the list sets it on itself through `ElementInternals`, where a
+   * reader on the field hears it through `aria-controls`. This element wrote it
+   * onto its own `role="combobox"` input as well, which an audit reports as a
+   * property the role does not support and no spec here ever asserted: the one
+   * that covers this says in as many words that telling the list is what this
+   * element is responsible for.
    * - `placeholder`: Text shown while nothing has been chosen.
    * - `remove-label`/`removeLabel`: What a tag's remove control is called, since the mark has no name.
    * - `suggest`: Whether the field finishes the word as it is typed.
@@ -38677,6 +38810,7 @@ export type CustomElementsSolidJs = {
    *
    * CSS variables available for styling the component.
    *
+   * - `--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
@@ -38697,7 +38831,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.
@@ -39287,10 +39421,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
@@ -40159,6 +40294,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `drilled`: While a row's page is showing rather than the top one, so a frame around this can answer the depth it is at.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
   "helix-headless-drilldown": Partial<
@@ -41369,6 +41505,9 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `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.
@@ -41530,7 +41669,7 @@ export type CustomElementsSolidJs = {
    * Custom selectors for styling elements within the component.
    *
    * - `cell`: One reading.
-   * - `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.
    * - `footer`: The three-slot row under the strip.
    * - `mark`: The invisible point the tooltip is anchored to.
@@ -43144,8 +43283,16 @@ export type CustomElementsSolidJs = {
    * a band is not a question of paint: a band is not placed against the trigger,
    * so the controller has to be told not to measure, and that decision is here
    * whatever the stylesheet says. Writing the width in both places would be one
-   * number in two languages, drifting the first time either moved. This sets
-   * `data-narrow` on the host and the stylesheet arranges itself off that.
+   * number in two languages, drifting the first time either moved. This records
+   * `:state(narrow)` on the host and the stylesheet arranges itself off that.
+   *
+   * **A custom state and never `data-narrow`, which is what it was.** The width
+   * is read in `connectedCallback`, so on a phone this is true on the very first
+   * update: an attribute written there is markup a consumer's server never sent,
+   * which React reports as a mismatch and answers by rebuilding the subtree. The
+   * narrow exception the server specs describe covers a mirror that can only
+   * become true long after hydration, and a viewport measured before the first
+   * paint is the opposite case. See `MixinControllerOpen` on `open`.
    * - `label`: The section's name, which names the default trigger and the panel.
    * - `open-on`/`openOn`: Whether hovering the trigger opens the panel, or only a press does.
    *
@@ -43245,6 +43392,7 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `narrow`: While the page is under `full-below`, so the panel is a band whether or not one was asked for.
    * - `open`: While the panel is open, which is when the trigger reads as current.
    * - `settled`: Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.
    */
@@ -44476,6 +44624,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
@@ -44896,7 +45051,7 @@ export type CustomElementsSolidJs = {
    *
    * Events that will be emitted by the component.
    *
-   * - `helix-before-activate`: The section being read has changed, carrying its id as the value. Cancelable: refusing it takes the decision and nothing moves.
+   * - `helix-activate`: The section being read has changed, carrying its id as the value. An announcement: it is read off where the page is scrolled to, so there is no decision here to take.
    *
    * ## Slots
    *
@@ -52117,6 +52272,8 @@ export type CustomCssProperties = {
   "--color-picker-saturation"?: (string) | undefined;
   /** A color to paint: the current one on the sample, a preset's on each preset. */
   "--color-picker-swatch"?: (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;
   /** How many month columns are drawn, capped at two. `--date-picker-columns` overrides it. */