@instructure/ui-menu 8.8.0 → 8.8.1-snapshot.63

package/src/Menu/props.ts

@@ -0,0 +1,235 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import PropTypes from 'prop-types'
+
+import { PositionPropTypes } from '@instructure/ui-position'
+import {
+  controllable,
+  Children as ChildrenPropTypes
+} from '@instructure/ui-prop-types'
+
+import type { PropValidators } from '@instructure/shared-types'
+import type { WithStyleProps } from '@instructure/emotion'
+import type {
+  PlacementPropValues,
+  PositionConstraint,
+  PositionMountNode
+} from '@instructure/ui-position'
+
+type MenuOwnProps = {
+  children?: React.ReactNode // TODO: oneOf(['MenuItem', 'MenuItemGroup', 'MenuItemSeparator', 'Menu'])
+  label?: string
+  disabled?: boolean
+  trigger?: React.ReactNode
+  placement?: PlacementPropValues
+  defaultShow?: boolean
+  show?: any // TODO: controllable(PropTypes.bool, 'onToggle', 'defaultShow')
+  onToggle?: (...args: any[]) => any
+  onSelect?: (...args: any[]) => any
+  onDismiss?: (...args: any[]) => any
+  onBlur?: (...args: any[]) => any
+  onFocus?: (...args: any[]) => any
+  onMouseOver?: (...args: any[]) => any
+  onKeyDown?: (...args: any[]) => any
+  onKeyUp?: (...args: any[]) => any
+  menuRef?: (...args: any[]) => any
+  popoverRef?: (...args: any[]) => any
+  mountNode?: PositionMountNode
+  constrain?: PositionConstraint
+  liveRegion?:
+    | React.ReactElement[]
+    | React.ReactElement
+    | ((...args: any[]) => any)
+  shouldHideOnSelect?: boolean
+  shouldFocusTriggerOnClose?: boolean
+  type?: 'flyout'
+  id?: string
+  withArrow?: boolean
+  offsetX?: string | number
+  offsetY?: string | number
+}
+
+type PropKeys = keyof MenuOwnProps
+
+type AllowedPropKeys = Readonly<Array<PropKeys>>
+
+type MenuProps = MenuOwnProps & WithStyleProps
+
+const propTypes: PropValidators<PropKeys> = {
+  /**
+   * Children of type `Menu.Item`, `Menu.Group`, `Menu.Separator`, or `Menu`
+   */
+  children: ChildrenPropTypes.oneOf([
+    'MenuItem',
+    'MenuItemGroup',
+    'MenuItemSeparator',
+    'Menu'
+  ]),
+  /**
+   * Description of the `<Menu />`
+   */
+  label: PropTypes.string,
+  /**
+   * Is the `<Menu />` disabled
+   */
+  disabled: PropTypes.bool,
+  /**
+   * The trigger element, if the `<Menu />` is to render as a popover
+   */
+  trigger: PropTypes.node,
+  /**
+   * If a trigger is supplied, where should the `<Menu />` be placed (relative to the trigger)
+   */
+  placement: PositionPropTypes.placement,
+  /**
+   * Should the `<Menu />` be open for the initial render
+   */
+  defaultShow: PropTypes.bool,
+  /**
+   * Is the `<Menu />` open (should be accompanied by `onToggle`)
+   */
+  show: controllable(PropTypes.bool, 'onToggle', 'defaultShow'),
+  /**
+   * Callback fired when the `<Menu />` is toggled open/closed. When used with `show`,
+   * the component will not control its own state.
+   */
+  onToggle: PropTypes.func,
+  /**
+   * Callback fired when an item within the `<Menu />` is selected
+   */
+  onSelect: PropTypes.func,
+  /**
+   * If a trigger is supplied, callback fired when the `<Menu />` is closed
+   */
+  onDismiss: PropTypes.func,
+  /**
+   * If a trigger is supplied, callback fired when the `<Menu />` trigger is blurred
+   */
+  onBlur: PropTypes.func,
+  /**
+   * If a trigger is supplied, callback fired when the `<Menu />` trigger is focused
+   */
+  onFocus: PropTypes.func,
+  /**
+   * If a trigger is supplied, callback fired onMouseOver for the `<Menu />` trigger
+   */
+  onMouseOver: PropTypes.func,
+  /**
+   * Callback fired on the onKeyDown of the `<Menu />`
+   */
+  onKeyDown: PropTypes.func,
+  /**
+   * Callback fired on the onKeyUp of the `<Menu />`
+   */
+  onKeyUp: PropTypes.func,
+  /**
+   * A function that returns a reference to the `<Menu />`
+   */
+  menuRef: PropTypes.func,
+  /**
+   * A function that returns a reference to the `<Popover />`
+   */
+  popoverRef: PropTypes.func,
+  /**
+   * If a trigger is supplied, an element or a function returning an element to use as the mount node
+   * for the `<Menu />` (defaults to `document.body`)
+   */
+  mountNode: PositionPropTypes.mountNode,
+  /**
+   * The parent in which to constrain the menu.
+   * One of: 'window', 'scroll-parent', 'parent', 'none', an element,
+   * or a function returning an element
+   */
+  constrain: PositionPropTypes.constrain,
+  /**
+   * If a trigger is supplied, an element, function returning an element, or array of elements that will not
+   * be hidden from the screen reader when the `<Menu />` is open
+   */
+  liveRegion: PropTypes.oneOfType([
+    PropTypes.arrayOf(PropTypes.element),
+    PropTypes.element,
+    PropTypes.func
+  ]),
+  /**
+   * If a trigger is supplied, should the `<Menu />` hide when an item is selected
+   */
+  shouldHideOnSelect: PropTypes.bool,
+  /**
+   * If a trigger is supplied, should the `<Menu />` focus the trigger on after closing
+   */
+  shouldFocusTriggerOnClose: PropTypes.bool,
+  /**
+   * The type of `<Menu />`
+   */
+  type: PropTypes.oneOf(['flyout']),
+  id: PropTypes.string,
+  /**
+   * Whether or not an arrow pointing to the trigger should be rendered
+   */
+  withArrow: PropTypes.bool,
+  /**
+   * The horizontal offset for the positioned content.
+   * Works only if `trigger` is provided.
+   */
+  offsetX: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+  /**
+   * The vertical offset for the positioned content.
+   * Works only if `trigger` is provided.
+   */
+  offsetY: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
+}
+
+const allowedProps: AllowedPropKeys = [
+  'children',
+  'label',
+  'disabled',
+  'trigger',
+  'placement',
+  'defaultShow',
+  'show',
+  'onToggle',
+  'onSelect',
+  'onDismiss',
+  'onBlur',
+  'onFocus',
+  'onMouseOver',
+  'onKeyDown',
+  'onKeyUp',
+  'menuRef',
+  'popoverRef',
+  'mountNode',
+  'constrain',
+  'liveRegion',
+  'shouldHideOnSelect',
+  'shouldFocusTriggerOnClose',
+  'type',
+  'id',
+  'withArrow',
+  'offsetX',
+  'offsetY'
+]
+
+export type { MenuProps }
+export { propTypes, allowedProps }

