@fusion.dev/helix-core 0.104.1 → 0.105.0

package/custom-elements.json

@@ -1175,15 +1175,15 @@
           "name": "FloatingController",
           "cssProperties": [
             {
-              "description": "How wide the anchor is, for a panel that matches it.",
+              "description": "The anchor's width, for a panel that matches it.",
               "name": "--floating-anchor-inline-size"
             },
             {
-              "description": "Where the pointer meets the anchor, from the panel's left edge in either direction.",
+              "description": "Where the arrow meets the anchor, from the panel's left edge in both text directions.",
               "name": "--floating-arrow-x"
             },
             {
-              "description": "Where the pointer meets the anchor, from the panel's top edge.",
+              "description": "Where the arrow meets the anchor, from the panel's top edge.",
               "name": "--floating-arrow-y"
             },
             {
@@ -3625,6 +3625,50 @@
           },
           "helix": {}
         },
+        {
+          "kind": "class",
+          "description": "A marker, a position, a route or an area changed what it says: where it is,\nits points, its progress, its name.\n\n**Said rather than reflected.** The connector and the frame follow the\nparts, and heard them through their attributes until the parts reflected\nnothing CSS selects on: a live position's coordinates are state, and a\nroute's points are a payload, neither of which belongs in the markup. It\nbubbles to the frame, whose light-DOM children the parts are, and goes no\nfurther, being the family's own bookkeeping rather than news for a page.",
+          "name": "HelixMapPartChangeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-map-part-change'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A reader pressed a cluster, one marker standing for several that would have\ndrawn over each other.\n\n**Opened by zooming in**, which the connector does, framing the places the\ncluster holds, as pressing one does on every map a reader has used. Told\nrather than asked: a page that lists them in a panel instead connects with\n`clusterZoom: false`. Sent from the marker the cluster is drawn as, and\nbubbles through the frame to the page.",
+          "name": "HelixMapClusterEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-map-cluster'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
         {
           "kind": "class",
           "description": "A message is about to be pinned or unpinned, and can be refused.",
@@ -4378,6 +4422,22 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMapPartChangeEvent",
+          "declaration": {
+            "name": "HelixMapPartChangeEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapClusterEvent",
+          "declaration": {
+            "name": "HelixMapClusterEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixBeforePinEvent",
@@ -4853,7 +4913,7 @@
           "events": [],
           "cssStates": [
             {
-              "description": "Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.",
+              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled"
             }
           ],
@@ -5090,7 +5150,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the control is non-interactive.\n\nReflected, because the styled tier selects on it, and mirrored to\n`aria-disabled` rather than removing the element from the accessibility\ntree, so a screen reader can still announce that the control exists.\n\nThe mirror itself is in `willUpdate` below, here rather than in each\ncontrol, because here is where `disabled` is.",
+              "description": "Whether the control is disabled and cannot be used.\n\nReflected, because the styled tier selects on it, and mirrored to\n`aria-disabled` rather than removing the element from the accessibility\ntree, so a screen reader can still announce that the control exists.\n\nThe mirror itself is in `willUpdate` below, here rather than in each\ncontrol, because here is where `disabled` is.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -5120,7 +5180,7 @@
                   }
                 }
               ],
-              "description": "The platform's notice that an ancestor fieldset changed.\n\n**The argument is the effective state, and taking it whole is what latched\nevery control in the library.** The platform calls this for the element's\nown `disabled` as well as for a fieldset, and our own arrives here at the\nworst possible moment: reflecting `disabled` to the attribute happens\ninside Lit's `update()`, the UA fires this synchronously from that write,\nand a reactive write during an update is a change-in-update Lit does not\nre-render for. So `formDisabled` ran exactly one update behind forever.\n\nMeasured on Slider, logging what `render` saw:\n\n```\nset true    disabled true   formDisabled false  isDisabled true\nset false   disabled false  formDisabled true   isDisabled true   <- stale\n(no third render)\n```\n\nThe host came out right every time, `disabled` false, `:disabled` not\nmatching, and the inner control kept the attribute, so a control disabled\nonce could never be re-enabled. It only shows when something re-enables,\nwhich is the same shape of bug `inheritDisabled` was written for.\n\nOur own half is already in `this.disabled` and `isDisabled` is an or, so\nthis records only what the fieldset adds. That also removes the write\nentirely on the own-disabled path rather than moving it.\n\nThe one case this cannot see is a control that is disabled itself *and*\ninside a disabled fieldset, whose own `disabled` is then removed: the\neffective state does not change, so the platform does not call again, and\nthe fieldset's hold is not recorded. There is no callback to learn it from\nand reading `:disabled` here would answer about the attribute we are in the\nmiddle of removing."
+              "description": "Called by the browser when an ancestor fieldset is disabled or enabled.\n\n**The argument is the effective state, and taking it whole is what latched\nevery control in the library.** The platform calls this for the element's\nown `disabled` as well as for a fieldset, and our own arrives here at the\nworst possible moment: reflecting `disabled` to the attribute happens\ninside Lit's `update()`, the UA fires this synchronously from that write,\nand a reactive write during an update is a change-in-update Lit does not\nre-render for. So `formDisabled` ran exactly one update behind forever.\n\nMeasured on Slider, logging what `render` saw:\n\n```\nset true    disabled true   formDisabled false  isDisabled true\nset false   disabled false  formDisabled true   isDisabled true   <- stale\n(no third render)\n```\n\nThe host came out right every time, `disabled` false, `:disabled` not\nmatching, and the inner control kept the attribute, so a control disabled\nonce could never be re-enabled. It only shows when something re-enables,\nwhich is the same shape of bug `inheritDisabled` was written for.\n\nOur own half is already in `this.disabled` and `isDisabled` is an or, so\nthis records only what the fieldset adds. That also removes the write\nentirely on the own-disabled path rather than moving it.\n\nThe one case this cannot see is a control that is disabled itself *and*\ninside a disabled fieldset, whose own `disabled` is then removed: the\neffective state does not change, so the platform does not call again, and\nthe fieldset's hold is not recorded. There is no callback to learn it from\nand reading `:disabled` here would answer about the attribute we are in the\nmiddle of removing."
             },
             {
               "kind": "method",
@@ -5130,7 +5190,7 @@
                   "text": "void"
                 }
               },
