@fusion.dev/helix-headless 0.52.1 → 0.53.0

package/custom-elements.json

@@ -13594,6 +13594,20 @@
               },
               "description": "Refuses an empty set where one was required.\n\n**The group is form-associated, and submits nothing.** Nothing here calls\n`setFormValue`, so the set that reaches the server is exactly the boxes,\neach of which submits itself. What form association buys is the other half\nof participation, validity, and there is no other mechanism for it:\n`setValidity` throws `NotSupportedError` on an element the platform does not\nknow is a control. happy-dom's shim does not throw, so a spec passes against\ncode that fails on every update in Chromium.\n\nIt is also what makes the rest work: the form refuses to submit, which fires\n`invalid`, which is what marks the field touched and puts the message on\nscreen.\n\nAnchored on the list, because the browser needs somewhere to point the\nbubble."
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -14765,6 +14779,20 @@
                 "text": "resetChecked() => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -17812,6 +17840,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -21418,6 +21460,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -25667,38 +25723,6 @@
               },
               "description": "Says on the toolbar and the footer whether anything is in them.\n\n**A stylesheet cannot ask.** `[part=\"toolbar\"]:has(> slot:not(:has(*)))` is\ntwo faults at once: `:has()` may not be nested inside `:has()`, so the\nselector fails to parse and the whole rule is discarded; and\n`slot:not(:has(*))` is as true of a filled slot as of an empty one, because\nassigned nodes are not a slot's DOM children. Both verified in a browser."
             },
-            {
-              "kind": "method",
-              "name": "markRegion",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "part",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "slots",
-                  "type": {
-                    "text": "readonly string[]"
-                  }
-                },
-                {
-                  "name": "occupied",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "One region, hidden when its slot holds nothing and nothing of ours fills it.\n\n`hidden` beside the `data-empty` mirror: `data-empty` is the hook the styled\nsheet reads, and this tier ships no sheet, so an empty region left in the box\ntree would be a gap a headless consumer cannot close without knowing to look\nfor it. The styled rule stays too, because that sheet sets `display` on these\nparts and therefore outranks the UA's `[hidden]` one."
-            },
             {
               "kind": "method",
               "name": "announceSort",
@@ -28238,6 +28262,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -34812,6 +34850,15 @@
                 "text": "focusItem() => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether this is the row the set is on, which in a drill-down is where focus\nis.\n\nA radio group's selection is an answer it holds; a page of rows has no\nanswer, only the row a reader has walked to, so focus is the whole of what\n\"the current one\" can mean here. This is `Menu.Item`'s reading word for\nword, and the two are one pattern: a menu that drills and a drill-down are\nthe same rows through the same controller.\n\nAsked of the document rather than of the shadow root. `focusItem` puts\nfocus on the control inside this row and the platform retargets it, so from\noutside the shadow tree `activeElement` is this element already and nothing\nhas to walk a tree. `ShadowRoot.activeElement` is also the reading that does\nnot survive happy-dom, which climbs `getRootNode()` to the top and then\ndereferences what it ran out of.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "select",
@@ -35323,6 +35370,14 @@
               "description": "The rows on the page showing, which is what the keys move over.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "keys",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new KeyboardNavigationController(this, { items: () => this.items, reserved: () => ['ArrowLeft', 'ArrowRight'], selects: () => false, })",
+              "description": "Moving between rows, which is `Menu`'s arrangement and not a second one.\n\nThe horizontal pair is reserved rather than released: in a drill-down they\nare the platform's own bindings for drilling, along the line to go in and\nback along it to come out, so they are spoken for here rather than\nunhandled. `handleKeydown` below owes them a binding, which is what\nreserving one means, and it has them.\n\n`selects` false, because arriving at a row must not follow it. Moving and\nchoosing are one act in a radio group and two here, which is the same\nreading `Menu` takes over the same rows.\n\nThe origin is the selection, which for these rows is where focus is. `focus`\nis the wrong reading however right it looks: it also carries a rule that a\npress which did not come from the set moves nothing, and Down on a page a\nreader has just tabbed to is how they get onto the first row at all."
+            },
             {
               "kind": "method",
               "name": "placeTabStop",
@@ -36885,6 +36940,20 @@
               ],
               "description": "What is known about a chosen file, as tags, behind a seam the styled tier\ncan move.\n\nOne method for both the size and the kind, because they are the same\nelement saying two things and two methods would be two places to keep in\nstep. Both parts are written out rather than passed in, and that is not\nstyle: a part name behind an interpolation is a part the manifest cannot\nsee, so a stylesheet targeting it matches nothing.\n\nA method rather than a fragment inline, so a tier above can render its own,\nwrap this one, or leave it out without reimplementing the whole template.\nThe tag is interpolated rather than written, so `tier` resolves it: this\nrenders the headless element, and a styled subclass that sets `tier`\nrenders the styled one from the same template."
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -41030,6 +41099,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -42929,7 +43012,7 @@
               }
             }
           ],
