@workday/canvas-kit-react 9.0.8 → 9.0.10

package/dist/commonjs/popup/lib/Popper.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import * as PopperJS from '@popperjs/core';
-export declare type Placement = `${PopperJS.Placement}`;
-export declare type PopperOptions = PopperJS.Options;
+import { Placement as PopperJSPlacement, Options, Instance } from '@popperjs/core';
+export declare type Placement = `${PopperJSPlacement}`;
+export declare type PopperOptions = Options;
+export declare const defaultFallbackPlacements: Placement[];
 export interface PopperProps {
     /**
      * The reference element used to position the Popper. Popper content will try to follow the
@@ -39,6 +40,13 @@ export interface PopperProps {
      * @default bottom
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * A callback function that will be called whenever PopperJS chooses a placement that is different
      * from the provided `placement` preference. If a `placement` preference doesn't fit, PopperJS
@@ -61,7 +69,7 @@ export interface PopperProps {
      * Reference to the PopperJS instance. Useful for making direct method calls on the popper
      * instance like `update`.
      */
-    popperInstanceRef?: React.Ref<PopperJS.Instance>;
+    popperInstanceRef?: React.Ref<Instance>;
 }
 /**
  * A thin wrapper component around the Popper.js positioning engine. For reference:

package/dist/commonjs/popup/lib/Popper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/Popper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,oBAAY,SAAS,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;AAChD,oBAAY,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;AAK7C,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAC,SAAS,EAAE,SAAS,CAAA;KAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACjF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,oFAQlB,CAAC"}
+{"version":3,"file":"Popper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/Popper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAA0B,MAAM,gBAAgB,CAAC;AAE3G,oBAAY,SAAS,GAAG,GAAG,iBAAiB,EAAE,CAAC;AAC/C,oBAAY,aAAa,GAAG,OAAO,CAAC;AACpC,eAAO,MAAM,yBAAyB,EAAE,SAAS,EAAuC,CAAC;AAMzF,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAC,SAAS,EAAE,SAAS,CAAA;KAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACjF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,oFAQlB,CAAC"}

package/dist/commonjs/popup/lib/Popper.js

@@ -19,12 +19,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Popper = void 0;
+exports.Popper = exports.defaultFallbackPlacements = void 0;
 const React = __importStar(require("react"));
 const ReactDOM = __importStar(require("react-dom"));
-const PopperJS = __importStar(require("@popperjs/core"));
+const core_1 = require("@popperjs/core");
+exports.defaultFallbackPlacements = ['top', 'right', 'bottom', 'left'];
 const hooks_1 = require("./hooks");
 const common_1 = require("@workday/canvas-kit-react/common");
+const fallbackPlacements_1 = require("./fallbackPlacements");
 /**
  * A thin wrapper component around the Popper.js positioning engine. For reference:
  * https://popper.js.org/. `Popper` also automatically works with the {@link PopupStack} system.
@@ -61,19 +63,23 @@ const getElementFromRefOrElement = (input) => {
 const defaultPopperOptions = {};
 // Popper bails early if `open` is false and React hooks cannot be called conditionally,
 // so we're breaking out the open version into another component.
-const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, popperOptions = defaultPopperOptions, placement: popperPlacement = 'bottom', onPlacementChange, children, portal, popperInstanceRef, }, ref) => {
+const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, popperOptions = defaultPopperOptions, placement: popperPlacement = 'bottom', fallbackPlacements = exports.defaultFallbackPlacements, onPlacementChange, children, portal, popperInstanceRef, }, ref) => {
     const firstRender = React.useRef(true);
     const { localRef, elementRef } = common_1.useLocalRef(popperInstanceRef);
     const [placement, setPlacement] = React.useState(popperPlacement);
     const stackRef = hooks_1.usePopupStack(ref, anchorElement);
+    const placementRef = React.useRef(popperPlacement);
+    placementRef.current = placement;
     const placementModifier = React.useMemo(() => {
         return {
             name: 'setPlacement',
             enabled: true,
-            phase: 'main',
+            phase: 'afterWrite',
             fn({ state }) {
-                setPlacement(state.placement);
-                onPlacementChange === null || onPlacementChange === void 0 ? void 0 : onPlacementChange(state.placement);
+                if (placementRef.current !== state.placement) {
+                    setPlacement(state.placement);
+                    onPlacementChange === null || onPlacementChange === void 0 ? void 0 : onPlacementChange(state.placement);
+                }
             },
         };
     }, [setPlacement, onPlacementChange]);
@@ -87,10 +93,19 @@ const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, poppe
             return undefined;
         }
         if (stackRef.current) {
-            const instance = PopperJS.createPopper(anchorEl, stackRef.current, {
+            const instance = core_1.createPopper(anchorEl, stackRef.current, {
                 placement: popperPlacement,
                 ...popperOptions,
-                modifiers: [...(popperOptions.modifiers || []), placementModifier],
+                modifiers: [
+                    placementModifier,
+                    {
+                        ...fallbackPlacements_1.fallbackPlacementsModifier,
+                        options: {
+                            fallbackPlacements,
+                        },
+                    },
+                    ...(popperOptions.modifiers || []),
+                ],
             });
             elementRef(instance); // update the ref with the instance
             return () => {
@@ -110,11 +125,20 @@ const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, poppe
             (_a = localRef.current) === null || _a === void 0 ? void 0 : _a.setOptions({
                 placement: popperPlacement,
                 ...popperOptions,
-                modifiers: [...(popperOptions.modifiers || []), placementModifier],
+                modifiers: [
+                    placementModifier,
+                    {
+                        ...fallbackPlacements_1.fallbackPlacementsModifier,
+                        options: {
+                            fallbackPlacements,
+                        },
+                    },
+                    ...(popperOptions.modifiers || []),
+                ],
             });
         }
         firstRender.current = false;
-    }, [popperOptions, popperPlacement, placementModifier, localRef]);
+    }, [popperOptions, popperPlacement, fallbackPlacements, placementModifier, localRef]);
     const contents = React.createElement(React.Fragment, null, isRenderProp(children) ? children({ placement }) : children);
     if (!portal) {
         return contents;

package/dist/commonjs/popup/lib/PopupPopper.d.ts

@@ -8,6 +8,13 @@ export interface PopupPopperProps extends PopperProps {
      * @default bottom
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * The additional options passed to the Popper's `popper.js` instance.
      */

