@elliemae/ds-menu-button 3.45.0-rc.1 → 3.45.0-rc.3

package/dist/esm/parts/DSMenuItemRendererFactory/react-desc-prop-types.js

@@ -0,0 +1,26 @@
+import * as React from "react";
+import {
+  PropTypes,
+  getPropsPerSlotPropTypes,
+  globalAttributesPropTypes,
+  xstyledPropTypes
+} from "@elliemae/ds-props-helpers";
+import { DSMenuItemRendererFactoryName, MENU_ITEM_RENDERER_FACTORY_SLOTS } from "./constants/index.js";
+const defaultProps = {};
+const DSMenuItemRendererFactoryPropTypes = {
+  ...getPropsPerSlotPropTypes(DSMenuItemRendererFactoryName, MENU_ITEM_RENDERER_FACTORY_SLOTS),
+  ...globalAttributesPropTypes,
+  ...xstyledPropTypes,
+  itemNode: PropTypes.object.description("The polymorphic item to render").isRequired,
+  ItemRenderer: PropTypes.func.description("The custom item renderer"),
+  FlyoutMenuCircularDepInject: PropTypes.func.description(
+    "Flyout menu component, passed to the factory to avoid circular dependency"
+  )
+};
+const DSMenuItemRendererFactoryPropTypesSchema = DSMenuItemRendererFactoryPropTypes;
+export {
+  DSMenuItemRendererFactoryPropTypes,
+  DSMenuItemRendererFactoryPropTypesSchema,
+  defaultProps
+};
+//# sourceMappingURL=react-desc-prop-types.js.map

package/dist/esm/parts/DSMenuItemRendererFactory/react-desc-prop-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/DSMenuItemRendererFactory/react-desc-prop-types.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-empty-interface */\nimport type { GlobalAttributesT, XstyledProps, DSPropTypesSchema, ValidationMap } from '@elliemae/ds-props-helpers';\nimport {\n  PropTypes,\n  getPropsPerSlotPropTypes,\n  globalAttributesPropTypes,\n  xstyledPropTypes,\n} from '@elliemae/ds-props-helpers';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport { DSMenuItemRendererFactoryName, MENU_ITEM_RENDERER_FACTORY_SLOTS } from './constants/index.js';\nimport type { DSMenuButtonT } from '../../react-desc-prop-types.js';\nimport type { DSFlyoutMenuT } from '../DSFlyoutMenu/react-desc-prop-types.js';\n\nexport declare namespace DSMenuItemRendererFactoryT {\n  /*\n   * everything that is specifically added in this namespace declaration and is not part of the original component\n   * is because the original component is an \"opinionated widget\" that offloads a chunk of responsibilities from dev to dimsum\n   * as such, the widget generates those interfaces,\n   *  but the app developer is not supposed to know about them\n   *    untill they go atomic composition (this namespace)\n   */\n  export interface RequiredProps {\n    itemNode: DSMenuButtonT.MenuNode;\n    FlyoutMenuCircularDepInject: React.ComponentType<DSFlyoutMenuT.Props>;\n  }\n\n  export interface DefaultProps {}\n\n  export interface OptionalProps\n    extends TypescriptHelpersT.PropsForGlobalOnSlots<\n      typeof DSMenuItemRendererFactoryName,\n      typeof MENU_ITEM_RENDERER_FACTORY_SLOTS\n    > {\n    ItemRenderer?: DSMenuButtonT.ItemRendererT;\n  }\n  export interface Props\n    extends Partial<DefaultProps>,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLLIElement>, keyof OptionalProps | keyof XstyledProps>,\n      XstyledProps,\n      RequiredProps {}\n\n  export interface InternalProps\n    extends DefaultProps,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLLIElement>, keyof OptionalProps | keyof XstyledProps>,\n      XstyledProps,\n      RequiredProps {}\n}\n\nexport const defaultProps: DSMenuItemRendererFactoryT.DefaultProps = {};\n\nexport const DSMenuItemRendererFactoryPropTypes: DSPropTypesSchema<DSMenuItemRendererFactoryT.Props> = {\n  ...getPropsPerSlotPropTypes(DSMenuItemRendererFactoryName, MENU_ITEM_RENDERER_FACTORY_SLOTS),\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  itemNode: PropTypes.object.description('The polymorphic item to render').isRequired,\n  ItemRenderer: PropTypes.func.description('The custom item renderer'),\n  FlyoutMenuCircularDepInject: PropTypes.func.description(\n    'Flyout menu component, passed to the factory to avoid circular dependency',\n  ),\n};\n\nexport const DSMenuItemRendererFactoryPropTypesSchema =\n  DSMenuItemRendererFactoryPropTypes as unknown as ValidationMap<DSMenuItemRendererFactoryT.Props>;\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,+BAA+B,wCAAwC;AAyCzE,MAAM,eAAwD,CAAC;AAE/D,MAAM,qCAA0F;AAAA,EACrG,GAAG,yBAAyB,+BAA+B,gCAAgC;AAAA,EAC3F,GAAG;AAAA,EACH,GAAG;AAAA,EACH,UAAU,UAAU,OAAO,YAAY,gCAAgC,EAAE;AAAA,EACzE,cAAc,UAAU,KAAK,YAAY,0BAA0B;AAAA,EACnE,6BAA6B,UAAU,KAAK;AAAA,IAC1C;AAAA,EACF;AACF;AAEO,MAAM,2CACX;",
+  "names": []
+}

package/dist/esm/parts/DSMenuItemRendererFactory/useMenuItemHighlightState.js

@@ -0,0 +1,32 @@
+import * as React from "react";
+import React2 from "react";
+const useMenuItemHighlightState = ({
+  focusableItemEl,
+  onMouseLeave,
+  onMouseEnter
+}) => {
+  const isFocused = focusableItemEl === document.activeElement;
+  const [isHovered, setIsHovered] = React2.useState(false);
+  const handleMouseEnter = React2.useCallback(
+    (e) => {
+      setIsHovered(true);
+      onMouseEnter?.(e);
+    },
+    [onMouseEnter]
+  );
+  const handleMouseLeave = React2.useCallback(
+    (e) => {
+      setIsHovered(false);
+      onMouseLeave?.(e);
+    },
+    [onMouseLeave]
+  );
+  return React2.useMemo(
+    () => ({ isFocused, isHovered, handleMouseEnter, handleMouseLeave, shouldHighlight: isFocused || isHovered }),
+    [isFocused, isHovered, handleMouseEnter, handleMouseLeave]
+  );
+};
+export {
+  useMenuItemHighlightState
+};
+//# sourceMappingURL=useMenuItemHighlightState.js.map

