@fusion.dev/helix-headless 0.162.1 → 0.164.0

package/custom-elements.json

@@ -1681,6 +1681,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "dismiss",
@@ -12722,7 +12751,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`tone` is on the headless tier because it carries meaning. It picks the icon\nand the icon region's accessible name, so a screen reader announces \"Error\"\nfor an error callout whether or not the color is seen. Set `tone-label` to\nsay the name in another language.\n\nThe icon is the fallback content of a slot. Slot your own icon to replace it,\nand the default disappears with no extra check. The tone's name stays on the\nregion around it.\n\nSet `dismissible` for a note a reader may put away, as Shoelace's `closable`\nalert does. The button fires `helix-dismiss` and the callout stays until a\nlistener removes it, so the page decides whether it comes back.\n\nA callout sets a passage apart inside a document and is read where it sits.\nFor page-level chrome above the masthead that is a live region and can be\ndismissed, use `Announcement`.",
+          "description": "`tone` is on the headless tier because it carries meaning. It picks the icon\nand the icon region's accessible name, so a screen reader announces \"Error\"\nfor an error callout whether or not the color is seen. Set `tone-label` to\nsay the name in another language.\n\nThe icon is the fallback content of a slot. Slot your own icon to replace it,\nand the default disappears with no extra check. The tone's name stays on the\nregion around it.\n\nSet `dismissible` for a note a reader may put away, as Shoelace's `closable`\nalert does. The button fires `helix-dismiss`, and unless a listener cancels\nit the callout hides itself: `open` turns false, `:state(exiting)` holds\nwhile its exit animations run, and then it is `hidden`. Remove it in your\nlistener to take it out of the page, or set `open` to show it again, which\nholds `:state(entering)` while it comes back. Focus on its dismiss button\nmoves to the next callout's, or to the tab stop beside it, once it hides.\n\nA callout sets a passage apart inside a document and is read where it sits.\nFor page-level chrome above the masthead that is a live region and can be\ndismissed, use `Announcement`.",
           "name": "HelixHeadlessCallout",
           "cssParts": [
             {
@@ -12796,6 +12825,57 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "turn",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Which journey is the latest, so an entrance settling late leaves an exit alone."
+            },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Hidden from a reader once hidden, for the focus hand-off.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dismiss",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Hides the callout once a dismissal stands, unless the page removed it in\nits listener, which is the page's answer and leaves `open` as it was.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              },
+              "type": {
+                "text": "dismiss() => boolean"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the callout is showing. A dismissal nobody canceled turns it\nfalse and the callout hides itself, and setting it true shows the callout\nagain. Not reflected: open is the resting state, so an `open` attribute\nwould appear on markup a server sent without it.",
+              "attribute": "open"
+            },
             {
               "kind": "field",
               "name": "tone",
@@ -12884,6 +12964,24 @@
               ],
               "description": "The dismiss button's name: `dismissLabel` with the heading's words, or the\ntone's name.\n\nThe heading is read from the children, so a server and a hydrating render\nname the button for the tone, and the update after names it for the\nheading."
             },
+            {
+              "kind": "method",
+              "name": "journey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The way out after a dismissal, or back in after `open` is set again.\n\n**Hidden only once the exit has run**, since a hidden element draws no\nanimation: `:state(exiting)` holds until every animation on the callout\nhas finished, or two frames where it has none, and then `hidden` takes it\nout of the page and out of the accessibility tree. Shown again at once,\nwith `:state(entering)` while it arrives."
+            },
+            {
+              "kind": "field",
+              "name": "readRegions",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Says which regions hold something, one call apiece so each pairs with its `@cssstate`."
+            },
             {
               "kind": "field",
               "name": "dismissible",
@@ -12930,19 +13028,17 @@
             },
             {
               "kind": "method",
-              "name": "dismiss",
+              "name": "handFocusOn",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
-              "description": "Fires `helix-dismiss`, and returns `false` if a listener cancels it.",
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
               "inheritedFrom": {
                 "name": "MixinDismissible",
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
-              },
-              "type": {
-                "text": "dismiss() => boolean"
               }
             },
             {
@@ -13378,7 +13474,7 @@
               "type": {
                 "text": "HelixDismissEvent"
               },
-              "description": "The dismiss button was pressed. The callout does not remove itself, so remove it in response. Cancelable.",
+              "description": "The dismiss button was pressed. Unless a listener cancels it, the callout hides itself, and a listener may remove it instead. Cancelable: cancel it to keep the callout showing.",
               "name": "helix-dismiss",
               "reactProp": "onhelix-dismiss"
             }
@@ -13397,6 +13493,15 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the callout is showing. A dismissal nobody canceled turns it\nfalse and the callout hides itself, and setting it true shows the callout\nagain. Not reflected: open is the resting state, so an `open` attribute\nwould appear on markup a server sent without it.",
+              "fieldName": "open"
+            },
             {
               "name": "tone",
               "type": {
@@ -13437,6 +13542,36 @@
               }
             }
           ],
+          "cssStates": [
+            {
+              "description": "While `open` is false: the callout was dismissed, and is leaving or hidden.",
+              "name": "closed"
+            },
+            {
+              "description": "While a callout shown again by `open` runs its entrance animations.",
+              "name": "entering"
+            },
+            {
+              "description": "While a dismissed callout runs its exit animations, before it is hidden.",
+              "name": "exiting"
+            },
+            {
+              "description": "Something is slotted into `heading`.",
+              "name": "has-heading"
+            },
+            {
+              "description": "An icon of your own is slotted into `icon`, in place of the tone's.",
+              "name": "has-icon"
+            },
+            {
+              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
+              "name": "settled",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
           "mixins": [
             {
               "name": "MixinDismissible",
@@ -13472,16 +13607,6 @@
           },
           "tagName": "helix-headless-callout",
           "customElement": true,
-          "cssStates": [
-            {
-              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
-              "name": "settled",
-              "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
-              }
-            }
-          ],
           "modulePath": "src/callout/root/callout-root.ts",
           "definitionPath": "src/callout/root/callout-root.ts"
         }
@@ -14410,6 +14535,22 @@
             "module": "./root/canvas-root.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CanvasRoute",
+          "declaration": {
+            "name": "CanvasRoute",
+            "module": "./root/canvas-root.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CanvasRouteEnds",
+          "declaration": {
+            "name": "CanvasRouteEnds",
+            "module": "./root/canvas-root.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CanvasSide",
@@ -15630,7 +15771,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A board of cards and connectors, drawn by Helix. On a canvas every position\nis data that someone placed, so drawing is arithmetic over rectangles with no\nlayout to compute. `Map` takes a slotted map, because another renderer draws\nits tiles.\n\nThe format is [JSON Canvas](https://jsoncanvas.org), an open format. Each\nnode has an `x`, `y`, `width`, `height`, and a type. Each edge names the two\nnodes it joins and the sides it leaves and arrives on. A card belongs to a\ngroup when it sits inside the group's bounds.\n\nThe cards are text in the DOM, so a screen reader can read them. The family\nadds a reading order and states each card's connections as text. `order` sets\nthe reading order:\n- `spatial` bands the cards into rows.\n- `edges` follows the arrows, starting from the cards that nothing points to.\n\n**Cards move by default.** The board writes the new `x` and `y` onto the\ncard, the way an input writes its own value, and dispatches two events:\n- `helix-before-move` for every step. Cancel it to hold the positions in your\n  own state and apply them yourself.\n- `helix-move` once the move is finished.\n\nA resize dispatches the same pair with a size. Set `readonly` on the board to\nkeep every card in place, such as on a published board. Set `readonly` on one\ncard or connection to keep only that one in place.\n\nSet `snap` to a length in the document's units, such as `32`, and a card\nthat is moved or resized lands on a multiple of it. Carrying a card, a\ncorner, a connection, or the selection box near the edge of the board moves\nthe board under it, so a card can be taken to a place off screen in one\ndrag. A connection let go within 20 pixels of a card arrives at it. A\ndouble click on the empty board zooms in about that point, and Shift with a\ndouble click zooms out.\n\nKeyboard behavior:\n- One card holds the board's tab stop.\n- The arrow keys move through the cards in reading order. The card you land\n  on scrolls into view, and its connections are announced with it.\n- The card you land on is selected. Control or Command with an arrow key,\n  Home, or End moves without changing the selection, and Space adds the card\n  to the selection or takes it out, so you can select cards that are not\n  next to each other.\n- Shift with an arrow key moves the card: by 16 units, or to the next\n  multiple of `snap` where it is set. Alt with an arrow key resizes it from\n  its bottom right corner the same way.\n- The connections leaving a card are stops of their own, straight after it.\n  Enter on one moves to the card it arrives at.\n- What a key changes that a reader cannot see is said: where a card moved\n  to, its new size, how many cards are selected, and the zoom. A selected\n  card or connection says so when a reader arrives on it.\n- Control or Command with C copies the selected cards, and the connections\n  between them, as a JSON Canvas document in text, which another board or\n  an app that reads the format takes. A paste is your page's: listen for\n  `paste` on the board, read the text with `fromJsonCanvas`, and add the\n  cards it holds.\n- Control or Command with Z undoes the last move or resize the board made,\n  and with Shift, or Control with Y, makes it again. `undo()` and `redo()`\n  do the same from a script. Each asks with `helix-before-move` and tells\n  with `helix-move`, as a move does, so a board that holds its positions in\n  your state is undone through your state.\n\nEvery drag also works with clicks, as WCAG 2.5.7 requires for a pointer that\ncannot hold a button down. Click a selected card's move handle, a corner, a\ncard's connection point, or the end of a selected connection to pick it up.\nIt follows the pointer with no button held, and the next click puts it down\nwhere a drag would have. On touch, the next tap sets where it lands. Escape,\nor a press outside the board, puts it back. So a finger connects two cards\nwith three taps: the card, one of its points, and the card to connect to.\n\nConnecting and removing dispatch requests, and your code applies them:\n- Drawing from a card's handle to another card, or pressing C on one card and\n  Enter on another, dispatches `helix-connect`.\n- Delete on a card or a connection dispatches `helix-remove`. The event names\n  every connection that removing the card would leave without an end.\n\nOnce your page removes what Delete asked for, focus moves to the next stop,\nto the one before where it was the last, and to the board where none is\nleft. A focused card your page removes for its own reasons hands focus on\nthe same way, unless the reader has already moved focus somewhere else.\n\nThe board applies a move itself, because the card already exists. A\nconnection is a new element, and React discards an element the board adds to\nits markup on the next render, so you write the connection.\n\nCards and connections are `helix-canvas-node` and `helix-canvas-edge`\nelements, so they are in the served markup whichever renderer wrote them. The\nlibrary fetches nothing, and an array passed to an element is missing from\nthe first paint of a server-rendered React page. `fromJsonCanvas` turns a\nJSON Canvas document into their props, and `toJsonCanvas()` writes a board\nback out.",
+          "description": "A board of cards and connectors, drawn by Helix. On a canvas every position\nis data that someone placed, so drawing is arithmetic over rectangles with no\nlayout to compute. `Map` takes a slotted map, because another renderer draws\nits tiles.\n\nThe format is [JSON Canvas](https://jsoncanvas.org), an open format. Each\nnode has an `x`, `y`, `width`, `height`, and a type. Each edge names the two\nnodes it joins and the sides it leaves and arrives on. A card belongs to a\ngroup when it sits inside the group's bounds.\n\nThe cards are text in the DOM, so a screen reader can read them. The family\nadds a reading order and states each card's connections as text. `order` sets\nthe reading order:\n- `spatial` bands the cards into rows.\n- `edges` follows the arrows, starting from the cards that nothing points to.\n\n**Cards move by default.** The board writes the new `x` and `y` onto the\ncard, the way an input writes its own value, and dispatches two events:\n- `helix-before-move` for every step. Cancel it to hold the positions in your\n  own state and apply them yourself.\n- `helix-move` once the move is finished.\n\nA resize dispatches the same pair with a size. Set `readonly` on the board to\nkeep every card in place, such as on a published board. Set `readonly` on one\ncard or connection to keep only that one in place.\n\nSet `snap` to a length in the document's units, such as `32`, and a card\nthat is moved or resized lands on a multiple of it. Carrying a card, a\ncorner, a connection, or the selection box near the edge of the board moves\nthe board under it, so a card can be taken to a place off screen in one\ndrag. A connection let go within 20 pixels of a card arrives at it. A\ndouble click on the empty board zooms in about that point, and Shift with a\ndouble click zooms out.\n\nKeyboard behavior:\n- One card holds the board's tab stop.\n- The arrow keys move through the cards in reading order. The card you land\n  on scrolls into view, and its connections are announced with it.\n- The card you land on is selected. Control or Command with an arrow key,\n  Home, or End moves without changing the selection, and Space adds the card\n  to the selection or takes it out, so you can select cards that are not\n  next to each other.\n- Shift with an arrow key moves the card: by 16 units, or to the next\n  multiple of `snap` where it is set. Alt with an arrow key resizes it from\n  its bottom right corner the same way.\n- The connections leaving a card are stops of their own, straight after it.\n  Enter on one moves to the card it arrives at.\n- What a key changes that a reader cannot see is said: where a card moved\n  to, its new size, how many cards are selected, and the zoom. A selected\n  card or connection says so when a reader arrives on it.\n- Control or Command with C copies the selected cards, and the connections\n  between them, as a JSON Canvas document in text, which another board or\n  an app that reads the format takes. A paste is your page's: listen for\n  `paste` on the board, read the text with `fromJsonCanvas`, and add the\n  cards it holds.\n- Control or Command with Z undoes the last move or resize the board made,\n  and with Shift, or Control with Y, makes it again. `undo()` and `redo()`\n  do the same from a script. Each asks with `helix-before-move` and tells\n  with `helix-move`, as a move does, so a board that holds its positions in\n  your state is undone through your state.\n\nEvery drag also works with clicks, as WCAG 2.5.7 requires for a pointer that\ncannot hold a button down. Click a selected card's move handle, a corner, a\ncard's connection point, or the end of a selected connection to pick it up.\nIt follows the pointer with no button held, and the next click puts it down\nwhere a drag would have. On touch, the next tap sets where it lands. Escape,\nor a press outside the board, puts it back. So a finger connects two cards\nwith three taps: the card, one of its points, and the card to connect to.\n\nConnecting and removing dispatch requests, and your code applies them:\n- Drawing from a card's handle to another card, or pressing C on one card and\n  Enter on another, dispatches `helix-connect`.\n- Delete on a card or a connection dispatches `helix-remove`. The event names\n  every connection that removing the card would leave without an end.\n\nOnce your page removes what Delete asked for, focus moves to the next stop,\nto the one before where it was the last, and to the board where none is\nleft. A focused card your page removes for its own reasons hands focus on\nthe same way, unless the reader has already moved focus somewhere else.\n\nThe board applies a move itself, because the card already exists. A\nconnection is a new element, and React discards an element the board adds to\nits markup on the next render, so you write the connection.\n\n**`edgeRoute` draws the connections' lines your own way**: a function from\nwhere a line leaves and arrives, and the sides it does, to its SVG path, for\na route such as one that bends around the cards between. What it returns\nis the line drawn, the line pressed and focused, and the one an arrowhead\nsits at the end of. Nothing back draws the board's own.\n\nAdd `minimap` to `controls` for a picture of the whole board in a corner:\neach card as a box, and a frame around what is on screen. A press or a drag\non it brings that place to the middle of the view. It is for a pointer, and\na screen reader skips it: the arrow keys and `show()` reach every card.\n\nCards and connections are `helix-canvas-node` and `helix-canvas-edge`\nelements, so they are in the served markup whichever renderer wrote them. The\nlibrary fetches nothing, and an array passed to an element is missing from\nthe first paint of a server-rendered React page. `fromJsonCanvas` turns a\nJSON Canvas document into their props, and `toJsonCanvas()` writes a board\nback out.",
           "name": "HelixHeadlessCanvas",
           "cssProperties": [
             {
@@ -15707,6 +15848,18 @@
               "description": "The box a Shift-drag across the empty board draws, which selects the cards it touches.",
               "name": "marquee"
             },
+            {
+              "description": "The picture of the whole board, under `controls=\"minimap\"`.",
+              "name": "minimap"
+            },
+            {
+              "description": "One card in the minimap.",
+              "name": "minimap-node"
+            },
+            {
+              "description": "The frame in the minimap around what is on screen.",
+              "name": "minimap-view"
+            },
             {
               "description": "The button that moves the board down.",
               "name": "pan-down"
@@ -15919,6 +16072,14 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "edgeRoute",
+              "type": {
+                "text": "CanvasRoute | undefined"
+              },
+              "description": "Draws every connection's line: a function from where it leaves and\narrives, and the sides it does, to its SVG path and where its label sits.\n\nAbsent, or returning nothing for a connection, draws the board's own\nroute. A function that throws draws the board's own too, and the error is\nreported to the page as an uncaught one. Set it as a property."
+            },
             {
               "kind": "field",
               "name": "fallbackLabel",
@@ -17118,6 +17279,49 @@
               ],
               "description": "The line a connection is drawn along on the plane, and its middle, where\nboth its cards are on the board; nothing where either is not."
             },
+            {
+              "kind": "method",
+              "name": "draw",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{ d: string; mid: { x: number; y: number } }"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "edge",
+                  "type": {
+                    "text": "CanvasEdge"
+                  }
+                },
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "CanvasNode"
+                  }
+                },
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "CanvasNode"
+                  }
+                },
+                {
+                  "name": "path",
+                  "type": {
+                    "text": "CanvasPath"
+                  }
+                },
+                {
+                  "name": "drawnHeads",
+                  "type": {
+                    "text": "{ start: boolean; end: boolean }"
+                  }
+                }
+              ],
+              "description": "One connection's line, by `edgeRoute` where it draws one, and by the board's own where not."
+            },
             {
               "kind": "method",
               "name": "cardOf",
@@ -18411,6 +18615,44 @@
               ],
               "description": "The connection being made, drawn from where it starts to the pointer, or to\nthe card a keyboard reader is on."
             },
