@elliemae/ds-popperjs 3.18.0 → 3.18.1

package/dist/cjs/PopoverContent.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/PopoverContent.tsx", "../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import React, { useCallback, useMemo } from 'react';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport { PopoverArrow } from './PopoverArrow.js';\nimport { StyledPopoverContentWrapper, StyledAnimatedPopper } from './styled.js';\n\nexport interface PopoverContentPropsT {\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popperStyles: React.CSSProperties;\n  arrowStyle: React.CSSProperties;\n  popperAttributes: Record<string, string> | undefined;\n  children: JSX.Element | JSX.Element[];\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  withoutArrow: boolean;\n  withoutAnimation: boolean;\n  animationDuration: number;\n  zIndex: number;\n  showPopover: boolean;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  globalAttrs: GlobalAttributesT;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const PopoverContent = ({\n  setPopperElement,\n  popperStyles,\n  popperAttributes,\n  children,\n  showPopover,\n  setArrowElement,\n  setIsAnimating,\n  arrowStyle,\n  withoutArrow,\n  withoutAnimation,\n  animationDuration,\n  zIndex,\n  globalAttrs,\n  xStyledAttrs,\n}: PopoverContentPropsT): JSX.Element => {\n  const checkAnimationStatus = useCallback(() => {\n    if (!showPopover && !withoutAnimation) {\n      setIsAnimating(false);\n    }\n  }, [showPopover, withoutAnimation, setIsAnimating]);\n\n  const popperContent = useMemo(\n    () => (\n      <>\n        {children}\n        {withoutArrow === false ? (\n          <>\n            <PopoverArrow\n              arrowElementRef={setArrowElement}\n              style={arrowStyle}\n              placement={popperAttributes ? popperAttributes['data-popper-placement'] : 'bottom'}\n            />\n            <div ref={setArrowElement} style={arrowStyle} />\n          </>\n        ) : null}\n      </>\n    ),\n    [children, withoutArrow, arrowStyle, popperAttributes, setArrowElement],\n  );\n  return (\n    <StyledPopoverContentWrapper\n      ref={setPopperElement}\n      style={popperStyles}\n      {...popperAttributes}\n      {...globalAttrs}\n      {...xStyledAttrs}\n      zIndex={zIndex}\n    >\n      <StyledAnimatedPopper\n        showPopover={showPopover}\n        animationDuration={animationDuration}\n        withoutAnimation={withoutAnimation}\n        onAnimationEnd={checkAnimationStatus}\n      >\n        {popperContent}\n      </StyledAnimatedPopper>\n    </StyledPopoverContentWrapper>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "sourcesContent": ["import React, { useCallback, useMemo } from 'react';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport { PopoverArrow } from './PopoverArrow.js';\nimport { StyledPopoverContentWrapper, StyledAnimatedPopper } from './styled.js';\n\nexport interface PopoverContentPropsT {\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popperStyles: React.CSSProperties;\n  arrowStyle: React.CSSProperties;\n  popperAttributes: Record<string, string> | undefined;\n  children: ReactChildrenComplete;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  withoutArrow: boolean;\n  withoutAnimation: boolean;\n  animationDuration: number;\n  zIndex: number;\n  showPopover: boolean;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  globalAttrs: GlobalAttributesT;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const PopoverContent = ({\n  setPopperElement,\n  popperStyles,\n  popperAttributes,\n  children,\n  showPopover,\n  setArrowElement,\n  setIsAnimating,\n  arrowStyle,\n  withoutArrow,\n  withoutAnimation,\n  animationDuration,\n  zIndex,\n  globalAttrs,\n  xStyledAttrs,\n}: PopoverContentPropsT): JSX.Element => {\n  const checkAnimationStatus = useCallback(() => {\n    if (!showPopover && !withoutAnimation) {\n      setIsAnimating(false);\n    }\n  }, [showPopover, withoutAnimation, setIsAnimating]);\n\n  const popperContent = useMemo(\n    () => (\n      <>\n        {children}\n        {withoutArrow === false ? (\n          <>\n            <PopoverArrow\n              arrowElementRef={setArrowElement}\n              style={arrowStyle}\n              placement={popperAttributes ? popperAttributes['data-popper-placement'] : 'bottom'}\n            />\n            <div ref={setArrowElement} style={arrowStyle} />\n          </>\n        ) : null}\n      </>\n    ),\n    [children, withoutArrow, arrowStyle, popperAttributes, setArrowElement],\n  );\n  return (\n    <StyledPopoverContentWrapper\n      ref={setPopperElement}\n      style={popperStyles}\n      {...popperAttributes}\n      {...globalAttrs}\n      {...xStyledAttrs}\n      zIndex={zIndex}\n    >\n      <StyledAnimatedPopper\n        showPopover={showPopover}\n        animationDuration={animationDuration}\n        withoutAnimation={withoutAnimation}\n        onAnimationEnd={checkAnimationStatus}\n      >\n        {popperContent}\n      </StyledAnimatedPopper>\n    </StyledPopoverContentWrapper>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADkDb;AAlDV,mBAA4C;AAG5C,0BAA6B;AAC7B,oBAAkE;AAmB3D,MAAM,iBAAiB,CAAC;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAyC;AACvC,QAAM,2BAAuB,0BAAY,MAAM;AAC7C,QAAI,CAAC,eAAe,CAAC,kBAAkB;AACrC,qBAAe,KAAK;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,aAAa,kBAAkB,cAAc,CAAC;AAElD,QAAM,oBAAgB;AAAA,IACpB,MACE,4EACG;AAAA;AAAA,MACA,iBAAiB,QAChB,4EACE;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,iBAAiB;AAAA,YACjB,OAAO;AAAA,YACP,WAAW,mBAAmB,iBAAiB,uBAAuB,IAAI;AAAA;AAAA,QAC5E;AAAA,QACA,4CAAC,SAAI,KAAK,iBAAiB,OAAO,YAAY;AAAA,SAChD,IACE;AAAA,OACN;AAAA,IAEF,CAAC,UAAU,cAAc,YAAY,kBAAkB,eAAe;AAAA,EACxE;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL,OAAO;AAAA,MACN,GAAG;AAAA,MACH,GAAG;AAAA,MACH,GAAG;AAAA,MACJ;AAAA,MAEA;AAAA,QAAC;AAAA;AAAA,UACC;AAAA,UACA;AAAA,UACA;AAAA,UACA,gBAAgB;AAAA,UAEf;AAAA;AAAA,MACH;AAAA;AAAA,EACF;AAEJ;",
   "names": []
 }

package/dist/cjs/config/useConfigDSPopperjs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/useConfigDSPopperjs.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemo, useState, useEffect } from 'react';\nimport { usePopper } from 'react-popper';\nimport { useGetGlobalAttributes, useGetXstyledProps } from '@elliemae/ds-props-helpers';\nimport { useConfiguredMergedProps } from './useConfiguredMergedProps.js';\nimport type { UseDSPopperjsPropsArgT, UseDSPopperjsRT } from '../react-desc-prop-types.js';\nimport { useOnClickOutside } from '../utils/hooks/useOnClickOutside.js';\n\nexport const useConfigDSPopperjs = (appProps: UseDSPopperjsPropsArgT): UseDSPopperjsRT => {\n  const [popperElement, setPopperElement] = useState<HTMLDivElement | null>(null);\n  const [arrowElement, setArrowElement] = useState<HTMLDivElement | null>(null);\n  const [isAnimating, setIsAnimating] = useState(false);\n\n  const props = useConfiguredMergedProps({ props: appProps, arrowElement });\n  const { referenceElement, closeContextMenu, onClickOutside, modifiers, startPlacementPreference } = props;\n  const popperExtraOpts = useMemo(\n    () => ({ placement: startPlacementPreference, modifiers }),\n    [modifiers, startPlacementPreference],\n  );\n\n  const popoverHelper = usePopper(referenceElement, popperElement, popperExtraOpts);\n\n  const { showPopover, withoutAnimation } = props;\n\n  useEffect(() => {\n    if (showPopover && !withoutAnimation) {\n      setIsAnimating(true);\n    }\n  }, [showPopover, withoutAnimation]);\n\n  useOnClickOutside(popperElement as Node, (e) => {\n    if (!referenceElement?.contains?.(e?.target as Node)) {\n      onClickOutside(e);\n      closeContextMenu();\n    }\n  });\n\n  const globalAttrs = useGetGlobalAttributes(props);\n  const xStyledAttrs = useGetXstyledProps(props);\n\n  return useMemo(\n    () => ({\n      props,\n      popperElement,\n      setPopperElement,\n      arrowElement,\n      setArrowElement,\n      popoverHelper,\n      isAnimating,\n      setIsAnimating,\n      globalAttrs,\n      xStyledAttrs,\n    }),\n    [props, popperElement, arrowElement, popoverHelper, isAnimating, globalAttrs, xStyledAttrs],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAA6C;AAC7C,0BAA0B;AAC1B,8BAA2D;AAC3D,sCAAyC;AAEzC,+BAAkC;AAE3B,MAAM,sBAAsB,CAAC,aAAsD;AACxF,QAAM,CAAC,eAAe,gBAAgB,QAAI,uBAAgC,IAAI;AAC9E,QAAM,CAAC,cAAc,eAAe,QAAI,uBAAgC,IAAI;AAC5E,QAAM,CAAC,aAAa,cAAc,QAAI,uBAAS,KAAK;AAEpD,QAAM,YAAQ,0DAAyB,EAAE,OAAO,UAAU,aAAa,CAAC;AACxE,QAAM,EAAE,kBAAkB,kBAAkB,gBAAgB,WAAW,yBAAyB,IAAI;AACpG,QAAM,sBAAkB;AAAA,IACtB,OAAO,EAAE,WAAW,0BAA0B,UAAU;AAAA,IACxD,CAAC,WAAW,wBAAwB;AAAA,EACtC;AAEA,QAAM,oBAAgB,+BAAU,kBAAkB,eAAe,eAAe;AAEhF,QAAM,EAAE,aAAa,iBAAiB,IAAI;AAE1C,8BAAU,MAAM;AACd,QAAI,eAAe,CAAC,kBAAkB;AACpC,qBAAe,IAAI;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,aAAa,gBAAgB,CAAC;AAElC,kDAAkB,eAAuB,CAAC,MAAM;AAC9C,QAAI,CAAC,kBAAkB,WAAW,GAAG,MAAc,GAAG;AACpD,qBAAe,CAAC;AAChB,uBAAiB;AAAA,IACnB;AAAA,EACF,CAAC;AAED,QAAM,kBAAc,gDAAuB,KAAK;AAChD,QAAM,mBAAe,4CAAmB,KAAK;AAE7C,aAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,OAAO,eAAe,cAAc,eAAe,aAAa,aAAa,YAAY;AAAA,EAC5F;AACF;",
+  "sourcesContent": ["import type React from 'react';\nimport { useMemo, useState, useEffect } from 'react';\nimport { usePopper } from 'react-popper';\nimport { useGetGlobalAttributes, useGetXstyledProps } from '@elliemae/ds-props-helpers';\nimport { useConfiguredMergedProps } from './useConfiguredMergedProps.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\nimport { useOnClickOutside } from '../utils/hooks/useOnClickOutside.js';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\ninterface UseDSPopperjsRT {\n  props: DSPopperJST.InternalProps;\n  popperElement: HTMLDivElement | null;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  isAnimating: boolean;\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  arrowElement: HTMLDivElement | null;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popoverHelper: ReturnType<typeof usePopper>;\n  globalAttrs: GlobalAttributesT<Element>;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const useConfigDSPopperjs = (appProps: DSPopperJST.Props): UseDSPopperjsRT => {\n  const [popperElement, setPopperElement] = useState<HTMLDivElement | null>(null);\n  const [arrowElement, setArrowElement] = useState<HTMLDivElement | null>(null);\n  const [isAnimating, setIsAnimating] = useState(false);\n\n  const props = useConfiguredMergedProps({ props: appProps, arrowElement });\n  const { referenceElement, closeContextMenu, onClickOutside, modifiers, startPlacementPreference } = props;\n  const popperExtraOpts = useMemo(\n    () => ({ placement: startPlacementPreference, modifiers }),\n    [modifiers, startPlacementPreference],\n  );\n\n  const popoverHelper = usePopper(referenceElement, popperElement, popperExtraOpts);\n\n  const { showPopover, withoutAnimation } = props;\n\n  useEffect(() => {\n    if (showPopover && !withoutAnimation) {\n      setIsAnimating(true);\n    }\n  }, [showPopover, withoutAnimation]);\n\n  useOnClickOutside(popperElement as Node, (e) => {\n    if (!referenceElement?.contains?.(e?.target as Node)) {\n      onClickOutside(e);\n      closeContextMenu();\n    }\n  });\n\n  const globalAttrs = useGetGlobalAttributes(props);\n  const xStyledAttrs = useGetXstyledProps(props);\n\n  return useMemo(\n    () => ({\n      props,\n      popperElement,\n      setPopperElement,\n      arrowElement,\n      setArrowElement,\n      popoverHelper,\n      isAnimating,\n      setIsAnimating,\n      globalAttrs,\n      xStyledAttrs,\n    }),\n    [props, popperElement, arrowElement, popoverHelper, isAnimating, globalAttrs, xStyledAttrs],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,mBAA6C;AAC7C,0BAA0B;AAC1B,8BAA2D;AAC3D,sCAAyC;AAEzC,+BAAkC;AAe3B,MAAM,sBAAsB,CAAC,aAAiD;AACnF,QAAM,CAAC,eAAe,gBAAgB,QAAI,uBAAgC,IAAI;AAC9E,QAAM,CAAC,cAAc,eAAe,QAAI,uBAAgC,IAAI;AAC5E,QAAM,CAAC,aAAa,cAAc,QAAI,uBAAS,KAAK;AAEpD,QAAM,YAAQ,0DAAyB,EAAE,OAAO,UAAU,aAAa,CAAC;AACxE,QAAM,EAAE,kBAAkB,kBAAkB,gBAAgB,WAAW,yBAAyB,IAAI;AACpG,QAAM,sBAAkB;AAAA,IACtB,OAAO,EAAE,WAAW,0BAA0B,UAAU;AAAA,IACxD,CAAC,WAAW,wBAAwB;AAAA,EACtC;AAEA,QAAM,oBAAgB,+BAAU,kBAAkB,eAAe,eAAe;AAEhF,QAAM,EAAE,aAAa,iBAAiB,IAAI;AAE1C,8BAAU,MAAM;AACd,QAAI,eAAe,CAAC,kBAAkB;AACpC,qBAAe,IAAI;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,aAAa,gBAAgB,CAAC;AAElC,kDAAkB,eAAuB,CAAC,MAAM;AAC9C,QAAI,CAAC,kBAAkB,WAAW,GAAG,MAAc,GAAG;AACpD,qBAAe,CAAC;AAChB,uBAAiB;AAAA,IACnB;AAAA,EACF,CAAC;AAED,QAAM,kBAAc,gDAAuB,KAAK;AAChD,QAAM,mBAAe,4CAAmB,KAAK;AAE7C,aAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,OAAO,eAAe,cAAc,eAAe,aAAa,aAAa,YAAY;AAAA,EAC5F;AACF;",
   "names": []
 }

package/dist/cjs/config/useConfiguredDefaultModifiers.js

@@ -33,7 +33,11 @@ __export(useConfiguredDefaultModifiers_exports, {
 module.exports = __toCommonJS(useConfiguredDefaultModifiers_exports);
 var React = __toESM(require("react"));
 var import_react = require("react");
-const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
+const useConfiguredDefaultModifiers = ({
+  props,
+  arrowElement,
+  defaultProps
+}) => {
   const {
     boundaryElement: explicitAppBoundaryElement,
     withoutArrow: explicitAppWithoutArrow = false,
@@ -50,7 +54,7 @@ const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
       }
     });
     if (!explicitAppWithoutArrow || explictAppOffset) {
-      const defaultOffset = explictAppOffset || [0, 14];
+      const defaultOffset = explictAppOffset || defaultProps.customOffset;
       mod.push({
         name: "offset",
         enabled: true,
@@ -77,6 +81,7 @@ const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
     return mod;
   }, [
     arrowElement,
+    defaultProps,
     explicitAppBoundaryElement,
     explicitAppWithoutArrow,
     explicitPlacementOrderPreference,

package/dist/cjs/config/useConfiguredDefaultModifiers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/useConfiguredDefaultModifiers.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemo } from 'react';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredDefaultModifiersT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultModifiers = ({ props, arrowElement }: UseConfiguredDefaultModifiersT) => {\n  // we destructure explicit app definitions before merge\n  const {\n    boundaryElement: explicitAppBoundaryElement,\n    withoutArrow: explicitAppWithoutArrow = false,\n    placementOrderPreference: explicitPlacementOrderPreference = ['top', 'bottom', 'left', 'right'],\n    customOffset: explictAppOffset = undefined,\n  } = props;\n  // to build default modifiers on top of it\n  const defaultModifiers = useMemo(() => {\n    const mod = [];\n    mod.push({ name: 'hide', enabled: true });\n    mod.push({\n      name: 'flip',\n      options: {\n        fallbackPlacements: explicitPlacementOrderPreference,\n      },\n    });\n    // we apply an offset if the app defines one or if the app wants the arrow\n    if (!explicitAppWithoutArrow || explictAppOffset) {\n      const defaultOffset = explictAppOffset || [0, 14];\n      mod.push({\n        name: 'offset',\n        enabled: true,\n        options: {\n          offset: defaultOffset,\n        },\n      });\n    }\n    // the app can opt for a \"no arrow\" implementation (we do so in datatable/calendar etc...)\n    if (!explicitAppWithoutArrow)\n      mod.push({\n        name: 'arrow',\n        options: {\n          element: arrowElement,\n          padding: 18,\n        },\n      });\n\n    // the app can define an explicit element to act as a boundary instead of popperjs default one\n    if (explicitAppBoundaryElement)\n      mod.push({\n        name: 'preventOverflow',\n        options: {\n          boundary: explicitAppBoundaryElement,\n        },\n      });\n    return mod;\n  }, [\n    arrowElement,\n    explicitAppBoundaryElement,\n    explicitAppWithoutArrow,\n    explicitPlacementOrderPreference,\n    explictAppOffset,\n  ]);\n  // if the app pass custom modifier, we don't use \"default modifiers\"\n  const { modifiers: explicitAppModifiers = defaultModifiers } = props;\n\n  return useMemo(\n    () => ({\n      modifiers: explicitAppModifiers,\n    }),\n    [explicitAppModifiers],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AAQjB,MAAM,gCAAgC,CAAC,EAAE,OAAO,aAAa,MAAsC;AAExG,QAAM;AAAA,IACJ,iBAAiB;AAAA,IACjB,cAAc,0BAA0B;AAAA,IACxC,0BAA0B,mCAAmC,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,IAC9F,cAAc,mBAAmB;AAAA,EACnC,IAAI;AAEJ,QAAM,uBAAmB,sBAAQ,MAAM;AACrC,UAAM,MAAM,CAAC;AACb,QAAI,KAAK,EAAE,MAAM,QAAQ,SAAS,KAAK,CAAC;AACxC,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,QACP,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAED,QAAI,CAAC,2BAA2B,kBAAkB;AAChD,YAAM,gBAAgB,oBAAoB,CAAC,GAAG,EAAE;AAChD,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,QACT,SAAS;AAAA,UACP,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,CAAC;AACH,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,MACF,CAAC;AAGH,QAAI;AACF,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF,CAAC;AACH,WAAO;AAAA,EACT,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,WAAW,uBAAuB,iBAAiB,IAAI;AAE/D,aAAO;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,IACb;AAAA,IACA,CAAC,oBAAoB;AAAA,EACvB;AACF;",
+  "sourcesContent": ["import { useMemo } from 'react';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredDefaultModifiersT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n  defaultProps: Omit<DSPopperJST.DefaultProps, 'zIndex'>;\n}\n\nexport const useConfiguredDefaultModifiers = ({\n  props,\n  arrowElement,\n  defaultProps,\n}: UseConfiguredDefaultModifiersT) => {\n  // we destructure explicit app definitions before merge\n  const {\n    boundaryElement: explicitAppBoundaryElement,\n    withoutArrow: explicitAppWithoutArrow = false,\n    placementOrderPreference: explicitPlacementOrderPreference = ['top', 'bottom', 'left', 'right'],\n    customOffset: explictAppOffset = undefined,\n  } = props;\n  // to build default modifiers on top of it\n  const defaultModifiers = useMemo(() => {\n    const mod = [];\n    mod.push({ name: 'hide', enabled: true });\n    mod.push({\n      name: 'flip',\n      options: {\n        fallbackPlacements: explicitPlacementOrderPreference,\n      },\n    });\n    // we apply an offset if the app defines one or if the app wants the arrow\n    if (!explicitAppWithoutArrow || explictAppOffset) {\n      const defaultOffset = explictAppOffset || defaultProps.customOffset;\n      mod.push({\n        name: 'offset',\n        enabled: true,\n        options: {\n          offset: defaultOffset,\n        },\n      });\n    }\n    // the app can opt for a \"no arrow\" implementation (we do so in datatable/calendar etc...)\n    if (!explicitAppWithoutArrow)\n      mod.push({\n        name: 'arrow',\n        options: {\n          element: arrowElement,\n          padding: 18,\n        },\n      });\n\n    // the app can define an explicit element to act as a boundary instead of popperjs default one\n    if (explicitAppBoundaryElement)\n      mod.push({\n        name: 'preventOverflow',\n        options: {\n          boundary: explicitAppBoundaryElement,\n        },\n      });\n    return mod;\n  }, [\n    arrowElement,\n    defaultProps,\n    explicitAppBoundaryElement,\n    explicitAppWithoutArrow,\n    explicitPlacementOrderPreference,\n    explictAppOffset,\n  ]);\n  // if the app pass custom modifier, we don't use \"default modifiers\"\n  const { modifiers: explicitAppModifiers = defaultModifiers } = props;\n\n  return useMemo(\n    () => ({\n      modifiers: explicitAppModifiers,\n    }),\n    [explicitAppModifiers],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AASjB,MAAM,gCAAgC,CAAC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AACF,MAAsC;AAEpC,QAAM;AAAA,IACJ,iBAAiB;AAAA,IACjB,cAAc,0BAA0B;AAAA,IACxC,0BAA0B,mCAAmC,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,IAC9F,cAAc,mBAAmB;AAAA,EACnC,IAAI;AAEJ,QAAM,uBAAmB,sBAAQ,MAAM;AACrC,UAAM,MAAM,CAAC;AACb,QAAI,KAAK,EAAE,MAAM,QAAQ,SAAS,KAAK,CAAC;AACxC,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,QACP,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAED,QAAI,CAAC,2BAA2B,kBAAkB;AAChD,YAAM,gBAAgB,oBAAoB,aAAa;AACvD,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,QACT,SAAS;AAAA,UACP,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,CAAC;AACH,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,MACF,CAAC;AAGH,QAAI;AACF,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF,CAAC;AACH,WAAO;AAAA,EACT,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,WAAW,uBAAuB,iBAAiB,IAAI;AAE/D,aAAO;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,IACb;AAAA,IACA,CAAC,oBAAoB;AAAA,EACvB;AACF;",
   "names": []
 }

package/dist/cjs/config/useConfiguredDefaultProps.js

@@ -51,13 +51,15 @@ const useConfiguredDefaultProps = ({ props, arrowElement }) => {
       portalDOMContainer: document.body,
       startPlacementPreference: "top",
       placementOrderPreference: ["top", "bottom", "left", "right"],
-      extraPopperStyles: emptyObj
+      extraPopperStyles: emptyObj,
+      customOffset: [0, 14]
     }),
     []
   );
   const { modifiers: configuredModifiers } = (0, import_useConfiguredDefaultModifiers.useConfiguredDefaultModifiers)({
     props,
-    arrowElement
+    arrowElement,
+    defaultProps: staticDefaultProps
   });
   const defaultProps = (0, import_react.useMemo)(
     () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),

package/dist/cjs/config/useConfiguredDefaultProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/useConfiguredDefaultProps.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemo } from 'react';\nimport { useConfiguredDefaultModifiers } from './useConfiguredDefaultModifiers.js';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\nconst noop = () => {};\n\nconst emptyObj = {};\n\ninterface UseConfiguredDefaultPropsT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultProps = ({ props, arrowElement }: Required<UseConfiguredDefaultPropsT>) => {\n  // don't move this out of the hook or `document.body` will explode\n  const staticDefaultProps: UseDSPopperjsPropsArgT = useMemo(\n    () => ({\n      referenceElement: null,\n      showPopover: false,\n      closeContextMenu: noop,\n      onClickOutside: noop,\n      withoutPortal: false,\n      withoutArrow: false,\n      withoutAnimation: false,\n      animationDuration: 100,\n      portalDOMContainer: document.body,\n      startPlacementPreference: 'top',\n      placementOrderPreference: ['top', 'bottom', 'left', 'right'],\n      extraPopperStyles: emptyObj,\n    }),\n    [],\n  );\n  const { modifiers: configuredModifiers } = useConfiguredDefaultModifiers({\n    props,\n    arrowElement,\n  });\n\n  const defaultProps = useMemo(\n    () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),\n    [configuredModifiers, staticDefaultProps],\n  );\n\n  return defaultProps;\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AACxB,2CAA8C;AAG9C,MAAM,OAAO,MAAM;AAAC;AAEpB,MAAM,WAAW,CAAC;AAOX,MAAM,4BAA4B,CAAC,EAAE,OAAO,aAAa,MAA4C;AAE1G,QAAM,yBAA6C;AAAA,IACjD,OAAO;AAAA,MACL,kBAAkB;AAAA,MAClB,aAAa;AAAA,MACb,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,MACnB,oBAAoB,SAAS;AAAA,MAC7B,0BAA0B;AAAA,MAC1B,0BAA0B,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,MAC3D,mBAAmB;AAAA,IACrB;AAAA,IACA,CAAC;AAAA,EACH;AACA,QAAM,EAAE,WAAW,oBAAoB,QAAI,oEAA8B;AAAA,IACvE;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,mBAAe;AAAA,IACnB,OAAO,EAAE,GAAG,oBAAoB,WAAW,oBAAoB;AAAA,IAC/D,CAAC,qBAAqB,kBAAkB;AAAA,EAC1C;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { useMemo } from 'react';\nimport { useConfiguredDefaultModifiers } from './useConfiguredDefaultModifiers.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\nconst noop = () => {};\n\nconst emptyObj = {};\n\ninterface UseConfiguredDefaultPropsT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultProps = ({ props, arrowElement }: Required<UseConfiguredDefaultPropsT>) => {\n  // the global object 'document' is in scope only if the staticDefaultProps is defined inside the react hook\n  //    moving this declaration outside of the hook will cause \"body.document\" to be undefined and cause an error\n  // we exclude zIndex from the staticDefaultProps because it is being applied from styled-components theme.props.popper\n  const staticDefaultProps: Omit<DSPopperJST.DefaultProps, 'zIndex'> = useMemo(\n    () => ({\n      referenceElement: null,\n      showPopover: false,\n      closeContextMenu: noop,\n      onClickOutside: noop,\n      withoutPortal: false,\n      withoutArrow: false,\n      withoutAnimation: false,\n      animationDuration: 100,\n      portalDOMContainer: document.body,\n      startPlacementPreference: 'top',\n      placementOrderPreference: ['top', 'bottom', 'left', 'right'],\n      extraPopperStyles: emptyObj,\n      customOffset: [0, 14],\n    }),\n    [],\n  );\n  const { modifiers: configuredModifiers } = useConfiguredDefaultModifiers({\n    props,\n    arrowElement,\n    defaultProps: staticDefaultProps,\n  });\n\n  const defaultProps = useMemo(\n    () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),\n    [configuredModifiers, staticDefaultProps],\n  );\n\n  return defaultProps;\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AACxB,2CAA8C;AAG9C,MAAM,OAAO,MAAM;AAAC;AAEpB,MAAM,WAAW,CAAC;AAOX,MAAM,4BAA4B,CAAC,EAAE,OAAO,aAAa,MAA4C;AAI1G,QAAM,yBAA+D;AAAA,IACnE,OAAO;AAAA,MACL,kBAAkB;AAAA,MAClB,aAAa;AAAA,MACb,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,MACnB,oBAAoB,SAAS;AAAA,MAC7B,0BAA0B;AAAA,MAC1B,0BAA0B,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,MAC3D,mBAAmB;AAAA,MACnB,cAAc,CAAC,GAAG,EAAE;AAAA,IACtB;AAAA,IACA,CAAC;AAAA,EACH;AACA,QAAM,EAAE,WAAW,oBAAoB,QAAI,oEAA8B;AAAA,IACvE;AAAA,IACA;AAAA,IACA,cAAc;AAAA,EAChB,CAAC;AAED,QAAM,mBAAe;AAAA,IACnB,OAAO,EAAE,GAAG,oBAAoB,WAAW,oBAAoB;AAAA,IAC/D,CAAC,qBAAqB,kBAAkB;AAAA,EAC1C;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/cjs/config/useConfiguredMergedProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/useConfiguredMergedProps.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useConfiguredDefaultProps } from './useConfiguredDefaultProps.js';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredMergedPropsT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredMergedProps = ({ props, arrowElement }: UseConfiguredMergedPropsT) => {\n  const defaultProps = useConfiguredDefaultProps({ props, arrowElement });\n\n  return useMemoMergePropsWithDefault<Required<UseDSPopperjsPropsArgT>>(props, defaultProps);\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA6C;AAC7C,uCAA0C;AAQnC,MAAM,2BAA2B,CAAC,EAAE,OAAO,aAAa,MAAiC;AAC9F,QAAM,mBAAe,4DAA0B,EAAE,OAAO,aAAa,CAAC;AAEtE,aAAO,sDAA+D,OAAO,YAAY;AAC3F;",
+  "sourcesContent": ["import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useConfiguredDefaultProps } from './useConfiguredDefaultProps.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredMergedPropsT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredMergedProps = ({ props, arrowElement }: UseConfiguredMergedPropsT) => {\n  const defaultProps = useConfiguredDefaultProps({ props, arrowElement });\n\n  return useMemoMergePropsWithDefault<DSPopperJST.InternalProps>(props, defaultProps);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA6C;AAC7C,uCAA0C;AAQnC,MAAM,2BAA2B,CAAC,EAAE,OAAO,aAAa,MAAiC;AAC9F,QAAM,mBAAe,4DAA0B,EAAE,OAAO,aAAa,CAAC;AAEtE,aAAO,sDAAwD,OAAO,YAAY;AACpF;",
   "names": []
 }

package/dist/cjs/index.js

@@ -104,7 +104,7 @@ const DSPopperJS = (props) => {
   if (showPopover || isAnimating) {
     if (withoutPortal === true)
       return contentJSX;
-    if (withoutPortal === false)
+    if (portalDOMContainer && withoutPortal === false)
       return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: (0, import_react_dom.createPortal)(contentJSX, portalDOMContainer) });
   }
   return null;

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.tsx", "../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import React, { useMemo } from 'react';\nimport { createPortal } from 'react-dom';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { PopoverContent } from './PopoverContent.js';\nimport { useConfigDSPopperjs } from './config/useConfigDSPopperjs.js';\nimport type { DSDSPopperjsPropsT } from './react-desc-prop-types.js';\nimport { dspopperjsPropTypes } from './react-desc-prop-types.js';\n\nconst DSPopperJS: React.ComponentType<DSDSPopperjsPropsT> = (props) => {\n  const {\n    props: {\n      showPopover,\n      withoutAnimation,\n      animationDuration,\n      withoutPortal,\n      withoutArrow,\n      portalDOMContainer,\n      zIndex,\n      extraPopperStyles,\n    },\n    globalAttrs,\n    xStyledAttrs,\n    setPopperElement,\n    setArrowElement,\n    setIsAnimating,\n    popoverHelper,\n    isAnimating,\n  } = useConfigDSPopperjs(props);\n  const { children } = props;\n  const { styles, attributes } = popoverHelper;\n  const contentJSX = useMemo(\n    () => (\n      <PopoverContent\n        setPopperElement={setPopperElement}\n        popperStyles={{ ...styles.popper, ...extraPopperStyles }}\n        popperAttributes={attributes.popper}\n        setArrowElement={setArrowElement}\n        arrowStyle={styles.arrow}\n        withoutArrow={withoutArrow}\n        withoutAnimation={withoutAnimation}\n        animationDuration={animationDuration}\n        zIndex={zIndex}\n        showPopover={showPopover}\n        setIsAnimating={setIsAnimating}\n        globalAttrs={globalAttrs}\n        xStyledAttrs={xStyledAttrs}\n      >\n        {children}\n      </PopoverContent>\n    ),\n    [\n      attributes.popper,\n      children,\n      setIsAnimating,\n      showPopover,\n      extraPopperStyles,\n      setArrowElement,\n      setPopperElement,\n      styles.arrow,\n      styles.popper,\n      withoutArrow,\n      withoutAnimation,\n      animationDuration,\n      zIndex,\n      globalAttrs,\n      xStyledAttrs,\n    ],\n  );\n  if (showPopover || isAnimating) {\n    if (withoutPortal === true) return contentJSX;\n    if (withoutPortal === false) return <>{createPortal(contentJSX, portalDOMContainer)}</>;\n  }\n  return null;\n};\n\nDSPopperJS.propTypes = dspopperjsPropTypes;\nDSPopperJS.displayName = 'DSPopperJS';\nconst DSPopperJSWithSchema = describe(DSPopperJS).description('A dimsum custom styling wrapper on top of popperjs');\nDSPopperJSWithSchema.propTypes = dspopperjsPropTypes;\n\nexport { DSPopperJS, DSPopperJSWithSchema };\nexport default DSPopperJS;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADgCjB;AAhCN,mBAA+B;AAC/B,uBAA6B;AAC7B,8BAAyB;AACzB,4BAA+B;AAC/B,iCAAoC;AAEpC,mCAAoC;AAEpC,MAAM,aAAsD,CAAC,UAAU;AACrE,QAAM;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,QAAI,gDAAoB,KAAK;AAC7B,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,QAAM,iBAAa;AAAA,IACjB,MACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,cAAc,EAAE,GAAG,OAAO,QAAQ,GAAG,kBAAkB;AAAA,QACvD,kBAAkB,WAAW;AAAA,QAC7B;AAAA,QACA,YAAY,OAAO;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QAEC;AAAA;AAAA,IACH;AAAA,IAEF;AAAA,MACE,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,eAAe,aAAa;AAC9B,QAAI,kBAAkB;AAAM,aAAO;AACnC,QAAI,kBAAkB;AAAO,aAAO,2EAAG,6CAAa,YAAY,kBAAkB,GAAE;AAAA,EACtF;AACA,SAAO;AACT;AAEA,WAAW,YAAY;AACvB,WAAW,cAAc;AACzB,MAAM,2BAAuB,kCAAS,UAAU,EAAE,YAAY,oDAAoD;AAClH,qBAAqB,YAAY;AAGjC,IAAO,cAAQ;",
+  "sourcesContent": ["import React, { useMemo } from 'react';\nimport { createPortal } from 'react-dom';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { PopoverContent } from './PopoverContent.js';\nimport { useConfigDSPopperjs } from './config/useConfigDSPopperjs.js';\nimport type { DSPopperJST } from './react-desc-prop-types.js';\nimport { dspopperjsPropTypes } from './react-desc-prop-types.js';\n\nconst DSPopperJS: React.ComponentType<DSPopperJST.Props> = (props) => {\n  const {\n    props: {\n      showPopover,\n      withoutAnimation,\n      animationDuration,\n      withoutPortal,\n      withoutArrow,\n      portalDOMContainer,\n      zIndex,\n      extraPopperStyles,\n    },\n    globalAttrs,\n    xStyledAttrs,\n    setPopperElement,\n    setArrowElement,\n    setIsAnimating,\n    popoverHelper,\n    isAnimating,\n  } = useConfigDSPopperjs(props);\n  const { children } = props;\n  const { styles, attributes } = popoverHelper;\n  const contentJSX = useMemo(\n    () => (\n      <PopoverContent\n        setPopperElement={setPopperElement}\n        popperStyles={{ ...styles.popper, ...extraPopperStyles }}\n        popperAttributes={attributes.popper}\n        setArrowElement={setArrowElement}\n        arrowStyle={styles.arrow}\n        withoutArrow={withoutArrow}\n        withoutAnimation={withoutAnimation}\n        animationDuration={animationDuration}\n        zIndex={zIndex}\n        showPopover={showPopover}\n        setIsAnimating={setIsAnimating}\n        globalAttrs={globalAttrs}\n        xStyledAttrs={xStyledAttrs}\n      >\n        {children}\n      </PopoverContent>\n    ),\n    [\n      attributes.popper,\n      children,\n      setIsAnimating,\n      showPopover,\n      extraPopperStyles,\n      setArrowElement,\n      setPopperElement,\n      styles.arrow,\n      styles.popper,\n      withoutArrow,\n      withoutAnimation,\n      animationDuration,\n      zIndex,\n      globalAttrs,\n      xStyledAttrs,\n    ],\n  );\n  if (showPopover || isAnimating) {\n    if (withoutPortal === true) return contentJSX;\n    if (portalDOMContainer && withoutPortal === false) return <>{createPortal(contentJSX, portalDOMContainer)}</>;\n  }\n  return null;\n};\n\nDSPopperJS.propTypes = dspopperjsPropTypes;\nDSPopperJS.displayName = 'DSPopperJS';\nconst DSPopperJSWithSchema = describe(DSPopperJS).description('A dimsum custom styling wrapper on top of popperjs');\nDSPopperJSWithSchema.propTypes = dspopperjsPropTypes;\n\nexport { DSPopperJS, DSPopperJSWithSchema };\nexport default DSPopperJS;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADgCjB;AAhCN,mBAA+B;AAC/B,uBAA6B;AAC7B,8BAAyB;AACzB,4BAA+B;AAC/B,iCAAoC;AAEpC,mCAAoC;AAEpC,MAAM,aAAqD,CAAC,UAAU;AACpE,QAAM;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,QAAI,gDAAoB,KAAK;AAC7B,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,QAAM,iBAAa;AAAA,IACjB,MACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,cAAc,EAAE,GAAG,OAAO,QAAQ,GAAG,kBAAkB;AAAA,QACvD,kBAAkB,WAAW;AAAA,QAC7B;AAAA,QACA,YAAY,OAAO;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QAEC;AAAA;AAAA,IACH;AAAA,IAEF;AAAA,MACE,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,eAAe,aAAa;AAC9B,QAAI,kBAAkB;AAAM,aAAO;AACnC,QAAI,sBAAsB,kBAAkB;AAAO,aAAO,2EAAG,6CAAa,YAAY,kBAAkB,GAAE;AAAA,EAC5G;AACA,SAAO;AACT;AAEA,WAAW,YAAY;AACvB,WAAW,cAAc;AACzB,MAAM,2BAAuB,kCAAS,UAAU,EAAE,YAAY,oDAAoD;AAClH,qBAAqB,YAAY;AAGjC,IAAO,cAAQ;",
   "names": []
 }

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

@@ -33,14 +33,32 @@ __export(react_desc_prop_types_exports, {
 module.exports = __toCommonJS(react_desc_prop_types_exports);
 var React = __toESM(require("react"));
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
+const placementPreferenceArray = [
+  "top-start",
+  "top",
+  "top-end",
+  "right-start",
+  "right",
+  "right-end",
+  "bottom-end",
+  "bottom",
+  "bottom-start",
+  "left-end",
+  "left",
+  "left-start"
+];
 const dspopperjsPropTypes = {
   ...import_ds_props_helpers.globalAttributesPropTypes,
   ...import_ds_props_helpers.xstyledPropTypes,
   /**
-   * React ref to popperjs referenceElement
+   * The content of the popper
+   */
+  children: import_ds_props_helpers.PropTypes.node.description("The content of the popper").isRequired,
+  /**
+   * The DOM element that needs to be used as a reference for positioning the popper.
    */
   referenceElement: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.instanceOf(Element), import_ds_props_helpers.PropTypes.oneOf([null])]).description(
-    "popperjs DOM referenceElement"
+    "The DOM element that needs to be used as a reference for positioning the popper."
   ).isRequired,
   /**
    * Wheter or not to show the popper content
@@ -69,68 +87,43 @@ const dspopperjsPropTypes = {
    *  Popper context menus Animation duration in ms
    */
   animationDuration: import_ds_props_helpers.PropTypes.number.description("Popper context menus Animation duration in ms").defaultValue(100),
-  /**
-   *  Bounding element to calculate upon, defaults to it is "clippingParents",
-   *   which are the scrolling containers that may cause the element to be partially or fully cut off.
-   */
-  boundaryElement: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.instanceOf(Element), import_ds_props_helpers.PropTypes.oneOf([null])]).description(
-    'Bounding element to calculate upon, defaults to "clippingParents",which are the scrolling containers that may cause element to be partially or fully cut off'
-  ).defaultValue(void 0),
-  /**
-   *  When using portal, the container in which to append the DOM content, defaults to document body
-   */
-  portalDOMContainer: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.instanceOf(Element), import_ds_props_helpers.PropTypes.oneOf([null])]).description("When using portal, the container in which to append the DOM content, defaults to document body").defaultValue(void 0),
   /**
    *  start placement preferences, as per popperjs placement option
    */
-  startPlacementPreference: import_ds_props_helpers.PropTypes.oneOf([
-    "top-start",
-    "top",
-    "top-end",
-    "right-start",
-    "right",
-    "right-end",
-    "bottom-end",
-    "bottom",
-    "bottom-start",
-    "left-end",
-    "left",
-    "left-start"
-  ]).description("start placement preferences, as per popperjs placement option").defaultValue("'top'"),
+  startPlacementPreference: import_ds_props_helpers.PropTypes.oneOf(placementPreferenceArray).description("start placement preferences, as per popperjs placement option").defaultValue("'top'"),
   /**
    *  Array of placement preferences, as per popperjs "flip" placement option
    */
-  placementOrderPreference: import_ds_props_helpers.PropTypes.arrayOf(
-    import_ds_props_helpers.PropTypes.oneOf([
-      "top-start",
-      "top",
-      "top-end",
-      "right-start",
-      "right",
-      "right-end",
-      "bottom-end",
-      "bottom",
-      "bottom-start",
-      "left-end",
-      "left",
-      "left-start"
-    ])
-  ).description('Array of placement preferences, as per popperjs "flip" placement option').defaultValue("['top', 'bottom', 'left', 'right']"),
+  placementOrderPreference: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.oneOf(placementPreferenceArray)).description('Array of placement preferences, as per popperjs "flip" placement option').defaultValue("['top', 'bottom', 'left', 'right']"),
   /**
    *  popperjs content z-index
    */
-  zIndex: import_ds_props_helpers.PropTypes.number.description("popperjs content z-index").defaultValue(1),
+  zIndex: import_ds_props_helpers.PropTypes.number.description("popperjs content z-index").defaultValue("theme.zIndex.popper"),
   /**
    *  placement offset array
    */
-  customOffset: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.number).description("placement offset array").defaultValue(1),
+  customOffset: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.number).description("placement offset array").defaultValue("[0,14]"),
+  extraPopperStyles: import_ds_props_helpers.PropTypes.object.description("Extra object styles to attach to the popper element").defaultValue({}),
+  onClickOutside: import_ds_props_helpers.PropTypes.func.description("Callback triggered when clicking outside the popper").defaultValue(() => null),
+  /**
+   *  Bounding element to calculate upon, defaults to it is "clippingParents",
+   *   which are the scrolling containers that may cause the element to be partially or fully cut off.
+   */
+  boundaryElement: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.instanceOf(Element), import_ds_props_helpers.PropTypes.oneOf([null])]).description(
+    'Bounding element to calculate upon, defaults to "clippingParents",which are the scrolling containers that may cause element to be partially or fully cut off'
+  ),
+  /**
+   *  When using portal, the container in which to append the DOM content, defaults to document body
+   */
+  portalDOMContainer: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.instanceOf(Element), import_ds_props_helpers.PropTypes.oneOf([null])]).description(
+    "When using portal, the container in which to append the DOM content, defaults to document body"
+  ),
   /**
    *  modifiers array for full-custom popper-js override
    *  https://popper.js.org/docs/v2/modifiers/
    */
