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

package/DropDownList/DropDownList.d.ts

@@ -1,264 +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 DropDownBase from '../common/DropDownBase';
-import { DropDownListProps } from './DropDownListProps';
-import { DropDownStateBase, InternalState } from './../common/settings';
-/**
- * @hidden
- */
-export interface DropDownListState extends DropDownStateBase {
-    windowWidth?: number;
-}
-/**
- * @hidden
- */
-export declare class DropDownListWithoutContext extends React.Component<DropDownListProps, DropDownListState> implements FormComponent {
-    static displayName: string;
-    /**
-     * @hidden
-     */
-    static propTypes: {
-        value: PropTypes.Requireable<any>;
-        defaultValue: PropTypes.Requireable<any>;
-        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>;
-        delay: PropTypes.Requireable<number>;
-        ignoreCase: PropTypes.Requireable<boolean>;
-        iconClassName: PropTypes.Requireable<string>;
-        svgIcon: PropTypes.Requireable<PropTypes.InferProps<{
-            name: PropTypes.Validator<string>;
-            content: PropTypes.Validator<string>;
-            viewBox: PropTypes.Validator<string>;
-        }>>;
-        defaultItem: PropTypes.Requireable<any>;
-        valueRender: PropTypes.Requireable<(...args: any[]) => any>;
-        valueMap: PropTypes.Requireable<(...args: any[]) => any>;
-        validationMessage: PropTypes.Requireable<string>;
-        required: PropTypes.Requireable<boolean>;
-        id: PropTypes.Requireable<string>;
-        ariaLabelledBy: PropTypes.Requireable<string>;
-        ariaDescribedBy: PropTypes.Requireable<string>;
-        ariaLabel: PropTypes.Requireable<string>;
-        leftRightKeysNavigation: PropTypes.Requireable<boolean>;
-        title: PropTypes.Requireable<string>;
-        groupField: PropTypes.Requireable<string>;
-        list: PropTypes.Requireable<any>;
-        skipDisabledItems: PropTypes.Requireable<boolean>;
-    };
-    /**
-     * @hidden
-     */
-    static defaultProps: {
-        required: boolean;
-        size: "small" | "medium" | "large" | null | undefined;
-        rounded: "small" | "medium" | "large" | "full" | null | undefined;
-        fillMode: "solid" | "flat" | "outline" | null | undefined;
-        groupMode: string | undefined;
-        popupSettings: {
-            height: string;
-        };
-        validityStyles: boolean;
-        delay: number;
-        tabIndex: number;
-        ignoreCase: boolean;
-    };
-    /**
-     * @hidden
-     */
-    readonly state: DropDownListState;
-    private _element;
-    private _typingTimeout;
-    protected readonly base: DropDownBase;
-    private searchState;
-    private _select;
-    private _skipFocusEvent;
-    private _filterInput;
-    private _valueDuringOnChange;
-    private _navigated;
-    private _lastKeypressIsFilter;
-    private get _inputId();
-    private get _listboxId();
-    private get _guid();
-    private itemHeight;
-    private observerResize?;
-    private get document();
-    constructor(props: DropDownListProps);
-    /**
-     * @hidden
-     */
-    focus: () => void;
-    /**
-     * @hidden
-     */
-    get element(): HTMLSpanElement | null;
-    /**
-     * The value of the DropDownList.
-     */
-    get value(): any;
-    /**
-     * The index of the selected item.
-     */
-    get index(): number;
-    /**
-     * Gets the `name` property of the DropDownList.
-     */
-    get name(): string | undefined;
-    /**
-     * Represents the validity state into which the DropDownList is set.
-     */
-    get validity(): FormComponentValidity;
-    protected get validityStyles(): boolean;
-    /**
-     * @hidden
-     */
-    protected get required(): boolean;
-    /**
-     * @hidden
-     */
-    componentDidUpdate(prevProps: DropDownListProps, prevState: DropDownListState): void;
-    /**
-     * @hidden
-     */
-    componentDidMount(): void;
-    /** @hidden */
-    componentWillUnmount(): void;
-    /**
-     * @hidden
-     */
-    render(): import("react/jsx-runtime").JSX.Element;
-    /**
-     * @hidden
-     */
-    handleItemSelect: (index: number, state: InternalState) => void;
-    /**
-     * @hidden
-     */
-    onNavigate(state: InternalState, keyCode: number, skipItems?: number): void;
-    private componentRef;
-    private dummySelect;
-    private renderAdaptiveListContainer;
-    private renderListContainer;
-    private renderList;
-    private onScroll;
-    private renderListFilter;
-    private renderDefaultItem;
-    private search;
-    private selectNext;
-    private handleKeyDown;
-    private handleItemClick;
-    private handleFocus;
-    private handleBlur;
-    private handleDefaultItemClick;
-    private handleWrapperClick;
-    private handleKeyPress;
-    private handleListFilterChange;
-    private onPopupOpened;
-    private onPopupClosed;
-    private getFocusedIndex;
-    private focusElement;
-    private setValidity;
-    private triggerOnChange;
-    private applyState;
-    private calculateMedia;
-    private resetValueIfDisabledItem;
-    private haveFocusedItemAndDataNotEmpty;
-}
-/**
- * Represents the PropsContext of the `DropDownList` component.
- * Used for global configuration of all `DropDownList` instances.
- *
- * For more information, refer to the [Dropdowns Props Context]({% slug props-context_dropdowns %}) article.
- */
-export declare const DropDownListPropsContext: React.Context<(p: DropDownListProps) => DropDownListProps>;
-/**
- * Represent the `ref` of the DropDownList component.
- */
-export interface DropDownListHandle extends Pick<DropDownListWithoutContext, keyof DropDownListWithoutContext> {
-    /**
-     * The index of the selected item.
-     */
-    index: number;
-    /**
-     * Gets the `name` property of the DropDownList.
-     */
-    name: string | undefined;
-    /**
-     * Represents the validity state into which the DropDownList is set.
-     */
-    validity: FormComponentValidity;
-    /**
-     * The value of the DropDownList.
-     */
-    value: any;
-}
-/** @hidden */
-export type DropDownList = DropDownListHandle;
-/**
- * Represents the [KendoReact DropDownList component]({% slug overview_dropdownlist %}).
- *
- * Accepts properties of type [DropDownListProps]({% slug api_dropdowns_dropdownlistprops %}).
- * Obtaining the `ref` returns an object of type [DropDownListHandle]({% slug api_dropdowns_dropdownlisthandle %}).
- *
- * @example
- * ```jsx
- * class App extends React.Component {
- *    dropdownlist = null;
- *    render() {
- *       return (
- *          <div>
- *              <DropDownList
- *                  data={[ "Albania", "Andorra", "Austria", "Belarus" ]}
- *                  ref={component => this.dropdownlist = component}
- *              />
- *              <button onClick={() => alert(this.dropdownlist.value)}>alert value</button>
- *          </div>
- *       );
- *    }
- * }
- * ReactDOM.render(<App />, document.querySelector('my-app'));
- * ```
- */
-export declare const DropDownList: React.ForwardRefExoticComponent<DropDownListProps & React.RefAttributes<any>>;

