@grapecity/wijmo.input 5.20251.34 → 5.20252.42

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
     *
-    * Wijmo Library 5.20251.34
+    * Wijmo Library 5.20252.42
     * https://developer.mescius.com/wijmo
     *
     * Copyright(c) MESCIUS inc. All rights reserved.
@@ -39,6 +39,10 @@ export declare const CalendarClsNames: {
     weekAfter: string;
     weekBefore: string;
     yearPicker: string;
+    focused: string;
+    selectedYear: string;
+    confirmationButtonContainer: string;
+    button: string;
 };
 export declare const CollectionViewNavigatorClsNames: {
     hostElement: string;
@@ -69,12 +73,14 @@ export declare const InputColorClsNames: {
 export declare const InputDateClsNames: {
     hostElement: string;
     inputDateDropDown: string;
+    inputDateDropDownContainer: string;
 };
 export declare const InputDateRangeClsNames: {
     hostElement: string;
 };
 export declare const InputDateTimeClsNames: {
     hostElement: string;
+    showDropDownButton: string;
 };
 export declare const InputMaskClsNames: {
     hostElement: string;
@@ -104,6 +110,7 @@ export declare const MultiAutoCompleteClsNames: {
     tokenClose: string;
     tokenHelper: string;
     tokenLabel: string;
+    screenReaderOnly: string;
 };
 export declare const MultiSelectClsNames: {
     hostElement: string;
@@ -173,6 +180,8 @@ export declare class InputNumber extends Control {
     _rptDn: _ClickRepeater;
     _fromKb: boolean;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link InputNumber} controls.
      */
@@ -286,6 +295,10 @@ export declare class InputNumber extends Control {
      * The default value for this property is **true**.
      */
     repeatButtons: boolean;
+    /**
+     * Gets or sets the aria-labelledby attribute of input element.
+     */
+    ariaLabelledBy: string;
     /**
      * Sets the focus to the control and selects all its content.
      */
@@ -331,8 +344,17 @@ export declare class InputNumber extends Control {
     protected _keypress(e: KeyboardEvent): void;
     protected _keydown(e: KeyboardEvent): void;
     protected _input(): void;
+    /**
+     * Checks if the value represents a negative currency entered using parentheses.
+     * Scenario:
+     *   1. First input "(" → value changes to "-$0.00"
+     *   2. Then input a digit (e.g., "1") → value changes to "-$01.00"
+     */
+    private _isNegativeCurrencyByParenthesis;
     protected _clickSpinner(e: MouseEvent): void;
     protected _updateAria(): void;
+    _updateInputAriaLabel(): void;
+    getAriaLabelForScreenReader(): any;
 }
 /**
  * The {@link InputMask} control provides a way to govern what a user is allowed
@@ -387,6 +409,8 @@ export declare class InputMask extends Control {
     _msk: _MaskProvider;
     _fullEdit: boolean;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link InputMask} controls.
      */
@@ -489,6 +513,21 @@ export declare class InputMask extends Control {
     dispose(): void;
     refresh(fullUpdate?: boolean): void;
     onGotFocus(e: any): void;
+    /**
+     * Gets or sets the aria-labelledby attribute of input element.
+     */
+    ariaLabelledBy: string;
+    _updateInputAriaLabel(): void;
+    getAriaLabelForScreenReader(): any;
+}
+/**
+ * Specifies constants that define the action to be performed when the TAB key is pressed.
+ */
+export declare enum ColorPickerTabKeyAction {
+    /** No special action (let the browser handle the key). */
+    None = 0,
+    /** All buttons in the color picker can be selected using the tab key. */
+    All = 1
 }
 /**
  * The {@link ColorPicker} control allows users to select a color by clicking
@@ -514,7 +553,11 @@ export declare class ColorPicker extends Control {
     _ePal: HTMLElement;
     _ePreview: HTMLElement;
     _eText: HTMLElement;
+    _ePalMainFirst: HTMLElement;
+    _ePalShadeFirst: HTMLElement;
     _htDown: Element;
+    _ariaLabel: string;
+    private _keyActionTab;
     static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link ColorPicker} controls.
@@ -571,6 +614,20 @@ export declare class ColorPicker extends Control {
      * No exceptions are thrown in these cases.
      */
     palette: string[];
+    /**
+     * Gets or sets the aria-label attribute of {@link ColorPicker} host element.
+     *
+     * The default value for this property is "Color Picker".
+     */
+    ariaLabel: string;
+    /**
+     * Gets or sets the action to perform when the Tab key is pressed.
+     *
+     * The default setting for this property is {@link ColorPickerTabKeyAction.None},
+     * This means that pressing the tab key will have no effect and follow the browser's default behavior.
+     */
+    keyActionTab: ColorPickerTabKeyAction;
+    _setTabOrder(value: number): void;
     /**
      * Occurs when the value of the {@link value} property changes, either
      * as a result of user actions or by assignment in code.
@@ -587,7 +644,18 @@ export declare class ColorPicker extends Control {
     private _updatePalette;
     private _makePalEntry;
     private _updatePanels;
+    private getColorsDiv;
     private _getTargetPanel;
+    protected getActualTabIndex(): string;
+    private _updateTabIndex;
+    protected _setIsDisabled(value: boolean): void;
+    private _updateAriaValues;
+    private _keydown;
+    private _isInColorPalette;
+    private _handleColorNavigation;
+    private _handleHSBNavigation;
+    _refreshSelection(): void;
+    private _handleAlphaNavigation;
 }
 /**
  * The {@link CollectionViewNavigator} control provides a UI for navigating
@@ -757,9 +825,13 @@ export declare class ListBox<T = any> extends Control {
     _itemRole: string;
     _caseSensitive: boolean;
     _addMode: boolean;
+    private _isShiftDown;
+    private _shouldClearOnShift;
     _vThreshold: number;
     _isVirtual: boolean;
     _children: HTMLElement[];
+    _ignoreItemFormatterTextArray: string[];
+    _itemFormatterHelper: HTMLDivElement;
     _clientHeight: number;
     _itemHeight: number;
     _itemsAbove: number;
@@ -776,8 +848,10 @@ export declare class ListBox<T = any> extends Control {
     _oldSel: HTMLElement | null;
     _container: HTMLElement | null;
     _oldSelectedIndex: number;
+    _ariaLabel: string;
     static _DIDX_KEY: string;
     static _VTHRESH: number;
+    _isNeedUpdateBnd: boolean;
     /**
      * Initializes a new instance of the {@link ListBox} class.
      *
@@ -785,6 +859,10 @@ export declare class ListBox<T = any> extends Control {
      * @param options The JavaScript object containing initialization data for the control.
      */
     constructor(element: any, options?: any);
+    /**
+     * Gets or sets the aria-labelledby attribute of {@link ListBox} input element.
+     */
+    ariaLabelledBy: string;
     /**
      * Gets or sets the array or {@link ICollectionView} object that contains
      * the list items.
@@ -903,13 +981,14 @@ export declare class ListBox<T = any> extends Control {
      *
      * @param index The index of the item in the {@link itemsSource}.
      */
-    getDisplayValue(index: number): string;
+    getDisplayValue(index: number, ignoreItemFormatter?: boolean): string;
     /**
      * Gets the text displayed for the item at a given index (as plain text).
      *
      * @param index The index of the item in the {@link itemsSource}.
      */
     getDisplayText(index: number): string;
+    _getDisplayText(index: number, notGetByList?: boolean): string;
     /**
      * Gets a value that determines whether the item at a given index is enabled.
      *
@@ -1079,6 +1158,7 @@ export declare class ListBox<T = any> extends Control {
      * @param fullUpdate Whether to update the control layout as well as the content.
      */
     refresh(fullUpdate?: boolean): void;
+    _updateAriaLabel(): void;
     _updateCheckedList(arr: any[]): void;
     _getBoundingClientRect(e: HTMLElement): Rect;
     _updateItemAttributes(e: HTMLElement | null, selected: boolean): void;
@@ -1099,24 +1179,32 @@ export declare class ListBox<T = any> extends Control {
     _updateViewRange(): boolean;
     _getSelectedElement(visible: boolean): HTMLElement | null;
     _handleResize(): void;
-    _createItem(i: number): string;
+    _createItem(i: number, groupIndex?: number): string;
     _getAriaSelected(isSelected: boolean, isChecked: boolean | null): boolean;
-    _createHeaderItem(group: CollectionViewGroup): string;
+    _createHeaderItem(group: CollectionViewGroup, groupIndex: number): string;
     private _click;
     private _keydown;
+    private _handleKeyUp;
+    private _getCheckboxState;
+    private _setCheckboxState;
+    private _getCheckbox;
     private _keypress;
-    _selectNext(): boolean;
-    _selectPrev(): boolean;
+    private _selectNext;
+    private _selectPrev;
+    private _findNextEnabled;
+    private _findPrevEnabled;
     _selectFirst(): boolean;
     _selectLast(): boolean;
     _selectNextPage(): boolean;
     _selectPrevPage(): boolean;
     private _findNext;
-    private _getCheckbox;
     _initFromSelect(hostElement: HTMLElement): void;
     _setIsDisabled(value: boolean): void;
     _setTabOrder(value: number): void;
+    _isMenuItem(): boolean;
     _updateTabIndex(): void;
+    private _selectRange;
+    dispose(): void;
 }
 /**
  * Provides arguments for the {@link ListBox.formatItem} event.
@@ -1163,6 +1251,7 @@ export declare class MultiSelectListBox<T = any> extends Control {
     _lbx: ListBox;
     _cbSelectAll: HTMLInputElement;
     _spSelectAll: HTMLSpanElement;
+    _ariaLabel: string;
     _selectAllLabel: string;
     _filterPlaceholder: string;
     _filterText: string;
@@ -1313,6 +1402,11 @@ export declare class MultiSelectListBox<T = any> extends Control {
      * Gets or sets an array containing the items that are currently checked.
      */
     checkedItems: any[];
+    /**
+     * Gets or sets the aria-labelledby attribute of {@link MultiSelectListBox} input element.
+     */
+    ariaLabelledBy: string;
+    _updateAriaLabel(): void;
     /**
      * Occurs when the value of the {@link checkedItems} property changes.
      */
@@ -1422,6 +1516,15 @@ export interface IDateValidator {
      */
     (date: Date): boolean;
 }
+/**
+ * Specifies constants that define the action to be performed when the TAB key is pressed.
+ */
+export declare enum CalendarTabKeyAction {
+    /** No special action (let the browser handle the key). */
+    None = 0,
+    /** All buttons in the calendar can be selected using the tab key. */
+    All = 1
+}
 /**
  * The {@link Calendar} control displays a table with one or more months
  * and allows users to view and select dates.
@@ -1473,6 +1576,9 @@ export declare class Calendar extends Control {
     private _btnPrv;
     private _btnTdy;
     private _btnNxt;
+    private _confirmationButtonContainer;
+    private _btnOK;
+    private _btnCancel;
     private _lbYears;
     private _rptUp;
     private _rptDn;
@@ -1493,6 +1599,13 @@ export declare class Calendar extends Control {
     private _selMode;
     private _itemFormatter;
     private _itemValidator;
+    private _showYearListBoxButton;
+    private _focusMode;
+    private _focusValue;
+    private _keyActionTab;
+    private _ariaLabel;
+    private _showConfirmationButtons;
+    private _isSpaceDownForSetValue;
     private _tmYrHidden;
     private _syncing;
     private _cals;
@@ -1502,6 +1615,7 @@ export declare class Calendar extends Control {
     private _fmtDayHdr;
     private _fmtDay;
     private _fmtMonths;
+    private _fmtDayTitle;
     static _DATE_KEY: string;
     static _ctrlTemplate: string;
     /**
@@ -1541,6 +1655,7 @@ export declare class Calendar extends Control {
      * cal.value = start; // rangeEnd == null
      */
     value: Date;
+    focusValue: Date;
     /**
      * Gets or sets the last selected date in a range selection.
      *
@@ -1866,6 +1981,8 @@ export declare class Calendar extends Control {
     private _syncProp;
     private _updateContent;
     private _updateSelection;
+    private _updateFocusInAccessibilityMode;
+    private _updateCellFocus;
     private _addWeek;
     private _customizeCell;
     private _canChangeValue;
@@ -1885,6 +2002,44 @@ export declare class Calendar extends Control {
     _rngMode(): boolean;
     private _navigate;
     _setTabOrder(value: number): void;
+    private _showYearPickerAction;
+    /**
+     * Gets or sets the focusMode enabled to support wcag related functions  of {@link Calendar} element.
+     */
+    focusMode: boolean;
+    /**
+     * Gets or sets the action to perform when the Tab key is pressed.
+     *
+     * The default setting for this property is {@link CalendarTabKeyAction.None},
+     * This means that pressing the tab key will have no effect and follow the browser's default behavior.
+     */
+    keyActionTab: CalendarTabKeyAction;
+    private _isButtonFocused;
+    private _isSameMonth;
+    private _dateViewContainsFocus;
+    private _updateMonthButtonAria;
+    private _isDayValid;
+    readonly cancelButtonClicked: Event<Calendar, EventArgs>;
+    cancelButtonClick(e?: EventArgs): void;
+    oneCancelButtonClick(e: any): void;
+    readonly OKButtonClicked: Event<Calendar, EventArgs>;
+    OKButtonClick(e?: EventArgs): void;
+    onOkButtonClick(e: any): void;
+    /**
+     * Gets or sets the aria-label attribute of {@link Calendar} element.
+     */
+    ariaLabel: string;
+    private _updateButtonTabIndex;
+    readonly _enterKeyDownToSetValue: Event<Calendar, EventArgs>;
+    _onEnterKeyDownToSetValue(e?: EventArgs): void;
+    showConfirmationButtons: boolean;
+    protected _setIsDisabled(value: boolean): void;
+    private updateCalendarsTabindex;
+    private setFocusModeValue;
+    private _getCalendarsHostElements;
+    updateConfirmationButtons(hostElement: HTMLElement): void;
+    setFocusValueToFirstOrLastCalendar(isFirst: boolean): void;
+    isCalendarDateCell(element: HTMLElement): boolean;
 }
 /**
  * Specifies constants that define the action to perform when the
@@ -1898,6 +2053,24 @@ export declare enum ClickAction {
     /** Toggle the drop-down. */
     Toggle = 2
 }
+/**
+ * Defines the behavior when keys are pressed in the control.
+ */
+export declare enum KeyAction {
+    /** Changes the selection without opening the dropdown. */
+    ChangeSelectionOnly = 0,
+    /** Opens the dropdown without changing selection. */
+    OpenDropdown = 1
+}
+/**
+ * Defines the behavior when the TAB key is pressed in the control.
+ */
+export declare enum TabKeyAction {
+    /** Closes the dropdown while maintaining focus on the control */
+    CloseAndKeepFocus = 0,
+    /** Closes the dropdown and moves focus to the next tabbable element. */
+    CloseAndMoveFocus = 1
+}
 /**
  * DropDown control (abstract).
  *
@@ -1922,6 +2095,9 @@ export declare class DropDown extends Control {
     _minWidthDropdown: string;
     _escapeIE: boolean;
     _isInvalidInputCancelled: boolean;
+    _keyActionDownArrow: KeyAction;
+    _keyActionUpArrow: KeyAction;
+    _keyActionTab: TabKeyAction;
     static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link DropDown} controls.
@@ -2028,6 +2204,47 @@ export declare class DropDown extends Control {
      * The default value for this property is **false**.
      */
     isAnimated: boolean;
+    /**
+     * Gets or sets the action to perform when the DOWN ARROW key is pressed.
+     *
+     * The default setting for this property is {@link KeyAction.ChangeSelectionOnly},
+     * which causes the control to change the selection item while keeping the listbox closed.
+     *
+     * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox
+     * without changing the current selection.
+     */
+    keyActionDownArrow: KeyAction;
+    /**
+     * Gets or sets the action to perform when the UP ARROW key is pressed.
+     *
+     * The default setting for this property is {@link KeyAction.ChangeSelectionOnly},
+     * which causes the control to change the selection item while keeping the listbox closed.
+     *
+     * Alternatively, you can set this to {@link KeyAction.OpenDropdown} to open the listbox
+     * without changing the current selection.
+     */
+    keyActionUpArrow: KeyAction;
+    /**
+     * Gets or sets the action to perform when the TAB key is pressed.
+     *
+     * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus},
+     * which provides standard form navigation behavior by:
+     * - Closing the dropdown (if open)
+     * - Moving focus to the next focusable element
+     *
+     * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus}
+     * to maintain focus on the control after closing the dropdown.
+     *
+     * This setting is particularly useful for controlling accessibility behavior
+     * and keyboard navigation flow in form controls.
+     *
+     * Example:
+     * ```typescript
+     * // Change TAB key behavior
+     * dropDown.keyActionTab = TabKeyAction.CloseAndMoveFocus;
+     * ```
+     */
+    keyActionTab: TabKeyAction;
     /**
      * Sets the focus to the control and selects all its content.
      */
@@ -2066,15 +2283,26 @@ export declare class DropDown extends Control {
     protected _expandSelection(): void;
     protected _getCharType(text: string, pos: number): 0 | 1 | -1;
     protected _keydown(e: KeyboardEvent): void;
+    private toggleDropDown;
+    private handleUpArrowKey;
+    private handleDownArrowKey;
+    _afterOpenDropdownByDownArrow(): void;
+    private openDropDown;
+    private isHostVisible;
     protected _isHiddenEditor(): boolean;
     protected _keypress(e: KeyboardEvent): void;
     protected _input(e: Event): void;
     protected _btnclick(e: MouseEvent): void;
     protected _setText(text: string, fullMatch: boolean, forceRevertInvalid?: boolean, clearTbxVal?: boolean): void;
     protected _updateBtn(): void;
+    _updateBtnAria(): void;
+    protected _updateTbx(): void;
+    _updateTbxAria(): void;
+    _updateTbxAriaHaspopup(): void;
     protected _createDropDown(): void;
-    protected _commitText(noFocus?: boolean): void;
+    protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
     _updateDropDown(): void;
+    _shouldRaiseInvalidInput(shouldInvalid: boolean): boolean;
 }
 /**
  * Specifies actions that trigger showing and hiding {@link Popup} controls.
@@ -2202,8 +2430,10 @@ export declare class Popup extends Control {
     static _DRAG_THRESHOLD: number;
     static _SZ_EDGE: number;
     static _SZ_MIN: number;
+    static _PopupInstanceCount: number;
     static _evtHover: MouseEvent;
     protected _owner: HTMLElement;
+    protected _ariaLabel: string;
     protected _modal: boolean;
     protected _position: PopupPosition;
     protected _showTrigger: PopupTrigger;
@@ -2246,6 +2476,10 @@ export declare class Popup extends Control {
     protected _myFocus: HTMLElement;
     protected _lastShow: number;
     protected _initialOwner: HTMLElement;
+    protected _activeEdge: _Edges;
+    private _toHidePopupTimer;
+    private _toGetFocusTimer;
+    private _hideTimer;
     /**
      * Initializes a new instance of the {@link Popup} class.
      *
@@ -2253,6 +2487,10 @@ export declare class Popup extends Control {
      * @param options JavaScript object containing initialization data for the control.
      */
     constructor(element: any, options?: any);
+    /**
+     * Gets or sets the aria-labelledby attribute of {@link Popup} input element.
+     */
+    ariaLabelledBy: string;
     /**
      * Gets or sets the element that owns this {@link Popup}.
      *
@@ -2650,7 +2888,6 @@ export declare class Popup extends Control {
      */
     onPositionChanged(e?: EventArgs): void;
     onLostFocus(e?: EventArgs): void;
-    dispose(): void;
     refresh(fullUpdate?: boolean): void;
     _clearTimeouts(): void;
     protected _handleDragResize(on: boolean): void;
@@ -2669,6 +2906,9 @@ export declare class Popup extends Control {
     private _getClosestHeader;
     private _showBackdrop;
     protected _validateAndHide(result: any): void;
+    protected _updateAriaLabel(): void;
+    protected _updateAriaLabelImp(oldLabels: any): void;
+    dispose(): void;
 }
 /**
  * Provides arguments for the {@link Popup} control's {@link sizeChanging} and
@@ -2747,13 +2987,16 @@ export declare class InputDate extends DropDown {
     private _clsOnSel;
     private _handleWheel;
     private _preserveCalendarNavigation;
-    private _clicked;
+    private _isTriggered;
     private _rangeChanged;
     private _textInitialized;
     private _previousText;
     private _keepInvalidText;
+    private _showConfirmationButtons;
+    protected _inputAriaLabel: any;
     protected _currentInput: string;
     static _ctrlTemplate: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link InputDate} control.
      */
@@ -3149,15 +3392,27 @@ export declare class InputDate extends DropDown {
     private _tryFocus;
     _clamp(value: Date): Date;
     protected _getText(): string;
-    protected _commitText(noFocus?: boolean): void;
-    protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date): void;
-    protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs): void;
+    protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
+    protected _triggerInvalidInputEvent(cancelEvtArgs: InputDateEventArgs, val: Date, rangeEnd?: Date, shouldInvalid?: boolean): void;
+    protected _nullValueInvalidInput(cancelEvtArgs: InputDateEventArgs, shouldInvalid?: boolean): void;
     protected _fromDateTime(value: Date): Date;
     protected _canChangeValue(): boolean;
     protected _isValidDate(value: Date): boolean;
     private _getRanges;
     private _updateRangeSelection;
     protected _copy(key: string, value: any): boolean;
+    /**
+     * Gets or sets whether to display the confirmation buttons in Calendar.
+     * When this property is set to true, using the arrow keys will only change the focus.
+     * And "OK" and "Cancel" buttons will be displayed below the dropdown.
+     */
+    showConfirmationButtons: boolean;
+    /**
+     * Gets or sets the aria-labelledby attribute of input element.
+     */
+    ariaLabelledBy: string;
+    protected _updateInputAriaLabel(): void;
+    getAriaLabelForScreenReader(): any;
 }
 /**
  * The {@link InputDateRange} control extends the {@link InputDate}
@@ -3174,6 +3429,7 @@ export declare class InputDate extends DropDown {
  */
 export declare class InputDateRange extends InputDate {
     static _ctrlTemplate: string;
+    protected _inputAriaLabel: any;
     /**
      * Gets or sets the template used to instantiate {@link InputDateRange} control.
      */
@@ -3204,6 +3460,8 @@ export declare class InputColor extends DropDown {
     private _colorPicker;
     private _value;
     private _textInitialized;
+    _ariaLabelledby: string;
+    protected _inputAriaLabel: string;
     static _ctrlTemplate: string;
     /**
      * Gets or sets the template used to instantiate {@link InputColor} control.
@@ -3264,6 +3522,14 @@ export declare class InputColor extends DropDown {
      * Gets a reference to the {@link ColorPicker} control shown in the drop-down.
      */
     readonly colorPicker: ColorPicker;
+    /**
+     * Gets or sets the aria-labelledby attribute of input color element.
+     */
+    ariaLabelledBy: string;
+    /**
+     * Gets or sets the colorPicker's keyActionTab property.
+     */
+    colorPickerKeyActionTab: ColorPickerTabKeyAction;
     /**
      * Occurs when the value of the {@link value} property changes, either
      * as a result of user actions or by assignment in code.
@@ -3278,6 +3544,8 @@ export declare class InputColor extends DropDown {
     protected _keydown(e: KeyboardEvent): void;
     protected _commitText(): void;
     protected _copy(key: string, value: any): boolean;
+    getAriaLabelForScreenReader(): any;
+    protected _updateInputAriaLabel(): void;
 }
 /**
  * The {@link ComboBox} control allows users to pick strings from lists.
@@ -3332,6 +3600,9 @@ export declare class ComboBox<T = any> extends DropDown {
     _selItems: any;
     _oldFilter: any;
     static _ctrlTemplate: string;
+    _keyActionPrintCharacters: KeyAction;
+    _inputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link ComboBox} control.
      */
@@ -3521,6 +3792,23 @@ export declare class ComboBox<T = any> extends DropDown {
      * means the drop-down has no maximum width limit.
      */
     maxDropDownWidth: number;
+    /**
+     * Gets or sets the action to perform when printable character keys are pressed (letters, numbers, symbols).
+     *
+     * The default setting for this property is {@link KeyAction.OpenDropdown},
+     * which opens the listbox and filters options as the user types.
+     * This allows users to see matching options before making a selection.
+     *
+     * Alternatively, you can set this to {@link KeyAction.ChangeSelectionOnly}
+     * to immediately change the selection to match the typed characters while keeping the listbox closed.
+     * This is useful for quick selection in known-value scenarios.
+     */
+    keyActionPrintCharacters: KeyAction;
+    /**
+     * Gets or sets the aria-labelledby attribute of input element.
+     */
+    ariaLabelledBy: string;
+    _updateInputAndListBoxAriaLabel(): void;
     /**
      * Gets the string displayed in the input element for the item at a
      * given index (always plain text).
@@ -3529,6 +3817,8 @@ export declare class ComboBox<T = any> extends DropDown {
      * @param trimText Optionally override the value of the {@link trimText} property.
      */
     getDisplayText(index?: number, trimText?: boolean): string;
+    _getDisplayText(index?: number, trimText?: boolean, ignoreItemFormatter?: boolean): string;
+    _hasCustomFormatItem(): boolean;
     /**
      * Gets the index of the first item that matches a given string.
      *
@@ -3565,18 +3855,32 @@ export declare class ComboBox<T = any> extends DropDown {
     protected _setIsDisabled(value: boolean): void;
     protected _updateBtn(): void;
     protected _hasItems(): boolean;
-    private _updateAria;
+    _updateTbxAria(): void;
+    _updateInputAriaLabel(): void;
     protected _createDropDown(): void;
     protected _wheel(e: WheelEvent): void;
     protected _dropDownClick(e: MouseEvent): void;
     protected _setText(text: string, fullMatch: boolean, isDateTime?: boolean): void;
     protected _findNext(search: string, step: number, start?: number): number;
+    _findNextWhenIsEditableFalse(search: string, step: number, start?: number): number;
     protected _keydown(e: KeyboardEvent): void;
-    protected _input(e: Event): void;
+    _afterOpenDropdownByDownArrow(): void;
+    _input(e: Event): void;
+    _handleDragTextState(): void;
+    _handleComposingState(): void;
+    _shouldOpenDropdown(): boolean;
+    _handleIsEditableFalseInput(): void;
+    _updateSelection(index: number, editStart: number): void;
+    _updateComponentText(): void;
+    _updateEmptyValueFlag(): void;
+    _controlDropdownVisibility(): void;
+    _resetDragState(): void;
     protected _updateInputSelection(start: number): void;
     private _getSelStart;
     private _getSelEnd;
     private _setSelRange;
+    getAriaLabelForScreenReader(): any;
+    _updateDropDownWhenInput(): void;
 }
 /**
  * Represents a method that returns a string used as a header for a
@@ -3626,6 +3930,7 @@ export declare class MultiSelect extends ComboBox {
     private _msLbx;
     static _DEF_CHECKED_PATH: string;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
     /**
      * Gets or sets the template used to instantiate {@link MultiSelect} control.
      */
@@ -3752,12 +4057,15 @@ export declare class MultiSelect extends ComboBox {
     onIsDroppedDownChanged(e?: EventArgs): void;
     onLostFocus(): void;
     protected _createDropDown(): void;
+    _updateBtnAria(): void;
+    _updateTbxAria(): void;
     isReadOnly: boolean;
     refresh(fullUpdate?: boolean): void;
     protected _setText(text: string, fullMatch: boolean): void;
     protected _keydown(e: KeyboardEvent): void;
     protected _hasItems(): boolean;
     private _updateHeader;
+    getAriaLabelForScreenReader(): any;
 }
 /**
  * Interface implemented by command objects.
@@ -3830,7 +4138,9 @@ export declare class Menu extends ComboBox {
     _ariaLabel: string;
     _aFEnabledItem: boolean;
     static _evtHover: MouseEvent;
+    static _MenuInstanceCount: number;
     static _ctrlTemplate: string;
+    _parentMenu: Menu;
     /**
      * Gets or sets the template used to instantiate {@link Menu} control.
      */
@@ -3842,6 +4152,9 @@ export declare class Menu extends ComboBox {
      * @param options The JavaScript object containing initialization data for the control.
      */
     constructor(element: any, options?: any);
+    _updateBtnAria(): void;
+    _updateHdrAria(): void;
+    _updateLbxAria(): void;
     /**
      * Gets or sets the aria-label attribute of {@link Menu} element.
      *
@@ -4041,13 +4354,16 @@ export declare class Menu extends ComboBox {
     onItemClicked(e?: EventArgs): void;
     refresh(fullUpdate?: boolean): void;
     onIsDroppedDownChanged(e?: EventArgs): void;
+    private _restoreSelectedItem;
     _updateHoverEvents(): void;
     _getSubItems(item: any): any[];
     _formatMenuItem(s: ListBox, e: FormatItemEventArgs): void;
     protected _keydown(e: KeyboardEvent): void;
+    _afterOpenDropdownByDownArrow(): void;
     protected _dropDownClick(e: MouseEvent): void;
     private _showSubMenu;
     private _raiseCommand;
+    private _focusMenuOwner;
     private _getCommand;
     private _getCommandParm;
     private _executeCommand;
@@ -4060,6 +4376,7 @@ export declare class Menu extends ComboBox {
     private _hoverLeave;
     _setIsDisabled(value: boolean): void;
     _setTabOrder(value: number): void;
+    dispose(): void;
 }
 /**
  * The {@link InputTime} control allows users to enter times using any format
@@ -4091,6 +4408,7 @@ export declare class InputTime extends ComboBox {
     _msk: _MaskProvider;
     _hasCustomItems: boolean;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
     /**
      * Gets or sets the template used to instantiate {@link InputTime} control.
      */
@@ -4202,8 +4520,10 @@ export declare class InputTime extends ComboBox {
     protected _keydown(e: KeyboardEvent): void;
     protected _updateTimeValue(step: number, specialChars: any, actualFormat: string): void;
     private _reselectText;
-    protected _commitText(): void;
+    protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
     protected _copy(key: string, value: any): boolean;
+    getAriaLabelForScreenReader(): any;
+    _input(e: Event): void;
 }
 /**
  * The {@link InputDateTime} control extends the {@link InputDate} control to allows users
@@ -4231,6 +4551,7 @@ export declare class InputDateTime extends InputDate {
     private _ddDate;
     private _ddTime;
     static _ctrlTemplate: string;
+    protected _inputAriaLabel: any;
     /**
      * Gets or sets the template used to instantiate {@link InputDateTime} controls.
      */
@@ -4298,7 +4619,32 @@ export declare class InputDateTime extends InputDate {
     protected _mouseWheel(e: WheelEvent): void;
     protected _keydown(e: KeyboardEvent): void;
     protected _updateDateTimeValue(step: number, specialChars: any, actualFormat: string): void;
-    protected _commitText(): void;
+    protected _commitText(noFocus?: boolean, shouldInvalid?: boolean): void;
+    _updateTbxAria(): void;
+    /**
+     * Gets or sets the action to perform when the TAB key is pressed.
+     *
+     * The default setting for this property is {@link TabKeyAction.CloseAndMoveFocus},
+     * which provides standard form navigation behavior by:
+     * - Closing the dropdown (if open)
+     * - Moving focus to the next focusable element
+     *
+     * For specialized cases, you can set this to {@link TabKeyAction.CloseAndKeepFocus}
+     * to maintain focus on the control after closing the dropdown.
+     *
+     * This setting is particularly useful for controlling accessibility behavior
+     * and keyboard navigation flow in form controls.
+     *
+     * Example:
+     * ```typescript
+     * // Change TAB key behavior
+     * dropDown.keyActionTab = TabKeyAction.CloseAndMoveFocus;
+     * ```
+     */
+    keyActionTab: TabKeyAction;
+    private _setDropDownByEvent;
+    _updateBtnAria(): void;
+    private inputDateTimeIsDroppedDownChanged;
 }
 /**
  * Represents a method that returns data items asynchronously as the user types.
@@ -4354,6 +4700,7 @@ export declare class AutoComplete extends ComboBox {
     private _oldSelectedIndex;
     _pendingSearchFn: any;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
     /**
      * Gets or sets the template used to instantiate {@link AutoComplete} control.
      */
@@ -4459,7 +4806,9 @@ export declare class AutoComplete extends ComboBox {
     * Raises the {@link selectedIndexChanged} event.
     */
     onSelectedIndexChanged(e?: EventArgs): void;
+    _updateTbxAria(): void;
     _keydown(e: KeyboardEvent): void;
+    _input(e: Event): void;
     private _isBlurInput;
     protected _commitText(noFocus?: boolean): void;
     _setText(text: string | null): void;
@@ -4474,6 +4823,8 @@ export declare class AutoComplete extends ComboBox {
     protected _formatListItem(sender: any, e: FormatItemEventArgs): void;
     private _enclosed;
     protected _wheel(e: WheelEvent): void;
+    getAriaLabelForScreenReader(): any;
+    _hasCustomFormatItem(): boolean;
 }
 /**
  * The {@link MultiAutoComplete} control allows users to pick items from lists
@@ -4488,12 +4839,16 @@ export declare class MultiAutoComplete extends AutoComplete {
     private _wjTpl;
     private _wjInput;
     private _helperInput;
+    private _screenReaderHelper;
     private _maxSelItems;
     private _lastInputValue;
     private _selPath;
     private _notAddItm;
     static _clsActive: string;
     static _ctrlTemplate: string;
+    _inputElementAriaLabel: string;
+    _helperInputElementAriaLabel: string;
+    _ariaLabelledby: string;
     /**
      * Gets or sets the template used to instantiate {@link MultiAutoComplete} control.
      */
@@ -4526,6 +4881,10 @@ export declare class MultiAutoComplete extends AutoComplete {
      * selected.
      */
     selectedItems: any[];
+    /**
+     * Gets or sets the aria-labelledby attribute of input element.
+     */
+    ariaLabelledBy: string;
     /**
      * Occurs when the value of the {@link selectedItems} property changes.
      */
@@ -4540,6 +4899,7 @@ export declare class MultiAutoComplete extends AutoComplete {
     protected _updateState(): void;
     protected _keyup(e: KeyboardEvent): void;
     private _addHelperInput;
+    private _addScreenReaderHelper;
     private _refreshHeader;
     private _insertToken;
     private _updateMaxItems;