@instructure/ui-menu 8.13.1-snapshot.9 → 8.14.0

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

@@ -22,25 +22,15 @@ export declare const MenuItemLocator: {
         toString: (maxLength?: number | undefined, options?: {
             highlight: boolean;
         } | undefined) => string;
-        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
-        children: (selector: string) => Element[];
-        title: () => string | null | undefined;
-        id: () => string;
-        tagName: () => string;
-        getAttribute: (qualifiedName: string) => string | null;
-        getBoundingClientRect: () => DOMRect;
-        matches: (selector: string | undefined) => boolean;
         visible: () => boolean;
-        value: () => string | null;
-        disabled: () => string | null;
-        role: () => string | null;
-        label: () => string | null | undefined;
         getId: () => string;
         getOwnerWindow: () => (Window & typeof globalThis) | null;
         getOwnerDocument: () => Document;
         getComputedStyle: () => CSSStyleDeclaration;
         getTagName: () => string;
+        tagName: () => string;
         typeIn: (text: string) => Promise<void>;
+        getAttribute: (qualifiedName: string) => string | null;
         getDOMNode: () => Element;
         node: () => Element;
         debug: (maxLength?: number | undefined, options?: {
@@ -50,6 +40,7 @@ export declare const MenuItemLocator: {
         getTextContent: () => string | null;
         getParentNode: () => ParentNode | null;
         parent: () => ParentNode | null;
+        getBoundingClientRect: () => DOMRect;
         rect: () => DOMRect;
         hasClass: (classname: string) => boolean;
         containsFocus: () => boolean;
@@ -61,17 +52,25 @@ export declare const MenuItemLocator: {
         exists: () => boolean;
         text: () => string | null;
         empty: () => boolean;
+        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
         descendants: (selector: string) => Element[];
         ancestors: (selector: string) => ParentNode[];
         attribute: (qualifiedName: string) => string | null;
         style: (property: string) => string;
         classNames: () => string[];
+        id: () => string;
+        matches: (selector: string | undefined) => boolean;
         checked: () => any;
         selected: () => any;
+        disabled: () => string | null;
         readonly: () => any;
+        role: () => string | null;
+        value: () => string | null;
+        label: () => string | null | undefined;
+        title: () => string | null | undefined;
+        children: (selector: string) => Element[];
         parents: (selector: string) => ParentNode[];
     } & {
-        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         copy: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         cut: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         paste: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -109,6 +108,7 @@ export declare const MenuItemLocator: {
         touchEnd: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchMove: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchStart: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
+        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         wheel: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         abort: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         canPlay: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -161,25 +161,15 @@ export declare const MenuItemLocator: {
         toString: (maxLength?: number | undefined, options?: {
             highlight: boolean;
         } | undefined) => string;
-        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
-        children: (selector: string) => Element[];
-        title: () => string | null | undefined;
-        id: () => string;
-        tagName: () => string;
-        getAttribute: (qualifiedName: string) => string | null;
-        getBoundingClientRect: () => DOMRect;
-        matches: (selector: string | undefined) => boolean;
         visible: () => boolean;
-        value: () => string | null;
-        disabled: () => string | null;
-        role: () => string | null;
-        label: () => string | null | undefined;
         getId: () => string;
         getOwnerWindow: () => (Window & typeof globalThis) | null;
         getOwnerDocument: () => Document;
         getComputedStyle: () => CSSStyleDeclaration;
         getTagName: () => string;
+        tagName: () => string;
         typeIn: (text: string) => Promise<void>;
+        getAttribute: (qualifiedName: string) => string | null;
         getDOMNode: () => Element;
         node: () => Element;
         debug: (maxLength?: number | undefined, options?: {
@@ -189,6 +179,7 @@ export declare const MenuItemLocator: {
         getTextContent: () => string | null;
         getParentNode: () => ParentNode | null;
         parent: () => ParentNode | null;
+        getBoundingClientRect: () => DOMRect;
         rect: () => DOMRect;
         hasClass: (classname: string) => boolean;
         containsFocus: () => boolean;
@@ -200,17 +191,25 @@ export declare const MenuItemLocator: {
         exists: () => boolean;
         text: () => string | null;
         empty: () => boolean;
+        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
         descendants: (selector: string) => Element[];
         ancestors: (selector: string) => ParentNode[];
         attribute: (qualifiedName: string) => string | null;
         style: (property: string) => string;
         classNames: () => string[];
+        id: () => string;
+        matches: (selector: string | undefined) => boolean;
         checked: () => any;
         selected: () => any;
+        disabled: () => string | null;
         readonly: () => any;
+        role: () => string | null;
+        value: () => string | null;
+        label: () => string | null | undefined;
+        title: () => string | null | undefined;
+        children: (selector: string) => Element[];
         parents: (selector: string) => ParentNode[];
     } & {
-        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         copy: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         cut: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         paste: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -248,6 +247,7 @@ export declare const MenuItemLocator: {
         touchEnd: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchMove: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchStart: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
+        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         wheel: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         abort: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         canPlay: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -300,25 +300,15 @@ export declare const MenuItemLocator: {
         toString: (maxLength?: number | undefined, options?: {
             highlight: boolean;
         } | undefined) => string;
-        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
-        children: (selector: string) => Element[];
-        title: () => string | null | undefined;
-        id: () => string;
-        tagName: () => string;
-        getAttribute: (qualifiedName: string) => string | null;
-        getBoundingClientRect: () => DOMRect;
-        matches: (selector: string | undefined) => boolean;
         visible: () => boolean;
-        value: () => string | null;
-        disabled: () => string | null;
-        role: () => string | null;
-        label: () => string | null | undefined;
         getId: () => string;
         getOwnerWindow: () => (Window & typeof globalThis) | null;
         getOwnerDocument: () => Document;
         getComputedStyle: () => CSSStyleDeclaration;
         getTagName: () => string;
+        tagName: () => string;
         typeIn: (text: string) => Promise<void>;
+        getAttribute: (qualifiedName: string) => string | null;
         getDOMNode: () => Element;
         node: () => Element;
         debug: (maxLength?: number | undefined, options?: {
@@ -328,6 +318,7 @@ export declare const MenuItemLocator: {
         getTextContent: () => string | null;
         getParentNode: () => ParentNode | null;
         parent: () => ParentNode | null;
+        getBoundingClientRect: () => DOMRect;
         rect: () => DOMRect;
         hasClass: (classname: string) => boolean;
         containsFocus: () => boolean;
@@ -339,17 +330,25 @@ export declare const MenuItemLocator: {
         exists: () => boolean;
         text: () => string | null;
         empty: () => boolean;
+        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
         descendants: (selector: string) => Element[];
         ancestors: (selector: string) => ParentNode[];
         attribute: (qualifiedName: string) => string | null;
         style: (property: string) => string;
         classNames: () => string[];
+        id: () => string;
+        matches: (selector: string | undefined) => boolean;
         checked: () => any;
         selected: () => any;
+        disabled: () => string | null;
         readonly: () => any;
+        role: () => string | null;
+        value: () => string | null;
+        label: () => string | null | undefined;
+        title: () => string | null | undefined;
+        children: (selector: string) => Element[];
         parents: (selector: string) => ParentNode[];
     } & {
-        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         copy: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         cut: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         paste: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -387,6 +386,7 @@ export declare const MenuItemLocator: {
         touchEnd: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchMove: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchStart: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
+        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         wheel: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         abort: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         canPlay: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -439,25 +439,15 @@ export declare const MenuItemLocator: {
         toString: (maxLength?: number | undefined, options?: {
             highlight: boolean;
         } | undefined) => string;
-        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
-        children: (selector: string) => Element[];
-        title: () => string | null | undefined;
-        id: () => string;
-        tagName: () => string;
-        getAttribute: (qualifiedName: string) => string | null;
-        getBoundingClientRect: () => DOMRect;
-        matches: (selector: string | undefined) => boolean;
         visible: () => boolean;
-        value: () => string | null;
-        disabled: () => string | null;
-        role: () => string | null;
-        label: () => string | null | undefined;
         getId: () => string;
         getOwnerWindow: () => (Window & typeof globalThis) | null;
         getOwnerDocument: () => Document;
         getComputedStyle: () => CSSStyleDeclaration;
         getTagName: () => string;
+        tagName: () => string;
         typeIn: (text: string) => Promise<void>;
+        getAttribute: (qualifiedName: string) => string | null;
         getDOMNode: () => Element;
         node: () => Element;
         debug: (maxLength?: number | undefined, options?: {
@@ -467,6 +457,7 @@ export declare const MenuItemLocator: {
         getTextContent: () => string | null;
         getParentNode: () => ParentNode | null;
         parent: () => ParentNode | null;
+        getBoundingClientRect: () => DOMRect;
         rect: () => DOMRect;
         hasClass: (classname: string) => boolean;
         containsFocus: () => boolean;
@@ -478,17 +469,25 @@ export declare const MenuItemLocator: {
         exists: () => boolean;
         text: () => string | null;
         empty: () => boolean;
+        contains: (elementOrSelector?: string | Element | undefined) => boolean | Element;
         descendants: (selector: string) => Element[];
         ancestors: (selector: string) => ParentNode[];
         attribute: (qualifiedName: string) => string | null;
         style: (property: string) => string;
         classNames: () => string[];
+        id: () => string;
+        matches: (selector: string | undefined) => boolean;
         checked: () => any;
         selected: () => any;
+        disabled: () => string | null;
         readonly: () => any;
+        role: () => string | null;
+        value: () => string | null;
+        label: () => string | null | undefined;
+        title: () => string | null | undefined;
+        children: (selector: string) => Element[];
         parents: (selector: string) => ParentNode[];
     } & {
-        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         copy: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         cut: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         paste: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
@@ -526,6 +525,7 @@ export declare const MenuItemLocator: {
         touchEnd: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchMove: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         touchStart: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
+        scroll: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         wheel: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         abort: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;
         canPlay: (init?: import("@instructure/ui-test-queries/src/utils/events").FireEventInit | undefined, options?: Record<string, unknown> | undefined) => Promise<Event>;

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

@@ -1,24 +1,25 @@
 /** @jsx jsx */
 import { Component } from 'react';
 import { jsx } from '@instructure/emotion';
-import type { MenuItemProps } from './props';
+import type { MenuItemProps, MenuItemState } from './props';
 /**
 ---
 parent: Menu
 id: Menu.Item
 ---
+@tsProps
 **/
-declare class MenuItem extends Component<MenuItemProps> {
+declare class MenuItem extends Component<MenuItemProps, MenuItemState> {
     static readonly componentId = "Menu.Item";
     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;
+        selected?: boolean | undefined;
+        onSelect?: import("./props").OnMenuItemSelect | undefined;
+        onClick?: ((e: import("react").MouseEvent<Element, MouseEvent>) => void) | undefined;
+        onKeyDown?: ((e: import("react").KeyboardEvent<Element>) => void) | undefined;
+        onKeyUp?: ((e: import("react").KeyboardEvent<Element>) => void) | undefined;
+        onMouseOver?: ((e: import("react").MouseEvent<Element, MouseEvent>, args: MenuItem) => void) | undefined;
         controls?: string | undefined;
         disabled?: boolean | undefined;
         as?: import("@instructure/shared-types/types/CommonProps").AsElementType | undefined;
@@ -29,12 +30,12 @@ declare class MenuItem extends Component<MenuItemProps> {
     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;
+        selected?: boolean | undefined;
+        onSelect?: import("./props").OnMenuItemSelect | undefined;
+        onClick?: ((e: import("react").MouseEvent<Element, MouseEvent>) => void) | undefined;
+        onKeyDown?: ((e: import("react").KeyboardEvent<Element>) => void) | undefined;
+        onKeyUp?: ((e: import("react").KeyboardEvent<Element>) => void) | undefined;
+        onMouseOver?: ((e: import("react").MouseEvent<Element, MouseEvent>, args: MenuItem) => void) | undefined;
         controls?: string | undefined;
         disabled?: boolean | undefined;
         as?: import("@instructure/shared-types/types/CommonProps").AsElementType | undefined;
@@ -45,26 +46,26 @@ declare class MenuItem extends Component<MenuItemProps> {
     static defaultProps: {
         readonly type: "button";
         readonly disabled: false;
-        readonly onSelect: (e: any, value: any, selected: any, item: any) => void;
     };
     static contextType: import("react").Context<{
-        registerMenuItem: () => void;
-        removeMenuItem: () => void;
+        registerMenuItem: (_value: MenuItem) => void;
+        removeMenuItem: (_value: MenuItem) => void;
     }>;
-    constructor(props: any);
+    constructor(props: MenuItemProps);
     get _node(): Element | null;
+    labelId: string;
     ref: Element | null;
     handleRef: (el: Element | null) => void;
     componentDidMount(): void;
     componentDidUpdate(): void;
     componentWillUnmount(): void;
-    handleClick: (e: any) => void;
-    handleKeyDown: (e: any) => void;
-    handleKeyUp: (e: any) => void;
-    handleMouseOver: (event: any) => void;
+    handleClick: (e: React.MouseEvent) => void;
+    handleKeyDown: (e: React.KeyboardEvent) => void;
+    handleKeyUp: (e: React.KeyboardEvent) => void;
+    handleMouseOver: (event: React.MouseEvent) => void;
     get elementType(): import("@instructure/shared-types/types/CommonProps").AsElementType;
     get role(): "button" | "menuitem" | "menuitemcheckbox" | "menuitemradio";
-    get selected(): any;
+    get selected(): boolean;
     get focused(): boolean;
     focus(): void;
     renderContent(): jsx.JSX.Element;

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;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,IAAI,KAAK,mBAMR;IACD,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAC1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAE9B;IAED,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,YAEV;IAED,KAAK;IAKL,aAAa;IAuBb,MAAM;CAmCP;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,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;GAMG;AACH,cAEM,QAAS,SAAQ,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,WAAW,eAAc;IAEzC,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;OAAY;IAC5B,MAAM,CAAC,YAAY;;;;;;;;;;;;;;;SAAe;IAClC,MAAM,CAAC,YAAY;;;MAGT;IAEV,MAAM,CAAC,WAAW;;;OAAc;gBAEpB,KAAK,EAAE,aAAa;IAYhC,IAAI,KAAK,mBAMR;IAED,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,GAAG,IAAI,CAAO;IAE1B,SAAS,OAAQ,OAAO,GAAG,IAAI,UAE9B;IAED,iBAAiB;IASjB,kBAAkB;IAIlB,oBAAoB;IAQpB,WAAW,MAAO,gBAAgB,UAqBjC;IAED,aAAa,MAAO,mBAAmB,UActC;IAED,WAAW,MAAO,mBAAmB,UAapC;IAED,eAAe,UAAW,gBAAgB,UAMzC;IAED,IAAI,WAAW,wEAEd;IAED,IAAI,IAAI,iEAWP;IAED,IAAI,QAAQ,YAIX;IAED,IAAI,OAAO,YAEV;IAED,KAAK;IAKL,aAAa;IAsBb,MAAM;CAkCP;AAED,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAA"}

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

@@ -1,17 +1,37 @@
 import React from 'react';
+import MenuItem from '../MenuItem';
 import type { AsElementType, PropValidators, MenuItemTheme, OtherHTMLAttributes } from '@instructure/shared-types';
 import type { WithStyleProps, ComponentStyle } from '@instructure/emotion';
+declare type OnMenuItemSelect = (e: React.MouseEvent, value: MenuItemOwnProps['value'], selected: MenuItemOwnProps['selected'], args: MenuItem) => void;
 declare type MenuItemOwnProps = {
+    /**
+     * the menu item label
+     */
     children: React.ReactNode;
+    /**
+     * whether to set the menu item state to selected or not on initial render
+     */
     defaultSelected?: boolean;
-    selected?: any;
-    onSelect?: (...args: any[]) => any;
-    onClick?: (...args: any[]) => any;
-    onKeyDown?: (...args: any[]) => any;
-    onKeyUp?: (...args: any[]) => any;
-    onMouseOver?: (...args: any[]) => any;
+    /**
+     * whether the menu item is selected or not (must be accompanied by an `onSelect` prop)
+     */
+    selected?: boolean;
+    /**
+     * when used with the `selected` prop, the component will not control its own state
+     */
+    onSelect?: OnMenuItemSelect;
+    onClick?: (e: React.MouseEvent) => void;
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+    onKeyUp?: (e: React.KeyboardEvent) => void;
+    onMouseOver?: (e: React.MouseEvent, args: MenuItem) => void;
+    /**
+     * the id of the element that the menu item will act upon
+     */
     controls?: string;
     disabled?: boolean;
+    /**
+     * the element type to render as (will default to `<a>` if href is provided)
+     */
     as?: AsElementType;
     type?: 'button' | 'checkbox' | 'radio' | 'flyout';
     value?: string | number;
@@ -23,6 +43,9 @@ declare type MenuItemProps = MenuItemOwnProps & WithStyleProps<MenuItemTheme, Me
 declare type MenuItemStyle = ComponentStyle<'menuItem' | 'icon' | 'label'>;
 declare const propTypes: PropValidators<PropKeys>;
 declare const allowedProps: AllowedPropKeys;
-export type { MenuItemProps, MenuItemStyle };
+declare type MenuItemState = {
+    selected: boolean;
+};
+export type { MenuItemProps, MenuItemStyle, MenuItemState, OnMenuItemSelect };
 export { propTypes, allowedProps };
 //# sourceMappingURL=props.d.ts.map

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

@@ -1 +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,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1E,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,GACnC,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,GAC5C,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;AAEvC,aAAK,aAAa,GAAG,cAAc,CAAC,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAElE,QAAA,MAAM,SAAS,EAAE,cAAc,CAAC,QAAQ,CAiCvC,CAAA;AAED,QAAA,MAAM,YAAY,EAAE,eAenB,CAAA;AAED,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/Menu/MenuItem/props.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,QAAQ,MAAM,aAAa,CAAA;AAGlC,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1E,aAAK,gBAAgB,GAAG,CACtB,CAAC,EAAE,KAAK,CAAC,UAAU,EACnB,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAChC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,IAAI,EAAE,QAAQ,KACX,IAAI,CAAA;AAET,aAAK,gBAAgB,GAAG;IACtB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAA;IACvC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAA;IAC5C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAA;IAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC3D;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,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,GACnC,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,GAC5C,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;AAEvC,aAAK,aAAa,GAAG,cAAc,CAAC,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAElE,QAAA,MAAM,SAAS,EAAE,cAAc,CAAC,QAAQ,CAevC,CAAA;AAED,QAAA,MAAM,YAAY,EAAE,eAenB,CAAA;AACD,aAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AACD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA"}