+            {
+              "kind": "field",
+              "name": "onScreen",
+              "type": {
+                "text": "{ x: number; y: number; width: number; height: number }"
+              },
+              "privacy": "private",
+              "description": "The part of the document on screen, in its own units.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "minimapArea",
+              "type": {
+                "text": "{ x: number; y: number; width: number; height: number }"
+              },
+              "privacy": "private",
+              "description": "What the minimap shows: every card and what is on screen, with room around them.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "handleMinimapPointer",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press or a drag on the minimap, which brings the place under it to the\nmiddle of the view.\n\n**The point is read through the picture's own scale**: the area is drawn\nwhole and centered in the box, so the box's spare width or height is split\neither side of it."
+            },
+            {
+              "kind": "method",
+              "name": "renderMinimap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "The minimap, under `controls=\"minimap\"`: each card as a box, and a frame\naround what is on screen.\n\n**A picture for a pointer**, hidden from screen readers and taking no\nfocus, as a map's own overview is: the arrow keys and `show()` already take\na keyboard to any card, and a second way that says nothing a reader can\nuse would be a stop that does nothing."
+            },
             {
               "kind": "field",
               "name": "controls",
@@ -20095,6 +20337,22 @@
             "module": "./canvas-document.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CanvasRoute",
+          "declaration": {
+            "name": "CanvasRoute",
+            "module": "./canvas-document.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CanvasRouteEnds",
+          "declaration": {
+            "name": "CanvasRouteEnds",
+            "module": "./canvas-document.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CanvasSide",
@@ -25806,7 +26064,35 @@
                   }
                 }
               ],
-              "description": "Moves focus to turn `at`, drawing it first where the transcript is\nwindowed and it is not drawn.\n\n**A turn takes focus only once a reader moves to it**, so the\n`tabindex=\"-1\"` a turn written as a child needs is written then, long\nafter any server's markup has hydrated, and never on a turn nobody moved\nto."
+              "description": "Moves focus to turn `at`, drawing it first where the transcript is\nwindowed and it is not drawn.\n\n**A turn takes focus only once a reader moves to it**, so the `tabindex`\nit needs is written then, long after any server's markup has hydrated,\nand never on a turn nobody moved to."
+            },
+            {
+              "kind": "field",
+              "name": "stop",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private",
+              "description": "The turn that is a tab stop because a reader moved to it."
+            },
+            {
+              "kind": "method",
+              "name": "visit",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "turn",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Focuses a turn, making it the transcript's one stop a reader moved to.\n\n**`0`, and never `-1`.** Chromium leaves the whole of a shadow host at a\nnegative `tabindex` out of the Tab order, its own controls and what is\nslotted into it alike, so a turn at `-1` lost its links and its Try again\nonce a reader had paged through it. The stop moves with the reader, and a\n`tabindex` you wrote on a turn is left as it is."
             },
             {
               "kind": "method",
@@ -30545,6 +30831,30 @@
           ],
           "description": "The files in a unified diff, each with its hunks.\n\n**A hunk is read to the counts its header states**, `@@ -12,7 +12,8"
         },
+        {
+          "kind": "function",
+          "name": "changedWords",
+          "return": {
+            "type": {
+              "text": "[DiffPiece[], DiffPiece[]] | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "before",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "after",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The runs of two paired lines that the other line does not have, by the\nlongest run of words they share in order.\n\n**Space between two changes is part of the change**, so \"a b\" replaced by\n\"c d\" is one run, with no gap for the eye to bridge. Two lines\nthat share no word share nothing worth marking: the whole line is the\nchange, which its own wash already says, and `undefined` draws it whole."
+        },
         {
           "kind": "function",
           "name": "pairLines",
@@ -30562,6 +30872,30 @@
             }
           ],
           "description": "A hunk's lines paired for a side-by-side view.\n\nContext sits on both sides. A run of removals followed by a run of additions\nis one change, and its lines are paired in order, the longer run's remainder\nstanding opposite nothing: that is what lets the eye read a changed line\nacross rather than hunting for it further down."
+        },
+        {
+          "kind": "function",
+          "name": "foldContext",
+          "return": {
+            "type": {
+              "text": "DiffRun[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "lines",
+              "type": {
+                "text": "DiffLine[]"
+              }
+            },
+            {
+              "name": "keep",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "A hunk's lines with each long run of unchanged lines folded, keeping `keep`\nlines on the side of each change, as a code host draws a diff with more\ncontext than a reader needs.\n\nA fold hides two lines or more: a control in place of one line is no\nshorter than the line."
         }
       ],
       "exports": [
@@ -30573,6 +30907,14 @@
             "module": "src/code-block/patch.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "changedWords",
+          "declaration": {
+            "name": "changedWords",
+            "module": "src/code-block/patch.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "pairLines",
@@ -30580,6 +30922,14 @@
             "name": "pairLines",
             "module": "src/code-block/patch.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "foldContext",
+          "declaration": {
+            "name": "foldContext",
+            "module": "src/code-block/patch.ts"
+          }
         }
       ]
     },