-  modifiers: import_ds_props_helpers.PropTypes.array.description("modifiers array for full-custom popper-js override, https://popper.js.org/docs/v2/modifiers/").defaultValue(1),
-  extraPopperStyles: import_ds_props_helpers.PropTypes.object.description("Extra object styles to attach to the popper element").defaultValue({}),
-  onClickOutside: import_ds_props_helpers.PropTypes.func.description("Callback triggered when clicking outside the popper").defaultValue(() => null),
-  children: import_ds_props_helpers.PropTypes.node.description("The content of the popper").defaultValue(void 0)
+  modifiers: import_ds_props_helpers.PropTypes.array.description(
+    'If you provide the modifiers array for full-custom override in popper.js, it means you are responsible for completely overwriting all the existing modifiers. This includes the modifiers that control "boundaryElement," "withoutArrow," "placementOrderPreference," and "customOffset".For more detailed information, please refer to the documentation at https://popper.js.org/docs/v2/modifiers/.'
+  )
 };
 //# sourceMappingURL=react-desc-prop-types.js.map

package/dist/cjs/react-desc-prop-types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/react-desc-prop-types.ts", "../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import type React from 'react';\nimport type { WeakValidationMap } from 'react';\nimport { globalAttributesPropTypes, PropTypes, xstyledPropTypes } from '@elliemae/ds-props-helpers';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport type { usePopper } from 'react-popper';\n\nexport type PopperPlacementsT =\n  | 'top-start'\n  | 'top'\n  | 'top-end'\n  | 'right-start'\n  | 'right'\n  | 'right-end'\n  | 'bottom-end'\n  | 'bottom'\n  | 'bottom-start'\n  | 'left-end'\n  | 'left'\n  | 'left-start';\nexport interface UseDSPopperjsPropsArgT {\n  referenceElement: HTMLElement | null;\n  showPopover: boolean;\n  closeContextMenu?: () => void;\n  onClickOutside?: (e: MouseEvent | TouchEvent) => void;\n  withoutPortal?: boolean;\n  withoutArrow?: boolean;\n  withoutAnimation?: boolean;\n  animationDuration?: number;\n  boundaryElement?: HTMLElement;\n  portalDOMContainer?: HTMLElement;\n  placementOrderPreference?: PopperPlacementsT[];\n  startPlacementPreference?: PopperPlacementsT;\n  modifiers?: Record<string, unknown>[];\n  customOffset?: [number, number];\n  zIndex?: number;\n  extraPopperStyles?: Record<string, unknown>;\n}\nexport interface UseDSPopperjsRT {\n  props: Required<UseDSPopperjsPropsArgT>;\n  popperElement: HTMLDivElement | null;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  isAnimating: boolean;\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  arrowElement: HTMLDivElement | null;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popoverHelper: ReturnType<typeof usePopper>;\n  globalAttrs: GlobalAttributesT<Element>;\n  xStyledAttrs: XstyledProps;\n}\nexport interface DSDSPopperjsPropsT extends UseDSPopperjsPropsArgT {\n  children: JSX.Element | JSX.Element[];\n}\n\nexport const dspopperjsPropTypes = {\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  /**\n   * React ref to popperjs referenceElement\n   */\n  referenceElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'popperjs DOM referenceElement',\n  ).isRequired,\n  /**\n   * Wheter or not to show the popper content\n   */\n  showPopover: PropTypes.bool.description('whether or not to show the popper content').isRequired,\n  /**\n   * Callback to close the context menu, used for \"on click outside\",\n   *  if not provided click outside will not trigger anything\n   */\n  closeContextMenu: PropTypes.func\n    .description(\n      'Callback to close the context menu, used for \"on click outside\",' +\n        ' if not provided click outside will not trigger anything',\n    )\n    .defaultValue('() => {}'),\n  /**\n   *  Wheter or not the popper content should appear in a DOM portal or not\n   */\n  withoutPortal: PropTypes.bool\n    .description('Whether or not the popper content should appear in a DOM portal or not')\n    .defaultValue(true),\n  /**\n   *  Wheter or not the popper context menu should print the arrow\n   */\n  withoutArrow: PropTypes.bool\n    .description('Whether or not the popper context menu should print the arrow')\n    .defaultValue(false),\n  /**\n   *  Whether or not the popper context menu should be animated\n   */\n  withoutAnimation: PropTypes.bool\n    .description('Whether or not the popper context menu should be animated')\n    .defaultValue(false),\n  /**\n   *  Popper context menus Animation duration in ms\n   */\n  animationDuration: PropTypes.number.description('Popper context menus Animation duration in ms').defaultValue(100),\n  /**\n   *  Bounding element to calculate upon, defaults to it is \"clippingParents\",\n   *   which are the scrolling containers that may cause the element to be partially or fully cut off.\n   */\n  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])])\n    .description(\n      'Bounding element to calculate upon, defaults to \"clippingParents\",' +\n        'which are the scrolling containers that may cause element to be partially or fully cut off',\n    )\n    .defaultValue(undefined),\n  /**\n   *  When using portal, the container in which to append the DOM content, defaults to document body\n   */\n  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])])\n    .description('When using portal, the container in which to append the DOM content, defaults to document body')\n    .defaultValue(undefined),\n  /**\n   *  start placement preferences, as per popperjs placement option\n   */\n  startPlacementPreference: PropTypes.oneOf([\n    'top-start',\n    'top',\n    'top-end',\n    'right-start',\n    'right',\n    'right-end',\n    'bottom-end',\n    'bottom',\n    'bottom-start',\n    'left-end',\n    'left',\n    'left-start',\n  ])\n    .description('start placement preferences, as per popperjs placement option')\n    .defaultValue(\"'top'\"),\n  /**\n   *  Array of placement preferences, as per popperjs \"flip\" placement option\n   */\n  placementOrderPreference: PropTypes.arrayOf(\n    PropTypes.oneOf([\n      'top-start',\n      'top',\n      'top-end',\n      'right-start',\n      'right',\n      'right-end',\n      'bottom-end',\n      'bottom',\n      'bottom-start',\n      'left-end',\n      'left',\n      'left-start',\n    ]),\n  )\n    .description('Array of placement preferences, as per popperjs \"flip\" placement option')\n    .defaultValue(\"['top', 'bottom', 'left', 'right']\"),\n  /**\n   *  popperjs content z-index\n   */\n  zIndex: PropTypes.number.description('popperjs content z-index').defaultValue(1),\n  /**\n   *  placement offset array\n   */\n  customOffset: PropTypes.arrayOf(PropTypes.number).description('placement offset array').defaultValue(1),\n  /**\n   *  modifiers array for full-custom popper-js override\n   *  https://popper.js.org/docs/v2/modifiers/\n   */\n  modifiers: PropTypes.array\n    .description('modifiers array for full-custom popper-js override, https://popper.js.org/docs/v2/modifiers/')\n    .defaultValue(1),\n  extraPopperStyles: PropTypes.object\n    .description('Extra object styles to attach to the popper element')\n    .defaultValue({}),\n  onClickOutside: PropTypes.func\n    .description('Callback triggered when clicking outside the popper')\n    .defaultValue(() => null),\n  children: PropTypes.node.description('The content of the popper').defaultValue(undefined),\n} as WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEvB,8BAAuE;AAoDhE,MAAM,sBAAsB;AAAA,EACjC,GAAG;AAAA,EACH,GAAG;AAAA;AAAA;AAAA;AAAA,EAIH,kBAAkB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC9F;AAAA,EACF,EAAE;AAAA;AAAA;AAAA;AAAA,EAIF,aAAa,kCAAU,KAAK,YAAY,2CAA2C,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrF,kBAAkB,kCAAU,KACzB;AAAA,IACC;AAAA,EAEF,EACC,aAAa,UAAU;AAAA;AAAA;AAAA;AAAA,EAI1B,eAAe,kCAAU,KACtB,YAAY,wEAAwE,EACpF,aAAa,IAAI;AAAA;AAAA;AAAA;AAAA,EAIpB,cAAc,kCAAU,KACrB,YAAY,+DAA+D,EAC3E,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,kBAAkB,kCAAU,KACzB,YAAY,2DAA2D,EACvE,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,mBAAmB,kCAAU,OAAO,YAAY,+CAA+C,EAAE,aAAa,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjH,iBAAiB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAC1F;AAAA,IACC;AAAA,EAEF,EACC,aAAa,MAAS;AAAA;AAAA;AAAA;AAAA,EAIzB,oBAAoB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAC7F,YAAY,gGAAgG,EAC5G,aAAa,MAAS;AAAA;AAAA;AAAA;AAAA,EAIzB,0BAA0B,kCAAU,MAAM;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,EACE,YAAY,+DAA+D,EAC3E,aAAa,OAAO;AAAA;AAAA;AAAA;AAAA,EAIvB,0BAA0B,kCAAU;AAAA,IAClC,kCAAU,MAAM;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,EACG,YAAY,yEAAyE,EACrF,aAAa,oCAAoC;AAAA;AAAA;AAAA;AAAA,EAIpD,QAAQ,kCAAU,OAAO,YAAY,0BAA0B,EAAE,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA,EAI/E,cAAc,kCAAU,QAAQ,kCAAU,MAAM,EAAE,YAAY,wBAAwB,EAAE,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtG,WAAW,kCAAU,MAClB,YAAY,8FAA8F,EAC1G,aAAa,CAAC;AAAA,EACjB,mBAAmB,kCAAU,OAC1B,YAAY,qDAAqD,EACjE,aAAa,CAAC,CAAC;AAAA,EAClB,gBAAgB,kCAAU,KACvB,YAAY,qDAAqD,EACjE,aAAa,MAAM,IAAI;AAAA,EAC1B,UAAU,kCAAU,KAAK,YAAY,2BAA2B,EAAE,aAAa,MAAS;AAC1F;",
+  "sourcesContent": ["import {} from '@popperjs/core'; // fix for pnpm not portable typescript\nimport type { WeakValidationMap } from 'react';\nimport { globalAttributesPropTypes, PropTypes, xstyledPropTypes } from '@elliemae/ds-props-helpers';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport type { usePopper } from 'react-popper';\n\nexport declare namespace DSPopperJST {\n  export type PopperPlacementsT =\n    | 'top-start'\n    | 'top'\n    | 'top-end'\n    | 'right-start'\n    | 'right'\n    | 'right-end'\n    | 'bottom-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'left-end'\n    | 'left'\n    | 'left-start';\n  export interface DefaultProps {\n    closeContextMenu: () => void;\n    withoutPortal: boolean;\n    withoutArrow: boolean;\n    withoutAnimation: boolean;\n    animationDuration: number;\n    startPlacementPreference: PopperPlacementsT;\n    placementOrderPreference: PopperPlacementsT[];\n    zIndex: number;\n    extraPopperStyles: Record<string, unknown>;\n    onClickOutside: (e: MouseEvent | TouchEvent) => void;\n    customOffset: [number, number];\n  }\n  export interface OptionalProps {\n    boundaryElement?: HTMLElement;\n    portalDOMContainer?: HTMLElement;\n    modifiers?: NonNullable<Parameters<typeof usePopper>[2]>['modifiers'];\n  }\n  export interface RequiredProps {\n    children: ReactChildrenComplete;\n    referenceElement: HTMLElement;\n    showPopover: boolean;\n  }\n\n  export interface Props\n    extends Partial<DefaultProps>,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>,\n      Omit<XstyledProps, 'zIndex'>,\n      RequiredProps {}\n\n  export interface InternalProps\n    extends DefaultProps,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>,\n      Omit<XstyledProps, 'zIndex'>,\n      RequiredProps {}\n}\n\nconst placementPreferenceArray = [\n  'top-start',\n  'top',\n  'top-end',\n  'right-start',\n  'right',\n  'right-end',\n  'bottom-end',\n  'bottom',\n  'bottom-start',\n  'left-end',\n  'left',\n  'left-start',\n];\nexport const dspopperjsPropTypes = {\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  /**\n   * The content of the popper\n   */\n  children: PropTypes.node.description('The content of the popper').isRequired,\n  /**\n   * The DOM element that needs to be used as a reference for positioning the popper.\n   */\n  referenceElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'The DOM element that needs to be used as a reference for positioning the popper.',\n  ).isRequired,\n  /**\n   * Wheter or not to show the popper content\n   */\n  showPopover: PropTypes.bool.description('whether or not to show the popper content').isRequired,\n  /**\n   * Callback to close the context menu, used for \"on click outside\",\n   *  if not provided click outside will not trigger anything\n   */\n  closeContextMenu: PropTypes.func\n    .description(\n      'Callback to close the context menu, used for \"on click outside\",' +\n        ' if not provided click outside will not trigger anything',\n    )\n    .defaultValue('() => {}'),\n  /**\n   *  Wheter or not the popper content should appear in a DOM portal or not\n   */\n  withoutPortal: PropTypes.bool\n    .description('Whether or not the popper content should appear in a DOM portal or not')\n    .defaultValue(true),\n  /**\n   *  Wheter or not the popper context menu should print the arrow\n   */\n  withoutArrow: PropTypes.bool\n    .description('Whether or not the popper context menu should print the arrow')\n    .defaultValue(false),\n  /**\n   *  Whether or not the popper context menu should be animated\n   */\n  withoutAnimation: PropTypes.bool\n    .description('Whether or not the popper context menu should be animated')\n    .defaultValue(false),\n  /**\n   *  Popper context menus Animation duration in ms\n   */\n  animationDuration: PropTypes.number.description('Popper context menus Animation duration in ms').defaultValue(100),\n  /**\n   *  start placement preferences, as per popperjs placement option\n   */\n  startPlacementPreference: PropTypes.oneOf(placementPreferenceArray)\n    .description('start placement preferences, as per popperjs placement option')\n    .defaultValue(\"'top'\"),\n  /**\n   *  Array of placement preferences, as per popperjs \"flip\" placement option\n   */\n  placementOrderPreference: PropTypes.arrayOf(PropTypes.oneOf(placementPreferenceArray))\n    .description('Array of placement preferences, as per popperjs \"flip\" placement option')\n    .defaultValue(\"['top', 'bottom', 'left', 'right']\"),\n  /**\n   *  popperjs content z-index\n   */\n  zIndex: PropTypes.number.description('popperjs content z-index').defaultValue('theme.zIndex.popper'),\n  /**\n   *  placement offset array\n   */\n  customOffset: PropTypes.arrayOf(PropTypes.number).description('placement offset array').defaultValue('[0,14]'),\n  extraPopperStyles: PropTypes.object\n    .description('Extra object styles to attach to the popper element')\n    .defaultValue({}),\n  onClickOutside: PropTypes.func\n    .description('Callback triggered when clicking outside the popper')\n    .defaultValue(() => null),\n  /**\n   *  Bounding element to calculate upon, defaults to it is \"clippingParents\",\n   *   which are the scrolling containers that may cause the element to be partially or fully cut off.\n   */\n  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'Bounding element to calculate upon, defaults to \"clippingParents\",' +\n      'which are the scrolling containers that may cause element to be partially or fully cut off',\n  ),\n  /**\n   *  When using portal, the container in which to append the DOM content, defaults to document body\n   */\n  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'When using portal, the container in which to append the DOM content, defaults to document body',\n  ),\n  /**\n   *  modifiers array for full-custom popper-js override\n   *  https://popper.js.org/docs/v2/modifiers/\n   */\n  modifiers: PropTypes.array.description(\n    'If you provide the modifiers array for full-custom override in popper.js,' +\n      ' it means you are responsible for completely overwriting all the existing modifiers.' +\n      ' This includes the modifiers that control \"boundaryElement,\" \"withoutArrow,\" \"placementOrderPreference,\" and \"customOffset\".' +\n      'For more detailed information, please refer to the documentation at https://popper.js.org/docs/v2/modifiers/.',\n  ),\n} as WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEvB,8BAAuE;AA0DvE,MAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,MAAM,sBAAsB;AAAA,EACjC,GAAG;AAAA,EACH,GAAG;AAAA;AAAA;AAAA;AAAA,EAIH,UAAU,kCAAU,KAAK,YAAY,2BAA2B,EAAE;AAAA;AAAA;AAAA;AAAA,EAIlE,kBAAkB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC9F;AAAA,EACF,EAAE;AAAA;AAAA;AAAA;AAAA,EAIF,aAAa,kCAAU,KAAK,YAAY,2CAA2C,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrF,kBAAkB,kCAAU,KACzB;AAAA,IACC;AAAA,EAEF,EACC,aAAa,UAAU;AAAA;AAAA;AAAA;AAAA,EAI1B,eAAe,kCAAU,KACtB,YAAY,wEAAwE,EACpF,aAAa,IAAI;AAAA;AAAA;AAAA;AAAA,EAIpB,cAAc,kCAAU,KACrB,YAAY,+DAA+D,EAC3E,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,kBAAkB,kCAAU,KACzB,YAAY,2DAA2D,EACvE,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,mBAAmB,kCAAU,OAAO,YAAY,+CAA+C,EAAE,aAAa,GAAG;AAAA;AAAA;AAAA;AAAA,EAIjH,0BAA0B,kCAAU,MAAM,wBAAwB,EAC/D,YAAY,+DAA+D,EAC3E,aAAa,OAAO;AAAA;AAAA;AAAA;AAAA,EAIvB,0BAA0B,kCAAU,QAAQ,kCAAU,MAAM,wBAAwB,CAAC,EAClF,YAAY,yEAAyE,EACrF,aAAa,oCAAoC;AAAA;AAAA;AAAA;AAAA,EAIpD,QAAQ,kCAAU,OAAO,YAAY,0BAA0B,EAAE,aAAa,qBAAqB;AAAA;AAAA;AAAA;AAAA,EAInG,cAAc,kCAAU,QAAQ,kCAAU,MAAM,EAAE,YAAY,wBAAwB,EAAE,aAAa,QAAQ;AAAA,EAC7G,mBAAmB,kCAAU,OAC1B,YAAY,qDAAqD,EACjE,aAAa,CAAC,CAAC;AAAA,EAClB,gBAAgB,kCAAU,KACvB,YAAY,qDAAqD,EACjE,aAAa,MAAM,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,iBAAiB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC7F;AAAA,EAEF;AAAA;AAAA;AAAA;AAAA,EAIA,oBAAoB,kCAAU,UAAU,CAAC,kCAAU,WAAW,OAAO,GAAG,kCAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAChG;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,kCAAU,MAAM;AAAA,IACzB;AAAA,EAIF;AACF;",
   "names": []
 }

package/dist/esm/PopoverContent.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../scripts/build/transpile/react-shim.js", "../../src/PopoverContent.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useCallback, useMemo } from 'react';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport { PopoverArrow } from './PopoverArrow.js';\nimport { StyledPopoverContentWrapper, StyledAnimatedPopper } from './styled.js';\n\nexport interface PopoverContentPropsT {\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popperStyles: React.CSSProperties;\n  arrowStyle: React.CSSProperties;\n  popperAttributes: Record<string, string> | undefined;\n  children: JSX.Element | JSX.Element[];\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  withoutArrow: boolean;\n  withoutAnimation: boolean;\n  animationDuration: number;\n  zIndex: number;\n  showPopover: boolean;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  globalAttrs: GlobalAttributesT;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const PopoverContent = ({\n  setPopperElement,\n  popperStyles,\n  popperAttributes,\n  children,\n  showPopover,\n  setArrowElement,\n  setIsAnimating,\n  arrowStyle,\n  withoutArrow,\n  withoutAnimation,\n  animationDuration,\n  zIndex,\n  globalAttrs,\n  xStyledAttrs,\n}: PopoverContentPropsT): JSX.Element => {\n  const checkAnimationStatus = useCallback(() => {\n    if (!showPopover && !withoutAnimation) {\n      setIsAnimating(false);\n    }\n  }, [showPopover, withoutAnimation, setIsAnimating]);\n\n  const popperContent = useMemo(\n    () => (\n      <>\n        {children}\n        {withoutArrow === false ? (\n          <>\n            <PopoverArrow\n              arrowElementRef={setArrowElement}\n              style={arrowStyle}\n              placement={popperAttributes ? popperAttributes['data-popper-placement'] : 'bottom'}\n            />\n            <div ref={setArrowElement} style={arrowStyle} />\n          </>\n        ) : null}\n      </>\n    ),\n    [children, withoutArrow, arrowStyle, popperAttributes, setArrowElement],\n  );\n  return (\n    <StyledPopoverContentWrapper\n      ref={setPopperElement}\n      style={popperStyles}\n      {...popperAttributes}\n      {...globalAttrs}\n      {...xStyledAttrs}\n      zIndex={zIndex}\n    >\n      <StyledAnimatedPopper\n        showPopover={showPopover}\n        animationDuration={animationDuration}\n        withoutAnimation={withoutAnimation}\n        onAnimationEnd={checkAnimationStatus}\n      >\n        {popperContent}\n      </StyledAnimatedPopper>\n    </StyledPopoverContentWrapper>\n  );\n};\n"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useCallback, useMemo } from 'react';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport { PopoverArrow } from './PopoverArrow.js';\nimport { StyledPopoverContentWrapper, StyledAnimatedPopper } from './styled.js';\n\nexport interface PopoverContentPropsT {\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popperStyles: React.CSSProperties;\n  arrowStyle: React.CSSProperties;\n  popperAttributes: Record<string, string> | undefined;\n  children: ReactChildrenComplete;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  withoutArrow: boolean;\n  withoutAnimation: boolean;\n  animationDuration: number;\n  zIndex: number;\n  showPopover: boolean;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  globalAttrs: GlobalAttributesT;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const PopoverContent = ({\n  setPopperElement,\n  popperStyles,\n  popperAttributes,\n  children,\n  showPopover,\n  setArrowElement,\n  setIsAnimating,\n  arrowStyle,\n  withoutArrow,\n  withoutAnimation,\n  animationDuration,\n  zIndex,\n  globalAttrs,\n  xStyledAttrs,\n}: PopoverContentPropsT): JSX.Element => {\n  const checkAnimationStatus = useCallback(() => {\n    if (!showPopover && !withoutAnimation) {\n      setIsAnimating(false);\n    }\n  }, [showPopover, withoutAnimation, setIsAnimating]);\n\n  const popperContent = useMemo(\n    () => (\n      <>\n        {children}\n        {withoutArrow === false ? (\n          <>\n            <PopoverArrow\n              arrowElementRef={setArrowElement}\n              style={arrowStyle}\n              placement={popperAttributes ? popperAttributes['data-popper-placement'] : 'bottom'}\n            />\n            <div ref={setArrowElement} style={arrowStyle} />\n          </>\n        ) : null}\n      </>\n    ),\n    [children, withoutArrow, arrowStyle, popperAttributes, setArrowElement],\n  );\n  return (\n    <StyledPopoverContentWrapper\n      ref={setPopperElement}\n      style={popperStyles}\n      {...popperAttributes}\n      {...globalAttrs}\n      {...xStyledAttrs}\n      zIndex={zIndex}\n    >\n      <StyledAnimatedPopper\n        showPopover={showPopover}\n        animationDuration={animationDuration}\n        withoutAnimation={withoutAnimation}\n        onAnimationEnd={checkAnimationStatus}\n      >\n        {popperContent}\n      </StyledAnimatedPopper>\n    </StyledPopoverContentWrapper>\n  );\n};\n"],
   "mappings": "AAAA,YAAY,WAAW;ACkDb,mBACE,KADF;AAlDV,SAAgB,aAAa,eAAe;AAG5C,SAAS,oBAAoB;AAC7B,SAAS,6BAA6B,4BAA4B;AAmB3D,MAAM,iBAAiB,CAAC;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAyC;AACvC,QAAM,uBAAuB,YAAY,MAAM;AAC7C,QAAI,CAAC,eAAe,CAAC,kBAAkB;AACrC,qBAAe,KAAK;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,aAAa,kBAAkB,cAAc,CAAC;AAElD,QAAM,gBAAgB;AAAA,IACpB,MACE,iCACG;AAAA;AAAA,MACA,iBAAiB,QAChB,iCACE;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,iBAAiB;AAAA,YACjB,OAAO;AAAA,YACP,WAAW,mBAAmB,iBAAiB,uBAAuB,IAAI;AAAA;AAAA,QAC5E;AAAA,QACA,oBAAC,SAAI,KAAK,iBAAiB,OAAO,YAAY;AAAA,SAChD,IACE;AAAA,OACN;AAAA,IAEF,CAAC,UAAU,cAAc,YAAY,kBAAkB,eAAe;AAAA,EACxE;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL,OAAO;AAAA,MACN,GAAG;AAAA,MACH,GAAG;AAAA,MACH,GAAG;AAAA,MACJ;AAAA,MAEA;AAAA,QAAC;AAAA;AAAA,UACC;AAAA,UACA;AAAA,UACA;AAAA,UACA,gBAAgB;AAAA,UAEf;AAAA;AAAA,MACH;AAAA;AAAA,EACF;AAEJ;",
   "names": []
 }