-          "description": "A comma or space separated list of numbers, in the order written."
+          "description": "A consumer's list of numbers, in the order written, with the rest dropped."
         },
         {
           "kind": "function",
@@ -42947,7 +43030,7 @@
               }
             }
           ],
-          "description": "A comma or space separated list of names, in the order written."
+          "description": "A consumer's list of names, in the order written."
         },
         {
           "kind": "function",
@@ -43429,38 +43512,6 @@
               },
               "description": "Says on the footer whether any of its three slots holds anything.\n\n**A stylesheet cannot ask.** `[part=\"footer\"]:not(:has(slot:has(*)))` is two\nfaults at once: `:has()` may not be nested inside `:has()`, so the selector\nfails to parse and the rule is discarded whole; and a slot's assigned nodes\nare not its DOM children, so `slot:has(*)` reports fallback content rather\nthan the fill, and is false either way. Both verified in a browser."
             },
-            {
-              "kind": "method",
-              "name": "markRegion",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "part",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "slots",
-                  "type": {
-                    "text": "readonly string[]"
-                  }
-                },
-                {
-                  "name": "occupied",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "One region, hidden when its slot holds nothing and nothing of ours fills it.\n\n`hidden` beside the `data-empty` mirror: `data-empty` is the hook the styled\nsheet reads, and this tier ships no sheet, so an empty region left in the box\ntree would be a gap a headless consumer cannot close without knowing to look\nfor it. The styled rule stays too, because that sheet sets `display` on these\nparts and therefore outranks the UA's `[hidden]` one."
-            },
             {
               "kind": "method",
               "name": "renderTooltip",
@@ -47660,6 +47711,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -52471,6 +52536,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -58770,26 +58849,6 @@
               "description": "State to open with, where nothing declared one.",
               "attribute": "default-read"
             },
-            {
-              "kind": "field",
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether a reader may remove it.",
-              "attribute": "dismissible"
-            },
-            {
-              "kind": "field",
-              "name": "dismissLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "Accessible name for the dismiss control.",
-              "attribute": "dismiss-label"
-            },
             {
               "kind": "field",
               "name": "locale",
@@ -58884,6 +58943,67 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "dismissible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether it offers a control to take it away.",
+              "attribute": "dismissible",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dismissLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dismiss'",
+              "description": "Accessible name for that control.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.",
+              "attribute": "dismiss-label",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dismissEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "HelixDismissEvent"
+                }
+              },
+              "description": "The event, built and not dispatched.\n\nReading text is safe here: nothing calls this on a server, because the\nonly things that do are a press and a timer.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dismiss",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Announces that it should go, and reports whether the request stood.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              },
+              "type": {
+                "text": "dismiss() => boolean"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -59254,14 +59374,27 @@
               "description": "State to open with, where nothing declared one.",
               "fieldName": "defaultRead"
             },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Locale for the timestamp.\n\nEmpty is the runtime's own.",
+              "fieldName": "locale"
+            },
             {
               "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether a reader may remove it.",
-              "fieldName": "dismissible"
+              "description": "Whether it offers a control to take it away.",
+              "fieldName": "dismissible",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
             },
             {
               "name": "dismiss-label",
@@ -59269,17 +59402,12 @@
                 "text": "string"
               },
               "default": "'Dismiss'",
