@sproutsocial/seeds-react-menu 0.5.0 → 1.0.0

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as downshift from 'downshift';
-import { UseComboboxProps, UseSelectProps, UseMultipleSelectionProps, UseComboboxReturnValue, UseSelectReturnValue, UseMultipleSelectionReturnValue, GetItemPropsOptions, 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 { 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';
@@ -25,13 +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 TypeBaseMenuGroupProps extends TypeMenuGroupStyledProps, Omit<React.ComponentPropsWithoutRef<"ul">, "color"> {
+interface TypeMenuGroupBaseProps extends TypeMenuGroupStyledProps, Omit<React.ComponentPropsWithoutRef<"ul">, "color"> {
     id: string;
     isSingleSelect?: boolean;
     title?: string;
     titleAs?: string | React.ComponentType<any>;
 }
-type TypeMenuGroupProps = TypeBaseMenuGroupProps & TypeChildrenOrItems;
+type TypeMenuGroupProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeMenuGroupBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-group/
@@ -52,35 +52,45 @@ type TypeMenuGroupProps = TypeBaseMenuGroupProps & TypeChildrenOrItems;
  *
  * @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;
+    __MENU_PRIMITIVE_TYPE: string;
+};
 
-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 TypeDownshiftComboboxProps extends Partial<UseComboboxProps<TypeDefaultItemProps>> {
+interface TypeDownshiftComboboxProps extends Partial<UseComboboxProps<TypeInternalItemProps>> {
 }
-interface TypeDownshiftSelectProps extends Partial<UseSelectProps<TypeDefaultItemProps>> {
+interface TypeDownshiftSelectProps extends Partial<UseSelectProps<TypeInternalItemProps>> {
 }
-interface TypeDownshiftMultiSelectProps extends Partial<Omit<UseMultipleSelectionProps<TypeDefaultItemProps>, "stateReducer" | "onStateChange" | "getA11yStatusMessage">> {
-    getA11yMultiStatusMessage?: UseMultipleSelectionProps<TypeDefaultItemProps>["getA11yStatusMessage"];
-    onMultiSelectStateChange?: UseMultipleSelectionProps<TypeDefaultItemProps>["onStateChange"];
-    multiSelectStateReducer?: UseMultipleSelectionProps<TypeDefaultItemProps>["stateReducer"];
+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<TypeDefaultItemProps>> {
+interface TypeDownshiftComboboxReturnValue extends Partial<UseComboboxReturnValue<TypeInternalItemProps>> {
 }
-interface TypeDownshiftSelectReturnValue extends Partial<UseSelectReturnValue<TypeDefaultItemProps>> {
+interface TypeDownshiftSelectReturnValue extends Partial<UseSelectReturnValue<TypeInternalItemProps>> {
 }
-interface TypeDownshiftMultiSelectReturnValue extends Partial<UseMultipleSelectionReturnValue<TypeDefaultItemProps>> {
+interface TypeDownshiftMultiSelectReturnValue extends Partial<UseMultipleSelectionReturnValue<TypeInternalItemProps>> {
 }
 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[];
+interface TypeMenuContextBaseProps {
     itemsMap?: {
-        [key: string]: TypeDefaultItemProps;
+        [key: string]: TypeInternalItemProps;
     };
     isListbox?: boolean;
+    hiddenItemsMap?: Record<string, boolean>;
+    hiddenItemsCount?: number;
+    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"];
@@ -90,73 +100,116 @@ interface TypeMenuContextProps extends Omit<TypeDownshiftComboboxReturnValue, Ty
     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]: TypeDefaultItemProps;
+        [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;
-    menuProps: Partial<TypeMenuContextProps>;
+    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, ...rest }?: Partial<TypeMenuContextProps>) => TypeMenuContext;
+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;
 /**
- * MenuContext factory, sets the type and the initial object
+ * MenuContentContext factory, sets the type and the initial object
+ * @description Context for the Menu Content
  */
-declare const MenuContext: React__default.Context<TypeMenuContext>;
+declare const MenuContentContext: React__default.Context<TypeMenuContext>;
 /**
- * Provider Component sets the context values into the provider
+ * MenuContentProvider Component sets the context values into the provider
+ * @description Context Provider for the Menu Content
  */
-declare const MenuProvider: ({ children, menuProps, }: TypeMenuProviderProps) => react_jsx_runtime.JSX.Element;
+declare const MenuContentProvider: ({ children, menuContext, }: TypeMenuProviderProps) => react_jsx_runtime.JSX.Element;
 /**
- * Utility hook for consuming MenuContext
+ * Utility hook for consuming MenuContentContext
  */
-declare const useMenuContext: () => TypeMenuContext;
+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<TypeMenuProviderProps["menuProps"]>, Pick<TypeMenuProviderProps, "children">, TypeMenuRootOwnProps {
+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: { focusLockProps, ...popoutProps }, width, ...contextProps }: TypeMenuRootProps) => react_jsx_runtime.JSX.Element;
+declare const MenuRoot: ({ children, menuToggleElement, popoutProps: { placement, focusLockProps, ...popoutProps }, width, ...contextProps }: TypeMenuRootProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeDefaultItemProps {
+interface TypeInternalItemProps<Item = TypeMenuItemProps> {
     id: string;
     index: number;
     disabled?: boolean;
-    hidden?: boolean;
-    menuItemProps?: TypeMenuItemProps;
-    menuGroupProps?: TypeMenuGroupProps;
+    menuItemProps?: Item;
+    menuGroupProps?: TypeMenuGroupBaseProps;
 }
-type TypeBaseChildrenOrItems = {
+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"];
-    /** Allows menu items to be passed in as objects. Cannot be used with the children prop.*/
-    items?: TypeMenuItemProps[];
-    /** Allows a custom MenuItem component to be used when rendering using the items prop.*/
-    MenuItemComponent?: React.ComponentType<TypeMenuItemProps>;
-};
-type TypePropsWithChildren = {
     children: TypeMenuRootProps["children"];
-    items?: never;
+    menuItems?: never;
     MenuItemComponent?: never;
-};
-type TypePropsWithItems = {
+} | {
     children?: never;
-    items: TypeMenuItemProps[];
+    /** 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 TypeChildrenOrItems = TypeBaseChildrenOrItems & (TypePropsWithChildren | TypePropsWithItems);
 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 {
 }
@@ -167,24 +220,31 @@ 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;
+    __MENU_PRIMITIVE_TYPE: string;
+};
 
 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 {
@@ -202,9 +262,9 @@ interface TypeMenuHeaderProps extends Omit<React$1.ComponentPropsWithoutRef<"div
  */
 declare const MenuHeader: ({ children, title, leftAction, rightAction, ...rest }: TypeMenuHeaderProps) => react_jsx_runtime.JSX.Element;
 
-interface TypeMenuContentBaseProps extends HTMLMotionProps<"ul"> {
-}
-type TypeMenuContentProps = TypeMenuContentBaseProps & TypeChildrenOrItems;
+type TypeMenuContentProps<I extends TypeMenuItemProps = TypeMenuItemProps> = Omit<HTMLMotionProps<"ul">, "children"> & {
+    innerRef?: React.Ref<HTMLUListElement>;
+} & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-content/
@@ -228,7 +288,10 @@ type TypeMenuContentProps = TypeMenuContentBaseProps & TypeChildrenOrItems;
  * @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: childrenProp, items, MenuItemComponent, ...rest }: TypeMenuContentProps) => react_jsx_runtime.JSX.Element | null;
+declare const MenuContent: {
+    <I extends TypeMenuItemProps = TypeMenuItemProps>({ id, children: childrenProp, menuItems, MenuItemComponent, onKeyDown, innerRef, ...rest }: TypeMenuContentProps<I>): react_jsx_runtime.JSX.Element | null;
+    __MENU_PRIMITIVE_TYPE: string;
+};
 
 /**
  * @link https://seeds.sproutsocial.com/components/menu-footer/
@@ -246,10 +309,46 @@ interface TypeMenuToggleButtonProps extends Partial<TypeButtonProps> {
 }
 declare const MenuToggleButton: ({ children, ...rest }: TypeMenuToggleButtonProps) => react_jsx_runtime.JSX.Element;
 
-type TypeInvalidMenuProps = "initialSelectedItem" | "defaultSelectedItem" | "selectedItem" | "items";
+type TypeGetIsItemVisibleFn = (item: TypeMenuContext["items"][number], inputValue: string) => boolean;
+
+interface TypeMenuSearchInputProps extends TypeInputProps {
+    getIsItemVisible?: TypeGetIsItemVisibleFn;
+}
+/**
+ * <input
+ *  aria-activedescendant=""
+ *  aria-autocomplete="list"
+ *  aria-controls="downshift-:r1:-menu"
+ *  aria-expanded="true"
+ * />
+ */
+/**
+ * @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 MenuSearchInput: ({ getIsItemVisible, inputProps, ...restInputProps }: TypeMenuSearchInputProps) => react_jsx_runtime.JSX.Element;
+
+interface TypeMenuTokenInputProps extends TypeTokenInputProps {
+    getTokenProps?: (itemId: TypeInternalItemProps["id"]) => Partial<TypeTokenSpec>;
+    MenuContext?: typeof MenuToggleContext | typeof MenuContentContext;
+}
+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-search-token-input/
+ *
+ * @description MenuSearchTokenInput is search token input that can be added to the MenuHeader to filter the items.
+ */
+declare const MenuSearchTokenInput: ({ getIsItemVisible, getTokenProps, onChange, inputProps: { value: inputPropsValue, ...inputProps }, value, ...tokenInputProps }: TypeMenuSearchTokenInputProps) => react_jsx_runtime.JSX.Element;
+
+type TypeInvalidMenuProps = "initialSelectedItem" | "defaultSelectedItem" | "selectedItem";
 interface TypeActionMenuBaseProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSelectProps, TypeInvalidMenuProps> {
 }
-type TypeActionMenuProps = TypeActionMenuBaseProps & TypeChildrenOrItems;
+type TypeActionMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeActionMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/action-menu/
@@ -260,11 +359,11 @@ type TypeActionMenuProps = TypeActionMenuBaseProps & TypeChildrenOrItems;
  * @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: childrenProp, items, MenuItemComponent, 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 TypeSingleSelectMenuBaseProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSelectProps, "items"> {
+interface TypeSingleSelectMenuBaseProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps {
 }
-type TypeSingleSelectMenuProps = TypeSingleSelectMenuBaseProps & TypeChildrenOrItems;
+type TypeSingleSelectMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeSingleSelectMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/singleselect-menu/
@@ -274,11 +373,11 @@ type TypeSingleSelectMenuProps = TypeSingleSelectMenuBaseProps & TypeChildrenOrI
  * **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: childrenProp, stateReducer: externalStateReducer, items, MenuItemComponent, ...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 TypeMultiSelectMenuBaseProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftSelectProps, "items">, Omit<TypeDownshiftMultiSelectProps, "items"> {
+interface TypeMultiSelectMenuBaseProps extends TypeMenuRootOwnProps, TypeDownshiftSelectProps, TypeDownshiftMultiSelectProps {
 }
-type TypeMultiSelectMenuProps = TypeMultiSelectMenuBaseProps & TypeChildrenOrItems;
+type TypeMultiSelectMenuProps<I extends TypeMenuItemProps = TypeMenuItemProps> = TypeMultiSelectMenuBaseProps & TypeChildrenOrItems<I>;
 
 /**
  * @link https://seeds.sproutsocial.com/components/multiselect-menu/
@@ -287,56 +386,140 @@ type TypeMultiSelectMenuProps = TypeMultiSelectMenuBaseProps & TypeChildrenOrIte
  *
  * @see {@link https://seeds.sproutsocial.com/components/menu-group/ | MenuGroup}
  */
-declare const MultiSelectMenu: ({ children: childrenProp, items, MenuItemComponent, 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 TypeAutocompleteBaseProps extends TypeMenuRootOwnProps, Omit<TypeDownshiftComboboxProps, "items"> {
-    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">;
 }
-type TypeAutocompleteProps = TypeAutocompleteBaseProps & TypeChildrenOrItems;
+
+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;
+    __MENU_PRIMITIVE_TYPE: string;
+};
+
+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: childrenProp, stateReducer: externalStateReducer, items: itemsProp, MenuItemComponent, 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 TypeUseMenuChildrenProps {
-    children?: ReactNode;
-    items?: TypeMenuItemProps[];
-    MenuItemComponent?: React__default.ComponentType<TypeMenuItemProps>;
+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;
+}
+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;
+    __MENU_PRIMITIVE_TYPE: string;
+};
+
+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;
+    __MENU_PRIMITIVE_TYPE: string;
+};
+
+interface TypeNestedMenuContext {
+    selectedMenuPath: string[];
+    setSelectedMenuId?: (id: string) => void;
+    setSelectedMenuPath?: (path: string[]) => void;
+    goBack?: () => void;
 }
-interface TypeMapMenuItemsProps {
-    items: TypeMenuItemProps[];
-    MenuItemComponent: React__default.ComponentType<TypeMenuItemProps>;
+interface TypeNestedMenuProviderProps extends TypeNestedMenuContext {
+    children: TypeNotEmptyChildren;
 }
-type TypeItemElement = React__default.ReactElement<TypeMenuItemProps>;
-type TypeMenuGroupElement = React__default.ReactElement<TypeMenuGroupProps>;
-type TypeMenuContentElement = React__default.ReactElement<TypeMenuContentProps>;
+/**
+ * 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" | "content";
-    element: React__default.ReactElement<TypeMenuGroupProps> | React__default.ReactElement<TypeMenuItemProps> | React__default.ReactElement<TypeMenuContentProps>;
+    element: TypeItemElement | TypeMenuGroupElement | TypeMenuContentElement;
 }
-declare const mapMenuItems: ({ items, MenuItemComponent, }: TypeMapMenuItemsProps) => react_jsx_runtime.JSX.Element;
-declare const useMenuChildren: ({ children: childrenProp, items, MenuItemComponent, }: TypeUseMenuChildrenProps) => {
-    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 TypeChildrenOrItems, type TypeDefaultItemProps, type TypeDownshiftComboboxProps, type TypeDownshiftComboboxReturnValue, type TypeDownshiftMultiSelectProps, type TypeDownshiftMultiSelectReturnValue, type TypeDownshiftSelectProps, type TypeDownshiftSelectReturnValue, type TypeItemElement, type TypeMapMenuItemsProps, type TypeMenuChildren, type TypeMenuContentElement, 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 TypeUseMenuChildrenProps, defaultUseSelectProps, mapMenuItems, useMenu, useMenuChildren, 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 };