package/DropDownList/DropDownListProps.d.ts

@@ -1,329 +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 { DropDownList } from './DropDownList';
-import { FilterChangeEvent, ChangeEvent, OpenEvent, CloseEvent, FocusEvent, BlurEvent, PageChangeEvent } 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 { FormComponentProps, SVGIcon } from '@progress/kendo-react-common';
-/**
- * Represents the object of the `filterChange` DropDownList event.
- */
-export interface DropDownListFilterChangeEvent extends FilterChangeEvent<DropDownList> {
-}
-/**
- * Represents the object of the `change` DropDownList event.
- */
-export interface DropDownListChangeEvent extends ChangeEvent<DropDownList> {
-}
-/**
- * Represents the object of the `open` DropDownList event.
- */
-export interface DropDownListOpenEvent extends OpenEvent<DropDownList> {
-}
-/**
- * Represents the object of the `close` DropDownList event.
- */
-export interface DropDownListCloseEvent extends CloseEvent<DropDownList> {
-}
-/**
- * Represents the object of the `focus` DropDownList event.
- */
-export interface DropDownListFocusEvent extends FocusEvent<DropDownList> {
-}
-/**
- * Represents the object of the `blur` DropDownList event.
- */
-export interface DropDownListBlurEvent extends BlurEvent<DropDownList> {
-}
-/**
- * Represents the object of the `pageChange` DropDownList event.
- */
-export interface DropDownListPageChangeEvent extends PageChangeEvent<DropDownList> {
-}
-/**
- * Represents the props of the [KendoReact DropDownList component]({% slug overview_dropdownlist %}).
- */
-export interface DropDownListProps extends FormComponentProps {
-    /**
-     * Sets the data of the DropDownList ([see example]({% slug binding_dropdownlist %})).
-     */
-    data?: any[];
-    /**
-     * Sets the text of the default empty item. The type of the defined value has to match the data type.
-     */
-    defaultItem?: any;
-    /**
-     * Sets the delay before an item search is performed. When filtration is disabled, use this option.
-     */
-    delay?: number;
-    /**
-     * Enables a case-insensitive search. When filtering is disabled, use this option.
-     */
-    ignoreCase?: boolean;
-    /**
-     * Sets the opened and closed state of the DropDownList.
-     */
-    opened?: boolean;
-    /**
-     * The styles that are applied to the DropDownList.
-     */
-    style?: React.CSSProperties;
-    /**
-     * Sets the value of the DropDownList ([see example]({% slug binding_dropdownlist %})). It can either be of the primitive (string, numbers) or of the complex (objects) type.
-     */
-    value?: any;
-    /**
-     * Sets the default value of the DropDownList ([see example]({% slug defaultitem_dropdownlist %})). Similar to the native `select` HTML element.
-     */
-    defaultValue?: any;
-    /**
-     * Sets additional classes to the DropDownList.
-     */
-    className?: string;
-    /**
-     * Sets CSS classes to the expand `icon` DOM element.
-     */
-    iconClassName?: string;
-    /**
-     * Sets the specified SVG icon.
-     */
-    svgIcon?: SVGIcon;
-    /**
-     * Sets the title attribute to the DropDownList DOM element.
-     */
-    title?: string;
-    /**
-     * Sets the disabled state of the DropDownList.
-     */
-    disabled?: boolean;
-    /**
-     * Represents the `dir` HTML attribute.
-     */
-    dir?: string;
-    /**
-     * Enables the filtering functionality of the DropDownList ([more information and examples]({% slug filtering_dropdownlist %})).
-     */
-    filterable?: boolean;
-    /**
-     * 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 loading state of the DropDownList.
-     */
-    loading?: boolean;
-    /**
-     * Specifies the `tabIndex` of the DropDownList.
-     */
-    tabIndex?: number;
-    /**
-     * Specifies the `accessKey` of the DropDownList.
-     */
-    accessKey?: string;
-    /**
-     * Sets the data item field that represents the item text ([see example]({% slug defaultitem_dropdownlist %})). If the data contains only primitive values, do not define it.
-     */
-    textField?: string;
-    /**
-     * Sets the key for comparing the data items of the DropDownList. If `dataItemKey` is not set, the DropDownList compares the items by reference ([see example]({% slug binding_dropdownlist %}#toc-datasets-of-objects)).
-     */
-    dataItemKey?: string;
-    /**
-     * Represents a callback function, which returns the value for submitting. The returned value will be rendered in an `option` of a hidden [`select`](https://reactjs.org/docs/forms.html#the-select-tag) element.
-     *
-     * @example
-     * ```jsx-no-run
-     * class App extends React.Component {
-     *    render() {
-     *       return (
-     *          <form>
-     *              <DropDownList
-     *                  data={[ { text: "Austria", id: 1 } , { text: "Belarus", id: 2 } ]}
-     *                  valueMap={value => value && value.id}
-     *              />
-     *              <button type="submit">Submit</button>
-     *          </form>
-     *       );
-     *    }
-     * }
-     * ReactDOM.render(<App />, document.querySelector('my-app'));
-     * ```
-     */
-    valueMap?: (value: any) => any;
-    /**
-     * Renders a floating label for the DropDownList.
-     */
-    label?: string;
-    /**
-     * 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;
-    /**
-     * The accessible label of the component. By default is set to value of `label` prop.
-     */
-    ariaLabel?: string;
-    /**
-     * Configures the popup of the DropDownList.
-     */
-    popupSettings?: DropDownsPopupSettings;
-    /**
-     * Configures the virtual scrolling of the DropDownList ([see example]({% slug virtualization_dropdownlist %})).
-     */
-    virtual?: VirtualizationSettings;
-    /**
-     * If set, the DropDownList 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));
-     * };
-     *
-     * <DropDownList focusedItemIndex={focusedItemIndex} />
-     * ```
-     */
-    focusedItemIndex?: (data: any, inputText: string, textField?: string) => number;
-    /**
-     * Fires each time the popup of the DropDownList is about to open.
-     */
-    onOpen?: (event: DropDownListOpenEvent) => void;
-    /**
-     * Fires each time the popup of the DropDownList is about to close.
-     */
-    onClose?: (event: DropDownListCloseEvent) => void;
-    /**
-     * Fires each time the user focuses the DropDownList.
-     */
-    onFocus?: (event: DropDownListFocusEvent) => void;
-    /**
-     * Fires each time the DropDownList gets blurred.
-     */
-    onBlur?: (event: DropDownListBlurEvent) => void;
-    /**
-     * Fires each time the value of the DropDownList is about to change ([see examples]({% slug binding_dropdownlist %})).
-     */
-    onChange?: (event: DropDownListChangeEvent) => void;
-    /**
-     * Fires each time the user types in the filter input. You can filter the source based on the passed filtration value.
-     */
-    onFilterChange?: (event: DropDownListFilterChangeEvent) => void;
-    /**
-     * Fires when both the virtual scrolling of the DropDownList is enabled and the component requires data for another page ([see example]({% slug virtualization_dropdownlist %})).
-     */
-    onPageChange?: (event: DropDownListPageChangeEvent) => void;
-    /**
-     * Fires when a DropDownList item is about to be rendered ([see example]({% slug customrendering_dropdownlist %}#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 renders the value is about to be rendered ([see example]({% slug customrendering_dropdownlist %}#toc-values)). Used to override the default appearance of the element.
-     */
-    valueRender?: (element: React.ReactElement<HTMLSpanElement>, value: any) => React.ReactNode;
-    /**
-     * Fires when the element which indicates no data in the popup is about to be rendered ([see example]({% slug customrendering_dropdownlist %}#toc-no-data)). Used to override the default appearance of the element.
-     */
-    listNoDataRender?: (element: React.ReactElement<HTMLDivElement>) => React.ReactNode;
-    /**
-     * Sets the header component of the DropDownList ([see example]({% slug customrendering_dropdownlist %}#toc-headers-and-footers)).
-     */
-    header?: React.ReactNode;
-    /**
-     * Sets the footer component of the DropDownList ([see example]({% slug customrendering_dropdownlist %}#toc-headers-and-footers)).
-     */
-    footer?: React.ReactNode;
-    /**
-     * Specifies the `name` property of the `select` DOM element.
-     */
-    name?: string;
-    /**
-     * If set to `false`, the DropDownList will not navigate over its data through left and right keys.
-     * Useful when the DropDownList is placed inside a toolbar which needs to handle left and right keys.
-     */
-    leftRightKeysNavigation?: boolean;
-    /**
-     * Configures the `size` of the DropDownList.
-     *
-     * 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 DropDownList.
-     *
-     * 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 DropDownList.
-     *
-     * The available options are:
-     * - solid
-     * - flat
-     * - outline
-     * - null&mdash;Does not set a fillMode `className`.
-     *
-     * @default `solid`
-     */
-    fillMode?: null | 'solid' | 'flat' | 'outline';
-    /**
-     * 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;
-    /**
-     * 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;
-    /**
-     * Defines if DropDownList's disabled items will be skipped or focused when navigating through the list of items using a keyboard. Defaults to `true`.
-     */
-    skipDisabledItems?: boolean;
-}