package/dist/esm/parts/DSMenuItemRendererFactory/useMenuItemHighlightState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/DSMenuItemRendererFactory/useMenuItemHighlightState.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React from 'react';\nexport const useMenuItemHighlightState = ({\n  focusableItemEl,\n  onMouseLeave,\n  onMouseEnter,\n}: {\n  focusableItemEl: HTMLElement | null;\n  onMouseLeave?: React.MouseEventHandler<HTMLElement>;\n  onMouseEnter?: React.MouseEventHandler<HTMLElement>;\n}) => {\n  const isFocused = focusableItemEl === document.activeElement;\n  const [isHovered, setIsHovered] = React.useState(false);\n  const handleMouseEnter = React.useCallback(\n    (e: React.MouseEvent<HTMLElement>) => {\n      setIsHovered(true);\n      onMouseEnter?.(e);\n    },\n    [onMouseEnter],\n  );\n  const handleMouseLeave = React.useCallback(\n    (e: React.MouseEvent<HTMLElement>) => {\n      setIsHovered(false);\n      onMouseLeave?.(e);\n    },\n    [onMouseLeave],\n  );\n  return React.useMemo(\n    () => ({ isFocused, isHovered, handleMouseEnter, handleMouseLeave, shouldHighlight: isFocused || isHovered }),\n    [isFocused, isHovered, handleMouseEnter, handleMouseLeave],\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,OAAOA,YAAW;AACX,MAAM,4BAA4B,CAAC;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,MAIM;AACJ,QAAM,YAAY,oBAAoB,SAAS;AAC/C,QAAM,CAAC,WAAW,YAAY,IAAIA,OAAM,SAAS,KAAK;AACtD,QAAM,mBAAmBA,OAAM;AAAA,IAC7B,CAAC,MAAqC;AACpC,mBAAa,IAAI;AACjB,qBAAe,CAAC;AAAA,IAClB;AAAA,IACA,CAAC,YAAY;AAAA,EACf;AACA,QAAM,mBAAmBA,OAAM;AAAA,IAC7B,CAAC,MAAqC;AACpC,mBAAa,KAAK;AAClB,qBAAe,CAAC;AAAA,IAClB;AAAA,IACA,CAAC,YAAY;AAAA,EACf;AACA,SAAOA,OAAM;AAAA,IACX,OAAO,EAAE,WAAW,WAAW,kBAAkB,kBAAkB,iBAAiB,aAAa,UAAU;AAAA,IAC3G,CAAC,WAAW,WAAW,kBAAkB,gBAAgB;AAAA,EAC3D;AACF;",
+  "names": ["React"]
+}

package/dist/esm/parts/DSOpinionatedButton/DSOpinionatedButton.js

@@ -0,0 +1,70 @@
+import * as React from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import React2 from "react";
+import { describe } from "@elliemae/ds-props-helpers";
+import { styled } from "@elliemae/ds-system";
+import { DSButtonV3 } from "@elliemae/ds-button-v2";
+import { DSOpinionatedButtonPropTypesSchema } from "./react-desc-prop-types.js";
+import { useOpinionatedButton } from "./config/useOpinionatedButton.js";
+import { OPINIONATED_BUTTON_SLOTS, DSOpinionatedButtonName } from "./constants/index.js";
+import { DSFlyoutMenu } from "../DSFlyoutMenu/index.js";
+import { MenuBehaviouralContextProviderContext } from "../DSMenuBehaviouralContextProvider/MenuBehaviouralContextProviderCTX.js";
+const StyledButton = styled(DSButtonV3, { name: DSOpinionatedButtonName, slot: OPINIONATED_BUTTON_SLOTS.ROOT })``;
+const DSOpinionatedButton = (props) => {
+  const {
+    propsWithDefault: { children, menuSpecificProps, ...restOfTheProps },
+    eventsHandlers: { handleOnClick, handleOnFocus, handleFocusIfTriggerIsFocusRegion, handleTriggerKeyDown },
+    floatingContext
+  } = useOpinionatedButton(props);
+  const {
+    isMenuOpen,
+    propsWithDefault: { optionsTree }
+  } = React2.useContext(MenuBehaviouralContextProviderContext);
+  return (
+    // onClick/onFocus/innerRef/onKeyDown ARE BEING OVERRIDEN ON PURPOSE
+    //  all the functions are being wrapped in a custom logic, they also invoke the original ones
+    /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        StyledButton,
+        {
+          ...restOfTheProps,
+          onClick: handleOnClick,
+          onFocus: handleOnFocus,
+          onKeyDown: handleTriggerKeyDown,
+          innerRef: handleFocusIfTriggerIsFocusRegion,
+          "aria-haspopup": "menu",
+          "aria-controls": (
+            /* ********************************************************************************************************************
+             * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-controls
+             *    The aria-controls only needs to be set when the popup is visible, but it is valid and easier to program to reference an element that is not visible.
+             * ********************************************************************************************************************
+             * ^^^ some automated tools will mark an error if the aria-controls references an element that does (yet) exist in the DOM
+             *  so, while technically valid to not check if expanded, we are doing it to avoid automated tools marking an error
+             * ******************************************************************************************************************** */
+            isMenuOpen ? optionsTree.plainChildren.map((child) => `ds-menu-item-${`${child.dsId}`.replace(/\s/g, "")}`).join(" ") : void 0
+          ),
+          children
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        DSFlyoutMenu,
+        {
+          ...menuSpecificProps,
+          isMenuOpen,
+          floatingContext: floatingContext.context,
+          floatingStyles: floatingContext.floatingStyles,
+          setFloatingRef: floatingContext.refs.setFloating,
+          itemNode: optionsTree
+        }
+      )
+    ] })
+  );
+};
+DSOpinionatedButton.displayName = DSOpinionatedButtonName;
+const DSOpinionatedButtonWithSchema = describe(DSOpinionatedButton);
+DSOpinionatedButtonWithSchema.propTypes = DSOpinionatedButtonPropTypesSchema;
+export {
+  DSOpinionatedButton,
+  DSOpinionatedButtonWithSchema
+};
+//# sourceMappingURL=DSOpinionatedButton.js.map

