@fusion.dev/helix 0.52.1 → 0.53.1

package/custom-elements.json

@@ -18432,6 +18432,20 @@
               "attribute": "orientation",
               "reflects": true
             },
+            {
+              "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",
@@ -19759,6 +19773,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",
@@ -23032,6 +23060,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",
@@ -27028,6 +27070,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",
@@ -27523,6 +27579,20 @@
                 "module": "src/combobox/root/combobox-root.ts"
               }
             },
+            {
+              "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,
+              "inheritedFrom": {
+                "name": "HelixHeadlessCombobox",
+                "module": "src/combobox/root/combobox-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "showing",
@@ -31968,7 +32038,7 @@
               },
               "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"
@@ -32725,6 +32795,20 @@
                 "module": "src/data-table/root/data-table-root.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,
+              "inheritedFrom": {
+                "name": "HelixHeadlessDataTable",
+                "module": "src/data-table/root/data-table-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "requestSort",
@@ -33080,42 +33164,6 @@
                 "module": "src/data-table/root/data-table-root.ts"
               }
             },
-            {
-              "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.",
-              "inheritedFrom": {
-                "name": "HelixHeadlessDataTable",
-                "module": "src/data-table/root/data-table-root.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "announceSort",
@@ -35038,6 +35086,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",
@@ -43729,6 +43791,19 @@
                 "module": "src/drilldown/item/drilldown-item.ts"
               }
             },
+            {
+              "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,
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrilldownItem",
+                "module": "src/drilldown/item/drilldown-item.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -44474,6 +44549,18 @@
                 "module": "src/drilldown/root/drilldown-root.ts"
               }
             },
+            {
+              "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.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrilldown",
+                "module": "src/drilldown/root/drilldown-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "placeTabStop",
@@ -45714,6 +45801,20 @@
                 "module": "src/helix-element/helix-element.ts"
               }
             },
+            {
+              "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",
@@ -50327,6 +50428,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",
@@ -55011,42 +55126,6 @@
                 "module": "src/heatmap/root/heatmap-root.ts"
               }
             },
