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

package/DropDownTree/DropDownTreeProps.d.ts

@@ -1,297 +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 { FormComponentProps } from '@progress/kendo-react-common';
-import { ItemRenderProps } from '@progress/kendo-react-treeview';
-import { FilterChangeEvent, ChangeEvent, OpenEvent, CloseEvent, FocusEvent, BlurEvent, DropdownEvent } from '../common/events';
-import { DropDownsPopupSettings } from '../common/settings';
-/**
- * Represents the Object which is passed to the
- * [`ref`](https://reactjs.org/docs/refs-and-the-dom.html) callback of the DropDownTree component.
- */
-export interface DropDownTreeHandle {
-    /**
-     * The current element or `null` if there is no one.
-     */
-    element: HTMLElement | null;
-    /**
-     * The props of the DropDownTree component.
-     */
-    props: DropDownTreeProps;
-    /**
-     * The focus function.
-     */
-    focus: () => void;
-}
-/**
- * Represents the object of the `onFilterChange` DropDownTree event.
- */
-export interface DropDownTreeFilterChangeEvent extends FilterChangeEvent<DropDownTreeHandle> {
-}
-/**
- * Represents the object of the `onChange` DropDownTree event.
- */
-export interface DropDownTreeChangeEvent extends ChangeEvent<DropDownTreeHandle> {
-    level: number[];
-}
-/**
- * Represents the object of the `onOpen` DropDownTree event.
- */
-export interface DropDownTreeOpenEvent extends OpenEvent<DropDownTreeHandle> {
-}
-/**
- * Represents the object of the `onClose` DropDownTree event.
- */
-export interface DropDownTreeCloseEvent extends CloseEvent<DropDownTreeHandle> {
-}
-/**
- * Represents the object of the `onFocus` DropDownTree event.
- */
-export interface DropDownTreeFocusEvent extends FocusEvent<DropDownTreeHandle> {
-}
-/**
- * Represents the object of the `onBlur` DropDownTree event.
- */
-export interface DropDownTreeBlurEvent extends BlurEvent<DropDownTreeHandle> {
-}
-/**
- * Represents the object of the `onExpandChange` DropDownTree event.
- */
-export interface DropDownTreeExpandEvent extends DropdownEvent<DropDownTreeHandle> {
-    item: any;
-    level: number[];
-}
-/**
- * The props of component that will be used for rendering each of the DropDownTree items
- * ([see example]({% slug customrendering_dropdowntree %}#toc-items-and-value-element)).
- */
-export interface ItemProps extends ItemRenderProps {
-}
-/**
- * The props of the `ListNoData` component ([see example]({% slug customrendering_dropdowntree %}#toc-no-data)).
- */
-export interface ListNoDataProps {
-    children?: React.ReactNode;
-}
-/**
- * The props of the `ValueHolder` component ([see example]({% slug customrendering_dropdowntree %}#toc-items-and-value-element)).
- */
-export interface ValueHolderProps {
-    children?: React.ReactNode;
-    item?: any;
-}
-/**
- * Represents the props of the [KendoReact DropDownTree component]({% slug overview_dropdowntree %}).
- */
-export interface DropDownTreeProps extends FormComponentProps {
-    /**
-     * Sets the data of the DropDownTree ([see example]({% slug overview_dropdowntree %})).
-     */
-    data?: any[];
-    /**
-     * Sets the opened state of the DropDownTree.
-     */
-    opened?: boolean;
-    /**
-     * The styles that are applied to the DropDownTree.
-     */
-    style?: React.CSSProperties;
-    /**
-     * Sets the value of the DropDownTree ([see example]({% slug overview_dropdowntree %})).
-     * It can be an object from the data-tree.
-     */
-    value?: any;
-    /**
-     * The hint that is displayed when the DropDownTree is empty.
-     */
-    placeholder?: string;
-    /**
-     * Sets the key for comparing the data items of the DropDownTree ([see example]({% slug overview_dropdowntree %})).
-     * If `dataItemKey` is not set, the DropDownTree compares the items by reference.
-     */
-    dataItemKey: string;
-    /**
-     * Sets additional classes to the DropDownTree.
-     */
-    className?: string;
-    /**
-     * Sets the disabled state of the DropDownTree.
-     */
-    disabled?: boolean;
-    /**
-     * Represents the `dir` HTML attribute.
-     */
-    dir?: string;
-    /**
-     * Renders a floating label for the DropDownTree.
-     */
-    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;
-    /**
-     * Enables the filtering functionality of the DropDownTree ([more information and examples]({% slug filtering_dropdowntree %})).
-     */
-    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 DropDownTree ([see example]({% slug filtering_dropdowntree %}#toc-visualize-filtering)).
-     */
-    loading?: boolean;
-    /**
-     * Specifies the `tabIndex` of the DropDownTree.
-     */
-    tabIndex?: number;
-    /**
-     * Specifies the `accessKey` of the DropDownTree.
-     */
-    accessKey?: string;
-    /**
-     * Sets the data item field that represents the item text ([see example]({% slug overview_dropdowntree %})).
-     */
-    textField: string;
-    /**
-     * Specifies the name of the field which will provide a Boolean representation of the selected state of the item.
-     */
-    selectField?: string;
-    /**
-     * Specifies the name of the field which will provide a Boolean representation of the expanded state of the item.
-     */
-    expandField?: string;
-    /**
-     * Specifies the name of the field which will provide an array representation of the item subitems.
-     * Defaults to 'items'.
-     */
-    subItemsField?: string;
-    /**
-     * Configures the popup of the DropDownTree.
-     */
-    popupSettings?: DropDownsPopupSettings;
-    /**
-     * 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>
-     *              <DropDownTree
-     *                  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;
-    /**
-     * Fires each time the popup of the DropDownTree is about to open.
-     */
-    onOpen?: (event: DropDownTreeOpenEvent) => void;
-    /**
-     * Fires each time the popup of the DropDownTree is about to close.
-     */
-    onClose?: (event: DropDownTreeCloseEvent) => void;
-    /**
-     * Fires each time the user focuses the DropDownTree.
-     */
-    onFocus?: (event: DropDownTreeFocusEvent) => void;
-    /**
-     * Fires each time the DropDownTree gets blurred.
-     */
-    onBlur?: (event: DropDownTreeBlurEvent) => void;
-    /**
-     * Fires each time the value of the DropDownTree is about to change ([see examples]({% slug overview_dropdowntree %})).
-     */
-    onChange?: (event: DropDownTreeChangeEvent) => void;
-    /**
-     * Fires each time the user types in the filter input
-     * ([see example]({% slug filtering_dropdowntree %}#toc-basic-configuration)).
-     * You can filter the source based on the passed filtration value.
-     */
-    onFilterChange?: (event: DropDownTreeFilterChangeEvent) => void;
-    /**
-     * Fires when the expanding or collapsing of an item is requested ([see examples]({% slug overview_dropdowntree %})).
-     */
-    onExpandChange?: (event: any) => void;
-    /**
-     * Defines the component that will be used for rendering each of the DropDownTree items
-     * ([see example]({% slug customrendering_dropdowntree %}#toc-items-and-value-element)).
-     */
-    item?: React.ComponentType<ItemProps>;
-    /**
-     * Defines the component that will be used for rendering the selected value
-     * ([see example]({% slug customrendering_dropdowntree %}#toc-items-and-value-element)).
-     */
-    valueHolder?: React.ComponentType<ValueHolderProps>;
-    /**
-     * Defines the component that will be rendered in the DropDownTree popup when no data is available
-     * ([see example]({% slug customrendering_dropdowntree %}#toc-no-data)).
-     */
-    listNoData?: React.ComponentType<ListNoDataProps>;
-    /**
-     * Configures the `size` of the DropDownTree.
-     *
-     * 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 DropDownTree.
-     *
-     * 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 DropDownTree.
-     *
-     * 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;
-}

package/DropDownTree/ListNoData.d.ts

@@ -1,10 +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 { ListNoDataProps } from './DropDownTreeProps';
-/**
- * @hidden
- */
-export declare const ListNoData: React.FunctionComponent<ListNoDataProps>;

package/DropDownTree/useDropdownWidth.d.ts

@@ -1,10 +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 { DropDownsPopupSettings } from '../common/settings';
-/**
- * @hidden
- */
-export declare function useDropdownWidth(elementRef: React.RefObject<HTMLElement | null>, defaultProps: any, popupSettings: DropDownsPopupSettings, style: React.CSSProperties): any;

package/MultiColumnComboBox/MultiColumnComboBox.d.ts

@@ -1,300 +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 { CustomComponent } from '@progress/kendo-react-common';
-import { ComboBoxBlurEvent, ComboBoxChangeEvent, ComboBoxCloseEvent, ComboBoxFilterChangeEvent, ComboBoxFocusEvent, ComboBoxOpenEvent, ComboBoxPageChangeEvent, ComboBoxProps } from '../ComboBox/ComboBoxProps';
-import { DropDownsPopupSettings, VirtualizationSettings } from '../common/settings';
-import { ListItemProps } from '../common/ListItem';
-/**
- * The represents the interface of the MultiColumnComboBox columns.
- */
-export interface MultiColumnComboBoxColumn {
-    /**
-     * The unique id of the column.
-     */
-    uniqueKey?: string;
-    /**
-     * The field of the column.
-     */
-    field?: string;
-    /**
-     * The header of the column.
-     */
-    header?: React.ReactNode;
-    /**
-     * Represents the width of the column. If the width is not specified it is applied the default width of `200px`.
-     */
-    width?: string | number;
-}
-/**
- * Represents the properties of the [MultiColumnComboBox]({% slug api_dropdowns_multicolumncombobox %}) component.
- */
-export interface MultiColumnComboBoxProps extends ComboBoxProps {
-    /**
-     * Determines the columns array of the MultiColumnComboBox.
-     */
-    columns: MultiColumnComboBoxColumn[];
-    /**
-     * Sets the data of the MultiColumnComboBox.
-     */
-    data?: any[];
-    /**
-     * Sets the opened and closed state of the MultiColumnComboBox.
-     */
-    opened?: boolean;
-    /**
-     * The styles that are applied to the MultiColumnComboBox.
-     */
-    style?: React.CSSProperties;
-    /**
-     * Sets the value of the MultiColumnComboBox. It can either be of the primitive (string, numbers) or of the complex (objects) type.
-     */
-    value?: any;
-    /**
-     * Sets the default value of the MultiColumnComboBox. Similar to the native `select` HTML element.
-     */
-    defaultValue?: any;
-    /**
-     * Sets additional classes to the MultiColumnComboBox.
-     */
-    className?: string;
-    /**
-     * If `clearButton` is set to `true`, the MultiColumnComboBox renders a button on hovering over the component. Clicking this button resets the value of the MultiColumnComboBox to `undefined` and triggers the `change` event.
-     */
-    clearButton?: boolean;
-    /**
-     * The hint that is displayed when the MultiColumnComboBox is empty.
-     */
-    placeholder?: string;
-    /**
-     * Specifies whether the MultiColumnComboBox allows user-defined values that are not present in the dataset. Defaults to `false`.
-     */
-    allowCustom?: boolean;
-    /**
-     * Sets the disabled state of the MultiColumnComboBox.
-     */
-    disabled?: boolean;
-    /**
-     * Enables the filtering functionality of the MultiColumnComboBox.
-     */
-    filterable?: boolean;
-    /**
-     * Sets the value of MultiColumnComboBox input. Useful for making the MultiColumnComboBox input a controlled component.
-     */
-    filter?: string | null;
-    /**
-     * Sets the loading state of the MultiColumnComboBox.
-     */
-    loading?: boolean;
-    /**
-     * Specifies the `tabIndex` of the MultiColumnComboBox.
-     */
-    tabIndex?: number;
-    /**
-     * Specifies the `accessKey` of the MultiColumnComboBox.
-     */
-    accessKey?: string;
-    /**
-     * Sets the key for comparing the data items of the MultiColumnComboBox. If `dataItemKey` is not set, the MultiColumnComboBox compares the items by reference.
-     */
-    dataItemKey?: string;
-    /**
-     * Renders a floating label for the MultiColumnComboBox.
-     */
-    label?: string;
-    /**
-     * Configures the popup of the MultiColumnComboBox.
-     */
-    popupSettings?: DropDownsPopupSettings;
-    /**
-     * Configures the virtual scrolling of the MultiColumnComboBox.
-     */
-    virtual?: VirtualizationSettings;
-    /**
-     * If set, the MultiColumnComboBox will use it to get the focused item index. Default functionality returns the first item which starts with the input text.
-     */
-    focusedItemIndex?: (data: any, inputText: string, textField?: string) => number;
-    /**
-     * Fires each time the popup of the MultiColumnComboBox is about to open.
-     */
-    onOpen?: (event: ComboBoxOpenEvent) => void;
-    /**
-     * Fires each time the popup of the MultiColumnComboBox is about to close.
-     */
-    onClose?: (event: ComboBoxCloseEvent) => void;
-    /**
-     * Fires each time the user focuses the MultiColumnComboBox.
-     */
-    onFocus?: (event: ComboBoxFocusEvent) => void;
-    /**
-     * Fires each time the MultiColumnComboBox gets blurred.
-     */
-    onBlur?: (event: ComboBoxBlurEvent) => void;
-    /**
-     * Fires each time the value of the MultiColumnComboBox is about to change.
-     */
-    onChange?: (event: ComboBoxChangeEvent) => void;
-    /**
-     * Fires each time the user types in the filter input. You can filter the source based on the passed filtration value.
-     */
-    onFilterChange?: (event: ComboBoxFilterChangeEvent) => void;
-    /**
-     * Fires when both the virtual scrolling of the MultiColumnComboBox is enabled and the component requires data for another page.
-     */
-    onPageChange?: (event: ComboBoxPageChangeEvent) => void;
-    /**
-     * @hidden
-     */
-    onGroupScroll?: (event: {
-        group?: string;
-    }) => void;
-    /**
-     * Fires when a MultiColumnComboBox list item is about to be rendered. Used to override the default appearance of the list items.
-     */
-    itemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListItemProps) => React.ReactNode;
-    /**
-     * Sets the header component of the MultiColumnComboBox.
-     */
-    header?: React.ReactNode;
-    /**
-     * Sets the footer component of the MultiColumnComboBox.
-     */
-    footer?: React.ReactNode;
-    /**
-     * Configures the `size` of the MultiColumnComboBox.
-     *
-     * 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 MultiColumnComboBox.
-     *
-     * 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 MultiColumnComboBox.
-     *
-     * The available options are:
-     * - solid
-     * - flat
-     * - outline
-     * - null&mdash;Does not set a fillMode `className`.
-     *
-     * @default `solid`
-     */
-    fillMode?: null | 'solid' | 'flat' | 'outline';
-    /**
-     * Sets a custom prefix to the MultiColumnComboBox component.
-     */
-    prefix?: CustomComponent<any> | undefined;
-    /**
-     * Sets a custom suffix to the MultiColumnComboBox component.
-     */
-    suffix?: CustomComponent<any> | undefined;
-}
-/**
- * Represents the target(element and props) of the MultiColumnComboBoxChangeEvent.
- */
-export interface MultiColumnComboBoxHandle {
-    /**
-     * The current element or `null` of there is no one.
-     */
-    element: HTMLSpanElement | null;
-    /**
-     * The value of the MultiColumnComboBox.
-     */
-    value: any;
-    /**
-     * The props values of the MultiColumnComboBox.
-     */
-    props: MultiColumnComboBoxProps;
-    /**
-     * The focus event callback.
-     */
-    focus: () => void;
-}
-/**
- * Represents the type of the MultiColumnComboBoxChangeEvent.
- */
-export interface MultiColumnComboBoxChangeEvent {
-    /**
-     * The value of the MultiColumnComboBoxChangeEvent.
-     */
-    value: any;
-    /**
-     * The target of the MultiColumnComboBoxChangeEvent from MultiColumnComboBoxHandle.
-     */
-    target: MultiColumnComboBoxHandle;
-    /**
-     * The event of the MultiColumnComboBoxChangeEvent.
-     */
-    syntheticEvent: React.SyntheticEvent<any>;
-}
-/**
- * Represents the PropsContext of the `MultiColumnComboBox` component.
- * Used for global configuration of all `MultiColumnComboBox` instances.
- *
- * For more information, refer to the [Dropdowns Props Context]({% slug props-context_dropdowns %}) article.
- */
-export declare const MultiColumnComboBoxPropsContext: React.Context<(p: MultiColumnComboBoxProps) => MultiColumnComboBoxProps>;
-/**
- * Represents the MultiColumnComboBox component.
- *
- * Accepts properties of type [MultiColumnComboBoxProps]({% slug api_dropdowns_multicolumncomboboxprops %}).
- * Obtaining the `ref` returns an object of type [MultiColumnComboBoxHandle]({% slug api_dropdowns_multicolumncomboboxhandle %}).
- *
- * @example
- * ```jsx
- * const columns = [
- *  {
- *    field: "id",
- *    header: "ID",
- *    width: "100px",
- *  },
- *  {
- *    field: "name",
- *    header: "Name",
- *    width: "300px",
- *  },
- *  {
- *    field: "position",
- *    header: "Position",
- *    width: "300px",
- *   },
- * ];
- * const App = () => {
- *   return (
- *     <div>
- *       <div>Employees:</div>
- *       <MultiColumnComboBox
- *         data={employees}
- *         columns={columns}
- *         textField={"name"}
- *         style={{
- *           width: "300px",
- *         }}
- *         placeholder="Please select ..."
- *       />
- *     </div>
- *   );
- * };
- * ReactDOM.render(<App />, document.querySelector("my-app"));
- * ```
- */
-export declare const MultiColumnComboBox: React.ForwardRefExoticComponent<MultiColumnComboBoxProps & React.RefAttributes<MultiColumnComboBoxHandle | null>>;