package/dist/esm/config/useConfigDSPopperjs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/config/useConfigDSPopperjs.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo, useState, useEffect } from 'react';\nimport { usePopper } from 'react-popper';\nimport { useGetGlobalAttributes, useGetXstyledProps } from '@elliemae/ds-props-helpers';\nimport { useConfiguredMergedProps } from './useConfiguredMergedProps.js';\nimport type { UseDSPopperjsPropsArgT, UseDSPopperjsRT } from '../react-desc-prop-types.js';\nimport { useOnClickOutside } from '../utils/hooks/useOnClickOutside.js';\n\nexport const useConfigDSPopperjs = (appProps: UseDSPopperjsPropsArgT): UseDSPopperjsRT => {\n  const [popperElement, setPopperElement] = useState<HTMLDivElement | null>(null);\n  const [arrowElement, setArrowElement] = useState<HTMLDivElement | null>(null);\n  const [isAnimating, setIsAnimating] = useState(false);\n\n  const props = useConfiguredMergedProps({ props: appProps, arrowElement });\n  const { referenceElement, closeContextMenu, onClickOutside, modifiers, startPlacementPreference } = props;\n  const popperExtraOpts = useMemo(\n    () => ({ placement: startPlacementPreference, modifiers }),\n    [modifiers, startPlacementPreference],\n  );\n\n  const popoverHelper = usePopper(referenceElement, popperElement, popperExtraOpts);\n\n  const { showPopover, withoutAnimation } = props;\n\n  useEffect(() => {\n    if (showPopover && !withoutAnimation) {\n      setIsAnimating(true);\n    }\n  }, [showPopover, withoutAnimation]);\n\n  useOnClickOutside(popperElement as Node, (e) => {\n    if (!referenceElement?.contains?.(e?.target as Node)) {\n      onClickOutside(e);\n      closeContextMenu();\n    }\n  });\n\n  const globalAttrs = useGetGlobalAttributes(props);\n  const xStyledAttrs = useGetXstyledProps(props);\n\n  return useMemo(\n    () => ({\n      props,\n      popperElement,\n      setPopperElement,\n      arrowElement,\n      setArrowElement,\n      popoverHelper,\n      isAnimating,\n      setIsAnimating,\n      globalAttrs,\n      xStyledAttrs,\n    }),\n    [props, popperElement, arrowElement, popoverHelper, isAnimating, globalAttrs, xStyledAttrs],\n  );\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,SAAS,UAAU,iBAAiB;AAC7C,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB,0BAA0B;AAC3D,SAAS,gCAAgC;AAEzC,SAAS,yBAAyB;AAE3B,MAAM,sBAAsB,CAAC,aAAsD;AACxF,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAgC,IAAI;AAC9E,QAAM,CAAC,cAAc,eAAe,IAAI,SAAgC,IAAI;AAC5E,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,KAAK;AAEpD,QAAM,QAAQ,yBAAyB,EAAE,OAAO,UAAU,aAAa,CAAC;AACxE,QAAM,EAAE,kBAAkB,kBAAkB,gBAAgB,WAAW,yBAAyB,IAAI;AACpG,QAAM,kBAAkB;AAAA,IACtB,OAAO,EAAE,WAAW,0BAA0B,UAAU;AAAA,IACxD,CAAC,WAAW,wBAAwB;AAAA,EACtC;AAEA,QAAM,gBAAgB,UAAU,kBAAkB,eAAe,eAAe;AAEhF,QAAM,EAAE,aAAa,iBAAiB,IAAI;AAE1C,YAAU,MAAM;AACd,QAAI,eAAe,CAAC,kBAAkB;AACpC,qBAAe,IAAI;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,aAAa,gBAAgB,CAAC;AAElC,oBAAkB,eAAuB,CAAC,MAAM;AAC9C,QAAI,CAAC,kBAAkB,WAAW,GAAG,MAAc,GAAG;AACpD,qBAAe,CAAC;AAChB,uBAAiB;AAAA,IACnB;AAAA,EACF,CAAC;AAED,QAAM,cAAc,uBAAuB,KAAK;AAChD,QAAM,eAAe,mBAAmB,KAAK;AAE7C,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,OAAO,eAAe,cAAc,eAAe,aAAa,aAAa,YAAY;AAAA,EAC5F;AACF;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type React from 'react';\nimport { useMemo, useState, useEffect } from 'react';\nimport { usePopper } from 'react-popper';\nimport { useGetGlobalAttributes, useGetXstyledProps } from '@elliemae/ds-props-helpers';\nimport { useConfiguredMergedProps } from './useConfiguredMergedProps.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\nimport { useOnClickOutside } from '../utils/hooks/useOnClickOutside.js';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\ninterface UseDSPopperjsRT {\n  props: DSPopperJST.InternalProps;\n  popperElement: HTMLDivElement | null;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  isAnimating: boolean;\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  arrowElement: HTMLDivElement | null;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popoverHelper: ReturnType<typeof usePopper>;\n  globalAttrs: GlobalAttributesT<Element>;\n  xStyledAttrs: XstyledProps;\n}\n\nexport const useConfigDSPopperjs = (appProps: DSPopperJST.Props): UseDSPopperjsRT => {\n  const [popperElement, setPopperElement] = useState<HTMLDivElement | null>(null);\n  const [arrowElement, setArrowElement] = useState<HTMLDivElement | null>(null);\n  const [isAnimating, setIsAnimating] = useState(false);\n\n  const props = useConfiguredMergedProps({ props: appProps, arrowElement });\n  const { referenceElement, closeContextMenu, onClickOutside, modifiers, startPlacementPreference } = props;\n  const popperExtraOpts = useMemo(\n    () => ({ placement: startPlacementPreference, modifiers }),\n    [modifiers, startPlacementPreference],\n  );\n\n  const popoverHelper = usePopper(referenceElement, popperElement, popperExtraOpts);\n\n  const { showPopover, withoutAnimation } = props;\n\n  useEffect(() => {\n    if (showPopover && !withoutAnimation) {\n      setIsAnimating(true);\n    }\n  }, [showPopover, withoutAnimation]);\n\n  useOnClickOutside(popperElement as Node, (e) => {\n    if (!referenceElement?.contains?.(e?.target as Node)) {\n      onClickOutside(e);\n      closeContextMenu();\n    }\n  });\n\n  const globalAttrs = useGetGlobalAttributes(props);\n  const xStyledAttrs = useGetXstyledProps(props);\n\n  return useMemo(\n    () => ({\n      props,\n      popperElement,\n      setPopperElement,\n      arrowElement,\n      setArrowElement,\n      popoverHelper,\n      isAnimating,\n      setIsAnimating,\n      globalAttrs,\n      xStyledAttrs,\n    }),\n    [props, popperElement, arrowElement, popoverHelper, isAnimating, globalAttrs, xStyledAttrs],\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACCvB,SAAS,SAAS,UAAU,iBAAiB;AAC7C,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB,0BAA0B;AAC3D,SAAS,gCAAgC;AAEzC,SAAS,yBAAyB;AAe3B,MAAM,sBAAsB,CAAC,aAAiD;AACnF,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAgC,IAAI;AAC9E,QAAM,CAAC,cAAc,eAAe,IAAI,SAAgC,IAAI;AAC5E,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,KAAK;AAEpD,QAAM,QAAQ,yBAAyB,EAAE,OAAO,UAAU,aAAa,CAAC;AACxE,QAAM,EAAE,kBAAkB,kBAAkB,gBAAgB,WAAW,yBAAyB,IAAI;AACpG,QAAM,kBAAkB;AAAA,IACtB,OAAO,EAAE,WAAW,0BAA0B,UAAU;AAAA,IACxD,CAAC,WAAW,wBAAwB;AAAA,EACtC;AAEA,QAAM,gBAAgB,UAAU,kBAAkB,eAAe,eAAe;AAEhF,QAAM,EAAE,aAAa,iBAAiB,IAAI;AAE1C,YAAU,MAAM;AACd,QAAI,eAAe,CAAC,kBAAkB;AACpC,qBAAe,IAAI;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,aAAa,gBAAgB,CAAC;AAElC,oBAAkB,eAAuB,CAAC,MAAM;AAC9C,QAAI,CAAC,kBAAkB,WAAW,GAAG,MAAc,GAAG;AACpD,qBAAe,CAAC;AAChB,uBAAiB;AAAA,IACnB;AAAA,EACF,CAAC;AAED,QAAM,cAAc,uBAAuB,KAAK;AAChD,QAAM,eAAe,mBAAmB,KAAK;AAE7C,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,OAAO,eAAe,cAAc,eAAe,aAAa,aAAa,YAAY;AAAA,EAC5F;AACF;",
   "names": []
 }

