@ringcentral/spring-ui 1.7.0

package/src/Animation/components/SortableArrow/index.d.ts

@@ -0,0 +1,2 @@
+export * from './SortableArrow';
+export * from './SortableArrow.classes';

package/src/Animation/components/index.d.ts

@@ -0,0 +1,7 @@
+export * from './ExpandCollapseCaret';
+export * from './Fade';
+export * from './Grow';
+export * from './ShowHideEye';
+export * from './SlideIn';
+export * from './SortableArrow';
+export * from './types';

package/src/Animation/components/types.d.ts

@@ -0,0 +1,9 @@
+import { Transition } from 'framer-motion';
+import { ComponentType } from 'react';
+export declare type CommonMotionOptions = {
+    toggle?: boolean;
+    prefersReducedMotion?: boolean;
+    toggleOnTransition?: Transition;
+    toggleOffTransition?: Transition;
+};
+export declare type MotionComponent<T> = ComponentType<T & CommonMotionOptions>;

package/src/Animation/hooks/__mocks__/MatchMedia.mock.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="jest" />
+export declare class MatchMediaMock {
+    private currentQueryValue;
+    private listenerNotifiers;
+    matchMediaMock: jest.SpyInstance<MediaQueryList, [query: string]>;
+    constructor();
+    createMock: () => jest.SpyInstance<MediaQueryList, [query: string]>;
+    private matchQuery;
+    updateMatchMediaQuery: (newQuery: string) => void;
+    reset: () => void;
+    mockRestore: () => void;
+}

package/src/Animation/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './usePrefersReducedMotion';
+export * from './useMotionSafeTransition';

package/src/Animation/hooks/useMotionSafeTransition/index.d.ts

@@ -0,0 +1 @@
+export * from './useMotionSafeTransition';

package/src/Animation/hooks/useMotionSafeTransition/useMotionSafeTransition.d.ts

@@ -0,0 +1,10 @@
+import { Transition } from 'framer-motion';
+/**
+ * A hook that returns an instant transition if the user has reduced motion enabled.
+ * If reduced motion is not enabled, returns the given motion transition.
+ */
+export declare const useMotionSafeTransition: (transition: Transition) => (import("framer-motion").Orchestration & import("framer-motion").Repeat & {
+    [key: string]: any;
+}) | {
+    duration: number;
+};

package/src/Animation/hooks/usePrefersReducedMotion/index.d.ts

@@ -0,0 +1 @@
+export * from './usePrefersReducedMotion';

package/src/Animation/hooks/usePrefersReducedMotion/usePrefersReducedMotion.d.ts

@@ -0,0 +1 @@
+export declare const usePrefersReducedMotion: () => boolean;

package/src/Animation/index.d.ts

@@ -0,0 +1,2 @@
+export * from './components';
+export * from './hooks';

package/src/Announcement/Announcement.classes.d.ts

@@ -0,0 +1,8 @@
+import type { CamelCase } from 'type-fest';
+import { BaseAlertClassesKey } from '../Alert/Alert.classes';
+export declare type BaseAnnouncementClassesKey = BaseAlertClassesKey;
+export declare type AnnouncementClassesKey = CamelCase<BaseAnnouncementClassesKey>;
+export declare type AnnouncementClasses = {
+    name: 'announcement';
+    classes: BaseAnnouncementClassesKey;
+};

package/src/Announcement/Announcement.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+import { AnnouncementProps } from './Announcement.type';
+import announcementStyles from './styles/Announcement.css';
+declare const Announcement: import("react").ForwardRefExoticComponent<Pick<AnnouncementProps, "classes" | "key" | "action" | `data-${string}` | keyof import("react").HTMLAttributes<HTMLDivElement> | "component" | "icon" | "onClose" | "startSlot" | "closeText" | "severity" | "CloseButtonProps"> & import("react").RefAttributes<HTMLDivElement>>;
+export { Announcement, announcementStyles };

package/src/Announcement/Announcement.type.d.ts

@@ -0,0 +1,4 @@
+import { StandardProps } from '@ringcentral/spring-base';
+import { AlertProps } from '../Alert';
+import { AnnouncementClassesKey } from './Announcement.classes';
+export declare type AnnouncementProps = StandardProps<Omit<AlertProps, 'classes'>, AnnouncementClassesKey, 'div'>;

package/src/Announcement/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Announcement.classes';
+export * from './Announcement';
+export * from './Announcement.type';

package/src/Autocomplete/Autocomplete.classes.d.ts