-              "description": "Accessible name for the dismiss control.",
-              "fieldName": "dismissLabel"
-            },
-            {
-              "name": "locale",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Locale for the timestamp.\n\nEmpty is the runtime's own.",
-              "fieldName": "locale"
+              "description": "Accessible name for that control.\n\n`attribute` is spelled out because Lit lowercases a property name to\nderive one rather than dash-casing it, so this would otherwise be\nreachable only as `dismisslabel`, which nobody would guess and no linter\nwould catch.",
+              "fieldName": "dismissLabel",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
             }
           ],
           "cssStates": [
@@ -59304,6 +59432,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinDismissible",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -59550,38 +59684,6 @@
               },
               "description": "Says on each region whether anything is in it.\n\n**A stylesheet cannot ask this, and the obvious selector fails twice over.**\n`[part=\"header\"]:not(:has(> slot:has(*)))`: `:has()` may not be nested\ninside `:has()`, so the selector fails to parse and the whole rule is\ndiscarded; and a slot's assigned nodes are not its DOM children, so\n`slot:has(*)` reports whether the slot has *fallback* rather than whether a\nconsumer filled it, and would have been false either way. Both verified in a\nbrowser: `insertRule` throws a `SyntaxError` on the first, and an assigned\nelement still leaves `slot.matches(':has(*)')` false.\n\n`slotFilled` is what the rest of the library already asks with. It is said\non the region inside this shadow root rather than on the host, because an\nattribute written onto the host is a change to markup the consumer rendered,\nwhich React reports on hydration and does not patch up."
             },
-            {
-              "kind": "method",
-              "name": "markRegion",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "part",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "slots",
-                  "type": {
-                    "text": "readonly string[]"
-                  }
-                },
-                {
-                  "name": "occupied",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "One region, hidden when its slot holds nothing and nothing of ours fills it.\n\n`hidden` beside the `data-empty` mirror: `data-empty` is the hook the styled\nsheet reads, and this tier ships no sheet, so an empty region left in the box\ntree would be a gap a headless consumer cannot close without knowing to look\nfor it. The styled rule stays too, because that sheet sets `display` on these\nparts and therefore outranks the UA's `[hidden]` one."
-            },
             {
               "kind": "field",
               "name": "handleMarkAll",
@@ -60810,6 +60912,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -67240,6 +67356,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -70767,6 +70897,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -71747,31 +71891,35 @@
           "members": [
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "defaultSelected",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether this choice can be made.",
-              "attribute": "disabled",
-              "reflects": true
+              "description": "Whether the markup declared this one chosen, which is what a reset returns to.\n\n`<option selected>` reflects to `defaultSelected` and `option.selected` is\nlive state that does not reflect, and those are two different facts. This\nelement has one `selected` doing both jobs, so the declaration is the\nattribute and the state is the property.\n\n**The attribute, read when it is asked for, and never a snapshot taken in\nthe constructor.** A field initializer runs there, and an element the HTML\nparser created has none of its attributes yet at that moment: measured on\nthis element, on `Option` and on `Toggle`, `<helix-radio value=\"a\"\nselected>` reported `defaultSelected` as `false` both from parsed markup\nand from `createElement` followed by `setAttribute`, which is every way a\nconsumer writes one. The snapshot could only ever be true for an element\nalready in the document when `customElements.define` ran.\n\nNothing overwrites it either, which is what makes reading it late correct\nrather than merely later: `selected` does not reflect, for the reason\n`willUpdate` records, so the group's writes never reach the attribute and\nwhat it says is what the markup said.\n\n**The deeper half is not this.** State reflecting under the declaration's\nname is the fault `TreeItem` avoids by mirroring to `data-selected`.\nSplitting them means moving what every stylesheet selects on, which is a\nchange of its own rather than a property being added."
             },
             {
               "kind": "field",
-              "name": "defaultSelected",
+              "name": "focusable",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the markup declared this one chosen, which is what a reset returns to.\n\n`<option selected>` reflects to `defaultSelected` and `option.selected` is\nlive state that does not reflect, and those are two different facts. This\nelement has one `selected` doing both jobs, so the declaration is the\nattribute and the state is the property.\n\n**The attribute, read when it is asked for, and never a snapshot taken in\nthe constructor.** A field initializer runs there, and an element the HTML\nparser created has none of its attributes yet at that moment: measured on\nthis element, on `Option` and on `Toggle`, `<helix-radio value=\"a\"\nselected>` reported `defaultSelected` as `false` both from parsed markup\nand from `createElement` followed by `setAttribute`, which is every way a\nconsumer writes one. The snapshot could only ever be true for an element\nalready in the document when `customElements.define` ran.\n\nNothing overwrites it either, which is what makes reading it late correct\nrather than merely later: `selected` does not reflect, for the reason\n`willUpdate` records, so the group's writes never reach the attribute and\nwhat it says is what the markup said.\n\n**The deeper half is not this.** State reflecting under the declaration's\nname is the fault `TreeItem` avoids by mirroring to `data-selected`.\nSplitting them means moving what every stylesheet selects on, which is a\nchange of its own rather than a property being added."
+              "default": "false",
+              "description": "Whether this choice holds the group's tab stop while nothing is chosen.\n\nThe stop rides on the selection, and an unanswered group has no selection,\nso without this every choice is `tabindex=\"-1\"` and the keyboard cannot\nenter the set at all.\n\n**Written by the group, with no attribute, and it reaches the control\nrather than the host.** A `tabindex` on the host is two faults at once: it\nis markup a consumer rendered and their server never sent, which React\nreports as a mismatch and does not patch up, and it puts the tab stop on\nthe element rather than on the `<button role=\"radio\">` inside it, so a\nscreen reader meets an unnamed box where a native group would have given\nthem an unchecked radio. `Toggle.Root` carries the same property for the\nsame reason."
             },
             {
               "kind": "field",
-              "name": "focusable",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this choice holds the group's tab stop while nothing is chosen.\n\nThe stop rides on the selection, and an unanswered group has no selection,\nso without this every choice is `tabindex=\"-1\"` and the keyboard cannot\nenter the set at all.\n\n**Written by the group, with no attribute, and it reaches the control\nrather than the host.** A `tabindex` on the host is two faults at once: it\nis markup a consumer rendered and their server never sent, which React\nreports as a mismatch and does not patch up, and it puts the tab stop on\nthe element rather than on the `<button role=\"radio\">` inside it, so a\nscreen reader meets an unnamed box where a native group would have given\nthem an unchecked radio. `Toggle.Root` carries the same property for the\nsame reason."
+              "description": "Whether this one can be chosen.",
+              "attribute": "disabled",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "field",
@@ -71780,8 +71928,12 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this is the current choice.\n\nWritten by the group.",
-              "attribute": "selected"
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "attribute": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "field",
@@ -71790,8 +71942,26 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies this choice to the group, and is what the form submits.",
-              "attribute": "value"
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "attribute": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "itemPart",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'item'",
+              "description": "The part `focusItem` focuses. See the interface note.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "method",
@@ -71801,7 +71971,11 @@
                   "text": "void"
                 }
               },