package/dist/esm/config/useConfiguredDefaultModifiers.js

@@ -1,6 +1,10 @@
 import * as React from "react";
 import { useMemo } from "react";
-const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
+const useConfiguredDefaultModifiers = ({
+  props,
+  arrowElement,
+  defaultProps
+}) => {
   const {
     boundaryElement: explicitAppBoundaryElement,
     withoutArrow: explicitAppWithoutArrow = false,
@@ -17,7 +21,7 @@ const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
       }
     });
     if (!explicitAppWithoutArrow || explictAppOffset) {
-      const defaultOffset = explictAppOffset || [0, 14];
+      const defaultOffset = explictAppOffset || defaultProps.customOffset;
       mod.push({
         name: "offset",
         enabled: true,
@@ -44,6 +48,7 @@ const useConfiguredDefaultModifiers = ({ props, arrowElement }) => {
     return mod;
   }, [
     arrowElement,
+    defaultProps,
     explicitAppBoundaryElement,
     explicitAppWithoutArrow,
     explicitPlacementOrderPreference,

package/dist/esm/config/useConfiguredDefaultModifiers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/config/useConfiguredDefaultModifiers.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredDefaultModifiersT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultModifiers = ({ props, arrowElement }: UseConfiguredDefaultModifiersT) => {\n  // we destructure explicit app definitions before merge\n  const {\n    boundaryElement: explicitAppBoundaryElement,\n    withoutArrow: explicitAppWithoutArrow = false,\n    placementOrderPreference: explicitPlacementOrderPreference = ['top', 'bottom', 'left', 'right'],\n    customOffset: explictAppOffset = undefined,\n  } = props;\n  // to build default modifiers on top of it\n  const defaultModifiers = useMemo(() => {\n    const mod = [];\n    mod.push({ name: 'hide', enabled: true });\n    mod.push({\n      name: 'flip',\n      options: {\n        fallbackPlacements: explicitPlacementOrderPreference,\n      },\n    });\n    // we apply an offset if the app defines one or if the app wants the arrow\n    if (!explicitAppWithoutArrow || explictAppOffset) {\n      const defaultOffset = explictAppOffset || [0, 14];\n      mod.push({\n        name: 'offset',\n        enabled: true,\n        options: {\n          offset: defaultOffset,\n        },\n      });\n    }\n    // the app can opt for a \"no arrow\" implementation (we do so in datatable/calendar etc...)\n    if (!explicitAppWithoutArrow)\n      mod.push({\n        name: 'arrow',\n        options: {\n          element: arrowElement,\n          padding: 18,\n        },\n      });\n\n    // the app can define an explicit element to act as a boundary instead of popperjs default one\n    if (explicitAppBoundaryElement)\n      mod.push({\n        name: 'preventOverflow',\n        options: {\n          boundary: explicitAppBoundaryElement,\n        },\n      });\n    return mod;\n  }, [\n    arrowElement,\n    explicitAppBoundaryElement,\n    explicitAppWithoutArrow,\n    explicitPlacementOrderPreference,\n    explictAppOffset,\n  ]);\n  // if the app pass custom modifier, we don't use \"default modifiers\"\n  const { modifiers: explicitAppModifiers = defaultModifiers } = props;\n\n  return useMemo(\n    () => ({\n      modifiers: explicitAppModifiers,\n    }),\n    [explicitAppModifiers],\n  );\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AAQjB,MAAM,gCAAgC,CAAC,EAAE,OAAO,aAAa,MAAsC;AAExG,QAAM;AAAA,IACJ,iBAAiB;AAAA,IACjB,cAAc,0BAA0B;AAAA,IACxC,0BAA0B,mCAAmC,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,IAC9F,cAAc,mBAAmB;AAAA,EACnC,IAAI;AAEJ,QAAM,mBAAmB,QAAQ,MAAM;AACrC,UAAM,MAAM,CAAC;AACb,QAAI,KAAK,EAAE,MAAM,QAAQ,SAAS,KAAK,CAAC;AACxC,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,QACP,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAED,QAAI,CAAC,2BAA2B,kBAAkB;AAChD,YAAM,gBAAgB,oBAAoB,CAAC,GAAG,EAAE;AAChD,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,QACT,SAAS;AAAA,UACP,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,CAAC;AACH,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,MACF,CAAC;AAGH,QAAI;AACF,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF,CAAC;AACH,WAAO;AAAA,EACT,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,WAAW,uBAAuB,iBAAiB,IAAI;AAE/D,SAAO;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,IACb;AAAA,IACA,CAAC,oBAAoB;AAAA,EACvB;AACF;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredDefaultModifiersT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n  defaultProps: Omit<DSPopperJST.DefaultProps, 'zIndex'>;\n}\n\nexport const useConfiguredDefaultModifiers = ({\n  props,\n  arrowElement,\n  defaultProps,\n}: UseConfiguredDefaultModifiersT) => {\n  // we destructure explicit app definitions before merge\n  const {\n    boundaryElement: explicitAppBoundaryElement,\n    withoutArrow: explicitAppWithoutArrow = false,\n    placementOrderPreference: explicitPlacementOrderPreference = ['top', 'bottom', 'left', 'right'],\n    customOffset: explictAppOffset = undefined,\n  } = props;\n  // to build default modifiers on top of it\n  const defaultModifiers = useMemo(() => {\n    const mod = [];\n    mod.push({ name: 'hide', enabled: true });\n    mod.push({\n      name: 'flip',\n      options: {\n        fallbackPlacements: explicitPlacementOrderPreference,\n      },\n    });\n    // we apply an offset if the app defines one or if the app wants the arrow\n    if (!explicitAppWithoutArrow || explictAppOffset) {\n      const defaultOffset = explictAppOffset || defaultProps.customOffset;\n      mod.push({\n        name: 'offset',\n        enabled: true,\n        options: {\n          offset: defaultOffset,\n        },\n      });\n    }\n    // the app can opt for a \"no arrow\" implementation (we do so in datatable/calendar etc...)\n    if (!explicitAppWithoutArrow)\n      mod.push({\n        name: 'arrow',\n        options: {\n          element: arrowElement,\n          padding: 18,\n        },\n      });\n\n    // the app can define an explicit element to act as a boundary instead of popperjs default one\n    if (explicitAppBoundaryElement)\n      mod.push({\n        name: 'preventOverflow',\n        options: {\n          boundary: explicitAppBoundaryElement,\n        },\n      });\n    return mod;\n  }, [\n    arrowElement,\n    defaultProps,\n    explicitAppBoundaryElement,\n    explicitAppWithoutArrow,\n    explicitPlacementOrderPreference,\n    explictAppOffset,\n  ]);\n  // if the app pass custom modifier, we don't use \"default modifiers\"\n  const { modifiers: explicitAppModifiers = defaultModifiers } = props;\n\n  return useMemo(\n    () => ({\n      modifiers: explicitAppModifiers,\n    }),\n    [explicitAppModifiers],\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AASjB,MAAM,gCAAgC,CAAC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AACF,MAAsC;AAEpC,QAAM;AAAA,IACJ,iBAAiB;AAAA,IACjB,cAAc,0BAA0B;AAAA,IACxC,0BAA0B,mCAAmC,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,IAC9F,cAAc,mBAAmB;AAAA,EACnC,IAAI;AAEJ,QAAM,mBAAmB,QAAQ,MAAM;AACrC,UAAM,MAAM,CAAC;AACb,QAAI,KAAK,EAAE,MAAM,QAAQ,SAAS,KAAK,CAAC;AACxC,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,QACP,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAED,QAAI,CAAC,2BAA2B,kBAAkB;AAChD,YAAM,gBAAgB,oBAAoB,aAAa;AACvD,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,QACT,SAAS;AAAA,UACP,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,CAAC;AACH,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,MACF,CAAC;AAGH,QAAI;AACF,UAAI,KAAK;AAAA,QACP,MAAM;AAAA,QACN,SAAS;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF,CAAC;AACH,WAAO;AAAA,EACT,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,WAAW,uBAAuB,iBAAiB,IAAI;AAE/D,SAAO;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,IACb;AAAA,IACA,CAAC,oBAAoB;AAAA,EACvB;AACF;",
   "names": []
 }

package/dist/esm/config/useConfiguredDefaultProps.js

@@ -18,13 +18,15 @@ const useConfiguredDefaultProps = ({ props, arrowElement }) => {
       portalDOMContainer: document.body,
       startPlacementPreference: "top",
       placementOrderPreference: ["top", "bottom", "left", "right"],
-      extraPopperStyles: emptyObj
+      extraPopperStyles: emptyObj,
+      customOffset: [0, 14]
     }),
     []
   );
   const { modifiers: configuredModifiers } = useConfiguredDefaultModifiers({
     props,
-    arrowElement
+    arrowElement,
+    defaultProps: staticDefaultProps
   });
   const defaultProps = useMemo(
     () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),

package/dist/esm/config/useConfiguredDefaultProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/config/useConfiguredDefaultProps.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport { useConfiguredDefaultModifiers } from './useConfiguredDefaultModifiers.js';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\nconst noop = () => {};\n\nconst emptyObj = {};\n\ninterface UseConfiguredDefaultPropsT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultProps = ({ props, arrowElement }: Required<UseConfiguredDefaultPropsT>) => {\n  // don't move this out of the hook or `document.body` will explode\n  const staticDefaultProps: UseDSPopperjsPropsArgT = useMemo(\n    () => ({\n      referenceElement: null,\n      showPopover: false,\n      closeContextMenu: noop,\n      onClickOutside: noop,\n      withoutPortal: false,\n      withoutArrow: false,\n      withoutAnimation: false,\n      animationDuration: 100,\n      portalDOMContainer: document.body,\n      startPlacementPreference: 'top',\n      placementOrderPreference: ['top', 'bottom', 'left', 'right'],\n      extraPopperStyles: emptyObj,\n    }),\n    [],\n  );\n  const { modifiers: configuredModifiers } = useConfiguredDefaultModifiers({\n    props,\n    arrowElement,\n  });\n\n  const defaultProps = useMemo(\n    () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),\n    [configuredModifiers, staticDefaultProps],\n  );\n\n  return defaultProps;\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AACxB,SAAS,qCAAqC;AAG9C,MAAM,OAAO,MAAM;AAAC;AAEpB,MAAM,WAAW,CAAC;AAOX,MAAM,4BAA4B,CAAC,EAAE,OAAO,aAAa,MAA4C;AAE1G,QAAM,qBAA6C;AAAA,IACjD,OAAO;AAAA,MACL,kBAAkB;AAAA,MAClB,aAAa;AAAA,MACb,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,MACnB,oBAAoB,SAAS;AAAA,MAC7B,0BAA0B;AAAA,MAC1B,0BAA0B,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,MAC3D,mBAAmB;AAAA,IACrB;AAAA,IACA,CAAC;AAAA,EACH;AACA,QAAM,EAAE,WAAW,oBAAoB,IAAI,8BAA8B;AAAA,IACvE;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,eAAe;AAAA,IACnB,OAAO,EAAE,GAAG,oBAAoB,WAAW,oBAAoB;AAAA,IAC/D,CAAC,qBAAqB,kBAAkB;AAAA,EAC1C;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport { useConfiguredDefaultModifiers } from './useConfiguredDefaultModifiers.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\nconst noop = () => {};\n\nconst emptyObj = {};\n\ninterface UseConfiguredDefaultPropsT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredDefaultProps = ({ props, arrowElement }: Required<UseConfiguredDefaultPropsT>) => {\n  // the global object 'document' is in scope only if the staticDefaultProps is defined inside the react hook\n  //    moving this declaration outside of the hook will cause \"body.document\" to be undefined and cause an error\n  // we exclude zIndex from the staticDefaultProps because it is being applied from styled-components theme.props.popper\n  const staticDefaultProps: Omit<DSPopperJST.DefaultProps, 'zIndex'> = useMemo(\n    () => ({\n      referenceElement: null,\n      showPopover: false,\n      closeContextMenu: noop,\n      onClickOutside: noop,\n      withoutPortal: false,\n      withoutArrow: false,\n      withoutAnimation: false,\n      animationDuration: 100,\n      portalDOMContainer: document.body,\n      startPlacementPreference: 'top',\n      placementOrderPreference: ['top', 'bottom', 'left', 'right'],\n      extraPopperStyles: emptyObj,\n      customOffset: [0, 14],\n    }),\n    [],\n  );\n  const { modifiers: configuredModifiers } = useConfiguredDefaultModifiers({\n    props,\n    arrowElement,\n    defaultProps: staticDefaultProps,\n  });\n\n  const defaultProps = useMemo(\n    () => ({ ...staticDefaultProps, modifiers: configuredModifiers }),\n    [configuredModifiers, staticDefaultProps],\n  );\n\n  return defaultProps;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AACxB,SAAS,qCAAqC;AAG9C,MAAM,OAAO,MAAM;AAAC;AAEpB,MAAM,WAAW,CAAC;AAOX,MAAM,4BAA4B,CAAC,EAAE,OAAO,aAAa,MAA4C;AAI1G,QAAM,qBAA+D;AAAA,IACnE,OAAO;AAAA,MACL,kBAAkB;AAAA,MAClB,aAAa;AAAA,MACb,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,MACnB,oBAAoB,SAAS;AAAA,MAC7B,0BAA0B;AAAA,MAC1B,0BAA0B,CAAC,OAAO,UAAU,QAAQ,OAAO;AAAA,MAC3D,mBAAmB;AAAA,MACnB,cAAc,CAAC,GAAG,EAAE;AAAA,IACtB;AAAA,IACA,CAAC;AAAA,EACH;AACA,QAAM,EAAE,WAAW,oBAAoB,IAAI,8BAA8B;AAAA,IACvE;AAAA,IACA;AAAA,IACA,cAAc;AAAA,EAChB,CAAC;AAED,QAAM,eAAe;AAAA,IACnB,OAAO,EAAE,GAAG,oBAAoB,WAAW,oBAAoB;AAAA,IAC/D,CAAC,qBAAqB,kBAAkB;AAAA,EAC1C;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/esm/config/useConfiguredMergedProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/config/useConfiguredMergedProps.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useConfiguredDefaultProps } from './useConfiguredDefaultProps.js';\nimport type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredMergedPropsT {\n  props: UseDSPopperjsPropsArgT;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredMergedProps = ({ props, arrowElement }: UseConfiguredMergedPropsT) => {\n  const defaultProps = useConfiguredDefaultProps({ props, arrowElement });\n\n  return useMemoMergePropsWithDefault<Required<UseDSPopperjsPropsArgT>>(props, defaultProps);\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,oCAAoC;AAC7C,SAAS,iCAAiC;AAQnC,MAAM,2BAA2B,CAAC,EAAE,OAAO,aAAa,MAAiC;AAC9F,QAAM,eAAe,0BAA0B,EAAE,OAAO,aAAa,CAAC;AAEtE,SAAO,6BAA+D,OAAO,YAAY;AAC3F;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useConfiguredDefaultProps } from './useConfiguredDefaultProps.js';\nimport type { DSPopperJST } from '../react-desc-prop-types.js';\n\ninterface UseConfiguredMergedPropsT {\n  props: DSPopperJST.Props;\n  arrowElement: HTMLDivElement | null;\n}\n\nexport const useConfiguredMergedProps = ({ props, arrowElement }: UseConfiguredMergedPropsT) => {\n  const defaultProps = useConfiguredDefaultProps({ props, arrowElement });\n\n  return useMemoMergePropsWithDefault<DSPopperJST.InternalProps>(props, defaultProps);\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,oCAAoC;AAC7C,SAAS,iCAAiC;AAQnC,MAAM,2BAA2B,CAAC,EAAE,OAAO,aAAa,MAAiC;AAC9F,QAAM,eAAe,0BAA0B,EAAE,OAAO,aAAa,CAAC;AAEtE,SAAO,6BAAwD,OAAO,YAAY;AACpF;",
   "names": []
 }

package/dist/esm/index.js

@@ -69,7 +69,7 @@ const DSPopperJS = (props) => {
   if (showPopover || isAnimating) {
     if (withoutPortal === true)
       return contentJSX;
-    if (withoutPortal === false)
+    if (portalDOMContainer && withoutPortal === false)
       return /* @__PURE__ */ jsx(Fragment, { children: createPortal(contentJSX, portalDOMContainer) });
   }
   return null;

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../scripts/build/transpile/react-shim.js", "../../src/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useMemo } from 'react';\nimport { createPortal } from 'react-dom';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { PopoverContent } from './PopoverContent.js';\nimport { useConfigDSPopperjs } from './config/useConfigDSPopperjs.js';\nimport type { DSDSPopperjsPropsT } from './react-desc-prop-types.js';\nimport { dspopperjsPropTypes } from './react-desc-prop-types.js';\n\nconst DSPopperJS: React.ComponentType<DSDSPopperjsPropsT> = (props) => {\n  const {\n    props: {\n      showPopover,\n      withoutAnimation,\n      animationDuration,\n      withoutPortal,\n      withoutArrow,\n      portalDOMContainer,\n      zIndex,\n      extraPopperStyles,\n    },\n    globalAttrs,\n    xStyledAttrs,\n    setPopperElement,\n    setArrowElement,\n    setIsAnimating,\n    popoverHelper,\n    isAnimating,\n  } = useConfigDSPopperjs(props);\n  const { children } = props;\n  const { styles, attributes } = popoverHelper;\n  const contentJSX = useMemo(\n    () => (\n      <PopoverContent\n        setPopperElement={setPopperElement}\n        popperStyles={{ ...styles.popper, ...extraPopperStyles }}\n        popperAttributes={attributes.popper}\n        setArrowElement={setArrowElement}\n        arrowStyle={styles.arrow}\n        withoutArrow={withoutArrow}\n        withoutAnimation={withoutAnimation}\n        animationDuration={animationDuration}\n        zIndex={zIndex}\n        showPopover={showPopover}\n        setIsAnimating={setIsAnimating}\n        globalAttrs={globalAttrs}\n        xStyledAttrs={xStyledAttrs}\n      >\n        {children}\n      </PopoverContent>\n    ),\n    [\n      attributes.popper,\n      children,\n      setIsAnimating,\n      showPopover,\n      extraPopperStyles,\n      setArrowElement,\n      setPopperElement,\n      styles.arrow,\n      styles.popper,\n      withoutArrow,\n      withoutAnimation,\n      animationDuration,\n      zIndex,\n      globalAttrs,\n      xStyledAttrs,\n    ],\n  );\n  if (showPopover || isAnimating) {\n    if (withoutPortal === true) return contentJSX;\n    if (withoutPortal === false) return <>{createPortal(contentJSX, portalDOMContainer)}</>;\n  }\n  return null;\n};\n\nDSPopperJS.propTypes = dspopperjsPropTypes;\nDSPopperJS.displayName = 'DSPopperJS';\nconst DSPopperJSWithSchema = describe(DSPopperJS).description('A dimsum custom styling wrapper on top of popperjs');\nDSPopperJSWithSchema.propTypes = dspopperjsPropTypes;\n\nexport { DSPopperJS, DSPopperJSWithSchema };\nexport default DSPopperJS;\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACgCjB,SAsCkC,UAtClC;AAhCN,SAAgB,eAAe;AAC/B,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;AAEpC,SAAS,2BAA2B;AAEpC,MAAM,aAAsD,CAAC,UAAU;AACrE,QAAM;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,oBAAoB,KAAK;AAC7B,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,QAAM,aAAa;AAAA,IACjB,MACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,cAAc,EAAE,GAAG,OAAO,QAAQ,GAAG,kBAAkB;AAAA,QACvD,kBAAkB,WAAW;AAAA,QAC7B;AAAA,QACA,YAAY,OAAO;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QAEC;AAAA;AAAA,IACH;AAAA,IAEF;AAAA,MACE,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,eAAe,aAAa;AAC9B,QAAI,kBAAkB;AAAM,aAAO;AACnC,QAAI,kBAAkB;AAAO,aAAO,gCAAG,uBAAa,YAAY,kBAAkB,GAAE;AAAA,EACtF;AACA,SAAO;AACT;AAEA,WAAW,YAAY;AACvB,WAAW,cAAc;AACzB,MAAM,uBAAuB,SAAS,UAAU,EAAE,YAAY,oDAAoD;AAClH,qBAAqB,YAAY;AAGjC,IAAO,cAAQ;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useMemo } from 'react';\nimport { createPortal } from 'react-dom';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { PopoverContent } from './PopoverContent.js';\nimport { useConfigDSPopperjs } from './config/useConfigDSPopperjs.js';\nimport type { DSPopperJST } from './react-desc-prop-types.js';\nimport { dspopperjsPropTypes } from './react-desc-prop-types.js';\n\nconst DSPopperJS: React.ComponentType<DSPopperJST.Props> = (props) => {\n  const {\n    props: {\n      showPopover,\n      withoutAnimation,\n      animationDuration,\n      withoutPortal,\n      withoutArrow,\n      portalDOMContainer,\n      zIndex,\n      extraPopperStyles,\n    },\n    globalAttrs,\n    xStyledAttrs,\n    setPopperElement,\n    setArrowElement,\n    setIsAnimating,\n    popoverHelper,\n    isAnimating,\n  } = useConfigDSPopperjs(props);\n  const { children } = props;\n  const { styles, attributes } = popoverHelper;\n  const contentJSX = useMemo(\n    () => (\n      <PopoverContent\n        setPopperElement={setPopperElement}\n        popperStyles={{ ...styles.popper, ...extraPopperStyles }}\n        popperAttributes={attributes.popper}\n        setArrowElement={setArrowElement}\n        arrowStyle={styles.arrow}\n        withoutArrow={withoutArrow}\n        withoutAnimation={withoutAnimation}\n        animationDuration={animationDuration}\n        zIndex={zIndex}\n        showPopover={showPopover}\n        setIsAnimating={setIsAnimating}\n        globalAttrs={globalAttrs}\n        xStyledAttrs={xStyledAttrs}\n      >\n        {children}\n      </PopoverContent>\n    ),\n    [\n      attributes.popper,\n      children,\n      setIsAnimating,\n      showPopover,\n      extraPopperStyles,\n      setArrowElement,\n      setPopperElement,\n      styles.arrow,\n      styles.popper,\n      withoutArrow,\n      withoutAnimation,\n      animationDuration,\n      zIndex,\n      globalAttrs,\n      xStyledAttrs,\n    ],\n  );\n  if (showPopover || isAnimating) {\n    if (withoutPortal === true) return contentJSX;\n    if (portalDOMContainer && withoutPortal === false) return <>{createPortal(contentJSX, portalDOMContainer)}</>;\n  }\n  return null;\n};\n\nDSPopperJS.propTypes = dspopperjsPropTypes;\nDSPopperJS.displayName = 'DSPopperJS';\nconst DSPopperJSWithSchema = describe(DSPopperJS).description('A dimsum custom styling wrapper on top of popperjs');\nDSPopperJSWithSchema.propTypes = dspopperjsPropTypes;\n\nexport { DSPopperJS, DSPopperJSWithSchema };\nexport default DSPopperJS;\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACgCjB,SAsCwD,UAtCxD;AAhCN,SAAgB,eAAe;AAC/B,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;AAEpC,SAAS,2BAA2B;AAEpC,MAAM,aAAqD,CAAC,UAAU;AACpE,QAAM;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,oBAAoB,KAAK;AAC7B,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,QAAM,aAAa;AAAA,IACjB,MACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,cAAc,EAAE,GAAG,OAAO,QAAQ,GAAG,kBAAkB;AAAA,QACvD,kBAAkB,WAAW;AAAA,QAC7B;AAAA,QACA,YAAY,OAAO;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QAEC;AAAA;AAAA,IACH;AAAA,IAEF;AAAA,MACE,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,eAAe,aAAa;AAC9B,QAAI,kBAAkB;AAAM,aAAO;AACnC,QAAI,sBAAsB,kBAAkB;AAAO,aAAO,gCAAG,uBAAa,YAAY,kBAAkB,GAAE;AAAA,EAC5G;AACA,SAAO;AACT;AAEA,WAAW,YAAY;AACvB,WAAW,cAAc;AACzB,MAAM,uBAAuB,SAAS,UAAU,EAAE,YAAY,oDAAoD;AAClH,qBAAqB,YAAY;AAGjC,IAAO,cAAQ;",
   "names": []
 }

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

