@fusion.dev/helix 0.171.0 → 0.172.0

package/custom-elements.json

@@ -29320,6 +29320,14 @@
                 "module": "src/chat/composer/chat-composer.ts"
               }
             },
+            {
+              "description": "The `feedback` message, under the field while it is set.",
+              "name": "feedback",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChatComposer",
+                "module": "src/chat/composer/chat-composer.ts"
+              }
+            },
             {
               "description": "The icon inside the send button.",
               "name": "mark",
@@ -29384,6 +29392,20 @@
                 "module": "src/chat/composer/chat-composer.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "feedback",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A message about the draft, shown under the field. While set, the composer\nis invalid, does not send, and does not submit, as a field's `feedback`\ndoes, and the message is announced as it appears.",
+              "attribute": "feedback",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChatComposer",
+                "module": "src/chat/composer/chat-composer.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "label",
@@ -29556,6 +29578,20 @@
                 "module": "src/chat/composer/chat-composer.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "edited",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader has typed in the field since it last held a fresh\ndraft: since it rendered, since a send cleared it, or since a reset.\n\n**A send clears the field, and the field still sends `change` as it is\nleft**, because the platform compares the text with what it held when it\nwas focused. Measured in Chromium before this: a required composer sent\n\"hi\", cleared, and on Tab showed itself invalid over an empty draft\nnobody had written.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChatComposer",
+                "module": "src/chat/composer/chat-composer.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "shownInvalid",
@@ -29677,6 +29713,17 @@
                 "module": "src/chat/composer/chat-composer.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleChange",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The field's `change`, which counts only after the reader typed in it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChatComposer",
+                "module": "src/chat/composer/chat-composer.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -30597,6 +30644,19 @@
           "tagName": "helix-chat-composer",
           "customElement": true,
           "attributes": [
+            {
+              "name": "feedback",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A message about the draft, shown under the field. While set, the composer\nis invalid, does not send, and does not submit, as a field's `feedback`\ndoes, and the message is announced as it appears.",
+              "fieldName": "feedback",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChatComposer",
+                "module": "src/chat/composer/chat-composer.ts"
+              }
+            },
             {
               "name": "label",
               "type": {
@@ -30792,7 +30852,7 @@
           ],
           "cssStates": [
             {
-              "description": "The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it.",
+              "description": "The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it. Or `feedback` is set.",
               "name": "invalid",
               "inheritedFrom": {
                 "name": "HelixHeadlessChatComposer",
@@ -33544,6 +33604,56 @@
                 "module": "src/chat/root/chat-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "held",
+              "type": {
+                "text": "{ at: number; id: unknown } | undefined"
+              },
+              "privacy": "private",
+              "description": "The turn focus is in, by its place and its identity, once a reader is in one.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusIn",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Notes the turn focus went into, or that it went somewhere else.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusOut",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Forgets the turn once focus moves to something outside the transcript.\nA move to nothing is kept, since removing the turn that held focus is\none.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "followRemoved",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Moves focus to a neighbor where removing the turn that held it dropped\nfocus to the body: the turn that took its place, or the one before it\nwhere it was the last.\n\n**Focus went to the body**, and Page Down did nothing until the reader\ntabbed back into the transcript. List and Virtual List move focus to a\nneighbor the same way, as React Aria's GridList does. Focus anywhere but\nthe body is where you put it, and is left there.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessChat",
+                "module": "src/chat/root/chat-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "tellTurns",
@@ -43194,6 +43304,31 @@
                 "module": "src/color-input/root/color-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "pressedOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the trigger's press opened the panel that is open now.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorInput",
+                "module": "src/color-input/root/color-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handlePress",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The trigger's press, which notes that it opened the panel, so Escape hands\nfocus back to the trigger.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorInput",
+                "module": "src/color-input/root/color-input-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderPicker",
@@ -45249,7 +45384,7 @@
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The `feedback` line, or nothing while there is none.",
+              "description": "The `feedback` line, or nothing while there is none.\n\n`role=\"alert\"`, as a field's feedback line has, so the message is\nannounced when it appears and the label and hint are not read with it.",
               "inheritedFrom": {
                 "name": "MixinPickerFeedback",
                 "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
@@ -58073,7 +58208,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws only the rows in view, with empty space in place of the rest.\n\n**Not a `mode`.** `mode` says where the rows come from and who filtered\nthem; this says how many of the ones we hold get drawn. They are\nindependent: a consumer fetching five thousand rows a chunk at a time wants\n`mode=\"server\"` and this at once, and folding this into `mode` would be an\nAPI that forbids that combination for no reason.\n\n**Composes with `paginated` rather than excluding it.** A window over a\npage is coherent -- the page is the slice of the result, the window is the\npart of that slice on screen -- and the arithmetic is the same either way,\nso there is nothing to forbid. Together they suit a table paging at a\nthousand rows, where the page is a reasonable fetch and a poor render.\n\nOff by default. Windowing costs a scroll listener, a measurement per row\ndrawn, and a `block-size` on the scrolling box, and a table of twenty rows\nshould pay none of them.",
+              "description": "Draws only the rows in view, with empty space in place of the rest.\n\n**Not a `mode`.** `mode` says where the rows come from and who filtered\nthem; this says how many of the ones we hold get drawn. They are\nindependent: a consumer fetching five thousand rows a chunk at a time wants\n`mode=\"server\"` and this at once, and folding this into `mode` would be an\nAPI that forbids that combination for no reason.\n\n**Composes with `paginated` rather than excluding it.** A window over a\npage is coherent -- the page is the slice of the result, the window is the\npart of that slice on screen -- and the arithmetic is the same either way,\nso there is nothing to forbid. Together they suit a table paging at a\nthousand rows, where the page is a reasonable fetch and a poor render.\n\nOff by default. Windowing costs a scroll listener, a measurement per row\ndrawn, and a `block-size` on the scrolling box, and a table of twenty rows\nshould pay none of them.\n\nWhile windowed, the `table` part scrolls on this tier: it carries\n`data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into\nevery shadow root. You still need to give it a block size.",
               "attribute": "windowed",
               "reflects": true,
               "inheritedFrom": {
@@ -61635,7 +61770,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws only the rows in view, with empty space in place of the rest.\n\n**Not a `mode`.** `mode` says where the rows come from and who filtered\nthem; this says how many of the ones we hold get drawn. They are\nindependent: a consumer fetching five thousand rows a chunk at a time wants\n`mode=\"server\"` and this at once, and folding this into `mode` would be an\nAPI that forbids that combination for no reason.\n\n**Composes with `paginated` rather than excluding it.** A window over a\npage is coherent -- the page is the slice of the result, the window is the\npart of that slice on screen -- and the arithmetic is the same either way,\nso there is nothing to forbid. Together they suit a table paging at a\nthousand rows, where the page is a reasonable fetch and a poor render.\n\nOff by default. Windowing costs a scroll listener, a measurement per row\ndrawn, and a `block-size` on the scrolling box, and a table of twenty rows\nshould pay none of them.",
+              "description": "Draws only the rows in view, with empty space in place of the rest.\n\n**Not a `mode`.** `mode` says where the rows come from and who filtered\nthem; this says how many of the ones we hold get drawn. They are\nindependent: a consumer fetching five thousand rows a chunk at a time wants\n`mode=\"server\"` and this at once, and folding this into `mode` would be an\nAPI that forbids that combination for no reason.\n\n**Composes with `paginated` rather than excluding it.** A window over a\npage is coherent -- the page is the slice of the result, the window is the\npart of that slice on screen -- and the arithmetic is the same either way,\nso there is nothing to forbid. Together they suit a table paging at a\nthousand rows, where the page is a reasonable fetch and a poor render.\n\nOff by default. Windowing costs a scroll listener, a measurement per row\ndrawn, and a `block-size` on the scrolling box, and a table of twenty rows\nshould pay none of them.\n\nWhile windowed, the `table` part scrolls on this tier: it carries\n`data-scroller`, and `core` ships `[data-scroller] { overflow: auto }` into\nevery shadow root. You still need to give it a block size.",
               "fieldName": "windowed",
               "inheritedFrom": {
                 "name": "HelixHeadlessDataTable",
@@ -67310,7 +67445,7 @@
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The `feedback` line, or nothing while there is none.",
+              "description": "The `feedback` line, or nothing while there is none.\n\n`role=\"alert\"`, as a field's feedback line has, so the message is\nannounced when it appears and the label and hint are not read with it.",
               "inheritedFrom": {
                 "name": "MixinPickerFeedback",
                 "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
@@ -72413,7 +72548,7 @@
               "name": "commands",
               "privacy": "protected",
               "readonly": true,
-              "default": "new CommandController(this, { commands: { '--close': () => this.close(), '--show': () => this.show(), '--toggle': () => this.toggleOpen(), }, })",
+              "default": "new CommandController(this, { commands: { '--close': () => this.close(), '--show': () => this.show(), '--toggle': () => this.toggleOpen(), }, expanded: () => this.open, })",
               "inheritedFrom": {
                 "name": "HelixHeadlessDialog",
                 "module": "src/dialog/root/dialog-root.ts"
@@ -75958,7 +76093,7 @@
               "name": "commands",
               "privacy": "protected",
               "readonly": true,
-              "default": "new CommandController(this, { commands: { '--close': () => this.requestOpen(false), '--show': () => this.requestOpen(true), '--toggle': () => this.toggleOpen(), }, })",
+              "default": "new CommandController(this, { commands: { '--close': () => this.requestOpen(false), '--show': () => this.requestOpen(true), '--toggle': () => this.toggleOpen(), }, expanded: () => this.open, })",
               "inheritedFrom": {
                 "name": "HelixHeadlessDrawer",
                 "module": "src/drawer/root/drawer-root.ts"
@@ -108625,7 +108760,7 @@
               "name": "commands",
               "privacy": "protected",
               "readonly": true,
-              "default": "new CommandController(this, { commands: { '--close': () => this.close(), '--fullscreen': () => this.toggleFullscreen(), '--next': () => this.next(), '--previous': () => this.previous(), '--show': () => this.show(), '--toggle': () => this.toggleOpen(), }, })",
+              "default": "new CommandController(this, { commands: { '--close': () => this.close(), '--fullscreen': () => this.toggleFullscreen(), '--next': () => this.next(), '--previous': () => this.previous(), '--show': () => this.show(), '--toggle': () => this.toggleOpen(), }, expanded: () => this.open, })",
               "inheritedFrom": {
                 "name": "HelixHeadlessLightbox",
                 "module": "src/lightbox/root/lightbox-root.ts"
@@ -116567,7 +116702,7 @@
                   }
                 }
               ],
-              "description": "Says how many options a filter left, in the live region.\n\n**A reader typing into a filter cannot see the list narrow**, and React\nAria and Web Awesome both say the count as it changes. Only \"No matches\"\nwas said here, so a query that left forty options and one that left one\nsounded the same. Said when the filter changes and the count with it, so\na keystroke that leaves the same options says nothing new. An empty filter\nsays nothing, being the list as it was given; no matches is `empty-text`,\nwhich the region says in place of this.",
+              "description": "Says how many options a filter left, in the live region.\n\n**A reader typing into a filter cannot see the list narrow**, and React\nAria and Web Awesome both say the count as it changes. Only \"No matches\"\nwas said here, so a query that left forty options and one that left one\nsounded the same. Said when the filter changes and the count with it, so\na keystroke that leaves the same options says nothing new. An empty filter\nsays nothing, being the list as it was given; no matches is `empty-text`,\nwhich the region says in place of this. A load that ends says the count\ntoo, whatever the filter.",
               "inheritedFrom": {
                 "name": "HelixHeadlessListbox",
                 "module": "src/listbox/root/listbox-root.ts"
@@ -133654,6 +133789,22 @@
                 "module": "src/menu/item/menu-item.ts"
               }
             },
+            {
+              "description": "The row is disabled.",
+              "name": "disabled",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenuItem",
+                "module": "src/menu/item/menu-item.ts"
+              }
+            },
+            {
+              "description": "Under `submenus=\"flyout\"`, the row's submenu is open beside it.",
+              "name": "expanded",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenuItem",
+                "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",
@@ -134413,6 +134564,20 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "openOn",
+              "type": {
+                "text": "'click' | 'long-press'"
+              },
+              "default": "'click'",
+              "description": "What opens the menu from its trigger. `long-press` leaves a press to the\ntrigger's own action and opens the menu on a press held for half a second,\nor on Alt+Down or Alt+Up.",
+              "attribute": "open-on",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "pressHeld",
@@ -134454,13 +134619,13 @@
             },
             {
               "kind": "field",
-              "name": "openOn",
+              "name": "placement",
               "type": {
-                "text": "'click' | 'long-press'"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
-              "default": "'click'",
-              "description": "What opens the menu from its trigger. `long-press` leaves a press to the\ntrigger's own action and opens the menu on a press held for half a second,\nor on Alt+Down or Alt+Up.",
-              "attribute": "open-on",
+              "default": "'bottom-start'",
+              "description": "The side the menu opens on, when there is room.\n\nIt moves if that side does not fit.",
+              "attribute": "placement",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
                 "module": "src/menu/root/menu-root.ts"
@@ -134468,13 +134633,16 @@
             },
             {
               "kind": "field",
-              "name": "placement",
+              "name": "resultsLabel",
               "type": {
-                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
+                "text": "string"
+              },
+              "default": "'{count, plural, one {# result} other {# results}}'",
+              "description": "What a screen reader hears when the filter narrows the rows. `{count}` is\nhow many rows are left, written in the locale, and each language writes\nthe forms it has, as Listbox's `results-label` does.",
+              "attribute": "results-label",
+              "helix": {
+                "words": true
               },
-              "default": "'bottom-start'",
-              "description": "The side the menu opens on, when there is room.\n\nIt moves if that side does not fit.",
-              "attribute": "placement",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
                 "module": "src/menu/root/menu-root.ts"
@@ -134518,6 +134686,17 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "phases",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new OpenPhaseController(this, { mark: { entering: (on) => this.toggleState('entering', on), exiting: (on) => this.toggleState('exiting', on), }, open: () => this.open, surface: () => this.partNamed('surface'), })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "aria",
@@ -134821,6 +135000,30 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "rowWatch",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private",
+              "description": "Watches for rows taken away while the menu is open.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "followRemoved",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Moves the reader to a neighbor when the page takes away the row they were\non: the row that took its place, or the one before it where it was the\nlast. A menu with no rows left closes and gives focus to its trigger.\n\n**Focus went to the body**, and the menu then ignored every key, its\nlistener being on the host: measured in Chromium, removing the focused\nrow and pressing ArrowUp did nothing. List and Virtual List move focus to\na neighbor the same way, as React Aria's collections do. With `filterable`,\nfocus stays in the field and the highlight moves. Focus a reader put\nanywhere but the body is left there.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "show",
@@ -134950,6 +135153,60 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "choiceRows",
+              "type": {
+                "text": "HelixHeadlessMenuItem[]"
+              },
+              "privacy": "private",
+              "description": "The choice rows anywhere in the menu, in document order.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "checkedValues",
+              "type": {
+                "text": "string[]"
+              },
+              "description": "The values of the choice rows that are checked, anywhere in the menu, in\ndocument order.\n\nSet it to check exactly those rows and uncheck every other choice row, as\nReact Aria's `selectedKeys` controls a menu's selection from one place.\nEach row keeps its own `checked` too, which this reads and writes. `change`\nis sent on the menu when a reader's choice changes it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "toldChecked",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The checked values `change` last said, joined, so a choice that moved nothing says nothing.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tellChecked",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Sends `change` when a reader's choice has changed which rows are checked.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleSelect",
@@ -135226,7 +135483,7 @@
               "name": "handleHover",
               "privacy": "private",
               "readonly": true,
-              "description": "A mouse resting on a row, under `flyout`: focus follows it, and after a\nmoment the row's submenu opens, or the submenus below the row's own page\nclose. Not while the pointer is crossing toward an open submenu.",
+              "description": "A mouse resting on a row: focus follows it, and under `flyout`, after a\nmoment, the row's submenu opens, or the submenus below the row's own page\nclose. Not while the pointer is crossing toward an open submenu.\n\n**In every mode**, as the APG's menus, React Aria's and Radix's have it.\nUnder `drill` the pointer did not move focus, so the row under the\npointer and the row the keys moved from were two rows, measured in\nChromium: hovering Delete left focus on Cut.",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
                 "module": "src/menu/root/menu-root.ts"
@@ -135266,6 +135523,20 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "namedByPage",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the surface is named by a submenu's page, which `nameSurface` undoes at the top.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "nameSurface",
@@ -135275,7 +135546,7 @@
                   "text": "void"
                 }
               },
-              "description": "Names the surface by its trigger, where nothing else names it.\n\nBy element reference, which is the one direction that crosses: the surface\nis in this shadow root and the trigger is in the tree around it. A host\n`aria-labelledby` is carried down by `aria`, and a host `aria-label` or\n`label` is a name of its own, so each of them clears this reference.",
+              "description": "Names the surface by its trigger, where nothing else names it, and a\nsubmenu's page by its title.\n\nBy element reference, which is the one direction that crosses: the surface\nis in this shadow root and the trigger is in the tree around it. A host\n`aria-labelledby` is carried down by `aria`, and a host `aria-label` or\n`label` is a name of its own, so each of them clears this reference.",
               "inheritedFrom": {
                 "name": "HelixHeadlessMenu",
                 "module": "src/menu/root/menu-root.ts"
@@ -135950,6 +136221,19 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "name": "results-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count, plural, one {# result} other {# results}}'",
+              "description": "What a screen reader hears when the filter narrows the rows. `{count}` is\nhow many rows are left, written in the locale, and each language writes\nthe forms it has, as Listbox's `results-label` does.",
+              "fieldName": "resultsLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "name": "submenus",
               "type": {
@@ -135977,6 +136261,18 @@
               },
               "reactProp": "ontoggle"
             },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "A reader's choice checked or unchecked rows. Read `checkedValues` for the rows that are checked now.",
+              "name": "change",
+              "reactProp": "onchange",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixBeforeCloseEvent"
@@ -136035,6 +136331,22 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "description": "What the menu shows when it has no items, for content richer than `empty-text`.",
+              "name": "empty",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "description": "What the menu shows while its items load, for content richer than `loading-text`.",
+              "name": "loading",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "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",
@@ -136135,6 +136447,22 @@
                 "module": "src/menu/root/menu-root.ts"
               }
             },
+            {
+              "description": "From the moment the panel shows until its entrance has finished.",
+              "name": "entering",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
+            {
+              "description": "From the moment the panel hides until its exit has finished.",
+              "name": "exiting",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMenu",
+                "module": "src/menu/root/menu-root.ts"
+              }
+            },
             {
               "description": "A row on the current page has a checkbox or a link, so every row keeps the trailing column.",
               "name": "mark",
@@ -159036,6 +159364,20 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "anchor",
+              "type": {
+                "text": "Element | string"
+              },
+              "default": "''",
+              "description": "The element the panel opens against, where that is not the trigger: its\n`id` in the same document or shadow root, or the element itself. Left\nempty, the panel opens against the trigger, or against the button whose\ncommand opened it.",
+              "attribute": "anchor",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "arrow",
@@ -159050,6 +159392,33 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "containerPadding",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How close to the window's edges the panel may come, in pixels, when it\nslides, shrinks or moves to the other side to fit. Left unset, it slides\nand shrinks to 8 pixels from an edge and moves to the other side only\nonce it would cross one.",
+              "attribute": "container-padding",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "crossOffset",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How far to slide the panel along the side it is on, in pixels: to the\nright on the top or the bottom, and down on the left or the right.",
+              "attribute": "cross-offset",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "fallbackLabel",
@@ -159067,6 +159436,20 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "flip",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the panel moves to the other side of the trigger when its own\nside has no room. On by default. Write `flip=\"false\"` to keep it on its\nside, where it shrinks to fit, as React Aria's `shouldFlip` turns off.",
+              "attribute": "flip",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "label",
@@ -159150,7 +159533,7 @@
               "name": "panel",
               "privacy": "private",
               "readonly": true,
-              "default": "new PopoverController(this, { anchor: () => this.trigger, arrow: () => this.partNamed('arrow'), /* The host *and* whatever invoked it, never the panel alone. An outside press is measured against this, and the host is not a box to rely on, a sheet being free to give it none, so a boundary of the panel alone would close on the very press that opened it. A `--toggle` button outside the host is part of the control by any reading a reader would give it: pressing it while the panel is open should close it once, not close it on `pointerdown` and reopen it on the `click` that follows. */ boundary: (): (HTMLElement | undefined)[] => [this, this.invoker], /* Measured to the point where there is one, as `Tooltip` measures it: the arrow is a square turned on its center, which reaches `n / sqrt(2)` past the edge it sits on. */ offset: () => this.offset + arrowReach(this.partNamed('arrow')), onDismiss: () => this.hide(), /* The side the panel landed on, for a sheet outside that draws by side, where no attribute can follow `::part()`. As `Tooltip` records it. */ onPlace: (placement) => { const side = sideOf(placement) this.toggleState('placed-bottom', side === 'bottom') this.toggleState('placed-left', side === 'left') this.toggleState('placed-right', side === 'right') this.toggleState('placed-top', side === 'top') this.side = side }, open: () => this.open, placement: () => this.placement, surface: () => this.partNamed('popover'), })",
+              "default": "new PopoverController(this, { anchor: () => this.placedAgainst, arrow: () => this.partNamed('arrow'), /* The host *and* whatever invoked it, never the panel alone. An outside press is measured against this, and the host is not a box to rely on, a sheet being free to give it none, so a boundary of the panel alone would close on the very press that opened it. A `--toggle` button outside the host is part of the control by any reading a reader would give it: pressing it while the panel is open should close it once, not close it on `pointerdown` and reopen it on the `click` that follows. */ boundary: (): (HTMLElement | undefined)[] => [this, this.invoker], crossOffset: () => this.crossOffset, flip: () => this.flip, /* Measured to the point where there is one, as `Tooltip` measures it: the arrow is a square turned on its center, which reaches `n / sqrt(2)` past the edge it sits on. */ offset: () => this.offset + arrowReach(this.partNamed('arrow')), onDismiss: () => this.dismiss(), /* The side the panel landed on, for a sheet outside that draws by side, where no attribute can follow `::part()`. As `Tooltip` records it. */ onPlace: (placement) => { const side = sideOf(placement) this.toggleState('aligned-end', placement.endsWith('-end')) this.toggleState('aligned-start', placement.endsWith('-start')) this.toggleState('placed-bottom', side === 'bottom') this.toggleState('placed-left', side === 'left') this.toggleState('placed-right', side === 'right') this.toggleState('placed-top', side === 'top') this.side = side }, open: () => this.open, padding: () => this.containerPadding, placement: () => this.placement, surface: () => this.partNamed('popover'), })",
               "inheritedFrom": {
                 "name": "HelixHeadlessPopover",
                 "module": "src/popover/root/popover-root.ts"
@@ -159241,7 +159624,7 @@
               "name": "commands",
               "privacy": "protected",
               "readonly": true,
-              "default": "new CommandController(this, { commands: { '--close': () => this.hide(), '--show': (source: Element | null) => { this.invoker = source instanceof HTMLElement ? source : undefined this.show() }, '--toggle': (source: Element | null) => { this.invoker = source instanceof HTMLElement ? source : undefined if (this.open) { this.hide() } else { this.show() } }, }, })",
+              "default": "new CommandController(this, { commands: { '--close': () => this.hide(), '--show': (source: Element | null) => { this.invoker = source instanceof HTMLElement ? source : undefined this.show() }, '--toggle': (source: Element | null) => { this.invoker = source instanceof HTMLElement ? source : undefined if (this.open) { this.hide() } else { this.show() } }, }, expanded: () => this.open, })",
               "inheritedFrom": {
                 "name": "HelixHeadlessPopover",
                 "module": "src/popover/root/popover-root.ts"
@@ -159249,7 +159632,7 @@
             },
             {
               "kind": "field",
-              "name": "trigger",
+              "name": "placedAgainst",
               "type": {
                 "text": "HTMLElement"
               },
@@ -159261,6 +159644,35 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "trigger",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private",
+              "description": "The element that opened the panel, which focus goes back to.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dismiss",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "A press outside, or Escape, closing the panel.\n\n**Focus goes back to the trigger where the press put it nowhere.** The\npress is heard on `pointerdown`, and the browser moves focus a moment\nlater: onto what was pressed where that takes focus, and to the body where\nit does not. A popover dismissed by a press on text was left with focus on\nthe body, measured in Chromium, where React Aria's returns it to the\ntrigger. Read after the press, once the browser has moved it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "show",
@@ -159836,6 +160248,19 @@
                 "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
               }
             },
+            {
+              "name": "anchor",
+              "type": {
+                "text": "Element | string"
+              },
+              "default": "''",
+              "description": "The element the panel opens against, where that is not the trigger: its\n`id` in the same document or shadow root, or the element itself. Left\nempty, the panel opens against the trigger, or against the button whose\ncommand opened it.",
+              "fieldName": "anchor",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "name": "arrow",
               "type": {
@@ -159849,6 +160274,31 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "name": "container-padding",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How close to the window's edges the panel may come, in pixels, when it\nslides, shrinks or moves to the other side to fit. Left unset, it slides\nand shrinks to 8 pixels from an edge and moves to the other side only\nonce it would cross one.",
+              "fieldName": "containerPadding",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
+            {
+              "name": "cross-offset",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How far to slide the panel along the side it is on, in pixels: to the\nright on the top or the bottom, and down on the left or the right.",
+              "fieldName": "crossOffset",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "name": "fallback-label",
               "type": {
@@ -159862,6 +160312,19 @@
                 "module": "src/popover/root/popover-root.ts"
               }
             },
+            {
+              "name": "flip",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the panel moves to the other side of the trigger when its own\nside has no room. On by default. Write `flip=\"false\"` to keep it on its\nside, where it shrinks to fit, as React Aria's `shouldFlip` turns off.",
+              "fieldName": "flip",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "name": "label",
               "type": {
@@ -160080,6 +160543,22 @@
             }
           ],
           "cssStates": [
+            {
+              "description": "While the panel is aligned to the end of the side it sits on.",
+              "name": "aligned-end",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
+            {
+              "description": "While the panel is aligned to the start of the side it sits on.",
+              "name": "aligned-start",
+              "inheritedFrom": {
+                "name": "HelixHeadlessPopover",
+                "module": "src/popover/root/popover-root.ts"
+              }
+            },
             {
               "description": "From the moment the panel shows until its entrance has finished.",
               "name": "entering",
@@ -177439,7 +177918,7 @@
               "name": "handleTriggerKeydown",
               "privacy": "private",
               "readonly": true,
-              "description": "The keys of the closed trigger.\n\nLetters choose without opening, the way a native `<select>` and React\nAria's Select do, so a reader who knows the answer types it. A Space in the\nmiddle of those letters is one of them. With `multiple`, a letter opens the\nlist on the match instead, because adding to a set is a choice the reader\nmakes in the list. ArrowLeft and ArrowRight choose the option before and\nafter the chosen one.",
+              "description": "The keys of the closed trigger.\n\nLetters choose without opening, the way a native `<select>` and React\nAria's Select do, so a reader who knows the answer types it. A Space in the\nmiddle of those letters is one of them. With `multiple`, a letter opens the\nlist on the match instead, because adding to a set is a choice the reader\nmakes in the list. ArrowLeft and ArrowRight choose the option before and\nafter the chosen one, the other way round on a right-to-left page.",
               "inheritedFrom": {
                 "name": "HelixHeadlessSelect",
                 "module": "src/select/root/select-root.ts"
@@ -210397,6 +210876,69 @@
                 "module": "src/textarea/root/textarea-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "setRangeText",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "replacement",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "start",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "end",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "selectMode",
+                  "optional": true,
+                  "type": {
+                    "text": "SelectionMode"
+                  }
+                }
+              ],
+              "description": "Replaces a range of the text, as the native method does: the selection\nwhere `start` and `end` are left out, and `selectMode` says what is\nselected after. It sends no event, as the native method sends none.",
+              "type": {
+                "text": "setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessTextarea",
+                "module": "src/textarea/root/textarea-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "select",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Selects everything in the field.",
+              "type": {
+                "text": "select() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessTextarea",
+                "module": "src/textarea/root/textarea-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "textLength",
@@ -216965,7 +217507,7 @@
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The `feedback` line, or nothing while there is none.",
+              "description": "The `feedback` line, or nothing while there is none.\n\n`role=\"alert\"`, as a field's feedback line has, so the message is\nannounced when it appears and the label and hint are not read with it.",
               "inheritedFrom": {
                 "name": "MixinPickerFeedback",
                 "module": "src/mixins/mixin-picker-feedback/mixin-picker-feedback.ts"
@@ -246687,6 +247229,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.171.0"
+    "version": "0.172.0"
   }
 }