-            {
-              "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.",
-              "inheritedFrom": {
-                "name": "HelixHeadlessHeatmap",
-                "module": "src/heatmap/root/heatmap-root.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "renderTooltip",
@@ -59304,6 +59383,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",
@@ -65123,6 +65216,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",
@@ -73453,40 +73560,74 @@
             },
             {
               "kind": "field",
-              "name": "at",
+              "name": "dismissible",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "When it happened, as anything `Date` parses.\n\nAn ISO string is what an API sends and what `<time datetime>` takes, so it\nis the shape that needs no translation at either end. Left unset the item\nshows no timestamp rather than showing the epoch, which is what parsing an\nempty string would give.",
-              "attribute": "at",
+              "default": "false",
+              "description": "Whether it offers a control to take it away.",
+              "attribute": "dismissible",
+              "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessNotification",
-                "module": "src/notifications/notification/notification.ts"
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
             {
               "kind": "field",
-              "name": "read",
+              "name": "dismissLabel",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Whether the reader has seen it.\n\nSet it and this element defers: a reader's click fires `helix-read` and\nchanges nothing until a new value arrives. `default-read` seeds a state\nthis element then owns.\n\n**Not reflected.** Unread is a visual state, which is why the four mixins\nmirror theirs, but the mirror may not be the property's own attribute:\n`<helix-notification default-read>` comes back from a server without `read`\nand would gain it on the first update, which React reports as a hydration\nmismatch, and which a copy of the serialized element re-parses as a\ndeclaration. `:state(read)` is what the stylesheet reads.\n`hydration.dom.spec.ts` holds it.",
-              "attribute": "read",
+              "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": "HelixHeadlessNotification",
-                "module": "src/notifications/notification/notification.ts"
+                "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": "defaultRead",
+              "name": "at",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "State to open with, where nothing declared one.",
-              "attribute": "default-read",
+              "default": "''",
+              "description": "When it happened, as anything `Date` parses.\n\nAn ISO string is what an API sends and what `<time datetime>` takes, so it\nis the shape that needs no translation at either end. Left unset the item\nshows no timestamp rather than showing the epoch, which is what parsing an\nempty string would give.",
+              "attribute": "at",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
                 "module": "src/notifications/notification/notification.ts"
@@ -73494,13 +73635,12 @@
             },
             {
               "kind": "field",
-              "name": "dismissible",
+              "name": "read",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether a reader may remove it.",
-              "attribute": "dismissible",
+              "description": "Whether the reader has seen it.\n\nSet it and this element defers: a reader's click fires `helix-read` and\nchanges nothing until a new value arrives. `default-read` seeds a state\nthis element then owns.\n\n**Not reflected.** Unread is a visual state, which is why the four mixins\nmirror theirs, but the mirror may not be the property's own attribute:\n`<helix-notification default-read>` comes back from a server without `read`\nand would gain it on the first update, which React reports as a hydration\nmismatch, and which a copy of the serialized element re-parses as a\ndeclaration. `:state(read)` is what the stylesheet reads.\n`hydration.dom.spec.ts` holds it.",
+              "attribute": "read",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
                 "module": "src/notifications/notification/notification.ts"
@@ -73508,13 +73648,13 @@
             },
             {
               "kind": "field",
-              "name": "dismissLabel",
+              "name": "defaultRead",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Dismiss'",
-              "description": "Accessible name for the dismiss control.",
-              "attribute": "dismiss-label",
+              "default": "false",
+              "description": "State to open with, where nothing declared one.",
+              "attribute": "default-read",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
                 "module": "src/notifications/notification/notification.ts"
@@ -73970,6 +74110,32 @@
               "description": "How a row is told apart from the one above it.\n\n`plain` is the resting one and is a hairline and nothing else: the row has\nno box of its own, and what separates it is a line the list draws between\nthem. It is sayable rather than only reachable by leaving the attribute off,\nwhich is the reason `Announcement` gives for spelling out its own neutral.\n\n`outlined` and `filled` make each row a box: an edge, a corner, and a gap\nwhere the hairline was. A feed of boxes is a different reading of the same\ncontent, and which one is right depends on whether the rows are a list to\nscan or a set of things to act on. The reference this came from draws cards\nbecause every row in it has a control.\n\n**On the row and not on the feed, because the row is the box being\nseparated.** A consumer wanting the whole feed carded says so once, in a\ndocument rule on the element, rather than on every item: this is a styled\naxis and a stylesheet is where it is set.",
               "fieldName": "separation"
             },
+            {
+              "name": "dismissible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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",
+              "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.",
+              "fieldName": "dismissLabel",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "name": "at",
               "type": {
@@ -74008,32 +74174,6 @@
                 "module": "src/notifications/notification/notification.ts"
               }
             },
-            {
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether a reader may remove it.",
-              "fieldName": "dismissible",
-              "inheritedFrom": {
-                "name": "HelixHeadlessNotification",
-                "module": "src/notifications/notification/notification.ts"
-              }
-            },
-            {
-              "name": "dismiss-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Dismiss'",
-              "description": "Accessible name for the dismiss control.",
-              "fieldName": "dismissLabel",
-              "inheritedFrom": {
-                "name": "HelixHeadlessNotification",
-                "module": "src/notifications/notification/notification.ts"
-              }
-            },
             {
               "name": "locale",
               "type": {
@@ -74642,42 +74782,6 @@
                 "module": "src/notifications/root/notifications-root.ts"
               }
             },
-            {
-              "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.",
-              "inheritedFrom": {
-                "name": "HelixHeadlessNotifications",
-                "module": "src/notifications/root/notifications-root.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "handleMarkAll",
@@ -75472,6 +75576,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",
@@ -84758,6 +84876,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",
@@ -89157,6 +89289,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",
@@ -90353,65 +90499,54 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this choice can be made.",
+              "description": "Whether this one can be chosen.",
               "attribute": "disabled",
               "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "defaultSelected",
-              "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.",
-              "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "focusable",
+              "name": "selected",
               "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 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": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "selected",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether this is the current choice.\n\nWritten by the group.",
-              "attribute": "selected",
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "attribute": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "itemPart",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Identifies this choice to the group, and is what the form submits.",
-              "attribute": "value",
+              "privacy": "protected",
+              "default": "'item'",
+              "description": "The part `focusItem` focuses. See the interface note.",
               "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -90422,13 +90557,13 @@
                   "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"
-              },
-              "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
               }
             },
             {
@@ -90436,13 +90571,38 @@
               "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"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultSelected",
+              "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.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessRadio",
+                "module": "src/radio/root/radio-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "focusable",
+              "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessRadio",
                 "module": "src/radio/root/radio-root.ts"
@@ -90797,11 +90957,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this choice can be made.",
+              "description": "Whether this one can be chosen.",
               "fieldName": "disabled",
               "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -90810,11 +90970,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this is the current choice.\n\nWritten by the group.",
+              "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": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -90823,11 +90983,11 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies this choice to the group, and is what the form submits.",
+              "description": "Identifies this one to the set, and is what a form submits.",
               "fieldName": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessRadio",
-                "module": "src/radio/root/radio-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             }
           ],
@@ -91251,6 +91411,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",
@@ -98638,6 +98812,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",
@@ -99014,10 +99202,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,
               "inheritedFrom": {
                 "name": "HelixHeadlessSelect",
@@ -101792,6 +101980,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",
@@ -109736,6 +109938,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",
@@ -114922,12 +115138,12 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the tab can be chosen.",
+              "description": "Whether this one can be chosen.",
               "attribute": "disabled",
               "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -114937,11 +115153,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this tab is the current one.",
+              "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": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -114951,11 +115167,25 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies the tab, and pairs it with the panel of the same value.",
+              "description": "Identifies this one to the set, and is what a form submits.",
               "attribute": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "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"
               }
             },
             {
@@ -114966,13 +115196,13 @@
                   "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"
-              },
-              "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
               }
             },
             {
@@ -114980,16 +115210,16 @@
               "name": "select",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Selects this tab and announces it.",
-              "type": {
-                "text": "select() => void"
-              },
+              "description": "Chooses this one and announces it, and reports whether it stood.",
               "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
+              },
+              "type": {
+                "text": "select() => boolean"
               }
             },
             {
@@ -115339,11 +115569,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the tab can be chosen.",
+              "description": "Whether this one can be chosen.",
               "fieldName": "disabled",
               "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -115352,11 +115582,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this tab is the current one.",
+              "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": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -115365,11 +115595,11 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies the tab, and pairs it with the panel of the same value.",
+              "description": "Identifies this one to the set, and is what a form submits.",
               "fieldName": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessTab",
-                "module": "src/tabs/tab/tab.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             }
           ],