@@ -1,13 +1,31 @@
 import * as React from "react";
 import { globalAttributesPropTypes, PropTypes, xstyledPropTypes } from "@elliemae/ds-props-helpers";
+const placementPreferenceArray = [
+  "top-start",
+  "top",
+  "top-end",
+  "right-start",
+  "right",
+  "right-end",
+  "bottom-end",
+  "bottom",
+  "bottom-start",
+  "left-end",
+  "left",
+  "left-start"
+];
 const dspopperjsPropTypes = {
   ...globalAttributesPropTypes,
   ...xstyledPropTypes,
   /**
-   * React ref to popperjs referenceElement
+   * The content of the popper
+   */
+  children: PropTypes.node.description("The content of the popper").isRequired,
+  /**
+   * The DOM element that needs to be used as a reference for positioning the popper.
    */
   referenceElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(
-    "popperjs DOM referenceElement"
+    "The DOM element that needs to be used as a reference for positioning the popper."
   ).isRequired,
   /**
    * Wheter or not to show the popper content
@@ -36,69 +54,44 @@ const dspopperjsPropTypes = {
    *  Popper context menus Animation duration in ms
    */
   animationDuration: PropTypes.number.description("Popper context menus Animation duration in ms").defaultValue(100),
-  /**
-   *  Bounding element to calculate upon, defaults to it is "clippingParents",
-   *   which are the scrolling containers that may cause the element to be partially or fully cut off.
-   */
-  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(
-    'Bounding element to calculate upon, defaults to "clippingParents",which are the scrolling containers that may cause element to be partially or fully cut off'
-  ).defaultValue(void 0),
-  /**
-   *  When using portal, the container in which to append the DOM content, defaults to document body
-   */
-  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description("When using portal, the container in which to append the DOM content, defaults to document body").defaultValue(void 0),
   /**
    *  start placement preferences, as per popperjs placement option
    */
-  startPlacementPreference: PropTypes.oneOf([
-    "top-start",
-    "top",
-    "top-end",
-    "right-start",
-    "right",
-    "right-end",
-    "bottom-end",
-    "bottom",
-    "bottom-start",
-    "left-end",
-    "left",
-    "left-start"
-  ]).description("start placement preferences, as per popperjs placement option").defaultValue("'top'"),
+  startPlacementPreference: PropTypes.oneOf(placementPreferenceArray).description("start placement preferences, as per popperjs placement option").defaultValue("'top'"),
   /**
    *  Array of placement preferences, as per popperjs "flip" placement option
    */
-  placementOrderPreference: PropTypes.arrayOf(
-    PropTypes.oneOf([
-      "top-start",
-      "top",
-      "top-end",
-      "right-start",
-      "right",
-      "right-end",
-      "bottom-end",
-      "bottom",
-      "bottom-start",
-      "left-end",
-      "left",
-      "left-start"
-    ])
-  ).description('Array of placement preferences, as per popperjs "flip" placement option').defaultValue("['top', 'bottom', 'left', 'right']"),
+  placementOrderPreference: PropTypes.arrayOf(PropTypes.oneOf(placementPreferenceArray)).description('Array of placement preferences, as per popperjs "flip" placement option').defaultValue("['top', 'bottom', 'left', 'right']"),
   /**
    *  popperjs content z-index
    */
-  zIndex: PropTypes.number.description("popperjs content z-index").defaultValue(1),
+  zIndex: PropTypes.number.description("popperjs content z-index").defaultValue("theme.zIndex.popper"),
   /**
    *  placement offset array
    */
-  customOffset: PropTypes.arrayOf(PropTypes.number).description("placement offset array").defaultValue(1),
+  customOffset: PropTypes.arrayOf(PropTypes.number).description("placement offset array").defaultValue("[0,14]"),
+  extraPopperStyles: PropTypes.object.description("Extra object styles to attach to the popper element").defaultValue({}),
+  onClickOutside: PropTypes.func.description("Callback triggered when clicking outside the popper").defaultValue(() => null),
+  /**
+   *  Bounding element to calculate upon, defaults to it is "clippingParents",
+   *   which are the scrolling containers that may cause the element to be partially or fully cut off.
+   */
+  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(
+    'Bounding element to calculate upon, defaults to "clippingParents",which are the scrolling containers that may cause element to be partially or fully cut off'
+  ),
+  /**
+   *  When using portal, the container in which to append the DOM content, defaults to document body
+   */
+  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(
+    "When using portal, the container in which to append the DOM content, defaults to document body"
+  ),
   /**
    *  modifiers array for full-custom popper-js override
    *  https://popper.js.org/docs/v2/modifiers/
    */
-  modifiers: PropTypes.array.description("modifiers array for full-custom popper-js override, https://popper.js.org/docs/v2/modifiers/").defaultValue(1),
-  extraPopperStyles: PropTypes.object.description("Extra object styles to attach to the popper element").defaultValue({}),
-  onClickOutside: PropTypes.func.description("Callback triggered when clicking outside the popper").defaultValue(() => null),
-  children: PropTypes.node.description("The content of the popper").defaultValue(void 0)
+  modifiers: PropTypes.array.description(
+    'If you provide the modifiers array for full-custom override in popper.js, it means you are responsible for completely overwriting all the existing modifiers. This includes the modifiers that control "boundaryElement," "withoutArrow," "placementOrderPreference," and "customOffset".For more detailed information, please refer to the documentation at https://popper.js.org/docs/v2/modifiers/.'
+  )
 };
 export {
   dspopperjsPropTypes

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../scripts/build/transpile/react-shim.js", "../../src/react-desc-prop-types.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type React from 'react';\nimport type { WeakValidationMap } from 'react';\nimport { globalAttributesPropTypes, PropTypes, xstyledPropTypes } from '@elliemae/ds-props-helpers';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport type { usePopper } from 'react-popper';\n\nexport type PopperPlacementsT =\n  | 'top-start'\n  | 'top'\n  | 'top-end'\n  | 'right-start'\n  | 'right'\n  | 'right-end'\n  | 'bottom-end'\n  | 'bottom'\n  | 'bottom-start'\n  | 'left-end'\n  | 'left'\n  | 'left-start';\nexport interface UseDSPopperjsPropsArgT {\n  referenceElement: HTMLElement | null;\n  showPopover: boolean;\n  closeContextMenu?: () => void;\n  onClickOutside?: (e: MouseEvent | TouchEvent) => void;\n  withoutPortal?: boolean;\n  withoutArrow?: boolean;\n  withoutAnimation?: boolean;\n  animationDuration?: number;\n  boundaryElement?: HTMLElement;\n  portalDOMContainer?: HTMLElement;\n  placementOrderPreference?: PopperPlacementsT[];\n  startPlacementPreference?: PopperPlacementsT;\n  modifiers?: Record<string, unknown>[];\n  customOffset?: [number, number];\n  zIndex?: number;\n  extraPopperStyles?: Record<string, unknown>;\n}\nexport interface UseDSPopperjsRT {\n  props: Required<UseDSPopperjsPropsArgT>;\n  popperElement: HTMLDivElement | null;\n  setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;\n  isAnimating: boolean;\n  setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  arrowElement: HTMLDivElement | null;\n  setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;\n  popoverHelper: ReturnType<typeof usePopper>;\n  globalAttrs: GlobalAttributesT<Element>;\n  xStyledAttrs: XstyledProps;\n}\nexport interface DSDSPopperjsPropsT extends UseDSPopperjsPropsArgT {\n  children: JSX.Element | JSX.Element[];\n}\n\nexport const dspopperjsPropTypes = {\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  /**\n   * React ref to popperjs referenceElement\n   */\n  referenceElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'popperjs DOM referenceElement',\n  ).isRequired,\n  /**\n   * Wheter or not to show the popper content\n   */\n  showPopover: PropTypes.bool.description('whether or not to show the popper content').isRequired,\n  /**\n   * Callback to close the context menu, used for \"on click outside\",\n   *  if not provided click outside will not trigger anything\n   */\n  closeContextMenu: PropTypes.func\n    .description(\n      'Callback to close the context menu, used for \"on click outside\",' +\n        ' if not provided click outside will not trigger anything',\n    )\n    .defaultValue('() => {}'),\n  /**\n   *  Wheter or not the popper content should appear in a DOM portal or not\n   */\n  withoutPortal: PropTypes.bool\n    .description('Whether or not the popper content should appear in a DOM portal or not')\n    .defaultValue(true),\n  /**\n   *  Wheter or not the popper context menu should print the arrow\n   */\n  withoutArrow: PropTypes.bool\n    .description('Whether or not the popper context menu should print the arrow')\n    .defaultValue(false),\n  /**\n   *  Whether or not the popper context menu should be animated\n   */\n  withoutAnimation: PropTypes.bool\n    .description('Whether or not the popper context menu should be animated')\n    .defaultValue(false),\n  /**\n   *  Popper context menus Animation duration in ms\n   */\n  animationDuration: PropTypes.number.description('Popper context menus Animation duration in ms').defaultValue(100),\n  /**\n   *  Bounding element to calculate upon, defaults to it is \"clippingParents\",\n   *   which are the scrolling containers that may cause the element to be partially or fully cut off.\n   */\n  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])])\n    .description(\n      'Bounding element to calculate upon, defaults to \"clippingParents\",' +\n        'which are the scrolling containers that may cause element to be partially or fully cut off',\n    )\n    .defaultValue(undefined),\n  /**\n   *  When using portal, the container in which to append the DOM content, defaults to document body\n   */\n  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])])\n    .description('When using portal, the container in which to append the DOM content, defaults to document body')\n    .defaultValue(undefined),\n  /**\n   *  start placement preferences, as per popperjs placement option\n   */\n  startPlacementPreference: PropTypes.oneOf([\n    'top-start',\n    'top',\n    'top-end',\n    'right-start',\n    'right',\n    'right-end',\n    'bottom-end',\n    'bottom',\n    'bottom-start',\n    'left-end',\n    'left',\n    'left-start',\n  ])\n    .description('start placement preferences, as per popperjs placement option')\n    .defaultValue(\"'top'\"),\n  /**\n   *  Array of placement preferences, as per popperjs \"flip\" placement option\n   */\n  placementOrderPreference: PropTypes.arrayOf(\n    PropTypes.oneOf([\n      'top-start',\n      'top',\n      'top-end',\n      'right-start',\n      'right',\n      'right-end',\n      'bottom-end',\n      'bottom',\n      'bottom-start',\n      'left-end',\n      'left',\n      'left-start',\n    ]),\n  )\n    .description('Array of placement preferences, as per popperjs \"flip\" placement option')\n    .defaultValue(\"['top', 'bottom', 'left', 'right']\"),\n  /**\n   *  popperjs content z-index\n   */\n  zIndex: PropTypes.number.description('popperjs content z-index').defaultValue(1),\n  /**\n   *  placement offset array\n   */\n  customOffset: PropTypes.arrayOf(PropTypes.number).description('placement offset array').defaultValue(1),\n  /**\n   *  modifiers array for full-custom popper-js override\n   *  https://popper.js.org/docs/v2/modifiers/\n   */\n  modifiers: PropTypes.array\n    .description('modifiers array for full-custom popper-js override, https://popper.js.org/docs/v2/modifiers/')\n    .defaultValue(1),\n  extraPopperStyles: PropTypes.object\n    .description('Extra object styles to attach to the popper element')\n    .defaultValue({}),\n  onClickOutside: PropTypes.func\n    .description('Callback triggered when clicking outside the popper')\n    .defaultValue(() => null),\n  children: PropTypes.node.description('The content of the popper').defaultValue(undefined),\n} as WeakValidationMap<unknown>;\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACEvB,SAAS,2BAA2B,WAAW,wBAAwB;AAoDhE,MAAM,sBAAsB;AAAA,EACjC,GAAG;AAAA,EACH,GAAG;AAAA;AAAA;AAAA;AAAA,EAIH,kBAAkB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC9F;AAAA,EACF,EAAE;AAAA;AAAA;AAAA;AAAA,EAIF,aAAa,UAAU,KAAK,YAAY,2CAA2C,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrF,kBAAkB,UAAU,KACzB;AAAA,IACC;AAAA,EAEF,EACC,aAAa,UAAU;AAAA;AAAA;AAAA;AAAA,EAI1B,eAAe,UAAU,KACtB,YAAY,wEAAwE,EACpF,aAAa,IAAI;AAAA;AAAA;AAAA;AAAA,EAIpB,cAAc,UAAU,KACrB,YAAY,+DAA+D,EAC3E,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,kBAAkB,UAAU,KACzB,YAAY,2DAA2D,EACvE,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,mBAAmB,UAAU,OAAO,YAAY,+CAA+C,EAAE,aAAa,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjH,iBAAiB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAC1F;AAAA,IACC;AAAA,EAEF,EACC,aAAa,MAAS;AAAA;AAAA;AAAA;AAAA,EAIzB,oBAAoB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAC7F,YAAY,gGAAgG,EAC5G,aAAa,MAAS;AAAA;AAAA;AAAA;AAAA,EAIzB,0BAA0B,UAAU,MAAM;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,EACE,YAAY,+DAA+D,EAC3E,aAAa,OAAO;AAAA;AAAA;AAAA;AAAA,EAIvB,0BAA0B,UAAU;AAAA,IAClC,UAAU,MAAM;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,EACG,YAAY,yEAAyE,EACrF,aAAa,oCAAoC;AAAA;AAAA;AAAA;AAAA,EAIpD,QAAQ,UAAU,OAAO,YAAY,0BAA0B,EAAE,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA,EAI/E,cAAc,UAAU,QAAQ,UAAU,MAAM,EAAE,YAAY,wBAAwB,EAAE,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtG,WAAW,UAAU,MAClB,YAAY,8FAA8F,EAC1G,aAAa,CAAC;AAAA,EACjB,mBAAmB,UAAU,OAC1B,YAAY,qDAAqD,EACjE,aAAa,CAAC,CAAC;AAAA,EAClB,gBAAgB,UAAU,KACvB,YAAY,qDAAqD,EACjE,aAAa,MAAM,IAAI;AAAA,EAC1B,UAAU,UAAU,KAAK,YAAY,2BAA2B,EAAE,aAAa,MAAS;AAC1F;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import {} from '@popperjs/core'; // fix for pnpm not portable typescript\nimport type { WeakValidationMap } from 'react';\nimport { globalAttributesPropTypes, PropTypes, xstyledPropTypes } from '@elliemae/ds-props-helpers';\nimport type {} from '@elliemae/ds-utilities';\nimport type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';\nimport type { usePopper } from 'react-popper';\n\nexport declare namespace DSPopperJST {\n  export type PopperPlacementsT =\n    | 'top-start'\n    | 'top'\n    | 'top-end'\n    | 'right-start'\n    | 'right'\n    | 'right-end'\n    | 'bottom-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'left-end'\n    | 'left'\n    | 'left-start';\n  export interface DefaultProps {\n    closeContextMenu: () => void;\n    withoutPortal: boolean;\n    withoutArrow: boolean;\n    withoutAnimation: boolean;\n    animationDuration: number;\n    startPlacementPreference: PopperPlacementsT;\n    placementOrderPreference: PopperPlacementsT[];\n    zIndex: number;\n    extraPopperStyles: Record<string, unknown>;\n    onClickOutside: (e: MouseEvent | TouchEvent) => void;\n    customOffset: [number, number];\n  }\n  export interface OptionalProps {\n    boundaryElement?: HTMLElement;\n    portalDOMContainer?: HTMLElement;\n    modifiers?: NonNullable<Parameters<typeof usePopper>[2]>['modifiers'];\n  }\n  export interface RequiredProps {\n    children: ReactChildrenComplete;\n    referenceElement: HTMLElement;\n    showPopover: boolean;\n  }\n\n  export interface Props\n    extends Partial<DefaultProps>,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>,\n      Omit<XstyledProps, 'zIndex'>,\n      RequiredProps {}\n\n  export interface InternalProps\n    extends DefaultProps,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>,\n      Omit<XstyledProps, 'zIndex'>,\n      RequiredProps {}\n}\n\nconst placementPreferenceArray = [\n  'top-start',\n  'top',\n  'top-end',\n  'right-start',\n  'right',\n  'right-end',\n  'bottom-end',\n  'bottom',\n  'bottom-start',\n  'left-end',\n  'left',\n  'left-start',\n];\nexport const dspopperjsPropTypes = {\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  /**\n   * The content of the popper\n   */\n  children: PropTypes.node.description('The content of the popper').isRequired,\n  /**\n   * The DOM element that needs to be used as a reference for positioning the popper.\n   */\n  referenceElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'The DOM element that needs to be used as a reference for positioning the popper.',\n  ).isRequired,\n  /**\n   * Wheter or not to show the popper content\n   */\n  showPopover: PropTypes.bool.description('whether or not to show the popper content').isRequired,\n  /**\n   * Callback to close the context menu, used for \"on click outside\",\n   *  if not provided click outside will not trigger anything\n   */\n  closeContextMenu: PropTypes.func\n    .description(\n      'Callback to close the context menu, used for \"on click outside\",' +\n        ' if not provided click outside will not trigger anything',\n    )\n    .defaultValue('() => {}'),\n  /**\n   *  Wheter or not the popper content should appear in a DOM portal or not\n   */\n  withoutPortal: PropTypes.bool\n    .description('Whether or not the popper content should appear in a DOM portal or not')\n    .defaultValue(true),\n  /**\n   *  Wheter or not the popper context menu should print the arrow\n   */\n  withoutArrow: PropTypes.bool\n    .description('Whether or not the popper context menu should print the arrow')\n    .defaultValue(false),\n  /**\n   *  Whether or not the popper context menu should be animated\n   */\n  withoutAnimation: PropTypes.bool\n    .description('Whether or not the popper context menu should be animated')\n    .defaultValue(false),\n  /**\n   *  Popper context menus Animation duration in ms\n   */\n  animationDuration: PropTypes.number.description('Popper context menus Animation duration in ms').defaultValue(100),\n  /**\n   *  start placement preferences, as per popperjs placement option\n   */\n  startPlacementPreference: PropTypes.oneOf(placementPreferenceArray)\n    .description('start placement preferences, as per popperjs placement option')\n    .defaultValue(\"'top'\"),\n  /**\n   *  Array of placement preferences, as per popperjs \"flip\" placement option\n   */\n  placementOrderPreference: PropTypes.arrayOf(PropTypes.oneOf(placementPreferenceArray))\n    .description('Array of placement preferences, as per popperjs \"flip\" placement option')\n    .defaultValue(\"['top', 'bottom', 'left', 'right']\"),\n  /**\n   *  popperjs content z-index\n   */\n  zIndex: PropTypes.number.description('popperjs content z-index').defaultValue('theme.zIndex.popper'),\n  /**\n   *  placement offset array\n   */\n  customOffset: PropTypes.arrayOf(PropTypes.number).description('placement offset array').defaultValue('[0,14]'),\n  extraPopperStyles: PropTypes.object\n    .description('Extra object styles to attach to the popper element')\n    .defaultValue({}),\n  onClickOutside: PropTypes.func\n    .description('Callback triggered when clicking outside the popper')\n    .defaultValue(() => null),\n  /**\n   *  Bounding element to calculate upon, defaults to it is \"clippingParents\",\n   *   which are the scrolling containers that may cause the element to be partially or fully cut off.\n   */\n  boundaryElement: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'Bounding element to calculate upon, defaults to \"clippingParents\",' +\n      'which are the scrolling containers that may cause element to be partially or fully cut off',\n  ),\n  /**\n   *  When using portal, the container in which to append the DOM content, defaults to document body\n   */\n  portalDOMContainer: PropTypes.oneOfType([PropTypes.instanceOf(Element), PropTypes.oneOf([null])]).description(\n    'When using portal, the container in which to append the DOM content, defaults to document body',\n  ),\n  /**\n   *  modifiers array for full-custom popper-js override\n   *  https://popper.js.org/docs/v2/modifiers/\n   */\n  modifiers: PropTypes.array.description(\n    'If you provide the modifiers array for full-custom override in popper.js,' +\n      ' it means you are responsible for completely overwriting all the existing modifiers.' +\n      ' This includes the modifiers that control \"boundaryElement,\" \"withoutArrow,\" \"placementOrderPreference,\" and \"customOffset\".' +\n      'For more detailed information, please refer to the documentation at https://popper.js.org/docs/v2/modifiers/.',\n  ),\n} as WeakValidationMap<unknown>;\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEvB,SAAS,2BAA2B,WAAW,wBAAwB;AA0DvE,MAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,MAAM,sBAAsB;AAAA,EACjC,GAAG;AAAA,EACH,GAAG;AAAA;AAAA;AAAA;AAAA,EAIH,UAAU,UAAU,KAAK,YAAY,2BAA2B,EAAE;AAAA;AAAA;AAAA;AAAA,EAIlE,kBAAkB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC9F;AAAA,EACF,EAAE;AAAA;AAAA;AAAA;AAAA,EAIF,aAAa,UAAU,KAAK,YAAY,2CAA2C,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrF,kBAAkB,UAAU,KACzB;AAAA,IACC;AAAA,EAEF,EACC,aAAa,UAAU;AAAA;AAAA;AAAA;AAAA,EAI1B,eAAe,UAAU,KACtB,YAAY,wEAAwE,EACpF,aAAa,IAAI;AAAA;AAAA;AAAA;AAAA,EAIpB,cAAc,UAAU,KACrB,YAAY,+DAA+D,EAC3E,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,kBAAkB,UAAU,KACzB,YAAY,2DAA2D,EACvE,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIrB,mBAAmB,UAAU,OAAO,YAAY,+CAA+C,EAAE,aAAa,GAAG;AAAA;AAAA;AAAA;AAAA,EAIjH,0BAA0B,UAAU,MAAM,wBAAwB,EAC/D,YAAY,+DAA+D,EAC3E,aAAa,OAAO;AAAA;AAAA;AAAA;AAAA,EAIvB,0BAA0B,UAAU,QAAQ,UAAU,MAAM,wBAAwB,CAAC,EAClF,YAAY,yEAAyE,EACrF,aAAa,oCAAoC;AAAA;AAAA;AAAA;AAAA,EAIpD,QAAQ,UAAU,OAAO,YAAY,0BAA0B,EAAE,aAAa,qBAAqB;AAAA;AAAA;AAAA;AAAA,EAInG,cAAc,UAAU,QAAQ,UAAU,MAAM,EAAE,YAAY,wBAAwB,EAAE,aAAa,QAAQ;AAAA,EAC7G,mBAAmB,UAAU,OAC1B,YAAY,qDAAqD,EACjE,aAAa,CAAC,CAAC;AAAA,EAClB,gBAAgB,UAAU,KACvB,YAAY,qDAAqD,EACjE,aAAa,MAAM,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,iBAAiB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAC7F;AAAA,EAEF;AAAA;AAAA;AAAA;AAAA,EAIA,oBAAoB,UAAU,UAAU,CAAC,UAAU,WAAW,OAAO,GAAG,UAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;AAAA,IAChG;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,UAAU,MAAM;AAAA,IACzB;AAAA,EAIF;AACF;",
   "names": []
 }