package/dist/esm/parts/DSOpinionatedButton/DSOpinionatedButton.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/DSOpinionatedButton/DSOpinionatedButton.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { styled } from '@elliemae/ds-system';\nimport { DSButtonV3 } from '@elliemae/ds-button-v2';\nimport { type DSOpinionatedButtonT, DSOpinionatedButtonPropTypesSchema } from './react-desc-prop-types.js';\nimport { useOpinionatedButton } from './config/useOpinionatedButton.js';\nimport { OPINIONATED_BUTTON_SLOTS, DSOpinionatedButtonName } from './constants/index.js';\nimport { DSFlyoutMenu } from '../DSFlyoutMenu/index.js';\nimport { MenuBehaviouralContextProviderContext } from '../DSMenuBehaviouralContextProvider/MenuBehaviouralContextProviderCTX.js';\nimport type { DSMenuButtonT } from '../../react-desc-prop-types.js';\n\nconst StyledButton = styled(DSButtonV3, { name: DSOpinionatedButtonName, slot: OPINIONATED_BUTTON_SLOTS.ROOT })``;\n\nconst DSOpinionatedButton: React.ComponentType<DSOpinionatedButtonT.Props> = (props) => {\n  const {\n    propsWithDefault: { children, menuSpecificProps, ...restOfTheProps },\n    eventsHandlers: { handleOnClick, handleOnFocus, handleFocusIfTriggerIsFocusRegion, handleTriggerKeyDown },\n    floatingContext,\n  } = useOpinionatedButton(props);\n  // this is the state of the global menu, hosted in the global context\n  // each flyout menu instance will have its own state, only this instances is mandated by the global context\n  // that's why flyout menu is reading the info from props and not from the context\n  const {\n    isMenuOpen,\n    propsWithDefault: { optionsTree },\n  } = React.useContext(MenuBehaviouralContextProviderContext);\n\n  return (\n    // onClick/onFocus/innerRef/onKeyDown ARE BEING OVERRIDEN ON PURPOSE\n    //  all the functions are being wrapped in a custom logic, they also invoke the original ones\n    <>\n      <StyledButton\n        {...restOfTheProps}\n        onClick={handleOnClick}\n        onFocus={handleOnFocus}\n        onKeyDown={handleTriggerKeyDown}\n        innerRef={handleFocusIfTriggerIsFocusRegion}\n        aria-haspopup=\"menu\"\n        aria-controls={\n          /* ********************************************************************************************************************\n           * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-controls\n           *    The aria-controls only needs to be set when the popup is visible, but it is valid and easier to program to reference an element that is not visible.\n           * ********************************************************************************************************************\n           * ^^^ some automated tools will mark an error if the aria-controls references an element that does (yet) exist in the DOM\n           *  so, while technically valid to not check if expanded, we are doing it to avoid automated tools marking an error\n           * ******************************************************************************************************************** */\n          isMenuOpen\n            ? optionsTree.plainChildren.map((child) => `ds-menu-item-${`${child.dsId}`.replace(/\\s/g, '')}`).join(' ')\n            : undefined\n        }\n      >\n        {children}\n      </StyledButton>\n      <DSFlyoutMenu\n        {...menuSpecificProps}\n        isMenuOpen={isMenuOpen}\n        floatingContext={floatingContext.context}\n        floatingStyles={floatingContext.floatingStyles}\n        setFloatingRef={floatingContext.refs.setFloating}\n        // DSTree doesn't support the root node having a different type than the children, so we need to cast it manually\n        itemNode={optionsTree as unknown as DSMenuButtonT.MenuNodeRootItem}\n      />\n    </>\n  );\n};\n\nDSOpinionatedButton.displayName = DSOpinionatedButtonName;\nconst DSOpinionatedButtonWithSchema = describe(DSOpinionatedButton);\nDSOpinionatedButtonWithSchema.propTypes = DSOpinionatedButtonPropTypesSchema;\n\nexport { DSOpinionatedButton, DSOpinionatedButtonWithSchema };\n"],
+  "mappings": "AAAA,YAAY,WAAW;AC8BnB,mBACE,KADF;AA9BJ,OAAOA,YAAW;AAClB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,kBAAkB;AAC3B,SAAoC,0CAA0C;AAC9E,SAAS,4BAA4B;AACrC,SAAS,0BAA0B,+BAA+B;AAClE,SAAS,oBAAoB;AAC7B,SAAS,6CAA6C;AAGtD,MAAM,eAAe,OAAO,YAAY,EAAE,MAAM,yBAAyB,MAAM,yBAAyB,KAAK,CAAC;AAE9G,MAAM,sBAAuE,CAAC,UAAU;AACtF,QAAM;AAAA,IACJ,kBAAkB,EAAE,UAAU,mBAAmB,GAAG,eAAe;AAAA,IACnE,gBAAgB,EAAE,eAAe,eAAe,mCAAmC,qBAAqB;AAAA,IACxG;AAAA,EACF,IAAI,qBAAqB,KAAK;AAI9B,QAAM;AAAA,IACJ;AAAA,IACA,kBAAkB,EAAE,YAAY;AAAA,EAClC,IAAIA,OAAM,WAAW,qCAAqC;AAE1D;AAAA;AAAA;AAAA,IAGE,iCACE;AAAA;AAAA,QAAC;AAAA;AAAA,UACE,GAAG;AAAA,UACJ,SAAS;AAAA,UACT,SAAS;AAAA,UACT,WAAW;AAAA,UACX,UAAU;AAAA,UACV,iBAAc;AAAA,UACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAQE,aACI,YAAY,cAAc,IAAI,CAAC,UAAU,gBAAgB,GAAG,MAAM,IAAI,GAAG,QAAQ,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,GAAG,IACvG;AAAA;AAAA,UAGL;AAAA;AAAA,MACH;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACE,GAAG;AAAA,UACJ;AAAA,UACA,iBAAiB,gBAAgB;AAAA,UACjC,gBAAgB,gBAAgB;AAAA,UAChC,gBAAgB,gBAAgB,KAAK;AAAA,UAErC,UAAU;AAAA;AAAA,MACZ;AAAA,OACF;AAAA;AAEJ;AAEA,oBAAoB,cAAc;AAClC,MAAM,gCAAgC,SAAS,mBAAmB;AAClE,8BAA8B,YAAY;",
+  "names": ["React"]
+}

package/dist/esm/parts/DSOpinionatedButton/config/useOpinionatedButton.js

