@fusion.dev/helix-core 0.103.3 → 0.104.0

package/custom-elements.json

@@ -107,6 +107,86 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/arrival-controller/arrival-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The words of an element that is announced when it appears, for a region that\nis there before they are.\n\n**A live region is heard when what it holds changes, not when it arrives.**\nAn element the page inserts with its message already inside is a region\narriving with its words, which a screen reader reads inconsistently at best:\nan empty state after a search, a banner raised mid-session. So the element\nrenders its region empty and this fills it a frame later, which is a change.\n\n**Left empty when the element came with the page**, served or parsed in the\nfirst pass, because a message that was always there is content rather than\nnews, and a region that spoke on every page load would interrupt a reader\nbefore they had read anything. Its words are the baseline instead, and the\nregion speaks only when they change. Filling it at once also drew the words a\nsecond time on the headless tier, which has no sheet to clip the region, and\na served page changed its picture on hydrating.\n\nThe component renders `said` into its region and calls `say` when what it\nholds changes, from a `slotchange`.",
+          "name": "ArrivalController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "said",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What the region says now."
+            },
+            {
+              "kind": "field",
+              "name": "heard",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "The words last accounted for, said or not."
+            },
+            {
+              "kind": "field",
+              "name": "frame",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "say",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Reads the words again, and says them if they moved."
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ArrivalController",
+          "declaration": {
+            "name": "ArrivalController",
+            "module": "src/controllers/arrival-controller/arrival-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/chart-pointer-controller/chart-pointer-controller.ts",
@@ -587,6 +667,16 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Listens again after a move, to the track it was following.\n\nThe track is kept across the disconnect for this: it is only chosen again\non `loadedmetadata`, and moving a video does not reload it, so a caption\nfroze on whatever it last said."
+            },
             {
               "kind": "method",
               "name": "hostDisconnected",
@@ -2056,6 +2146,16 @@
               "privacy": "private",
               "description": "Cancels the availability watch, since it outlives a single render."
             },
+            {
+              "kind": "field",
+              "name": "connected",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the host is in the document, which a watch is only kept while."
+            },
             {
               "kind": "method",
               "name": "attach",
@@ -2074,6 +2174,17 @@
               ],
               "description": "Starts watching the media element, once there is one."
             },
+            {
+              "kind": "method",
+              "name": "start",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "description": "Asks to hear when a device turns up or goes, for the media attached.\n\n**A watch that arrives after the host has gone is canceled on arrival.**\nThe platform answers asynchronously, and a video removed while it did kept\na watch nothing would cancel."
+            },
             {
               "kind": "method",
               "name": "prompt",
@@ -2084,6 +2195,16 @@
               },
               "description": "Opens the platform's own device picker. It has no list of its own."
             },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Watches again after a move. The disconnect canceled it, and `attach` is\ncalled once, so the control kept whatever it last knew about devices."