package/src/Menu/theme.ts

@@ -22,7 +22,7 @@
  * SOFTWARE.
  */
 
-import { Theme } from '@instructure/ui-themes'
+import type { Theme } from '@instructure/ui-themes'
 import { MenuTheme } from '@instructure/shared-types'
 
 /**

package/src/index.ts

@@ -23,7 +23,7 @@
  */
 export { Menu, MenuItem, MenuItemGroup, MenuItemSeparator } from './Menu'
 
-export type { MenuProps } from './Menu/types'
-export type { MenuItemProps } from './Menu/MenuItem/types'
-export type { MenuGroupProps } from './Menu/MenuItemGroup/types'
-export type { MenuSeparatorProps } from './Menu/MenuItemSeparator/types'
+export type { MenuProps } from './Menu/props'
+export type { MenuItemProps } from './Menu/MenuItem/props'
+export type { MenuGroupProps } from './Menu/MenuItemGroup/props'
+export type { MenuSeparatorProps } from './Menu/MenuItemSeparator/props'

package/types/Menu/MenuItem/index.d.ts

@@ -1,8 +1,7 @@
 /** @jsx jsx */
 import { Component } from 'react';
-import PropTypes from 'prop-types';
 import { jsx } from '@instructure/emotion';
-import { MenuItemProps } from './types';
+import type { MenuItemProps } from './props';
 /**
 ---
 parent: Menu
@@ -11,49 +10,42 @@ id: Menu.Item
 **/
 declare class MenuItem extends Component<MenuItemProps> {
     static readonly componentId = "Menu.Item";
-    static propTypes: {
-        makeStyles: PropTypes.Requireable<(...args: any[]) => any>;
-        styles: PropTypes.Requireable<object>;
-        children: PropTypes.Validator<string | number | boolean | {} | PropTypes.ReactElementLike | PropTypes.ReactNodeArray>;
-        defaultSelected: PropTypes.Requireable<boolean>;
-        /**
-         * whether the menu item is selected or not (must be accompanied by an `onSelect` prop)
-         */
-        selected: (props: Record<string, any>, propName: string, componentName: string) => Error | null;
-        /**
-         * when used with the `selected` prop, the component will not control its own state
-         */
-        onSelect: PropTypes.Requireable<(...args: any[]) => any>;
-        onClick: PropTypes.Requireable<(...args: any[]) => any>;
-        onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
-        onKeyUp: PropTypes.Requireable<(...args: any[]) => any>;
-        onMouseOver: PropTypes.Requireable<(...args: any[]) => any>;
-        /**
-         * the id of the element that the menu item will act upon
-         */
-        controls: PropTypes.Requireable<string>;
-        disabled: PropTypes.Requireable<boolean>;
-        /**
-         * the element type to render as (will default to `<a>` if href is provided)
-         */
-        as: PropTypes.Requireable<PropTypes.ReactComponentLike>;
-        type: PropTypes.Requireable<string>;
-        value: PropTypes.Requireable<string | number>;
-        href: PropTypes.Requireable<string>;
-    };
+    static propTypes: import("@instructure/shared-types/types/UtilityTypes").PropValidators<keyof {
+        children: import("react").ReactNode;
+        defaultSelected?: boolean | undefined;
+        selected?: any;
+        onSelect?: ((...args: any[]) => any) | undefined;
+        onClick?: ((...args: any[]) => any) | undefined;
+        onKeyDown?: ((...args: any[]) => any) | undefined;
+        onKeyUp?: ((...args: any[]) => any) | undefined;
+        onMouseOver?: ((...args: any[]) => any) | undefined;
+        controls?: string | undefined;
+        disabled?: boolean | undefined;
+        as?: import("@instructure/shared-types/types/CommonProps").AsElementType | undefined;
+        type?: "button" | "checkbox" | "radio" | "flyout" | undefined;
+        value?: string | number | undefined;
+        href?: string | undefined;
+    }>;
+    static allowedProps: readonly (keyof {
+        children: import("react").ReactNode;
+        defaultSelected?: boolean | undefined;
+        selected?: any;
+        onSelect?: ((...args: any[]) => any) | undefined;
+        onClick?: ((...args: any[]) => any) | undefined;
+        onKeyDown?: ((...args: any[]) => any) | undefined;
+        onKeyUp?: ((...args: any[]) => any) | undefined;
+        onMouseOver?: ((...args: any[]) => any) | undefined;
+        controls?: string | undefined;
+        disabled?: boolean | undefined;
+        as?: import("@instructure/shared-types/types/CommonProps").AsElementType | undefined;
+        type?: "button" | "checkbox" | "radio" | "flyout" | undefined;
+        value?: string | number | undefined;
+        href?: string | undefined;
+    })[];
     static defaultProps: {
-        type: string;
-        disabled: boolean;
-        onSelect: (e: any, value: any, selected: any, item: any) => void;
-        defaultSelected: undefined;
-        selected: undefined;
-        onClick: undefined;
-        onKeyDown: undefined;
-        onKeyUp: undefined;
-        onMouseOver: undefined;
-        controls: undefined;
-        value: undefined;
-        href: undefined;
+        readonly type: "button";
+        readonly disabled: false;
+        readonly onSelect: (e: any, value: any, selected: any, item: any) => void;
     };
     static contextType: import("react").Context<{
         registerMenuItem: () => void;
@@ -67,7 +59,7 @@ declare class MenuItem extends Component<MenuItemProps> {
     handleKeyDown: (e: any) => void;
     handleKeyUp: (e: any) => void;
     handleMouseOver: (event: any) => void;
-    get elementType(): any;
+    get elementType(): import("@instructure/shared-types/types/CommonProps").AsElementType;
     get role(): "button" | "menuitemcheckbox" | "menuitemradio" | "menuitem";
     get selected(): any;
     get focused(): boolean;

package/types/Menu/MenuItem/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/index.tsx"],"names":[],"mappings":"AAuBA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,SAAS,MAAM,YAAY,CAAA;AAUlC,OAAO,EAAa,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvC;;;;;GAKG;AACH,cAEM,QAAS,SAAQ,SAAS,CAAC,aAAa,CAAC;IAC7C,MAAM,CAAC,QAAQ,CAAC,WAAW,eAAc;IAEzC,MAAM,CAAC,SAAS;;;;;QASd;;WAEG;;QAEH;;WAEG;;;;;;QAMH;;WAEG;;;QAGH;;WAEG;;;;;MAKJ;IAED,MAAM,CAAC,YAAY;;;;;;;;;;;;;MAclB;IAED,MAAM,CAAC,WAAW;;;OAAc;gBAGpB,KAAK,KAAA;IAcjB,iBAAiB;IAUjB,kBAAkB;IAKlB,oBAAoB;IASpB,WAAW,mBAqBV;IAGD,aAAa,mBAcZ;IAGD,WAAW,mBAaV;IAGD,eAAe,uBAMd;IAED,IAAI,WAAW,QAEd;IAED,IAAI,IAAI,iEAWP;IAED,IAAI,QAAQ,QAKX;IAED,IAAI,OAAO,YAGV;IAED,KAAK;IAKL,aAAa;IAuBb,MAAM;CAsCP;AAED,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/index.tsx"],"names":[],"mappings":"AAuBA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AASjC,OAAO,EAAa,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAQrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;;GAKG;AACH,cAEM,QAAS,SAAQ,SAAS,CAAC,aAAa,CAAC;IAC7C,MAAM,CAAC,QAAQ,CAAC,WAAW,eAAc;IAEzC,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;OAAY;IAC5B,MAAM,CAAC,YAAY;;;;;;;;;;;;;;;SAAe;IAClC,MAAM,CAAC,YAAY;;;;MAKT;IAEV,MAAM,CAAC,WAAW;;;OAAc;gBAGpB,KAAK,KAAA;IAcjB,iBAAiB;IAUjB,kBAAkB;IAKlB,oBAAoB;IASpB,WAAW,mBAqBV;IAGD,aAAa,mBAcZ;IAGD,WAAW,mBAaV;IAGD,eAAe,uBAMd;IAED,IAAI,WAAW,wEAEd;IAED,IAAI,IAAI,iEAWP;IAED,IAAI,QAAQ,QAKX;IAED,IAAI,OAAO,YAGV;IAED,KAAK;IAKL,aAAa;IAuBb,MAAM;CAsCP;AAED,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/types/Menu/MenuItem/props.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { AsElementType, PropValidators } from '@instructure/shared-types';
+import type { WithStyleProps } from '@instructure/emotion';
+declare type MenuItemOwnProps = {
+    children: React.ReactNode;
+    defaultSelected?: boolean;
+    selected?: any;
+    onSelect?: (...args: any[]) => any;
+    onClick?: (...args: any[]) => any;
+    onKeyDown?: (...args: any[]) => any;
+    onKeyUp?: (...args: any[]) => any;
+    onMouseOver?: (...args: any[]) => any;
+    controls?: string;
+    disabled?: boolean;
+    as?: AsElementType;
+    type?: 'button' | 'checkbox' | 'radio' | 'flyout';
+    value?: string | number;
+    href?: string;
+};
+declare type PropKeys = keyof MenuItemOwnProps;
+declare type AllowedPropKeys = Readonly<Array<PropKeys>>;
+declare type MenuItemProps = MenuItemOwnProps & WithStyleProps;
+declare const propTypes: PropValidators<PropKeys>;
+declare const allowedProps: AllowedPropKeys;
+export type { MenuItemProps };
+export { propTypes, allowedProps };
+//# sourceMappingURL=props.d.ts.map

package/types/Menu/MenuItem/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,aAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IAClC,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACjC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACnC,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACjC,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,aAAK,QAAQ,GAAG,MAAM,gBAAgB,CAAA;AAEtC,aAAK,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEhD,aAAK,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAA;AAEtD,QAAA,MAAM,SAAS,EAAE,cAAc,CAAC,QAAQ,CAiCvC,CAAA;AAED,QAAA,MAAM,YAAY,EAAE,eAenB,CAAA;AAED,YAAY,EAAE,aAAa,EAAE,CAAA;AAC7B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA"}

package/types/Menu/MenuItem/styles.d.ts

@@ -1,5 +1,5 @@
 import { MenuItemTheme } from '@instructure/shared-types';
-import { MenuItemProps } from './types';
+import { MenuItemProps } from './props';
 /**
  * ---
  * private: true

package/types/Menu/MenuItem/theme.d.ts

@@ -1,5 +1,5 @@
 import { MenuItemTheme } from '@instructure/shared-types';
-import { Theme } from '@instructure/ui-themes';
+import type { Theme } from '@instructure/ui-themes';
 /**
  * Generates the theme object for the component from the theme and provided additional information
  * @param  {Object} theme The actual theme object.

package/types/Menu/MenuItem/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/theme.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,KAAK,EAAsB,MAAM,wBAAwB,CAAA;AAElE;;;;GAIG;AACH,QAAA,MAAM,sBAAsB,UAAW,KAAK,KAAG,aAmC9C,CAAA;AAED,eAAe,sBAAsB,CAAA"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/theme.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAsB,MAAM,wBAAwB,CAAA;AAEvE;;;;GAIG;AACH,QAAA,MAAM,sBAAsB,UAAW,KAAK,KAAG,aAmC9C,CAAA;AAED,eAAe,sBAAsB,CAAA"}

package/types/Menu/MenuItemGroup/index.d.ts

@@ -1,8 +1,7 @@
 /** @jsx jsx */
 import { Component } from 'react';
-import PropTypes from 'prop-types';
 import { jsx } from '@instructure/emotion';
-import { MenuGroupProps } from './types';
+import type { MenuGroupProps } from './props';
 /**
 ---
 parent: Menu
@@ -11,52 +10,36 @@ id: Menu.Group
 **/
 declare class MenuItemGroup extends Component<MenuGroupProps> {
     static readonly componentId = "Menu.Group";
-    static propTypes: {
-        makeStyles: PropTypes.Requireable<(...args: any[]) => any>;
-        styles: PropTypes.Requireable<object>;
-        label: PropTypes.Validator<string | number | boolean | {} | PropTypes.ReactElementLike | PropTypes.ReactNodeArray>;
-        allowMultiple: PropTypes.Requireable<boolean>;
-        /**
-         * children of type `Menu.Item`, `Menu.Separator`
-         */
-        children: {
-            (props: Record<string, any>, propName: string, componentName: string): Error | null;
-            isRequired: (props: Record<string, any>, propName: string, componentName: string, location?: string | undefined, propFullName?: string | undefined) => Error | null;
-        };
-        /**
-         * an array of the values (or indices by default) for the selected items
-         */
-        selected: (props: Record<string, any>, propName: string, componentName: string) => Error | null;
-        /**
-         * an array of the values (or indices by default) for the selected items on initial render
-         */
-        defaultSelected: PropTypes.Requireable<any[]>;
-        /**
-         * call this function when a menu item is selected
-         */
-        onSelect: PropTypes.Requireable<(...args: any[]) => any>;
-        onMouseOver: PropTypes.Requireable<(...args: any[]) => any>;
-        onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
-        /**
-         * the id of the element that the menu items will act upon
-         */
-        controls: PropTypes.Requireable<string>;
-        /**
-         * returns a reference to the `MenuItem`
-         */
-        itemRef: PropTypes.Requireable<(...args: any[]) => any>;
-        disabled: PropTypes.Requireable<boolean>;
-        /**
-         * should the group appear in the tab order (the first item will have a tabIndex of 0)
-         */
-        isTabbable: PropTypes.Requireable<boolean>;
-    };
+    static propTypes: import("@instructure/shared-types/types/UtilityTypes").PropValidators<keyof {
+        label: import("react").ReactNode;
+        allowMultiple?: boolean | undefined;
+        children?: import("react").ReactNode;
+        selected?: any;
+        defaultSelected?: any[] | undefined;
+        onSelect?: ((...args: any[]) => any) | undefined;
+        onMouseOver?: ((...args: any[]) => any) | undefined;
+        onKeyDown?: ((...args: any[]) => any) | undefined;
+        controls?: string | undefined;
+        itemRef?: ((...args: any[]) => any) | undefined;
+        disabled?: boolean | undefined;
+        isTabbable?: boolean | undefined;
+    }>;
+    static allowedProps: readonly (keyof {
+        label: import("react").ReactNode;
+        allowMultiple?: boolean | undefined;
+        children?: import("react").ReactNode;
+        selected?: any;
+        defaultSelected?: any[] | undefined;
+        onSelect?: ((...args: any[]) => any) | undefined;
+        onMouseOver?: ((...args: any[]) => any) | undefined;
+        onKeyDown?: ((...args: any[]) => any) | undefined;
+        controls?: string | undefined;
+        itemRef?: ((...args: any[]) => any) | undefined;
+        disabled?: boolean | undefined;
+        isTabbable?: boolean | undefined;
+    })[];
     static defaultProps: {
-        onMouseOver: undefined;
         disabled: boolean;
-        controls: undefined;
-        onKeyDown: undefined;
-        selected: undefined;
         children: null;
         isTabbable: boolean;
         allowMultiple: boolean;