@fusion.dev/helix 0.13.2 → 0.15.0

package/custom-elements.json

@@ -19033,6 +19033,48 @@
                 "text": "toggleOpen() => boolean"
               }
             },
+            {
+              "kind": "field",
+              "name": "collapseLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show fewer'",
+              "description": "What the control says once everything is showing.",
+              "attribute": "collapse-label",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "expandable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the count is a control that shows the rest.",
+              "attribute": "expandable",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "expandLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show all'",
+              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "attribute": "expand-label",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "maxTags",
@@ -19047,6 +19089,44 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader has asked for all of them.\n\nState and private, the way `Input`'s `revealed` is: it is a reader's\nmomentary choice about what is on their own screen, it must not survive\nanything, and a consumer who wants the field opened is asking for\n`max-tags=\"0\"` rather than for a second way to say it.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "shownLimit",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "toggleExpanded",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Turns the cap off and on, which is all expanding is.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderTokenRow",
@@ -19075,6 +19155,29 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "renderRest",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "over",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The count, as a control where the host asked for one and a word otherwise.\n\n**`part=\"rest\"` either way**, so a consumer's `::part(rest)` keeps working\nacross the change. The element under it is different, which is the point:\na `<span>` that looks like an affordance and answers nothing is the fault\nthis exists to fix, and the way to fix it is a real button rather than a\nclick handler on text.\n\n**Expanded, it renders on no count.** `shownLimit` is zero while expanded,\nso `over` is zero too, and gating the control on the number would take\naway the only way back.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "hideOverflow",
@@ -20374,7 +20477,7 @@
                 "slug": "invalid"
               },
               {
-                "description": "A cap on the tags drawn, with the rest counted.",
+                "description": "A cap on the tags drawn, with the rest counted and openable.",
                 "slug": "max-tags"
               },
               {
@@ -20420,6 +20523,45 @@
                 "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
               }
             },
