@fusion.dev/helix 0.165.0 → 0.166.0

package/custom-elements.json

@@ -38627,6 +38627,36 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "file",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The name of the file shown, where the block holds several Code Blocks:\nthe `label` of one, or its `language` without one.\n\nUnset, or a name no file has, shows the first.",
+              "attribute": "file",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filesLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Files'",
+              "description": "The name of the file tabs, read by screen readers.",
+              "attribute": "files-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "hideUnchangedLabel",
@@ -39054,6 +39084,155 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "blocks",
+              "type": {
+                "text": "HelixHeadlessCodeBlock[]"
+              },
+              "privacy": "private",
+              "description": "The Code Blocks this block holds as its code, once its children can be read.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tabbed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the block is one of several files under another block's tabs,\nwhich name it. Read from the parent, so a block needs no telling.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "shownFile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessCodeBlock | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "blocks",
+                  "type": {
+                    "text": "HelixHeadlessCodeBlock[]"
+                  }
+                }
+              ],
+              "description": "The file shown among several: the one `file` names, or the first.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "chooseFile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "block",
+                  "type": {
+                    "text": "HelixHeadlessCodeBlock"
+                  }
+                }
+              ],
+              "description": "Shows the file a tab names, once nobody refused.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFileKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Arrow keys, `Home` and `End` on the file tabs, which move to a tab and\nshow its file, as a tab list that follows focus does and as Sandbox's file\ntabs do. Left and Right swap on a right-to-left page.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hid",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<Element>()",
+              "description": "The blocks this element hid, to show them again.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fileCount",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "How many files the block last held, so each is told when that changes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "showFile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hides the files not shown, shows any this element hid that is now, and\ntells each file when how many there are changes, since a file draws its\nown name only while it is alone.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderFiles",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "blocks",
+                  "type": {
+                    "text": "HelixHeadlessCodeBlock[]"
+                  }
+                }
+              ],
+              "description": "The tabs over several files, and the file shown under them. One file\ndraws no tabs, only itself.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderExpand",
@@ -39114,6 +39293,10 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "drawn",
+                  "default": "name"
                 }
               ],
               "description": "The name with the copy button beside it, or nothing when there is no name.\n\n**The button is in the header wherever there is one**, because beside the\ncode it stands over the block and the block has to make room for it. A\ndiff cannot: its washes run to the edge, so the button stood on the hunk\nline and the line under it. In the header it is over nothing.\n\n**No name draws no header**, unless the page put a control in `actions`\nor asked for the wrap button. A bar holding the copy button alone turned a\n`Usage` section of one-line imports into a run of empty strips. The button\nthen stands beside the code, in room the block keeps for it.",
@@ -39744,6 +39927,10 @@
                 "description": "A long file capped at a height, with a button under it that shows every line and fewer again.",
                 "slug": "expandable"
               },
+              {
+                "description": "Three code blocks shown as files under tabs, one at a time.",
+                "slug": "files"
+              },
               {
                 "description": "A block drawn by a highlighter of your own, whose copy is still the code as written.",
                 "slug": "highlight"
@@ -39988,6 +40175,22 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "description": "One file tab, `aria-selected` while its file is shown.",
+              "name": "file-tab",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "description": "The file tabs over the blocks a block holds, where there are several.",
+              "name": "files",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "description": "In a split diff, the empty row opposite a line the other side does not have.",
               "name": "filler",
@@ -40247,6 +40450,31 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "name": "file",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The name of the file shown, where the block holds several Code Blocks:\nthe `label` of one, or its `language` without one.\n\nUnset, or a name no file has, shows the first.",
+              "fieldName": "file",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "name": "files-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Files'",
+              "description": "The name of the file tabs, read by screen readers.",
+              "fieldName": "filesLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "name": "hide-unchanged-label",
               "type": {
@@ -40391,6 +40619,30 @@
             }
           ],
           "events": [
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "A file tab showed its file, whose name `file` now holds.",
+              "name": "change",
+              "reactProp": "onchange",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeChangeEvent"
+              },
+              "description": "A file tab is about to show its file, with the file's name in `detail.value`. Cancelable: cancel it to keep the file shown.",
+              "name": "helix-before-change",
+              "reactProp": "onhelix-before-change",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixBeforeToggleEvent"
@@ -40403,6 +40655,30 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "type": {
+                "text": "HelixCopyEvent"
+              },
+              "description": "The copy button put the code on the clipboard, with the text in `detail.value`.",
+              "name": "helix-copy",
+              "reactProp": "onhelix-copy",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixCopyErrorEvent"
+              },
+              "description": "A press on the copy button put nothing on the clipboard: the browser did not allow the write, or there was no code.",
+              "name": "helix-copy-error",
+              "reactProp": "onhelix-copy-error",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixToggleEvent"
@@ -40425,6 +40701,14 @@
                 "module": "src/code-block/root/code-block-root.ts"
               }
             },