-              "description": "Moves focus to this choice, for the group's arrow keys.",
+              "description": "Moves focus to the control this renders, for the set's arrow keys.\n\nThe set drives the keys and cannot reach the control itself, which is\ninside this shadow root, so the intent is a method and the internals stay\nthe item's.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
                 "text": "focusItem() => void"
               }
@@ -71811,12 +71985,16 @@
               "name": "select",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Makes this choice and announces it.",
+              "description": "Chooses this one and announces it, and reports whether it stood.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
-                "text": "select() => void"
+                "text": "select() => boolean"
               }
             },
             {
@@ -72154,35 +72332,6 @@
               "reactProp": "onhelix-select"
             }
           ],
-          "attributes": [
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether this choice can be made.",
-              "fieldName": "disabled"
-            },
-            {
-              "name": "selected",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether this is the current choice.\n\nWritten by the group.",
-              "fieldName": "selected"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Identifies this choice to the group, and is what the form submits.",
-              "fieldName": "value"
-            }
-          ],
           "cssStates": [
             {
               "description": "While it is the one chosen.",
@@ -72197,6 +72346,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -72225,6 +72380,47 @@
           },
           "tagName": "helix-headless-radio",
           "customElement": true,
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this one can be chosen.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "fieldName": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "fieldName": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            }
+          ],
           "modulePath": "src/radio/root/radio-root.ts",
           "definitionPath": "src/radio/root/radio-root.ts"
         }