@@ -0,0 +1,53 @@
+import * as React from "react";
+import { useMemoMergePropsWithDefault } from "@elliemae/ds-props-helpers";
+import { useFloatingContext } from "@elliemae/ds-floating-context";
+import React2 from "react";
+import { uid } from "uid";
+import {
+  DSOpinionatedButtonPropTypesSchema,
+  defaultProps
+} from "../react-desc-prop-types.js";
+import { useTriggerEventsHandlers } from "./useTriggerEventsHandlers.js";
+import { useValidateProps } from "./useValidateProps.js";
+const placementOrderPreference = [
+  "bottom-start",
+  "bottom-end",
+  "bottom",
+  "right-start",
+  "right-start",
+  "right",
+  "left-start",
+  "left-end",
+  "left",
+  "top-start",
+  "top-end",
+  "top"
+];
+const useOpinionatedButton = (propsFromUser) => {
+  const propsWithDefault = useMemoMergePropsWithDefault(
+    propsFromUser,
+    defaultProps
+  );
+  useValidateProps(propsWithDefault, DSOpinionatedButtonPropTypesSchema);
+  const instanceUid = React2.useMemo(() => `ds-opinionated-button-${uid(5)}`, []);
+  const floatingContext = useFloatingContext({
+    placement: placementOrderPreference[0],
+    placementOrderPreference,
+    animationDuration: 100,
+    customOffset: [0, 0]
+  });
+  const eventsHandlers = useTriggerEventsHandlers({ propsWithDefault, floatingContext });
+  return React2.useMemo(
+    () => ({
+      propsWithDefault,
+      instanceUid,
+      eventsHandlers,
+      floatingContext
+    }),
+    [propsWithDefault, instanceUid, eventsHandlers, floatingContext]
+  );
+};
+export {
+  useOpinionatedButton
+};
+//# sourceMappingURL=useOpinionatedButton.js.map

package/dist/esm/parts/DSOpinionatedButton/config/useOpinionatedButton.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../scripts/build/transpile/react-shim.js", "../../../../../src/parts/DSOpinionatedButton/config/useOpinionatedButton.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useFloatingContext, type DSHookFloatingContextT } from '@elliemae/ds-floating-context';\nimport React from 'react';\nimport { uid } from 'uid';\nimport {\n  DSOpinionatedButtonPropTypesSchema,\n  defaultProps,\n  type DSOpinionatedButtonT,\n} from '../react-desc-prop-types.js';\nimport { useTriggerEventsHandlers } from './useTriggerEventsHandlers.js';\nimport { useValidateProps } from './useValidateProps.js';\n\nconst placementOrderPreference: Required<DSHookFloatingContextT.Props>['placementOrderPreference'] = [\n  'bottom-start',\n  'bottom-end',\n  'bottom',\n  'right-start',\n  'right-start',\n  'right',\n  'left-start',\n  'left-end',\n  'left',\n  'top-start',\n  'top-end',\n  'top',\n];\n\nexport const useOpinionatedButton = (propsFromUser: DSOpinionatedButtonT.Props) => {\n  // =============================================================================\n  // MERGE WITH DEFAULT AND VALIDATE PROPS\n  // =============================================================================\n  const propsWithDefault = useMemoMergePropsWithDefault<DSOpinionatedButtonT.InternalProps>(\n    propsFromUser,\n    defaultProps,\n  );\n  useValidateProps(propsWithDefault, DSOpinionatedButtonPropTypesSchema);\n  // =============================================================================\n  // XSTYLED PROPS\n  // =============================================================================\n  // nothing to do here because this is 100% inherited from DSButtonV3, DSButtonV3 has its own xstyled props\n\n  // =============================================================================\n  // AD HOC PER COMPONENT LOGIC\n  // =============================================================================\n  // custom code goes here, this is an example\n  const instanceUid = React.useMemo(() => `ds-opinionated-button-${uid(5)}`, []);\n\n  const floatingContext = useFloatingContext({\n    placement: placementOrderPreference[0],\n    placementOrderPreference,\n    animationDuration: 100,\n    customOffset: [0, 0],\n  });\n  const eventsHandlers = useTriggerEventsHandlers({ propsWithDefault, floatingContext });\n\n  return React.useMemo(\n    () => ({\n      propsWithDefault,\n      instanceUid,\n      eventsHandlers,\n      floatingContext,\n    }),\n    [propsWithDefault, instanceUid, eventsHandlers, floatingContext],\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,oCAAoC;AAC7C,SAAS,0BAAuD;AAChE,OAAOA,YAAW;AAClB,SAAS,WAAW;AACpB;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,gCAAgC;AACzC,SAAS,wBAAwB;AAEjC,MAAM,2BAA+F;AAAA,EACnG;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,uBAAuB,CAAC,kBAA8C;AAIjF,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACA,mBAAiB,kBAAkB,kCAAkC;AAUrE,QAAM,cAAcA,OAAM,QAAQ,MAAM,yBAAyB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAE7E,QAAM,kBAAkB,mBAAmB;AAAA,IACzC,WAAW,yBAAyB,CAAC;AAAA,IACrC;AAAA,IACA,mBAAmB;AAAA,IACnB,cAAc,CAAC,GAAG,CAAC;AAAA,EACrB,CAAC;AACD,QAAM,iBAAiB,yBAAyB,EAAE,kBAAkB,gBAAgB,CAAC;AAErF,SAAOA,OAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,kBAAkB,aAAa,gBAAgB,eAAe;AAAA,EACjE;AACF;",
+  "names": ["React"]
+}

package/dist/esm/parts/DSOpinionatedButton/config/useTriggerEventsHandlers.js

