@fusion.dev/helix-headless 0.52.0 → 0.53.0

package/types/jsx.d.ts

@@ -756,7 +756,14 @@ can draw a part as less than nothing, `step` is for a quantity that changes
 at a moment and is ordered the way `straight` is.
 
 Absent rather than defaulted because a reflecting property with a default
-writes its attribute onto every host, including the ones nobody configured. */
+writes its attribute onto every host, including the ones nobody configured.
+The resting value therefore lives in the render, as `curve ?? 'straight'`.
+
+**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A
+line claims a position, so the bounded invention a monotone cubic makes is
+a reading aid and costs nothing. A band claims an amount, and two sums
+smoothed independently can cross, so the same aid here draws a part as less
+than nothing. Same axis, different mark, different resting value. */
   curve?: (HelixHeadlessAreaChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -799,7 +806,14 @@ can draw a part as less than nothing, `step` is for a quantity that changes
 at a moment and is ordered the way `straight` is.
 
 Absent rather than defaulted because a reflecting property with a default
-writes its attribute onto every host, including the ones nobody configured. */
+writes its attribute onto every host, including the ones nobody configured.
+The resting value therefore lives in the render, as `curve ?? 'straight'`.
+
+**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A
+line claims a position, so the bounded invention a monotone cubic makes is
+a reading aid and costs nothing. A band claims an amount, and two sums
+smoothed independently can cross, so the same aid here draws a part as less
+than nothing. Same axis, different mark, different resting value. */
   "prop:curve"?: (HelixHeadlessAreaChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -8494,7 +8508,13 @@ renders, including the ones nobody configured.
 consumer wrote. The default therefore lives where the path is built, as
 `curve ?? 'smooth'`.
 
-`step` claims the opposite of both, that a reading holds until the next. */
+`step` claims the opposite of both, that a reading holds until the next.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   curve?: (HelixHeadlessLineChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -8599,7 +8619,13 @@ renders, including the ones nobody configured.
 consumer wrote. The default therefore lives where the path is built, as
 `curve ?? 'smooth'`.
 
-`step` claims the opposite of both, that a reading holds until the next. */
+`step` claims the opposite of both, that a reading holds until the next.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   "prop:curve"?: (HelixHeadlessLineChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -9979,16 +10005,26 @@ declaration. `:state(read)` is what the stylesheet reads.
   "default-read"?: (HelixHeadlessNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   defaultRead?: (HelixHeadlessNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  dismissible?: (HelixHeadlessNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  dismissLabel?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
   locale?: (HelixHeadlessNotification["locale"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  dismissible?: (HelixHeadlessNotification["dismissible"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  "dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  dismissLabel?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
 
   /** Fired when a reader asks to remove it, and cancelable. */
   "onhelix-dismiss"?: ((
@@ -10024,16 +10060,26 @@ declaration. `:state(read)` is what the stylesheet reads.
   "bool:default-read"?: (HelixHeadlessNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   "prop:defaultRead"?: (HelixHeadlessNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  "prop:dismissible"?: (HelixHeadlessNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "attr:dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "prop:dismissLabel"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
   "prop:locale"?: (HelixHeadlessNotification["locale"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  "prop:dismissible"?: (HelixHeadlessNotification["dismissible"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  "attr:dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  "prop:dismissLabel"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
   /** Fired when a reader asks to remove it, and cancelable. */
   "on:helix-dismiss"?: ((
     e: HelixHeadlessNotificationHelixDismissElementEvent,
@@ -11780,11 +11826,13 @@ and a URL is a better name than "QR code" for a reader who cannot see it. */
   label?: (HelixHeadlessQrCode["label"]) | undefined;
   /** How the modules are drawn.
 
-`square` is the default and the only one that joins runs of adjacent
-modules into a single subpath, which is what keeps a thousand modules to a
-handful of nodes. `rounded` and `dots` draw each module on its own, because
-the corners are the thing being drawn and a joined run has none in the
-middle. That cost is paid only by a code that asks for them.
+`square` is the resting state and is written by not writing it, per the
+rule that a reflected property takes no default. It is also the only one
+that joins runs of adjacent modules into a single subpath, which is what
+keeps a thousand modules to a handful of nodes. `rounded` and `dots` draw
+each module on its own, because the corners are the thing being drawn and a
+joined run has none in the middle. That cost is paid only by a code that
+asks for them.
 
 A scanner reads contrast between cells, not their shape, so all three
 scan. `dots` sits a little under half a module so neighbors do not touch,
@@ -11810,11 +11858,13 @@ and a URL is a better name than "QR code" for a reader who cannot see it. */
   "prop:label"?: (HelixHeadlessQrCode["label"]) | undefined;
   /** How the modules are drawn.
 
-`square` is the default and the only one that joins runs of adjacent
-modules into a single subpath, which is what keeps a thousand modules to a
-handful of nodes. `rounded` and `dots` draw each module on its own, because
-the corners are the thing being drawn and a joined run has none in the
-middle. That cost is paid only by a code that asks for them.
+`square` is the resting state and is written by not writing it, per the
+rule that a reflected property takes no default. It is also the only one
+that joins runs of adjacent modules into a single subpath, which is what
+keeps a thousand modules to a handful of nodes. `rounded` and `dots` draw
+each module on its own, because the corners are the thing being drawn and a
+joined run has none in the middle. That cost is paid only by a code that
+asks for them.
 
 A scanner reads contrast between cells, not their shape, so all three
 scan. `dots` sits a little under half a module so neighbors do not touch,
@@ -12010,13 +12060,15 @@ export type HelixHeadlessRadioHelixSelectElementEvent =
   HelixHeadlessRadioElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessRadioProps = {
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessRadio["disabled"]) | undefined;
-  /** Whether this is the current choice.
+  /** Whether this is the current one.
 
-Written by the group. */
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessRadio["selected"]) | undefined;
-  /** Identifies this choice to the group, and is what the form submits. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -12065,13 +12117,15 @@ same reason. */
 };
 
 export type HelixHeadlessRadioSolidJsProps = {
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixHeadlessRadio["disabled"]) | undefined;
-  /** Whether this is the current choice.
+  /** Whether this is the current one.
 
-Written by the group. */
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   "prop:selected"?: (HelixHeadlessRadio["selected"]) | undefined;
-  /** Identifies this choice to the group, and is what the form submits. */
+  /** Identifies this one to the set, and is what a form submits. */
   "prop:value"?: (HelixHeadlessRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -13066,7 +13120,13 @@ assert against. So the resting state is still the attribute's absence, and
 `curve ?? 'smooth'` is what reads it.
 
 `step` claims the opposite of both, that a reading holds until the next.
-Bars ignore it, having no between to interpolate. */
+Bars ignore it, having no between to interpolate.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   curve?: (HelixHeadlessSparkline["curve"]) | undefined;
   /** The id of a table to read instead, when there is one behind the line.
 
@@ -13141,7 +13201,13 @@ assert against. So the resting state is still the attribute's absence, and
 `curve ?? 'smooth'` is what reads it.
 
 `step` claims the opposite of both, that a reading holds until the next.
-Bars ignore it, having no between to interpolate. */
+Bars ignore it, having no between to interpolate.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   "prop:curve"?: (HelixHeadlessSparkline["curve"]) | undefined;
   /** The id of a table to read instead, when there is one behind the line.
 
@@ -14474,11 +14540,15 @@ export type HelixHeadlessTabHelixSelectElementEvent =
   HelixHeadlessTabElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessTabProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessTab["disabled"]) | undefined;
-  /** Whether this tab is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessTab["selected"]) | undefined;
-  /** Identifies the tab, and pairs it with the panel of the same value. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessTab["value"]) | undefined;
 
   /** Fired when the tab is chosen. Cancelable: refusing it takes the decision and nothing moves. */
@@ -14486,11 +14556,15 @@ export type HelixHeadlessTabProps = {
 };
 
 export type HelixHeadlessTabSolidJsProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixHeadlessTab["disabled"]) | undefined;
-  /** Whether this tab is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   "prop:selected"?: (HelixHeadlessTab["selected"]) | undefined;
-  /** Identifies the tab, and pairs it with the panel of the same value. */
+  /** Identifies this one to the set, and is what a form submits. */
   "prop:value"?: (HelixHeadlessTab["value"]) | undefined;
   /** Fired when the tab is chosen. Cancelable: refusing it takes the decision and nothing moves. */
   "on:helix-select"?: ((e: HelixHeadlessTabHelixSelectElementEvent) => void) | undefined;
@@ -16013,11 +16087,15 @@ export type HelixHeadlessToggleHelixSelectElementEvent =
   HelixHeadlessToggleElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessToggleProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessToggle["disabled"]) | undefined;
-  /** Whether this item is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -16059,11 +16137,15 @@ hydration reports and does not patch up. */
 };
 
 export type HelixHeadlessToggleSolidJsProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixHeadlessToggle["disabled"]) | undefined;
-  /** Whether this item is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   "prop:selected"?: (HelixHeadlessToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   "prop:value"?: (HelixHeadlessToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -18202,6 +18284,13 @@ export type CustomElements = {
    *
    * Absent rather than defaulted because a reflecting property with a default
    * writes its attribute onto every host, including the ones nobody configured.
+   * The resting value therefore lives in the render, as `curve ?? 'straight'`.
+   *
+   * **`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A
+   * line claims a position, so the bounded invention a monotone cubic makes is
+   * a reading aid and costs nothing. A band claims an amount, and two sums
+   * smoothed independently can cross, so the same aid here draws a part as less
+   * than nothing. Same axis, different mark, different resting value.
    * - `gridlines`: Which rules are drawn across the plot, if any.
    *
    * The same three values `LineChart` takes, with the same fallback: a bare
@@ -23472,6 +23561,21 @@ export type CustomElements = {
    * - `showingPage`: Whether this row's own page is the one showing.
    *
    * Written by the stack. (property only)
+   * - `selected`: Whether this is the row the set is on, which in a drill-down is where focus
+   * is.
+   *
+   * A radio group's selection is an answer it holds; a page of rows has no
+   * answer, only the row a reader has walked to, so focus is the whole of what
+   * "the current one" can mean here. This is `Menu.Item`'s reading word for
+   * word, and the two are one pattern: a menu that drills and a drill-down are
+   * the same rows through the same controller.
+   *
+   * Asked of the document rather than of the shadow root. `focusItem` puts
+   * focus on the control inside this row and the platform retargets it, so from
+   * outside the shadow tree `activeElement` is this element already and nothing
+   * has to walk a tree. `ShadowRoot.activeElement` is also the reading that does
+   * not survive happy-dom, which climbs `getRootNode()` to the top and then
+   * dereferences what it ran out of. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -25934,6 +26038,12 @@ export type CustomElements = {
    * `curve ?? 'smooth'`.
    *
    * `step` claims the opposite of both, that a reading holds until the next.
+   *
+   * **`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+   * position and a stacked band claims an amount: a curve fitted through one
+   * sum can pass under the curve fitted through the sum beneath it, so a
+   * smoothed stack can draw a part as less than nothing. There is no such edge
+   * here, which is what lets a line take the reading aid.
    * - `gridlines`: Which rules are drawn across the plot, if any.
    *
    * Absent draws none, which is the honest default rather than a timid one: a
@@ -27449,11 +27559,16 @@ export type CustomElements = {
    * declaration. `:state(read)` is what the stylesheet reads.
    * `hydration.dom.spec.ts` holds it.
    * - `default-read`/`defaultRead`: State to open with, where nothing declared one.
-   * - `dismissible`: Whether a reader may remove it.
-   * - `dismiss-label`/`dismissLabel`: Accessible name for the dismiss control.
    * - `locale`: Locale for the timestamp.
    *
    * Empty is the runtime's own.
+   * - `dismissible`: Whether it offers a control to take it away.
+   * - `dismiss-label`/`dismissLabel`: Accessible name for that control.
+   *
+   * `attribute` is spelled out because Lit lowercases a property name to
+   * derive one rather than dash-casing it, so this would otherwise be
+   * reachable only as `dismisslabel`, which nobody would guess and no linter
+   * would catch.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -27502,6 +27617,7 @@ export type CustomElements = {
    * Public because a consumer's own control is as likely to ask as this
    * element's own markup is, and because a list marking everything read has to
    * go through the same request rather than writing the property behind it.
+   * - `dismiss() => boolean`: Announces that it should go, and reports whether the request stood.
    *
    * ## CSS Parts
    *
@@ -29288,11 +29404,13 @@ export type CustomElements = {
    * and a URL is a better name than "QR code" for a reader who cannot see it.
    * - `shape`: How the modules are drawn.
    *
-   * `square` is the default and the only one that joins runs of adjacent
-   * modules into a single subpath, which is what keeps a thousand modules to a
-   * handful of nodes. `rounded` and `dots` draw each module on its own, because
-   * the corners are the thing being drawn and a joined run has none in the
-   * middle. That cost is paid only by a code that asks for them.
+   * `square` is the resting state and is written by not writing it, per the
+   * rule that a reflected property takes no default. It is also the only one
+   * that joins runs of adjacent modules into a single subpath, which is what
+   * keeps a thousand modules to a handful of nodes. `rounded` and `dots` draw
+   * each module on its own, because the corners are the thing being drawn and a
+   * joined run has none in the middle. That cost is paid only by a code that
+   * asks for them.
    *
    * A scanner reads contrast between cells, not their shape, so all three
    * scan. `dots` sits a little under half a module so neighbors do not touch,
@@ -29606,11 +29724,13 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether this choice can be made.
-   * - `selected`: Whether this is the current choice.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
    *
-   * Written by the group.
-   * - `value`: Identifies this choice to the group, and is what the form submits.
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `defaultSelected`: Whether the markup declared this one chosen, which is what a reset returns to.
    *
    * `<option selected>` reflects to `defaultSelected` and `option.selected` is
@@ -29688,8 +29808,12 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this choice, for the group's arrow keys.
-   * - `select() => void`: Makes this choice and announces it.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
+   *
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *
@@ -30866,6 +30990,12 @@ export type CustomElements = {
    *
    * `step` claims the opposite of both, that a reading holds until the next.
    * Bars ignore it, having no between to interpolate.
+   *
+   * **`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+   * position and a stacked band claims an amount: a curve fitted through one
+   * sum can pass under the curve fitted through the sum beneath it, so a
+   * smoothed stack can draw a part as less than nothing. There is no such edge
+   * here, which is what lets a line take the reading aid.
    * - `for`: The id of a table to read instead, when there is one behind the line.
    *
    * The first column of numbers is the series drawn. This wins over `values`,
@@ -32467,9 +32597,13 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether the tab can be chosen.
-   * - `selected`: Whether this tab is the current one.
-   * - `value`: Identifies the tab, and pairs it with the panel of the same value.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
+   *
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -32507,8 +32641,12 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this tab, for the list's arrow keys.
-   * - `select() => void`: Selects this tab and announces it.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
+   *
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *
@@ -33978,9 +34116,13 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether the item can be chosen.
-   * - `selected`: Whether this item is the current one.
-   * - `value`: Identifies the item to the group.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
+   *
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `defaultSelected`: Whether the markup declared this one chosen, which is what a reset returns to.
    *
    * `<option selected>` reflects to `defaultSelected` and `option.selected` is
@@ -34050,12 +34192,12 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this item's own control.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
    *
-   * The group drives arrow-key navigation and cannot reach the control itself,
-   * which is inside this shadow root. Exposing the intent as a method keeps the
-   * group out of the child's internals.
-   * - `select() => void`: Chooses this item and announces it.
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *
@@ -36093,6 +36235,13 @@ export type CustomElementsSolidJs = {
    *
    * Absent rather than defaulted because a reflecting property with a default
    * writes its attribute onto every host, including the ones nobody configured.
+   * The resting value therefore lives in the render, as `curve ?? 'straight'`.
+   *
+   * **`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A
+   * line claims a position, so the bounded invention a monotone cubic makes is
+   * a reading aid and costs nothing. A band claims an amount, and two sums
+   * smoothed independently can cross, so the same aid here draws a part as less
+   * than nothing. Same axis, different mark, different resting value.
    * - `gridlines`: Which rules are drawn across the plot, if any.
    *
    * The same three values `LineChart` takes, with the same fallback: a bare
@@ -41435,6 +41584,21 @@ export type CustomElementsSolidJs = {
    * - `showingPage`: Whether this row's own page is the one showing.
    *
    * Written by the stack. (property only)
+   * - `selected`: Whether this is the row the set is on, which in a drill-down is where focus
+   * is.
+   *
+   * A radio group's selection is an answer it holds; a page of rows has no
+   * answer, only the row a reader has walked to, so focus is the whole of what
+   * "the current one" can mean here. This is `Menu.Item`'s reading word for
+   * word, and the two are one pattern: a menu that drills and a drill-down are
+   * the same rows through the same controller.
+   *
+   * Asked of the document rather than of the shadow root. `focusItem` puts
+   * focus on the control inside this row and the platform retargets it, so from
+   * outside the shadow tree `activeElement` is this element already and nothing
+   * has to walk a tree. `ShadowRoot.activeElement` is also the reading that does
+   * not survive happy-dom, which climbs `getRootNode()` to the top and then
+   * dereferences what it ran out of. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -43932,6 +44096,12 @@ export type CustomElementsSolidJs = {
    * `curve ?? 'smooth'`.
    *
    * `step` claims the opposite of both, that a reading holds until the next.
+   *
+   * **`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+   * position and a stacked band claims an amount: a curve fitted through one
+   * sum can pass under the curve fitted through the sum beneath it, so a
+   * smoothed stack can draw a part as less than nothing. There is no such edge
+   * here, which is what lets a line take the reading aid.
    * - `gridlines`: Which rules are drawn across the plot, if any.
    *
    * Absent draws none, which is the honest default rather than a timid one: a
@@ -45476,11 +45646,16 @@ export type CustomElementsSolidJs = {
    * declaration. `:state(read)` is what the stylesheet reads.
    * `hydration.dom.spec.ts` holds it.
    * - `default-read`/`defaultRead`: State to open with, where nothing declared one.
-   * - `dismissible`: Whether a reader may remove it.
-   * - `dismiss-label`/`dismissLabel`: Accessible name for the dismiss control.
    * - `locale`: Locale for the timestamp.
    *
    * Empty is the runtime's own.
+   * - `dismissible`: Whether it offers a control to take it away.
+   * - `dismiss-label`/`dismissLabel`: Accessible name for that control.
+   *
+   * `attribute` is spelled out because Lit lowercases a property name to
+   * derive one rather than dash-casing it, so this would otherwise be
+   * reachable only as `dismisslabel`, which nobody would guess and no linter
+   * would catch.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -45529,6 +45704,7 @@ export type CustomElementsSolidJs = {
    * Public because a consumer's own control is as likely to ask as this
    * element's own markup is, and because a list marking everything read has to
    * go through the same request rather than writing the property behind it.
+   * - `dismiss() => boolean`: Announces that it should go, and reports whether the request stood.
    *
    * ## CSS Parts
    *
@@ -47338,11 +47514,13 @@ export type CustomElementsSolidJs = {
    * and a URL is a better name than "QR code" for a reader who cannot see it.
    * - `shape`: How the modules are drawn.
    *
-   * `square` is the default and the only one that joins runs of adjacent
-   * modules into a single subpath, which is what keeps a thousand modules to a
-   * handful of nodes. `rounded` and `dots` draw each module on its own, because
-   * the corners are the thing being drawn and a joined run has none in the
-   * middle. That cost is paid only by a code that asks for them.
+   * `square` is the resting state and is written by not writing it, per the
+   * rule that a reflected property takes no default. It is also the only one
+   * that joins runs of adjacent modules into a single subpath, which is what
+   * keeps a thousand modules to a handful of nodes. `rounded` and `dots` draw
+   * each module on its own, because the corners are the thing being drawn and a
+   * joined run has none in the middle. That cost is paid only by a code that
+   * asks for them.
    *
    * A scanner reads contrast between cells, not their shape, so all three
    * scan. `dots` sits a little under half a module so neighbors do not touch,
@@ -47663,11 +47841,13 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether this choice can be made.
-   * - `selected`: Whether this is the current choice.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
    *
-   * Written by the group.
-   * - `value`: Identifies this choice to the group, and is what the form submits.
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `defaultSelected`: Whether the markup declared this one chosen, which is what a reset returns to.
    *
    * `<option selected>` reflects to `defaultSelected` and `option.selected` is
@@ -47745,8 +47925,12 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this choice, for the group's arrow keys.
-   * - `select() => void`: Makes this choice and announces it.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
+   *
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *
@@ -48943,6 +49127,12 @@ export type CustomElementsSolidJs = {
    *
    * `step` claims the opposite of both, that a reading holds until the next.
    * Bars ignore it, having no between to interpolate.
+   *
+   * **`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+   * position and a stacked band claims an amount: a curve fitted through one
+   * sum can pass under the curve fitted through the sum beneath it, so a
+   * smoothed stack can draw a part as less than nothing. There is no such edge
+   * here, which is what lets a line take the reading aid.
    * - `for`: The id of a table to read instead, when there is one behind the line.
    *
    * The first column of numbers is the series drawn. This wins over `values`,
@@ -50585,9 +50775,13 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether the tab can be chosen.
-   * - `selected`: Whether this tab is the current one.
-   * - `value`: Identifies the tab, and pairs it with the panel of the same value.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
+   *
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -50625,8 +50819,12 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this tab, for the list's arrow keys.
-   * - `select() => void`: Selects this tab and announces it.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
+   *
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *
@@ -52120,9 +52318,13 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `disabled`: Whether the item can be chosen.
-   * - `selected`: Whether this item is the current one.
-   * - `value`: Identifies the item to the group.
+   * - `disabled`: Whether this one can be chosen.
+   * - `selected`: Whether this is the current one.
+   *
+   * Written by the set rather than by a consumer, which is why it takes no
+   * default from an attribute here: a family whose selection a consumer
+   * declares in markup carries `defaultSelected` of its own to say so.
+   * - `value`: Identifies this one to the set, and is what a form submits.
    * - `defaultSelected`: Whether the markup declared this one chosen, which is what a reset returns to.
    *
    * `<option selected>` reflects to `defaultSelected` and `option.selected` is
@@ -52192,12 +52394,12 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `focusItem() => void`: Moves focus to this item's own control.
+   * - `focusItem() => void`: Moves focus to the control this renders, for the set's arrow keys.
    *
-   * The group drives arrow-key navigation and cannot reach the control itself,
-   * which is inside this shadow root. Exposing the intent as a method keeps the
-   * group out of the child's internals.
-   * - `select() => void`: Chooses this item and announces it.
+   * The set drives the keys and cannot reach the control itself, which is
+   * inside this shadow root, so the intent is a method and the internals stay
+   * the item's.
+   * - `select() => boolean`: Chooses this one and announces it, and reports whether it stood.
    *
    * ## CSS Parts
    *