@@ -116790,6 +117020,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",
@@ -119082,6 +119326,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",
@@ -125607,6 +125865,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",
@@ -126743,51 +127015,54 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the item can be chosen.",
+              "description": "Whether this one can be chosen.",
               "attribute": "disabled",
               "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "defaultSelected",
+              "name": "selected",
               "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 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": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "focusable",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "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.",
+              "default": "''",
+              "description": "Identifies this one to the set, and is what a form submits.",
+              "attribute": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
               "kind": "field",
-              "name": "selected",
+              "name": "itemPart",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether this item is the current one.",
-              "attribute": "selected",
+              "privacy": "protected",
+              "default": "'item'",
+              "description": "The part `focusItem` focuses. See the interface note.",
               "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -126798,13 +127073,13 @@
                   "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"
-              },
-              "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
               }
             },
             {
@@ -126812,13 +127087,25 @@
               "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": "defaultSelected",
+              "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessToggle",
                 "module": "src/toggle/root/toggle-root.ts"
@@ -126826,13 +127113,12 @@
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "focusable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Identifies the item to the group.",
-              "attribute": "value",
+              "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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessToggle",
                 "module": "src/toggle/root/toggle-root.ts"
@@ -127226,11 +127512,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the item can be chosen.",
+              "description": "Whether this one can be chosen.",
               "fieldName": "disabled",
               "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -127239,11 +127525,11 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this item is the current one.",
+              "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": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             },
             {
@@ -127252,11 +127538,11 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies the item to the group.",
+              "description": "Identifies this one to the set, and is what a form submits.",
               "fieldName": "value",
               "inheritedFrom": {
-                "name": "HelixHeadlessToggle",
-                "module": "src/toggle/root/toggle-root.ts"
+                "name": "MixinSelectableItem",
+                "module": "src/mixins/mixin-selectable-item/mixin-selectable-item.ts"
               }
             }
           ],