-              "description": "The form was reset. Nothing here, and every override calls it.\n\n**A chain rather than a leaf**, because more than one layer owes a reset\nsomething: the value mixin its default, and the field mixin beneath it the\nforgetting of a reader's past attempt, whose message otherwise showed over\nthe emptied control the moment the form was reset."
+              "description": "Called by the browser when the form is reset. It does nothing here, and\nevery override calls it.\n\n**A chain rather than a leaf**, because more than one layer owes a reset\nsomething: the value mixin its default, and the field mixin beneath it the\nforgetting of a reader's past attempt, whose message otherwise showed over\nthe emptied control the moment the form was reset."
             },
             {
               "kind": "method",
@@ -5161,7 +5221,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Name submitted with the form.\n\n**Reflected, and it is the exception to \"reflect only what CSS selects\non\".** The platform builds a form's entry list from the `name` *content\nattribute*, not from the property, so a control named through the property\nsubmitted under no name at all and was silently dropped. Measured: two\ninputs in one form, one named by attribute and one by property, and the\nform carried a single entry.\n\nSafe for a React consumer, which is what the rule is protecting: React\nrenders a custom element's props as attributes on the server, so the name\nis already in the markup being hydrated and reflecting it writes what is\nthere. It is only a change to the markup when a consumer assigns it\nimperatively later, and nothing is hydrating by then.\n\nHere rather than on each control.",
+              "description": "The name the control's value is submitted under.\n\n**Reflected, and it is the exception to \"reflect only what CSS selects\non\".** The platform builds a form's entry list from the `name` *content\nattribute*, not from the property, so a control named through the property\nsubmitted under no name at all and was silently dropped. Measured: two\ninputs in one form, one named by attribute and one by property, and the\nform carried a single entry.\n\nSafe for a React consumer, which is what the rule is protecting: React\nrenders a custom element's props as attributes on the server, so the name\nis already in the markup being hydrated and reflecting it writes what is\nthere. It is only a change to the markup when a consumer assigns it\nimperatively later, and nothing is hydrating by then.\n\nHere rather than on each control.",
               "attribute": "name",
               "reflects": true
             },
@@ -5171,7 +5231,7 @@
               "type": {
                 "text": "HTMLFormElement | null"
               },
-              "description": "The form this control belongs to, if any.",
+              "description": "The form the control belongs to, or `null`.",
               "readonly": true,
               "helix": {
                 "references": [
@@ -5188,7 +5248,7 @@
               "type": {
                 "text": "NodeList"
               },
-              "description": "Labels associated with this control.",
+              "description": "The labels associated with the control.",
               "readonly": true,
               "helix": {
                 "references": [
@@ -5532,7 +5592,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the control is non-interactive.\n\nReflected, because the styled tier selects on it, and mirrored to\n`aria-disabled` rather than removing the element from the accessibility\ntree, so a screen reader can still announce that the control exists.\n\nThe mirror itself is in `willUpdate` below, here rather than in each\ncontrol, because here is where `disabled` is.",
+              "description": "Whether the control is disabled and cannot be used.\n\nReflected, because the styled tier selects on it, and mirrored to\n`aria-disabled` rather than removing the element from the accessibility\ntree, so a screen reader can still announce that the control exists.\n\nThe mirror itself is in `willUpdate` below, here rather than in each\ncontrol, because here is where `disabled` is.",
               "fieldName": "disabled"
             },
             {
@@ -5541,7 +5601,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Name submitted with the form.\n\n**Reflected, and it is the exception to \"reflect only what CSS selects\non\".** The platform builds a form's entry list from the `name` *content\nattribute*, not from the property, so a control named through the property\nsubmitted under no name at all and was silently dropped. Measured: two\ninputs in one form, one named by attribute and one by property, and the\nform carried a single entry.\n\nSafe for a React consumer, which is what the rule is protecting: React\nrenders a custom element's props as attributes on the server, so the name\nis already in the markup being hydrated and reflecting it writes what is\nthere. It is only a change to the markup when a consumer assigns it\nimperatively later, and nothing is hydrating by then.\n\nHere rather than on each control.",
+              "description": "The name the control's value is submitted under.\n\n**Reflected, and it is the exception to \"reflect only what CSS selects\non\".** The platform builds a form's entry list from the `name` *content\nattribute*, not from the property, so a control named through the property\nsubmitted under no name at all and was silently dropped. Measured: two\ninputs in one form, one named by attribute and one by property, and the\nform carried a single entry.\n\nSafe for a React consumer, which is what the rule is protecting: React\nrenders a custom element's props as attributes on the server, so the name\nis already in the markup being hydrated and reflecting it writes what is\nthere. It is only a change to the markup when a consumer assigns it\nimperatively later, and nothing is hydrating by then.\n\nHere rather than on each control.",
               "fieldName": "name"
             }
           ],
@@ -5558,7 +5618,7 @@
           },
           "cssStates": [
             {
-              "description": "Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.",
+              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
               "inheritedFrom": {
                 "name": "HelixElement",
@@ -6352,6 +6412,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMapClusterEvent",
+          "declaration": {
+            "name": "HelixMapClusterEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixMapPanEvent",
@@ -6360,6 +6428,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMapPartChangeEvent",
+          "declaration": {
+            "name": "HelixMapPartChangeEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixMapZoomEvent",
@@ -6512,6 +6588,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "MapClusterDetail",
+          "declaration": {
+            "name": "MapClusterDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "MapPanDetail",
@@ -6520,6 +6604,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "MapPartChangeDetail",
+          "declaration": {
+            "name": "MapPartChangeDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "MapZoomDetail",
@@ -7723,7 +7815,7 @@
           "name": "MixinChartSourceInterface",
           "cssProperties": [
             {
-              "description": "The color of the mark this is set on. Written by the component, read by the sheet that paints.",
+              "description": "The color of the mark it is set on. The component sets it, and the stylesheet reads it.",
               "name": "--chart-series"
             },
             {
@@ -7838,7 +7930,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The drawing's name, for a pointer resting on it.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written."
+              "description": "The chart's name, which starts the chart's text summary.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written."
             },
             {
               "kind": "field",
@@ -7846,7 +7938,7 @@
               "type": {
                 "text": "Series[]"
               },
-              "description": "The columns of the table, one series each, or none if there is no table.",
+              "description": "The table's columns, one series each. Empty when there is no table.",
               "readonly": true
             },
             {
@@ -7855,7 +7947,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What to call the drawing, the consumer's word or the table's own.",
+              "description": "The chart's name: `label` when it is set, and the table's caption\notherwise.",
               "readonly": true
             },
             {
@@ -7864,7 +7956,7 @@
               "type": {
                 "text": "Row[]"
               },
-              "description": "Every row of the table, with each cell's text as well as its number.",
+              "description": "Every row of the table, with each cell's text and number.",
               "readonly": true
             },
             {
@@ -7873,7 +7965,7 @@
               "type": {
                 "text": "number[]"
               },
-              "description": "Which cells of a row hold numbers, by their place in it, in table order.",
+              "description": "The positions of the cells in a row that hold numbers, in table order.",
               "readonly": true
             },
             {
@@ -7892,7 +7984,7 @@
                   }
                 }
               ],
-              "description": "The palette slot the cell at this place in a row is drawn in, or nothing\nwhere no series was read from that column."
+              "description": "The palette slot for the cell at this position in a row, or `undefined`\nwhen no series was read from that column."
             },
             {
               "kind": "field",
@@ -7900,7 +7992,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "How many readings there are, which is what the pointer maps onto.",
+              "description": "The number of readings, which the pointer position maps onto.",
               "readonly": true
             },
             {
@@ -7909,7 +8001,7 @@
               "type": {
                 "text": "ChartPointerController"
               },
-              "description": "Which reading a pointer is nearest, for a tooltip to sit on."
+              "description": "Finds the reading nearest the pointer, so the tooltip can sit on it."
             }
           ],
           "helix": {}
@@ -7932,7 +8024,7 @@
               "name": "pointer",
               "readonly": true,
               "default": "new ChartPointerController(this)",
-              "description": "Which reading a pointer is nearest, for a tooltip to sit on.\n\nPublic for the same reason `series` and `named` are: a protected member\ncannot be cast onto across unrelated classes, so it would be invisible to\nevery chart that needs it. Reading where a pointer is resting is a fair\nthing to ask a chart anyway."
+              "description": "Finds the reading nearest the pointer, so the tooltip can sit on it.\n\nPublic for the same reason `series` and `named` are: a protected member\ncannot be cast onto across unrelated classes, so it would be invisible to\nevery chart that needs it. Reading where a pointer is resting is a fair\nthing to ask a chart anyway."
             },
             {
               "kind": "field",
@@ -7951,7 +8043,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The drawing's name, for a pointer resting on it.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written.",
+              "description": "The chart's name, which starts the chart's text summary.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written.",
               "attribute": "label"
             },
             {
@@ -7960,7 +8052,7 @@
               "type": {
                 "text": "Series[]"
               },
-              "description": "The columns of the table, one series each, or none if there is no table.\n\nHeld by the controller between edits, so a render reading this five\ntimes parses the table once. See `SourceController.series`.",
+              "description": "The table's columns, one series each. Empty when there is no table.\n\nHeld by the controller between edits, so a render reading this five\ntimes parses the table once. See `SourceController.series`.",
               "readonly": true
             },
             {
@@ -7969,7 +8061,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What to call the drawing, the consumer's word or the table's own.\n\nThe fallback is the reason this is shared rather than copied: a caption is\nalready written, already the right words, and already the thing a reader\nof the table sees. A chart that made the consumer say it twice would be\nasking for the second one to drift.",
+              "description": "The chart's name: `label` when it is set, and the table's caption\notherwise.\n\nThe fallback is the reason this is shared rather than copied: a caption is\nalready written, already the right words, and already the thing a reader\nof the table sees. A chart that made the consumer say it twice would be\nasking for the second one to drift.",
               "readonly": true
             },
             {
@@ -7978,7 +8070,7 @@
               "type": {
                 "text": "Row[]"
               },
-              "description": "Every row of the table, with each cell's text as well as its number.\n\nThis is where a tooltip's content comes from, and it is deliberately not\n`series`. A chart draws numbers; a reader resting a pointer on one wants\nwhat the table says, which is `$128k` and not `128000`, and often wants\nthe column beside it that nothing plotted at all.\n\n**Not `rows`.** It is the source table's rows, and `rows` on a chart is a\nname a chart wants for itself: `helix-heatmap` takes `rows=\"7\"` to mean a\ncalendar week, and declaring that against a base class whose `rows` is a\n`Row[]` getter is a type error at best. Name the member for what it holds\nrather than for the shortest word available.",
+              "description": "Every row of the table, with each cell's text and number.\n\nThis is where a tooltip's content comes from, and it is deliberately not\n`series`. A chart draws numbers; a reader resting a pointer on one wants\nwhat the table says, which is `$128k` and not `128000`, and often wants\nthe column beside it that nothing plotted at all.\n\n**Not `rows`.** It is the source table's rows, and `rows` on a chart is a\nname a chart wants for itself: `helix-heatmap` takes `rows=\"7\"` to mean a\ncalendar week, and declaring that against a base class whose `rows` is a\n`Row[]` getter is a type error at best. Name the member for what it holds\nrather than for the shortest word available.",
               "readonly": true
             },
             {
@@ -7987,7 +8079,7 @@
               "type": {
                 "text": "number[]"
               },
-              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "description": "The positions of the cells in a row that hold numbers, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
               "readonly": true
             },
             {
@@ -8006,7 +8098,7 @@
                   }
                 }
               ],
-              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column."
+              "description": "The palette slot for the cell at this position in a row.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column."
             },
             {
               "kind": "field",
@@ -8014,7 +8106,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "How many readings there are, which is what the pointer maps onto.",
+              "description": "The number of readings, which the pointer position maps onto.",
               "readonly": true
             }
           ],