@@ -30589,7 +30939,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Renders a `<pre><code>` pair: `pre` keeps the whitespace, and `code` marks it\nas code. Long lines scroll inside the block and do not wrap, because a line\nbreak can be significant in code.\n\nA copy button is on by default. Set `no-copy` to remove it. The button copies\nthe slotted text, so there is no second copy of the code to keep in sync.\n\nFor a fragment of code inside a sentence, use `Code`.\n\nSet `line-numbers` to number the lines in a gutter beside the code, hidden\nfrom the accessibility tree and left out of a copy. Set `mark-lines` to\nmark lines a reader should look at, such as `2, 4-6`: the block draws a\nband behind each run, placed where the lines are laid out, so it follows a\nhighlighter's markup and lines that wrap. Set `wrap` to wrap long lines\nrather than scroll them; a gutter then numbers each line where it starts.\nSet `wrappable` for a button in the header that turns `wrap` on and off,\npressed while the lines wrap.\n\nThe header holds the name, the `actions` slot, and the copy button. Slot a\ncontrol into `actions`, such as a button that sets `wrap` or one that opens\nthe code in an editor, and the block draws a header for it even with no\nname. `copy-icon` and `copied-icon` replace the copy button's two icons. Set `highlight` to a\nfunction that turns the code into highlighted markup, such as one wrapping\nShiki or Prism, and the block draws what it returns; it is handed the\nblock's `language`, so one function serves every block. The code stays in\nthe slot, so the copy button and the page's own text are the code as\nwritten.\n\nSet `expandable` on a block whose height is capped, such as by\n`--code-block-max-block-size`, and a button under it shows every line and\nthen fewer again, as a docs site's long example does. The button is drawn\nonly while the cap hides something, says whether the block is expanded with\n`aria-expanded`, names the block it opens with `aria-controls`, and the block\ncarries `:state(expanded)` while it is.\n\nSet `diff` to show a change. Put a unified diff, the output of `git diff` or\n`diff -u`, in the same slot, and the block draws the lines it added and\nremoved. The block never computes a diff itself. Line numbers come from the\nhunk headers and are hidden from the accessibility tree. Changed lines are\n`<ins>` and `<del>` with the `+` and `-` kept as text, so the change does not\ndepend on color. Each file in the patch is its own block under its own name,\nand its copy button copies the new version of the file. `variant=\"split\"`\nshows the old version beside the new, each removal opposite its replacement.\n\n**A block that scrolls is a tab stop.** While its lines run past its width or\nits cap, the scroller is a region named for the block, such as \"Code,\napp.ts\", that Tab reaches, so a keyboard scrolls it with the arrow keys in\nevery browser. Chromium and Firefox make a scrolling box focusable on their\nown, and Safari does not. A block that fits is no stop at all.\n\n**The code the block draws is marked untranslated**, `translate=\"no\"` on\nits `<pre>`, so a page translator leaves highlighted lines and a diff as\nwritten. Code in the slot takes its translation mode from the element, which\nwrites nothing onto itself, so set `translate=\"no\"` on the element to keep a\ntranslator off plain code too.\n\nOn the server, the slot renders as ordinary code, so a diff first appears as\nthe patch text in a `<pre>`. The client makes the same first render, which\nkeeps hydration clean, and draws the diff once it can read the content. Diff\nmode is experimental. The rest of the family is stable.",
+          "description": "Renders a `<pre><code>` pair: `pre` keeps the whitespace, and `code` marks it\nas code. Long lines scroll inside the block and do not wrap, because a line\nbreak can be significant in code.\n\nA copy button is on by default. Set `no-copy` to remove it. The button copies\nthe slotted text, so there is no second copy of the code to keep in sync.\n\nFor a fragment of code inside a sentence, use `Code`.\n\nSet `line-numbers` to number the lines in a gutter beside the code, hidden\nfrom the accessibility tree and left out of a copy. Set `mark-lines` to\nmark lines a reader should look at, such as `2, 4-6`: the block draws a\nband behind each run, placed where the lines are laid out, so it follows a\nhighlighter's markup and lines that wrap. Set `wrap` to wrap long lines\nrather than scroll them; a gutter then numbers each line where it starts.\nSet `wrappable` for a button in the header that turns `wrap` on and off,\npressed while the lines wrap.\n\nThe header holds the name, the `actions` slot, and the copy button. Slot a\ncontrol into `actions`, such as a button that sets `wrap` or one that opens\nthe code in an editor, and the block draws a header for it even with no\nname. `copy-icon` and `copied-icon` replace the copy button's two icons. Set `highlight` to a\nfunction that turns the code into highlighted markup, such as one wrapping\nShiki or Prism, and the block draws what it returns; it is handed the\nblock's `language`, so one function serves every block. The code stays in\nthe slot, so the copy button and the page's own text are the code as\nwritten.\n\nSet `expandable` on a block whose height is capped, such as by\n`--code-block-max-block-size`, and a button under it shows every line and\nthen fewer again, as a docs site's long example does. The button is drawn\nonly while the cap hides something, says whether the block is expanded with\n`aria-expanded`, names the block it opens with `aria-controls`, and the block\ncarries `:state(expanded)` while it is.\n\nSet `diff` to show a change. Put a unified diff, the output of `git diff` or\n`diff -u`, in the same slot, and the block draws the lines it added and\nremoved. The block never computes a diff itself. Line numbers come from the\nhunk headers and are hidden from the accessibility tree. Changed lines are\n`<ins>` and `<del>` with the `+` and `-` kept as text, so the change does not\ndepend on color. Where a removed line is paired with the added line that\nreplaced it, the words each does not share with the other are the `changed`\npart, so the eye goes to what changed within the line. Each file in the patch is its own block under its own name,\nand its copy button copies the new version of the file. `variant=\"split\"`\nshows the old version beside the new, each removal opposite its replacement.\n`context-lines` folds each long run of unchanged lines, keeping that many\nbeside each change, behind a button that shows them and hides them again,\nas a code host draws a diff written with more context than a reader needs.\n\n**A block that scrolls is a tab stop.** While its lines run past its width or\nits cap, the scroller is a region named for the block, such as \"Code,\napp.ts\", that Tab reaches, so a keyboard scrolls it with the arrow keys in\nevery browser. Chromium and Firefox make a scrolling box focusable on their\nown, and Safari does not. A block that fits is no stop at all.\n\n**The code the block draws is marked untranslated**, `translate=\"no\"` on\nits `<pre>`, so a page translator leaves highlighted lines and a diff as\nwritten. Code in the slot takes its translation mode from the element, which\nwrites nothing onto itself, so set `translate=\"no\"` on the element to keep a\ntranslator off plain code too.\n\nOn the server, the slot renders as ordinary code, so a diff first appears as\nthe patch text in a `<pre>`. The client makes the same first render, which\nkeeps hydration clean, and draws the diff once it can read the content. Diff\nmode is experimental. The rest of the family is stable.",
           "name": "HelixHeadlessCodeBlock",
           "cssProperties": [
             {
@@ -30622,6 +30972,10 @@
               "description": "The scrolling `<pre>`.",
               "name": "block"
             },
+            {
+              "description": "In a diff, the words of a changed line that the line opposite it does not have, inside its `text`.",
+              "name": "changed"
+            },
             {
               "description": "The `<code>` inside it.",
               "name": "code"
@@ -30706,6 +31060,10 @@
               "description": "In a split diff, the empty row opposite a line the other side does not have.",
               "name": "filler"
             },
+            {
+              "description": "In a diff with `context-lines`, the button that shows a folded run of unchanged lines, and hides it again, saying which with `aria-expanded`.",
+              "name": "fold"
+            },
             {
               "description": "The code, and the copy button beside it where there is no header.",
               "name": "frame"
@@ -30831,6 +31189,15 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "contextLines",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "In a diff, how many unchanged lines to keep beside each change. Each\nlonger run of unchanged lines is folded behind a button that shows it.\nUnset shows every line the diff holds.",
+              "attribute": "context-lines"
+            },
             {
               "kind": "field",
               "name": "copiedLabel",
@@ -30904,6 +31271,19 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "hideUnchangedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count, plural, one {Hide # unchanged line} other {Hide # unchanged lines}}'",
+              "description": "The words of a button that hides a run of unchanged lines it showed, in a\ndiff with `context-lines`. `{count}` is how many, and each language\nwrites the forms it has.",
+              "attribute": "hide-unchanged-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "highlight",
@@ -30964,6 +31344,19 @@
               "attribute": "no-copy",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "showUnchangedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count, plural, one {Show # unchanged line} other {Show # unchanged lines}}'",
+              "description": "The words of a button that shows a folded run of unchanged lines, in a\ndiff with `context-lines`. `{count}` is how many.",
+              "attribute": "show-unchanged-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "variant",
@@ -31039,6 +31432,68 @@
               "description": "The files in the content, when it is a diff and it can be read yet.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "unfolded",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<string>()",
+              "description": "The folds a reader opened, by file, hunk and the line each starts at."
+            },
+            {
+              "kind": "method",
+              "name": "runsOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "DiffRun[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "hunk",
+                  "type": {
+                    "text": "DiffHunk"
+                  }
+                }
+              ],
+              "description": "A hunk's lines in runs, folded where `context-lines` asks."
+            },
+            {
+              "kind": "method",
+              "name": "renderFold",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "run",
+                  "type": {
+                    "text": "DiffRun"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "(one: DiffLine) => TemplateResult"
+                  }
+                },
+                {
+                  "name": "hidden",
+                  "default": "false"
+                }
+              ],
+              "description": "The button over a folded run, and the run once it is open.\n\nA disclosure, so focus stays on the button as the lines appear under it.\nThe new side of a split diff draws the same words hidden from the\naccessibility tree, there to keep the rows level and to answer a press."
+            },
             {
               "kind": "field",
               "name": "text",
@@ -31383,6 +31838,12 @@
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
                 }
               ],
               "description": "The old version beside the new one, row for row.\n\nThe new side's hunk headers are hidden from the accessibility tree, being\nthe old side's text again and there only to keep the rows level."
@@ -31792,6 +32253,14 @@
               "description": "The expand button's words while the block shows every line.",
               "fieldName": "collapseLabel"
             },