package/dist/commonjs/popup/lib/PopupPopper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PopupPopper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/PopupPopper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAC,SAAS,EAAE,aAAa,EAAU,WAAW,EAAC,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;EAMtB,CAAC"}
+{"version":3,"file":"PopupPopper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/PopupPopper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAC,SAAS,EAAE,aAAa,EAAU,WAAW,EAAC,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;EAMtB,CAAC"}

package/dist/commonjs/popup/lib/fallbackPlacements.d.ts

@@ -0,0 +1,9 @@
+import { Placement as PopperJSPlacement, Modifier } from '@popperjs/core';
+export declare type Placement = PopperJSPlacement;
+export declare type Options = {
+    fallbackPlacements: Placement[];
+};
+declare const name = "fallbackModifier";
+export declare const fallbackPlacementsModifier: Modifier<typeof name, Options>;
+export {};
+//# sourceMappingURL=fallbackPlacements.d.ts.map

package/dist/commonjs/popup/lib/fallbackPlacements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackPlacements.d.ts","sourceRoot":"","sources":["../../../../popup/lib/fallbackPlacements.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,IAAI,iBAAiB,EAK9B,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAExB,oBAAY,SAAS,GAAG,iBAAiB,CAAC;AAyD1C,oBAAY,OAAO,GAAG;IACpB,kBAAkB,EAAE,SAAS,EAAE,CAAC;CACjC,CAAC;AAEF,QAAA,MAAM,IAAI,qBAAqB,CAAC;AAEhC,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,OAAO,CAwBrE,CAAC"}

package/dist/commonjs/popup/lib/fallbackPlacements.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fallbackPlacementsModifier = void 0;
+const core_1 = require("@popperjs/core");
+const getOppositePlacement = (popperPlacement) => {
+    var _a;
+    const [first, second] = popperPlacement.split('-');
+    let oppositePlacement;
+    switch (first) {
+        case 'top':
+            oppositePlacement = 'bottom';
+            break;
+        case 'bottom':
+            oppositePlacement = 'top';
+            break;
+        case 'left':
+            oppositePlacement = 'right';
+            break;
+        case 'right':
+            oppositePlacement = 'left';
+            break;
+        default:
+            oppositePlacement = 'auto';
+    }
+    if (second) {
+        oppositePlacement =
+            (_a = core_1.placements.find(placement => placement.includes(`${oppositePlacement}-${second}`))) !== null && _a !== void 0 ? _a : oppositePlacement;
+    }
+    return oppositePlacement;
+};
+const choseAvailablePlacement = (placements, state, preferredPlacement) => {
+    if (placements.length === 0 || placements[0].split('-')[0] === 'auto') {
+        return preferredPlacement;
+    }
+    const { reference, popper } = state.rects;
+    const overflow = core_1.detectOverflow({ ...state, placement: placements[0] });
+    const direction = /left|right/.test(placements[0].split('-')[0]) ? 'horizontal' : 'vertical';
+    const isOverflowed = (overflow.top > 0 || overflow.bottom > 0 || overflow.left > 0 || overflow.right > 0) &&
+        (direction === 'horizontal'
+            ? popper.height / 2 - overflow.top < reference.height ||
+                popper.height / 2 - overflow.bottom < reference.height
+            : popper.width - overflow.left < reference.width ||
+                popper.width - overflow.right < reference.width);
+    const key = placements[0].split('-')[0];
+    if (!isOverflowed && overflow[key] <= 0) {
+        return placements[0];
+    }
+    else {
+        return choseAvailablePlacement(placements.slice(1), state, preferredPlacement);
+    }
+};
+const name = 'fallbackModifier';
+exports.fallbackPlacementsModifier = {
+    name: name,
+    enabled: true,
+    phase: 'main',
+    data: {
+        _skip: false,
+    },
+    fn({ state, options }) {
+        const preferredPlacement = state.options.placement;
+        const { fallbackPlacements } = options;
+        const placements = [
+            preferredPlacement,
+            getOppositePlacement(preferredPlacement),
+            ...(fallbackPlacements || []),
+        ];
+        const placementOverride = choseAvailablePlacement(placements, state, preferredPlacement);
+        if (state.placement !== placementOverride) {
+            state.modifiersData[name]._skip = true;
+            state.placement = placementOverride;
+            state.reset = true;
+        }
+    },
+};