@@ -8034,7 +8126,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The drawing's name, for a pointer resting on it.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written.",
+              "description": "The chart's name, which starts the chart's text summary.\n\nAbsent falls back to the table's own caption, which is usually the right\nwords and is already written.",
               "fieldName": "label"
             }
           ],
@@ -8122,7 +8214,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the rows are still on their way."
+              "description": "Whether the rows are still loading."
             },
             {
               "kind": "field",
@@ -8130,7 +8222,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What is said while they are."
+              "description": "The text shown and announced while the rows load."
             },
             {
               "kind": "field",
@@ -8138,7 +8230,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What is said where there are none and none are coming."
+              "description": "The text shown and announced when there are no rows and none are loading."
             },
             {
               "kind": "method",
@@ -8232,7 +8324,7 @@
                 "text": "string"
               },
               "default": "'Nothing to show'",
-              "description": "What is said where there are none, and none are coming.",
+              "description": "The text shown and announced when there are no rows and none are loading.",
               "attribute": "empty-text"
             },
             {
@@ -8242,7 +8334,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the rows are still on their way.\n\nReflected, because a stylesheet needs it: the rows that are already there\nare dimmed rather than removed while a new set arrives, and only CSS can\nsay that without the component knowing what a row looks like.",
+              "description": "Whether the rows are still loading.\n\nReflected, because a stylesheet needs it: the rows that are already there\nare dimmed rather than removed while a new set arrives, and only CSS can\nsay that without the component knowing what a row looks like.",
               "attribute": "loading",
               "reflects": true
             },
@@ -8253,7 +8345,7 @@
                 "text": "string"
               },
               "default": "'Loading'",
-              "description": "What is said while they are on their way.",
+              "description": "The text shown and announced while the rows load.",
               "attribute": "loading-text"
             },
             {
@@ -8360,7 +8452,7 @@
                 "text": "string"
               },
               "default": "'Nothing to show'",
-              "description": "What is said where there are none, and none are coming.",
+              "description": "The text shown and announced when there are no rows and none are loading.",
               "fieldName": "emptyText"
             },
             {
@@ -8369,7 +8461,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the rows are still on their way.\n\nReflected, because a stylesheet needs it: the rows that are already there\nare dimmed rather than removed while a new set arrives, and only CSS can\nsay that without the component knowing what a row looks like.",
+              "description": "Whether the rows are still loading.\n\nReflected, because a stylesheet needs it: the rows that are already there\nare dimmed rather than removed while a new set arrives, and only CSS can\nsay that without the component knowing what a row looks like.",
               "fieldName": "loading"
             },
             {
@@ -8378,7 +8470,7 @@
                 "text": "string"
               },
               "default": "'Loading'",
-              "description": "What is said while they are on their way.",
+              "description": "The text shown and announced while the rows load.",
               "fieldName": "loadingText"
             }
           ],
@@ -8426,7 +8518,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Which item is current, by its `value`.\n\nReading gives the real one. Writing always applies, and is a seed and a\ncorrection rather than a claim of ownership: a consumer who wants the\ndecision refuses the `helix-before-activate`."
+              "description": "The `value` of the current item.\n\nReading gives the real one. Writing always applies, and is a seed and a\ncorrection rather than a claim of ownership: a consumer who wants the\ndecision refuses the `helix-before-activate`."
             },
             {
               "kind": "field",
@@ -8434,7 +8526,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Which item the markup declared current. Ignored once `active` is written."
+              "description": "The `value` of the item declared current in markup. Ignored once `active`\nis written."
             },
             {
               "kind": "method",
@@ -8452,7 +8544,7 @@
                   }
                 }
               ],