@@ -0,0 +1,14 @@
+import type { CamelCase } from 'type-fest';
+import type { FormFieldSize, FormFieldVariant } from '../FormField/FormField.type';
+export declare type AutocompleteSlot = 'chevron' | 'clear' | 'form-field-content' | 'chip' | 'input-container' | 'input' | 'end-adornment';
+export declare type BaseAutocompleteClassesKey = 'root' | 'error' | FormFieldVariant | AutocompleteSlot | `form-field-content-${FormFieldSize}` | `input-container-${FormFieldSize}` | `input-${FormFieldSize}` | `error-${AutocompleteSlot}` | `${FormFieldVariant}-expanded` | `${FormFieldVariant}-expanded-${AutocompleteSlot}` | `${FormFieldVariant}-${AutocompleteSlot}`;
+export declare type AutocompleteClassesKey = CamelCase<BaseAutocompleteClassesKey>;
+export declare type AutocompleteClasses = {
+    name: 'autocomplete';
+    classes: BaseAutocompleteClassesKey;
+};
+export declare type AutocompletePopperClassesKey = 'root' | 'paper' | 'empty';
+export declare type AutocompletePopperClasses = {
+    name: 'autocomplete-popper';
+    classes: AutocompletePopperClassesKey;
+};

package/src/Autocomplete/Autocomplete.d.ts

@@ -0,0 +1,11 @@
+import { AutocompleteComponent, AutocompleteProps } from './Autocomplete.type';
+import autocompleteStyles from './styles/Autocomplete.css';
+import { SuggestionListItemData } from './SuggestionList';
+declare const Autocomplete: AutocompleteComponent<SuggestionListItemData>;
+export { Autocomplete, autocompleteStyles };
+/**
+ * default Autocomplete filter options method, use with `variant="tags"`
+ *
+ * - filter options by input value and selected items
+ */
+export declare const RcAutocompleteDefaultFilterOptions: AutocompleteProps['filterOptions'];

package/src/Autocomplete/Autocomplete.type.d.ts

