@fusion.dev/helix 0.52.0 → 0.53.0

package/custom-elements.json

@@ -1387,7 +1387,7 @@
               "type": {
                 "text": "'elevated' | 'filled' | undefined"
               },
-              "description": "Which rung of the surface ladder the band rides.\n\n`filled` is the resting one, a well sunk below the page. `elevated` brings\nit up to the surface step, for a band that reads as part of the furniture\nrather than as a slot cut into it.\n\n**This was `tone=\"surface\"`**, which put an elevation on the axis that says\nwhat a thing means. The band's own doc admitted it, calling `surface` the\none value that was not a color. A band can be `info` and elevated at the\nsame time, and two values that can both be true are two axes.\n\nStyled and not headless, because a rung of a ladder is paint: the headless\ntier has no stylesheet to sit a band on. `tone` crosses because meaning\nsurvives having nothing to paint with, and it is the only axis that does.",
+              "description": "Which rung of the surface ladder the band rides.\n\n`filled` is the resting one, a well sunk below the page. `elevated` brings\nit up to the surface step, for a band that reads as part of the furniture\nrather than as a slot cut into it.\n\n**`separation` and not `tone`, because a rung is not a meaning.** A band\ncan be `info` and elevated at the same time, and two values that can both\nbe true are two axes, which is the test the registry answers to.\n\nStyled and not headless, because a rung of a ladder is paint: the headless\ntier has no stylesheet to sit a band on. `tone` crosses because meaning\nsurvives having nothing to paint with, and it is the only axis that does.",
               "attribute": "separation",
               "reflects": true
             },
@@ -1827,7 +1827,7 @@
               "type": {
                 "text": "'elevated' | 'filled' | undefined"
               },