-              "description": "Requests a new current item, and reports whether the request stood."
+              "description": "Requests a new current item, and returns whether the change was applied."
             },
             {
               "kind": "method",
@@ -8487,7 +8579,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Which item is current, by its `value`.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "description": "The `value` of the current item.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
               "attribute": "active"
             },
             {
@@ -8497,7 +8589,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
+              "description": "The `value` of the item declared current in markup.\n\nIgnored once `active` is written.",
               "attribute": "default-active"
             },
             {
@@ -8526,7 +8618,7 @@
                   }
                 }
               ],
-              "description": "Requests a new current item, and reports whether the request stood.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction."
+              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction."
             },
             {
               "kind": "method",
@@ -8580,7 +8672,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Which item is current, by its `value`.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "description": "The `value` of the current item.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
               "fieldName": "active"
             },
             {
@@ -8589,7 +8681,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
+              "description": "The `value` of the item declared current in markup.\n\nIgnored once `active` is written.",
               "fieldName": "defaultActive"
             }
           ],
@@ -8645,7 +8737,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the markup declared it checked, which is where a reset returns to."
+              "description": "Whether the control starts checked. A form reset returns it to this state."
             },
             {
               "kind": "method",
@@ -8663,7 +8755,7 @@
                   }
                 }
               ],
-              "description": "Requests a checked change, and reports whether it was applied.\n\nAnnounces before it acts: a listener calling `preventDefault()` on the\n`helix-before-toggle` refuses the change, and nothing moves."
+              "description": "Requests a change to `checked`, and returns whether it was applied.\n\nAnnounces before it acts: a listener calling `preventDefault()` on the\n`helix-before-toggle` refuses the change, and nothing moves."
             },
             {
               "kind": "method",
@@ -8709,7 +8801,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the markup declared it checked, which is where a reset returns to.",
+              "description": "Whether the control starts checked. A form reset returns it to this state.",
               "attribute": "default-checked"
             },
             {
@@ -8738,7 +8830,7 @@
                   }
                 }
               ],
-              "description": "Requests a checked change, and reports whether it was applied.\n\nAnnounces before it acts, so `preventDefault()` on the\n`helix-before-toggle` is a refusal and nothing moves. Nobody refusing\nmeans the element updates itself, whether or not a consumer declared the\nproperty: a declared property is a seed and a correction, the way\n`<input value>` is, and a consumer who wants the change for themselves\nrefuses it and assigns their own."
+              "description": "Requests a change to `checked`, and returns whether it was applied.\n\nAnnounces before it acts, so `preventDefault()` on the\n`helix-before-toggle` is a refusal and nothing moves. Nobody refusing\nmeans the element updates itself, whether or not a consumer declared the\nproperty: a declared property is a seed and a correction, the way\n`<input value>` is, and a consumer who wants the change for themselves\nrefuses it and assigns their own."
             },
             {
               "kind": "method",
@@ -8802,7 +8894,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the markup declared it checked, which is where a reset returns to.",
+              "description": "Whether the control starts checked. A form reset returns it to this state.",
               "fieldName": "defaultChecked"
             }
           ],
@@ -8850,7 +8942,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the markup declared it open. Ignored once `open` is written."
+              "description": "Whether the element starts open. Ignored once `open` is written."
             },
             {
               "kind": "field",
@@ -8876,7 +8968,7 @@
                   }
                 }
               ],
-              "description": "Requests an open-state change, and reports whether it was applied.\n\nAnnounces before it acts: a listener calling `preventDefault()` on the\n`helix-before-open` or `helix-before-close` refuses the change, and nothing moves."
+              "description": "Requests that the element open or close, and returns whether the change was\napplied.\n\nAnnounces before it acts: a listener calling `preventDefault()` on the\n`helix-before-open` or `helix-before-close` refuses the change, and nothing moves."
             },
             {
               "kind": "method",
@@ -8903,7 +8995,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "description": "Whether the element starts open. Ignored once `open` is written.",
               "attribute": "default-open"
             },
             {
@@ -8941,7 +9033,7 @@
                   }
                 }
               ],
-              "description": "Requests an open-state change, and reports whether it was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-open` or\n`helix-before-close` is a refusal and nothing moves. Nobody refusing means the\nelement opens or closes itself, whether or not a consumer declared\n`open`: a declared property is a seed and a correction, and a consumer\nwho wants the decision for themselves refuses it and assigns their own."
+              "description": "Requests that the element open or close, and returns whether the change\nwas applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-open` or\n`helix-before-close` is a refusal and nothing moves. Nobody refusing means the\nelement opens or closes itself, whether or not a consumer declared\n`open`: a declared property is a seed and a correction, and a consumer\nwho wants the decision for themselves refuses it and assigns their own."
             },
             {
               "kind": "method",
@@ -8980,7 +9072,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "description": "Whether the element starts open. Ignored once `open` is written.",
               "fieldName": "defaultOpen"
             },
             {
@@ -9036,7 +9128,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The value the markup declared, which is where a reset returns to.\n\nSeparate from `value`, which is where the control is now, and gone from the\nreader's view the moment they change anything."
+              "description": "The value the control starts with. A form reset returns it to this value.\n\nSeparate from `value`, which is where the control is now, and gone from the\nreader's view the moment they change anything."
             },
             {
               "kind": "field",
@@ -9044,7 +9136,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control holds now, and what its form submits.\n\nReading gives the real value. Writing always applies, and is a seed and a\ncorrection rather than a claim of ownership: a consumer who wants the\ndecision refuses the `helix-before-change`."
+              "description": "The control's current value, which its form submits.\n\nReading gives the real value. Writing always applies, and is a seed and a\ncorrection rather than a claim of ownership: a consumer who wants the\ndecision refuses the `helix-before-change`."
             },
             {
               "kind": "field",
@@ -9072,7 +9164,7 @@
                   }
                 }
               ],
-              "description": "Requests a new value, and reports whether the request stood."
+              "description": "Requests a new value, and returns whether the change was applied."
             },
             {
               "kind": "method",
@@ -9082,7 +9174,7 @@
                   "text": "void"
                 }
               },
-              "description": "Returns the control to the value its markup declared."
+              "description": "Returns the control to its `defaultValue`."
             },
             {
               "kind": "method",
@@ -9117,7 +9209,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The value the markup declared, which is where a reset returns to.",
+              "description": "The value the control starts with. A form reset returns it to this value.",
               "attribute": "default-value"
             },
             {
@@ -9126,7 +9218,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control holds now, and what its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
+              "description": "The control's current value, which its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
               "attribute": "value"
             },
             {
@@ -9177,7 +9269,7 @@
                   }
                 }
               ],