@@ -0,0 +1,141 @@
+import { ComponentType, ElementType, ReactElement, Ref } from 'react';
+import { ClassesProp, HTMLDataAttribute, StandardProps } from '@ringcentral/spring-base';
+import { IconButtonProps } from '../IconButton';
+import { PopperProps } from '../Popper';
+import { StandardInputAttributes, TextFieldProps } from '../TextField';
+import { AutocompleteClassesKey, AutocompletePopperClassesKey } from './Autocomplete.classes';
+import { AutocompleteRenderOptionState, BaseSuggestionListProps, SuggestionListItemData, SuggestionListProps } from './SuggestionList';
+import { UseAutocompleteParams } from './useAutocomplete';
+import { GetTagProps } from './useAutocompleteTag';
+export declare type AutocompleteSuggestionListProps<T> = BaseSuggestionListProps<T> & Pick<SuggestionListProps, 'maxContainerHeight' | 'padding' | 'virtualize'>;
+export declare type AutocompleteRef<T extends SuggestionListItemData = SuggestionListItemData> = {
+    /** get current active index */
+    getActiveIndex: () => number;
+    /** set current active index */
+    setActiveIndex: (index: number) => void;
+    /** get current filter result option items; */
+    getFilterResultItems: () => T[];
+    /** get current highlight index */
+    getHighlightedIndex: () => number;
+    /** set current highlight index */
+    setHighlightedIndex: (index: number) => void;
+    /**
+     * keep highlightedIndex for next render when options change,
+     * can use when lazy load more options
+     */
+    keepHighlightedIndex: () => void;
+    /** open the listbox menu */
+    openMenu: () => void;
+    /** close the listbox menu */
+    closeMenu: () => void;
+    /** focus on text field input */
+    focus: () => void;
+    /** reset whole downshift, isFocus default is `false` */
+    reset: (isFocus?: boolean) => void;
+    /** method to clean input value */
+    clearInput: () => void;
+};
+export declare type AutocompleteProps<T extends SuggestionListItemData = SuggestionListItemData> = StandardProps<{
+    /** Determines the variant of the Autocomplete component. */
+    variant?: 'autocomplete' | 'tags';
+    /** If true, the component will take up the full width of its container.
+     *  @default `true`
+     */
+    fullWidth?: boolean;
+    /** Specifies the variant of the input field. */
+    inputVariant?: AutoCompleteTextFieldInputProps['variant'];
+    /** Enables the toggle button for the dropdown menu. */
+    toggleButton?: boolean;
+    /** Props applied to the toggle button. */
+    ToggleButtonProps?: Partial<IconButtonProps> & HTMLDataAttribute;
+    /**
+     * Props applied to the underlying IconButton component used for the clear button.
+     * Allows customization of appearance and behavior.
+     *
+     * @example
+     * ```tsx
+     * ClearButtonProps={{
+     *   size: 'xsmall',
+     *   'aria-label': 'Clear input',
+     * }}
+     * ```
+     */
+    ClearButtonProps?: Partial<IconButtonProps> & HTMLDataAttribute;
+    /**
+     * Function to get custom props for the toggle button based on the menu's open state.
+     * Useful for customizing the toggle button icon.
+     */
+    getToggleButtonProps?: (isOpen: boolean) => AutocompleteProps<T>['ToggleButtonProps'];
+    /**
+     * A ref for imperative actions.
+     *
+     * - `getActiveIndex`: get current active index
+     * - `setActiveIndex`: set current active index;
+     * - `getFilterResultItems`: get current filter result option items;
+     * - `getHighlightedIndex`: get current highlight index;
+     * - `setHighlightedIndex`: set current highlight index;
+     * - `openMenu`: open the listbox menu
+     * - `closeMenu`: close the listbox menu
+     * - `focus`: focus on text field input
+     * - `reset(isFocus)`: reset whole downshift, `isFocus` default is `false`
+     */
+    action?: React.Ref<AutocompleteRef<T>>;
+    /**
+     * Custom rendering function for options Uses `getOptionLabel` by default.
+     * @param option The option to render.
+     * @param state The state of the component.
+     * @returns A ReactNode representing the rendered option.
+     */
+    renderOption?: (option: T, state: AutocompleteRenderOptionState) => React.ReactNode;
+    /** Custom component for rendering the popper. Defaults to Popper.
+     *  @default Popper
+     */
+    PopperComponent?: ComponentType<PopperProps>;
+    /** Configuration props for the Popper component. */
+    PopperProps?: Omit<Partial<PopperProps>, 'open' | 'keepMounted' | 'anchorEl' | 'classes'> & {
+        /**
+         * Determines the anchor element type for the popper.
+         *
+         * - `root`: on that whole TextField
+         * - `input`: on that inside input
+         * @default 'root'
+         */
+        anchorElType?: 'root' | 'input';
+    } & ClassesProp<AutocompletePopperClassesKey>;
+    /** Props for the suggestion list, supporting virtualized lists. */
+    SuggestionListProps?: AutocompleteSuggestionListProps<T>;
+    /**
+     * Custom rendering function for the input field, default is `RcTextField`
+     */
+    renderInput?: (params: Partial<AutoCompleteTextFieldInputProps>) => React.ReactElement;
+    /** If true, allows free solo input not bound to provided options. */
+    freeSolo?: boolean;
+    /**
+     * If `true`, the placeholder will be displayed when multiple value is allowed and tags are present.
+     * @default false
+     */
+    showPlaceholderWithTags?: boolean;
+    /**
+     * Custom rendering function for selected tags.
+     *
+     * @param selectedItems The selected items.
+     * @param getTagProps Function to get props for each tag.
+     * @returns A ReactNode representing the rendered tags.
+     */
+    renderTags?: (selectedItems: T[], getTagProps: (selectedItem: T, index: number) => Omit<GetTagProps<T>, 'children' | 'index' | 'selectedItem'> & {
+        onDelete?: React.EventHandler<any>;
+    }) => React.ReactNode;
+    /** If true, the popup will ignore blur events. Useful for customization. */
+    debug?: boolean;
+} & Omit<UseAutocompleteParams<T>, 'inputRef'> & Partial<Pick<UseAutocompleteParams<T>, 'inputRef'>> & Omit<AutoCompleteTextFieldInputProps, 'value' | 'variant' | 'onChange'> & Pick<SuggestionListProps, 'renderGroup'>, AutocompleteClassesKey, 'div'>;
+export interface AutocompleteComponent<T extends SuggestionListItemData = SuggestionListItemData> {
+    (props: AutocompleteProps<T>): ReactElement;
+    displayName?: string;
+}
+export declare type AutoCompleteInputProps = {
+    startAdornment?: React.ReactNode;
+    containerRef?: Ref<HTMLDivElement>;
+    containerClassName?: string;
+    onContainerClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+} & StandardInputAttributes;
+export declare type AutoCompleteTextFieldInputProps = TextFieldProps<ElementType, AutoCompleteInputProps>;