+            {
+              "name": "collapse-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show fewer'",
+              "description": "What the control says once everything is showing.",
+              "fieldName": "collapseLabel",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "name": "expandable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the count is a control that shows the rest.",
+              "fieldName": "expandable",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "name": "expand-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show all'",
+              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "fieldName": "expandLabel",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "name": "max-tags",
               "type": {
@@ -20958,7 +21100,7 @@
               }
             },
             {
-              "description": "The count of choices held beyond `max-tags`.",
+              "description": "The count of choices held beyond `max-tags`. A `<button>` with `expandable`, a `<span>` without it.",
               "name": "rest",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
@@ -34414,17 +34556,33 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The frame is the field rather than the input, so the tokens sit inside the\nsame box as the text and the focus ring is drawn once around the whole\ncontrol. It grows down a line at a time as tokens are added, which is the\narrangement Combobox takes when it is holding a selection.\n\n**The tokens are the consumer's own elements**, so the only thing said about\nthem here is to keep their size and not run past the field. A `Tag` slotted\ninto `tags` already looks like one; anything else looks like whatever it is.\n\nHeight comes from the region, like every other control: `data-density` on\nwhatever holds it, not a `size` here.",
+          "description": "The frame is the field rather than the input, so the tokens sit inside the\nsame box as the text and the focus ring is drawn once around the whole\ncontrol. It grows down a line at a time as tokens are added, which is the\narrangement Combobox takes when it is holding a selection.\n\n**The tokens are the consumer's own elements**, so the only thing said about\nthem here is to keep their size and not run past the field. A `Tag` slotted\ninto `tags` already looks like one; anything else looks like whatever it is.\n\n**The suggestion panel is this element's own box, not a listbox's.** Combobox\nputs a `helix-listbox` in its panel because the options there are a selection\nit owns; these are the consumer's suggestions, so the panel is a plain\n`role=\"listbox\"` region and the options pass their own `helix-select`\nstraight through it. That is why this surface scrolls where Combobox's does\nnot: there is no list inside to do it.\n\nHeight comes from the region, like every other control: `data-density` on\nwhatever holds it, not a `size` here.",
           "name": "HelixFilterInput",
           "cssProperties": [
             {
               "description": "Fill behind the field.",
               "name": "--filter-input-background-color"
             },
+            {
+              "description": "Color of the suggestion panel's edge.",
+              "name": "--filter-input-border-color"
+            },
+            {
+              "description": "Width of that edge. Follows `--helix-border-floating`.",
+              "name": "--filter-input-border-width"
+            },
             {
               "description": "Smallest the text keeps as tokens fill the line, before it wraps to its own.",
               "name": "--filter-input-control-size"
             },
+            {
+              "description": "Width of the suggestion panel. Follows the field by default.",
+              "name": "--filter-input-panel-size"
+            },
+            {
+              "description": "Lift under the panel. Follows `--helix-shadow-floating`: a floating surface sits over content nobody can predict, so it keeps a lift by default.",
+              "name": "--filter-input-shadow"
+            },
             {
               "description": "Height of the field with nothing in it, which it grows from.",
               "name": "--filter-input-size"
@@ -34433,106 +34591,119 @@
           "members": [
             {
               "kind": "field",
-              "name": "maxTags",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "description": "How many tokens to show before the rest become a count.",
-              "attribute": "max-tags",
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "attribute": "open",
               "inheritedFrom": {
-                "name": "MixinTokens",
-                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "attribute": "default-open",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "openState",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The state, whoever set it, and `undefined` until somebody has.\n\nPrefixed, and it has to be. These mixins compose onto one prototype\nchain, `Select` takes this one and `MixinControllerValue` together, and\nTypeScript's `private` is a compile-time fiction: two mixins with a field\ncalled `state` share one property on the instance, and the second one\nsilently overwrites the first. Measured, as a select whose `value` came\nback holding its `open` boolean.\n\nOne field and not two. Writing always applies, the way a native control\ndoes when a script assigns to it.",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
               }
             },
             {
               "kind": "method",
-              "name": "renderTokenRow",
-              "privacy": "protected",
+              "name": "requestOpen",
               "return": {
                 "type": {
-                  "text": "TemplateResult | typeof nothing"
+                  "text": "boolean"
                 }
               },
               "parameters": [
                 {
-                  "name": "content",
-                  "type": {
-                    "text": "unknown"
-                  }
-                },
-                {
-                  "name": "over",
+                  "name": "next",
                   "type": {
-                    "text": "number"
+                    "text": "boolean"
                   }
                 }
               ],
+              "description": "Requests an open-state change, and reports whether it was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-open` or\n`helix-before-close` is a refusal and nothing moves. Nobody refusing means the\nelement opens or closes itself, whether or not a consumer declared\n`open`: a declared property is a seed and a correction, and a consumer\nwho wants the decision for themselves refuses it and assigns their own.",
               "inheritedFrom": {
-                "name": "MixinTokens",
-                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              },
+              "type": {
+                "text": "requestOpen(next: boolean) => boolean"
               }
             },
             {
               "kind": "method",
-              "name": "hideOverflow",
-              "privacy": "protected",
+              "name": "announceToggle",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "number"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "slot",
+                  "name": "open",
                   "type": {
-                    "text": "HTMLSlotElement | null | undefined"
+                    "text": "boolean"
                   }
                 }
               ],
+              "description": "Says the state moved, under the platform's own name and in its shape.\n\n**A native `toggle` from inside a shadow root reaches nobody**, because\nit neither bubbles nor composes, so the ten families showing a\n`popover=\"manual\"` panel and the two rendering a real `<dialog>` announce\nnothing to a consumer. The disclosures have no native element to fire\nanything at all: `AccordionItem` and `TreeItem` are `aria-expanded` and\n`hidden` written by hand, which is `<details>`'s job done manually.\n\n**From here rather than from `PopoverController`.** The controller covers\neleven families and the mixin covers sixteen, so announcing from both\nwould announce twice on the ten they share. What `toggle` reports is the\n*state*, and the state is this mixin's; the controller is a way of\nputting a panel on the screen.\n\n**`newState` and `oldState`, because that is the platform's shape**, so a\nconsumer arriving from `<details>` reads the same two words. Not\ncancelable: the before events are the request, and a second cancelable\nevent for one transition is two answers to one question.",
               "inheritedFrom": {
-                "name": "MixinTokens",
-                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
               }
             },
             {
               "kind": "method",
-              "name": "tokenKeydown",
-              "privacy": "protected",
+              "name": "toggleOpen",
               "return": {
                 "type": {
                   "text": "boolean"
                 }
               },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                },
-                {
-                  "name": "typed",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
+              "description": "Requests the opposite of the current state.",
               "inheritedFrom": {
-                "name": "MixinTokens",
-                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              },
+              "type": {
+                "text": "toggleOpen() => boolean"
               }
             },
             {
-              "kind": "method",
-              "name": "removeLastToken",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "collapseLabel",
+              "type": {
+                "text": "string"
               },
-              "description": "Asks the last token to go, rather than taking it.\n\n`dismiss()` is the tag's own, so this is the code path its remove control\nalready runs on a press: the consumer hears one `helix-dismiss`, cancels it\nor removes the element, and never learns which of the two asked. A slotted\nnode that is not a `Tag` has no such method and is left alone, because\nhiding a consumer's element on Backspace would be this element deciding\nsomething it was never given.",
+              "default": "'Show fewer'",
+              "description": "What the control says once everything is showing.",
+              "attribute": "collapse-label",
               "inheritedFrom": {
                 "name": "MixinTokens",
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
@@ -34540,29 +34711,225 @@
             },
             {
               "kind": "field",
-              "name": "defaultValue",
+              "name": "expandable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "The value the markup declared, which is where a reset returns to.",
-              "attribute": "default-value",
+              "default": "false",
+              "description": "Whether the count is a control that shows the rest.",
+              "attribute": "expandable",
               "inheritedFrom": {
-                "name": "MixinControllerValue",
-                "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "expandLabel",
               "type": {
                 "text": "string"
               },
-              "description": "What the control holds now, and what its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
-              "attribute": "value",
+              "default": "'Show all'",
+              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "attribute": "expand-label",
               "inheritedFrom": {
-                "name": "MixinControllerValue",
-                "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "maxTags",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How many tokens to show before the rest become a count.",
+              "attribute": "max-tags",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader has asked for all of them.\n\nState and private, the way `Input`'s `revealed` is: it is a reader's\nmomentary choice about what is on their own screen, it must not survive\nanything, and a consumer who wants the field opened is asking for\n`max-tags=\"0\"` rather than for a second way to say it.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "shownLimit",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "toggleExpanded",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Turns the cap off and on, which is all expanding is.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderTokenRow",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "content",
+                  "type": {
+                    "text": "unknown"
+                  }
+                },
+                {
+                  "name": "over",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderRest",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "over",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The count, as a control where the host asked for one and a word otherwise.\n\n**`part=\"rest\"` either way**, so a consumer's `::part(rest)` keeps working\nacross the change. The element under it is different, which is the point:\na `<span>` that looks like an affordance and answers nothing is the fault\nthis exists to fix, and the way to fix it is a real button rather than a\nclick handler on text.\n\n**Expanded, it renders on no count.** `shownLimit` is zero while expanded,\nso `over` is zero too, and gating the control on the number would take\naway the only way back.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hideOverflow",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "slot",
+                  "type": {
+                    "text": "HTMLSlotElement | null | undefined"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tokenKeydown",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                },
+                {
+                  "name": "typed",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeLastToken",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks the last token to go, rather than taking it.\n\n`dismiss()` is the tag's own, so this is the code path its remove control\nalready runs on a press: the consumer hears one `helix-dismiss`, cancels it\nor removes the element, and never learns which of the two asked. A slotted\nnode that is not a `Tag` has no such method and is left alone, because\nhiding a consumer's element on Backspace would be this element deciding\nsomething it was never given.",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The value the markup declared, which is where a reset returns to.",
+              "attribute": "default-value",
+              "inheritedFrom": {
+                "name": "MixinControllerValue",
+                "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "What the control holds now, and what its form submits.\n\nOne property, not two, so `input.value` answers the question anyone\nasking it meant. Writing always applies; `<helix-input value=\"x\">` is the\nsame statement in markup, and `default-value` is how markup seeds a value\na reset should return to.",
+              "attribute": "value",
+              "inheritedFrom": {
+                "name": "MixinControllerValue",
+                "module": "src/mixins/mixin-controller-value/mixin-controller-value.ts"
               }
             },
             {
@@ -34967,6 +35334,59 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "activeAt",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "-1",
+              "description": "Which suggestion the keyboard is on, or `-1` for none.\n\nAn index rather than a value, unlike Listbox's: these are the consumer's\nown list and two of them may legitimately carry the same value, a `label`\nand an `assignee` both called `ada`. Position is what a reader is moving\nthrough and it is what stays right when they do.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "suggesting",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether anything is offering itself to be suggested.\n\n**The ARIA follows this rather than being declared once.** A text field\ncarrying `role=\"combobox\"` promises a popup; a filter field that no consumer\never gives options to has none, and saying otherwise sends a screen reader\nlooking for a list that does not exist. So the role, `aria-expanded` and\n`aria-controls` all arrive with the first option and leave with the last.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dismissed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether Escape has closed the panel over text that still has suggestions.\n\nWithout it the panel is open whenever there is something to show, so Escape\nwould close it and the next render would put it straight back. Cleared by\nthe next keystroke, because that is the reader saying something new.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "panel",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new PopoverController(this, { anchor: () => this.renderRoot?.querySelector<HTMLElement>('[part=\"field\"]'), boundary: (): readonly (Element | null | undefined)[] => [ this.renderRoot?.querySelector<HTMLElement>('[part=\"surface\"]'), this.renderRoot?.querySelector<HTMLElement>('[part=\"field\"]'), ], offset: () => 4, onDismiss: () => this.requestOpen(false), placement: 'bottom-start', surface: () => this.renderRoot?.querySelector<HTMLElement>('[part=\"surface\"]'), })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "releaseCaret",
@@ -35034,6 +35454,97 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "suggestions",
+              "type": {
+                "text": "SuggestionOption[]"
+              },
+              "privacy": "private",
+              "description": "The suggestions, in the order a reader moves through them.\n\n**Groups are opened out rather than walked into.** A slot assigns the group\nelement, not the options inside it, so a panel that read only what was\nassigned would offer nothing at all the moment a consumer reached for\n`option-group` to say what a run of values belongs to.\n\nA disabled option keeps its place on screen and is skipped here, which is\nthe difference between a list that explains why something cannot be chosen\nand one that pretends it was never there.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "selectionDirection",
+              "type": {
+                "text": "'backward' | 'forward' | 'none'"
+              },
+              "description": "The caret and the selection, under the platform's own names.\n\n**Published for the reason `Input` publishes them, and this element needs\nthem more.** The `<input>` is inside this shadow root, so a consumer has no\nway to ask where the caret is: `querySelector` does not cross the boundary.\nA grammar that completes what is being typed cannot work without it, because\n\"what is being typed\" is the term the caret is in, and after writing a\ncompletion back the caret has to be put after it or the next parse reads the\nwrong term.\n\nZero before there is a control, which is where an empty field's caret would\nbe anyway.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "selectionEnd",
+              "type": {
+                "text": "number"
+              },
+              "description": "Where the selection ends, which is the caret when nothing is selected.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "selectionStart",
+              "type": {
+                "text": "number"
+              },
+              "description": "Where the selection starts, which is the caret when nothing is selected.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setSelectionRange",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "start",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "end",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "direction",
+                  "optional": true,
+                  "type": {
+                    "text": "'backward' | 'forward' | 'none'"
+                  }
+                }
+              ],
+              "description": "Moves the caret, or selects a run of the text.",
+              "type": {
+                "text": "setSelectionRange(start: number, end: number, direction?: 'backward' | 'forward' | 'none') => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleInput",
@@ -35067,6 +35578,44 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "settleOpen",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Opens the panel when there is something in it, and closes it when there is\nnot.\n\n**Derived rather than commanded, which is the whole of how two levels\nwork.** A reader who picks `disposition` wants its values next, and the\nconsumer answers by rendering those values; if picking closed the panel it\nwould shut and reopen between two renders, which a reader sees as a flicker\nand a screen reader hears as a list going away. Nothing here closes on a\nchoice: the panel goes when the consumer stops offering, which is exactly\nwhen a value has been completed and there is nothing left to say.\n\nThrough `requestOpen` for both directions, so `helix-before-open` and\n`helix-before-close` still gate it and a consumer who refuses is obeyed.\n**No guard of its own**, because that method already returns early when the\nanswer has not moved: this runs after every render, and a second guard here\nwould only be a copy of that one going stale.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "move",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "by",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves the highlight, wrapping, and opens the panel if it was closed.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleKeydown",
@@ -35077,6 +35626,54 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "refreshSuggesting",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "What is on offer, settled before the render that draws it.\n\n**Not left to `slotchange`, for the reason the token row is not.** That\nevent reports the assignment moving and nothing else, and it does not fire\nat all under the harness these are tested in, so a panel that learned only\nfrom it would be a panel that never opened. Reading the slot every update is\nwhat makes the answer true whenever anyone asks.\n\nState only. Opening is an announcement and belongs after the render, which\nis why `settleOpen` is not called from here.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSuggestions",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The panel again, whenever what is in it changes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusIn",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Focus arriving in the field is a reader asking what they can type.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleFocusOut",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Focus leaving the element closes it.\n\n`relatedTarget` and not a timer: a press inside the panel moves focus within\nthis element and must not close what is being pressed.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleTokens",
@@ -35088,6 +35685,21 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "markActive",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Marks the highlighted suggestion, and tells the control which one it is.\n\n**Two halves, and neither does the other's job.** `active` is the option's\nown published flag and is what a stylesheet draws from. The control carries\n`aria-activedescendant`, because focus never leaves the text: a screen\nreader is told what is highlighted by the field the caret is in, not by the\nlist.\n\nThrough `ariaActiveDescendantElement` rather than an id, which is what\n`Listbox` reaches for and for the same two reasons: it crosses a shadow\nboundary, where an `aria-activedescendant` naming an id cannot, and it needs\nno ids invented for the consumer's own elements. Feature-tested, because\nwhere it is missing the assignment is a silent no-op rather than an error,\nand the highlight is still drawn.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "focus",
@@ -35445,9 +36057,18 @@
                 "description": "Backspace on an empty field asks the same way the close control does.",
                 "slug": "dismissing"
               },
+              {
+                "description": "A capped row whose count opens it, and closes it again.",
+                "slug": "expandable"
+              },
               {
                 "description": "A cap for a field in a row, where the rest becomes a count.",
                 "slug": "max-tags"
+              },
+              {
+                "description": "Keys before the colon, values after it, in one panel.",
+                "min": 420,
+                "slug": "suggesting"
               }
             ],
             "source": "helix/styled/src/filter-input"
@@ -35455,6 +36076,70 @@
           "tagName": "helix-filter-input",
           "customElement": true,
           "attributes": [
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "fieldName": "open",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "fieldName": "defaultOpen",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "name": "collapse-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show fewer'",
+              "description": "What the control says once everything is showing.",
+              "fieldName": "collapseLabel",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "name": "expandable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the count is a control that shows the rest.",
+              "fieldName": "expandable",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
+            {
+              "name": "expand-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Show all'",
+              "description": "What the collapsed count is called, since `+3` names nothing.",
+              "fieldName": "expandLabel",
+              "inheritedFrom": {
+                "name": "MixinTokens",
+                "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
+              }
+            },
             {
               "name": "max-tags",
               "type": {
@@ -35647,6 +36332,42 @@
                 "name": "HelixHeadlessFilterInput",
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeCloseEvent"
+              },
+              "description": "Fired before the suggestions go, and cancelable.",
+              "name": "helix-before-close",
+              "reactProp": "onhelix-before-close",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeOpenEvent"
+              },
+              "description": "Fired before the suggestions show, and cancelable.",
+              "name": "helix-before-open",
+              "reactProp": "onhelix-before-open",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Says the panel moved, carrying `newState` and `oldState`.",
+              "name": "toggle",
+              "reactProp": "ontoggle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
             }
           ],
           "slots": [
@@ -35666,6 +36387,14 @@
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "What could be typed next, as `Option`s, and `Option.Group`s of them.",
+              "name": "suggestions",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "What is already narrowing the results, as `Tag`s.",
               "name": "tags",
@@ -35725,13 +36454,21 @@
               }
             },
             {
-              "description": "How many tokens did not fit.",
+              "description": "How many tokens did not fit. A `<button>` with `expandable`, a `<span>` without it.",
               "name": "rest",
               "inheritedFrom": {
                 "name": "HelixHeadlessFilterInput",
                 "module": "src/filter-input/root/filter-input-root.ts"
               }
             },
+            {
+              "description": "The floating panel the suggestions sit in.",
+              "name": "surface",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "description": "The row the tokens sit in.",
               "name": "tags",