@fusion.dev/helix 0.52.1 → 0.53.0

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

@@ -11785,6 +11785,22 @@ separated.** A consumer wanting the whole feed carded says so once, in a
 document rule on the element, rather than on every item: this is a styled
 axis and a stylesheet is where it is set. */
   separation?: (HelixNotification["separation"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  dismissible?: (HelixNotification["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"?: (HelixNotification["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?: (HelixNotification["dismissLabel"]) | undefined;
   /** When it happened, as anything `Date` parses.
 
 An ISO string is what an API sends and what `<time datetime>` takes, so it
@@ -11810,12 +11826,6 @@ declaration. `:state(read)` is what the stylesheet reads.
   "default-read"?: (HelixNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   defaultRead?: (HelixNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  dismissible?: (HelixNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "dismiss-label"?: (HelixNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  dismissLabel?: (HelixNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
@@ -11846,6 +11856,22 @@ separated.** A consumer wanting the whole feed carded says so once, in a
 document rule on the element, rather than on every item: this is a styled
 axis and a stylesheet is where it is set. */
   "prop:separation"?: (HelixNotification["separation"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  "prop:dismissible"?: (HelixNotification["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"?: (HelixNotification["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"?: (HelixNotification["dismissLabel"]) | undefined;
   /** When it happened, as anything `Date` parses.
 
 An ISO string is what an API sends and what `<time datetime>` takes, so it
@@ -11871,12 +11897,6 @@ declaration. `:state(read)` is what the stylesheet reads.
   "bool:default-read"?: (HelixNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   "prop:defaultRead"?: (HelixNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  "prop:dismissible"?: (HelixNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "attr:dismiss-label"?: (HelixNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "prop:dismissLabel"?: (HelixNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
@@ -13979,13 +13999,15 @@ The circle stays in both. A card whose only marker was its own border would
 ask a reader to compare surfaces across a row to find the answer, and would
 leave nothing for a high-contrast display. */
   variant?: (HelixRadio["variant"]) | undefined;
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixRadio["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?: (HelixRadio["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?: (HelixRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -14084,13 +14106,15 @@ The circle stays in both. A card whose only marker was its own border would
 ask a reader to compare surfaces across a row to find the answer, and would
 leave nothing for a high-contrast display. */
   "prop:variant"?: (HelixRadio["variant"]) | undefined;
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixRadio["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"?: (HelixRadio["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"?: (HelixRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -17264,11 +17288,15 @@ export type HelixTabHelixSelectElementEvent =
   HelixTabElementEvent<HelixSelectEvent>;
 
 export type HelixTabProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixTab["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?: (HelixTab["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?: (HelixTab["value"]) | undefined;
 
   /** Fired when the tab is chosen. Cancelable: refusing it takes the decision and nothing moves. */
@@ -17276,11 +17304,15 @@ export type HelixTabProps = {
 };
 
 export type HelixTabSolidJsProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixTab["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"?: (HelixTab["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"?: (HelixTab["value"]) | undefined;
   /** Fired when the tab is chosen. Cancelable: refusing it takes the decision and nothing moves. */
   "on:helix-select"?: ((e: HelixTabHelixSelectElementEvent) => void) | undefined;
@@ -18936,11 +18968,15 @@ export type HelixToggleHelixSelectElementEvent =
   HelixToggleElementEvent<HelixSelectEvent>;
 
 export type HelixToggleProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixToggle["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?: (HelixToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -18982,11 +19018,15 @@ hydration reports and does not patch up. */
 };
 
 export type HelixToggleSolidJsProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   "prop:disabled"?: (HelixToggle["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"?: (HelixToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   "prop:value"?: (HelixToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -27162,6 +27202,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
@@ -31271,6 +31326,13 @@ export type CustomElements = {
    * separated.** A consumer wanting the whole feed carded says so once, in a
    * document rule on the element, rather than on every item: this is a styled
    * axis and a stylesheet is where it is set.
+   * - `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.
    * - `at`: When it happened, as anything `Date` parses.
    *
    * An ISO string is what an API sends and what `<time datetime>` takes, so it
@@ -31291,8 +31353,6 @@ 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.
@@ -31339,6 +31399,7 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
+   * - `dismiss() => boolean`: Announces that it should go, and reports whether the request stood.
    * - `markRead(next = true) => boolean`: Asks to be marked read, and reports whether the request stood.
    *
    * Public because a consumer's own control is as likely to ask as this
@@ -33534,11 +33595,13 @@ export type CustomElements = {
    * The circle stays in both. A card whose only marker was its own border would
    * ask a reader to compare surfaces across a row to find the answer, and would
    * leave nothing for a high-contrast display.
-   * - `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
@@ -33616,8 +33679,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 Custom Properties
    *
@@ -37017,9 +37084,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
@@ -37057,8 +37128,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
    *
@@ -38624,9 +38699,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
@@ -38696,12 +38775,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
    *
@@ -46734,6 +46813,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
@@ -50935,6 +51029,13 @@ export type CustomElementsSolidJs = {
    * separated.** A consumer wanting the whole feed carded says so once, in a
    * document rule on the element, rather than on every item: this is a styled
    * axis and a stylesheet is where it is set.
+   * - `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.
    * - `at`: When it happened, as anything `Date` parses.
    *
    * An ISO string is what an API sends and what `<time datetime>` takes, so it
@@ -50955,8 +51056,6 @@ 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.
@@ -51003,6 +51102,7 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
+   * - `dismiss() => boolean`: Announces that it should go, and reports whether the request stood.
    * - `markRead(next = true) => boolean`: Asks to be marked read, and reports whether the request stood.
    *
    * Public because a consumer's own control is as likely to ask as this
@@ -53250,11 +53350,13 @@ export type CustomElementsSolidJs = {
    * The circle stays in both. A card whose only marker was its own border would
    * ask a reader to compare surfaces across a row to find the answer, and would
    * leave nothing for a high-contrast display.
-   * - `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
@@ -53332,8 +53434,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 Custom Properties
    *
@@ -56823,9 +56929,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
@@ -56863,8 +56973,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
    *
@@ -58462,9 +58576,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
@@ -58534,12 +58652,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
    *

package/types/vue.d.ts

@@ -6035,6 +6035,22 @@ separated.** A consumer wanting the whole feed carded says so once, in a
 document rule on the element, rather than on every item: this is a styled
 axis and a stylesheet is where it is set. */
   separation?: (HelixNotification["separation"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  dismissible?: (HelixNotification["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"?: (HelixNotification["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?: (HelixNotification["dismissLabel"]) | undefined;
   /** When it happened, as anything `Date` parses.
 
 An ISO string is what an API sends and what `<time datetime>` takes, so it
@@ -6060,12 +6076,6 @@ declaration. `:state(read)` is what the stylesheet reads.
   "default-read"?: (HelixNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   defaultRead?: (HelixNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  dismissible?: (HelixNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "dismiss-label"?: (HelixNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  dismissLabel?: (HelixNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
@@ -7183,13 +7193,15 @@ The circle stays in both. A card whose only marker was its own border would
 ask a reader to compare surfaces across a row to find the answer, and would
 leave nothing for a high-contrast display. */
   variant?: (HelixRadio["variant"]) | undefined;
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixRadio["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?: (HelixRadio["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?: (HelixRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -8841,11 +8853,15 @@ export type HelixTabHelixSelectElementEvent =
   HelixTabElementEvent<HelixSelectEvent>;
 
 export type HelixTabVueProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixTab["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?: (HelixTab["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?: (HelixTab["value"]) | undefined;
 };
 
@@ -9698,11 +9714,15 @@ export type HelixToggleHelixSelectElementEvent =
   HelixToggleElementEvent<HelixSelectEvent>;
 
 export type HelixToggleVueProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixToggle["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?: (HelixToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.