-              "description": "Which rung of the surface ladder the band rides.\n\n`filled` is the resting one, a well sunk below the page. `elevated` brings\nit up to the surface step, for a band that reads as part of the furniture\nrather than as a slot cut into it.\n\n**This was `tone=\"surface\"`**, which put an elevation on the axis that says\nwhat a thing means. The band's own doc admitted it, calling `surface` the\none value that was not a color. A band can be `info` and elevated at the\nsame time, and two values that can both be true are two axes.\n\nStyled and not headless, because a rung of a ladder is paint: the headless\ntier has no stylesheet to sit a band on. `tone` crosses because meaning\nsurvives having nothing to paint with, and it is the only axis that does.",
+              "description": "Which rung of the surface ladder the band rides.\n\n`filled` is the resting one, a well sunk below the page. `elevated` brings\nit up to the surface step, for a band that reads as part of the furniture\nrather than as a slot cut into it.\n\n**`separation` and not `tone`, because a rung is not a meaning.** A band\ncan be `info` and elevated at the same time, and two values that can both\nbe true are two axes, which is the test the registry answers to.\n\nStyled and not headless, because a rung of a ladder is paint: the headless\ntier has no stylesheet to sit a band on. `tone` crosses because meaning\nsurvives having nothing to paint with, and it is the only axis that does.",
               "fieldName": "separation"
             },
             {
@@ -2899,7 +2899,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.",
+              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.\nThe resting value therefore lives in the render, as `curve ?? 'straight'`.\n\n**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A\nline claims a position, so the bounded invention a monotone cubic makes is\na reading aid and costs nothing. A band claims an amount, and two sums\nsmoothed independently can cross, so the same aid here draws a part as less\nthan nothing. Same axis, different mark, different resting value.",
               "attribute": "curve",
               "reflects": true,
               "inheritedFrom": {
@@ -3681,7 +3681,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.",
+              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.\nThe resting value therefore lives in the render, as `curve ?? 'straight'`.\n\n**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A\nline claims a position, so the bounded invention a monotone cubic makes is\na reading aid and costs nothing. A band claims an amount, and two sums\nsmoothed independently can cross, so the same aid here draws a part as less\nthan nothing. Same axis, different mark, different resting value.",
               "fieldName": "curve",
               "inheritedFrom": {
                 "name": "HelixHeadlessAreaChart",
@@ -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",
@@ -33080,42 +33136,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 +35058,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 +43763,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 +44521,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 +45773,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 +50400,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 +55098,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 +59355,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",
@@ -62505,7 +62570,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.",
+              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "attribute": "curve",
               "reflects": true,
               "inheritedFrom": {
@@ -63243,7 +63308,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.",
+              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "fieldName": "curve",
               "inheritedFrom": {
                 "name": "HelixHeadlessLineChart",
@@ -65123,6 +65188,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",
@@ -70954,7 +71033,7 @@
               "type": {
                 "text": "'subtle' | undefined"
               },
-              "description": "How much ink the reading claims.\n\n`subtle` is the reading as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a dashboard of several meters\nwhere one is the number being watched and the rest are context, which is a\nfact about the region rather than about any one of them.\n\n**One value and not the four.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `outlined` earns its\nplace in `BarChart`, which keeps the area and fades it toward the page, only\nbecause a chart has other series for the outlined one to be a *different\nkind of fact from* (a forecast, a target, a budget). A meter reports one\nquantity against its own range, and the bands it carries already say which\npart of that range it is in, so there is no second kind of fact for an\noutline to name. `solid` is the resting state and is written by not writing\nit, per the rule that a reflected property takes no default.",
+              "description": "How much ink the reading claims.\n\n`subtle` is the reading as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a dashboard of several meters\nwhere one is the number being watched and the rest are context, which is a\nfact about the region rather than about any one of them.\n\n**One value of the five.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `muted` is the quiet\nink `Text` takes and a reading draws a fill rather than ink, so `subtle` is\nthe whole of what quiet means here. `outlined` earns its\nplace in `BarChart`, which keeps the area and fades it toward the page, only\nbecause a chart has other series for the outlined one to be a *different\nkind of fact from* (a forecast, a target, a budget). A meter reports one\nquantity against its own range, and the bands it carries already say which\npart of that range it is in, so there is no second kind of fact for an\noutline to name. `solid` is the resting state and is written by not writing\nit, per the rule that a reflected property takes no default.",
               "attribute": "emphasis",
               "reflects": true
             },
@@ -71567,7 +71646,7 @@
               "type": {
                 "text": "'subtle' | undefined"
               },
-              "description": "How much ink the reading claims.\n\n`subtle` is the reading as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a dashboard of several meters\nwhere one is the number being watched and the rest are context, which is a\nfact about the region rather than about any one of them.\n\n**One value and not the four.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `outlined` earns its\nplace in `BarChart`, which keeps the area and fades it toward the page, only\nbecause a chart has other series for the outlined one to be a *different\nkind of fact from* (a forecast, a target, a budget). A meter reports one\nquantity against its own range, and the bands it carries already say which\npart of that range it is in, so there is no second kind of fact for an\noutline to name. `solid` is the resting state and is written by not writing\nit, per the rule that a reflected property takes no default.",
+              "description": "How much ink the reading claims.\n\n`subtle` is the reading as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a dashboard of several meters\nwhere one is the number being watched and the rest are context, which is a\nfact about the region rather than about any one of them.\n\n**One value of the five.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `muted` is the quiet\nink `Text` takes and a reading draws a fill rather than ink, so `subtle` is\nthe whole of what quiet means here. `outlined` earns its\nplace in `BarChart`, which keeps the area and fades it toward the page, only\nbecause a chart has other series for the outlined one to be a *different\nkind of fact from* (a forecast, a target, a budget). A meter reports one\nquantity against its own range, and the bands it carries already say which\npart of that range it is in, so there is no second kind of fact for an\noutline to name. `solid` is the resting state and is written by not writing\nit, per the rule that a reflected property takes no default.",
               "fieldName": "emphasis"
             },
             {
@@ -73453,40 +73532,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 +73607,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 +73620,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 +74082,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 +74146,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 +74754,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 +75548,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",
@@ -79712,7 +79802,7 @@
               "type": {
                 "text": "'lg' | 'sm' | undefined"
               },
-              "description": "Diameter relative to the surrounding text.\n\nReflected because the stylesheet selects on it. The mesh is chosen from the\nrendered box rather than from this, so `--orb-size` and a consumer's own\n`inline-size` get the same treatment as the three named steps.",
+              "description": "Diameter relative to the surrounding text.\n\nReflected because the stylesheet selects on it. The mesh is chosen from the\nrendered box rather than from this, so `--orb-size` and a consumer's own\n`inline-size` get the same treatment as the named steps.",
               "attribute": "size",
               "reflects": true
             },
@@ -80334,7 +80424,7 @@
               "type": {
                 "text": "'lg' | 'sm' | undefined"
               },
-              "description": "Diameter relative to the surrounding text.\n\nReflected because the stylesheet selects on it. The mesh is chosen from the\nrendered box rather than from this, so `--orb-size` and a consumer's own\n`inline-size` get the same treatment as the three named steps.",
+              "description": "Diameter relative to the surrounding text.\n\nReflected because the stylesheet selects on it. The mesh is chosen from the\nrendered box rather than from this, so `--orb-size` and a consumer's own\n`inline-size` get the same treatment as the named steps.",
               "fieldName": "size"
             },
             {
@@ -84758,6 +84848,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",
@@ -87176,7 +87280,7 @@
               "type": {
                 "text": "'subtle' | undefined"
               },
-              "description": "How much ink the bar claims.\n\n`subtle` is the bar as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a background task, which has to\nbe visible and must not compete with what the reader is actually looking at.\n\n**One value and not the four.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `outlined` is the\ninteresting refusal: `BarChart` earns it by keeping the area and fading it\ntoward the page, so an outlined column still encodes its value and stands as\na *different kind of fact* from the series beside it (a forecast, a target,\na budget). A progress bar is alone in its region and has nothing to differ\nfrom, so an outline there costs legibility and buys no distinction. `solid`\nis the resting state and is written by not writing it, per the rule that a\nreflected property takes no default.",
+              "description": "How much ink the bar claims.\n\n`subtle` is the bar as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a background task, which has to\nbe visible and must not compete with what the reader is actually looking at.\n\n**One value of the five.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `muted` is the quiet\nink `Text` takes and a bar draws a fill rather than ink, so `subtle` is the\nwhole of what quiet means here. `outlined` is the\ninteresting refusal: `BarChart` earns it by keeping the area and fading it\ntoward the page, so an outlined column still encodes its value and stands as\na *different kind of fact* from the series beside it (a forecast, a target,\na budget). A progress bar is alone in its region and has nothing to differ\nfrom, so an outline there costs legibility and buys no distinction. `solid`\nis the resting state and is written by not writing it, per the rule that a\nreflected property takes no default.",
               "attribute": "emphasis",
               "reflects": true
             },
@@ -87624,7 +87728,7 @@
               "type": {
                 "text": "'subtle' | undefined"
               },
-              "description": "How much ink the bar claims.\n\n`subtle` is the bar as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a background task, which has to\nbe visible and must not compete with what the reader is actually looking at.\n\n**One value and not the four.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `outlined` is the\ninteresting refusal: `BarChart` earns it by keeping the area and fading it\ntoward the page, so an outlined column still encodes its value and stands as\na *different kind of fact* from the series beside it (a forecast, a target,\na budget). A progress bar is alone in its region and has nothing to differ\nfrom, so an outline there costs legibility and buys no distinction. `solid`\nis the resting state and is written by not writing it, per the rule that a\nreflected property takes no default.",
+              "description": "How much ink the bar claims.\n\n`subtle` is the bar as a wash of its own color: still legible, no longer\nthe loudest thing in the region. The case is a background task, which has to\nbe visible and must not compete with what the reader is actually looking at.\n\n**One value of the five.** `ghost` would leave a track with nothing in\nit, which is not a quiet reading but an absent one. `muted` is the quiet\nink `Text` takes and a bar draws a fill rather than ink, so `subtle` is the\nwhole of what quiet means here. `outlined` is the\ninteresting refusal: `BarChart` earns it by keeping the area and fading it\ntoward the page, so an outlined column still encodes its value and stands as\na *different kind of fact* from the series beside it (a forecast, a target,\na budget). A progress bar is alone in its region and has nothing to differ\nfrom, so an outline there costs legibility and buys no distinction. `solid`\nis the resting state and is written by not writing it, per the rule that a\nreflected property takes no default.",
               "fieldName": "emphasis"
             },
             {
@@ -87932,11 +88036,11 @@
               "kind": "field",
               "name": "shape",
               "type": {
-                "text": "QrStyle"
+                "text": "QrStyle | undefined"
               },
-              "default": "'square'",
-              "description": "How the modules are drawn.\n\n`square` is the default and the only one that joins runs of adjacent\nmodules into a single subpath, which is what keeps a thousand modules to a\nhandful of nodes. `rounded` and `dots` draw each module on its own, because\nthe corners are the thing being drawn and a joined run has none in the\nmiddle. That cost is paid only by a code that asks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
+              "description": "How the modules are drawn.\n\n`square` is the resting state and is written by not writing it, per the\nrule that a reflected property takes no default. It is also the only one\nthat joins runs of adjacent modules into a single subpath, which is what\nkeeps a thousand modules to a handful of nodes. `rounded` and `dots` draw\neach module on its own, because the corners are the thing being drawn and a\njoined run has none in the middle. That cost is paid only by a code that\nasks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
               "attribute": "shape",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessQrCode",
                 "module": "src/qr-code/root/qr-code-root.ts"
@@ -88443,10 +88547,9 @@
             {
               "name": "shape",
               "type": {
-                "text": "QrStyle"
+                "text": "QrStyle | undefined"
               },
-              "default": "'square'",
-              "description": "How the modules are drawn.\n\n`square` is the default and the only one that joins runs of adjacent\nmodules into a single subpath, which is what keeps a thousand modules to a\nhandful of nodes. `rounded` and `dots` draw each module on its own, because\nthe corners are the thing being drawn and a joined run has none in the\nmiddle. That cost is paid only by a code that asks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
+              "description": "How the modules are drawn.\n\n`square` is the resting state and is written by not writing it, per the\nrule that a reflected property takes no default. It is also the only one\nthat joins runs of adjacent modules into a single subpath, which is what\nkeeps a thousand modules to a handful of nodes. `rounded` and `dots` draw\neach module on its own, because the corners are the thing being drawn and a\njoined run has none in the middle. That cost is paid only by a code that\nasks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
               "fieldName": "shape",
               "inheritedFrom": {
                 "name": "HelixHeadlessQrCode",
@@ -89158,6 +89261,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",
@@ -90354,65 +90471,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"
               }
             },
             {
@@ -90423,13 +90529,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"
               }
             },
             {
@@ -90437,13 +90543,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"
@@ -90798,11 +90929,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"
               }
             },
             {
@@ -90811,11 +90942,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"
               }
             },
             {
@@ -90824,11 +90955,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"
               }
             }
           ],