@@ -72758,6 +72954,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -75703,6 +75913,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -78076,6 +78300,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -84433,6 +84671,20 @@
                 "text": "resetChecked() => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -88973,6 +89225,20 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "itemPart",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'tab'",
+              "description": "The part `focusItem` focuses. See the interface note.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -88980,9 +89246,13 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the tab can be chosen.",
+              "description": "Whether this one can be chosen.",
               "attribute": "disabled",
-              "reflects": true
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "field",
@@ -88991,8 +89261,12 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this tab is the current one.",
-              "attribute": "selected"
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "attribute": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "field",
@@ -89001,8 +89275,12 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies the tab, and pairs it with the panel of the same value.",
-              "attribute": "value"
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "attribute": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "method",
@@ -89012,7 +89290,11 @@
                   "text": "void"
                 }
               },
-              "description": "Moves focus to this tab, for the list's arrow keys.",
+              "description": "Moves focus to the control this renders, for the set's arrow keys.\n\nThe set drives the keys and cannot reach the control itself, which is\ninside this shadow root, so the intent is a method and the internals stay\nthe item's.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
                 "text": "focusItem() => void"
               }
@@ -89022,12 +89304,16 @@
               "name": "select",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Selects this tab and announces it.",
+              "description": "Chooses this one and announces it, and reports whether it stood.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
-                "text": "select() => void"
+                "text": "select() => boolean"
               }
             },
             {
@@ -89365,35 +89651,6 @@
               "reactProp": "onhelix-select"
             }
           ],
-          "attributes": [
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the tab can be chosen.",
-              "fieldName": "disabled"
-            },
-            {
-              "name": "selected",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether this tab is the current one.",
-              "fieldName": "selected"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Identifies the tab, and pairs it with the panel of the same value.",
-              "fieldName": "value"
-            }
-          ],
           "cssStates": [
             {
               "description": "While it is the tab selected.",
@@ -89408,6 +89665,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -89426,6 +89689,47 @@
           },
           "tagName": "helix-headless-tab",
           "customElement": true,
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this one can be chosen.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "fieldName": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "fieldName": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            }
+          ],
           "modulePath": "src/tabs/tab/tab.ts",
           "definitionPath": "src/tabs/tab/tab.ts"
         }
@@ -90471,6 +90775,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -92643,6 +92961,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -97714,6 +98046,20 @@
                 "text": "formStateRestoreCallback(state: string | null) => void"
               }
             },