+            {
+              "name": "context-lines",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "In a diff, how many unchanged lines to keep beside each change. Each\nlonger run of unchanged lines is folded behind a button that shows it.\nUnset shows every line the diff holds.",
+              "fieldName": "contextLines"
+            },
             {
               "name": "copied-label",
               "type": {
@@ -31846,6 +32315,15 @@
               "description": "The expand button's words while the cap hides lines.",
               "fieldName": "expandLabel"
             },
+            {
+              "name": "hide-unchanged-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count, plural, one {Hide # unchanged line} other {Hide # unchanged lines}}'",
+              "description": "The words of a button that hides a run of unchanged lines it showed, in a\ndiff with `context-lines`. `{count}` is how many, and each language\nwrites the forms it has.",
+              "fieldName": "hideUnchangedLabel"
+            },
             {
               "name": "label",
               "type": {
@@ -31891,6 +32369,15 @@
               "description": "Whether to leave the copy button off.\n\nNegative, which is not a style choice. A boolean attribute is true whenever\nit is *present*, so a `copyable` defaulting to true could never be turned\noff from markup: `copyable=\"false\"` is the string \"false\", which is\npresent, which is true. Measured, and it is why this is named the other way\nround. The platform already writes booleans like this for the same reason,\n`novalidate` and `nomodule` and `noreferrer` among them.\n\n**Reflected, because the gutter is a stylesheet rule.** A sheet reserves\nthe copy button's width with `:host(:not([no-copy]))`, so the attribute is\nwhat decides whether the block pays for a control. Unreflected, setting it\nfrom script takes the button away (`render` reads the property) and leaves\nthe 40px it stood in reserved.\n\nA false boolean reflects as the attribute's absence, so this costs no\n`no-copy=\"\"` on hosts that never asked for one, and the rule about a\nreflected property taking no default is satisfied by the default being\n`false`.",
               "fieldName": "noCopy"
             },
+            {
+              "name": "show-unchanged-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count, plural, one {Show # unchanged line} other {Show # unchanged lines}}'",
+              "description": "The words of a button that shows a folded run of unchanged lines, in a\ndiff with `context-lines`. `{count}` is how many.",
+              "fieldName": "showUnchangedLabel"
+            },
             {
               "name": "variant",
               "type": {
@@ -35219,7 +35706,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The picker on its own, with no field around it, for a settings pane or a\ntoolbar. Color Input shows this element in a panel behind a text field.\n\nThe saturation and brightness square is two `<input type=\"range\">` elements,\nlaid over the square and made invisible, and the handle is drawn from their\nvalues. The keyboard behavior, the announcements, and the touch targets come\nfrom the platform, and there is no `role=\"application\"`.\n\nThe picker works in HSB and derives the value from it. A value set from\noutside is read into the model once. Black is `brightness: 0`, which has no\nhue or saturation, so a model read back from the value would turn red into\ngray after you drag to the bottom of the square and back.\n\nThe square is one tab stop. In it, the up and down arrows move brightness\nand the left and right arrows move saturation, and PageUp and PageDown move\nbrightness by ten. The picker sends `input` as the color moves and `change`\nwhen a drag, a key, a typed value or a preset settles it, as\n`<input type=\"color\">` does.\n\nA screen reader hears the color's name, such as \"vibrant red\", after the two\nnumbers on the square and after the number on the hue ramp, and each preset\nis named by its color. The opacity ramp is heard as a percentage. Set\n`color-words` to speak the names in another language.\n\n`label` names the picker, which is then a group with that name, and the\nsquare's ramps say it before their own, as \"Brand, Saturation\". `hint`\nwrites help under the picker, which the square, the ramps and the value\nfield are described by. Inside Color Input the field carries both.\n\nThe presets are a listbox with the current color selected, and one tab\nstop. The arrow keys move between them, Home and End go to the ends, and\nEnter, Space or a press chooses one.",
+          "description": "The picker on its own, with no field around it, for a settings pane or a\ntoolbar. Color Input shows this element in a panel behind a text field.\n\nThe saturation and brightness square is two `<input type=\"range\">` elements,\nlaid over the square and made invisible, and the handle is drawn from their\nvalues. The keyboard behavior, the announcements, and the touch targets come\nfrom the platform, and there is no `role=\"application\"`.\n\nThe picker works in HSB and derives the value from it. A value set from\noutside is read into the model once. Black is `brightness: 0`, which has no\nhue or saturation, so a model read back from the value would turn red into\ngray after you drag to the bottom of the square and back.\n\nThe square is one tab stop. In it, the up and down arrows move brightness\nand the left and right arrows move saturation, by ten with Shift. PageUp and\nPageDown move brightness by ten, and Home and End move saturation by ten,\nturned on a right-to-left page as the arrows are, as React Aria's ColorArea\ndoes. The picker sends `input` as the color moves and `change`\nwhen a drag, a key, a typed value or a preset settles it, as\n`<input type=\"color\">` does.\n\nA screen reader hears the color's name, such as \"vibrant red\", after the two\nnumbers on the square and after the number on the hue ramp, and each preset\nis named by its color. The opacity ramp is heard as a percentage. Set\n`color-words` to speak the names in another language.\n\n`label` names the picker, which is then a group with that name, and the\nsquare's ramps say it before their own, as \"Brand, Saturation\". `hint`\nwrites help under the picker, which the square, the ramps and the value\nfield are described by. Inside Color Input the field carries both.\n\nThe presets are a listbox with the current color selected, and one tab\nstop. The arrow keys move between them, Home and End go to the ends, and\nEnter, Space or a press chooses one.",
           "name": "HelixHeadlessColorPicker",
           "cssProperties": [
             {
@@ -36127,7 +36614,7 @@
               "name": "handleAreaKeydown",
               "privacy": "private",
               "readonly": true,
-              "description": "Moves the square from the keyboard, both axes from either of its inputs.\n\nThe square is two native ranges, and a native range maps every arrow to\nits own one axis: on the saturation input, ArrowUp moved the handle\nsideways. Here the vertical keys move brightness and the horizontal keys\nmove saturation, turned on a right-to-left page as the pointer is, which is\nwhat React Aria's ColorArea does."
+              "description": "Moves the square from the keyboard, both axes from either of its inputs.\n\nThe square is two native ranges, and a native range maps every arrow to\nits own one axis: on the saturation input, ArrowUp moved the handle\nsideways. Here the vertical keys move brightness and the horizontal keys\nmove saturation, turned on a right-to-left page as the pointer is, which is\nwhat React Aria's ColorArea does. Shift makes an arrow a step of ten, and\nHome and End are saturation's steps of ten, as PageUp and PageDown are\nbrightness's."
             },
             {
               "kind": "method",
@@ -37971,7 +38458,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The list is a `Listbox`, which handles filtering, the empty state, the\nhighlight, `aria-activedescendant`, and scrolling an option into view. This\nelement handles the field, the panel, and the communication between them.\n\nThe typed text and the value are separate. The text is a filter: it narrows\nthe list and is then discarded. The value is the option you choose, and the\nfield then shows that option's text. The filter clears on close, so a\nreopened combobox starts from the whole list.\n\nFocus stays in the text field. The arrow keys move through the list with the\nlistbox's public `navigate` method. As typing narrows the list, a screen\nreader hears how many options are left, such as \"3 results\". Emptying the\nfield and leaving it clears a single choice.\n\n**Keyboard.**\n\n| Key | What it does |\n|---|---|\n| Down, Up | On a closed field, opens the list on the chosen option, or the first or the last. In the open list, moves the highlight, round from the last option to the first. |\n| Page Down, Page Up | In the open list, moves the highlight by as many options as the list shows at once. |\n| Enter | Chooses the highlighted option. With nothing left in the list, creates what was typed with `creatable`, or takes it with `allows-custom-value`. On a closed field, submits the form. |\n| Escape | Closes the list and puts the chosen words back. On a closed field, a second Escape clears a single choice. |\n| Tab | Closes the list and moves on. |\n| Backspace | With `multiple`, on an empty field, removes the last tag. |\n| Left | With `multiple`, with the caret at the start of the text, moves to the last tag's remove button. Right on a right-to-left page. |\n| Left, Right on a tag | Move between the tags, and past the last back to the text. |\n| Delete, Backspace on a tag | Removes the tag. |\n| Space, Home, End, letters | Edit the text. |\n\n**ARIA.** The input is the `combobox`, named by the label, with\n`aria-expanded`, `aria-controls` naming the list, `aria-autocomplete`\n(`both` with `suggest`, `list` otherwise) and `aria-activedescendant` on\nthe highlighted option. The list is the listbox `Listbox` describes.\n\nOn Apple devices, where VoiceOver does not read the option the field points\nto, the field says it in a live region as the highlight moves, says how many\noptions there are as the list opens, and says a choice once it is made, as\nReact Aria's combobox does there.\n\nSet `autocomplete` to let a browser's autofill choose an option.\n\nWith `multiple`, each chosen option is a tag in the field with its own remove\ncontrol. The text is the field's one tab stop, and the arrow keys reach the\ntags from it. The panel stays open and the filter clears after each choice, so the\nnext choice starts from the whole list.\n\nWith `creatable`, the combobox offers a create row and fires `helix-create`.\nIt does not add the option. The options are your light DOM, and your\nframework would re-render over an element the combobox inserted, so add the\noption in your event handler.",
+          "description": "The list is a `Listbox`, which handles filtering, the empty state, the\nhighlight, `aria-activedescendant`, and scrolling an option into view. This\nelement handles the field, the panel, and the communication between them.\n\nThe typed text and the value are separate. The text is a filter: it narrows\nthe list and is then discarded. The value is the option you choose, and the\nfield then shows that option's text. The filter clears on close, so a\nreopened combobox starts from the whole list.\n\nFocus stays in the text field. The arrow keys move through the list with the\nlistbox's public `navigate` method. As typing narrows the list, a screen\nreader hears how many options are left, such as \"3 results\". Emptying the\nfield and leaving it clears a single choice.\n\n**Keyboard.**\n\n| Key | What it does |\n|---|---|\n| Down, Up | On a closed field, opens the list on the chosen option, or the first or the last. In the open list, moves the highlight, round from the last option to the first. |\n| Alt with Down, Alt with Up | Opens the list without moving the highlight, and closes it, choosing nothing. |\n| Page Down, Page Up | In the open list, moves the highlight by as many options as the list shows at once. |\n| Enter | Chooses the highlighted option. With nothing left in the list, creates what was typed with `creatable`, or takes it with `allows-custom-value`. On a closed field, submits the form. |\n| Escape | Closes the list and puts the chosen words back. On a closed field, a second Escape clears a single choice. |\n| Tab | Closes the list and moves on. |\n| Backspace | With `multiple`, on an empty field, removes the last tag. |\n| Left | With `multiple`, with the caret at the start of the text, moves to the last tag's remove button. Right on a right-to-left page. |\n| Left, Right on a tag | Move between the tags, and past the last back to the text. |\n| Delete, Backspace on a tag | Removes the tag. |\n| Space, Home, End, letters | Edit the text. |\n\n**ARIA.** The input is the `combobox`, named by the label, with\n`aria-expanded`, `aria-controls` naming the list, `aria-autocomplete`\n(`both` with `suggest`, `list` otherwise) and `aria-activedescendant` on\nthe highlighted option. The list is the listbox `Listbox` describes.\n\nOn Apple devices, where VoiceOver does not read the option the field points\nto, the field says it in a live region as the highlight moves, says how many\noptions there are as the list opens, and says a choice once it is made, as\nReact Aria's combobox does there.\n\nSet `autocomplete` to let a browser's autofill choose an option.\n\nWith `multiple`, each chosen option is a tag in the field with its own remove\ncontrol. The text is the field's one tab stop, and the arrow keys reach the\ntags from it. The panel stays open and the filter clears after each choice, so the\nnext choice starts from the whole list.\n\nWith `creatable`, the combobox offers a create row and fires `helix-create`.\nIt does not add the option. The options are your light DOM, and your\nframework would re-render over an element the combobox inserted, so add the\noption in your event handler.",
           "name": "HelixHeadlessCombobox",
           "cssParts": [
             {
@@ -48330,6 +48817,10 @@
               "description": "While `error-text` is set.",
               "name": "error"
             },
+            {
+              "description": "While `loading` is set, as the rows are on their way.",
+              "name": "loading"
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -65972,6 +66463,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "dismiss",
@@ -101285,7 +101805,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Wraps a map drawn by MapLibre, Leaflet, or another renderer. The frame adds\na name for the map, a column of controls, and a strip for the map credit.\nHelix does not draw the map itself.\n\nThe controls are one column, and `controls` names which ones: `fullscreen`,\n`layers`, `tilt`, `zoom`, and `compass`, top to bottom. `zoom compass\nfullscreen` by default. The compass's needle points north as the map turns,\nand pressing it turns the map to face north.\n\nAdd `pan` and `rotate` for buttons around the compass that move and turn the\nmap. Dragging is otherwise the only way a pointer moves the map, so add them\nwhere the map has to be usable without dragging, as WCAG 2.2 asks at level\nAA. The arrow keys pan the map and Shift with Left or Right turns it either\nway.\n\nThe pan and zoom buttons and the arrow keys send `helix-map-pan` and\n`helix-map-zoom`. Move your map in response, or connect it with\n`connectMap` from `@fusion.dev/helix-map`, which does this for you.\n\nAdd `tilt` to `controls` for the 3D button, which a map with 3D buildings\nor terrain needs. It is a toggle. Pressed, it tilts the map 50 degrees, and\n`connectMap` raises the buildings and the ground. Pressed again, it makes the\nmap flat, and lays them flat too. Shift with Up or Down tilts the map in\nsteps. Turning and tilting send `helix-map-rotate` and `helix-map-tilt`,\nwhich `connectMap` answers on MapLibre. Leaflet draws maps flat and does not\nrotate.\n\nAdd `layers` to `controls` for a layers button. It opens a menu with a tile\nfor each layer, which sets the layer's `hidden` attribute. Layers with the\nsame `group`, such as a route and its dotted legs, share one tile. A tile\nsends `helix-before-toggle` from the layer first, so you can store the\nchoice or refuse it, and `helix-toggle` from it once `hidden` holds the\nchoice.\n\nImagery, a `helix-map-raster` with `ground`, is a map type and not a tile.\nThe menu opens with a card for each type, Standard, Hybrid, and Satellite,\nwith a picture of the map in it, and `map-type` says which is chosen.\nStandard hides the imagery, Hybrid draws it under the roads and names, and\nSatellite draws it alone. Choosing one sends `helix-before-change` with its\nname, and `change` once `map-type` holds it. `connectMap` does not draw a\nhidden layer, so a layer you write with `hidden` starts turned off.\n\nMarkers, routes, areas, live positions, and points layers go inside the\nframe as child elements.",
+          "description": "Wraps a map drawn by MapLibre, Leaflet, or another renderer. The frame adds\na name for the map, a column of controls, and a strip for the map credit.\nHelix does not draw the map itself.\n\nThe controls are one column, and `controls` names which ones: `fullscreen`,\n`layers`, `tilt`, `zoom`, and `compass`, top to bottom. `zoom compass\nfullscreen` by default. The compass's needle points north as the map turns,\nand pressing it turns the map to face north.\n\nAdd `pan` and `rotate` for buttons around the compass that move and turn the\nmap. Dragging is otherwise the only way a pointer moves the map, so add them\nwhere the map has to be usable without dragging, as WCAG 2.2 asks at level\nAA. The arrow keys pan the map and Shift with Left or Right turns it either\nway.\n\nThe pan and zoom buttons and the arrow keys send `helix-map-pan` and\n`helix-map-zoom`. Move your map in response, or connect it with\n`connectMap` from `@fusion.dev/helix-map`, which does this for you.\n\nAdd `tilt` to `controls` for the 3D button, which a map with 3D buildings\nor terrain needs. It is a toggle. Pressed, it tilts the map 50 degrees, and\n`connectMap` raises the buildings and the ground. Pressed again, it makes the\nmap flat, and lays them flat too. Shift with Up or Down tilts the map in\nsteps. Turning and tilting send `helix-map-rotate` and `helix-map-tilt`,\nwhich `connectMap` answers on MapLibre. Leaflet draws maps flat and does not\nrotate.\n\nAdd `layers` to `controls` for a layers button. It opens a menu with a tile\nfor each layer, which sets the layer's `hidden` attribute. Layers with the\nsame `group`, such as a route and its dotted legs, share one tile. A tile\nsends `helix-before-toggle` from the layer first, so you can store the\nchoice or refuse it, and `helix-toggle` from it once `hidden` holds the\nchoice. Escape closes the menu and returns focus to its button, and the menu\ncloses when focus moves on from it or a press lands outside the map.\n\nImagery, a `helix-map-raster` with `ground`, is a map type and not a tile.\nThe menu opens with a card for each type, Standard, Hybrid, and Satellite,\nwith a picture of the map in it, and `map-type` says which is chosen.\nStandard hides the imagery, Hybrid draws it under the roads and names, and\nSatellite draws it alone. Choosing one sends `helix-before-change` with its\nname, and `change` once `map-type` holds it. `connectMap` does not draw a\nhidden layer, so a layer you write with `hidden` starts turned off.\n\nMarkers, routes, areas, live positions, and points layers go inside the\nframe as child elements.",
           "name": "HelixHeadlessMap",
           "cssProperties": [
             {
@@ -102068,6 +102588,13 @@
               "readonly": true,
               "description": "Closes the layers menu on a press anywhere outside the frame."
             },
+            {
+              "kind": "field",
+              "name": "handleMenuFocusOut",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Closes the layers menu when focus moves on from its button and the menu,\nas a Tab past the last tile does. Focus leaving the page, with nothing\nfocused in its place, leaves the menu as it is."
+            },
             {
               "kind": "field",
               "name": "handleMenuKeydown",
@@ -106768,7 +107295,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "One element covers three kinds of row, and what you give it decides which:\n- Content in the `submenu` slot makes the row open a submenu page.\n- `checked` makes the row a choice.\n- With neither, the row is a command.\n\nThe role follows the kind. A row with `checked` is `menuitemcheckbox` with\n`aria-checked`, and `exclusive` makes it `menuitemradio`, for a set where\nonly one can be on. A row that opens a page keeps `menuitem` and sets\n`aria-haspopup`.\n\nChoosing a choice row checks or unchecks it before `helix-select` is sent,\nso a listener reads the new `checked`. An `exclusive` row turns on and turns\noff the `exclusive` rows next to it. Cancel `helix-before-toggle` to keep a\nrow as it is and set `checked` yourself.\n\nThe menu sets whether the row's page is showing as a property, never as an\nattribute. An attribute written onto your element after it upgrades causes a\nhydration mismatch.\n\n`shortcut` shows a row's keyboard shortcut after its label, drawn by `Kbd`\nin the platform's glyphs, and gives the row `aria-keyshortcuts`. It binds\nnothing: the shortcut is the page's to bind. Other trailing words, such as a\ncount, go in the `end` slot.\n\nThe row is named by its label alone. Words in `description`, a line under the\nlabel, and in `end` describe it instead, through `aria-describedby`, as\nReact Aria's menu item does with its description: a reader hears \"Copy\",\nthen \"Copies the selection\".\n\nA development build warns when a row has no words to be named by, such as a\nrow holding only an icon with no label.\n\nThe check mark and the caret are the fallbacks of the `check` and `chevron`\nslots, so a mark of your own replaces either by being slotted. Neither is\nread as part of the row's name.",
+          "description": "One element covers three kinds of row, and what you give it decides which:\n- Content in the `submenu` slot makes the row open a submenu page.\n- `checked` makes the row a choice.\n- With neither, the row is a command.\n\nThe role follows the kind. A row with `checkable` or `checked` is\n`menuitemcheckbox` with `aria-checked`, and an `exclusive` row is\n`menuitemradio`, for a set where only one can be on. A row that opens a page\nkeeps `menuitem` and sets `aria-haspopup`.\n\nChoosing a choice row checks or unchecks it before `helix-select` is sent,\nso a listener reads the new `checked`. An `exclusive` row turns on and turns\noff the `exclusive` rows next to it. Cancel `helix-before-toggle` to keep a\nrow as it is and set `checked` yourself.\n\nSpace on a choice row changes it and leaves the menu open, so a reader can\nset several in a row, as the APG's menu does. Enter and a press change it and\nclose the menu. `close-on-select=\"false\"` on the row keeps the menu open after\nany choice of it, and `close-on-select` on the row closes it after a Space as\nwell.\n\nThe menu sets whether the row's page is showing as a property, never as an\nattribute. An attribute written onto your element after it upgrades causes a\nhydration mismatch.\n\n`shortcut` shows a row's keyboard shortcut after its label, drawn by `Kbd`\nin the platform's glyphs, and gives the row `aria-keyshortcuts`. It binds\nnothing: the shortcut is the page's to bind. Other trailing words, such as a\ncount, go in the `end` slot.\n\nThe row is named by its label alone. Words in `description`, a line under the\nlabel, and in `end` describe it instead, through `aria-describedby`, as\nReact Aria's menu item does with its description: a reader hears \"Copy\",\nthen \"Copies the selection\".\n\nA development build warns when a row has no words to be named by, such as a\nrow holding only an icon with no label.\n\nThe check mark and the caret are the fallbacks of the `check` and `chevron`\nslots, so a mark of your own replaces either by being slotted. Neither is\nread as part of the row's name.",
           "name": "HelixHeadlessMenuItem",
           "cssParts": [
             {
@@ -106846,7 +107373,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the row is one of a set of choices.\n\nSeparate from `checked`, and it has to be. A row that is off is still a\nchoice, and `checked` alone cannot say so: an unticked row and a row that\nwas never tickable look identical from here. Announcing only the ticked one\nas a checkbox tells a reader its siblings are commands, which is the one\nthing they are not.\n\n`checked` implies it, so a row that is on never has to say both.\n\nChoosing the row checks or unchecks it, after a `helix-before-toggle` that\nyou can cancel.",
+              "description": "Whether the row is one of a set of choices.\n\nSeparate from `checked`, and it has to be. A row that is off is still a\nchoice, and `checked` alone cannot say so: an unticked row and a row that\nwas never tickable look identical from here. Announcing only the ticked one\nas a checkbox tells a reader its siblings are commands, which is the one\nthing they are not.\n\n`checked` and `exclusive` imply it, so a row that is on, or one of a set,\nnever has to say both.\n\nChoosing the row checks or unchecks it, after a `helix-before-toggle` that\nyou can cancel.",
               "attribute": "checkable",
               "reflects": true
             },
@@ -106860,6 +107387,15 @@
               "description": "Whether the row is checked.\n\nThe row changes it when it is chosen. Not reflected: the attribute is the\nstate you start the row in, and `:state(checked)` carries the current one.",
               "attribute": "checked"
             },
+            {
+              "kind": "field",
+              "name": "closeOnSelect",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "Whether choosing the row closes the menu.\n\nUnset takes the menu's `close-on-select`, which is on, and keeps the menu\nopen after a Space on a choice row. Write `close-on-select=\"false\"` for a\nrow that changes something the reader is watching, such as a zoom step.",
+              "attribute": "close-on-select"
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -106888,7 +107424,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether only one row in its set can be checked at a time.\n\nThe set is the run of `exclusive` rows next to this one, up to the first\nelement that is not one, such as a divider. Choosing a row in it checks\nthat row and unchecks the others. Choosing the row that is checked leaves\nit checked. `menuitemradio` tells a reader which kind of set they are in,\nwhere `menuitemcheckbox` says every row is independent.\n\nMeaningless without `checkable`, since a row that cannot be ticked is not\none of a set of anything.",
+              "description": "Whether only one row in its set can be checked at a time.\n\nThe set is the run of `exclusive` rows next to this one, up to the first\nelement that is not one, such as a divider. Choosing a row in it checks\nthat row and unchecks the others. Choosing the row that is checked leaves\nit checked. `menuitemradio` tells a reader which kind of set they are in,\nwhere `menuitemcheckbox` says every row is independent.\n\nIt makes the row a choice, so it needs no `checkable` beside it.",
               "attribute": "exclusive",
               "reflects": true
             },
@@ -107146,7 +107682,14 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "space",
+                  "default": "false"
+                }
+              ],
+              "description": "Chooses the row. `space` is whether a Space chose it, which keeps the menu\nopen on a choice row unless the row says otherwise."
             },
             {
               "kind": "field",
@@ -107154,6 +107697,16 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "spacePressed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the click on its way is the one a Space on a linked row sent."
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -107545,7 +108098,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the row is one of a set of choices.\n\nSeparate from `checked`, and it has to be. A row that is off is still a\nchoice, and `checked` alone cannot say so: an unticked row and a row that\nwas never tickable look identical from here. Announcing only the ticked one\nas a checkbox tells a reader its siblings are commands, which is the one\nthing they are not.\n\n`checked` implies it, so a row that is on never has to say both.\n\nChoosing the row checks or unchecks it, after a `helix-before-toggle` that\nyou can cancel.",
+              "description": "Whether the row is one of a set of choices.\n\nSeparate from `checked`, and it has to be. A row that is off is still a\nchoice, and `checked` alone cannot say so: an unticked row and a row that\nwas never tickable look identical from here. Announcing only the ticked one\nas a checkbox tells a reader its siblings are commands, which is the one\nthing they are not.\n\n`checked` and `exclusive` imply it, so a row that is on, or one of a set,\nnever has to say both.\n\nChoosing the row checks or unchecks it, after a `helix-before-toggle` that\nyou can cancel.",
               "fieldName": "checkable"
             },
             {
@@ -107557,6 +108110,14 @@
               "description": "Whether the row is checked.\n\nThe row changes it when it is chosen. Not reflected: the attribute is the\nstate you start the row in, and `:state(checked)` carries the current one.",
               "fieldName": "checked"
             },
+            {
+              "name": "close-on-select",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "Whether choosing the row closes the menu.\n\nUnset takes the menu's `close-on-select`, which is on, and keeps the menu\nopen after a Space on a choice row. Write `close-on-select=\"false\"` for a\nrow that changes something the reader is watching, such as a zoom step.",
+              "fieldName": "closeOnSelect"
+            },
             {
               "name": "disabled",
               "type": {
@@ -107581,7 +108142,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether only one row in its set can be checked at a time.\n\nThe set is the run of `exclusive` rows next to this one, up to the first\nelement that is not one, such as a divider. Choosing a row in it checks\nthat row and unchecks the others. Choosing the row that is checked leaves\nit checked. `menuitemradio` tells a reader which kind of set they are in,\nwhere `menuitemcheckbox` says every row is independent.\n\nMeaningless without `checkable`, since a row that cannot be ticked is not\none of a set of anything.",
+              "description": "Whether only one row in its set can be checked at a time.\n\nThe set is the run of `exclusive` rows next to this one, up to the first\nelement that is not one, such as a divider. Choosing a row in it checks\nthat row and unchecks the others. Choosing the row that is checked leaves\nit checked. `menuitemradio` tells a reader which kind of set they are in,\nwhere `menuitemcheckbox` says every row is independent.\n\nIt makes the row a choice, so it needs no `checkable` beside it.",
               "fieldName": "exclusive"
             },
             {
@@ -107703,7 +108264,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The trigger is slotted and stays your own element, as with the tooltip. The\nmenu renders its surface in the top layer with the popover API, so an\nancestor with `overflow: hidden` does not clip it and it needs no `z-index`.\n\nSlot a `helix-button` or `helix-icon-button` as the trigger, and the menu\ntells it that it opens a menu and whether the menu is open, inside its own\nshadow root. On a plain element, such as a `<button>`, the menu writes\n`aria-haspopup=\"menu\"` and `aria-expanded`, from a frame after its own first\nrender, so a server's markup is never changed while a framework hydrates it.\nIt never writes `aria-expanded` where you wrote it yourself.\n\nSubmenus drill down by default. A submenu replaces the panel's content, and a\nback row returns to the previous page. One panel stays inside a narrow\nwindow, and works on touch screens, which have no hover.\n\n**`submenus=\"flyout\"` opens each submenu in a panel of its own beside its\nrow**, as React Aria's `SubmenuTrigger` and Radix's `Sub` do. Resting the\npointer on the row opens it, and a pointer crossing toward the open panel\nover the rows between keeps it open, as Radix's grace area does. Right Arrow\nopens a row's submenu on its first row, and Left Arrow or Escape closes it\nand returns focus to the row, the two arrows swapping on a right-to-left\npage. The row says `aria-expanded`, and the panel is a `menu` named by the\nrow.\n\nThe root holds which page is open, because only one page shows at a time. It\nsets this on items as a property, never as an attribute. An attribute written\nonto your element after it upgrades causes a hydration mismatch.\n\nGroup rows under a heading with `Menu.Section`, which is a `group` named by\nits heading. Between runs of rows, a `<helix-divider>` is a separator a\nscreen reader announces.\n\nKeys: Enter, Space or Down Arrow on the trigger opens the menu on its first\nrow, and Up Arrow on its last. In the menu, Up and Down Arrow move between\nrows, Home and End go to the first and the last, a typed letter moves to\nthe next row whose name starts with it, Enter and Space choose, Right Arrow\nopens a row's submenu and Left Arrow goes back, the two swapping on a\nright-to-left page. Left Arrow on the top page does nothing. Escape closes\nthe menu and returns focus to the trigger. Tab closes it and moves on.\n\nWhile it is open, the surface carries the trigger's width as\n`--floating-anchor-inline-size` and the room left below it as\n`--floating-available-block-size`, as Radix's dropdown menu publishes its\ntrigger's width, for a menu as wide as its trigger:\n`helix-menu::part(surface) { min-inline-size: var(--floating-anchor-inline-size) }`.\n\nWith `context`, the trigger is an area and the menu is its context menu: a\nright-click, a long press, Shift+F10 or the menu key over the area opens it\nat the pointer, or at the area's corner from the keyboard, as Radix's context\nmenu does. A press on the area does not open it, and closing it returns focus\nto where it was. A touch or a pen held still on the area opens it too, on\nevery browser, since iOS sends no `contextmenu` for one.\n\n**A trigger with its own action.** With `open-on=\"long-press\"`, a press on\nthe trigger is the trigger's own, and a press held for half a second opens\nthe menu, as React Aria's `trigger=\"longPress\"` does. Alt+Down or Alt+Up\nopens it from the keyboard, and the trigger is described by\n`long-press-label`, which says so.",
+          "description": "The trigger is slotted and stays your own element, as with the tooltip. The\nmenu renders its surface in the top layer with the popover API, so an\nancestor with `overflow: hidden` does not clip it and it needs no `z-index`.\n\nSlot a `helix-button` or `helix-icon-button` as the trigger, and the menu\ntells it that it opens a menu and whether the menu is open, inside its own\nshadow root. On a plain element, such as a `<button>`, the menu writes\n`aria-haspopup=\"menu\"` and `aria-expanded`, from a frame after its own first\nrender, so a server's markup is never changed while a framework hydrates it.\nIt never writes `aria-expanded` where you wrote it yourself.\n\nSubmenus drill down by default. A submenu replaces the panel's content, and a\nback row returns to the previous page. One panel stays inside a narrow\nwindow, and works on touch screens, which have no hover.\n\n**`submenus=\"flyout\"` opens each submenu in a panel of its own beside its\nrow**, as React Aria's `SubmenuTrigger` and Radix's `Sub` do. Resting the\npointer on the row opens it, and a pointer crossing toward the open panel\nover the rows between keeps it open, as Radix's grace area does. Right Arrow\nopens a row's submenu on its first row, and Left Arrow or Escape closes it\nand returns focus to the row, the two arrows swapping on a right-to-left\npage. The row says `aria-expanded`, and the panel is a `menu` named by the\nrow.\n\nThe root holds which page is open, because only one page shows at a time. It\nsets this on items as a property, never as an attribute. An attribute written\nonto your element after it upgrades causes a hydration mismatch.\n\nGroup rows under a heading with `Menu.Section`, which is a `group` named by\nits heading. Between runs of rows, a `<helix-divider>` is a separator a\nscreen reader announces.\n\nKeys: Enter, Space or Down Arrow on the trigger opens the menu on its first\nrow, and Up Arrow on its last. In the menu, Up and Down Arrow move between\nrows, Home and End go to the first and the last, a typed letter moves to\nthe next row whose name starts with it, Enter and Space choose (Space on a\nchoice row changes it and leaves the menu open), Right Arrow\nopens a row's submenu and Left Arrow goes back, the two swapping on a\nright-to-left page. Left Arrow on the top page does nothing. Escape closes\nthe menu and returns focus to the trigger. Tab closes it and moves on.\n\nWhile it is open, the surface carries the trigger's width as\n`--floating-anchor-inline-size` and the room left below it as\n`--floating-available-block-size`, as Radix's dropdown menu publishes its\ntrigger's width, for a menu as wide as its trigger:\n`helix-menu::part(surface) { min-inline-size: var(--floating-anchor-inline-size) }`.\n\nWith `context`, the trigger is an area and the menu is its context menu: a\nright-click, a long press, Shift+F10 or the menu key over the area opens it\nat the pointer, or at the area's corner from the keyboard, as Radix's context\nmenu does. A press on the area does not open it, and closing it returns focus\nto where it was. A touch or a pen held still on the area opens it too, on\nevery browser, since iOS sends no `contextmenu` for one.\n\n**A trigger with its own action.** With `open-on=\"long-press\"`, a press on\nthe trigger is the trigger's own, and a press held for half a second opens\nthe menu, as React Aria's `trigger=\"longPress\"` does. Alt+Down or Alt+Up\nopens it from the keyboard, and the trigger is described by\n`long-press-label`, which says so.",
           "name": "HelixHeadlessMenu",
           "cssProperties": [
             {
@@ -107787,6 +108348,16 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "closeOnSelect",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether choosing a row closes the menu.\n\nOn by default, and a Space on a choice row leaves the menu open either way.\nWrite `close-on-select=\"false\"` to keep the menu open after every choice, as\nArk UI's `closeOnSelect` does. A row's own `close-on-select` wins over this.",
+              "attribute": "close-on-select"
+            },
             {
               "kind": "field",
               "name": "context",
@@ -109146,6 +109717,15 @@
               "description": "The text of the row that returns from a submenu.",
               "fieldName": "backLabel"
             },
+            {
+              "name": "close-on-select",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether choosing a row closes the menu.\n\nOn by default, and a Space on a choice row leaves the menu open either way.\nWrite `close-on-select=\"false\"` to keep the menu open after every choice, as\nArk UI's `closeOnSelect` does. A row's own `close-on-select` wins over this.",
+              "fieldName": "closeOnSelect"
+            },
             {
               "name": "context",
               "type": {
@@ -112595,6 +113175,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "dismiss",
@@ -117105,6 +117714,10 @@
               "description": "The number of entries a branch holds.",
               "name": "count"
             },
+            {
+              "description": "The row shown in the tree while it has no entries to show: no value, or a filter that matched none. It holds the `empty` slot.",
+              "name": "empty"
+            },
             {
               "description": "The tree and the copy button beside it.",
               "name": "frame"
@@ -117170,6 +117783,12 @@
               "name": "value"
             }
           ],
+          "slots": [
+            {
+              "description": "Shown in the tree while it has no entries to show. Defaults to `empty-label`, or `no-matches-label` while a filter matched none.",
+              "name": "empty"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -117226,6 +117845,19 @@
               "description": "How many levels start open.\n\nOne by default: the root is open and everything under it closed, so a\nreader sees the shape of the value before its contents. `0` starts with the\nroot closed; a large number opens everything, which on a big value is the\nwall of text this exists to avoid.",
               "attribute": "default-depth"
             },
+            {
+              "kind": "field",
+              "name": "emptyLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Nothing to show'",
+              "description": "What the tree says while there is no value to show, such as before a\nfetch answers. The `empty` slot replaces it.",
+              "attribute": "empty-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "expanded",
@@ -117341,6 +117973,19 @@
               "description": "Hides the copy button.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.\n\n**It does not reflect, where Code Block's does**, and the difference is what\nthe two sheets need. Code Block reserves the button's width with\n`:host(:not([no-copy]))`, so the attribute has to be there for a consumer\nwho set the property. This button is positioned out of the flow and takes no\nroom, so nothing selects on it, and reflection exists so that a selector can\nreach a value.",
               "attribute": "no-copy"
             },
+            {
+              "kind": "field",
+              "name": "noMatchesLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No matches'",
+              "description": "What the tree says while a filter matched no entry. The `empty` slot\nreplaces it.",
+              "attribute": "no-matches-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "renderValue",
@@ -117610,6 +118255,16 @@
               ],
               "description": "Opens the branches around each path, where the value has them."
             },
+            {
+              "kind": "field",
+              "name": "blank",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the tree has no entries to show. Not while a value named by `for`\nis still to be read, as on a server and while hydrating what one sent,\nwhere it says nothing yet about the value.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "counted",
@@ -118410,6 +119065,15 @@
               "description": "How many levels start open.\n\nOne by default: the root is open and everything under it closed, so a\nreader sees the shape of the value before its contents. `0` starts with the\nroot closed; a large number opens everything, which on a big value is the\nwall of text this exists to avoid.",
               "fieldName": "defaultDepth"
             },
+            {
+              "name": "empty-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Nothing to show'",
+              "description": "What the tree says while there is no value to show, such as before a\nfetch answers. The `empty` slot replaces it.",
+              "fieldName": "emptyLabel"
+            },
             {
               "name": "filter",
               "type": {
@@ -118498,6 +119162,15 @@
               "description": "Hides the copy button.\n\nNegative for the reason Code Block's is: a boolean attribute defaulting to\ntrue could never be turned off from markup.\n\n**It does not reflect, where Code Block's does**, and the difference is what\nthe two sheets need. Code Block reserves the button's width with\n`:host(:not([no-copy]))`, so the attribute has to be there for a consumer\nwho set the property. This button is positioned out of the flow and takes no\nroom, so nothing selects on it, and reflection exists so that a selector can\nreach a value.",
               "fieldName": "noCopy"
             },
+            {
+              "name": "no-matches-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No matches'",
+              "description": "What the tree says while a filter matched no entry. The `empty` slot\nreplaces it.",
+              "fieldName": "noMatchesLabel"
+            },
             {
               "name": "result-label",
               "type": {
@@ -118534,6 +119207,28 @@
               "fieldName": "windowed"
             }
           ],
+          "cssStates": [
+            {
+              "description": "While the tree has no entries to show: no value, or a filter that matched none.",
+              "name": "empty"
+            },
+            {
+              "description": "While `filter` holds text.",
+              "name": "filtered"
+            },
+            {
+              "description": "While `filter` holds text and matched at least one entry.",
+              "name": "matched"
+            },
+            {
+              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
+              "name": "settled",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
           "superclass": {
             "name": "HelixElement",
             "package": "@fusion.dev/helix-core"
@@ -118566,16 +119261,6 @@
           },
           "tagName": "helix-headless-object-inspector",
           "customElement": true,
-          "cssStates": [
-            {
-              "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
-              "name": "settled",
-              "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
-              }
-            }
-          ],
           "modulePath": "src/object-inspector/root/object-inspector-root.ts",
           "definitionPath": "src/object-inspector/root/object-inspector-root.ts"
         }
@@ -149963,7 +150648,7 @@
                 "text": "number"
               },
               "privacy": "private",
-              "description": "The index of the stage the reader is on, or `-1`.",
+              "description": "The index of the stage the reader is on, or `-1`.\n\nRead from `active` once anything has set it, because a move writes\n`active` at once and each step's `current` only on the next update: two\ncalls to `next()` in one task then move two stages.",
               "readonly": true
             },
             {
@@ -155018,7 +155703,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Lays out the rows on a CSS grid, so every column lines up across rows and\neach row stays a real element that can be styled, hidden, or made\ninteractive. A `<table>` layout aligns columns but limits almost everything\nelse.\n\nA grid of elements has no table structure for assistive technology, so the\nroles are set explicitly: `table`, `row`, `cell`, `columnheader`, and\n`rowheader` for a `header` cell in a row of values. Rows are\n`display: contents`, so their cells become items of the one grid.\n\n**Sorting.** A column with `sortable` and a `field` draws its heading as a\nbutton that sorts the rows by the text of its cells, numbers by their value.\nYour markup is not reordered: the table draws the rows in the sorted order.\n\n1. Each press cycles the column through ascending, descending, and the\n   order the rows were written in, which keeps a server's own ranking\n   reachable.\n2. `helix-sort` asks first, with `field:direction`, or empty for the written\n   order. Refuse it to keep the order, or to sort the rows yourself and set\n   `sort`.\n3. `helix-sorted` follows once the order stands, and `sort` holds it.\n4. The heading carries `aria-sort`, and a screen reader hears `sorted-label`\n   (\"Sorted by Name, ascending\") or `unsorted-label` from a polite region.\n\nTab reaches each sort button, and Enter or Space presses it.\n\nThe `heading` slot names the table: slot a heading or a line of text into\nit, and the table is named by its words. An `aria-label` or `aria-labelledby` on the\nhost wins over it.\n\n**Selecting.** `selectable` adds a column of checkboxes.\n\n1. Each row is known by its `value`, or by its place among the rows where it\n   has none, and `selected` holds the chosen keys, comma separated, the same\n   shape `DataTable` uses. `default-selected` is where it starts.\n2. A row's checkbox is named by `select-row-label` (\"Select {row}\") with the\n   words of the row's first cell. The checkbox in the heading selects every\n   row, and shows a dash while only some are chosen.\n3. `helix-select` asks first, with every key the change would leave.\n   Refuse it to keep the selection. `helix-selected` follows once it stands.\n4. A chosen row takes `:state(selected)`, and a screen reader hears\n   `selected-label` (\"2 selected\") from a polite region.\n\nTab reaches each checkbox, and Space ticks it. To act on one row, put a\nlink or a button in a cell, or give the row an `href`.\n\n`selection-mode=\"single\"` selects one row at a time: ticking a row lets go\nof the one before, the heading holds no checkbox, and Shift and Control with\nA take in nothing more. `selection-behavior=\"replace\"` makes a press on a\nrow, anywhere but its own controls, select it alone, as a file list does,\nand in a `grid` table the arrow keys carry the selection with them. Control\nor Command with a press adds or takes out the row, and with an arrow moves\nwithout selecting. Shift with a press takes in the rows from the one last\nchosen.\n\n**Nesting rows.** A row with `parent` sits under the row of that key, as\na file sits in a folder. The table then draws a column of disclosure\nbuttons, under a heading named by `expand-column-label`: a row with rows\nunder it has a button named by `expand-row-label` (\"Expand {row}\") that\nsays with `aria-expanded` whether it is open, and the rows under a shut row\nare not drawn. `expanded` holds the open rows' keys, comma separated, and\n`default-expanded` is where it starts. A press asks with\n`helix-before-toggle` and tells with `helix-toggle`, both from the row, so\nyou can refuse it or load the rows on the way. A sort orders the rows\nunder each row among themselves, and in a `grid` table the table is a\n`treegrid` whose rows say their depth.\n\n**Moving rows.** `reorderable` adds a column of grips before the checkboxes,\nunder a heading named by `row-grips-label`.\n\n1. Each row is known by its `value`, or by its place among the rows where it\n   has none, as for selecting. Give rows a `value` when they move, so a key\n   stays with its row.\n2. A grip is a button named by `move-row-label` (\"Move {row}\") with the\n   words of the row's first cell. Drag it to move its row, and the page\n   scrolls near an edge. Or press it with Space, Enter, or a click to pick\n   the row up, move it with Up, Down, Home, and End, and press it again to\n   drop it. A click on another row drops it there, and Escape puts it back.\n3. `helix-before-reorder` asks first, and `helix-reorder` follows with\n   `keys`, every row's key in the new order. **You move the rows**: the\n   table moves no element of yours, and focus goes back to the moved row's\n   grip once you have.\n4. Each step is said in the table's live region, in words you can change:\n   `picked-up-label`, `moved-label`, `dropped-label`, and `canceled-label`.\n   The grips do nothing while a sort is set.\n\n**A grid.** `grid` makes the table one tab stop that the arrow keys move\nthrough cell by cell, the headings included, as React Aria's table is. The\ntable is then a `grid` and each value a `gridcell`, and the table gives\nevery cell a `tabindex` so focus can rest on it: set `grid` only where the\ncells may carry one.\n\n| Key | What it does |\n|---|---|\n| Right, Left | Moves one cell along the row. Left moves on, on a right-to-left page. |\n| Down, Up | Moves one row, the headings included. |\n| Home, End | Moves to the first or the last cell of the row. |\n| Control with Home or End | Moves to the first or the last cell of the table. |\n| Page Down, Page Up | Moves by the rows that fit in view. |\n| Enter, F2 | Moves into the cell's links and controls. Escape or F2 moves back to the cell, and Tab moves between the controls of one cell. |\n| Enter on a cell of a row with `href` | Follows the row's link. |\n| Enter, Space on a sortable heading | Sorts by the column. |\n| Space on a row, Enter or Space on its checkbox cell | Selects the row, in a `selectable` table. |\n| Enter or Space on a disclosure cell | Shows or hides the rows under the row, in a table whose rows nest. |\n| Enter or Space on a grip cell | Picks the row up, or drops it, in a `reorderable` table. Up, Down, Home, and End move a row picked up, and Escape puts it back. |\n| Down, Up, Page Down, Page Up under `selection-behavior=\"replace\"` | Selects the row it moves to alone. Control or Command with the key moves without selecting. |\n| Shift with Down or Up | Selects the rows it moves across, in a `selectable` table. |\n| Shift with Space | Selects every row from the one last chosen, in a `selectable` table. |\n| Control or Command with A | Selects every row, in a `selectable` table. |\n| A letter or a word | Moves to the next row whose first cell starts with what you typed. |\n| Tab | Leaves the table. |\n\n**Loading more.** `load-more` sends `helix-load-more` once the end of the\ntable comes within a screen of view, in the box that scrolls it or the\npage, once for each number of rows: add rows and it can send it again. Set\n`loading` while you fetch, and the table asks for nothing until it clears.\n\nWhen the rows did not load, set `error-text`, such as \"The orders did not\nload\", and put a button that tries again in the `error` slot. The line shows\nafter the rows in place of the empty and loading lines, the live region says\nit, and the table takes the `error` state. Clear it once you try again.\n\nThe CSS custom properties listed for this component are written by it and\nread by the stylesheet that draws it. Do not set them. Each holds a number\nthe component computes and CSS cannot, so the stylesheet can draw the table\nwithout measuring anything.",
+          "description": "Lays out the rows on a CSS grid, so every column lines up across rows and\neach row stays a real element that can be styled, hidden, or made\ninteractive. A `<table>` layout aligns columns but limits almost everything\nelse.\n\nA grid of elements has no table structure for assistive technology, so the\nroles are set explicitly: `table`, `row`, `cell`, `columnheader`, and\n`rowheader` for a `header` cell in a row of values. Rows are\n`display: contents`, so their cells become items of the one grid.\n\n**Sorting.** A column with `sortable` and a `field` draws its heading as a\nbutton that sorts the rows by the text of its cells, numbers by their value.\nYour markup is not reordered: the table draws the rows in the sorted order.\n\n1. Each press cycles the column through ascending, descending, and the\n   order the rows were written in, which keeps a server's own ranking\n   reachable.\n2. `helix-sort` asks first, with `field:direction`, or empty for the written\n   order. Refuse it to keep the order, or to sort the rows yourself and set\n   `sort`.\n3. `helix-sorted` follows once the order stands, and `sort` holds it.\n4. The heading carries `aria-sort`, and a screen reader hears `sorted-label`\n   (\"Sorted by Name, ascending\") or `unsorted-label` from a polite region.\n\nTab reaches each sort button, and Enter or Space presses it.\n\nThe `heading` slot names the table: slot a heading or a line of text into\nit, and the table is named by its words. An `aria-label` or `aria-labelledby` on the\nhost wins over it.\n\n**Selecting.** `selectable` adds a column of checkboxes.\n\n1. Each row is known by its `value`, or by its place among the rows where it\n   has none, and `selected` holds the chosen keys, comma separated, the same\n   shape `DataTable` uses. `default-selected` is where it starts.\n2. A row's checkbox is named by `select-row-label` (\"Select {row}\") with the\n   words of the row's first cell. The checkbox in the heading selects every\n   row, and shows a dash while only some are chosen.\n3. `helix-select` asks first, with every key the change would leave.\n   Refuse it to keep the selection. `helix-selected` follows once it stands.\n4. A chosen row takes `:state(selected)`, and a screen reader hears\n   `selected-label` (\"2 selected\") from a polite region.\n\nTab reaches each checkbox, and Space ticks it. To act on one row, put a\nlink or a button in a cell, or give the row an `href`.\n\n`selection-mode=\"single\"` selects one row at a time: ticking a row lets go\nof the one before, the heading holds no checkbox, and Shift and Control with\nA take in nothing more. `selection-behavior=\"replace\"` makes a press on a\nrow, anywhere but its own controls, select it alone, as a file list does,\nand in a `grid` table the arrow keys carry the selection with them. Control\nor Command with a press adds or takes out the row, and with an arrow moves\nwithout selecting. Shift with a press takes in the rows from the one last\nchosen.\n\n**Nesting rows.** A row with `parent` sits under the row of that key, as\na file sits in a folder. The table then draws a column of disclosure\nbuttons, under a heading named by `expand-column-label`: a row with rows\nunder it has a button named by `expand-row-label` (\"Expand {row}\") that\nsays with `aria-expanded` whether it is open, and the rows under a shut row\nare not drawn. `expanded` holds the open rows' keys, comma separated, and\n`default-expanded` is where it starts. A press asks with\n`helix-before-toggle` and tells with `helix-toggle`, both from the row, so\nyou can refuse it or load the rows on the way. A sort orders the rows\nunder each row among themselves, and in a `grid` table the table is a\n`treegrid` whose rows say their depth.\n\n**Moving rows.** `reorderable` adds a column of grips before the checkboxes,\nunder a heading named by `row-grips-label`.\n\n1. Each row is known by its `value`, or by its place among the rows where it\n   has none, as for selecting. Give rows a `value` when they move, so a key\n   stays with its row.\n2. A grip is a button named by `move-row-label` (\"Move {row}\") with the\n   words of the row's first cell. Drag it to move its row, and the page\n   scrolls near an edge. Or press it with Space, Enter, or a click to pick\n   the row up, move it with Up, Down, Home, and End, and press it again to\n   drop it. A click on another row drops it there, and Escape puts it back.\n3. `helix-before-reorder` asks first, and `helix-reorder` follows with\n   `keys`, every row's key in the new order. **You move the rows**: the\n   table moves no element of yours, and focus goes back to the moved row's\n   grip once you have.\n4. Each step is said in the table's live region, in words you can change:\n   `picked-up-label`, `moved-label`, `dropped-label`, and `canceled-label`.\n   The grips do nothing while a sort is set.\n\n**A grid.** `grid` makes the table one tab stop that the arrow keys move\nthrough cell by cell, the headings included, as React Aria's table is. The\ntable is then a `grid` and each value a `gridcell`, and the table gives\nevery cell a `tabindex` so focus can rest on it: set `grid` only where the\ncells may carry one.\n\n| Key | What it does |\n|---|---|\n| Right, Left | Moves one cell along the row. Left moves on, on a right-to-left page. |\n| Down, Up | Moves one row, the headings included. |\n| Home, End | Moves to the first or the last cell of the row. |\n| Control with Home or End | Moves to the first or the last cell of the table. |\n| Page Down, Page Up | Moves by the rows that fit in view. |\n| Enter, F2 | Moves into the cell's links and controls. Escape or F2 moves back to the cell, and Tab moves between the controls of one cell. |\n| Enter on a cell of a row with `href` | Follows the row's link. |\n| Enter, Space on a sortable heading | Sorts by the column. |\n| Space on a row, Enter or Space on its checkbox cell | Selects the row, in a `selectable` table. |\n| Enter or Space on a disclosure cell | Shows or hides the rows under the row, in a table whose rows nest. |\n| Right on a disclosure cell | Shows the rows under a shut row, and otherwise moves one cell along the row. Left does, on a right-to-left page. |\n| Left on a disclosure cell | Hides the rows under an open row, and moves to the row this one sits under from any other. |\n| Enter or Space on a grip cell | Picks the row up, or drops it, in a `reorderable` table. Up, Down, Home, and End move a row picked up, and Escape puts it back. |\n| Down, Up, Page Down, Page Up under `selection-behavior=\"replace\"` | Selects the row it moves to alone. Control or Command with the key moves without selecting. |\n| Shift with Down or Up | Selects the rows it moves across, in a `selectable` table. |\n| Shift with Space | Selects every row from the one last chosen, in a `selectable` table. |\n| Control or Command with A | Selects every row, in a `selectable` table. |\n| A letter or a word | Moves to the next row whose first cell starts with what you typed. |\n| Tab | Leaves the table. |\n\n**Loading more.** `load-more` sends `helix-load-more` once the end of the\ntable comes within a screen of view, in the box that scrolls it or the\npage, once for each number of rows: add rows and it can send it again. Set\n`loading` while you fetch, and the table asks for nothing until it clears.\n\nWhen the rows did not load, set `error-text`, such as \"The orders did not\nload\", and put a button that tries again in the `error` slot. The line shows\nafter the rows in place of the empty and loading lines, the live region says\nit, and the table takes the `error` state. Clear it once you try again.\n\nThe CSS custom properties listed for this component are written by it and\nread by the stylesheet that draws it. Do not set them. Each holds a number\nthe component computes and CSS cannot, so the stylesheet can draw the table\nwithout measuring anything.",
           "name": "HelixHeadlessTable",
           "cssProperties": [
             {
@@ -155627,7 +156312,7 @@
               "name": "gridKeys",
               "privacy": "private",
               "readonly": true,
-              "default": "new TableGridController(this, { activate: (place, event) => this.activate(place, event), arrive: (to, control) => { if (this.replaces && !control) { this.chooseOnly(to) } }, columns: () => this.tableColumns.filter((column) => column.shown), lead: () => this.lead, on: () => this.grid, part: (name) => this.partNamed(name), rows: () => (this.childrenKnown ? this.arrangedRows : []), rowWords: () => this.arrangedRows.map((row) => textOf(row.children[0])), selectAll: () => this.selectable && !this.single && this.requestSelected(new Set([...this.chosen, ...this.enabledKeys])), selectRange: (to, from) => this.selectRange(to, from), })",
+              "default": "new TableGridController(this, { activate: (place, event) => this.activate(place, event), arrive: (to, control) => { if (this.replaces && !control) { this.chooseOnly(to) } }, columns: () => this.tableColumns.filter((column) => column.shown), disclose: (at, forward) => this.disclose(at, forward), lead: () => this.lead, on: () => this.grid, part: (name) => this.partNamed(name), rows: () => (this.childrenKnown ? this.arrangedRows : []), rowWords: () => this.arrangedRows.map((row) => textOf(row.children[0])), selectAll: () => this.selectable && !this.single && this.requestSelected(new Set([...this.chosen, ...this.enabledKeys])), selectRange: (to, from) => this.selectRange(to, from), })",
               "description": "The keyboard of a `grid` table, in `grid-controller.ts`."
             },
             {
@@ -156034,6 +156719,31 @@
               ],
               "description": "One row's checkbox, ticked or not. It becomes the row a range runs from."
             },
+            {
+              "kind": "method",
+              "name": "disclose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean | number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "forward",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Right or Left on a disclosure cell, as on a tree's item and as Data\nTable's row headers do: on to open a shut row, back to shut an open one.\nBack on a row that is shut, or has no rows under it, moves to the row it\nsits under. Anything else moves along the row."
+            },
             {
               "kind": "method",
               "name": "activate",
@@ -157264,6 +157974,10 @@
               "description": "While `error-text` is set.",
               "name": "error"
             },
+            {
+              "description": "While `loading` is set, as the rows are on their way.",
+              "name": "loading"
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -159809,6 +160523,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "stopBeside",
@@ -161621,6 +162364,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "dismiss",
@@ -172932,6 +173704,35 @@
                 "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "present",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the element is still on the page for a reader, which is what\nthe focus hand-off waits on: connected, for a surface the page removes.\nA surface that hides itself says it is gone once hidden, and calls\n`handFocusOn` then.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handFocusOn",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hands focus on now, where a dismissal is waiting for this element to\ngo: for a surface that hides itself, once it has.",
+              "inheritedFrom": {
+                "name": "MixinDismissible",
+                "module": "src/mixins/mixin-dismissible/mixin-dismissible.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "stopBeside",
@@ -185390,6 +186191,18 @@
               "description": "The entry that is playing.",
               "name": "current"
             },
+            {
+              "description": "The entry a pointer is dragging, in a `reorderable` playlist.",
+              "name": "dragging"
+            },
+            {
+              "description": "The entry the dragged one would land after, which the drop indicator is drawn under.",
+              "name": "drop-after"
+            },
+            {
+              "description": "The entry the dragged one would land before, which the drop indicator is drawn over.",
+              "name": "drop-before"
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -186262,7 +187075,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "**You slot the player**, so it keeps your appearance, extra controls,\ncaptions, and poster treatment. `Sandbox` takes its preview and `Menu` its\ntrigger the same way.\n\n**Entries are markup.** React skips properties it would set imperatively\nduring hydration, so an array property on a custom element is missing on the\nfirst paint of a server-rendered page. `using-the-elements.mdx` has the\nmeasurement. Markup also makes each entry a real button with its name inside.\n\n**The playlist does not play media.** It sets `src` on the player and tracks\nwhich entry is current. The current entry moves when:\n\n- an entry is pressed,\n- the player dispatches `helix-next` or `helix-previous`, or\n- the player reaches the end.\n\nOn `ended` the playlist advances and the next clip starts playing, because\nthe user already pressed play once. `no-advance` turns that off, and the\nplaylist stays on the entry that ended. `repeat` decides what happens at the\nend: `one` plays the same entry again, and `all` goes from the last entry\nback to the first. Without it, the playlist stops on the last entry and\nsends `helix-end`. `shuffle` plays the entries in a random order, starting\nfrom the one that is current, and `previous` retraces that order.\n\n**`helix-before-activate` says why the playlist is moving**, in\n`detail.cause`: `press` for an entry or a menu choice, `next` and\n`previous` for the player's controls and the methods, `ended` at the end of\na clip, and `removed` when the current entry leaves the playlist. Cancel an\n`ended` move to show your own \"Up next\" countdown, then call `next()`.\n\n**Removing the current entry moves the playlist on**, to the entry after it,\nor to the one before it when it was the last. A clip that was playing keeps\nplaying in the entry that takes its place.\n\n**The player is named by the current entry**, and the device's own media\ncontrols show the entry as the title. A player you gave a `label` keeps\nyour name, and only the title follows the entry.\n\n**Keyboard.** The entries take one stop in the tab order: the entry you\nlast focused, or the current entry before you have focused one. Enter or\nSpace plays it. The arrow keys move focus to the entry before or after, and\nHome and End to the first and the last, passing over disabled entries. The\ncurrent entry carries `aria-current`. While focus is on the player, the\nplayer's own keys work, and `Video` lists them, and Shift with N or P plays\nthe next or the previous entry. The player's previous and next controls\nmove through the entries in the same order the playlist does.\n\n**What a screen reader hears.** A list named by `label`, with a button for\neach entry. When the playlist moves to another entry, by a press, by the\nplayer's controls, or at the end of a clip, a live region says\n`playing-label`, \"Now playing\" and the entry's name.",
+          "description": "**You slot the player**, so it keeps your appearance, extra controls,\ncaptions, and poster treatment. `Sandbox` takes its preview and `Menu` its\ntrigger the same way.\n\n**Entries are markup.** React skips properties it would set imperatively\nduring hydration, so an array property on a custom element is missing on the\nfirst paint of a server-rendered page. `using-the-elements.mdx` has the\nmeasurement. Markup also makes each entry a real button with its name inside.\n\n**The playlist does not play media.** It sets `src` on the player and tracks\nwhich entry is current. The current entry moves when:\n\n- an entry is pressed,\n- the player dispatches `helix-next` or `helix-previous`, or\n- the player reaches the end.\n\nOn `ended` the playlist advances and the next clip starts playing, because\nthe user already pressed play once. `no-advance` turns that off, and the\nplaylist stays on the entry that ended. `repeat` decides what happens at the\nend: `one` plays the same entry again, and `all` goes from the last entry\nback to the first. Without it, the playlist stops on the last entry and\nsends `helix-end`. `shuffle` plays the entries in a random order, starting\nfrom the one that is current, and `previous` retraces that order.\n\n**`helix-before-activate` says why the playlist is moving**, in\n`detail.cause`: `press` for an entry or a menu choice, `next` and\n`previous` for the player's controls and the methods, `ended` at the end of\na clip, and `removed` when the current entry leaves the playlist. Cancel an\n`ended` move to show your own \"Up next\" countdown, then call `next()`.\n\n**Removing the current entry moves the playlist on**, to the entry after it,\nor to the one before it when it was the last. A clip that was playing keeps\nplaying in the entry that takes its place.\n\n**The player is named by the current entry**, and the device's own media\ncontrols show the entry as the title. A player you gave a `label` keeps\nyour name, and only the title follows the entry.\n\n**Keyboard.** The entries take one stop in the tab order: the entry you\nlast focused, or the current entry before you have focused one. Enter or\nSpace plays it. The arrow keys move focus to the entry before or after, and\nHome and End to the first and the last, passing over disabled entries. The\ncurrent entry carries `aria-current`. While focus is on the player, the\nplayer's own keys work, and `Video` lists them, and Shift with N or P plays\nthe next or the previous entry. The player's previous and next controls\nmove through the entries in the same order the playlist does.\n\n**Moving entries.** `reorderable` lets a reader change the order of the\nqueue:\n\n- Alt with Up or Down moves the focused entry a place, and Alt with Home or\n  End moves it to either end, as the APG's rearrangeable listbox does.\n  Focus stays on it.\n- A pointer drags an entry, with a drop indicator, and the page scrolls near\n  an edge. A press that does not travel still plays the entry.\n- A drop sends `helix-before-reorder`, which you can refuse, and then\n  `helix-reorder`, whose `keys` hold every entry's `value` in the new order.\n  **You move the entries**: the playlist moves no element of yours, and the\n  next entry is the one after the current entry in the order you leave.\n- Each move is said in the live region, in words you can change:\n  `moved-label`, `dropped-label`, `canceled-label`, and `picked-up-label`.\n\n**What a screen reader hears.** A list named by `label`, with a button for\neach entry. When the playlist moves to another entry, by a press, by the\nplayer's controls, or at the end of a clip, a live region says\n`playing-label`, \"Now playing\" and the entry's name.",
           "name": "HelixHeadlessVideoPlaylist",
           "cssParts": [
             {
@@ -186307,6 +187120,32 @@
               "default": "'helix-video-playlist'",
               "description": "The key this family's words are registered under, its styled tag:\n`registerWords('de', { 'helix-video-playlist': { label: 'Wiedergabeliste' } })`."
             },
+            {
+              "kind": "field",
+              "name": "canceledLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Canceled'",
+              "description": "What screen readers hear when a move is put back, in a `reorderable`\nplaylist. `{name}` is the entry's words.",
+              "attribute": "canceled-label",
+              "helix": {
+                "words": true
+              }
+            },
+            {
+              "kind": "field",
+              "name": "droppedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dropped'",
+              "description": "What screen readers hear when a moved entry is let go, in a `reorderable`\nplaylist. `{name}` is the entry's words.",
+              "attribute": "dropped-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "emptyLabel",
@@ -186333,6 +187172,19 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "movedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{name} moved to position {position} of {count}'",
+              "description": "What screen readers hear each time a key moves an entry, in a\n`reorderable` playlist. `{name}` is the entry's words, `{position}` its\nnew place, counting from 1, and `{count}` the number of entries.",
+              "attribute": "moved-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "noAdvance",
@@ -186343,6 +187195,19 @@
               "description": "Stays on an entry when its clip ends, where the playlist would otherwise\nplay the next one. The player's controls, a press, and `next()` still\nmove. `repeat=\"one\"` still plays the entry again.",
               "attribute": "no-advance"
             },
+            {
+              "kind": "field",
+              "name": "pickedUpLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Picked up {name}'",
+              "description": "What screen readers hear when a pointer picks up an entry, in a\n`reorderable` playlist. `{name}` is the entry's words.",
+              "attribute": "picked-up-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "playingLabel",
@@ -186356,6 +187221,17 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "reorderable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Lets a reader move the entries, with Alt and the arrow keys or by\ndragging one. The playlist moves no entry itself: you move your entries\non `helix-reorder`.",
+              "attribute": "reorderable",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "status",
@@ -186364,6 +187240,63 @@
               "default": "new StatusController(this)",
               "description": "The live region, rendered from the first move."
             },
+            {
+              "kind": "method",
+              "name": "entryOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessVideoPlaylistItem | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "The entry an event passed through, where it may move."
+            },
+            {
+              "kind": "method",
+              "name": "entryFor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessVideoPlaylistItem | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The entry with that value."
+            },
+            {
+              "kind": "field",
+              "name": "reorder",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ReorderController(this, { axis: 'block', box: (value) => this.entryFor(value)?.getBoundingClientRect(), current: (event) => this.entryOf(event)?.value, grip: (event) => { const entry = this.entryOf(event) return entry ? { element: entry, key: entry.value } : undefined }, holds: false, keys: () => this.items.map((one) => one.value), name: (value) => this.entryFor(value)?.text || value, refocus: (value) => this.entryFor(value)?.focus(), say: (words) => this.status.say(words), })",
+              "description": "Moving the entries, as a listbox moves its options: Alt with the arrows\non the focused entry, or a pointer dragging a whole entry, where a press\nthat does not travel still plays it."
+            },
+            {
+              "kind": "method",
+              "name": "markMoves",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Tells each entry where it stands in a move, which it says through its\nstates for the styled tier to draw: the entry dragged, and the one the\ndrop indicator is before or after."
+            },
             {
               "kind": "field",
               "name": "repeat",
@@ -187122,6 +188055,14 @@
               "name": "helix-before-activate",
               "reactProp": "onhelix-before-activate"
             },
+            {
+              "type": {
+                "text": "HelixBeforeReorderEvent"
+              },
+              "description": "An entry was moved to a new place, in a `reorderable` playlist, with every entry's value in the new order in `detail.keys`. Cancelable: cancel it to keep the entry where it is.",
+              "name": "helix-before-reorder",
+              "reactProp": "onhelix-before-reorder"
+            },
             {
               "type": {
                 "text": "HelixEndEvent"
@@ -187129,9 +188070,35 @@
               "description": "The last entry finished playing, and the playlist stopped there. Not sent while `repeat` is set.",
               "name": "helix-end",
               "reactProp": "onhelix-end"
+            },
+            {
+              "type": {
+                "text": "HelixReorderEvent"
+              },
+              "description": "Fired after `helix-before-reorder` when nobody canceled it. Move your entries to the order in `keys`. Cancelable: cancel it to say the move did not happen.",
+              "name": "helix-reorder",
+              "reactProp": "onhelix-reorder"
             }
           ],
           "attributes": [
+            {
+              "name": "canceled-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Canceled'",
+              "description": "What screen readers hear when a move is put back, in a `reorderable`\nplaylist. `{name}` is the entry's words.",
+              "fieldName": "canceledLabel"
+            },
+            {
+              "name": "dropped-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Dropped'",
+              "description": "What screen readers hear when a moved entry is let go, in a `reorderable`\nplaylist. `{name}` is the entry's words.",
+              "fieldName": "droppedLabel"
+            },
             {
               "name": "empty-label",
               "type": {
@@ -187150,6 +188117,15 @@
               "description": "The list's name, read by screen readers.",
               "fieldName": "label"
             },
+            {
+              "name": "moved-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{name} moved to position {position} of {count}'",
+              "description": "What screen readers hear each time a key moves an entry, in a\n`reorderable` playlist. `{name}` is the entry's words, `{position}` its\nnew place, counting from 1, and `{count}` the number of entries.",
+              "fieldName": "movedLabel"
+            },
             {
               "name": "no-advance",
               "type": {
@@ -187159,6 +188135,15 @@
               "description": "Stays on an entry when its clip ends, where the playlist would otherwise\nplay the next one. The player's controls, a press, and `next()` still\nmove. `repeat=\"one\"` still plays the entry again.",
               "fieldName": "noAdvance"
             },
+            {
+              "name": "picked-up-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Picked up {name}'",
+              "description": "What screen readers hear when a pointer picks up an entry, in a\n`reorderable` playlist. `{name}` is the entry's words.",
+              "fieldName": "pickedUpLabel"
+            },
             {
               "name": "playing-label",
               "type": {
@@ -187168,6 +188153,15 @@
               "description": "What the live region says when the playlist moves to another entry.\n`{title}` is the entry's name.\n\n**A move a reader did not make is said.** At the end of a clip the\nplaylist starts the next one, and the only other trace of that is the\n`aria-current` on a button the reader is not on.",
               "fieldName": "playingLabel"
             },
+            {
+              "name": "reorderable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Lets a reader move the entries, with Alt and the arrow keys or by\ndragging one. The playlist moves no entry itself: you move your entries\non `helix-reorder`.",
+              "fieldName": "reorderable"
+            },
             {
               "name": "repeat",
               "type": {
@@ -192420,6 +193414,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.162.1"
+    "version": "0.164.0"
   }
 }