package/DropDownTree/DropDownTree.d.ts

@@ -1,74 +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 { DropDownTreeProps, DropDownTreeHandle } from './DropDownTreeProps';
-/**
- * Represents the PropsContext of the `DropDownTree` component.
- * Used for global configuration of all `DropDownTree` instances.
- *
- * For more information, refer to the [Dropdowns Props Context]({% slug props-context_dropdowns %}) article.
- */
-export declare const DropDownTreePropsContext: React.Context<(p: DropDownTreeProps) => DropDownTreeProps>;
-/**
- * Represents the DropDownTree component.
- *
- * Accepts properties of type [DropDownTreeProps]({% slug api_dropdowns_dropdowntreeprops %}).
- * Obtaining the `ref` returns an object of type [DropDownTreeHandle]({% slug api_dropdowns_dropdowntreehandle %}).
- *
- * @example
- * ```jsx
- * const selectField = "selected";
- * const expandField = "expanded";
- * const dataItemKey = "id";
- * const textField = "text";
- * const subItemsField = "items";
- * const fields = {
- *  selectField,
- *  expandField,
- *  dataItemKey,
- *  subItemsField,
- * };
- *  const App = () => {
- *  const [value, setValue] = React.useState(null);
- *  const [expanded, setExpanded] = React.useState([data[0][dataItemKey]]);
- *  const onChange = (event) => setValue(event.value);
- *  const onExpandChange = React.useCallback(
- *    (event) => setExpanded(expandedState(event.item, dataItemKey, expanded)),
- *    [expanded]
- *  );
- *  const treeData = React.useMemo(
- *    () =>
- *      processTreeData(
- *        data,
- *        {
- *          expanded,
- *          value,
- *        },
- *        fields
- *      ),
- *    [expanded, value]
- *  );
- *
- *  return (
- *      <DropDownTree
- *        style={{
- *          width: '300px',
- *        }}
- *        placeholder="Please select ..."
- *        data={treeData}
- *        value={value}
- *        onChange={onChange}
- *        textField={textField}
- *        dataItemKey={dataItemKey}
- *        selectField={selectField}
- *        expandField={expandField}
- *        onExpandChange={onExpandChange}
- *      />
- *  );
- * };
- * ReactDOM.render(<App />, document.querySelector('my-app'));
- * ```
- */
-export declare const DropDownTree: React.ForwardRefExoticComponent<DropDownTreeProps & React.RefAttributes<DropDownTreeHandle | null>>;