+            {
+              "kind": "field",
+              "name": "controlId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'control'",
+              "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself.",
+              "inheritedFrom": {
+                "name": "MixinField",
+                "module": "src/mixins/mixin-field/mixin-field.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -98680,31 +99026,35 @@
           "members": [
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "defaultSelected",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether the item can be chosen.",
-              "attribute": "disabled",
-              "reflects": true
+              "description": "Whether the markup declared this one chosen, which is what a reset returns to.\n\n`<option selected>` reflects to `defaultSelected` and `option.selected` is\nlive state that does not reflect, and those are two different facts. This\nelement has one `selected` doing both jobs, so the declaration is the\nattribute and the state is the property.\n\n**The attribute, read when it is asked for, and never a snapshot taken in\nthe constructor.** A field initializer runs there, and an element the HTML\nparser created has none of its attributes yet at that moment: measured on\nthis element, on `Option` and on `Radio`, `<helix-toggle value=\"light\"\nselected>` reported `defaultSelected` as `false` both from parsed markup\nand from `createElement` followed by `setAttribute`, which is every way a\nconsumer writes one. The snapshot could only ever be true for an element\nalready in the document when `customElements.define` ran.\n\nNothing overwrites it either, which is what makes reading it late correct\nrather than merely later: `selected` does not reflect, for the reason\n`willUpdate` records, so the group's writes never reach the attribute and\nwhat it says is what the markup said.\n\n**The deeper half is not this.** State reflecting under the declaration's\nname is the fault `TreeItem` avoids by mirroring to `data-selected`.\nSplitting them means moving what every stylesheet selects on, which is a\nchange of its own rather than a property being added."
             },
             {
               "kind": "field",
-              "name": "defaultSelected",
+              "name": "focusable",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the markup declared this one chosen, which is what a reset returns to.\n\n`<option selected>` reflects to `defaultSelected` and `option.selected` is\nlive state that does not reflect, and those are two different facts. This\nelement has one `selected` doing both jobs, so the declaration is the\nattribute and the state is the property.\n\n**The attribute, read when it is asked for, and never a snapshot taken in\nthe constructor.** A field initializer runs there, and an element the HTML\nparser created has none of its attributes yet at that moment: measured on\nthis element, on `Option` and on `Radio`, `<helix-toggle value=\"light\"\nselected>` reported `defaultSelected` as `false` both from parsed markup\nand from `createElement` followed by `setAttribute`, which is every way a\nconsumer writes one. The snapshot could only ever be true for an element\nalready in the document when `customElements.define` ran.\n\nNothing overwrites it either, which is what makes reading it late correct\nrather than merely later: `selected` does not reflect, for the reason\n`willUpdate` records, so the group's writes never reach the attribute and\nwhat it says is what the markup said.\n\n**The deeper half is not this.** State reflecting under the declaration's\nname is the fault `TreeItem` avoids by mirroring to `data-selected`.\nSplitting them means moving what every stylesheet selects on, which is a\nchange of its own rather than a property being added."
+              "default": "false",
+              "description": "Whether this item holds the group's tab stop while nothing is chosen.\n\nThe stop normally rides on the selection, and an unanswered group has no\nselection, so without this the keyboard cannot reach it. Written by the\ngroup, with no attribute: it is coordination between elements, and\n`tabindex` on a host the consumer rendered is the change a React consumer's\nhydration reports and does not patch up."
             },
             {
               "kind": "field",
-              "name": "focusable",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this item holds the group's tab stop while nothing is chosen.\n\nThe stop normally rides on the selection, and an unanswered group has no\nselection, so without this the keyboard cannot reach it. Written by the\ngroup, with no attribute: it is coordination between elements, and\n`tabindex` on a host the consumer rendered is the change a React consumer's\nhydration reports and does not patch up."
+              "description": "Whether this one can be chosen.",
+              "attribute": "disabled",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "field",
@@ -98713,8 +99063,40 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this item is the current one.",
-              "attribute": "selected"
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "attribute": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "attribute": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "itemPart",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'item'",
+              "description": "The part `focusItem` focuses. See the interface note.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
             },
             {
               "kind": "method",
@@ -98724,7 +99106,11 @@
                   "text": "void"
                 }
               },
-              "description": "Moves focus to this item's own control.\n\nThe group drives arrow-key navigation and cannot reach the control itself,\nwhich is inside this shadow root. Exposing the intent as a method keeps the\ngroup out of the child's internals.",
+              "description": "Moves focus to the control this renders, for the set's arrow keys.\n\nThe set drives the keys and cannot reach the control itself, which is\ninside this shadow root, so the intent is a method and the internals stay\nthe item's.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
                 "text": "focusItem() => void"
               }
@@ -98734,24 +99120,18 @@
               "name": "select",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Chooses this item and announces it.",
+              "description": "Chooses this one and announces it, and reports whether it stood.",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
               "type": {
-                "text": "select() => void"
+                "text": "select() => boolean"
               }
             },
-            {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Identifies the item to the group.",
-              "attribute": "value"
-            },
             {
               "kind": "field",
               "name": "tier",
@@ -99087,35 +99467,6 @@
               "reactProp": "onhelix-select"
             }
           ],
-          "attributes": [
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the item can be chosen.",
-              "fieldName": "disabled"
-            },
-            {
-              "name": "selected",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether this item is the current one.",
-              "fieldName": "selected"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Identifies the item to the group.",
-              "fieldName": "value"
-            }
-          ],
           "cssStates": [
             {
               "description": "While it is on.",
@@ -99130,6 +99481,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -99158,6 +99515,47 @@
           },
           "tagName": "helix-headless-toggle",
           "customElement": true,
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this one can be chosen.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "fieldName": "selected",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "fieldName": "value",
+              "inheritedFrom": {
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              }
+            }
+          ],
           "modulePath": "src/toggle/root/toggle-root.ts",
           "definitionPath": "src/toggle/root/toggle-root.ts"
         }