@fusion.dev/helix-headless 0.13.2 → 0.15.0

package/types/jsx.d.ts

@@ -3065,6 +3065,16 @@ the resolved state for stylesheets, which is what the mirror is for. */
   "default-open"?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
   /** Initial open state for uncontrolled use, where nothing declared one. */
   defaultOpen?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "collapse-label"?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  collapseLabel?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  expandable?: (HelixHeadlessCombobox["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "expand-label"?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  expandLabel?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "max-tags"?: (HelixHeadlessCombobox["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -3221,6 +3231,16 @@ the resolved state for stylesheets, which is what the mirror is for. */
   "bool:default-open"?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
   /** Initial open state for uncontrolled use, where nothing declared one. */
   "prop:defaultOpen"?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "attr:collapse-label"?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  "prop:collapseLabel"?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  "prop:expandable"?: (HelixHeadlessCombobox["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "attr:expand-label"?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "prop:expandLabel"?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "attr:max-tags"?: (HelixHeadlessCombobox["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -5780,6 +5800,12 @@ export type HelixHeadlessFilterInputElementEvent<E = Event> = TypedEvent<
 /** `helix-before-change` event type */
 export type HelixHeadlessFilterInputHelixBeforeChangeElementEvent =
   HelixHeadlessFilterInputElementEvent<HelixBeforeChangeEvent>;
+/** `helix-before-close` event type */
+export type HelixHeadlessFilterInputHelixBeforeCloseElementEvent =
+  HelixHeadlessFilterInputElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixHeadlessFilterInputHelixBeforeOpenElementEvent =
+  HelixHeadlessFilterInputElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixHeadlessFilterInputProps = {
   /** Whether the field offers a button that empties it.
@@ -5797,6 +5823,33 @@ them. */
 
 Not a label: it goes when typing starts. */
   placeholder?: (HelixHeadlessFilterInput["placeholder"]) | undefined;
+  /** Whether the element is open.
+
+One property, not two, so `dialog.open` answers the question anyone
+asking it meant. Writing always applies; `<helix-dialog open>` is the
+same statement in markup.
+
+**Not reflected, and that is required rather than tidy.** Reflection
+writes the resolved state back as an attribute, so an element that opened
+itself would put `open` on its own host: cloned, serialized for
+hydration, or diffed by a framework, it comes back holding whatever the
+last reader did rather than what the author wrote. `:state(open)` carries
+the resolved state for stylesheets, which is what the mirror is for. */
+  open?: (HelixHeadlessFilterInput["open"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  "default-open"?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  defaultOpen?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "collapse-label"?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  collapseLabel?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  expandable?: (HelixHeadlessFilterInput["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "expand-label"?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  expandLabel?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "max-tags"?: (HelixHeadlessFilterInput["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -5853,8 +5906,18 @@ Here rather than on each control. */
   "onhelix-before-change"?: ((
     e: HelixHeadlessFilterInputHelixBeforeChangeElementEvent,
   ) => void) | undefined;
+  /** Fired before the suggestions go, and cancelable. */
+  "onhelix-before-close"?: ((
+    e: HelixHeadlessFilterInputHelixBeforeCloseElementEvent,
+  ) => void) | undefined;
+  /** Fired before the suggestions show, and cancelable. */
+  "onhelix-before-open"?: ((
+    e: HelixHeadlessFilterInputHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Announced once the text has moved. */
   oninput?: ((e: HelixHeadlessFilterInputElementEvent) => void) | undefined;
+  /** Says the panel moved, carrying `newState` and `oldState`. */
+  ontoggle?: ((e: HelixHeadlessFilterInputElementEvent) => void) | undefined;
 };
 
 export type HelixHeadlessFilterInputSolidJsProps = {
@@ -5873,6 +5936,33 @@ them. */
 
 Not a label: it goes when typing starts. */
   "prop:placeholder"?: (HelixHeadlessFilterInput["placeholder"]) | undefined;
+  /** Whether the element is open.
+
+One property, not two, so `dialog.open` answers the question anyone
+asking it meant. Writing always applies; `<helix-dialog open>` is the
+same statement in markup.
+
+**Not reflected, and that is required rather than tidy.** Reflection
+writes the resolved state back as an attribute, so an element that opened
+itself would put `open` on its own host: cloned, serialized for
+hydration, or diffed by a framework, it comes back holding whatever the
+last reader did rather than what the author wrote. `:state(open)` carries
+the resolved state for stylesheets, which is what the mirror is for. */
+  "prop:open"?: (HelixHeadlessFilterInput["open"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  "bool:default-open"?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  "prop:defaultOpen"?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "attr:collapse-label"?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  "prop:collapseLabel"?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  "prop:expandable"?: (HelixHeadlessFilterInput["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "attr:expand-label"?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "prop:expandLabel"?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "attr:max-tags"?: (HelixHeadlessFilterInput["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -5928,8 +6018,18 @@ Here rather than on each control. */
   "on:helix-before-change"?: ((
     e: HelixHeadlessFilterInputHelixBeforeChangeElementEvent,
   ) => void) | undefined;
+  /** Fired before the suggestions go, and cancelable. */
+  "on:helix-before-close"?: ((
+    e: HelixHeadlessFilterInputHelixBeforeCloseElementEvent,
+  ) => void) | undefined;
+  /** Fired before the suggestions show, and cancelable. */
+  "on:helix-before-open"?: ((
+    e: HelixHeadlessFilterInputHelixBeforeOpenElementEvent,
+  ) => void) | undefined;
   /** Announced once the text has moved. */
   "on:input"?: ((e: HelixHeadlessFilterInputElementEvent) => void) | undefined;
+  /** Says the panel moved, carrying `newState` and `oldState`. */
+  "on:toggle"?: ((e: HelixHeadlessFilterInputElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -18374,6 +18474,9 @@ export type CustomElements = {
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
    * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `collapse-label`/`collapseLabel`: What the control says once everything is showing.
+   * - `expandable`: Whether the count is a control that shows the rest.
+   * - `expand-label`/`expandLabel`: What the collapsed count is called, since `+3` names nothing.
    * - `max-tags`/`maxTags`: How many tokens to show before the rest become a count.
    * - `default-value`/`defaultValue`: The value the markup declared, which is where a reset returns to.
    * - `value`: What the control holds now, and what its form submits.
@@ -18545,7 +18648,7 @@ export type CustomElements = {
    * - `listbox-loading`: Shown while the options are still on their way.
    * - `listbox-search`: The region holding the field that narrows the list.
    * - `listbox-search-field`: The field itself.
-   * - `rest`: The count of choices held beyond `max-tags`.
+   * - `rest`: The count of choices held beyond `max-tags`. A `<button>` with `expandable`, a `<span>` without it.
    * - `surface`: The floating panel.
    * - `tag`: One chosen option.
    * - `tag-dismiss`: The remove button, when `dismissible`.
@@ -20524,6 +20627,20 @@ export type CustomElements = {
    * `helix-dismiss` its own remove control fires, so a consumer who handled the
    * pointer has already handled the keyboard.
    *
+   * **It can suggest what to type next, and it never learns the grammar.** Slot
+   * `helix-option` elements into `suggestions` and the field shows them, moves
+   * through them with the arrows, and lets Enter press one; the option fires its
+   * own `helix-select` and the consumer decides what choosing meant. Deciding
+   * *what* to suggest is theirs too: keys before a colon and values after it are
+   * the same panel with different contents, which is all a two-level filter is,
+   * and the parse that tells them apart belongs where the domain does.
+   *
+   * **The panel opens when there is something in it and closes when there is
+   * not**, rather than on a choice. A reader who picks a key wants its values
+   * next, and closing on the choice would shut the panel between two renders. Use
+   * `selectionStart` and `setSelectionRange` to write a completion back and put
+   * the caret after it, or the next parse reads the wrong term.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -20538,6 +20655,22 @@ export type CustomElements = {
    * - `placeholder`: Shown while the field is empty.
    *
    * Not a label: it goes when typing starts.
+   * - `open`: Whether the element is open.
+   *
+   * One property, not two, so `dialog.open` answers the question anyone
+   * asking it meant. Writing always applies; `<helix-dialog open>` is the
+   * same statement in markup.
+   *
+   * **Not reflected, and that is required rather than tidy.** Reflection
+   * writes the resolved state back as an attribute, so an element that opened
+   * itself would put `open` on its own host: cloned, serialized for
+   * hydration, or diffed by a framework, it comes back holding whatever the
+   * last reader did rather than what the author wrote. `:state(open)` carries
+   * the resolved state for stylesheets, which is what the mirror is for.
+   * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `collapse-label`/`collapseLabel`: What the control says once everything is showing.
+   * - `expandable`: Whether the count is a control that shows the rest.
+   * - `expand-label`/`expandLabel`: What the collapsed count is called, since `+3` names nothing.
    * - `max-tags`/`maxTags`: How many tokens to show before the rest become a count.
    * - `default-value`/`defaultValue`: The value the markup declared, which is where a reset returns to.
    * - `value`: What the control holds now, and what its form submits.
@@ -20574,6 +20707,20 @@ export type CustomElements = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
+   * - `selectionDirection`: The caret and the selection, under the platform's own names.
+   *
+   * **Published for the reason `Input` publishes them, and this element needs
+   * them more.** The `<input>` is inside this shadow root, so a consumer has no
+   * way to ask where the caret is: `querySelector` does not cross the boundary.
+   * A grammar that completes what is being typed cannot work without it, because
+   * "what is being typed" is the term the caret is in, and after writing a
+   * completion back the caret has to be put after it or the next parse reads the
+   * wrong term.
+   *
+   * Zero before there is a control, which is where an empty field's caret would
+   * be anyway. (property only) (readonly)
+   * - `selectionEnd`: Where the selection ends, which is the caret when nothing is selected. (property only) (readonly)
+   * - `selectionStart`: Where the selection starts, which is the caret when nothing is selected. (property only) (readonly)
    * - `form`: The form this control belongs to, if any. (property only) (readonly)
    * - `labels`: Labels associated with this control. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -20601,7 +20748,10 @@ export type CustomElements = {
    *
    * - `change`: Relayed from the input once the reader has finished.
    * - `helix-before-change`: Fired as the text changes, and cancelable.
+   * - `helix-before-close`: Fired before the suggestions go, and cancelable.
+   * - `helix-before-open`: Fired before the suggestions show, and cancelable.
    * - `input`: Announced once the text has moved.
+   * - `toggle`: Says the panel moved, carrying `newState` and `oldState`.
    *
    * ## Slots
    *
@@ -20609,13 +20759,23 @@ export type CustomElements = {
    *
    * - `end`: After the text, for a count or a control.
    * - `start`: Before the text, for a search icon.
+   * - `suggestions`: What could be typed next, as `Option`s, and `Option.Group`s of them.
    * - `tags`: What is already narrowing the results, as `Tag`s.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
+   * - `setSelectionRange(start: number, end: number, direction?: 'backward' | 'forward' | 'none') => void`: Moves the caret, or selects a run of the text.
    * - `focus(options?: FocusOptions) => void`: Puts the caret in the field, the way a label pointing at one would.
+   * - `requestOpen(next: boolean) => boolean`: Requests an open-state change, and reports whether it was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-open` or
+   * `helix-before-close` is a refusal and nothing moves. Nobody refusing means the
+   * element opens or closes itself, whether or not a consumer declared
+   * `open`: a declared property is a seed and a correction, and a consumer
+   * who wants the decision for themselves refuses it and assigns their own.
+   * - `toggleOpen() => boolean`: Requests the opposite of the current state.
    * - `requestValue(next: string) => boolean`: Requests a new value, and reports whether the request stood.
    *
    * Announces before it acts, so `preventDefault()` on the `helix-before-change` is
@@ -20677,7 +20837,8 @@ export type CustomElements = {
    * - `field`: The box holding everything.
    * - `hint`: Help under the field, while nothing is wrong.
    * - `label`: The question, over the field.
-   * - `rest`: How many tokens did not fit.
+   * - `rest`: How many tokens did not fit. A `<button>` with `expandable`, a `<span>` without it.
+   * - `surface`: The floating panel the suggestions sit in.
    * - `tags`: The row the tokens sit in.
    */
   "helix-headless-filter-input": Partial<
@@ -32774,6 +32935,9 @@ export type CustomElementsSolidJs = {
    * last reader did rather than what the author wrote. `:state(open)` carries
    * the resolved state for stylesheets, which is what the mirror is for.
    * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `collapse-label`/`collapseLabel`: What the control says once everything is showing.
+   * - `expandable`: Whether the count is a control that shows the rest.
+   * - `expand-label`/`expandLabel`: What the collapsed count is called, since `+3` names nothing.
    * - `max-tags`/`maxTags`: How many tokens to show before the rest become a count.
    * - `default-value`/`defaultValue`: The value the markup declared, which is where a reset returns to.
    * - `value`: What the control holds now, and what its form submits.
@@ -32945,7 +33109,7 @@ export type CustomElementsSolidJs = {
    * - `listbox-loading`: Shown while the options are still on their way.
    * - `listbox-search`: The region holding the field that narrows the list.
    * - `listbox-search-field`: The field itself.
-   * - `rest`: The count of choices held beyond `max-tags`.
+   * - `rest`: The count of choices held beyond `max-tags`. A `<button>` with `expandable`, a `<span>` without it.
    * - `surface`: The floating panel.
    * - `tag`: One chosen option.
    * - `tag-dismiss`: The remove button, when `dismissible`.
@@ -34958,6 +35122,20 @@ export type CustomElementsSolidJs = {
    * `helix-dismiss` its own remove control fires, so a consumer who handled the
    * pointer has already handled the keyboard.
    *
+   * **It can suggest what to type next, and it never learns the grammar.** Slot
+   * `helix-option` elements into `suggestions` and the field shows them, moves
+   * through them with the arrows, and lets Enter press one; the option fires its
+   * own `helix-select` and the consumer decides what choosing meant. Deciding
+   * *what* to suggest is theirs too: keys before a colon and values after it are
+   * the same panel with different contents, which is all a two-level filter is,
+   * and the parse that tells them apart belongs where the domain does.
+   *
+   * **The panel opens when there is something in it and closes when there is
+   * not**, rather than on a choice. A reader who picks a key wants its values
+   * next, and closing on the choice would shut the panel between two renders. Use
+   * `selectionStart` and `setSelectionRange` to write a completion back and put
+   * the caret after it, or the next parse reads the wrong term.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -34972,6 +35150,22 @@ export type CustomElementsSolidJs = {
    * - `placeholder`: Shown while the field is empty.
    *
    * Not a label: it goes when typing starts.
+   * - `open`: Whether the element is open.
+   *
+   * One property, not two, so `dialog.open` answers the question anyone
+   * asking it meant. Writing always applies; `<helix-dialog open>` is the
+   * same statement in markup.
+   *
+   * **Not reflected, and that is required rather than tidy.** Reflection
+   * writes the resolved state back as an attribute, so an element that opened
+   * itself would put `open` on its own host: cloned, serialized for
+   * hydration, or diffed by a framework, it comes back holding whatever the
+   * last reader did rather than what the author wrote. `:state(open)` carries
+   * the resolved state for stylesheets, which is what the mirror is for.
+   * - `default-open`/`defaultOpen`: Initial open state for uncontrolled use, where nothing declared one.
+   * - `collapse-label`/`collapseLabel`: What the control says once everything is showing.
+   * - `expandable`: Whether the count is a control that shows the rest.
+   * - `expand-label`/`expandLabel`: What the collapsed count is called, since `+3` names nothing.
    * - `max-tags`/`maxTags`: How many tokens to show before the rest become a count.
    * - `default-value`/`defaultValue`: The value the markup declared, which is where a reset returns to.
    * - `value`: What the control holds now, and what its form submits.
@@ -35008,6 +35202,20 @@ export type CustomElementsSolidJs = {
    * imperatively later, and nothing is hydrating by then.
    *
    * Here rather than on each control.
+   * - `selectionDirection`: The caret and the selection, under the platform's own names.
+   *
+   * **Published for the reason `Input` publishes them, and this element needs
+   * them more.** The `<input>` is inside this shadow root, so a consumer has no
+   * way to ask where the caret is: `querySelector` does not cross the boundary.
+   * A grammar that completes what is being typed cannot work without it, because
+   * "what is being typed" is the term the caret is in, and after writing a
+   * completion back the caret has to be put after it or the next parse reads the
+   * wrong term.
+   *
+   * Zero before there is a control, which is where an empty field's caret would
+   * be anyway. (property only) (readonly)
+   * - `selectionEnd`: Where the selection ends, which is the caret when nothing is selected. (property only) (readonly)
+   * - `selectionStart`: Where the selection starts, which is the caret when nothing is selected. (property only) (readonly)
    * - `form`: The form this control belongs to, if any. (property only) (readonly)
    * - `labels`: Labels associated with this control. (property only) (readonly)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -35035,7 +35243,10 @@ export type CustomElementsSolidJs = {
    *
    * - `change`: Relayed from the input once the reader has finished.
    * - `helix-before-change`: Fired as the text changes, and cancelable.
+   * - `helix-before-close`: Fired before the suggestions go, and cancelable.
+   * - `helix-before-open`: Fired before the suggestions show, and cancelable.
    * - `input`: Announced once the text has moved.
+   * - `toggle`: Says the panel moved, carrying `newState` and `oldState`.
    *
    * ## Slots
    *
@@ -35043,13 +35254,23 @@ export type CustomElementsSolidJs = {
    *
    * - `end`: After the text, for a count or a control.
    * - `start`: Before the text, for a search icon.
+   * - `suggestions`: What could be typed next, as `Option`s, and `Option.Group`s of them.
    * - `tags`: What is already narrowing the results, as `Tag`s.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
+   * - `setSelectionRange(start: number, end: number, direction?: 'backward' | 'forward' | 'none') => void`: Moves the caret, or selects a run of the text.
    * - `focus(options?: FocusOptions) => void`: Puts the caret in the field, the way a label pointing at one would.
+   * - `requestOpen(next: boolean) => boolean`: Requests an open-state change, and reports whether it was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-open` or
+   * `helix-before-close` is a refusal and nothing moves. Nobody refusing means the
+   * element opens or closes itself, whether or not a consumer declared
+   * `open`: a declared property is a seed and a correction, and a consumer
+   * who wants the decision for themselves refuses it and assigns their own.
+   * - `toggleOpen() => boolean`: Requests the opposite of the current state.
    * - `requestValue(next: string) => boolean`: Requests a new value, and reports whether the request stood.
    *
    * Announces before it acts, so `preventDefault()` on the `helix-before-change` is
@@ -35111,7 +35332,8 @@ export type CustomElementsSolidJs = {
    * - `field`: The box holding everything.
    * - `hint`: Help under the field, while nothing is wrong.
    * - `label`: The question, over the field.
-   * - `rest`: How many tokens did not fit.
+   * - `rest`: How many tokens did not fit. A `<button>` with `expandable`, a `<span>` without it.
+   * - `surface`: The floating panel the suggestions sit in.
    * - `tags`: The row the tokens sit in.
    */
   "helix-headless-filter-input": Partial<

package/types/vue.d.ts

@@ -1620,6 +1620,16 @@ the resolved state for stylesheets, which is what the mirror is for. */
   "default-open"?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
   /** Initial open state for uncontrolled use, where nothing declared one. */
   defaultOpen?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "collapse-label"?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  collapseLabel?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  expandable?: (HelixHeadlessCombobox["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "expand-label"?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  expandLabel?: (HelixHeadlessCombobox["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "max-tags"?: (HelixHeadlessCombobox["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -2965,6 +2975,12 @@ export type HelixHeadlessFilterInputElementEvent<E = Event> = TypedEvent<
 /** `helix-before-change` event type */
 export type HelixHeadlessFilterInputHelixBeforeChangeElementEvent =
   HelixHeadlessFilterInputElementEvent<HelixBeforeChangeEvent>;
+/** `helix-before-close` event type */
+export type HelixHeadlessFilterInputHelixBeforeCloseElementEvent =
+  HelixHeadlessFilterInputElementEvent<HelixBeforeCloseEvent>;
+/** `helix-before-open` event type */
+export type HelixHeadlessFilterInputHelixBeforeOpenElementEvent =
+  HelixHeadlessFilterInputElementEvent<HelixBeforeOpenEvent>;
 
 export type HelixHeadlessFilterInputVueProps = {
   /** Whether the field offers a button that empties it.
@@ -2982,6 +2998,33 @@ them. */
 
 Not a label: it goes when typing starts. */
   placeholder?: (HelixHeadlessFilterInput["placeholder"]) | undefined;
+  /** Whether the element is open.
+
+One property, not two, so `dialog.open` answers the question anyone
+asking it meant. Writing always applies; `<helix-dialog open>` is the
+same statement in markup.
+
+**Not reflected, and that is required rather than tidy.** Reflection
+writes the resolved state back as an attribute, so an element that opened
+itself would put `open` on its own host: cloned, serialized for
+hydration, or diffed by a framework, it comes back holding whatever the
+last reader did rather than what the author wrote. `:state(open)` carries
+the resolved state for stylesheets, which is what the mirror is for. */
+  open?: (HelixHeadlessFilterInput["open"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  "default-open"?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** Initial open state for uncontrolled use, where nothing declared one. */
+  defaultOpen?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
+  /** What the control says once everything is showing. */
+  "collapse-label"?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** What the control says once everything is showing. */
+  collapseLabel?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
+  /** Whether the count is a control that shows the rest. */
+  expandable?: (HelixHeadlessFilterInput["expandable"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  "expand-label"?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
+  /** What the collapsed count is called, since `+3` names nothing. */
+  expandLabel?: (HelixHeadlessFilterInput["expandLabel"]) | undefined;
   /** How many tokens to show before the rest become a count. */
   "max-tags"?: (HelixHeadlessFilterInput["maxTags"]) | undefined;
   /** How many tokens to show before the rest become a count. */
@@ -3038,8 +3081,14 @@ export type HelixHeadlessFilterInputVueEvents = {
   change: HelixHeadlessFilterInputElementEvent;
   /** Fired as the text changes, and cancelable. */
   "helix-before-change": HelixHeadlessFilterInputHelixBeforeChangeElementEvent;
+  /** Fired before the suggestions go, and cancelable. */
+  "helix-before-close": HelixHeadlessFilterInputHelixBeforeCloseElementEvent;
+  /** Fired before the suggestions show, and cancelable. */
+  "helix-before-open": HelixHeadlessFilterInputHelixBeforeOpenElementEvent;
   /** Announced once the text has moved. */
   input: HelixHeadlessFilterInputElementEvent;
+  /** Says the panel moved, carrying `newState` and `oldState`. */
+  toggle: HelixHeadlessFilterInputElementEvent;
 };
 
 export type HelixHeadlessFormatDateVueProps = {
@@ -8313,7 +8362,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessFileInputVueProps,
     HelixHeadlessFileInputVueEvents
   >;
-  /** **The tokens are the consumer's own elements, slotted.** What a filter narrows by belongs to the consumer's model rather than to this element: a facet with a prefix, a saved query, a range. So they are slotted rather than rendered from a list of strings, and removing one is a request this element makes rather than a change it applies. Combobox is the other way round, and that is the difference between the two: its tokens are a view of a selection it owns, drawn from options it was handed.  **'value' is the text being typed, not the tokens**, which is what makes this a field a consumer can listen to. Every keystroke announces 'input' with the text on the element, so a table narrows as the reader types. The tokens need no reporting back, being markup the consumer already holds.  Backspace on an empty field asks the last token to go, through the same 'helix-dismiss' its own remove control fires, so a consumer who handled the pointer has already handled the keyboard. */
+  /** **The tokens are the consumer's own elements, slotted.** What a filter narrows by belongs to the consumer's model rather than to this element: a facet with a prefix, a saved query, a range. So they are slotted rather than rendered from a list of strings, and removing one is a request this element makes rather than a change it applies. Combobox is the other way round, and that is the difference between the two: its tokens are a view of a selection it owns, drawn from options it was handed.  **'value' is the text being typed, not the tokens**, which is what makes this a field a consumer can listen to. Every keystroke announces 'input' with the text on the element, so a table narrows as the reader types. The tokens need no reporting back, being markup the consumer already holds.  Backspace on an empty field asks the last token to go, through the same 'helix-dismiss' its own remove control fires, so a consumer who handled the pointer has already handled the keyboard.  **It can suggest what to type next, and it never learns the grammar.** Slot 'helix-option' elements into 'suggestions' and the field shows them, moves through them with the arrows, and lets Enter press one; the option fires its own 'helix-select' and the consumer decides what choosing meant. Deciding *what* to suggest is theirs too: keys before a colon and values after it are the same panel with different contents, which is all a two-level filter is, and the parse that tells them apart belongs where the domain does.  **The panel opens when there is something in it and closes when there is not**, rather than on a choice. A reader who picks a key wants its values next, and closing on the choice would shut the panel between two renders. Use 'selectionStart' and 'setSelectionRange' to write a completion back and put the caret after it, or the next parse reads the wrong term. */
   "helix-headless-filter-input": DefineCustomElement<
     HelixHeadlessFilterInput,
     HelixHeadlessFilterInputVueProps,