-              "description": "Requests a new value, and reports whether the request stood.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-change` is\na refusal and nothing moves. Nobody refusing means the control updates\nitself, whether or not a consumer declared `value`: a declared property\nis a seed and a correction, the way `<input value>` is, and a consumer\nwho wants the change for themselves refuses it and assigns their own."
+              "description": "Requests a new value, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-change` is\na refusal and nothing moves. Nobody refusing means the control updates\nitself, whether or not a consumer declared `value`: a declared property\nis a seed and a correction, the way `<input value>` is, and a consumer\nwho wants the change for themselves refuses it and assigns their own."
             },
             {
               "kind": "method",
@@ -9187,7 +9279,7 @@
                   "text": "void"
                 }
               },
-              "description": "Returns the control to the value its markup declared.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value."
+              "description": "Returns the control to its `defaultValue`.\n\nBoth halves are dropped, the consumer's and the control's, because a\nreset means the form is as it was served. Clearing only the internal one\nwould leave a control that had been written to stuck at that value."
             },
             {
               "kind": "method",
@@ -9215,7 +9307,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The value the markup declared, which is where a reset returns to.",
+              "description": "The value the control starts with. A form reset returns it to this value.",
               "fieldName": "defaultValue"
             },
             {
@@ -9223,7 +9315,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control holds now, and what its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
+              "description": "The control's current value, which its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
               "fieldName": "value"
             }
           ],
@@ -9271,7 +9363,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether it offers a control to take it away."
+              "description": "Whether the element shows a control that dismisses it."
             },
             {
               "kind": "field",
@@ -9279,7 +9371,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Accessible name for that control."
+              "description": "The dismiss control's label, read by screen readers."
             },
             {
               "kind": "method",
@@ -9289,7 +9381,7 @@
                   "text": "boolean"
                 }
               },
-              "description": "Announces that it should go, and reports whether the request stood."
+              "description": "Fires `helix-dismiss`, and returns `false` if a listener cancels it."
             },
             {
               "kind": "method",
@@ -9317,7 +9409,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether it offers a control to take it away.",
+              "description": "Whether the element shows a control that dismisses it.",
               "attribute": "dismissible",
               "reflects": true
             },
@@ -9328,7 +9420,7 @@
                 "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.",
+              "description": "The dismiss control's label, read by screen readers.\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"
             },
             {
@@ -9350,7 +9442,7 @@
                   "text": "boolean"
                 }
               },
-              "description": "Announces that it should go, and reports whether the request stood."
+              "description": "Fires `helix-dismiss`, and returns `false` if a listener cancels it."
             }
           ],
           "attributes": [
@@ -9360,7 +9452,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether it offers a control to take it away.",
+              "description": "Whether the element shows a control that dismisses it.",
               "fieldName": "dismissible"
             },
             {
@@ -9369,7 +9461,7 @@
                 "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.",
+              "description": "The dismiss control's label, read by screen readers.\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"
             }
           ],
@@ -9445,7 +9537,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Help under the control, shown while there is nothing wrong.\n\nFallback content for the `hint` slot, so anything richer replaces it."
+              "description": "Help text shown under the control. A validation message replaces it.\n\nFallback content for the `hint` slot, so anything richer replaces it."
             },
             {
               "kind": "field",
@@ -9462,7 +9554,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What is wrong, in the reader's words rather than the browser's.\n\nOverrides the platform's message. Left empty, the platform's own is shown\nonce the reader has had a go at the field, never before. Either way it\ntakes the hint's place rather than appearing under it."
+              "description": "The validation message shown under the control. It replaces the browser's\nmessage.\n\nOverrides the platform's message. Left empty, the platform's own is shown\nonce the reader has had a go at the field, never before. Either way it\ntakes the hint's place rather than appearing under it."
             },
             {
               "kind": "field",
@@ -9470,7 +9562,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The accessible name, and the fallback for the `label` slot.\n\nContent rather than configuration, so it is the slot's fallback and never a\nsecond thing rendered beside it."
+              "description": "The field's label, which is also its accessible name. Content in the\n`label` slot replaces it.\n\nContent rather than configuration, so it is the slot's fallback and never a\nsecond thing rendered beside it."
             },
             {
               "kind": "method",
@@ -9533,7 +9625,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the form refuses to submit without it."
+              "description": "Whether the field needs a value before the form can submit."
             },
             {
               "kind": "method",
@@ -9603,7 +9695,7 @@
                 "text": "string"
               },
               "readonly": true,
-              "description": "The message actually shown: the consumer's, or the platform's, or none."
+              "description": "The validation message shown: yours, the browser's, or none."
             },
             {
               "kind": "field",
@@ -9611,7 +9703,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field is required and empty, where the page says."
+              "description": "The message shown when the field is required and empty."
             }
           ],
           "helix": {}
@@ -9658,7 +9750,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "What is wrong, in the reader's words rather than the browser's.",
+              "description": "The validation message shown under the control. It replaces the\nbrowser's message.",
               "attribute": "feedback"
             },
             {
@@ -9668,7 +9760,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Help under the control, shown while there is nothing wrong.",
+              "description": "Help text shown under the control. A validation message replaces it.",
               "attribute": "hint"
             },
             {
@@ -9678,7 +9770,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The accessible name, and the fallback for the `label` slot.",
+              "description": "The field's label, which is also its accessible name. Content in the\n`label` slot replaces it.",
               "attribute": "label"
             },
             {
@@ -9688,7 +9780,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the form refuses to submit without it.",
+              "description": "Whether the field needs a value before the form can submit.",
               "attribute": "required",
               "reflects": true
             },
@@ -9698,7 +9790,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field is required and empty, where the\npage says.\n\n**Absent, or empty, is the control's own sentence**, \"Choose one to continue.\" on a\nset and the browser's own on a text field, which the browser writes in\nthe reader's language. Every other word a control speaks is a property,\nand this one was the English a form in another language still spoke in\nthe bubble it raises on submit: `feedback` replaces the message under\nthe field and does not reach that one.",
+              "description": "The message shown when the field is required and empty.\n\n**Absent, or empty, is the control's own sentence**, \"Choose one to continue.\" on a\nset and the browser's own on a text field, which the browser writes in\nthe reader's language. Every other word a control speaks is a property,\nand this one was the English a form in another language still spoke in\nthe bubble it raises on submit: `feedback` replaces the message under\nthe field and does not reach that one.",
               "attribute": "value-missing-message"
             },
             {
@@ -9855,7 +9947,7 @@
                   "text": "void"
                 }
               },
