@sproutsocial/seeds-react-menu 0.4.1 → 0.6.0

package/dist/index.d.mts

@@ -1,15 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as downshift from 'downshift';
-import { GetItemPropsOptions, UseComboboxProps, UseSelectProps, UseMultipleSelectionProps, UseComboboxReturnValue, UseSelectReturnValue, UseMultipleSelectionReturnValue, UseComboboxGetInputPropsOptions } from 'downshift';
+import { UseComboboxProps, UseSelectProps, UseMultipleSelectionProps, UseComboboxReturnValue, UseSelectReturnValue, UseMultipleSelectionReturnValue, UseComboboxGetInputPropsOptions, GetItemPropsOptions } from 'downshift';
+import { TypeBorderSystemProps, TypeColorSystemProps, TypeFlexboxSystemProps, TypeGridSystemProps, TypeLayoutSystemProps, TypePositionSystemProps, TypeSpaceSystemProps, TypeTypographySystemProps, TypeStyledComponentsCommonProps } from '@sproutsocial/seeds-react-system-props';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
-import { TypeBorderSystemProps, TypeColorSystemProps, TypeFlexboxSystemProps, TypeGridSystemProps, TypeLayoutSystemProps, TypePositionSystemProps, TypeSpaceSystemProps, TypeTypographySystemProps, TypeStyledComponentsCommonProps } from '@sproutsocial/seeds-react-system-props';
+import { TypePopoutProps } from '@sproutsocial/seeds-react-popout';
+import { TypeTokenInputProps, TypeTokenSpec } from '@sproutsocial/seeds-react-token-input';
 import * as styled_components from 'styled-components';
 import { HTMLMotionProps } from 'motion/react';
 import { TypeBoxProps } from '@sproutsocial/seeds-react-box';
 export { TypeBoxProps as TypeMenuFooterProps } from '@sproutsocial/seeds-react-box';
 import * as _sproutsocial_seeds_react_text from '@sproutsocial/seeds-react-text';
-import { TypePopoutProps } from '@sproutsocial/seeds-react-popout';
 import { TypeLabelProps } from '@sproutsocial/seeds-react-label';
 import { TypeButtonProps } from '@sproutsocial/seeds-react-button';
 import { TypeInputProps } from '@sproutsocial/seeds-react-input';
@@ -25,15 +25,13 @@ type TypeMenuItemRoles = (typeof MENU_ITEM_ROLES)[keyof typeof MENU_ITEM_ROLES];
 
 interface TypeMenuGroupStyledProps extends TypeBorderSystemProps, TypeColorSystemProps, TypeFlexboxSystemProps, TypeGridSystemProps, TypeLayoutSystemProps, TypePositionSystemProps, TypeSpaceSystemProps, TypeTypographySystemProps {
 }
