@progress/kendo-react-dropdowns 7.2.4-develop.3 → 7.3.0-develop.1

package/MultiSelect/MultiSelect.d.ts

@@ -1,262 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import PropTypes from 'prop-types';
-import { FormComponent, FormComponentValidity } from '@progress/kendo-react-common';
-import { TagData } from './TagList';
-import DropDownBase from '../common/DropDownBase';
-import { MultiSelectProps } from './MultiSelectProps';
-import { DropDownStateBase, InternalState, ActiveDescendant } from './../common/settings';
-/** @hidden */
-export interface MultiSelectState extends DropDownStateBase {
-    selectedItems?: Array<any>;
-    focusedIndex?: number;
-    focusedTag?: TagData;
-    activedescendant?: ActiveDescendant;
-    value?: Array<any>;
-    currentValue?: Array<any>;
-    windowWidth?: number;
-}
-/** @hidden */
-export interface MultiSelectInternalState extends InternalState {
-    data: MultiSelectState;
-}
-/** @hidden */
-export declare class MultiSelectWithoutContext extends React.Component<MultiSelectProps, MultiSelectState> implements FormComponent {
-    static displayName: string;
-    /** @hidden */
-    static propTypes: {
-        autoClose: PropTypes.Requireable<boolean>;
-        value: PropTypes.Requireable<any[]>;
-        defaultValue: PropTypes.Requireable<any[]>;
-        dataItemKey: PropTypes.Requireable<string>;
-        placeholder: PropTypes.Requireable<string>;
-        tags: PropTypes.Requireable<(PropTypes.InferProps<{
-            text: PropTypes.Requireable<string>;
-            data: PropTypes.Requireable<any[]>;
-        }> | null | undefined)[]>;
-        tagRender: PropTypes.Requireable<(...args: any[]) => any>;
-        id: PropTypes.Requireable<string>;
-        ariaLabelledBy: PropTypes.Requireable<string>;
-        ariaDescribedBy: PropTypes.Requireable<string>;
-        groupField: PropTypes.Requireable<string>;
-        list: PropTypes.Requireable<any>;
-        adaptive: PropTypes.Requireable<boolean>;
-        adaptiveTitle: PropTypes.Requireable<string>;
-        onCancel: PropTypes.Requireable<(...args: any[]) => any>;
-        skipDisabledItems: PropTypes.Requireable<boolean>;
-        filterable: PropTypes.Requireable<boolean>;
-        filter: PropTypes.Requireable<string>;
-        virtual: PropTypes.Requireable<PropTypes.InferProps<{
-            pageSize: PropTypes.Validator<number>;
-            skip: PropTypes.Validator<number>;
-            total: PropTypes.Validator<number>;
-        }>>;
-        onFilterChange: PropTypes.Requireable<(...args: any[]) => any>;
-        onPageChange: PropTypes.Requireable<(...args: any[]) => any>;
-        opened: PropTypes.Requireable<boolean>;
-        disabled: PropTypes.Requireable<boolean>;
-        dir: PropTypes.Requireable<string>;
-        tabIndex: PropTypes.Requireable<number>;
-        accessKey: PropTypes.Requireable<string>;
-        data: PropTypes.Requireable<any[]>;
-        textField: PropTypes.Requireable<string>;
-        className: PropTypes.Requireable<string>;
-        label: PropTypes.Requireable<string>;
-        loading: PropTypes.Requireable<boolean>;
-        popupSettings: PropTypes.Requireable<PropTypes.InferProps<{
-            animate: PropTypes.Requireable<NonNullable<boolean | PropTypes.InferProps<{
-                openDuration: PropTypes.Requireable<number>;
-                closeDuration: PropTypes.Requireable<number>;
-            }> | null | undefined>>;
-            popupClass: PropTypes.Requireable<string>;
-            className: PropTypes.Requireable<string>;
-            appendTo: PropTypes.Requireable<any>;
-            width: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
-            height: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
-        }>>;
-        onOpen: PropTypes.Requireable<(...args: any[]) => any>;
-        onClose: PropTypes.Requireable<(...args: any[]) => any>;
-        onFocus: PropTypes.Requireable<(...args: any[]) => any>;
-        onBlur: PropTypes.Requireable<(...args: any[]) => any>;
-        onChange: PropTypes.Requireable<(...args: any[]) => any>;
-        itemRender: PropTypes.Requireable<(...args: any[]) => any>;
-        listNoDataRender: PropTypes.Requireable<(...args: any[]) => any>;
-        focusedItemIndex: PropTypes.Requireable<(...args: any[]) => any>;
-        header: PropTypes.Requireable<PropTypes.ReactNodeLike>;
-        footer: PropTypes.Requireable<PropTypes.ReactNodeLike>;
-    };
-    /** @hidden */
-    static defaultProps: {
-        autoClose: boolean;
-        required: boolean;
-        size: "small" | "medium" | "large" | null | undefined;
-        rounded: "small" | "medium" | "large" | "full" | null | undefined;
-        fillMode: "solid" | "flat" | "outline" | null | undefined;
-        groupMode: string | undefined;
-        skipDisabledItems: boolean;
-        prefix: undefined;
-        suffix: undefined;
-        popupSettings: {
-            height: string;
-        };
-        validityStyles: boolean;
-    };
-    /** @hidden */
-    readonly state: MultiSelectState;
-    private _element;
-    private _valueItemsDuringOnChange;
-    private get _inputId();
-    protected readonly base: DropDownBase;
-    private readonly _tags;
-    private _input;
-    private _adaptiveInput;
-    private _skipFocusEvent;
-    private _lastSelectedOrDeslectedItemIndex;
-    private itemHeight;
-    protected scrollToFocused: boolean;
-    private localization;
-    private observerResize?;
-    private get document();
-    constructor(props: MultiSelectProps);
-    /** @hidden */
-    focus: () => void;
-    /** @hidden */
-    get element(): HTMLSpanElement | null;
-    /** @hidden */
-    get opened(): boolean;
-    /** @hidden */
-    get tagsToRender(): Array<TagData>;
-    /**
-     * The mobile mode of the ComboBox.
-     */
-    get mobileMode(): boolean;
-    /**
-     * Represents the value of the MultiSelect.
-     */
-    get value(): Array<any>;
-    /**
-     * Gets the `name` property of the MultiSelect.
-     */
-    get name(): string | undefined;
-    /**
-     * Represents the validity state into which the MultiSelect is set.
-     */
-    get validity(): FormComponentValidity;
-    /** @hidden */
-    protected get required(): boolean;
-    protected get validityStyles(): boolean;
-    /** @hidden */
-    componentDidUpdate(prevProps: MultiSelectProps, prevState: MultiSelectState): void;
-    /** @hidden */
-    componentDidMount(): void;
-    /** @hidden */
-    componentWillUnmount(): void;
-    /** @hidden */
-    handleItemSelect: (index: number, state: MultiSelectInternalState) => void;
-    /** @hidden */
-    onTagDelete: (itemsToRemove: Array<any>, event: React.MouseEvent<HTMLSpanElement>) => void;
-    /** @hidden */
-    onNavigate(state: MultiSelectInternalState, keyCode: number, skipItems?: number): void;
-    /** @hidden */
-    itemFocus: (index: number, state: MultiSelectInternalState) => void;
-    /** @hidden */
-    render(): import("react/jsx-runtime").JSX.Element;
-    private componentRef;
-    private renderSearchBar;
-    private searchbarRef;
-    private onChangeHandler;
-    private clearButtonClick;
-    private onInputKeyDown;
-    private onTagsNavigate;
-    private triggerOnChange;
-    private selectFocusedItem;
-    private setItems;
-    private getFocusedState;
-    private listContainerContent;
-    private renderListContainer;
-    private renderAdaptiveListContainer;
-    private closePopup;
-    private onCancel;
-    private renderList;
-    private onScroll;
-    private customItemSelect;
-    private handleWrapperClick;
-    private handleItemClick;
-    private handleBlur;
-    private handleFocus;
-    private onPopupOpened;
-    private onPopupClosed;
-    private focusElement;
-    private applyState;
-    private setValidity;
-    private calculateMedia;
-    /**
-     * Updates the state of the MultiSelect when the complex keyboard navigation that
-     * includes key combinations with the Ctrl/Command, Shift, Home and End keys
-     *
-     * @param {Array<string | Object>} dataToSet Defines the array of new values that will be applied to the MultiSelect
-     * @param {MultiSelectInternalState} state The current state of the MultiSelect
-     */
-    private updateStateOnKeyboardNavigation;
-    /**
-     * Returns the last element that was selected or deselected. Needed for the keyboard navigation specifications
-     *
-     * @param {number} correction A correction is needed depending on if UP or DOWN key is pressed
-     */
-    private getLastSelectedOrDeselectedIndex;
-}
-/**
- * Represents the PropsContext of the `MultiSelect` component.
- * Used for global configuration of all `MultiSelect` instances.
- *
- * For more information, refer to the [Dropdowns Props Context]({% slug props-context_dropdowns %}) article.
- */
-export declare const MultiSelectPropsContext: React.Context<(p: MultiSelectProps) => MultiSelectProps>;
-/**
- * Represent the `ref` of the MultiSelect component.
- */
-export interface MultiSelectHandle extends Pick<MultiSelectWithoutContext, keyof MultiSelectWithoutContext> {
-    /**
-     * Gets the `name` property of the MultiSelect.
-     */
-    name: string | undefined;
-    /**
-     * Represents the validity state into which the MultiSelect is set.
-     */
-    validity: FormComponentValidity;
-    /**
-     * Represents the value of the MultiSelect.
-     */
-    value: Array<any>;
-}
-/** @hidden */
-export type MultiSelect = MultiSelectHandle;
-/**
- * Represents the [KendoReact MultiSelect component]({% slug overview_multiselect %}).
- *
- * Accepts properties of type [MultiSelectProps]({% slug api_dropdowns_multiselectprops %}).
- * Obtaining the `ref` returns an object of type [MultiSelectHandle]({% slug api_dropdowns_multiselecthandle %}).
- *
- * @example
- * ```jsx
- * class App extends React.Component {
- *    multiselect = null;
- *    render() {
- *       return (
- *          <div>
- *              <MultiSelect
- *                  data={[ "Albania", "Andorra", "Austria", "Belarus" ]}
- *                  ref={component => this.multiselect = component}
- *              />
- *              <button onClick={() => alert(this.multiselect.value)}>alert value</button>
- *          </div>
- *       );
- *    }
- * }
- * ReactDOM.render(<App />, document.querySelector('my-app'));
- * ```
- */
-export declare const MultiSelect: React.ForwardRefExoticComponent<MultiSelectProps & React.RefAttributes<any>>;