-              "description": "Forgets the reader's attempts along with the value, so an emptied field\nis not wrong until they try again.\n\nThrough the base's prototype rather than `super`, because the base this\ngrafts onto is any element and only a form element has the hook."
+              "description": "Clears the record of the user's edits along with the value, so the field\nshows no error until they edit it again.\n\nThrough the base's prototype rather than `super`, because the base this\ngrafts onto is any element and only a form element has the hook."
             }
           ],
           "attributes": [
@@ -9865,7 +9957,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "What is wrong, in the reader's words rather than the browser's.",
+              "description": "The validation message shown under the control. It replaces the\nbrowser's message.",
               "fieldName": "feedback"
             },
             {
@@ -9874,7 +9966,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Help under the control, shown while there is nothing wrong.",
+              "description": "Help text shown under the control. A validation message replaces it.",
               "fieldName": "hint"
             },
             {
@@ -9883,7 +9975,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The accessible name, and the fallback for the `label` slot.",
+              "description": "The field's label, which is also its accessible name. Content in the\n`label` slot replaces it.",
               "fieldName": "label"
             },
             {
@@ -9892,7 +9984,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the form refuses to submit without it.",
+              "description": "Whether the field needs a value before the form can submit.",
               "fieldName": "required"
             },
             {
@@ -9900,7 +9992,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field is required and empty, where the\npage says.\n\n**Absent, or empty, is the control's own sentence**, \"Choose one to continue.\" on a\nset and the browser's own on a text field, which the browser writes in\nthe reader's language. Every other word a control speaks is a property,\nand this one was the English a form in another language still spoke in\nthe bubble it raises on submit: `feedback` replaces the message under\nthe field and does not reach that one.",
+              "description": "The message shown when the field is required and empty.\n\n**Absent, or empty, is the control's own sentence**, \"Choose one to continue.\" on a\nset and the browser's own on a text field, which the browser writes in\nthe reader's language. Every other word a control speaks is a property,\nand this one was the English a form in another language still spoke in\nthe bubble it raises on submit: `feedback` replaces the message under\nthe field and does not reach that one.",
               "fieldName": "valueMissingMessage"
             }
           ],
@@ -9977,7 +10069,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the control refuses changes while still submitting its value."
+              "description": "Whether the value is locked. A read-only control still submits its value."
             },
             {
               "kind": "method",
@@ -9995,7 +10087,7 @@
                   }
                 }
               ],
-              "description": "Refuses every change while read-only. See `readOnly`."
+              "description": "Requests a new value. While `readOnly` is set, nothing changes and it\nreturns `false`."
             }
           ],
           "helix": {}
@@ -10012,7 +10104,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the control refuses changes while still submitting its value.\n\n**Enforced by refusing every request in one place**, which is the seam this\ncomponent already has: `requestValue` is what every path here comes through,\nand gating it once is what stops the next call site from being written\nwithout the check.\n\nNot `disabled`, which is the confusion worth naming: a disabled control\nsubmits nothing and leaves the tab order, and a read-only one submits its\nvalue and stays reachable, which is what a form showing a value somebody\nelse set needs.",
+              "description": "Whether the value is locked. A read-only control still submits its value.\n\n**Enforced by refusing every request in one place**, which is the seam this\ncomponent already has: `requestValue` is what every path here comes through,\nand gating it once is what stops the next call site from being written\nwithout the check.\n\nNot `disabled`, which is the confusion worth naming: a disabled control\nsubmits nothing and leaves the tab order, and a read-only one submits its\nvalue and stays reachable, which is what a form showing a value somebody\nelse set needs.",
               "attribute": "readonly",
               "reflects": true
             },
@@ -10042,7 +10134,7 @@
                   }
                 }
               ],
-              "description": "Refuses every change while read-only. See `readOnly`."
+              "description": "Requests a new value. While `readOnly` is set, nothing changes and it\nreturns `false`."
             },
             {
               "kind": "field",
@@ -10066,7 +10158,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the control refuses changes while still submitting its value.\n\n**Enforced by refusing every request in one place**, which is the seam this\ncomponent already has: `requestValue` is what every path here comes through,\nand gating it once is what stops the next call site from being written\nwithout the check.\n\nNot `disabled`, which is the confusion worth naming: a disabled control\nsubmits nothing and leaves the tab order, and a read-only one submits its\nvalue and stays reachable, which is what a form showing a value somebody\nelse set needs.",
+              "description": "Whether the value is locked. A read-only control still submits its value.\n\n**Enforced by refusing every request in one place**, which is the seam this\ncomponent already has: `requestValue` is what every path here comes through,\nand gating it once is what stops the next call site from being written\nwithout the check.\n\nNot `disabled`, which is the confusion worth naming: a disabled control\nsubmits nothing and leaves the tab order, and a read-only one submits its\nvalue and stays reachable, which is what a form showing a value somebody\nelse set needs.",
               "fieldName": "readOnly"
             }
           ],
@@ -10114,7 +10206,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field holds something the picker cannot read."
+              "description": "The message shown when the field holds text the picker cannot read."
             },
             {
               "kind": "field",
@@ -10173,7 +10265,7 @@
                   }
                 }
               ],
-              "description": "Puts the caret in the field, the way a label pointing at one would."
+              "description": "Puts the caret in the field, as clicking its label does."
             },
             {
               "kind": "field",
@@ -10281,7 +10373,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field holds something the picker cannot\nread: a date that is not one, a time, a color.\n\n**Every sentence a control raises in the browser's bubble is a\nproperty**, named for the validity flag it reports, so a form in another\nlanguage speaks it. Absent is the family's own sentence, in English,\nwhich says what the value should look like.",
+              "description": "The message shown when the field holds text the picker cannot read as a\ndate, a time, or a color.\n\n**Every sentence a control raises in the browser's bubble is a\nproperty**, named for the validity flag it reports, so a form in another\nlanguage speaks it. Absent is the family's own sentence, in English,\nwhich says what the value should look like.",
               "attribute": "bad-input-message"
             },
             {
@@ -10429,7 +10521,7 @@
                   }
                 }
               ],
-              "description": "Puts the caret in the field, the way a label pointing at one would."
+              "description": "Puts the caret in the field, as clicking its label does."
             }
           ],
           "attributes": [
@@ -10438,7 +10530,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What a reader is told when the field holds something the picker cannot\nread: a date that is not one, a time, a color.\n\n**Every sentence a control raises in the browser's bubble is a\nproperty**, named for the validity flag it reports, so a form in another\nlanguage speaks it. Absent is the family's own sentence, in English,\nwhich says what the value should look like.",
+              "description": "The message shown when the field holds text the picker cannot read as a\ndate, a time, or a color.\n\n**Every sentence a control raises in the browser's bubble is a\nproperty**, named for the validity flag it reports, so a form in another\nlanguage speaks it. Absent is the family's own sentence, in English,\nwhich says what the value should look like.",
               "fieldName": "badInputMessage"
             }
           ],
@@ -10486,7 +10578,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether this one can be chosen."
+              "description": "Whether the item is disabled and cannot be chosen."
             },
             {
               "kind": "method",
@@ -10496,7 +10588,7 @@
                   "text": "void"
                 }
               },
-              "description": "Moves focus to the control this renders, for the set's arrow keys."
+              "description": "Moves focus to the item's control, for the set's arrow keys."
             },
             {
               "kind": "field",
@@ -10515,7 +10607,7 @@
                   "text": "boolean"
                 }
               },
-              "description": "Chooses this one and announces it, and reports whether the request stood.\n\n`MixinDismissible.dismiss` next door has the same shape and for the same\nreason: a mixin has no family, so the answer to a cancelable event it\ndispatches is read at the dispatch or nowhere. The set acting on the choice\noffers the second refusal on its own root."
+              "description": "Selects the item and fires `helix-select`. Returns `false` if the item is\ndisabled or a listener cancels the event.\n\n`MixinDismissible.dismiss` next door has the same shape and for the same\nreason: a mixin has no family, so the answer to a cancelable event it\ndispatches is read at the dispatch or nowhere. The set acting on the choice\noffers the second refusal on its own root."
             },
             {
               "kind": "field",
@@ -10523,7 +10615,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether this is the current one. Written by the set."
+              "description": "Whether the item is selected. The parent set updates it."
             },
             {
               "kind": "field",
@@ -10531,7 +10623,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Identifies this one to the set, and is what a form submits."
+              "description": "The item's value, which identifies it in its set and is what a form\nsubmits."
             }
           ],
           "helix": {}
