@breadstone/mosaik-elements-foundation 0.0.151 → 0.0.152

package/Controls/Components/Inputs/AutoCompleteBox/AutoCompleteBoxElement.d.ts

@@ -1,6 +1,13 @@
+import { CssLength } from '@breadstone/mosaik-themes';
+import { type TemplateResult } from '../../../../Dom/Html';
 import { CustomElement } from '../../Abstracts/CustomElement';
 import type { IAutoCompleteBoxElementProps } from './IAutoCompleteBoxElementProps';
-declare const AutoCompleteBoxElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/AutoCompleteable").IAutoCompleteableProps & import("../../../Behaviors/AutoCompleteable").IAutoCompletableEvents & import("../../../Behaviors/AutoCompleteable").IAutoCompletable) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
+import { Placement } from '../../../Types/Placement';
+import { Strategy } from '../../../Types/Strategy';
+import { FloatingSync } from '../../../Types/FloatingSync';
+import { type IDropDownable } from '../../../Behaviors/DropDownable';
+import { AutoCompleteBoxElementIntl } from './AutoCompleteBoxElementIntl';
+declare const AutoCompleteBoxElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/DropDownable").IDropDownableProps & IDropDownable) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Focusable").IFocusableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/AutoCompleteable").IAutoCompleteableProps & import("../../../Behaviors/AutoCompleteable").IAutoCompletableEvents & import("../../../Behaviors/AutoCompleteable").IAutoCompletable) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
  * Auto Complete Box - An input field with auto-completion functionality for enhanced user experience.
  *
