@warp-ds/elements 2.3.2 → 2.4.0-next.10

package/dist/packages/combobox/combobox.d.ts

@@ -0,0 +1,89 @@
+import { LitElement, PropertyValues } from 'lit';
+export interface ComboboxOption {
+    value: string;
+    label?: string;
+    key?: string;
+}
+declare const WarpCombobox_base: import("@open-wc/form-control").Constructor<import("@open-wc/form-control").FormControlInterface> & typeof LitElement;
+/**
+ * A combobox element for text input with selectable options.
+ *
+ * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-combobox--docs)
+ */
+export declare class WarpCombobox extends WarpCombobox_base {
+    #private;
+    /** The available options to select from */
+    options: ComboboxOption[];
+    /** Label above input */
+    label?: string;
+    /** Input placeholder */
+    placeholder?: string;
+    /** The input value */
+    value: string;
+    /** Whether the popover opens when focus is on the text field */
+    openOnFocus: boolean;
+    /** Select active option on blur */
+    selectOnBlur: boolean;
+    /** Whether the matching text segments in the options should be highlighted */
+    matchTextSegments: boolean;
+    /** Disable client-side static filtering */
+    disableStaticFiltering: boolean;
+    /** Renders the input field in an invalid state */
+    invalid: boolean;
+    /** The content to display as the help text */
+    helpText?: string;
+    /** Whether the element is disabled */
+    disabled: boolean;
+    /** Whether the element is required */
+    required: boolean;
+    /** Whether to show optional text */
+    optional: boolean;
+    /** Name attribute for form submission */
+    name?: string;
+    /** Autocomplete attribute for the input field */
+    autocomplete?: string;
+    /** @internal Options list open boolean */
+    private _isOpen;
+    /** @internal The option the user has navigated to with their keyboard */
+    private _navigationOption;
+    /** @internal Available options based on user's input value */
+    private _currentOptions;
+    /** @internal Unique identifier counter for options */
+    private _optionIdCounter;
+    static styles: import("lit").CSSResult[];
+    constructor();
+    firstUpdated(changedProps: Map<string, unknown>): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    resetFormControl(): void;
+    private get _listboxId();
+    private get _id();
+    private get _helpId();
+    private get _navigationValueOrInputValue();
+    /** Generate options with unique IDs and match information */
+    private _createOptionsWithIdAndMatch;
+    /** Get ARIA text for screen readers */
+    private _getAriaText;
+    /** Get option classes */
+    private _getOptionClasses;
+    /** Handle keyboard navigation */
+    private _handleKeyDown;
+    /** Find and set active option based on keyboard navigation */
+    private _findAndSetActiveOption;
+    /** Handle option selection */
+    private _handleSelect;
+    /** Handle input change */
+    private _handleChange;
+    /** Handle input focus */
+    private _handleFocus;
+    /** Handle input blur */
+    private _handleBlur;
+    /** Handle option click */
+    private _handleOptionClick;
+    /** Handle container blur */
+    private _handleContainerBlur;
+    /** Render highlighted text match */
+    private _renderTextMatch;
+    protected willUpdate(changedProperties: PropertyValues<this>): void;
+    render(): import("lit").TemplateResult<1>;
+}
+export {};