@@ -10548,7 +10640,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this one can be chosen.",
+              "description": "Whether the item is disabled and cannot be chosen.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -10559,7 +10651,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "description": "Whether the item is selected.\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"
             },
             {
@@ -10569,7 +10661,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies this one to the set, and is what a form submits.",
+              "description": "The item's value, which identifies it in its set and is what a form\nsubmits.",
               "attribute": "value"
             },
             {
@@ -10590,7 +10682,7 @@
                   "text": "void"
                 }
               },
-              "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."
+              "description": "Moves focus to the item's control, 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."
             },
             {
               "kind": "method",
@@ -10600,7 +10692,7 @@
                   "text": "boolean"
                 }
               },
-              "description": "Chooses this one and announces it, and reports whether it stood."
+              "description": "Selects the item and fires `helix-select`. Returns `false` if the item is\ndisabled or a listener cancels the event."
             }
           ],
           "attributes": [
@@ -10610,7 +10702,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this one can be chosen.",
+              "description": "Whether the item is disabled and cannot be chosen.",
               "fieldName": "disabled"
             },
             {
@@ -10619,7 +10711,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether this is the current one.\n\nWritten by the set rather than by a consumer, which is why it takes no\ndefault from an attribute here: a family whose selection a consumer\ndeclares in markup carries `defaultSelected` of its own to say so.",
+              "description": "Whether the item is selected.\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"
             },
             {
@@ -10628,7 +10720,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Identifies this one to the set, and is what a form submits.",
+              "description": "The item's value, which identifies it in its set and is what a form\nsubmits.",
               "fieldName": "value"
             }
           ],
@@ -10684,7 +10776,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the count is a control that shows the rest.\n\n**Off by default, and that is about focus rather than caution.** The count\nbecomes a real button when this is set, which is a new stop in the tab\norder inside the field. Combobox's whole arrangement is that focus stays in\nthe text while the arrows work the list, so a button appearing between the\ntags and the caret is a change to its keyboard model and not a detail. A\nhost that wants it asks.\n\nLeft off, the count stays the `<span>` it has always been: no tab stop, no\nbehavior, and nothing a consumer is holding changes."
+              "description": "Whether the count is a button that shows the hidden tokens.\n\n**Off by default, and that is about focus rather than caution.** The count\nbecomes a real button when this is set, which is a new stop in the tab\norder inside the field. Combobox's whole arrangement is that focus stays in\nthe text while the arrows work the list, so a button appearing between the\ntags and the caret is a change to its keyboard model and not a detail. A\nhost that wants it asks.\n\nLeft off, the count stays the `<span>` it has always been: no tab stop, no\nbehavior, and nothing a consumer is holding changes."
             },
             {
               "kind": "field",
@@ -10692,7 +10784,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the collapsed count is called, since `+3` names nothing."
+              "description": "The count button's label, read by screen readers. Its visible text, such\nas `+3`, does not say what it does."
             },
             {
               "kind": "field",
@@ -10700,7 +10792,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control is called once everything is showing.\n\n**The name and not the words on it**, which are a caret: expanded there is\nno longer a number to show, and a phrase in its place would translate badly\nand change the control's width as it was pressed. The mark is the same size\neither way and this is what says what pressing it does."
+              "description": "The button's label, read by screen readers, once every token is showing.\n\n**The name and not the words on it**, which are a caret: expanded there is\nno longer a number to show, and a phrase in its place would translate badly\nand change the control's width as it was pressed. The mark is the same size\neither way and this is what says what pressing it does."
             },
             {
               "kind": "field",
@@ -10807,7 +10899,7 @@
                 "text": "string"
               },
               "default": "'Show fewer'",
-              "description": "What the control is called once everything is showing.",
+              "description": "The button's label, read by screen readers, once every token is showing.",
               "attribute": "collapse-label"
             },
             {
@@ -10817,7 +10909,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the count is a control that shows the rest.",
+              "description": "Whether the count is a button that shows the hidden tokens.",
               "attribute": "expandable"
             },
             {
@@ -10827,7 +10919,7 @@
                 "text": "string"
               },
               "default": "'Show all'",
-              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "description": "The count button's label, read by screen readers. Its visible text, such\nas `+3`, does not say what it does.",
               "attribute": "expand-label"
             },
             {
@@ -10969,7 +11061,7 @@
                 "text": "string"
               },
               "default": "'Show fewer'",
-              "description": "What the control is called once everything is showing.",
+              "description": "The button's label, read by screen readers, once every token is showing.",
               "fieldName": "collapseLabel"
             },
             {
@@ -10978,7 +11070,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the count is a control that shows the rest.",
+              "description": "Whether the count is a button that shows the hidden tokens.",
               "fieldName": "expandable"
             },
             {
@@ -10987,7 +11079,7 @@
                 "text": "string"
               },
               "default": "'Show all'",
-              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "description": "The count button's label, read by screen readers. Its visible text, such\nas `+3`, does not say what it does.",
               "fieldName": "expandLabel"
             },
             {
@@ -11044,7 +11136,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which of the controls the surface draws, as a list of what to keep."
+              "description": "Which controls to show, as a list of `pan`, `zoom`, and `fullscreen`, or `none`."
             },
             {
               "kind": "field",
@@ -11060,7 +11152,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that fills the screen is called."
+              "description": "The fullscreen button's label."
             },
             {
               "kind": "field",
@@ -11068,7 +11160,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "How long the reader may be still before the chrome hides, in milliseconds."
+              "description": "How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible."
             },
             {
               "kind": "field",
@@ -11076,7 +11168,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that pans down is called."
+              "description": "The pan down button's label."
             },
             {
               "kind": "field",
@@ -11084,7 +11176,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that pans left is called."
+              "description": "The pan left button's label."
             },
             {
               "kind": "field",
@@ -11092,7 +11184,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that pans right is called."
+              "description": "The pan right button's label."
             },
             {
               "kind": "field",
@@ -11100,7 +11192,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "How far one press moves the view, as a fraction of what is on screen."
+              "description": "How far one press pans the view, as a fraction of its size."
             },
             {
               "kind": "field",
@@ -11108,7 +11200,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that pans up is called."
+              "description": "The pan up button's label."
             },
             {
               "kind": "field",
@@ -11116,7 +11208,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that zooms in is called."
+              "description": "The zoom in button's label."
             },
             {
               "kind": "field",
@@ -11124,7 +11216,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "What the control that zooms out is called."
+              "description": "The zoom out button's label."
             },
             {
               "kind": "method",
@@ -11142,7 +11234,7 @@
                   }
                 }
               ],
-              "description": "Asks for the view to move, which the consumer answers."
+              "description": "Pans the view one step in a direction."
             },
             {
               "kind": "method",
@@ -11160,7 +11252,7 @@
                   }
                 }
               ],