package/dist/commonjs/popup/lib/hooks/usePopupPopper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePopupPopper.d.ts","sourceRoot":"","sources":["../../../../../popup/lib/hooks/usePopupPopper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;mCAGX,SAAS;EAevB,CAAC"}
+{"version":3,"file":"usePopupPopper.d.ts","sourceRoot":"","sources":["../../../../../popup/lib/hooks/usePopupPopper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;mCAOX,SAAS;EAevB,CAAC"}

package/dist/commonjs/popup/lib/hooks/usePopupPopper.js

@@ -13,12 +13,15 @@ const react_1 = __importDefault(require("react"));
  */
 exports.usePopupPopper = common_1.createElemPropsHook(usePopupModel_1.usePopupModel)(({ state, events }, ref) => {
     const elementRef = common_1.useForkRef(ref, state.stackRef);
+    // Create a mutable ref of the placement to keep a stable `onPlacementChange` reference.
+    const placementRef = react_1.default.useRef(state.placement);
+    placementRef.current = state.placement;
     const onPlacementChange = react_1.default.useCallback((placement) => {
-        if (placement !== state.placement) {
+        if (placement !== placementRef.current) {
             // only update if the placement has changed
             events.updatePlacement({ placement });
         }
-    }, [events, state.placement]);
+    }, [events]);
     return {
         open: state.visibility !== 'hidden',
         anchorElement: state.targetRef,

package/dist/commonjs/tooltip/lib/OverflowTooltip.d.ts

@@ -25,6 +25,13 @@ export interface OverflowTooltipProps extends Omit<React.HTMLAttributes<HTMLDivE
      * @default 'top'
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
 }
-export declare const OverflowTooltip: ({ placement, children, ...elemProps }: OverflowTooltipProps) => JSX.Element;
+export declare const OverflowTooltip: ({ placement, fallbackPlacements, children, ...elemProps }: OverflowTooltipProps) => JSX.Element;
 //# sourceMappingURL=OverflowTooltip.d.ts.map

package/dist/commonjs/tooltip/lib/OverflowTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverflowTooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/OverflowTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAA4B,SAAS,EAAS,MAAM,iCAAiC,CAAC;AAM7F;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAmBhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAahE,CAAC;AAcF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAiBD,eAAO,MAAM,eAAe,0CAIzB,oBAAoB,gBAwCtB,CAAC"}
+{"version":3,"file":"OverflowTooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/OverflowTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAEL,SAAS,EAGV,MAAM,iCAAiC,CAAC;AAMzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAmBhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAahE,CAAC;AAcF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;CAClC;AAiBD,eAAO,MAAM,eAAe,8DAKzB,oBAAoB,gBAwCtB,CAAC"}

package/dist/commonjs/tooltip/lib/OverflowTooltip.js

@@ -88,7 +88,7 @@ function mergeCallbacks(elemProps, componentProps, keys = Object.keys(componentP
         return mergedProps;
     }, {});
 }
-const OverflowTooltip = ({ placement = 'top', children, ...elemProps }) => {
+const OverflowTooltip = ({ placement = 'top', fallbackPlacements = popup_1.defaultFallbackPlacements, children, ...elemProps }) => {
     const [titleText, setTitleText] = React.useState('');
     const { targetProps, popperProps, tooltipProps } = useTooltip_1.useTooltip({ type: 'muted' });
     const onMouseEnter = (event) => {
@@ -113,7 +113,7 @@ const OverflowTooltip = ({ placement = 'top', children, ...elemProps }) => {
             'aria-label': undefined,
             ...mergeCallbacks({ ...targetProps, onMouseEnter, onFocus }, children.props),
         }),
-        React.createElement(popup_1.Popper, Object.assign({ placement: placement }, popperProps), ({ placement }) => {
+        React.createElement(popup_1.Popper, Object.assign({ placement: placement, fallbackPlacements: fallbackPlacements }, popperProps), ({ placement }) => {
             const transformOrigin = popup_1.getTransformFromPlacement(placement);
             return (React.createElement(TooltipContainer_1.TooltipContainer, Object.assign({ transformOrigin: transformOrigin }, tooltipProps, elemProps), titleText));
         })));

package/dist/commonjs/tooltip/lib/Tooltip.d.ts

@@ -20,6 +20,13 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      * @default 'top'
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * Determines the tooltip type for accessibility.
      *

package/dist/commonjs/tooltip/lib/Tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAA4B,SAAS,EAAS,MAAM,iCAAiC,CAAC;AAM7F,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACvF;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,eAAO,MAAM,OAAO,kFAyClB,CAAC"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,SAAS,EAGV,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACvF;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,eAAO,MAAM,OAAO,kFA0ClB,CAAC"}

package/dist/commonjs/tooltip/lib/Tooltip.js

@@ -42,7 +42,7 @@ function mergeCallbacks(elemProps, componentProps, keys = Object.keys(componentP
 }
 exports.Tooltip = common_1.createComponent('div')({
     displayName: 'Tooltip',
-    Component({ type = 'label', placement = 'top', title, children, showDelay = 300, hideDelay = 100, ...elemProps }) {
+    Component({ type = 'label', placement = 'top', title, children, showDelay = 300, hideDelay = 100, fallbackPlacements = popup_1.defaultFallbackPlacements, ...elemProps }) {
         const titleText = react_innertext_1.default(title);
         const { targetProps, popperProps, tooltipProps } = useTooltip_1.useTooltip({
             type,
@@ -58,7 +58,7 @@ exports.Tooltip = common_1.createComponent('div')({
                     ? { 'aria-label': children.props['aria-label'] }
                     : {}),
             }),
-            React.createElement(popup_1.Popper, Object.assign({ placement: placement }, popperProps), ({ placement }) => {
+            React.createElement(popup_1.Popper, Object.assign({ placement: placement, fallbackPlacements: fallbackPlacements }, popperProps), ({ placement }) => {
                 const transformOrigin = popup_1.getTransformFromPlacement(placement);
                 return (React.createElement(TooltipContainer_1.TooltipContainer, Object.assign({ transformOrigin: transformOrigin }, elemProps, tooltipProps), title));
             })));

package/dist/es6/popup/lib/Popper.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import * as PopperJS from '@popperjs/core';
-export declare type Placement = `${PopperJS.Placement}`;
-export declare type PopperOptions = PopperJS.Options;
+import { Placement as PopperJSPlacement, Options, Instance } from '@popperjs/core';
+export declare type Placement = `${PopperJSPlacement}`;
+export declare type PopperOptions = Options;
+export declare const defaultFallbackPlacements: Placement[];
 export interface PopperProps {
     /**
      * The reference element used to position the Popper. Popper content will try to follow the
@@ -39,6 +40,13 @@ export interface PopperProps {
      * @default bottom
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * A callback function that will be called whenever PopperJS chooses a placement that is different
      * from the provided `placement` preference. If a `placement` preference doesn't fit, PopperJS
@@ -61,7 +69,7 @@ export interface PopperProps {
      * Reference to the PopperJS instance. Useful for making direct method calls on the popper
      * instance like `update`.
      */
-    popperInstanceRef?: React.Ref<PopperJS.Instance>;
+    popperInstanceRef?: React.Ref<Instance>;
 }
 /**
  * A thin wrapper component around the Popper.js positioning engine. For reference:

package/dist/es6/popup/lib/Popper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/Popper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,oBAAY,SAAS,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;AAChD,oBAAY,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;AAK7C,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAC,SAAS,EAAE,SAAS,CAAA;KAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACjF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,oFAQlB,CAAC"}
+{"version":3,"file":"Popper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/Popper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAA0B,MAAM,gBAAgB,CAAC;AAE3G,oBAAY,SAAS,GAAG,GAAG,iBAAiB,EAAE,CAAC;AAC/C,oBAAY,aAAa,GAAG,OAAO,CAAC;AACpC,eAAO,MAAM,yBAAyB,EAAE,SAAS,EAAuC,CAAC;AAMzF,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1D;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAC,SAAS,EAAE,SAAS,CAAA;KAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACjF;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,oFAQlB,CAAC"}

package/dist/es6/popup/lib/Popper.js

@@ -1,8 +1,10 @@
 import * as React from 'react';
 import * as ReactDOM from 'react-dom';
-import * as PopperJS from '@popperjs/core';
+import { createPopper } from '@popperjs/core';
+export const defaultFallbackPlacements = ['top', 'right', 'bottom', 'left'];
 import { usePopupStack } from './hooks';
 import { useLocalRef } from '@workday/canvas-kit-react/common';
+import { fallbackPlacementsModifier } from './fallbackPlacements';
 /**
  * A thin wrapper component around the Popper.js positioning engine. For reference:
  * https://popper.js.org/. `Popper` also automatically works with the {@link PopupStack} system.
@@ -39,19 +41,23 @@ const getElementFromRefOrElement = (input) => {
 const defaultPopperOptions = {};
 // Popper bails early if `open` is false and React hooks cannot be called conditionally,
 // so we're breaking out the open version into another component.
-const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, popperOptions = defaultPopperOptions, placement: popperPlacement = 'bottom', onPlacementChange, children, portal, popperInstanceRef, }, ref) => {
+const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, popperOptions = defaultPopperOptions, placement: popperPlacement = 'bottom', fallbackPlacements = defaultFallbackPlacements, onPlacementChange, children, portal, popperInstanceRef, }, ref) => {
     const firstRender = React.useRef(true);
     const { localRef, elementRef } = useLocalRef(popperInstanceRef);
     const [placement, setPlacement] = React.useState(popperPlacement);
     const stackRef = usePopupStack(ref, anchorElement);
+    const placementRef = React.useRef(popperPlacement);
+    placementRef.current = placement;
     const placementModifier = React.useMemo(() => {
         return {
             name: 'setPlacement',
             enabled: true,
-            phase: 'main',
+            phase: 'afterWrite',
             fn({ state }) {
-                setPlacement(state.placement);
-                onPlacementChange === null || onPlacementChange === void 0 ? void 0 : onPlacementChange(state.placement);
+                if (placementRef.current !== state.placement) {
+                    setPlacement(state.placement);
+                    onPlacementChange === null || onPlacementChange === void 0 ? void 0 : onPlacementChange(state.placement);
+                }
             },
         };
     }, [setPlacement, onPlacementChange]);
@@ -65,10 +71,19 @@ const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, poppe
             return undefined;
         }
         if (stackRef.current) {
-            const instance = PopperJS.createPopper(anchorEl, stackRef.current, {
+            const instance = createPopper(anchorEl, stackRef.current, {
                 placement: popperPlacement,
                 ...popperOptions,
-                modifiers: [...(popperOptions.modifiers || []), placementModifier],
+                modifiers: [
+                    placementModifier,
+                    {
+                        ...fallbackPlacementsModifier,
+                        options: {
+                            fallbackPlacements,
+                        },
+                    },
+                    ...(popperOptions.modifiers || []),
+                ],
             });
             elementRef(instance); // update the ref with the instance
             return () => {
@@ -88,11 +103,20 @@ const OpenPopper = React.forwardRef(({ anchorElement, getAnchorClientRect, poppe
             (_a = localRef.current) === null || _a === void 0 ? void 0 : _a.setOptions({
                 placement: popperPlacement,
                 ...popperOptions,
-                modifiers: [...(popperOptions.modifiers || []), placementModifier],
+                modifiers: [
+                    placementModifier,
+                    {
+                        ...fallbackPlacementsModifier,
+                        options: {
+                            fallbackPlacements,
+                        },
+                    },
+                    ...(popperOptions.modifiers || []),
+                ],
             });
         }
         firstRender.current = false;
-    }, [popperOptions, popperPlacement, placementModifier, localRef]);
+    }, [popperOptions, popperPlacement, fallbackPlacements, placementModifier, localRef]);
     const contents = React.createElement(React.Fragment, null, isRenderProp(children) ? children({ placement }) : children);
     if (!portal) {
         return contents;

package/dist/es6/popup/lib/PopupPopper.d.ts

@@ -8,6 +8,13 @@ export interface PopupPopperProps extends PopperProps {
      * @default bottom
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * The additional options passed to the Popper's `popper.js` instance.
      */

package/dist/es6/popup/lib/PopupPopper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PopupPopper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/PopupPopper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAC,SAAS,EAAE,aAAa,EAAU,WAAW,EAAC,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;EAMtB,CAAC"}
+{"version":3,"file":"PopupPopper.d.ts","sourceRoot":"","sources":["../../../../popup/lib/PopupPopper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAC,SAAS,EAAE,aAAa,EAAU,WAAW,EAAC,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;EAMtB,CAAC"}

package/dist/es6/popup/lib/fallbackPlacements.d.ts

@@ -0,0 +1,9 @@
+import { Placement as PopperJSPlacement, Modifier } from '@popperjs/core';
+export declare type Placement = PopperJSPlacement;
+export declare type Options = {
+    fallbackPlacements: Placement[];
+};
+declare const name = "fallbackModifier";
+export declare const fallbackPlacementsModifier: Modifier<typeof name, Options>;
+export {};
+//# sourceMappingURL=fallbackPlacements.d.ts.map

package/dist/es6/popup/lib/fallbackPlacements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackPlacements.d.ts","sourceRoot":"","sources":["../../../../popup/lib/fallbackPlacements.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,IAAI,iBAAiB,EAK9B,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAExB,oBAAY,SAAS,GAAG,iBAAiB,CAAC;AAyD1C,oBAAY,OAAO,GAAG;IACpB,kBAAkB,EAAE,SAAS,EAAE,CAAC;CACjC,CAAC;AAEF,QAAA,MAAM,IAAI,qBAAqB,CAAC;AAEhC,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,OAAO,CAwBrE,CAAC"}

package/dist/es6/popup/lib/fallbackPlacements.js

@@ -0,0 +1,72 @@
+import { placements, detectOverflow, } from '@popperjs/core';
+const getOppositePlacement = (popperPlacement) => {
+    var _a;
+    const [first, second] = popperPlacement.split('-');
+    let oppositePlacement;
+    switch (first) {
+        case 'top':
+            oppositePlacement = 'bottom';
+            break;
+        case 'bottom':
+            oppositePlacement = 'top';
+            break;
+        case 'left':
+            oppositePlacement = 'right';
+            break;
+        case 'right':
+            oppositePlacement = 'left';
+            break;
+        default:
+            oppositePlacement = 'auto';
+    }
+    if (second) {
+        oppositePlacement =
+            (_a = placements.find(placement => placement.includes(`${oppositePlacement}-${second}`))) !== null && _a !== void 0 ? _a : oppositePlacement;
+    }
+    return oppositePlacement;
+};
+const choseAvailablePlacement = (placements, state, preferredPlacement) => {
+    if (placements.length === 0 || placements[0].split('-')[0] === 'auto') {
+        return preferredPlacement;
+    }
+    const { reference, popper } = state.rects;
+    const overflow = detectOverflow({ ...state, placement: placements[0] });
+    const direction = /left|right/.test(placements[0].split('-')[0]) ? 'horizontal' : 'vertical';
+    const isOverflowed = (overflow.top > 0 || overflow.bottom > 0 || overflow.left > 0 || overflow.right > 0) &&
+        (direction === 'horizontal'
+            ? popper.height / 2 - overflow.top < reference.height ||
+                popper.height / 2 - overflow.bottom < reference.height
+            : popper.width - overflow.left < reference.width ||
+                popper.width - overflow.right < reference.width);
+    const key = placements[0].split('-')[0];
+    if (!isOverflowed && overflow[key] <= 0) {
+        return placements[0];
+    }
+    else {
+        return choseAvailablePlacement(placements.slice(1), state, preferredPlacement);
+    }
+};
+const name = 'fallbackModifier';
+export const fallbackPlacementsModifier = {
+    name: name,
+    enabled: true,
+    phase: 'main',
+    data: {
+        _skip: false,
+    },
+    fn({ state, options }) {
+        const preferredPlacement = state.options.placement;
+        const { fallbackPlacements } = options;
+        const placements = [
+            preferredPlacement,
+            getOppositePlacement(preferredPlacement),
+            ...(fallbackPlacements || []),
+        ];
+        const placementOverride = choseAvailablePlacement(placements, state, preferredPlacement);
+        if (state.placement !== placementOverride) {
+            state.modifiersData[name]._skip = true;
+            state.placement = placementOverride;
+            state.reset = true;
+        }
+    },
+};

package/dist/es6/popup/lib/hooks/usePopupPopper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePopupPopper.d.ts","sourceRoot":"","sources":["../../../../../popup/lib/hooks/usePopupPopper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;mCAGX,SAAS;EAevB,CAAC"}
+{"version":3,"file":"usePopupPopper.d.ts","sourceRoot":"","sources":["../../../../../popup/lib/hooks/usePopupPopper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;mCAOX,SAAS;EAevB,CAAC"}

package/dist/es6/popup/lib/hooks/usePopupPopper.js

@@ -7,12 +7,15 @@ import React from 'react';
  */
 export const usePopupPopper = createElemPropsHook(usePopupModel)(({ state, events }, ref) => {
     const elementRef = useForkRef(ref, state.stackRef);
+    // Create a mutable ref of the placement to keep a stable `onPlacementChange` reference.
+    const placementRef = React.useRef(state.placement);
+    placementRef.current = state.placement;
     const onPlacementChange = React.useCallback((placement) => {
-        if (placement !== state.placement) {
+        if (placement !== placementRef.current) {
             // only update if the placement has changed
             events.updatePlacement({ placement });
         }
-    }, [events, state.placement]);
+    }, [events]);
     return {
         open: state.visibility !== 'hidden',
         anchorElement: state.targetRef,

package/dist/es6/tooltip/lib/OverflowTooltip.d.ts

@@ -25,6 +25,13 @@ export interface OverflowTooltipProps extends Omit<React.HTMLAttributes<HTMLDivE
      * @default 'top'
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
 }
-export declare const OverflowTooltip: ({ placement, children, ...elemProps }: OverflowTooltipProps) => JSX.Element;
+export declare const OverflowTooltip: ({ placement, fallbackPlacements, children, ...elemProps }: OverflowTooltipProps) => JSX.Element;
 //# sourceMappingURL=OverflowTooltip.d.ts.map

package/dist/es6/tooltip/lib/OverflowTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverflowTooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/OverflowTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAA4B,SAAS,EAAS,MAAM,iCAAiC,CAAC;AAM7F;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAmBhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAahE,CAAC;AAcF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAiBD,eAAO,MAAM,eAAe,0CAIzB,oBAAoB,gBAwCtB,CAAC"}
+{"version":3,"file":"OverflowTooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/OverflowTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAEL,SAAS,EAGV,MAAM,iCAAiC,CAAC;AAMzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAmBhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,OAAO,GAAG,IAahE,CAAC;AAcF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/F;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;CAClC;AAiBD,eAAO,MAAM,eAAe,8DAKzB,oBAAoB,gBAwCtB,CAAC"}

package/dist/es6/tooltip/lib/OverflowTooltip.js

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { getTransformFromPlacement, Popper } from '@workday/canvas-kit-react/popup';
+import { getTransformFromPlacement, Popper, defaultFallbackPlacements, } from '@workday/canvas-kit-react/popup';
 import { mergeCallback } from '@workday/canvas-kit-react/common';
 import { TooltipContainer } from './TooltipContainer';
 import { useTooltip } from './useTooltip';
@@ -64,7 +64,7 @@ function mergeCallbacks(elemProps, componentProps, keys = Object.keys(componentP
         return mergedProps;
     }, {});
 }
-export const OverflowTooltip = ({ placement = 'top', children, ...elemProps }) => {
+export const OverflowTooltip = ({ placement = 'top', fallbackPlacements = defaultFallbackPlacements, children, ...elemProps }) => {
     const [titleText, setTitleText] = React.useState('');
     const { targetProps, popperProps, tooltipProps } = useTooltip({ type: 'muted' });
     const onMouseEnter = (event) => {
@@ -89,7 +89,7 @@ export const OverflowTooltip = ({ placement = 'top', children, ...elemProps }) =
             'aria-label': undefined,
             ...mergeCallbacks({ ...targetProps, onMouseEnter, onFocus }, children.props),
         }),
-        React.createElement(Popper, Object.assign({ placement: placement }, popperProps), ({ placement }) => {
+        React.createElement(Popper, Object.assign({ placement: placement, fallbackPlacements: fallbackPlacements }, popperProps), ({ placement }) => {
             const transformOrigin = getTransformFromPlacement(placement);
             return (React.createElement(TooltipContainer, Object.assign({ transformOrigin: transformOrigin }, tooltipProps, elemProps), titleText));
         })));

package/dist/es6/tooltip/lib/Tooltip.d.ts

@@ -20,6 +20,13 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      * @default 'top'
      */
     placement?: Placement;
+    /**
+     * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+     * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+     * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+     * disable the fallback placements.
+     */
+    fallbackPlacements?: Placement[];
     /**
      * Determines the tooltip type for accessibility.
      *

package/dist/es6/tooltip/lib/Tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAA4B,SAAS,EAAS,MAAM,iCAAiC,CAAC;AAM7F,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACvF;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,eAAO,MAAM,OAAO,kFAyClB,CAAC"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../tooltip/lib/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,SAAS,EAGV,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IACvF;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD,eAAO,MAAM,OAAO,kFA0ClB,CAAC"}

package/dist/es6/tooltip/lib/Tooltip.js

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import innerText from 'react-innertext';
-import { getTransformFromPlacement, Popper } from '@workday/canvas-kit-react/popup';
+import { getTransformFromPlacement, Popper, defaultFallbackPlacements, } from '@workday/canvas-kit-react/popup';
 import { createComponent, mergeCallback } from '@workday/canvas-kit-react/common';
 import { TooltipContainer } from './TooltipContainer';
 import { useTooltip } from './useTooltip';
@@ -17,7 +17,7 @@ function mergeCallbacks(elemProps, componentProps, keys = Object.keys(componentP
 }
 export const Tooltip = createComponent('div')({
     displayName: 'Tooltip',
-    Component({ type = 'label', placement = 'top', title, children, showDelay = 300, hideDelay = 100, ...elemProps }) {
+    Component({ type = 'label', placement = 'top', title, children, showDelay = 300, hideDelay = 100, fallbackPlacements = defaultFallbackPlacements, ...elemProps }) {
         const titleText = innerText(title);
         const { targetProps, popperProps, tooltipProps } = useTooltip({
             type,
@@ -33,7 +33,7 @@ export const Tooltip = createComponent('div')({
                     ? { 'aria-label': children.props['aria-label'] }
                     : {}),
             }),
-            React.createElement(Popper, Object.assign({ placement: placement }, popperProps), ({ placement }) => {
+            React.createElement(Popper, Object.assign({ placement: placement, fallbackPlacements: fallbackPlacements }, popperProps), ({ placement }) => {
                 const transformOrigin = getTransformFromPlacement(placement);
                 return (React.createElement(TooltipContainer, Object.assign({ transformOrigin: transformOrigin }, elemProps, tooltipProps), title));
             })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workday/canvas-kit-react",
-  "version": "9.0.8",
+  "version": "9.0.10",
   "description": "The parent module that contains all Workday Canvas Kit React components",
   "author": "Workday, Inc. (https://www.workday.com)",
   "license": "Apache-2.0",
@@ -49,7 +49,7 @@
     "@emotion/styled": "^11.6.0",
     "@popperjs/core": "^2.5.4",
     "@workday/canvas-colors-web": "^2.0.0",
-    "@workday/canvas-kit-popup-stack": "^9.0.8",
+    "@workday/canvas-kit-popup-stack": "^9.0.10",
     "@workday/canvas-system-icons-web": "^3.0.0",
     "@workday/design-assets-types": "^0.2.8",
     "chroma-js": "^2.1.0",
@@ -66,5 +66,5 @@
     "@workday/canvas-accent-icons-web": "^3.0.0",
     "@workday/canvas-applet-icons-web": "^2.0.0"
   },
-  "gitHead": "e0f80f6255d61eceeb79932d6a1bae3d9adeffdc"
+  "gitHead": "8fa72860c376f39967e95014afe43664f55d1683"
 }

package/popup/lib/Popper.tsx

@@ -1,12 +1,14 @@
 import * as React from 'react';
 import * as ReactDOM from 'react-dom';
-import * as PopperJS from '@popperjs/core';
+import { Placement as PopperJSPlacement, Options, Instance, Modifier, createPopper } from '@popperjs/core';
 
-export type Placement = `${PopperJS.Placement}`; // Use template literals to make documentation list them out
-export type PopperOptions = PopperJS.Options;
+export type Placement = `${PopperJSPlacement}`; // Use template literals to make documentation list them out
+export type PopperOptions = Options;
+export const defaultFallbackPlacements: Placement[] = ['top', 'right', 'bottom', 'left'];
 
 import {usePopupStack} from './hooks';
 import {useLocalRef} from '@workday/canvas-kit-react/common';
+import {fallbackPlacementsModifier} from './fallbackPlacements';
 
 export interface PopperProps {
   /**
@@ -43,6 +45,13 @@ export interface PopperProps {
    * @default bottom
    */
   placement?: Placement;
+  /**
+   * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+   * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+   * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+   * disable the fallback placements.
+   */
+  fallbackPlacements?: Placement[];
   /**
    * A callback function that will be called whenever PopperJS chooses a placement that is different
    * from the provided `placement` preference. If a `placement` preference doesn't fit, PopperJS
@@ -65,7 +74,7 @@ export interface PopperProps {
    * Reference to the PopperJS instance. Useful for making direct method calls on the popper
    * instance like `update`.
    */
-  popperInstanceRef?: React.Ref<PopperJS.Instance>;
+  popperInstanceRef?: React.Ref<Instance>;
 }
 
 /**
@@ -117,6 +126,7 @@ const OpenPopper = React.forwardRef<HTMLDivElement, PopperProps>(
       getAnchorClientRect,
       popperOptions = defaultPopperOptions,
       placement: popperPlacement = 'bottom',
+      fallbackPlacements = defaultFallbackPlacements,
       onPlacementChange,
       children,
       portal,
@@ -129,14 +139,19 @@ const OpenPopper = React.forwardRef<HTMLDivElement, PopperProps>(
     const [placement, setPlacement] = React.useState(popperPlacement);
     const stackRef = usePopupStack(ref, anchorElement as HTMLElement);
 
-    const placementModifier = React.useMemo((): PopperJS.Modifier<any, any> => {
+    const placementRef = React.useRef(popperPlacement);
+    placementRef.current = placement;
+
+    const placementModifier = React.useMemo((): Modifier<any, any> => {
       return {
         name: 'setPlacement',
         enabled: true,
-        phase: 'main',
+        phase: 'afterWrite',
         fn({state}) {
-          setPlacement(state.placement);
-          onPlacementChange?.(state.placement);
+          if (placementRef.current !== state.placement) {
+            setPlacement(state.placement);
+            onPlacementChange?.(state.placement);
+          }
         },
       };
     }, [setPlacement, onPlacementChange]);
@@ -154,10 +169,19 @@ const OpenPopper = React.forwardRef<HTMLDivElement, PopperProps>(
       }
 
       if (stackRef.current) {
-        const instance = PopperJS.createPopper(anchorEl, stackRef.current, {
+        const instance = createPopper(anchorEl, stackRef.current, {
           placement: popperPlacement,
           ...popperOptions,
-          modifiers: [...(popperOptions.modifiers || []), placementModifier],
+          modifiers: [
+            placementModifier,      
+            {
+              ...fallbackPlacementsModifier,
+              options: {
+                fallbackPlacements,
+              },
+            },
+            ...(popperOptions.modifiers || []),
+          ],
         });
         elementRef(instance); // update the ref with the instance
 
@@ -179,11 +203,20 @@ const OpenPopper = React.forwardRef<HTMLDivElement, PopperProps>(
         localRef.current?.setOptions({
           placement: popperPlacement,
           ...popperOptions,
-          modifiers: [...(popperOptions.modifiers || []), placementModifier],
+          modifiers: [
+            placementModifier,
+            {
+              ...fallbackPlacementsModifier,
+              options: {
+                fallbackPlacements,
+              },
+            },
+            ...(popperOptions.modifiers || []),
+          ],
         });
       }
       firstRender.current = false;
-    }, [popperOptions, popperPlacement, placementModifier, localRef]);
+    }, [popperOptions, popperPlacement, fallbackPlacements, placementModifier, localRef]);
 
     const contents = <>{isRenderProp(children) ? children({placement}) : children}</>;
 

package/popup/lib/PopupPopper.tsx

@@ -13,6 +13,13 @@ export interface PopupPopperProps extends PopperProps {
    * @default bottom
    */
   placement?: Placement;
+  /**
+   * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+   * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+   * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+   * disable the fallback placements.
+   */
+  fallbackPlacements?: Placement[];
   /**
    * The additional options passed to the Popper's `popper.js` instance.
    */

package/popup/lib/fallbackPlacements.ts

@@ -0,0 +1,98 @@
+import {
+  Placement as PopperJSPlacement,
+  placements,
+  State,
+  detectOverflow,
+  SideObject,
+  Modifier,
+  ModifierArguments,
+} from '@popperjs/core';
+
+export type Placement = PopperJSPlacement; // Use template literals to make documentation list them out
+
+const getOppositePlacement = (popperPlacement: Placement): Placement => {
+  const [first, second] = popperPlacement.split('-');
+  let oppositePlacement: Placement;
+  switch (first) {
+    case 'top':
+      oppositePlacement = 'bottom';
+      break;
+    case 'bottom':
+      oppositePlacement = 'top';
+      break;
+    case 'left':
+      oppositePlacement = 'right';
+      break;
+    case 'right':
+      oppositePlacement = 'left';
+      break;
+    default:
+      oppositePlacement = 'auto';
+  }
+  if (second) {
+    oppositePlacement =
+      placements.find(placement => placement.includes(`${oppositePlacement}-${second}`)) ??
+      oppositePlacement;
+  }
+  return oppositePlacement;
+};
+
+const choseAvailablePlacement = (
+  placements: Placement[],
+  state: State,
+  preferredPlacement: Placement
+): Placement => {
+  if (placements.length === 0 || placements[0].split('-')[0] === 'auto') {
+    return preferredPlacement;
+  }
+
+  const {reference, popper} = state.rects;
+  const overflow = detectOverflow({...state, placement: placements[0]});
+  const direction = /left|right/.test(placements[0].split('-')[0]) ? 'horizontal' : 'vertical';
+  const isOverflowed =
+    (overflow.top > 0 || overflow.bottom > 0 || overflow.left > 0 || overflow.right > 0) &&
+    (direction === 'horizontal'
+      ? popper.height / 2 - overflow.top < reference.height ||
+        popper.height / 2 - overflow.bottom < reference.height
+      : popper.width - overflow.left < reference.width ||
+        popper.width - overflow.right < reference.width);
+  const key = placements[0].split('-')[0] as keyof SideObject;
+
+  if (!isOverflowed && overflow[key] <= 0) {
+    return placements[0];
+  } else {
+    return choseAvailablePlacement(placements.slice(1), state, preferredPlacement);
+  }
+};
+
+export type Options = {
+  fallbackPlacements: Placement[];
+};
+
+const name = 'fallbackModifier';
+
+export const fallbackPlacementsModifier: Modifier<typeof name, Options> = {
+  name: name,
+  enabled: true,
+  phase: 'main',
+  data: {
+    _skip: false,
+  },
+  fn({state, options}: ModifierArguments<Options>) {
+    const preferredPlacement = state.options.placement;
+    const {fallbackPlacements} = options;
+
+    const placements = [
+      preferredPlacement,
+      getOppositePlacement(preferredPlacement),
+      ...(fallbackPlacements || []),
+    ];
+
+    const placementOverride = choseAvailablePlacement(placements, state, preferredPlacement);
+    if (state.placement !== placementOverride) {
+      state.modifiersData[name]._skip = true;
+      state.placement = placementOverride;
+      state.reset = true;
+    }
+  },
+};

package/popup/lib/hooks/usePopupPopper.ts

@@ -9,14 +9,18 @@ import {Placement} from '../Popper';
  */
 export const usePopupPopper = createElemPropsHook(usePopupModel)(({state, events}, ref) => {
   const elementRef = useForkRef(ref, state.stackRef);
+
+  // Create a mutable ref of the placement to keep a stable `onPlacementChange` reference.
+  const placementRef = React.useRef(state.placement);
+  placementRef.current = state.placement;
   const onPlacementChange = React.useCallback(
     (placement: Placement) => {
-      if (placement !== state.placement) {
+      if (placement !== placementRef.current) {
         // only update if the placement has changed
         events.updatePlacement({placement});
       }
     },
-    [events, state.placement]
+    [events]
   );
 
   return {

package/tooltip/lib/OverflowTooltip.tsx

@@ -1,6 +1,11 @@
 import * as React from 'react';
 
-import {getTransformFromPlacement, Placement, Popper} from '@workday/canvas-kit-react/popup';
+import {
+  getTransformFromPlacement,
+  Placement,
+  Popper,
+  defaultFallbackPlacements,
+} from '@workday/canvas-kit-react/popup';
 import {mergeCallback} from '@workday/canvas-kit-react/common';
 
 import {TooltipContainer} from './TooltipContainer';
@@ -77,6 +82,13 @@ export interface OverflowTooltipProps extends Omit<React.HTMLAttributes<HTMLDivE
    * @default 'top'
    */
   placement?: Placement;
+  /**
+   * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+   * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+   * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+   * disable the fallback placements.
+   */
+  fallbackPlacements?: Placement[];
 }
 
 function mergeCallbacks<T extends {[key: string]: any}>(
@@ -96,6 +108,7 @@ function mergeCallbacks<T extends {[key: string]: any}>(
 
 export const OverflowTooltip = ({
   placement = 'top',
+  fallbackPlacements = defaultFallbackPlacements,
   children,
   ...elemProps
 }: OverflowTooltipProps) => {
@@ -126,7 +139,7 @@ export const OverflowTooltip = ({
         'aria-label': undefined, // we don't need a label, the accessible name will be the content
         ...mergeCallbacks({...targetProps, onMouseEnter, onFocus}, children.props),
       })}
-      <Popper placement={placement} {...popperProps}>
+      <Popper placement={placement} fallbackPlacements={fallbackPlacements} {...popperProps}>
         {({placement}) => {
           const transformOrigin = getTransformFromPlacement(placement);
           return (

package/tooltip/lib/Tooltip.tsx

@@ -1,7 +1,12 @@
 import * as React from 'react';
 import innerText from 'react-innertext';
 
-import {getTransformFromPlacement, Placement, Popper} from '@workday/canvas-kit-react/popup';
+import {
+  getTransformFromPlacement,
+  Placement,
+  Popper,
+  defaultFallbackPlacements,
+} from '@workday/canvas-kit-react/popup';
 import {createComponent, mergeCallback} from '@workday/canvas-kit-react/common';
 
 import {TooltipContainer} from './TooltipContainer';
@@ -27,6 +32,13 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
    * @default 'top'
    */
   placement?: Placement;
+  /**
+   * Define fallback placements by providing a list of {@link Placement} in array (in order of preference).
+   * The default preference is following the order of `top`, `right`, `bottom`, and `left`. Once the initial
+   * and opposite placements are not available, the fallback placements will be in use. Use an empty array to
+   * disable the fallback placements.
+   */
+  fallbackPlacements?: Placement[];
   /**
    * Determines the tooltip type for accessibility.
    *
@@ -78,6 +90,7 @@ export const Tooltip = createComponent('div')({
     children,
     showDelay = 300,
     hideDelay = 100,
+    fallbackPlacements = defaultFallbackPlacements,
     ...elemProps
   }: TooltipProps) {
     const titleText = innerText(title);
@@ -97,7 +110,7 @@ export const Tooltip = createComponent('div')({
             ? {'aria-label': children.props['aria-label']}
             : {}),
         })}
-        <Popper placement={placement} {...popperProps}>
+        <Popper placement={placement} fallbackPlacements={fallbackPlacements} {...popperProps}>
           {({placement}) => {
             const transformOrigin = getTransformFromPlacement(placement);
             return (