@@ -0,0 +1,68 @@
+import * as React from "react";
+import React2 from "react";
+import { MenuBehaviouralContextProviderContext } from "../../DSMenuBehaviouralContextProvider/MenuBehaviouralContextProviderCTX.js";
+import { MENU_FOCUS_REGIONS } from "../../DSMenuBehaviouralContextProvider/constants/index.js";
+const useTriggerEventsHandlers = ({ propsWithDefault, floatingContext }) => {
+  const { focusRegion, isMenuOpen, onOpinionatedOpen, onOpinionatedClose, trackFocusTrigger } = React2.useContext(
+    MenuBehaviouralContextProviderContext
+  );
+  const { onClick, onFocus, innerRef, onKeyDown } = propsWithDefault;
+  const {
+    refs: { setReference }
+  } = floatingContext;
+  const focusedRegionPerformanceHelper = React2.useRef(focusRegion);
+  focusedRegionPerformanceHelper.current = focusRegion;
+  const mutableIsMenuOpen = React2.useRef(isMenuOpen);
+  mutableIsMenuOpen.current = isMenuOpen;
+  const handleOnClick = React2.useCallback(
+    (e, ...args) => {
+      if (onClick) onClick(e, ...args);
+      if (mutableIsMenuOpen.current) {
+        onOpinionatedClose();
+      } else {
+        onOpinionatedOpen();
+      }
+    },
+    [onClick, onOpinionatedClose, onOpinionatedOpen]
+  );
+  const handleOnFocus = React2.useCallback(
+    (e, ...args) => {
+      if (focusedRegionPerformanceHelper.current !== MENU_FOCUS_REGIONS.TRIGGER) trackFocusTrigger();
+      if (onFocus) onFocus(e, ...args);
+    },
+    [onFocus, trackFocusTrigger]
+  );
+  const handleFocusIfTriggerIsFocusRegion = React2.useCallback(
+    (node) => {
+      setReference(node);
+      if (focusRegion === MENU_FOCUS_REGIONS.TRIGGER && node) {
+        node.focus();
+      }
+      if (typeof innerRef === "function") innerRef?.(node);
+    },
+    [focusRegion, innerRef, setReference]
+  );
+  const handleTriggerKeyDown = React2.useCallback(
+    (event, ...args) => {
+      if (event.key === "ArrowDown") {
+        onOpinionatedOpen();
+      }
+      if (event.key === "ArrowUp") {
+        onOpinionatedOpen({ focusLastChild: true });
+      }
+      if (event.key === "Escape") {
+        onOpinionatedClose();
+      }
+      if (onKeyDown) onKeyDown(event, ...args);
+    },
+    [onKeyDown, onOpinionatedOpen, onOpinionatedClose]
+  );
+  return React2.useMemo(
+    () => ({ handleTriggerKeyDown, handleOnClick, handleOnFocus, handleFocusIfTriggerIsFocusRegion }),
+    [handleFocusIfTriggerIsFocusRegion, handleOnClick, handleOnFocus, handleTriggerKeyDown]
+  );
+};
+export {
+  useTriggerEventsHandlers
+};
+//# sourceMappingURL=useTriggerEventsHandlers.js.map

package/dist/esm/parts/DSOpinionatedButton/config/useTriggerEventsHandlers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../scripts/build/transpile/react-shim.js", "../../../../../src/parts/DSOpinionatedButton/config/useTriggerEventsHandlers.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type { DSButtonV3T } from '@elliemae/ds-button-v2';\nimport { type useFloatingContext } from '@elliemae/ds-floating-context';\nimport React from 'react';\nimport { MenuBehaviouralContextProviderContext } from '../../DSMenuBehaviouralContextProvider/MenuBehaviouralContextProviderCTX.js';\nimport { MENU_FOCUS_REGIONS } from '../../DSMenuBehaviouralContextProvider/constants/index.js';\nimport { type DSOpinionatedButtonT } from '../react-desc-prop-types.js';\n\ntype UseTriggerEventsHandlersConfig = {\n  propsWithDefault: DSOpinionatedButtonT.InternalProps;\n  floatingContext: ReturnType<typeof useFloatingContext>;\n};\n\nexport const useTriggerEventsHandlers = ({ propsWithDefault, floatingContext }: UseTriggerEventsHandlersConfig) => {\n  // =============================================================================\n  // on click -> open the submenu\n  //  if the props already include an onClick, we will wrap it\n  // =============================================================================\n  const { focusRegion, isMenuOpen, onOpinionatedOpen, onOpinionatedClose, trackFocusTrigger } = React.useContext(\n    MenuBehaviouralContextProviderContext,\n  );\n  const { onClick, onFocus, innerRef, onKeyDown } = propsWithDefault;\n  const {\n    refs: { setReference },\n  } = floatingContext;\n\n  const focusedRegionPerformanceHelper = React.useRef(focusRegion);\n  focusedRegionPerformanceHelper.current = focusRegion;\n\n  const mutableIsMenuOpen = React.useRef(isMenuOpen);\n  // this is a boolean, so a primitive value,\n  //   we don't need to useEffect to change it\n  //   because we don't need to ensure referencial equality\n  mutableIsMenuOpen.current = isMenuOpen;\n\n  const handleOnClick = React.useCallback<Required<DSButtonV3T.Props>['onClick']>(\n    (e, ...args) => {\n      if (onClick) onClick(e, ...args);\n      // no reason to change this function reference every time the menu opens/closes\n      //  so we are using a mutable ref to optimize this\n      if (mutableIsMenuOpen.current) {\n        onOpinionatedClose();\n      } else {\n        onOpinionatedOpen();\n      }\n    },\n    [onClick, onOpinionatedClose, onOpinionatedOpen],\n  );\n  const handleOnFocus = React.useCallback<Required<DSButtonV3T.Props>['onFocus']>(\n    (e, ...args) => {\n      if (focusedRegionPerformanceHelper.current !== MENU_FOCUS_REGIONS.TRIGGER) trackFocusTrigger();\n      if (onFocus) onFocus(e, ...args);\n    },\n    [onFocus, trackFocusTrigger],\n  );\n\n  const handleFocusIfTriggerIsFocusRegion = React.useCallback<React.RefCallback<HTMLButtonElement>>(\n    (node) => {\n      setReference(node);\n      if (focusRegion === MENU_FOCUS_REGIONS.TRIGGER && node) {\n        node.focus();\n      }\n      if (typeof innerRef === 'function') innerRef?.(node);\n    },\n    [focusRegion, innerRef, setReference],\n  );\n  /*\n   * 13th August 2024:\n   * https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/\n   * With focus on the button:\n   * Enter: opens the menu and places focus on the first menu item.\n   * Space: Opens the menu and places focus on the first menu item.\n   * (Optional) Down Arrow: opens the menu and moves focus to the first menu item.\n   * (Optional) Up Arrow: opens the menu and moves focus to the last menu item.\n   */\n  const handleTriggerKeyDown = React.useCallback<Required<DSButtonV3T.Props>['onKeyDown']>(\n    (event, ...args) => {\n      // DSButtonV3 triggers the onClick on Enter and Space, so we don't need to handle it here\n      // if (event.key === 'Enter' || event.key === ' ') {\n      //   onOpinionatedOpen();\n      // }\n      if (event.key === 'ArrowDown') {\n        onOpinionatedOpen();\n      }\n      if (event.key === 'ArrowUp') {\n        onOpinionatedOpen({ focusLastChild: true });\n      }\n      if (event.key === 'Escape') {\n        onOpinionatedClose();\n      }\n      if (onKeyDown) onKeyDown(event, ...args);\n    },\n    [onKeyDown, onOpinionatedOpen, onOpinionatedClose],\n  );\n\n  return React.useMemo(\n    () => ({ handleTriggerKeyDown, handleOnClick, handleOnFocus, handleFocusIfTriggerIsFocusRegion }),\n    [handleFocusIfTriggerIsFocusRegion, handleOnClick, handleOnFocus, handleTriggerKeyDown],\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEvB,OAAOA,YAAW;AAClB,SAAS,6CAA6C;AACtD,SAAS,0BAA0B;AAQ5B,MAAM,2BAA2B,CAAC,EAAE,kBAAkB,gBAAgB,MAAsC;AAKjH,QAAM,EAAE,aAAa,YAAY,mBAAmB,oBAAoB,kBAAkB,IAAIA,OAAM;AAAA,IAClG;AAAA,EACF;AACA,QAAM,EAAE,SAAS,SAAS,UAAU,UAAU,IAAI;AAClD,QAAM;AAAA,IACJ,MAAM,EAAE,aAAa;AAAA,EACvB,IAAI;AAEJ,QAAM,iCAAiCA,OAAM,OAAO,WAAW;AAC/D,iCAA+B,UAAU;AAEzC,QAAM,oBAAoBA,OAAM,OAAO,UAAU;AAIjD,oBAAkB,UAAU;AAE5B,QAAM,gBAAgBA,OAAM;AAAA,IAC1B,CAAC,MAAM,SAAS;AACd,UAAI,QAAS,SAAQ,GAAG,GAAG,IAAI;AAG/B,UAAI,kBAAkB,SAAS;AAC7B,2BAAmB;AAAA,MACrB,OAAO;AACL,0BAAkB;AAAA,MACpB;AAAA,IACF;AAAA,IACA,CAAC,SAAS,oBAAoB,iBAAiB;AAAA,EACjD;AACA,QAAM,gBAAgBA,OAAM;AAAA,IAC1B,CAAC,MAAM,SAAS;AACd,UAAI,+BAA+B,YAAY,mBAAmB,QAAS,mBAAkB;AAC7F,UAAI,QAAS,SAAQ,GAAG,GAAG,IAAI;AAAA,IACjC;AAAA,IACA,CAAC,SAAS,iBAAiB;AAAA,EAC7B;AAEA,QAAM,oCAAoCA,OAAM;AAAA,IAC9C,CAAC,SAAS;AACR,mBAAa,IAAI;AACjB,UAAI,gBAAgB,mBAAmB,WAAW,MAAM;AACtD,aAAK,MAAM;AAAA,MACb;AACA,UAAI,OAAO,aAAa,WAAY,YAAW,IAAI;AAAA,IACrD;AAAA,IACA,CAAC,aAAa,UAAU,YAAY;AAAA,EACtC;AAUA,QAAM,uBAAuBA,OAAM;AAAA,IACjC,CAAC,UAAU,SAAS;AAKlB,UAAI,MAAM,QAAQ,aAAa;AAC7B,0BAAkB;AAAA,MACpB;AACA,UAAI,MAAM,QAAQ,WAAW;AAC3B,0BAAkB,EAAE,gBAAgB,KAAK,CAAC;AAAA,MAC5C;AACA,UAAI,MAAM,QAAQ,UAAU;AAC1B,2BAAmB;AAAA,MACrB;AACA,UAAI,UAAW,WAAU,OAAO,GAAG,IAAI;AAAA,IACzC;AAAA,IACA,CAAC,WAAW,mBAAmB,kBAAkB;AAAA,EACnD;AAEA,SAAOA,OAAM;AAAA,IACX,OAAO,EAAE,sBAAsB,eAAe,eAAe,kCAAkC;AAAA,IAC/F,CAAC,mCAAmC,eAAe,eAAe,oBAAoB;AAAA,EACxF;AACF;",
+  "names": ["React"]
+}

