feat(filterable-multiselect): add onMenuChange event (#7370)

* feat(filterable-multiselect): add onMenuChange event

* feat(filterable-multiselect): fix onMenuChange event

* Update packages/react/src/components/MultiSelect/FilterableMultiSelect.js

Co-authored-by: emyarod <emyarod@users.noreply.github.com>

Co-authored-by: emyarod <emyarod@users.noreply.github.com>
Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

.all-contributorsrc

@@ -628,6 +628,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "munkurious",
+      "name": "Boston Cartwright",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2187109?v=4",
+      "profile": "https://github.com/munkurious",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "commitConvention": "none"

packages/react/__tests__/__snapshots__/PublicAPI-test.js.snap

@@ -3576,6 +3576,9 @@ Map {
         "onChange": Object {
           "type": "func",
         },
+        "onMenuChange": Object {
+          "type": "func",
+        },
         "open": Object {
           "type": "bool",
         },

packages/react/src/components/MultiSelect/FilterableMultiSelect.js

@@ -94,6 +94,12 @@ export default class FilterableMultiSelect extends React.Component {
      */
     onChange: PropTypes.func,
 
+    /**
+     * `onMenuChange` is a utility for this controlled component to communicate to a
+     * consuming component that the menu was opened(`true`)/closed(`false`).
+     */
+    onMenuChange: PropTypes.func,
+
     /**
      * Initialize the component with an open(`true`)/closed(`false`) menu.
      */
@@ -184,15 +190,17 @@ export default class FilterableMultiSelect extends React.Component {
     }
   };
 
-  handleOnToggleMenu = () => {
+  handleOnMenuChange = (isOpen) => {
     this.setState((state) => ({
-      isOpen: !state.isOpen,
+      isOpen: isOpen ?? !state.isOpen,
     }));
+    if (this.props.onMenuChange) {
+      this.props.onMenuChange(isOpen);
+    }
   };
 
   handleOnOuterClick = () => {
     this.setState({
-      isOpen: false,
       inputValue: '',
     });
   };
@@ -211,32 +219,30 @@ export default class FilterableMultiSelect extends React.Component {
       case Downshift.stateChangeTypes.keyDownArrowDown:
         this.setState({
           highlightedIndex: changes.highlightedIndex,
-          isOpen: true,
         });
+        if (!this.state.isOpen) this.handleOnMenuChange(true);
         break;
       case Downshift.stateChangeTypes.keyDownEscape:
       case Downshift.stateChangeTypes.mouseUp:
-        this.setState({ isOpen: false });
+        if (this.state.isOpen) this.handleOnMenuChange(false);
         break;
       // Opt-in to some cases where we should be toggling the menu based on
       // a given key press or mouse handler
       // Reference: https://github.com/paypal/downshift/issues/206
       case Downshift.stateChangeTypes.clickButton:
-      case Downshift.stateChangeTypes.keyDownSpaceButton:
-        this.setState(() => {
-          let nextIsOpen = changes.isOpen || false;
-          if (changes.isOpen === false) {
-            // If Downshift is trying to close the menu, but we know the input
-            // is the active element in thedocument, then keep the menu open
-            if (this.inputNode === document.activeElement) {
-              nextIsOpen = true;
-            }
+      case Downshift.stateChangeTypes.keyDownSpaceButton: {
+        let nextIsOpen = changes.isOpen || false;
+        if (changes.isOpen === false) {
+          // If Downshift is trying to close the menu, but we know the input
+          // is the active element in the document, then keep the menu open
+          if (this.inputNode === document.activeElement) {
+            nextIsOpen = true;
           }
-          return {
-            isOpen: nextIsOpen,
-          };
-        });
+        }
+        if (this.state.isOpen !== nextIsOpen)
+          this.handleOnMenuChange(nextIsOpen);
         break;
+      }
     }
   };
 
@@ -245,7 +251,7 @@ export default class FilterableMultiSelect extends React.Component {
   };
 
   handleOnInputValueChange = (inputValue, { type }) => {
-    if (type === Downshift.stateChangeTypes.changeInput)
+    if (type === Downshift.stateChangeTypes.changeInput) {
       this.setState(() => {
         if (Array.isArray(inputValue)) {
           return {
@@ -254,9 +260,11 @@ export default class FilterableMultiSelect extends React.Component {
         }
         return {
           inputValue: inputValue || '',
-          isOpen: Boolean(inputValue) || this.state.isOpen,
         };
       });
+      if (Boolean(inputValue) !== this.state.isOpen)
+        this.handleOnMenuChange(Boolean(inputValue));
+    }
   };
 
   clearInputValue = (event) => {

packages/react/src/components/MultiSelect/MultiSelect-story.js

@@ -197,6 +197,9 @@ export const _Filterable = withReadme(readme, () => {
         placeholder={defaultPlaceholder}
         translateWithId={(id) => listBoxMenuIconTranslationIds[id]}
         selectionFeedback={selectionFeedback}
+        onMenuChange={(e) => {
+          multiSelectProps.onMenuChange(e);
+        }}
       />
     </div>
   );

packages/react/src/components/MultiSelect/__tests__/FilterableMultiSelect-test.js

@@ -29,6 +29,7 @@ describe('MultiSelect.Filterable', () => {
       items: generateItems(5, generateGenericItem),
       initialSelectedItems: [],
       onChange: jest.fn(),
+      onMenuChange: jest.fn(),
       placeholder: 'Placeholder...',
     };
   });

packages/react/src/components/MultiSelect/__tests__/__snapshots__/FilterableMultiSelect-test.js.snap

@@ -41,6 +41,7 @@ exports[`MultiSelect.Filterable should render 1`] = `
   light={false}
   locale="en"
   onChange={[MockFunction]}
+  onMenuChange={[MockFunction]}
   open={false}
   placeholder="Placeholder..."
   selectionFeedback="top-after-reopen"