package/dist/types/PopoverContent.d.ts

@@ -5,7 +5,7 @@ export interface PopoverContentPropsT {
     popperStyles: React.CSSProperties;
     arrowStyle: React.CSSProperties;
     popperAttributes: Record<string, string> | undefined;
-    children: JSX.Element | JSX.Element[];
+    children: ReactChildrenComplete;
     setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;
     withoutArrow: boolean;
     withoutAnimation: boolean;

package/dist/types/config/useConfigDSPopperjs.d.ts

@@ -1,2 +1,18 @@
-import type { UseDSPopperjsPropsArgT, UseDSPopperjsRT } from '../react-desc-prop-types.js';
-export declare const useConfigDSPopperjs: (appProps: UseDSPopperjsPropsArgT) => UseDSPopperjsRT;
+import type React from 'react';
+import { usePopper } from 'react-popper';
+import type { DSPopperJST } from '../react-desc-prop-types.js';
+import type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';
+interface UseDSPopperjsRT {
+    props: DSPopperJST.InternalProps;
+    popperElement: HTMLDivElement | null;
+    setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;
+    isAnimating: boolean;
+    setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;
+    arrowElement: HTMLDivElement | null;
+    setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;
+    popoverHelper: ReturnType<typeof usePopper>;
+    globalAttrs: GlobalAttributesT<Element>;
+    xStyledAttrs: XstyledProps;
+}
+export declare const useConfigDSPopperjs: (appProps: DSPopperJST.Props) => UseDSPopperjsRT;
+export {};

package/dist/types/config/useConfiguredDefaultModifiers.d.ts

@@ -1,9 +1,54 @@
-import type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';
+import type { DSPopperJST } from '../react-desc-prop-types.js';
 interface UseConfiguredDefaultModifiersT {
-    props: UseDSPopperjsPropsArgT;
+    props: DSPopperJST.Props;
     arrowElement: HTMLDivElement | null;
+    defaultProps: Omit<DSPopperJST.DefaultProps, 'zIndex'>;
 }
-export declare const useConfiguredDefaultModifiers: ({ props, arrowElement }: UseConfiguredDefaultModifiersT) => {
-    modifiers: Record<string, unknown>[];
+export declare const useConfiguredDefaultModifiers: ({ props, arrowElement, defaultProps, }: UseConfiguredDefaultModifiersT) => {
+    modifiers: readonly Partial<import("@popperjs/core/index.js").Modifier<unknown, object>>[] | ({
+        name: string;
+        enabled: boolean;
+        options?: undefined;
+    } | {
+        name: string;
+        options: {
+            fallbackPlacements: DSPopperJST.PopperPlacementsT[];
+            offset?: undefined;
+            element?: undefined;
+            padding?: undefined;
+            boundary?: undefined;
+        };
+        enabled?: undefined;
+    } | {
+        name: string;
+        enabled: boolean;
+        options: {
+            offset: [number, number];
+            fallbackPlacements?: undefined;
+            element?: undefined;
+            padding?: undefined;
+            boundary?: undefined;
+        };
+    } | {
+        name: string;
+        options: {
+            element: HTMLDivElement | null;
+            padding: number;
+            fallbackPlacements?: undefined;
+            offset?: undefined;
+            boundary?: undefined;
+        };
+        enabled?: undefined;
+    } | {
+        name: string;
+        options: {
+            boundary: HTMLElement;
+            fallbackPlacements?: undefined;
+            offset?: undefined;
+            element?: undefined;
+            padding?: undefined;
+        };
+        enabled?: undefined;
+    })[];
 };
 export {};

package/dist/types/config/useConfiguredDefaultProps.d.ts

@@ -1,24 +1,63 @@
-import type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';
+import type { DSPopperJST } from '../react-desc-prop-types.js';
 interface UseConfiguredDefaultPropsT {
-    props: UseDSPopperjsPropsArgT;
+    props: DSPopperJST.Props;
     arrowElement: HTMLDivElement | null;
 }
 export declare const useConfiguredDefaultProps: ({ props, arrowElement }: Required<UseConfiguredDefaultPropsT>) => {
-    modifiers: Record<string, unknown>[];
-    referenceElement: HTMLElement | null;
-    showPopover: boolean;
-    closeContextMenu?: (() => void) | undefined;
-    onClickOutside?: ((e: MouseEvent | TouchEvent) => void) | undefined;
-    withoutPortal?: boolean | undefined;
-    withoutArrow?: boolean | undefined;
-    withoutAnimation?: boolean | undefined;
-    animationDuration?: number | undefined;
-    boundaryElement?: HTMLElement | undefined;
-    portalDOMContainer?: HTMLElement | undefined;
-    placementOrderPreference?: import("../react-desc-prop-types.js").PopperPlacementsT[] | undefined;
-    startPlacementPreference?: import("../react-desc-prop-types.js").PopperPlacementsT | undefined;
-    customOffset?: [number, number] | undefined;
-    zIndex?: number | undefined;
-    extraPopperStyles?: Record<string, unknown> | undefined;
+    modifiers: readonly Partial<import("@popperjs/core/index.js").Modifier<unknown, object>>[] | ({
+        name: string;
+        enabled: boolean;
+        options?: undefined;
+    } | {
+        name: string;
+        options: {
+            fallbackPlacements: DSPopperJST.PopperPlacementsT[];
+            offset?: undefined;
+            element?: undefined;
+            padding?: undefined;
+            boundary?: undefined;
+        };
+        enabled?: undefined;
+    } | {
+        name: string;
+        enabled: boolean;
+        options: {
+            offset: [number, number];
+            fallbackPlacements?: undefined;
+            element?: undefined;
+            padding?: undefined;
+            boundary?: undefined;
+        };
+    } | {
+        name: string;
+        options: {
+            element: HTMLDivElement | null;
+            padding: number;
+            fallbackPlacements?: undefined;
+            offset?: undefined;
+            boundary?: undefined;
+        };
+        enabled?: undefined;
+    } | {
+        name: string;
+        options: {
+            boundary: HTMLElement;
+            fallbackPlacements?: undefined;
+            offset?: undefined;
+            element?: undefined;
+            padding?: undefined;
+        };
+        enabled?: undefined;
+    })[];
+    animationDuration: number;
+    withoutAnimation: boolean;
+    withoutArrow: boolean;
+    closeContextMenu: () => void;
+    withoutPortal: boolean;
+    startPlacementPreference: DSPopperJST.PopperPlacementsT;
+    placementOrderPreference: DSPopperJST.PopperPlacementsT[];
+    extraPopperStyles: Record<string, unknown>;
+    onClickOutside: (e: MouseEvent | TouchEvent) => void;
+    customOffset: [number, number];
 };
 export {};

package/dist/types/config/useConfiguredMergedProps.d.ts

@@ -1,7 +1,7 @@
-import type { UseDSPopperjsPropsArgT } from '../react-desc-prop-types.js';
+import type { DSPopperJST } from '../react-desc-prop-types.js';
 interface UseConfiguredMergedPropsT {
-    props: UseDSPopperjsPropsArgT;
+    props: DSPopperJST.Props;
     arrowElement: HTMLDivElement | null;
 }
-export declare const useConfiguredMergedProps: ({ props, arrowElement }: UseConfiguredMergedPropsT) => Required<UseDSPopperjsPropsArgT>;
+export declare const useConfiguredMergedProps: ({ props, arrowElement }: UseConfiguredMergedPropsT) => DSPopperJST.InternalProps;
 export {};

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { DSDSPopperjsPropsT } from './react-desc-prop-types.js';
-declare const DSPopperJS: React.ComponentType<DSDSPopperjsPropsT>;
-declare const DSPopperJSWithSchema: import("@elliemae/ds-props-helpers/dist/types/propTypes/types.js").DocumentedReactComponent<DSDSPopperjsPropsT>;
+import type { DSPopperJST } from './react-desc-prop-types.js';
+declare const DSPopperJS: React.ComponentType<DSPopperJST.Props>;
+declare const DSPopperJSWithSchema: import("@elliemae/ds-props-helpers/dist/types/propTypes/types.js").DocumentedReactComponent<DSPopperJST.Props>;
 export { DSPopperJS, DSPopperJSWithSchema };
 export default DSPopperJS;

package/dist/types/react-desc-prop-types.d.ts

@@ -1,38 +1,34 @@
-import type React from 'react';
+import type { WeakValidationMap } from 'react';
 import type { GlobalAttributesT, XstyledProps } from '@elliemae/ds-props-helpers';
 import type { usePopper } from 'react-popper';
-export type PopperPlacementsT = 'top-start' | 'top' | 'top-end' | 'right-start' | 'right' | 'right-end' | 'bottom-end' | 'bottom' | 'bottom-start' | 'left-end' | 'left' | 'left-start';
-export interface UseDSPopperjsPropsArgT {
-    referenceElement: HTMLElement | null;
-    showPopover: boolean;
-    closeContextMenu?: () => void;
-    onClickOutside?: (e: MouseEvent | TouchEvent) => void;
-    withoutPortal?: boolean;
-    withoutArrow?: boolean;
-    withoutAnimation?: boolean;
-    animationDuration?: number;
-    boundaryElement?: HTMLElement;
-    portalDOMContainer?: HTMLElement;
-    placementOrderPreference?: PopperPlacementsT[];
-    startPlacementPreference?: PopperPlacementsT;
-    modifiers?: Record<string, unknown>[];
-    customOffset?: [number, number];
-    zIndex?: number;
-    extraPopperStyles?: Record<string, unknown>;
+export declare namespace DSPopperJST {
+    type PopperPlacementsT = 'top-start' | 'top' | 'top-end' | 'right-start' | 'right' | 'right-end' | 'bottom-end' | 'bottom' | 'bottom-start' | 'left-end' | 'left' | 'left-start';
+    interface DefaultProps {
+        closeContextMenu: () => void;
+        withoutPortal: boolean;
+        withoutArrow: boolean;
+        withoutAnimation: boolean;
+        animationDuration: number;
+        startPlacementPreference: PopperPlacementsT;
+        placementOrderPreference: PopperPlacementsT[];
+        zIndex: number;
+        extraPopperStyles: Record<string, unknown>;
+        onClickOutside: (e: MouseEvent | TouchEvent) => void;
+        customOffset: [number, number];
+    }
+    interface OptionalProps {
+        boundaryElement?: HTMLElement;
+        portalDOMContainer?: HTMLElement;
+        modifiers?: NonNullable<Parameters<typeof usePopper>[2]>['modifiers'];
+    }
+    interface RequiredProps {
+        children: ReactChildrenComplete;
+        referenceElement: HTMLElement;
+        showPopover: boolean;
+    }
+    interface Props extends Partial<DefaultProps>, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>, Omit<XstyledProps, 'zIndex'>, RequiredProps {
+    }
+    interface InternalProps extends DefaultProps, OptionalProps, Omit<GlobalAttributesT<HTMLButtonElement>, keyof DefaultProps | keyof OptionalProps | keyof RequiredProps>, Omit<XstyledProps, 'zIndex'>, RequiredProps {
+    }
 }
-export interface UseDSPopperjsRT {
-    props: Required<UseDSPopperjsPropsArgT>;
-    popperElement: HTMLDivElement | null;
-    setIsAnimating: React.Dispatch<React.SetStateAction<boolean>>;
-    isAnimating: boolean;
-    setPopperElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;
-    arrowElement: HTMLDivElement | null;
-    setArrowElement: React.Dispatch<React.SetStateAction<HTMLDivElement | null>>;
-    popoverHelper: ReturnType<typeof usePopper>;
-    globalAttrs: GlobalAttributesT<Element>;
-    xStyledAttrs: XstyledProps;
-}
-export interface DSDSPopperjsPropsT extends UseDSPopperjsPropsArgT {
-    children: JSX.Element | JSX.Element[];
-}
-export declare const dspopperjsPropTypes: React.WeakValidationMap<unknown>;
+export declare const dspopperjsPropTypes: WeakValidationMap<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-popperjs",
-  "version": "3.18.0",
+  "version": "3.18.1",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Popper JS Wrapper",
   "files": [
@@ -73,9 +73,9 @@
   "dependencies": {
     "@xstyled/system": "~3.7.3",
     "react-popper": "~2.3.0",
-    "@elliemae/ds-props-helpers": "3.18.0",
-    "@elliemae/ds-system": "3.18.0",
-    "@elliemae/ds-utilities": "3.18.0"
+    "@elliemae/ds-system": "3.18.1",
+    "@elliemae/ds-props-helpers": "3.18.1",
+    "@elliemae/ds-utilities": "3.18.1"
   },
   "devDependencies": {
     "styled-components": "~5.3.9"