package/dist/esm/parts/DSOpinionatedButton/config/useValidateProps.js

@@ -0,0 +1,10 @@
+import * as React from "react";
+import { useValidateTypescriptPropTypes } from "@elliemae/ds-props-helpers";
+import { DSOpinionatedButtonName } from "../constants/index.js";
+const useValidateProps = (props, propTypes) => {
+  useValidateTypescriptPropTypes(props, propTypes, DSOpinionatedButtonName);
+};
+export {
+  useValidateProps
+};
+//# sourceMappingURL=useValidateProps.js.map

package/dist/esm/parts/DSOpinionatedButton/config/useValidateProps.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../scripts/build/transpile/react-shim.js", "../../../../../src/parts/DSOpinionatedButton/config/useValidateProps.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { ValidationMap } from '@elliemae/ds-props-helpers';\nimport { type DSOpinionatedButtonT } from '../react-desc-prop-types.js';\nimport { DSOpinionatedButtonName } from '../constants/index.js';\n\nexport const useValidateProps = (\n  props: DSOpinionatedButtonT.InternalProps,\n  propTypes: ValidationMap<DSOpinionatedButtonT.Props>,\n): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSOpinionatedButtonName);\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,sCAAsC;AAG/C,SAAS,+BAA+B;AAEjC,MAAM,mBAAmB,CAC9B,OACA,cACS;AAET,iCAA+B,OAAO,WAAW,uBAAuB;AAC1E;",
+  "names": []
+}

package/dist/esm/parts/DSOpinionatedButton/constants/index.js

@@ -0,0 +1,18 @@
+import * as React from "react";
+import { slotObjectToDataTestIds } from "@elliemae/ds-system";
+const DSOpinionatedButtonName = "DSOpinionatedButton";
+const EXAMPLE_CONSTANTS = {};
+const OPINIONATED_BUTTON_SLOTS = {
+  ROOT: "root"
+};
+const OPINIONATED_BUTTON_DATA_TESTID = slotObjectToDataTestIds(
+  DSOpinionatedButtonName,
+  OPINIONATED_BUTTON_SLOTS
+);
+export {
+  DSOpinionatedButtonName,
+  EXAMPLE_CONSTANTS,
+  OPINIONATED_BUTTON_DATA_TESTID,
+  OPINIONATED_BUTTON_SLOTS
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/parts/DSOpinionatedButton/constants/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../scripts/build/transpile/react-shim.js", "../../../../../src/parts/DSOpinionatedButton/constants/index.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { slotObjectToDataTestIds } from '@elliemae/ds-system';\n\nexport const DSOpinionatedButtonName = 'DSOpinionatedButton';\n\nexport const EXAMPLE_CONSTANTS = {} as const;\n\n// we are naming this with the ${component_name}_slots convention to namespace & avoid errors on duplicate exports variables in aggregators\nexport const OPINIONATED_BUTTON_SLOTS = {\n  ROOT: 'root',\n} as const;\n\n// we are naming this with the ${component_name}_data_testid convention to namespace & avoid errors on duplicate exports variables in aggregators\nexport const OPINIONATED_BUTTON_DATA_TESTID = slotObjectToDataTestIds(\n  DSOpinionatedButtonName,\n  OPINIONATED_BUTTON_SLOTS,\n);\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,+BAA+B;AAEjC,MAAM,0BAA0B;AAEhC,MAAM,oBAAoB,CAAC;AAG3B,MAAM,2BAA2B;AAAA,EACtC,MAAM;AACR;AAGO,MAAM,iCAAiC;AAAA,EAC5C;AAAA,EACA;AACF;",
+  "names": []
+}