package/src/Autocomplete/SuggestionList/SuggestionList.classes.d.ts

@@ -0,0 +1,7 @@
+import type { CamelCase } from 'type-fest';
+export declare type BaseSuggestionListClassesKey = 'root' | 'item' | 'selected' | 'group-title' | 'readonly' | 'group-title-readonly' | 'highlighted' | 'expand-icon';
+export declare type SuggestionListClassesKey = CamelCase<BaseSuggestionListClassesKey>;
+export declare type SuggestionListClasses = {
+    name: 'suggestion-list';
+    classes: BaseSuggestionListClassesKey;
+};

package/src/Autocomplete/SuggestionList/SuggestionList.d.ts

@@ -0,0 +1,144 @@
+import React, { HTMLAttributes } from 'react';
+import { VirtuosoHandle, VirtuosoProps } from 'react-virtuoso';
+import { ClassesProp, HTMLDataAttribute } from '@ringcentral/spring-base';
+import { IconButtonProps } from '../../IconButton';
+import suggestionListStyles from './styles/SuggestionList.css';
+import { SuggestionListClassesKey } from './SuggestionList.classes';
+import { SuggestionListItemProps } from './SuggestionListItem';
+import { SuggestionListGroupedOption, SuggestionListHighlightChangeReason, SuggestionListItemData, UseSuggestionListParams } from './utils';
+export interface AutocompleteRenderOptionState {
+    /** current input value */
+    inputValue?: string;
+    /** is that item be show highlighted style */
+    highlighted: boolean;
+    /** that item index */
+    index: number;
+    /** sort index in option own group */
+    indexInOwnGroup?: number;
+    /** if that item is group title, that have that `expanded` state */
+    expanded?: boolean;
+    /** if that item is group title, that will have that `expandIconProps` */
+    expandIconProps?: Partial<IconButtonProps>;
+}
+export declare type BaseSuggestionListProps<T, K = any> = Omit<Partial<VirtuosoProps<T, K>>, 'totalCount' | 'itemContent' | 'data' | 'color'> & ClassesProp<SuggestionListClassesKey> & HTMLDataAttribute;
+export declare type SuggestionListProps<T extends SuggestionListItemData = SuggestionListItemData, K = any> = {
+    /**
+     * that virtual list container height,
+     *
+     * @default 100%
+     */
+    maxContainerHeight?: number | '100%';
+    /**
+     * vertical padding of the list
+     *
+     * @default 8
+     */
+    padding?: boolean | number;
+    /** is that menu virtualize  */
+    virtualize?: boolean;
+    /** current highlightedIndex */
+    highlightedIndex: number;
+    /** select options */
+    options: SuggestionListItemData[];
+    /**
+     * Used to determine the selected state for a given option.
+     *
+     * @param {T} option The option to test.
+     * @returns {boolean}
+     */
+    getOptionSelected?: (option: T) => boolean;
+    /** each item props getter */
+    getItemProps: (options: {
+        index?: number;
+        item: T;
+    }) => SuggestionListItemProps;
+    /** list wrapper props getter */
+    getSuggestionListProps: (restProps?: HTMLAttributes<HTMLDivElement> | undefined) => HTMLAttributes<HTMLDivElement>;
+    /** that reason that change highlighted */
+    changeHighlightedIndexReason?: SuggestionListHighlightChangeReason | undefined;
+    /** is that need keep highlighted index, that will be helpful when you need load more options when scroll */
+    isKeepHighlightedIndex?: boolean;
+    /** trigger when need update outside popper position */
+    onContainerHeightChange?: () => void;
+    /** options group list, use for calculate `aria-setsize` */
+    optionsGroupList?: SuggestionListGroupedOption<SuggestionListItemData>[];
+    /**
+     * Render the option, use `getOptionLabel` by default.
+     *
+     * @param {T} option The option to render.
+     * @param {object} state The state of the component.
+     * @returns {ReactNode}
+     */
+    renderOption?: (option: T, state: AutocompleteRenderOptionState) => React.ReactNode;
+    /**
+     * Render the group title item, also with for toggle button props.
+     *
+     * > when you have set custom `renderOption`, the `renderGroup` must be set.
+     *
+     * @param {T} option The option to render.
+     * @param {object} state The state of the component.
+     * @returns {ReactNode}
+     */
+    renderGroup?: (option: T, state: AutocompleteRenderOptionState) => React.ReactNode;
+} & Pick<UseSuggestionListParams, 'groupVariant' | 'groupExpanded' | 'inputValue' | 'getOptionDisabled' | 'getOptionLabel'> & BaseSuggestionListProps<T, K>;
+export declare const SuggestionList: React.ForwardRefExoticComponent<{
+    /**
+     * that virtual list container height,
+     *
+     * @default 100%
+     */
+    maxContainerHeight?: number | "100%" | undefined;
+    /**
+     * vertical padding of the list
+     *
+     * @default 8
+     */
+    padding?: number | boolean | undefined;
+    /** is that menu virtualize  */
+    virtualize?: boolean | undefined;
+    /** current highlightedIndex */
+    highlightedIndex: number;
+    /** select options */
+    options: SuggestionListItemData[];
+    /**
+     * Used to determine the selected state for a given option.
+     *
+     * @param {T} option The option to test.
+     * @returns {boolean}
+     */
+    getOptionSelected?: ((option: SuggestionListItemData) => boolean) | undefined;
+    /** each item props getter */
+    getItemProps: (options: {
+        index?: number | undefined;
+        item: SuggestionListItemData;
+    }) => SuggestionListItemProps;
+    /** list wrapper props getter */
+    getSuggestionListProps: (restProps?: HTMLAttributes<HTMLDivElement> | undefined) => HTMLAttributes<HTMLDivElement>;
+    /** that reason that change highlighted */
+    changeHighlightedIndexReason?: SuggestionListHighlightChangeReason | undefined;
+    /** is that need keep highlighted index, that will be helpful when you need load more options when scroll */
+    isKeepHighlightedIndex?: boolean | undefined;
+    /** trigger when need update outside popper position */
+    onContainerHeightChange?: (() => void) | undefined;
+    /** options group list, use for calculate `aria-setsize` */
+    optionsGroupList?: SuggestionListGroupedOption<SuggestionListItemData>[] | undefined;
+    /**
+     * Render the option, use `getOptionLabel` by default.
+     *
+     * @param {T} option The option to render.
+     * @param {object} state The state of the component.
+     * @returns {ReactNode}
+     */
+    renderOption?: ((option: SuggestionListItemData, state: AutocompleteRenderOptionState) => React.ReactNode) | undefined;
+    /**
+     * Render the group title item, also with for toggle button props.
+     *
+     * > when you have set custom `renderOption`, the `renderGroup` must be set.
+     *
+     * @param {T} option The option to render.
+     * @param {object} state The state of the component.
+     * @returns {ReactNode}
+     */
+    renderGroup?: ((option: SuggestionListItemData, state: AutocompleteRenderOptionState) => React.ReactNode) | undefined;
+} & Pick<UseSuggestionListParams<SuggestionListItemData>, "getOptionDisabled" | "groupExpanded" | "groupVariant" | "inputValue" | "getOptionLabel"> & Omit<Partial<VirtuosoProps<SuggestionListItemData, any>>, "data" | "color" | "itemContent" | "totalCount"> & ClassesProp<SuggestionListClassesKey> & HTMLDataAttribute & React.RefAttributes<VirtuosoHandle>>;
+export { suggestionListStyles };