@@ -91252,6 +91383,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",
@@ -98391,7 +98536,7 @@
               "type": {
                 "text": "'ghost' | undefined"
               },
-              "description": "How much ink the trigger claims.\n\n**The first field in this library to take an axis, and the case that asked\nfor it is a control in a row rather than a control on a form.** A chat's\ncomposer wants a model picker beside an attachment button and a send button:\nat the field's own frame it is 40 pixels of bordered well in a line of 28\npixel glyphs, and it reads as the composer's subject rather than as one of\nits tools. The same is true of a select in a toolbar, in a table header, or\ninside a sentence.\n\n- Unset is the frame an `Input` wears, which is what a form wants: a control\n  that looks like a button among fields reads as an action rather than an\n  answer.\n- `ghost` drops the fill and the edge, takes the width of what is in it, and\n  puts the mark against the value instead of at the far end of the control.\n\n**`emphasis` and not `separation`, which the registry decides rather than\ntaste.** Emphasis is asked of controls, how loud this one is; separation is\nasked of containers, where the surface ends. A trigger is a control, and a\nfamily may not declare both. Two of the four values are refused: `solid` and\n`subtle` are a button's way of being the one thing to press, which is not a\nthing an answer should ever be.\n\n**The other three fields want this too and do not have it yet.** `Input`,\n`Textarea` and `Combobox` wear the same frame from the same shared\nstylesheet, and an inline one of each is as reasonable as an inline select.\nThey are left alone rather than swept, because each has a different thing\ninside the frame and guessing at three is how an axis ends up meaning four\nthings, which is the fault `appearance` was retired for.",
+              "description": "How much ink the trigger claims.\n\n**The first field in this library to take an axis, and the case that asked\nfor it is a control in a row rather than a control on a form.** A chat's\ncomposer wants a model picker beside an attachment button and a send button:\nat the field's own frame it is 40 pixels of bordered well in a line of 28\npixel glyphs, and it reads as the composer's subject rather than as one of\nits tools. The same is true of a select in a toolbar, in a table header, or\ninside a sentence.\n\n- Unset is the frame an `Input` wears, which is what a form wants: a control\n  that looks like a button among fields reads as an action rather than an\n  answer.\n- `ghost` drops the fill and the edge, takes the width of what is in it, and\n  puts the mark against the value instead of at the far end of the control.\n\n**`emphasis` and not `separation`, which the registry decides rather than\ntaste.** Emphasis is asked of controls, how loud this one is; separation is\nasked of containers, where the surface ends. A trigger is a control, and a\nfamily may not declare both. Three of the five values are refused: `solid`\nand `subtle` are a button's way of being the one thing to press, which is\nnot a thing an answer should ever be, and `muted` is the quiet ink `Text`\ntakes, where a trigger's loudness is its frame rather than its ink.\n`outlined` is what the unset frame already draws, so writing it would be\nwriting the resting state out.\n\n**The other three fields want this too and do not have it yet.** `Input`,\n`Textarea` and `Combobox` wear the same frame from the same shared\nstylesheet, and an inline one of each is as reasonable as an inline select.\nThey are left alone rather than swept, because each has a different thing\ninside the frame and guessing at three is how an axis ends up meaning four\nthings, which is the fault `appearance` was retired for.",
               "attribute": "emphasis",
               "reflects": true
             },