package/dist/esm/parts/DSOpinionatedButton/index.js

@@ -0,0 +1,10 @@
+import * as React from "react";
+import {
+  DSOpinionatedButton,
+  DSOpinionatedButtonWithSchema
+} from "./DSOpinionatedButton.js";
+export {
+  DSOpinionatedButton,
+  DSOpinionatedButtonWithSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/parts/DSOpinionatedButton/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/DSOpinionatedButton/index.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { \n    DSOpinionatedButton,\n    DSOpinionatedButtonWithSchema\n} from './DSOpinionatedButton.js';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB;AAAA,EACI;AAAA,EACA;AAAA,OACG;",
+  "names": []
+}

package/dist/esm/parts/DSOpinionatedButton/react-desc-prop-types.js

@@ -0,0 +1,23 @@
+import * as React from "react";
+import { DSButtonV3DefaultProps, DSButtonV3PropTypes } from "@elliemae/ds-button-v2";
+import { getPropsPerSlotPropTypes, PropTypes } from "@elliemae/ds-props-helpers";
+import { DSMenuSpecificPropTypes } from "../../react-desc-prop-types.js";
+import { DSOpinionatedButtonName, OPINIONATED_BUTTON_SLOTS } from "./constants/index.js";
+const defaultProps = {
+  ...DSButtonV3DefaultProps
+};
+const DSOpinionatedButtonPropTypes = {
+  ...getPropsPerSlotPropTypes(DSOpinionatedButtonName, OPINIONATED_BUTTON_SLOTS),
+  ...DSButtonV3PropTypes,
+  menuSpecificProps: PropTypes.shape(DSMenuSpecificPropTypes).description("Props for the main flyout menu").isRequired,
+  innerRef: PropTypes.func.description(
+    "Ref callback for the button, if not provided how is the flyout menu being positioned?"
+  ).isRequired
+};
+const DSOpinionatedButtonPropTypesSchema = DSOpinionatedButtonPropTypes;
+export {
+  DSOpinionatedButtonPropTypes,
+  DSOpinionatedButtonPropTypesSchema,
+  defaultProps
+};
+//# sourceMappingURL=react-desc-prop-types.js.map

package/dist/esm/parts/DSOpinionatedButton/react-desc-prop-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/DSOpinionatedButton/react-desc-prop-types.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-empty-interface */\nimport React from 'react';\nimport { DSButtonV3DefaultProps, DSButtonV3PropTypes } from '@elliemae/ds-button-v2';\nimport type { DSPropTypesSchema, ValidationMap } from '@elliemae/ds-props-helpers';\nimport { getPropsPerSlotPropTypes, PropTypes } from '@elliemae/ds-props-helpers';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport { type DSMenuButtonT, DSMenuSpecificPropTypes } from '../../react-desc-prop-types.js';\nimport { DSOpinionatedButtonName, OPINIONATED_BUTTON_SLOTS } from './constants/index.js';\n\nexport declare namespace DSOpinionatedButtonT {\n  /*\n   * everything that is specifically added in this namespace declaration and is not part of the original component\n   * is because the original component is an \"opinionated widget\" that offloads a chunk of responsibilities from dev to dimsum\n   * as such, the widget generates those interfaces,\n   *  but the app developer is not supposed to know about them\n   *    untill they go atomic composition (this namespace)\n   */\n  export interface RequiredProps extends DSMenuButtonT.ButtonInheritedRequiredProps {\n    menuSpecificProps: DSMenuButtonT.MenuSpecificProps;\n  }\n\n  export interface DefaultProps extends DSMenuButtonT.ButtonInheiredDefaultProps {}\n\n  export interface OptionalProps\n    extends TypescriptHelpersT.PropsForGlobalOnSlots<typeof DSOpinionatedButtonName, typeof OPINIONATED_BUTTON_SLOTS>,\n      DSMenuButtonT.ButtonInheritedOptionalProps {}\n\n  export interface Props\n    extends RequiredProps,\n      Partial<DefaultProps>,\n      OptionalProps,\n      // this is where global/xstyled props are inherited from DSButtonV3\n      DSMenuButtonT.ButtonInheritedProps {\n    innerRef: React.RefCallback<HTMLButtonElement>;\n  }\n\n  export interface InternalProps\n    extends RequiredProps,\n      DefaultProps,\n      OptionalProps,\n      // this is where global/xstyled props are inherited from DSButtonV3\n      DSMenuButtonT.ButtonInheritedInternalProps {\n    innerRef: React.RefCallback<HTMLButtonElement>;\n  }\n}\n\nexport const defaultProps: DSOpinionatedButtonT.DefaultProps = {\n  ...DSButtonV3DefaultProps,\n};\n\nexport const DSOpinionatedButtonPropTypes: DSPropTypesSchema<DSOpinionatedButtonT.Props> = {\n  ...getPropsPerSlotPropTypes(DSOpinionatedButtonName, OPINIONATED_BUTTON_SLOTS),\n  ...DSButtonV3PropTypes,\n  menuSpecificProps: PropTypes.shape(DSMenuSpecificPropTypes).description('Props for the main flyout menu').isRequired,\n  innerRef: PropTypes.func.description(\n    'Ref callback for the button, if not provided how is the flyout menu being positioned?',\n  ).isRequired,\n};\n\nexport const DSOpinionatedButtonPropTypesSchema =\n  DSOpinionatedButtonPropTypes as unknown as ValidationMap<DSOpinionatedButtonT.Props>;\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEvB,SAAS,wBAAwB,2BAA2B;AAE5D,SAAS,0BAA0B,iBAAiB;AAEpD,SAA6B,+BAA+B;AAC5D,SAAS,yBAAyB,gCAAgC;AAuC3D,MAAM,eAAkD;AAAA,EAC7D,GAAG;AACL;AAEO,MAAM,+BAA8E;AAAA,EACzF,GAAG,yBAAyB,yBAAyB,wBAAwB;AAAA,EAC7E,GAAG;AAAA,EACH,mBAAmB,UAAU,MAAM,uBAAuB,EAAE,YAAY,gCAAgC,EAAE;AAAA,EAC1G,UAAU,UAAU,KAAK;AAAA,IACvB;AAAA,EACF,EAAE;AACJ;AAEO,MAAM,qCACX;",
+  "names": []
+}

