@enact/limestone 1.3.0 → 1.10.0

package/ContextualPopupDecorator/ContextualPopupDecorator.js

@@ -35,6 +35,8 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default":
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
@@ -42,19 +44,7 @@ function _nonIterableRest() { throw new TypeError("Invalid attempt to destructur
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
-function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
-function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
-function _possibleConstructorReturn(t, e) { if (e && ("object" == typeof e || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
-function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
-function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
-function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
-function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); } /* global MutationObserver ResizeObserver */ /**
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } /* global MutationObserver ResizeObserver */ /**
  * A higher-order component to add a Limestone styled popup to a component.
  *
  * @module limestone/ContextualPopupDecorator
@@ -106,576 +96,611 @@ var defaultConfig = {
    */
   openProp: 'selected'
 };
+var contextualPopupDecoratorDefaultProps = {
+  'data-webos-voice-exclusive': true,
+  direction: 'below center',
+  noAutoDismiss: false,
+  offset: 'small',
+  open: false,
+  scrimType: 'none',
+  spotlightRestrict: 'self-first'
+};
 var ContextualPopupContainer = (0, _SpotlightContainerDecorator["default"])({
   enterTo: 'default-element',
   preserveId: true
 }, _ContextualPopup.ContextualPopup);
 var Decorator = (0, _hoc["default"])(defaultConfig, function (config, Wrapped) {
-  var _Class;
   var noArrow = config.noArrow,
     noSkin = config.noSkin,
     openProp = config.openProp;
   var WrappedWithRef = (0, _WithRef.WithRef)(Wrapped);
-  return _Class = /*#__PURE__*/function (_Component) {
-    function _Class(props) {
-      var _this;
-      _classCallCheck(this, _Class);
-      _this = _callSuper(this, _Class, [props]);
-      _this.generateId = function () {
-        return Math.random().toString(36).substring(2, 10);
-      };
-      _this.getContainerAdjustedPosition = function () {
-        var position = _this.adjustedDirection;
-        var arr = _this.adjustedDirection.split(' ');
-        var direction = null;
-        var anchor = null;
-        if (arr.length === 2) {
-          var _arr = _slicedToArray(arr, 2);
-          direction = _arr[0];
-          anchor = _arr[1];
-        } else {
-          direction = position;
-        }
-        return {
-          anchor: anchor,
-          direction: direction
-        };
+
+  // eslint-disable-next-line no-shadow
+  var _ContextualPopupDecorator = function ContextualPopupDecorator(props) {
+    (0, _util.checkPropTypes)(_ContextualPopupDecorator, props);
+    var componentProps = (0, _util.setDefaultProps)(props, contextualPopupDecoratorDefaultProps);
+    var _useState = (0, _react.useState)(null),
+      _useState2 = _slicedToArray(_useState, 2),
+      activator = _useState2[0],
+      setActivator = _useState2[1];
+    var _useState3 = (0, _react.useState)({
+        top: 0,
+        left: 0
+      }),
+      _useState4 = _slicedToArray(_useState3, 2),
+      arrowPosition = _useState4[0],
+      setArrowPosition = _useState4[1];
+    var _useState5 = (0, _react.useState)({
+        top: 0,
+        left: 0,
+        right: 0
+      }),
+      _useState6 = _slicedToArray(_useState5, 2),
+      containerPosition = _useState6[0],
+      setContainerPosition = _useState6[1];
+    var _useState7 = (0, _react.useState)(componentProps.direction),
+      _useState8 = _slicedToArray(_useState7, 2),
+      direction = _useState8[0],
+      setDirection = _useState8[1];
+    var _useState9 = (0, _react.useState)(null),
+      _useState0 = _slicedToArray(_useState9, 2),
+      holeBounds = _useState0[0],
+      setHoleBounds = _useState0[1];
+    var adjustedDirection = (0, _react.useRef)(componentProps.direction);
+    var containerNode = (0, _react.useRef)(null);
+    var clientSiblingRef = (0, _react.useRef)(null);
+    var overflow = (0, _react.useRef)({});
+    var mutationObserver = (0, _react.useRef)(null);
+    var prevProps = (0, _react.useRef)(componentProps);
+    var snapshot = (0, _react.useRef)(null);
+    var resizeObserver = (0, _react.useRef)(null);
+    var findClientSiblingRef = (0, _react.useRef)(null);
+    var keyDownRef = (0, _react.useRef)(null);
+    var keyUpRef = (0, _react.useRef)(null);
+    var containerId = (0, _react.useMemo)(function () {
+      return _spotlight["default"].add(componentProps.popupSpotlightId);
+    }, [componentProps.popupSpotlightId]);
+    if (componentProps.setApiProvider) {
+      componentProps.setApiProvider();
+    }
+    var distances = (0, _react.useCallback)(function () {
+      var MARGIN = _resolution["default"].scale(noArrow ? 0 : 12);
+      var ARROW_WIDTH = noArrow ? 0 : _resolution["default"].scale(60); // svg arrow width.
+      var ARROW_OFFSET = noArrow ? 0 : _resolution["default"].scale(36); // actual distance of the svg arrow displayed to offset overlaps with the container. Offset is when `noArrow` is false.
+      var KEEPOUT = _resolution["default"].scale(24); // keep out distance on the edge of the screen
+
+      return {
+        ARROW_OFFSET: ARROW_OFFSET,
+        ARROW_WIDTH: ARROW_WIDTH,
+        KEEPOUT: KEEPOUT,
+        MARGIN: MARGIN
       };
-      /**
-       * Position the popup in relation to the activator.
-       *
-       * Position is based on the dimensions of the popup and its activator. If the popup does not
-       * fit in the specified direction, it will automatically flip to the opposite direction.
-       *
-       * @method
-       * @memberof limestone/ContextualPopupDecorator.ContextualPopupDecorator.prototype
-       * @public
-       * @returns {undefined}
-       */
-      _this.positionContextualPopup = function () {
-        var _this$clientSiblingRe;
-        if (_this.containerNode && (_this$clientSiblingRe = _this.clientSiblingRef) !== null && _this$clientSiblingRe !== void 0 && _this$clientSiblingRe.current) {
-          var containerNode = _this.containerNode.getBoundingClientRect();
-          var _this$clientSiblingRe2 = _this.clientSiblingRef.current.getBoundingClientRect(),
-            top = _this$clientSiblingRe2.top,
-            left = _this$clientSiblingRe2.left,
-            bottom = _this$clientSiblingRe2.bottom,
-            right = _this$clientSiblingRe2.right,
-            width = _this$clientSiblingRe2.width,
-            height = _this$clientSiblingRe2.height;
-          var clientNode = {
-            top: top,
-            left: left,
-            bottom: bottom,
-            right: right,
-            width: width,
-            height: height
-          };
-          clientNode.left = _this.props.rtl ? window.innerWidth - right : left;
-          clientNode.right = _this.props.rtl ? window.innerWidth - left : right;
-          _this.calcOverflow(containerNode, clientNode);
-          _this.adjustDirection();
-          var arrowPosition = _this.getArrowPosition(containerNode, clientNode),
-            containerPosition = _this.getContainerPosition(containerNode, clientNode);
-          if (_this.state.direction !== _this.adjustedDirection || _this.state.arrowPosition.left !== arrowPosition.left || _this.state.arrowPosition.top !== arrowPosition.top || _this.state.containerPosition.left !== containerPosition.left || _this.state.containerPosition.right !== containerPosition.right || _this.state.containerPosition.top !== containerPosition.top) {
-            _this.setState({
-              direction: _this.adjustedDirection,
-              arrowPosition: arrowPosition,
-              containerPosition: containerPosition
-            });
-          }
-        }
+    }, []);
+    var generateId = (0, _react.useCallback)(function () {
+      return Math.random().toString(36).substring(2, 10);
+    }, []);
+    var id = (0, _react.useMemo)(function () {
+      return generateId();
+    }, [generateId]);
+    var adjustRTL = (0, _react.useCallback)(function (position) {
+      var pos = position;
+      if (componentProps.rtl) {
+        var tmpLeft = pos.left;
+        pos.left = pos.right;
+        pos.right = tmpLeft;
+      }
+      return pos;
+    }, [componentProps]);
+    var getContainerAdjustedPosition = (0, _react.useCallback)(function () {
+      var position = adjustedDirection.current;
+      var arr = adjustedDirection.current.split(' ');
+      var localDirection;
+      var anchor = null;
+      if (arr.length === 2) {
+        var _arr = _slicedToArray(arr, 2);
+        localDirection = _arr[0];
+        anchor = _arr[1];
+      } else {
+        localDirection = position;
+      }
+      return {
+        anchor: anchor,
+        localDirection: localDirection
       };
-      _this.getContainerNode = function (node) {
-        _this.containerNode = node;
-        if (_this.resizeObserver) {
-          if (node) {
-            var _node$parentElement;
-            // It is not easy to trigger changed position of activator,
-            // so we chose to observe the `div` element's size that has the real size below the root of floatLayer.
-            // This implementation is dependent on the current structure of FloatingLayer,
-            // so if the structure have changed, below code needs to be changed accordingly.
-            _this.resizeObserver.observe(node === null || node === void 0 || (_node$parentElement = node.parentElement) === null || _node$parentElement === void 0 ? void 0 : _node$parentElement.parentElement);
-          } else {
-            _this.resizeObserver.disconnect();
-          }
-        }
-        if (_this.mutationObserver) {
-          if (node) {
-            _this.mutationObserver.observe(document.body, {
-              attributes: false,
-              childList: true,
-              subtree: true
-            });
+    }, []);
+    var centerContainerPosition = (0, _react.useCallback)(function (localContainerNode, clientNode) {
+      var pos = {};
+      var _distances = distances(),
+        KEEPOUT = _distances.KEEPOUT;
+      var _getContainerAdjusted = getContainerAdjustedPosition(),
+        anchor = _getContainerAdjusted.anchor,
+        localDirection = _getContainerAdjusted.localDirection;
+      if (localDirection === 'above' || localDirection === 'below') {
+        if (overflow.current.isOverLeft) {
+          // anchor to the left of the screen
+          pos.left = KEEPOUT;
+        } else if (overflow.current.isOverRight) {
+          // anchor to the right of the screen
+          pos.left = window.innerWidth - localContainerNode.width - KEEPOUT;
+        } else if (anchor) {
+          if (anchor === 'center') {
+            // center horizontally
+            pos.left = clientNode.left + (clientNode.width - localContainerNode.width) / 2;
+          } else if (anchor === 'left') {
+            // anchor to the left side of the activator
+            pos.left = clientNode.left;
           } else {
-            _this.mutationObserver.disconnect();
+            // anchor to the right side of the activator
+            pos.left = clientNode.right - localContainerNode.width;
           }
+        } else {
+          // anchor to the left side of the activator, matching its width
+          pos.left = clientNode.left;
+          pos.width = clientNode.width;
         }
-      };
-      _this.handle = _handle.handle.bind(_this);
-      _this.handleKeyUp = _this.handle((0, _handle.forProp)('open', true), (0, _handle.forKey)('enter'), function () {
-        return _spotlight["default"].getCurrent() === _this.state.activator;
-      }, _handle.stop, (0, _handle.forwardCustom)('onClose'));
-      _this.handleOpen = function (ev) {
-        (0, _handle.forward)('onOpen', ev, _this.props);
-        _this.positionContextualPopup();
-        var current = _spotlight["default"].getCurrent();
-        _this.updateLeaveFor(current);
-        _this.setState({
-          activator: current
-        }, function () {
-          return _this.spotPopupContent();
-        });
-      };
-      _this.handleClose = function () {
-        _this.updateLeaveFor(null);
-        _this.setState({
-          activator: null
-        });
-      };
-      _this.handleDismiss = function () {
-        (0, _handle.forwardCustom)('onClose')(null, _this.props);
-      };
-      // handle key event from outside (i.e. the activator) to the popup container
-      _this.handleKeyDown = function (ev) {
-        var _this$state = _this.state,
-          activator = _this$state.activator,
-          containerId = _this$state.containerId;
-        var spotlightRestrict = _this.props.spotlightRestrict;
-        var current = _spotlight["default"].getCurrent();
-        var direction = (0, _spotlight.getDirection)(ev.keyCode);
-        if (!direction) return;
-        var hasSpottables = _spotlight["default"].getSpottableDescendants(containerId).length > 0;
-        var spotlessSpotlightModal = spotlightRestrict === 'self-only' && !hasSpottables;
-        var shouldSpotPopup = current === activator && direction === PositionToDirection[_this.adjustedDirection.split(' ')[0]] && hasSpottables;
-        if (shouldSpotPopup || spotlessSpotlightModal) {
-          _this.handleDirectionalKey(ev);
-
-          // we guard against attempting a focus change by verifying the case where a
-          // spotlightModal popup contains no spottable components
-          if (!spotlessSpotlightModal && shouldSpotPopup) {
-            _this.spotPopupContent();
-          }
-        }
-      };
-      // handle key event from contextual popup and closes the popup
-      _this.handleContainerKeyDown = function (ev) {
-        // Note: Container will be only rendered if `open`ed, therefore no need to check for `open`
-        var direction = (0, _spotlight.getDirection)(ev.keyCode);
-        if (!direction) return;
-        _this.handleDirectionalKey(ev);
-
-        // if focus moves outside the popup's container, issue the `onClose` event
-        if (_spotlight["default"].move(direction) && !_this.containerNode.contains(_spotlight["default"].getCurrent())) {
-          (0, _handle.forwardCustom)('onClose')(null, _this.props);
-        }
-      };
-      _this.spotActivator = function (activator) {
-        if (!_spotlight["default"].getPointerMode() && activator && activator === _spotlight["default"].getCurrent()) {
-          activator.blur();
-        }
-        if (!_spotlight["default"].focus(activator)) {
-          _spotlight["default"].focus();
+      } else if (localDirection === 'left' || localDirection === 'right') {
+        if (overflow.current.isOverTop) {
+          // anchor to the top of the screen
+          pos.top = KEEPOUT;
+        } else if (overflow.current.isOverBottom) {
+          // anchor to the bottom of the screen
+          pos.top = window.innerHeight - localContainerNode.height - KEEPOUT;
+        } else if (anchor === 'middle') {
+          // center vertically
+          pos.top = clientNode.top - (localContainerNode.height - clientNode.height) / 2;
+        } else if (anchor === 'top') {
+          // anchor to the top of the activator
+          pos.top = clientNode.top;
+        } else {
+          // anchor to the bottom of the activator
+          pos.top = clientNode.bottom - localContainerNode.height;
         }
-      };
-      _this.spotPopupContent = function () {
-        var spotlightRestrict = _this.props.spotlightRestrict;
-        var containerId = _this.state.containerId;
-        var spottableDescendants = _spotlight["default"].getSpottableDescendants(containerId);
-        if (spotlightRestrict === 'self-only' && spottableDescendants.length && _spotlight["default"].getCurrent()) {
-          _spotlight["default"].getCurrent().blur();
+      }
+      return pos;
+    }, [distances, getContainerAdjustedPosition]);
+    var getContainerNodeWidth = (0, _react.useCallback)(function () {
+      return containerNode.current && containerNode.current.getBoundingClientRect().width || 0;
+    }, []);
+    var updateLeaveFor = (0, _react.useCallback)(function (localActivator) {
+      _spotlight["default"].set(containerId, {
+        leaveFor: {
+          up: localActivator,
+          down: localActivator,
+          left: localActivator,
+          right: localActivator
         }
-        if (!_spotlight["default"].focus(containerId)) {
-          _spotlight["default"].setActiveContainer(containerId);
+      });
+    }, [containerId]);
+    var getContainerPosition = (0, _react.useCallback)(function (localContainerNode, clientNode) {
+      var _distances2 = distances(),
+        ARROW_OFFSET = _distances2.ARROW_OFFSET,
+        MARGIN = _distances2.MARGIN;
+      var position = centerContainerPosition(localContainerNode, clientNode);
+      var _getContainerAdjusted2 = getContainerAdjustedPosition(),
+        localDirection = _getContainerAdjusted2.localDirection;
+      switch (localDirection) {
+        case 'above':
+          position.top = clientNode.top - ARROW_OFFSET - localContainerNode.height - MARGIN;
+          break;
+        case 'below':
+          position.top = clientNode.bottom + ARROW_OFFSET + MARGIN;
+          break;
+        case 'right':
+          position.left = componentProps.rtl ? clientNode.left - localContainerNode.width - ARROW_OFFSET - MARGIN : clientNode.right + ARROW_OFFSET + MARGIN;
+          break;
+        case 'left':
+          position.left = componentProps.rtl ? clientNode.right + ARROW_OFFSET + MARGIN : clientNode.left - localContainerNode.width - ARROW_OFFSET - MARGIN;
+          break;
+      }
+      return adjustRTL(position);
+    }, [adjustRTL, centerContainerPosition, componentProps, distances, getContainerAdjustedPosition]);
+    var getArrowPosition = (0, _react.useCallback)(function (localContainerNode, clientNode) {
+      var _distances3 = distances(),
+        ARROW_WIDTH = _distances3.ARROW_WIDTH,
+        KEEPOUT = _distances3.KEEPOUT,
+        MARGIN = _distances3.MARGIN;
+      var position = {};
+      var _getContainerAdjusted3 = getContainerAdjustedPosition(),
+        anchor = _getContainerAdjusted3.anchor,
+        localDirection = _getContainerAdjusted3.localDirection;
+      if (localDirection === 'above' || localDirection === 'below') {
+        if (overflow.current.isOverRight && !overflow.current.isOverLeft) {
+          position.left = window.innerWidth - (localContainerNode.width + ARROW_WIDTH) / 2 - KEEPOUT;
+        } else if (!overflow.current.isOverRight && overflow.current.isOverLeft) {
+          position.left = (localContainerNode.width - ARROW_WIDTH) / 2 + KEEPOUT;
+        } else if (anchor === 'left') {
+          position.left = clientNode.left + (localContainerNode.width - ARROW_WIDTH) / 2;
+        } else if (anchor === 'right') {
+          position.left = clientNode.right - localContainerNode.width + (localContainerNode.width - ARROW_WIDTH) / 2;
+        } else {
+          position.left = clientNode.left + (clientNode.width - ARROW_WIDTH) / 2;
         }
+      } else if (overflow.current.isOverBottom && !overflow.current.isOverTop) {
+        position.top = window.innerHeight - (localContainerNode.height + ARROW_WIDTH) / 2 - KEEPOUT;
+      } else if (!overflow.current.isOverBottom && overflow.current.isOverTop) {
+        position.top = (localContainerNode.height - ARROW_WIDTH) / 2 + KEEPOUT;
+      } else if (anchor === 'top') {
+        position.top = clientNode.top + (localContainerNode.height - ARROW_WIDTH) / 2;
+      } else if (anchor === 'bottom') {
+        position.top = clientNode.bottom - localContainerNode.height + (localContainerNode.height - ARROW_WIDTH) / 2;
+      } else {
+        position.top = clientNode.top + (clientNode.height - ARROW_WIDTH) / 2;
+      }
+      switch (localDirection) {
+        case 'above':
+          position.top = clientNode.top - ARROW_WIDTH - MARGIN;
+          break;
+        case 'below':
+          position.top = clientNode.bottom + MARGIN;
+          break;
+        case 'left':
+          position.left = componentProps.rtl ? clientNode.left + clientNode.width + MARGIN : clientNode.left - ARROW_WIDTH - MARGIN;
+          break;
+        case 'right':
+          position.left = componentProps.rtl ? clientNode.left - ARROW_WIDTH - MARGIN : clientNode.left + clientNode.width + MARGIN;
+          break;
+        default:
+          return {};
+      }
+      return adjustRTL(position);
+    }, [adjustRTL, componentProps, distances, getContainerAdjustedPosition]);
+    var adjustInlineOverflow = (0, _react.useCallback)(function (localDirection, previousOverflow, currentOverflow) {
+      if (currentOverflow.isOverRight && currentOverflow.isOverLeft && (localDirection === 'above' || localDirection === 'below')) {
+        overflow.current = previousOverflow;
+      } else {
+        overflow.current = currentOverflow;
+      }
+    }, []);
+    var calcOverflow = (0, _react.useCallback)(function (container, client) {
+      var containerHeight, containerWidth;
+      var _distances4 = distances(),
+        ARROW_OFFSET = _distances4.ARROW_OFFSET,
+        KEEPOUT = _distances4.KEEPOUT,
+        MARGIN = _distances4.MARGIN;
+      var _getContainerAdjusted4 = getContainerAdjustedPosition(),
+        anchor = _getContainerAdjusted4.anchor,
+        localDirection = _getContainerAdjusted4.localDirection;
+      if (localDirection === 'above' || localDirection === 'below') {
+        containerHeight = container.height;
+        containerWidth = anchor ? (container.width - client.width) / 2 : 0;
+      } else {
+        containerHeight = (container.height - client.height) / 2;
+        containerWidth = container.width;
+      }
+      var currentOverflow = {
+        isOverTop: anchor === 'top' && (localDirection === 'left' || localDirection === 'right') ? !(client.top > KEEPOUT) : client.top - containerHeight - ARROW_OFFSET - MARGIN - KEEPOUT < 0,
+        isOverBottom: anchor === 'bottom' && (localDirection === 'left' || localDirection === 'right') ? client.bottom + KEEPOUT > window.innerHeight : client.bottom + containerHeight + ARROW_OFFSET + MARGIN + KEEPOUT > window.innerHeight,
+        isOverLeft: anchor === 'left' && (localDirection === 'above' || localDirection === 'below') ? !(client.left > KEEPOUT) : client.left - containerWidth - ARROW_OFFSET - MARGIN - KEEPOUT < 0,
+        isOverRight: anchor === 'right' && (localDirection === 'above' || localDirection === 'below') ? client.right + KEEPOUT > window.innerWidth : client.right + containerWidth + ARROW_OFFSET + MARGIN + KEEPOUT > window.innerWidth
       };
-      _this.state = {
-        arrowPosition: {
-          top: 0,
-          left: 0
-        },
-        containerPosition: {
-          top: 0,
-          left: 0,
-          right: 0
-        },
-        containerId: _spotlight["default"].add(_this.props.popupSpotlightId),
-        activator: null
-      };
-      _this.resizeObserver = null;
-      _this.overflow = {};
-      _this.adjustedDirection = _this.props.direction;
-      _this.id = _this.generateId();
-      _this.clientSiblingRef = /*#__PURE__*/(0, _react.createRef)(null);
-      _this.findClientSiblingRef = /*#__PURE__*/(0, _react.createRef)(null);
-      _this.MARGIN = _resolution["default"].scale(noArrow ? 0 : 12);
-      _this.ARROW_WIDTH = noArrow ? 0 : _resolution["default"].scale(60); // svg arrow width. used for arrow positioning
-      _this.ARROW_OFFSET = noArrow ? 0 : _resolution["default"].scale(36); // actual distance of the svg arrow displayed to offset overlaps with the container. Offset is when `noArrow` is false.
-      _this.KEEPOUT = _resolution["default"].scale(24); // keep out distance on the edge of the screen
-
-      if (props.setApiProvider) {
-        props.setApiProvider(_this);
+      adjustInlineOverflow(localDirection, overflow.current, currentOverflow);
+    }, [adjustInlineOverflow, distances, getContainerAdjustedPosition]);
+    var adjustDirection = (0, _react.useCallback)(function () {
+      var _getContainerAdjusted5 = getContainerAdjustedPosition(),
+        anchor = _getContainerAdjusted5.anchor,
+        localDirection = _getContainerAdjusted5.localDirection;
+      if (overflow.current.isOverTop && !overflow.current.isOverBottom && localDirection === 'above') {
+        adjustedDirection.current = anchor ? "below ".concat(anchor) : 'below';
+      } else if (overflow.current.isOverBottom && !overflow.current.isOverTop && localDirection === 'below') {
+        adjustedDirection.current = anchor ? "above ".concat(anchor) : 'above';
+      } else if (overflow.current.isOverLeft && !overflow.current.isOverRight && localDirection === 'left' && !componentProps.rtl) {
+        adjustedDirection.current = anchor ? "right ".concat(anchor) : 'right';
+      } else if (overflow.current.isOverRight && !overflow.current.isOverLeft && localDirection === 'right' && !componentProps.rtl) {
+        adjustedDirection.current = anchor ? "left ".concat(anchor) : 'left';
       }
-      return _this;
-    }
-    _inherits(_Class, _Component);
-    return _createClass(_Class, [{
-      key: "componentDidMount",
-      value: function componentDidMount() {
-        var _this2 = this;
-        if (this.props.open) {
-          (0, _dispatcher.on)('keydown', this.handleKeyDown);
-          (0, _dispatcher.on)('keyup', this.handleKeyUp);
+    }, [componentProps, getContainerAdjustedPosition]);
+
+    /**
+     * Position the popup in relation to the activator.
+     *
+     * Position is based on the dimensions of the popup and its activator. If the popup does not
+     * fit in the specified direction, it will automatically flip to the opposite direction.
+     *
+     * @method
+     * @memberof limestone/ContextualPopupDecorator.ContextualPopupDecorator.prototype
+     * @public
+     * @returns {undefined}
+     */
+    var positionContextualPopup = (0, _react.useCallback)(function () {
+      if (containerNode.current && clientSiblingRef !== null && clientSiblingRef !== void 0 && clientSiblingRef.current) {
+        var localContainerNode = containerNode.current.getBoundingClientRect();
+        var _clientSiblingRef$cur = clientSiblingRef.current.getBoundingClientRect(),
+          top = _clientSiblingRef$cur.top,
+          left = _clientSiblingRef$cur.left,
+          bottom = _clientSiblingRef$cur.bottom,
+          right = _clientSiblingRef$cur.right,
+          width = _clientSiblingRef$cur.width,
+          height = _clientSiblingRef$cur.height;
+        var clientNode = {
+          top: top,
+          left: left,
+          bottom: bottom,
+          right: right,
+          width: width,
+          height: height
+        };
+        clientNode.left = componentProps.rtl ? window.innerWidth - right : left;
+        clientNode.right = componentProps.rtl ? window.innerWidth - left : right;
+        calcOverflow(localContainerNode, clientNode);
+        adjustDirection();
+        var localArrowPosition = getArrowPosition(localContainerNode, clientNode),
+          localContainerPosition = getContainerPosition(localContainerNode, clientNode);
+        if (direction !== adjustedDirection.current || arrowPosition.left !== localArrowPosition.left || arrowPosition.top !== localArrowPosition.top || containerPosition.left !== localContainerPosition.left || containerPosition.right !== localContainerPosition.right || containerPosition.top !== localContainerPosition.top) {
+          setDirection(adjustedDirection.current);
+          setArrowPosition(localArrowPosition);
+          setContainerPosition(localContainerPosition);
         }
-        if (typeof ResizeObserver === 'function') {
-          this.resizeObserver = new ResizeObserver(function () {
-            _this2.positionContextualPopup();
-          });
+      }
+    }, [adjustDirection, arrowPosition, calcOverflow, componentProps, containerPosition, direction, getArrowPosition, getContainerPosition]);
+    var getContainerNode = (0, _react.useCallback)(function (node) {
+      containerNode.current = node;
+      if (resizeObserver.current) {
+        if (node) {
+          var _node$parentElement;
+          // It is not easy to trigger changed position of activator,
+          // so we chose to observe the `div` element's size that has the real size below the root of floatLayer.
+          // This implementation is dependent on the current structure of FloatingLayer,
+          // so if the structure have changed, below code needs to be changed accordingly.
+          resizeObserver.current.observe(node === null || node === void 0 || (_node$parentElement = node.parentElement) === null || _node$parentElement === void 0 ? void 0 : _node$parentElement.parentElement);
+        } else {
+          resizeObserver.current.disconnect();
         }
-        if (typeof MutationObserver === 'function') {
-          this.mutationObserver = new MutationObserver(function () {
-            _this2.positionContextualPopup();
+      }
+      if (mutationObserver.current) {
+        if (node) {
+          mutationObserver.current.observe(document.body, {
+            attributes: false,
+            childList: true,
+            subtree: true
           });
+        } else {
+          mutationObserver.current.disconnect();
         }
       }
-    }, {
-      key: "getSnapshotBeforeUpdate",
-      value: function getSnapshotBeforeUpdate(prevProps, prevState) {
-        var snapshot = {
-          containerWidth: this.getContainerNodeWidth(),
-          clientSiblingWidth: this.getClientSiblingNodeWidth()
-        };
-        if (prevProps.open && !this.props.open) {
-          var current = _spotlight["default"].getCurrent();
-          snapshot.shouldSpotActivator =
-          // isn't set
-          !current ||
-          // is on the activator, and we want to re-spot it so a11y read out can occur
-          current === prevState.activator ||
-          // is within the popup
-          this.containerNode.contains(current);
-        }
-        return snapshot;
+    }, []);
+    var spotPopupContent = (0, _react.useCallback)(function () {
+      var localSpotlightRestrict = componentProps.spotlightRestrict;
+      var spottableDescendants = _spotlight["default"].getSpottableDescendants(containerId);
+      if (localSpotlightRestrict === 'self-only' && spottableDescendants.length && _spotlight["default"].getCurrent()) {
+        _spotlight["default"].getCurrent().blur();
       }
-    }, {
-      key: "componentDidUpdate",
-      value: function componentDidUpdate(prevProps, prevState, snapshot) {
-        if (snapshot.clientSiblingWidth !== this.getClientSiblingNodeWidth()) {
-          this.clientSiblingRef.current = this.findClientSiblingRef.current();
-        }
-        if (prevProps.direction !== this.props.direction || snapshot.containerWidth !== this.getContainerNodeWidth() || prevProps.open && this.props.open) {
-          this.adjustedDirection = this.props.direction;
-          // NOTE: `setState` is called and will cause re-render
-          this.positionContextualPopup();
-        }
-        if (this.props.open && !prevProps.open) {
-          (0, _dispatcher.on)('keydown', this.handleKeyDown);
-          (0, _dispatcher.on)('keyup', this.handleKeyUp);
-        } else if (!this.props.open && prevProps.open) {
-          (0, _dispatcher.off)('keydown', this.handleKeyDown);
-          (0, _dispatcher.off)('keyup', this.handleKeyUp);
-          if (snapshot && snapshot.shouldSpotActivator) {
-            this.spotActivator(prevState.activator);
-          }
-        }
+      if (!_spotlight["default"].focus(containerId)) {
+        _spotlight["default"].setActiveContainer(containerId);
       }
-    }, {
-      key: "componentWillUnmount",
-      value: function componentWillUnmount() {
-        if (this.props.open) {
-          (0, _dispatcher.off)('keydown', this.handleKeyDown);
-          (0, _dispatcher.off)('keyup', this.handleKeyUp);
-        }
-        _spotlight["default"].remove(this.state.containerId);
-        if (this.resizeObserver) {
-          this.resizeObserver.disconnect();
-          this.resizeObserver = null;
-        }
-        if (this.mutationObserver) {
-          this.mutationObserver.disconnect();
-          this.mutationObserver = null;
+    }, [componentProps, containerId]);
+    var handleKeyUp = (0, _react.useCallback)(function () {
+      return (0, _handle.handle)((0, _handle.forProp)('open', true), (0, _handle.forKey)('enter'), function () {
+        return _spotlight["default"].getCurrent() === activator;
+      }, _handle.stop, (0, _handle.forwardCustom)('onClose'));
+    }, [activator]);
+    var handleOpen = (0, _react.useCallback)(function (ev) {
+      (0, _handle.forward)('onOpen', ev, componentProps);
+      positionContextualPopup();
+      var current = _spotlight["default"].getCurrent();
+      updateLeaveFor(current);
+      setTimeout(function () {
+        setActivator(current);
+        spotPopupContent();
+      });
+    }, [componentProps, positionContextualPopup, spotPopupContent, updateLeaveFor]);
+    var handleClose = (0, _react.useCallback)(function () {
+      updateLeaveFor(null);
+      setActivator(null);
+    }, [updateLeaveFor]);
+    var handleDismiss = (0, _react.useCallback)(function () {
+      (0, _handle.forwardCustom)('onClose')(null, componentProps);
+    }, [componentProps]);
+    var handleDirectionalKey = (0, _react.useCallback)(function (ev) {
+      // prevent default page scrolling
+      ev.preventDefault();
+      // stop propagation to prevent default spotlight behavior
+      ev.stopPropagation();
+      // set the pointer mode to false on keydown
+      _spotlight["default"].setPointerMode(false);
+    }, []);
+
+    // handle key event from outside (i.e. the activator) to the popup container
+    var handleKeyDown = (0, _react.useCallback)(function (ev) {
+      var current = _spotlight["default"].getCurrent();
+      var localDirection = (0, _spotlight.getDirection)(ev.keyCode);
+      if (!localDirection) return;
+      var hasSpottables = _spotlight["default"].getSpottableDescendants(containerId).length > 0;
+      var spotlessSpotlightModal = componentProps.spotlightRestrict === 'self-only' && !hasSpottables;
+      var shouldSpotPopup = current === activator && localDirection === PositionToDirection[adjustedDirection.current.split(' ')[0]] && hasSpottables;
+      if (shouldSpotPopup || spotlessSpotlightModal) {
+        handleDirectionalKey(ev);
+
+        // we guard against attempting a focus change by verifying the case where a
+        // spotlightModal popup contains no spottable components
+        if (!spotlessSpotlightModal && shouldSpotPopup) {
+          spotPopupContent();
         }
       }
-    }, {
-      key: "getContainerNodeWidth",
-      value: function getContainerNodeWidth() {
-        return this.containerNode && this.containerNode.getBoundingClientRect().width || 0;
+    }, [activator, componentProps, containerId, handleDirectionalKey, spotPopupContent]);
+
+    // handle key event from contextual popup and closes the popup
+    var handleContainerKeyDown = (0, _react.useCallback)(function (ev) {
+      // Note: Container will be only rendered if `open`ed, therefore no need to check for `open`
+      var localDirection = (0, _spotlight.getDirection)(ev.keyCode);
+      if (!localDirection) return;
+      handleDirectionalKey(ev);
+
+      // if focus moves outside the popup's container, issue the `onClose` event
+      if (_spotlight["default"].move(localDirection) && !containerNode.current.contains(_spotlight["default"].getCurrent())) {
+        (0, _handle.forwardCustom)('onClose')(null, componentProps);
       }
-    }, {
-      key: "getClientSiblingNodeWidth",
-      value: function getClientSiblingNodeWidth() {
-        return this.clientSiblingRef.current && this.clientSiblingRef.current.getBoundingClientRect().width || 0;
+    }, [componentProps, handleDirectionalKey]);
+    var spotActivator = (0, _react.useCallback)(function (localActivator) {
+      if (!_spotlight["default"].getPointerMode() && localActivator && localActivator === _spotlight["default"].getCurrent()) {
+        localActivator.blur();
       }
-    }, {
-      key: "updateLeaveFor",
-      value: function updateLeaveFor(activator) {
-        _spotlight["default"].set(this.state.containerId, {
-          leaveFor: {
-            up: activator,
-            down: activator,
-            left: activator,
-            right: activator
-          }
-        });
+      if (!_spotlight["default"].focus(localActivator)) {
+        _spotlight["default"].focus();
       }
-    }, {
-      key: "getContainerPosition",
-      value: function getContainerPosition(containerNode, clientNode) {
-        var position = this.centerContainerPosition(containerNode, clientNode);
-        var _this$getContainerAdj = this.getContainerAdjustedPosition(),
-          direction = _this$getContainerAdj.direction;
-        switch (direction) {
-          case 'above':
-            position.top = clientNode.top - this.ARROW_OFFSET - containerNode.height - this.MARGIN;
-            break;
-          case 'below':
-            position.top = clientNode.bottom + this.ARROW_OFFSET + this.MARGIN;
-            break;
-          case 'right':
-            position.left = this.props.rtl ? clientNode.left - containerNode.width - this.ARROW_OFFSET - this.MARGIN : clientNode.right + this.ARROW_OFFSET + this.MARGIN;
-            break;
-          case 'left':
-            position.left = this.props.rtl ? clientNode.right + this.ARROW_OFFSET + this.MARGIN : clientNode.left - containerNode.width - this.ARROW_OFFSET - this.MARGIN;
-            break;
-        }
-        return this.adjustRTL(position);
+    }, []);
+    var getClientSiblingNodeWidth = (0, _react.useCallback)(function () {
+      return clientSiblingRef.current && clientSiblingRef.current.getBoundingClientRect().width || 0;
+    }, []);
+    var getSnapshotBeforeUpdate = (0, _react.useCallback)(function () {
+      var localSnapshot = {
+        containerWidth: getContainerNodeWidth(),
+        clientSiblingWidth: getClientSiblingNodeWidth()
+      };
+      if (prevProps.current.open && !componentProps.open) {
+        var _containerNode$curren;
+        var current = _spotlight["default"].getCurrent();
+        localSnapshot.shouldSpotActivator =
+        // isn't set
+        !current ||
+        // is on the activator, and we want to re-spot it so a11y read out can occur
+        current === activator || (// is within the popup
+        (_containerNode$curren = containerNode.current) === null || _containerNode$curren === void 0 ? void 0 : _containerNode$curren.contains(current));
       }
-    }, {
-      key: "centerContainerPosition",
-      value: function centerContainerPosition(containerNode, clientNode) {
-        var pos = {};
-        var _this$getContainerAdj2 = this.getContainerAdjustedPosition(),
-          anchor = _this$getContainerAdj2.anchor,
-          direction = _this$getContainerAdj2.direction;
-        if (direction === 'above' || direction === 'below') {
-          if (this.overflow.isOverLeft) {
-            // anchor to the left of the screen
-            pos.left = this.KEEPOUT;
-          } else if (this.overflow.isOverRight) {
-            // anchor to the right of the screen
-            pos.left = window.innerWidth - containerNode.width - this.KEEPOUT;
-          } else if (anchor) {
-            if (anchor === 'center') {
-              // center horizontally
-              pos.left = clientNode.left + (clientNode.width - containerNode.width) / 2;
-            } else if (anchor === 'left') {
-              // anchor to the left side of the activator
-              pos.left = clientNode.left;
-            } else {
-              // anchor to the right side of the activator
-              pos.left = clientNode.right - containerNode.width;
-            }
-          } else {
-            // anchor to the left side of the activator, matching its width
-            pos.left = clientNode.left;
-            pos.width = clientNode.width;
-          }
-        } else if (direction === 'left' || direction === 'right') {
-          if (this.overflow.isOverTop) {
-            // anchor to the top of the screen
-            pos.top = this.KEEPOUT;
-          } else if (this.overflow.isOverBottom) {
-            // anchor to the bottom of the screen
-            pos.top = window.innerHeight - containerNode.height - this.KEEPOUT;
-          } else if (anchor === 'middle') {
-            // center vertically
-            pos.top = clientNode.top - (containerNode.height - clientNode.height) / 2;
-          } else if (anchor === 'top') {
-            // anchor to the top of the activator
-            pos.top = clientNode.top;
-          } else {
-            // anchor to the bottom of the activator
-            pos.top = clientNode.bottom - containerNode.height;
-          }
+      return localSnapshot;
+    }, [activator, componentProps, getContainerNodeWidth, getClientSiblingNodeWidth]);
+    (0, _react.useEffect)(function () {
+      if (componentProps.open) {
+        if (handleKeyDown !== keyDownRef.current || handleKeyUp !== keyUpRef.current) {
+          (0, _dispatcher.off)('keydown', keyDownRef.current);
+          (0, _dispatcher.off)('keyup', keyUpRef.current);
+          keyDownRef.current = handleKeyDown;
+          keyUpRef.current = handleKeyUp;
+          (0, _dispatcher.on)('keydown', keyDownRef.current);
+          (0, _dispatcher.on)('keyup', keyUpRef.current);
         }
-        return pos;
       }
-    }, {
-      key: "getArrowPosition",
-      value: function getArrowPosition(containerNode, clientNode) {
-        var position = {};
-        var _this$getContainerAdj3 = this.getContainerAdjustedPosition(),
-          anchor = _this$getContainerAdj3.anchor,
-          direction = _this$getContainerAdj3.direction;
-        if (direction === 'above' || direction === 'below') {
-          if (this.overflow.isOverRight && !this.overflow.isOverLeft) {
-            position.left = window.innerWidth - (containerNode.width + this.ARROW_WIDTH) / 2 - this.KEEPOUT;
-          } else if (!this.overflow.isOverRight && this.overflow.isOverLeft) {
-            position.left = (containerNode.width - this.ARROW_WIDTH) / 2 + this.KEEPOUT;
-          } else if (anchor === 'left') {
-            position.left = clientNode.left + (containerNode.width - this.ARROW_WIDTH) / 2;
-          } else if (anchor === 'right') {
-            position.left = clientNode.right - containerNode.width + (containerNode.width - this.ARROW_WIDTH) / 2;
-          } else {
-            position.left = clientNode.left + (clientNode.width - this.ARROW_WIDTH) / 2;
-          }
-        } else if (this.overflow.isOverBottom && !this.overflow.isOverTop) {
-          position.top = window.innerHeight - (containerNode.height + this.ARROW_WIDTH) / 2 - this.KEEPOUT;
-        } else if (!this.overflow.isOverBottom && this.overflow.isOverTop) {
-          position.top = (containerNode.height - this.ARROW_WIDTH) / 2 + this.KEEPOUT;
-        } else if (anchor === 'top') {
-          position.top = clientNode.top + (containerNode.height - this.ARROW_WIDTH) / 2;
-        } else if (anchor === 'bottom') {
-          position.top = clientNode.bottom - containerNode.height + (containerNode.height - this.ARROW_WIDTH) / 2;
-        } else {
-          position.top = clientNode.top + (clientNode.height - this.ARROW_WIDTH) / 2;
+    }, [componentProps, handleKeyDown, handleKeyUp]);
+    (0, _react.useEffect)(function () {
+      var localId = containerId;
+      if (componentProps.open) {
+        (0, _dispatcher.on)('keydown', keyDownRef.current);
+        (0, _dispatcher.on)('keyup', keyUpRef.current);
+      }
+      if (typeof ResizeObserver === 'function') {
+        resizeObserver.current = new ResizeObserver(function () {
+          positionContextualPopup();
+        });
+      }
+      if (typeof MutationObserver === 'function') {
+        mutationObserver.current = new MutationObserver(function () {
+          positionContextualPopup();
+        });
+      }
+      return function () {
+        if (componentProps.open) {
+          (0, _dispatcher.off)('keydown', keyDownRef.current);
+          (0, _dispatcher.off)('keyup', keyUpRef.current);
         }
-        switch (direction) {
-          case 'above':
-            position.top = clientNode.top - this.ARROW_WIDTH - this.MARGIN;
-            break;
-          case 'below':
-            position.top = clientNode.bottom + this.MARGIN;
-            break;
-          case 'left':
-            position.left = this.props.rtl ? clientNode.left + clientNode.width + this.MARGIN : clientNode.left - this.ARROW_WIDTH - this.MARGIN;
-            break;
-          case 'right':
-            position.left = this.props.rtl ? clientNode.left - this.ARROW_WIDTH - this.MARGIN : clientNode.left + clientNode.width + this.MARGIN;
-            break;
-          default:
-            return {};
+        _spotlight["default"].remove(localId);
+        if (resizeObserver.current) {
+          resizeObserver.current.disconnect();
+          resizeObserver.current = null;
         }
-        return this.adjustRTL(position);
-      }
-    }, {
-      key: "calcOverflow",
-      value: function calcOverflow(container, client) {
-        var containerHeight, containerWidth;
-        var _this$getContainerAdj4 = this.getContainerAdjustedPosition(),
-          anchor = _this$getContainerAdj4.anchor,
-          direction = _this$getContainerAdj4.direction;
-        if (direction === 'above' || direction === 'below') {
-          containerHeight = container.height;
-          containerWidth = (container.width - client.width) / 2;
-        } else {
-          containerHeight = (container.height - client.height) / 2;
-          containerWidth = container.width;
+        if (mutationObserver.current) {
+          mutationObserver.current.disconnect();
+          mutationObserver.current = null;
         }
-        this.overflow = {
-          isOverTop: anchor === 'top' && (direction === 'left' || direction === 'right') ? !(client.top > this.KEEPOUT) : client.top - containerHeight - this.ARROW_OFFSET - this.MARGIN - this.KEEPOUT < 0,
-          isOverBottom: anchor === 'bottom' && (direction === 'left' || direction === 'right') ? client.bottom + this.KEEPOUT > window.innerHeight : client.bottom + containerHeight + this.ARROW_OFFSET + this.MARGIN + this.KEEPOUT > window.innerHeight,
-          isOverLeft: anchor === 'left' && (direction === 'above' || direction === 'below') ? !(client.left > this.KEEPOUT) : client.left - containerWidth - this.ARROW_OFFSET - this.MARGIN - this.KEEPOUT < 0,
-          isOverRight: anchor === 'right' && (direction === 'above' || direction === 'below') ? client.right + this.KEEPOUT > window.innerWidth : client.right + containerWidth + this.ARROW_OFFSET + this.MARGIN + this.KEEPOUT > window.innerWidth
-        };
+      };
+    }, []); // eslint-disable-line react-hooks/exhaustive-deps
+
+    (0, _react.useEffect)(function () {
+      snapshot.current = getSnapshotBeforeUpdate();
+      if (snapshot.current.clientSiblingWidth !== getClientSiblingNodeWidth()) {
+        clientSiblingRef.current = findClientSiblingRef.current();
       }
-    }, {
-      key: "adjustDirection",
-      value: function adjustDirection() {
-        var _this$getContainerAdj5 = this.getContainerAdjustedPosition(),
-          anchor = _this$getContainerAdj5.anchor,
-          direction = _this$getContainerAdj5.direction;
-        if (this.overflow.isOverTop && !this.overflow.isOverBottom && direction === 'above') {
-          this.adjustedDirection = anchor ? "below ".concat(anchor) : 'below';
-        } else if (this.overflow.isOverBottom && !this.overflow.isOverTop && direction === 'below') {
-          this.adjustedDirection = anchor ? "above ".concat(anchor) : 'above';
-        } else if (this.overflow.isOverLeft && !this.overflow.isOverRight && direction === 'left' && !this.props.rtl) {
-          this.adjustedDirection = anchor ? "right ".concat(anchor) : 'right';
-        } else if (this.overflow.isOverRight && !this.overflow.isOverLeft && direction === 'right' && !this.props.rtl) {
-          this.adjustedDirection = anchor ? "left ".concat(anchor) : 'left';
-        }
+      if (prevProps.current.direction !== componentProps.direction || snapshot.current.containerWidth !== getContainerNodeWidth() || prevProps.current.open && componentProps.open) {
+        adjustedDirection.current = componentProps.direction;
+        // NOTE: `setState` is called and will cause re-render
+        positionContextualPopup();
       }
-    }, {
-      key: "adjustRTL",
-      value: function adjustRTL(position) {
-        var pos = position;
-        if (this.props.rtl) {
-          var tmpLeft = pos.left;
-          pos.left = pos.right;
-          pos.right = tmpLeft;
+      if (componentProps.open && !prevProps.current.open) {
+        (0, _dispatcher.on)('keydown', keyDownRef.current);
+        (0, _dispatcher.on)('keyup', keyUpRef.current);
+      } else if (!componentProps.open && prevProps.current.open) {
+        (0, _dispatcher.off)('keydown', keyDownRef.current);
+        (0, _dispatcher.off)('keyup', keyUpRef.current);
+        if (snapshot.current && snapshot.current.shouldSpotActivator) {
+          spotActivator(activator);
         }
-        return pos;
-      }
-    }, {
-      key: "handleDirectionalKey",
-      value: function handleDirectionalKey(ev) {
-        // prevent default page scrolling
-        ev.preventDefault();
-        // stop propagation to prevent default spotlight behavior
-        ev.stopPropagation();
-        // set the pointer mode to false on keydown
-        _spotlight["default"].setPointerMode(false);
       }
-    }, {
-      key: "render",
-      value: function render() {
-        var _this$clientSiblingRe3;
-        var _this$props = this.props,
-          voiceExclusive = _this$props['data-webos-voice-exclusive'],
-          PopupComponent = _this$props.popupComponent,
-          popupClassName = _this$props.popupClassName,
-          noAutoDismiss = _this$props.noAutoDismiss,
-          open = _this$props.open,
-          offset = _this$props.offset,
-          popupProps = _this$props.popupProps,
-          skin = _this$props.skin,
-          spotlightRestrict = _this$props.spotlightRestrict,
-          rest = _objectWithoutProperties(_this$props, _excluded);
-        var idFloatLayer = "".concat(this.id, "_floatLayer");
-        var scrimType = rest.scrimType;
-        delete rest.scrimType;
+      prevProps.current = componentProps;
+    }, [activator, componentProps, getContainerNodeWidth, getClientSiblingNodeWidth, getSnapshotBeforeUpdate, positionContextualPopup, spotActivator]);
+    var voiceExclusive = componentProps['data-webos-voice-exclusive'],
+      PopupComponent = componentProps.popupComponent,
+      popupClassName = componentProps.popupClassName,
+      noAutoDismiss = componentProps.noAutoDismiss,
+      open = componentProps.open,
+      offset = componentProps.offset,
+      popupProps = componentProps.popupProps,
+      skin = componentProps.skin,
+      spotlightRestrict = componentProps.spotlightRestrict,
+      rest = _objectWithoutProperties(componentProps, _excluded);
+    var idFloatLayer = "".concat(id, "_floatLayer");
+    var scrimType = rest.scrimType;
+    delete rest.scrimType;
 
-        // 'holepunch' scrimType is specific to this component, not supported by floating layer
-        // so it must be swapped-out for one that FloatingLayer does support.
-        var holepunchScrim = scrimType === 'holepunch';
-        if (spotlightRestrict === 'self-only' && scrimType === 'none' || holepunchScrim) {
-          scrimType = 'transparent';
-        }
-        var popupPropsRef = Object.assign({}, popupProps);
-        var ariaProps = (0, _util.extractAriaProps)(popupPropsRef);
-        if (!noSkin) {
-          rest.skin = skin;
-        }
-        var holeBounds;
-        if ((_this$clientSiblingRe3 = this.clientSiblingRef) !== null && _this$clientSiblingRe3 !== void 0 && _this$clientSiblingRe3.current && holepunchScrim) {
-          holeBounds = this.clientSiblingRef.current.getBoundingClientRect();
-        }
-        delete rest.direction;
-        delete rest.onClose;
-        delete rest.onOpen;
-        delete rest.popupSpotlightId;
-        delete rest.rtl;
-        delete rest.setApiProvider;
-        if (openProp) rest[openProp] = open;
-        return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
-          "aria-owns": idFloatLayer,
-          className: _ContextualPopupDecoratorModule["default"].contextualPopupDecorator,
-          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_FloatingLayer["default"], {
-            id: idFloatLayer,
-            noAutoDismiss: noAutoDismiss,
-            onClose: this.handleClose,
-            onDismiss: this.handleDismiss,
-            onOpen: this.handleOpen,
-            open: open,
-            scrimType: scrimType,
-            children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
-              children: [holepunchScrim ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_HolePunchScrim["default"], {
-                holeBounds: holeBounds
-              }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualPopupContainer, _objectSpread(_objectSpread({}, ariaProps), {}, {
-                className: popupClassName,
-                onKeyDown: this.handleContainerKeyDown,
-                direction: this.state.direction,
-                arrowPosition: this.state.arrowPosition,
-                containerPosition: this.state.containerPosition,
-                containerRef: this.getContainerNode,
-                "data-webos-voice-exclusive": voiceExclusive,
-                offset: noArrow ? offset : 'none',
-                showArrow: !noArrow,
-                skin: skin,
-                spotlightId: this.state.containerId,
-                spotlightRestrict: spotlightRestrict,
-                children: /*#__PURE__*/(0, _jsxRuntime.jsx)(PopupComponent, _objectSpread({}, popupPropsRef))
-              }))]
-            })
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(WrappedWithRef, _objectSpread(_objectSpread({}, rest), {}, {
-            outermostRef: this.clientSiblingRef,
-            findOutermostRef: this.findClientSiblingRef,
-            referrerName: "ContextualPopup"
-          }))]
-        });
+    // 'holepunch' scrimType is specific to this component, not supported by floating layer
+    // so it must be swapped-out for one that FloatingLayer does support.
+    var holepunchScrim = scrimType === 'holepunch';
+    if (spotlightRestrict === 'self-only' && scrimType === 'none' || holepunchScrim) {
+      scrimType = 'transparent';
+    }
+    var popupPropsRef = Object.assign({}, popupProps);
+    var ariaProps = (0, _util.extractAriaProps)(popupPropsRef);
+    if (!noSkin) {
+      rest.skin = skin;
+    }
+    (0, _react.useEffect)(function () {
+      if (clientSiblingRef !== null && clientSiblingRef !== void 0 && clientSiblingRef.current && holepunchScrim) {
+        setHoleBounds(clientSiblingRef.current.getBoundingClientRect());
       }
-    }]);
-  }(_react.Component), _Class.displayName = 'ContextualPopupDecorator', _Class.propTypes = /** @lends limestone/ContextualPopupDecorator.ContextualPopupDecorator.prototype */{
+    }, [holepunchScrim]);
+    delete rest.direction;
+    delete rest.onClose;
+    delete rest.onOpen;
+    delete rest.popupSpotlightId;
+    delete rest.rtl;
+    delete rest.setApiProvider;
+    if (openProp) rest[openProp] = open;
+    return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      "aria-owns": idFloatLayer,
+      className: _ContextualPopupDecoratorModule["default"].contextualPopupDecorator,
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_FloatingLayer["default"], {
+        id: idFloatLayer,
+        noAutoDismiss: noAutoDismiss,
+        onClose: handleClose,
+        onDismiss: handleDismiss,
+        onOpen: handleOpen,
+        open: open,
+        scrimType: scrimType,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+          children: [holepunchScrim ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_HolePunchScrim["default"], {
+            holeBounds: holeBounds
+          }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualPopupContainer, _objectSpread(_objectSpread({}, ariaProps), {}, {
+            className: popupClassName,
+            onKeyDown: handleContainerKeyDown,
+            direction: direction,
+            arrowPosition: arrowPosition,
+            containerPosition: containerPosition,
+            containerRef: getContainerNode,
+            "data-webos-voice-exclusive": voiceExclusive,
+            offset: noArrow ? offset : 'none',
+            showArrow: !noArrow,
+            skin: skin,
+            spotlightId: containerId,
+            spotlightRestrict: spotlightRestrict,
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(PopupComponent, _objectSpread({}, popupPropsRef))
+          }))]
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(WrappedWithRef, _objectSpread(_objectSpread({}, rest), {}, {
+        outermostRef: clientSiblingRef,
+        findOutermostRef: findClientSiblingRef,
+        referrerName: "ContextualPopup"
+      }))]
+    });
+  };
+  _ContextualPopupDecorator.displayName = 'ContextualPopupDecorator';
+  _ContextualPopupDecorator.propTypes = /** @lends limestone/ContextualPopupDecorator.ContextualPopupDecorator.prototype */{
     /**
      * The component rendered within the
      * {@link limestone/ContextualPopupDecorator.ContextualPopup|ContextualPopup}.
@@ -824,15 +849,8 @@ var Decorator = (0, _hoc["default"])(defaultConfig, function (config, Wrapped) {
      * @public
      */
     spotlightRestrict: _propTypes2["default"].oneOf(['none', 'self-first', 'self-only'])
-  }, _Class.defaultProps = {
-    'data-webos-voice-exclusive': true,
-    direction: 'below center',
-    noAutoDismiss: false,
-    offset: 'small',
-    open: false,
-    scrimType: 'none',
-    spotlightRestrict: 'self-first'
-  }, _Class;
+  };
+  return _ContextualPopupDecorator;
 });
 
 /**