+            {
+              "description": "The block is one of several files under another block's tabs, which name it, so it draws no name of its own.",
+              "name": "tabbed",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCodeBlock",
+                "module": "src/code-block/root/code-block-root.ts"
+              }
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",
@@ -83953,6 +84237,14 @@
                 "module": "src/filter-input/menu/filter-menu.ts"
               }
             },
+            {
+              "description": "The inner menu's filter field, drawn with `filterable`.",
+              "name": "menu-search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterMenu",
+                "module": "src/filter-input/menu/filter-menu.ts"
+              }
+            },
             {
               "description": "The floating panel the menu is drawn on.",
               "name": "menu-surface",
@@ -130904,7 +131196,7 @@
               "kind": "field",
               "name": "describedBy",
               "type": {
-                "text": "string | typeof nothing"
+                "text": "string | null"
               },
               "privacy": "private",
               "description": "What describes the row: the line under its label and the words after it.",
@@ -131138,6 +131430,20 @@
                 "module": "src/menu/item/menu-item.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onHost",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the row says what it is from its host, for a field's `aria-activedescendant`.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenuItem",
+                "module": "src/menu/item/menu-item.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "tag",
@@ -131794,6 +132100,14 @@
                 "module": "src/menu/item/menu-item.ts"
               }
             },
+            {
+              "description": "In a menu with `filterable`, the arrow keys or the pointer reached the row while focus stays in the filter field.",
+              "name": "highlighted",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenuItem",
+                "module": "src/menu/item/menu-item.ts"
+              }
+            },
             {
               "description": "Under `submenus=\"flyout\"`, a row in this row's submenu can be ticked or opens a submenu, so the submenu keeps its trailing column.",
               "name": "submenu-mark",
@@ -132301,6 +132615,63 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "filter",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The text the rows are filtered by, which the filter field holds.\n\nCleared as the menu closes and as a submenu opens or closes, so each page\nstarts with every row showing.",
+              "attribute": "filter",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filterable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the menu shows a field above its rows that narrows them as the\nreader types, with focus staying in the field.",
+              "attribute": "filterable",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filterLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Filter'",
+              "description": "The filter field's name and placeholder.",
+              "attribute": "filter-label",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filterMatch",
+              "type": {
+                "text": "((text: string, filter: string) => boolean) | undefined | undefined"
+              },
+              "description": "Whether a row is kept by the filter: a function given the row's words and\nthe filter, trimmed, that returns `true` to keep it showing, as React\nAria's `Autocomplete` takes `filter`. See Listbox's `filterMatch`.\n\nAbsent, a row is kept where its words hold the filter, in any case. A\nproperty only, there being no way to write a function in markup.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "label",
@@ -132457,6 +132828,23 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "noResultsText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No matches'",
+              "description": "The text shown when the filter keeps no rows.",
+              "attribute": "no-results-text",
+              "helix": {
+                "words": true
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "offset",
@@ -132581,7 +132969,7 @@
               "name": "aria",
               "privacy": "protected",
               "readonly": true,
-              "default": "new AriaForwardController(this, { label: true, target: () => this.partNamed('surface'), })",
+              "default": "new AriaForwardController(this, { label: true, target: () => this.menuBox, })",
               "description": "Carries a host `aria-label` and `aria-labelledby` to the surface.",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
@@ -132695,6 +133083,190 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "menuBox",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "description": "The element that is the `menu`: the surface, or with `filterable` the box after the field.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "field",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "description": "The filter field, with `filterable`.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filterPage",
+              "type": {
+                "text": "HelixHeadlessMenuItem | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The submenu the filter narrows, or null for the top page.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "refused",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The filter a listener refused, which narrows nothing.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filtering",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the filter is narrowing the rows.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "kept",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "HelixHeadlessMenuItem"
+                  }
+                }
+              ],
+              "description": "Whether the filter keeps a row: one of another page, or one whose words it matches.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "requestFilter",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Asks to filter by new text, which the field and `filter` then hold. A\nrefusal keeps every row showing, for a page that narrows them itself.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFilterInput",
+              "privacy": "private",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "filterBy",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Filters by what the reader typed, and highlights the first row kept.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "highlighted",
+              "type": {
+                "text": "HelixHeadlessMenuItem | undefined"
+              },
+              "privacy": "private",
+              "description": "The row the keys reached while focus stays in the filter field.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reach",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "HelixHeadlessMenuItem | undefined"
+                  }
+                }
+              ],
+              "description": "Moves the reader to a row: focus, or with `filterable` the highlight,\nwhich the field names with `aria-activedescendant`. An element reference,\nbecause the field is in this shadow root and the row in the tree around\nit, the one direction a reference crosses.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "show",
@@ -132845,6 +133417,29 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "revealRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "HelixHeadlessMenuItem"
+                  }
+                }
+              ],
+              "description": "Scrolls the panel that holds a row to show it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -132922,6 +133517,17 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleMouseDown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Keeps focus in the filter field through a press on a row or the way\nback, as React Aria's virtual focus does: the press still chooses.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handlePointerMove",
@@ -133538,6 +134144,10 @@
                 "min": 300,
                 "slug": "events"
               },