@@ -98639,6 +98784,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",
@@ -99578,7 +99737,7 @@
               "type": {
                 "text": "'ghost' | undefined"
               },
-              "description": "How much ink the trigger claims.\n\n**The first field in this library to take an axis, and the case that asked\nfor it is a control in a row rather than a control on a form.** A chat's\ncomposer wants a model picker beside an attachment button and a send button:\nat the field's own frame it is 40 pixels of bordered well in a line of 28\npixel glyphs, and it reads as the composer's subject rather than as one of\nits tools. The same is true of a select in a toolbar, in a table header, or\ninside a sentence.\n\n- Unset is the frame an `Input` wears, which is what a form wants: a control\n  that looks like a button among fields reads as an action rather than an\n  answer.\n- `ghost` drops the fill and the edge, takes the width of what is in it, and\n  puts the mark against the value instead of at the far end of the control.\n\n**`emphasis` and not `separation`, which the registry decides rather than\ntaste.** Emphasis is asked of controls, how loud this one is; separation is\nasked of containers, where the surface ends. A trigger is a control, and a\nfamily may not declare both. Two of the four values are refused: `solid` and\n`subtle` are a button's way of being the one thing to press, which is not a\nthing an answer should ever be.\n\n**The other three fields want this too and do not have it yet.** `Input`,\n`Textarea` and `Combobox` wear the same frame from the same shared\nstylesheet, and an inline one of each is as reasonable as an inline select.\nThey are left alone rather than swept, because each has a different thing\ninside the frame and guessing at three is how an axis ends up meaning four\nthings, which is the fault `appearance` was retired for.",
+              "description": "How much ink the trigger claims.\n\n**The first field in this library to take an axis, and the case that asked\nfor it is a control in a row rather than a control on a form.** A chat's\ncomposer wants a model picker beside an attachment button and a send button:\nat the field's own frame it is 40 pixels of bordered well in a line of 28\npixel glyphs, and it reads as the composer's subject rather than as one of\nits tools. The same is true of a select in a toolbar, in a table header, or\ninside a sentence.\n\n- Unset is the frame an `Input` wears, which is what a form wants: a control\n  that looks like a button among fields reads as an action rather than an\n  answer.\n- `ghost` drops the fill and the edge, takes the width of what is in it, and\n  puts the mark against the value instead of at the far end of the control.\n\n**`emphasis` and not `separation`, which the registry decides rather than\ntaste.** Emphasis is asked of controls, how loud this one is; separation is\nasked of containers, where the surface ends. A trigger is a control, and a\nfamily may not declare both. Three of the five values are refused: `solid`\nand `subtle` are a button's way of being the one thing to press, which is\nnot a thing an answer should ever be, and `muted` is the quiet ink `Text`\ntakes, where a trigger's loudness is its frame rather than its ink.\n`outlined` is what the unset frame already draws, so writing it would be\nwriting the resting state out.\n\n**The other three fields want this too and do not have it yet.** `Input`,\n`Textarea` and `Combobox` wear the same frame from the same shared\nstylesheet, and an inline one of each is as reasonable as an inline select.\nThey are left alone rather than swept, because each has a different thing\ninside the frame and guessing at three is how an axis ends up meaning four\nthings, which is the fault `appearance` was retired for.",
               "fieldName": "emphasis"
             },
             {
@@ -101793,6 +101952,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",
@@ -103366,7 +103539,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.",
+              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "attribute": "curve",
               "reflects": true,
               "inheritedFrom": {
@@ -103811,7 +103984,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.",
+              "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "fieldName": "curve",
               "inheritedFrom": {
                 "name": "HelixHeadlessSparkline",
@@ -109737,6 +109910,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",
@@ -114923,12 +115110,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"
               }
             },
             {
@@ -114938,11 +115125,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"
               }
             },
             {
@@ -114952,11 +115139,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"
               }
             },
             {
@@ -114967,13 +115168,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"
               }
             },
             {
@@ -114981,16 +115182,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"
               }
             },
             {
@@ -115340,11 +115541,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"
               }
             },
             {
@@ -115353,11 +115554,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"
               }
             },
             {
@@ -115366,11 +115567,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"
               }
             }
           ],
@@ -116791,6 +116992,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",
@@ -119083,6 +119298,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",
@@ -125608,6 +125837,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",
@@ -126744,51 +126987,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"
               }
             },
             {
@@ -126799,13 +127045,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"
               }
             },
             {
@@ -126813,13 +127059,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"
@@ -126827,13 +127085,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"
@@ -127227,11 +127484,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"
               }
             },
             {
@@ -127240,11 +127497,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"
               }
             },
             {
@@ -127253,11 +127510,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"
               }
             }
           ],