+            },
             {
               "kind": "method",
               "name": "hostDisconnected",
@@ -3066,8 +3187,8 @@
         },
         {
           "kind": "class",
-          "description": "A stop asking the tour to move.\n\nComposed and bubbling, because a stop is slotted into the root and the root\nhas to hear it across that boundary.\n\n**A class rather than a hand-rolled `CustomEvent`.** A dispatch is matched as\n`new HelixSomethingEvent(`, so a raw `CustomEvent` is not held to being\ndeclared and nothing carries it into the manifest: consumers can hear it and\ncannot find it.",
-          "name": "HelixTourAskEvent",
+          "description": "The board moved, which on a canvas is a fact rather than a request.\n\n**`Map` asks and `Canvas` tells, and the difference is who draws.** A map is\nsomebody else's, so the frame can only ask them to move it; a canvas is drawn\nhere from a document, so the same press moves it and this says that it did.\nThe detail is the same shape either way, being a direction and a distance.",
+          "name": "HelixCanvasPanEvent",
           "members": [
             {
               "kind": "field",
@@ -3077,7 +3198,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-tour-ask'"
+              "default": "'helix-canvas-pan'"
             }
           ],
           "superclass": {
@@ -3088,8 +3209,8 @@
         },
         {
           "kind": "class",
-          "description": "The eyedropper opening, and closing again.\n\nTwo events rather than one carrying a flag, because what a consumer does with\nthem is not symmetrical: the surface holding the picker has to get out of the\nway for the sample and come back afterwards, and those are two moments with\ndifferent work in each.\n\n**A class rather than a bare `Event`.** The check that holds an event to being\ndeclared reads `new Event(` as well as `new HelixSomethingEvent(`, so a\nhand-rolled one is public API a consumer can hear and cannot find.\n\nNo detail, because there is nothing to say beyond that it happened.",
-          "name": "HelixSampleStartEvent",
+          "description": "The board zoomed, and told, for the same reason.",
+          "name": "HelixCanvasZoomEvent",
           "members": [
             {
               "kind": "field",
@@ -3099,19 +3220,19 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-sample-start'"
+              "default": "'helix-canvas-zoom'"
             }
           ],
           "superclass": {
-            "name": "Event",
+            "name": "CustomEvent",
             "module": "src/events/events.ts"
           },
           "helix": {}
         },
         {
           "kind": "class",
-          "description": "The eyedropper closing, whether or not a color was taken.",
-          "name": "HelixSampleEndEvent",
+          "description": "Cards are about to move, and can be refused.\n\n**This is the controlled half, the way `helix-before-open` is for a\ndialog.** A board moves its own cards by default, writing `x` and `y` onto\neach one the way an input writes its own value. A consumer who keeps the\npositions in their own state calls `preventDefault()` here, writes what the\ndetail says into that state, and renders the cards where it puts them.\n\nSent for every step of a drag, so a controlled board follows the pointer\nrather than jumping on the drop.",
+          "name": "HelixBeforeMoveEvent",
           "members": [
             {
               "kind": "field",
@@ -3121,19 +3242,19 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-sample-end'"
+              "default": "'helix-before-move'"
             }
           ],
           "superclass": {
-            "name": "Event",
+            "name": "CustomEvent",
             "module": "src/events/events.ts"
           },
           "helix": {}
         },
         {
           "kind": "class",
-          "description": "Fired when an element asks to be taken away.\n\nA request rather than a notification: the element does not remove itself,\nbecause the consumer owns the markup it is in and removing the node under\nthem would put their state and the document out of step. Cancelable, so\n`preventDefault()` is a refusal.\n\nOne verb for both shapes. A tag leaving a list and an announcement closing\nitself are the same act from the element's side.",
-          "name": "HelixDismissEvent",
+          "description": "Cards moved, and the move is finished: a drag let go, or a key press.\n\nThe `change` to `helix-before-move`'s `input`: what a consumer binds who\nonly wants to save a board once somebody has finished rearranging it.",
+          "name": "HelixMoveEvent",
           "members": [
             {
               "kind": "field",
@@ -3143,7 +3264,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-dismiss'"
+              "default": "'helix-move'"
             }
           ],
           "superclass": {
@@ -3154,8 +3275,8 @@
         },
         {
           "kind": "class",
-          "description": "A set is about to make a different child current, and can be refused.\n\n**Not a generic `helix-change`.** `Tabs` moving to another tab, `Tree` marking\nanother row and `Steps` advancing are not a value changing, they are a set\nchoosing, and the platform's word for a committed value would say the wrong\nthing. `active` names which child is current, so `activate` is the verb, and\nunlike `change` the platform has no claim on it.\n\n**This fires before the state moves.** Inside a handler `currentTarget.active`\nstill holds the previous value, and `detail.value` is a proposal another\nlistener may refuse, so a consumer who only wants to know which child is\ncurrent listens for `helix-activate` instead. `helix-select` is not that\nnotification either: it fires when an item is *chosen*, not when `active` is\nassigned.\n\nThe shape is the one `MixinControllerOpen` already has, a cancelable request\nand a plain notification after the state has moved.",
-          "name": "HelixBeforeActivateEvent",
+          "description": "A reader asked for two cards to be joined.\n\n**A request with no default, which is the difference from a move.** A board\nwrites a card's position onto the card, because the card is already there.\nA connection is a new element, and a board that added one to markup React\nrenders would have it put back or thrown away on the next render. So the board\nasks and the page adds the `helix-canvas-edge`, the way `Map` asks to be panned.",
+          "name": "HelixConnectEvent",
           "members": [
             {
               "kind": "field",
@@ -3165,7 +3286,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-activate'"
+              "default": "'helix-connect'"
             }
           ],
           "superclass": {
@@ -3176,8 +3297,8 @@
         },
         {
           "kind": "class",
-          "description": "A set has made a different child current.\n\nThe notification half of `helix-before-activate`, dispatched after the state\nhas moved, so `currentTarget.active` is the new value and the detail is a fact\nrather than a proposal.\n\n**Not cancelable**, for the reason every notification here is not: the\ndecision was taken by the event before it, and a second refusable event for\none transition is two answers to one question.\n\n**Prefixed, and it has to be.** `activate` unprefixed is not in any\n`*EventMap` in the DOM library, checked rather than assumed, but the prefix is\nwhat stops an event dispatched inside a shadow root and retargeted to the host\nbeing mistaken for something the host's own contents sent.",
-          "name": "HelixActivateEvent",
+          "description": "A connection's end is about to move to another card or another side, and can\nbe refused.\n\n**A move, not a request, and that is the difference from `helix-connect`.**\nThe connection is already an element on the page, so the board rewrites its\nends itself, the way it writes a card's position onto the card; a page that\nholds its connections in state refuses this and writes them there.",
+          "name": "HelixBeforeReconnectEvent",
           "members": [
             {
               "kind": "field",
@@ -3187,7 +3308,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-activate'"
+              "default": "'helix-before-reconnect'"
             }
           ],
           "superclass": {
@@ -3198,8 +3319,8 @@
         },
         {
           "kind": "class",
-          "description": "The reader asked the map to move, which is as far as this library goes.\n\n**Helix draws no map and moves nobody's.** A tile renderer is a library and\nthe frame around it is what this adds, so panning is a request the consumer\nanswers against whatever they slotted: MapLibre, Leaflet, Google, or their\nown. The direction is in reading order rather than compass order, because the\ncontrol that sent it is a button a reader pressed and `start` on a\nright-to-left page is east.\n\nNot cancelable. Nothing here moves on its own, and an event whose\n`preventDefault` means nothing is an event that lies about what it offers.",
-          "name": "HelixMapPanEvent",
+          "description": "A connection's end moved, and the move is finished.",
+          "name": "HelixReconnectEvent",
           "members": [
             {
               "kind": "field",
@@ -3209,7 +3330,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-map-pan'"
+              "default": "'helix-reconnect'"
             }
           ],
           "superclass": {
@@ -3220,8 +3341,8 @@
         },
         {
           "kind": "class",
-          "description": "The reader asked the map to zoom, and for the same reason it is a request.\n\n`by` is a direction rather than a level: a scale a consumer's map understands\nis the consumer's to decide, and a frame that said \"go to zoom 14\" would be\nasserting a numbering that Leaflet, MapLibre and a static tile server do not\nagree on.",
-          "name": "HelixMapZoomEvent",
+          "description": "A label the board draws is about to change, and can be refused.\n\n**The board edits what it draws and asks for what it does not.** A\nconnection's label and a group's name are drawn by the board from an\nattribute, so the board edits them in place and writes the attribute back,\nthe way it writes a card's position; a page holding them in state refuses\nthis and writes them there. A card's own content is the page's, which is why\nthat is `helix-canvas-edit`, a request, rather than this.",
+          "name": "HelixBeforeRelabelEvent",
           "members": [
             {
               "kind": "field",
@@ -3231,7 +3352,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-map-zoom'"
+              "default": "'helix-before-relabel'"
             }
           ],
           "superclass": {
@@ -3242,8 +3363,8 @@
         },
         {
           "kind": "class",
-          "description": "A message is about to be pinned or unpinned, and can be refused.",
-          "name": "HelixBeforePinEvent",
+          "description": "A label the board draws changed.",
+          "name": "HelixRelabelEvent",
           "members": [
             {
               "kind": "field",
@@ -3253,7 +3374,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-pin'"
+              "default": "'helix-relabel'"
             }
           ],
           "superclass": {
@@ -3264,8 +3385,8 @@
         },
         {
           "kind": "class",
-          "description": "A divider is about to move, and can be refused.",
-          "name": "HelixBeforeResizeEvent",
+          "description": "A reader asked to edit a card: a double-click, or Enter or F2 on it.\n\n**A request, because what a card holds is the page's.** Text, a picture, a\nchart: the board cannot know what editing any of those means, so it says\nwhich card and the page opens its own editor, in place, in a dialog, or in a\npanel beside the board.",
+          "name": "HelixCanvasEditEvent",
           "members": [
             {
               "kind": "field",
@@ -3275,7 +3396,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-resize'"
+              "default": "'helix-canvas-edit'"
             }
           ],
           "superclass": {
@@ -3286,8 +3407,8 @@
         },
         {
           "kind": "class",
-          "description": "The divider between a sandbox's panes is about to move, and can be refused.\n\nIts own verb rather than a `helix-before-resize` carrying which divider moved:\na sandbox has two, and they were told apart by a field on a detail every other\nrequest in this file also carries.",
-          "name": "HelixBeforeSplitEvent",
+          "description": "A reader asked for cards or connections to be taken away.\n\nA request for the reason `helix-connect` is one: the elements are the page's,\nso the page removes them. Nothing to refuse, because nothing happens unless\nthe page acts.",
+          "name": "HelixRemoveEvent",
           "members": [
             {
               "kind": "field",
@@ -3297,7 +3418,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-split'"
+              "default": "'helix-remove'"
             }
           ],
           "superclass": {
@@ -3308,8 +3429,8 @@
         },
         {
           "kind": "class",
-          "description": "A sandbox's panel is about to change height, and can be refused.\n\nThe sibling of `helix-before-split`, and named for the divider rather than for\nthe axis because a reader binding one of the two is choosing which divider they\ncare about. `value` is pixels here and a percentage there, which is what each\nproperty already publishes.",
-          "name": "HelixBeforePanelResizeEvent",
+          "description": "The board's view changed, however it changed: a drag, the wheel, a press on\na control, a card brought into view, or the board fitting itself.\n\n**One event for all of them**, because what a consumer keeping a minimap or a\nsaved position in step needs is where the board is now, not which of six\ngestures put it there; `helix-canvas-pan` and `helix-canvas-zoom` still say\nwhich control was pressed. Sent for every step of a drag, the way `input` is.",
+          "name": "HelixCanvasViewEvent",
           "members": [
             {
               "kind": "field",
@@ -3319,7 +3440,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-panel-resize'"
+              "default": "'helix-canvas-view'"
             }
           ],
           "superclass": {
@@ -3330,8 +3451,8 @@
         },
         {
           "kind": "class",
-          "description": "A pane is about to collapse or reopen, and can be refused.",
-          "name": "HelixBeforeCollapseEvent",
+          "description": "A stop asking the tour to move.\n\nComposed and bubbling, because a stop is slotted into the root and the root\nhas to hear it across that boundary.\n\n**A class rather than a hand-rolled `CustomEvent`.** A dispatch is matched as\n`new HelixSomethingEvent(`, so a raw `CustomEvent` is not held to being\ndeclared and nothing carries it into the manifest: consumers can hear it and\ncannot find it.",
+          "name": "HelixTourAskEvent",
           "members": [
             {
               "kind": "field",
@@ -3341,7 +3462,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-collapse'"
+              "default": "'helix-tour-ask'"
             }
           ],
           "superclass": {
@@ -3352,8 +3473,8 @@
         },
         {
           "kind": "class",
-          "description": "Source is about to be edited, and can be refused.",
-          "name": "HelixBeforeEditEvent",
+          "description": "The eyedropper opening, and closing again.\n\nTwo events rather than one carrying a flag, because what a consumer does with\nthem is not symmetrical: the surface holding the picker has to get out of the\nway for the sample and come back afterwards, and those are two moments with\ndifferent work in each.\n\n**A class rather than a bare `Event`.** The check that holds an event to being\ndeclared reads `new Event(` as well as `new HelixSomethingEvent(`, so a\nhand-rolled one is public API a consumer can hear and cannot find.\n\nNo detail, because there is nothing to say beyond that it happened.",
+          "name": "HelixSampleStartEvent",
           "members": [
             {
               "kind": "field",
@@ -3363,19 +3484,19 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-edit'"
+              "default": "'helix-sample-start'"
             }
           ],
           "superclass": {
-            "name": "CustomEvent",
+            "name": "Event",
             "module": "src/events/events.ts"
           },
           "helix": {}
         },
         {
           "kind": "class",
-          "description": "A value is about to change, and the change can be refused.\n\n**The request half of every value control.** It announces the value being\n*proposed*, before anything moves, so a listener calling `preventDefault()`\nrefuses it and the control stays where it was. That is how a consumer takes\none decision without declaring a mode, which is what 294 settled: the element\nalways owns and applies its state, and refusing is the way to take it over.\n\n**The notification is native and separate.** Once this has gone out and the\nvalue has moved, the control announces it again under the platform's own\nname, `input` while a reader is editing and `change` when they are done, so\n`onChange` in React and `onchange=` in HTML both reach it and\n`currentTarget.value` is correct by the time a handler reads it. This event\ncarries the detail because at the moment it fires the value is not on the\nelement yet.\n\n**`announcesInput` picks which native notification fires, not which name this\ncarries.** Granularity is the platform's own distinction, `input` against\n`change`; the request is always this one event.",
-          "name": "HelixBeforeChangeEvent",
+          "description": "The eyedropper closing, whether or not a color was taken.",
+          "name": "HelixSampleEndEvent",
           "members": [
             {
               "kind": "field",
@@ -3385,19 +3506,19 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-change'"
+              "default": "'helix-sample-end'"
             }
           ],
           "superclass": {
-            "name": "CustomEvent",
+            "name": "Event",
             "module": "src/events/events.ts"
           },
           "helix": {}
         },
         {
           "kind": "class",
-          "description": "A checked state is about to change, and the change can be refused.\n\n**Its own event rather than a `helix-before-change` carrying a boolean.**\nThrough the value event the state arrives as `String(checked)`, so a consumer\nreceives the string `\"false\"`, which is truthy, and a test asserting the value\npasses on that bug. A control whose state is a boolean wants an event with a\ntyped boolean in it.\n\nThe notification is native, as it is for a value: the control relays `change`\nfrom the inner input and announces `input` beside it, so `onChange` reads\n`currentTarget.checked` and gets a boolean from the platform.\n\nIt also ends a collision: Checkbox Group listened for its boxes' change and\ndispatched its own under the same name from the same host, so it needed\n`stopImmediatePropagation` to keep a consumer from receiving one box's boolean\nalongside the whole set. Two names, two facts.",
-          "name": "HelixBeforeToggleEvent",
+          "description": "Fired when an element asks to be taken away.\n\nA request rather than a notification: the element does not remove itself,\nbecause the consumer owns the markup it is in and removing the node under\nthem would put their state and the document out of step. Cancelable, so\n`preventDefault()` is a refusal.\n\nOne verb for both shapes. A tag leaving a list and an announcement closing\nitself are the same act from the element's side.",
+          "name": "HelixDismissEvent",
           "members": [
             {
               "kind": "field",
@@ -3407,7 +3528,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-toggle'"
+              "default": "'helix-dismiss'"
             }
           ],
           "superclass": {
@@ -3418,8 +3539,8 @@
         },
         {
           "kind": "class",
-          "description": "The reader asked for something the list does not hold.\n\nCancelable, and announced before anything is applied, because the options are\nthe consumer's own light DOM and no component here writes into it. What the\ncontrol can do is say what was asked for and take the value; putting an\noption in the list, or a row in a database, is the consumer's, and a consumer\nwho validates first refuses this and adds nothing.\n\nThe detail carries the text as typed, not a slug of it. Trimming or lowering\nit here would be this element deciding what a name means, and a consumer who\nwants an identifier can make one from what they were given.",
-          "name": "HelixCreateEvent",
+          "description": "A set is about to make a different child current, and can be refused.\n\n**Not a generic `helix-change`.** `Tabs` moving to another tab, `Tree` marking\nanother row and `Steps` advancing are not a value changing, they are a set\nchoosing, and the platform's word for a committed value would say the wrong\nthing. `active` names which child is current, so `activate` is the verb, and\nunlike `change` the platform has no claim on it.\n\n**This fires before the state moves.** Inside a handler `currentTarget.active`\nstill holds the previous value, and `detail.value` is a proposal another\nlistener may refuse, so a consumer who only wants to know which child is\ncurrent listens for `helix-activate` instead. `helix-select` is not that\nnotification either: it fires when an item is *chosen*, not when `active` is\nassigned.\n\nThe shape is the one `MixinControllerOpen` already has, a cancelable request\nand a plain notification after the state has moved.",
+          "name": "HelixBeforeActivateEvent",
           "members": [
             {
               "kind": "field",
@@ -3429,7 +3550,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-create'"
+              "default": "'helix-before-activate'"
             }
           ],
           "superclass": {
@@ -3440,8 +3561,8 @@
         },
         {
           "kind": "class",
-          "description": "Something was copied to the clipboard.\n\nNot cancelable, and deliberately: it is announced after the write, because a\nclipboard write is a permission the platform may refuse and there is nothing\nuseful to report until it has either happened or not.",
-          "name": "HelixCopyEvent",
+          "description": "A set has made a different child current.\n\nThe notification half of `helix-before-activate`, dispatched after the state\nhas moved, so `currentTarget.active` is the new value and the detail is a fact\nrather than a proposal.\n\n**Not cancelable**, for the reason every notification here is not: the\ndecision was taken by the event before it, and a second refusable event for\none transition is two answers to one question.\n\n**Prefixed, and it has to be.** `activate` unprefixed is not in any\n`*EventMap` in the DOM library, checked rather than assumed, but the prefix is\nwhat stops an event dispatched inside a shadow root and retargeted to the host\nbeing mistaken for something the host's own contents sent.",
+          "name": "HelixActivateEvent",
           "members": [
             {
               "kind": "field",
@@ -3451,7 +3572,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-copy'"
+              "default": "'helix-activate'"
             }
           ],
           "superclass": {
@@ -3462,8 +3583,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when something being previewed writes to the console.\n\nCarries text rather than the logged values. The preview is a separate\ndocument, so what arrives has crossed `postMessage` and been through\nstructured clone: a DOM node or a function does not survive that, and half a\nvalue is worse than a string of it.",
-          "name": "HelixConsoleEvent",
+          "description": "The reader asked the map to move, which is as far as this library goes.\n\n**Helix draws no map and moves nobody's.** A tile renderer is a library and\nthe frame around it is what this adds, so panning is a request the consumer\nanswers against whatever they slotted: MapLibre, Leaflet, Google, or their\nown. The direction is in reading order rather than compass order, because the\ncontrol that sent it is a button a reader pressed and `start` on a\nright-to-left page is east.\n\nNot cancelable. Nothing here moves on its own, and an event whose\n`preventDefault` means nothing is an event that lies about what it offers.",
+          "name": "HelixMapPanEvent",
           "members": [
             {
               "kind": "field",
@@ -3473,7 +3594,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-console'"
+              "default": "'helix-map-pan'"
             }
           ],
           "superclass": {
@@ -3484,8 +3605,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when something reports how much room its content actually needs.\n\n**A measurement crossing a boundary the measurer is on the far side of.** A\nsandboxed preview is its own document: nothing outside it can read the height\nof what it drew, because the frame is opaque and a box sized from the outside\nonly ever reports the box. So the document measures itself and says so, and\nthis is what it says it with.\n\nA number rather than a box, because the width is the container's to decide and\nonly the block size follows the content. A consumer that wants to act on it\nclamps it: what arrives is what was drawn, which for an empty example is\nnearly nothing and for a long one is more than a page.",
-          "name": "HelixResizeEvent",
+          "description": "The reader asked the map to zoom, and for the same reason it is a request.\n\n`by` is a direction rather than a level: a scale a consumer's map understands\nis the consumer's to decide, and a frame that said \"go to zoom 14\" would be\nasserting a numbering that Leaflet, MapLibre and a static tile server do not\nagree on.",
+          "name": "HelixMapZoomEvent",
           "members": [
             {
               "kind": "field",
@@ -3495,7 +3616,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-resize'"
+              "default": "'helix-map-zoom'"
             }
           ],
           "superclass": {
@@ -3506,8 +3627,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a header crosses the threshold between resting at the top of the\npage and floating over it.\n\n**The threshold lives in a custom state, and is announced rather than\nreflected.** A `data-scrolled` on the host is an attribute nobody rendered: a\nserver sends the element without it and the element adds it on upgrade, so a\nframework hydrating the page finds markup that no longer matches what it sent.\nA custom state is deliberately not in the DOM and therefore not something a\nhydration pass can disagree with.\n\nThat closes the observability an attribute would accidentally provide. A\n`MutationObserver` can watch an attribute and there is no equivalent for\n`ElementInternals.states`, so a component holding a boolean nothing can read\nis a component with a private opinion its consumers demonstrably need: the\nbar's own backdrop is drawn by the page around it, and the page has to know\nwhen to light it.\n\nNot cancelable. It reports where the page is rather than asking permission to\nbe there, and refusing it would leave the state and the announcement\ndisagreeing.\n\nThe hysteresis stays inside the header, which is the point of announcing at\nall: a consumer listening to `scroll` itself would be a second opinion on\nwhen the page counts as scrolled, and the two would part company at the eight\npixels of travel this waits for.",
-          "name": "HelixScrolledEvent",
+          "description": "A message is about to be pinned or unpinned, and can be refused.",
+          "name": "HelixBeforePinEvent",
           "members": [
             {
               "kind": "field",
@@ -3517,7 +3638,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-scrolled'"
+              "default": "'helix-before-pin'"
             }
           ],
           "superclass": {
@@ -3528,8 +3649,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the cursor moves in a text editor.\n\nNot cancelable, unlike everything else here. The others announce something\nabout to happen and a listener can refuse it; this one reports where the\ncaret already is, and there is nothing left to refuse.\n\nIt fires on every keystroke and every arrow press, which is why the status\nbar reads it from the DOM rather than through a framework's state: routing a\ncaret position through React would re-render the workbench on every cursor\nmove.",
-          "name": "HelixCaretEvent",
+          "description": "A divider is about to move, and can be refused.",
+          "name": "HelixBeforeResizeEvent",
           "members": [
             {
               "kind": "field",
@@ -3539,7 +3660,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-caret'"
+              "default": "'helix-before-resize'"
             }
           ],
           "superclass": {
@@ -3550,8 +3671,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a component moves the view it is showing, rather than its value.\n\nA calendar paging to another month is not choosing a date, and the two have\nto be separable: a consumer driving the view needs to hear that it moved\nwithout being told the answer changed. `helix-change` belongs to the value,\nand giving it both jobs would make either one unusable on its own.",
-          "name": "HelixNavigateEvent",
+          "description": "The divider between a sandbox's panes is about to move, and can be refused.\n\nIts own verb rather than a `helix-before-resize` carrying which divider moved:\na sandbox has two, and they were told apart by a field on a detail every other\nrequest in this file also carries.",
+          "name": "HelixBeforeSplitEvent",
           "members": [
             {
               "kind": "field",
@@ -3561,7 +3682,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-navigate'"
+              "default": "'helix-before-split'"
             }
           ],
           "superclass": {
@@ -3572,8 +3693,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a control that fills up has filled.\n\nThe moment a code entry exists for: a six-character field is worth submitting\nthe instant the sixth character lands, and a consumer watching `helix-change`\nhas to know the length and compare it on every keystroke to find that moment\nthemselves.\n\nSeparate from `helix-change` rather than a flag on it, because they are\nanswered by different code: one keeps a value in step and the other decides\nwhether to send a form. A listener that only cares about the second says so by\nwhich event it listens for.\n\n`complete` is free as a verb. React's synthetic system claims `change`,\n`input`, `submit`, `reset`, `copy`, `paste`, `scroll`, `drag`, `focus` and\n`blur`, measured, and this is none of them.\n\nNot cancelable. It reports that something already happened, which is the same\nreason `helix-caret` is not: there is nothing left to refuse once the last\ncharacter is in the box.",
-          "name": "HelixCompleteEvent",
+          "description": "A sandbox's panel is about to change height, and can be refused.\n\nThe sibling of `helix-before-split`, and named for the divider rather than for\nthe axis because a reader binding one of the two is choosing which divider they\ncare about. `value` is pixels here and a percentage there, which is what each\nproperty already publishes.",
+          "name": "HelixBeforePanelResizeEvent",
           "members": [
             {
               "kind": "field",
@@ -3583,7 +3704,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-complete'"
+              "default": "'helix-before-panel-resize'"
             }
           ],
           "superclass": {
@@ -3594,8 +3715,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the reader offers something they wrote.\n\n**Cancelable, and the composer clears only when nobody refused.** Sending is a\nround trip: a composer that empties itself and then hears the request failed\nhas thrown away the only copy of what the reader typed, and a reader who has\njust written three paragraphs is exactly who cannot afford that. Refusing\nleaves the text where it is.\n\nNot `helix-create`, which is the combobox's event for a value a list does not\nhold, and not `helix-change`, because nothing about a value changed: the\nreader finished something and handed it over.",
-          "name": "HelixSendEvent",
+          "description": "A pane is about to collapse or reopen, and can be refused.",
+          "name": "HelixBeforeCollapseEvent",
           "members": [
             {
               "kind": "field",
@@ -3605,7 +3726,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-send'"
+              "default": "'helix-before-collapse'"
             }
           ],
           "superclass": {
@@ -3616,8 +3737,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when something a user comes back to is marked read, or unread.\n\n**Read state is reported rather than owned.** Marking a notification read is\nusually a round trip, and a component that flips the state itself and then\nhears the request failed has already told the reader something untrue. So this\nis cancelable, and refusing it leaves the item alone; the component applies\nit once nobody has refused, which is the same contract every other axis in\nthe library uses.\n\nBubbles and is composed, so a feed hears its own items: one handler on the\nlist serves every notification in it, which is what a consumer syncing to a\nserver actually wants.",
-          "name": "HelixReadEvent",
+          "description": "Source is about to be edited, and can be refused.",
+          "name": "HelixBeforeEditEvent",
           "members": [
             {
               "kind": "field",
@@ -3627,7 +3748,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-read'"
+              "default": "'helix-before-edit'"
             }
           ],
           "superclass": {
@@ -3638,8 +3759,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the reader asks for a different order.\n\nCancelable, and refusing it leaves the order alone, which is what makes a\nserver-side sort expressible: the consumer refuses the local reorder, fetches,\nand hands back a new set. This is the element reporting that a heading was\nclicked, before it acts on it.\n\nNot `helix-change`: nothing about the data changed, only the order it is read\nin, and a consumer listening for changes to a value should not hear a sort.\nThat is the same distinction `helix-filter` is drawn on.",
-          "name": "HelixSortEvent",
+          "description": "A value is about to change, and the change can be refused.\n\n**The request half of every value control.** It announces the value being\n*proposed*, before anything moves, so a listener calling `preventDefault()`\nrefuses it and the control stays where it was. That is how a consumer takes\none decision without declaring a mode, which is what 294 settled: the element\nalways owns and applies its state, and refusing is the way to take it over.\n\n**The notification is native and separate.** Once this has gone out and the\nvalue has moved, the control announces it again under the platform's own\nname, `input` while a reader is editing and `change` when they are done, so\n`onChange` in React and `onchange=` in HTML both reach it and\n`currentTarget.value` is correct by the time a handler reads it. This event\ncarries the detail because at the moment it fires the value is not on the\nelement yet.\n\n**`announcesInput` picks which native notification fires, not which name this\ncarries.** Granularity is the platform's own distinction, `input` against\n`change`; the request is always this one event.",
+          "name": "HelixBeforeChangeEvent",
           "members": [
             {
               "kind": "field",
@@ -3649,7 +3770,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-sort'"
+              "default": "'helix-before-change'"
             }
           ],
           "superclass": {
@@ -3660,8 +3781,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the reader changes which values a field is filtered by.\n\n**Not `helix-filter`, which is a different thing already taken.** That one\nsays a list narrowed itself to a string, and `Data Table` and `Listbox` both\ndispatch it with exactly that meaning. This one carries a structured filter:\na field, a comparison and a set of values, which is a shape neither of those\nhas and neither should grow.\n\nCancelable, and refusing it is how a consumer takes the decision for one\ninteraction, the way `requestChange` documents for every stateful change here.",
-          "name": "HelixFacetEvent",
+          "description": "A checked state is about to change, and the change can be refused.\n\n**Its own event rather than a `helix-before-change` carrying a boolean.**\nThrough the value event the state arrives as `String(checked)`, so a consumer\nreceives the string `\"false\"`, which is truthy, and a test asserting the value\npasses on that bug. A control whose state is a boolean wants an event with a\ntyped boolean in it.\n\nThe notification is native, as it is for a value: the control relays `change`\nfrom the inner input and announces `input` beside it, so `onChange` reads\n`currentTarget.checked` and gets a boolean from the platform.\n\nIt also ends a collision: Checkbox Group listened for its boxes' change and\ndispatched its own under the same name from the same host, so it needed\n`stopImmediatePropagation` to keep a consumer from receiving one box's boolean\nalongside the whole set. Two names, two facts.",
+          "name": "HelixBeforeToggleEvent",
           "members": [
             {
               "kind": "field",
@@ -3671,7 +3792,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-facet'"
+              "default": "'helix-before-toggle'"
             }
           ],
           "superclass": {
@@ -3682,8 +3803,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a component narrows what it is showing.\n\nFiltering hides rather than removes, so nothing about the value changes and\n`helix-change` would be a lie. What a consumer wants to know is that the list\nin front of the reader is no longer the whole list.",
-          "name": "HelixFilterEvent",
+          "description": "The reader asked for something the list does not hold.\n\nCancelable, and announced before anything is applied, because the options are\nthe consumer's own light DOM and no component here writes into it. What the\ncontrol can do is say what was asked for and take the value; putting an\noption in the list, or a row in a database, is the consumer's, and a consumer\nwho validates first refuses this and adds nothing.\n\nThe detail carries the text as typed, not a slug of it. Trimming or lowering\nit here would be this element deciding what a name means, and a consumer who\nwants an identifier can make one from what they were given.",
+          "name": "HelixCreateEvent",
           "members": [
             {
               "kind": "field",
@@ -3693,7 +3814,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-filter'"
+              "default": "'helix-create'"
             }
           ],
           "superclass": {
@@ -3704,8 +3825,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a shortcut's chord is pressed.\n\nCancelable, and the key event is only consumed where this is not refused: a\nconsumer that decides the moment is wrong, a dialog is over the control or\nthe reader is mid-composition, calls `preventDefault()` and the keystroke\ngoes on to whatever would have had it.",
-          "name": "HelixShortcutEvent",
+          "description": "Something was copied to the clipboard.\n\nNot cancelable, and deliberately: it is announced after the write, because a\nclipboard write is a permission the platform may refuse and there is nothing\nuseful to report until it has either happened or not.",
+          "name": "HelixCopyEvent",
           "members": [
             {
               "kind": "field",
@@ -3715,7 +3836,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-shortcut'"
+              "default": "'helix-copy'"
             }
           ],
           "superclass": {
@@ -3726,7 +3847,271 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the reader selects an item in a set.\n\nBubbles and is composed, because this is how a set coordinates: a tree, a\ntab list and a toggle group all learn which of their children was chosen by\nhearing it arrive.",
+          "description": "Fired when something being previewed writes to the console.\n\nCarries text rather than the logged values. The preview is a separate\ndocument, so what arrives has crossed `postMessage` and been through\nstructured clone: a DOM node or a function does not survive that, and half a\nvalue is worse than a string of it.",
+          "name": "HelixConsoleEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-console'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when something reports how much room its content actually needs.\n\n**A measurement crossing a boundary the measurer is on the far side of.** A\nsandboxed preview is its own document: nothing outside it can read the height\nof what it drew, because the frame is opaque and a box sized from the outside\nonly ever reports the box. So the document measures itself and says so, and\nthis is what it says it with.\n\nA number rather than a box, because the width is the container's to decide and\nonly the block size follows the content. A consumer that wants to act on it\nclamps it: what arrives is what was drawn, which for an empty example is\nnearly nothing and for a long one is more than a page.",
+          "name": "HelixResizeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-resize'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a header crosses the threshold between resting at the top of the\npage and floating over it.\n\n**The threshold lives in a custom state, and is announced rather than\nreflected.** A `data-scrolled` on the host is an attribute nobody rendered: a\nserver sends the element without it and the element adds it on upgrade, so a\nframework hydrating the page finds markup that no longer matches what it sent.\nA custom state is deliberately not in the DOM and therefore not something a\nhydration pass can disagree with.\n\nThat closes the observability an attribute would accidentally provide. A\n`MutationObserver` can watch an attribute and there is no equivalent for\n`ElementInternals.states`, so a component holding a boolean nothing can read\nis a component with a private opinion its consumers demonstrably need: the\nbar's own backdrop is drawn by the page around it, and the page has to know\nwhen to light it.\n\nNot cancelable. It reports where the page is rather than asking permission to\nbe there, and refusing it would leave the state and the announcement\ndisagreeing.\n\nThe hysteresis stays inside the header, which is the point of announcing at\nall: a consumer listening to `scroll` itself would be a second opinion on\nwhen the page counts as scrolled, and the two would part company at the eight\npixels of travel this waits for.",
+          "name": "HelixScrolledEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-scrolled'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the cursor moves in a text editor.\n\nNot cancelable, unlike everything else here. The others announce something\nabout to happen and a listener can refuse it; this one reports where the\ncaret already is, and there is nothing left to refuse.\n\nIt fires on every keystroke and every arrow press, which is why the status\nbar reads it from the DOM rather than through a framework's state: routing a\ncaret position through React would re-render the workbench on every cursor\nmove.",
+          "name": "HelixCaretEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-caret'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a component moves the view it is showing, rather than its value.\n\nA calendar paging to another month is not choosing a date, and the two have\nto be separable: a consumer driving the view needs to hear that it moved\nwithout being told the answer changed. `helix-change` belongs to the value,\nand giving it both jobs would make either one unusable on its own.",
+          "name": "HelixNavigateEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-navigate'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a control that fills up has filled.\n\nThe moment a code entry exists for: a six-character field is worth submitting\nthe instant the sixth character lands, and a consumer watching `helix-change`\nhas to know the length and compare it on every keystroke to find that moment\nthemselves.\n\nSeparate from `helix-change` rather than a flag on it, because they are\nanswered by different code: one keeps a value in step and the other decides\nwhether to send a form. A listener that only cares about the second says so by\nwhich event it listens for.\n\n`complete` is free as a verb. React's synthetic system claims `change`,\n`input`, `submit`, `reset`, `copy`, `paste`, `scroll`, `drag`, `focus` and\n`blur`, measured, and this is none of them.\n\nNot cancelable. It reports that something already happened, which is the same\nreason `helix-caret` is not: there is nothing left to refuse once the last\ncharacter is in the box.",
+          "name": "HelixCompleteEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-complete'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the reader offers something they wrote.\n\n**Cancelable, and the composer clears only when nobody refused.** Sending is a\nround trip: a composer that empties itself and then hears the request failed\nhas thrown away the only copy of what the reader typed, and a reader who has\njust written three paragraphs is exactly who cannot afford that. Refusing\nleaves the text where it is.\n\nNot `helix-create`, which is the combobox's event for a value a list does not\nhold, and not `helix-change`, because nothing about a value changed: the\nreader finished something and handed it over.",
+          "name": "HelixSendEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-send'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when something a user comes back to is marked read, or unread.\n\n**Read state is reported rather than owned.** Marking a notification read is\nusually a round trip, and a component that flips the state itself and then\nhears the request failed has already told the reader something untrue. So this\nis cancelable, and refusing it leaves the item alone; the component applies\nit once nobody has refused, which is the same contract every other axis in\nthe library uses.\n\nBubbles and is composed, so a feed hears its own items: one handler on the\nlist serves every notification in it, which is what a consumer syncing to a\nserver actually wants.",
+          "name": "HelixReadEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-read'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the reader asks for a different order.\n\nCancelable, and refusing it leaves the order alone, which is what makes a\nserver-side sort expressible: the consumer refuses the local reorder, fetches,\nand hands back a new set. This is the element reporting that a heading was\nclicked, before it acts on it.\n\nNot `helix-change`: nothing about the data changed, only the order it is read\nin, and a consumer listening for changes to a value should not hear a sort.\nThat is the same distinction `helix-filter` is drawn on.",
+          "name": "HelixSortEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-sort'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the reader changes which values a field is filtered by.\n\n**Not `helix-filter`, which is a different thing already taken.** That one\nsays a list narrowed itself to a string, and `Data Table` and `Listbox` both\ndispatch it with exactly that meaning. This one carries a structured filter:\na field, a comparison and a set of values, which is a shape neither of those\nhas and neither should grow.\n\nCancelable, and refusing it is how a consumer takes the decision for one\ninteraction, the way `requestChange` documents for every stateful change here.",
+          "name": "HelixFacetEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-facet'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a component narrows what it is showing.\n\nFiltering hides rather than removes, so nothing about the value changes and\n`helix-change` would be a lie. What a consumer wants to know is that the list\nin front of the reader is no longer the whole list.",
+          "name": "HelixFilterEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-filter'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a shortcut's chord is pressed.\n\nCancelable, and the key event is only consumed where this is not refused: a\nconsumer that decides the moment is wrong, a dialog is over the control or\nthe reader is mid-composition, calls `preventDefault()` and the keystroke\ngoes on to whatever would have had it.",
+          "name": "HelixShortcutEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-shortcut'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the reader selects an item in a set.\n\nBubbles and is composed, because this is how a set coordinates: a tree, a\ntab list and a toggle group all learn which of their children was chosen by\nhearing it arrive.",
           "name": "HelixSelectEvent",
           "members": [
             {
@@ -3833,6 +4218,102 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixCanvasPanEvent",
+          "declaration": {
+            "name": "HelixCanvasPanEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasZoomEvent",
+          "declaration": {
+            "name": "HelixCanvasZoomEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforeMoveEvent",
+          "declaration": {
+            "name": "HelixBeforeMoveEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMoveEvent",
+          "declaration": {
+            "name": "HelixMoveEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixConnectEvent",
+          "declaration": {
+            "name": "HelixConnectEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforeReconnectEvent",
+          "declaration": {
+            "name": "HelixBeforeReconnectEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixReconnectEvent",
+          "declaration": {
+            "name": "HelixReconnectEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforeRelabelEvent",
+          "declaration": {
+            "name": "HelixBeforeRelabelEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixRelabelEvent",
+          "declaration": {
+            "name": "HelixRelabelEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasEditEvent",
+          "declaration": {
+            "name": "HelixCanvasEditEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixRemoveEvent",
+          "declaration": {
+            "name": "HelixRemoveEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasViewEvent",
+          "declaration": {
+            "name": "HelixCanvasViewEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixTourAskEvent",
@@ -4641,6 +5122,16 @@
               ],
               "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."
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback",
+              "return": {
+                "type": {
+                  "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."
+            },
             {
               "kind": "method",
               "name": "announceInput",
@@ -5109,6 +5600,22 @@
             "module": "./controllers/aria-forward-controller/aria-forward-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ArrivalController",
+          "declaration": {
+            "name": "ArrivalController",
+            "module": "./controllers/arrival-controller/arrival-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArrivalOptions",
+          "declaration": {
+            "name": "ArrivalOptions",
+            "module": "./controllers/arrival-controller/arrival-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ChartPointerController",
@@ -5525,6 +6032,14 @@
             "module": "./events/element-events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CanvasView",
+          "declaration": {
+            "name": "CanvasView",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CaretDetail",
@@ -5549,6 +6064,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ConnectDetail",
+          "declaration": {
+            "name": "ConnectDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ConsoleDetail",
@@ -5645,6 +6168,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixBeforeMoveEvent",
+          "declaration": {
+            "name": "HelixBeforeMoveEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixBeforeOpenEvent",
@@ -5669,6 +6200,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixBeforeReconnectEvent",
+          "declaration": {
+            "name": "HelixBeforeReconnectEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforeRelabelEvent",
+          "declaration": {
+            "name": "HelixBeforeRelabelEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixBeforeResizeEvent",
@@ -5693,6 +6240,38 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixCanvasEditEvent",
+          "declaration": {
+            "name": "HelixCanvasEditEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasPanEvent",
+          "declaration": {
+            "name": "HelixCanvasPanEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasViewEvent",
+          "declaration": {
+            "name": "HelixCanvasViewEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixCanvasZoomEvent",
+          "declaration": {
+            "name": "HelixCanvasZoomEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixCaretEvent",
@@ -5709,6 +6288,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixConnectEvent",
+          "declaration": {
+            "name": "HelixConnectEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixConsoleEvent",
@@ -5781,6 +6368,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMoveEvent",
+          "declaration": {
+            "name": "HelixMoveEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixNavigateEvent",
@@ -5813,6 +6408,30 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixReconnectEvent",
+          "declaration": {
+            "name": "HelixReconnectEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixRelabelEvent",
+          "declaration": {
+            "name": "HelixRelabelEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixRemoveEvent",
+          "declaration": {
+            "name": "HelixRemoveEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixReorderEvent",
@@ -5889,47 +6508,79 @@
           "kind": "js",
           "name": "HelixTourAskEvent",
           "declaration": {
-            "name": "HelixTourAskEvent",
+            "name": "HelixTourAskEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MapPanDetail",
+          "declaration": {
+            "name": "MapPanDetail",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MapZoomDetail",
+          "declaration": {
+            "name": "MapZoomDetail",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MoveDetail",
+          "declaration": {
+            "name": "MoveDetail",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NavigateDetail",
+          "declaration": {
+            "name": "NavigateDetail",
             "module": "./events/events.js"
           }
         },
         {
           "kind": "js",
-          "name": "MapPanDetail",
+          "name": "OpenDetail",
           "declaration": {
-            "name": "MapPanDetail",
+            "name": "OpenDetail",
             "module": "./events/events.js"
           }
         },
         {
           "kind": "js",
-          "name": "MapZoomDetail",
+          "name": "ReadDetail",
           "declaration": {
-            "name": "MapZoomDetail",
+            "name": "ReadDetail",
             "module": "./events/events.js"
           }
         },
         {
           "kind": "js",
-          "name": "NavigateDetail",
+          "name": "ReconnectDetail",
           "declaration": {
-            "name": "NavigateDetail",
+            "name": "ReconnectDetail",
             "module": "./events/events.js"
           }
         },
         {
           "kind": "js",
-          "name": "OpenDetail",
+          "name": "RelabelDetail",
           "declaration": {
-            "name": "OpenDetail",
+            "name": "RelabelDetail",
             "module": "./events/events.js"
           }
         },
         {
           "kind": "js",
-          "name": "ReadDetail",
+          "name": "RemoveDetail",
           "declaration": {
-            "name": "ReadDetail",
+            "name": "RemoveDetail",
             "module": "./events/events.js"
           }
         },
@@ -6461,6 +7112,14 @@
             "module": "./utils/element-by-id/element-by-id.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "fillTemplate",
+          "declaration": {
+            "name": "fillTemplate",
+            "module": "./utils/fill-template/fill-template.js"
+          }
+        },
         {
           "kind": "js",
           "name": "deepActiveElement",
@@ -6549,6 +7208,14 @@
             "module": "./utils/is-rtl/is-rtl.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "keyClaimed",
+          "declaration": {
+            "name": "keyClaimed",
+            "module": "./utils/key-claimed/key-claimed.js"
+          }
+        },
         {
           "kind": "js",
           "name": "Curve",
@@ -6701,6 +7368,14 @@
             "module": "./utils/relative-time/relative-time.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "reportValues",
+          "declaration": {
+            "name": "reportValues",
+            "module": "./utils/report-values/report-values.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ChangeRequestOptions",
@@ -6805,6 +7480,14 @@
             "module": "./utils/slot-filled/slot-filled.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "slottedWords",
+          "declaration": {
+            "name": "slottedWords",
+            "module": "./utils/slotted-words/slotted-words.js"
+          }
+        },
         {
           "kind": "js",
           "name": "splitValues",
@@ -7476,6 +8159,25 @@
               ],
               "description": "The status line, or nothing where the collection has content to show.\n\nRendered by the component wherever its rows would be."
             },
+            {
+              "kind": "method",
+              "name": "renderLive",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "hasContent",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "The same words for a screen reader, in a region that is always there.\n\nRendered by the component outside its rows, where a status is allowed."
+            },
             {
               "kind": "method",
               "name": "countRows",
@@ -7630,6 +8332,25 @@
                 }
               ],
               "description": "The status line, or nothing where there is content to show.\n\nLoading wins over empty. A collection that has not answered yet is not\nempty, and saying so is the most common version of this fault: the reader\nis told there is nothing a moment before there is something."
+            },
+            {
+              "kind": "method",
+              "name": "renderLive",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "hasContent",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "The same words for a screen reader, in a region that is always there.\n\n**A region is heard when what it holds changes, not when it arrives.**\nThe loading line was a `role=\"status\"` inserted with its words already\nin it, which is read inconsistently at best, and the empty line was no\nregion at all, so a filter that emptied a list said nothing. This one is\nrendered on every pass and only its words move: \"Loading\", then\n\"No matches\", then nothing once there are rows.\n\n**Outside the rows, which is the component's to place.** A status is not\na child a `listbox`, a `table` or a `tree` may hold, so the component\nrenders this beside its container rather than inside it. The styled\ntier clips it; the visible lines are `renderStatus`."
             }
           ],
           "attributes": [
@@ -8177,22 +8898,22 @@
           "members": [
             {
               "kind": "field",
-              "name": "open",
+              "name": "defaultOpen",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
-              "attribute": "open"
+              "default": "false",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "attribute": "default-open"
             },
             {
               "kind": "field",
-              "name": "defaultOpen",
+              "name": "open",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether the markup declared it open. Ignored once `open` is written.",
-              "attribute": "default-open"
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "attribute": "open"
             },
             {
               "kind": "field",
@@ -8254,21 +8975,21 @@
           ],
           "attributes": [
             {
-              "name": "open",
+              "name": "default-open",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
-              "fieldName": "open"
+              "default": "false",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "fieldName": "defaultOpen"
             },
             {
-              "name": "default-open",
+              "name": "open",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether the markup declared it open. Ignored once `open` is written.",
-              "fieldName": "defaultOpen"
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "fieldName": "open"
             }
           ],
           "parameters": [
@@ -8375,7 +9096,7 @@
                 {
                   "name": "state",
                   "type": {
-                    "text": "string | null"
+                    "text": "string | File | FormData | null"
                   }
                 }
               ],
@@ -8480,7 +9201,7 @@
                 {
                   "name": "state",
                   "type": {
-                    "text": "string | null"
+                    "text": "string | File | FormData | null"
                   }
                 }
               ],
@@ -8699,6 +9420,25 @@
               "privacy": "protected",
               "description": "Id the field's label points at, written by the control this wraps.\n\nThe third fixed id and the only one this mixin does not render, the\ncontrol being the family's. See the note on the class member."
             },
+            {
+              "kind": "field",
+              "name": "labelId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "The id the label carries, for an element in the template to be named by."
+            },
+            {
+              "kind": "field",
+              "name": "labeled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether a label is drawn at all, in either shape.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "hint",
@@ -8837,6 +9577,25 @@
               ],
               "description": "Reports \"required and empty\" against a rendered part, or clears it.\n\n`empty` is the control's own answer to whether it holds nothing, `message`\nis what to say about it, and `anchor` names the part the browser should\npoint its bubble at."
             },
+            {
+              "kind": "method",
+              "name": "copyValidity",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "control",
+                  "type": {
+                    "text": "HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement"
+                  }
+                }
+              ],
+              "description": "Hands on the verdict of a native control this renders, with the page's own\nwords where it gave some."
+            },
             {
               "kind": "field",
               "name": "resolvedFeedback",
@@ -8845,6 +9604,14 @@
               },
               "readonly": true,
               "description": "The message actually shown: the consumer's, or the platform's, or none."
+            },
+            {
+              "kind": "field",
+              "name": "valueMissingMessage",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "What a reader is told when the field is required and empty, where the page says."
             }
           ],
           "helix": {}
@@ -8864,6 +9631,26 @@
               "default": "'control'",
               "description": "Id the field's label points at, written by the control this wraps.\n\n`renderLabel` emits the `for` and the family renders the `id`, so the\ntwo ends of one IDREF sat in two packages as a pair of literals with\nnothing holding them together: eleven templates wrote `id=\"control\"`,\ntwo wrote a second `for=\"control\"` of their own, and a family that\nspelled either differently got a `<label for>` resolving to nothing.\nThat failure is silent in the way the area rules describe for a\n`[part=]` naming a part nobody renders: no error, no warning, and a\nlabel that has stopped focusing its field.\n\nA member rather than a module constant, which is what the anchor\nargument for `reportRequired` already settled one level down: the name\nbelongs to the control the family renders, so the family has to be able\nto read it, and `HINT_ID` and `FEEDBACK_ID` stay private because this\nmixin renders both of those itself."
             },
+            {
+              "kind": "field",
+              "name": "labelId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "default": "'label'",
+              "description": "The id the label carries, for an element in the template to be named by.\n\n**What a template draws is not the host**, which is what `hostAria`\nnames: a rating's radiogroup, a pin input's row of cells, a listbox's\nlist and a range slider's two thumbs are elements of their own, and they\nhad no name but a `label` string, or none at all. In the same tree as\nthe label, so a plain `aria-labelledby` resolves, and it names them by\nwhatever the label holds, a slotted one included. One id for both shapes,\nsince a family draws one or the other."
+            },
+            {
+              "kind": "field",
+              "name": "labeled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether a label is drawn at all, in either shape.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "feedback",
@@ -8905,6 +9692,15 @@
               "attribute": "required",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "valueMissingMessage",
+              "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.",
+              "attribute": "value-missing-message"
+            },
             {
               "kind": "field",
               "name": "touched",
@@ -9031,6 +9827,35 @@
                 }
               ],
               "description": "Reports \"required and empty\" and refreshes the message, or clears both.\n\nTwo things differ between the controls that call this, so those are the\narguments: whether the control is empty, which only it can say, and the\nsentence to say about it, which is different for a box, a switch and a\nset. The anchor is looked up here because every one of them anchors on a\nrendered part and the browser needs somewhere to point the bubble.\n\nThe message is not derived from the control's kind, deliberately. \"Tick\nthis box\" and \"Choose one\" are not the same instruction and a lookup\ntable would be one more thing to keep in step with the components."
+            },
+            {
+              "kind": "method",
+              "name": "copyValidity",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "control",
+                  "type": {
+                    "text": "HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement"
+                  }
+                }
+              ],
+              "description": "Hands on the verdict of a native control this renders, with the page's\nown words where it gave some.\n\nThe browser's message otherwise, which is already in the reader's\nlanguage, anchored on the control so the bubble points at the text and\nnot at the host. The seven families that copy a native verdict each\nwrote this line, and none of them could be told what to say."
+            },
+            {
+              "kind": "method",
+              "name": "formResetCallback",
+              "return": {
+                "type": {
+                  "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."
             }
           ],
           "attributes": [
@@ -9069,6 +9894,14 @@
               "default": "false",
               "description": "Whether the form refuses to submit without it.",
               "fieldName": "required"
+            },
+            {
+              "name": "value-missing-message",
+              "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.",
+              "fieldName": "valueMissingMessage"
             }
           ],
           "parameters": [
@@ -9275,6 +10108,14 @@
           "description": "The public surface `MixinPickerField` adds.\n\nDeclared separately because TypeScript cannot emit declarations for an\nanonymous class that has private members (TS4094). Casting the mixin's return\nto this interface keeps the internals private and the build working.",
           "name": "MixinPickerFieldInterface",
           "members": [
+            {
+              "kind": "field",
+              "name": "badInputMessage",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "What a reader is told when the field holds something the picker cannot read."
+            },
             {
               "kind": "field",
               "name": "anchor",
@@ -9285,6 +10126,16 @@
               "description": "What the label points at and focus lands on.\n\nThe text control, unless a family says otherwise: Color Input in `swatch`\nhas no text control, and its trigger is the only thing in the field a label\ncan name.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "answers",
+              "type": {
+                "text": "readonly string[] | undefined"
+              },
+              "privacy": "protected",
+              "description": "Each answer the field holds, where it holds several, or `undefined` where\nits value is one answer. Several are sent one entry each; see\n`reportValues`.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "control",
@@ -9424,6 +10275,15 @@
           "description": "Grafts a floating picker onto a text field, and the protocol between them.\n\n**Three families are this shape and were three copies of it.** Date Input,\nTime Input and Color Input each render a text control, a trigger and a\n`popover=\"manual\"` surface holding a picker that already exists on its own,\nand each owed the same wiring: the panel that floats the surface against the\nfield, the Escape that shuts it and hands the caret back, the restore that\nputs the control back where a refusal left the value, and the sync that\nreports the value and a verdict the platform cannot reach. Measured on the\ndiff that made the lift, 14 Sep 2026, comments counted: 223 lines left Date\nInput and 32 came back, 185 left Time Input and 32 came back, 87 left\nColor Input and 11 came back.\n\n**What it does not own is the picker, the typing or the value's shape.**\nWhich element floats in the surface, what a keystroke means, what the field\nshows when idle and what is wrong with a value are each the family's, which\nis why `display` and `validate` are seams here and the template stays where\nit was. A family renders `field`, `control`, `trigger` and `surface`; this\nreads them.\n\n**The parts this reads are the host's, so the name is a parameter.** A\nliteral `[part=\"control\"]` here would be a lookup nothing in this file\nrenders, which is the fault `helix component`'s `selectors` exists to catch\nand would rightly report. `MixinField.reportRequired` takes its anchor the\nsame way, and for the same reason: a mixin reads a part out of whatever host\napplies it.\n\n**Opening on focus, `readOnly` and the idle rendering are not here.** They\nare `MixinPickerEditing`'s, because Color Input has none of the three: a hex\nis pasted and read at a glance, so its field neither renders nor opens on\narrival, and giving it `readOnly` would be a property its API does not have.\n\n**Three things the two typed families share stay with them.** `renderTrigger`\ndiffers only by its icon and would still be the wrong thing to lift: a part a\nmixin renders belongs to every host that applies it, which is how\n`helix component`'s `parts` reads a chain, so `trigger-icon` would be\ncredited to Color Input, whose trigger is a swatch and documents no such\npart. `renderTag` names its part after the family, `date` or `time`, and\nwrites the label on the remove control differently in each. `valueAsDate`\nand `valueAsNumber` are public, convert a different way, and carry a\ndifferent note onto each family's page, which a mixin could only carry as\none.\n\n**Four more families look like this and are not.** Select has no text to\nhand the caret to: its panel hangs off the trigger and dismissal refocuses\nthat. Combobox has the text and a different agreement with it: a press\nanywhere in the field is inside, the gap is four, Escape closes without the\n`returning` flag because nothing there opens on arrival, and the control is\nreconciled against a completion rather than restored to a value. Input and\nTextarea open nothing, and their `readOnly` is the native attribute rather\nthan a gate on `requestValue`, so a programmatic change still lands. What\nthose two share with this is `focus()` and the platform's verdict copied in\n`sync`, which is not a protocol.",
           "name": "MixinPickerField",
           "members": [
+            {
+              "kind": "field",
+              "name": "badInputMessage",
+              "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.",
+              "attribute": "bad-input-message"
+            },
             {
               "kind": "field",
               "name": "panel",
@@ -9481,6 +10341,16 @@
               "description": "What the field shows, which is the value unless a family renders it.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "answers",
+              "type": {
+                "text": "readonly string[] | undefined"
+              },
+              "privacy": "protected",
+              "description": "Each answer the field holds, where it holds several.\n\nOne answer by default, the value itself. Date Input and Time Input hold\nseveral in `multiple` and `range`, and say so.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "validate",
@@ -9562,6 +10432,16 @@
               "description": "Puts the caret in the field, the way a label pointing at one would."
             }
           ],
+          "attributes": [
+            {
+              "name": "bad-input-message",
+              "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.",
+              "fieldName": "badInputMessage"
+            }
+          ],
           "parameters": [
             {
               "name": "Base",
@@ -10192,11 +11072,27 @@
             },
             {
               "kind": "field",
-              "name": "panLabel",
+              "name": "panDownLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "What the control that pans down is called."
+            },
+            {
+              "kind": "field",
+              "name": "panLeftLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "What the control that pans left is called."
+            },
+            {
+              "kind": "field",
+              "name": "panRightLabel",
               "type": {
                 "text": "string"
               },
-              "description": "What one pan control is called, with `{way}` filled in."
+              "description": "What the control that pans right is called."
             },
             {
               "kind": "field",
@@ -10206,6 +11102,14 @@
               },
               "description": "How far one press moves the view, as a fraction of what is on screen."
             },
+            {
+              "kind": "field",
+              "name": "panUpLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "What the control that pans up is called."
+            },
             {
               "kind": "field",
               "name": "zoomInLabel",
@@ -10318,11 +11222,19 @@
             {
               "kind": "field",
               "name": "controlsLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "What the group of controls is called, where the page says."
+            },
+            {
+              "kind": "field",
+              "name": "restingControlsLabel",
               "type": {
                 "text": "string"
               },
               "privacy": "protected",
-              "description": "What the group of controls is called, for a family that is not a map.",
+              "description": "What the group of controls is called where the page does not say, which each family says for itself.",
               "readonly": true
             },
             {
@@ -10373,6 +11285,26 @@
                 }
               },
               "description": "The controls, or nothing where the surface keeps none of them."
+            },
+            {
+              "kind": "field",
+              "name": "controlsElement",
+              "type": {
+                "text": "Element | null"
+              },
+              "privacy": "protected",
+              "description": "The drawn group of controls, where there is one, for a family that measures it.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "restingControls",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "Which controls the surface draws while `controls` is absent.",
+              "readonly": true
             }
           ],
           "helix": {}
@@ -10388,10 +11320,19 @@
               "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 all three, which is this library's rule that a resting value is\nan attribute's absence, and it is what the stylesheet asks about: the\nlayout rules are written against `[controls]:not([controls~=\"zoom\"])`\nrather than the bare negation, or a surface that named no list at all\nwould be laid out as though it had dropped everything.",
+              "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.",
               "attribute": "controls",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "controlsLabel",
+              "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.",
+              "attribute": "controls-label"
+            },
             {
               "kind": "field",
               "name": "controlsPlacement",
@@ -10424,13 +11365,33 @@
             },
             {
               "kind": "field",
-              "name": "panLabel",
+              "name": "panDownLabel",
+              "type": {
+                "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.",
+              "attribute": "pan-down-label"
+            },
+            {
+              "kind": "field",
+              "name": "panLeftLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan left'",
+              "description": "What the control that pans left is called, on screen.",
+              "attribute": "pan-left-label"
+            },
+            {
+              "kind": "field",
+              "name": "panRightLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Pan {way}'",
-              "description": "What one pan control is called, with `{way}` filled in.",
-              "attribute": "pan-label"
+              "default": "'Pan right'",
+              "description": "What the control that pans right is called, on screen.",
+              "attribute": "pan-right-label"
             },
             {
               "kind": "field",
@@ -10444,23 +11405,23 @@
             },
             {
               "kind": "field",
-              "name": "zoomInLabel",
+              "name": "panUpLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Zoom in'",
-              "description": "What the control that zooms in is called.",
-              "attribute": "zoom-in-label"
+              "default": "'Pan up'",
+              "description": "What the control that pans up is called.",
+              "attribute": "pan-up-label"
             },
             {
               "kind": "field",
-              "name": "zoomOutLabel",
+              "name": "zoomInLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Zoom out'",
-              "description": "What the control that zooms out is called.",
-              "attribute": "zoom-out-label"
+              "default": "'Zoom in'",
+              "description": "What the control that zooms in is called.",
+              "attribute": "zoom-in-label"
             },
             {
               "kind": "field",
@@ -10498,12 +11459,22 @@
             },
             {
               "kind": "field",
-              "name": "controlsLabel",
+              "name": "zoomOutLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Zoom out'",
+              "description": "What the control that zooms out is called.",
+              "attribute": "zoom-out-label"
+            },
+            {
+              "kind": "field",
+              "name": "restingControlsLabel",
               "type": {
                 "text": "string"
               },
               "privacy": "protected",
-              "description": "What the group of controls is called.\n\nA getter rather than a string in the template, so a family that is not a\nmap does not announce one. Not a property: what this group is called is a\nfact about the family rather than a choice a consumer makes per instance,\nand the labels a consumer does set are the ones on the controls\nthemselves.",
+              "description": "What the group of controls is called where the page does not say.\n\nA getter a family overrides rather than a default on the property, the\nway `restingControls` is: a default would reflect nothing and still be\none value for every family composing this.",
               "readonly": true
             },
             {
@@ -10517,13 +11488,13 @@
               },
               "parameters": [
                 {
-                  "name": "detail",
+                  "name": "_detail",
                   "type": {
                     "text": "ViewportPanDetail"
                   }
                 }
               ],
-              "description": "The pan event, built and not dispatched.\n\nA factory for the reason `MixinDismissible` has one: the surface is\nshared and the name is not. `Map` sends `helix-map-pan` because that is\nwhat a consumer of a map listens for, and the next family names its own."
+              "description": "The pan event, which the family names and this one does not.\n\n**No default, and the analyzer is why as much as the taste is.** A mixin\nthat built a `helix-map-pan` would put it in the manifest of every family\nthat composed the surface, since a mixin's code is resolved into its\nusers: a canvas would be documented as dispatching a map's event, and a\nconsumer reading the reference page would believe it. So the surface\ncarries no event name at all, and a family that forgets to name one hears\nabout it the first time a reader presses an arrow."
             },
             {
               "kind": "method",
@@ -10536,13 +11507,13 @@
               },
               "parameters": [
                 {
-                  "name": "detail",
+                  "name": "_detail",
                   "type": {
                     "text": "ViewportZoomDetail"
                   }
                 }
               ],
-              "description": "The zoom event, built and not dispatched, for the same reason."
+              "description": "The zoom event, which the family names, for the same reason."
             },
             {
               "kind": "method",
@@ -10590,6 +11561,16 @@
               },
               "description": "Fills the screen with the surface, or comes back."
             },
+            {
+              "kind": "field",
+              "name": "restingControls",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "Which controls the surface draws while `controls` is absent.\n\nAll three here, and a family overrides it where its reader has a better\nway to do one of them already.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "draws",
@@ -10609,6 +11590,35 @@
               ],
               "description": "Whether a named group of controls is one this surface draws."
             },
+            {
+              "kind": "method",
+              "name": "sideOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "way",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "The side of the screen a reading-order way is on, left or right.\n\n**Start is left only where the text runs that way.** The pad's grid is\nlaid out in reading order, so on a right-to-left page the start button\nsits on the right, and it said \"left\" and pointed left from there."
+            },
+            {
+              "kind": "field",
+              "name": "rightToLeft",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the page runs right to left, as far as this render may say.\n\n**Not while hydrating.** A server cannot measure direction, so it drew\nthe left-to-right pad; Lit hydrates by keeping what the server drew and\nrecording the client's value unwritten, so a right-to-left answer in the\nhydrating render would never reach the page. It answers once hydration\nis over, and `firstUpdated` asks for that render.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "named",
@@ -10628,6 +11638,25 @@
               ],
               "description": "What one pan control is called, with the way it goes filled in.\n\nLeft and right rather than start and end, because the label is read aloud\nand a reader knows which way left is. The event keeps the reading-order\nname, which is the one a right-to-left page needs."
             },
+            {
+              "kind": "method",
+              "name": "glyph",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "way",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "The arrow drawn on a pan control, pointing the way it goes on screen."
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -10635,6 +11664,16 @@
               "readonly": true,
               "description": "The arrow keys, which are the second way rather than the only one.\n\n`inlineStep` rather than a test against `ArrowLeft`, so the reader on a\nright-to-left page moves the way their text runs, which is what the pan\ncontrols say too.\n\n**Only from the surface's own frame, and that is the difference between\none move and two.** What a consumer slots may answer the arrow keys\nitself, and a press relayed from inside it moves their view once on its\nown and once more on the event this would send. The rule is the region\nand the controls rather than the whole shadow root, because a family with\nits own focusable content in there, a list of notes beside a canvas,\nwould otherwise pan the surface out from under a reader arrowing through\nit."
             },
+            {
+              "kind": "field",
+              "name": "controlsElement",
+              "type": {
+                "text": "Element | null"
+              },
+              "privacy": "protected",
+              "description": "The group of controls as drawn, or nothing where none are.\n\n**Here, because this is what renders it.** A family that measures the\ncluster, as a board does to keep its fit clear of the buttons, would\notherwise look up a part its own template never writes, and a lookup\nlike that is one a later edit to this template breaks without a word.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "renderControls",
@@ -10653,9 +11692,17 @@
               "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 all three, which is this library's rule that a resting value is\nan attribute's absence, and it is what the stylesheet asks about: the\nlayout rules are written against `[controls]:not([controls~=\"zoom\"])`\nrather than the bare negation, or a surface that named no list at all\nwould be laid out as though it had dropped everything.",
+              "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.",
               "fieldName": "controls"
             },
+            {
+              "name": "controls-label",
+              "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.",
+              "fieldName": "controlsLabel"
+            },
             {
               "name": "controls-placement",
               "type": {
@@ -10683,13 +11730,31 @@
               "fieldName": "idleDelay"
             },
             {
-              "name": "pan-label",
+              "name": "pan-down-label",
+              "type": {
+                "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.",
+              "fieldName": "panDownLabel"
+            },
+            {
+              "name": "pan-left-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan left'",
+              "description": "What the control that pans left is called, on screen.",
+              "fieldName": "panLeftLabel"
+            },
+            {
+              "name": "pan-right-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Pan {way}'",
-              "description": "What one pan control is called, with `{way}` filled in.",
-              "fieldName": "panLabel"
+              "default": "'Pan right'",
+              "description": "What the control that pans right is called, on screen.",
+              "fieldName": "panRightLabel"
             },
             {
               "name": "pan-step",
@@ -10700,6 +11765,15 @@
               "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.",
               "fieldName": "panStep"
             },
+            {
+              "name": "pan-up-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan up'",
+              "description": "What the control that pans up is called.",
+              "fieldName": "panUpLabel"
+            },
             {
               "name": "zoom-in-label",
               "type": {
@@ -11297,6 +12371,46 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/fill-template/fill-template.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "fillTemplate",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "template",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "values",
+              "type": {
+                "text": "Record<string, string | number>"
+              }
+            }
+          ],
+          "description": "A label with its `{placeholders}` filled in.\n\n**The one way every translatable sentence here is written**: a property holds\nthe whole sentence, and the numbers and names go in where it says. A\nsentence built from pieces in code puts the pieces in English order, and\nanother language may want them the other way round.\n\nEvery occurrence is filled, so a sentence can name the same thing twice. A\nplaceholder with no value is left as written rather than emptied, which\nshows up on the page as the mistake it is."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "fillTemplate",
+          "declaration": {
+            "name": "fillTemplate",
+            "module": "src/utils/fill-template/fill-template.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/focusable-elements/focusable-elements.ts",
@@ -11594,6 +12708,40 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/key-claimed/key-claimed.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "keyClaimed",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "KeyboardEvent"
+              }
+            }
+          ],
+          "description": "Whether a press was already the business of whatever it landed on.\n\n**For a container that binds keys over content it did not write**: a toolbar,\na viewer, a drilldown. Some of what they hold uses the same keys for itself,\nand moving the container regardless makes an input inside it uneditable:\nArrowRight moves somewhere else, and `preventDefault` means the caret never\nmoves at all.\n\n`composedPath()[0]` rather than `event.target`, which is retargeted to the\ncontrol's host at the shadow boundary and cannot tell a text field inside a\ncomponent from the component itself.\n\n`defaultPrevented` first, because a control that has already answered the\npress has said so in the way the platform provides, and a foreign control\nthis package has never heard of has no other way to say it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "keyClaimed",
+          "declaration": {
+            "name": "keyClaimed",
+            "module": "src/utils/key-claimed/key-claimed.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/line-path/line-path.ts",
@@ -11907,6 +13055,52 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/report-values/report-values.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "reportValues",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "internals",
+              "type": {
+                "text": "ElementInternals"
+              }
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "values",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ],
+          "description": "Reports a control's answer to its form: one entry for each value, the way a\nnative `<select multiple>` and a row of checkboxes send theirs.\n\n**Several answers are several entries, not one joined string.** A server\nreading `tags=a,b` has to know to split it on a convention this library\nchose, and one reading `tags=a&tags=b` reads it the way it reads every\nother multi-valued control on the platform. Listbox, Select and Combobox\nsent the first and Date Picker the second, so what a server received for the\nsame answer depended on which control asked for it.\n\n**The joined string is the state**, which is what the browser hands back to\n`formStateRestoreCallback` and what `value` holds, so a restored control\nreads the shape it wrote.\n\n**Nothing without a `name`.** A plain string is skipped by the form when its\ncontrol has no name, but `FormData` carries its own names and its entries\nare appended whatever the element is called, so an unnamed control would\nsubmit empty-named values."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "reportValues",
+          "declaration": {
+            "name": "reportValues",
+            "module": "src/utils/report-values/report-values.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/request-change/request-change.ts",
@@ -12223,6 +13417,46 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/slotted-words/slotted-words.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "slottedWords",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "Element"
+              }
+            },
+            {
+              "name": "slots",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ],
+          "description": "The words a host's children say in the named slots, `''` being the default\none, in the order they are written.\n\nFor a component that says what the page put in it, which is the page's own\ntext and not anything this library wrote: an empty state's heading and\nmessage, a banner's message. Text nodes count toward the default slot, as\nthey are assigned to it. Nothing on a server, whose element has no children\nto read."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "slottedWords",
+          "declaration": {
+            "name": "slottedWords",
+            "module": "src/utils/slotted-words/slotted-words.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/split-values/split-values.ts",
@@ -12289,7 +13523,7 @@
               }
             }
           ],
-          "description": "Tells a slotted trigger that it opens something, and whether it is open.\n\n**Writing `aria-expanded` onto the consumer's element is a hydration\nmismatch, so it is not written.** The gap that answer was reaching for is\nreal: a consumer who has to mirror `open` back onto their own trigger is a\nconsumer who will forget, and the failure is silent to everyone who can see\nthe screen. It is still the wrong answer, because a component decorating a\nconsumer's markup after upgrading is one whose output a React consumer's\nhydration disagrees with.\n\n**Measured 28 Aug 2026 against React 19.2.8.** Four\nfamilies were server-rendered as React emits them and hydrated with the\nelement definitions loaded either side of `hydrateRoot`:\n\n```\ncase        writes to trigger   hydration mismatch\nmegamenu    aria-expanded       yes, both load orders\nspeed dial  aria-expanded       yes, both load orders\npopover     nothing             no\nmenu        nothing             no\n```\n\nReact reports \"some attributes of the server rendered HTML didn't match the\nclient properties. This won't be patched up\", and the cost is not the console\nline: it answers a mismatch by discarding the server's HTML for that subtree\nand rebuilding it, which is what the carousel's own note records blinding an\n`<helix-aura>` two sections away.\n\n**A property crosses the gap that an attribute cannot.** React diffs the\nattributes it rendered and never looks at a property, so the state reaches\nthe trigger, lands as `aria-expanded` inside *that element's* shadow root,\nand the consumer's markup is exactly what they served. Both positions get\nwhat they were protecting: nothing is written onto the consumer's element,\nand the reader is still told what the control does.\n\n**Set before upgrade is safe**, which is what lets this run without waiting\nfor a definition: `ReactiveElement` captures an instance property assigned\nbefore it upgrades and re-applies it, so a trigger whose module has not\nloaded yet still ends up with the value.\n\n**A plain element is warned about rather than written to.** A\n`<button slot=\"trigger\">` has no shadow root to keep the state out of the\nmarkup and no property to take it, and a consumer cannot mirror it themselves\nbecause the open state belongs to the component. Saying so once is the same\nanswer `Tooltip` gives about the link it will not write for them."
+          "description": "Tells a slotted trigger that it opens something, and whether it is open.\n\n**Writing `aria-expanded` onto the consumer's element is a hydration\nmismatch, so it is not written.** The gap that answer was reaching for is\nreal: a consumer who has to mirror `open` back onto their own trigger is a\nconsumer who will forget, and the failure is silent to everyone who can see\nthe screen. It is still the wrong answer, because a component decorating a\nconsumer's markup after upgrading is one whose output a React consumer's\nhydration disagrees with.\n\n**Measured 28 Aug 2026 against React 19.2.8.** Four\nfamilies were server-rendered as React emits them and hydrated with the\nelement definitions loaded either side of `hydrateRoot`:\n\n```\ncase        writes to trigger   hydration mismatch\nmegamenu    aria-expanded       yes, both load orders\nspeed dial  aria-expanded       yes, both load orders\npopover     nothing             no\nmenu        nothing             no\n```\n\nReact reports \"some attributes of the server rendered HTML didn't match the\nclient properties. This won't be patched up\", and the cost is not the console\nline: it answers a mismatch by discarding the server's HTML for that subtree\nand rebuilding it, which is what the carousel's own note records blinding an\n`<helix-aura>` two sections away.\n\n**A property crosses the gap that an attribute cannot.** React diffs the\nattributes it rendered and never looks at a property, so the state reaches\nthe trigger, lands as `aria-expanded` inside *that element's* shadow root,\nand the consumer's markup is exactly what they served. Both positions get\nwhat they were protecting: nothing is written onto the consumer's element,\nand the reader is still told what the control does.\n\n**Set before upgrade is safe**, which is what lets this run without waiting\nfor a definition: `ReactiveElement` captures an instance property assigned\nbefore it upgrades and re-applies it, so a trigger whose module has not\nloaded yet still ends up with the value.\n\n**A plain element is warned about rather than written to.** A\n`<button slot=\"trigger\">` has no shadow root to keep the state out of the\nmarkup and no property to take it, and a consumer cannot mirror it themselves\nbecause the open state belongs to the component. Saying so once is the same\nanswer `Tooltip` gives about the link it will not write for them, and not at\nall to a trigger that already carries `aria-expanded`, which is a consumer\nmirroring the state from the component's `toggle` event."
         }
       ],
       "exports": [