package/src/Autocomplete/SuggestionList/SuggestionListItem.d.ts

@@ -0,0 +1,28 @@
+import { DetailedHTMLProps, HTMLAttributes, PropsWithoutRef } from 'react';
+import { ClassesProp } from '@ringcentral/spring-base';
+import { IconButtonProps } from '../../IconButton';
+import { SuggestionListClassesKey } from './SuggestionList.classes';
+export declare type SuggestionListItemProps = {
+    id?: string;
+    label?: React.ReactNode;
+    expanded?: boolean;
+    expandable?: boolean;
+    isGroupTitle?: boolean;
+    isTitleMode?: boolean;
+    selected?: boolean;
+    highlighted?: boolean;
+    disabled?: boolean;
+    expandIconProps?: Partial<IconButtonProps>;
+} & PropsWithoutRef<DetailedHTMLProps<HTMLAttributes<HTMLElement>, HTMLElement>> & ClassesProp<SuggestionListClassesKey>;
+export declare const SuggestionListItem: import("react").ForwardRefExoticComponent<{
+    id?: string | undefined;
+    label?: React.ReactNode;
+    expanded?: boolean | undefined;
+    expandable?: boolean | undefined;
+    isGroupTitle?: boolean | undefined;
+    isTitleMode?: boolean | undefined;
+    selected?: boolean | undefined;
+    highlighted?: boolean | undefined;
+    disabled?: boolean | undefined;
+    expandIconProps?: Partial<IconButtonProps<"button">> | undefined;
+} & Pick<DetailedHTMLProps<HTMLAttributes<HTMLElement>, HTMLElement>, "key" | keyof HTMLAttributes<HTMLElement>> & ClassesProp<SuggestionListClassesKey> & import("react").RefAttributes<HTMLDivElement>>;