package/dist/esm/react-desc-prop-types.js

@@ -1,34 +1,70 @@
 import * as React from "react";
-import { PropTypes, globalAttributesPropTypes, xstyledPropTypes } from "@elliemae/ds-props-helpers";
+import { PropTypes, getPropsPerSlotPropTypes } from "@elliemae/ds-props-helpers";
+import { DSButtonV3PropTypes } from "@elliemae/ds-button-v2";
+import { DSMenuButtonName, MENU_BUTTON_SLOTS } from "./constants/index.js";
 const defaultProps = {
-  selectedKeys: [],
-  onSelectionChange: () => {
-  }
+  selectedOptions: {},
+  onClickOutside: () => null,
+  onOptionClick: () => null,
+  openedSubmenus: {},
+  onSubmenuToggle: () => null,
+  isLoading: false,
+  isSkeleton: false
 };
-const DSDMenuButtonPropTypes = {
-  ...globalAttributesPropTypes,
-  ...xstyledPropTypes,
-  items: PropTypes.arrayOf(
-    PropTypes.shape({
-      dsId: PropTypes.string.isRequired,
-      label: PropTypes.string,
-      type: PropTypes.oneOf(["separator", "section", "single", "multiple", void 0])
-    })
-  ).description("Array of items to be displayed in the dropdown").isRequired,
-  TriggerElement: PropTypes.node.description("Component to be used as the trigger element").isRequired,
-  selectedKeys: PropTypes.arrayOf(PropTypes.string).description("Array of selected keys"),
-  onSelectionChange: PropTypes.func.description("Function to be called when selection changes"),
-  triggerElementProps: PropTypes.object.description("Props to be passed to the trigger element"),
-  selectionMode: PropTypes.oneOf(["single", "multiple"]).description("Selection mode"),
-  menuMinWidth: PropTypes.oneOfType([PropTypes.string, PropTypes.number]).description(
-    "Minimum width of the main dropdown"
-  ),
-  ItemRenderer: PropTypes.node.description("Component to be used to render the items")
+const MenuBehaviouralLayerPropTypes = {
+  selectedItems: PropTypes.arrayOf(PropTypes.object).description(
+    "an array of tree-nodes that have to be marked as selected in the GUI"
+  ).isRequired,
+  onItemSelected: PropTypes.func.description("IoC function in charge of handling the selection of a menu item").signature(`((
+      newSelection: DSMenuButtonT.PseudoFocusableMenuNodes[],
+      metainfo: { itemNode: DSMenuButtonT.PseudoFocusableMenuNodes; event?: React.SyntheticEvent },
+    ) => void)`).isRequired,
+  onActivateItem: PropTypes.func.description(
+    "IoC function in charge of handling the activation (NOT INVOKED ON SELECTION) of a menu item"
+  ).signature(`((
+      itemNode: DSMenuButtonT.PseudoFocusableMenuNodes,
+      metainfo: { itemNode: DSMenuButtonT.PseudoFocusableMenuNodes; event?: React.SyntheticEvent },
+    ) => void)`).isRequired,
+  onOpen: PropTypes.func.description("function triggered when the widget opens the menu").signature(`(()=>void)`),
+  onClose: PropTypes.func.description("function triggered when the widget closes the menu").signature(`(()=>void)`),
+  onDisplayedSubmenuChange: PropTypes.func.description("function triggered when the widget's closes or opens a submenu").signature(`((
+      newOpenedItems: DSMenuButtonT.PseudoFocusableMenuNodes[],
+      metainfo: { itemNode: DSMenuButtonT.PseudoFocusableMenuNodes; event?: React.SyntheticEvent },
+    ) => void)`)
 };
-const DSDMenuButtonPropTypesSchema = DSDMenuButtonPropTypes;
+const DSMenuSpecificPropTypes = {
+  ItemRenderer: PropTypes.node.description("Component to be used to render the items"),
+  onClickOutside: PropTypes.func.description("Callback executed when you click outside the dropdown menu, or press the Esc key").defaultValue(() => null),
+  selectedOptions: PropTypes.object.description(
+    "Object with the ids of the options as keys, and booleans as keys. Represents the state of the current selection in the dropdown menu"
+  ).defaultValue({}),
+  onOptionClick: PropTypes.func.description(
+    "Callback triggered when an item is clicked or pressed. We provide the next selected options, the clicked option and the event, in that order"
+  ).defaultValue(() => null),
+  openedSubmenus: PropTypes.object.description(
+    "Object with the ids of the submenus as keys, and booleans as keys. Represents the state of the current opened submenus"
+  ).defaultValue({}),
+  onSubmenuToggle: PropTypes.func.description("Callback triggered when a submenu is opened or closed.").signature(
+    "((nextOpenedSubmenus: Record<string, boolean>, submenu: Item, e: React.MouseEvent | React.KeyboardEvent) => void)"
+  ).defaultValue(() => null),
+  isLoading: PropTypes.bool.description("Whether the flyout menu should render the loading indicator").defaultValue(false),
+  isSkeleton: PropTypes.bool.description("Whether the flyout menu should render the skeleton").defaultValue(false)
+};
+const DSMenuButtonPropTypes = {
+  options: PropTypes.oneOfType([PropTypes.array, PropTypes.object]).description(
+    "Array of options to display in the menu or a DSTree node to build branches from"
+  ).isRequired,
+  ...DSButtonV3PropTypes,
+  ...MenuBehaviouralLayerPropTypes,
+  ...DSMenuSpecificPropTypes,
+  ...getPropsPerSlotPropTypes(DSMenuButtonName, MENU_BUTTON_SLOTS)
+};
+const DSMenuButtonPropTypesSchema = DSMenuButtonPropTypes;
 export {
-  DSDMenuButtonPropTypes,
-  DSDMenuButtonPropTypesSchema,
+  DSMenuButtonPropTypes,
+  DSMenuButtonPropTypesSchema,
+  DSMenuSpecificPropTypes,
+  MenuBehaviouralLayerPropTypes,
   defaultProps
 };
 //# sourceMappingURL=react-desc-prop-types.js.map