@fusion.dev/helix-headless 0.52.1 → 0.53.1

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",
@@ -20769,6 +20811,16 @@
               "description": "The chosen options themselves, for their words.\n\nRead off the options rather than stored, because the words are the\nconsumer's content and a copy of them goes stale the moment they change it.\nSelect records the same.\n\nIn the value's own order, which is the order they were chosen. It has to\nbe: a created answer is not in the list at all, so there is no position in\nthe list to give it. Neither order ever reshuffles what is already there,\nso a tag does not move out from under the pointer about to remove it.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "unresolved",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether a value is declared and this render cannot say what it is.\n\n**A placeholder is a statement, so a render that cannot read the words does\nnot make it.** `value` is an attribute and a server has it; the words are\nthe options' and the options are light-DOM children a server has none of.\nThe field then came out empty with \"Search owners\" over it, which says\nnothing is chosen where the consumer had already said what is. Blank, it\nsays nothing, keeps its box, and is filled in by the render after\nhydration, which is the answer `Select.Root.display` reaches for in the same\nposition and for the same reason.\n\nThe placeholder still stands where there is genuinely no value, which is\nwhat it is for and the one case a server can be sure of.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "showing",
@@ -21418,6 +21470,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",
@@ -25374,12 +25440,22 @@
               },
               "privacy": "protected",
               "readonly": true,
-              "description": "Emptiness is a fact about the data here, not about slotted children.\n\n**The page rather than the window**, which is the difference between the two\ncounts `view` carries and the reason this reads `available`. A windowed\ntable draws a slice, and a slice can be short of the rows that are there:\nasking whether *this* slice has rows says \"nothing matched\" about a result\nthat matched plenty.\n\nThe mixin's own answer counts children with no `slot`, which for this\nelement is the columns. Left in place, a table with columns and no data\nwould call itself full.",
+              "description": "Emptiness is a fact about the data here, not about slotted children.\n\n**The page rather than the window**, which is the difference between the two\ncounts `view` carries and the reason this reads `available`. A windowed\ntable draws a slice, and a slice can be short of the rows that are there:\nasking whether *this* slice has rows says \"nothing matched\" about a result\nthat matched plenty.\n\nThe mixin's own answer counts children with no `slot`, which for this\nelement is the columns. Left in place, a table with columns and no data\nwould call itself full.\n\n**`sourceKnown` is the half the mixin was keeping**, and overriding without\nit is what put \"Nothing to show\" over eight rows of files on every server\nrender of this family's own preview. `MixinCollection.hasRows` answers true\nuntil the rows have been counted for exactly that reason, and a count is\nwhat this replaced.",
               "inheritedFrom": {
                 "name": "MixinCollection",
                 "module": "src/mixins/mixin-collection/mixin-collection.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "sourceKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether this render can tell a result with no rows from one not yet handed\nover.\n\n**Unknown is not empty, which is what an empty state must never say.** The\nrows are a property, and a property is set by whoever holds the element: a\nconsumer binding it in a template has it on the server, and a consumer\nassigning it from a script has it only once that script has run, which is\nafter the parse a server's markup ends at. A render that cannot see a\ndocument cannot tell the two apart, and a hydrating render must not look,\nits output having to be the server's.\n\nThe same shape as `Heatmap.sourceKnown`, asked of a property rather than of\na document, and `childrenKnown` is already both halves of the question: a\nserver has no tree and a hydrating render may not read one.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "requestSort",
@@ -25667,38 +25743,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 +28282,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 +34870,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 +35390,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 +36960,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 +41119,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 +43032,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 +43050,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 +43532,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 +47731,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 +52556,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 +58869,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 +58963,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 +59394,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 +59422,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 +59452,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinDismissible",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -59550,38 +59704,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 +60932,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 +67376,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 +70917,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 +71911,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 +71948,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 +71962,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 +71991,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 +72005,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 +72352,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 +72366,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -72225,6 +72400,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 +72974,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",
@@ -75397,10 +75627,10 @@
               "kind": "field",
               "name": "display",
               "type": {
-                "text": "string"
+                "text": "string | typeof nothing"
               },
               "privacy": "private",
-              "description": "What the trigger says: the chosen options' words, or the placeholder.\n\nRead off the options rather than stored, because the words are the\nconsumer's content and storing a copy is storing something that goes stale\nthe moment they change it.\n\n**Off this element's own children, not the listbox's**, which reach the\nlistbox through a slot and so only after a render has made it: read there,\nthe first render showed the placeholder over a chosen value and waited on a\n`slotchange`, which a declarative shadow root fires before anything listens,\nso a hydrated select kept \"Choose\" for good. Nothing on a server or while\nhydrating what one sent, which drew the placeholder too.",
+              "description": "What the trigger says: the chosen options' words, or the placeholder.\n\nRead off the options rather than stored, because the words are the\nconsumer's content and storing a copy is storing something that goes stale\nthe moment they change it.\n\n**Off this element's own children, not the listbox's**, which reach the\nlistbox through a slot and so only after a render has made it: read there,\nthe first render showed the placeholder over a chosen value and waited on a\n`slotchange`, which a declarative shadow root fires before anything listens,\nso a hydrated select kept \"Choose\" for good. Nothing on a server or while\nhydrating what one sent, which drew the placeholder too.\n\n**And the placeholder is a statement, so a render that cannot read the\nwords does not make it.** \"Choose\" means nothing is chosen. `value` is an\nattribute and a server has it, the words are the children's and a server\nhas none, so a `<helix-select default-value=\"two\">` served \"Choose\" over an\nanswer the consumer had already given: false to a reader, and false to a\ncrawler, on every select in the library's own examples. Where a value is\ndeclared and the word for it cannot be read, the trigger says nothing and\nkeeps its box, which is the answer this library reaches for everywhere it\ncannot tell empty from unknown. `firstUpdated` asks for the render that\nfills it in.\n\nThe placeholder still stands where there is genuinely no value, which is\nwhat it is for and the one case a server can be sure of.\n\n**`nothing` and never `''`, which is the difference between a word that\narrives and one that never does.** Lit's hydration primes a child part with\nwhatever the render computed, and `''` is a primitive, so `_commitText`\ntakes the branch that assumes the server left a text node to overwrite.\nThere is none, the write lands on the closing part marker's comment data,\nand the trigger stays empty for the life of the page: measured by\n`check:spec:dsd`, which caught all nine of these and showed a blank select\nbeside a client's \"Option Two\". `nothing` primes the sentinel instead, so\nthe commit creates the text node it needs.",
               "readonly": true
             },
             {
@@ -75703,6 +75933,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 +78320,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 +84691,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 +89245,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 +89266,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 +89281,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 +89295,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 +89310,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 +89324,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 +89671,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 +89685,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -89426,6 +89709,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 +90795,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 +92981,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 +98066,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 +99046,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 +99083,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 +99126,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 +99140,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 +99487,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 +99501,12 @@
               }
             }
           ],
+          "mixins": [
+            {
+              "name": "MixinSelectableItem",
+              "package": "@fusion.dev/helix-core"
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -99158,6 +99535,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"
         }