+              {
+                "description": "A menu with a filter field, which narrows its rows and its submenu's rows as you type.",
+                "slug": "filter"
+              },
               {
                 "description": "A menu whose submenus open in a panel beside their rows.",
                 "min": 300,
@@ -133669,6 +134279,45 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "name": "filter",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The text the rows are filtered by, which the filter field holds.\n\nCleared as the menu closes and as a submenu opens or closes, so each page\nstarts with every row showing.",
+              "fieldName": "filter",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "name": "filterable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the menu shows a field above its rows that narrows them as the\nreader types, with focus staying in the field.",
+              "fieldName": "filterable",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "name": "filter-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Filter'",
+              "description": "The filter field's name and placeholder.",
+              "fieldName": "filterLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "name": "label",
               "type": {
@@ -133695,6 +134344,19 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "name": "no-results-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No matches'",
+              "description": "The text shown when the filter keeps no rows.",
+              "fieldName": "noResultsText",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "name": "offset",
               "type": {
@@ -133785,6 +134447,18 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "type": {
+                "text": "HelixFilterEvent"
+              },
+              "description": "The text in the filter field changed, with the new text in `detail.value`. Cancelable: cancel it to keep every row showing and narrow the rows yourself.",
+              "name": "helix-filter",
+              "reactProp": "onhelix-filter",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixSelectEvent"
@@ -133807,6 +134481,14 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "description": "What the menu shows when the filter keeps no rows, for content richer than `no-results-text`.",
+              "name": "no-results",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "description": "The control that opens the menu, or with `context` the area a context menu opens over.",
               "name": "trigger",
@@ -133866,7 +134548,15 @@
               }
             },
             {
-              "description": "The floating panel the menu is drawn on.",
+              "description": "With `filterable`, the field that narrows the rows.",
+              "name": "search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "description": "The floating panel the menu is drawn on. It is the `menu` itself, and with `filterable` it holds the filter field and then the `menu`.",
               "name": "surface",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
@@ -144244,6 +144934,32 @@
                 "module": "src/object-inspector/root/object-inspector-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Moves focus to the row the keys move from, or to the tree while that row\nis scrolled out of the window, as Tab reaches them.",
+              "type": {
+                "text": "focus(options?: FocusOptions) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessObjectInspector",
+                "module": "src/object-inspector/root/object-inspector-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "focusActive",
@@ -166861,7 +167577,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A source pane dispatches `helix-before-edit`, which bubbles, and the sandbox\npasses the value to the preview slotted into it. The source pane and the\npreview do not reference each other, so you can replace either one or use it\nalone.\n\nThe event carries the pane's `name`, so one sandbox can hold several panes.\n`html` sets the preview's markup, `css` sets its stylesheet, and `js` sets\na script that runs as a module after the markup. The sandbox ignores a pane\nwith any other name, so that pane can show content without changing the\npreview.\n\n**The dividers are two nested `helix-splitter` elements**, which handle the\npointer, the keyboard, and the corner. The inner splitter holds the panes and\nthe outer one holds the panel, so the panel spans the full width.\n\n**Several source panes are files**, one shown at a time under a row of\ntabs, each named by the pane's `label` or, without one, its `name`. `file`\nholds the `name` of the pane shown. The tabs are a tab list: the arrow keys\nmove between them and show each pane, and `Home` and `End` go to the first\nand the last. Choosing one sends `helix-before-change` with the pane's\n`name`, which you can cancel, and `change` once `file` holds it. The panes\nnot shown carry `hidden`. One pane draws no tabs.\n\n**Any editor can be the source pane**: an element in the `source` slot with\na `name` that dispatches `helix-before-edit` with its text, which bubbles.\nA wrapper around CodeMirror or Monaco sends one on each change and is a pane\nlike `helix-sandbox-source`, and the sandbox reads its `value` to seed the\npreview. Dispatch `helix-caret` from it too for the status bar's position.\n\nOn a focused divider, the arrow keys move it, and `Home` and `End` move it\nto its ends. `Enter` on the panes divider shuts the lead pane, and pressed\nagain it opens the pane where it was. `Enter` on the panel divider shuts the\npanel to `panel-collapsed-size`, and pressed again it opens the panel to its\nlast height.",
+          "description": "A source pane dispatches `helix-before-edit`, which bubbles, and the sandbox\npasses the value to the preview slotted into it. The source pane and the\npreview do not reference each other, so you can replace either one or use it\nalone.\n\nThe preview runs an edit once typing has rested for `preview-delay`, 300\nmilliseconds by default, so a word typed reloads it once. A pane's text when the sandbox starts reaches it at once.\n\nThe event carries the pane's `name`, so one sandbox can hold several panes.\n`html` sets the preview's markup, `css` sets its stylesheet, and `js` sets\na script that runs as a module after the markup. The sandbox ignores a pane\nwith any other name, so that pane can show content without changing the\npreview.\n\n**The dividers are two nested `helix-splitter` elements**, which handle the\npointer, the keyboard, and the corner. The inner splitter holds the panes and\nthe outer one holds the panel, so the panel spans the full width.\n\n**Several source panes are files**, one shown at a time under a row of\ntabs, each named by the pane's `label` or, without one, its `name`. `file`\nholds the `name` of the pane shown. The tabs are a tab list: the arrow keys\nmove between them and show each pane, and `Home` and `End` go to the first\nand the last. Choosing one sends `helix-before-change` with the pane's\n`name`, which you can cancel, and `change` once `file` holds it. The panes\nnot shown carry `hidden`. One pane draws no tabs.\n\n**Any editor can be the source pane**: an element in the `source` slot with\na `name` that dispatches `helix-before-edit` with its text, which bubbles.\nA wrapper around CodeMirror or Monaco sends one on each change and is a pane\nlike `helix-sandbox-source`, and the sandbox reads its `value` to seed the\npreview. Dispatch `helix-caret` from it too for the status bar's position.\n\nSandbox is styled only and has behavior, as `Aura` is. Its behavior is the\nhand-off from a source pane to a preview frame, which works with any pane\nthat sends `helix-before-edit`, and what it draws is the layout around them:\ndividers, file tabs, and a panel. A page that wants another look slots its\nown panes and keeps the hand-off, so there is nothing for a headless version\nto hold.\n\nA development build warns about a source pane with no `label` and no `name`,\nwhose file tab would have no words.\n\nOn a focused divider, the arrow keys move it, and `Home` and `End` move it\nto its ends. `Enter` on the panes divider shuts the lead pane, and pressed\nagain it opens the pane where it was. `Enter` on the panel divider shuts the\npanel to `panel-collapsed-size`, and pressed again it opens the panel to its\nlast height.",
           "name": "HelixSandbox",
           "cssProperties": [
             {
@@ -167051,6 +167767,39 @@
                 "text": "number"
               }
             },
+            {
+              "kind": "field",
+              "name": "previewDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "How long typing rests before the preview runs the new source, in\nmilliseconds, as Sandpack's `recompileDelay` does. The preview reloads its\nframe on each run, so a word typed runs it once. `0` runs it on every\nedit.",
+              "attribute": "preview-delay"
+            },
+            {
+              "kind": "field",
+              "name": "edits",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<PaneName, string>()",
+              "description": "The edits waiting out `previewDelay`, the last text of each pane."
+            },
+            {
+              "kind": "field",
+              "name": "resting",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new DelayController(this, { renders: false })",
+              "description": "The wait before the edits reach the previews."
+            },
+            {
+              "kind": "field",
+              "name": "runEdits",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Hands the waiting edits to the previews."
+            },
             {
               "kind": "field",
               "name": "separatorLabel",
@@ -168105,6 +168854,15 @@
               "description": "Height of the panel, in pixels.",
               "fieldName": "panelSize"
             },
+            {
+              "name": "preview-delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "How long typing rests before the preview runs the new source, in\nmilliseconds, as Sandpack's `recompileDelay` does. The preview reloads its\nframe on each run, so a word typed runs it once. `0` runs it on every\nedit.",
+              "fieldName": "previewDelay"
+            },
             {
               "name": "separator-label",
               "type": {
@@ -168327,6 +169085,19 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "fieldNameLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{field}, {name}'",
+              "description": "The editable region's name where the pane has a `label`, so each file's\nfield says which file it holds. `{field}` is `field-label` and `{name}`\nthe pane's `label`.",
+              "attribute": "field-name-label",
+              "helix": {
+                "words": true
+              }
+            },
             {
               "kind": "field",
               "name": "keysDescription",
@@ -168849,6 +169620,15 @@
               "description": "The editable region's name, read by screen readers.",
               "fieldName": "fieldLabel"
             },
+            {
+              "name": "field-name-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{field}, {name}'",
+              "description": "The editable region's name where the pane has a `label`, so each file's\nfield says which file it holds. `{field}` is `field-label` and `{name}`\nthe pane's `label`.",
+              "fieldName": "fieldNameLabel"
+            },
             {
               "name": "keys-description",
               "type": {
@@ -235000,6 +235780,14 @@
                 "module": "src/video-playlist/menu/video-playlist-menu.ts"
               }
             },
+            {
+              "description": "The inner menu's filter field, drawn with `filterable`.",
+              "name": "menu-search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessVideoPlaylistMenu",
+                "module": "src/video-playlist/menu/video-playlist-menu.ts"
+              }
+            },
             {
               "description": "The floating panel the menu is drawn on.",
               "name": "menu-surface",
@@ -239958,6 +240746,14 @@
                 "module": "src/video/root/video-root.ts"
               }
             },
+            {
+              "description": "The inner menu's filter field, drawn with `filterable`.",
+              "name": "captions-menu-search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessVideo",
+                "module": "src/video/root/video-root.ts"
+              }
+            },
             {
               "description": "The floating panel the menu is drawn on.",
               "name": "captions-menu-surface",
@@ -240206,6 +241002,14 @@
                 "module": "src/video/root/video-root.ts"
               }
             },
+            {
+              "description": "The inner menu's filter field, drawn with `filterable`.",
+              "name": "overflow-search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessVideo",
+                "module": "src/video/root/video-root.ts"
+              }
+            },
             {
               "description": "The floating panel the menu is drawn on.",
               "name": "overflow-surface",
@@ -242834,6 +243638,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.165.0"
+    "version": "0.166.0"
   }
 }