package/src/Autocomplete/SuggestionList/index.d.ts

@@ -0,0 +1,4 @@
+export * from './SuggestionList.classes';
+export * from './SuggestionList';
+export * from './SuggestionListItem';
+export * from './utils';

package/src/Autocomplete/SuggestionList/utils/SuggestionListItem.d.ts

@@ -0,0 +1,33 @@
+import { ButtonHTMLAttributes, DetailedHTMLProps, PropsWithoutRef } from 'react';
+import { IconButtonProps } from '../../../IconButton';
+export interface SuggestionListGroupedOption<T = SuggestionListItemData> {
+    options: T[];
+    /** group key */
+    key: number;
+    /** group index in all options */
+    index: number;
+    /** group order in all group */
+    order: number;
+    /** group title */
+    group: string;
+    /** expanded state */
+    expanded: boolean;
+    /** The props apply to apply to the underlying `IconButton` */
+    getExpandIconProps?: (additionalProps?: Omit<PropsWithoutRef<DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>, 'color'> & Partial<IconButtonProps>) => Omit<PropsWithoutRef<DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>, 'color'> | undefined | Partial<IconButtonProps>;
+}
+export declare type SuggestionListItemData = {
+    /** children item id */
+    id?: number | string;
+    /** display label */
+    label?: string;
+    /** is that item disabled */
+    disabled?: boolean;
+    /** is that item error */
+    error?: boolean;
+    /** is that come from freeSolo item */
+    freeSolo?: boolean;
+    /** that item belongs group */
+    group?: SuggestionListGroupedOption;
+    /** default styles */
+    className?: string;
+};

package/src/Autocomplete/SuggestionList/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './SuggestionListItem';
+export * from './useDynamicHeight';
+export * from './useHighlightScroll';
+export * from './useSuggestionList';
+export * from './useSuggestionListGroup';

package/src/Autocomplete/SuggestionList/utils/useDynamicHeight.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+declare type UseDynamicHeightParams = {
+    /** total items count */
+    itemCount: number;
+    /** max-height of container */
+    maxContainerHeight?: number | '100%';
+    /** trigger when container height need change */
+    onContainerHeightChange?: (number: number) => void;
+};
+/**
+ * auto calculate container height
+ */
+export declare const useDynamicHeight: ({ itemCount, maxContainerHeight, onContainerHeightChange, }: UseDynamicHeightParams) => {
+    containerHeighRef: import("react").MutableRefObject<number>;
+    totalListHeightChanged: (height: number) => void;
+    style: {
+        height: string | number;
+    };
+};
+export {};

package/src/Autocomplete/SuggestionList/utils/useHighlightScroll.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { FlatIndexLocationWithAlign, ListItem } from 'react-virtuoso';
+declare type UseHighlightScrollParams = {
+    /** function to call to scroll to target index */
+    scrollToIndex: (location: FlatIndexLocationWithAlign) => void;
+    /** that scroll container height ref */
+    containerHeighRef: React.MutableRefObject<number>;
+};
+/**
+ * scroll into current highlight index
+ */
+export declare function useHighlightScroll({ containerHeighRef, scrollToIndex, }: UseHighlightScrollParams): {
+    /**
+     * scroller reference
+     */
+    scrollerRef: React.MutableRefObject<HTMLElement | undefined>;
+    /**
+     * Scroll to target highlighted index
+     * @param prevHighlightedIndex previous highlightedIndex
+     * @param currHighlightedIndex current highlightedIndex
+     * @param topHighlightIndex top highlighIndex for check should scroll when init
+     */
+    scrollToHighlightedIndex: (prevHighlightedIndex: number, currHighlightedIndex: number, topHighlightIndex?: number) => void;
+    /**
+     * set to virtuoso `scrollerRef` prop, auto bind inner `scrollerRef`
+     */
+    scrollerRefFn: (elm: HTMLElement) => HTMLElement;
+    /**
+     * set to virtuoso `itemsRendered` prop, auto bind inner `renderedItemsRef`
+     */
+    itemsRendered: (e: ListItem<unknown>[]) => ListItem<unknown>[];
+};
+export {};