package/MultiSelect/MultiSelectProps.d.ts

@@ -1,325 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { MultiSelect } from './MultiSelect';
-import { CustomComponent, FormComponentProps } from '@progress/kendo-react-common';
-import { FilterChangeEvent, ChangeEvent, OpenEvent, CloseEvent, FocusEvent, BlurEvent, PageChangeEvent, CancelEvent } from './../common/events';
-import { VirtualizationSettings, DropDownsPopupSettings } from '../common/settings';
-import { ListGroupItemProps } from '../common/ListGroupItem';
-import { GroupStickyHeaderProps } from '../common/GroupStickyHeader';
-import { ListItemProps } from '../common/ListItem';
-import { TagData } from './TagList';
-/**
- * Represents the object of the `filterChange` MultiSelect event.
- */
-export interface MultiSelectFilterChangeEvent extends FilterChangeEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `change` MultiSelect event.
- */
-export interface MultiSelectChangeEvent extends ChangeEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `onCancel` MultiSelect event.
- */
-export interface MultiSelectCancelEvent extends CancelEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `open` MultiSelect event.
- */
-export interface MultiSelectOpenEvent extends OpenEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `close` MultiSelect event.
- */
-export interface MultiSelectCloseEvent extends CloseEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `focus` MultiSelect event.
- */
-export interface MultiSelectFocusEvent extends FocusEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `blur` MultiSelect event.
- */
-export interface MultiSelectBlurEvent extends BlurEvent<MultiSelect> {
-}
-/**
- * Represents the object of the `pageChange` MultiSelect event.
- */
-export interface MultiSelectPageChangeEvent extends PageChangeEvent<MultiSelect> {
-}
-/**
- * Represents the props of the [KendoReact MultiSelect component]({% slug overview_multiselect %}).
- */
-export interface MultiSelectProps extends FormComponentProps {
-    /**
-     * Specifies whether the MultiSelect allows user-defined values that are not present in the dataset ([see example]({% slug custom_values_multiselect %})). Defaults to `false`.
-     */
-    allowCustom?: boolean;
-    /**
-     * Sets the data of the MultiSelect ([see example]({% slug binding_multiselect %})).
-     */
-    data?: any[];
-    /**
-     * Sets the opened and closed state of the MultiSelect.
-     */
-    opened?: boolean;
-    /**
-     * Determines whether to close the options list of the MultiSelect after the item selection is finished.
-     *
-     * @example
-     * ```jsx
-     * class App extends React.Component {
-     *    render() {
-     *       return (
-     *              <MultiSelect
-     *                  data={[ "Albania", "Andorra", "Austria", "Belarus" ]}
-     *                  autoClose={false}
-     *              />
-     *       );
-     *    }
-     * }
-     * ReactDOM.render(<App />, document.querySelector('my-app'));
-     * ```
-     *
-     * @default true
-     */
-    autoClose?: boolean;
-    /**
-     * The styles that are applied to the MultiSelect.
-     */
-    style?: React.CSSProperties;
-    /**
-     * Sets the value of the MultiSelect ([see example]({% slug binding_multiselect %})). It can either be of the primitive (string, numbers) or of the complex (objects) type.
-     */
-    value?: Array<any>;
-    /**
-     * The hint that is displayed when the MultiSelect is empty.
-     */
-    placeholder?: string;
-    /**
-     * Sets the tags of the MultiSelect ([see example]({% slug customtags_multiselect %})).
-     */
-    tags?: Array<TagData>;
-    /**
-     * Sets the key for comparing the data items of the MultiSelect ([see example]({% slug binding_multiselect %}#toc-datasets-of-objects)). If `dataItemKey` is not set, the MultiSelect compares the items by reference.
-     */
-    dataItemKey?: string;
-    /**
-     * Sets the default value of the MultiSelect. Similar to the native `select` HTML element.
-     */
-    defaultValue?: Array<any>;
-    /**
-     * Sets additional classes to the MultiSelect.
-     */
-    className?: string;
-    /**
-     * Sets the disabled state of the MultiSelect.
-     */
-    disabled?: boolean;
-    /**
-     * Represents the `dir` HTML attribute.
-     */
-    dir?: string;
-    /**
-     * Enables the filtering functionality of the MultiSelect ([more information and examples]({% slug filtering_multiselect %})).
-     */
-    filterable?: boolean;
-    /**
-     * Specifies the id of the component.
-     */
-    id?: string;
-    /**
-     * Identifies the element(s) which will describe the component, similar to [HTML aria-describedby attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute).
-     * For example these elements could contain error or hint message.
-     */
-    ariaDescribedBy?: string;
-    /**
-     * Identifies the element(s) which will label the component.
-     */
-    ariaLabelledBy?: string;
-    /**
-     * If set, the MultiSelect will use it to get the focused item index.
-     *
-     * Default functionality returns the first item which starts with the input text.
-     *
-     * @example
-     * ```jsx-no-run
-     * const focusedItemIndex = (data, inputText, textField) => {
-     *     let text = inputText.toLowerCase();
-     *     return data.findIndex(item =>
-     *         String(textField ? item[textField] : item).toLowerCase().includes(text));
-     * };
-     *
-     * <MultiSelect focusedItemIndex={focusedItemIndex} />
-     * ```
-     */
-    focusedItemIndex?: (data: any, inputText: string, textField?: string) => number;
-    /**
-     * Sets the value of filtering input. Useful for making the filtering input a [controlled component](https://reactjs.org/docs/forms.html#controlled-components).
-     */
-    filter?: string;
-    /**
-     * Sets the value of the adaptive filtering input of the of MultiSelect.
-     */
-    adaptiveFilter?: string;
-    /**
-     * Sets the loading state of the MultiSelect ([see example]({% slug filtering_multiselect %}#toc-basic-configuration)).
-     */
-    loading?: boolean;
-    /**
-     * Specifies the `tabIndex` of the MultiSelect.
-     */
-    tabIndex?: number;
-    /**
-     * Specifies the `accessKey` of the MultiSelect.
-     */
-    accessKey?: string;
-    /**
-     * Sets the data item field that represents the item text ([see example]({% slug binding_multiselect %}#toc-datasets-of-objects)). If the data contains only primitive values, do not define it.
-     */
-    textField?: string;
-    /**
-     * Renders a floating label for the MultiSelect.
-     */
-    label?: string;
-    /**
-     * Configures the popup of the MultiSelect.
-     */
-    popupSettings?: DropDownsPopupSettings;
-    /**
-     * Configures the virtual scrolling of the MultiSelect ([see example]({% slug virtualization_multiselect %})).
-     */
-    virtual?: VirtualizationSettings;
-    /**
-     * Fires each time the popup of the MultiSelect is about to open.
-     */
-    onOpen?: (event: MultiSelectOpenEvent) => void;
-    /**
-     * Fires each time the popup of the MultiSelect is about to close.
-     */
-    onClose?: (event: MultiSelectCloseEvent) => void;
-    /**
-     * Fires each time the user focuses the MultiSelect.
-     */
-    onFocus?: (event: MultiSelectFocusEvent) => void;
-    /**
-     * Fires each time the MultiSelect gets blurred.
-     */
-    onBlur?: (event: MultiSelectBlurEvent) => void;
-    /**
-     * Fires each time the value of the MultiSelect is about to change ([see examples]({% slug binding_multiselect %})).
-     */
-    onChange?: (event: MultiSelectChangeEvent) => void;
-    /**
-     * Fires each time the popup of the MultiSelect is about to cancel in ([adaptive mode]({% slug adaptive_rendering_multiselect %})).
-     */
-    onCancel?: (event: MultiSelectCancelEvent) => void;
-    /**
-     * Fires each time the user types in the filter input ([see example]({% slug filtering_multiselect %}#toc-basic-configuration)). You can filter the source based on the passed filtration value.
-     */
-    onFilterChange?: (event: MultiSelectFilterChangeEvent) => void;
-    /**
-     * Fires when both the virtual scrolling of the MultiSelect is enabled and when the component requires data for another page ([see example]({% slug virtualization_multiselect %})).
-     */
-    onPageChange?: (event: MultiSelectPageChangeEvent) => void;
-    /**
-     * Fires when a MultiSelect item is about to be rendered ([see example]({% slug customrendering_multiselect %}#toc-items)). Used to override the default appearance of the list items.
-     */
-    itemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListItemProps) => React.ReactNode;
-    /**
-     * Fires when the element which indicates no data in the popup is about to be rendered ([see example]({% slug customrendering_multiselect %}#toc-no-data)). Used to override the default appearance of the element.
-     */
-    listNoDataRender?: (element: React.ReactElement<HTMLDivElement>) => React.ReactNode;
-    /**
-     * Fires when a tag element is about to be rendered ([see example]({% slug customrendering_multiselect %}#toc-tags)). Used to override the default appearance of the element.
-     */
-    tagRender?: (tagData: TagData, tag: React.ReactElement) => React.ReactElement;
-    /**
-     * Sets the header component of the MultiSelect ([see example]({% slug customrendering_multiselect %}#toc-headers-and-footers)).
-     */
-    header?: React.ReactNode;
-    /**
-     * Sets the footer component of the MultiSelect ([see example]({% slug customrendering_multiselect %}#toc-headers-and-footers)).
-     */
-    footer?: React.ReactNode;
-    /**
-     * Configures the `size` of the MultiSelect.
-     *
-     * The available options are:
-     * - small
-     * - medium
-     * - large
-     * - null&mdash;Does not set a size `className`.
-     *
-     * @default `medium`
-     */
-    size?: null | 'small' | 'medium' | 'large';
-    /**
-     * Configures the `roundness` of the MultiSelect.
-     *
-     * The available options are:
-     * - small
-     * - medium
-     * - large
-     * - full
-     * - null&mdash;Does not set a rounded `className`.
-     *
-     * @default `medium`
-     */
-    rounded?: null | 'small' | 'medium' | 'large' | 'full';
-    /**
-     * Configures the `fillMode` of the MultiSelect.
-     *
-     * The available options are:
-     * - solid
-     * - flat
-     * - outline
-     * - null&mdash;Does not set a fillMode `className`.
-     *
-     * @default `solid`
-     */
-    fillMode?: null | 'solid' | 'flat' | 'outline';
-    /**
-     * Sets the data item field that represents the start of a group. Applicable to objects data.
-     */
-    groupField?: string;
-    /**
-     * Fires when a DropDownList's group header item is about to be rendered. Used to override the default appearance of the group's headers.
-     */
-    groupHeaderItemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListGroupItemProps) => React.ReactNode;
-    /**
-     * Fires when a DropDownList's sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
-     */
-    groupStickyHeaderItemRender?: (div: React.ReactElement<HTMLDivElement>, stickyHeaderProps: GroupStickyHeaderProps) => React.ReactNode;
-    /**
-     * @hidden
-     */
-    list?: any;
-    /**
-     * @hidden
-     */
-    groupMode?: string;
-    /**
-     * Providing different rendering of the popup element based on the screen dimensions.
-     */
-    adaptive?: boolean;
-    /**
-     * Specifies the text that is rendered as title in the adaptive popup.
-     */
-    adaptiveTitle?: string;
-    /**
-     * Defines if MultiSelect's disabled items will be skipped or focused when navigating through the list of items using a keyboard. Defaults to `true`.
-     */
-    skipDisabledItems?: boolean;
-    /**
-     * Sets a custom prefix to the MultiSelect component.
-     */
-    prefix?: CustomComponent<any>;
-    /**
-     * Sets a custom suffix to the MultiSelect component.
-     */
-    suffix?: CustomComponent<any>;
-}

package/MultiSelect/TagList.d.ts

@@ -1,42 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-/**
- * Represents the tag data.
- */
-export interface TagData {
-    /**
-     * Represents the text of the tag.
-     */
-    text: string;
-    /**
-     * Represents the data items which correspond to the tag.
-     */
-    data: Array<any>;
-}
-/**
- * @hidden
- */
-export interface TagListProps {
-    children?: React.ReactNode;
-    data: Array<TagData>;
-    guid: string;
-    focused?: TagData;
-    onTagDelete: (items: Array<any>, event: React.MouseEvent<HTMLSpanElement>) => void;
-    tagRender?: (tagData: TagData, tag: React.ReactElement) => React.ReactElement;
-    tag?: React.ComponentType<{
-        tagData: TagData;
-        guid: string;
-        focusedTag?: TagData;
-        onTagDelete: (items: Array<any>, event: React.MouseEvent<HTMLSpanElement>) => void;
-    }>;
-    size?: null | 'small' | 'medium' | 'large';
-}
-/**
- * @hidden
- */
-export default class TagList extends React.Component<TagListProps, {}> {
-    render(): import("react/jsx-runtime").JSX.Element;
-}