@@ -17,6 +24,8 @@ declare const AutoCompleteBoxElement_base: (abstract new (...args: Array<any>) =
  * @csspart input - the input field.
  * @csspart list - the suggestions list.
  * @csspart item - individual suggestion items.
+ * @csspart portal - the floating portal container for the suggestions.
+ * @csspart popup - the floating popup container for the suggestions.
  *
  * @cssprop {String} --auto-complete-box-background-color - The background color.
  * @cssprop {String} --auto-complete-box-border-color - The border color.
@@ -33,6 +42,9 @@ declare const AutoCompleteBoxElement_base: (abstract new (...args: Array<any>) =
  * @cssprop {String} --auto-complete-box-shadow - The shadow.
  * @cssprop {String} --auto-complete-box-width - The width.
  *
+ * @dependency mosaik-portal - Provides a portal host for rendering the suggestion popup.
+ * @dependency mosaik-floating - Positions the suggestion popup relative to the host element.
+ *
  * @example
  * ```html
  * <mosaik-autocompletebox
@@ -43,8 +55,18 @@ declare const AutoCompleteBoxElement_base: (abstract new (...args: Array<any>) =
  *
  * @public
  */
-export declare class AutoCompleteBoxElement extends AutoCompleteBoxElement_base implements IAutoCompleteBoxElementProps {
+export declare class AutoCompleteBoxElement extends AutoCompleteBoxElement_base implements IAutoCompleteBoxElementProps, IDropDownable {
+    private static _idCounter;
+    private static readonly _floatingFlipFallbackPlacements;
     private _text;
+    private _shouldSyncSearchFromText;
+    private _highlightedIndex;
+    private _lastFilterText;
+    private readonly _inputId;
+    private readonly _listboxId;
+    private readonly _intlController;
+    private _closeTimeoutHandle;
+    private _suggestionSync;
     /**
      * @public
      */
@@ -66,8 +88,219 @@ export declare class AutoCompleteBoxElement extends AutoCompleteBoxElement_base
      */
     get text(): string;
     set text(value: string);
-    onInput(e: Event): void;
+    /**
+     * Gets the identifier of the input element.
+     *
+     * @public
+     * @readonly
+     */
+    get inputId(): string;
+    /**
+     * Gets the identifier of the suggestion list element.
+     *
+     * @public
+     * @readonly
+     */
+    get listboxId(): string;
+    /**
+     * Gets the index of the highlighted suggestion.
+     *
+     * @public
+     * @readonly
+     */
+    get highlightedIndex(): number;
+    /**
+     * Gets a value indicating whether the suggestion list should be rendered.
+     *
+     * @public
+     * @readonly
+     */
+    get shouldRenderSuggestions(): boolean;
+    /**
+     * Gets a value indicating whether suggestions are available.
+     *
+     * @public
+     * @readonly
+     */
+    get hasSuggestions(): boolean;
+    /**
+     * Gets the active descendant identifier for accessibility.
+     *
+     * @public
+     * @readonly
+     */
+    get activeDescendantId(): string | null;
+    /**
+     * Gets a value indicating whether the no-results message should be displayed.
+     *
+     * @public
+     * @readonly
+     */
+    get shouldShowNoResultsMessage(): boolean;
+    /**
+     * Gets a value indicating whether the loading state should be displayed.
+     *
+     * @public
+     * @readonly
+     */
+    get shouldShowLoadingState(): boolean;
+    /**
+     * Gets or sets the preferred placement for the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get suggestionPlacement(): Placement;
+    set suggestionPlacement(value: Placement);
+    /**
+     * Gets or sets the positioning strategy for the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get suggestionStrategy(): Strategy;
+    set suggestionStrategy(value: Strategy);
+    /**
+     * Gets or sets the distance in pixels between the host and the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get suggestionDistance(): number;
+    set suggestionDistance(value: number);
+    /**
+     * Gets or sets the horizontal skidding offset for the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get suggestionSkidding(): number;
+    set suggestionSkidding(value: number);
+    /**
+     * Gets or sets the size synchronization mode for the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get suggestionSync(): FloatingSync;
+    set suggestionSync(value: FloatingSync);
+    /**
+     * Gets or sets the maximum height for the suggestion popup.
+     *
+     * @public
+     * @attr
+     */
+    get maxSuggestionHeight(): CssLength;
+    set maxSuggestionHeight(value: CssLength);
+    /**
+     * Gets the fallback placements used when positioning the suggestion popup.
+     *
+     * @public
+     * @readonly
+     */
+    get suggestionFlipFallbackPlacements(): Array<Placement>;
+    /**
+     * Returns the `intl` property.
+     *
+     * @public
+     * @readonly
+     */
+    get intl(): AutoCompleteBoxElementIntl;
+    /**
+       * Synchronizes the suggestion visibility with the floating popup state.
+       *
+       * @public
+       * @param isActive - Indicates whether the floating popup is active.
+       */
+    onFloatingActiveChanged(isActive: boolean): void;
+    /**
+     * @public
+     * @override
+     */
     onSelectCallback(item: unknown): void;
+    /**
+     * @public
+     * @override
+     */
+    disconnectedCallback(): void;
+    /**
+     * Handles input events raised by the native text box.
+     *
+     * @public
+     * @param event - The event that triggered the handler.
+     */
+    onInput(event: Event): void;
+    /**
+     * Handles focus events raised by the native input element.
+     *
+     * @public
+     */
+    onFocus(_event: FocusEvent): void;
+    /**
+     * Handles blur events raised by the native input element.
+     *
+     * @public
+     */
+    onBlur(_event: FocusEvent): void;
+    /**
+     * Handles keyboard interactions for navigating the suggestion list.
+     *
+     * @public
+     * @param event - The keyboard event that triggered the handler.
+     */
+    onKeyDown(event: KeyboardEvent): void;
+    /**
+     * Handles pointer events to keep the suggestion list open while interacting with it.
+     *
+     * @public
+     * @param event - The mouse event that triggered the handler.
+     */
+    onSuggestionMouseDown(event: MouseEvent): void;
+    /**
+     * Handles click events on suggestion items.
+     *
+     * @public
+     * @param index - The index of the clicked suggestion.
+     */
+    onSuggestionClick(index: number): void;
+    /**
+     * Renders a suggestion with highlighted text.
+     *
+     * @public
+     * @param item - The item to render.
+     */
+    renderHighlightedItem(item: unknown): TemplateResult;
+    /**
+     * Gets the identifier for the suggestion option at the specified index.
+     *
+     * @public
+     * @param index - The index of the option.
+     */
+    getOptionId(index: number): string;
+    /**
+     * Synchronizes internal state when the dropdown open state changes.
+     *
+     * @protected
+     */
+    protected onDropDownOpenChanged(_previous?: boolean, next?: boolean): void;
+    /**
+     * @protected
+     */
+    protected onDisabledChanged(_previous: boolean, next: boolean): void;
+    private static generateId;
+    private getInputElement;
+    private executeWithoutSearchSync;
+    private openSuggestions;
+    private closeSuggestions;
+    private scheduleCloseSuggestions;
+    private cancelCloseSuggestions;
+    private clearCloseTimeout;
+    private commitSelection;
+    private applyTextCompletion;
+    private moveHighlight;
+    private setHighlightedIndex;
+    private scrollHighlightedOptionIntoView;
+    private scrollOptionIntoView;
 }
 /**
  * @public

package/Controls/Components/Inputs/AutoCompleteBox/AutoCompleteBoxElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoCompleteBoxElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Inputs/AutoCompleteBox/AutoCompleteBoxElement.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;;AAQnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAca,sBACT,SAAQ,2BACR,YAAW,4BAA4B;IAIvC,OAAO,CAAC,KAAK,CAAc;IAM3B;;OAEG;;IASH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;OAKG;IACH,IACW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAK5B;IAMM,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IAMd,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAMxD;AAED;;GAEG;AACH,yBAAiB,sBAAsB,CAAC;IACpC,KAAY,KAAK,GAAG,4BAA4B,CAAC;CACpD;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,wBAAwB,EAAE,sBAAsB,CAAC;KACpD;CACJ"}
+{"version":3,"file":"AutoCompleteBoxElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Inputs/AutoCompleteBox/AutoCompleteBoxElement.ts"],"names":[],"mappings":"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"}