-              "description": "Asks for the view to zoom, `1` in and `-1` out."
+              "description": "Zooms the view one step: `1` zooms in and `-1` zooms out."
             },
             {
               "kind": "method",
@@ -11170,7 +11262,7 @@
                   "text": "void"
                 }
               },
-              "description": "Fills the screen with the surface, or comes back."
+              "description": "Turns fullscreen on or off."
             },
             {
               "kind": "field",
@@ -11225,7 +11317,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What the group of controls is called, where the page says."
+              "description": "The name of the group of controls, read by screen readers."
             },
             {
               "kind": "field",
@@ -11320,7 +11412,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which of the controls this surface draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: all three for a map, whose\nreader may have no other way to move it, and zoom and fullscreen for a\nboard, which a reader drags and whose pad took a third of the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
+              "description": "Which controls to show, as a list of `pan`, `zoom`, and `fullscreen`, or `none`.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: all three for a map, whose\nreader may have no other way to move it, and zoom and fullscreen for a\nboard, which a reader drags and whose pad took a third of the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
               "attribute": "controls",
               "reflects": true
             },
@@ -11330,7 +11422,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What the group of controls is called, for a reader who meets it.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
+              "description": "The name of the group of controls, read by screen readers.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
               "attribute": "controls-label"
             },
             {
@@ -11350,7 +11442,7 @@
                 "text": "string"
               },
               "default": "'Fill the screen'",
-              "description": "What the control that fills the screen is called.",
+              "description": "The fullscreen button's label.",
               "attribute": "fullscreen-label"
             },
             {
@@ -11360,7 +11452,7 @@
                 "text": "number"
               },
               "default": "0",
-              "description": "How long the reader may be still before the chrome hides, in milliseconds.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
+              "description": "How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
               "attribute": "idle-delay"
             },
             {
@@ -11370,7 +11462,7 @@
                 "text": "string"
               },
               "default": "'Pan down'",
-              "description": "What the control that pans down is called.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
+              "description": "The pan down button's label.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
               "attribute": "pan-down-label"
             },
             {
@@ -11380,7 +11472,7 @@
                 "text": "string"
               },
               "default": "'Pan left'",
-              "description": "What the control that pans left is called, on screen.",
+              "description": "The pan left button's label.",
               "attribute": "pan-left-label"
             },
             {
@@ -11390,7 +11482,7 @@
                 "text": "string"
               },
               "default": "'Pan right'",
-              "description": "What the control that pans right is called, on screen.",
+              "description": "The pan right button's label.",
               "attribute": "pan-right-label"
             },
             {
@@ -11400,7 +11492,7 @@
                 "text": "number"
               },
               "default": "0.25",
-              "description": "How far one press moves the view, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
+              "description": "How far one press pans the view, as a fraction of its size.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
               "attribute": "pan-step"
             },
             {
@@ -11410,7 +11502,7 @@
                 "text": "string"
               },
               "default": "'Pan up'",
-              "description": "What the control that pans up is called.",
+              "description": "The pan up button's label.",
               "attribute": "pan-up-label"
             },
             {
@@ -11420,7 +11512,7 @@
                 "text": "string"
               },
               "default": "'Zoom in'",
-              "description": "What the control that zooms in is called.",
+              "description": "The zoom in button's label.",
               "attribute": "zoom-in-label"
             },
             {
@@ -11464,7 +11556,7 @@
                 "text": "string"
               },
               "default": "'Zoom out'",
-              "description": "What the control that zooms out is called.",
+              "description": "The zoom out button's label.",
               "attribute": "zoom-out-label"
             },
             {
@@ -11531,7 +11623,7 @@
                   }
                 }
               ],
-              "description": "Asks for the view to move, which the consumer answers."
+              "description": "Pans the view one step in a direction."
             },
             {
               "kind": "method",
@@ -11549,7 +11641,7 @@
                   }
                 }
               ],
-              "description": "Asks for the view to zoom, `1` in and `-1` out."
+              "description": "Zooms the view one step: `1` zooms in and `-1` zooms out."
             },
             {
               "kind": "method",
@@ -11559,7 +11651,7 @@
                   "text": "void"
                 }
               },
-              "description": "Fills the screen with the surface, or comes back."
+              "description": "Turns fullscreen on or off."
             },
             {
               "kind": "field",
@@ -11692,7 +11784,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which of the controls this surface draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: all three for a map, whose\nreader may have no other way to move it, and zoom and fullscreen for a\nboard, which a reader drags and whose pad took a third of the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
+              "description": "Which controls to show, as a list of `pan`, `zoom`, and `fullscreen`, or `none`.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: all three for a map, whose\nreader may have no other way to move it, and zoom and fullscreen for a\nboard, which a reader drags and whose pad took a third of the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
               "fieldName": "controls"
             },
             {
@@ -11700,7 +11792,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "What the group of controls is called, for a reader who meets it.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
+              "description": "The name of the group of controls, read by screen readers.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
               "fieldName": "controlsLabel"
             },
             {
@@ -11717,7 +11809,7 @@
                 "text": "string"
               },
               "default": "'Fill the screen'",
-              "description": "What the control that fills the screen is called.",
+              "description": "The fullscreen button's label.",
               "fieldName": "fullscreenLabel"
             },
             {
@@ -11726,7 +11818,7 @@
                 "text": "number"
               },
               "default": "0",
-              "description": "How long the reader may be still before the chrome hides, in milliseconds.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
+              "description": "How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
               "fieldName": "idleDelay"
             },
             {
@@ -11735,7 +11827,7 @@
                 "text": "string"
               },
               "default": "'Pan down'",
-              "description": "What the control that pans down is called.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
+              "description": "The pan down button's label.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
               "fieldName": "panDownLabel"
             },
             {
@@ -11744,7 +11836,7 @@
                 "text": "string"
               },
               "default": "'Pan left'",
-              "description": "What the control that pans left is called, on screen.",
+              "description": "The pan left button's label.",
               "fieldName": "panLeftLabel"
             },
             {
@@ -11753,7 +11845,7 @@
                 "text": "string"
               },
               "default": "'Pan right'",
-              "description": "What the control that pans right is called, on screen.",
+              "description": "The pan right button's label.",
               "fieldName": "panRightLabel"
             },
             {
@@ -11762,7 +11854,7 @@
                 "text": "number"
               },
               "default": "0.25",
-              "description": "How far one press moves the view, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
+              "description": "How far one press pans the view, as a fraction of its size.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
               "fieldName": "panStep"
             },
             {
@@ -11771,7 +11863,7 @@
                 "text": "string"
               },
               "default": "'Pan up'",
-              "description": "What the control that pans up is called.",
+              "description": "The pan up button's label.",
               "fieldName": "panUpLabel"
             },
             {
@@ -11780,7 +11872,7 @@
                 "text": "string"
               },
               "default": "'Zoom in'",
-              "description": "What the control that zooms in is called.",
+              "description": "The zoom in button's label.",
               "fieldName": "zoomInLabel"
             },
             {
@@ -11789,7 +11881,7 @@
                 "text": "string"
               },
               "default": "'Zoom out'",
-              "description": "What the control that zooms out is called.",
+              "description": "The zoom out button's label.",
               "fieldName": "zoomOutLabel"
             }
           ],