-interface TypeMenuGroupProps extends TypeMenuGroupStyledProps, Omit<React.ComponentPropsWithoutRef<"ul">, "color"> {
+interface TypeMenuGroupBaseProps extends TypeMenuGroupStyledProps, Omit<React.ComponentPropsWithoutRef<"ul">, "color"> {
     id: string;
     isSingleSelect?: boolean;
     title?: string;
-    children?: ReactNode;
-    items?: TypeMenuItemProps[];
-    MenuItemComponent?: typeof MenuItem;
     titleAs?: string | React.ComponentType<any>;
 }
+type TypeMenuGroupProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeMenuGroupBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-group/
@@ -54,21 +52,160 @@ interface TypeMenuGroupProps extends TypeMenuGroupStyledProps, Omit<React.Compon
  *
  * @see {@link https://seeds.sproutsocial.com/components/menu-item/ | MenuItem}
  */
-declare const MenuGroup: ({ titleAs, children: childrenProp, title, color, isSingleSelect, id, items, MenuItemComponent, ...rest }: TypeMenuGroupProps) => react_jsx_runtime.JSX.Element | null;
+declare const MenuGroup: <I extends TypeMenuItemProps = TypeMenuItemProps>({ titleAs, children: childrenProp, title, color, isSingleSelect, id, menuItems, MenuItemComponent, ...rest }: TypeMenuGroupProps<I>) => react_jsx_runtime.JSX.Element | null;
 
-declare const StyledMenuGroup: styled_components.StyledComponent<"li", styled_components.DefaultTheme, TypeMenuGroupProps, never>;
+declare const StyledMenuGroup: styled_components.StyledComponent<"li", styled_components.DefaultTheme, TypeMenuGroupBaseProps, never>;
 declare const StyledTitle: styled_components.StyledComponent<React$1.FC<_sproutsocial_seeds_react_text.TypeTextProps>, styled_components.DefaultTheme, {}, never>;
 declare const StyledMenuGroupUl: styled_components.StyledComponent<"ul", styled_components.DefaultTheme, {}, never>;
 
-interface TypeDefaultItemProps {
+interface TypeDownshiftComboboxProps extends Partial<UseComboboxProps<TypeInternalItemProps>> {
+}
+interface TypeDownshiftSelectProps extends Partial<UseSelectProps<TypeInternalItemProps>> {
+}
+interface TypeDownshiftMultiSelectProps extends Partial<Omit<UseMultipleSelectionProps<TypeInternalItemProps>, "stateReducer" | "onStateChange" | "getA11yStatusMessage">> {
+    getA11yMultiStatusMessage?: UseMultipleSelectionProps<TypeInternalItemProps>["getA11yStatusMessage"];
+    onMultiSelectStateChange?: UseMultipleSelectionProps<TypeInternalItemProps>["onStateChange"];
+    multiSelectStateReducer?: UseMultipleSelectionProps<TypeInternalItemProps>["stateReducer"];
+}
+interface TypeDownshiftComboboxReturnValue extends Partial<UseComboboxReturnValue<TypeInternalItemProps>> {
+}
+interface TypeDownshiftSelectReturnValue extends Partial<UseSelectReturnValue<TypeInternalItemProps>> {
+}
+interface TypeDownshiftMultiSelectReturnValue extends Partial<UseMultipleSelectionReturnValue<TypeInternalItemProps>> {
+}
+type TypeDonwshiftSharedReturnValue = "getLabelProps" | "getToggleButtonProps" | "getMenuProps";
+type TypeDonwshiftSharedProps = "onHighlightedIndexChange" | "onIsOpenChange" | "onSelectedItemChange" | "onStateChange" | "stateReducer";
+interface TypeMenuContextBaseProps {
+    itemsMap?: {
+        [key: string]: TypeInternalItemProps;
+    };
+    isListbox?: boolean;
+    hiddenItemsMap?: Record<string, boolean>;
+    setHiddenItemsMap?: React__default.Dispatch<React__default.SetStateAction<Record<string, boolean>>>;
+    subMenuId?: string;
+    setSubMenuId?: (id: string) => void;
+    contentRef?: React__default.RefObject<HTMLUListElement>;
+}
+interface TypeAllDownshiftProps extends Omit<TypeDownshiftComboboxReturnValue, TypeDonwshiftSharedReturnValue>, Omit<TypeDownshiftComboboxProps, TypeDonwshiftSharedProps>, Omit<TypeDownshiftSelectReturnValue, TypeDonwshiftSharedReturnValue>, Omit<TypeDownshiftSelectProps, TypeDonwshiftSharedProps>, TypeDownshiftMultiSelectReturnValue, TypeDownshiftMultiSelectProps {
+    onHighlightedIndexChange?: TypeDownshiftComboboxProps["onHighlightedIndexChange"] | TypeDownshiftSelectProps["onHighlightedIndexChange"];
+    onIsOpenChange?: TypeDownshiftComboboxProps["onIsOpenChange"] | TypeDownshiftSelectProps["onIsOpenChange"];
+    onSelectedItemChange?: TypeDownshiftComboboxProps["onSelectedItemChange"] | TypeDownshiftSelectProps["onSelectedItemChange"];
+    onStateChange?: TypeDownshiftComboboxProps["onStateChange"] | TypeDownshiftSelectProps["onStateChange"];
+    stateReducer?: TypeDownshiftComboboxProps["stateReducer"] | TypeDownshiftSelectProps["stateReducer"];
+    getLabelProps?: TypeDownshiftComboboxReturnValue["getLabelProps"] | TypeDownshiftSelectReturnValue["getLabelProps"];
+    getToggleButtonProps?: TypeDownshiftComboboxReturnValue["getToggleButtonProps"] | TypeDownshiftSelectReturnValue["getToggleButtonProps"];
+    getMenuProps?: TypeDownshiftComboboxReturnValue["getMenuProps"] | TypeDownshiftSelectReturnValue["getMenuProps"];
+}
+interface TypeMenuContextProps extends TypeAllDownshiftProps, TypeMenuContextBaseProps {
+    items: TypeInternalItemProps[];
+    itemsMap?: {
+        [key: string]: TypeInternalItemProps;
+    };
+    selectedItemIds?: {
+        [key: string]: boolean;
+    };
+    isListbox?: boolean;
+}
+interface TypeMenuContext extends TypeMenuContextProps {
+    itemsMap: {
+        [key: string]: TypeInternalItemProps;
+    };
+    isItemSelected: (id: string) => boolean;
+    getInputComponentProps: (props: Pick<TypeTokenInputProps, "inputProps"> & Parameters<Required<TypeMenuContextProps>["getInputProps"]>[0]) => Omit<TypeDownshiftMergedInputProps<TypeTokenInputProps>, "onClick">;
+}
+interface TypeMenuProviderProps {
+    children: TypeNotEmptyChildren;
+    menuContext: TypeMenuContext;
+}
+interface TypeMenuToggleContext extends TypeMenuContext {
+    ref?: (arg0: React__default.ElementRef<any> | HTMLElement) => void;
+    toggle?: () => void;
+    show?: () => void;
+    hide?: () => void;
+    ariaProps?: Record<string, any>;
+}
+interface TypeMenuToggleProviderProps extends TypeMenuProviderProps {
+    menuContext: TypeMenuToggleContext;
+}
+/**
+ * Object for Initializing the Menu Context
+ */
+declare const defaultMenuContext: TypeMenuContext;
+declare const getSelectedItemIds: <T extends TypeMenuContextProps["selectedItems"] | undefined, R = T extends undefined ? undefined : Record<string, boolean>>(selectedItems?: T) => R;
+declare const checkIfItemSelected: ({ id, selectedItem, selectedItemIds, }: {
+    id: string;
+    selectedItem?: TypeInternalItemProps | null;
+    selectedItemIds?: TypeMenuContextProps["selectedItemIds"];
+}) => boolean;
+/**
+ * Hook for initializing Menu context
+ */
+declare const useMenu: ({ items, isListbox, isOpen, itemsMap: itemsMapFromProps, selectedItemIds: selectedItemIdsFromProps, selectedItem, selectedItems, getInputProps, contentRef: contentRefFromProps, ...rest }?: Partial<TypeMenuContextProps>) => TypeMenuContext;
+/**
+ * MenuToggleContext factory, sets the type and the initial object
+ * @description Context for the Menu Toggle
+ */
+declare const MenuToggleContext: React__default.Context<TypeMenuToggleContext>;
+/**
+ * MenuToggleProvider Component sets the context values into the provider
+ * @description Context Provider for the Menu Toggle
+ */
+declare const MenuToggleProvider: ({ children, menuContext, }: TypeMenuToggleProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Utility hook for consuming MenuToggleContext
+ */
+declare const useMenuToggleContext: () => TypeMenuToggleContext;
+/**
+ * MenuContentContext factory, sets the type and the initial object
+ * @description Context for the Menu Content
+ */
+declare const MenuContentContext: React__default.Context<TypeMenuContext>;
+/**
+ * MenuContentProvider Component sets the context values into the provider
+ * @description Context Provider for the Menu Content
+ */
+declare const MenuContentProvider: ({ children, menuContext, }: TypeMenuProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Utility hook for consuming MenuContentContext
+ */
+declare const useMenuContentContext: () => TypeMenuContext;
+
+interface TypeMenuRootOwnProps {
+    menuToggleElement: React__default.ReactElement<any>;
+    popoutProps?: Partial<Omit<TypePopoutProps, "isOpen" | "setIsOpen" | "content" | "children">>;
+    width?: TypePopoutProps["width"];
+}
+interface TypeMenuRootProps extends Partial<TypeMenuContextProps>, Pick<TypeMenuProviderProps, "children">, TypeMenuRootOwnProps {
+}
+/**
+ * @link https://seeds.sproutsocial.com/components/menu-root/
+ *
+ * @description MenuRoot is a utility component used to handle {@link https://github.com/sproutsocial/seeds/blob/dev/seeds-react/seeds-react-menu/src/MenuContext.tsx | MenuContext}. This component should rarely, if ever, be used directly unless building a custom menu type.
+ */
+declare const MenuRoot: ({ children, menuToggleElement, popoutProps: { placement, focusLockProps, ...popoutProps }, width, ...contextProps }: TypeMenuRootProps) => react_jsx_runtime.JSX.Element;
+
+interface TypeInternalItemProps<Item = TypeMenuItemProps> {
     id: string;
     index: number;
     disabled?: boolean;
-    hidden?: boolean;
-    menuItemProps?: TypeMenuItemProps;
-    menuGroupProps?: TypeMenuGroupProps;
+    menuItemProps?: Item;
+    menuGroupProps?: TypeMenuGroupBaseProps;
 }
+type TypeChildrenOrItems<I extends TypeMenuItemProps = TypeMenuItemProps> = {
+    /** Allows menu items to be passed in as children. Cannot be used with the items prop.*/
+    children: TypeMenuRootProps["children"];
+    menuItems?: never;
+    MenuItemComponent?: never;
+} | {
+    children?: never;
+    /** Allows menu items to be passed in as objects. Cannot be used with the children prop.*/
+    menuItems: I[];
+    /** Allows a custom MenuItem component to be used when rendering using the items prop.*/
+    MenuItemComponent?: React.ComponentType<I>;
+};
 type TypeNotEmptyChildren = React.ReactChild | React.ReactFragment | React.ReactPortal;
+type TypeInputEventListeners = "onKeyDown" | "onChange" | "onInput" | "onBlur" | "onClick" | "refKey";
+type TypeDownshiftMergedInputProps<B> = Pick<UseComboboxGetInputPropsOptions, TypeInputEventListeners> & Omit<Partial<B>, TypeInputEventListeners>;
 
 interface TypeMenuItemStyledProps extends TypeBorderSystemProps, TypeColorSystemProps, TypeFlexboxSystemProps, TypeGridSystemProps, TypeLayoutSystemProps, TypePositionSystemProps, TypeSpaceSystemProps, TypeTypographySystemProps {
 }
@@ -79,24 +216,28 @@ declare const INPUT_TYPES: {
     readonly ICON: "icon";
 };
 type InputType = (typeof INPUT_TYPES)[keyof typeof INPUT_TYPES];
-interface TypeMenuItemProps extends TypeMenuItemStyledProps, Omit<GetItemPropsOptions<TypeDefaultItemProps>, "as" | "item" | keyof TypeMenuItemStyledProps | keyof TypeDefaultItemProps>, Omit<TypeDefaultItemProps, "index"> {
+interface TypeMenuItemProps extends TypeMenuItemStyledProps, Omit<GetItemPropsOptions<TypeInternalItemProps>, "as" | "item" | "ref" | keyof TypeMenuItemStyledProps | keyof TypeInternalItemProps>, Omit<TypeInternalItemProps, "index"> {
     children: React.ReactNode;
     disabled?: boolean;
     role?: TypeMenuItemRoles;
+    innerRef?: React.Ref<any>;
     $highlighted?: boolean;
     active?: boolean;
     inputType?: InputType;
     inputLabelId?: string;
 }
 
-declare const MenuItem: ({ id, children, onClick, onKeyDown, disabled, ref, href, color, ...props }: TypeMenuItemProps) => react_jsx_runtime.JSX.Element;
+declare const MenuItem: ({ id, children, onClick, onKeyDown, disabled, active, innerRef, href, color, ...props }: TypeMenuItemProps) => react_jsx_runtime.JSX.Element;
 
 declare const MenuItemContainer: styled_components.StyledComponent<"li", styled_components.DefaultTheme, {}, never>;
-declare const StyledMenuItem: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {
+declare const StyledMenuItem: styled_components.StyledComponent<"button", styled_components.DefaultTheme, {
     $highlighted: boolean;
+    $active?: boolean;
 }, never>;
 declare const MenuItemRow: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {}, never>;
 declare const MenuItemAction: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {}, never>;
+declare const MenuItemActionLeft: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {}, never>;
+declare const MenuItemActionRight: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {}, never>;
 declare const MenuItemText: styled_components.StyledComponent<"div", styled_components.DefaultTheme, {}, never>;
 
 interface TypeMenuHeaderProps extends Omit<React$1.ComponentPropsWithoutRef<"div">, "color">, TypeStyledComponentsCommonProps, TypeBorderSystemProps, TypeColorSystemProps, TypeFlexboxSystemProps, TypeGridSystemProps, TypeLayoutSystemProps, TypeSpaceSystemProps, TypePositionSystemProps {
@@ -114,9 +255,9 @@ interface TypeMenuHeaderProps extends Omit<React$1.ComponentPropsWithoutRef<"div
  */
 declare const MenuHeader: ({ children, title, leftAction, rightAction, ...rest }: TypeMenuHeaderProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeMenuContentProps extends HTMLMotionProps<"ul"> {
-    children: ReactNode;
-}
+type TypeMenuContentProps<I extends TypeMenuItemProps = TypeMenuItemProps> = Omit<HTMLMotionProps<"ul">, "children"> & {
+    innerRef?: React.Ref<HTMLUListElement>;
+} & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-content/
@@ -140,7 +281,7 @@ interface TypeMenuContentProps extends HTMLMotionProps<"ul"> {
  * @see {@link https://seeds.sproutsocial.com/components/menu-item/ | MenuItem}
  * @see {@link https://seeds.sproutsocial.com/components/menu-group/ | MenuGroup}
  */
-declare const MenuContent: ({ id, children, ...rest }: TypeMenuContentProps) => react_jsx_runtime.JSX.Element;
+declare const MenuContent: <I extends TypeMenuItemProps = TypeMenuItemProps>({ id, children: childrenProp, menuItems, MenuItemComponent, onKeyDown, innerRef, ...rest }: TypeMenuContentProps<I>) => react_jsx_runtime.JSX.Element | null;
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-footer/
@@ -151,89 +292,45 @@ declare const MenuContent: ({ id, children, ...rest }: TypeMenuContentProps) =>
  */
 declare const MenuFooter: ({ children, ...rest }: TypeBoxProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeDownshiftComboboxProps extends Partial<UseComboboxProps<TypeDefaultItemProps>> {
-}
-interface TypeDownshiftSelectProps extends Partial<UseSelectProps<TypeDefaultItemProps>> {
-}
-interface TypeDownshiftMultiSelectProps extends Partial<Omit<UseMultipleSelectionProps<TypeDefaultItemProps>, "stateReducer" | "onStateChange" | "getA11yStatusMessage">> {
-    getA11yMultiStatusMessage?: UseMultipleSelectionProps<TypeDefaultItemProps>["getA11yStatusMessage"];
-    onMultiSelectStateChange?: UseMultipleSelectionProps<TypeDefaultItemProps>["onStateChange"];
-    multiSelectStateReducer?: UseMultipleSelectionProps<TypeDefaultItemProps>["stateReducer"];
-}
-interface TypeDownshiftComboboxReturnValue extends Partial<UseComboboxReturnValue<TypeDefaultItemProps>> {
-}
-interface TypeDownshiftSelectReturnValue extends Partial<UseSelectReturnValue<TypeDefaultItemProps>> {
-}
-interface TypeDownshiftMultiSelectReturnValue extends Partial<UseMultipleSelectionReturnValue<TypeDefaultItemProps>> {
-}
-type TypeDonwshiftSharedReturnValue = "getLabelProps" | "getToggleButtonProps" | "getMenuProps";
-type TypeDonwshiftSharedProps = "onHighlightedIndexChange" | "onIsOpenChange" | "onSelectedItemChange" | "onStateChange" | "stateReducer";
-interface TypeMenuContextProps extends Omit<TypeDownshiftComboboxReturnValue, TypeDonwshiftSharedReturnValue>, Omit<TypeDownshiftComboboxProps, TypeDonwshiftSharedProps>, Omit<TypeDownshiftSelectReturnValue, TypeDonwshiftSharedReturnValue>, Omit<TypeDownshiftSelectProps, TypeDonwshiftSharedProps>, TypeDownshiftMultiSelectReturnValue, TypeDownshiftMultiSelectProps {
-    items: TypeDefaultItemProps[];
-    itemsMap?: {
-        [key: string]: TypeDefaultItemProps;
-    };
-    isListbox?: boolean;
-    onHighlightedIndexChange?: TypeDownshiftComboboxProps["onHighlightedIndexChange"] | TypeDownshiftSelectProps["onHighlightedIndexChange"];
-    onIsOpenChange?: TypeDownshiftComboboxProps["onIsOpenChange"] | TypeDownshiftSelectProps["onIsOpenChange"];
-    onSelectedItemChange?: TypeDownshiftComboboxProps["onSelectedItemChange"] | TypeDownshiftSelectProps["onSelectedItemChange"];
-    onStateChange?: TypeDownshiftComboboxProps["onStateChange"] | TypeDownshiftSelectProps["onStateChange"];
-    stateReducer?: TypeDownshiftComboboxProps["stateReducer"] | TypeDownshiftSelectProps["stateReducer"];
-    getLabelProps?: TypeDownshiftComboboxReturnValue["getLabelProps"] | TypeDownshiftSelectReturnValue["getLabelProps"];
-    getToggleButtonProps?: TypeDownshiftComboboxReturnValue["getToggleButtonProps"] | TypeDownshiftSelectReturnValue["getToggleButtonProps"];
-    getMenuProps?: TypeDownshiftComboboxReturnValue["getMenuProps"] | TypeDownshiftSelectReturnValue["getMenuProps"];
-}
-interface TypeMenuContext extends TypeMenuContextProps {
-    itemsMap: {
-        [key: string]: TypeDefaultItemProps;
-    };
+declare const MenuLabel: ({ children, ...rest }: Partial<TypeLabelProps>) => react_jsx_runtime.JSX.Element;
+
+interface TypeMenuToggleButtonProps extends Partial<TypeButtonProps> {
+    children: ReactNode;
 }
-interface TypeMenuProviderProps {
-    children: TypeNotEmptyChildren;
-    menuProps: Partial<TypeMenuContextProps>;
+declare const MenuToggleButton: ({ children, ...rest }: TypeMenuToggleButtonProps) => react_jsx_runtime.JSX.Element;
+
+type TypeGetIsItemVisibleFn = (item: TypeMenuContext["items"][number], inputValue: string) => boolean;
+
+interface TypeMenuSearchInputProps extends TypeInputProps {
+    getIsItemVisible?: TypeGetIsItemVisibleFn;
 }
 /**
- * Hook for initializing Menu context
- */
-declare const useMenu: ({ items, isListbox, isOpen, itemsMap: itemsMapFromProps, ...rest }?: Partial<TypeMenuContextProps>) => TypeMenuContext;
-/**
- * MenuContext factory, sets the type and the initial object
- */
-declare const MenuContext: React__default.Context<TypeMenuContext>;
-/**
- * Provider Component sets the context values into the provider
- */
-declare const MenuProvider: ({ children, menuProps, }: TypeMenuProviderProps) => react_jsx_runtime.JSX.Element;
-/**
- * Utility hook for consuming MenuContext
+ * @link https://seeds.sproutsocial.com/components/menu-header/
+ *
+ * @description MenuSearchInput is search input that can be added to the MenuHeader to filter the items.
  */
-declare const useMenuContext: () => TypeMenuContext;
+declare const MenuSearchInput: ({ getIsItemVisible, ...inputProps }: TypeMenuSearchInputProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeMenuRootOwnProps {
-    menuToggleElement: React__default.ReactElement<any>;
-    popoutProps?: Partial<Omit<TypePopoutProps, "isOpen" | "setIsOpen" | "content" | "children">>;
-    width?: TypePopoutProps["width"];
+interface TypeMenuTokenInputProps extends TypeTokenInputProps {
+    getTokenProps?: (itemId: TypeInternalItemProps["id"]) => Partial<TypeTokenSpec>;
+    MenuContext?: typeof MenuToggleContext | typeof MenuContentContext;
 }
-interface TypeMenuRootProps extends Partial<TypeMenuProviderProps["menuProps"]>, Pick<TypeMenuProviderProps, "children">, TypeMenuRootOwnProps {
+declare const MenuTokenInput: ({ inputProps, getTokenProps, onKeyDown, MenuContext, ...tokenInputProps }: TypeMenuTokenInputProps) => react_jsx_runtime.JSX.Element;
+
+interface TypeMenuSearchTokenInputProps extends TypeMenuTokenInputProps {
+    getIsItemVisible?: TypeGetIsItemVisibleFn;
 }
 /**
- * @link https://seeds.sproutsocial.com/components/menu-root/
+ * @link https://seeds.sproutsocial.com/components/menu-search-token-input/
  *
- * @description MenuRoot is a utility component used to handle {@link https://github.com/sproutsocial/seeds/blob/dev/seeds-react/seeds-react-menu/src/MenuContext.tsx | MenuContext}. This component should rarely, if ever, be used directly unless building a custom menu type.
+ * @description MenuSearchTokenInput is search token input that can be added to the MenuHeader to filter the items.
  */
-declare const MenuRoot: ({ children, menuToggleElement, popoutProps: { focusLockProps, ...popoutProps }, width, ...contextProps }: TypeMenuRootProps) => react_jsx_runtime.JSX.Element;
-
-declare const MenuLabel: ({ children, ...rest }: Partial<TypeLabelProps>) => react_jsx_runtime.JSX.Element;
-
-interface TypeMenuToggleButtonProps extends Partial<TypeButtonProps> {
-    children: ReactNode;
-}
-declare const MenuToggleButton: ({ children, ...rest }: TypeMenuToggleButtonProps) => react_jsx_runtime.JSX.Element;
+declare const MenuSearchTokenInput: ({ getIsItemVisible, getTokenProps, onChange, inputProps: { value: inputPropsValue, ...inputProps }, value, ...tokenInputProps }: TypeMenuSearchTokenInputProps) => react_jsx_runtime.JSX.Element;
 
 type TypeInvalidMenuProps = "initialSelectedItem" | "defaultSelectedItem" | "selectedItem";
-interface TypeActionMenuProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSelectProps, TypeInvalidMenuProps> {
-    children: TypeMenuRootProps["children"];
+interface TypeActionMenuBaseProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSelectProps, TypeInvalidMenuProps> {
 }
+type TypeActionMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeActionMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/action-menu/
@@ -244,11 +341,11 @@ interface TypeActionMenuProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSe
  * @see {@link https://github.com/sproutsocial/seeds/tree/dev/seeds-react/seeds-react-menu/src/SingleSelectMenu | SingleSelectMenu}
  * @see {@link https://github.com/sproutsocial/seeds/tree/dev/seeds-react/seeds-react-menu/src/MultiSelectMenu | MultiSelectMenu}
  */
-declare const ActionMenu: ({ children, stateReducer: externalStateReducer, ...useSelectProps }: TypeActionMenuProps) => react_jsx_runtime.JSX.Element;
+declare const ActionMenu: <I extends TypeMenuItemProps = TypeMenuItemProps>({ children: childrenProp, menuItems, MenuItemComponent, stateReducer: externalStateReducer, ...useSelectProps }: TypeActionMenuProps<I>) => react_jsx_runtime.JSX.Element;
 
-interface TypeSingleSelectMenuProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps {
-    children: TypeMenuRootProps["children"];
+interface TypeSingleSelectMenuBaseProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps {
 }
+type TypeSingleSelectMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeSingleSelectMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/singleselect-menu/
@@ -258,11 +355,11 @@ interface TypeSingleSelectMenuProps extends TypeMenuRootOwnProps, TypeDownshiftS
  * **To trigger actions from a menu:**
  * @see {@link https://github.com/sproutsocial/seeds/tree/dev/seeds-react/seeds-react-menu/src/ActionMenu | ActionMenu}
  */
-declare const SingleSelectMenu: ({ children, stateReducer: externalStateReducer, ...useSelectProps }: TypeSingleSelectMenuProps) => react_jsx_runtime.JSX.Element;
+declare const SingleSelectMenu: <I extends TypeMenuItemProps = TypeMenuItemProps>({ children: childrenProp, stateReducer: externalStateReducer, menuItems, MenuItemComponent, ...useSelectProps }: TypeSingleSelectMenuProps<I>) => react_jsx_runtime.JSX.Element;
 
-interface TypeMultiSelectMenuProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps, TypeDownshiftMultiSelectProps {
-    children: TypeMenuRootProps["children"];
+interface TypeMultiSelectMenuBaseProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps, TypeDownshiftMultiSelectProps {
 }
+type TypeMultiSelectMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeMultiSelectMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/multiselect-menu/
@@ -271,47 +368,131 @@ interface TypeMultiSelectMenuProps extends TypeMenuRootOwnProps, TypeDownshiftSe
  *
  * @see {@link https://seeds.sproutsocial.com/components/menu-group/ | MenuGroup}
  */
-declare const MultiSelectMenu: ({ children, stateReducer: externalStateReducer, getA11yMultiStatusMessage, onMultiSelectStateChange, multiSelectStateReducer, ...useSelectProps }: TypeMultiSelectMenuProps) => react_jsx_runtime.JSX.Element;
+declare const MultiSelectMenu: <I extends TypeMenuItemProps = TypeMenuItemProps>({ children: childrenProp, menuItems, MenuItemComponent, onSelectedItemChange: externalOnSelectedItemChange, stateReducer: externalStateReducer, getA11yMultiStatusMessage, onMultiSelectStateChange, multiSelectStateReducer, ...useSelectProps }: TypeMultiSelectMenuProps<I>) => react_jsx_runtime.JSX.Element;
 
-interface TypeAutocompleteProps extends TypeMenuRootOwnProps, TypeDownshiftComboboxProps {
-    children: TypeMenuRootProps["children"];
-    getIsItemVisible?: (item: TypeMenuContext["items"][number], inputValue: string) => boolean;
+type TypeSubmenuValidMenuComponentProps<I extends TypeMenuItemProps> = TypeChildrenOrItems<I> & (TypeActionMenuProps<I> | TypeSingleSelectMenuProps<I> | TypeMultiSelectMenuProps<I>);
+interface TypeSubmenuItemProps<I extends TypeMenuItemProps, P extends TypeSubmenuValidMenuComponentProps<I>> extends TypeMenuItemProps {
+    isOpen?: boolean;
+    onToggleSubmenu?: (isOpen: boolean) => void;
+    MenuComponent: React.ComponentType<P>;
+    menuProps: Omit<P, "menuToggleElement">;
 }
 
+declare const SubmenuItem: <I extends TypeMenuItemProps, P extends TypeSubmenuValidMenuComponentProps<I>>({ MenuComponent, menuProps: { children: menuChildren, menuItems, MenuItemComponent, popoutProps: { popperProps, ...popoutProps }, onStateChange, ...menuProps }, id, children, ...rest }: TypeSubmenuItemProps<I, P>) => react_jsx_runtime.JSX.Element;
+
+type TypeSingleAutocompleteProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeMenuRootOwnProps & TypeChildrenOrItems<I> & TypeDownshiftComboboxProps & {
+    getIsItemVisible?: TypeGetIsItemVisibleFn;
+};
+type TypeMultiAutocompleteProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeSingleAutocompleteProps<I> & TypeDownshiftMultiSelectProps & {
+    showSelectedItemsInDropdown?: boolean;
+};
+type TypeAutocompleteProps<I extends TypeMenuItemProps = TypeMenuItemProps> = (TypeSingleAutocompleteProps<I> & {
+    multiSelect?: false;
+}) | (TypeMultiAutocompleteProps<I> & {
+    multiSelect: true;
+});
+
 /**
- * @link https://seeds.sproutsocial.com/components/multiselect-menu/
+ * @link https://seeds.sproutsocial.com/components/autocomplete/
  *
- * @description A Autocomplete allows multiple {@link https://github.com/sproutsocial/seeds/tree/dev/seeds-react/seeds-react-menu/src/MenuItem | MenuItems} to be selected from a list or groups of lists.
+ * @description A Autocomplete allows selecting a {@link https://github.com/sproutsocial/seeds/tree/dev/seeds-react/seeds-react-menu/src/MenuItem | MenuItems} to be selected from a list or groups of lists to populate an input.
  *
- * @see {@link https://seeds.sproutsocial.com/components/menu-group/ | MenuGroup}
  */
-declare const Autocomplete: ({ children, stateReducer: externalStateReducer, itemToString, getIsItemVisible, ...useComboboxProps }: TypeAutocompleteProps) => react_jsx_runtime.JSX.Element;
+declare const Autocomplete: <I extends TypeMenuItemProps = TypeMenuItemProps>({ multiSelect, ...rest }: TypeAutocompleteProps<I>) => react_jsx_runtime.JSX.Element;
 
-type TypeInputEventListeners = "onKeyDown" | "onChange" | "onInput" | "onBlur" | "onClick" | "refKey";
-interface TypeAutocompleteInputProps extends Pick<UseComboboxGetInputPropsOptions, TypeInputEventListeners>, Omit<Partial<TypeInputProps>, TypeInputEventListeners> {
+interface TypeAutocompleteInputProps extends TypeDownshiftMergedInputProps<TypeInputProps> {
 }
 declare const AutocompleteInput: ({ onKeyDown, onChange, onInput, onBlur, onClick, inputProps, ...rest }: TypeAutocompleteInputProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeUseItemsFromChildrenProps {
-    children: ReactNode;
+interface TypeNestedMenuMapProps<P, I extends TypeMenuItemProps = TypeNestedMenuItemProps> {
+    MenuComponent: React.ComponentType<P>;
+    menuProps: Omit<P, "menuToggleElement"> & TypeChildrenOrItems<I>;
+    /** Defaults to NestedMenuHeader if not provided.
+     *  This header can be suppressed by passing null.*/
+    MenuHeaderComponent?: React.ComponentType<TypeMenuHeaderProps> | null;
+    menuHeaderProps?: Partial<TypeMenuHeaderProps>;
+}
+interface TypeNestedMenuHeaderProps extends TypeMenuHeaderProps {
+    /** Localized label for the back arrow in this child menu.
+     *  Overrides the default label passed to NestedMenu. */
+    backArrowLabel?: string;
 }
-type TypeItemElement = React__default.ReactElement<TypeMenuItemProps>;
-type TypeMenuGroupElement = React__default.ReactElement<TypeMenuGroupProps>;
+interface TypeNestedMenuItemProps extends TypeMenuItemProps {
+    childMenuId?: string;
+}
+interface TypeNestedMenuProps<I extends TypeMenuItemProps = TypeNestedMenuItemProps> {
+    initialMenuId: string;
+    menuToggleElement: TypeMenuRootProps["menuToggleElement"];
+    onBackButtonClick?: (menuId: string) => void;
+    /** Sets the default localized label for the back arrow in all child menus.
+     *  This label can be overridden by including backArrowLabel in a menu's menuHeaderProps. */
+    backArrowLabel?: string;
+    /** An object of the menus and child menus to be displayed, keyed by id.*/
+    menus: {
+        [id: string]: TypeNestedMenuMapProps<TypeActionMenuProps<I>, I> | TypeNestedMenuMapProps<TypeSingleSelectMenuProps<I>, I> | TypeNestedMenuMapProps<TypeMultiSelectMenuProps<I>, I>;
+    };
+}
+
+declare const NestedMenu: <I extends TypeMenuItemProps = TypeNestedMenuItemProps>({ initialMenuId, menus, onBackButtonClick, backArrowLabel, menuToggleElement, }: TypeNestedMenuProps<I>) => react_jsx_runtime.JSX.Element;
+
+declare const NestedMenuItem: ({ children, childMenuId, onClick: onClickProp, ...rest }: TypeNestedMenuItemProps) => react_jsx_runtime.JSX.Element;
+
+declare const NestedMenuHeader: ({ backArrowLabel, ...props }: TypeNestedMenuHeaderProps) => react_jsx_runtime.JSX.Element;
+
+declare const NestedMenuContent: <I extends TypeMenuItemProps = TypeNestedMenuItemProps>({ innerRef: innerRefProp, onKeyDown: onKeyDownProp, children, menuItems, MenuItemComponent, ...props }: TypeMenuContentProps<I>) => react_jsx_runtime.JSX.Element;
+
+interface TypeNestedMenuContext {
+    selectedMenuPath: string[];
+    setSelectedMenuId?: (id: string) => void;
+    setSelectedMenuPath?: (path: string[]) => void;
+    goBack?: () => void;
+}
+interface TypeNestedMenuProviderProps extends TypeNestedMenuContext {
+    children: TypeNotEmptyChildren;
+}
+/**
+ * NestedMenuContext factory, sets the type and the initial object
+ */
+declare const NestedMenuContext: React__default.Context<TypeNestedMenuContext>;
+/**
+ * Provider Component sets the context values in the provider
+ */
+declare const NestedMenuProvider: ({ children, ...nestedMenuProps }: TypeNestedMenuProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Utility hook for consuming NestedMenuContext
+ */
+declare const useNestedMenuContext: () => TypeNestedMenuContext;
+
+interface TypeMapMenuItemsProps<I extends TypeMenuItemProps = TypeMenuItemProps> {
+    menuItems: I[];
+    MenuItemComponent?: React__default.ComponentType<I>;
+}
+type TypeItemElement<I extends TypeMenuItemProps = TypeMenuItemProps> = React__default.ReactElement<TypeMenuItemProps | TypeSubmenuItemProps<I, TypeSubmenuValidMenuComponentProps<I>>>;
+type TypeMenuGroupElement<I extends TypeMenuItemProps = TypeMenuItemProps> = React__default.ReactElement<TypeMenuGroupProps<I>>;
+type TypeMenuContentElement<I extends TypeMenuItemProps = TypeMenuItemProps> = React__default.ReactElement<TypeMenuContentProps<I>>;
 interface TypeMenuChildren {
-    type: "item" | "group";
-    element: React__default.ReactElement<TypeMenuGroupProps> | React__default.ReactElement<TypeMenuItemProps>;
+    type: "item" | "group" | "content";
+    element: TypeItemElement | TypeMenuGroupElement | TypeMenuContentElement;
 }
-declare const useItemsFromChildren: ({ children, }: TypeUseItemsFromChildrenProps) => {
-    allMenuItems: TypeDefaultItemProps[];
+declare const mapMenuItems: <I extends TypeMenuItemProps = TypeMenuItemProps>({ menuItems, MenuItemComponent, }: TypeMapMenuItemsProps<I>) => react_jsx_runtime.JSX.Element;
+type TypeUseMenuChildrenProps<I extends TypeMenuItemProps = TypeMenuItemProps> = {
+    children?: TypeMenuRootProps["children"];
+    menuItems?: I[];
+    MenuItemComponent?: React__default.ComponentType<I>;
+};
+declare const getChildrenFromMenuItems: <I extends TypeMenuItemProps = TypeMenuItemProps>({ menuItems, MenuItemComponent, }: {
+    menuItems: I[];
+    MenuItemComponent?: React__default.ComponentType<I>;
+}) => react_jsx_runtime.JSX.Element;
+declare const useMenuChildren: <I extends TypeMenuItemProps = TypeMenuItemProps>({ children: childrenProp, menuItems, MenuItemComponent, }: TypeUseMenuChildrenProps<I>) => {
+    allMenuItems: TypeInternalItemProps<TypeMenuItemProps>[];
     menuItemsMap: {
-        [key: string]: TypeDefaultItemProps;
+        [key: string]: TypeInternalItemProps<TypeMenuItemProps>;
     };
+    children: TypeNotEmptyChildren;
 };
 
-declare const useSelectStateReducer: Required<UseSelectProps<TypeDefaultItemProps>>["stateReducer"];
-declare const defaultUseSelectProps: {
-    stateReducer: (state: downshift.UseSelectState<TypeDefaultItemProps>, actionAndChanges: downshift.UseSelectStateChangeOptions<TypeDefaultItemProps>) => Partial<downshift.UseSelectState<TypeDefaultItemProps>>;
-    isItemDisabled: (item: any) => boolean;
-};
+declare const useSelectStateReducer: Required<UseSelectProps<TypeInternalItemProps>>["stateReducer"];
+declare const useSelectStateReducerForMulti: Required<UseSelectProps<TypeInternalItemProps>>["stateReducer"];
 
-export { ActionMenu, Autocomplete, AutocompleteInput, INPUT_TYPES, type InputType, MenuContent, MenuContext, MenuFooter, MenuGroup, MenuHeader, MenuItem, MenuItemAction, MenuItemContainer, MenuItemRow, MenuItemText, MenuLabel, MenuProvider, MenuRoot, MenuToggleButton, MultiSelectMenu, SingleSelectMenu, StyledMenuGroup, StyledMenuGroupUl, StyledMenuItem, StyledTitle, type TypeActionMenuProps, type TypeAutocompleteInputProps, type TypeAutocompleteProps, type TypeDefaultItemProps, type TypeDownshiftComboboxProps, type TypeDownshiftComboboxReturnValue, type TypeDownshiftMultiSelectProps, type TypeDownshiftMultiSelectReturnValue, type TypeDownshiftSelectProps, type TypeDownshiftSelectReturnValue, type TypeItemElement, type TypeMenuChildren, type TypeMenuContentProps, type TypeMenuContext, type TypeMenuContextProps, type TypeMenuGroupElement, type TypeMenuGroupProps, type TypeMenuGroupStyledProps, type TypeMenuHeaderProps, type TypeMenuItemProps, type TypeMenuItemStyledProps, type TypeMenuProviderProps, type TypeMenuRootOwnProps, type TypeMenuRootProps, type TypeMenuToggleButtonProps, type TypeMultiSelectMenuProps, type TypeNotEmptyChildren, type TypeSingleSelectMenuProps, type TypeUseItemsFromChildrenProps, defaultUseSelectProps, useItemsFromChildren, useMenu, useMenuContext, useSelectStateReducer };
+export { ActionMenu, Autocomplete, AutocompleteInput, INPUT_TYPES, type InputType, MenuContent, MenuContentContext, MenuContentProvider, MenuFooter, MenuGroup, MenuHeader, MenuItem, MenuItemAction, MenuItemActionLeft, MenuItemActionRight, MenuItemContainer, MenuItemRow, MenuItemText, MenuLabel, MenuRoot, MenuSearchInput, MenuSearchTokenInput, MenuToggleButton, MenuToggleContext, MenuToggleProvider, MenuTokenInput, MultiSelectMenu, NestedMenu, NestedMenuContent, NestedMenuContext, NestedMenuHeader, NestedMenuItem, NestedMenuProvider, SingleSelectMenu, StyledMenuGroup, StyledMenuGroupUl, StyledMenuItem, StyledTitle, SubmenuItem, type TypeActionMenuBaseProps, type TypeActionMenuProps, type TypeAutocompleteInputProps, type TypeAutocompleteProps, type TypeChildrenOrItems, type TypeDownshiftComboboxProps, type TypeDownshiftComboboxReturnValue, type TypeDownshiftMergedInputProps, type TypeDownshiftMultiSelectProps, type TypeDownshiftMultiSelectReturnValue, type TypeDownshiftSelectProps, type TypeDownshiftSelectReturnValue, type TypeInternalItemProps, type TypeItemElement, type TypeMapMenuItemsProps, type TypeMenuChildren, type TypeMenuContentElement, type TypeMenuContentProps, type TypeMenuContext, type TypeMenuContextBaseProps, type TypeMenuContextProps, type TypeMenuGroupBaseProps, type TypeMenuGroupElement, type TypeMenuGroupProps, type TypeMenuGroupStyledProps, type TypeMenuHeaderProps, type TypeMenuItemProps, type TypeMenuItemStyledProps, type TypeMenuProviderProps, type TypeMenuRootOwnProps, type TypeMenuRootProps, type TypeMenuSearchInputProps, type TypeMenuSearchTokenInputProps, type TypeMenuToggleButtonProps, type TypeMenuToggleContext, type TypeMenuToggleProviderProps, type TypeMenuTokenInputProps, type TypeMultiAutocompleteProps, type TypeMultiSelectMenuBaseProps, type TypeMultiSelectMenuProps, type TypeNestedMenuContext, type TypeNestedMenuHeaderProps, type TypeNestedMenuItemProps, type TypeNestedMenuMapProps, type TypeNestedMenuProps, type TypeNestedMenuProviderProps, type TypeNotEmptyChildren, type TypeSingleAutocompleteProps, type TypeSingleSelectMenuBaseProps, type TypeSingleSelectMenuProps, type TypeSubmenuItemProps, type TypeSubmenuValidMenuComponentProps, checkIfItemSelected, defaultMenuContext, getChildrenFromMenuItems, getSelectedItemIds, mapMenuItems, useMenu, useMenuChildren, useMenuContentContext, useMenuToggleContext, useNestedMenuContext, useSelectStateReducer, useSelectStateReducerForMulti };